v2: jvk rebuild

.github/actions/build-container/action.yml

@@ -0,0 +1,48 @@
+name: 'Build Container'
+description: 'Builds and pushes the Linux Docker image'
+inputs:
+  dockerfile:
+    description: 'Path to the Dockerfile'
+    required: true
+  tag:
+    description: 'Tag suffix for the image'
+    required: true
+  image-subdir:
+    description: 'Subdirectory to push image to'
+    default: 'cache'
+
+outputs:
+  container-image-adress: 
+    description: Address of container image
+    value: ${{ steps.set-image.outputs.image }}
+
+runs:
+  using: "composite"
+  steps:
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v4
+
+    - name: Set image names
+      id: set-image
+      shell: bash
+      run: |
+        image="ghcr.io/${{ github.repository }}/${{ inputs.image-subdir }}:${{ inputs.tag }}"
+        echo "image=$image" >> $GITHUB_OUTPUT
+        echo "cache_image=${image}-cache" >> $GITHUB_OUTPUT
+
+    - name: Log in to the Container registry
+      uses: docker/login-action@v4
+      with:
+        registry: ghcr.io
+        username: ${{ github.actor }}
+        password: ${{ github.token }}
+
+    - name: Build Docker image
+      uses: docker/build-push-action@v7
+      with:
+        context: .
+        file: ${{ inputs.dockerfile }}
+        push: true
+        tags: ${{ steps.set-image.outputs.image }}
+        cache-from: type=registry,ref=${{ steps.set-image.outputs.cache_image }}
+        cache-to: type=registry,ref=${{ steps.set-image.outputs.cache_image }},mode=max

.github/actions/build-engine/action.yml

@@ -0,0 +1,49 @@
+name: 'Build engine'
+description: 'Handles Caching, Configuration, and Compilation'
+inputs:
+  cache_prefix:
+    description: 'Cache Prefix e.g. OS'
+    required: true
+  preset:
+    description: 'CI preset from ci/CMakeUserPresets.json'
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    # --- 1. setup vcpkg cache ---
+    - name: setup vcpkg
+      uses: ./.github/actions/setup-vcpkg-cache
+
+    # --- 2. configure ---
+    - name: Configure CMake
+      shell: bash
+      run: |
+        [ -f ci/CMakeUserPresets.json ] && cp ci/CMakeUserPresets.json CMakeUserPresets.json
+        cmake --preset ${{ inputs.preset }}
+
+    # --- 3. restore BuildCache ---
+    - name: Restore BuildCache
+      id: buildcache
+      uses: ./.github/actions/restore-cache
+      with:
+        path: .buildcache
+        key: buildcache-${{ inputs.cache_prefix }}-${{ inputs.preset }}-${{ github.run_id }}
+        restore-keys: buildcache-${{ inputs.cache_prefix }}-${{ inputs.preset }}-
+        global-tag: buildcache-${{ inputs.cache_prefix }}-${{ inputs.preset }}
+        gh-token: ${{ github.token }}
+
+    # --- 4. build ---
+    - name: Build
+      shell: bash
+      run: cmake --build --preset ${{ inputs.preset }}
+
+    # --- 5. save BuildCache ---
+    - name: Save BuildCache
+      if: always()
+      uses: ./.github/actions/save-cache
+      with:
+        path: .buildcache
+        key: ${{ steps.buildcache.outputs.primary-key }}
+        global-tag: buildcache-${{ inputs.cache_prefix }}-${{ inputs.preset }}
+        gh-token: ${{ github.token }}

.github/actions/restore-cache/action.yml

