Refactor: Foundational Major InfiniFrame.Native c++ rework

.gitattributes

@@ -1,4 +1,4 @@
-src/InfiniFrame.Native/Dependencies/* linguist-vendored
-src/InfiniFrame.Native/Dependencies/**/* linguist-vendored
+src/InfiniFrame.NativeBridge/Native/Dependencies/* linguist-vendored
+src/InfiniFrame.NativeBridge/Native/Dependencies/**/* linguist-vendored
 
 *.sh text eol=lf

.github/codeql-config.yml

@@ -10,16 +10,16 @@ paths:
 
 # Exclude third-party and generated content from CodeQL alerting.
 paths-ignore:
-  - "src/InfiniFrame.Native/artifacts/**"
-  - "src/InfiniFrame.Native/build/**"
-  - "src/InfiniFrame.Native/packages/**"
-  - "src/InfiniFrame.Native/cmake-build-debug/**"
-  - "src/InfiniFrame.Native/cmake-build-debug-linux/**"
-  - "src/InfiniFrame.Native/cmake-build-debug-windows/**"
-  - "src/InfiniFrame.Native/cmake-build-release/**"
-  - "src/InfiniFrame.Native/cmake-build-release-linux/**"
-  - "src/InfiniFrame.Native/cmake-build-release-windows/**"
-  - "src/InfiniFrame.Native/Dependencies/**"
+  - "src/InfiniFrame.NativeBridge/artifacts/**"
+  - "src/InfiniFrame.NativeBridge/build/**"
+  - "src/InfiniFrame.NativeBridge/Native/cmake-build-debug/**"
+  - "src/InfiniFrame.NativeBridge/Native/cmake-build-debug-linux/**"
+  - "src/InfiniFrame.NativeBridge/Native/cmake-build-debug-windows/**"
+  - "src/InfiniFrame.NativeBridge/Native/cmake-build-release/**"
+  - "src/InfiniFrame.NativeBridge/Native/cmake-build-release-linux/**"
+  - "src/InfiniFrame.NativeBridge/Native/cmake-build-release-windows/**"
+  - "src/InfiniFrame.NativeBridge/Native/Dependencies/**"
+  - "src/InfiniFrame.NativeBridge/Native/packages/**"
   - "tests/**"
   - "**/node_modules/**"
   - "**/dist/**"

.github/scripts/bump_version.py

@@ -11,7 +11,7 @@
 # Resolve paths from the repository root: .github/scripts -> repo root is three levels up.
 REPO_ROOT: Final[Path] = Path(__file__).parent.parent.parent
 FILE: Final[Path] = REPO_ROOT / "src" / "Directory.Build.props"
-CMAKE_FILE: Final[Path] = REPO_ROOT / "src" / "InfiniFrame.Native" / "CMakeLists.txt"
+CMAKE_FILE: Final[Path] = REPO_ROOT / "src" / "InfiniFrame.NativeBridge" / "Native" / "CMakeLists.txt"
 VERSION_PATTERN: Final[re.Pattern[str]] = re.compile(r"^\d+\.\d+\.\d+(-preview\.\d+)?$")
 BumpPart = Literal["major", "minor", "patch", "preview"]
 

.github/workflows/ci-codeql.yml

@@ -1,3 +1,4 @@
+#file: noinspection UndefinedAction,UndefinedParamsPresent
 name: "CodeQL Advanced"
 
 concurrency:
@@ -73,7 +74,7 @@ jobs:
                           - '.github/codeql-config.yml'
 
                         cpp:
-                          - 'src/InfiniFrame.Native/**'
+                          - 'src/InfiniFrame.NativeBridge/Native/**'
                           - 'native-vendor-deps.json'
                           - 'global.json'
                           - '.github/actions/setup-dependencies-native/**'
@@ -220,35 +221,40 @@ jobs:
                     category: "/language:csharp"
 
     analyze-cpp:
-        name: Analyze C/C++ (${{ matrix.os }})
+        name: Analyze C/C++ (${{ matrix.os }} / ${{ matrix.arch }})
         needs: changes
         runs-on: ${{ matrix.os }}
         timeout-minutes: 90
-        
+
         if: >
             (
               github.event_name == 'workflow_dispatch' &&
               github.event.inputs.full_scan == 'true'
             ) || (
               needs.changes.outputs.cpp == 'true'
             )
-        
+
         strategy:
             fail-fast: false
             matrix:
-                os:
-                    - ubuntu-latest
-                    - windows-latest
-                  # - macos-latest # support is currently experimental and requires additional setup
-
+                include:
+                    -   os: ubuntu-latest
+                        arch: x64
+
+                    -   os: windows-latest
+                        arch: x64
+
+#                    -   os: macos-latest
+#                        arch: arm64
+
         permissions:
             contents: read
             security-events: write
             actions: read
             packages: read
             pull-requests: write
             checks: write
-        
+
         steps:
             -   name: Checkout
                 uses: actions/checkout@v6
@@ -261,8 +267,8 @@ jobs:
             -   name: Setup Native Dependencies
                 uses: ./.github/actions/setup-dependencies-native
                 with:
