Sync verified Native toolchain fixes for graphics Actions tests

.github/workflows/nuget-avalonia-native.yml

@@ -1,349 +0,0 @@
-name: staticlink-avalonia-native
-
-on:
-  workflow_call:
-    inputs:
-      avalonia_version:
-        type: string
-        default: ''
-      force_build:
-        type: boolean
-        default: false
-      publish_to_nuget:
-        type: boolean
-        default: false
-  workflow_dispatch:
-    inputs:
-      avalonia_version:
-        description: Avalonia version to build; empty checks the latest stable 11.x and 12.x versions
-        required: false
-        type: string
-      force_build:
-        description: Build even when this StaticLink.Avalonia.Native version already exists
-        required: true
-        default: false
-        type: boolean
-      publish_to_nuget:
-        description: Publish with NuGet Trusted Publishing after smoke tests
-        required: true
-        default: false
-        type: boolean
-
-jobs:
-  detect:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    outputs:
-      versions: ${{ steps.version.outputs.versions }}
-      should_build: ${{ steps.version.outputs.should_build }}
-    steps:
-      - name: Detect unpublished Avalonia version
-        id: version
-        shell: bash
-        env:
-          REQUESTED_VERSION: ${{ inputs.avalonia_version }}
-          FORCE_BUILD: ${{ inputs.force_build }}
-        run: |
-          set -euo pipefail
-
-          if [ -n "$REQUESTED_VERSION" ]; then
-            candidate_versions=("$REQUESTED_VERSION")
-          else
-            nuget_versions="$(curl --fail --silent --show-error --location \
-              https://api.nuget.org/v3-flatcontainer/avalonia/index.json)"
-            candidate_versions=()
-            for major in 11 12; do
-              candidate_versions+=("$(jq -r --arg major "$major" \
-                '[.versions[] | select(startswith($major + ".") and (contains("-") | not))] | last' \
-                <<< "$nuget_versions")")
-            done
-          fi
-
-          versions='[]'
-          for avalonia_version in "${candidate_versions[@]}"; do
-            if [ -z "$avalonia_version" ] || [ "$avalonia_version" = "null" ]; then
-              echo "Could not determine a stable Avalonia version." >&2
-              exit 1
-            fi
-
-            package_version="$avalonia_version.2"
-            package_url="https://api.nuget.org/v3-flatcontainer/staticlink.avalonia.native/$package_version/staticlink.avalonia.native.$package_version.nupkg"
-            status=$(curl --retry 3 --silent --show-error --location --output /dev/null --write-out '%{http_code}' "$package_url")
-            if [ "$status" != 200 ] && [ "$status" != 404 ]; then
-              echo "NuGet availability check failed: HTTP $status" >&2
-              exit 1
-            fi
-            if [ "$FORCE_BUILD" != "true" ] && [ "$status" = 200 ]; then
-              echo "Already published: $package_version"
-              continue
-            fi
-
-            echo "Build required: $package_version"
-            versions="$(jq -cn --argjson versions "$versions" \
-              --arg avalonia_version "$avalonia_version" \
-              --arg package_version "$package_version" \
-              '$versions + [{avalonia_version: $avalonia_version, package_version: $package_version}]')"
-          done
-
-          echo "versions=$versions" >> "$GITHUB_OUTPUT"
-          if [ "$versions" = '[]' ]; then
-            echo 'should_build=false' >> "$GITHUB_OUTPUT"
-          else
-            echo 'should_build=true' >> "$GITHUB_OUTPUT"
-          fi
-
-  toolchain:
-    needs: detect
-    if: ${{ needs.detect.outputs.should_build == 'true' }}
-    permissions:
-      contents: read
-      packages: write
-    uses: ./.github/workflows/zig-toolchain-image.yml
-    with:
-      validation_rids: '["osx-x64","osx-arm64"]'
-
-  build:
-    needs: [detect, toolchain]
-    if: ${{ needs.detect.outputs.should_build == 'true' }}
-    strategy:
-      fail-fast: false
-      matrix:
-        version: ${{ fromJSON(needs.detect.outputs.versions) }}
-        rid: [osx-x64, osx-arm64]
-        include:
-          - rid: osx-x64
-            runner: macos-14
-          - rid: osx-arm64
-            runner: macos-15
-    runs-on: ubuntu-24.04
-    permissions:
-      contents: read
-      packages: read
-    env:
-      TOOLCHAIN_IMAGE: ${{ needs.toolchain.outputs.image }}
-      RID: ${{ matrix.rid }}
-      AVALONIA_VERSION: ${{ matrix.version.avalonia_version }}
-      WORK_DIR: ${{ github.workspace }}/External/AvaloniaNative/.work
-      OUTPUT_DIR: ${{ github.workspace }}/External/AvaloniaNative/${{ matrix.rid }}/native
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Pull immutable toolchain image
-        env:
-          GH_TOKEN: ${{ github.token }}
-          ACTOR: ${{ github.actor }}
-        run: |
-          printf '%s' "$GH_TOKEN" | docker login ghcr.io -u "$ACTOR" --password-stdin
-          docker pull "$TOOLCHAIN_IMAGE"
-
-      - name: Build static AvaloniaNative and font preinit with Zig
-        run: |
-          mkdir -p "$WORK_DIR" "$OUTPUT_DIR"
-          docker run --rm --user "$(id -u):$(id -g)" \
-            -e HOME=/tmp/staticlink-home -e RID -e AVALONIA_VERSION \
-            -v "$PWD:/src" -w /src --entrypoint bash "$TOOLCHAIN_IMAGE" \
-            scripts/build-avalonia-native-container.sh
-
-      - name: Upload static AvaloniaNative
-        uses: actions/upload-artifact@v4
-        with:
-          name: native-avalonia-${{ matrix.version.avalonia_version }}-${{ matrix.rid }}
-          path: |
-            External/AvaloniaNative/${{ matrix.rid }}/native/libAvaloniaNative.a
-            External/AvaloniaNative/${{ matrix.rid }}/native/macos_font_preinit.o
-            External/AvaloniaNative/${{ matrix.rid }}/native/avalonia-native-build.json
-          if-no-files-found: error
-
-  pack:
-    needs:
-      - detect
-      - build
-    if: ${{ needs.detect.outputs.should_build == 'true' }}
-    strategy:
-      matrix:
-        version: ${{ fromJSON(needs.detect.outputs.versions) }}
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v4
-        with:
-          dotnet-version: "10.0.x"
-
-      - name: Download static AvaloniaNative archives
-        uses: actions/download-artifact@v4
-        with:
-          pattern: native-avalonia-${{ matrix.version.avalonia_version }}-*
-          path: artifacts/native
-          merge-multiple: false
-
-      - name: Prepare package inputs
-        shell: bash
-        run: |
-          set -euo pipefail
-          for rid in osx-x64 osx-arm64; do
-            mkdir -p "External/AvaloniaNative/$rid/native"
-            cp "artifacts/native/native-avalonia-${{ matrix.version.avalonia_version }}-$rid/libAvaloniaNative.a" "External/AvaloniaNative/$rid/native/"
-            cp "artifacts/native/native-avalonia-${{ matrix.version.avalonia_version }}-$rid/macos_font_preinit.o" "External/AvaloniaNative/$rid/native/"
-            cp "artifacts/native/native-avalonia-${{ matrix.version.avalonia_version }}-$rid/avalonia-native-build.json" "External/AvaloniaNative/$rid/native/"
-          done
-
-      - name: Pack StaticLink.Avalonia.Native
-        run: |
-          dotnet pack NuGet/AvaloniaNative/StaticLink.Avalonia.Native.csproj \
-            -c Release \
-            -o artifacts/nuget \
-            /p:PackageVersion=${{ matrix.version.package_version }} \
-            /p:Version=${{ matrix.version.package_version }}
-
-      - name: Upload NuGet package
-        uses: actions/upload-artifact@v4
-        with:
-          name: staticlink-avalonia-native-${{ matrix.version.package_version }}
-          path: artifacts/nuget/*.nupkg
-          if-no-files-found: error
-
-  smoke:
-    needs:
-      - detect
-      - pack
-    if: ${{ needs.detect.outputs.should_build == 'true' }}
-    strategy:
-      fail-fast: false
-      matrix:
-        version: ${{ fromJSON(needs.detect.outputs.versions) }}
-        rid: [osx-x64, osx-arm64]
-        include:
-          - rid: osx-x64
-            runner: macos-14
-          - rid: osx-arm64
-            runner: macos-15
-    runs-on: ${{ matrix.runner }}
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v4
-        with:
-          dotnet-version: "10.0.x"
-
-      - name: Download NuGet package
-        uses: actions/download-artifact@v4
-        with:
-          name: staticlink-avalonia-native-${{ matrix.version.package_version }}
-          path: artifacts/nuget
-
-      - name: Publish Avalonia NativeAOT smoke app
-        shell: pwsh
-        run: |
-          $projectDir = Join-Path $PWD "artifacts/avalonia-native-smoke-src"
-          pwsh ./scripts/create-avalonia-smoke.ps1 `
-            -ProjectDir $projectDir `
-            -NuGetSource (Resolve-Path "artifacts/nuget") `
-            -AvaloniaVersion "${{ matrix.version.avalonia_version }}" `
-            -StaticLinkNativeVersion "${{ matrix.version.package_version }}"
-          dotnet publish (Join-Path $projectDir "AvaloniaStaticLinkSmoke.csproj") `
-            -c Release `
-            -r "${{ matrix.rid }}" `
-            --configfile (Join-Path $projectDir "NuGet.config") `
-            /p:PublishDir="$PWD/artifacts/smoke-${{ matrix.rid }}/"
-
-      - name: Verify AvaloniaNative is statically linked
-        shell: bash
-        run: |
-          set -euo pipefail
-          test ! -f "artifacts/smoke-${{ matrix.rid }}/libAvaloniaNative.dylib"
-          test -x "artifacts/smoke-${{ matrix.rid }}/AvaloniaStaticLinkSmoke"
-
-      - name: Run Avalonia smoke app
-        shell: bash
-        run: |
-          set -euo pipefail
-          cd "artifacts/smoke-${{ matrix.rid }}"
-          python3 - <<'PY'
-          import subprocess
-          import sys
-
-          proc = subprocess.Popen(
-              ["./AvaloniaStaticLinkSmoke"],
-              stdout=subprocess.PIPE,
-              stderr=subprocess.STDOUT,
-              text=True,
-          )
-          try:
-              output, _ = proc.communicate(timeout=15)
-          except subprocess.TimeoutExpired:
-              proc.kill()
-              output, _ = proc.communicate()
-              print(output or "")
-              print("Avalonia smoke app stayed alive for 15 seconds.")
-              sys.exit(0)
-
-          print(output or "")
-          if proc.returncode == 0:
-              sys.exit(0)
-          sys.exit(proc.returncode if proc.returncode > 0 else 1)
-          PY
-
-      - name: Upload AvaloniaNative smoke app
-        if: ${{ always() }}
-        uses: actions/upload-artifact@v4
-        with:
-          name: avalonia-native-smoke-${{ matrix.version.avalonia_version }}-${{ matrix.rid }}
-          path: artifacts/smoke-${{ matrix.rid }}/**
-          if-no-files-found: warn
-
-  publish:
-    needs:
-      - detect
-      - smoke
-    if: ${{ needs.detect.outputs.should_build == 'true' && inputs.publish_to_nuget == true }}
-    strategy:
-      matrix:
-        version: ${{ fromJSON(needs.detect.outputs.versions) }}
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-    steps:
-      - name: Download NuGet package
-        uses: actions/download-artifact@v4
-        with:
-          name: staticlink-avalonia-native-${{ matrix.version.package_version }}
-          path: artifacts/nuget
-
-      - uses: actions/setup-dotnet@v4
-        with:
-          dotnet-version: "10.0.302"
-
-      - name: Validate Trusted Publishing configuration
-        env:
-          NUGET_USER: ${{ vars.NUGET_USER }}
-          NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }}
-        run: |
-          if [ -z "$NUGET_USER" ] && [ -z "$NUGET_API_KEY" ]; then
-            echo 'Configure NUGET_USER with Trusted Publishing or NUGET_API_KEY.' >&2
-            exit 1
-          fi
-
-      - name: NuGet login
-        if: ${{ vars.NUGET_USER != '' }}
-        id: login
-        uses: NuGet/login@v1
-        with:
-          user: ${{ vars.NUGET_USER }}
-
-      - name: Publish to nuget.org
-        env:
-          NUGET_API_KEY: ${{ steps.login.outputs.NUGET_API_KEY || secrets.NUGET_API_KEY }}
-        run: |
-          dotnet nuget push artifacts/nuget/*.nupkg \
-            --source https://www.nuget.org/api/v2/package \
-            --api-key "$NUGET_API_KEY" \
-            --skip-duplicate

.github/workflows/nuget-static-graphics-repack.yml

@@ -0,0 +1,106 @@
+name: staticlink-avalonia-repack
+
+on:
+  workflow_dispatch:
+    inputs:
+      source_version:
+        description: Existing package version containing the static libraries
+        required: true
+        default: 4.150.1-7922.1
+        type: string
+      publish_to_nuget:
+        description: Publish package to nuget.org
+        required: true
+        default: false
+        type: boolean
+
+jobs:
+  repack:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: "10.0.x"
+
+      - name: Extract static libraries from existing package
+        env:
+          SOURCE_VERSION: ${{ inputs.source_version }}
+        run: |
+          python3 - <<'PY'
+          import os
+          import pathlib
+          import urllib.request
+          import zipfile
+
+          version = os.environ["SOURCE_VERSION"]
+          package = pathlib.Path("artifacts/source.nupkg")
+          package.parent.mkdir(parents=True, exist_ok=True)
+          urllib.request.urlretrieve(
+              f"https://api.nuget.org/v3-flatcontainer/staticlink.avalonia/{version}/staticlink.avalonia.{version}.nupkg",
+              package,
+          )
+
+          output = pathlib.Path("External/NativeStatic")
+          with zipfile.ZipFile(package) as archive:
+              for entry in archive.infolist():
+                  name = entry.filename.replace("\\", "/")
+                  if not name.startswith("static/") or name.endswith("/"):
+                      continue
+                  destination = output / name.removeprefix("static/")
+                  destination.parent.mkdir(parents=True, exist_ok=True)
+                  destination.write_bytes(archive.read(entry))
+          PY
+
+      - name: Verify static archives
+        run: |
+          for rid in linux-x64 linux-arm64 linux-musl-x64 linux-musl-arm64 osx-x64 osx-arm64; do
+            test -f External/NativeStatic/$rid/native/libskia.a
+            test -f External/NativeStatic/$rid/native/libSkiaSharp.a
+            test -f External/NativeStatic/$rid/native/libHarfBuzzSharp.a
+            test -f External/NativeStatic/$rid/native/libANGLE_static.a
+            test -f External/NativeStatic/$rid/native/libGLESv2_static.a
+          done
+
+          for rid in win-x64 win-x86 win-arm64; do
+            test -f External/NativeStatic/$rid/native/skia.lib
+            test -f External/NativeStatic/$rid/native/SkiaSharp.lib
+            test -f External/NativeStatic/$rid/native/libHarfBuzzSharp.lib
+            test -f External/NativeStatic/$rid/native/libANGLE_static.lib
+            test -f External/NativeStatic/$rid/native/libGLESv2_static.lib
+          done
+          test -f External/NativeStatic/win-x86/native/skia_x86_stdcall_thunks.lib
+
+      - name: Pack NuGet package
+        run: dotnet pack NuGet/StaticGraphics/StaticLink.Avalonia.csproj -c Release -o artifacts/nuget
+
+      - name: Verify portable NuGet paths
+        run: |
+          package=$(find artifacts/nuget -name 'StaticLink.Avalonia.*.nupkg' ! -name 'StaticLink.Avalonia.Native.*.nupkg' -print -quit)
+          test -n "$package"
+          if unzip -Z1 "$package" | grep -F '\'; then
+            echo "NuGet package contains Windows-only backslash paths."
+            exit 1
+          fi
+          unzip -Z1 "$package" | grep -Fx 'buildTransitive/StaticLink.Avalonia.props'
+          unzip -Z1 "$package" | grep -Fx 'buildTransitive/StaticLink.Avalonia.targets'
+
+      - name: Upload NuGet artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: staticlink-avalonia-repacked-nuget
+          path: artifacts/nuget/*.nupkg
+          if-no-files-found: error
+
+      - name: Publish to nuget.org
+        if: ${{ inputs.publish_to_nuget == true }}
+        env:
+          NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }}
+        run: |
+          test -n "$NUGET_API_KEY"
+          dotnet nuget push artifacts/nuget/*.nupkg \
+            --source "https://api.nuget.org/v3/index.json" \
+            --api-key "$NUGET_API_KEY" \
+            --skip-duplicate

.github/workflows/nuget-static-graphics.yml

@@ -0,0 +1,598 @@
+name: staticlink-avalonia
+
+on:
+  workflow_dispatch:
+    inputs:
+      environment_only:
+        description: Validate the complete toolchain container without building release libraries
+        type: boolean
+        default: false
+      skiasharp_version:
+        description: Stable SkiaSharp version from this branch major; empty uses the branch version
+        type: string
+        default: ''
+      native_package_revision:
+        description: Published AvaloniaNative revision for independent graphics smoke tests
+        type: string
+        default: '1'
+      publish_to_nuget:
+        description: Publish package to nuget.org
+        required: true
+        default: false
+        type: boolean
+      publish_to_release:
+        description: Publish NuGet package and smoke apps to GitHub Release
+        required: true
+        default: false
+        type: boolean
+  push:
+    tags:
+      - "staticlink-avalonia-v*"
+
+env:
+  DOTNET_ALPINE_IMAGE: mcr.microsoft.com/dotnet/sdk:10.0.302-alpine3.23
+
+concurrency:
+  group: graphics-${{ github.ref }}-${{ inputs.skiasharp_version }}
+  cancel-in-progress: false
+
+jobs:
+  environment:
+    permissions:
+      contents: read
+      packages: write
+    uses: ./.github/workflows/zig-toolchain-image.yml
+
+  preflight:
+    if: ${{ inputs.environment_only != true }}
+    uses: ./.github/workflows/static-graphics-preflight.yml
+    with:
+      skiasharp_version: ${{ inputs.skiasharp_version }}
+
+  build-zig:
+    permissions:
+      contents: read
+      packages: write
+    needs: [preflight, environment]
+    uses: ./.github/workflows/static-graphics-zig-cross.yml
+    with:
+      skiasharp_version: ${{ needs.preflight.outputs.skiasharp_version }}
+      source_lock: ${{ needs.preflight.outputs.source_lock }}
+      toolchain_image: ${{ needs.environment.outputs.image }}
+
+  pack:
+    runs-on: ubuntu-24.04
+    needs:
+      - preflight
+      - build-zig
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: "10.0.302"
+
+      - name: Download static archives
+        uses: actions/download-artifact@v4
+        with:
+          pattern: native-static-*
+          path: External/NativeStatic
+          merge-multiple: false
+
+      - name: Move static archives into RID directories
+        run: |
+          for rid in win-x64 win-x86 win-arm64 linux-x64 linux-arm64 linux-musl-x64 linux-musl-arm64 osx-x64 osx-arm64; do
+            mkdir -p "External/NativeStatic/$rid"
+            mv "External/NativeStatic/native-static-$rid"/* "External/NativeStatic/$rid/"
+            rmdir "External/NativeStatic/native-static-$rid"
+            if [ ! -d "External/NativeStatic/$rid/native" ]; then
+              mkdir -p "External/NativeStatic/$rid/native"
+              find "External/NativeStatic/$rid" -maxdepth 1 -type f -exec mv {} "External/NativeStatic/$rid/native/" \;
+            fi
+          done
+
+      - name: Verify static archives
+        run: |
+          for rid in linux-x64 linux-arm64 linux-musl-x64 linux-musl-arm64 osx-x64 osx-arm64; do
+            test -f External/NativeStatic/$rid/native/libskia.a
+            test -f External/NativeStatic/$rid/native/libSkiaSharp.a
+            test -f External/NativeStatic/$rid/native/libHarfBuzzSharp.a
+            test -f External/NativeStatic/$rid/native/libANGLE_static.a
+            test -f External/NativeStatic/$rid/native/libGLESv2_static.a
+          done
+
+          for rid in win-x64 win-x86 win-arm64; do
+            test -f External/NativeStatic/$rid/native/skia.lib
+            test -f External/NativeStatic/$rid/native/SkiaSharp.lib
+            test -f External/NativeStatic/$rid/native/libHarfBuzzSharp.lib
+            test -f External/NativeStatic/$rid/native/libANGLE_static.lib
+            test -f External/NativeStatic/$rid/native/libGLESv2_static.lib
+          done
+          test -f External/NativeStatic/win-x86/native/skia_x86_stdcall_thunks.lib
+
+      - name: Pack NuGet package
+        env:
+          SOURCE_LOCK_JSON: ${{ needs.preflight.outputs.source_lock }}
+          PACKAGE_VERSION: ${{ needs.preflight.outputs.package_version }}
+          SKIASHARP_VERSION: ${{ needs.preflight.outputs.skiasharp_version }}
+        run: |
+          python3 scripts/apply-release-version.py
+          dotnet pack NuGet/StaticGraphics/StaticLink.Avalonia.csproj -c Release -o artifacts/nuget
+
+      - name: Verify portable NuGet paths
+        shell: bash
+        run: |
+          package=$(find artifacts/nuget -name 'StaticLink.Avalonia.*.nupkg' ! -name 'StaticLink.Avalonia.Native.*.nupkg' -print -quit)
+          test -n "$package"
+          if unzip -Z1 "$package" | grep -F '\'; then
+            echo "NuGet package contains Windows-only backslash paths."
+            exit 1
+          fi
+          unzip -Z1 "$package" | grep -Fx 'buildTransitive/StaticLink.Avalonia.props'
+          unzip -Z1 "$package" | grep -Fx 'buildTransitive/StaticLink.Avalonia.targets'
+
+      - name: Upload release source lock
+        uses: actions/upload-artifact@v4
+        with:
+          name: graphics-release-source-lock
+          path: build/linux-toolchain/release.lock.json
+          if-no-files-found: error
+
+      - name: Upload NuGet artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: staticlink-avalonia-nuget
+          path: |
+            artifacts/nuget/*.nupkg
+            artifacts/nuget/*.snupkg
+          if-no-files-found: error
+
+  smoke-avalonia:
+    needs: pack
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - rid: win-x64
+            runner: windows-2022
+            msvc_arch: x64
+          - rid: win-x86
+            runner: windows-2022
+            msvc_arch: x86
+          - rid: win-arm64
+            runner: windows-2022
+            msvc_arch: amd64_arm64
+          - rid: linux-x64
+            runner: ubuntu-24.04
+          - rid: linux-arm64
+            runner: ubuntu-24.04-arm
+          - rid: linux-musl-x64
+            runner: ubuntu-24.04
+          - rid: linux-musl-arm64
+            runner: ubuntu-24.04-arm
+          - rid: osx-x64
+            runner: macos-15
+            avalonia_version: 11.3.14
+          - rid: osx-arm64
+            runner: macos-15
+            avalonia_version: 11.3.14
+    runs-on: ${{ matrix.runner }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup MSVC environment
+        if: ${{ startsWith(matrix.rid, 'win-') }}
+        uses: ilammy/msvc-dev-cmd@v1
+        with:
+          arch: ${{ matrix.msvc_arch }}
+
+      - name: Install LLVM linker for Zig Windows archives
+        if: ${{ startsWith(matrix.rid, 'win-') }}
+        shell: pwsh
+        run: choco install llvm -y
+
+      - name: Install Linux publish dependencies
+        if: ${{ startsWith(matrix.rid, 'linux-') && !startsWith(matrix.rid, 'linux-musl-') }}
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clang lld xvfb zlib1g-dev libfontconfig1-dev libffi-dev libwayland-dev libx11-dev libxext-dev libxcb1-dev libfreetype6 libgl1 libice6 libsm6 libx11-6 libxcb1 libxcursor1 libxext6 libxfixes3 libxinerama1 libxrandr2 libxrender1 libxi6
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: "10.0.302"
+
+      - name: Download NuGet package
+        uses: actions/download-artifact@v4
+        with:
+          name: staticlink-avalonia-nuget
+          path: artifacts/nuget
+
+      - name: Publish Avalonia single-file smoke app
+        if: ${{ !startsWith(matrix.rid, 'linux-musl-') }}
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = "Stop"
+          $package = Get-ChildItem -Path "artifacts/nuget" -Filter "StaticLink.Avalonia.*.nupkg" | Where-Object { $_.Name -notlike "StaticLink.Avalonia.Native.*" } | Select-Object -First 1
+          if (-not $package) { throw "StaticLink NuGet package was not downloaded." }
+          if ($package.BaseName -notmatch '^StaticLink\.Avalonia\.(.+)$') { throw "Unexpected package name: $($package.Name)" }
+          $version = $Matches[1]
+          $avaloniaVersion = "${{ matrix.avalonia_version }}"
+          if (-not $avaloniaVersion) { $avaloniaVersion = "11.3.14" }
+          $projectDir = Join-Path $PWD "artifacts/avalonia-smoke-src"
+          $nativeVersion = ""
+          if ("${{ matrix.rid }}".StartsWith("osx-")) { $nativeVersion = "$avaloniaVersion.${{ inputs.native_package_revision || '1' }}" }
+          pwsh ./scripts/create-avalonia-smoke.ps1 -ProjectDir $projectDir -NuGetSource (Resolve-Path "artifacts/nuget") -StaticLinkVersion $version -AvaloniaVersion $avaloniaVersion -StaticLinkNativeVersion $nativeVersion
+          dotnet publish (Join-Path $projectDir "AvaloniaStaticLinkSmoke.csproj") `
+            -c Release `
+            -r "${{ matrix.rid }}" `
+            --configfile (Join-Path $projectDir "NuGet.config") `
+            /p:PublishAot=true `
+            /p:SelfContained=true `
+            /p:PublishSingleFile=true `
+            /p:StripSymbols=true `
+            /p:PublishDir="$PWD/artifacts/smoke-${{ matrix.rid }}/"
+
+      - name: Publish Avalonia musl smoke app
+        if: ${{ startsWith(matrix.rid, 'linux-musl-') }}
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = "Stop"
+          $package = Get-ChildItem -Path "artifacts/nuget" -Filter "StaticLink.Avalonia.*.nupkg" | Where-Object { $_.Name -notlike "StaticLink.Avalonia.Native.*" } | Select-Object -First 1
+          if (-not $package) { throw "StaticLink NuGet package was not downloaded." }
+          if ($package.BaseName -notmatch '^StaticLink\.Avalonia\.(.+)$') { throw "Unexpected package name: $($package.Name)" }
+          $version = $Matches[1]
+          $projectDir = Join-Path $PWD "artifacts/avalonia-smoke-src"
+          pwsh ./scripts/create-avalonia-smoke.ps1 -ProjectDir $projectDir -NuGetSource "/workspace/artifacts/nuget" -StaticLinkVersion $version -AvaloniaVersion "11.3.14"
+          docker run --rm `
+            -v "${{ github.workspace }}:/workspace" `
+            -w /workspace `
+            "${{ env.DOTNET_ALPINE_IMAGE }}" `
+            sh -c "apk add --no-cache clang lld build-base zlib-dev fontconfig-dev libffi-dev wayland-dev libx11-dev libxext-dev libxcb-dev && dotnet publish /workspace/artifacts/avalonia-smoke-src/AvaloniaStaticLinkSmoke.csproj -c Release -r ${{ matrix.rid }} --configfile /workspace/artifacts/avalonia-smoke-src/NuGet.config /p:PublishAot=true /p:SelfContained=true /p:PublishSingleFile=true /p:StripSymbols=true /p:PublishDir=/workspace/artifacts/smoke-${{ matrix.rid }}/"
+
+      - name: Verify no dynamic graphics libraries remain
+        shell: pwsh
+        run: |
+          $publishDir = "artifacts/smoke-${{ matrix.rid }}"
+          $blocked = Get-ChildItem -Path $publishDir -Recurse -File | Where-Object {
+            $_.Name -in @("libSkiaSharp.dll", "libHarfBuzzSharp.dll", "av_libglesv2.dll", "libSkiaSharp.so", "libHarfBuzzSharp.so", "libSkiaSharp.dylib", "libHarfBuzzSharp.dylib")
+          }
+          if ($blocked) {
+            $blocked | ForEach-Object { Write-Error "Unexpected dynamic graphics library: $($_.FullName)" }
+            exit 1
+          }
+          Get-ChildItem -Path $publishDir -Recurse -File | ForEach-Object { $_.FullName }
+
+      - name: Verify Windows executable architecture
+        if: ${{ startsWith(matrix.rid, 'win-') }}
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = "Stop"
+          $app = Join-Path $PWD "artifacts/smoke-${{ matrix.rid }}/AvaloniaStaticLinkSmoke.exe"
+          $expectedMachine = @{
+            "win-x64" = "8664 machine"
+            "win-x86" = "14C machine"
+            "win-arm64" = "AA64 machine"
+          }["${{ matrix.rid }}"]
+          $headers = & dumpbin /headers $app | Out-String
+          if ($LASTEXITCODE -ne 0 -or $headers -notmatch [regex]::Escape($expectedMachine)) {
+            throw "Expected $expectedMachine in PE headers for $app.`n$headers"
+          }
+
+      - name: Run Windows Avalonia smoke app
+        if: ${{ matrix.rid == 'win-x64' || matrix.rid == 'win-x86' }}
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = "Stop"
+          $publishDir = Join-Path $PWD "artifacts/smoke-${{ matrix.rid }}"
+          $app = Join-Path $publishDir "AvaloniaStaticLinkSmoke.exe"
+          $process = Start-Process -FilePath $app -WorkingDirectory $publishDir -PassThru
+          if ($process.WaitForExit(15000)) {
+            if ($process.ExitCode -eq 0) {
+              Write-Host "Avalonia Windows smoke app exited normally."
+              exit 0
+            }
+            throw "Avalonia Windows smoke app failed with exit code $($process.ExitCode)."
+          }
+
+          Stop-Process -Id $process.Id -Force
+          Write-Host "Avalonia Windows smoke app stayed alive for 15 seconds."
+
+      - name: Run Linux Avalonia smoke app
+        if: ${{ startsWith(matrix.rid, 'linux-') && !startsWith(matrix.rid, 'linux-musl-') }}
+        shell: bash
+        run: |
+          set +e
+          cd "artifacts/smoke-${{ matrix.rid }}"
+          chmod +x ./AvaloniaStaticLinkSmoke
+          timeout 15s xvfb-run -a ./AvaloniaStaticLinkSmoke
+          code=$?
+          if [ "$code" = 124 ] || [ "$code" = 143 ]; then
+            echo "Avalonia Linux smoke app stayed alive for 15 seconds."
+            exit 0
+          fi
+          exit "$code"
+
+      - name: Verify musl ELF dependencies
+        if: ${{ startsWith(matrix.rid, 'linux-musl-') }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          docker run --rm \
+            -v "${{ github.workspace }}:/workspace" \
+            -w /workspace \
+            alpine:3.23 \
+            sh -c 'apk add --no-cache binutils pax-utils && app="artifacts/smoke-${{ matrix.rid }}/AvaloniaStaticLinkSmoke" && readelf -l "$app" | grep "Requesting program interpreter: /lib/ld-musl-" && scanelf -n "$app" && ! scanelf -n "$app" | grep -E "ld-linux|ld64.so"'
+
+      - name: Run Linux musl Avalonia smoke app
+        if: ${{ startsWith(matrix.rid, 'linux-musl-') }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          docker run --rm \
+            -v "${{ github.workspace }}:/workspace" \
+            -w /workspace/artifacts/smoke-${{ matrix.rid }} \
+            alpine:3.23 \
+            sh -c 'apk add --no-cache xvfb-run libstdc++ libgcc fontconfig freetype ttf-dejavu libx11 libxcb libxext libxrender libxi libxrandr libxcursor libxfixes libxinerama libice libsm mesa-gl mesa-egl && fc-cache -f && fc-match sans && chmod +x ./AvaloniaStaticLinkSmoke && timeout 15s xvfb-run -a ./AvaloniaStaticLinkSmoke || code=$?; if [ "${code:-0}" = 124 ] || [ "${code:-0}" = 143 ]; then echo "Avalonia musl smoke app stayed alive for 15 seconds."; exit 0; fi; exit "${code:-0}"'
+
+      - name: Run macOS Avalonia smoke app
+        if: ${{ startsWith(matrix.rid, 'osx-') }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          cd "artifacts/smoke-${{ matrix.rid }}"
+          chmod +x ./AvaloniaStaticLinkSmoke
+          python3 - <<'PY'
+          import pathlib
+          import subprocess
+          import sys
+
+          log = pathlib.Path("avalonia-smoke-run.log")
+          proc = subprocess.Popen(
+              ["./AvaloniaStaticLinkSmoke"],
+              stdout=subprocess.PIPE,
+              stderr=subprocess.STDOUT,
+              text=True,
+          )
+
+          try:
+              output, _ = proc.communicate(timeout=15)
+          except subprocess.TimeoutExpired:
+              proc.kill()
+              output, _ = proc.communicate()
+              log.write_text(output or "")
+              print(output or "")
+              print("Avalonia smoke app stayed alive for 15 seconds.")
+              sys.exit(0)
+
+          log.write_text(output or "")
+          print(output or "")
+          if proc.returncode == 0:
+              print("Avalonia smoke app exited normally.")
+              sys.exit(0)
+
+          print(f"Avalonia smoke app failed with exit code {proc.returncode}.", file=sys.stderr)
+          sys.exit(proc.returncode if proc.returncode > 0 else 1)
+          PY
+
+      - name: Upload Avalonia smoke app
+        if: ${{ always() }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: avalonia-smoke-${{ matrix.rid }}
+          path: artifacts/smoke-${{ matrix.rid }}/**
+          if-no-files-found: warn
+
+  smoke-macos-metal:
+    runs-on: macos-15
+    needs: pack
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: "10.0.302"
+
+      - name: Download NuGet package
+        uses: actions/download-artifact@v4
+        with:
+          name: staticlink-avalonia-nuget
+          path: artifacts/nuget
+
+      - name: Publish Avalonia 12 macOS arm64 smoke app
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = "Stop"
+          $package = Get-ChildItem -Path "artifacts/nuget" -Filter "StaticLink.Avalonia.*.nupkg" | Where-Object { $_.Name -notlike "StaticLink.Avalonia.Native.*" } | Select-Object -First 1
+          if (-not $package) { throw "StaticLink NuGet package was not downloaded." }
+          if ($package.BaseName -notmatch '^StaticLink\.Avalonia\.(.+)$') { throw "Unexpected package name: $($package.Name)" }
+          $projectDir = Join-Path $PWD "artifacts/avalonia-metal-smoke-src"
+          pwsh ./scripts/create-avalonia-smoke.ps1 `
+            -ProjectDir $projectDir `
+            -NuGetSource (Resolve-Path "artifacts/nuget") `
+            -StaticLinkVersion $Matches[1] `
+            -AvaloniaVersion "12.1.0" `
+            -StaticLinkNativeVersion "12.1.0.${{ inputs.native_package_revision || '1' }}"
+          dotnet publish (Join-Path $projectDir "AvaloniaStaticLinkSmoke.csproj") `
+            -c Release `
+            -r osx-arm64 `
+            --configfile (Join-Path $projectDir "NuGet.config") `
+            /p:PublishAot=true `
+            /p:SelfContained=true `
+            /p:PublishSingleFile=true `
+            /p:StripSymbols=true `
+            /p:PublishDir="$PWD/artifacts/smoke-osx-arm64-metal/"
+
+      - name: Verify fully static third-party libraries
+        shell: bash
+        run: |
+          set -euo pipefail
+          publish_dir="artifacts/smoke-osx-arm64-metal"
+          test -x "$publish_dir/AvaloniaStaticLinkSmoke"
+          for library in libAvaloniaNative.dylib libSkiaSharp.dylib libHarfBuzzSharp.dylib; do
+            test ! -f "$publish_dir/$library"
+          done
+
+      - name: Run default and Metal-only smoke tests
+        shell: bash
+        run: |
+          set -euo pipefail
+          cd artifacts/smoke-osx-arm64-metal
+          python3 - <<'PY'
+          import os
+          import pathlib
+          import subprocess
+
+          for renderer in ("default", "metal"):
+              environment = os.environ.copy()
+              environment["STATICLINK_MAC_RENDERER"] = renderer
+              environment["STATICLINK_SMOKE_AUTOCLOSE"] = "1"
+              try:
+                  result = subprocess.run(
+                      ["./AvaloniaStaticLinkSmoke"],
+                      env=environment,
+                      stdout=subprocess.PIPE,
+                      stderr=subprocess.STDOUT,
+                      text=True,
+                      timeout=15,
+                  )
+              except subprocess.TimeoutExpired as exception:
+                  output = exception.stdout or ""
+                  if isinstance(output, bytes):
+                      output = output.decode(errors="replace")
+                  pathlib.Path(f"avalonia-{renderer}.log").write_text(output)
+                  raise SystemExit(f"Avalonia {renderer} smoke app timed out.\n{output}")
+
+              output = result.stdout or ""
+              pathlib.Path(f"avalonia-{renderer}.log").write_text(output)
+              print(output, end="")
+              marker = f"STATICLINK_SMOKE_READY={renderer}"
+              if result.returncode != 0 or marker not in output.splitlines():
+                  raise SystemExit(f"Avalonia {renderer} smoke app failed with exit code {result.returncode}.")
+          PY
+
+      - name: Upload macOS Metal smoke app
+        if: ${{ always() }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: avalonia-smoke-osx-arm64-metal
+          path: artifacts/smoke-osx-arm64-metal/**
+          if-no-files-found: warn
+
+  publish-nuget:
+    permissions:
+      contents: read
+      id-token: write
+    runs-on: ubuntu-24.04
+    needs:
+      - pack
+      - smoke-avalonia
+      - smoke-macos-metal
+    steps:
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: "10.0.302"
+
+      - name: Download NuGet package
+        uses: actions/download-artifact@v4
+        with:
+          name: staticlink-avalonia-nuget
+          path: artifacts/nuget
+
+      - name: NuGet Trusted Publishing login
+        id: login
+        if: ${{ vars.NUGET_USER != '' && (startsWith(github.ref, 'refs/tags/staticlink-avalonia-v') || inputs.publish_to_nuget == true) }}
+        uses: NuGet/login@v1
+        with:
+          user: ${{ vars.NUGET_USER }}
+
+      - name: Publish to nuget.org
+        if: ${{ startsWith(github.ref, 'refs/tags/staticlink-avalonia-v') || (github.event_name == 'workflow_dispatch' && inputs.publish_to_nuget == true) }}
+        env:
+          NUGET_API_KEY: ${{ steps.login.outputs.NUGET_API_KEY || secrets.NUGET_API_KEY }}
+        run: |
+          if [ -z "$NUGET_API_KEY" ]; then
+            echo "NUGET_API_KEY secret is not configured." >&2
+            exit 1
+          fi
+
+          for package in artifacts/nuget/*.nupkg; do
+            dotnet nuget push "$package" \
+              --source "https://api.nuget.org/v3/index.json" \
+              --api-key "$NUGET_API_KEY" \
+              --skip-duplicate
+          done
+
+  release:
+    runs-on: ubuntu-24.04
+    needs:
+      - preflight
+      - pack
+      - smoke-avalonia
+      - smoke-macos-metal
+      - publish-nuget
+    if: ${{ startsWith(github.ref, 'refs/tags/staticlink-avalonia-v') || (github.event_name == 'workflow_dispatch' && inputs.publish_to_release == true) }}
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download NuGet artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: staticlink-avalonia-nuget
+          path: release-artifacts/staticlink-avalonia-nuget
+
+      - name: Download release source lock
+        uses: actions/download-artifact@v4
+        with:
+          name: graphics-release-source-lock
+          path: release-artifacts/source-lock
+
+      - name: Download smoke artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: avalonia-smoke-*
+          path: release-artifacts
+          merge-multiple: false
+
+      - name: Prepare release files
+        run: |
+          mkdir -p release-files
+          cp release-artifacts/source-lock/release.lock.json release-files/
+          find release-artifacts/staticlink-avalonia-nuget -type f \( -name '*.nupkg' -o -name '*.snupkg' \) -exec cp {} release-files/ \;
+          for dir in release-artifacts/avalonia-smoke-*; do
+            [ -d "$dir" ] || continue
+            name="$(basename "$dir")"
+            (cd "$dir" && zip -r "../../release-files/$name.zip" .)
+          done
+          ls -la release-files
+
+      - name: Publish GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          PACKAGE_VERSION: ${{ needs.preflight.outputs.package_version }}
+        run: |
+          if [ "${GITHUB_REF_TYPE}" = "tag" ]; then
+            release_tag="${GITHUB_REF_NAME}"
+            title="${GITHUB_REF_NAME}"
+          else
+            release_tag="staticlink-avalonia-v${PACKAGE_VERSION}"
+            title="StaticLink.Avalonia ${PACKAGE_VERSION}"
+          fi
+
+          if gh release view "$release_tag" >/dev/null 2>&1; then
+            gh release upload "$release_tag" release-files/* --clobber
+          else
+            gh release create "$release_tag" release-files/* \
+              --target "$GITHUB_SHA" \
+              --title "$title" \
+              --notes "NuGet package plus Avalonia 11.3.14 NativeAOT single-file smoke apps for win-x64, win-x86, win-arm64, linux-x64, linux-arm64, linux-musl-x64, linux-musl-arm64, osx-x64, and osx-arm64."
+          fi

.github/workflows/static-graphics-linux-debian.yml

@@ -0,0 +1,28 @@
+name: static-graphics-linux-debian-zig
+
+on:
+  workflow_call:
+    inputs:
+      skiasharp_version:
+        required: true
+        type: string
+      source_lock:
+        type: string
+        default: ''
+  workflow_dispatch:
+    inputs:
+      skiasharp_version:
+        type: string
+        default: '4.150.1'
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  build:
+    uses: ./.github/workflows/static-graphics-zig-cross.yml
+    with:
+      skiasharp_version: ${{ inputs.skiasharp_version }}
+      source_lock: ${{ inputs.source_lock || '' }}
+      rids: '["linux-x64","linux-arm64","linux-musl-x64","linux-musl-arm64"]'

.github/workflows/static-graphics-linux.yml

@@ -0,0 +1,28 @@
+name: static-graphics-linux-zig
+
+on:
+  workflow_call:
+    inputs:
+      skiasharp_version:
+        required: true
+        type: string
+      source_lock:
+        type: string
+        default: ''
+  workflow_dispatch:
+    inputs:
+      skiasharp_version:
+        type: string
+        default: '4.150.1'
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  build:
+    uses: ./.github/workflows/static-graphics-zig-cross.yml
+    with:
+      skiasharp_version: ${{ inputs.skiasharp_version }}
+      source_lock: ${{ inputs.source_lock || '' }}
+      rids: '["linux-x64","linux-arm64"]'

.github/workflows/static-graphics-macos.yml

@@ -0,0 +1,28 @@
+name: static-graphics-macos-zig
+
+on:
+  workflow_call:
+    inputs:
+      skiasharp_version:
+        required: true
+        type: string
+      source_lock:
+        type: string
+        default: ''
+  workflow_dispatch:
+    inputs:
+      skiasharp_version:
+        type: string
+        default: '4.150.1'
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  build:
+    uses: ./.github/workflows/static-graphics-zig-cross.yml
+    with:
+      skiasharp_version: ${{ inputs.skiasharp_version }}
+      source_lock: ${{ inputs.source_lock || '' }}
+      rids: '["osx-x64","osx-arm64"]'

.github/workflows/static-graphics-musl.yml

@@ -0,0 +1,28 @@
+name: static-graphics-musl-zig
+
+on:
+  workflow_call:
+    inputs:
+      skiasharp_version:
+        required: true
+        type: string
+      source_lock:
+        type: string
+        default: ''
+  workflow_dispatch:
+    inputs:
+      skiasharp_version:
+        type: string
+        default: '4.150.1'
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  build:
+    uses: ./.github/workflows/static-graphics-zig-cross.yml
+    with:
+      skiasharp_version: ${{ inputs.skiasharp_version }}
+      source_lock: ${{ inputs.source_lock || '' }}
+      rids: '["linux-musl-x64","linux-musl-arm64"]'

.github/workflows/static-graphics-preflight.yml

@@ -0,0 +1,99 @@
+name: static-graphics-preflight
+
+on:
+  workflow_call:
+    inputs:
+      skiasharp_version:
+        type: string
+        default: ''
+    outputs:
+      source_lock:
+        value: ${{ jobs.validate.outputs.source_lock }}
+      package_version:
+        value: ${{ jobs.validate.outputs.package_version }}
+      skiasharp_version:
+        value: ${{ jobs.validate.outputs.skiasharp_version }}
+      angle_branch:
+        value: ${{ jobs.validate.outputs.angle_branch }}
+  workflow_dispatch:
+
+jobs:
+  validate:
+    runs-on: ubuntu-24.04
+    outputs:
+      source_lock: ${{ steps.versions.outputs.source_lock }}
+      package_version: ${{ steps.versions.outputs.package_version }}
+      skiasharp_version: ${{ steps.versions.outputs.skiasharp_version }}
+      angle_branch: ${{ steps.versions.outputs.angle_branch }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: "10.0.302"
+
+      - name: Read and validate versions
+        id: versions
+        shell: bash
+        env:
+          REQUESTED_VERSION: ${{ inputs.skiasharp_version }}
+        run: |
+          if [ "${GITHUB_REF_TYPE:-}" = tag ] && [ -z "$REQUESTED_VERSION" ]; then
+            tag_version="${GITHUB_REF_NAME#staticlink-avalonia-v}"
+            REQUESTED_VERSION="${tag_version%%-*}"
+          fi
+          python3 scripts/resolve-release-lock.py --version "$REQUESTED_VERSION"
+          python3 - <<'PY'
+          import os
+          import pathlib
+          import xml.etree.ElementTree as ET
+
+          project = pathlib.Path("NuGet/StaticGraphics/StaticLink.Avalonia.csproj")
+          root = ET.parse(project).getroot()
+          import json
+          lock = json.loads(pathlib.Path("build/linux-toolchain/release.lock.json").read_text())
+          package_version = root.findtext(".//Version")
+          package_version = lock["skiasharp_version"] + "-" + package_version.split("-", 1)[1]
+          skia_reference = next(
+              item.attrib["Version"]
+              for item in root.findall(".//PackageReference")
+              if item.attrib.get("Include") == "SkiaSharp"
+          )
+          version_base, revision = package_version.rsplit(".", 1)
+          skiasharp_version, angle_branch = version_base.split("-", 1)
+          if not revision.isdigit() or skiasharp_version != lock["skiasharp_version"]:
+              raise SystemExit(f"Inconsistent package version: {package_version}, SkiaSharp: {skia_reference}")
+          if os.environ.get("GITHUB_REF_TYPE") == "tag":
+              expected_tag = f"staticlink-avalonia-v{package_version}"
+              if os.environ.get("GITHUB_REF_NAME") != expected_tag:
+                  raise SystemExit(f"Release tag must be {expected_tag}")
+
+          with open(os.environ["GITHUB_OUTPUT"], "a", encoding="utf-8") as output:
+              output.write("source_lock=" + json.dumps(lock, separators=(",", ":")) + "\n")
+              output.write(f"package_version={package_version}\n")
+              output.write(f"skiasharp_version={skiasharp_version}\n")
+              output.write(f"angle_branch={angle_branch}\n")
+          PY
+
+      - name: Validate upstream refs and ANGLE patch
+        env:
+          SKIASHARP_VERSION: ${{ steps.versions.outputs.skiasharp_version }}
+          ANGLE_BRANCH: ${{ steps.versions.outputs.angle_branch }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          git ls-remote --exit-code --tags https://github.com/mono/SkiaSharp.git "refs/tags/v${SKIASHARP_VERSION}"
+          git clone --depth 1 --branch "chromium/${ANGLE_BRANCH}" https://github.com/google/angle.git /tmp/staticlink-angle
+          git -C /tmp/staticlink-angle apply --check "$GITHUB_WORKSPACE/External/NativeStatic/patches/angle-chromium-${ANGLE_BRANCH}.patch"
+
+      - name: Validate scripts
+        shell: bash
+        run: |
+          set -euo pipefail
+          bash -n scripts/build-linux-static-graphics.sh
+          bash -n scripts/build-macos-static-graphics.sh
+          pwsh -NoProfile -Command '$files = @("scripts/build-windows-static-graphics.ps1", "scripts/create-avalonia-smoke.ps1"); foreach ($file in $files) { $errors = $null; [System.Management.Automation.Language.Parser]::ParseFile((Resolve-Path $file), [ref]$null, [ref]$errors) | Out-Null; if ($errors.Count) { $errors | Format-List | Out-String; exit 1 } }'
+
+      - name: Compile smoke project
+        run: dotnet build Smoke/AvaloniaStaticLinkSmoke/AvaloniaStaticLinkSmoke.csproj -c Release -p:PublishAot=false

.github/workflows/static-graphics-windows.yml

@@ -0,0 +1,28 @@
+name: static-graphics-windows-zig
+
+on:
+  workflow_call:
+    inputs:
+      skiasharp_version:
+        required: true
+        type: string
+      source_lock:
+        type: string
+        default: ''
+  workflow_dispatch:
+    inputs:
+      skiasharp_version:
+        type: string
+        default: '4.150.1'
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  build:
+    uses: ./.github/workflows/static-graphics-zig-cross.yml
+    with:
+      skiasharp_version: ${{ inputs.skiasharp_version }}
+      source_lock: ${{ inputs.source_lock || '' }}
+      rids: '["win-x64","win-x86","win-arm64"]'

.github/workflows/static-graphics-zig-cross.yml

@@ -0,0 +1,111 @@
+name: static-graphics-zig-cross-debian12
+
+# All native archives are compiled with Zig on Linux; platform runners validate consumer apps.
+on:
+  workflow_call:
+    inputs:
+      skiasharp_version:
+        type: string
+        required: true
+      toolchain_image:
+        type: string
+        default: ''
+      rids:
+        type: string
+        default: '["linux-x64","linux-arm64","linux-musl-x64","linux-musl-arm64","win-x64","win-x86","win-arm64","osx-x64","osx-arm64"]'
+      artifact_prefix:
+        type: string
+        default: native-static
+      source_lock:
+        type: string
+        required: true
+  workflow_dispatch:
+    inputs:
+      skiasharp_version:
+        description: Locked SkiaSharp release profile
+        type: string
+        default: '4.150.1'
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  image:
+    if: ${{ inputs.toolchain_image == '' }}
+    uses: ./.github/workflows/zig-toolchain-image.yml
+
+  build:
+    needs: image
+    if: ${{ always() && (needs.image.result == 'success' || inputs.toolchain_image != '') }}
+    permissions:
+      contents: read
+      packages: read
+    env:
+      TOOLCHAIN_IMAGE: ${{ inputs.toolchain_image || needs.image.outputs.image }}
+    timeout-minutes: 180
+    runs-on: ubuntu-24.04
+    strategy:
+      fail-fast: false
+      matrix:
+        rid: ${{ fromJSON(inputs.rids || '["linux-x64","linux-arm64","linux-musl-x64","linux-musl-arm64","win-x64","win-x86","win-arm64","osx-x64","osx-arm64"]') }}
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - name: Resolve immutable build inputs
+        env:
+          SOURCE_LOCK_JSON: ${{ inputs.source_lock }}
+          REQUESTED_VERSION: ${{ inputs.skiasharp_version }}
+        run: |
+          if [ -n "$SOURCE_LOCK_JSON" ]; then
+            python3 - <<'PY'
+          import json, os, pathlib
+          lock = json.loads(os.environ['SOURCE_LOCK_JSON'])
+          if lock['skiasharp_version'] != os.environ['REQUESTED_VERSION']:
+              raise SystemExit('Source lock does not match requested version')
+          pathlib.Path('build/linux-toolchain/release.lock.json').write_text(json.dumps(lock, indent=2) + '\n')
+          PY
+          else
+            python3 scripts/resolve-release-lock.py --version "$REQUESTED_VERSION"
+          fi
+      - name: Restore exact target cache
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4
+        with:
+          path: External/NativeStatic/.work
+          key: zig-debian12-v3-${{ inputs.skiasharp_version }}-${{ matrix.rid }}-${{ hashFiles('build/linux-toolchain/**', 'scripts/prepare-cross-sources.sh', 'scripts/build-linux-static-graphics.sh', 'External/NativeStatic/patches/*.patch') }}
+      - name: Pull immutable toolchain image
+        env:
+          GH_TOKEN: ${{ github.token }}
+          ACTOR: ${{ github.actor }}
+        run: |
+          printf '%s' "$GH_TOKEN" | docker login ghcr.io -u "$ACTOR" --password-stdin
+          docker pull "$TOOLCHAIN_IMAGE"
+      - name: Prepare locked sources and build native libraries
+        env:
+          CROSS_RID: ${{ matrix.rid }}
+          SKIASHARP_PROFILE: ${{ inputs.skiasharp_version }}
+        run: |
+          mkdir -p External/NativeStatic/.work/home
+          docker run --rm --user "$(id -u):$(id -g)" \
+            -e HOME=/src/External/NativeStatic/.work/home -e CROSS_RID -e SKIASHARP_PROFILE \
+            -e CCACHE_DIR=/src/External/NativeStatic/.work/ccache -e CCACHE_MAXSIZE=1G \
+            -e ZIG_GLOBAL_CACHE_DIR=/src/External/NativeStatic/.work/zig-global \
+            -v "$PWD:/src" -w /src --entrypoint bash "$TOOLCHAIN_IMAGE" -c '
+              set -euo pipefail
+              export SOURCE_LOCK="/src/build/linux-toolchain/release.lock.json"
+              source scripts/prepare-cross-sources.sh
+              python3 build/linux-toolchain/build-cross.py \
+                --target "$CROSS_RID" \
+                --sources-manifest "$WORK_DIR/cross-sources.json" \
+                --work /src/External/NativeStatic/.work/toolchains \
+                --output "/src/External/NativeStatic/zig-cross/$SKIASHARP_PROFILE/$CROSS_RID" --jobs 4
+              python3 build/linux-toolchain/package-zig.py \
+                --rid "$CROSS_RID" \
+                --input "/src/External/NativeStatic/zig-cross/$SKIASHARP_PROFILE/$CROSS_RID" \
+                --output "/src/External/NativeStatic/$CROSS_RID/native"
+            '
+      - name: Upload archives, link tests and input manifest
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: ${{ inputs.artifact_prefix || 'native-static' }}-${{ matrix.rid }}
+          path: External/NativeStatic/${{ matrix.rid }}/**
+          if-no-files-found: error

.github/workflows/zig-recent-regression.yml

@@ -0,0 +1,55 @@
+name: zig-recent-release-regression
+
+on:
+  workflow_dispatch:
+    inputs:
+      versions:
+        description: JSON array of stable SkiaSharp versions from this branch major
+        type: string
+        default: '["4.150.3","4.150.5","4.153.1"]'
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  resolve:
+    runs-on: ubuntu-24.04
+    outputs:
+      releases: ${{ steps.locks.outputs.releases }}
+    steps:
+      - uses: actions/checkout@v4
+      - id: locks
+        env:
+          VERSIONS: ${{ inputs.versions }}
+        run: |
+          python3 - <<'PY'
+          import json, os, pathlib, subprocess
+          versions = json.loads(os.environ['VERSIONS'])
+          if not isinstance(versions, list) or not 1 <= len(versions) <= 5:
+              raise SystemExit('Expected one to five stable versions')
+          releases = []
+          for version in versions:
+              subprocess.run(['python3', 'scripts/resolve-release-lock.py', '--version', version], check=True)
+              lock = json.loads(pathlib.Path('build/linux-toolchain/release.lock.json').read_text())
+              releases.append({'version': version, 'lock': json.dumps(lock)})
+          with open(os.environ['GITHUB_OUTPUT'], 'a') as output:
+              output.write('releases=' + json.dumps(releases, separators=(',', ':')) + '\n')
+          PY
+
+  toolchain:
+    needs: resolve
+    uses: ./.github/workflows/zig-toolchain-image.yml
+
+  build:
+    needs: [resolve, toolchain]
+    strategy:
+      fail-fast: false
+      matrix:
+        release: ${{ fromJSON(needs.resolve.outputs.releases) }}
+    uses: ./.github/workflows/static-graphics-zig-cross.yml
+    with:
+      skiasharp_version: ${{ matrix.release.version }}
+      source_lock: ${{ matrix.release.lock }}
+      toolchain_image: ${{ needs.toolchain.outputs.image }}
+      artifact_prefix: regression-${{ matrix.release.version }}

scripts/build-avalonia-native-container.sh

@@ -1,15 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-: "${RID:?RID is required}"
-: "${AVALONIA_VERSION:?AVALONIA_VERSION is required}"
-mkdir -p "$HOME"
-source_dir="/src/External/AvaloniaNative/.work/Avalonia-$AVALONIA_VERSION"
-git clone --depth 1 --branch "$AVALONIA_VERSION" https://github.com/AvaloniaUI/Avalonia.git "$source_dir"
-if git -C "$source_dir" config -f .gitmodules --get-regexp path | grep -q "[[:space:]]external/Numerge$"; then
-  git -C "$source_dir" submodule update --init --depth 1 external/Numerge
-fi
-python3 build/linux-toolchain/build-avalonia-native-cross.py \
-  --source "$source_dir" --rid "$RID" --sdk /opt/macos-sdk/MacOSX15.5.sdk \
-  --work "/src/External/AvaloniaNative/.work/zig-$AVALONIA_VERSION-$RID" \
-  --output "/src/External/AvaloniaNative/$RID/native"
-