Cross-platform port: WPF → Avalonia 12 + .NET 10 (Windows/macOS/Linux)

.claude/settings.json

@@ -0,0 +1,4 @@
+{
+  "permissions": {
+  }
+}

.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [main, migrate-to-avalonia]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          global-json-file: global.json
+
+      # The browser (WASM) head needs the wasm-tools workload to build.
+      - name: Install wasm-tools workload
+        run: dotnet workload install wasm-tools
+
+      - name: Restore
+        run: dotnet restore CrossEscPos.slnx
+
+      - name: Build
+        run: dotnet build CrossEscPos.slnx -c Release --no-restore
+
+      - name: Test
+        run: dotnet test CrossEscPos.slnx -c Release --no-build
+
+      - name: Pack libraries
+        run: dotnet pack CrossEscPos.slnx -c Release --no-build -o artifacts/packages
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: nupkg
+          path: artifacts/packages/*.nupkg
+          if-no-files-found: warn

.github/workflows/release.yml

@@ -0,0 +1,166 @@
+name: Release
+
+# Builds self-contained desktop apps for Windows, Linux and macOS, packs the NuGet libraries, and
+# publishes everything to a GitHub Release. Trigger by pushing a tag like `v1.2.3`, or run manually
+# (workflow_dispatch) to just build artifacts.
+
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    name: Build ${{ matrix.rid }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - { rid: win-x64,   os: ubuntu-latest, kind: zip }
+          - { rid: linux-x64, os: ubuntu-latest, kind: targz }
+          - { rid: osx-x64,   os: macos-latest,  kind: app }
+          - { rid: osx-arm64, os: macos-latest,  kind: app }
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-dotnet@v4
+        with:
+          global-json-file: global.json
+
+      - name: Determine version
+        id: ver
+        shell: bash
+        run: |
+          VER=1.0.0
+          if [ "$GITHUB_REF_TYPE" = "tag" ]; then VER="${GITHUB_REF_NAME#v}"; fi
+          echo "version=$VER" >> "$GITHUB_OUTPUT"
+
+      - name: Publish (self-contained)
+        run: >
+          dotnet publish src/CrossEscPos.App.Desktop/CrossEscPos.App.Desktop.csproj
+          -c Release
+          -r ${{ matrix.rid }}
+          --self-contained true
+          -p:PublishSingleFile=false
+          -p:Version=${{ steps.ver.outputs.version }}
+          -o publish/${{ matrix.rid }}
+
+      - name: Package — zip (Windows)
+        if: matrix.kind == 'zip'
+        run: |
+          cd publish/${{ matrix.rid }}
+          zip -r ../../CrossEscPos-${{ matrix.rid }}.zip .
+
+      - name: Package — tar.gz (Linux)
+        if: matrix.kind == 'targz'
+        run: tar -czf CrossEscPos-${{ matrix.rid }}.tar.gz -C publish/${{ matrix.rid }} .
+
+      - name: Package — .app bundle (macOS)
+        if: matrix.kind == 'app'
+        run: |
+          chmod +x scripts/make-macos-app.sh
+          scripts/make-macos-app.sh publish/${{ matrix.rid }} dist "${{ steps.ver.outputs.version }}"
+          ditto -c -k --keepParent dist/CrossEscPos.app CrossEscPos-${{ matrix.rid }}.zip
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.rid }}
+          path: |
+            CrossEscPos-${{ matrix.rid }}.zip
+            CrossEscPos-${{ matrix.rid }}.tar.gz
+          if-no-files-found: ignore
+
+  pack:
+    name: Pack NuGet libraries
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          global-json-file: global.json
+
+      - name: Determine version
+        id: ver
+        shell: bash
+        run: |
+          VER=1.0.0
+          if [ "$GITHUB_REF_TYPE" = "tag" ]; then VER="${GITHUB_REF_NAME#v}"; fi
+          echo "version=$VER" >> "$GITHUB_OUTPUT"
+
+      # The packable libraries don't need the browser head, so pack each individually (no wasm workload).
+      - name: Pack
+        shell: bash
+        run: |
+          for proj in Abstractions Core Rendering.Skia Rendering.ImageSharp Transports Controls; do
+            dotnet pack "src/CrossEscPos.$proj/CrossEscPos.$proj.csproj" \
+              -c Release -p:Version=${{ steps.ver.outputs.version }} -o packages
+          done
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: nupkg
+          path: |
+            packages/*.nupkg
+            packages/*.snupkg
+
+  publish-nuget:
+    name: Publish to NuGet.org
+    needs: pack
+    runs-on: ubuntu-latest
+    # Only publish for real version tags (v*), never on a manual workflow_dispatch dry run.
+    if: startsWith(github.ref, 'refs/tags/')
+    # Scopes the OIDC token to this environment; also lets you add a manual approval gate in
+    # Settings → Environments → release before anything reaches nuget.org.
+    environment: release
+    permissions:
+      id-token: write   # required: mints the GitHub OIDC token for NuGet Trusted Publishing
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          global-json-file: global.json
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: nupkg
+          path: packages
+
+      # Exchanges the GitHub OIDC token for a short-lived (1 h) nuget.org API key. No stored key.
+      # NUGET_USER is your nuget.org profile name (NOT your email); set it as a repo/environment secret.
+      - name: NuGet login (OIDC → short-lived API key)
+        id: login
+        uses: NuGet/login@v1
+        with:
+          user: ${{ secrets.NUGET_USER }}
+
+      # Pushing *.nupkg also pushes each matching *.snupkg symbol package automatically.
+      - name: Push packages
+        run: >
+          dotnet nuget push "packages/*.nupkg"
+          --api-key ${{ steps.login.outputs.NUGET_API_KEY }}
+          --source https://api.nuget.org/v3/index.json
+          --skip-duplicate
+
+  release:
+    name: Create GitHub Release
+    needs: [build, pack]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: List artifacts
+        run: find artifacts -type f
+
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: artifacts/**/*
+          generate_release_notes: true
+          fail_on_unmatched_files: false