@@ -0,0 +1,73 @@
+name: 'Restore Cache'
+description: 'Restores from GitHub Cache or GHCR'
+inputs:
+  path:
+    description: 'File path to restore'
+    required: true
+  key:
+    description: 'Primary key for GitHub Cache'
+    required: true
+  restore-keys:
+    description: 'Fallback keys for GitHub Cache'
+    required: false
+  global-tag:
+    description: 'OCI Tag for GHCR'
+    required: true
+  gh-token:
+    description: 'GitHub Token for GHCR auth'
+    required: true
+    default: ${{ github.token }}
+
+outputs:
+  cache-hit:
+    description: 'true if cache was found in either github or GHCR'
+    value: ${{ steps.local-cache.outputs.cache-hit == 'true' || steps.global-cache.outputs.hit == 'true' }}
+  primary-key:
+    description: 'The key used for saving later'
+    value: ${{ steps.local-cache.outputs.cache-primary-key }}
+
+runs:
+  using: "composite"
+  steps:
+    # --- Local GitHub cache ---
+    - name: Restore local cache
+      id: local-cache
+      uses: actions/cache/restore@v6
+      with:
+        path: ${{ inputs.path }}
+        key: ${{ inputs.key }}
+        restore-keys: ${{ inputs.restore-keys }}
+
+    # --- Setup ORAS (Only if local missed) ---
+    - name: Set up ORAS
+      if: steps.local-cache.outputs.cache-matched-key == ''
+      uses: oras-project/setup-oras@v2
+
+    # --- Login ---
+    - name: Login to GHCR (Native ORAS)
+      if: steps.local-cache.outputs.cache-matched-key == ''
+      shell: bash
+      run: |
+        echo "${{ inputs.gh-token }}" | oras login ghcr.io \
+          --username "${{ github.actor }}" \
+          --password-stdin
+
+    # --- Global GHCR cache ---
+    - name: Restore global cache
+      id: global-cache
+      if: steps.local-cache.outputs.cache-matched-key == ''
+      shell: bash
+      env:
+        REPO: ghcr.io/${{ github.repository }}
+        TAG: master-${{ inputs.global-tag }}
+        TARGET_PATH: ${{ inputs.path }}
+      run: |
+        echo "Local miss. Pulling from GHCR: $TAG"
+        if oras pull "$REPO/cache:$TAG"; then
+          echo "hit=true" >> $GITHUB_OUTPUT
+          tar -xzf cache-archive.tar.gz
+          rm cache-archive.tar.gz
+        else
+          echo "hit=false" >> $GITHUB_OUTPUT
+          echo "Global cache miss."
+        fi

.github/actions/save-cache/action.yml

@@ -0,0 +1,58 @@
+name: 'Save Cache'
+description: 'Saves to GitHub Cache (Always) and GHCR (Only on master)'
+inputs:
+  path:
+    description: 'File path to save'
+    required: true
+  key:
+    description: 'Key used in the restore step'
+    required: true
+  global-tag:
+    description: 'OCI Tag for GHCR'
+    required: true
+  gh-token:
+    description: 'GitHub Token for GHCR auth'
+    required: true
+    default: ${{ github.token }}
+
+runs:
+  using: "composite"
+  steps:
+    # --- Local github cache ---
+    - name: Save Local Cache
+      uses: actions/cache/save@v6
+      with:
+        path: ${{ inputs.path }}
+        key: ${{ inputs.key }}
+
+    # --- Setup for Global (Only on master) ---
+    - name: Set up ORAS
+      if: github.ref == 'refs/heads/master'
+      uses: oras-project/setup-oras@v2
+
+    # --- Login ---
+    - name: Login to GHCR (Native ORAS)
+      if: github.ref == 'refs/heads/master'
+      shell: bash
+      run: |
+        echo "${{ inputs.gh-token }}" | oras login ghcr.io \
+          --username "${{ github.actor }}" \
+          --password-stdin
+
+    # --- Global GHCR cache (master only) ---
+    - name: Save Global Cache
+      if: github.ref == 'refs/heads/master'
+      shell: bash
+      env:
+        REPO: ghcr.io/${{ github.repository }}
+        TAG: master-${{ inputs.global-tag }}
+        TARGET_PATH: ${{ inputs.path }}
+      run: |
+        if [ -d "$TARGET_PATH" ]; then
+          echo "Compressing for Global Cache..."
+          tar -czf cache-archive.tar.gz "$TARGET_PATH"
+
+          echo "Pushing to GHCR..."
+          oras push "$REPO/cache:$TAG" cache-archive.tar.gz
+          rm cache-archive.tar.gz
+        fi

.github/actions/setup-vcpkg-cache/action.yml

