refactor: migrate to modules and support module-based document generation

Author: tsurumi-yizhou

pixi.lock

@@ -23,6 +23,7 @@ cmake = ">=3.30"
 ninja = "*"
 clang = "==20.1.8"
 clangxx = "==20.1.8"
+clang-tools = "==20.1.8"
 lld = "==20.1.8"
 llvm-tools = "==20.1.8"
 compiler-rt = "==20.1.8"

pixi.toml

@@ -1,12 +1,34 @@
-file(GLOB_RECURSE CLORE_CORE_SOURCES CONFIGURE_DEPENDS
-    "${CMAKE_CURRENT_SOURCE_DIR}/config/*.cpp"
-    "${CMAKE_CURRENT_SOURCE_DIR}/extract/*.cpp"
-    "${CMAKE_CURRENT_SOURCE_DIR}/generate/*.cpp"
-    "${CMAKE_CURRENT_SOURCE_DIR}/support/*.cpp"
+file(GLOB_RECURSE CLORE_MODULE_SOURCES CONFIGURE_DEPENDS
+    "${CMAKE_CURRENT_SOURCE_DIR}/config/*.cppm"
+    "${CMAKE_CURRENT_SOURCE_DIR}/extract/*.cppm"
+    "${CMAKE_CURRENT_SOURCE_DIR}/generate/*.cppm"
+    "${CMAKE_CURRENT_SOURCE_DIR}/support/*.cppm"
 )
 
-add_library(clore-core STATIC ${CLORE_CORE_SOURCES})
+# ── locate clang-scan-deps (required for C++20 module compilation) ───
+find_program(CLANG_SCAN_DEPS_EXE
+    NAMES clang-scan-deps
+    HINTS
+        "${CMAKE_CXX_COMPILER}/../"
+        "$ENV{CONDA_PREFIX}/Library/bin"
+        "$ENV{CONDA_PREFIX}/bin"
+)
+if(CLANG_SCAN_DEPS_EXE)
+    set(CMAKE_CXX_COMPILER_CLANG_SCAN_DEPS "${CLANG_SCAN_DEPS_EXE}" CACHE FILEPATH "" FORCE)
+    message(STATUS "Found clang-scan-deps: ${CLANG_SCAN_DEPS_EXE}")
+else()
+    message(STATUS "clang-scan-deps not found; will rely on CMAKE_CXX_COMPILER_CLANG_SCAN_DEPS cache")
+endif()
+
+add_library(clore-core STATIC)
 add_library(clore::core ALIAS clore-core)
+set_property(TARGET clore-core PROPERTY CXX_SCAN_FOR_MODULES ON)
+
+target_sources(clore-core
+    PUBLIC
+        FILE_SET CXX_MODULES FILES
+            ${CLORE_MODULE_SOURCES}
+)
 
 target_include_directories(clore-core PUBLIC
     "${CMAKE_CURRENT_SOURCE_DIR}"
@@ -22,6 +44,7 @@ target_link_libraries(clore-core PUBLIC
 )
 
 add_executable(clore "${CMAKE_CURRENT_SOURCE_DIR}/main.cpp")
+set_property(TARGET clore PROPERTY CXX_SCAN_FOR_MODULES ON)
 target_link_libraries(clore PRIVATE clore::core eventide::deco)
 install(TARGETS clore RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR})
 
@@ -50,6 +73,7 @@ if(CLORE_ENABLE_TEST)
         "${PROJECT_SOURCE_DIR}/tests/unit"
     )
     target_link_libraries(unit_tests PRIVATE clore::core eventide::zest eventide::deco)
+    set_property(TARGET unit_tests PROPERTY CXX_SCAN_FOR_MODULES ON)
 endif()
 
 if(CLORE_ENABLE_IPO)

src/CMakeLists.txt

@@ -0,0 +1,6 @@
+export module clore.config;
+
+export import :schema;
+export import :load;
+export import :normalize;
+export import :validate;