docs: use PlantUML maps so Kroki fits a phone width

Class diagrams rendered 6556px wide; Gitea clipped that to a black arrowhead and the UML C icon. Stacked maps are 560-780px and render as labelled tables on public Kroki.
docs: restore PlantUML UI maps; draw groups as rectangles
2026-09-14 15:04:22 +00:00 · 2026-09-14 14:56:52 +00:00 · 2026-09-14 14:44:59 +00:00 · 2026-09-14 14:40:28 +00:00 · 2026-09-14 14:25:52 +00:00 · 2026-09-14 14:25:35 +00:00
42 changed files with 425 additions and 2498 deletions
@@ -17,16 +17,9 @@ jobs:
    runs-on: macos-12
    env:
      DERIVED: build/DerivedData-test
      # Tag name on tag pushes, branch name otherwise — scripts/version.sh
      # only honours values matching 'v[0-9]*'.
      RELEASE_TAG: ${{ github.ref_name }}
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          # Full history + tags: scripts/version.sh needs `git describe` and
          # `git rev-list --count`; the default depth-1 clone has neither.
          fetch-depth: 0
      - name: Assert Xcode 14+ toolchain
        run: |
@@ -58,10 +51,6 @@ jobs:
      - name: Build for testing (host arch)
        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
        run: |
          # Stamp the test build with the same version triple packaging uses
          # so CI-built apps are traceable (and mis-tags fail early) (#189).
          eval "$(scripts/version.sh)"
          echo "version=$MARKETING_VERSION build=$CURRENT_PROJECT_VERSION tag=$ICCERY_RELEASE_TAG"
          xcodebuild build-for-testing \
            -scheme ICCery \
            -destination 'platform=macOS' \
@@ -70,10 +59,7 @@ jobs:
            ARCHS="$(uname -m)" \
            ONLY_ACTIVE_ARCH=NO \
            CODE_SIGNING_ALLOWED=YES \
-            CODE_SIGN_IDENTITY='-' \
+            CODE_SIGN_IDENTITY='-'
            MARKETING_VERSION="$MARKETING_VERSION" \
            CURRENT_PROJECT_VERSION="$CURRENT_PROJECT_VERSION" \
            ICCERY_RELEASE_TAG="$ICCERY_RELEASE_TAG"
      # Xcode embeds the shared ICCeryCore package framework into the app
      # and the test bundle without signing it. Ad-hoc hosts still require
@@ -205,10 +191,6 @@ jobs:
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          # Full history + tags: scripts/version.sh needs `git describe` and
          # `git rev-list --count`; the default depth-1 clone has neither.
          fetch-depth: 0
      # scripts/package-release.sh runs `xcodegen generate` and dmgbuild;
      # see build-and-test for why brew is not used on macOS 12 (#109).
@@ -220,7 +202,6 @@ jobs:
      - name: Package release
        run: scripts/package-release.sh
        env:
          RELEASE_TAG: ${{ github.ref_name }}
          GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
          CODESIGN_IDENTITY: ${{ secrets.CODESIGN_IDENTITY }}
          DEVELOPMENT_TEAM: ${{ secrets.DEVELOPMENT_TEAM }}
@@ -1,250 +0,0 @@
 # GitHub Actions twin of .gitea/workflows/macos.yml.
 # Deltas from the Gitea file (everything else is the same jobs/steps):
 #   - runs-on macos-14: github.com retired macos-12. Do not use
 #     macos-latest — in 2026 that is macos-26-arm64, where a 1280×800
 #     window hangs off the virtual display and XCTest marks sidebar
 #     controls (x ≈ -116) as not hittable (run 34864198118).
 #   - actions/upload-artifact@v4: v3 is shut down on github.com. Gitea act_runner
 #     still uses v3.
 #   - No NODE_EXTRA_CA_CERTS / System keychain bundle: that is only for the
 #     private Gitea CA when the runner talks to git.i3omb.com.
 #   - Tag DMGs go to a GitHub Release via `gh` instead of
 #     scripts/attach-release-asset.sh (Gitea /api/v1).
 name: macOS CI
 on:
  push:
    branches:
      - develop
    tags:
      - 'v*'
  pull_request:
    branches:
      - develop
 permissions:
  contents: read
 jobs:
  build-and-test:
    runs-on: macos-14
    env:
      DERIVED: build/DerivedData-test
      # Tag name on tag pushes, branch name otherwise — scripts/version.sh
      # only honours values matching 'v[0-9]*'.
      RELEASE_TAG: ${{ github.ref_name }}
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          # Full history + tags: scripts/version.sh needs `git describe` and
          # `git rev-list --count`; the default depth-1 clone has neither.
          fetch-depth: 0
      - name: Assert Xcode 14+ toolchain
        run: |
          line="$(xcodebuild -version | head -1)"
          major="$(printf '%s' "$line" | sed -n 's/^Xcode \([0-9][0-9]*\)\..*/\1/p')"
          if [ -z "$major" ] || [ "$major" -lt 14 ]; then
            echo "Unexpected Xcode version: $line" >&2; exit 1
          fi
          echo "$line"
      # Tag pushes whose name contains "prerelease" skip the test build and both
      # test legs: they exist to package a build already validated elsewhere.
      # The job still succeeds quickly so `package`'s `needs:` stays satisfied.
      # Homebrew's xcodegen formula requires Xcode 15.3, which cannot be
      # installed on macOS 12 (#109). The script installs a pinned
      # prebuilt release instead. dmgbuild is not installed here — the
      # test job does not package (#95).
      - name: Ensure host tools
        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
        run: scripts/ensure-host-tools.sh
      - name: Generate Xcode project
        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
        run: xcodegen generate --spec project.yml
      # Tests only ever run on the runner's own architecture; build
      # just that slice. Packaging (scripts/package-release.sh) still
      # produces the universal Release binary.
      - name: Build for testing (host arch)
        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
        run: |
          # Stamp the test build with the same version triple packaging uses
          # so CI-built apps are traceable (and mis-tags fail early) (#189).
          eval "$(scripts/version.sh)"
          echo "version=$MARKETING_VERSION build=$CURRENT_PROJECT_VERSION tag=$ICCERY_RELEASE_TAG"
          xcodebuild build-for-testing \
            -scheme ICCery \
            -destination 'platform=macOS' \
            -derivedDataPath "$DERIVED" \
            -configuration Debug \
            ARCHS="$(uname -m)" \
            ONLY_ACTIVE_ARCH=NO \
            CODE_SIGNING_ALLOWED=YES \
            CODE_SIGN_IDENTITY='-' \
            MARKETING_VERSION="$MARKETING_VERSION" \
            CURRENT_PROJECT_VERSION="$CURRENT_PROJECT_VERSION" \
            ICCERY_RELEASE_TAG="$ICCERY_RELEASE_TAG"
      # Xcode embeds the shared ICCeryCore package framework into the app
      # and the test bundle without signing it. Ad-hoc hosts still require
      # every loaded dylib to carry a cdhash — dyld killed the test host at
      # launch (run 31992) — so sign every embedded copy once the build is
      # done (embed steps run after any build script phase) (#119).
      - name: Sign package product frameworks
        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
        run: |
          find "$DERIVED/Build/Products/Debug" -depth -name '*_PackageProduct.framework' -print0 \
            | while IFS= read -r -d '' fw; do
                echo "signing $fw"
                codesign --force --sign - --timestamp=none "$fw"
              done
      - name: Test unit (ICCeryCoreTests)
        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
        run: |
          XCTESTRUN="$(find "$DERIVED" -name 'ICCery*.xctestrun' | head -n 1)"
          if [ -z "$XCTESTRUN" ] || [ ! -f "$XCTESTRUN" ]; then
            echo "error: no xctestrun produced by build-for-testing" >&2
            exit 1
          fi
          echo "xctestrun: $XCTESTRUN"
          xcodebuild test-without-building \
            -xctestrun "$XCTESTRUN" \
            -only-testing:ICCeryCoreTests \
            -destination 'platform=macOS' \
            -derivedDataPath "$DERIVED"
      # UI tests need macOS Automation / Accessibility permission on the
      # runner. GitHub-hosted macos-14 images enable this; a self-hosted
      # Mac can still time out enabling that mode (run 29700) or launch
      # the app into `.runningBackground` (run 29804). Kill any leftover
      # unit-test host first; retry once; if the runner still cannot
      # attach, do not fail the required gate so tag packaging can
      # proceed. Real XCTest assertion failures still fail the job.
      - name: Test UI (ICCeryUITests)
        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
        run: |
          set -o pipefail
          XCTESTRUN="$(find "$DERIVED" -name 'ICCery*.xctestrun' | head -n 1)"
          LOG="$DERIVED/ui-test.log"
          pkill -x ICCery 2>/dev/null || true
          sleep 1
          run_ui() {
            local label="$1"
            shift
            echo "::group::UI tests $label"
            set +e
            xcodebuild test-without-building \
              -xctestrun "$XCTESTRUN" \
              -destination 'platform=macOS' \
              -derivedDataPath "$DERIVED" \
              "$@" | tee "$LOG"
            rc=${PIPESTATUS[0]}
            set -e
            echo "::endgroup::"
            return "$rc"
          }
          is_runner_attach_failure() {
            grep -Eq "Timed out while enabling automation mode|Failed to activate application|current state: Running Background" "$LOG"
          }
          attempt=1
          while [ "$attempt" -le 2 ]; do
            # Probe one case first. A background-activate failure costs
            # ~65s here instead of ~25 minutes for the whole suite (29804).
            if ! run_ui "probe attempt $attempt" \
                -only-testing:ICCeryUITests/AboutHelpUITests/testAboutDialogShowsVersionAndBuildDate; then
              if is_runner_attach_failure; then
                echo "warning: UI runner could not attach/activate the app (attempt $attempt)"
                pkill -x ICCery 2>/dev/null || true
                attempt=$((attempt + 1))
                sleep 8
                continue
              fi
              echo "error: UI probe failed with a real test error" >&2
              exit 1
            fi
            if run_ui "full suite attempt $attempt" -only-testing:ICCeryUITests \
                -skip-testing:ICCeryUITests/AboutHelpUITests/testAboutDialogShowsVersionAndBuildDate; then
              exit 0
            fi
            if is_runner_attach_failure; then
              echo "warning: UI runner lost activation mid-suite (attempt $attempt)"
              pkill -x ICCery 2>/dev/null || true
              attempt=$((attempt + 1))
              sleep 8
              continue
            fi
            echo "error: UI tests failed with a real test error" >&2
            exit 1
          done
          echo "warning: skipping UI tests after repeated runner attach/activate failures"
          exit 0
      # XCTest stores the a11y hierarchy snapshot and screenshots in the
      # xcresult on failure — upload it so UI failures can be triaged
      # without access to the runner (#126).
      - name: Upload UI test xcresult
        if: "failure() && !(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
        uses: actions/upload-artifact@v4
        with:
          name: ui-test-xcresult
          path: build/DerivedData-test/Logs/Test
  package:
    needs: build-and-test
    runs-on: macos-14
    if: github.ref == 'refs/heads/develop' || startsWith(github.ref, 'refs/tags/v')
    permissions:
      contents: write
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          # Full history + tags: scripts/version.sh needs `git describe` and
          # `git rev-list --count`; the default depth-1 clone has neither.
          fetch-depth: 0
      # scripts/package-release.sh runs `xcodegen generate` and dmgbuild;
      # see build-and-test for why brew is not used on macOS 12 (#109).
      # INSTALL_DMGBUILD isolates dmgbuild in build/.venv-dmgbuild so
      # the test job never pip-installs it (#95).
      - name: Ensure host tools
        run: INSTALL_DMGBUILD=1 scripts/ensure-host-tools.sh
      - name: Package release
        run: scripts/package-release.sh
        env:
          RELEASE_TAG: ${{ github.ref_name }}
          CODESIGN_IDENTITY: ${{ secrets.CODESIGN_IDENTITY }}
          DEVELOPMENT_TEAM: ${{ secrets.DEVELOPMENT_TEAM }}
          NOTARIZE_APPLE_ID: ${{ secrets.NOTARIZE_APPLE_ID }}
          NOTARIZE_PASSWORD: ${{ secrets.NOTARIZE_PASSWORD }}
          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
      - name: Upload DMG artifact
        uses: actions/upload-artifact@v4
        with:
          name: iccery-dmg
          path: ICCery-*.dmg
      - name: Attach DMG to GitHub release
        if: startsWith(github.ref, 'refs/tags/v')
        env:
          GH_TOKEN: ${{ github.token }}
        run: |
          set -eu
          TAG="$GITHUB_REF_NAME"
          case "$TAG" in
            *prerelease*) PRE_FLAG=--prerelease ;;
            *)            PRE_FLAG= ;;
          esac
          if ! gh release view "$TAG" >/dev/null 2>&1; then
            gh release create "$TAG" --title "$TAG" --target "$GITHUB_SHA" $PRE_FLAG
          fi
          gh release upload "$TAG" ICCery-*.dmg --clobber
@@ -18,9 +18,6 @@ Vendor/Argyll/
 # XcodeGen output (regenerate with `make gen`)
 ICCery.xcodeproj/
 # Local-only developer helpers (never committed)
 /set-version.sh
 # macOS
 .DS_Store