@@ -0,0 +1,42 @@
+name: 'Vcpkg Cache'
+description: 'sets up vcpkg to use NuGet for caching'
+inputs:
+  gh-token:
+    description: 'GitHub Token for GHCR auth'
+    required: true
+    default: ${{ github.token }}
+
+runs:
+  using: "composite"
+  steps: 
+    # --- WINDOWS: (dotnet nuget) ---
+    - name: setup vcpkg nuget source
+      if: runner.os == 'Windows'
+      shell: bash
+      run: |
+        dotnet nuget add source "https://nuget.pkg.github.com/${{ github.repository_owner }}/index.json" \
+          --name "GitHub" \
+          --username "${{ github.repository_owner }}" \
+          --password "${{ inputs.gh-token }}" \
+          --store-password-in-clear-text
+
+    # --- other: (mono + nuget.exe) ---
+    - name: setup vcpkg nuget source
+      if: runner.os != 'Windows'
+      shell: bash
+      run: |
+        # download nuget.exe
+        wget -qO nuget.exe https://dist.nuget.org/win-x86-commandline/latest/nuget.exe
+        NUGET_PATH="$(pwd)/nuget.exe"
+
+        # add source
+        mono "$NUGET_PATH" sources add \
+          -Name "GitHub" \
+          -Source "https://nuget.pkg.github.com/${{ github.repository_owner }}/index.json" \
+          -UserName "${{ github.repository_owner }}" \
+          -Password "${{ inputs.gh-token }}" \
+          -StorePasswordInClearText
+
+        # set API key for push
+        mono "$NUGET_PATH" setapikey "${{ inputs.gh-token }}" \
+          -Source "https://nuget.pkg.github.com/${{ github.repository_owner }}/index.json"

.github/actions/setup-windows/action.yml

@@ -0,0 +1,47 @@
+name: 'Setup Windows Environment'
+description: 'Sets up MSVC, Vcpkg, BuildCache, CMake and Ninja'
+inputs:
+  compiler:
+    description: 'compiler of the CI preset (msvc or clang)'
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    - uses: ilammy/msvc-dev-cmd@v1
+
+    - name: Setup Vcpkg Environment
+      shell: pwsh
+      run: |
+        $vcpkgPath = $env:VCPKG_INSTALLATION_ROOT
+        if (-not (Test-Path "$vcpkgPath")) {
+           Write-Error "Vcpkg not found at VCPKG_INSTALLATION_ROOT ($vcpkgPath)"
+           exit 1
+        }
+        "VCPKG_ROOT=$vcpkgPath" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
+
+    - name: Install BuildCache
+      shell: pwsh
+      run: |
+        Invoke-WebRequest -Uri "https://gitlab.com/bits-n-bites/buildcache/-/releases/v0.31.7/downloads/buildcache-windows.zip" -OutFile "buildcache.zip"
+        Expand-Archive buildcache.zip -DestinationPath c:\buildcache
+        echo "c:\buildcache\buildcache\bin" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
+
+    - name: Install LLVM
+      if: inputs.compiler == 'clang'
+      shell: pwsh
+      run: |
+        $version = "23.1.2"
+        $name = "clang+llvm-$version-x86_64-pc-windows-msvc"
+        curl.exe -fsSL -o "$env:RUNNER_TEMP\llvm.tar.xz" "https://github.com/llvm/llvm-project/releases/download/llvmorg-$version/$name.tar.xz"
+        cmd /c "7z x %RUNNER_TEMP%\llvm.tar.xz -so | 7z x -si -ttar -oc:\llvm > nul"
+        & "c:\llvm\$name\bin\clang++.exe" --version
+        echo "c:\llvm\$name\bin" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
+
+    - uses: actions/setup-python@v7
+      with:
+        python-version: "3.x"
+
+    - name: Install CMake & Ninja
+      run: pip install --upgrade cmake ninja
+      shell: powershell

.github/actions/test-engine/action.yml

@@ -0,0 +1,13 @@
+name: 'Test engine'
+description: 'Runs CTest with the given CI test preset'
+inputs:
+  preset:
+    description: 'CI preset from ci/CMakeUserPresets.json'
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    - name: Test
+      shell: bash
+      run: ctest --preset ${{ inputs.preset }} --output-on-failure

.github/workflows/build-test.yml

@@ -0,0 +1,36 @@
+name: Build & Test
+
+on:
+  push: { branches: ["master", "v2"] }
+  pull_request: { branches: ["master", "v2"] }
+  workflow_dispatch:
+
+permissions: { contents: read, packages: write }
+
+jobs:
+  linux:
+    name: Linux (${{ matrix.compiler }} ${{ matrix.config }})
+    strategy:
+      fail-fast: false
+      matrix:
+        compiler: [gcc, clang]
+        # debug runs the validation layers with synchronization validation
+        config: [debug, release]
+
+    uses: ./.github/workflows/linux-pipeline.yml
+    with:
+      compiler: ${{ matrix.compiler }}
+      config: ${{ matrix.config }}
+    secrets: inherit
+
+  windows:
+    name: Windows (${{ matrix.compiler }})
+    strategy:
+      fail-fast: false
+      matrix:
+        compiler: [msvc, clang]
+
+    uses: ./.github/workflows/windows-pipeline.yml
+    with:
+      compiler: ${{ matrix.compiler }}
+    secrets: inherit