Release SharpLink 2.0.0: merge dev into main

.editorconfig

@@ -0,0 +1,78 @@
+root = true
+
+# Repository-wide text defaults.
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+
+# C# formatting. Keep this section limited to layout so style preferences can
+# be introduced separately without creating unrelated semantic rewrites.
+[*.cs]
+indent_style = space
+indent_size = 4
+tab_width = 4
+trim_trailing_whitespace = true
+
+dotnet_diagnostic.IDE0055.severity = warning
+
+# New lines
+csharp_new_line_before_open_brace = all
+csharp_new_line_before_else = true
+csharp_new_line_before_catch = true
+csharp_new_line_before_finally = true
+csharp_new_line_before_members_in_object_initializers = true
+csharp_new_line_before_members_in_anonymous_types = true
+csharp_new_line_between_query_expression_clauses = true
+
+# Indentation
+csharp_indent_block_contents = true
+csharp_indent_braces = false
+csharp_indent_case_contents = true
+csharp_indent_case_contents_when_block = true
+csharp_indent_switch_labels = true
+csharp_indent_labels = one_less_than_current
+
+# Spacing
+csharp_space_after_cast = false
+csharp_space_after_keywords_in_control_flow_statements = true
+csharp_space_between_parentheses = false
+csharp_space_before_colon_in_inheritance_clause = true
+csharp_space_after_colon_in_inheritance_clause = true
+csharp_space_around_binary_operators = before_and_after
+csharp_space_between_method_declaration_parameter_list_parentheses = false
+csharp_space_between_method_declaration_empty_parameter_list_parentheses = false
+csharp_space_between_method_declaration_name_and_open_parenthesis = false
+csharp_space_between_method_call_parameter_list_parentheses = false
+csharp_space_between_method_call_empty_parameter_list_parentheses = false
+csharp_space_between_method_call_name_and_opening_parenthesis = false
+csharp_space_after_comma = true
+csharp_space_before_comma = false
+csharp_space_after_dot = false
+csharp_space_before_dot = false
+csharp_space_after_semicolon_in_for_statement = true
+csharp_space_before_semicolon_in_for_statement = false
+csharp_space_around_declaration_statements = false
+csharp_space_before_open_square_brackets = false
+csharp_space_between_empty_square_brackets = false
+csharp_space_between_square_brackets = false
+
+# Wrapping
+csharp_preserve_single_line_blocks = true
+csharp_preserve_single_line_statements = true
+
+# Keep project XML clean without imposing a new indentation convention on the
+# repository's existing mix of two- and four-space files.
+[*.{csproj,props,targets,slnx}]
+trim_trailing_whitespace = true
+
+# JSON and GitHub workflow files conventionally use two-space indentation.
+[*.{json,yml,yaml}]
+indent_style = space
+indent_size = 2
+tab_width = 2
+trim_trailing_whitespace = true
+
+# Preserve intentional Markdown hard line breaks while normalizing new files.
+[*.md]
+trim_trailing_whitespace = false

.github/actions/allocation-gate/action.yml

@@ -0,0 +1,56 @@
+name: Deterministic allocation gate
+description: Builds and runs the Release allocation regression harness.
+inputs:
+  artifact-directory:
+    description: Directory for JSON evidence.
+    required: false
+    default: artifacts/perf/allocation-gate
+  negative-control:
+    description: Run the injected-allocation negative control and require it to fail.
+    required: false
+    default: 'false'
+runs:
+  using: composite
+  steps:
+    - name: Restore allocation gate
+      shell: bash
+      run: dotnet restore test/SharpLink.Benchmarks/SharpLink.Benchmarks.csproj
+
+    - name: Build allocation gate in Release
+      shell: bash
+      run: dotnet build test/SharpLink.Benchmarks/SharpLink.Benchmarks.csproj -c Release --no-restore -v minimal
+
+    - name: Allocation gate harness self-tests
+      shell: bash
+      run: >-
+        dotnet run
+        --project test/SharpLink.Benchmarks/SharpLink.Benchmarks.csproj
+        -c Release
+        --no-build
+        --
+        --allocation-gate-self-test
+        --output "${{ inputs.artifact-directory }}/self-test.json"
+
+    - name: Enforce allocation budgets
+      shell: bash
+      env:
+        SHARPLINK_ALLOCATION_OUTPUT: ${{ inputs.artifact-directory }}/gate.json
+      run: ./eng/run-allocation-gate.sh
+
+    - name: Prove injected allocation is rejected
+      if: inputs.negative-control == 'true'
+      shell: bash
+      env:
+        SHARPLINK_ALLOCATION_OUTPUT: ${{ inputs.artifact-directory }}/negative-control.json
+      run: |
+        set +e
+        ./eng/run-allocation-gate.sh \
+          --filter rpc-add-sharedmemory-c1 \
+          --inject-bytes-per-operation 512
+        status=$?
+        set -e
+        if [[ $status -eq 0 ]]; then
+          echo "::error::Injected allocation negative control unexpectedly passed."
+          exit 1
+        fi
+        echo "Injected allocation was rejected as expected."

