feat!: add macros as primary public interface

.clang-tidy

@@ -2,7 +2,8 @@ Checks: >
   readability-identifier-naming,
   readability-implicit-bool-conversion,
   misc-const-correctness,
-  -clang-diagnostic-error
+  -clang-diagnostic-error,
+  -clang-diagnostic-gnu-string-literal-operator-template
 
 CheckOptions:
   - key: readability-identifier-naming.ClassCase
@@ -38,7 +39,7 @@ CheckOptions:
     value: '^[A-Z][A-Z0-9_]*$'
 
   - key: readability-identifier-naming.EnumConstantCase
-    value: CamelCase
+    value: lower_case
 
   - key: readability-identifier-naming.EnumCase
     value: lower_case

.github/workflows/ci.yml

@@ -113,10 +113,17 @@ jobs:
     if: github.event_name == 'pull_request'
     steps:
       - uses: actions/checkout@v4
+      - name: Install Clang-Format 22
+        run: |
+          wget https://apt.llvm.org/llvm.sh
+          chmod +x llvm.sh
+          sudo ./llvm.sh 22
+          sudo apt-get update
+          sudo apt-get install -y clang-format-22
       - name: Check formatting
         run: |
-          find include tests -name "*.h" -o -name "*.cpp" | \
-          xargs clang-format --dry-run --Werror
+          find include \( -name "*.h" -o -name "*.cpp" \) | \
+          xargs clang-format-22 --dry-run --Werror
 
   clang-tidy:
     name: Clang Tidy
@@ -126,14 +133,15 @@ jobs:
       - uses: actions/checkout@v4
       - name: Install Clang-Tidy 19
         run: |
-          wget -qO- https://apt.llvm.org/llvm-snapshot.gpg.key | sudo tee /etc/apt/trusted.gpg.d/apt.llvm.org.asc
-          echo "deb http://apt.llvm.org/noble/ llvm-toolchain-noble-19 main" | sudo tee /etc/apt/sources.list.d/llvm.list
+          wget https://apt.llvm.org/llvm.sh
+          chmod +x llvm.sh
+          sudo ./llvm.sh 19
           sudo apt-get update
           sudo apt-get install -y clang-tidy-19
       - name: Check tidy
         run: |
-          find include -name "*.h" -o -name "*.cpp" | \
-          xargs -I{} clang-tidy-19 {} -- -x c++ -std=c++20 -I include -include cstdint -include cstddef
+          find include \( -name "*.h" -o -name "*.cpp" \) | \
+          xargs -I{} clang-tidy-19 {} --header-filter="include/.*" -- -x c++ -std=c++20 -I include
 
   all-checks:
     name: All Checks

.gitignore

@@ -1,22 +1,39 @@
-.vs/
-*.sln.docstates
-Debug/
-Release/
-x64/
-x86/
-build/
-install/
-.idea/
-
-*.o
-*.obj
-*.exe
-*.dll
-*.pdb
-*.ilk
-*.log
-*.tlog
-*.user
-*.iml
-*.xml
-*.bat
+# IDE
+.vs/
+.idea/
+
+# Executables
+*.exe
+*.out
+*.app
+
+# Build directories
+build/
+Build/
+build-*/
+
+# Development
+development/
+cmake/development.cmake
+
+# CMake generated files
+CMakeFiles/
+CMakeCache.txt
+cmake_install.cmake
+Makefile
+install_manifest.txt
+compile_commands.json
+
+# Temporary files
+*.tmp
+*.log
+*.bak
+*.swp
+*.bat
+
+# vcpkg
+vcpkg_installed/
+
+# test output & cache
+Testing/
+.cache/

CMakeLists.txt

@@ -43,4 +43,6 @@ install(FILES
         ${CMAKE_CURRENT_BINARY_DIR}/obfuscxxConfig.cmake
         ${CMAKE_CURRENT_BINARY_DIR}/obfuscxxConfigVersion.cmake
         DESTINATION lib/cmake/obfuscxx
-)
+)
+
+include(cmake/development.cmake OPTIONAL)