CPP-GL: version 2.0.0

.clangd

@@ -0,0 +1,47 @@
+CompileFlags:
+  CompilationDatabase: build
+  Add:
+    - -std=c++23
+    - -xc++-header
+    - -Iinclude
+    - -Wall
+    - -Wextra
+    - -Wcast-align
+    - -Wconversion
+    - -Wsign-conversion
+    - -Wunreachable-code
+    - -Wuninitialized
+    - -Wunused
+    - -pedantic
+    - -ftemplate-depth=512
+
+Diagnostics:
+  UnusedIncludes: None
+  ClangTidy:
+    Add:
+      - bugprone-*
+      - modernize-*
+      - performance-*
+    Remove:
+      - modernize-use-trailing-return-type
+
+Index:
+  Background: Build
+
+---
+
+If:
+  PathMatch: tests/.*
+CompileFlags:
+  Add:
+    - -Itests/include
+    - -Itests/external
+
+---
+
+If:
+  PathMatch: benchmarks/.*
+CompileFlags:
+  CompilationDatabase: build_bench
+  Add:
+    - -Ibenchmarks/include

.github/workflows/benchmarks.yaml

@@ -0,0 +1,45 @@
+name: Benchmarks Smoke Test
+on:
+  push:
+    branches:
+      - "*"
+    paths:
+      - .github/workflows/benchmarks.yaml
+      - CMakeLists.txt
+      - cmake/
+      - include/**
+      - benchmarks/**
+
+jobs:
+  build:
+    name: Build and Run Benchmarks (Smoke Test)
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Dependencies (Boost)
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libboost-graph-dev
+
+      - name: Prepare
+        env:
+          CC: gcc-14
+          CXX: g++-14
+        run: |
+          cmake -B build_bench -DCMAKE_CXX_COMPILER=$CXX -DCMAKE_C_COMPILER=$CC \
+            -DBUILD_BENCHMARKS=ON -DBENCH_INCLUDE_BGL=ON -DCMAKE_BUILD_TYPE=Release
+        continue-on-error: false
+
+      - name: Build the Benchmarks
+        run: |
+          cmake --build build_bench/ -j$(nproc)
+        continue-on-error: false
+
+      - name: Execute the Smoke Test
+        run: |
+          ./build_bench/benchmarks/cpp-gl-bench \
+            --benchmark_repetitions=1 --benchmark_display_aggregates_only=true \
+            --bip-v 100

.github/workflows/clang.yaml

@@ -1,16 +1,18 @@
-name: clang++
+name: Clang++
 on:
   push:
     branches:
-      - '*'
+      - "*"
     paths:
       - .github/workflows/clang.yaml
+      - CMakeLists.txt
+      - cmake/
       - include/**
       - tests/**
 
 jobs:
   build:
-    name: Build and run tests
+    name: Build and Run Tests (Clang)
     runs-on: ubuntu-24.04
 
     steps:
@@ -19,18 +21,18 @@ jobs:
 
       - name: Prepare
         env:
-          CC:  clang-17
-          CXX: clang++-17
+          CC: clang-18
+          CXX: clang++-18
         run: |
-          cmake -B build -DCMAKE_CXX_COMPILER=$CXX -DCMAKE_C_COMPILER=$CC
+          cmake -B build_clang -DBUILD_TESTS=ON -DCMAKE_CXX_COMPILER=$CXX -DCMAKE_C_COMPILER=$CC
         continue-on-error: false
 
-      - name: Build test executable
+      - name: Build Tests
         run: |
-          cd build && make -j 4
+          cmake --build build_clang/ -j$(nproc)
         continue-on-error: false
 
-      - name: Run tests
+      - name: Run Tests
         run: |
-          ./build/tests/run
-        continue-on-error: false
+          ./build_clang/tests/gl
+          ./build_clang/tests/hgl

.github/workflows/documentation.yaml

@@ -0,0 +1,88 @@
+name: Documentation
+
+on:
+  pull_request:
+    branches:
+      - "*"
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  build-and-deploy:
+    name: Build & Deploy Documentation
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          submodules: recursive
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Install system dependencies
+        run: sudo apt-get update && sudo apt-get install doxygen -y
+
+      - name: Install Python dependencies (uv)
+        run: |
+          pip install uv
+          uv sync
+
+      - name: Validate Internal Project Versions
+        run: |
+          VERSION=$(uv run python scripts/check_version.py)
+          echo "project version = $VERSION"
+          echo "VERSION=$VERSION" >> $GITHUB_ENV
+
+      - name: Validate Git Tag (Deploy Only)
+        if: github.event_name == 'push'
+        run: |
+          VERSION_TAG="${GITHUB_REF_NAME}"
+          echo "git version tag = $VERSION_TAG"
+          if [[ "$VERSION_TAG" != "v$VERSION" ]]; then
+            echo "Error: Tag mismatch: git version tag = $VERSION_TAG, project version: v$VERSION"
+            exit 1
+          fi
+
+      - name: Build Docs (PR Validation Only)
+        if: github.event_name == 'pull_request'
+        run: make build-docs
+
+      # See: https://api.github.com/users/github-actions%5Bbot%5D
+      - name: Configure Git (Deploy Only)
+        if: github.event_name == 'push'
+        run: |
+          git config --local user.name "github-actions[bot]"
+          git config --local user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - name: Determine if Latest Tag (Deploy Only)
+        if: github.event_name == 'push'
+        run: |
+          CURRENT_VERSION="v${VERSION}"
+          git fetch --tags --force
+          ALL_TAGS=$(git tag | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | sort -V)
+          LATEST_TAG=$(echo "$ALL_TAGS" | tail -n 1)
+
+          if [ "$CURRENT_VERSION" = "$LATEST_TAG" ]; then
+            echo "DEPLOY_LATEST=true" >> $GITHUB_ENV
+          else
+            echo "DEPLOY_LATEST=false" >> $GITHUB_ENV
+          fi
+
+      - name: Deploy with mike (Latest)
+        if: github.event_name == 'push' && env.DEPLOY_LATEST == 'true'
+        run: |
+          make docs TAGS="--push --update-aliases v${VERSION} latest"
+          uv run mike set-default --push latest
+
+      - name: Deploy with mike (Older Version)
+        if: github.event_name == 'push' && env.DEPLOY_LATEST == 'false'
+        run: make docs TAGS="--push v${VERSION}"

.github/workflows/format.yaml

@@ -1,16 +1,17 @@
-name: format
+name: Code Formatting
 on:
   push:
     branches:
-      - '*'
+      - "*"
     paths:
       - .github/workflows/format.yaml
+      - scripts/common.py
       - scripts/format.py
       - include/**
       - tests/include/**
       - tests/source/**
       - tests/app/**
-
+      - benchmarks/**
 
 jobs:
   build:
@@ -24,9 +25,9 @@ jobs:
       - name: Set up python
         uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.14"
 
       - name: Test formatting
         shell: bash
         run: |
-          python3 scripts/format.py --check
+          python3 scripts/format.py --check --clang-format-executable clang-format-18

.github/workflows/gpp.yaml

@@ -1,17 +1,18 @@
-name: g++
+name: G++
 on:
   push:
     branches:
-      - '*'
+      - "*"
     paths:
       - .github/workflows/gpp.yaml
+      - CMakeLists.txt
+      - cmake/
       - include/**
       - tests/**
 
-
 jobs:
   build:
-    name: Build and run tests
+    name: Build and Run Tests (G++)
     runs-on: ubuntu-24.04
 
     steps:
@@ -20,17 +21,18 @@ jobs:
 
       - name: Prepare
         env:
-          CC:  gcc-13
-          CXX: g++-13
+          CC: gcc-14
+          CXX: g++-14
         run: |
-          cmake -B build -DCMAKE_CXX_COMPILER=$CXX -DCMAKE_C_COMPILER=$CC
+          cmake -B build_gcc -DBUILD_TESTS=ON -DCMAKE_CXX_COMPILER=$CXX -DCMAKE_C_COMPILER=$CC
         continue-on-error: false
 
-      - name: Build test executable
+      - name: Build Tests
         run: |
-          cd build && make -j 4
+          cmake --build build_gcc/ -j$(nproc)
         continue-on-error: false
 
-      - name: Run tests
+      - name: Run Tests
         run: |
-          ./build/tests/run
+          ./build_gcc/tests/gl
+          ./build_gcc/tests/hgl

.github/workflows/licence.yaml

@@ -1,17 +1,17 @@
-name: licence
+name: Licence
 on:
   push:
     branches:
-      - '*'
+      - "*"
     paths:
       - .github/workflows/licence.yaml
+      - scripts/common.py
       - scripts/check_licence.py
       - include/**
 
-
 jobs:
   build:
-    name: Test code formatting
+    name: Test License Comments
     runs-on: ubuntu-24.04
 
     steps:
@@ -23,7 +23,7 @@ jobs:
         with:
           python-version: "3.12"
 
-      - name: Test formatting
+      - name: Validate Licence Comments
         shell: bash
         run: |
           python3 scripts/check_licence.py

.gitignore

@@ -1,16 +1,22 @@
 # editor files
 .vscode/
 .idea/
+.zed/
 
 # build files
 *.exe
 *build*/
 
 # documentation files
 documentation/
+site/
+mike-*.yml
+docs/cpp-gl/
 
 # python temporary files
 **/__pycache__/
+.ruff_cache/
+.venv/
 
 # other
 *tmp*/

.python-version

@@ -0,0 +1 @@
+3.14