.gitignore

@@ -5,3 +5,14 @@ riderModule.iml
 /_ReSharper.Caches/
 /.vs
 /.idea/
+
+# Runtime debug dumps written by ReceiptPrinter.FeedEscPos
+last_escpos_receive.txt
+last_ticket.bin
+last_*.txt
+
+# macOS
+.DS_Store
+
+# Generated: the host publishes the Avalonia WASM client here on first build.
+samples/CrossEscPos.Host/wwwroot/

CrossEscPos.slnx

@@ -0,0 +1,23 @@
+<Solution>
+  <Folder Name="/samples/">
+    <Project Path="samples/CrossEscPos.Headless/CrossEscPos.Headless.csproj" />
+    <Project Path="samples/CrossEscPos.Host/CrossEscPos.Host.csproj" />
+  </Folder>
+  <Folder Name="/src/">
+    <Project Path="src/CrossEscPos.Abstractions/CrossEscPos.Abstractions.csproj" />
+    <Project Path="src/CrossEscPos.Bridge/CrossEscPos.Bridge.csproj" />
+    <Project Path="src/CrossEscPos.App/CrossEscPos.App.csproj" />
+    <Project Path="src/CrossEscPos.App.Browser/CrossEscPos.App.Browser.csproj" />
+    <Project Path="src/CrossEscPos.App.Desktop/CrossEscPos.App.Desktop.csproj" />
+    <Project Path="src/CrossEscPos.Controls/CrossEscPos.Controls.csproj" />
+    <Project Path="src/CrossEscPos.Core/CrossEscPos.Core.csproj" />
+    <Project Path="src/CrossEscPos.Rendering.ImageSharp/CrossEscPos.Rendering.ImageSharp.csproj" />
+    <Project Path="src/CrossEscPos.Rendering.Skia/CrossEscPos.Rendering.Skia.csproj" />
+    <Project Path="src/CrossEscPos.Transports/CrossEscPos.Transports.csproj" />
+    <Project Path="src/CrossEscPos.Transports.Browser/CrossEscPos.Transports.Browser.csproj" />
+  </Folder>
+  <Folder Name="/tests/">
+    <Project Path="tests/CrossEscPos.Controls.Tests/CrossEscPos.Controls.Tests.csproj" />
+    <Project Path="tests/CrossEscPos.Core.Tests/CrossEscPos.Core.Tests.csproj" />
+  </Folder>
+</Solution>