-                    brew-cache-key: ${{ runner.os }}-brew-codeql-${{ hashFiles('.github/actions/setup-dependencies-native/action.yml', '.github/workflows/shared-testing-macos.yml') }}
-                    brew-restore-key: ${{ runner.os }}-brew-codeql-
+                    brew-cache-key: ${{ matrix.os }}-${{ matrix.arch }}-brew-codeql-${{ hashFiles('.github/actions/setup-dependencies-native/action.yml', '.github/workflows/ci-codeql.yml') }}
+                    brew-restore-key: ${{ matrix.os }}-${{ matrix.arch }}-brew-codeql-
 
             -   name: Initialize CodeQL
                 uses: github/codeql-action/init@v4
@@ -277,18 +283,14 @@ jobs:
                     dotnet restore src/InfiniFrame.NativeBridge/InfiniFrame.NativeBridge.csproj /p:NoWarn=NU1503
 
             -   name: Build NativeBridge
-                shell: pwsh
+                timeout-minutes: 45
                 run: |
-                    dotnet build src/InfiniFrame.NativeBridge/InfiniFrame.NativeBridge.csproj `
-                      --configuration Release `
-                      --no-restore `
-                      -p:SolutionDir="${{ github.workspace }}/" `
-                      -p:Platform=x64
+                    dotnet build src/InfiniFrame.NativeBridge/InfiniFrame.NativeBridge.csproj --configuration Release --no-restore /p:SolutionDir=${{ github.workspace }}/ /p:NativeArch=${{ matrix.arch }}
 
             -   name: Perform CodeQL Analysis
                 uses: github/codeql-action/analyze@v4
                 with:
-                    category: "/language:c-cpp"
+                    category: "/language:c-cpp/${{ matrix.os }}-${{ matrix.arch }}"
 
     analyze-javascript-typescript:
         name: Analyze JavaScript / TypeScript

.github/workflows/ci-release-docs.yml

@@ -1,3 +1,4 @@
+#file: noinspection UndefinedAction,UndefinedParamsPresent
 name: "CI: Release Docs"
 on:
     workflow_dispatch:
@@ -8,7 +9,6 @@ permissions:
     id-token: write
 
 jobs:
-    # noinspection UndefinedAction, UndefinedParamsPresent
     deploy-docs:
         name: Publish Docs
         uses: ./.github/workflows/shared-release-publish-docs.yml

.github/workflows/ci-release.yml

@@ -1,3 +1,4 @@
+#file: noinspection UndefinedAction,UndefinedParamsPresent
 name: "CI: Release"
 on:
     workflow_dispatch:
@@ -35,12 +36,10 @@ permissions:
     id-token: write
 
 jobs:
-    # noinspection UndefinedAction
     tests-python:
         name: Python Tests
         uses: ./.github/workflows/shared-testing-python.yml
 
-    # noinspection UndefinedAction, UndefinedParamsPresent
     tests-platform:
         name: Platform Tests
         needs: tests-python
@@ -54,12 +53,12 @@ jobs:
             run_macos: true
             run_docs: true
             run_trim_aot: true
+            enable_test_exports: false
         secrets: inherit
 
     # ------------------------------------------------------------------------------------------------------------------
     # Bump version, commit, and tag
     # ------------------------------------------------------------------------------------------------------------------
-    # noinspection UndefinedAction, UndefinedParamsPresent
     bump-version:
         name: Bump Version
         needs: tests-platform
@@ -70,7 +69,6 @@ jobs:
             custom_version: ${{ inputs.custom_version }}
         secrets: inherit
 
-    # noinspection UndefinedAction, UndefinedParamsPresent
     build:
         name: Build Native
         needs: bump-version
@@ -79,7 +77,6 @@ jobs:
             tag_name: ${{ needs.bump-version.outputs.tag_name }}
         secrets: inherit
 
-    # noinspection UndefinedAction, UndefinedParamsPresent
     publish:
         name: Publish Release
         needs: [ build, bump-version ]
@@ -90,7 +87,6 @@ jobs:
             publish_to_nuget: ${{ inputs.publish_to_nuget }}
         secrets: inherit
 
-    # noinspection UndefinedAction, UndefinedParamsPresent
     publish-docs:
         name: Publish Docs
         needs: [ publish, bump-version ]

.github/workflows/ci-testing-python.yml

@@ -1,3 +1,4 @@
+#file: noinspection UndefinedAction,UndefinedParamsPresent
 name: "CI: Python Tests"
 on:
     pull_request:
@@ -20,7 +21,6 @@ permissions:
     contents: read
 
 jobs:
-    # noinspection UndefinedAction
     run:
         name: Python Tests
         uses: ./.github/workflows/shared-testing-python.yml

.github/workflows/ci-testing.yml

@@ -1,3 +1,4 @@
+#file: noinspection UndefinedAction,UndefinedParamsPresent
 name: "CI: Full Test Suite"
 
 permissions:
@@ -38,12 +39,10 @@ on:
                 default: true
 
 jobs:
-    # noinspection UndefinedAction
     python-tests:
         name: Python Tests
         uses: ./.github/workflows/shared-testing-python.yml
 
-    # noinspection UndefinedAction, UndefinedParamsPresent
     run:
         name: Full Test Suite
         needs: python-tests
@@ -56,4 +55,5 @@ jobs:
             run_macos: ${{ inputs.run_macos }}
             run_docs: ${{ inputs.run_docs }}
             run_trim_aot: ${{ inputs.run_trim_aot }}
+            enable_test_exports: true
         secrets: inherit

.github/workflows/ci-todo.yml

@@ -1,3 +1,4 @@
+#file: noinspection UndefinedAction,UndefinedParamsPresent
 name: "CI: Todo Sync"
 on:
     push:

.github/workflows/ci-update-native-vendor-deps.yml

@@ -1,3 +1,4 @@
+#file: noinspection UndefinedAction,UndefinedParamsPresent
 name: "CI: Update Native Vendor Deps"
 
 on:

.github/workflows/shared-release-build.yml

@@ -1,3 +1,4 @@
+#file: noinspection UndefinedAction,UndefinedParamsPresent
 name: "Shared: Release Build"
 on:
     workflow_call:
@@ -57,9 +58,7 @@ jobs:
                         10.x
 
             -   name: Setup Native dependencies
-                # noinspection UndefinedAction
                 uses: ./.github/actions/setup-dependencies-native
-                # noinspection UndefinedParamsPresent
                 with:
                     brew-cache-key: ${{ matrix.os }}-${{ matrix.arch }}-brew-native-${{ hashFiles('.github/actions/setup-dependencies-native/action.yml', '.github/workflows/shared-release-build.yml') }}
                     brew-restore-key: ${{ matrix.os }}-${{ matrix.arch }}-brew-native-

.github/workflows/shared-release-bump-version.yml

@@ -1,3 +1,4 @@
+#file: noinspection UndefinedAction,UndefinedParamsPresent
 name: "Shared: Release Bump Version"
 on:
     workflow_call:

.github/workflows/shared-release-publish-docs.yml

@@ -1,3 +1,4 @@
+#file: noinspection UndefinedAction,UndefinedParamsPresent
 name: "Shared: Release Docs"
 on:
     workflow_call:

.github/workflows/shared-release-publish.yml

@@ -1,3 +1,4 @@
+#file: noinspection UndefinedAction,UndefinedParamsPresent
 name: "Shared: Release Publish"
 on:
     workflow_call:
@@ -50,9 +51,7 @@ jobs:
                       --prefix InfiniLore
 
             -   name: Setup Native dependencies
-                # noinspection UndefinedAction
                 uses: ./.github/actions/setup-dependencies-native
-                # noinspection UndefinedParamsPresent
                 with:
                     brew-cache-key: ${{ matrix.os }}-${{ matrix.arch }}-brew-native-${{ hashFiles('.github/actions/setup-dependencies-native/action.yml', '.github/workflows/shared-release-publish.yml') }}
                     brew-restore-key: ${{ matrix.os }}-${{ matrix.arch }}-brew-native-

.github/workflows/shared-testing-build.yml

@@ -1,3 +1,4 @@
+#file: noinspection UndefinedAction,UndefinedParamsPresent
 name: "Shared: Testing Build"
 on:
     workflow_call:
@@ -15,6 +16,11 @@ on:
                 description: 'Resolved commit SHA used by testing workflows.'
                 type: string
                 required: true
+            enable_test_exports:
+                description: 'Enable native test exports in testing native artifacts.'
+                type: boolean
+                required: false
+                default: false
 
 permissions:
     contents: read
@@ -68,7 +74,8 @@ jobs:
                 run: |
                     ./src/InfiniFrame.NativeBridge/native-build.ps1 `
                       "Release" `
-                      "${{ matrix.arch }}"
+                      "${{ matrix.arch }}" `
+                      "${{ inputs.enable_test_exports }}"
 
             -   name: Upload Build Artifact
                 uses: actions/upload-artifact@v7

.github/workflows/shared-testing-docs.yml

@@ -1,3 +1,4 @@
+#file: noinspection UndefinedAction,UndefinedParamsPresent
 name: "Shared: Docs Tests"
 
 on:
@@ -46,9 +47,7 @@ jobs:
             -   name: Set Docs Pending
                 env:
                     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-                # noinspection UndefinedAction, UndefinedParamsPresent
                 uses: ./.github/actions/sync-check
-                # noinspection UndefinedAction, UndefinedParamsPresent
                 with:
                     repo: ${{ github.repository }}
                     sha: ${{ env.TARGET_SHA }}
@@ -66,9 +65,7 @@ jobs:
                 if: always()
                 env:
                     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-                # noinspection UndefinedAction, UndefinedParamsPresent
                 uses: ./.github/actions/sync-check-finalize
-                # noinspection UndefinedParamsPresent
                 with:
                     repo: ${{ github.repository }}
                     sha: ${{ env.TARGET_SHA }}