Refactor: Unified NativeBridge project

.github/actions/download-native-binaries/action.yml

@@ -0,0 +1,123 @@
+name: Download Native Binaries
+description: Download, normalize, and verify native build artifacts for testing or release workflows
+
+inputs:
+    artifact-type:
+        description: Artifact naming mode
+        required: true
+        default: testing
+    target-root:
+        description: Root path where normalized native artifacts should be written
+        required: false
+        default: ""
+
+runs:
+    using: composite
+    steps:
+        -   name: Resolve Native Artifact Settings
+            id: resolve-native-artifact-settings
+            shell: bash
+            run: |
+                set -euo pipefail
+
+                artifact_type="${{ inputs.artifact-type }}"
+                input_root="${{ inputs.target-root }}"
+
+                case "$artifact_type" in
+                  testing)
+                    pattern="native-testing-*"
+                    ;;
+                  release)
+                    pattern="native-*"
+                    ;;
+                  *)
+                    echo "Unsupported artifact-type: $artifact_type"
+                    exit 1
+                    ;;
+                esac
+
+                if [ -n "$input_root" ]; then
+                  root="$input_root"
+                elif [ "$artifact_type" = "testing" ]; then
+                  root="src/InfiniFrame.NativeBridge/artifacts/native"
+                else
+                  root="artifacts/native"
+                fi
+
+                echo "pattern=$pattern" >> "$GITHUB_OUTPUT"
+                echo "root=$root" >> "$GITHUB_OUTPUT"
+
+        -   name: Download Native Build Artifacts
+            uses: actions/download-artifact@v8
+            with:
+                path: artifacts/native
+                pattern: ${{ steps.resolve-native-artifact-settings.outputs.pattern }}
+
+        -   name: Normalize Native Artifacts
+            shell: bash
+            run: |
+                set -euo pipefail
+
+                ROOT="${{ steps.resolve-native-artifact-settings.outputs.root }}"
+                artifact_type="${{ inputs.artifact-type }}"
+
+                mkdir -p "$ROOT/windows/x64/Release" "$ROOT/windows/arm64/Release"
+                mkdir -p "$ROOT/linux/x64/Release" "$ROOT/linux/arm64/Release"
+                mkdir -p "$ROOT/osx/x64/Release" "$ROOT/osx/arm64/Release"
+
+                copy_artifact() {
+                    src_name="$1"
+                    dest_dir="$2"
+                    src="artifacts/native/$src_name"
+                    if [ -d "$src" ]; then
+                        cp -R "$src"/. "$dest_dir"/
+                    fi
+                }
+
+                if [ "$artifact_type" = "testing" ]; then
+                    copy_artifact "native-testing-windows-x64" "$ROOT/windows/x64/Release"
+                    copy_artifact "native-testing-windows-arm64" "$ROOT/windows/arm64/Release"
+                    copy_artifact "native-testing-linux-x64" "$ROOT/linux/x64/Release"
+                    copy_artifact "native-testing-linux-arm64" "$ROOT/linux/arm64/Release"
+                    copy_artifact "native-testing-osx-x64" "$ROOT/osx/x64/Release"
+                    copy_artifact "native-testing-osx-arm64" "$ROOT/osx/arm64/Release"
+                else
+                    copy_artifact "native-windows-x64" "$ROOT/windows/x64/Release"
+                    copy_artifact "native-windows-arm64" "$ROOT/windows/arm64/Release"
+                    copy_artifact "native-linux-x64" "$ROOT/linux/x64/Release"
+                    copy_artifact "native-linux-arm64" "$ROOT/linux/arm64/Release"
+                    copy_artifact "native-osx-x64" "$ROOT/osx/x64/Release"
+                    copy_artifact "native-osx-arm64" "$ROOT/osx/arm64/Release"
+                fi
+
+        -   name: Verify Native Artifacts
+            shell: bash
+            run: |
+                set -euo pipefail
+
+                ROOT="${{ steps.resolve-native-artifact-settings.outputs.root }}"
+                EXPECTED=(
+                  "$ROOT/windows/x64/Release/InfiniFrame.Native.dll"
+                  "$ROOT/windows/x64/Release/WebView2Loader.dll"
+                  "$ROOT/windows/arm64/Release/InfiniFrame.Native.dll"
+                  "$ROOT/windows/arm64/Release/WebView2Loader.dll"
+                  "$ROOT/linux/x64/Release/InfiniFrame.Native.so"
+                  "$ROOT/linux/arm64/Release/InfiniFrame.Native.so"
+                  "$ROOT/osx/x64/Release/InfiniFrame.Native.dylib"
+                  "$ROOT/osx/arm64/Release/InfiniFrame.Native.dylib"
+                )
+
+                missing=0
+                for file in "${EXPECTED[@]}"; do
+                  if [ ! -f "$file" ]; then
+                    echo "Missing native artifact: $file"
+                    missing=$((missing+1))
+                  fi
+                done
+
+                if [ "$missing" -gt 0 ]; then
+                  echo "Missing $missing native artifact(s)."
+                  exit 1
+                fi
+
+                echo "All native artifacts downloaded and verified."

.github/actions/setup-dependencies-native/action.yml