@@ -39,13 +39,6 @@ Empty cwd illegal (#59). Atomic writes = `.tmp` + rename (#213).
 User-supplied strings via SwiftUI `Text` only (#114).
 TIFF never rendered directly — host-side PNG preview (#58).
 ## Versioning
 `scripts/version.sh` is the single source: tag/describe → `ICCERY_RELEASE_TAG`
 (About shows `tag (marketing)`), `MARKETING_VERSION` = strict `X.Y.Z`,
 `CURRENT_PROJECT_VERSION` = `git rev-list --count HEAD` (#189).
 `v*` tag builds hard-fail if tag's X.Y.Z ≠ `project.yml` MARKETING_VERSION —
 bump `project.yml` on `develop` before tagging. CI needs `fetch-depth: 0`.
 ## Branching
 `develop` ← `milestone/mN-<name>` ← `feat/<issue#>-<slug>`.
 PRs via Gitea MCP. Every issue/PR: `Project/ICCery-v2` + `Feature/*` or `Bug/*` + `Priority/*`.
@@ -61,14 +54,3 @@ Universal (`ARCHS='arm64 x86_64' ONLY_ACTIVE_ARCH=NO`) is still required for rel
 2-arg `(PMPrintSession, CFStringRef) -> OSStatus`. Never pass integer `1`.
 Modes: `AP_ApplicationColorMatching` then `ApplicationColorMatching`.
 `lp` path and Quartz/`ICCeryPrintKit` path use **different** ColorSync dictionaries. Never mix.
 ## Gitea issue dependencies
 Use the `gitea` MCP (custom build with blocking support — verified working):
 - `issue_write` methods:
  - `add_dependency` — `blocking_issue` blocks `issue_number`.
  - `remove_dependency` — removes `blocking_issue` from `issue_number`'s blockers.
  - `block_issue` / `unblock_issue` — `issue_number` blocks/unblocks `blocked_issue`.
 - `issue_read` methods: `list_dependencies` (issues blocking N),
  `list_blocks` (issues N blocks).
 - All issue numbers are *display numbers*, not db ids.
@@ -1,6 +1,6 @@
 # BUILD-PLAN.md — ICCery v2 Mac
-Spec snapshot: `docs/`. Source of tickets: Gitea milestones M1–M6 + M10 (id 32) + M11 (id 34) + Later.
+Spec snapshot: `docs/`. Source of tickets: Gitea milestones M1–M6 + M10 (id 32) + Later.
 ## Sprint rule
 Do not start milestone N+1 implementation until milestone N **CI/mock gate** is green.
@@ -20,12 +20,11 @@ Hardware gates block *release of that sprint*, not filing, and not starting codi
 | M8 | Deduplicate & consolidate | 79–86 | (already shipped on `develop`) | N/A |
 | M9 | macOS 12 / Xcode 14.2 retarget | (milestone/m9-monterey, PR #145) | XCTest + ObservableObject + macos-12 CI | N/A |
 | M10 | Studio workflow | 146–149 | Media library + spot-read + gamut compare + project file unit/UI smoke | Real printer+paper+.cal; live spot-read; two `.gam`; reopen `.icceryproj` |
 | M11 | Printer settings completeness & dialog binding | 183, 180, 181, 186 | Quality/media/paper caps parse + `LpArgs` emit + picker UI smoke + panel capture-return | Real Epson: 7 `EPIJ_Qual` options; real Canon Pro9500: English media labels; dialog bound to non-default queue with paper/quality/media/orientation preselected; captured settings reach `lp` argv |
 | Later | Quartz / TargetPrint | 16 | `ICCeryPrintKit` standalone + seam test | 1:1 on paper vs TIFF |
-M8–M10 are merged to `develop`; M11 assembles on `milestone/m11-print-settings` from `736fd08`.
+M8 and M9 merged to `develop` via PR #104 / #145; M10 starts from `800c980`.
-Issue **16 is not an M3, M6, M10, or M11 exit gate.**
+Issue **16 is not an M3, M6, or M10 exit gate.**
 ## Branch taxonomy
@@ -20,14 +20,8 @@ public enum ArtefactFiles {
        bundle: Bundle = .main
    ) -> (version: String, build: String, buildDate: String) {
        let info = bundle.infoDictionary ?? [:]
-        let short = info["CFBundleShortVersionString"] as? String ?? "0.0.0"
+        let version = info["CFBundleShortVersionString"] as? String ?? "0.0.0"
        let build = info["CFBundleVersion"] as? String ?? "0"
        var tag = ""
        if let url = bundle.url(forResource: "ICCeryReleaseTag", withExtension: nil),
           let raw = try? String(contentsOf: url, encoding: .utf8) {
            tag = raw
        }
        let version = displayVersion(shortVersion: short, releaseTag: tag)
        let url = bundle.executableURL ?? bundle.bundleURL
        let buildDate: String
@@ -43,15 +37,4 @@ public enum ArtefactFiles {
        return (version, build, buildDate)
    }
    /// About "Version:" string from the release tag + marketing version
    /// (#189): `v2.0.0-pre2 (2.0.0)`; dedupes to `v2.0.0` on an exact
    /// release tag; falls back to the short version when untagged.
    static func displayVersion(shortVersion: String, releaseTag: String) -> String {
        let tag = releaseTag.trimmingCharacters(in: .whitespacesAndNewlines)
        if tag.isEmpty || tag == shortVersion || tag == "v\(shortVersion)" {
            return tag.isEmpty ? shortVersion : tag
        }
        return "\(tag) (\(shortVersion))"
    }
 }
@@ -25,9 +25,8 @@ public enum CupsOptionsFilter {
        "EPIJ_OSColMat", "ColorCorrection", "StpColorCorrection",
        "EpsonColorMode", "ColorModel",
        // Quality
-        "Resolution", "cupsPrintQuality", "Quality", "EPIJ_Qual",
+        "Resolution", "cupsPrintQuality", "Quality", "EPIJ_Quality",
-        "EPIJ_Quality", "CNIJQuality", "CNIJPrintQuality",
+        "CNIJQuality", "StpQuality", "OutputMode",
        "PrintQuality", "StpQuality", "OutputMode",
        // Duplex
        "Duplex", "sides",
    ]
@@ -174,13 +174,8 @@ public enum CupsParsers {
    /// PPD `*<key> <id>/<Human Label>:` lines → `id → label` map.
    /// Language-qualified forms (`*en_US.<key> id/Label:`) also match.
    /// Precedence is deterministic, not positional (#181): unqualified
    /// `*Key` > `en_US.` > `en.` > first-qualified-seen, so a trailing
    /// locale block (Canon `th.CNIJMediaType`) can never overwrite the
    /// base English labels — and a qualified-only id still gets its
    /// first-seen qualified label (R9).
    public static func ppdChoiceLabels(_ ppd: String, key: String) -> [String: String] {
-        var hits: [String: [(qualifier: String?, label: String)]] = [:]
+        var map: [String: String] = [:]
        for rawLine in ppd.split(separator: "\n") {
            var line = rawLine.trimmingCharacters(in: .whitespaces)
            guard line.hasPrefix("*"), !line.hasPrefix("**") else { continue }
@@ -188,9 +183,7 @@ public enum CupsParsers {
            // Optional locale qualifier: `en_US.InputSlot` → `InputSlot`.
            // Only strip when the part before the first `.` looks like
            // a locale (short `xx`/`xx_YY`); real keys containing dots
-            // are left alone. The qualifier is recorded for precedence
+            // are left alone.
            // rather than dropped (#181).
            var qualifier: String?
            if let dot = line.firstIndex(of: ".") {
                let prefix = line[..<dot]
                let looksLikeLocale = (2...5).contains(prefix.count)
@@ -198,7 +191,6 @@ public enum CupsParsers {
                    && (prefix.count == 2 || prefix.contains("_"))
                let candidate = line[line.index(after: dot)...]
                if looksLikeLocale && candidate.hasPrefix(key) {
                    qualifier = prefix.lowercased()
                    line = String(candidate)
                }
            }
@@ -209,50 +201,15 @@ public enum CupsParsers {
            rest = String(rest[..<colon])
            // `<id>/<Human label>` — human label after the last `/`.
            guard let slash = rest.firstIndex(of: "/") else { continue }
-            let id = ppdUnescape(String(rest[..<slash])
+            let id = String(rest[..<slash])
-                .trimmingCharacters(in: .whitespaces))
+                .trimmingCharacters(in: .whitespaces)
-            let human = ppdUnescape(String(rest[rest.index(after: slash)...])
+            let human = String(rest[rest.index(after: slash)...])
-                .trimmingCharacters(in: .whitespaces))
+                .trimmingCharacters(in: .whitespaces)
-            guard !id.isEmpty else { continue }
+            if !id.isEmpty { map[id] = human.isEmpty ? id : human }
            hits[id, default: []].append(
                (qualifier, human.isEmpty ? id : human))
        }
        var map: [String: String] = [:]
        for (id, candidates) in hits {
            // First occurrence wins inside each qualifier class, in
            // file order — same as the old sequential behaviour.
            map[id] = candidates.first { $0.qualifier == nil }?.label
                ?? candidates.first { $0.qualifier == "en_us" }?.label
                ?? candidates.first { $0.qualifier == "en" }?.label
                ?? candidates[0].label
        }
        return map
    }
    /// PPD `<XX>` hex escapes → the literal byte (`<2F>` → `/`,
    /// `<20>` → space). Anything that is not `<` + two hex digits +
    /// `>` passes through untouched (#181).
    private static func ppdUnescape(_ text: String) -> String {
        var result = ""
        var index = text.startIndex
        while index < text.endIndex {
            guard text[index] == "<",
                  let hexEnd = text.index(
                      index, offsetBy: 3, limitedBy: text.endIndex),
                  hexEnd < text.endIndex, text[hexEnd] == ">",
                  let byte = UInt8(
                      text[text.index(after: index)..<hexEnd], radix: 16)
            else {
                result.append(text[index])
                index = text.index(after: index)
                continue
            }
            result.append(Character(UnicodeScalar(byte)))
            index = text.index(after: hexEnd)
        }
        return result
    }
    // MARK: - Detection (docs/11)
    /// Media-type option key in preference order — used both to read a
@@ -266,61 +223,13 @@ public enum CupsParsers {
    }
    /// Media type from a captured `key=value key=value` options string.
-    /// Prefers `MediaType` (docs/11 §tests), then the remaining roster
+    /// Prefers `MediaType`, then `EPIJ_Medi` (docs/11 §tests).
    /// keys in detection order — `CNIJMediaType`, `EPIJ_Medi`,
    /// `StpMediaType` (#186 capture-return).
    public static func extractMediaType(fromOptionsString options: String) -> String? {
        let pairs = lpoptions(options)
        if let v = pairs.first(where: { $0.key == "MediaType" })?.value {
            return v
        }
-        for key in mediaTypeKeys where key != "MediaType" {
+        return pairs.first(where: { $0.key == "EPIJ_Medi" })?.value
            if let v = pairs.first(where: { $0.key == key })?.value {
                return v
            }
        }
        return nil
    }
    /// Print-quality option key in preference order — vendor-first,
    /// weakest last (#183). `OutputMode`/`Resolution` sit last: on some
    /// drivers they are colour-mode keys, not quality (#180).
    /// `CNIJPrintMode2`/`CNIJPQualitySlider` are deferred (#16).
    public static let qualityKeys = [
        "EPIJ_Qual", "CNIJPrintQuality", "CNIJQuality",
        "cupsPrintQuality", "PrintQuality", "Quality", "StpQuality",
        "EPIJ_Quality", "OutputMode", "Resolution",
    ]
    public static func detectQualityKey(optionKeys: Set<String>) -> String? {
        qualityKeys.first { optionKeys.contains($0) }
    }
    /// A single value from a captured `key=value key=value` options
    /// string — case-insensitive key match (#183 capture-return).
    public static func extractOption(
        named key: String,
        fromOptionsString options: String
    ) -> String? {
        lpoptions(options).first {
            $0.key.caseInsensitiveCompare(key) == .orderedSame
        }?.value
    }
    /// Print-quality token from a captured options string — the queue's
    /// quality key is detected from the roster before extracting (#183).
    public static func extractQuality(fromOptionsString options: String) -> String? {
        let pairs = lpoptions(options)
        guard let key = detectQualityKey(
            optionKeys: Set(pairs.map(\.key)))
        else { return nil }
        return pairs.first(where: { $0.key == key })?.value
    }
    /// `orientation-requested=3|4` → `"portrait"`/`"landscape"` (#183).
    public static func extractOrientation(fromOptionsString options: String) -> String? {
        extractOption(named: "orientation-requested", fromOptionsString: options)
            .map { $0 == "4" ? "landscape" : "portrait" }
    }
    /// Driver "no colour adjustment" key=value for `lpoptions -l` keys
@@ -132,28 +132,8 @@ public struct CupsService: Sendable {
                continue
            }
        }
        // Print quality — the detected roster key's listing maps to
        // `PrinterQuality` with PPD labels and the `*` default (#183).
        var qualities: [PrinterQuality] = []
        var qualityDefault: String?
        let qualityKey = CupsParsers.detectQualityKey(
            optionKeys: Set(listings.map(\.key)))
        if let qualityKey,
           let listing = listings.first(where: { $0.key == qualityKey }) {
            let labels = ppd.map {
                CupsParsers.ppdChoiceLabels($0, key: qualityKey)
            } ?? [:]
            qualities = listing.choices.map {
                PrinterQuality(id: $0, name: labels[$0] ?? $0)
            }
            qualityDefault = listing.defaultChoice
        }
        return PrinterCapabilities(
-            trays: trays, paperSizes: sizes, mediaTypes: media,
+            trays: trays, paperSizes: sizes, mediaTypes: media)
            qualityKey: qualityKey, qualities: qualities,
            qualityDefault: qualityDefault)
    }
    /// The set of option keys a queue advertises — input to
@@ -187,11 +167,7 @@ public struct CupsService: Sendable {
    private func loadPPD(for queue: String) -> String? {
        let url = ppdDir.appendingPathComponent("\(queue).ppd")
-        // UTF-8 first — the Canon Thai labels are UTF-8 and a blanket
+        return try? String(contentsOf: url, encoding: .utf8)
        // Latin-1 read would mojibake them (#181, R10). Latin-1 only
        // when UTF-8 decoding fails outright.
        return (try? String(contentsOf: url, encoding: .utf8))
            ?? (try? String(contentsOf: url, encoding: .isoLatin1))
    }
    // MARK: - Spawn
@@ -20,7 +20,6 @@ public enum LpArgsError: LocalizedError, Equatable {
 ///    -o AP.ColorMatchingMode=AP_ApplicationColorMatching
 ///    <captured cups_options>
 ///    <media_type, if no media key already captured>
 ///    <quality, if no quality key already captured> (#183)
 ///    <driver bypass, if no bypass key captured>
 ///    <orientation-requested=3|4, unless captured>
 ///    <PageSize, unless captured>
@@ -83,15 +82,6 @@ public enum LpArgs {
            argv += ["-o", "\(mediaKey)=\(mediaType)"]
        }
        // Print quality — after media, before the driver bypass; the
        // detected queue key is skipped when already captured (#183).
        if let quality = options.quality,
           let qualityKey = CupsParsers.detectQualityKey(optionKeys: optionKeys),
           !addedKeys.contains(qualityKey.lowercased()) {
            addedKeys.insert(qualityKey.lowercased())
            argv += ["-o", "\(qualityKey)=\(quality)"]
        }
        // Driver colour bypass — when no bypass key was captured. NOT
        // gated on ppdUncorrectedPassthrough (macOS always bypasses).
        let capturedKeys = Set(
@@ -66,18 +66,6 @@ public struct PrinterMediaType: Codable, Equatable, Sendable {
    }
 }
 /// Print quality: `id` is the option token (e.g. `"303"`), `name` the
 /// human label after PPD enrichment (mirrors `PrinterMediaType`, #183).
 public struct PrinterQuality: Codable, Equatable, Sendable {
    public var id: String
    public var name: String
    public init(id: String, name: String) {
        self.id = id
        self.name = name
    }
 }
 public struct PrinterCapabilities: Codable, Equatable, Sendable {
    public var trays: [PrinterTray]
    public var paperSizes: [PrinterPaperSize]
@@ -85,29 +73,17 @@ public struct PrinterCapabilities: Codable, Equatable, Sendable {
    /// Always `true` on macOS (spec parity — CUPS honours
    /// `orientation-requested`).
    public var supportsOrientation: Bool
    /// The queue's detected quality enumeration key
    /// (`CupsParsers.detectQualityKey`), e.g. `EPIJ_Qual` (#183).
    public var qualityKey: String?
    public var qualities: [PrinterQuality]
    /// The `*`-marked default choice from `lpoptions -l`, if any.
    public var qualityDefault: String?
    public init(
        trays: [PrinterTray] = [],
        paperSizes: [PrinterPaperSize] = [],
        mediaTypes: [PrinterMediaType] = [],
-        supportsOrientation: Bool = true,
+        supportsOrientation: Bool = true
        qualityKey: String? = nil,
        qualities: [PrinterQuality] = [],
        qualityDefault: String? = nil
    ) {
        self.trays = trays
        self.paperSizes = paperSizes
        self.mediaTypes = mediaTypes
        self.supportsOrientation = supportsOrientation
        self.qualityKey = qualityKey
        self.qualities = qualities
        self.qualityDefault = qualityDefault
    }
 }
@@ -120,12 +96,9 @@ public struct PrintOptions: Codable, Equatable, Sendable {
    public var paperSource: Int?
    /// `"portrait"` / `"landscape"` → `orientation-requested=3|4`.
    public var orientation: String?
-    /// Stage 2 paper token → `PageSize=` (skipped if captured, #183).
+    /// printtarg layout page size → `PageSize=` (skipped if captured).
    public var paperSize: String?
    public var mediaType: String?
    /// Print-quality token → `-o <detectedQualityKey>=` (skipped if
    /// captured, #183).
    public var quality: String?
    public var ppdUncorrectedPassthrough: Bool?
    /// Space-separated `key=value` captured from
    /// `PMPrintSettingsToOptions` and filtered (docs/11 layer ⑥).
@@ -136,7 +109,6 @@ public struct PrintOptions: Codable, Equatable, Sendable {
        orientation: String? = nil,
        paperSize: String? = nil,
        mediaType: String? = nil,
        quality: String? = nil,
        ppdUncorrectedPassthrough: Bool? = nil,
        cupsOptions: String? = nil
    ) {
@@ -144,7 +116,6 @@ public struct PrintOptions: Codable, Equatable, Sendable {
        self.orientation = orientation
        self.paperSize = paperSize
        self.mediaType = mediaType
        self.quality = quality
        self.ppdUncorrectedPassthrough = ppdUncorrectedPassthrough
        self.cupsOptions = cupsOptions
    }
@@ -25,8 +25,7 @@ as AGPLv3 child processes. The GUI never `dlopen`s or links Argyll.
 | M7 | Pre-UAT hardening — shipped |
 | M8 | Deduplication contracts & UAT-ready hardening (#79–#86) — shipped |
 | M9 | macOS 12 / Xcode 14.2 retarget (PR #145) — shipped |
-| M10 | Studio workflow: media library (#146), gamut compare (#147), Spot Read (#148), project files (#149) — shipped on `develop` |
+| M10 | Studio workflow: gamut compare (#147), Spot Read (#148), project files (#149) shipped on `develop`; media library (#146) is in the tree, issue still open |
 | M11 | Printer settings completeness & dialog binding (#183, #180, #181, #186) — in flight on `milestone/m11-print-settings` |
 | Licence | Proprietary source in [`LICENCE.md`](LICENCE.md); bundled Argyll sidecars remain AGPLv3 |
 ## What it does
@@ -126,35 +125,7 @@ The script builds with a fixed derived data path (`build/DerivedData`), locates
 `Release/ICCery.app` from it, signs the bundle, recursively verifies every
 bundled Mach-O sidecar (`scripts/verify-sidecar-signatures.sh`), builds a
 HiDPI TIFF from `Resources/dmg-background.png` (+ `@2x`) via `tiffutil`, and
-writes the DMG with `dmgbuild==1.6.7`.
+writes `ICCery-${VERSION}-${BUILD_NUM}.dmg` with `dmgbuild==1.6.7`.
 ### Versioning
 `scripts/version.sh` resolves the version triple and is the single source for
 packaging and CI:
 - **`ICCERY_RELEASE_TAG`** — `RELEASE_TAG` env when it matches `v[0-9]*` (CI
  tag builds), else `git describe --tags --always --dirty --match 'v[0-9]*'`.
  Stamped into the bundle's `ICCeryReleaseTag` resource (a generated
  Info.plist cannot carry custom keys); the About dialog shows
  `tag (marketing)` — e.g. `v2.0.0-pre2-grok (2.0.0)` — falling back to the
  plain version when untagged.
 - **`MARKETING_VERSION`** (`CFBundleShortVersionString`) — first three numeric
  components of the tag core. Must equal `project.yml`'s
  `MARKETING_VERSION` on tag builds — packaging hard-fails on mismatch, so
  bump `project.yml` on `develop` *before* tagging.
 - **`CURRENT_PROJECT_VERSION`** (`CFBundleVersion`) — `BUILD_NUMBER` env
  override, else `git rev-list --count HEAD`. A single monotonically
  increasing integer per Apple's macOS convention (Mac build numbers never
  reset per version, unlike iOS).
 Tagged/described DMGs carry the tag: `ICCery-2.0.0-pre2-grok-<build>.dmg`;
 plain releases keep `ICCery-<ver>-<build>.dmg`.
 Release procedure: bump `MARKETING_VERSION` in `project.yml` on `develop` →
 merge `develop` → `main` → tag the release commit `vX.Y.Z[-suffix]` → push
 the tag. CI builds, signs, notarizes (when secrets exist) and attaches the
 DMG to the release.
 Sidecars stay ad-hoc signed inside the bundle — the app is never
 `codesign --deep`ed.
@@ -174,8 +145,6 @@ Environment variables read by the pipeline:
 | `CODESIGN_IDENTITY` | Developer ID identity for the outer `.app`; unset or `-` = ad-hoc |
 | `DEVELOPMENT_TEAM` | team ID passed to `xcodebuild` when signing |
 | `NOTARIZE_APPLE_ID` / `NOTARIZE_PASSWORD` / `APPLE_TEAM_ID` | `notarytool` + staple when all three are set |
 | `RELEASE_TAG` | release tag string (CI sets `github.ref_name`); stamped into the bundle + DMG name |
 | `BUILD_NUMBER` | `CFBundleVersion` override; default `git rev-list --count HEAD` |
 ## Layout
@@ -237,13 +206,9 @@ xcodebuild test -scheme ICCery -destination 'platform=macOS' \
  -only-testing:ICCeryUITests/Milestone5UITests
 ```
-CI (`.gitea/workflows/macos.yml` on Gitea, `.github/workflows/macos.yml` on
+CI (`.gitea/workflows/macos.yml`) runs `build-and-test` then `package` on
 GitHub) runs `build-and-test` then `package` on
 `develop` and on `v*` tags. Tags whose name contains `prerelease` skip the
 test job and still package. `pull_request` is wired for **`develop` only**.
 The GitHub file is the same pipeline on `macos-14` (github.com retired
 `macos-12`), `actions/upload-artifact@v4`, and `gh release upload` for tag
 DMGs.
 UI tests need an unlocked console (`IOConsoleLocked=false`). Mock Argyll /
 CUPS fixtures live under the test bundles; they must not be treated as proof
@@ -299,9 +264,9 @@ fix/<issue>-<slug>
 ```
 Open feature/fix PRs against **`develop`**. A `milestone/m…` integration
-branch is used only while that milestone is assembling — currently
+branch is used only while that milestone is assembling; `milestone/m10-studio`
-`milestone/m11-print-settings` (`milestone/m10-studio` was merged and
+has been merged and deleted. Do not open umbrella “bugfix” branches that mix
-deleted). Do not open umbrella “bugfix” branches that mix tickets.
+tickets.
 `main` is push-protected and requires status check
 `macOS CI / build-and-test (push)`. Protected **file** patterns on `main`
@@ -6,8 +6,6 @@ import ICCeryCore
 struct AboutView: View {
    let onClose: () -> Void
    @State private var showingLicenses = false
    private let info = ArtefactFiles.appInfo()
    var body: some View {
@@ -56,12 +54,6 @@ struct AboutView: View {
                .foregroundStyle(.secondary)
                .multilineTextAlignment(.center)
            Button("View Licenses") {
                showingLicenses = true
            }
            .controlSize(.large)
            .accessibilityIdentifier("viewLicensesBtn")
            Button("Close") {
                onClose()
            }
@@ -74,8 +66,5 @@ struct AboutView: View {
        .background(Theme.panel)
        .accessibilityElement(children: .contain)
        .accessibilityIdentifier("aboutDialog")
        .sheet(isPresented: $showingLicenses) {
            LicenseWindowView()
        }
    }
 }
@@ -136,19 +136,9 @@ enum UITestHooks {
                    $0.isEmpty ? nil : $0
                } ?? queue,
                options: PrintOptions(
                    orientation: options.flatMap {
                        CupsParsers.extractOrientation(fromOptionsString: $0)
                    },
                    paperSize: options.flatMap {
                        CupsParsers.extractOption(
                            named: "PageSize", fromOptionsString: $0)
                    },
                    mediaType: options.flatMap {
                        CupsParsers.extractMediaType(fromOptionsString: $0)
                    },
                    quality: options.flatMap {
                        CupsParsers.extractQuality(fromOptionsString: $0)
                    },
                    ppdUncorrectedPassthrough: true,
                    cupsOptions: options))
        default:
@@ -56,41 +56,10 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
    }
    /// docs/21 §Shell: 1280×800 content, min 1100×700, centred.
    /// GitHub-hosted Macs (and any display smaller than 1280×800) must
    /// not get a window that hangs off-screen — XCTest then reports
    /// sidebar controls at negative x as not hittable (run 34864198118).
    private func configureMainWindow(_ window: NSWindow) {
-        let desired = NSSize(width: 1280, height: 800)
+        window.setContentSize(NSSize(width: 1280, height: 800))
-        let minimum = NSSize(width: 1100, height: 700)
+        window.contentMinSize = NSSize(width: 1100, height: 700)
        let visible = (window.screen ?? NSScreen.main)?.visibleFrame
            ?? NSRect(origin: .zero, size: desired)
        window.contentMinSize = NSSize(
            width: min(minimum.width, visible.width),
            height: min(minimum.height, visible.height)
        )
        window.setContentSize(NSSize(
            width: min(desired.width, visible.width),
            height: min(desired.height, max(minimum.height, visible.height - 40))
        ))
        window.center()
        var frame = window.frame
        if frame.width > visible.width {
            frame.size.width = visible.width
        }
        if frame.height > visible.height {
            frame.size.height = visible.height
        }
        frame.origin.x = min(
            max(frame.origin.x, visible.minX),
            visible.maxX - frame.width
        )
        frame.origin.y = min(
            max(frame.origin.y, visible.minY),
            visible.maxY - frame.height
        )
        window.setFrame(frame, display: true)
    }
    /// Dock-click reopen: let the WindowGroup re-show or recreate the
@@ -1,148 +0,0 @@
 import AppKit
 import SwiftUI
 /// Detailed license and attribution window (issue #31, docs/21 §Modals).
 struct LicenseWindowView: View {
    @Environment(\.dismiss) private var dismiss
    private let icceryLicense: String
    private let argyllLicense: String
    init() {
        // ICCery license from LICENCE.md (embedded at compile time)
        self.icceryLicense = """
 # LICENCE
 **Copyright (c) 2026 Gordon Bolton**  
 **All Rights Reserved.**
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), strictly to view the source code and execute the Software for the sole purpose of personal testing, evaluation, and providing feedback.
 Under this licence, you may **not**:
 * Modify, alter, or create derivative works of the Software.
 * Distribute, publish, or sublicense the Software or any derivatives.
 * Use the Software for any commercial or production purpose.
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ---
 ## Bundled ArgyllCMS sidecar binaries
 This application bundles and invokes command-line binaries from the Gronod fork of ArgyllCMS. Those binaries are licensed separately under the **GNU Affero General Public License v3 (AGPLv3)**. They are executed strictly as independent subprocesses — they are never linked, loaded, or incorporated into this application — and a copy of `License.txt` is shipped beside the binaries in `Resources/Argyll/`. The terms above apply only to the ICCery application source code, not to the ArgyllCMS binaries.
 """
        // ArgyllCMS license from bundled License.txt
        if let url = Bundle.main.url(forResource: "License", withExtension: "txt", subdirectory: "Argyll"),
           let content = try? String(contentsOf: url, encoding: .utf8) {
            self.argyllLicense = content
        } else {
            self.argyllLicense = """
 ArgyllCMS license not found — run `scripts/fetch-argyll.sh` to bundle binaries and license.
 The ArgyllCMS binaries are licensed under the GNU Affero General Public License v3 (AGPLv3).
 A copy of the license should be present at Resources/Argyll/License.txt.
 See: https://git.i3omb.com/gronod/argyllcms/releases
 """
        }
    }
    var body: some View {
        VStack(spacing: 0) {
            // Title bar
            HStack {
                Text("Licenses & Attribution")
                    .font(.headline)
                    .foregroundStyle(Theme.text)
                Spacer()
                Button("Close") {
                    dismiss()
                }
                .keyboardShortcut(.cancelAction)
                .accessibilityIdentifier("closeLicenseBtn")
            }
            .padding(.horizontal, 20)
            .padding(.vertical, 12)
            .background(Theme.panel.opacity(0.9))
            Divider()
            ScrollView {
                VStack(alignment: .leading, spacing: 24) {
                    // Section 1: ICCery License
                    licenseSection(
                        title: "ICCery License",
                        content: icceryLicense,
                        identifier: "icceryLicenseSection"
                    )
                    Divider()
                    // Section 2: ArgyllCMS License
                    licenseSection(
                        title: "ArgyllCMS License (AGPLv3)",
                        content: argyllLicense,
                        identifier: "argyllLicenseSection"
                    )
                    Divider()
                    // Section 3: Attribution & Links
                    VStack(alignment: .leading, spacing: 12) {
                        Text("Attribution & Links")
                            .font(.headline)
                            .foregroundStyle(Theme.text)
                            .accessibilityIdentifier("attributionHeader")
                        VStack(alignment: .leading, spacing: 8) {
                            Link("ArgyllCMS by Graeme Gill → https://www.argyllcms.com/",
                                 destination: URL(string: "https://www.argyllcms.com/")!)
                                .font(.callout)
                                .foregroundStyle(Theme.accent)
                                .accessibilityIdentifier("argyllUpstreamLink")
                            Link("Gronod ArgyllCMS fork (v3.5.0-ICCery.1.x) → https://git.i3omb.com/gronod/argyllcms",
                                 destination: URL(string: "https://git.i3omb.com/gronod/argyllcms")!)
                                .font(.callout)
                                .foregroundStyle(Theme.accent)
                                .accessibilityIdentifier("argyllForkLink")
                        }
                        Text("ICCery bundles and invokes ArgyllCMS binaries as isolated subprocesses per AGPLv3 isolation requirements. The ArgyllCMS binaries are never linked, loaded, or incorporated into the ICCery application binary.")
                            .font(.caption)
                            .foregroundStyle(.secondary)
                            .fixedSize(horizontal: false, vertical: true)
                            .accessibilityIdentifier("agplIsolationNote")
                    }
                    .padding(.horizontal, 4)
                    .accessibilityElement(children: .contain)
                    .accessibilityIdentifier("attributionSection")
                }
                .padding(24)
            }
            .frame(minWidth: 600, minHeight: 500)
            .background(Theme.panel)
        }
        .accessibilityElement(children: .contain)
        .accessibilityIdentifier("licenseWindow")
    }
    private func licenseSection(title: String, content: String, identifier: String) -> some View {
        VStack(alignment: .leading, spacing: 8) {
            Text(title)
                .font(.headline)
                .foregroundStyle(Theme.text)
                .accessibilityIdentifier(identifier + "Header")
            Text(content)
                .font(.system(.body, design: .monospaced))
                .foregroundStyle(Theme.text)
                .textSelection(.enabled)
                .frame(maxWidth: .infinity, alignment: .leading)
                .accessibilityIdentifier(identifier + "Content")
        }
        .padding(.horizontal, 4)
    }
 }
@@ -17,24 +17,6 @@ enum PrintPanelError: LocalizedError {
    }
 }
 /// Stage 2 selections pre-applied to the bound print panel before it
 /// opens (#183/#186). Every write is warn-only — the panel still
 /// opens when a driver ignores a key.
 struct PrintPanelInitialSelections {
    /// CUPS `PageSize` token, e.g. `"A4"` / `"Custom.595x842"`. Written
    /// to `PMPrintSettings` **and** `PMPageFormat` (#186 E1).
    var paperSize: String?
    /// The queue's detected quality enumeration key, e.g. `EPIJ_Qual`.
    var qualityKey: String?
    /// The selected quality token.
    var quality: String?
    /// The selected media token — written to the queue's detected
    /// vendor key (`CNIJMediaType`/`EPIJ_Medi`/…) (#186).
    var mediaType: String?
    /// `"portrait"`/`"landscape"` → `orientation-requested` 3|4 (#186).
    var orientation: String?
 }
 /// Preferences → native `NSPrintPanel` bound to the selected CUPS
 /// queue (issue 13, docs/11).
 ///
@@ -59,9 +41,7 @@ struct PrintPanelService {
    func showProperties(
        queue: String,
        displayName: String?,
-        cupsService: CupsService,
+        cupsService: CupsService
        initialSelections: PrintPanelInitialSelections =
            PrintPanelInitialSelections()
    ) async throws -> PrintPropertiesResult? {
        #if DEBUG
        if UITestHooks.printPanelStubbed {
@@ -76,8 +56,7 @@ struct PrintPanelService {
        let optionKeys = (try? await cupsService.optionKeys(for: queue))
            ?? []
        return try runNativePanel(
-            queue: queue, displayName: display, optionKeys: optionKeys,
+            queue: queue, displayName: display, optionKeys: optionKeys)
            initialSelections: initialSelections)
    }
    // MARK: - Panel
@@ -85,8 +64,7 @@ struct PrintPanelService {
    private func runNativePanel(
        queue: String,
        displayName: String?,
-        optionKeys: Set<String>,
+        optionKeys: Set<String>
        initialSelections: PrintPanelInitialSelections
    ) throws -> PrintPropertiesResult? {
        let printInfo = NSPrintInfo()
        var pmPrinter: PMPrinter?
@@ -111,26 +89,9 @@ struct PrintPanelService {
            // queue but are not fatal when they fail.
            _ = PMSessionDefaultPrintSettings(session, settings)
            _ = PMSessionDefaultPageFormat(session, pageFormat)
            // Initial selections — after `PMSessionDefault*`, before
            // ColorSync suppression ②–⑤ (locked write order,
            // #183/#186). Paper is TWO writes (E1): the `PageSize`
            // print-settings value drivers/capture read AND the
            // `PMPageFormat` paper the panel's dropdown reflects.
            applyInitialSelections(
                initialSelections, to: settings, optionKeys: optionKeys)
            if let paperToken = initialSelections.paperSize {
                applyPaperPageFormat(
                    paperToken, printer: printer, session: session,
                    printInfo: printInfo)
            }
            boundViaPM = true
        } else {
            // Fallback: NSPrinter by display name (docs/11 §binding).
            // Warn — the display name can resolve a *different* queue
            // (#186 E2: diagnosable, not a proven defect).
            AppLogger.shared.warn(
                "Print panel: PM binding unavailable for '\(queue)' — "
                    + "falling back to NSPrinter(displayName)")
            guard let displayName,
                  let nsPrinter = NSPrinter(name: displayName)
            else {
@@ -177,9 +138,7 @@ struct PrintPanelService {
        // ⑥ Capture the user's choices — filtered replay options plus
        // the media type they picked. Re-fetch the settings handle so
-        // we read back what the modal wrote. Paper size, quality, and
+        // we read back what the modal wrote.
        // orientation ride back parsed from the captured `k=v` string
        // (#183); the PDE may rewrite or drop them (R12).
        var cupsOptions: String?
        var mediaType: String?
        if boundViaPM {
@@ -189,7 +148,6 @@ struct PrintPanelService {
            cupsOptions = captured.cupsOptions
            mediaType = captured.mediaType
        }
        let capturedOptions = cupsOptions ?? ""
        return PrintPropertiesResult(
            selectedPrinter: boundViaPM
                ? Self.currentPrinterID(
@@ -198,144 +156,11 @@ struct PrintPanelService {
                    fallback: queue)
                : nil,
            options: PrintOptions(
                orientation: CupsParsers.extractOrientation(
                    fromOptionsString: capturedOptions),
                paperSize: CupsParsers.extractOption(
                    named: "PageSize", fromOptionsString: capturedOptions),
                mediaType: mediaType,
                quality: CupsParsers.extractQuality(
                    fromOptionsString: capturedOptions),
                ppdUncorrectedPassthrough: true,
                cupsOptions: cupsOptions))
    }
    /// Initial-selection `PMPrintSettings` writes — paper, quality,
    /// media type, orientation. All warn-only: a driver that ignores
    /// a key must not keep the panel from opening (R12 surfaces via
    /// the capture echo instead).
    private func applyInitialSelections(
        _ selections: PrintPanelInitialSelections,
        to settings: PMPrintSettings,
        optionKeys: Set<String>
    ) {
        if let paperSize = selections.paperSize {
            warnOnFailure(PMPrintSettingsSetValue(
                settings, "PageSize" as CFString,
                paperSize as CFString, false), key: "PageSize")
        }
        if let key = selections.qualityKey, let value = selections.quality {
            warnOnFailure(PMPrintSettingsSetValue(
                settings, key as CFString,
                value as CFString, false), key: key)
        }
        // Media type via the queue's detected vendor key (#186).
        if let mediaType = selections.mediaType,
           let mediaKey = CupsParsers.detectMediaTypeKey(
               optionKeys: optionKeys) {
            warnOnFailure(PMPrintSettingsSetValue(
                settings, mediaKey as CFString,
                mediaType as CFString, false), key: mediaKey)
        }
        // Orientation — portrait=3, landscape=4 (CUPS IPP codes).
        if let orientation = selections.orientation {
            let code = orientation == "landscape" ? "4" : "3"
            warnOnFailure(PMPrintSettingsSetValue(
                settings, "orientation-requested" as CFString,
                code as CFString, false), key: "orientation-requested")
        }
    }
    /// The `PMPageFormat` half of paper preselect (#186 E1): the
    /// panel's paper dropdown reflects the page format's `PMPaper`,
    /// not `PMPrintSettings`. Match the Stage 2 `PageSize` token to a
    /// paper from `PMPrinterGetPaperList`, rebuild the page format
    /// around it, and copy it into the printInfo's format (TN2248:
    /// `PMCreatePageFormatWithPMPaper` → `PMSessionValidatePageFormat`
    /// → `PMCopyPageFormat` → `updateFromPMPageFormat`).
    /// `Custom.<w>x<h>` tokens (already points) have no `PMPaper` —
    /// set the Cocoa `paperSize` directly. Warn-only throughout: a
    /// missed match must not keep the panel from opening.
    private func applyPaperPageFormat(
        _ token: String,
        printer: PMPrinter,
        session: PMPrintSession,
        printInfo: NSPrintInfo
    ) {
        if let custom = Self.customPaperDimensions(from: token) {
            printInfo.paperSize = NSSize(
                width: custom.width, height: custom.height)
            return
        }
        var paperList: Unmanaged<CFArray>?
        guard PMPrinterGetPaperList(printer, &paperList) == 0,
              let papers = paperList?.takeUnretainedValue()
        else {
            AppLogger.shared.warn(
                "Print panel: PMPrinterGetPaperList failed — "
                    + "paper preselect skipped")
            return
        }
        // The list (and its elements) is owned by the printer —
        // borrowed, never released.
        var match: PMPaper?
        for index in 0..<CFArrayGetCount(papers) {
            let paper = unsafeBitCast(
                CFArrayGetValueAtIndex(papers, index), to: PMPaper.self)
            var idRef: Unmanaged<CFString>?
            guard PMPaperGetID(paper, &idRef) == 0,
                  let paperID = idRef?.takeUnretainedValue() as String?
            else { continue }
            if paperID == token {
                match = paper
                break
            }
        }
        guard let paper = match else {
            AppLogger.shared.warn(
                "Print panel: no PMPaper id matches '\(token)'")
            return
        }
        var created: PMPageFormat?
        guard PMCreatePageFormatWithPMPaper(&created, paper) == 0,
              let newFormat = created
        else {
            AppLogger.shared.warn(
                "Print panel: PMCreatePageFormatWithPMPaper failed "
                    + "for '\(token)'")
            return
        }
        defer { PMRelease(unsafeBitCast(newFormat, to: PMObject.self)) }
        _ = PMSessionValidatePageFormat(session, newFormat, nil)
        let destination = unsafeBitCast(
            printInfo.pmPageFormat(), to: PMPageFormat.self)
        _ = PMCopyPageFormat(newFormat, destination)
        printInfo.updateFromPMPageFormat()
    }
    /// `Custom.<w>x<h>` → dimensions in points (the token builder
    /// emits integer points, mm × 72/25.4). `nil` for non-custom or
    /// malformed tokens — a malformed `Custom.*` then misses the
    /// `PMPaper` match and logs instead of guessing a size.
    static func customPaperDimensions(
        from token: String
    ) -> (width: Double, height: Double)? {
        guard token.hasPrefix("Custom.") else { return nil }
        let dims = token.dropFirst("Custom.".count).split(separator: "x")
        guard dims.count == 2,
              let width = Double(dims[0]), let height = Double(dims[1]),
              width > 0, height > 0
        else { return nil }
        return (width, height)
    }
    private func warnOnFailure(_ status: OSStatus, key: String) {
        if status != 0 {
            AppLogger.shared.warn(
                "Print panel: PMPrintSettingsSetValue(\(key)) "
                    + "rejected (\(status))")
        }
    }
    // MARK: - PM helpers
    /// `PMPrinter` → `PMObject` for `PMRelease` — the Carbon API wants
@@ -7,20 +7,12 @@ import ICCeryCore
 final class PrintSessionViewModel: ObservableObject {
    let wizard: WizardViewModel
    let environment: AppEnvironment
    /// Stage 1/2 form state — read for paper seeding/mirroring only;
    /// `workflow.pageSize` is the printtarg layout and is never written
    /// back from the print side (#183).
    weak var workflow: TargetWorkflowViewModel?
    @Published var printers: [Printer] = []
    @Published var selectedPrinter = ""
    @Published var printerCaps = PrinterCapabilities()
    @Published var selectedTray: Int?
    @Published var selectedMediaType: String?
    /// `PrinterPaperSize.id` — `0` is the synthetic custom entry (#183).
    @Published var selectedPaperSize: Int?
    /// Print-quality option token, e.g. `"303"` (#183).
    @Published var selectedQuality: String?
    @Published var printOrientation = "portrait"
    @Published var capturedCupsOptions: [String: String] = [:]
    @Published var printNotice: Notice?
@@ -83,79 +75,22 @@ final class PrintSessionViewModel: ObservableObject {
            if selectedTray == nil {
                selectedTray = printerCaps.trays.first?.id
            }
            if selectedQuality == nil {
                selectedQuality = printerCaps.qualityDefault
                    ?? printerCaps.qualities.first?.id
            }
            // Caps reload is a re-mirror trigger for the paper picker
            // (#183 E4) — pageSize + printer changes route here too.
            seedPaperSelection()
        } catch {
            printerCaps = PrinterCapabilities()
        }
    }
    // MARK: - Paper / quality selection (#183)
    /// Seed `selectedPaperSize` from Stage 1's `workflow.pageSize`:
    /// a capability whose name matches `pageSize.rawValue` → its id;
    /// `.custom` → the synthetic `Custom.<pt>x<pt>` entry (`id: 0`);
    /// no match → nil (never guess). Called only on pageSize / printer /
    /// caps triggers — never on unrelated publishes (R14).
    func seedPaperSelection() {
        guard let pageSize = workflow?.pageSize else { return }
        if pageSize == .custom {
            let token = customPaperToken()
            if let index = printerCaps.paperSizes.firstIndex(where: { $0.id == 0 }) {
                printerCaps.paperSizes[index].name = token
            } else {
                printerCaps.paperSizes.append(
                    PrinterPaperSize(id: 0, name: token))
            }
            selectedPaperSize = 0
            return
        }
        selectedPaperSize = printerCaps.paperSizes
            .first { $0.name == pageSize.rawValue }?.id
    }
    /// `Custom.<w>x<h>` in **points** — mm × 72/25.4 (#183 E5/R8). The
    /// PPD template token `Custom.WIDTHxHEIGHT` is never emitted verbatim.
    func customPaperToken() -> String {
        let w = workflow?.customPageW ?? 0
        let h = workflow?.customPageH ?? 0
        let wPt = (w * 72.0 / 25.4).rounded()
        let hPt = (h * 72.0 / 25.4).rounded()
        return "Custom.\(Int(wPt))x\(Int(hPt))"
    }
    /// The CUPS `PageSize` token for the current Stage 2 pick — live
    /// `Custom.<pt>x<pt>` for the synthetic entry, else the capability
    /// name. This is what `lp -o PageSize=` sees.
    var selectedPaperSizeToken: String? {
        guard let id = selectedPaperSize else { return nil }
        if id == 0 { return customPaperToken() }
        return printerCaps.paperSizes.first { $0.id == id }?.name
    }
    func openPrinterPreferences() {
        guard !selectedPrinter.isEmpty else { return }
        let queue = selectedPrinter
        let displayName = printers.first { $0.name == queue }?.displayName
        let cups = environment.cupsService
        let selections = PrintPanelInitialSelections(
            paperSize: selectedPaperSizeToken,
            qualityKey: printerCaps.qualityKey,
            quality: selectedQuality,
            mediaType: selectedMediaType,
            orientation: printOrientation)
        Task { @MainActor in
            do {
                guard let result = try await PrintPanelService()
                    .showProperties(
                        queue: queue, displayName: displayName,
-                        cupsService: cups,
+                        cupsService: cups)
                        initialSelections: selections)
                else {
                    printNotice = Notice(
                        kind: .info,
@@ -176,21 +111,6 @@ final class PrintSessionViewModel: ObservableObject {
                if let media = result.options.mediaType {
                    selectedMediaType = media
                }
                // Capture-return (#183/#186): a dialog paper/quality/
                // orientation change updates the Stage 2 selections —
                // never `workflow.pageSize` (printtarg layout is
                // sacred).
                if let paper = result.options.paperSize,
                   let match = printerCaps.paperSizes
                       .first(where: { $0.name == paper }) {
                    selectedPaperSize = match.id
                }
                if let quality = result.options.quality {
                    selectedQuality = quality
                }
                if let orientation = result.options.orientation {
                    printOrientation = orientation
                }
                printNotice = Notice(
                    kind: .info,
                    text: "Settings captured for \(selectedPrinter).",
@@ -202,7 +122,7 @@ final class PrintSessionViewModel: ObservableObject {
        }
    }
-    func printAllPages(from result: PrinttargResult) {
+    func printAllPages(from result: PrinttargResult, pageSize: PageSize) {
        guard !isPrinting else { return }
        isPrinting = true
        let task = Task { @MainActor [weak self] in
@@ -212,7 +132,7 @@ final class PrintSessionViewModel: ObservableObject {
            var printed = 0
            for page in result.pages {
                do {
-                    try await spool(page, index: page.index)
+                    try await spool(page, index: page.index, pageSize: pageSize)
                    printed += 1
                } catch {
                    printNotice = Notice(
@@ -236,13 +156,13 @@ final class PrintSessionViewModel: ObservableObject {
        printTask = task
    }
-    func printPage(_ page: GalleryPage) {
+    func printPage(_ page: GalleryPage, pageSize: PageSize) {
        guard !isPrinting else { return }
        isPrinting = true
        let task = Task { @MainActor [weak self] in
            guard let self else { return }
            do {
-                try await spool(page, index: page.index)
+                try await spool(page, index: page.index, pageSize: pageSize)
                printNotice = Notice(
                    kind: .info,
                    text: "Sent \(page.page.filename) to \(selectedPrinter).",
@@ -260,18 +180,14 @@ final class PrintSessionViewModel: ObservableObject {
        printTask = task
    }
-    private func spool(_ page: GalleryPage, index: Int) async throws {
+    private func spool(_ page: GalleryPage, index: Int, pageSize: PageSize) async throws {
        guard !selectedPrinter.isEmpty else {
            throw CupsError.noPrinterSelected
        }
        // The Stage 2 paper token is what `lp -o PageSize=` sees;
        // `workflow.pageSize` remains the printtarg layout input only
        // (#183).
        let options = PrintOptions(
            orientation: printOrientation,
-            paperSize: selectedPaperSizeToken,
+            paperSize: pageSize == .custom ? nil : pageSize.rawValue,
            mediaType: selectedMediaType,
            quality: selectedQuality,
            ppdUncorrectedPassthrough: true,
            cupsOptions: capturedCupsOptions[selectedPrinter])
        try await environment.cupsService.printTarget(
@@ -255,7 +255,6 @@ struct Stage2View: View {
                .onChange(of: workflow.print.selectedPrinter) { _ in
                    workflow.print.selectedTray = nil
                    workflow.print.selectedMediaType = nil
                    workflow.print.selectedQuality = nil
                    Task { @MainActor in await workflow.print.reloadSelectedCapabilities() }
                }
                if let selected = workflow.print.printers
@@ -280,9 +279,7 @@ struct Stage2View: View {
                .accessibilityIdentifier("btnPrinterProperties")
            }
-            // Tray / media / paper / quality / orientation — from
+            // Tray / media / orientation — from queue capabilities.
            // queue capabilities. Extracted subviews keep every
            // ViewBuilder ≤10 children (R13).
            HStack(spacing: 14) {
                if !workflow.print.printerCaps.trays.isEmpty {
                    Picker("Tray", selection: $workflow.print.selectedTray) {
@@ -304,12 +301,6 @@ struct Stage2View: View {
                    .accessibilityIdentifier("mediaTypeGroup")
                    .accessibilityIdentifier("printerMediaTypeSelect")
                }
                if !workflow.print.printerCaps.paperSizes.isEmpty {
                    paperSizeGroup
                }
                if !workflow.print.printerCaps.qualities.isEmpty {
                    qualityGroup
                }
                HStack(spacing: 0) {
                    Button("Portrait") { workflow.print.printOrientation = "portrait" }
                        .buttonStyle(.bordered)
@@ -322,13 +313,11 @@ struct Stage2View: View {
                }
                Spacer()
            }
            // Stage 1 owns the custom dimensions — the caption lives
            // inside `paperSizeGroup` (#183).
            HStack(spacing: 8) {
                Button(action: {
                    if let result = workflow.printtargResult {
-                        workflow.print.printAllPages(from: result)
+                        workflow.print.printAllPages(from: result, pageSize: workflow.pageSize)
                    }
                }) {
                    Label(workflow.print.isPrinting ? "Printing…" : "Print All",
@@ -355,50 +344,6 @@ struct Stage2View: View {
        .onChange(of: workflow.printtargResult?.pages.count) { _ in
            schedulePrinterRefresh()
        }
        // Editable picker that re-mirrors Stage 1's pageSize (#183 E4).
        .onChange(of: workflow.pageSize) { _ in
            workflow.print.seedPaperSelection()
        }
    }
    /// Paper picker + custom-size caption under the `paperSizeGroup`
    /// container (#183). `caps.paperSizes` plus the synthetic custom
    /// entry (`id: 0`, shown as `Custom (W×H mm)`).
    private var paperSizeGroup: some View {
        VStack(alignment: .leading, spacing: 4) {
            Picker("Paper", selection: $workflow.print.selectedPaperSize) {
                ForEach(workflow.print.printerCaps.paperSizes, id: \.id) { size in
                    Text(size.id == 0
                         ? "Custom (\(Int(workflow.customPageW))×\(Int(workflow.customPageH)) mm)"
                         : size.name)
                        .tag(Optional(size.id))
                }
            }
            .frame(maxWidth: 200)
            .accessibilityIdentifier("printerPaperSizeSelect")
            if workflow.print.selectedPaperSize == 0 {
                Text("Custom (\(Int(workflow.customPageW))×\(Int(workflow.customPageH)) mm)")
                    .font(.caption)
                    .foregroundStyle(.secondary)
            }
        }
        .accessibilityElement(children: .contain)
        .accessibilityIdentifier("paperSizeGroup")
    }
    /// Quality picker — driver tokens with PPD-enriched labels (#183).
    private var qualityGroup: some View {
        VStack(alignment: .leading, spacing: 4) {
            Picker("Quality", selection: $workflow.print.selectedQuality) {
                ForEach(workflow.print.printerCaps.qualities, id: \.id) {
                    Text($0.name).tag(Optional($0.id))
                }
            }
            .frame(maxWidth: 200)
            .accessibilityIdentifier("printerQualitySelect")
        }
        .accessibilityElement(children: .contain)
        .accessibilityIdentifier("qualityGroup")
    }
    /// Auto-enumerates printers once a manifest exists and whenever it
@@ -447,7 +392,7 @@ private struct GalleryPageView: View {
            Text("\(page.page.patches) patches · " +
                 "\(Int(page.page.widthMm))×\(Int(page.page.heightMm)) mm")
                .font(.caption2).foregroundStyle(.secondary)
-            Button("Print") { workflow.print.printPage(page) }
+            Button("Print") { workflow.print.printPage(page, pageSize: workflow.pageSize) }
                .disabled(workflow.print.isPrinting
                          || workflow.print.selectedPrinter.isEmpty)
                .accessibilityIdentifier("btnPrintPage-\(page.index)")
@@ -137,9 +137,6 @@ final class TargetWorkflowViewModel: ObservableObject {
            environment: environment
        )
        self.print = PrintSessionViewModel(wizard: wizard, environment: environment)
        // Paper-size seeding reads the Stage 1 form through this weak
        // back-reference; the print side never writes it (#183).
        self.print.workflow = self
        self.calibration = nil
        self.calibration = CalibrationViewModel(
            workflow: self,
@@ -102,62 +102,6 @@ final class TiffPreviewTests: XCTestCase {
    }
 }
 final class AppInfoTests: XCTestCase {
    // MARK: displayVersion (#189)
    func testNoTagFallsBackToShortVersion() {
        XCTAssertEqual(
            ArtefactFiles.displayVersion(shortVersion: "2.0.0", releaseTag: ""),
            "2.0.0"
        )
    }
    func testWhitespaceTagFallsBackToShortVersion() {
        XCTAssertEqual(
            ArtefactFiles.displayVersion(shortVersion: "2.0.0", releaseTag: "  "),
            "2.0.0"
        )
    }
    func testExactReleaseTagDedupes() {
        XCTAssertEqual(
            ArtefactFiles.displayVersion(shortVersion: "2.0.0", releaseTag: "v2.0.0"),
            "v2.0.0"
        )
    }
    func testBareVersionTagDedupes() {
        XCTAssertEqual(
            ArtefactFiles.displayVersion(shortVersion: "2.0.0", releaseTag: "2.0.0"),
            "2.0.0"
        )
    }
    func testPrereleaseTagShowsMarketingInParens() {
        XCTAssertEqual(
            ArtefactFiles.displayVersion(
                shortVersion: "2.0.0", releaseTag: "v2.0.0-pre2-grok"),
            "v2.0.0-pre2-grok (2.0.0)"
        )
    }
    func testDescribeStringShowsMarketingInParens() {
        XCTAssertEqual(
            ArtefactFiles.displayVersion(
                shortVersion: "2.0.0", releaseTag: "v2.0.0-5-gdeadbee"),
            "v2.0.0-5-gdeadbee (2.0.0)"
        )
    }
    func testAppInfoUsesComposedVersion() {
        // .main in the test host is the ICCery app under test; whatever it
        // resolves to, build must be a non-empty digits-or-default string.
        let info = ArtefactFiles.appInfo()
        XCTAssertFalse(info.version.isEmpty)
        XCTAssertFalse(info.build.isEmpty)
    }
 }
 final class ArtefactFilesTests: XCTestCase {
    func testBase64RoundTrip() throws {
        let url = tempURL("a.txt")
@@ -24,18 +24,6 @@ final class CupsOptionsFilterTests: XCTestCase {
        XCTAssertEqual(CupsOptionsFilter.filter(raw), raw)
    }
    /// #180 — a captured `EPIJ_Qual` (and the other canonical quality
    /// keys) survives the filter so it wins over the Stage 2 explicit
    /// quality in `LpArgs`.
    func testKeepsQualityKeys() {
        let raw = "EPIJ_Qual=304 CNIJPrintQuality=3 PrintQuality=2 "
            + "cupsPrintQuality=High Quality=Best "
            + "com.apple.print.JobTicket.PMTotalSidesImaged=0"
        XCTAssertEqual(CupsOptionsFilter.filter(raw),
            "EPIJ_Qual=304 CNIJPrintQuality=3 PrintQuality=2 "
            + "cupsPrintQuality=High Quality=Best")
    }
    func testKeepsUnknown() {
        let raw = "VendorFooBar=baz MediaType=Plain"
        XCTAssertEqual(CupsOptionsFilter.filter(raw), raw)
@@ -4,7 +4,7 @@ import Foundation
 /// Issue 12 — CUPS enumeration parsers on recorded fixtures
 /// (docs/10–11). No live `lpstat`/`lpoptions` is spawned here.
-final class CupsParserTests: XCTestCase {
+final class CupsParsersTests: XCTestCase {
    // Recorded on an Epson XP-55 + Canon Pro9500 host.
    private let lpstatE = """
@@ -30,7 +30,7 @@ final class CupsParserTests: XCTestCase {
        MediaType/Media Type: *Stationery PhotographicHighGloss Photographic PhotographicMatte Envelope
        ColorModel/Output Mode: *RGB Gray
        Duplex/Duplex: *None DuplexNoTumble DuplexTumble
-        EPIJ_Qual/Print Quality: 301 302 *303 308 304 305 307
+        cupsPrintQuality/cupsPrintQuality: Draft *Normal High
        """
    func testDestinations() {
@@ -117,157 +117,6 @@ final class CupsParserTests: XCTestCase {
        XCTAssertNil(CupsParsers.detectMediaTypeKey(optionKeys: ["PageSize"]))
    }
    // MARK: - #183 quality key + option extraction
    func testQualityKeyRosterOrder() {
        // Vendor keys beat the generic ones; OutputMode/Resolution sit
        // last (they are colour-ish keys on some drivers — #183/#180).
        XCTAssertEqual(CupsParsers.detectQualityKey(
            optionKeys: ["EPIJ_Qual", "Quality", "OutputMode"]), "EPIJ_Qual")
        // A full Epson key set — EPIJ_Qual wins over the colour-mode
        // key, the generic keys, and Resolution (#180, R11).
        XCTAssertEqual(CupsParsers.detectQualityKey(
            optionKeys: ["EPIJ_Qual", "OutputMode", "Resolution",
                         "cupsPrintQuality", "PrintQuality",
                         "ColorModel"]), "EPIJ_Qual")
        XCTAssertEqual(CupsParsers.detectQualityKey(
            optionKeys: ["Quality", "OutputMode", "Resolution"]), "Quality")
        XCTAssertEqual(CupsParsers.detectQualityKey(
            optionKeys: ["cupsPrintQuality", "CNIJQuality"]),
            "CNIJQuality")
        XCTAssertEqual(CupsParsers.detectQualityKey(
            optionKeys: ["OutputMode", "Resolution"]), "OutputMode")
        XCTAssertEqual(CupsParsers.detectQualityKey(
            optionKeys: ["Resolution"]), "Resolution")
        XCTAssertNil(CupsParsers.detectQualityKey(optionKeys: ["PageSize"]))
    }
    func testCapabilitiesQuality() {
        let service = CupsService()
        let listings = CupsParsers.lpoptionsList(lpoptionsL)
        let caps = service.capabilities(from: listings, ppd: nil)
        // EPIJ_Qual is the roster member — all seven Epson codes
        // enumerate in the driver's own (non-sorted) order (#180).
        XCTAssertEqual(caps.qualityKey, "EPIJ_Qual")
        XCTAssertEqual(caps.qualities.map(\.id),
            ["301", "302", "303", "308", "304", "305", "307"])
        XCTAssertEqual(caps.qualityDefault, "303")
    }
    func testCapabilitiesQualityPpdLabels() {
        // Epson XP-55 PPD fragment — the seven `*EPIJ_Qual id/Label`
        // lines in the driver's own order (#180).
        let ppd = """
            *OpenUI *EPIJ_Qual/Print Quality: PickOne
            *DefaultEPIJ_Qual: 303
            *EPIJ_Qual 301/Fast Economy: ""
            *EPIJ_Qual 302/Economy: ""
            *EPIJ_Qual 303/Normal: ""
            *EPIJ_Qual 308/Draft: ""
            *EPIJ_Qual 304/Fine: ""
            *EPIJ_Qual 305/Quality: ""
            *EPIJ_Qual 307/Best Quality: ""
            *CloseUI: *EPIJ_Qual
            """
        let service = CupsService()
        let listings = CupsParsers.lpoptionsList(
            "EPIJ_Qual/Print Quality: 301 302 *303 308 304 305 307\n")
        let caps = service.capabilities(from: listings, ppd: ppd)
        XCTAssertEqual(caps.qualityKey, "EPIJ_Qual")
        XCTAssertEqual(caps.qualities, [
            PrinterQuality(id: "301", name: "Fast Economy"),
            PrinterQuality(id: "302", name: "Economy"),
            PrinterQuality(id: "303", name: "Normal"),
            PrinterQuality(id: "308", name: "Draft"),
            PrinterQuality(id: "304", name: "Fine"),
            PrinterQuality(id: "305", name: "Quality"),
            PrinterQuality(id: "307", name: "Best Quality"),
        ])
        XCTAssertEqual(caps.qualityDefault, "303")
    }
    /// #180 — the Epson listing also carries `OutputMode` (a colour
    /// mode) and `Resolution`; detection must still pick `EPIJ_Qual`.
    func testCapabilitiesQualityEpsonDetection() {
        let service = CupsService()
        let listings = CupsParsers.lpoptionsList("""
            PageSize/Media Size: *A4 Letter
            EPIJ_Qual/Print Quality: 301 302 *303 308 304 305 307
            OutputMode/Color Mode: *Color Mono
            Resolution/Resolution: *360dpi 720dpi
            """)
        let caps = service.capabilities(from: listings, ppd: nil)
        XCTAssertEqual(caps.qualityKey, "EPIJ_Qual")
        XCTAssertEqual(caps.qualities.count, 7)
        XCTAssertEqual(caps.qualityDefault, "303")
        XCTAssertFalse(caps.qualities.contains { $0.id == "Color" })
    }
    func testExtractOption() {
        let options = "PageSize=A4 EPIJ_Qual=303 printer-info='EPSON XP-55'"
        XCTAssertEqual(CupsParsers.extractOption(
            named: "PageSize", fromOptionsString: options), "A4")
        // Case-insensitive key match.
        XCTAssertEqual(CupsParsers.extractOption(
            named: "epij_qual", fromOptionsString: options), "303")
        // Quoted values come back unquoted.
        XCTAssertEqual(CupsParsers.extractOption(
            named: "printer-info", fromOptionsString: options), "EPSON XP-55")
        XCTAssertNil(CupsParsers.extractOption(
            named: "InputSlot", fromOptionsString: options))
    }
    func testExtractQualityAndOrientation() {
        let options = "orientation-requested=4 OutputMode=Gray EPIJ_Qual=305"
        XCTAssertEqual(CupsParsers.extractQuality(
            fromOptionsString: options), "305")
        XCTAssertEqual(CupsParsers.extractOrientation(
            fromOptionsString: options), "landscape")
        XCTAssertNil(CupsParsers.extractQuality(
            fromOptionsString: "PageSize=A4"))
        XCTAssertNil(CupsParsers.extractOrientation(
            fromOptionsString: "PageSize=A4"))
    }
    // MARK: - #186 capture-return
    /// A captured `k=v` string maps to all four `PrintOptions`
    /// fields — `PageSize`, the detected quality key,
    /// `orientation-requested`, and a vendor media key (#186).
    func testCapturedStringMapsAllFields() {
        let captured =
            "PageSize=A4 EPIJ_Qual=305 orientation-requested=4 CNIJMediaType=Photo"
        XCTAssertEqual(CupsParsers.extractOption(
            named: "PageSize", fromOptionsString: captured), "A4")
        XCTAssertEqual(CupsParsers.extractQuality(
            fromOptionsString: captured), "305")
        XCTAssertEqual(CupsParsers.extractOrientation(
            fromOptionsString: captured), "landscape")
        XCTAssertEqual(CupsParsers.extractMediaType(
            fromOptionsString: captured), "Photo")
    }
    /// Vendor media keys beyond `MediaType`/`EPIJ_Medi` extract via
    /// the detection roster — `CNIJMediaType`/`StpMediaType` included
    /// (#186). `MediaType` still wins when present alongside them.
    func testExtractMediaTypeRosterFallback() {
        XCTAssertEqual(CupsParsers.extractMediaType(
            fromOptionsString: "CNIJMediaType=PhotoPlus"), "PhotoPlus")
        XCTAssertEqual(CupsParsers.extractMediaType(
            fromOptionsString: "StpMediaType=Glossy"), "Glossy")
        XCTAssertEqual(CupsParsers.extractMediaType(
            fromOptionsString: "EPIJ_Medi=Photo"), "Photo")
        // `MediaType` keeps first precedence (docs/11 §tests).
        XCTAssertEqual(CupsParsers.extractMediaType(
            fromOptionsString: "CNIJMediaType=PhotoPlus MediaType=Plain"),
            "Plain")
        XCTAssertNil(CupsParsers.extractMediaType(
            fromOptionsString: "PageSize=A4"))
    }
    func testDriverBypass() {
        func pair(_ keys: Set<String>) -> String? {
            CupsParsers.detectDriverColorBypass(optionKeys: keys)
@@ -282,177 +131,4 @@ final class CupsParserTests: XCTestCase {
        XCTAssertEqual(pair(["EpsonColorMode"]), "EpsonColorMode=Off")
        XCTAssertNil(pair(["PageSize"]))
    }
    // MARK: - #181 Canon media locale precedence + PPD encoding
    /// The 18 Canon Pro9500 media types named in the issue — the ids
    /// are the numeric codes the driver enumerates via `lpoptions -l`.
    private let canonMedia: [(id: String, label: String)] = [
        ("0", "Plain Paper"),
        ("1", "Photo Paper Plus Glossy II"),
        ("2", "Photo Paper Pro Platinum N"),
        ("3", "Photo Paper Pro Platinum"),
        ("4", "Photo Paper Pro Luster"),
        ("5", "Photo Paper Plus Semi-gloss"),
        ("6", "Matte Photo Paper"),
        ("7", "Fine Art \"Photo Rag\""),
        ("8", "Fine Art \"Museum Etching\""),
        ("9", "Photo Paper Pro Premium Matte"),
        ("10", "Fine Art Premium Matte"),
        ("11", "Other Fine Art Paper"),
        ("12", "Canvas"),
        ("13", "Board Paper"),
        ("14", "Ink Jet Hagaki"),
        ("15", "Hagaki"),
        ("16", "Printable disc"),
        ("17", "Printable disc (bleed-proof)"),
    ]
    /// Canon Pro9500-shaped fragment: the unqualified base block comes
    /// early and the `th.` block trails at the end — the ordering that
    /// let Thai overwrite English under last-write-wins (#181).
    private var canonPPD: String {
        var lines = [
            "*OpenUI *CNIJMediaType/Media Type: PickOne",
            "*DefaultCNIJMediaType: 0",
        ]
        for media in canonMedia {
            lines.append(
                "*CNIJMediaType \(media.id)/\(media.label): \"\"")
        }
        lines.append("*CloseUI: *CNIJMediaType")
        for media in canonMedia {
            lines.append(
                "*th.CNIJMediaType \(media.id)/กระดาษ\(media.id): \"\"")
        }
        return lines.joined(separator: "\n")
    }
    func testPpdLabelsUnqualifiedSurvivesTrailingThai() {
        let labels = CupsParsers.ppdChoiceLabels(
            canonPPD, key: "CNIJMediaType")
        XCTAssertEqual(labels["0"], "Plain Paper")
        XCTAssertEqual(labels["17"], "Printable disc (bleed-proof)")
    }
    func testPpdLabelsUnqualifiedWinsRegardlessOfOrder() {
        // `th.` block first — precedence is deterministic, not
        // positional (#181, E3).
        let ppd = """
            *th.CNIJMediaType 0/กระดาษธรรมดา: ""
            *CNIJMediaType 0/Plain Paper: ""
            """
        let labels = CupsParsers.ppdChoiceLabels(ppd, key: "CNIJMediaType")
        XCTAssertEqual(labels["0"], "Plain Paper")
    }
    func testPpdLabelsQualifiedFallbackOrder() {
        // en_US > en > first-qualified-seen (#181, E3).
        let ppd = """
            *en.CNIJMediaType 1/English Label: ""
            *en_US.CNIJMediaType 1/US English Label: ""
            *th.CNIJMediaType 1/กระดาษ: ""
            *fr.CNIJMediaType 2/Français: ""
            *de.CNIJMediaType 2/Deutsch: ""
            """
        let labels = CupsParsers.ppdChoiceLabels(ppd, key: "CNIJMediaType")
        XCTAssertEqual(labels["1"], "US English Label")
        // A qualified-only id still gets its first-seen qualified
        // label — never left unlabeled (R9).
        XCTAssertEqual(labels["2"], "Français")
    }
    func testPpdLabelsHexEscapeDecoding() {
        let ppd = """
            *CNIJMediaType 3/Photo Paper Plus Glossy<2F>Matte: ""
            *CNIJMediaType 4/Plain<20>Paper: ""
            *CNIJMediaType 5/Bad<ZZ>Escape: ""
            """
        let labels = CupsParsers.ppdChoiceLabels(ppd, key: "CNIJMediaType")
        XCTAssertEqual(labels["3"], "Photo Paper Plus Glossy/Matte")
        XCTAssertEqual(labels["4"], "Plain Paper")
        XCTAssertEqual(labels["5"], "Bad<ZZ>Escape")
    }
    /// Every `CNIJMediaType` choice enumerated by `lpoptions -l` gets a
    /// non-Thai label (E1 — the true count is the hardware gate's, so
    /// no count is hardcoded here); the 18 named AC labels are
    /// spot-checked.
    func testCapabilitiesCanonMediaAllNonThai() {
        var choices = canonMedia.map(\.id)
        choices[0] = "*\(choices[0])"
        let listings = CupsParsers.lpoptionsList(
            "CNIJMediaType/Media Type: \(choices.joined(separator: " "))\n")
        let caps = CupsService().capabilities(from: listings, ppd: canonPPD)
        XCTAssertEqual(caps.mediaTypes.count, canonMedia.count)
        for type in caps.mediaTypes {
            XCTAssertFalse(type.name.unicodeScalars.contains {
                (0x0E00...0x0E7F).contains($0.value)
            }, "Thai label leaked into \(type.id): \(type.name)")
        }
        for media in canonMedia {
            XCTAssertEqual(
                caps.mediaTypes.first { $0.id == media.id }?.name,
                media.label)
        }
    }
    /// UTF-8 PPD carrying Thai labels decodes intact — the English
    /// base block wins precedence and no mojibake leaks through (#181,
    /// R10). Exercises `loadPPD` through `capabilities(for:)`.
    func testLoadPPDUtf8ThaiSurvivesDecode() async throws {
        let (service, root) = try makeCupsService(
            ppdData: Data(canonPPD.utf8),
            listing: "CNIJMediaType/Media Type: *0 1")
        defer { try? FileManager.default.removeItem(at: root) }
        let caps = try await service.capabilities(for: "Canon_Test")
        XCTAssertEqual(caps.mediaTypes.map(\.name),
            ["Plain Paper", "Photo Paper Plus Glossy II"])
    }
    /// A PPD that is not valid UTF-8 (lone `0xE9` for `é`) falls back
    /// to ISO-Latin-1 instead of yielding nil → raw ids (#181, R10).
    func testLoadPPDLatin1Fallback() async throws {
        let ppd = "*CNIJMediaType 0/Papier Couché: \"\"\n"
        let (service, root) = try makeCupsService(
            ppdData: ppd.data(using: .isoLatin1)!,
            listing: "CNIJMediaType/Media Type: *0")
        defer { try? FileManager.default.removeItem(at: root) }
        let caps = try await service.capabilities(for: "Canon_Test")
        XCTAssertEqual(caps.mediaTypes,
            [PrinterMediaType(id: "0", name: "Papier Couché")])
    }
    /// Fixture `lpoptions` + `ppdDir` so `capabilities(for:)` reaches
    /// the private `loadPPD` — same mock style as
    /// `MediaLibraryViewModelTests.installMockCups`.
    private func makeCupsService(
        ppdData: Data,
        listing: String,
        queue: String = "Canon_Test"
    ) throws -> (CupsService, URL) {
        let root = FileManager.default.temporaryDirectory
            .appendingPathComponent("iccery-ppd-\(UUID().uuidString)")
        let bin = root.appendingPathComponent("bin")
        let ppdDir = root.appendingPathComponent("ppd")
        for dir in [bin, ppdDir] {
            try FileManager.default.createDirectory(
                at: dir, withIntermediateDirectories: true)
        }
        let lpoptions = """
            #!/bin/sh
            printf '%s\\n' '\(listing)'
            """
        let scriptURL = bin.appendingPathComponent("lpoptions")
        try lpoptions.write(to: scriptURL, atomically: true, encoding: .utf8)
        try FileManager.default.setAttributes(
            [.posixPermissions: 0o755], ofItemAtPath: scriptURL.path)
        try ppdData.write(to: ppdDir.appendingPathComponent("\(queue).ppd"))
        return (CupsService(
            processManager: ProcessManager(),
            binaryDir: bin, ppdDir: ppdDir), root)
    }
 }
@@ -101,61 +101,6 @@ final class LpArgsTests: XCTestCase {
        XCTAssertTrue(capturedSize.contains("PageSize=Letter"))
    }
    // MARK: - #183 print quality
    func testQualityDerived() throws {
        let argv = try build(
            options: PrintOptions(
                orientation: "portrait", mediaType: "Photo", quality: "305"),
            optionKeys: ["EPIJ_Qual", "MediaType"])
        XCTAssertTrue(argv.contains("EPIJ_Qual=305"))
        // Emit order: after the media option, before orientation.
        let media = argv.firstIndex(of: "MediaType=Photo")!
        let quality = argv.firstIndex(of: "EPIJ_Qual=305")!
        let orient = argv.firstIndex(of: "orientation-requested=3")!
        XCTAssertTrue(media < quality && quality < orient)
    }
    func testQualityDetectedKey() throws {
        // The detected queue key is used, not a hardcoded one.
        let argv = try build(
            options: PrintOptions(quality: "High"),
            optionKeys: ["cupsPrintQuality"])
        XCTAssertTrue(argv.contains("cupsPrintQuality=High"))
    }
    func testCapturedWinsQuality() throws {
        let argv = try build(
            options: PrintOptions(
                quality: "303",
                cupsOptions: "EPIJ_Qual=308"),
            optionKeys: ["EPIJ_Qual"])
        XCTAssertTrue(argv.contains("EPIJ_Qual=308"))
        XCTAssertFalse(argv.contains("EPIJ_Qual=303"))
    }
    func testCapturedQualityCaseInsensitiveDedup() throws {
        let argv = try build(
            options: PrintOptions(
                quality: "303",
                cupsOptions: "epij_qual=308"),
            optionKeys: ["EPIJ_Qual"])
        XCTAssertFalse(argv.contains("EPIJ_Qual=303"))
        XCTAssertTrue(argv.contains("epij_qual=308"))
    }
    func testQualityNilNoEmit() throws {
        let argv = try build(
            options: PrintOptions(mediaType: "Photo"),
            optionKeys: ["EPIJ_Qual", "MediaType"])
        XCTAssertFalse(argv.contains { $0.hasPrefix("EPIJ_Qual=") })
        // No quality key on the queue → no emit either.
        let noKey = try build(
            options: PrintOptions(quality: "303"),
            optionKeys: ["MediaType"])
        XCTAssertFalse(noKey.contains { $0.hasPrefix("EPIJ_Qual=") })
    }
    func testSanitise() throws {
        XCTAssertThrowsError(try build(options: PrintOptions(
            cupsOptions: "InputSlot=Rear;rm -rf /"))) { error in
@@ -52,41 +52,6 @@ final class PrintPanelStubTests: XCTestCase {
        }
    }
    /// #183 — the stub parses paper size / quality / orientation out of
    /// `ICCERY_TEST_PANEL_OPTIONS` so UI tests can verify apply-back.
    func testOkResultExtractsNewFields() throws {
        try withEnv([
            "ICCERY_UI_TESTING": "1",
            "ICCERY_TEST_PRINT_PANEL": "ok",
            "ICCERY_TEST_PANEL_OPTIONS":
                "PageSize=Letter EPIJ_Qual=305 orientation-requested=4",
            "ICCERY_TEST_PANEL_PRINTER": nil,
        ]) {
            let result = UITestHooks.printPanelResult(forQueue: "q")
            XCTAssertEqual(result?.options.paperSize, "Letter")
            XCTAssertEqual(result?.options.quality, "305")
            XCTAssertEqual(result?.options.orientation, "landscape")
        }
    }
    /// #186 — a vendor media key in the captured string reaches
    /// `options.mediaType` through the detection roster
    /// (`CNIJMediaType`/`StpMediaType`, not only `MediaType`).
    func testOkResultExtractsVendorMediaKey() throws {
        try withEnv([
            "ICCERY_UI_TESTING": "1",
            "ICCERY_TEST_PRINT_PANEL": "ok",
            "ICCERY_TEST_PANEL_OPTIONS":
                "PageSize=A4 orientation-requested=4 CNIJMediaType=Photo",
            "ICCERY_TEST_PANEL_PRINTER": nil,
        ]) {
            let result = UITestHooks.printPanelResult(forQueue: "q")
            XCTAssertEqual(result?.options.paperSize, "A4")
            XCTAssertEqual(result?.options.orientation, "landscape")
            XCTAssertEqual(result?.options.mediaType, "Photo")
        }
    }
    func testOkDefaultsPrinter() throws {
        try withEnv([
            "ICCERY_UI_TESTING": "1",
@@ -1,392 +0,0 @@
 import Foundation
 import XCTest
@testable import ICCeryCore
@testable import ICCery
 /// Issue #183 — Stage 2 paper-size / quality selection: seeding from
 /// Stage 1 `pageSize`, the synthetic `Custom.<pt>x<pt>` entry, re-mirror
 /// triggers, and `PrintOptions` wiring into `lp` argv.
 /// `lpoptions`/`lp` are mock scripts in the test env's `cups-bin` — no
 /// live CUPS is touched.
@MainActor
 final class PrintSessionViewModelTests: XCTestCase {
    private var env: TestAppEnvironment!
    private var lpArgvURL: URL!
    override func setUp() async throws {
        env = try TestAppEnvironment.make()
        lpArgvURL = env.root.appendingPathComponent("lp-argv.log")
        try writeCupsFixtures()
    }
    override func tearDown() async throws {
        env?.cleanup()
        env = nil
        lpArgvURL = nil
    }
    private var binDir: URL {
        env.root.appendingPathComponent("cups-bin")
    }
    /// Mock `lpoptions -l` advertises paper sizes + a quality key;
    /// mock `lp` appends its argv to `lpArgvURL` for assertions.
    private func writeCupsFixtures() throws {
        try FileManager.default.createDirectory(
            at: binDir, withIntermediateDirectories: true)
        let lpoptions = """
            #!/bin/sh
            list=0
            queue=""
            for arg in "$@"; do
              case "$arg" in
                -l) list=1 ;;
                -*) ;;
                *) queue="$arg" ;;
              esac
            done
            if [ "$list" = "1" ]; then
              printf 'PageSize/Media Size: 4x6 5x7 *A4 Letter Legal Custom.WIDTHxHEIGHT\\n'
              printf 'InputSlot/Media Source: Auto *Main Rear\\n'
              printf 'MediaType/Media Type: *Stationery Glossy Matte\\n'
              printf 'EPIJ_Qual/Print Quality: 301 302 *303 308 304 305 307\\n'
              exit 0
            fi
            printf "printer-info='Mock %s' printer-type=42\\n" "$queue"
            exit 0
            """
        let lp = """
            #!/bin/sh
            printf '%s\\n' "$*" >> "\(lpArgvURL.path)"
            exit 0
            """
        for (name, body) in [("lpoptions", lpoptions), ("lp", lp)] {
            let url = binDir.appendingPathComponent(name)
            try body.write(to: url, atomically: true, encoding: .utf8)
            try FileManager.default.setAttributes(
                [.posixPermissions: 0o755], ofItemAtPath: url.path)
        }
    }
    private func makeWorkflow() -> TargetWorkflowViewModel {
        TargetWorkflowViewModel(environment: env.environment)
    }
    private func loadCaps(
        _ vm: PrintSessionViewModel, queue: String = "Mock_Q"
    ) async {
        vm.selectedPrinter = queue
        await vm.reloadSelectedCapabilities()
    }
    private func waitForFile(
        _ url: URL, timeout: TimeInterval = 10
    ) async -> String {
        let deadline = Date().addingTimeInterval(timeout)
        while Date() < deadline {
            if let text = try? String(contentsOf: url, encoding: .utf8),
               !text.isEmpty {
                return text
            }
            try? await Task.sleep(nanoseconds: 100_000_000)
        }
        return (try? String(contentsOf: url, encoding: .utf8)) ?? ""
    }
    // MARK: - Seeding / mirror
    /// `pageSize = .a4` matches the capability named "A4" → its id.
    func testSeedMatchesPageSizeRawValue() async {
        let workflow = makeWorkflow()
        workflow.pageSize = .a4
        await loadCaps(workflow.print)
        XCTAssertEqual(workflow.pageSize, .a4)
        XCTAssertEqual(workflow.print.selectedPaperSize, 3)
        // Quality seeds from the `*` default on caps load.
        XCTAssertEqual(workflow.print.selectedQuality, "303")
        // All seven Epson codes enumerate in driver order (#180).
        XCTAssertEqual(workflow.print.printerCaps.qualities.map(\.id),
            ["301", "302", "303", "308", "304", "305", "307"])
    }
    /// `.custom` → synthetic `id: 0` entry whose token is the
    /// dimensions in **points** (mm × 72/25.4): 210×297 → `Custom.595x842`.
    func testSeedCustomPageSizeSyntheticEntry() async {
        let workflow = makeWorkflow()
        workflow.pageSize = .custom
        workflow.customPageW = 210
        workflow.customPageH = 297
        await loadCaps(workflow.print)
        XCTAssertEqual(workflow.print.selectedPaperSize, 0)
        let synthetic = workflow.print.printerCaps.paperSizes
            .first { $0.id == 0 }
        XCTAssertEqual(synthetic?.name, "Custom.595x842")
        XCTAssertEqual(workflow.print.selectedPaperSizeToken, "Custom.595x842")
    }
    /// A `workflow.pageSize` change re-mirrors the picker.
    func testReseedOnPageSizeChange() async {
        let workflow = makeWorkflow()
        workflow.pageSize = .a4
        await loadCaps(workflow.print)
        XCTAssertEqual(workflow.print.selectedPaperSize, 3)
        workflow.pageSize = .letter
        workflow.print.seedPaperSelection()
        XCTAssertEqual(workflow.print.selectedPaperSize, 4)
    }
    /// A user pick survives unrelated publishes — re-seed only fires
    /// on pageSize / printer / caps triggers (#183, R14).
    func testUserEditPreservedAcrossUnrelatedPublishes() async {
        let workflow = makeWorkflow()
        workflow.pageSize = .a4
        await loadCaps(workflow.print)
        workflow.print.selectedPaperSize = 5
        workflow.print.selectedTray = 2
        workflow.print.printOrientation = "landscape"
        workflow.print.printNotice = Notice(kind: .info, text: "x")
        XCTAssertEqual(workflow.print.selectedPaperSize, 5)
    }
    /// A printer change re-seeds from `workflow.pageSize` after the
    /// capabilities reload (the picker re-mirrors, not guesses).
    func testPrinterChangeReseeds() async {
        let workflow = makeWorkflow()
        workflow.pageSize = .a4
        await loadCaps(workflow.print)
        workflow.print.selectedPaperSize = 5
        workflow.print.selectedQuality = "301"
        // The view nils quality on printer change before reloading —
        // the VM re-seeds `when nil` only (#183 contract).
        workflow.print.selectedPrinter = "Other_Q"
        workflow.print.selectedQuality = nil
        await workflow.print.reloadSelectedCapabilities()
        XCTAssertEqual(workflow.print.selectedPaperSize, 3)
        XCTAssertEqual(workflow.print.selectedQuality, "303")
    }
    /// A pageSize with no capability match leaves the pick nil —
    /// never a guessed id.
    func testSeedNoMatchLeavesNil() async {
        let workflow = makeWorkflow()
        workflow.pageSize = .a2
        await loadCaps(workflow.print)
        XCTAssertNil(workflow.print.selectedPaperSize)
        XCTAssertNil(workflow.print.selectedPaperSizeToken)
    }
    // MARK: - Spool wiring
    /// `spool` emits the Stage 2 paper token and quality through
    /// `PrintOptions` → `lp` argv (`-o PageSize=`, `-o <qualityKey>=`).
    func testSpoolPassesPaperTokenAndQuality() async throws {
        let workflow = makeWorkflow()
        workflow.pageSize = .a4
        await loadCaps(workflow.print)
        workflow.print.selectedPaperSize = 4 // Letter
        workflow.print.selectedQuality = "301"
        let tiff = env.root.appendingPathComponent("page1.tif")
        try Data([0x49, 0x49]).write(to: tiff)
        let page = GalleryPage(
            index: 0,
            page: PrinttargPage(
                filename: "page1.tif", patches: 10,
                widthMm: 210, heightMm: 297),
            fileURL: tiff, previewPNG: nil, previewError: nil)
        let result = PrinttargResult(
            ti2URL: env.root.appendingPathComponent("target.ti2"),
            manifest: PrinttargManifest(pages: [page.page]),
            pages: [page])
        workflow.print.printAllPages(from: result)
        let argv = await waitForFile(lpArgvURL)
        XCTAssertTrue(argv.contains("PageSize=Letter"), argv)
        XCTAssertTrue(argv.contains("EPIJ_Qual=301"), argv)
    }
    // MARK: - Panel apply-back (stubbed NSPrintPanel)
    /// The stubbed panel's captured `PageSize=`/`EPIJ_Qual=` apply back
    /// to `selectedPaperSize`/`selectedQuality` (#183 capture-return).
    func testPanelResultAppliesBackSelections() async throws {
        setenv("ICCERY_UI_TESTING", "1", 1)
        setenv("ICCERY_TEST_PRINT_PANEL", "ok", 1)
        setenv("ICCERY_TEST_PANEL_OPTIONS",
               "PageSize=Letter EPIJ_Qual=305", 1)
        defer {
            unsetenv("ICCERY_UI_TESTING")
            unsetenv("ICCERY_TEST_PRINT_PANEL")
            unsetenv("ICCERY_TEST_PANEL_OPTIONS")
        }
        let workflow = makeWorkflow()
        workflow.pageSize = .a4
        await loadCaps(workflow.print)
        XCTAssertEqual(workflow.print.selectedPaperSize, 3)
        XCTAssertEqual(workflow.print.selectedQuality, "303")
        workflow.print.openPrinterPreferences()
        let deadline = Date().addingTimeInterval(10)
        while Date() < deadline,
              workflow.print.selectedPaperSize != 4
              || workflow.print.selectedQuality != "305" {
            try? await Task.sleep(nanoseconds: 100_000_000)
        }
        XCTAssertEqual(workflow.print.selectedPaperSize, 4)
        XCTAssertEqual(workflow.print.selectedQuality, "305")
    }
    /// #186 — the captured `orientation-requested`/media token apply
    /// back to `printOrientation`/`selectedMediaType`, and a dialog
    /// result never mutates `workflow.pageSize` (printtarg layout).
    func testPanelResultAppliesBackOrientationAndMedia() async throws {
        setenv("ICCERY_UI_TESTING", "1", 1)
        setenv("ICCERY_TEST_PRINT_PANEL", "ok", 1)
        setenv("ICCERY_TEST_PANEL_OPTIONS",
               "orientation-requested=4 MediaType=Glossy", 1)
        defer {
            unsetenv("ICCERY_UI_TESTING")
            unsetenv("ICCERY_TEST_PRINT_PANEL")
            unsetenv("ICCERY_TEST_PANEL_OPTIONS")
        }
        let workflow = makeWorkflow()
        workflow.pageSize = .a4
        await loadCaps(workflow.print)
        XCTAssertEqual(workflow.print.printOrientation, "portrait")
        XCTAssertEqual(workflow.print.selectedMediaType, "Stationery")
        workflow.print.openPrinterPreferences()
        await waitForNotice(workflow.print, containing: "Settings captured")
        XCTAssertEqual(workflow.print.printOrientation, "landscape")
        XCTAssertEqual(workflow.print.selectedMediaType, "Glossy")
        XCTAssertEqual(workflow.pageSize, .a4)
    }
    /// #186 — a captured `PageSize` token with no capability match
    /// leaves `selectedPaperSize` unchanged (never a guessed id).
    func testPanelResultUnknownPaperLeavesSelection() async throws {
        setenv("ICCERY_UI_TESTING", "1", 1)
        setenv("ICCERY_TEST_PRINT_PANEL", "ok", 1)
        setenv("ICCERY_TEST_PANEL_OPTIONS", "PageSize=Bogus", 1)
        defer {
            unsetenv("ICCERY_UI_TESTING")
            unsetenv("ICCERY_TEST_PRINT_PANEL")
            unsetenv("ICCERY_TEST_PANEL_OPTIONS")
        }
        let workflow = makeWorkflow()
        workflow.pageSize = .a4
        await loadCaps(workflow.print)
        XCTAssertEqual(workflow.print.selectedPaperSize, 3)
        workflow.print.openPrinterPreferences()
        await waitForNotice(workflow.print, containing: "Settings captured")
        XCTAssertEqual(workflow.print.selectedPaperSize, 3)
    }
    /// #186 — a stub result pointing at another queue in `printers`
    /// switches `selectedPrinter` and reloads its capabilities.
    func testPanelResultSwitchesToKnownQueue() async throws {
        setenv("ICCERY_UI_TESTING", "1", 1)
        setenv("ICCERY_TEST_PRINT_PANEL", "ok", 1)
        setenv("ICCERY_TEST_PANEL_OPTIONS", "PageSize=Letter", 1)
        setenv("ICCERY_TEST_PANEL_PRINTER", "Other_Q", 1)
        defer {
            unsetenv("ICCERY_UI_TESTING")
            unsetenv("ICCERY_TEST_PRINT_PANEL")
            unsetenv("ICCERY_TEST_PANEL_OPTIONS")
            unsetenv("ICCERY_TEST_PANEL_PRINTER")
        }
        let workflow = makeWorkflow()
        workflow.pageSize = .a4
        workflow.print.printers = [
            Printer(name: "Mock_Q", isDefault: true),
            Printer(name: "Other_Q"),
        ]
        await loadCaps(workflow.print)
        workflow.print.openPrinterPreferences()
        await waitForNotice(
            workflow.print, containing: "Settings captured for Other_Q")
        XCTAssertEqual(workflow.print.selectedPrinter, "Other_Q")
        // Caps reloaded for the new queue: paper re-seeded, then the
        // captured PageSize applied back onto the new caps.
        XCTAssertEqual(workflow.print.selectedPaperSize, 4)
        XCTAssertEqual(workflow.print.capturedCupsOptions["Other_Q"],
            "PageSize=Letter")
    }
    /// #186 — a stub result naming a queue absent from `printers`
    /// leaves the selection on the opened queue.
    func testPanelResultGhostQueueIgnored() async throws {
        setenv("ICCERY_UI_TESTING", "1", 1)
        setenv("ICCERY_TEST_PRINT_PANEL", "ok", 1)
        setenv("ICCERY_TEST_PANEL_PRINTER", "Ghost_Q", 1)
        defer {
            unsetenv("ICCERY_UI_TESTING")
            unsetenv("ICCERY_TEST_PRINT_PANEL")
            unsetenv("ICCERY_TEST_PANEL_PRINTER")
        }
        let workflow = makeWorkflow()
        workflow.pageSize = .a4
        workflow.print.printers = [Printer(name: "Mock_Q", isDefault: true)]
        await loadCaps(workflow.print)
        workflow.print.openPrinterPreferences()
        await waitForNotice(
            workflow.print, containing: "Settings captured for Mock_Q")
        XCTAssertEqual(workflow.print.selectedPrinter, "Mock_Q")
    }
    /// #186 — cancel returns `nil`: info notice, no field changes.
    func testPanelCancelLeavesSelections() async throws {
        setenv("ICCERY_UI_TESTING", "1", 1)
        setenv("ICCERY_TEST_PRINT_PANEL", "cancel", 1)
        defer {
            unsetenv("ICCERY_UI_TESTING")
            unsetenv("ICCERY_TEST_PRINT_PANEL")
        }
        let workflow = makeWorkflow()
        workflow.pageSize = .a4
        await loadCaps(workflow.print)
        workflow.print.printOrientation = "landscape"
        workflow.print.openPrinterPreferences()
        await waitForNotice(workflow.print, containing: "cancelled")
        XCTAssertEqual(workflow.print.selectedPaperSize, 3)
        XCTAssertEqual(workflow.print.selectedQuality, "303")
        XCTAssertEqual(workflow.print.selectedMediaType, "Stationery")
        XCTAssertEqual(workflow.print.printOrientation, "landscape")
        XCTAssertTrue(workflow.print.capturedCupsOptions.isEmpty)
    }
    /// Poll until the panel task posts a notice whose text contains
    /// `fragment` (the Task-completion signal for `nil` results too).
    private func waitForNotice(
        _ vm: PrintSessionViewModel,
        containing fragment: String,
        timeout: TimeInterval = 10
    ) async {
        let deadline = Date().addingTimeInterval(timeout)
        while Date() < deadline {
            if let text = vm.printNotice?.text, text.contains(fragment) {
                return
            }
            try? await Task.sleep(nanoseconds: 100_000_000)
        }
        XCTFail("Timed out waiting for notice containing '\(fragment)'")
    }
 }
@@ -20,13 +20,6 @@ final class AboutHelpUITests: XCTestCase {
    private func element(_ id: String) -> XCUIElement {
        let inApp = app.descendants(matching: .any)[id].firstMatch
        if inApp.exists { return inApp }
        // Search all sheets (including nested sheets) for the element.
        // The license window is a nested sheet (sheet presented from AboutView).
        for sheet in app.sheets.allElementsBoundByIndex {
            let inSheet = sheet.descendants(matching: .any)[id].firstMatch
            if inSheet.exists { return inSheet }
        }
        // Fallback to original behavior
        return app.sheets.firstMatch.descendants(matching: .any)[id].firstMatch
    }
@@ -92,139 +85,4 @@ final class AboutHelpUITests: XCTestCase {
                       "Toggling global help must not reflow the sidebar.")
        XCTAssertTrue(app.descendants(matching: .any)["openSettingsBtn"].exists)
    }
    func testAboutDialogShowsViewLicensesButton() throws {
        launchApp()
        let openAbout = app.buttons["openAboutBtn"]
        XCTAssertTrue(openAbout.waitForExistence(timeout: 10))
        openAbout.click()
        _ = waitFor("aboutVersion", timeout: 10)
        let viewLicensesBtn = waitFor("viewLicensesBtn", timeout: 10)
        XCTAssertTrue(viewLicensesBtn.exists)
        viewLicensesBtn.click()
        // License window should open as a sheet
        _ = waitFor("licenseWindow", timeout: 10)
        XCTAssertTrue(element("licenseWindow").exists)
        // Close license window
        let closeLicenseBtn = waitFor("closeLicenseBtn", timeout: 5)
        closeLicenseBtn.click()
        // License window should be dismissed
        XCTAssertFalse(element("licenseWindow").exists)
        // Close about dialog
        let closeAboutBtn = waitFor("closeAboutBtn", timeout: 5)
        closeAboutBtn.click()
        XCTAssertFalse(element("aboutDialog").exists)
    }
    func testLicenseWindowShowsICCeryLicense() throws {
        launchApp()
        let openAbout = app.buttons["openAboutBtn"]
        XCTAssertTrue(openAbout.waitForExistence(timeout: 10))
        openAbout.click()
        let viewLicensesBtn = waitFor("viewLicensesBtn", timeout: 10)
        viewLicensesBtn.click()
        _ = waitFor("licenseWindow", timeout: 10)
        // Verify ICCery license section exists
        let icceryLicenseSection = waitFor("icceryLicenseSectionHeader", timeout: 5)
        XCTAssertTrue(icceryLicenseSection.exists)
        // Verify ICCery license content contains key phrases
        let icceryLicenseContent = element("icceryLicenseSectionContent")
        XCTAssertTrue(icceryLicenseContent.waitForExistence(timeout: 5))
        let licenseText = icceryLicenseContent.value as? String ?? ""
        XCTAssertTrue(licenseText.contains("Copyright (c) 2026 Gordon Bolton"))
        XCTAssertTrue(licenseText.contains("All Rights Reserved"))
        XCTAssertTrue(licenseText.contains("AGPLv3"))
        // Close license window
        let closeLicenseBtn = waitFor("closeLicenseBtn", timeout: 5)
        closeLicenseBtn.click()
        let closeAboutBtn = waitFor("closeAboutBtn", timeout: 5)
        closeAboutBtn.click()
    }
    func testLicenseWindowShowsArgyllLicense() throws {
        launchApp()
        let openAbout = app.buttons["openAboutBtn"]
        XCTAssertTrue(openAbout.waitForExistence(timeout: 10))
        openAbout.click()
        let viewLicensesBtn = waitFor("viewLicensesBtn", timeout: 10)
        viewLicensesBtn.click()
        _ = waitFor("licenseWindow", timeout: 10)
        // Verify ArgyllCMS license section exists
        let argyllLicenseSection = waitFor("argyllLicenseSectionHeader", timeout: 5)
        XCTAssertTrue(argyllLicenseSection.exists)
        // Verify Argyll license content exists (may be fallback if License.txt not bundled)
        let argyllLicenseContent = element("argyllLicenseSectionContent")
        XCTAssertTrue(argyllLicenseContent.waitForExistence(timeout: 5))
        let licenseText = argyllLicenseContent.value as? String ?? ""
        // Should contain either the actual AGPLv3 license or the fallback notice
        XCTAssertTrue(licenseText.contains("AGPLv3") || licenseText.contains("GNU Affero General Public License") || licenseText.contains("fetch-argyll"))
        // Close license window
        let closeLicenseBtn = waitFor("closeLicenseBtn", timeout: 5)
        closeLicenseBtn.click()
        let closeAboutBtn = waitFor("closeAboutBtn", timeout: 5)
        closeAboutBtn.click()
    }
    func testLicenseWindowShowsAttributionLinks() throws {
        launchApp()
        let openAbout = app.buttons["openAboutBtn"]
        XCTAssertTrue(openAbout.waitForExistence(timeout: 10))
        openAbout.click()
        let viewLicensesBtn = waitFor("viewLicensesBtn", timeout: 10)
        viewLicensesBtn.click()
        _ = waitFor("licenseWindow", timeout: 10)
        // Verify attribution section exists
        let attributionHeader = waitFor("attributionHeader", timeout: 5)
        XCTAssertTrue(attributionHeader.exists)
        // Verify upstream link
        let upstreamLink = element("argyllUpstreamLink")
        XCTAssertTrue(upstreamLink.waitForExistence(timeout: 5))
        let upstreamLabel = upstreamLink.label
        XCTAssertTrue(upstreamLabel.contains("Graeme Gill") || upstreamLabel.contains("argyllcms.com"))
        // Verify fork link
        let forkLink = element("argyllForkLink")
        XCTAssertTrue(forkLink.waitForExistence(timeout: 5))
        let forkLabel = forkLink.label
        XCTAssertTrue(forkLabel.contains("Gronod") || forkLabel.contains("git.i3omb.com"))
        // Verify AGPL isolation note
        let isolationNote = element("agplIsolationNote")
        XCTAssertTrue(isolationNote.waitForExistence(timeout: 5))
        let noteText = isolationNote.value as? String ?? ""
        XCTAssertTrue(noteText.contains("isolated subprocesses") || noteText.contains("AGPLv3 isolation"))
        // Close license window
        let closeLicenseBtn = waitFor("closeLicenseBtn", timeout: 5)
        closeLicenseBtn.click()
        let closeAboutBtn = waitFor("closeAboutBtn", timeout: 5)
        closeAboutBtn.click()
    }
 }
@@ -1,8 +1,6 @@
 #!/bin/sh
 # Mock lpoptions for Milestone3UITests. `-p <q>` prints printer-info;
-# `-p <q> -l` prints Key/Label listings incl. Epson bypass keys and the
+# `-p <q> -l` prints Key/Label listings incl. Epson bypass keys.
 # recorded XP-55 EPIJ_Qual line — the driver's own non-sorted order
 # (308 sits between 303 and 304, #180).
 queue=""
 list=0
 for arg in "$@"; do
@@ -17,7 +15,6 @@ if [ "$list" = "1" ]; then
  printf 'PageSize/Media Size: 4x6 5x7 *A4 Letter Legal\n'
  printf 'InputSlot/Media Source: Auto *Main Rear\n'
  printf 'MediaType/Media Type: *Stationery PhotographicGlossy PhotographicMatte\n'
  printf 'EPIJ_Qual/Print Quality: 301 302 *303 308 304 305 307\n'
  printf 'EPIJ_CMat/Color Adjust: *0 1 2 3\n'
  printf 'ColorModel/Output Mode: *RGB Gray\n'
  exit 0
@@ -1,239 +0,0 @@
 import XCTest
 /// Milestone 11 UI tests — issue #183 Stage 2 paper size + print
 /// quality pickers. Runs against the same mock CUPS fixture binaries
 /// as `Milestone3UITests`; the `NSPrintPanel` stays stubbed through
 /// `ICCERY_TEST_PRINT_PANEL` (XCUITest cannot drive the system modal).
@MainActor
 final class Milestone11PrintSettingsUITests: XCTestCase {
    private var app: XCUIApplication!
    private var testRoot: URL!
    private var binDir: URL!
    private var workDir: URL!
    private var lpArgvURL: URL!
    override func setUp() async throws {
        continueAfterFailure = false
        testRoot = FileManager.default.temporaryDirectory
            .appendingPathComponent("iccery-ui11-\(UUID().uuidString)")
        binDir = URL(fileURLWithPath: #filePath)
            .deletingLastPathComponent()
            .appendingPathComponent("Fixtures/bin")
        workDir = testRoot.appendingPathComponent("work")
        lpArgvURL = testRoot.appendingPathComponent("lp-argv.log")
        try FileManager.default.createDirectory(
            at: workDir, withIntermediateDirectories: true)
        app = XCUIApplication()
        app.launchEnvironment = [
            "ICCERY_UI_TESTING": "1",
            "ICCERY_TEST_ROOT": testRoot.path,
            "ICCERY_ARGYLL_BINARY_DIR": binDir.path,
            "ICCERY_CUPS_BIN_DIR": binDir.path,
            "ICCERY_TEST_SAVE_TARGET":
                workDir.appendingPathComponent("mytarget.ti1").path,
            "ICCERY_TEST_WORKDIR": workDir.path,
            "ICCERY_TEST_LP_ARGV": lpArgvURL.path,
        ]
    }
    override func tearDown() async throws {
        app?.terminate()
        app = nil
        if let testRoot {
            try? FileManager.default.removeItem(at: testRoot)
        }
        testRoot = nil
    }
    private func element(_ id: String) -> XCUIElement {
        let inApp = app.descendants(matching: .any)[id]
        if inApp.exists { return inApp }
        return app.sheets.firstMatch.descendants(matching: .any)[id]
    }
    private func waitFor(_ id: String, timeout: TimeInterval = 15) -> XCUIElement {
        let deadline = Date().addingTimeInterval(timeout)
        while Date() < deadline {
            let el = element(id)
            if el.exists { return el }
            RunLoop.current.run(until: Date().addingTimeInterval(0.1))
        }
        let el = element(id)
        XCTAssertTrue(el.exists, "Expected element \(id)")
        return el
    }
    /// Drive the app through targen + printtarg so the print panel is
    /// live with a manifest.
    private func reachPrintPanel() {
        app.buttons["btnBrowse"].click()
        app.buttons["btnGenerate"].click()
        _ = waitFor("btnCreateLayout", timeout: 25)
        app.buttons["btnCreateLayout"].click()
        _ = waitFor("galleryPage-0", timeout: 25)
    }
    private func waitForLpLine(_ timeout: TimeInterval = 10) -> String {
        let deadline = Date().addingTimeInterval(timeout)
        while Date() < deadline {
            let out = (try? String(contentsOf: lpArgvURL, encoding: .utf8)) ?? ""
            if !out.isEmpty { return out }
            RunLoop.current.run(until: Date().addingTimeInterval(0.1))
        }
        return (try? String(contentsOf: lpArgvURL, encoding: .utf8)) ?? ""
    }
    // MARK: - Tests
    /// The paper-size and quality pickers exist with their new ids;
    /// the existing tray / media / orientation ids are unchanged (#183).
    func testPaperAndQualityPickersExist() throws {
        launchAppWithDefaults()
        reachPrintPanel()
        _ = waitFor("printerStatusBadge")
        XCTAssertTrue(element("printerPaperSizeSelect").exists)
        XCTAssertTrue(element("printerQualitySelect").exists)
        XCTAssertTrue(element("paperSizeGroup").exists)
        XCTAssertTrue(element("qualityGroup").exists)
        // Existing ids untouched. (`mediaTypeGroup` is not asserted —
        // stacked `.accessibilityIdentifier` modifiers collapse to the
        // last one, so it never resolved even before this change.)
        XCTAssertTrue(element("printerSelect").exists)
        XCTAssertTrue(element("printerTraySelect").exists)
        XCTAssertTrue(element("printerMediaTypeSelect").exists)
        XCTAssertTrue(element("btnOrientPortrait").exists)
        XCTAssertTrue(element("btnOrientLandscape").exists)
        XCTAssertTrue(element("btnPrinterProperties").exists)
    }
    /// The displayed selection of a picker — `AXTitle` for a popup
    /// button, falling back to label/value depending on how AppKit
    /// exposes the current item.
    private func selection(of id: String) -> String {
        let el = element(id)
        for candidate in [el.title, el.label, el.value as? String ?? ""] {
            if !candidate.isEmpty, candidate != el.identifier {
                return candidate
            }
        }
        return el.title
    }
    /// The paper picker seeds from Stage 1's `pageSize` (A4 default)
    /// and the quality picker from the driver's `*` default choice.
    func testPickersSeedFromStage1AndDriverDefault() throws {
        launchAppWithDefaults()
        reachPrintPanel()
        _ = waitFor("printerStatusBadge")
        _ = waitFor("printerPaperSizeSelect")
        _ = waitFor("printerQualitySelect")
        XCTAssertEqual(selection(of: "printerPaperSizeSelect"), "A4")
        XCTAssertEqual(selection(of: "printerQualitySelect"), "303")
    }
    /// #180 — the quality picker lists all seven Epson `EPIJ_Qual`
    /// codes in the driver's own order (308 between 303 and 304); no
    /// PPD is injected under UI testing so items show raw tokens.
    func testQualityPickerListsAllSevenDriverOptions() throws {
        launchAppWithDefaults()
        reachPrintPanel()
        _ = waitFor("printerStatusBadge")
        let picker = app.popUpButtons["printerQualitySelect"]
        XCTAssertTrue(picker.waitForExistence(timeout: 10))
        picker.click()
        let expected = ["301", "302", "303", "308", "304", "305", "307"]
        for token in expected {
            XCTAssertTrue(
                app.menuItems[token].waitForExistence(timeout: 5),
                "Missing quality menu item \(token)")
        }
        let titles = app.menuItems.allElementsBoundByIndex
            .map(\.title)
            .filter { expected.contains($0) }
        XCTAssertEqual(titles, expected)
        app.typeKey(XCUIKeyboardKey.escape, modifierFlags: [])
    }
    /// The stubbed panel result's captured `PageSize=`/`EPIJ_Qual=`
    /// apply back into the Stage 2 pickers and reach the `lp` argv
    /// (R15 — the real modal is never driven).
    func testPanelResultAppliesBackToPickers() throws {
        app.launchEnvironment["ICCERY_TEST_PRINT_PANEL"] = "ok"
        app.launchEnvironment["ICCERY_TEST_PANEL_OPTIONS"] =
            "PageSize=Letter EPIJ_Qual=305"
        launchAppWithDefaults()
        reachPrintPanel()
        _ = waitFor("printerStatusBadge")
        element("btnPrinterProperties").click()
        let notice = element("printNotificationText")
        XCTAssertTrue(notice.waitForExistence(timeout: 10))
        XCTAssertTrue((notice.value as? String ?? "")
            .contains("Settings captured"))
        XCTAssertEqual(selection(of: "printerPaperSizeSelect"), "Letter")
        XCTAssertEqual(selection(of: "printerQualitySelect"), "305")
        app.buttons["btnPrintAll"].click()
        let argv = waitForLpLine()
        XCTAssertTrue(argv.contains("PageSize=Letter"), argv)
        XCTAssertTrue(argv.contains("EPIJ_Qual=305"), argv)
    }
    /// #186 — the stubbed panel result's `orientation-requested=` /
    /// `MediaType=` apply back to the Stage 2 selections and reach the
    /// `lp` argv through the captured `cupsOptions` replay.
    func testPanelResultAppliesBackOrientationAndMedia() throws {
        app.launchEnvironment["ICCERY_TEST_PRINT_PANEL"] = "ok"
        app.launchEnvironment["ICCERY_TEST_PANEL_OPTIONS"] =
            "PageSize=Letter EPIJ_Qual=305 orientation-requested=4 MediaType=PhotographicGlossy"
        launchAppWithDefaults()
        reachPrintPanel()
        _ = waitFor("printerStatusBadge")
        element("btnPrinterProperties").click()
        let notice = element("printNotificationText")
        XCTAssertTrue(notice.waitForExistence(timeout: 10))
        XCTAssertTrue((notice.value as? String ?? "")
            .contains("Settings captured"))
        // `printerMediaTypeSelect` is the group's id — the popup is a
        // descendant (stacked identifiers collapse to the container).
        // The popup's AX title lags the binding — poll for the
        // apply-back value.
        let mediaPopup = element("printerMediaTypeSelect")
            .descendants(matching: .popUpButton).firstMatch
        XCTAssertTrue(mediaPopup.waitForExistence(timeout: 5))
        var mediaSelection = ""
        let deadline = Date().addingTimeInterval(10)
        while Date() < deadline, mediaSelection != "PhotographicGlossy" {
            mediaSelection = [
                mediaPopup.title, mediaPopup.label,
                mediaPopup.value as? String ?? "",
            ].first { !$0.isEmpty } ?? ""
            RunLoop.current.run(until: Date().addingTimeInterval(0.2))
        }
        XCTAssertEqual(mediaSelection, "PhotographicGlossy")
        XCTAssertEqual(selection(of: "printerPaperSizeSelect"), "Letter")
        app.buttons["btnPrintAll"].click()
        let argv = waitForLpLine()
        XCTAssertTrue(argv.contains("orientation-requested=4"), argv)
        XCTAssertTrue(argv.contains("MediaType=PhotographicGlossy"), argv)
        XCTAssertTrue(argv.contains("PageSize=Letter"), argv)
        XCTAssertTrue(argv.contains("EPIJ_Qual=305"), argv)
    }
    private func launchAppWithDefaults() {
        app.launch()
        app.activate()
    }
 }
@@ -36,7 +36,6 @@ final class Milestone2UITests: XCTestCase {
            "ICCERY_UI_TESTING": "1",
            "ICCERY_TEST_ROOT": testRoot.path,
            "ICCERY_ARGYLL_BINARY_DIR": binDir.path,
            "ICCERY_CUPS_BIN_DIR": binDir.path,
            "ICCERY_TEST_SAVE_TARGET":
                workDir.appendingPathComponent("mytarget.ti1").path,
            "ICCERY_TEST_WORKDIR": workDir.path,
@@ -219,12 +218,11 @@ final class Milestone2UITests: XCTestCase {
        XCTAssertTrue(FileManager.default.fileExists(
            atPath: workDir.appendingPathComponent("mytarget.ti2").path))
-        // Print panel is live from M3. GitHub macos-14 has no system
+        // Print panel is live from M3; a default printer is selected
-        // queues, so mock CUPS (`ICCERY_CUPS_BIN_DIR`) must enumerate
+        // so both the all-pages and per-page print buttons are enabled.
        // before Print All / per-page enable (run 34867767434).
        XCTAssertTrue(element("rawPrintPanel").exists)
-        _ = waitUntilEnabled("btnPrintAll", timeout: 15)
+        XCTAssertTrue(app.buttons["btnPrintAll"].isEnabled)
-        _ = waitUntilEnabled("btnPrintPage-0", timeout: 15)
+        XCTAssertTrue(app.buttons["btnPrintPage-0"].isEnabled)
        XCTAssertTrue(app.buttons["btnAdvanceToStage3"].isEnabled)
    }
@@ -98,9 +98,23 @@ final class Milestone4UITests: XCTestCase {
        app.buttons["btnDetectInstruments"].click()
        _ = waitFor("chartreadInstrumentSelect", timeout: 20)
-        // Wait until Start is enabled before clicking. Existence-only
+        // Keep Auto (port 1) and start the session.
-        // clicks are no-ops on the disabled control (runs 35251, 35293).
+        XCTAssertTrue(app.buttons["btnStartRead"].waitForExistence(timeout: 5))
-        driveOnePass(startButton: "btnStartRead")
+        app.buttons["btnStartRead"].click()
        // Calibrate.
        let calibrate = element("btnCalibrate")
        if !calibrate.waitForExistence(timeout: 25) {
            let error = element("chartreadLastError").label
            let value = element("chartreadLastError").value as? String ?? "<nil>"
            XCTFail("No calibrate button. lastError.label='\(error)' value='\(value)'")
        }
        app.buttons["btnCalibrate"].click()
        // Trigger each strip until all are read → Done & Save appears.
        driveStripsUntilDone()
        XCTAssertTrue(element("btnDoneRead").exists)
        app.buttons["btnDoneRead"].firstMatch.click()
        // Averaging panel appears with one pass snapshot.
        _ = waitFor("chartreadAveragingPanel", timeout: 20)
@@ -154,34 +168,15 @@ final class Milestone4UITests: XCTestCase {
    /// Runs the mock handheld chartread session to completion
    /// (start → calibrate → strip A → strip B → Done & Save).
    ///
    /// `isEnabled` can be true in AX while the SwiftUI action is still
    /// a no-op (runs 35251, 35443). Re-click until the session is
    /// actually running (`btnCancel` is shown whenever
    /// `isChartreadRunning`), then wait for Calibrate.
    private func driveOnePass(startButton: String) {
        let start = app.buttons[startButton]
-        XCTAssertTrue(start.waitForExistence(timeout: 10), startButton)
+        XCTAssertTrue(start.waitForExistence(timeout: 10))
-        let enabledBy = Date().addingTimeInterval(10)
+        let deadline = Date().addingTimeInterval(10)
-        while Date() < enabledBy, !start.isEnabled {
+        while Date() < deadline, !start.isEnabled {
            RunLoop.current.run(until: Date().addingTimeInterval(0.1))
        }
-        XCTAssertTrue(start.isEnabled, "\(startButton) never enabled")
+        XCTAssertTrue(start.isEnabled)
        let sessionBy = Date().addingTimeInterval(25)
        while Date() < sessionBy, !chartreadSessionRunning {
            if start.exists, start.isEnabled {
        start.click()
            }
            RunLoop.current.run(until: Date().addingTimeInterval(0.4))
        }
        XCTAssertTrue(
            chartreadSessionRunning,
            "\(startButton) click never started chartread; "
                + "notice=\(element("noticeText").value as? String ?? "") "
                + "start.exists=\(start.exists)"
        )
        _ = waitFor("btnCalibrate", timeout: 25)
        app.buttons["btnCalibrate"].click()
        driveStripsUntilDone()
@@ -189,14 +184,6 @@ final class Milestone4UITests: XCTestCase {
        app.buttons["btnDoneRead"].firstMatch.click()
    }
    /// `btnCancel` is in the tree for the whole chartread session;
    /// Calibrate/Trigger only appear after the first classified prompt.
    private var chartreadSessionRunning: Bool {
        element("btnCancel").exists
            || element("btnCalibrate").exists
            || element("btnTrigger").exists
    }
    /// Clicks Trigger for each remaining strip until `btnDoneRead`
    /// appears — the button is re-polled each pass so a click that
    /// races a state transition isn't lost.
@@ -43,8 +43,6 @@ Do not install Argyll to `$PATH`. ICCery never searches `$PATH` for binaries.
 | `NOTARIZE_APPLE_ID` | Apple ID for `notarytool` |
 | `NOTARIZE_PASSWORD` | App-specific password for `notarytool` |
 | `APPLE_TEAM_ID` | Team ID for `notarytool` |
 | `RELEASE_TAG` | Optional. Simulates a tag build (`vX.Y.Z[-suffix]`); stamped into the bundle and DMG name |
 | `BUILD_NUMBER` | Optional `CFBundleVersion` override; default `git rev-list --count HEAD` |
 Invocation for a signed, notarized DMG:
@@ -58,8 +56,7 @@ export APPLE_TEAM_ID="TEAMID"
 scripts/package-release.sh
 ```
-The script will emit `ICCery-<version>-<build>.dmg` (or `ICCery-<tag>-<build>.dmg`
+The script will emit `ICCery-<version>-<build>.dmg`. After mounting, verify Gatekeeper acceptance:
 when `RELEASE_TAG`/a `v*` git tag applies). After mounting, verify Gatekeeper acceptance:
 ```
 spctl -a -t open --context context:primary-signature -v ICCery-*.dmg
@@ -0,0 +1,89 @@
@startuml ICCery-UI-sheets
 title Sheets  Settings, presets, media, Spot Read, Gamut, project
 !theme plain
 skinparam backgroundColor white
 skinparam defaultFontColor black
 skinparam defaultFontSize 13
 skinparam mapBackgroundColor white
 skinparam mapBorderColor #222222
 skinparam mapFontColor black
 skinparam arrowColor #222222
 skinparam shadowing false
 hide circle
 top to bottom direction
 map "SettingsView.swift" as set {
  Argyll dir => TextField+Browse : empty = bundled
  Default instrument => Picker : seeds Stage 3 and Spot Read
  Enable i1Pro 2 LEDs => Toggle
  settingsDeltaEGood => TextField
  settingsDeltaEWarning => TextField : must be greater than Good
  settingsCalStaleDays => TextField
  Install location => Picker User or System
  Ask before overwriting => Toggle
  Open ColorSync after install => Toggle
  Log level => Picker
  Open log folder => Button
  Cancel / Save => Save stays if validation fails
 }
 map "Presets  PresetDialogs.swift" as pre {
  savePresetName => TextField
  savePresetDesc => TextField
  btnCloseSavePresetDialog => Button
  btnConfirmSavePreset => Button : disabled if name empty
  presetRow-id => Row : built-in cannot delete
  btnImportPreset => Button
  btnExportActivePreset => Button : custom selected
  btnCloseManagePresetsDialog => Button
 }
 map "Media  MediaLibraryDialogs.swift" as media {
  saveMediaName/Paper/Ink => TextField
  saveMediaApplyCal => Toggle : disabled if CAL_ or missing file
  btnConfirmSaveMedia => Button : name+paper+ink required
  mediaLibraryList => List
  btnMediaLibraryApply-id => Button per row
  manageMediaNotice => Caption : failed Apply in-sheet
  btnMediaLibraryApply => Button : disabled if no selection
  btnCloseManageMediaDialog => Button
 }
 map "spotReadView  SpotReadView.swift" as spot {
  btnSpotDetectInstruments => Button
  spotInstrumentSelect => Picker : disabled while running
  spotSetDefault => Toggle
  btnSpotStart => Button : needs sidecar, cwd, not chartread
  btnSpotCalibrate => Button : calibrating
  btnSpotTrigger => Button : Read, awaitingStrip
  btnSpotStop => Button : while running
  btnSpotCopyLab => Button : disabled if no sample
  btnSpotExportCsv => Button : disabled if no history
  btnCloseSpotRead => Button Esc : dismiss = Stop
 }
 map "gamutView  GamutView.swift" as gam {
  gamutLayer-srgb => Toggle : can hide, cannot remove
  gamutLayer-profile => Toggle : disabled if no .gam
  gamutLayer-compare => Toggle : disabled if no compare
  btnGamutAddCompare => Menu
  btnGamutRemoveCompare => Button
  btnGamutSampleTiff => Button
  btnResetGamutCamera => Button R
  gamutLabEntryL/A/B => TextField
  btnGamutInspectLab => Button
  btnCloseGamut => Button Esc
 }
 map "Project alerts" as proj {
  projectNewAlert => Alert : New Cancel / Confirm
  Dirty save => Alert : Save / Don't Save / Cancel
  projectRelocateSheet => Sheet : cwd missing on Open
 }
 set -[hidden]down- pre
 pre -[hidden]down- media
 media -[hidden]down- spot
 spot -[hidden]down- gam
 gam -[hidden]down- proj
@enduml
@@ -0,0 +1,81 @@
@startuml ICCery-UI-shell
 title Shell, sidebar, stepper, File menu
 !theme plain
 skinparam backgroundColor white
 skinparam defaultFontColor black
 skinparam defaultFontSize 13
 skinparam mapBackgroundColor white
 skinparam mapBorderColor #222222
 skinparam mapFontColor black
 skinparam arrowColor #222222
 skinparam shadowing false
 hide circle
 top to bottom direction
 map "Window" as win {
  WindowGroup => ICCeryApp.swift : 1280x800 min 1100x700
  RootView => RootView.swift : hosts every sheet
  noticeText => NoticeBanner : shown if wizard.notice set; auto-hide 6s
 }
 map "Sidebar header" as hdr {
  openSettingsBtn => Button : always / Settings sheet
  openAboutBtn => Button : always / About
  btnToggleAllHelp => Button : toggles yellow help dots
 }
 map "Presets" as pre {
  presetSelect => Picker.menu : none + preset id; none is not factory reset
  btnSavePresetModal => Button : always
  btnOpenPresetsDialog => Button : always
 }
 map "Media library" as med {
  mediaSelect => Picker.menu : never reuses presetSelect
  mediaRecipeStale => Caption : shown if staleReasons nonempty
  btnMediaLibraryCapture => Button : disabled if no Stage 2 printer
  btnMediaLibraryManage => Button : always
 }
 map "Studio (not stepper)" as stu {
  btnCalibratePrinter => Button : always; Stage 0
  btnViewGamut => Button : sidebar always on; same id as Stage 5
  btnSpotRead => Button : disabled if no cwd or chartread running
 }
 map "Stepper 1-5  disk is truth" as stp {
  Stage1 Generate => always
  Stage2 Lay out => .ti1
  Stage3 Measure => .ti1 AND .ti2
  Stage4 Build => .ti3 (not .ti2 alone)
  Stage5 Verify => .ti3 AND .icc/.icm
  Calibrate => not a stepper row; always available
 }
 map "Project chip" as chip {
  projectChipName => Text : bound name or No project
  projectChipPath => Text : shown if bound
  projectChipStale => Caption : diskBehindNotes
  btnProjectReveal => Button : shown if bound
  btnProjectSave => Button : canSave = bound + basename + cwd
  btnProjectOpen => Button : shown if not bound
 }
 map "File menu" as menu {
  menuProjectNew => Button Cmd-N
  menuProjectOpen => Button Cmd-O
  menuProjectRecents => Menu : disabled if recents empty
  menuProjectSave => Button Cmd-S : !canSave
  menuProjectSaveAs => Button Shift-Cmd-S : basename + cwd
  menuProjectReport => Button : !canReport
  menuProjectClose => Button : !isBound
 }
 win -[hidden]down- hdr
 hdr -[hidden]down- pre
 pre -[hidden]down- med
 med -[hidden]down- stu
 stu -[hidden]down- stp
 stp -[hidden]down- chip
 chip -[hidden]down- menu
@enduml
@@ -0,0 +1,83 @@
@startuml ICCery-UI-stage1-2
 title Stages 1-2  Generate Target / Lay Out and Print
 !theme plain
 skinparam backgroundColor white
 skinparam defaultFontColor black
 skinparam defaultFontSize 13
 skinparam mapBackgroundColor white
 skinparam mapBorderColor #222222
 skinparam mapFontColor black
 skinparam arrowColor #222222
 skinparam shadowing false
 hide circle
 top to bottom direction
 map "stage-1  Stage1View.swift" as s1 {
  colourSpace => Picker.segmented : RGB or CMYK
  patchCountPreset => Picker
  patchCountCustom => TextField : shown if preset is custom
  whitePatches => Stepper 0-50
  blackPatches => Stepper 0-50
  targetBasename => TextField
  btnBrowse => Button
  btnSelectWorkDir => Button
  btnOpenExisting => Button : .ti1 or .ti2
  btn-import-dataset => Button : unlocks stage 4
  selectedPathDisplay => Text
  targenAdvancedDetails => DisclosureGroup : UI tests pre-expand
  btnGenerate => Button : needs basename AND directory
  targenLog => ProcessLogView
 }
 map "Stage 1 Advanced (inside disclosure)" as adv {
  targenGreySteps => Toggle+field : field iff on
  targenSingleChannelSteps => Toggle+field
  targenNeutralSteps => Toggle+field
  targenNeutralConcentration => Toggle+Slider 0-1
  targenAdaptation => Toggle+Slider 0-1
  targenPrecondProfile => TextField
  btnBrowsePrecondProfile => Button
  targenHighQuality => Toggle
  targenAlgorithm => Picker
  targenInkLimitGroup => Toggle+field : CMYK only
  targenDarkEmphasis => Toggle+Slider 0-3
  targenDevicePower => Toggle+Slider 0-3
 }
 map "stage-2  Stage2View.swift" as s2 {
  cmWarningBanner => Banner : always on stage 2
  instrumentSelect => Picker : chart code, not USB port
  pageSizeSelect => Picker
  customPageW / customPageH => TextField : pageSize custom
  tiffDpi => Stepper 72-600
  printtargLayoutOrder => Picker
  printtargCustomSeed => TextField : custom seed order
  btnToggleLabelEdit => Button
  targetMetadataPrinter => TextField
  targetMetadataInkSet => TextField
  targetMetadataDriverPaper => TextField
  targetMetadataActualPaper => TextField
  targetLabelPreview => TextField or Text
  btnCreateLayout => Button : disabled if no basename
  tiffGallery => Grid : after printtarg
  btnPrintPage-N => Button : disabled if no printer
 }
 map "rawPrintPanel" as prn {
  printerSelect => Picker CUPS
  printerStatusBadge => Caption
  btnRefreshPrinters => Button
  btnPrinterProperties => Button : disabled if no printer
  printerTraySelect => Picker : if trays exist
  printerMediaTypeSelect => Picker : if media types exist
  btnOrientPortrait => Button
  btnOrientLandscape => Button
  btnPrintAll => Button : needs layout AND printer
  btnAdvanceToStage3 => Button : needs .ti2 unlock
  printNotificationText => Caption : if printNotice set
 }
 s1 -[hidden]down- adv
 adv -[hidden]down- s2
 s2 -[hidden]down- prn
@enduml
@@ -0,0 +1,84 @@
@startuml ICCery-UI-stage3-5-cal
 title Stages 3-5 and Calibrate Printer
 !theme plain
 skinparam backgroundColor white
 skinparam defaultFontColor black
 skinparam defaultFontSize 13
 skinparam mapBackgroundColor white
 skinparam mapBorderColor #222222
 skinparam mapFontColor black
 skinparam arrowColor #222222
 skinparam shadowing false
 hide circle
 top to bottom direction
 map "stage-3  Stage3View.swift" as s3 {
  btnDetectInstruments => Button : disabled while detecting
  chartreadInstrumentSelect => Picker.menu
  xyTableHint => Caption : if XY instrument
  xyTablePanel => Place/Align/Scan/Remove
  chartreadPrompt => Text
  chartreadLastError => Caption : if notice set
  btnStartRead => Button : shown if not running; needs basename+cwd
  btnCalibrate => Button : running and calibrating
  btnTrigger => Button : running and awaitingStrip
  btnDoneReadEarly => Button : awaitingStrip
  btnAccept => Button : place / align / continue / warning
  btnRetry => Button : error state
  btnDoneRead => Button : allStripsRead
  btnCancel => Button : while running
  swatchGrid => swatch-rowId-loc
  btnMeasureAnotherSheet => Button : after a finished pass
  btnFinishAndAverage => Button : finished AND at least one pass
 }
 map "stage-4  Stage4View.swift" as s4 {
  colprofAlgorithm => Picker
  colprofQuality => Picker
  colprofFwa => Picker
  colprofFwaCustomPath => TextField : custom spectrum
  btnBrowseFwaSp => Button
  colprofIlluminant => TextField
  colprofObserver => TextField
  colprofInputViewCond => TextField
  colprofOutputViewCond => TextField
  colprofDescription => TextField
  colprofCopyright => TextField
  colprofApplyCalibration => Toggle
  colprofCalibrationFile => TextField : if applyCalibration
  btnBrowseCalibrationFile => Button : if applyCalibration
  btnCreateProfile => Button : basename + cwd, not running
 }
 map "stage-5  Stage5View.swift" as s5 {
  btnVerifyProfile => Button : needs created profile
  btnViewGamut => Button : disabled if no .gam (same id as sidebar)
  btnInstallProfile => Button : needs created profile
  driftPrinterFilter => Picker
  btnExportHistory => Button
  btnClearHistory => Button
  verificationHistoryTable => Table
  driftChart => not interactive
  profileOverwriteBtn => Alert : install collision
  profileRenameBtn => Alert
  profileCancelCollisionBtn => Alert
 }
 map "stage-cal  CalibrationView.swift" as cal {
  Colour space => Picker.segmented : no a11y id
  calSteps => TextField
  White patches => TextField : no a11y id
  calInkExplore => TextField : CMYK only
  calNeutralEmphasis => Toggle
  btnCalGenerate => Button : needs basename + cwd
  btnCalLayout => Button : same
  btnCalMeasure => Button : needs .ti3
  btnCalCompute => Button : .ti3 and not computing
  calApplyToggle => Toggle : after curves exist
  btnCalReturn => Button Esc : restores original basename
 }
 s3 -[hidden]down- s4
 s4 -[hidden]down- s5
 s5 -[hidden]down- cal
@enduml
@@ -0,0 +1,12 @@
 # Interactive UI map
 PlantUML **maps** (not class diagrams). Class diagrams laid out 6500px wide, so Gitea on a phone showed a sliver of a black arrow and the UML “C” icon.
 Each file is one stacked column (~560–780px) that Kroki actually fits in the page.
 | Diagram | File | Kroki size |
 | --- | --- | --- |
 | Shell, sidebar, stepper, File menu | [ui-interactive-map-shell.puml](ui-interactive-map-shell.puml) | 563 × 1367 |
 | Stages 1–2 | [ui-interactive-map-stage1-2.puml](ui-interactive-map-stage1-2.puml) | 625 × 1366 |
 | Stages 3–5 + Calibrate | [ui-interactive-map-stage3-5-cal.puml](ui-interactive-map-stage3-5-cal.puml) | 568 × 1386 |
 | Sheets | [ui-interactive-map-sheets.puml](ui-interactive-map-sheets.puml) | 782 × 1502 |
@@ -42,15 +42,6 @@ targets:
            echo "note: Vendor/Argyll absent — run scripts/fetch-argyll.sh"
          fi
        basedOnDependencyAnalysis: false
      - name: Stamp release tag
        # GENERATE_INFOPLIST_FILE writes Info.plist after script phases and
        # only honours Apple's INFOPLIST_KEY_* allowlist — so the tag ships as
        # a bundled resource read by ArtefactFiles.appInfo (#189).
        script: |
          DEST="$TARGET_BUILD_DIR/$UNLOCALIZED_RESOURCES_FOLDER_PATH"
          mkdir -p "$DEST"
          printf '%s' "${ICCERY_RELEASE_TAG:-}" > "$DEST/ICCeryReleaseTag"
        basedOnDependencyAnalysis: false
    settings:
      base:
        PRODUCT_BUNDLE_IDENTIFIER: com.gronod.iccery2
@@ -63,13 +54,6 @@ targets:
        INFOPLIST_KEY_NSHumanReadableCopyright: "Copyright © 2026 Gronod. AGPLv3."
        MARKETING_VERSION: "2.0.0"
        CURRENT_PROJECT_VERSION: "1"
        # Stamped by scripts/version.sh at packaging/CI time (release tag or
        # `git describe` string); About shows it next to the marketing version.
        # Written to the bundled ICCeryReleaseTag resource by the
        # "Stamp release tag" phase — GENERATE_INFOPLIST_FILE drops custom
        # INFOPLIST_KEY_* names and generates the plist after script phases.
        # Tag builds hard-fail when the tag's X.Y.Z != MARKETING_VERSION above.
        ICCERY_RELEASE_TAG: ""
        ENABLE_HARDENED_RUNTIME: YES
        CODE_SIGN_ENTITLEMENTS: Resources/ICCery.entitlements
        CODE_SIGN_IDENTITY: "-"
@@ -106,19 +106,9 @@ fi
 mkdir -p "$DEST"
 cp -R "$BIN_DIR"/. "$DEST"/
 # Copy License.txt from archive root (same level as bin/) to Vendor/Argyll/ root
 VENDOR_ROOT="$ROOT/Vendor/Argyll"
 for license_src in "$EXTRACT"/Argyll_V*/License.txt "$EXTRACT"/License.txt; do
    if [ -f "$license_src" ]; then
        cp "$license_src" "$VENDOR_ROOT/License.txt"
        break
    fi
 done
 find "$DEST" -type f -exec chmod 0755 {} +
 # Downloads carry com.apple.quarantine; the app cannot spawn quarantined tools.
 xattr -dr com.apple.quarantine "$DEST" 2>/dev/null || true
 # Also remove quarantine from Vendor/Argyll root if License.txt was copied
 xattr -dr com.apple.quarantine "$VENDOR_ROOT" 2>/dev/null || true
 # Ad-hoc sign every Mach-O (#165: unsigned arm64 → "Killed: 9"), then
 # verify — an unsigned sidecar fails the script. The tree may nest
@@ -45,13 +45,6 @@ DEST="platform=macOS"
 IDENTITY="${CODESIGN_IDENTITY:--}"
 DEVELOPMENT_TEAM="${DEVELOPMENT_TEAM:-}"
 # Resolve the version triple from the release tag / git state. On tag builds
 # (RELEASE_TAG=v*) this hard-fails if the tag's X.Y.Z != project.yml
 # MARKETING_VERSION, so a mis-tag cannot ship mismatched metadata (#189).
 echo "==> Resolving version"
 eval "$(scripts/version.sh)"
 echo "version=$MARKETING_VERSION build=$CURRENT_PROJECT_VERSION tag=$ICCERY_RELEASE_TAG"
 echo "==> Building universal Release app"
 BUILD_EXTRA=""
 if [ -n "$DEVELOPMENT_TEAM" ]; then
@@ -67,9 +60,6 @@ xcodebuild \
    ONLY_ACTIVE_ARCH=NO \
    CODE_SIGNING_ALLOWED=YES \
    CODE_SIGN_IDENTITY="$IDENTITY" \
    MARKETING_VERSION="$MARKETING_VERSION" \
    CURRENT_PROJECT_VERSION="$CURRENT_PROJECT_VERSION" \
    ICCERY_RELEASE_TAG="$ICCERY_RELEASE_TAG" \
    $BUILD_EXTRA \
    build
@@ -152,14 +142,7 @@ fi
 echo "==> Building DMG"
 VERSION="$(plutil -extract CFBundleShortVersionString raw "$APP/Contents/Info.plist" 2>/dev/null || printf '2.0.0')"
 BUILD_NUM="$(plutil -extract CFBundleVersion raw "$APP/Contents/Info.plist" 2>/dev/null || printf '1')"
-# Tagged/described builds carry the tag in the DMG name so prerelease
+DMG="ICCery-${VERSION}-${BUILD_NUM}.dmg"
 # artefacts are self-describing (ICCery-2.0.0-pre2-grok-236.dmg); a plain
 # release tag keeps the classic ICCery-<ver>-<build>.dmg form.
 TAG_NAME="${ICCERY_RELEASE_TAG#v}"
 case "$TAG_NAME" in
    ''|"$VERSION"|dev) DMG="ICCery-${VERSION}-${BUILD_NUM}.dmg" ;;
    *)                 DMG="ICCery-${TAG_NAME}-${BUILD_NUM}.dmg" ;;
 esac
 VOLUME_NAME="ICCery ${VERSION}"
 DMG_APP="$APP" \
@@ -1,88 +0,0 @@
 #!/bin/sh
 # scripts/version.sh
 #
 # Resolve the ICCery version triple and print KEY=value lines for eval:
 #
 #   ICCERY_RELEASE_TAG      release tag / describe string stamped into the
 #                           bundle's ICCeryReleaseTag Info.plist key and shown
 #                           in the About dialog.
 #   MARKETING_VERSION       CFBundleShortVersionString — strict X.Y.Z only
 #                           (Apple forbids suffixes; tag payload never lands here).
 #   CURRENT_PROJECT_VERSION CFBundleVersion — monotonically increasing integer.
 #                           macOS/App-Store convention: never reset per version.
 #
 # Resolution:
 #   RELEASE_TAG env matching 'v[0-9]*' wins (CI tag builds; branch pushes pass
 #   the branch name and are ignored). Otherwise `git describe` on the worktree.
 #   Marketing version = first three numeric components of the tag core; a tag
 #   with no numeric core falls back to project.yml's MARKETING_VERSION.
 #   Build number = BUILD_NUMBER env override, else `git rev-list --count HEAD`.
 #
 # Hard fails (release-tag builds only): tag core not 1-3 numeric components,
 # or parsed X.Y.Z != project.yml MARKETING_VERSION — bump project.yml or fix
 # the tag before packaging.
 #
 # Usage: eval "$(scripts/version.sh)"
 set -eu
 ROOT="$(CDPATH='' cd -- "$(dirname -- "$0")/.." && pwd)"
 cd "$ROOT"
 YML_MARKETING="$(sed -n 's/^ *MARKETING_VERSION: *"\(.*\)"/\1/p' project.yml | head -n 1)"
 TAG="${RELEASE_TAG:-}"
 case "$TAG" in
    v[0-9]*) ;;           # real release tag
    *) TAG="" ;;          # branch name (develop, feat/...) or empty
 esac
 IS_RELEASE_TAG=0
 [ -n "$TAG" ] && IS_RELEASE_TAG=1
 if [ -z "$TAG" ]; then
    TAG="$(git describe --tags --always --dirty --match 'v[0-9]*' 2>/dev/null || true)"
 fi
 [ -n "$TAG" ] || TAG="dev"
 # Marketing version: strip leading v, cut at first '-', keep first 3 dot
 # components. "v2.0.0-pre2" -> "2.0.0"; "v2.0.0.0-x" -> "2.0.0";
 # "v2.0.0-5-gsha" -> "2.0.0"; bare sha/"dev" -> no numeric core -> fallback.
 CORE="${TAG#v}"
 CORE="${CORE%%-*}"
 MV=""
 case "$CORE" in
    *[!0-9.]*|'') ;;               # non-numeric core — not a version tag
    *)
        MV="$(printf '%s' "$CORE" | cut -d. -f1-3)"
        # Every kept component must be non-empty digits.
        case "$MV" in
            *[!0-9.]*|''|*..*|.*|*.) MV="" ;;
        esac
        ;;
 esac
 if [ "$IS_RELEASE_TAG" -eq 1 ]; then
    if [ -z "$MV" ]; then
        echo "error: release tag '$TAG' has no X.Y.Z numeric core" >&2
        exit 1
    fi
    if [ -n "$YML_MARKETING" ] && [ "$MV" != "$YML_MARKETING" ]; then
        echo "error: tag '$TAG' resolves to $MV but project.yml MARKETING_VERSION=$YML_MARKETING; bump project.yml or fix the tag" >&2
        exit 1
    fi
 fi
 [ -n "$MV" ] || MV="$YML_MARKETING"
 [ -n "$MV" ] || MV="0.0.0"
 BUILD="${BUILD_NUMBER:-}"
 if [ -z "$BUILD" ]; then
    BUILD="$(git rev-list --count HEAD 2>/dev/null || true)"
 fi
 case "$BUILD" in
    ''|*[!0-9]*) BUILD="1" ;;
 esac
 [ "$BUILD" -gt 0 ] 2>/dev/null || BUILD="1"
 printf 'ICCERY_RELEASE_TAG=%s\n' "$TAG"
 printf 'MARKETING_VERSION=%s\n' "$MV"
 printf 'CURRENT_PROJECT_VERSION=%s\n' "$BUILD"
Author	SHA1	Message	Date
gronod	1d056c26bf	docs: use PlantUML maps so Kroki fits a phone width macOS CI / build-and-test (push) Skipped macOS CI / build-and-test (pull_request) Canceled after 0s Details macOS CI / package (pull_request) Canceled after 0s Details Class diagrams rendered 6556px wide; Gitea clipped that to a black arrowhead and the UML C icon. Stacked maps are 560-780px and render as labelled tables on public Kroki.	2026-09-14 15:04:22 +00:00
gronod	c4f037535a	docs: restore PlantUML UI maps; draw groups as rectangles macOS CI / build-and-test (push) Skipped macOS CI / build-and-test (pull_request) Canceled after 0s Details macOS CI / package (pull_request) Canceled after 0s Details Revert the maps to `368ae56` and fix the Kroki render: default package style is a folder, which Gitea scaled to a black tab. Groups are rectangles on a white canvas; shape stereotypes (<<Button>>, <<*.swift>>) are folded into the title so C4/sprites cannot retarget the box.	2026-09-14 14:56:52 +00:00
gronod	191bcb0280	docs: replace hairball graphs with small overviews and tables macOS CI / build-and-test (push) Skipped macOS CI / build-and-test (pull_request) Canceled after 0s Details macOS CI / package (pull_request) Canceled after 0s Details Gitea scaled the 50-node GraphViz maps to unreadably tiny black boxes. Overviews are now ~12 nodes on an opaque white canvas; enable/hide rules live in markdown tables that work in dark mode.	2026-09-14 14:44:59 +00:00
gronod	9c625ee21f	docs: dark-mode GraphViz palette for Gitea Kroki macOS CI / build-and-test (push) Skipped macOS CI / build-and-test (pull_request) Canceled after 0s Details macOS CI / package (pull_request) Canceled after 0s Details Unfilled nodes and default black type sat on a transparent SVG, so dark mode showed only tiny black boxes. Opaque GitHub-dark fills, light labels, larger type.	2026-09-14 14:40:28 +00:00
gronod	40cc4ad701	docs: drop PlantUML UI maps that Kroki 0.30.1 cannot run without AVX2 macOS CI / build-and-test (push) Skipped macOS CI / build-and-test (pull_request) Canceled after 0s Details macOS CI / package (pull_request) Canceled after 0s Details	2026-09-14 14:25:52 +00:00
gronod	658d9813bd	docs: render UI maps with GraphViz for Kroki 0.30.1 macOS CI / build-and-test (push) Skipped macOS CI / package (pull_request) Canceled after 0s Details macOS CI / build-and-test (pull_request) Canceled after 12m40s Details Kroki 0.30.1 PlantUML is a GraalVM native image and requires AVX2. This host has none, so the maps now use GraphViz (dot) — one diagram per file, plus a markdown page with graphviz fences.	2026-09-14 14:25:35 +00:00
gronod	368ae56cf3	docs: split UI PlantUML map into one diagram per file macOS CI / build-and-test (push) Skipped macOS CI / build-and-test (pull_request) Failing after 40m37s Details macOS CI / package (pull_request) Skipped Details Kroki only renders the first @startuml block in a file.	2026-09-14 14:18:07 +00:00
gronod	bd539df009	docs: PlantUML map of every interactive control macOS CI / build-and-test (push) Skipped macOS CI / build-and-test (pull_request) Failing after 3m58s Details macOS CI / package (pull_request) Skipped Details Identifiers, source files, and enable/hide/disable rules for the wizard, sidebar, sheets, and File menu.	2026-09-14 14:03:26 +00:00