refactor cli commands, support doxygen format docstrings, add preliminary logging system

Author: emanspeaks

.clangd

@@ -1,3 +1,7 @@
+# The empty compile_flags.txt in the root directory causes clangd to treat
+# relative paths in compile flags as relative to the root of the project when
+# compile_commands.json is not present.
+
 If:
   PathMatch: .*\.in
 
@@ -17,4 +21,19 @@ CompileFlags:
   Add:
     - -Wall
     - -Wextra
-    - -Wpedantic
+    - -Wpedantic
+    - -xc++  # Force .h files to be treated as C++
+    - -std=gnu++17
+    # - -std=c++20
+    - --target=x86_64-pc-windows-msvc
+    - -DUNICODE
+    - -D_UNICODE
+    - -D_DEBUG
+    - -D_DLL
+    - -D_MT
+    - -Xclang
+    - --dependent-lib=msvcrtd
+    - -g
+    - -Xclang
+    - -gcodeview
+    - -fno-char8_t

.gitignore

@@ -12,3 +12,4 @@
 /.dep-cache/
 /tmp/
 /doc/
+/.cesium-doc/

.vscode/ltex.dictionary.en-US.txt

@@ -5,7 +5,9 @@ Backlinks
 bigz
 buildtools
 cesium-buildtools
+CesiumDocCLI
 cesiumlang
+clangd
 CPACK
 darkgray
 Darkmode
@@ -20,18 +22,23 @@ Fallthrough
 FETCHCONTENT
 filesystem
 frontmatter
+gcodeview
 Grotesk
 inlining
 Interop
 intrinsics
+IWYU
+JsonDoc
 katex
 lexer
 libtree
 lightgray
+LOGTQDM
 mac
 macdeployqt
 Monomorphization
 MSVC
+msvcrtd
 Namespacing
 nlohmann
 PYRANDYOS
@@ -40,8 +47,10 @@ qt
 RRGGBB
 Schibsted
 scrutinising
+sdeq
 shadowable
 shiki
+sstm
 subprocessing
 szenius
 unistd
@@ -56,6 +65,3 @@ windeployqt
 WINSYS
 yyjson
 Zig
-
-CesiumDocCLI
-JsonDoc

CMakeLists.txt

@@ -28,6 +28,7 @@ include(qt)
 include(yyjson)
 include(tree-sitter-core)
 include(tree-sitter-cpp)
+# include(utf8)
 
 # Add cesium subdirectory
 add_subdirectory(cesium)

CMakePresets.json

@@ -29,7 +29,9 @@
         "CMAKE_EXPORT_COMPILE_COMMANDS": "ON",
         "CMAKE_C_COMPILER": "$env{llvmBin}/clang.exe",
         "CMAKE_CXX_COMPILER": "$env{llvmBin}/clang++.exe",
-        "CMAKE_RC_COMPILER": "$env{WinSdkDir}/rc.exe"
+        "CMAKE_RC_COMPILER": "$env{WinSdkDir}/rc.exe",
+        "CMAKE_C_COMPILER_TARGET": "x86_64-pc-windows-msvc",
+        "CMAKE_CXX_COMPILER_TARGET": "x86_64-pc-windows-msvc"
       }
     },
     {

cesium-doc-config.json

@@ -0,0 +1,24 @@
+{
+  "languages": {
+    "cpp": {
+      "library": "tree-sitter-cpp.so",
+      "function": "tree_sitter_cpp",
+      "extensions": [".cpp", ".hpp", ".cc", ".h", ".cxx", ".h.in"],
+      "docstring_style": "/** */"
+    }
+  },
+  "source_directories": ["cesium/src/", "cesium/include/"],
+  "extract_directory": ".cesium-doc/",
+  "output_directory": "doc/api/",
+  "exclude_patterns": ["**/test/**", "**/*_test.*"],
+  "logging": {
+    "level": "debug",
+    "console_level": "debug",
+    "file_level": "debug",
+    "log_file": ".cesium-doc/cesium-doc.log",
+    "max_file_size_mb": 10,
+    "backup_count": 5,
+    "enable_colors": true,
+    "enable_timestamps": true
+  }
+}

cesium-doc-config.jsonc

@@ -19,6 +19,7 @@
 			"buildtools/opt/**": true,
 			"build/**": true,
 			"doc/**": true,
+      ".cesium-doc/**": true,
 			"tmp/**": true,
       "**/.zig-cache/**": true,
       "**/node_modules/**": true,
@@ -87,6 +88,8 @@
       "streetsidesoftware.code-spell-checker-scientific-terms",
 			"streetsidesoftware.code-spell-checker-win32",
       "ltex-plus.vscode-ltex-plus",
+
+      "vadimcn.vscode-lldb",
     ]
   },
   "launch": {

cesium.code-workspace

@@ -42,6 +42,7 @@ target_link_libraries(cesium
     yyjson
     tree-sitter-core
     tree-sitter-cpp
+    # utf8
 )
 
 # # Copy DLL dependencies to bin directory on Windows

cesium/CMakeLists.txt

@@ -6,11 +6,19 @@ target_sources(cesium PUBLIC ${CMAKE_CURRENT_BINARY_DIR}/version.h)
 
 target_sources(cesium PRIVATE
   json.h
-  treesitter.h
   dynlib.h
-  javadoc.h
-  ts_ast_parser.h
-  markdowngen.h
-  docgen.h
-  doc_cli.h
+  cli_utils.h
+  debug_utils.h
+  win32.h
+
+  # Documentation core headers
+  doc/treesitter.h
+  doc/markdowngen.h
+  doc/docgen.h
+  doc/doc_cli.h
+
+  # C++ language-specific headers
+  doc/cpp/docstrings.h
+  doc/cpp/ts_ast_parser.h
+  doc/cpp/ast_extractor.h
 )