.github/actions/package-smoke/action.yml

@@ -0,0 +1,21 @@
+name: Run NuGet package smoke
+description: Restore and run package consumers against packages in artifacts/nuget.
+
+runs:
+  using: composite
+  steps:
+    - name: Restore Package Smoke
+      shell: bash
+      env:
+        NUGET_PACKAGES: ${{ github.workspace }}/.nuget-package-smoke
+      run: dotnet restore test/SharpLink.PackageSmoke/SharpLink.PackageSmoke.csproj --force --no-cache --configfile test/SharpLink.PackageSmoke/NuGet.config
+
+    - name: Run Package Smoke
+      shell: bash
+      env:
+        NUGET_PACKAGES: ${{ github.workspace }}/.nuget-package-smoke
+      run: dotnet run -c Release --no-restore --project test/SharpLink.PackageSmoke/SharpLink.PackageSmoke.csproj
+
+    - name: Run Quick Start Package Smoke
+      shell: bash
+      run: ./eng/run-quickstart-package-smoke.sh artifacts/nuget

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

@@ -0,0 +1,14 @@
+name: Setup .NET CI environment
+description: Configure the shared .NET CLI environment and install the repository CI SDK.
+
+runs:
+  using: composite
+  steps:
+    - name: Configure .NET CLI environment
+      shell: bash
+      run: echo "DOTNET_CLI_TELEMETRY_OPTOUT=1" >> "$GITHUB_ENV"
+
+    - name: Setup .NET
+      uses: actions/setup-dotnet@a98b56852c35b8e3190ac28c8c2271da59106c68 # v6.0.0
+      with:
+        dotnet-version: 10.0.x

.github/actions/verify-packages/action.yml

@@ -0,0 +1,31 @@
+name: Verify NuGet package contracts
+description: Verify SharpLink NuGet packages contain the expected generator, metadata, symbols, and dependency contracts.
+
+inputs:
+  package-directory:
+    description: Directory containing packaged NuGet artifacts.
+    required: false
+    default: artifacts/nuget
+
+runs:
+  using: composite
+  steps:
+    - name: Verify SDK Contains Generator
+      shell: bash
+      run: |
+        package_listing="$(mktemp "$RUNNER_TEMP/sharplink-sdk-package-list.XXXXXX")"
+        trap 'rm -f "$package_listing"' EXIT
+        unzip -l "${{ inputs.package-directory }}"/SharpLink.Sdk.*.nupkg > "$package_listing"
+        grep -q 'analyzers/dotnet/cs/SharpLink.Generator.dll' "$package_listing"
+
+    - name: Verify package metadata, XML documentation, and symbols
+      shell: bash
+      run: ./eng/verify-packages.sh "${{ inputs.package-directory }}"
+
+    - name: Verify Hosting direct Runtime dependency
+      shell: bash
+      run: ./eng/verify-hosting-package-dependency.sh "${{ inputs.package-directory }}"
+
+    - name: Verify Abstractions has no DI dependency
+      shell: bash
+      run: ./eng/verify-abstractions-package-dependency.sh "${{ inputs.package-directory }}"

.github/workflows/codec-android-arm64-evidence.yml