@@ -2,10 +2,6 @@ name: Setup Native Dependencies
 description: Install and cache Native related dependencies for Linux/macOS runners.
 
 inputs:
-    apt-cache-version:
-        description: Version token for apt package cache invalidation
-        required: false
-        default: "1.0"
     brew-cache-key:
         description: Full Homebrew cache key for macOS runners
         required: false
@@ -29,31 +25,52 @@ runs:
             uses: awalsh128/cache-apt-pkgs-action@latest
             with:
                 packages: >
-                    pkg-config
-                    xvfb
-                    openbox
-                    x11-utils
-                    x11-xserver-utils
-                    dbus-x11
                     at-spi2-core
+                    dbus-x11
+                    fonts-liberation
                     gsettings-desktop-schemas
-                    libnotify4
-                    libnotify-dev
-                    libwebkit2gtk-4.1-dev
-                    libgtk-3-dev
-                    libglib2.0-dev
-                    libgdk-pixbuf2.0-dev
-                    libpango1.0-dev
                     libatk1.0-dev
-                    libharfbuzz-dev
+                    libegl1
                     libepoxy-dev
-                    libx11-dev
+                    libgdk-pixbuf2.0-dev
                     libgl1-mesa-dri
-                    libegl1
+                    libglib2.0-dev
+                    libgtk-3-dev
+                    libharfbuzz-dev
+                    libnotify-dev
+                    libnotify4
+                    libpango1.0-dev
+                    libwebkit2gtk-4.1-dev
+                    libx11-dev
                     mesa-utils
-                    fonts-liberation
+                    openbox
+                    pkg-config
+                    x11-utils
+                    x11-xserver-utils
                     xfonts-base
-                version: ${{ inputs['apt-cache-version'] }}
+                    xvfb
+                version: 2.0
+
+        -   name: Verify GTK3 Deps (Linux)
+            if: runner.os == 'Linux'
+            shell: bash
+            run: |
+                set -euo pipefail
+
+                if pkg-config --exists gtk+-3.0; then
+                  echo "gtk+-3.0 detected via pkg-config."
+                  exit 0
+                fi
+
+                echo "gtk+-3.0 not found after cached apt step; running fallback apt install."
+                sudo apt-get update
+                sudo apt-get install -y --no-install-recommends \
+                  libgtk-3-dev \
+                  libwebkit2gtk-4.1-dev \
+                  pkg-config
+
+                pkg-config --exists gtk+-3.0
+                echo "gtk+-3.0 is now available."
 
         -   name: Cache Homebrew
             if: runner.os == 'macOS'
@@ -69,9 +86,13 @@ runs:
                 restore-keys: |
                     ${{ inputs['brew-restore-key'] }}
 
-        -   name: Install GTK3 (macOS)
+        -   name: Install GTK3 and PowerShell (macOS)
             if: runner.os == 'macOS'
             shell: bash
             run: |
                 brew list gtk+3 >/dev/null 2>&1 || brew install gtk+3
                 brew list pkg-config >/dev/null 2>&1 || brew install pkg-config
+
+                if ! command -v pwsh >/dev/null 2>&1; then
+                    brew list --cask powershell >/dev/null 2>&1 || brew install --cask powershell
+                fi

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

@@ -0,0 +1,38 @@
+name: Setup Dependencies
+description: Install and cache related dependencies.
+
+inputs:
+    cache-dotnet:
+        description: Whether to cache .NET dependencies
+        required: false
+        default: true
+
+runs:
+    using: composite
+    steps:
+        -   name: Setup Node
+            uses: actions/setup-node@v6
+            with:
+                node-version: 24
+                cache: npm
+                cache-dependency-path: |
+                    package-lock.json
+                    **/package-lock.json
+
+        -   name: Setup Python
+            uses: actions/setup-python@v6
+            with:
+                python-version: '3.x'
+
+        -   name: Setup .NET
+            uses: actions/setup-dotnet@v5
+            with:
+                dotnet-version: |
+                    8.x
+                    9.x
+                    10.x
+                cache: ${{ inputs['cache-dotnet'] }}
+                cache-dependency-path: |
+                    **/*.csproj
+                    **/*.props
+                    **/Directory.Packages.props

.github/actions/sync-check/action.yml

@@ -52,7 +52,13 @@ inputs:
 runs:
     using: composite
     steps:
+        -   name: Skip status/check sync in local mode
+            if: ${{ env.LOCAL_GHA_SKIP_STATUS == '1' }}
+            shell: bash
+            run: echo "LOCAL_GHA_SKIP_STATUS=1, skipping GitHub status/check sync."
+
         -   name: Sync status/check
+            if: ${{ env.LOCAL_GHA_SKIP_STATUS != '1' }}
             shell: pwsh
             run: |
                 $argsList = @(

.github/scripts/sync_github_checks.py

@@ -190,6 +190,7 @@ def complete_matching_check_runs(args: Args, token: str) -> bool:
         for run in check_runs
         if run.get("name") == args.context
            and run.get("status") in ("queued", "in_progress")
+           and run.get("details_url") == args.target_url
            and isinstance(run.get("id"), int)
     ]