Directory.Build.props

@@ -0,0 +1,46 @@
+<Project>
+
+  <!-- Shared build settings for every project in the repository. Individual projects override the
+       target framework (e.g. the desktop WinExe, the net10.0-browser WASM app) as needed. -->
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <LangVersion>latest</LangVersion>
+    <!-- One shared root namespace across every assembly, so types resolve by feature/directory
+         (e.g. CrossEscPos.Emulator, CrossEscPos.Graphics) regardless of which package they live in. -->
+    <RootNamespace>CrossEscPos</RootNamespace>
+    <!-- The codebase uses explicit usings; keep implicit usings off to match. -->
+    <ImplicitUsings>disable</ImplicitUsings>
+    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
+    <!-- Security-audit findings (vulnerable packages) must fail the build/CI, not just warn. -->
+    <NuGetAuditMode>all</NuGetAuditMode>
+    <!-- Libraries opt into packaging individually; apps and samples stay false. -->
+    <IsPackable>false</IsPackable>
+  </PropertyGroup>
+
+  <!-- NuGet package metadata, applied to the projects that set IsPackable=true. -->
+  <PropertyGroup>
+    <Version>1.2.0</Version>
+    <Authors>Daniel Meza</Authors>
+    <!-- Packages are published to the Gasoleo Technology organization on nuget.org. -->
+    <Company>Gasoleo Technology</Company>
+    <Product>CrossEscPos</Product>
+    <Copyright>Copyright (c) 2026 Daniel Meza / Gasoleo Technology</Copyright>
+    <PackageProjectUrl>https://github.com/danielmeza/CrossEscPosEmulator</PackageProjectUrl>
+    <RepositoryUrl>https://github.com/danielmeza/CrossEscPosEmulator</RepositoryUrl>
+    <RepositoryType>git</RepositoryType>
+    <PackageTags>escpos;receipt;printer;emulator;thermal;pos</PackageTags>
+    <!-- SPDX license expression; the LICENSE file at the repo root is packed via Directory.Build.targets. -->
+    <PackageLicenseExpression>MIT</PackageLicenseExpression>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
+    <IncludeSymbols>true</IncludeSymbols>
+    <SymbolPackageFormat>snupkg</SymbolPackageFormat>
+    <!-- Source Link: embed repo/commit info and untracked sources so consumers can step into the code.
+         The GitHub Source Link provider ships in the .NET SDK, so no extra package reference is needed. -->
+    <PublishRepositoryUrl>true</PublishRepositoryUrl>
+    <EmbedUntrackedSources>true</EmbedUntrackedSources>
+    <!-- Deterministic, CI-stamped builds when running on GitHub Actions. -->
+    <ContinuousIntegrationBuild Condition="'$(GITHUB_ACTIONS)' == 'true'">true</ContinuousIntegrationBuild>
+  </PropertyGroup>
+
+</Project>

Directory.Build.targets

@@ -0,0 +1,11 @@
+<Project>
+
+  <!-- Runs AFTER each project's own PropertyGroup, so $(IsPackable) reflects the per-project override
+       (Directory.Build.props imports first, when IsPackable is still the default false). Packs the shared
+       README into the root of every packable NuGet package to satisfy <PackageReadmeFile>. The LICENSE is
+       declared via <PackageLicenseExpression> (SPDX), which needs no packed file. -->
+  <ItemGroup Condition="'$(IsPackable)' == 'true'">
+    <None Include="$(MSBuildThisFileDirectory)README.md" Pack="true" PackagePath="\" Visible="false" />
+  </ItemGroup>
+
+</Project>