@@ -0,0 +1,185 @@
+name: Codec Android ARM64 Device Evidence
+
+# Physical ARM64 Android evidence. GitHub-hosted ARM runners cannot currently
+# provide the nested virtualization required by the Android ARM64 emulator, so
+# this workflow is manual and requires a prepared self-hosted ARM64 runner with
+# an attached Android ARM64 device.
+
+permissions:
+  contents: read
+
+on:
+  workflow_dispatch:
+
+jobs:
+  android-arm64-device:
+    runs-on: [self-hosted, ARM64, android-device]
+    timeout-minutes: 45
+    env:
+      DOTNET_CLI_TELEMETRY_OPTOUT: '1'
+      SHARPLINK_COMMIT: ${{ github.sha }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@a98b56852c35b8e3190ac28c8c2271da59106c68 # v6.0.0
+        with:
+          dotnet-version: 10.0.x
+
+      - name: Install Android workload
+        run: dotnet workload install android
+
+      - name: Record SDK version
+        shell: bash
+        run: echo "SHARPLINK_SDK_VERSION=$(dotnet --version)" >> "$GITHUB_ENV"
+
+      - name: Require one physical Android ARM64 device
+        shell: bash
+        run: |
+          command -v adb
+          adb start-server
+          device_count="$(adb devices | awk 'NR > 1 && $2 == "device" { count++ } END { print count+0 }')"
+          if [[ "$device_count" != "1" ]]; then
+            echo "::error::Expected exactly one online Android device, found $device_count."
+            adb devices -l
+            exit 1
+          fi
+          abi="$(adb shell getprop ro.product.cpu.abi | tr -d '\r')"
+          qemu="$(adb shell getprop ro.kernel.qemu | tr -d '\r')"
+          echo "Android device ABI: $abi"
+          echo "ro.kernel.qemu: ${qemu:-unset}"
+          if [[ "$abi" != "arm64-v8a" ]]; then
+            echo "::error::Expected a physical arm64-v8a Android device, observed $abi."
+            exit 1
+          fi
+          if [[ "$qemu" == "1" ]]; then
+            echo "::error::This workflow requires a physical device, not an emulator."
+            exit 1
+          fi
+
+      - name: Produce canonical desktop corpus
+        run: >-
+          dotnet run -c Release
+          --project test/SharpLink.CodecCompatibility/SharpLink.CodecCompatibility.csproj
+          -- produce
+          --output artifacts/codec-compat/producers/codec-android-arm64-corpus-desktop-reference
+
+      - name: Build and run Android ARM64 Mono producer
+        shell: bash
+        run: |
+          rm -rf test/SharpLink.CodecCompatibility.Android/bin test/SharpLink.CodecCompatibility.Android/obj
+          dotnet build -c Debug -f net10.0-android -r android-arm64 \
+            test/SharpLink.CodecCompatibility.Android/SharpLink.CodecCompatibility.Android.csproj \
+            -t:SignAndroidPackage \
+            -p:CodecRuntime=mono \
+            -p:AndroidPackageFormats=apk \
+            -p:AndroidBuildApplicationPackage=true
+          apk="$(find test/SharpLink.CodecCompatibility.Android/bin/Debug -name '*-Signed.apk' -type f | head -n 1)"
+          test -n "$apk"
+          cp "$apk" artifacts/codec-compat/android-arm64-mono.apk
+          adb install -r "$apk"
+          node test/SharpLink.CodecCompatibility.Android/run-android.mjs \
+            produce artifacts/codec-compat/android-arm64-mono-corpus \
+            "$SHARPLINK_COMMIT" "$SHARPLINK_SDK_VERSION" Mono
+          adb uninstall com.sharplink.codeccompat || true
+
+      - name: Build and run Android ARM64 CoreCLR producer
+        shell: bash
+        run: |
+          rm -rf test/SharpLink.CodecCompatibility.Android/bin test/SharpLink.CodecCompatibility.Android/obj
+          dotnet build -c Debug -f net10.0-android -r android-arm64 \
+            test/SharpLink.CodecCompatibility.Android/SharpLink.CodecCompatibility.Android.csproj \
+            -t:SignAndroidPackage \
+            -p:CodecRuntime=coreclr \
+            -p:AndroidPackageFormats=apk \
+            -p:AndroidBuildApplicationPackage=true
+          apk="$(find test/SharpLink.CodecCompatibility.Android/bin/Debug -name '*-Signed.apk' -type f | head -n 1)"
+          test -n "$apk"
+          cp "$apk" artifacts/codec-compat/android-arm64-coreclr.apk
+          adb install -r "$apk"
+          node test/SharpLink.CodecCompatibility.Android/run-android.mjs \
+            produce artifacts/codec-compat/android-arm64-coreclr-corpus \
+            "$SHARPLINK_COMMIT" "$SHARPLINK_SDK_VERSION" CoreCLR
+          adb uninstall com.sharplink.codeccompat || true
+
+      - name: Assemble Android ARM64 producer fan-in
+        shell: bash
+        run: |
+          mkdir -p artifacts/codec-compat/producers/codec-android-arm64-corpus-mono
+          mkdir -p artifacts/codec-compat/producers/codec-android-arm64-corpus-coreclr
+          cp -R artifacts/codec-compat/android-arm64-mono-corpus/. artifacts/codec-compat/producers/codec-android-arm64-corpus-mono/
+          cp -R artifacts/codec-compat/android-arm64-coreclr-corpus/. artifacts/codec-compat/producers/codec-android-arm64-corpus-coreclr/
+
+      - name: Verify documented edges on Android ARM64 Mono
+        shell: bash
+        env:
+          SHARPLINK_SKIP_BUILTIN_RAW: '1'
+        run: |
+          adb install -r artifacts/codec-compat/android-arm64-mono.apk
+          node test/SharpLink.CodecCompatibility.Android/run-android.mjs \
+            verify artifacts/codec-compat/producers \
+            artifacts/codec-compat/android-arm64-mono-verification/verification.json \
+            "$SHARPLINK_COMMIT" "$SHARPLINK_SDK_VERSION" Mono
+          adb uninstall com.sharplink.codeccompat || true
+
+      - name: Append raw evidence for Android ARM64 Mono
+        run: |
+          node test/SharpLink.CodecCompatibility.Browser/portable-artifacts.mjs \
+            append-raw artifacts/codec-compat/android-arm64-mono-verification/verification.json \
+            artifacts/codec-compat/producers artifacts/codec-compat/android-arm64-mono-corpus
+          node test/SharpLink.CodecCompatibility.Browser/portable-artifacts.mjs \
+            check-report artifacts/codec-compat/android-arm64-mono-verification/verification.json
+
+      - name: Verify documented edges on Android ARM64 CoreCLR
+        shell: bash
+        env:
+          SHARPLINK_SKIP_BUILTIN_RAW: '1'
+        run: |
+          adb install -r artifacts/codec-compat/android-arm64-coreclr.apk
+          node test/SharpLink.CodecCompatibility.Android/run-android.mjs \
+            verify artifacts/codec-compat/producers \
+            artifacts/codec-compat/android-arm64-coreclr-verification/verification.json \
+            "$SHARPLINK_COMMIT" "$SHARPLINK_SDK_VERSION" CoreCLR
+          adb uninstall com.sharplink.codeccompat || true
+
+      - name: Append raw evidence for Android ARM64 CoreCLR
+        run: |
+          node test/SharpLink.CodecCompatibility.Browser/portable-artifacts.mjs \
+            append-raw artifacts/codec-compat/android-arm64-coreclr-verification/verification.json \
+            artifacts/codec-compat/producers artifacts/codec-compat/android-arm64-coreclr-corpus
+          node test/SharpLink.CodecCompatibility.Browser/portable-artifacts.mjs \
+            check-report artifacts/codec-compat/android-arm64-coreclr-verification/verification.json
+
+      - name: Require both Android ARM64 consumer reports
+        shell: bash
+        run: |
+          count="$(find artifacts/codec-compat -path '*android-arm64-*-verification/verification.json' -type f | wc -l | tr -d ' ')"
+          if [[ "$count" != "2" ]]; then
+            echo "::error::Expected 2 Android ARM64 consumer reports, found $count."
+            exit 1
+          fi
+
+      - name: Aggregate Android ARM64 device evidence
+        run: >-
+          dotnet run -c Release
+          --project test/SharpLink.CodecCompatibility/SharpLink.CodecCompatibility.csproj
+          -- summarize
+          --input artifacts/codec-compat
+          --output artifacts/codec-compat/summary
+          --profile android-arm64-device
+
+      - name: Upload Android ARM64 device evidence
+        if: always()
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: codec-android-arm64-device-evidence
+          path: |
+            artifacts/codec-compat/producers/codec-android-arm64-corpus-desktop-reference
+            artifacts/codec-compat/android-arm64-mono-corpus
+            artifacts/codec-compat/android-arm64-coreclr-corpus
+            artifacts/codec-compat/android-arm64-mono-verification/verification.json
+            artifacts/codec-compat/android-arm64-coreclr-verification/verification.json
+            artifacts/codec-compat/summary
+          if-no-files-found: warn
+          retention-days: 30