From bd539df00968ab1163350d4f60061032682a402e Mon Sep 17 00:00:00 2001
From: gronod <gronod@users.noreply.git.i3omb.com>
Date: Mon, 14 Sep 2026 14:03:26 +0000
Subject: [PATCH 1/8] docs: PlantUML map of every interactive control

Identifiers, source files, and enable/hide/disable rules for the
wizard, sidebar, sheets, and File menu.
---
 docs/ui-interactive-map.puml | 762 +++++++++++++++++++++++++++++++++++
 1 file changed, 762 insertions(+)
 create mode 100644 docs/ui-interactive-map.puml

diff --git a/docs/ui-interactive-map.puml b/docs/ui-interactive-map.puml
new file mode 100644
index 0000000..ad492e7
--- /dev/null
+++ b/docs/ui-interactive-map.puml
@@ -0,0 +1,762 @@
+@startuml ICCery-UI-shell
+title ICCery v2 — interactive UI map (develop)\nobject names, files, enable / hide rules
+caption Accessibility ids in quotes. Disk gating: WizardGating.swift. No App Sandbox.
+skinparam classAttributeIconSize 0
+skinparam wrapWidth 280
+hide circle
+hide empty methods
+
+together {
+  class "WindowGroup ICCery" as win <<ICCeryApp.swift>> {
+    1280x800, min 1100x700
+    File menu: ProjectCommands
+  }
+  class "RootView" as root <<RootView.swift>> {
+    sidebar 270pt + stage column
+    sheets / alerts hosted here
+  }
+}
+
+win --> root
+
+package "Persistent chrome" {
+  class "SidebarView" as side <<SidebarView.swift>>
+  class "NoticeBanner" as ban <<NoticeBanner.swift>> {
+    id noticeText
+    shown: wizard.notice != nil
+    auto-hide 6s unless nil
+    close: xmark (no a11y id)
+  }
+  class "WizardStageContent" as stage <<RootView.swift>> {
+    switch wizard.stage
+  }
+}
+
+root --> side
+root --> ban
+root --> stage
+
+package "Sidebar header" {
+  class "openSettingsBtn" as sSet <<Button>> {
+    gearshape
+    always enabled
+    presents SettingsView sheet
+  }
+  class "openAboutBtn" as sAbt <<Button>> {
+    info.circle
+    always enabled
+    presents AboutView
+  }
+  class "btnToggleAllHelp" as sHlp <<Button>> {
+    questionmark.circle
+    toggles showingAllHelp
+    HelpOverlayView: yellow dots when on
+  }
+}
+side --> sSet
+side --> sAbt
+side --> sHlp
+
+package "Presets (#11)" {
+  class "presetSelect" as pre <<Picker.menu>> {
+    tags: none + ProfilingPreset.id
+    set applies preset immediately
+    "No preset" does not factory-reset
+  }
+  class "btnSavePresetModal" as preS <<Button>> {
+    always enabled
+    showingSavePreset = true
+  }
+  class "btnOpenPresetsDialog" as preM <<Button>> {
+    always enabled
+    showingManagePresets = true
+  }
+}
+side --> pre
+side --> preS
+side --> preM
+
+package "Media library (#146)" {
+  class "mediaSelect" as med <<Picker.menu>> {
+    tags: none + MediaRecipe.id
+    never reuses presetSelect
+    failed apply snaps back to none
+  }
+  class "mediaRecipeStale" as medSt <<Caption>> {
+    shown: staleReasons[selected] nonempty
+    "Printer not installed" or "Calibration stale"
+  }
+  class "btnMediaLibraryCapture" as medC <<Button>> {
+    disabled: print.selectedPrinter.isEmpty
+    needs Stage 2 queue
+  }
+  class "btnMediaLibraryManage" as medM <<Button>> {
+    always enabled
+  }
+}
+side --> med
+side --> medSt
+side --> medC
+side --> medM
+
+package "Studio (not stepper)" {
+  class "btnCalibratePrinter" as calB <<Button>> {
+    always enabled
+    wizard.enterCalibration()
+    Stage 0, not numbered
+  }
+  class "btnViewGamut" as gamB <<Button>> {
+    Sidebar copy — same id as Stage 5
+    always enabled
+    no .gam => sRGB only
+  }
+  class "btnSpotRead" as spotB <<Button>> {
+    disabled: workingDirectory==nil
+             OR measurement.isChartreadRunning
+  }
+}
+side --> calB
+side --> gamB
+side --> spotB
+
+package "Stepper 1–5  (disk is truth)" {
+  class "StepperRow stage N" as step <<Button.plain>> {
+    WizardStage.stepperStages
+    disabled / opacity 0.45 unless isUnlocked
+    go(to:) allowed backward always
+    calibrate is NOT a stepper row
+  }
+  note as nGate
+    WizardGating.swift / WizardViewModel.isUnlocked
+    1 generate: always
+    2 layOutPrint: .ti1
+    3 measure: .ti1 AND .ti2
+    4 buildProfile: .ti3 (not .ti2 alone)
+    5 verifyInstall: .ti3 AND .icc/.icm
+    Re-probed on window key (#151)
+  end note
+}
+side --> step
+step .. nGate
+
+package "Project chip (#149)  ProjectUI.swift" {
+  class "projectChip" as chip <<Container>>
+  class "projectChipName" as cn <<Text>> {
+    bound name or "No project"
+  }
+  class "projectChipPath" as cp <<Text>> {
+    shown if bound; last path component
+  }
+  class "projectChipStale" as cs <<Caption>> {
+    shown: diskBehindNotes
+  }
+  class "btnProjectReveal" as cr <<Button>> {
+    shown if bound
+  }
+  class "btnProjectSave" as csv <<Button>> {
+    shown if bound
+    disabled: !canSave
+    canSave: isBound && basename && cwd
+    CAL_ basename still enabled (refusal banner)
+  }
+  class "btnProjectOpen" as co <<Button>> {
+    shown if NOT bound
+  }
+}
+side --> chip
+chip --> cn
+chip --> cp
+chip --> cs
+chip --> cr
+chip --> csv
+chip --> co
+
+package "File menu  ProjectCommands / ICCeryApp.swift" {
+  class "menuProjectNew" as mN <<Button>> {
+    ⌘N  requestNew()
+  }
+  class "menuProjectOpen" as mO <<Button>> {
+    ⌘O
+  }
+  class "menuProjectRecents" as mR <<Menu>> {
+    disabled: recents.isEmpty
+    items: projectRecent-{bookmarkHash}
+    menuProjectRecentsClear
+  }
+  class "menuProjectSave" as mS <<Button>> {
+    ⌘S  disabled: !canSave
+  }
+  class "menuProjectSaveAs" as mSa <<Button>> {
+    ⇧⌘S  disabled: !canSaveAs
+    canSaveAs: basename && cwd (no bind required)
+  }
+  class "menuProjectReport" as mRp <<Button>> {
+    disabled: !canReport
+  }
+  class "menuProjectClose" as mCl <<Button>> {
+    disabled: !isBound
+  }
+}
+
+stage --> "stage-1\nStage1View.swift" as st1
+stage --> "stage-2\nStage2View.swift" as st2
+stage --> "stage-3\nStage3View.swift" as st3
+stage --> "stage-4\nStage4View.swift" as st4
+stage --> "stage-5\nStage5View.swift" as st5
+stage --> "stage-cal\nCalibrationView.swift" as st0
+@enduml
+
+@startuml ICCery-UI-stage1-2
+title Stages 1–2 — Generate Target / Lay Out and Print
+skinparam classAttributeIconSize 0
+hide circle
+hide empty methods
+
+package "stage-1  Stage1View.swift" {
+  class "colourSpace" as csp <<Picker.segmented>> {
+    RGB | CMYK
+  }
+  class "patchCountPreset" as pcp <<Picker>> {
+    PatchCountPreset.allCases
+  }
+  class "patchCountCustom" as pcc <<TextField.number>> {
+    shown: patchPreset == .custom
+  }
+  class "whitePatches" as wp <<Stepper>> {
+    0...50
+  }
+  class "blackPatches" as bp <<Stepper>> {
+    0...50
+  }
+  class "targetBasename" as tb <<TextField>>
+  class "btnBrowse" as bb <<Button>> {
+    save panel; sets basename
+  }
+  class "btnSelectWorkDir" as wd <<Button>>
+  class "btnOpenExisting" as oe <<Button>> {
+    .ti1 or .ti2 (+ matching .ti1)
+  }
+  class "btn-import-dataset" as imp <<Button>> {
+    .ti3 / .txt / .cgats / .csv
+    unlocks stage 4
+  }
+  class "selectedPathDisplay" as spd <<Text>>
+  class "targenAdvancedDetails" as adv <<DisclosureGroup>> {
+    UI tests pre-expand
+  }
+  class "btnGenerate" as gen <<Button>> {
+    disabled: !canGenerate || targenRunning
+    canGenerate: valid basename AND directory
+    label Generating… while running
+  }
+  class "targenLogContainer / targenLog" as tlog <<DisclosureGroup>> {
+    ProcessLogView.swift
+  }
+}
+
+package "Advanced (hidden until disclosure open)" {
+  class "targenGreySteps" as ag <<Toggle+TextField>> {
+    field shown iff toggle on
+  }
+  class "targenSingleChannelSteps" as as1 <<Toggle+TextField>>
+  class "targenNeutralSteps" as an <<Toggle+TextField>>
+  class "targenNeutralConcentration" as anc <<Toggle+Slider>> {
+    0...1  shown iff on
+  }
+  class "targenAdaptation" as aa <<Toggle+Slider>> {
+    0...1
+  }
+  class "targenPrecondProfile" as ap <<TextField>>
+  class "btnBrowsePrecondProfile" as apb <<Button>>
+  class "targenHighQuality" as ahq <<Toggle>> {
+    OFPS -G
+  }
+  class "targenAlgorithm" as aal <<Picker>>
+  class "targenInkLimitGroup" as ail <<Toggle+TextField>> {
+    shown: colourSpace == cmyk
+  }
+  class "targenDarkEmphasis" as ad <<Toggle+Slider>> {
+    0...3
+  }
+  class "targenDevicePower" as adp <<Toggle+Slider>> {
+    0...3
+  }
+}
+adv --> ag
+
+package "stage-2  Stage2View.swift" {
+  class "cmWarningBanner" as cmw <<Banner>> {
+    always visible on stage 2
+    not a control
+  }
+  class "instrumentSelect" as ins <<Picker>> {
+    PrintInstrument — chart code, NOT USB port
+  }
+  class "pageSizeSelect" as pgs <<Picker>>
+  class "customPageSizeRow" as cps <<HStack>> {
+    shown: pageSize == .custom
+    customPageW / customPageH  mm
+  }
+  class "bitDepth" as bit <<Picker>> {
+    8-bit | 16-bit TIFF
+    (no a11y id on picker)
+  }
+  class "tiffDpi" as dpi <<Stepper>> {
+    72...600
+  }
+  class "printtargLayoutOrder" as lo <<Picker>>
+  class "printtargCustomSeedGroup" as seed <<HStack>> {
+    shown: layoutOrder == .customSeed
+    id printtargCustomSeed
+  }
+  class "btnToggleLabelEdit" as tle <<Button>> {
+    toggles labelIsCustom
+    title: Edit label… / Use automatic label
+  }
+  class "targetMetadataPrinter" as mp <<TextField>>
+  class "targetMetadataInkSet" as mi <<TextField>>
+  class "targetMetadataDriverPaper" as md <<TextField>>
+  class "targetMetadataActualPaper" as ma <<TextField>>
+  class "targetLabelPreview" as lpv <<TextField|Text>> {
+    TextField if labelIsCustom else Text(automatic)
+  }
+  class "btnCreateLayout" as lay <<Button>> {
+    disabled: printtargRunning || basename.empty
+  }
+  class "printtargLogContainer" as plog <<DisclosureGroup>>
+  class "tiffGallery" as gal <<Grid>> {
+    shown: printtargResult != nil
+    galleryInfo, galleryGrid
+    galleryPage-{index}
+    btnPrintPage-{index}
+    Print disabled: isPrinting || selectedPrinter.empty
+  }
+}
+
+package "rawPrintPanel" {
+  class "printerSelect" as ps <<Picker>> {
+    CUPS queues
+  }
+  class "printerStatusBadge" as psb <<Caption>> {
+    shown: selected printer in list
+  }
+  class "btnRefreshPrinters" as prf <<Button>>
+  class "btnPrinterProperties" as ppr <<Button>> {
+    disabled: selectedPrinter.empty
+    bound NSPrintPanel
+  }
+  class "printerTraySelect" as ptr <<Picker>> {
+    shown: trays nonempty
+  }
+  class "printerMediaTypeSelect" as pmt <<Picker>> {
+    shown: mediaTypes nonempty
+    also mediaTypeGroup
+  }
+  class "btnOrientPortrait" as por <<Button>>
+  class "btnOrientLandscape" as lan <<Button>>
+  class "btnPrintAll" as pal <<Button>> {
+    disabled: isPrinting
+             || printtargResult==nil
+             || selectedPrinter.empty
+  }
+  class "btnAdvanceToStage3" as a3 <<Button>> {
+    disabled: printtargResult==nil
+             || !isUnlocked(.measure)
+  }
+  class "printNotificationText" as pnt <<Caption>> {
+    shown: print.printNotice != nil
+  }
+}
+@enduml
+
+@startuml ICCery-UI-stage3-5-cal
+title Stages 3–5, Calibrate Printer, Measure transport
+skinparam classAttributeIconSize 0
+hide circle
+hide empty methods
+
+package "stage-3  Stage3View.swift / MeasurementWorkflowViewModel" {
+  class "btnDetectInstruments" as d3 <<Button>> {
+    disabled: !canDetect  (!isDetecting)
+  }
+  class "chartreadInstrumentSelect" as i3 <<Picker.menu>> {
+    Auto + instlist ports
+  }
+  class "xyTableHint" as xyh <<Caption>> {
+    shown: selectedInstrument.isXY
+  }
+  class "xyTablePanel" as xyp <<HStack>> {
+    shown: isXY
+    xyStepPlace / Align / Scan / Remove
+    highlight = xyStep
+  }
+  class "chartreadPrompt" as pr <<Text>>
+  class "chartreadLastError" as err <<Caption>> {
+    shown: chartreadNotice != nil
+  }
+  class "btnStartRead" as sr <<Button>> {
+    shown: !isChartreadRunning
+    disabled: !canStartRead
+    canStart: basename && cwd && !running
+  }
+  class "btnCalibrate" as cal3 <<Button>> {
+    shown: running && state==calibrating
+  }
+  class "btnTrigger" as trg <<Button>> {
+    shown: running && awaitingStrip
+  }
+  class "btnDoneReadEarly" as de <<Button>> {
+    shown: awaitingStrip
+  }
+  class "btnAccept" as acc <<Button>> {
+    shown: tablePlaceSheet | tableAlign
+           | promptContinue | warning
+    title Continue or Continue (send 'X')
+  }
+  class "btnRetry" as rty <<Button>> {
+    shown: state==error
+  }
+  class "btnDoneRead" as dn <<Button>> {
+    shown: allStripsRead
+  }
+  class "btnCancel" as cnc <<Button>> {
+    shown: isChartreadRunning
+  }
+  class "swatchGrid" as sw <<Scroll>> {
+    swatch-{rowId}{loc}
+  }
+  class "readStats" as rst <<Text>>
+  class "chartreadAveragingPanel" as avg <<Panel>> {
+    shown: passSnapshots nonempty OR isFinished
+    passCounterBadge, passesList
+  }
+  class "btnMeasureAnotherSheet" as mas <<Button>> {
+    disabled: !isFinished || isChartreadRunning
+  }
+  class "btnFinishAndAverage" as fa <<Button>> {
+    disabled: !canFinish || isFinishing
+    canFinish: isFinished && passes nonempty
+  }
+}
+
+package "stage-4  Stage4View.swift / ProfileWorkflowViewModel" {
+  class "colprofAlgorithm" as alg <<Picker>>
+  class "colprofQuality" as q <<Picker>>
+  class "colprofFwa" as fwa <<Picker>>
+  class "colprofFwaCustomPath" as fwap <<TextField>> {
+    shown: custom spectrum selected
+  }
+  class "btnBrowseFwaSp" as fwab <<Button>> {
+    shown with custom path
+  }
+  class "colprofIlluminant" as ill <<TextField>>
+  class "colprofObserver" as obs <<TextField>>
+  class "colprofInputViewCond" as ivc <<TextField>>
+  class "colprofOutputViewCond" as ovc <<TextField>>
+  class "colprofDescription" as desc <<TextField>>
+  class "colprofCopyright" as cpr <<TextField>>
+  class "colprofApplyCalibration" as ac <<Toggle>>
+  class "colprofCalibrationFile" as cf <<TextField>> {
+    shown: applyCalibration
+  }
+  class "btnBrowseCalibrationFile" as cfb <<Button>> {
+    shown: applyCalibration
+  }
+  class "btnCreateProfile" as cp <<Button>> {
+    disabled: !canCreateProfile
+    canCreate: basename && cwd && !colprofRunning
+  }
+  class "colprofProgressIndicator" as cpi <<Progress>> {
+    shown: isColprofRunning
+  }
+}
+
+package "stage-5  Stage5View.swift" {
+  class "btnVerifyProfile" as vf <<Button>> {
+    disabled: !canVerify
+    canVerify: createdProfileURL && !profcheckRunning
+  }
+  class "profcheckProgressIndicator" as ppi <<Progress>> {
+    shown: isProfcheckRunning
+  }
+  class "btnViewGamut" as vg5 <<Button>> {
+    DUPLICATE id with sidebar
+    disabled: createdGamutURL == nil
+  }
+  class "btnInstallProfile" as inst <<Button>> {
+    disabled: createdProfileURL == nil
+    may present collision alert
+  }
+  class "driftPrinterFilter" as df <<Picker>>
+  class "btnExportHistory" as eh <<Button>>
+  class "btnClearHistory" as ch <<Button>>
+  class "verificationHistoryTable" as ht <<Table>>
+  class "driftChart" as dc <<View>> {
+    DriftChartView.swift  not interactive
+  }
+  class "driftAlert / profcheckWarningBanner" as dalt <<Banner>> {
+    shown on fail / warning status
+  }
+}
+
+package "Install collision alert" {
+  class "profileOverwriteBtn" as io <<Button>>
+  class "profileRenameBtn" as ir <<Button>>
+  class "profileCancelCollisionBtn" as ic <<Button>> {
+    shown: showingInstallCollision
+    && settings.askBeforeOverwriteProfile
+  }
+}
+
+package "stage-cal  CalibrationView.swift  (Stage 0)" {
+  class "Colour Space" as ccs <<Picker.segmented>> {
+    RGB | CMYK  (no a11y id)
+  }
+  class "calSteps" as cst <<TextField.number>>
+  class "White patches" as cwp <<TextField.number>> {
+    no a11y id
+  }
+  class "calInkExplore" as cin <<TextField>> {
+    shown: colourSpace == cmyk
+  }
+  class "calNeutralEmphasis" as cne <<Toggle.checkbox>>
+  class "btnCalGenerate" as cg <<Button>> {
+    disabled: basename.empty || cwd==nil || isGenerating
+  }
+  class "btnCalLayout" as cl <<Button>> {
+    same disable as Generate
+  }
+  class "btnCalMeasure" as cm <<Button>> {
+    disabled: calibrationTi3URL == nil
+  }
+  class "btnCalCompute" as cc <<Button>> {
+    disabled: !canCompute
+    canCompute: .ti3 exists && !isComputing
+  }
+  class "calApplyToggle" as cat <<Toggle>> {
+    shown: computedCalURL != nil
+  }
+  class "btnCalReturn" as cr <<Button>> {
+    Esc / cancelAction
+    restores original basename
+  }
+}
+@enduml
+
+@startuml ICCery-UI-sheets
+title Sheets, dialogs, Spot Read, Gamut, Settings
+skinparam classAttributeIconSize 0
+hide circle
+hide empty methods
+
+package "SettingsView.swift  sheet from openSettingsBtn" {
+  class "Argyll dir" as ad <<TextField+Browse>> {
+    empty => bundled sidecars
+  }
+  class "Default instrument" as di <<Picker>> {
+    None + i1/p3/CM/SS/20/22/41/51
+    seeds Stage 3 + Spot Read
+    does NOT change instrumentSelect
+  }
+  class "Enable i1Pro 2 LEDs" as led <<Toggle>>
+  class "settingsDeltaEGood" as dg <<TextField.number>>
+  class "settingsDeltaEWarning" as dw <<TextField.number>> {
+    Save refuses unless Warning > Good
+  }
+  class "settingsCalStaleDays" as sd <<TextField.number>>
+  class "Install location" as il <<Picker>> {
+    User | System library
+  }
+  class "Ask before overwriting" as ao <<Toggle>>
+  class "Open ColorSync after install" as oc <<Toggle>>
+  class "Log level" as ll <<Picker>>
+  class "Open log folder / Copy path / Copy excerpt" as lg <<Button x3>>
+  class "Cancel / Save" as ss <<Button>> {
+    Save stays on sheet if validation fails
+    frame 560x620
+  }
+}
+
+package "AboutView.swift" {
+  class "aboutDialog" as ab <<Sheet>> {
+    aboutVersion, aboutBuildDate
+    closeAboutBtn  Esc
+  }
+}
+
+package "savePresetDialog  PresetDialogs.swift" {
+  class "savePresetName" as spn <<TextField>>
+  class "savePresetDesc" as spd <<TextField>>
+  class "btnCloseSavePresetDialog" as spc <<Button>>
+  class "btnConfirmSavePreset" as sps <<Button>> {
+    disabled: name trimmed empty
+  }
+}
+
+package "managePresetsDialog" {
+  class "presetRow-{id}" as prw <<Row>> {
+    Built-in: no delete
+    else btnExportPreset-{id} btnDeletePreset-{id}
+  }
+  class "btnImportPreset" as pim <<Button>>
+  class "btnExportActivePreset" as pea <<Button>> {
+    shown: selected custom preset
+  }
+  class "btnCloseManagePresetsDialog" as pcl <<Button>>
+}
+
+package "saveMediaRecipeDialog  MediaLibraryDialogs.swift" {
+  class "saveMediaName/Notes/Paper/Ink" as smf <<TextField x4>>
+  class "saveMediaPrinter/Preset/ColourSpace/Cal" as smr <<read-only>>
+  class "saveMediaApplyCal" as smc <<Toggle>> {
+    disabled: !calApplyable
+    calApplyable: path exists, not CAL_ stem
+  }
+  class "btnCloseSaveMediaDialog" as smx <<Button>>
+  class "btnConfirmSaveMedia" as sms <<Button>> {
+    disabled: name|paper|ink empty
+             OR captureColourSpaceMismatch
+  }
+}
+
+package "manageMediaDialog" {
+  class "mediaLibraryList" as mll <<List>> {
+    mediaRow-{id}
+    btnMediaLibraryApply-{id}
+    btnMediaLibraryDelete-{id}
+    double-click row = Apply
+  }
+  class "manageMediaNotice" as mmn <<Caption>> {
+    shown: manageApplyNotice != nil
+    in-sheet copy of failed Apply (#170)
+  }
+  class "btnMediaLibraryApply" as mla <<Button>> {
+    Apply selected
+    disabled: selection == nil
+  }
+  class "btnMediaLibraryCaptureFromManage" as mlc <<Button>> {
+    dismiss then open capture
+  }
+  class "btnCloseManageMediaDialog" as mlx <<Button>>
+  class "Delete alert" as mld <<alert>> {
+    Cancel / Delete
+  }
+}
+
+package "spotReadView  SpotReadView.swift  (#148)" {
+  class "spotSidecarMissing" as ssm <<Text>> {
+    shown: !sidecarAvailable
+    hides instrument/transport
+  }
+  class "btnSpotDetectInstruments" as sdet <<Button>> {
+    disabled: !canDetect  (detecting or running)
+  }
+  class "spotInstrumentSelect" as sis <<Picker>> {
+    disabled: isRunning
+  }
+  class "spotDefaultMissing" as sdm <<Caption>> {
+    shown: defaultMissing
+  }
+  class "spotSetDefault" as ssd <<Toggle>>
+  class "spotXYHint" as sxy <<Caption>> {
+    shown: selected is XY table
+  }
+  class "btnSpotStart" as sst <<Button>> {
+    shown: !isRunning
+    disabled: !canStart
+    canStart: sidecar && !detecting && !running
+              && !chartreadRunning && cwd
+  }
+  class "btnSpotCalibrate" as sca <<Button>> {
+    shown: running && calibrating
+  }
+  class "btnSpotTrigger" as str <<Button>> {
+    shown: running && awaitingStrip  (Read)
+  }
+  class "btnSpotStop" as ssp <<Button>> {
+    shown: isRunning
+  }
+  class "spotLastSample / Lab / XYZ / DeltaE" as sls <<Display>> {
+    spotLabImplausible if L not in 0...100
+    spotDeltaE hidden on first sample
+  }
+  class "spotHistoryTable" as sht <<List>> {
+    rows are buttons spotHistoryRow-{uuid}
+    click restores last sample, no trigger
+  }
+  class "btnSpotCopyLab" as scp <<Button>> {
+    disabled: displayedSample == nil
+  }
+  class "btnSpotExportCsv" as sex <<Button>> {
+    disabled: samples.isEmpty
+  }
+  class "btnCloseSpotRead" as scl <<Button>> {
+    Esc; onDismiss = Stop
+  }
+}
+
+package "gamutView  GamutView.swift  (#147)" {
+  class "gamutLayer-srgb" as gls <<Toggle.checkbox>> {
+    sRGB always loaded; can hide; cannot remove
+  }
+  class "gamutLayer-profile" as glp <<Toggle>> {
+    disabled: no session .gam
+  }
+  class "gamutLayer-compare" as glc <<Toggle>> {
+    disabled: no compare layer
+  }
+  class "btnGamutAddCompare" as gac <<Menu>> {
+    btnGamutOpenGam / btnGamutOpenProfile
+  }
+  class "btnGamutRemoveCompare" as grc <<Button>> {
+    disabled: compare layer nil
+  }
+  class "btnGamutSampleTiff" as gst <<Button>>
+  class "gamutViewerUnavailable" as gun <<Caption>> {
+    shown: no Metal / SCNView failed
+    toggles + inspect still enabled
+  }
+  class "btnResetGamutCamera" as grs <<Button>> {
+    R when focused
+  }
+  class "gamutLabEntryL/A/B" as gle <<TextField x3>>
+  class "btnGamutInspectLab" as gin <<Button>> {
+    disabled: !canInspectLab
+  }
+  class "gamutInspectPanel" as gip <<Panel>>
+  class "btnCloseGamut" as gcl <<Button>> {
+    Esc
+  }
+  class "gamutTiffPreview sheet" as gtf <<Sheet>> {
+    showingTiffPreview
+    click pixel; btnCloseGamutTiffPreview
+  }
+}
+
+package "Project alerts / relocate  RootView + ProjectUI" {
+  class "projectNewAlert" as pna <<alert>> {
+    btnProjectNewCancel / btnProjectNewConfirm
+  }
+  class "Dirty save alert" as pda <<alert>> {
+    btnProjectDirtySave
+    btnProjectDirtyDiscard
+    btnProjectDirtyCancel
+    shown when New/Open/Close and dirty
+  }
+  class "projectRelocateSheet" as prs <<Sheet>> {
+    shown: cwd missing on Open
+    btnProjectRelocateCancel
+    btnProjectRelocate  Choose Folder…
+  }
+}
+
+note as nMutex
+  Mutex / exclusive
+  Spot Read disabled while Stage 3 chartread runs
+  Opening Spot Read never kills chartread_{basename}
+  Calibrate uses temporary CAL_ basename; Save Project stays
+  enabled so the refusal banner can fire; chip Save uses canSave
+  Failed media Apply keeps manageMediaDialog open
+  Window noticeText is occluded by that sheet — use manageMediaNotice
+end note
+@enduml
-- 
2.39.5


From 368ae56cf30e7f9e0ac5d142bde3c7f31cadacb4 Mon Sep 17 00:00:00 2001
From: gronod <gronod@users.noreply.git.i3omb.com>
Date: Mon, 14 Sep 2026 14:18:07 +0000
Subject: [PATCH 2/8] docs: split UI PlantUML map into one diagram per file

Kroki only renders the first @startuml block in a file.
---
 docs/ui-interactive-map-sheets.puml       | 217 ++++++
 docs/ui-interactive-map-shell.puml        | 208 ++++++
 docs/ui-interactive-map-stage1-2.puml     | 163 +++++
 docs/ui-interactive-map-stage3-5-cal.puml | 174 +++++
 docs/ui-interactive-map.puml              | 762 ----------------------
 5 files changed, 762 insertions(+), 762 deletions(-)
 create mode 100644 docs/ui-interactive-map-sheets.puml
 create mode 100644 docs/ui-interactive-map-shell.puml
 create mode 100644 docs/ui-interactive-map-stage1-2.puml
 create mode 100644 docs/ui-interactive-map-stage3-5-cal.puml
 delete mode 100644 docs/ui-interactive-map.puml

diff --git a/docs/ui-interactive-map-sheets.puml b/docs/ui-interactive-map-sheets.puml
new file mode 100644
index 0000000..9372ac3
--- /dev/null
+++ b/docs/ui-interactive-map-sheets.puml
@@ -0,0 +1,217 @@
+@startuml ICCery-UI-sheets
+title Sheets, dialogs, Spot Read, Gamut, Settings
+skinparam classAttributeIconSize 0
+hide circle
+hide empty methods
+
+package "SettingsView.swift  sheet from openSettingsBtn" {
+  class "Argyll dir" as ad <<TextField+Browse>> {
+    empty => bundled sidecars
+  }
+  class "Default instrument" as di <<Picker>> {
+    None + i1/p3/CM/SS/20/22/41/51
+    seeds Stage 3 + Spot Read
+    does NOT change instrumentSelect
+  }
+  class "Enable i1Pro 2 LEDs" as led <<Toggle>>
+  class "settingsDeltaEGood" as dg <<TextField.number>>
+  class "settingsDeltaEWarning" as dw <<TextField.number>> {
+    Save refuses unless Warning > Good
+  }
+  class "settingsCalStaleDays" as sd <<TextField.number>>
+  class "Install location" as il <<Picker>> {
+    User | System library
+  }
+  class "Ask before overwriting" as ao <<Toggle>>
+  class "Open ColorSync after install" as oc <<Toggle>>
+  class "Log level" as ll <<Picker>>
+  class "Open log folder / Copy path / Copy excerpt" as lg <<Button x3>>
+  class "Cancel / Save" as ss <<Button>> {
+    Save stays on sheet if validation fails
+    frame 560x620
+  }
+}
+
+package "AboutView.swift" {
+  class "aboutDialog" as ab <<Sheet>> {
+    aboutVersion, aboutBuildDate
+    closeAboutBtn  Esc
+  }
+}
+
+package "savePresetDialog  PresetDialogs.swift" {
+  class "savePresetName" as spn <<TextField>>
+  class "savePresetDesc" as spd <<TextField>>
+  class "btnCloseSavePresetDialog" as spc <<Button>>
+  class "btnConfirmSavePreset" as sps <<Button>> {
+    disabled: name trimmed empty
+  }
+}
+
+package "managePresetsDialog" {
+  class "presetRow-{id}" as prw <<Row>> {
+    Built-in: no delete
+    else btnExportPreset-{id} btnDeletePreset-{id}
+  }
+  class "btnImportPreset" as pim <<Button>>
+  class "btnExportActivePreset" as pea <<Button>> {
+    shown: selected custom preset
+  }
+  class "btnCloseManagePresetsDialog" as pcl <<Button>>
+}
+
+package "saveMediaRecipeDialog  MediaLibraryDialogs.swift" {
+  class "saveMediaName/Notes/Paper/Ink" as smf <<TextField x4>>
+  class "saveMediaPrinter/Preset/ColourSpace/Cal" as smr <<read-only>>
+  class "saveMediaApplyCal" as smc <<Toggle>> {
+    disabled: !calApplyable
+    calApplyable: path exists, not CAL_ stem
+  }
+  class "btnCloseSaveMediaDialog" as smx <<Button>>
+  class "btnConfirmSaveMedia" as sms <<Button>> {
+    disabled: name|paper|ink empty
+             OR captureColourSpaceMismatch
+  }
+}
+
+package "manageMediaDialog" {
+  class "mediaLibraryList" as mll <<List>> {
+    mediaRow-{id}
+    btnMediaLibraryApply-{id}
+    btnMediaLibraryDelete-{id}
+    double-click row = Apply
+  }
+  class "manageMediaNotice" as mmn <<Caption>> {
+    shown: manageApplyNotice != nil
+    in-sheet copy of failed Apply (#170)
+  }
+  class "btnMediaLibraryApply" as mla <<Button>> {
+    Apply selected
+    disabled: selection == nil
+  }
+  class "btnMediaLibraryCaptureFromManage" as mlc <<Button>> {
+    dismiss then open capture
+  }
+  class "btnCloseManageMediaDialog" as mlx <<Button>>
+  class "Delete alert" as mld <<alert>> {
+    Cancel / Delete
+  }
+}
+
+package "spotReadView  SpotReadView.swift  (#148)" {
+  class "spotSidecarMissing" as ssm <<Text>> {
+    shown: !sidecarAvailable
+    hides instrument/transport
+  }
+  class "btnSpotDetectInstruments" as sdet <<Button>> {
+    disabled: !canDetect  (detecting or running)
+  }
+  class "spotInstrumentSelect" as sis <<Picker>> {
+    disabled: isRunning
+  }
+  class "spotDefaultMissing" as sdm <<Caption>> {
+    shown: defaultMissing
+  }
+  class "spotSetDefault" as ssd <<Toggle>>
+  class "spotXYHint" as sxy <<Caption>> {
+    shown: selected is XY table
+  }
+  class "btnSpotStart" as sst <<Button>> {
+    shown: !isRunning
+    disabled: !canStart
+    canStart: sidecar && !detecting && !running
+              && !chartreadRunning && cwd
+  }
+  class "btnSpotCalibrate" as sca <<Button>> {
+    shown: running && calibrating
+  }
+  class "btnSpotTrigger" as str <<Button>> {
+    shown: running && awaitingStrip  (Read)
+  }
+  class "btnSpotStop" as ssp <<Button>> {
+    shown: isRunning
+  }
+  class "spotLastSample / Lab / XYZ / DeltaE" as sls <<Display>> {
+    spotLabImplausible if L not in 0...100
+    spotDeltaE hidden on first sample
+  }
+  class "spotHistoryTable" as sht <<List>> {
+    rows are buttons spotHistoryRow-{uuid}
+    click restores last sample, no trigger
+  }
+  class "btnSpotCopyLab" as scp <<Button>> {
+    disabled: displayedSample == nil
+  }
+  class "btnSpotExportCsv" as sex <<Button>> {
+    disabled: samples.isEmpty
+  }
+  class "btnCloseSpotRead" as scl <<Button>> {
+    Esc; onDismiss = Stop
+  }
+}
+
+package "gamutView  GamutView.swift  (#147)" {
+  class "gamutLayer-srgb" as gls <<Toggle.checkbox>> {
+    sRGB always loaded; can hide; cannot remove
+  }
+  class "gamutLayer-profile" as glp <<Toggle>> {
+    disabled: no session .gam
+  }
+  class "gamutLayer-compare" as glc <<Toggle>> {
+    disabled: no compare layer
+  }
+  class "btnGamutAddCompare" as gac <<Menu>> {
+    btnGamutOpenGam / btnGamutOpenProfile
+  }
+  class "btnGamutRemoveCompare" as grc <<Button>> {
+    disabled: compare layer nil
+  }
+  class "btnGamutSampleTiff" as gst <<Button>>
+  class "gamutViewerUnavailable" as gun <<Caption>> {
+    shown: no Metal / SCNView failed
+    toggles + inspect still enabled
+  }
+  class "btnResetGamutCamera" as grs <<Button>> {
+    R when focused
+  }
+  class "gamutLabEntryL/A/B" as gle <<TextField x3>>
+  class "btnGamutInspectLab" as gin <<Button>> {
+    disabled: !canInspectLab
+  }
+  class "gamutInspectPanel" as gip <<Panel>>
+  class "btnCloseGamut" as gcl <<Button>> {
+    Esc
+  }
+  class "gamutTiffPreview sheet" as gtf <<Sheet>> {
+    showingTiffPreview
+    click pixel; btnCloseGamutTiffPreview
+  }
+}
+
+package "Project alerts / relocate  RootView + ProjectUI" {
+  class "projectNewAlert" as pna <<alert>> {
+    btnProjectNewCancel / btnProjectNewConfirm
+  }
+  class "Dirty save alert" as pda <<alert>> {
+    btnProjectDirtySave
+    btnProjectDirtyDiscard
+    btnProjectDirtyCancel
+    shown when New/Open/Close and dirty
+  }
+  class "projectRelocateSheet" as prs <<Sheet>> {
+    shown: cwd missing on Open
+    btnProjectRelocateCancel
+    btnProjectRelocate  Choose Folder…
+  }
+}
+
+note as nMutex
+  Mutex / exclusive
+  Spot Read disabled while Stage 3 chartread runs
+  Opening Spot Read never kills chartread_{basename}
+  Calibrate uses temporary CAL_ basename; Save Project stays
+  enabled so the refusal banner can fire; chip Save uses canSave
+  Failed media Apply keeps manageMediaDialog open
+  Window noticeText is occluded by that sheet — use manageMediaNotice
+end note
+@enduml
diff --git a/docs/ui-interactive-map-shell.puml b/docs/ui-interactive-map-shell.puml
new file mode 100644
index 0000000..38f89f2
--- /dev/null
+++ b/docs/ui-interactive-map-shell.puml
@@ -0,0 +1,208 @@
+@startuml ICCery-UI-shell
+title ICCery v2 — interactive UI map (develop)\nobject names, files, enable / hide rules
+caption Accessibility ids in quotes. Disk gating: WizardGating.swift. No App Sandbox.
+skinparam classAttributeIconSize 0
+skinparam wrapWidth 280
+hide circle
+hide empty methods
+
+together {
+  class "WindowGroup ICCery" as win <<ICCeryApp.swift>> {
+    1280x800, min 1100x700
+    File menu: ProjectCommands
+  }
+  class "RootView" as root <<RootView.swift>> {
+    sidebar 270pt + stage column
+    sheets / alerts hosted here
+  }
+}
+
+win --> root
+
+package "Persistent chrome" {
+  class "SidebarView" as side <<SidebarView.swift>>
+  class "NoticeBanner" as ban <<NoticeBanner.swift>> {
+    id noticeText
+    shown: wizard.notice != nil
+    auto-hide 6s unless nil
+    close: xmark (no a11y id)
+  }
+  class "WizardStageContent" as stage <<RootView.swift>> {
+    switch wizard.stage
+  }
+}
+
+root --> side
+root --> ban
+root --> stage
+
+package "Sidebar header" {
+  class "openSettingsBtn" as sSet <<Button>> {
+    gearshape
+    always enabled
+    presents SettingsView sheet
+  }
+  class "openAboutBtn" as sAbt <<Button>> {
+    info.circle
+    always enabled
+    presents AboutView
+  }
+  class "btnToggleAllHelp" as sHlp <<Button>> {
+    questionmark.circle
+    toggles showingAllHelp
+    HelpOverlayView: yellow dots when on
+  }
+}
+side --> sSet
+side --> sAbt
+side --> sHlp
+
+package "Presets (#11)" {
+  class "presetSelect" as pre <<Picker.menu>> {
+    tags: none + ProfilingPreset.id
+    set applies preset immediately
+    "No preset" does not factory-reset
+  }
+  class "btnSavePresetModal" as preS <<Button>> {
+    always enabled
+    showingSavePreset = true
+  }
+  class "btnOpenPresetsDialog" as preM <<Button>> {
+    always enabled
+    showingManagePresets = true
+  }
+}
+side --> pre
+side --> preS
+side --> preM
+
+package "Media library (#146)" {
+  class "mediaSelect" as med <<Picker.menu>> {
+    tags: none + MediaRecipe.id
+    never reuses presetSelect
+    failed apply snaps back to none
+  }
+  class "mediaRecipeStale" as medSt <<Caption>> {
+    shown: staleReasons[selected] nonempty
+    "Printer not installed" or "Calibration stale"
+  }
+  class "btnMediaLibraryCapture" as medC <<Button>> {
+    disabled: print.selectedPrinter.isEmpty
+    needs Stage 2 queue
+  }
+  class "btnMediaLibraryManage" as medM <<Button>> {
+    always enabled
+  }
+}
+side --> med
+side --> medSt
+side --> medC
+side --> medM
+
+package "Studio (not stepper)" {
+  class "btnCalibratePrinter" as calB <<Button>> {
+    always enabled
+    wizard.enterCalibration()
+    Stage 0, not numbered
+  }
+  class "btnViewGamut" as gamB <<Button>> {
+    Sidebar copy — same id as Stage 5
+    always enabled
+    no .gam => sRGB only
+  }
+  class "btnSpotRead" as spotB <<Button>> {
+    disabled: workingDirectory==nil
+             OR measurement.isChartreadRunning
+  }
+}
+side --> calB
+side --> gamB
+side --> spotB
+
+package "Stepper 1–5  (disk is truth)" {
+  class "StepperRow stage N" as step <<Button.plain>> {
+    WizardStage.stepperStages
+    disabled / opacity 0.45 unless isUnlocked
+    go(to:) allowed backward always
+    calibrate is NOT a stepper row
+  }
+  note as nGate
+    WizardGating.swift / WizardViewModel.isUnlocked
+    1 generate: always
+    2 layOutPrint: .ti1
+    3 measure: .ti1 AND .ti2
+    4 buildProfile: .ti3 (not .ti2 alone)
+    5 verifyInstall: .ti3 AND .icc/.icm
+    Re-probed on window key (#151)
+  end note
+}
+side --> step
+step .. nGate
+
+package "Project chip (#149)  ProjectUI.swift" {
+  class "projectChip" as chip <<Container>>
+  class "projectChipName" as cn <<Text>> {
+    bound name or "No project"
+  }
+  class "projectChipPath" as cp <<Text>> {
+    shown if bound; last path component
+  }
+  class "projectChipStale" as cs <<Caption>> {
+    shown: diskBehindNotes
+  }
+  class "btnProjectReveal" as cr <<Button>> {
+    shown if bound
+  }
+  class "btnProjectSave" as csv <<Button>> {
+    shown if bound
+    disabled: !canSave
+    canSave: isBound && basename && cwd
+    CAL_ basename still enabled (refusal banner)
+  }
+  class "btnProjectOpen" as co <<Button>> {
+    shown if NOT bound
+  }
+}
+side --> chip
+chip --> cn
+chip --> cp
+chip --> cs
+chip --> cr
+chip --> csv
+chip --> co
+
+package "File menu  ProjectCommands / ICCeryApp.swift" {
+  class "menuProjectNew" as mN <<Button>> {
+    ⌘N  requestNew()
+  }
+  class "menuProjectOpen" as mO <<Button>> {
+    ⌘O
+  }
+  class "menuProjectRecents" as mR <<Menu>> {
+    disabled: recents.isEmpty
+    items: projectRecent-{bookmarkHash}
+    menuProjectRecentsClear
+  }
+  class "menuProjectSave" as mS <<Button>> {
+    ⌘S  disabled: !canSave
+  }
+  class "menuProjectSaveAs" as mSa <<Button>> {
+    ⇧⌘S  disabled: !canSaveAs
+    canSaveAs: basename && cwd (no bind required)
+  }
+  class "menuProjectReport" as mRp <<Button>> {
+    disabled: !canReport
+  }
+  class "menuProjectClose" as mCl <<Button>> {
+    disabled: !isBound
+  }
+}
+
+stage --> "stage-1\nStage1View.swift" as st1
+stage --> "stage-2\nStage2View.swift" as st2
+stage --> "stage-3\nStage3View.swift" as st3
+stage --> "stage-4\nStage4View.swift" as st4
+stage --> "stage-5\nStage5View.swift" as st5
+stage --> "stage-cal\nCalibrationView.swift" as st0
+@enduml
+
diff --git a/docs/ui-interactive-map-stage1-2.puml b/docs/ui-interactive-map-stage1-2.puml
new file mode 100644
index 0000000..f69cfb2
--- /dev/null
+++ b/docs/ui-interactive-map-stage1-2.puml
@@ -0,0 +1,163 @@
+@startuml ICCery-UI-stage1-2
+title Stages 1–2 — Generate Target / Lay Out and Print
+skinparam classAttributeIconSize 0
+hide circle
+hide empty methods
+
+package "stage-1  Stage1View.swift" {
+  class "colourSpace" as csp <<Picker.segmented>> {
+    RGB | CMYK
+  }
+  class "patchCountPreset" as pcp <<Picker>> {
+    PatchCountPreset.allCases
+  }
+  class "patchCountCustom" as pcc <<TextField.number>> {
+    shown: patchPreset == .custom
+  }
+  class "whitePatches" as wp <<Stepper>> {
+    0...50
+  }
+  class "blackPatches" as bp <<Stepper>> {
+    0...50
+  }
+  class "targetBasename" as tb <<TextField>>
+  class "btnBrowse" as bb <<Button>> {
+    save panel; sets basename
+  }
+  class "btnSelectWorkDir" as wd <<Button>>
+  class "btnOpenExisting" as oe <<Button>> {
+    .ti1 or .ti2 (+ matching .ti1)
+  }
+  class "btn-import-dataset" as imp <<Button>> {
+    .ti3 / .txt / .cgats / .csv
+    unlocks stage 4
+  }
+  class "selectedPathDisplay" as spd <<Text>>
+  class "targenAdvancedDetails" as adv <<DisclosureGroup>> {
+    UI tests pre-expand
+  }
+  class "btnGenerate" as gen <<Button>> {
+    disabled: !canGenerate || targenRunning
+    canGenerate: valid basename AND directory
+    label Generating… while running
+  }
+  class "targenLogContainer / targenLog" as tlog <<DisclosureGroup>> {
+    ProcessLogView.swift
+  }
+}
+
+package "Advanced (hidden until disclosure open)" {
+  class "targenGreySteps" as ag <<Toggle+TextField>> {
+    field shown iff toggle on
+  }
+  class "targenSingleChannelSteps" as as1 <<Toggle+TextField>>
+  class "targenNeutralSteps" as an <<Toggle+TextField>>
+  class "targenNeutralConcentration" as anc <<Toggle+Slider>> {
+    0...1  shown iff on
+  }
+  class "targenAdaptation" as aa <<Toggle+Slider>> {
+    0...1
+  }
+  class "targenPrecondProfile" as ap <<TextField>>
+  class "btnBrowsePrecondProfile" as apb <<Button>>
+  class "targenHighQuality" as ahq <<Toggle>> {
+    OFPS -G
+  }
+  class "targenAlgorithm" as aal <<Picker>>
+  class "targenInkLimitGroup" as ail <<Toggle+TextField>> {
+    shown: colourSpace == cmyk
+  }
+  class "targenDarkEmphasis" as ad <<Toggle+Slider>> {
+    0...3
+  }
+  class "targenDevicePower" as adp <<Toggle+Slider>> {
+    0...3
+  }
+}
+adv --> ag
+
+package "stage-2  Stage2View.swift" {
+  class "cmWarningBanner" as cmw <<Banner>> {
+    always visible on stage 2
+    not a control
+  }
+  class "instrumentSelect" as ins <<Picker>> {
+    PrintInstrument — chart code, NOT USB port
+  }
+  class "pageSizeSelect" as pgs <<Picker>>
+  class "customPageSizeRow" as cps <<HStack>> {
+    shown: pageSize == .custom
+    customPageW / customPageH  mm
+  }
+  class "bitDepth" as bit <<Picker>> {
+    8-bit | 16-bit TIFF
+    (no a11y id on picker)
+  }
+  class "tiffDpi" as dpi <<Stepper>> {
+    72...600
+  }
+  class "printtargLayoutOrder" as lo <<Picker>>
+  class "printtargCustomSeedGroup" as seed <<HStack>> {
+    shown: layoutOrder == .customSeed
+    id printtargCustomSeed
+  }
+  class "btnToggleLabelEdit" as tle <<Button>> {
+    toggles labelIsCustom
+    title: Edit label… / Use automatic label
+  }
+  class "targetMetadataPrinter" as mp <<TextField>>
+  class "targetMetadataInkSet" as mi <<TextField>>
+  class "targetMetadataDriverPaper" as md <<TextField>>
+  class "targetMetadataActualPaper" as ma <<TextField>>
+  class "targetLabelPreview" as lpv <<TextField|Text>> {
+    TextField if labelIsCustom else Text(automatic)
+  }
+  class "btnCreateLayout" as lay <<Button>> {
+    disabled: printtargRunning || basename.empty
+  }
+  class "printtargLogContainer" as plog <<DisclosureGroup>>
+  class "tiffGallery" as gal <<Grid>> {
+    shown: printtargResult != nil
+    galleryInfo, galleryGrid
+    galleryPage-{index}
+    btnPrintPage-{index}
+    Print disabled: isPrinting || selectedPrinter.empty
+  }
+}
+
+package "rawPrintPanel" {
+  class "printerSelect" as ps <<Picker>> {
+    CUPS queues
+  }
+  class "printerStatusBadge" as psb <<Caption>> {
+    shown: selected printer in list
+  }
+  class "btnRefreshPrinters" as prf <<Button>>
+  class "btnPrinterProperties" as ppr <<Button>> {
+    disabled: selectedPrinter.empty
+    bound NSPrintPanel
+  }
+  class "printerTraySelect" as ptr <<Picker>> {
+    shown: trays nonempty
+  }
+  class "printerMediaTypeSelect" as pmt <<Picker>> {
+    shown: mediaTypes nonempty
+    also mediaTypeGroup
+  }
+  class "btnOrientPortrait" as por <<Button>>
+  class "btnOrientLandscape" as lan <<Button>>
+  class "btnPrintAll" as pal <<Button>> {
+    disabled: isPrinting
+             || printtargResult==nil
+             || selectedPrinter.empty
+  }
+  class "btnAdvanceToStage3" as a3 <<Button>> {
+    disabled: printtargResult==nil
+             || !isUnlocked(.measure)
+  }
+  class "printNotificationText" as pnt <<Caption>> {
+    shown: print.printNotice != nil
+  }
+}
+@enduml
+
diff --git a/docs/ui-interactive-map-stage3-5-cal.puml b/docs/ui-interactive-map-stage3-5-cal.puml
new file mode 100644
index 0000000..79bac4d
--- /dev/null
+++ b/docs/ui-interactive-map-stage3-5-cal.puml
@@ -0,0 +1,174 @@
+@startuml ICCery-UI-stage3-5-cal
+title Stages 3–5, Calibrate Printer, Measure transport
+skinparam classAttributeIconSize 0
+hide circle
+hide empty methods
+
+package "stage-3  Stage3View.swift / MeasurementWorkflowViewModel" {
+  class "btnDetectInstruments" as d3 <<Button>> {
+    disabled: !canDetect  (!isDetecting)
+  }
+  class "chartreadInstrumentSelect" as i3 <<Picker.menu>> {
+    Auto + instlist ports
+  }
+  class "xyTableHint" as xyh <<Caption>> {
+    shown: selectedInstrument.isXY
+  }
+  class "xyTablePanel" as xyp <<HStack>> {
+    shown: isXY
+    xyStepPlace / Align / Scan / Remove
+    highlight = xyStep
+  }
+  class "chartreadPrompt" as pr <<Text>>
+  class "chartreadLastError" as err <<Caption>> {
+    shown: chartreadNotice != nil
+  }
+  class "btnStartRead" as sr <<Button>> {
+    shown: !isChartreadRunning
+    disabled: !canStartRead
+    canStart: basename && cwd && !running
+  }
+  class "btnCalibrate" as cal3 <<Button>> {
+    shown: running && state==calibrating
+  }
+  class "btnTrigger" as trg <<Button>> {
+    shown: running && awaitingStrip
+  }
+  class "btnDoneReadEarly" as de <<Button>> {
+    shown: awaitingStrip
+  }
+  class "btnAccept" as acc <<Button>> {
+    shown: tablePlaceSheet | tableAlign
+           | promptContinue | warning
+    title Continue or Continue (send 'X')
+  }
+  class "btnRetry" as rty <<Button>> {
+    shown: state==error
+  }
+  class "btnDoneRead" as dn <<Button>> {
+    shown: allStripsRead
+  }
+  class "btnCancel" as cnc <<Button>> {
+    shown: isChartreadRunning
+  }
+  class "swatchGrid" as sw <<Scroll>> {
+    swatch-{rowId}{loc}
+  }
+  class "readStats" as rst <<Text>>
+  class "chartreadAveragingPanel" as avg <<Panel>> {
+    shown: passSnapshots nonempty OR isFinished
+    passCounterBadge, passesList
+  }
+  class "btnMeasureAnotherSheet" as mas <<Button>> {
+    disabled: !isFinished || isChartreadRunning
+  }
+  class "btnFinishAndAverage" as fa <<Button>> {
+    disabled: !canFinish || isFinishing
+    canFinish: isFinished && passes nonempty
+  }
+}
+
+package "stage-4  Stage4View.swift / ProfileWorkflowViewModel" {
+  class "colprofAlgorithm" as alg <<Picker>>
+  class "colprofQuality" as q <<Picker>>
+  class "colprofFwa" as fwa <<Picker>>
+  class "colprofFwaCustomPath" as fwap <<TextField>> {
+    shown: custom spectrum selected
+  }
+  class "btnBrowseFwaSp" as fwab <<Button>> {
+    shown with custom path
+  }
+  class "colprofIlluminant" as ill <<TextField>>
+  class "colprofObserver" as obs <<TextField>>
+  class "colprofInputViewCond" as ivc <<TextField>>
+  class "colprofOutputViewCond" as ovc <<TextField>>
+  class "colprofDescription" as desc <<TextField>>
+  class "colprofCopyright" as cpr <<TextField>>
+  class "colprofApplyCalibration" as ac <<Toggle>>
+  class "colprofCalibrationFile" as cf <<TextField>> {
+    shown: applyCalibration
+  }
+  class "btnBrowseCalibrationFile" as cfb <<Button>> {
+    shown: applyCalibration
+  }
+  class "btnCreateProfile" as cp <<Button>> {
+    disabled: !canCreateProfile
+    canCreate: basename && cwd && !colprofRunning
+  }
+  class "colprofProgressIndicator" as cpi <<Progress>> {
+    shown: isColprofRunning
+  }
+}
+
+package "stage-5  Stage5View.swift" {
+  class "btnVerifyProfile" as vf <<Button>> {
+    disabled: !canVerify
+    canVerify: createdProfileURL && !profcheckRunning
+  }
+  class "profcheckProgressIndicator" as ppi <<Progress>> {
+    shown: isProfcheckRunning
+  }
+  class "btnViewGamut" as vg5 <<Button>> {
+    DUPLICATE id with sidebar
+    disabled: createdGamutURL == nil
+  }
+  class "btnInstallProfile" as inst <<Button>> {
+    disabled: createdProfileURL == nil
+    may present collision alert
+  }
+  class "driftPrinterFilter" as df <<Picker>>
+  class "btnExportHistory" as eh <<Button>>
+  class "btnClearHistory" as ch <<Button>>
+  class "verificationHistoryTable" as ht <<Table>>
+  class "driftChart" as dc <<View>> {
+    DriftChartView.swift  not interactive
+  }
+  class "driftAlert / profcheckWarningBanner" as dalt <<Banner>> {
+    shown on fail / warning status
+  }
+}
+
+package "Install collision alert" {
+  class "profileOverwriteBtn" as io <<Button>>
+  class "profileRenameBtn" as ir <<Button>>
+  class "profileCancelCollisionBtn" as ic <<Button>> {
+    shown: showingInstallCollision
+    && settings.askBeforeOverwriteProfile
+  }
+}
+
+package "stage-cal  CalibrationView.swift  (Stage 0)" {
+  class "Colour Space" as ccs <<Picker.segmented>> {
+    RGB | CMYK  (no a11y id)
+  }
+  class "calSteps" as cst <<TextField.number>>
+  class "White patches" as cwp <<TextField.number>> {
+    no a11y id
+  }
+  class "calInkExplore" as cin <<TextField>> {
+    shown: colourSpace == cmyk
+  }
+  class "calNeutralEmphasis" as cne <<Toggle.checkbox>>
+  class "btnCalGenerate" as cg <<Button>> {
+    disabled: basename.empty || cwd==nil || isGenerating
+  }
+  class "btnCalLayout" as cl <<Button>> {
+    same disable as Generate
+  }
+  class "btnCalMeasure" as cm <<Button>> {
+    disabled: calibrationTi3URL == nil
+  }
+  class "btnCalCompute" as cc <<Button>> {
+    disabled: !canCompute
+    canCompute: .ti3 exists && !isComputing
+  }
+  class "calApplyToggle" as cat <<Toggle>> {
+    shown: computedCalURL != nil
+  }
+  class "btnCalReturn" as cr <<Button>> {
+    Esc / cancelAction
+    restores original basename
+  }
+}
+@enduml
+
diff --git a/docs/ui-interactive-map.puml b/docs/ui-interactive-map.puml
deleted file mode 100644
index ad492e7..0000000
--- a/docs/ui-interactive-map.puml
+++ /dev/null
@@ -1,762 +0,0 @@
-@startuml ICCery-UI-shell
-title ICCery v2 — interactive UI map (develop)\nobject names, files, enable / hide rules
-caption Accessibility ids in quotes. Disk gating: WizardGating.swift. No App Sandbox.
-skinparam classAttributeIconSize 0
-skinparam wrapWidth 280
-hide circle
-hide empty methods
-
-together {
-  class "WindowGroup ICCery" as win <<ICCeryApp.swift>> {
-    1280x800, min 1100x700
-    File menu: ProjectCommands
-  }
-  class "RootView" as root <<RootView.swift>> {
-    sidebar 270pt + stage column
-    sheets / alerts hosted here
-  }
-}
-
-win --> root
-
-package "Persistent chrome" {
-  class "SidebarView" as side <<SidebarView.swift>>
-  class "NoticeBanner" as ban <<NoticeBanner.swift>> {
-    id noticeText
-    shown: wizard.notice != nil
-    auto-hide 6s unless nil
-    close: xmark (no a11y id)
-  }
-  class "WizardStageContent" as stage <<RootView.swift>> {
-    switch wizard.stage
-  }
-}
-
-root --> side
-root --> ban
-root --> stage
-
-package "Sidebar header" {
-  class "openSettingsBtn" as sSet <<Button>> {
-    gearshape
-    always enabled
-    presents SettingsView sheet
-  }
-  class "openAboutBtn" as sAbt <<Button>> {
-    info.circle
-    always enabled
-    presents AboutView
-  }
-  class "btnToggleAllHelp" as sHlp <<Button>> {
-    questionmark.circle
-    toggles showingAllHelp
-    HelpOverlayView: yellow dots when on
-  }
-}
-side --> sSet
-side --> sAbt
-side --> sHlp
-
-package "Presets (#11)" {
-  class "presetSelect" as pre <<Picker.menu>> {
-    tags: none + ProfilingPreset.id
-    set applies preset immediately
-    "No preset" does not factory-reset
-  }
-  class "btnSavePresetModal" as preS <<Button>> {
-    always enabled
-    showingSavePreset = true
-  }
-  class "btnOpenPresetsDialog" as preM <<Button>> {
-    always enabled
-    showingManagePresets = true
-  }
-}
-side --> pre
-side --> preS
-side --> preM
-
-package "Media library (#146)" {
-  class "mediaSelect" as med <<Picker.menu>> {
-    tags: none + MediaRecipe.id
-    never reuses presetSelect
-    failed apply snaps back to none
-  }
-  class "mediaRecipeStale" as medSt <<Caption>> {
-    shown: staleReasons[selected] nonempty
-    "Printer not installed" or "Calibration stale"
-  }
-  class "btnMediaLibraryCapture" as medC <<Button>> {
-    disabled: print.selectedPrinter.isEmpty
-    needs Stage 2 queue
-  }
-  class "btnMediaLibraryManage" as medM <<Button>> {
-    always enabled
-  }
-}
-side --> med
-side --> medSt
-side --> medC
-side --> medM
-
-package "Studio (not stepper)" {
-  class "btnCalibratePrinter" as calB <<Button>> {
-    always enabled
-    wizard.enterCalibration()
-    Stage 0, not numbered
-  }
-  class "btnViewGamut" as gamB <<Button>> {
-    Sidebar copy — same id as Stage 5
-    always enabled
-    no .gam => sRGB only
-  }
-  class "btnSpotRead" as spotB <<Button>> {
-    disabled: workingDirectory==nil
-             OR measurement.isChartreadRunning
-  }
-}
-side --> calB
-side --> gamB
-side --> spotB
-
-package "Stepper 1–5  (disk is truth)" {
-  class "StepperRow stage N" as step <<Button.plain>> {
-    WizardStage.stepperStages
-    disabled / opacity 0.45 unless isUnlocked
-    go(to:) allowed backward always
-    calibrate is NOT a stepper row
-  }
-  note as nGate
-    WizardGating.swift / WizardViewModel.isUnlocked
-    1 generate: always
-    2 layOutPrint: .ti1
-    3 measure: .ti1 AND .ti2
-    4 buildProfile: .ti3 (not .ti2 alone)
-    5 verifyInstall: .ti3 AND .icc/.icm
-    Re-probed on window key (#151)
-  end note
-}
-side --> step
-step .. nGate
-
-package "Project chip (#149)  ProjectUI.swift" {
-  class "projectChip" as chip <<Container>>
-  class "projectChipName" as cn <<Text>> {
-    bound name or "No project"
-  }
-  class "projectChipPath" as cp <<Text>> {
-    shown if bound; last path component
-  }
-  class "projectChipStale" as cs <<Caption>> {
-    shown: diskBehindNotes
-  }
-  class "btnProjectReveal" as cr <<Button>> {
-    shown if bound
-  }
-  class "btnProjectSave" as csv <<Button>> {
-    shown if bound
-    disabled: !canSave
-    canSave: isBound && basename && cwd
-    CAL_ basename still enabled (refusal banner)
-  }
-  class "btnProjectOpen" as co <<Button>> {
-    shown if NOT bound
-  }
-}
-side --> chip
-chip --> cn
-chip --> cp
-chip --> cs
-chip --> cr
-chip --> csv
-chip --> co
-
-package "File menu  ProjectCommands / ICCeryApp.swift" {
-  class "menuProjectNew" as mN <<Button>> {
-    ⌘N  requestNew()
-  }
-  class "menuProjectOpen" as mO <<Button>> {
-    ⌘O
-  }
-  class "menuProjectRecents" as mR <<Menu>> {
-    disabled: recents.isEmpty
-    items: projectRecent-{bookmarkHash}
-    menuProjectRecentsClear
-  }
-  class "menuProjectSave" as mS <<Button>> {
-    ⌘S  disabled: !canSave
-  }
-  class "menuProjectSaveAs" as mSa <<Button>> {
-    ⇧⌘S  disabled: !canSaveAs
-    canSaveAs: basename && cwd (no bind required)
-  }
-  class "menuProjectReport" as mRp <<Button>> {
-    disabled: !canReport
-  }
-  class "menuProjectClose" as mCl <<Button>> {
-    disabled: !isBound
-  }
-}
-
-stage --> "stage-1\nStage1View.swift" as st1
-stage --> "stage-2\nStage2View.swift" as st2
-stage --> "stage-3\nStage3View.swift" as st3
-stage --> "stage-4\nStage4View.swift" as st4
-stage --> "stage-5\nStage5View.swift" as st5
-stage --> "stage-cal\nCalibrationView.swift" as st0
-@enduml
-
-@startuml ICCery-UI-stage1-2
-title Stages 1–2 — Generate Target / Lay Out and Print
-skinparam classAttributeIconSize 0
-hide circle
-hide empty methods
-
-package "stage-1  Stage1View.swift" {
-  class "colourSpace" as csp <<Picker.segmented>> {
-    RGB | CMYK
-  }
-  class "patchCountPreset" as pcp <<Picker>> {
-    PatchCountPreset.allCases
-  }
-  class "patchCountCustom" as pcc <<TextField.number>> {
-    shown: patchPreset == .custom
-  }
-  class "whitePatches" as wp <<Stepper>> {
-    0...50
-  }
-  class "blackPatches" as bp <<Stepper>> {
-    0...50
-  }
-  class "targetBasename" as tb <<TextField>>
-  class "btnBrowse" as bb <<Button>> {
-    save panel; sets basename
-  }
-  class "btnSelectWorkDir" as wd <<Button>>
-  class "btnOpenExisting" as oe <<Button>> {
-    .ti1 or .ti2 (+ matching .ti1)
-  }
-  class "btn-import-dataset" as imp <<Button>> {
-    .ti3 / .txt / .cgats / .csv
-    unlocks stage 4
-  }
-  class "selectedPathDisplay" as spd <<Text>>
-  class "targenAdvancedDetails" as adv <<DisclosureGroup>> {
-    UI tests pre-expand
-  }
-  class "btnGenerate" as gen <<Button>> {
-    disabled: !canGenerate || targenRunning
-    canGenerate: valid basename AND directory
-    label Generating… while running
-  }
-  class "targenLogContainer / targenLog" as tlog <<DisclosureGroup>> {
-    ProcessLogView.swift
-  }
-}
-
-package "Advanced (hidden until disclosure open)" {
-  class "targenGreySteps" as ag <<Toggle+TextField>> {
-    field shown iff toggle on
-  }
-  class "targenSingleChannelSteps" as as1 <<Toggle+TextField>>
-  class "targenNeutralSteps" as an <<Toggle+TextField>>
-  class "targenNeutralConcentration" as anc <<Toggle+Slider>> {
-    0...1  shown iff on
-  }
-  class "targenAdaptation" as aa <<Toggle+Slider>> {
-    0...1
-  }
-  class "targenPrecondProfile" as ap <<TextField>>
-  class "btnBrowsePrecondProfile" as apb <<Button>>
-  class "targenHighQuality" as ahq <<Toggle>> {
-    OFPS -G
-  }
-  class "targenAlgorithm" as aal <<Picker>>
-  class "targenInkLimitGroup" as ail <<Toggle+TextField>> {
-    shown: colourSpace == cmyk
-  }
-  class "targenDarkEmphasis" as ad <<Toggle+Slider>> {
-    0...3
-  }
-  class "targenDevicePower" as adp <<Toggle+Slider>> {
-    0...3
-  }
-}
-adv --> ag
-
-package "stage-2  Stage2View.swift" {
-  class "cmWarningBanner" as cmw <<Banner>> {
-    always visible on stage 2
-    not a control
-  }
-  class "instrumentSelect" as ins <<Picker>> {
-    PrintInstrument — chart code, NOT USB port
-  }
-  class "pageSizeSelect" as pgs <<Picker>>
-  class "customPageSizeRow" as cps <<HStack>> {
-    shown: pageSize == .custom
-    customPageW / customPageH  mm
-  }
-  class "bitDepth" as bit <<Picker>> {
-    8-bit | 16-bit TIFF
-    (no a11y id on picker)
-  }
-  class "tiffDpi" as dpi <<Stepper>> {
-    72...600
-  }
-  class "printtargLayoutOrder" as lo <<Picker>>
-  class "printtargCustomSeedGroup" as seed <<HStack>> {
-    shown: layoutOrder == .customSeed
-    id printtargCustomSeed
-  }
-  class "btnToggleLabelEdit" as tle <<Button>> {
-    toggles labelIsCustom
-    title: Edit label… / Use automatic label
-  }
-  class "targetMetadataPrinter" as mp <<TextField>>
-  class "targetMetadataInkSet" as mi <<TextField>>
-  class "targetMetadataDriverPaper" as md <<TextField>>
-  class "targetMetadataActualPaper" as ma <<TextField>>
-  class "targetLabelPreview" as lpv <<TextField|Text>> {
-    TextField if labelIsCustom else Text(automatic)
-  }
-  class "btnCreateLayout" as lay <<Button>> {
-    disabled: printtargRunning || basename.empty
-  }
-  class "printtargLogContainer" as plog <<DisclosureGroup>>
-  class "tiffGallery" as gal <<Grid>> {
-    shown: printtargResult != nil
-    galleryInfo, galleryGrid
-    galleryPage-{index}
-    btnPrintPage-{index}
-    Print disabled: isPrinting || selectedPrinter.empty
-  }
-}
-
-package "rawPrintPanel" {
-  class "printerSelect" as ps <<Picker>> {
-    CUPS queues
-  }
-  class "printerStatusBadge" as psb <<Caption>> {
-    shown: selected printer in list
-  }
-  class "btnRefreshPrinters" as prf <<Button>>
-  class "btnPrinterProperties" as ppr <<Button>> {
-    disabled: selectedPrinter.empty
-    bound NSPrintPanel
-  }
-  class "printerTraySelect" as ptr <<Picker>> {
-    shown: trays nonempty
-  }
-  class "printerMediaTypeSelect" as pmt <<Picker>> {
-    shown: mediaTypes nonempty
-    also mediaTypeGroup
-  }
-  class "btnOrientPortrait" as por <<Button>>
-  class "btnOrientLandscape" as lan <<Button>>
-  class "btnPrintAll" as pal <<Button>> {
-    disabled: isPrinting
-             || printtargResult==nil
-             || selectedPrinter.empty
-  }
-  class "btnAdvanceToStage3" as a3 <<Button>> {
-    disabled: printtargResult==nil
-             || !isUnlocked(.measure)
-  }
-  class "printNotificationText" as pnt <<Caption>> {
-    shown: print.printNotice != nil
-  }
-}
-@enduml
-
-@startuml ICCery-UI-stage3-5-cal
-title Stages 3–5, Calibrate Printer, Measure transport
-skinparam classAttributeIconSize 0
-hide circle
-hide empty methods
-
-package "stage-3  Stage3View.swift / MeasurementWorkflowViewModel" {
-  class "btnDetectInstruments" as d3 <<Button>> {
-    disabled: !canDetect  (!isDetecting)
-  }
-  class "chartreadInstrumentSelect" as i3 <<Picker.menu>> {
-    Auto + instlist ports
-  }
-  class "xyTableHint" as xyh <<Caption>> {
-    shown: selectedInstrument.isXY
-  }
-  class "xyTablePanel" as xyp <<HStack>> {
-    shown: isXY
-    xyStepPlace / Align / Scan / Remove
-    highlight = xyStep
-  }
-  class "chartreadPrompt" as pr <<Text>>
-  class "chartreadLastError" as err <<Caption>> {
-    shown: chartreadNotice != nil
-  }
-  class "btnStartRead" as sr <<Button>> {
-    shown: !isChartreadRunning
-    disabled: !canStartRead
-    canStart: basename && cwd && !running
-  }
-  class "btnCalibrate" as cal3 <<Button>> {
-    shown: running && state==calibrating
-  }
-  class "btnTrigger" as trg <<Button>> {
-    shown: running && awaitingStrip
-  }
-  class "btnDoneReadEarly" as de <<Button>> {
-    shown: awaitingStrip
-  }
-  class "btnAccept" as acc <<Button>> {
-    shown: tablePlaceSheet | tableAlign
-           | promptContinue | warning
-    title Continue or Continue (send 'X')
-  }
-  class "btnRetry" as rty <<Button>> {
-    shown: state==error
-  }
-  class "btnDoneRead" as dn <<Button>> {
-    shown: allStripsRead
-  }
-  class "btnCancel" as cnc <<Button>> {
-    shown: isChartreadRunning
-  }
-  class "swatchGrid" as sw <<Scroll>> {
-    swatch-{rowId}{loc}
-  }
-  class "readStats" as rst <<Text>>
-  class "chartreadAveragingPanel" as avg <<Panel>> {
-    shown: passSnapshots nonempty OR isFinished
-    passCounterBadge, passesList
-  }
-  class "btnMeasureAnotherSheet" as mas <<Button>> {
-    disabled: !isFinished || isChartreadRunning
-  }
-  class "btnFinishAndAverage" as fa <<Button>> {
-    disabled: !canFinish || isFinishing
-    canFinish: isFinished && passes nonempty
-  }
-}
-
-package "stage-4  Stage4View.swift / ProfileWorkflowViewModel" {
-  class "colprofAlgorithm" as alg <<Picker>>
-  class "colprofQuality" as q <<Picker>>
-  class "colprofFwa" as fwa <<Picker>>
-  class "colprofFwaCustomPath" as fwap <<TextField>> {
-    shown: custom spectrum selected
-  }
-  class "btnBrowseFwaSp" as fwab <<Button>> {
-    shown with custom path
-  }
-  class "colprofIlluminant" as ill <<TextField>>
-  class "colprofObserver" as obs <<TextField>>
-  class "colprofInputViewCond" as ivc <<TextField>>
-  class "colprofOutputViewCond" as ovc <<TextField>>
-  class "colprofDescription" as desc <<TextField>>
-  class "colprofCopyright" as cpr <<TextField>>
-  class "colprofApplyCalibration" as ac <<Toggle>>
-  class "colprofCalibrationFile" as cf <<TextField>> {
-    shown: applyCalibration
-  }
-  class "btnBrowseCalibrationFile" as cfb <<Button>> {
-    shown: applyCalibration
-  }
-  class "btnCreateProfile" as cp <<Button>> {
-    disabled: !canCreateProfile
-    canCreate: basename && cwd && !colprofRunning
-  }
-  class "colprofProgressIndicator" as cpi <<Progress>> {
-    shown: isColprofRunning
-  }
-}
-
-package "stage-5  Stage5View.swift" {
-  class "btnVerifyProfile" as vf <<Button>> {
-    disabled: !canVerify
-    canVerify: createdProfileURL && !profcheckRunning
-  }
-  class "profcheckProgressIndicator" as ppi <<Progress>> {
-    shown: isProfcheckRunning
-  }
-  class "btnViewGamut" as vg5 <<Button>> {
-    DUPLICATE id with sidebar
-    disabled: createdGamutURL == nil
-  }
-  class "btnInstallProfile" as inst <<Button>> {
-    disabled: createdProfileURL == nil
-    may present collision alert
-  }
-  class "driftPrinterFilter" as df <<Picker>>
-  class "btnExportHistory" as eh <<Button>>
-  class "btnClearHistory" as ch <<Button>>
-  class "verificationHistoryTable" as ht <<Table>>
-  class "driftChart" as dc <<View>> {
-    DriftChartView.swift  not interactive
-  }
-  class "driftAlert / profcheckWarningBanner" as dalt <<Banner>> {
-    shown on fail / warning status
-  }
-}
-
-package "Install collision alert" {
-  class "profileOverwriteBtn" as io <<Button>>
-  class "profileRenameBtn" as ir <<Button>>
-  class "profileCancelCollisionBtn" as ic <<Button>> {
-    shown: showingInstallCollision
-    && settings.askBeforeOverwriteProfile
-  }
-}
-
-package "stage-cal  CalibrationView.swift  (Stage 0)" {
-  class "Colour Space" as ccs <<Picker.segmented>> {
-    RGB | CMYK  (no a11y id)
-  }
-  class "calSteps" as cst <<TextField.number>>
-  class "White patches" as cwp <<TextField.number>> {
-    no a11y id
-  }
-  class "calInkExplore" as cin <<TextField>> {
-    shown: colourSpace == cmyk
-  }
-  class "calNeutralEmphasis" as cne <<Toggle.checkbox>>
-  class "btnCalGenerate" as cg <<Button>> {
-    disabled: basename.empty || cwd==nil || isGenerating
-  }
-  class "btnCalLayout" as cl <<Button>> {
-    same disable as Generate
-  }
-  class "btnCalMeasure" as cm <<Button>> {
-    disabled: calibrationTi3URL == nil
-  }
-  class "btnCalCompute" as cc <<Button>> {
-    disabled: !canCompute
-    canCompute: .ti3 exists && !isComputing
-  }
-  class "calApplyToggle" as cat <<Toggle>> {
-    shown: computedCalURL != nil
-  }
-  class "btnCalReturn" as cr <<Button>> {
-    Esc / cancelAction
-    restores original basename
-  }
-}
-@enduml
-
-@startuml ICCery-UI-sheets
-title Sheets, dialogs, Spot Read, Gamut, Settings
-skinparam classAttributeIconSize 0
-hide circle
-hide empty methods
-
-package "SettingsView.swift  sheet from openSettingsBtn" {
-  class "Argyll dir" as ad <<TextField+Browse>> {
-    empty => bundled sidecars
-  }
-  class "Default instrument" as di <<Picker>> {
-    None + i1/p3/CM/SS/20/22/41/51
-    seeds Stage 3 + Spot Read
-    does NOT change instrumentSelect
-  }
-  class "Enable i1Pro 2 LEDs" as led <<Toggle>>
-  class "settingsDeltaEGood" as dg <<TextField.number>>
-  class "settingsDeltaEWarning" as dw <<TextField.number>> {
-    Save refuses unless Warning > Good
-  }
-  class "settingsCalStaleDays" as sd <<TextField.number>>
-  class "Install location" as il <<Picker>> {
-    User | System library
-  }
-  class "Ask before overwriting" as ao <<Toggle>>
-  class "Open ColorSync after install" as oc <<Toggle>>
-  class "Log level" as ll <<Picker>>
-  class "Open log folder / Copy path / Copy excerpt" as lg <<Button x3>>
-  class "Cancel / Save" as ss <<Button>> {
-    Save stays on sheet if validation fails
-    frame 560x620
-  }
-}
-
-package "AboutView.swift" {
-  class "aboutDialog" as ab <<Sheet>> {
-    aboutVersion, aboutBuildDate
-    closeAboutBtn  Esc
-  }
-}
-
-package "savePresetDialog  PresetDialogs.swift" {
-  class "savePresetName" as spn <<TextField>>
-  class "savePresetDesc" as spd <<TextField>>
-  class "btnCloseSavePresetDialog" as spc <<Button>>
-  class "btnConfirmSavePreset" as sps <<Button>> {
-    disabled: name trimmed empty
-  }
-}
-
-package "managePresetsDialog" {
-  class "presetRow-{id}" as prw <<Row>> {
-    Built-in: no delete
-    else btnExportPreset-{id} btnDeletePreset-{id}
-  }
-  class "btnImportPreset" as pim <<Button>>
-  class "btnExportActivePreset" as pea <<Button>> {
-    shown: selected custom preset
-  }
-  class "btnCloseManagePresetsDialog" as pcl <<Button>>
-}
-
-package "saveMediaRecipeDialog  MediaLibraryDialogs.swift" {
-  class "saveMediaName/Notes/Paper/Ink" as smf <<TextField x4>>
-  class "saveMediaPrinter/Preset/ColourSpace/Cal" as smr <<read-only>>
-  class "saveMediaApplyCal" as smc <<Toggle>> {
-    disabled: !calApplyable
-    calApplyable: path exists, not CAL_ stem
-  }
-  class "btnCloseSaveMediaDialog" as smx <<Button>>
-  class "btnConfirmSaveMedia" as sms <<Button>> {
-    disabled: name|paper|ink empty
-             OR captureColourSpaceMismatch
-  }
-}
-
-package "manageMediaDialog" {
-  class "mediaLibraryList" as mll <<List>> {
-    mediaRow-{id}
-    btnMediaLibraryApply-{id}
-    btnMediaLibraryDelete-{id}
-    double-click row = Apply
-  }
-  class "manageMediaNotice" as mmn <<Caption>> {
-    shown: manageApplyNotice != nil
-    in-sheet copy of failed Apply (#170)
-  }
-  class "btnMediaLibraryApply" as mla <<Button>> {
-    Apply selected
-    disabled: selection == nil
-  }
-  class "btnMediaLibraryCaptureFromManage" as mlc <<Button>> {
-    dismiss then open capture
-  }
-  class "btnCloseManageMediaDialog" as mlx <<Button>>
-  class "Delete alert" as mld <<alert>> {
-    Cancel / Delete
-  }
-}
-
-package "spotReadView  SpotReadView.swift  (#148)" {
-  class "spotSidecarMissing" as ssm <<Text>> {
-    shown: !sidecarAvailable
-    hides instrument/transport
-  }
-  class "btnSpotDetectInstruments" as sdet <<Button>> {
-    disabled: !canDetect  (detecting or running)
-  }
-  class "spotInstrumentSelect" as sis <<Picker>> {
-    disabled: isRunning
-  }
-  class "spotDefaultMissing" as sdm <<Caption>> {
-    shown: defaultMissing
-  }
-  class "spotSetDefault" as ssd <<Toggle>>
-  class "spotXYHint" as sxy <<Caption>> {
-    shown: selected is XY table
-  }
-  class "btnSpotStart" as sst <<Button>> {
-    shown: !isRunning
-    disabled: !canStart
-    canStart: sidecar && !detecting && !running
-              && !chartreadRunning && cwd
-  }
-  class "btnSpotCalibrate" as sca <<Button>> {
-    shown: running && calibrating
-  }
-  class "btnSpotTrigger" as str <<Button>> {
-    shown: running && awaitingStrip  (Read)
-  }
-  class "btnSpotStop" as ssp <<Button>> {
-    shown: isRunning
-  }
-  class "spotLastSample / Lab / XYZ / DeltaE" as sls <<Display>> {
-    spotLabImplausible if L not in 0...100
-    spotDeltaE hidden on first sample
-  }
-  class "spotHistoryTable" as sht <<List>> {
-    rows are buttons spotHistoryRow-{uuid}
-    click restores last sample, no trigger
-  }
-  class "btnSpotCopyLab" as scp <<Button>> {
-    disabled: displayedSample == nil
-  }
-  class "btnSpotExportCsv" as sex <<Button>> {
-    disabled: samples.isEmpty
-  }
-  class "btnCloseSpotRead" as scl <<Button>> {
-    Esc; onDismiss = Stop
-  }
-}
-
-package "gamutView  GamutView.swift  (#147)" {
-  class "gamutLayer-srgb" as gls <<Toggle.checkbox>> {
-    sRGB always loaded; can hide; cannot remove
-  }
-  class "gamutLayer-profile" as glp <<Toggle>> {
-    disabled: no session .gam
-  }
-  class "gamutLayer-compare" as glc <<Toggle>> {
-    disabled: no compare layer
-  }
-  class "btnGamutAddCompare" as gac <<Menu>> {
-    btnGamutOpenGam / btnGamutOpenProfile
-  }
-  class "btnGamutRemoveCompare" as grc <<Button>> {
-    disabled: compare layer nil
-  }
-  class "btnGamutSampleTiff" as gst <<Button>>
-  class "gamutViewerUnavailable" as gun <<Caption>> {
-    shown: no Metal / SCNView failed
-    toggles + inspect still enabled
-  }
-  class "btnResetGamutCamera" as grs <<Button>> {
-    R when focused
-  }
-  class "gamutLabEntryL/A/B" as gle <<TextField x3>>
-  class "btnGamutInspectLab" as gin <<Button>> {
-    disabled: !canInspectLab
-  }
-  class "gamutInspectPanel" as gip <<Panel>>
-  class "btnCloseGamut" as gcl <<Button>> {
-    Esc
-  }
-  class "gamutTiffPreview sheet" as gtf <<Sheet>> {
-    showingTiffPreview
-    click pixel; btnCloseGamutTiffPreview
-  }
-}
-
-package "Project alerts / relocate  RootView + ProjectUI" {
-  class "projectNewAlert" as pna <<alert>> {
-    btnProjectNewCancel / btnProjectNewConfirm
-  }
-  class "Dirty save alert" as pda <<alert>> {
-    btnProjectDirtySave
-    btnProjectDirtyDiscard
-    btnProjectDirtyCancel
-    shown when New/Open/Close and dirty
-  }
-  class "projectRelocateSheet" as prs <<Sheet>> {
-    shown: cwd missing on Open
-    btnProjectRelocateCancel
-    btnProjectRelocate  Choose Folder…
-  }
-}
-
-note as nMutex
-  Mutex / exclusive
-  Spot Read disabled while Stage 3 chartread runs
-  Opening Spot Read never kills chartread_{basename}
-  Calibrate uses temporary CAL_ basename; Save Project stays
-  enabled so the refusal banner can fire; chip Save uses canSave
-  Failed media Apply keeps manageMediaDialog open
-  Window noticeText is occluded by that sheet — use manageMediaNotice
-end note
-@enduml
-- 
2.39.5


From 658d9813bdaa2acf46371af6dae4a8030dafc754 Mon Sep 17 00:00:00 2001
From: gronod <gronod@users.noreply.git.i3omb.com>
Date: Mon, 14 Sep 2026 14:25:35 +0000
Subject: [PATCH 3/8] docs: render UI maps with GraphViz for Kroki 0.30.1
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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.
---
 docs/ui-interactive-map-sheets.dot       | 107 ++++++
 docs/ui-interactive-map-shell.dot        | 110 ++++++
 docs/ui-interactive-map-stage1-2.dot     |  77 +++++
 docs/ui-interactive-map-stage3-5-cal.dot |  85 +++++
 docs/ui-interactive-map.md               | 411 +++++++++++++++++++++++
 5 files changed, 790 insertions(+)
 create mode 100644 docs/ui-interactive-map-sheets.dot
 create mode 100644 docs/ui-interactive-map-shell.dot
 create mode 100644 docs/ui-interactive-map-stage1-2.dot
 create mode 100644 docs/ui-interactive-map-stage3-5-cal.dot
 create mode 100644 docs/ui-interactive-map.md

diff --git a/docs/ui-interactive-map-sheets.dot b/docs/ui-interactive-map-sheets.dot
new file mode 100644
index 0000000..a497d6e
--- /dev/null
+++ b/docs/ui-interactive-map-sheets.dot
@@ -0,0 +1,107 @@
+digraph ICCeryUISheets {
+  graph [label="ICCery UI — sheets, Spot Read, Gamut, Settings, project alerts",
+         labelloc=t, fontsize=14, fontname="Helvetica"]
+  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
+  edge [fontname="Helvetica", fontsize=8]
+
+  subgraph cluster_set {
+    label="SettingsView.swift  (openSettingsBtn)"
+    ad [label="Argyll dir  TextField+Browse\nempty => bundled sidecars"]
+    di [label="Default instrument  Picker\nNone + i1/p3/CM/SS/20/22/41/51\nseeds Stage 3 + Spot Read\ndoes NOT change instrumentSelect"]
+    led [label="Enable i1Pro 2 LEDs  Toggle"]
+    dg [label="settingsDeltaEGood  TextField"]
+    dw [label="settingsDeltaEWarning  TextField\nSave refuses unless Warning > Good"]
+    sd [label="settingsCalStaleDays  TextField"]
+    il [label="Install location  Picker\nUser | System library"]
+    ao [label="Ask before overwriting  Toggle"]
+    oc [label="Open ColorSync after install  Toggle"]
+    ll [label="Log level  Picker"]
+    lg [label="Open log folder / Copy path / Copy excerpt"]
+    ss [label="Cancel / Save\nSave stays if validation fails\nframe 560x620"]
+  }
+
+  subgraph cluster_about {
+    label="AboutView.swift"
+    ab [label="aboutDialog\naboutVersion, aboutBuildDate\ncloseAboutBtn  Esc"]
+  }
+
+  subgraph cluster_sp {
+    label="savePresetDialog  PresetDialogs.swift"
+    spn [label="savePresetName  TextField"]
+    spd [label="savePresetDesc  TextField"]
+    spc [label="btnCloseSavePresetDialog"]
+    sps [label="btnConfirmSavePreset\ndisabled: name trimmed empty"]
+  }
+
+  subgraph cluster_mp {
+    label="managePresetsDialog"
+    prw [label="presetRow-{id}\nBuilt-in: no delete\nelse btnExportPreset-{id}\nbtnDeletePreset-{id}"]
+    pim [label="btnImportPreset"]
+    pea [label="btnExportActivePreset\nshown: selected custom preset"]
+    pcl [label="btnCloseManagePresetsDialog"]
+  }
+
+  subgraph cluster_sm {
+    label="saveMediaRecipeDialog  MediaLibraryDialogs.swift"
+    smf [label="saveMediaName/Notes/Paper/Ink  TextField x4"]
+    smr [label="saveMediaPrinter/Preset/ColourSpace/Cal  read-only"]
+    smc [label="saveMediaApplyCal  Toggle\ndisabled: !calApplyable\ncalApplyable: path exists, not CAL_"]
+    smx [label="btnCloseSaveMediaDialog"]
+    sms [label="btnConfirmSaveMedia\ndisabled: name|paper|ink empty\nOR colour-space mismatch"]
+  }
+
+  subgraph cluster_mm {
+    label="manageMediaDialog"
+    mll [label="mediaLibraryList\nmediaRow-{id}\nbtnMediaLibraryApply-{id}\nbtnMediaLibraryDelete-{id}\ndouble-click = Apply"]
+    mmn [label="manageMediaNotice  Caption\nshown: manageApplyNotice != nil\nin-sheet copy of failed Apply (#170)"]
+    mla [label="btnMediaLibraryApply\ndisabled: selection == nil"]
+    mlc [label="btnMediaLibraryCaptureFromManage\ndismiss then open capture"]
+    mlx [label="btnCloseManageMediaDialog"]
+    mld [label="Delete alert  Cancel / Delete"]
+  }
+
+  subgraph cluster_spot {
+    label="spotReadView  SpotReadView.swift (#148)"
+    ssm [label="spotSidecarMissing\nshown: !sidecarAvailable\nhides instrument/transport"]
+    sdet [label="btnSpotDetectInstruments\ndisabled: detecting OR running"]
+    sis [label="spotInstrumentSelect  Picker\ndisabled: isRunning"]
+    sdm [label="spotDefaultMissing\nshown: defaultMissing"]
+    ssd [label="spotSetDefault  Toggle"]
+    sxy [label="spotXYHint  shown: selected is XY"]
+    sst [label="btnSpotStart\nshown: !isRunning\ndisabled: !canStart\ncanStart: sidecar, !detecting, !running,\n!chartreadRunning, cwd"]
+    sca [label="btnSpotCalibrate\nshown: running AND calibrating"]
+    str [label="btnSpotTrigger  Read\nshown: running AND awaitingStrip"]
+    ssp [label="btnSpotStop  shown: isRunning"]
+    sls [label="spotLastSample / Lab / XYZ / DeltaE\nspotLabImplausible if L not 0..100\nspotDeltaE hidden on first sample"]
+    sht [label="spotHistoryTable\nrows: spotHistoryRow-{uuid}\nclick restores sample, no trigger"]
+    scp [label="btnSpotCopyLab\ndisabled: displayedSample == nil"]
+    sex [label="btnSpotExportCsv\ndisabled: samples empty"]
+    scl [label="btnCloseSpotRead  Esc; onDismiss = Stop"]
+  }
+
+  subgraph cluster_gamut {
+    label="gamutView  GamutView.swift (#147)"
+    gls [label="gamutLayer-srgb  Toggle\nsRGB always loaded; can hide"]
+    glp [label="gamutLayer-profile  Toggle\ndisabled: no session .gam"]
+    glc [label="gamutLayer-compare  Toggle\ndisabled: no compare layer"]
+    gac [label="btnGamutAddCompare  Menu\nbtnGamutOpenGam / btnGamutOpenProfile"]
+    grc [label="btnGamutRemoveCompare\ndisabled: compare layer nil"]
+    gst [label="btnGamutSampleTiff"]
+    gun [label="gamutViewerUnavailable\nshown: no Metal\ntoggles + inspect still enabled"]
+    grs [label="btnResetGamutCamera  R"]
+    gle [label="gamutLabEntryL/A/B  TextField x3"]
+    gin [label="btnGamutInspectLab\ndisabled: !canInspectLab"]
+    gip [label="gamutInspectPanel"]
+    gcl [label="btnCloseGamut  Esc"]
+    gtf [label="gamutTiffPreview sheet\nshowingTiffPreview\nbtnCloseGamutTiffPreview"]
+  }
+
+  subgraph cluster_proj {
+    label="Project alerts  RootView + ProjectUI"
+    pna [label="projectNewAlert\nbtnProjectNewCancel / Confirm"]
+    pda [label="Dirty save alert\nbtnProjectDirtySave\nbtnProjectDirtyDiscard\nbtnProjectDirtyCancel"]
+    prs [label="projectRelocateSheet\nshown: cwd missing on Open\nbtnProjectRelocateCancel\nbtnProjectRelocate"]
+  }
+
+  mutex [shape=note, label="Mutex\nSpot Read disabled while Stage 3 chartread runs\nOpening Spot Read never kills chartread_{basename}\nFailed media Apply keeps manage sheet open\nWindow noticeText is occluded — use manageMediaNotice"]
+}
diff --git a/docs/ui-interactive-map-shell.dot b/docs/ui-interactive-map-shell.dot
new file mode 100644
index 0000000..093c6ef
--- /dev/null
+++ b/docs/ui-interactive-map-shell.dot
@@ -0,0 +1,110 @@
+digraph ICCeryUIShell {
+  graph [label="ICCery UI — shell, sidebar, stepper, File menu\nids are accessibility identifiers. Gating: WizardGating.swift",
+         labelloc=t, fontsize=14, fontname="Helvetica"]
+  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
+  edge [fontname="Helvetica", fontsize=8]
+
+  win [label="WindowGroup ICCery\nICCeryApp.swift\n1280x800, min 1100x700"]
+  root [label="RootView.swift\nsheets and alerts live here"]
+  win -> root
+
+  subgraph cluster_chrome {
+    label="Persistent chrome"
+    side [label="SidebarView.swift\n270 pt"]
+    ban [label="noticeText  NoticeBanner.swift\nshown: wizard.notice != nil\nauto-hide 6s; close has no id"]
+    stage [label="WizardStageContent\nswitch wizard.stage"]
+  }
+  root -> side
+  root -> ban
+  root -> stage
+
+  subgraph cluster_header {
+    label="Header"
+    sSet [label="openSettingsBtn  Button\nalways on → Settings sheet"]
+    sAbt [label="openAboutBtn  Button\nalways on → About"]
+    sHlp [label="btnToggleAllHelp  Button\ntoggles showingAllHelp overlays"]
+  }
+  side -> sSet
+  side -> sAbt
+  side -> sHlp
+
+  subgraph cluster_preset {
+    label="Presets (#11)"
+    pre [label="presetSelect  Picker.menu\nnone + ProfilingPreset.id\napply on change; none is not factory reset"]
+    preS [label="btnSavePresetModal  Button\nalways on"]
+    preM [label="btnOpenPresetsDialog  Button\nalways on"]
+  }
+  side -> pre
+  side -> preS
+  side -> preM
+
+  subgraph cluster_media {
+    label="Media library (#146)"
+    med [label="mediaSelect  Picker.menu\nnone + MediaRecipe.id\nnever reuses presetSelect"]
+    medSt [label="mediaRecipeStale  Caption\nshown: staleReasons nonempty"]
+    medC [label="btnMediaLibraryCapture  Button\ndisabled: selectedPrinter empty"]
+    medM [label="btnMediaLibraryManage  Button\nalways on"]
+  }
+  side -> med
+  side -> medSt
+  side -> medC
+  side -> medM
+
+  subgraph cluster_studio {
+    label="Studio (not stepper)"
+    calB [label="btnCalibratePrinter  Button\nalways on; Stage 0"]
+    gamB [label="btnViewGamut  Button\nSAME id as Stage 5\nalways on; no .gam = sRGB only"]
+    spotB [label="btnSpotRead  Button\ndisabled: no cwd OR chartread running"]
+  }
+  side -> calB
+  side -> gamB
+  side -> spotB
+
+  subgraph cluster_step {
+    label="Stepper 1-5 (disk is truth)"
+    step [label="StepperRow  Button.plain\ndisabled/opacity 0.45 unless isUnlocked\nbackward always; calibrate is not a row"]
+    nGate [shape=note, label="WizardGating.swift\n1 always\n2 .ti1\n3 .ti1 AND .ti2\n4 .ti3 (not .ti2 alone)\n5 .ti3 AND .icc/.icm\nre-probe on window key (#151)"]
+  }
+  side -> step
+  step -> nGate [style=dashed]
+
+  subgraph cluster_chip {
+    label="projectChip  ProjectUI.swift (#149)"
+    cn [label="projectChipName\nbound name or No project"]
+    cp [label="projectChipPath\nshown if bound"]
+    cs [label="projectChipStale\nshown: diskBehindNotes"]
+    cr [label="btnProjectReveal\nshown if bound"]
+    csv [label="btnProjectSave\nshown if bound\ndisabled: !canSave\ncanSave: bound + basename + cwd\nCAL_ still enabled (refusal banner)"]
+    co [label="btnProjectOpen\nshown if NOT bound"]
+  }
+  side -> cn
+  side -> cp
+  side -> cs
+  side -> cr
+  side -> csv
+  side -> co
+
+  subgraph cluster_menu {
+    label="File menu  ProjectCommands / ICCeryApp.swift"
+    mN [label="menuProjectNew  Cmd-N"]
+    mO [label="menuProjectOpen  Cmd-O"]
+    mR [label="menuProjectRecents  Menu\ndisabled: recents empty\nprojectRecent-{hash}\nmenuProjectRecentsClear"]
+    mS [label="menuProjectSave  Cmd-S\ndisabled: !canSave"]
+    mSa [label="menuProjectSaveAs  Shift-Cmd-S\ndisabled: !canSaveAs\ncanSaveAs: basename + cwd"]
+    mRp [label="menuProjectReport\ndisabled: !canReport"]
+    mCl [label="menuProjectClose\ndisabled: !isBound"]
+  }
+
+  st1 [label="stage-1  Stage1View.swift"]
+  st2 [label="stage-2  Stage2View.swift"]
+  st3 [label="stage-3  Stage3View.swift"]
+  st4 [label="stage-4  Stage4View.swift"]
+  st5 [label="stage-5  Stage5View.swift"]
+  st0 [label="stage-cal  CalibrationView.swift"]
+  stage -> st1
+  stage -> st2
+  stage -> st3
+  stage -> st4
+  stage -> st5
+  stage -> st0
+}
diff --git a/docs/ui-interactive-map-stage1-2.dot b/docs/ui-interactive-map-stage1-2.dot
new file mode 100644
index 0000000..5a4872e
--- /dev/null
+++ b/docs/ui-interactive-map-stage1-2.dot
@@ -0,0 +1,77 @@
+digraph ICCeryUIStage12 {
+  graph [label="ICCery UI — Stage 1 Generate Target / Stage 2 Lay Out and Print",
+         labelloc=t, fontsize=14, fontname="Helvetica"]
+  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
+  edge [fontname="Helvetica", fontsize=8]
+
+  subgraph cluster_s1 {
+    label="stage-1  Stage1View.swift"
+    csp [label="colourSpace  Picker.segmented\nRGB | CMYK"]
+    pcp [label="patchCountPreset  Picker"]
+    pcc [label="patchCountCustom  TextField.number\nshown: patchPreset == custom"]
+    wp [label="whitePatches  Stepper  0..50"]
+    bp [label="blackPatches  Stepper  0..50"]
+    tb [label="targetBasename  TextField"]
+    bb [label="btnBrowse  Button"]
+    wd [label="btnSelectWorkDir  Button"]
+    oe [label="btnOpenExisting  Button\n.ti1 or .ti2 (+ matching .ti1)"]
+    imp [label="btn-import-dataset  Button\n.ti3 / txt / cgats / csv\nunlocks stage 4"]
+    spd [label="selectedPathDisplay  Text"]
+    adv [label="targenAdvancedDetails  DisclosureGroup\nUI tests pre-expand"]
+    gen [label="btnGenerate  Button\ndisabled: !canGenerate OR targenRunning\ncanGenerate: valid basename AND directory"]
+    tlog [label="targenLogContainer / targenLog\nProcessLogView.swift"]
+  }
+
+  subgraph cluster_adv {
+    label="Advanced (hidden until disclosure open)"
+    ag [label="targenGreySteps  Toggle+TextField\nfield iff toggle on"]
+    as1 [label="targenSingleChannelSteps  Toggle+TextField"]
+    an [label="targenNeutralSteps  Toggle+TextField"]
+    anc [label="targenNeutralConcentration  Toggle+Slider 0..1"]
+    aa [label="targenAdaptation  Toggle+Slider 0..1"]
+    ap [label="targenPrecondProfile  TextField"]
+    apb [label="btnBrowsePrecondProfile  Button"]
+    ahq [label="targenHighQuality  Toggle  OFPS -G"]
+    aal [label="targenAlgorithm  Picker"]
+    ail [label="targenInkLimitGroup  Toggle+TextField\nshown: colourSpace == cmyk"]
+    ad [label="targenDarkEmphasis  Toggle+Slider 0..3"]
+    adp [label="targenDevicePower  Toggle+Slider 0..3"]
+  }
+  adv -> ag [style=dashed]
+
+  subgraph cluster_s2 {
+    label="stage-2  Stage2View.swift"
+    cmw [label="cmWarningBanner  always visible, not a control"]
+    ins [label="instrumentSelect  Picker\nPrintInstrument chart code, NOT USB port"]
+    pgs [label="pageSizeSelect  Picker"]
+    cps [label="customPageSizeRow\nshown: pageSize == custom\ncustomPageW / customPageH mm"]
+    bit [label="bitDepth  Picker  8-bit | 16-bit\n(no a11y id on picker)"]
+    dpi [label="tiffDpi  Stepper  72..600"]
+    lo [label="printtargLayoutOrder  Picker"]
+    seed [label="printtargCustomSeedGroup\nshown: layoutOrder == customSeed\nid printtargCustomSeed"]
+    tle [label="btnToggleLabelEdit  Button\nEdit label / Use automatic"]
+    mp [label="targetMetadataPrinter  TextField"]
+    mi [label="targetMetadataInkSet  TextField"]
+    md [label="targetMetadataDriverPaper  TextField"]
+    ma [label="targetMetadataActualPaper  TextField"]
+    lpv [label="targetLabelPreview  TextField or Text\nTextField iff labelIsCustom"]
+    lay [label="btnCreateLayout  Button\ndisabled: printtargRunning OR basename empty"]
+    plog [label="printtargLogContainer  DisclosureGroup"]
+    gal [label="tiffGallery  shown: printtargResult != nil\ngalleryInfo, galleryGrid\ngalleryPage-{index}\nbtnPrintPage-{index}\nPrint disabled: isPrinting OR no printer"]
+  }
+
+  subgraph cluster_print {
+    label="rawPrintPanel"
+    ps [label="printerSelect  Picker  CUPS queues"]
+    psb [label="printerStatusBadge\nshown: selected printer in list"]
+    prf [label="btnRefreshPrinters  Button"]
+    ppr [label="btnPrinterProperties  Button\ndisabled: selectedPrinter empty"]
+    ptr [label="printerTraySelect  Picker\nshown: trays nonempty"]
+    pmt [label="printerMediaTypeSelect  Picker\nshown: mediaTypes nonempty"]
+    por [label="btnOrientPortrait  Button"]
+    lan [label="btnOrientLandscape  Button"]
+    pal [label="btnPrintAll  Button\ndisabled: isPrinting OR no result OR no printer"]
+    a3 [label="btnAdvanceToStage3  Button\ndisabled: no result OR !isUnlocked(measure)"]
+    pnt [label="printNotificationText\nshown: printNotice != nil"]
+  }
+}
diff --git a/docs/ui-interactive-map-stage3-5-cal.dot b/docs/ui-interactive-map-stage3-5-cal.dot
new file mode 100644
index 0000000..5ac2d89
--- /dev/null
+++ b/docs/ui-interactive-map-stage3-5-cal.dot
@@ -0,0 +1,85 @@
+digraph ICCeryUIStage345Cal {
+  graph [label="ICCery UI — Stage 3 Measure / 4 Build / 5 Verify / Stage 0 Calibrate",
+         labelloc=t, fontsize=14, fontname="Helvetica"]
+  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
+  edge [fontname="Helvetica", fontsize=8]
+
+  subgraph cluster_s3 {
+    label="stage-3  Stage3View.swift / MeasurementWorkflowViewModel"
+    d3 [label="btnDetectInstruments  Button\ndisabled: isDetecting"]
+    i3 [label="chartreadInstrumentSelect  Picker.menu\nAuto + instlist ports"]
+    xyh [label="xyTableHint  Caption\nshown: selected is XY"]
+    xyp [label="xyTablePanel  shown: isXY\nxyStepPlace Align Scan Remove"]
+    pr [label="chartreadPrompt  Text"]
+    err [label="chartreadLastError  Caption\nshown: chartreadNotice != nil"]
+    sr [label="btnStartRead  Button\nshown: !running\ndisabled: !canStartRead\ncanStart: basename AND cwd AND !running"]
+    cal3 [label="btnCalibrate  Button\nshown: running AND calibrating"]
+    trg [label="btnTrigger  Button\nshown: running AND awaitingStrip"]
+    de [label="btnDoneReadEarly  Button\nshown: awaitingStrip"]
+    acc [label="btnAccept  Button\nshown: place | align | continue | warning"]
+    rty [label="btnRetry  Button\nshown: state == error"]
+    dn [label="btnDoneRead  Button\nshown: allStripsRead"]
+    cnc [label="btnCancel  Button\nshown: isChartreadRunning"]
+    sw [label="swatchGrid  swatch-{rowId}{loc}"]
+    rst [label="readStats  Text"]
+    avg [label="chartreadAveragingPanel\nshown: passes nonempty OR isFinished"]
+    mas [label="btnMeasureAnotherSheet  Button\ndisabled: !isFinished OR running"]
+    fa [label="btnFinishAndAverage  Button\ndisabled: !canFinish OR isFinishing\ncanFinish: isFinished AND passes nonempty"]
+  }
+
+  subgraph cluster_s4 {
+    label="stage-4  Stage4View.swift / ProfileWorkflowViewModel"
+    alg [label="colprofAlgorithm  Picker"]
+    q [label="colprofQuality  Picker"]
+    fwa [label="colprofFwa  Picker"]
+    fwap [label="colprofFwaCustomPath  TextField\nshown: custom spectrum"]
+    fwab [label="btnBrowseFwaSp  Button\nshown with custom path"]
+    ill [label="colprofIlluminant  TextField"]
+    obs [label="colprofObserver  TextField"]
+    ivc [label="colprofInputViewCond  TextField"]
+    ovc [label="colprofOutputViewCond  TextField"]
+    desc [label="colprofDescription  TextField"]
+    cpr [label="colprofCopyright  TextField"]
+    ac [label="colprofApplyCalibration  Toggle"]
+    cf [label="colprofCalibrationFile  TextField\nshown: applyCalibration"]
+    cfb [label="btnBrowseCalibrationFile  Button\nshown: applyCalibration"]
+    cp [label="btnCreateProfile  Button\ndisabled: !canCreateProfile\ncanCreate: basename AND cwd AND !colprofRunning"]
+    cpi [label="colprofProgressIndicator\nshown: isColprofRunning"]
+  }
+
+  subgraph cluster_s5 {
+    label="stage-5  Stage5View.swift"
+    vf [label="btnVerifyProfile  Button\ndisabled: !canVerify\ncanVerify: createdProfileURL AND !profcheckRunning"]
+    ppi [label="profcheckProgressIndicator\nshown: isProfcheckRunning"]
+    vg5 [label="btnViewGamut  Button\nDUPLICATE id with sidebar\ndisabled: createdGamutURL == nil"]
+    inst [label="btnInstallProfile  Button\ndisabled: createdProfileURL == nil"]
+    df [label="driftPrinterFilter  Picker"]
+    eh [label="btnExportHistory  Button"]
+    ch [label="btnClearHistory  Button"]
+    ht [label="verificationHistoryTable"]
+    dc [label="driftChart  DriftChartView.swift\nnot interactive"]
+    dalt [label="driftAlert / profcheckWarningBanner\nshown on fail / warning"]
+  }
+
+  subgraph cluster_coll {
+    label="Install collision alert"
+    io [label="profileOverwriteBtn"]
+    ir [label="profileRenameBtn"]
+    ic [label="profileCancelCollisionBtn\nshown: showingInstallCollision\nAND askBeforeOverwriteProfile"]
+  }
+
+  subgraph cluster_cal {
+    label="stage-cal  CalibrationView.swift (Stage 0)"
+    ccs [label="Colour Space  Picker.segmented\nRGB | CMYK  (no a11y id)"]
+    cst [label="calSteps  TextField.number"]
+    cwp [label="White patches  TextField.number\n(no a11y id)"]
+    cin [label="calInkExplore  TextField\nshown: colourSpace == cmyk"]
+    cne [label="calNeutralEmphasis  Toggle.checkbox"]
+    cg [label="btnCalGenerate  Button\ndisabled: empty basename OR no cwd OR isGenerating"]
+    cl [label="btnCalLayout  Button\nsame disable as Generate"]
+    cm [label="btnCalMeasure  Button\ndisabled: calibrationTi3URL == nil"]
+    cc [label="btnCalCompute  Button\ndisabled: !canCompute\ncanCompute: .ti3 exists AND !isComputing"]
+    cat [label="calApplyToggle  Toggle\nshown: computedCalURL != nil"]
+    cr [label="btnCalReturn  Button  Esc\nrestores original basename"]
+  }
+}
diff --git a/docs/ui-interactive-map.md b/docs/ui-interactive-map.md
new file mode 100644
index 0000000..4a250c8
--- /dev/null
+++ b/docs/ui-interactive-map.md
@@ -0,0 +1,411 @@
+# Interactive UI map
+One GraphViz diagram per section so Gitea Kroki (0.30.1) can render them.
+These are **GraphViz**, not PlantUML: Kroki 0.30.1 ships PlantUML as a GraalVM native image that requires AVX2. This host does not have AVX2, so PlantUML returns 400 / SIGILL. `dot` in the same image does not.
+Node labels are accessibility identifiers, source files, and enable / hide / disable rules.
+
+## Shell
+
+Window, sidebar, stepper, File menu. Source: [`ui-interactive-map-shell.dot`](ui-interactive-map-shell.dot)
+
+```graphviz
+digraph ICCeryUIShell {
+  graph [label="ICCery UI — shell, sidebar, stepper, File menu\nids are accessibility identifiers. Gating: WizardGating.swift",
+         labelloc=t, fontsize=14, fontname="Helvetica"]
+  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
+  edge [fontname="Helvetica", fontsize=8]
+
+  win [label="WindowGroup ICCery\nICCeryApp.swift\n1280x800, min 1100x700"]
+  root [label="RootView.swift\nsheets and alerts live here"]
+  win -> root
+
+  subgraph cluster_chrome {
+    label="Persistent chrome"
+    side [label="SidebarView.swift\n270 pt"]
+    ban [label="noticeText  NoticeBanner.swift\nshown: wizard.notice != nil\nauto-hide 6s; close has no id"]
+    stage [label="WizardStageContent\nswitch wizard.stage"]
+  }
+  root -> side
+  root -> ban
+  root -> stage
+
+  subgraph cluster_header {
+    label="Header"
+    sSet [label="openSettingsBtn  Button\nalways on → Settings sheet"]
+    sAbt [label="openAboutBtn  Button\nalways on → About"]
+    sHlp [label="btnToggleAllHelp  Button\ntoggles showingAllHelp overlays"]
+  }
+  side -> sSet
+  side -> sAbt
+  side -> sHlp
+
+  subgraph cluster_preset {
+    label="Presets (#11)"
+    pre [label="presetSelect  Picker.menu\nnone + ProfilingPreset.id\napply on change; none is not factory reset"]
+    preS [label="btnSavePresetModal  Button\nalways on"]
+    preM [label="btnOpenPresetsDialog  Button\nalways on"]
+  }
+  side -> pre
+  side -> preS
+  side -> preM
+
+  subgraph cluster_media {
+    label="Media library (#146)"
+    med [label="mediaSelect  Picker.menu\nnone + MediaRecipe.id\nnever reuses presetSelect"]
+    medSt [label="mediaRecipeStale  Caption\nshown: staleReasons nonempty"]
+    medC [label="btnMediaLibraryCapture  Button\ndisabled: selectedPrinter empty"]
+    medM [label="btnMediaLibraryManage  Button\nalways on"]
+  }
+  side -> med
+  side -> medSt
+  side -> medC
+  side -> medM
+
+  subgraph cluster_studio {
+    label="Studio (not stepper)"
+    calB [label="btnCalibratePrinter  Button\nalways on; Stage 0"]
+    gamB [label="btnViewGamut  Button\nSAME id as Stage 5\nalways on; no .gam = sRGB only"]
+    spotB [label="btnSpotRead  Button\ndisabled: no cwd OR chartread running"]
+  }
+  side -> calB
+  side -> gamB
+  side -> spotB
+
+  subgraph cluster_step {
+    label="Stepper 1-5 (disk is truth)"
+    step [label="StepperRow  Button.plain\ndisabled/opacity 0.45 unless isUnlocked\nbackward always; calibrate is not a row"]
+    nGate [shape=note, label="WizardGating.swift\n1 always\n2 .ti1\n3 .ti1 AND .ti2\n4 .ti3 (not .ti2 alone)\n5 .ti3 AND .icc/.icm\nre-probe on window key (#151)"]
+  }
+  side -> step
+  step -> nGate [style=dashed]
+
+  subgraph cluster_chip {
+    label="projectChip  ProjectUI.swift (#149)"
+    cn [label="projectChipName\nbound name or No project"]
+    cp [label="projectChipPath\nshown if bound"]
+    cs [label="projectChipStale\nshown: diskBehindNotes"]
+    cr [label="btnProjectReveal\nshown if bound"]
+    csv [label="btnProjectSave\nshown if bound\ndisabled: !canSave\ncanSave: bound + basename + cwd\nCAL_ still enabled (refusal banner)"]
+    co [label="btnProjectOpen\nshown if NOT bound"]
+  }
+  side -> cn
+  side -> cp
+  side -> cs
+  side -> cr
+  side -> csv
+  side -> co
+
+  subgraph cluster_menu {
+    label="File menu  ProjectCommands / ICCeryApp.swift"
+    mN [label="menuProjectNew  Cmd-N"]
+    mO [label="menuProjectOpen  Cmd-O"]
+    mR [label="menuProjectRecents  Menu\ndisabled: recents empty\nprojectRecent-{hash}\nmenuProjectRecentsClear"]
+    mS [label="menuProjectSave  Cmd-S\ndisabled: !canSave"]
+    mSa [label="menuProjectSaveAs  Shift-Cmd-S\ndisabled: !canSaveAs\ncanSaveAs: basename + cwd"]
+    mRp [label="menuProjectReport\ndisabled: !canReport"]
+    mCl [label="menuProjectClose\ndisabled: !isBound"]
+  }
+
+  st1 [label="stage-1  Stage1View.swift"]
+  st2 [label="stage-2  Stage2View.swift"]
+  st3 [label="stage-3  Stage3View.swift"]
+  st4 [label="stage-4  Stage4View.swift"]
+  st5 [label="stage-5  Stage5View.swift"]
+  st0 [label="stage-cal  CalibrationView.swift"]
+  stage -> st1
+  stage -> st2
+  stage -> st3
+  stage -> st4
+  stage -> st5
+  stage -> st0
+}
+```
+
+## Stages 1–2
+
+Generate Target, Lay Out and Print. Source: [`ui-interactive-map-stage1-2.dot`](ui-interactive-map-stage1-2.dot)
+
+```graphviz
+digraph ICCeryUIStage12 {
+  graph [label="ICCery UI — Stage 1 Generate Target / Stage 2 Lay Out and Print",
+         labelloc=t, fontsize=14, fontname="Helvetica"]
+  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
+  edge [fontname="Helvetica", fontsize=8]
+
+  subgraph cluster_s1 {
+    label="stage-1  Stage1View.swift"
+    csp [label="colourSpace  Picker.segmented\nRGB | CMYK"]
+    pcp [label="patchCountPreset  Picker"]
+    pcc [label="patchCountCustom  TextField.number\nshown: patchPreset == custom"]
+    wp [label="whitePatches  Stepper  0..50"]
+    bp [label="blackPatches  Stepper  0..50"]
+    tb [label="targetBasename  TextField"]
+    bb [label="btnBrowse  Button"]
+    wd [label="btnSelectWorkDir  Button"]
+    oe [label="btnOpenExisting  Button\n.ti1 or .ti2 (+ matching .ti1)"]
+    imp [label="btn-import-dataset  Button\n.ti3 / txt / cgats / csv\nunlocks stage 4"]
+    spd [label="selectedPathDisplay  Text"]
+    adv [label="targenAdvancedDetails  DisclosureGroup\nUI tests pre-expand"]
+    gen [label="btnGenerate  Button\ndisabled: !canGenerate OR targenRunning\ncanGenerate: valid basename AND directory"]
+    tlog [label="targenLogContainer / targenLog\nProcessLogView.swift"]
+  }
+
+  subgraph cluster_adv {
+    label="Advanced (hidden until disclosure open)"
+    ag [label="targenGreySteps  Toggle+TextField\nfield iff toggle on"]
+    as1 [label="targenSingleChannelSteps  Toggle+TextField"]
+    an [label="targenNeutralSteps  Toggle+TextField"]
+    anc [label="targenNeutralConcentration  Toggle+Slider 0..1"]
+    aa [label="targenAdaptation  Toggle+Slider 0..1"]
+    ap [label="targenPrecondProfile  TextField"]
+    apb [label="btnBrowsePrecondProfile  Button"]
+    ahq [label="targenHighQuality  Toggle  OFPS -G"]
+    aal [label="targenAlgorithm  Picker"]
+    ail [label="targenInkLimitGroup  Toggle+TextField\nshown: colourSpace == cmyk"]
+    ad [label="targenDarkEmphasis  Toggle+Slider 0..3"]
+    adp [label="targenDevicePower  Toggle+Slider 0..3"]
+  }
+  adv -> ag [style=dashed]
+
+  subgraph cluster_s2 {
+    label="stage-2  Stage2View.swift"
+    cmw [label="cmWarningBanner  always visible, not a control"]
+    ins [label="instrumentSelect  Picker\nPrintInstrument chart code, NOT USB port"]
+    pgs [label="pageSizeSelect  Picker"]
+    cps [label="customPageSizeRow\nshown: pageSize == custom\ncustomPageW / customPageH mm"]
+    bit [label="bitDepth  Picker  8-bit | 16-bit\n(no a11y id on picker)"]
+    dpi [label="tiffDpi  Stepper  72..600"]
+    lo [label="printtargLayoutOrder  Picker"]
+    seed [label="printtargCustomSeedGroup\nshown: layoutOrder == customSeed\nid printtargCustomSeed"]
+    tle [label="btnToggleLabelEdit  Button\nEdit label / Use automatic"]
+    mp [label="targetMetadataPrinter  TextField"]
+    mi [label="targetMetadataInkSet  TextField"]
+    md [label="targetMetadataDriverPaper  TextField"]
+    ma [label="targetMetadataActualPaper  TextField"]
+    lpv [label="targetLabelPreview  TextField or Text\nTextField iff labelIsCustom"]
+    lay [label="btnCreateLayout  Button\ndisabled: printtargRunning OR basename empty"]
+    plog [label="printtargLogContainer  DisclosureGroup"]
+    gal [label="tiffGallery  shown: printtargResult != nil\ngalleryInfo, galleryGrid\ngalleryPage-{index}\nbtnPrintPage-{index}\nPrint disabled: isPrinting OR no printer"]
+  }
+
+  subgraph cluster_print {
+    label="rawPrintPanel"
+    ps [label="printerSelect  Picker  CUPS queues"]
+    psb [label="printerStatusBadge\nshown: selected printer in list"]
+    prf [label="btnRefreshPrinters  Button"]
+    ppr [label="btnPrinterProperties  Button\ndisabled: selectedPrinter empty"]
+    ptr [label="printerTraySelect  Picker\nshown: trays nonempty"]
+    pmt [label="printerMediaTypeSelect  Picker\nshown: mediaTypes nonempty"]
+    por [label="btnOrientPortrait  Button"]
+    lan [label="btnOrientLandscape  Button"]
+    pal [label="btnPrintAll  Button\ndisabled: isPrinting OR no result OR no printer"]
+    a3 [label="btnAdvanceToStage3  Button\ndisabled: no result OR !isUnlocked(measure)"]
+    pnt [label="printNotificationText\nshown: printNotice != nil"]
+  }
+}
+```
+
+## Stages 3–5 + Calibrate
+
+Measure, Build, Verify, Stage 0. Source: [`ui-interactive-map-stage3-5-cal.dot`](ui-interactive-map-stage3-5-cal.dot)
+
+```graphviz
+digraph ICCeryUIStage345Cal {
+  graph [label="ICCery UI — Stage 3 Measure / 4 Build / 5 Verify / Stage 0 Calibrate",
+         labelloc=t, fontsize=14, fontname="Helvetica"]
+  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
+  edge [fontname="Helvetica", fontsize=8]
+
+  subgraph cluster_s3 {
+    label="stage-3  Stage3View.swift / MeasurementWorkflowViewModel"
+    d3 [label="btnDetectInstruments  Button\ndisabled: isDetecting"]
+    i3 [label="chartreadInstrumentSelect  Picker.menu\nAuto + instlist ports"]
+    xyh [label="xyTableHint  Caption\nshown: selected is XY"]
+    xyp [label="xyTablePanel  shown: isXY\nxyStepPlace Align Scan Remove"]
+    pr [label="chartreadPrompt  Text"]
+    err [label="chartreadLastError  Caption\nshown: chartreadNotice != nil"]
+    sr [label="btnStartRead  Button\nshown: !running\ndisabled: !canStartRead\ncanStart: basename AND cwd AND !running"]
+    cal3 [label="btnCalibrate  Button\nshown: running AND calibrating"]
+    trg [label="btnTrigger  Button\nshown: running AND awaitingStrip"]
+    de [label="btnDoneReadEarly  Button\nshown: awaitingStrip"]
+    acc [label="btnAccept  Button\nshown: place | align | continue | warning"]
+    rty [label="btnRetry  Button\nshown: state == error"]
+    dn [label="btnDoneRead  Button\nshown: allStripsRead"]
+    cnc [label="btnCancel  Button\nshown: isChartreadRunning"]
+    sw [label="swatchGrid  swatch-{rowId}{loc}"]
+    rst [label="readStats  Text"]
+    avg [label="chartreadAveragingPanel\nshown: passes nonempty OR isFinished"]
+    mas [label="btnMeasureAnotherSheet  Button\ndisabled: !isFinished OR running"]
+    fa [label="btnFinishAndAverage  Button\ndisabled: !canFinish OR isFinishing\ncanFinish: isFinished AND passes nonempty"]
+  }
+
+  subgraph cluster_s4 {
+    label="stage-4  Stage4View.swift / ProfileWorkflowViewModel"
+    alg [label="colprofAlgorithm  Picker"]
+    q [label="colprofQuality  Picker"]
+    fwa [label="colprofFwa  Picker"]
+    fwap [label="colprofFwaCustomPath  TextField\nshown: custom spectrum"]
+    fwab [label="btnBrowseFwaSp  Button\nshown with custom path"]
+    ill [label="colprofIlluminant  TextField"]
+    obs [label="colprofObserver  TextField"]
+    ivc [label="colprofInputViewCond  TextField"]
+    ovc [label="colprofOutputViewCond  TextField"]
+    desc [label="colprofDescription  TextField"]
+    cpr [label="colprofCopyright  TextField"]
+    ac [label="colprofApplyCalibration  Toggle"]
+    cf [label="colprofCalibrationFile  TextField\nshown: applyCalibration"]
+    cfb [label="btnBrowseCalibrationFile  Button\nshown: applyCalibration"]
+    cp [label="btnCreateProfile  Button\ndisabled: !canCreateProfile\ncanCreate: basename AND cwd AND !colprofRunning"]
+    cpi [label="colprofProgressIndicator\nshown: isColprofRunning"]
+  }
+
+  subgraph cluster_s5 {
+    label="stage-5  Stage5View.swift"
+    vf [label="btnVerifyProfile  Button\ndisabled: !canVerify\ncanVerify: createdProfileURL AND !profcheckRunning"]
+    ppi [label="profcheckProgressIndicator\nshown: isProfcheckRunning"]
+    vg5 [label="btnViewGamut  Button\nDUPLICATE id with sidebar\ndisabled: createdGamutURL == nil"]
+    inst [label="btnInstallProfile  Button\ndisabled: createdProfileURL == nil"]
+    df [label="driftPrinterFilter  Picker"]
+    eh [label="btnExportHistory  Button"]
+    ch [label="btnClearHistory  Button"]
+    ht [label="verificationHistoryTable"]
+    dc [label="driftChart  DriftChartView.swift\nnot interactive"]
+    dalt [label="driftAlert / profcheckWarningBanner\nshown on fail / warning"]
+  }
+
+  subgraph cluster_coll {
+    label="Install collision alert"
+    io [label="profileOverwriteBtn"]
+    ir [label="profileRenameBtn"]
+    ic [label="profileCancelCollisionBtn\nshown: showingInstallCollision\nAND askBeforeOverwriteProfile"]
+  }
+
+  subgraph cluster_cal {
+    label="stage-cal  CalibrationView.swift (Stage 0)"
+    ccs [label="Colour Space  Picker.segmented\nRGB | CMYK  (no a11y id)"]
+    cst [label="calSteps  TextField.number"]
+    cwp [label="White patches  TextField.number\n(no a11y id)"]
+    cin [label="calInkExplore  TextField\nshown: colourSpace == cmyk"]
+    cne [label="calNeutralEmphasis  Toggle.checkbox"]
+    cg [label="btnCalGenerate  Button\ndisabled: empty basename OR no cwd OR isGenerating"]
+    cl [label="btnCalLayout  Button\nsame disable as Generate"]
+    cm [label="btnCalMeasure  Button\ndisabled: calibrationTi3URL == nil"]
+    cc [label="btnCalCompute  Button\ndisabled: !canCompute\ncanCompute: .ti3 exists AND !isComputing"]
+    cat [label="calApplyToggle  Toggle\nshown: computedCalURL != nil"]
+    cr [label="btnCalReturn  Button  Esc\nrestores original basename"]
+  }
+}
+```
+
+## Sheets
+
+Settings, Spot Read, Gamut, media, project alerts. Source: [`ui-interactive-map-sheets.dot`](ui-interactive-map-sheets.dot)
+
+```graphviz
+digraph ICCeryUISheets {
+  graph [label="ICCery UI — sheets, Spot Read, Gamut, Settings, project alerts",
+         labelloc=t, fontsize=14, fontname="Helvetica"]
+  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
+  edge [fontname="Helvetica", fontsize=8]
+
+  subgraph cluster_set {
+    label="SettingsView.swift  (openSettingsBtn)"
+    ad [label="Argyll dir  TextField+Browse\nempty => bundled sidecars"]
+    di [label="Default instrument  Picker\nNone + i1/p3/CM/SS/20/22/41/51\nseeds Stage 3 + Spot Read\ndoes NOT change instrumentSelect"]
+    led [label="Enable i1Pro 2 LEDs  Toggle"]
+    dg [label="settingsDeltaEGood  TextField"]
+    dw [label="settingsDeltaEWarning  TextField\nSave refuses unless Warning > Good"]
+    sd [label="settingsCalStaleDays  TextField"]
+    il [label="Install location  Picker\nUser | System library"]
+    ao [label="Ask before overwriting  Toggle"]
+    oc [label="Open ColorSync after install  Toggle"]
+    ll [label="Log level  Picker"]
+    lg [label="Open log folder / Copy path / Copy excerpt"]
+    ss [label="Cancel / Save\nSave stays if validation fails\nframe 560x620"]
+  }
+
+  subgraph cluster_about {
+    label="AboutView.swift"
+    ab [label="aboutDialog\naboutVersion, aboutBuildDate\ncloseAboutBtn  Esc"]
+  }
+
+  subgraph cluster_sp {
+    label="savePresetDialog  PresetDialogs.swift"
+    spn [label="savePresetName  TextField"]
+    spd [label="savePresetDesc  TextField"]
+    spc [label="btnCloseSavePresetDialog"]
+    sps [label="btnConfirmSavePreset\ndisabled: name trimmed empty"]
+  }
+
+  subgraph cluster_mp {
+    label="managePresetsDialog"
+    prw [label="presetRow-{id}\nBuilt-in: no delete\nelse btnExportPreset-{id}\nbtnDeletePreset-{id}"]
+    pim [label="btnImportPreset"]
+    pea [label="btnExportActivePreset\nshown: selected custom preset"]
+    pcl [label="btnCloseManagePresetsDialog"]
+  }
+
+  subgraph cluster_sm {
+    label="saveMediaRecipeDialog  MediaLibraryDialogs.swift"
+    smf [label="saveMediaName/Notes/Paper/Ink  TextField x4"]
+    smr [label="saveMediaPrinter/Preset/ColourSpace/Cal  read-only"]
+    smc [label="saveMediaApplyCal  Toggle\ndisabled: !calApplyable\ncalApplyable: path exists, not CAL_"]
+    smx [label="btnCloseSaveMediaDialog"]
+    sms [label="btnConfirmSaveMedia\ndisabled: name|paper|ink empty\nOR colour-space mismatch"]
+  }
+
+  subgraph cluster_mm {
+    label="manageMediaDialog"
+    mll [label="mediaLibraryList\nmediaRow-{id}\nbtnMediaLibraryApply-{id}\nbtnMediaLibraryDelete-{id}\ndouble-click = Apply"]
+    mmn [label="manageMediaNotice  Caption\nshown: manageApplyNotice != nil\nin-sheet copy of failed Apply (#170)"]
+    mla [label="btnMediaLibraryApply\ndisabled: selection == nil"]
+    mlc [label="btnMediaLibraryCaptureFromManage\ndismiss then open capture"]
+    mlx [label="btnCloseManageMediaDialog"]
+    mld [label="Delete alert  Cancel / Delete"]
+  }
+
+  subgraph cluster_spot {
+    label="spotReadView  SpotReadView.swift (#148)"
+    ssm [label="spotSidecarMissing\nshown: !sidecarAvailable\nhides instrument/transport"]
+    sdet [label="btnSpotDetectInstruments\ndisabled: detecting OR running"]
+    sis [label="spotInstrumentSelect  Picker\ndisabled: isRunning"]
+    sdm [label="spotDefaultMissing\nshown: defaultMissing"]
+    ssd [label="spotSetDefault  Toggle"]
+    sxy [label="spotXYHint  shown: selected is XY"]
+    sst [label="btnSpotStart\nshown: !isRunning\ndisabled: !canStart\ncanStart: sidecar, !detecting, !running,\n!chartreadRunning, cwd"]
+    sca [label="btnSpotCalibrate\nshown: running AND calibrating"]
+    str [label="btnSpotTrigger  Read\nshown: running AND awaitingStrip"]
+    ssp [label="btnSpotStop  shown: isRunning"]
+    sls [label="spotLastSample / Lab / XYZ / DeltaE\nspotLabImplausible if L not 0..100\nspotDeltaE hidden on first sample"]
+    sht [label="spotHistoryTable\nrows: spotHistoryRow-{uuid}\nclick restores sample, no trigger"]
+    scp [label="btnSpotCopyLab\ndisabled: displayedSample == nil"]
+    sex [label="btnSpotExportCsv\ndisabled: samples empty"]
+    scl [label="btnCloseSpotRead  Esc; onDismiss = Stop"]
+  }
+
+  subgraph cluster_gamut {
+    label="gamutView  GamutView.swift (#147)"
+    gls [label="gamutLayer-srgb  Toggle\nsRGB always loaded; can hide"]
+    glp [label="gamutLayer-profile  Toggle\ndisabled: no session .gam"]
+    glc [label="gamutLayer-compare  Toggle\ndisabled: no compare layer"]
+    gac [label="btnGamutAddCompare  Menu\nbtnGamutOpenGam / btnGamutOpenProfile"]
+    grc [label="btnGamutRemoveCompare\ndisabled: compare layer nil"]
+    gst [label="btnGamutSampleTiff"]
+    gun [label="gamutViewerUnavailable\nshown: no Metal\ntoggles + inspect still enabled"]
+    grs [label="btnResetGamutCamera  R"]
+    gle [label="gamutLabEntryL/A/B  TextField x3"]
+    gin [label="btnGamutInspectLab\ndisabled: !canInspectLab"]
+    gip [label="gamutInspectPanel"]
+    gcl [label="btnCloseGamut  Esc"]
+    gtf [label="gamutTiffPreview sheet\nshowingTiffPreview\nbtnCloseGamutTiffPreview"]
+  }
+
+  subgraph cluster_proj {
+    label="Project alerts  RootView + ProjectUI"
+    pna [label="projectNewAlert\nbtnProjectNewCancel / Confirm"]
+    pda [label="Dirty save alert\nbtnProjectDirtySave\nbtnProjectDirtyDiscard\nbtnProjectDirtyCancel"]
+    prs [label="projectRelocateSheet\nshown: cwd missing on Open\nbtnProjectRelocateCancel\nbtnProjectRelocate"]
+  }
+
+  mutex [shape=note, label="Mutex\nSpot Read disabled while Stage 3 chartread runs\nOpening Spot Read never kills chartread_{basename}\nFailed media Apply keeps manage sheet open\nWindow noticeText is occluded — use manageMediaNotice"]
+}
+```
-- 
2.39.5


From 40cc4ad701402cb003cb426d9bf67f988803d2a0 Mon Sep 17 00:00:00 2001
From: gronod <gronod@users.noreply.git.i3omb.com>
Date: Mon, 14 Sep 2026 14:25:52 +0000
Subject: [PATCH 4/8] docs: drop PlantUML UI maps that Kroki 0.30.1 cannot run
 without AVX2

---
 docs/ui-interactive-map-sheets.puml       | 217 ----------------------
 docs/ui-interactive-map-shell.puml        | 208 ---------------------
 docs/ui-interactive-map-stage1-2.puml     | 163 ----------------
 docs/ui-interactive-map-stage3-5-cal.puml | 174 -----------------
 4 files changed, 762 deletions(-)
 delete mode 100644 docs/ui-interactive-map-sheets.puml
 delete mode 100644 docs/ui-interactive-map-shell.puml
 delete mode 100644 docs/ui-interactive-map-stage1-2.puml
 delete mode 100644 docs/ui-interactive-map-stage3-5-cal.puml

diff --git a/docs/ui-interactive-map-sheets.puml b/docs/ui-interactive-map-sheets.puml
deleted file mode 100644
index 9372ac3..0000000
--- a/docs/ui-interactive-map-sheets.puml
+++ /dev/null
@@ -1,217 +0,0 @@
-@startuml ICCery-UI-sheets
-title Sheets, dialogs, Spot Read, Gamut, Settings
-skinparam classAttributeIconSize 0
-hide circle
-hide empty methods
-
-package "SettingsView.swift  sheet from openSettingsBtn" {
-  class "Argyll dir" as ad <<TextField+Browse>> {
-    empty => bundled sidecars
-  }
-  class "Default instrument" as di <<Picker>> {
-    None + i1/p3/CM/SS/20/22/41/51
-    seeds Stage 3 + Spot Read
-    does NOT change instrumentSelect
-  }
-  class "Enable i1Pro 2 LEDs" as led <<Toggle>>
-  class "settingsDeltaEGood" as dg <<TextField.number>>
-  class "settingsDeltaEWarning" as dw <<TextField.number>> {
-    Save refuses unless Warning > Good
-  }
-  class "settingsCalStaleDays" as sd <<TextField.number>>
-  class "Install location" as il <<Picker>> {
-    User | System library
-  }
-  class "Ask before overwriting" as ao <<Toggle>>
-  class "Open ColorSync after install" as oc <<Toggle>>
-  class "Log level" as ll <<Picker>>
-  class "Open log folder / Copy path / Copy excerpt" as lg <<Button x3>>
-  class "Cancel / Save" as ss <<Button>> {
-    Save stays on sheet if validation fails
-    frame 560x620
-  }
-}
-
-package "AboutView.swift" {
-  class "aboutDialog" as ab <<Sheet>> {
-    aboutVersion, aboutBuildDate
-    closeAboutBtn  Esc
-  }
-}
-
-package "savePresetDialog  PresetDialogs.swift" {
-  class "savePresetName" as spn <<TextField>>
-  class "savePresetDesc" as spd <<TextField>>
-  class "btnCloseSavePresetDialog" as spc <<Button>>
-  class "btnConfirmSavePreset" as sps <<Button>> {
-    disabled: name trimmed empty
-  }
-}
-
-package "managePresetsDialog" {
-  class "presetRow-{id}" as prw <<Row>> {
-    Built-in: no delete
-    else btnExportPreset-{id} btnDeletePreset-{id}
-  }
-  class "btnImportPreset" as pim <<Button>>
-  class "btnExportActivePreset" as pea <<Button>> {
-    shown: selected custom preset
-  }
-  class "btnCloseManagePresetsDialog" as pcl <<Button>>
-}
-
-package "saveMediaRecipeDialog  MediaLibraryDialogs.swift" {
-  class "saveMediaName/Notes/Paper/Ink" as smf <<TextField x4>>
-  class "saveMediaPrinter/Preset/ColourSpace/Cal" as smr <<read-only>>
-  class "saveMediaApplyCal" as smc <<Toggle>> {
-    disabled: !calApplyable
-    calApplyable: path exists, not CAL_ stem
-  }
-  class "btnCloseSaveMediaDialog" as smx <<Button>>
-  class "btnConfirmSaveMedia" as sms <<Button>> {
-    disabled: name|paper|ink empty
-             OR captureColourSpaceMismatch
-  }
-}
-
-package "manageMediaDialog" {
-  class "mediaLibraryList" as mll <<List>> {
-    mediaRow-{id}
-    btnMediaLibraryApply-{id}
-    btnMediaLibraryDelete-{id}
-    double-click row = Apply
-  }
-  class "manageMediaNotice" as mmn <<Caption>> {
-    shown: manageApplyNotice != nil
-    in-sheet copy of failed Apply (#170)
-  }
-  class "btnMediaLibraryApply" as mla <<Button>> {
-    Apply selected
-    disabled: selection == nil
-  }
-  class "btnMediaLibraryCaptureFromManage" as mlc <<Button>> {
-    dismiss then open capture
-  }
-  class "btnCloseManageMediaDialog" as mlx <<Button>>
-  class "Delete alert" as mld <<alert>> {
-    Cancel / Delete
-  }
-}
-
-package "spotReadView  SpotReadView.swift  (#148)" {
-  class "spotSidecarMissing" as ssm <<Text>> {
-    shown: !sidecarAvailable
-    hides instrument/transport
-  }
-  class "btnSpotDetectInstruments" as sdet <<Button>> {
-    disabled: !canDetect  (detecting or running)
-  }
-  class "spotInstrumentSelect" as sis <<Picker>> {
-    disabled: isRunning
-  }
-  class "spotDefaultMissing" as sdm <<Caption>> {
-    shown: defaultMissing
-  }
-  class "spotSetDefault" as ssd <<Toggle>>
-  class "spotXYHint" as sxy <<Caption>> {
-    shown: selected is XY table
-  }
-  class "btnSpotStart" as sst <<Button>> {
-    shown: !isRunning
-    disabled: !canStart
-    canStart: sidecar && !detecting && !running
-              && !chartreadRunning && cwd
-  }
-  class "btnSpotCalibrate" as sca <<Button>> {
-    shown: running && calibrating
-  }
-  class "btnSpotTrigger" as str <<Button>> {
-    shown: running && awaitingStrip  (Read)
-  }
-  class "btnSpotStop" as ssp <<Button>> {
-    shown: isRunning
-  }
-  class "spotLastSample / Lab / XYZ / DeltaE" as sls <<Display>> {
-    spotLabImplausible if L not in 0...100
-    spotDeltaE hidden on first sample
-  }
-  class "spotHistoryTable" as sht <<List>> {
-    rows are buttons spotHistoryRow-{uuid}
-    click restores last sample, no trigger
-  }
-  class "btnSpotCopyLab" as scp <<Button>> {
-    disabled: displayedSample == nil
-  }
-  class "btnSpotExportCsv" as sex <<Button>> {
-    disabled: samples.isEmpty
-  }
-  class "btnCloseSpotRead" as scl <<Button>> {
-    Esc; onDismiss = Stop
-  }
-}
-
-package "gamutView  GamutView.swift  (#147)" {
-  class "gamutLayer-srgb" as gls <<Toggle.checkbox>> {
-    sRGB always loaded; can hide; cannot remove
-  }
-  class "gamutLayer-profile" as glp <<Toggle>> {
-    disabled: no session .gam
-  }
-  class "gamutLayer-compare" as glc <<Toggle>> {
-    disabled: no compare layer
-  }
-  class "btnGamutAddCompare" as gac <<Menu>> {
-    btnGamutOpenGam / btnGamutOpenProfile
-  }
-  class "btnGamutRemoveCompare" as grc <<Button>> {
-    disabled: compare layer nil
-  }
-  class "btnGamutSampleTiff" as gst <<Button>>
-  class "gamutViewerUnavailable" as gun <<Caption>> {
-    shown: no Metal / SCNView failed
-    toggles + inspect still enabled
-  }
-  class "btnResetGamutCamera" as grs <<Button>> {
-    R when focused
-  }
-  class "gamutLabEntryL/A/B" as gle <<TextField x3>>
-  class "btnGamutInspectLab" as gin <<Button>> {
-    disabled: !canInspectLab
-  }
-  class "gamutInspectPanel" as gip <<Panel>>
-  class "btnCloseGamut" as gcl <<Button>> {
-    Esc
-  }
-  class "gamutTiffPreview sheet" as gtf <<Sheet>> {
-    showingTiffPreview
-    click pixel; btnCloseGamutTiffPreview
-  }
-}
-
-package "Project alerts / relocate  RootView + ProjectUI" {
-  class "projectNewAlert" as pna <<alert>> {
-    btnProjectNewCancel / btnProjectNewConfirm
-  }
-  class "Dirty save alert" as pda <<alert>> {
-    btnProjectDirtySave
-    btnProjectDirtyDiscard
-    btnProjectDirtyCancel
-    shown when New/Open/Close and dirty
-  }
-  class "projectRelocateSheet" as prs <<Sheet>> {
-    shown: cwd missing on Open
-    btnProjectRelocateCancel
-    btnProjectRelocate  Choose Folder…
-  }
-}
-
-note as nMutex
-  Mutex / exclusive
-  Spot Read disabled while Stage 3 chartread runs
-  Opening Spot Read never kills chartread_{basename}
-  Calibrate uses temporary CAL_ basename; Save Project stays
-  enabled so the refusal banner can fire; chip Save uses canSave
-  Failed media Apply keeps manageMediaDialog open
-  Window noticeText is occluded by that sheet — use manageMediaNotice
-end note
-@enduml
diff --git a/docs/ui-interactive-map-shell.puml b/docs/ui-interactive-map-shell.puml
deleted file mode 100644
index 38f89f2..0000000
--- a/docs/ui-interactive-map-shell.puml
+++ /dev/null
@@ -1,208 +0,0 @@
-@startuml ICCery-UI-shell
-title ICCery v2 — interactive UI map (develop)\nobject names, files, enable / hide rules
-caption Accessibility ids in quotes. Disk gating: WizardGating.swift. No App Sandbox.
-skinparam classAttributeIconSize 0
-skinparam wrapWidth 280
-hide circle
-hide empty methods
-
-together {
-  class "WindowGroup ICCery" as win <<ICCeryApp.swift>> {
-    1280x800, min 1100x700
-    File menu: ProjectCommands
-  }
-  class "RootView" as root <<RootView.swift>> {
-    sidebar 270pt + stage column
-    sheets / alerts hosted here
-  }
-}
-
-win --> root
-
-package "Persistent chrome" {
-  class "SidebarView" as side <<SidebarView.swift>>
-  class "NoticeBanner" as ban <<NoticeBanner.swift>> {
-    id noticeText
-    shown: wizard.notice != nil
-    auto-hide 6s unless nil
-    close: xmark (no a11y id)
-  }
-  class "WizardStageContent" as stage <<RootView.swift>> {
-    switch wizard.stage
-  }
-}
-
-root --> side
-root --> ban
-root --> stage
-
-package "Sidebar header" {
-  class "openSettingsBtn" as sSet <<Button>> {
-    gearshape
-    always enabled
-    presents SettingsView sheet
-  }
-  class "openAboutBtn" as sAbt <<Button>> {
-    info.circle
-    always enabled
-    presents AboutView
-  }
-  class "btnToggleAllHelp" as sHlp <<Button>> {
-    questionmark.circle
-    toggles showingAllHelp
-    HelpOverlayView: yellow dots when on
-  }
-}
-side --> sSet
-side --> sAbt
-side --> sHlp
-
-package "Presets (#11)" {
-  class "presetSelect" as pre <<Picker.menu>> {
-    tags: none + ProfilingPreset.id
-    set applies preset immediately
-    "No preset" does not factory-reset
-  }
-  class "btnSavePresetModal" as preS <<Button>> {
-    always enabled
-    showingSavePreset = true
-  }
-  class "btnOpenPresetsDialog" as preM <<Button>> {
-    always enabled
-    showingManagePresets = true
-  }
-}
-side --> pre
-side --> preS
-side --> preM
-
-package "Media library (#146)" {
-  class "mediaSelect" as med <<Picker.menu>> {
-    tags: none + MediaRecipe.id
-    never reuses presetSelect
-    failed apply snaps back to none
-  }
-  class "mediaRecipeStale" as medSt <<Caption>> {
-    shown: staleReasons[selected] nonempty
-    "Printer not installed" or "Calibration stale"
-  }
-  class "btnMediaLibraryCapture" as medC <<Button>> {
-    disabled: print.selectedPrinter.isEmpty
-    needs Stage 2 queue
-  }
-  class "btnMediaLibraryManage" as medM <<Button>> {
-    always enabled
-  }
-}
-side --> med
-side --> medSt
-side --> medC
-side --> medM
-
-package "Studio (not stepper)" {
-  class "btnCalibratePrinter" as calB <<Button>> {
-    always enabled
-    wizard.enterCalibration()
-    Stage 0, not numbered
-  }
-  class "btnViewGamut" as gamB <<Button>> {
-    Sidebar copy — same id as Stage 5
-    always enabled
-    no .gam => sRGB only
-  }
-  class "btnSpotRead" as spotB <<Button>> {
-    disabled: workingDirectory==nil
-             OR measurement.isChartreadRunning
-  }
-}
-side --> calB
-side --> gamB
-side --> spotB
-
-package "Stepper 1–5  (disk is truth)" {
-  class "StepperRow stage N" as step <<Button.plain>> {
-    WizardStage.stepperStages
-    disabled / opacity 0.45 unless isUnlocked
-    go(to:) allowed backward always
-    calibrate is NOT a stepper row
-  }
-  note as nGate
-    WizardGating.swift / WizardViewModel.isUnlocked
-    1 generate: always
-    2 layOutPrint: .ti1
-    3 measure: .ti1 AND .ti2
-    4 buildProfile: .ti3 (not .ti2 alone)
-    5 verifyInstall: .ti3 AND .icc/.icm
-    Re-probed on window key (#151)
-  end note
-}
-side --> step
-step .. nGate
-
-package "Project chip (#149)  ProjectUI.swift" {
-  class "projectChip" as chip <<Container>>
-  class "projectChipName" as cn <<Text>> {
-    bound name or "No project"
-  }
-  class "projectChipPath" as cp <<Text>> {
-    shown if bound; last path component
-  }
-  class "projectChipStale" as cs <<Caption>> {
-    shown: diskBehindNotes
-  }
-  class "btnProjectReveal" as cr <<Button>> {
-    shown if bound
-  }
-  class "btnProjectSave" as csv <<Button>> {
-    shown if bound
-    disabled: !canSave
-    canSave: isBound && basename && cwd
-    CAL_ basename still enabled (refusal banner)
-  }
-  class "btnProjectOpen" as co <<Button>> {
-    shown if NOT bound
-  }
-}
-side --> chip
-chip --> cn
-chip --> cp
-chip --> cs
-chip --> cr
-chip --> csv
-chip --> co
-
-package "File menu  ProjectCommands / ICCeryApp.swift" {
-  class "menuProjectNew" as mN <<Button>> {
-    ⌘N  requestNew()
-  }
-  class "menuProjectOpen" as mO <<Button>> {
-    ⌘O
-  }
-  class "menuProjectRecents" as mR <<Menu>> {
-    disabled: recents.isEmpty
-    items: projectRecent-{bookmarkHash}
-    menuProjectRecentsClear
-  }
-  class "menuProjectSave" as mS <<Button>> {
-    ⌘S  disabled: !canSave
-  }
-  class "menuProjectSaveAs" as mSa <<Button>> {
-    ⇧⌘S  disabled: !canSaveAs
-    canSaveAs: basename && cwd (no bind required)
-  }
-  class "menuProjectReport" as mRp <<Button>> {
-    disabled: !canReport
-  }
-  class "menuProjectClose" as mCl <<Button>> {
-    disabled: !isBound
-  }
-}
-
-stage --> "stage-1\nStage1View.swift" as st1
-stage --> "stage-2\nStage2View.swift" as st2
-stage --> "stage-3\nStage3View.swift" as st3
-stage --> "stage-4\nStage4View.swift" as st4
-stage --> "stage-5\nStage5View.swift" as st5
-stage --> "stage-cal\nCalibrationView.swift" as st0
-@enduml
-
diff --git a/docs/ui-interactive-map-stage1-2.puml b/docs/ui-interactive-map-stage1-2.puml
deleted file mode 100644
index f69cfb2..0000000
--- a/docs/ui-interactive-map-stage1-2.puml
+++ /dev/null
@@ -1,163 +0,0 @@
-@startuml ICCery-UI-stage1-2
-title Stages 1–2 — Generate Target / Lay Out and Print
-skinparam classAttributeIconSize 0
-hide circle
-hide empty methods
-
-package "stage-1  Stage1View.swift" {
-  class "colourSpace" as csp <<Picker.segmented>> {
-    RGB | CMYK
-  }
-  class "patchCountPreset" as pcp <<Picker>> {
-    PatchCountPreset.allCases
-  }
-  class "patchCountCustom" as pcc <<TextField.number>> {
-    shown: patchPreset == .custom
-  }
-  class "whitePatches" as wp <<Stepper>> {
-    0...50
-  }
-  class "blackPatches" as bp <<Stepper>> {
-    0...50
-  }
-  class "targetBasename" as tb <<TextField>>
-  class "btnBrowse" as bb <<Button>> {
-    save panel; sets basename
-  }
-  class "btnSelectWorkDir" as wd <<Button>>
-  class "btnOpenExisting" as oe <<Button>> {
-    .ti1 or .ti2 (+ matching .ti1)
-  }
-  class "btn-import-dataset" as imp <<Button>> {
-    .ti3 / .txt / .cgats / .csv
-    unlocks stage 4
-  }
-  class "selectedPathDisplay" as spd <<Text>>
-  class "targenAdvancedDetails" as adv <<DisclosureGroup>> {
-    UI tests pre-expand
-  }
-  class "btnGenerate" as gen <<Button>> {
-    disabled: !canGenerate || targenRunning
-    canGenerate: valid basename AND directory
-    label Generating… while running
-  }
-  class "targenLogContainer / targenLog" as tlog <<DisclosureGroup>> {
-    ProcessLogView.swift
-  }
-}
-
-package "Advanced (hidden until disclosure open)" {
-  class "targenGreySteps" as ag <<Toggle+TextField>> {
-    field shown iff toggle on
-  }
-  class "targenSingleChannelSteps" as as1 <<Toggle+TextField>>
-  class "targenNeutralSteps" as an <<Toggle+TextField>>
-  class "targenNeutralConcentration" as anc <<Toggle+Slider>> {
-    0...1  shown iff on
-  }
-  class "targenAdaptation" as aa <<Toggle+Slider>> {
-    0...1
-  }
-  class "targenPrecondProfile" as ap <<TextField>>
-  class "btnBrowsePrecondProfile" as apb <<Button>>
-  class "targenHighQuality" as ahq <<Toggle>> {
-    OFPS -G
-  }
-  class "targenAlgorithm" as aal <<Picker>>
-  class "targenInkLimitGroup" as ail <<Toggle+TextField>> {
-    shown: colourSpace == cmyk
-  }
-  class "targenDarkEmphasis" as ad <<Toggle+Slider>> {
-    0...3
-  }
-  class "targenDevicePower" as adp <<Toggle+Slider>> {
-    0...3
-  }
-}
-adv --> ag
-
-package "stage-2  Stage2View.swift" {
-  class "cmWarningBanner" as cmw <<Banner>> {
-    always visible on stage 2
-    not a control
-  }
-  class "instrumentSelect" as ins <<Picker>> {
-    PrintInstrument — chart code, NOT USB port
-  }
-  class "pageSizeSelect" as pgs <<Picker>>
-  class "customPageSizeRow" as cps <<HStack>> {
-    shown: pageSize == .custom
-    customPageW / customPageH  mm
-  }
-  class "bitDepth" as bit <<Picker>> {
-    8-bit | 16-bit TIFF
-    (no a11y id on picker)
-  }
-  class "tiffDpi" as dpi <<Stepper>> {
-    72...600
-  }
-  class "printtargLayoutOrder" as lo <<Picker>>
-  class "printtargCustomSeedGroup" as seed <<HStack>> {
-    shown: layoutOrder == .customSeed
-    id printtargCustomSeed
-  }
-  class "btnToggleLabelEdit" as tle <<Button>> {
-    toggles labelIsCustom
-    title: Edit label… / Use automatic label
-  }
-  class "targetMetadataPrinter" as mp <<TextField>>
-  class "targetMetadataInkSet" as mi <<TextField>>
-  class "targetMetadataDriverPaper" as md <<TextField>>
-  class "targetMetadataActualPaper" as ma <<TextField>>
-  class "targetLabelPreview" as lpv <<TextField|Text>> {
-    TextField if labelIsCustom else Text(automatic)
-  }
-  class "btnCreateLayout" as lay <<Button>> {
-    disabled: printtargRunning || basename.empty
-  }
-  class "printtargLogContainer" as plog <<DisclosureGroup>>
-  class "tiffGallery" as gal <<Grid>> {
-    shown: printtargResult != nil
-    galleryInfo, galleryGrid
-    galleryPage-{index}
-    btnPrintPage-{index}
-    Print disabled: isPrinting || selectedPrinter.empty
-  }
-}
-
-package "rawPrintPanel" {
-  class "printerSelect" as ps <<Picker>> {
-    CUPS queues
-  }
-  class "printerStatusBadge" as psb <<Caption>> {
-    shown: selected printer in list
-  }
-  class "btnRefreshPrinters" as prf <<Button>>
-  class "btnPrinterProperties" as ppr <<Button>> {
-    disabled: selectedPrinter.empty
-    bound NSPrintPanel
-  }
-  class "printerTraySelect" as ptr <<Picker>> {
-    shown: trays nonempty
-  }
-  class "printerMediaTypeSelect" as pmt <<Picker>> {
-    shown: mediaTypes nonempty
-    also mediaTypeGroup
-  }
-  class "btnOrientPortrait" as por <<Button>>
-  class "btnOrientLandscape" as lan <<Button>>
-  class "btnPrintAll" as pal <<Button>> {
-    disabled: isPrinting
-             || printtargResult==nil
-             || selectedPrinter.empty
-  }
-  class "btnAdvanceToStage3" as a3 <<Button>> {
-    disabled: printtargResult==nil
-             || !isUnlocked(.measure)
-  }
-  class "printNotificationText" as pnt <<Caption>> {
-    shown: print.printNotice != nil
-  }
-}
-@enduml
-
diff --git a/docs/ui-interactive-map-stage3-5-cal.puml b/docs/ui-interactive-map-stage3-5-cal.puml
deleted file mode 100644
index 79bac4d..0000000
--- a/docs/ui-interactive-map-stage3-5-cal.puml
+++ /dev/null
@@ -1,174 +0,0 @@
-@startuml ICCery-UI-stage3-5-cal
-title Stages 3–5, Calibrate Printer, Measure transport
-skinparam classAttributeIconSize 0
-hide circle
-hide empty methods
-
-package "stage-3  Stage3View.swift / MeasurementWorkflowViewModel" {
-  class "btnDetectInstruments" as d3 <<Button>> {
-    disabled: !canDetect  (!isDetecting)
-  }
-  class "chartreadInstrumentSelect" as i3 <<Picker.menu>> {
-    Auto + instlist ports
-  }
-  class "xyTableHint" as xyh <<Caption>> {
-    shown: selectedInstrument.isXY
-  }
-  class "xyTablePanel" as xyp <<HStack>> {
-    shown: isXY
-    xyStepPlace / Align / Scan / Remove
-    highlight = xyStep
-  }
-  class "chartreadPrompt" as pr <<Text>>
-  class "chartreadLastError" as err <<Caption>> {
-    shown: chartreadNotice != nil
-  }
-  class "btnStartRead" as sr <<Button>> {
-    shown: !isChartreadRunning
-    disabled: !canStartRead
-    canStart: basename && cwd && !running
-  }
-  class "btnCalibrate" as cal3 <<Button>> {
-    shown: running && state==calibrating
-  }
-  class "btnTrigger" as trg <<Button>> {
-    shown: running && awaitingStrip
-  }
-  class "btnDoneReadEarly" as de <<Button>> {
-    shown: awaitingStrip
-  }
-  class "btnAccept" as acc <<Button>> {
-    shown: tablePlaceSheet | tableAlign
-           | promptContinue | warning
-    title Continue or Continue (send 'X')
-  }
-  class "btnRetry" as rty <<Button>> {
-    shown: state==error
-  }
-  class "btnDoneRead" as dn <<Button>> {
-    shown: allStripsRead
-  }
-  class "btnCancel" as cnc <<Button>> {
-    shown: isChartreadRunning
-  }
-  class "swatchGrid" as sw <<Scroll>> {
-    swatch-{rowId}{loc}
-  }
-  class "readStats" as rst <<Text>>
-  class "chartreadAveragingPanel" as avg <<Panel>> {
-    shown: passSnapshots nonempty OR isFinished
-    passCounterBadge, passesList
-  }
-  class "btnMeasureAnotherSheet" as mas <<Button>> {
-    disabled: !isFinished || isChartreadRunning
-  }
-  class "btnFinishAndAverage" as fa <<Button>> {
-    disabled: !canFinish || isFinishing
-    canFinish: isFinished && passes nonempty
-  }
-}
-
-package "stage-4  Stage4View.swift / ProfileWorkflowViewModel" {
-  class "colprofAlgorithm" as alg <<Picker>>
-  class "colprofQuality" as q <<Picker>>
-  class "colprofFwa" as fwa <<Picker>>
-  class "colprofFwaCustomPath" as fwap <<TextField>> {
-    shown: custom spectrum selected
-  }
-  class "btnBrowseFwaSp" as fwab <<Button>> {
-    shown with custom path
-  }
-  class "colprofIlluminant" as ill <<TextField>>
-  class "colprofObserver" as obs <<TextField>>
-  class "colprofInputViewCond" as ivc <<TextField>>
-  class "colprofOutputViewCond" as ovc <<TextField>>
-  class "colprofDescription" as desc <<TextField>>
-  class "colprofCopyright" as cpr <<TextField>>
-  class "colprofApplyCalibration" as ac <<Toggle>>
-  class "colprofCalibrationFile" as cf <<TextField>> {
-    shown: applyCalibration
-  }
-  class "btnBrowseCalibrationFile" as cfb <<Button>> {
-    shown: applyCalibration
-  }
-  class "btnCreateProfile" as cp <<Button>> {
-    disabled: !canCreateProfile
-    canCreate: basename && cwd && !colprofRunning
-  }
-  class "colprofProgressIndicator" as cpi <<Progress>> {
-    shown: isColprofRunning
-  }
-}
-
-package "stage-5  Stage5View.swift" {
-  class "btnVerifyProfile" as vf <<Button>> {
-    disabled: !canVerify
-    canVerify: createdProfileURL && !profcheckRunning
-  }
-  class "profcheckProgressIndicator" as ppi <<Progress>> {
-    shown: isProfcheckRunning
-  }
-  class "btnViewGamut" as vg5 <<Button>> {
-    DUPLICATE id with sidebar
-    disabled: createdGamutURL == nil
-  }
-  class "btnInstallProfile" as inst <<Button>> {
-    disabled: createdProfileURL == nil
-    may present collision alert
-  }
-  class "driftPrinterFilter" as df <<Picker>>
-  class "btnExportHistory" as eh <<Button>>
-  class "btnClearHistory" as ch <<Button>>
-  class "verificationHistoryTable" as ht <<Table>>
-  class "driftChart" as dc <<View>> {
-    DriftChartView.swift  not interactive
-  }
-  class "driftAlert / profcheckWarningBanner" as dalt <<Banner>> {
-    shown on fail / warning status
-  }
-}
-
-package "Install collision alert" {
-  class "profileOverwriteBtn" as io <<Button>>
-  class "profileRenameBtn" as ir <<Button>>
-  class "profileCancelCollisionBtn" as ic <<Button>> {
-    shown: showingInstallCollision
-    && settings.askBeforeOverwriteProfile
-  }
-}
-
-package "stage-cal  CalibrationView.swift  (Stage 0)" {
-  class "Colour Space" as ccs <<Picker.segmented>> {
-    RGB | CMYK  (no a11y id)
-  }
-  class "calSteps" as cst <<TextField.number>>
-  class "White patches" as cwp <<TextField.number>> {
-    no a11y id
-  }
-  class "calInkExplore" as cin <<TextField>> {
-    shown: colourSpace == cmyk
-  }
-  class "calNeutralEmphasis" as cne <<Toggle.checkbox>>
-  class "btnCalGenerate" as cg <<Button>> {
-    disabled: basename.empty || cwd==nil || isGenerating
-  }
-  class "btnCalLayout" as cl <<Button>> {
-    same disable as Generate
-  }
-  class "btnCalMeasure" as cm <<Button>> {
-    disabled: calibrationTi3URL == nil
-  }
-  class "btnCalCompute" as cc <<Button>> {
-    disabled: !canCompute
-    canCompute: .ti3 exists && !isComputing
-  }
-  class "calApplyToggle" as cat <<Toggle>> {
-    shown: computedCalURL != nil
-  }
-  class "btnCalReturn" as cr <<Button>> {
-    Esc / cancelAction
-    restores original basename
-  }
-}
-@enduml
-
-- 
2.39.5


From 9c625ee21fbc9dfcb14778946ee272e423c84152 Mon Sep 17 00:00:00 2001
From: gronod <gronod@users.noreply.git.i3omb.com>
Date: Mon, 14 Sep 2026 14:40:28 +0000
Subject: [PATCH 5/8] docs: dark-mode GraphViz palette for Gitea Kroki

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.
---
 docs/ui-interactive-map-sheets.dot       |  71 ++++++-
 docs/ui-interactive-map-shell.dot        |  65 ++++++-
 docs/ui-interactive-map-stage1-2.dot     |  39 +++-
 docs/ui-interactive-map-stage3-5-cal.dot |  45 ++++-
 docs/ui-interactive-map.md               | 227 +++++++++++++++++++++--
 5 files changed, 417 insertions(+), 30 deletions(-)

diff --git a/docs/ui-interactive-map-sheets.dot b/docs/ui-interactive-map-sheets.dot
index a497d6e..8fe87ab 100644
--- a/docs/ui-interactive-map-sheets.dot
+++ b/docs/ui-interactive-map-sheets.dot
@@ -1,10 +1,25 @@
 digraph ICCeryUISheets {
   graph [label="ICCery UI — sheets, Spot Read, Gamut, Settings, project alerts",
-         labelloc=t, fontsize=14, fontname="Helvetica"]
-  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
-  edge [fontname="Helvetica", fontsize=8]
+    labelloc=t,
+    fontname="Helvetica",
+    fontsize=16,
+    fontcolor="#e6edf3",
+    bgcolor="#0d1117",
+    pad="0.4",
+    nodesep=0.35,
+    ranksep=0.55]
+  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
+        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
+        penwidth=1.2, margin="0.22,0.14"]
+  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
 
   subgraph cluster_set {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="SettingsView.swift  (openSettingsBtn)"
     ad [label="Argyll dir  TextField+Browse\nempty => bundled sidecars"]
     di [label="Default instrument  Picker\nNone + i1/p3/CM/SS/20/22/41/51\nseeds Stage 3 + Spot Read\ndoes NOT change instrumentSelect"]
@@ -21,11 +36,23 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_about {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="AboutView.swift"
     ab [label="aboutDialog\naboutVersion, aboutBuildDate\ncloseAboutBtn  Esc"]
   }
 
   subgraph cluster_sp {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="savePresetDialog  PresetDialogs.swift"
     spn [label="savePresetName  TextField"]
     spd [label="savePresetDesc  TextField"]
@@ -34,6 +61,12 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_mp {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="managePresetsDialog"
     prw [label="presetRow-{id}\nBuilt-in: no delete\nelse btnExportPreset-{id}\nbtnDeletePreset-{id}"]
     pim [label="btnImportPreset"]
@@ -42,6 +75,12 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_sm {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="saveMediaRecipeDialog  MediaLibraryDialogs.swift"
     smf [label="saveMediaName/Notes/Paper/Ink  TextField x4"]
     smr [label="saveMediaPrinter/Preset/ColourSpace/Cal  read-only"]
@@ -51,6 +90,12 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_mm {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="manageMediaDialog"
     mll [label="mediaLibraryList\nmediaRow-{id}\nbtnMediaLibraryApply-{id}\nbtnMediaLibraryDelete-{id}\ndouble-click = Apply"]
     mmn [label="manageMediaNotice  Caption\nshown: manageApplyNotice != nil\nin-sheet copy of failed Apply (#170)"]
@@ -61,6 +106,12 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_spot {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="spotReadView  SpotReadView.swift (#148)"
     ssm [label="spotSidecarMissing\nshown: !sidecarAvailable\nhides instrument/transport"]
     sdet [label="btnSpotDetectInstruments\ndisabled: detecting OR running"]
@@ -80,6 +131,12 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_gamut {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="gamutView  GamutView.swift (#147)"
     gls [label="gamutLayer-srgb  Toggle\nsRGB always loaded; can hide"]
     glp [label="gamutLayer-profile  Toggle\ndisabled: no session .gam"]
@@ -97,11 +154,17 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_proj {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Project alerts  RootView + ProjectUI"
     pna [label="projectNewAlert\nbtnProjectNewCancel / Confirm"]
     pda [label="Dirty save alert\nbtnProjectDirtySave\nbtnProjectDirtyDiscard\nbtnProjectDirtyCancel"]
     prs [label="projectRelocateSheet\nshown: cwd missing on Open\nbtnProjectRelocateCancel\nbtnProjectRelocate"]
   }
 
-  mutex [shape=note, label="Mutex\nSpot Read disabled while Stage 3 chartread runs\nOpening Spot Read never kills chartread_{basename}\nFailed media Apply keeps manage sheet open\nWindow noticeText is occluded — use manageMediaNotice"]
+  mutex [shape=note, style=filled, fillcolor="#3d2f00", fontcolor="#f0e6c8", color="#d4a72c", label="Mutex\nSpot Read disabled while Stage 3 chartread runs\nOpening Spot Read never kills chartread_{basename}\nFailed media Apply keeps manage sheet open\nWindow noticeText is occluded — use manageMediaNotice"]
 }
diff --git a/docs/ui-interactive-map-shell.dot b/docs/ui-interactive-map-shell.dot
index 093c6ef..c4727e2 100644
--- a/docs/ui-interactive-map-shell.dot
+++ b/docs/ui-interactive-map-shell.dot
@@ -1,14 +1,29 @@
 digraph ICCeryUIShell {
   graph [label="ICCery UI — shell, sidebar, stepper, File menu\nids are accessibility identifiers. Gating: WizardGating.swift",
-         labelloc=t, fontsize=14, fontname="Helvetica"]
-  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
-  edge [fontname="Helvetica", fontsize=8]
+    labelloc=t,
+    fontname="Helvetica",
+    fontsize=16,
+    fontcolor="#e6edf3",
+    bgcolor="#0d1117",
+    pad="0.4",
+    nodesep=0.35,
+    ranksep=0.55]
+  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
+        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
+        penwidth=1.2, margin="0.22,0.14"]
+  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
 
   win [label="WindowGroup ICCery\nICCeryApp.swift\n1280x800, min 1100x700"]
   root [label="RootView.swift\nsheets and alerts live here"]
   win -> root
 
   subgraph cluster_chrome {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Persistent chrome"
     side [label="SidebarView.swift\n270 pt"]
     ban [label="noticeText  NoticeBanner.swift\nshown: wizard.notice != nil\nauto-hide 6s; close has no id"]
@@ -19,6 +34,12 @@ digraph ICCeryUIShell {
   root -> stage
 
   subgraph cluster_header {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Header"
     sSet [label="openSettingsBtn  Button\nalways on → Settings sheet"]
     sAbt [label="openAboutBtn  Button\nalways on → About"]
@@ -29,6 +50,12 @@ digraph ICCeryUIShell {
   side -> sHlp
 
   subgraph cluster_preset {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Presets (#11)"
     pre [label="presetSelect  Picker.menu\nnone + ProfilingPreset.id\napply on change; none is not factory reset"]
     preS [label="btnSavePresetModal  Button\nalways on"]
@@ -39,6 +66,12 @@ digraph ICCeryUIShell {
   side -> preM
 
   subgraph cluster_media {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Media library (#146)"
     med [label="mediaSelect  Picker.menu\nnone + MediaRecipe.id\nnever reuses presetSelect"]
     medSt [label="mediaRecipeStale  Caption\nshown: staleReasons nonempty"]
@@ -51,6 +84,12 @@ digraph ICCeryUIShell {
   side -> medM
 
   subgraph cluster_studio {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Studio (not stepper)"
     calB [label="btnCalibratePrinter  Button\nalways on; Stage 0"]
     gamB [label="btnViewGamut  Button\nSAME id as Stage 5\nalways on; no .gam = sRGB only"]
@@ -61,14 +100,26 @@ digraph ICCeryUIShell {
   side -> spotB
 
   subgraph cluster_step {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Stepper 1-5 (disk is truth)"
     step [label="StepperRow  Button.plain\ndisabled/opacity 0.45 unless isUnlocked\nbackward always; calibrate is not a row"]
-    nGate [shape=note, label="WizardGating.swift\n1 always\n2 .ti1\n3 .ti1 AND .ti2\n4 .ti3 (not .ti2 alone)\n5 .ti3 AND .icc/.icm\nre-probe on window key (#151)"]
+    nGate [shape=note, style=filled, fillcolor="#3d2f00", fontcolor="#f0e6c8", color="#d4a72c", label="WizardGating.swift\n1 always\n2 .ti1\n3 .ti1 AND .ti2\n4 .ti3 (not .ti2 alone)\n5 .ti3 AND .icc/.icm\nre-probe on window key (#151)"]
   }
   side -> step
   step -> nGate [style=dashed]
 
   subgraph cluster_chip {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="projectChip  ProjectUI.swift (#149)"
     cn [label="projectChipName\nbound name or No project"]
     cp [label="projectChipPath\nshown if bound"]
@@ -85,6 +136,12 @@ digraph ICCeryUIShell {
   side -> co
 
   subgraph cluster_menu {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="File menu  ProjectCommands / ICCeryApp.swift"
     mN [label="menuProjectNew  Cmd-N"]
     mO [label="menuProjectOpen  Cmd-O"]
diff --git a/docs/ui-interactive-map-stage1-2.dot b/docs/ui-interactive-map-stage1-2.dot
index 5a4872e..1be2da5 100644
--- a/docs/ui-interactive-map-stage1-2.dot
+++ b/docs/ui-interactive-map-stage1-2.dot
@@ -1,10 +1,25 @@
 digraph ICCeryUIStage12 {
   graph [label="ICCery UI — Stage 1 Generate Target / Stage 2 Lay Out and Print",
-         labelloc=t, fontsize=14, fontname="Helvetica"]
-  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
-  edge [fontname="Helvetica", fontsize=8]
+    labelloc=t,
+    fontname="Helvetica",
+    fontsize=16,
+    fontcolor="#e6edf3",
+    bgcolor="#0d1117",
+    pad="0.4",
+    nodesep=0.35,
+    ranksep=0.55]
+  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
+        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
+        penwidth=1.2, margin="0.22,0.14"]
+  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
 
   subgraph cluster_s1 {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="stage-1  Stage1View.swift"
     csp [label="colourSpace  Picker.segmented\nRGB | CMYK"]
     pcp [label="patchCountPreset  Picker"]
@@ -23,6 +38,12 @@ digraph ICCeryUIStage12 {
   }
 
   subgraph cluster_adv {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Advanced (hidden until disclosure open)"
     ag [label="targenGreySteps  Toggle+TextField\nfield iff toggle on"]
     as1 [label="targenSingleChannelSteps  Toggle+TextField"]
@@ -40,6 +61,12 @@ digraph ICCeryUIStage12 {
   adv -> ag [style=dashed]
 
   subgraph cluster_s2 {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="stage-2  Stage2View.swift"
     cmw [label="cmWarningBanner  always visible, not a control"]
     ins [label="instrumentSelect  Picker\nPrintInstrument chart code, NOT USB port"]
@@ -61,6 +88,12 @@ digraph ICCeryUIStage12 {
   }
 
   subgraph cluster_print {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="rawPrintPanel"
     ps [label="printerSelect  Picker  CUPS queues"]
     psb [label="printerStatusBadge\nshown: selected printer in list"]
diff --git a/docs/ui-interactive-map-stage3-5-cal.dot b/docs/ui-interactive-map-stage3-5-cal.dot
index 5ac2d89..8b94efc 100644
--- a/docs/ui-interactive-map-stage3-5-cal.dot
+++ b/docs/ui-interactive-map-stage3-5-cal.dot
@@ -1,10 +1,25 @@
 digraph ICCeryUIStage345Cal {
   graph [label="ICCery UI — Stage 3 Measure / 4 Build / 5 Verify / Stage 0 Calibrate",
-         labelloc=t, fontsize=14, fontname="Helvetica"]
-  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
-  edge [fontname="Helvetica", fontsize=8]
+    labelloc=t,
+    fontname="Helvetica",
+    fontsize=16,
+    fontcolor="#e6edf3",
+    bgcolor="#0d1117",
+    pad="0.4",
+    nodesep=0.35,
+    ranksep=0.55]
+  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
+        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
+        penwidth=1.2, margin="0.22,0.14"]
+  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
 
   subgraph cluster_s3 {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="stage-3  Stage3View.swift / MeasurementWorkflowViewModel"
     d3 [label="btnDetectInstruments  Button\ndisabled: isDetecting"]
     i3 [label="chartreadInstrumentSelect  Picker.menu\nAuto + instlist ports"]
@@ -28,6 +43,12 @@ digraph ICCeryUIStage345Cal {
   }
 
   subgraph cluster_s4 {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="stage-4  Stage4View.swift / ProfileWorkflowViewModel"
     alg [label="colprofAlgorithm  Picker"]
     q [label="colprofQuality  Picker"]
@@ -48,6 +69,12 @@ digraph ICCeryUIStage345Cal {
   }
 
   subgraph cluster_s5 {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="stage-5  Stage5View.swift"
     vf [label="btnVerifyProfile  Button\ndisabled: !canVerify\ncanVerify: createdProfileURL AND !profcheckRunning"]
     ppi [label="profcheckProgressIndicator\nshown: isProfcheckRunning"]
@@ -62,6 +89,12 @@ digraph ICCeryUIStage345Cal {
   }
 
   subgraph cluster_coll {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Install collision alert"
     io [label="profileOverwriteBtn"]
     ir [label="profileRenameBtn"]
@@ -69,6 +102,12 @@ digraph ICCeryUIStage345Cal {
   }
 
   subgraph cluster_cal {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="stage-cal  CalibrationView.swift (Stage 0)"
     ccs [label="Colour Space  Picker.segmented\nRGB | CMYK  (no a11y id)"]
     cst [label="calSteps  TextField.number"]
diff --git a/docs/ui-interactive-map.md b/docs/ui-interactive-map.md
index 4a250c8..cf4da03 100644
--- a/docs/ui-interactive-map.md
+++ b/docs/ui-interactive-map.md
@@ -1,6 +1,9 @@
 # Interactive UI map
-One GraphViz diagram per section so Gitea Kroki (0.30.1) can render them.
-These are **GraphViz**, not PlantUML: Kroki 0.30.1 ships PlantUML as a GraalVM native image that requires AVX2. This host does not have AVX2, so PlantUML returns 400 / SIGILL. `dot` in the same image does not.
+
+GraphViz diagrams for Gitea Kroki 0.30.1 (PlantUML's Graal image needs AVX2; this host has none).
+
+Colours are set **inside the SVG** (dark fill, light type, opaque background) so Gitea dark mode does not turn nodes into black boxes on a transparent canvas.
+
 Node labels are accessibility identifiers, source files, and enable / hide / disable rules.
 
 ## Shell
@@ -10,15 +13,30 @@ Window, sidebar, stepper, File menu. Source: [`ui-interactive-map-shell.dot`](ui
 ```graphviz
 digraph ICCeryUIShell {
   graph [label="ICCery UI — shell, sidebar, stepper, File menu\nids are accessibility identifiers. Gating: WizardGating.swift",
-         labelloc=t, fontsize=14, fontname="Helvetica"]
-  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
-  edge [fontname="Helvetica", fontsize=8]
+    labelloc=t,
+    fontname="Helvetica",
+    fontsize=16,
+    fontcolor="#e6edf3",
+    bgcolor="#0d1117",
+    pad="0.4",
+    nodesep=0.35,
+    ranksep=0.55]
+  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
+        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
+        penwidth=1.2, margin="0.22,0.14"]
+  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
 
   win [label="WindowGroup ICCery\nICCeryApp.swift\n1280x800, min 1100x700"]
   root [label="RootView.swift\nsheets and alerts live here"]
   win -> root
 
   subgraph cluster_chrome {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Persistent chrome"
     side [label="SidebarView.swift\n270 pt"]
     ban [label="noticeText  NoticeBanner.swift\nshown: wizard.notice != nil\nauto-hide 6s; close has no id"]
@@ -29,6 +47,12 @@ digraph ICCeryUIShell {
   root -> stage
 
   subgraph cluster_header {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Header"
     sSet [label="openSettingsBtn  Button\nalways on → Settings sheet"]
     sAbt [label="openAboutBtn  Button\nalways on → About"]
@@ -39,6 +63,12 @@ digraph ICCeryUIShell {
   side -> sHlp
 
   subgraph cluster_preset {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Presets (#11)"
     pre [label="presetSelect  Picker.menu\nnone + ProfilingPreset.id\napply on change; none is not factory reset"]
     preS [label="btnSavePresetModal  Button\nalways on"]
@@ -49,6 +79,12 @@ digraph ICCeryUIShell {
   side -> preM
 
   subgraph cluster_media {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Media library (#146)"
     med [label="mediaSelect  Picker.menu\nnone + MediaRecipe.id\nnever reuses presetSelect"]
     medSt [label="mediaRecipeStale  Caption\nshown: staleReasons nonempty"]
@@ -61,6 +97,12 @@ digraph ICCeryUIShell {
   side -> medM
 
   subgraph cluster_studio {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Studio (not stepper)"
     calB [label="btnCalibratePrinter  Button\nalways on; Stage 0"]
     gamB [label="btnViewGamut  Button\nSAME id as Stage 5\nalways on; no .gam = sRGB only"]
@@ -71,14 +113,26 @@ digraph ICCeryUIShell {
   side -> spotB
 
   subgraph cluster_step {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Stepper 1-5 (disk is truth)"
     step [label="StepperRow  Button.plain\ndisabled/opacity 0.45 unless isUnlocked\nbackward always; calibrate is not a row"]
-    nGate [shape=note, label="WizardGating.swift\n1 always\n2 .ti1\n3 .ti1 AND .ti2\n4 .ti3 (not .ti2 alone)\n5 .ti3 AND .icc/.icm\nre-probe on window key (#151)"]
+    nGate [shape=note, style=filled, fillcolor="#3d2f00", fontcolor="#f0e6c8", color="#d4a72c", label="WizardGating.swift\n1 always\n2 .ti1\n3 .ti1 AND .ti2\n4 .ti3 (not .ti2 alone)\n5 .ti3 AND .icc/.icm\nre-probe on window key (#151)"]
   }
   side -> step
   step -> nGate [style=dashed]
 
   subgraph cluster_chip {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="projectChip  ProjectUI.swift (#149)"
     cn [label="projectChipName\nbound name or No project"]
     cp [label="projectChipPath\nshown if bound"]
@@ -95,6 +149,12 @@ digraph ICCeryUIShell {
   side -> co
 
   subgraph cluster_menu {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="File menu  ProjectCommands / ICCeryApp.swift"
     mN [label="menuProjectNew  Cmd-N"]
     mO [label="menuProjectOpen  Cmd-O"]
@@ -127,11 +187,26 @@ Generate Target, Lay Out and Print. Source: [`ui-interactive-map-stage1-2.dot`](
 ```graphviz
 digraph ICCeryUIStage12 {
   graph [label="ICCery UI — Stage 1 Generate Target / Stage 2 Lay Out and Print",
-         labelloc=t, fontsize=14, fontname="Helvetica"]
-  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
-  edge [fontname="Helvetica", fontsize=8]
+    labelloc=t,
+    fontname="Helvetica",
+    fontsize=16,
+    fontcolor="#e6edf3",
+    bgcolor="#0d1117",
+    pad="0.4",
+    nodesep=0.35,
+    ranksep=0.55]
+  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
+        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
+        penwidth=1.2, margin="0.22,0.14"]
+  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
 
   subgraph cluster_s1 {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="stage-1  Stage1View.swift"
     csp [label="colourSpace  Picker.segmented\nRGB | CMYK"]
     pcp [label="patchCountPreset  Picker"]
@@ -150,6 +225,12 @@ digraph ICCeryUIStage12 {
   }
 
   subgraph cluster_adv {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Advanced (hidden until disclosure open)"
     ag [label="targenGreySteps  Toggle+TextField\nfield iff toggle on"]
     as1 [label="targenSingleChannelSteps  Toggle+TextField"]
@@ -167,6 +248,12 @@ digraph ICCeryUIStage12 {
   adv -> ag [style=dashed]
 
   subgraph cluster_s2 {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="stage-2  Stage2View.swift"
     cmw [label="cmWarningBanner  always visible, not a control"]
     ins [label="instrumentSelect  Picker\nPrintInstrument chart code, NOT USB port"]
@@ -188,6 +275,12 @@ digraph ICCeryUIStage12 {
   }
 
   subgraph cluster_print {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="rawPrintPanel"
     ps [label="printerSelect  Picker  CUPS queues"]
     psb [label="printerStatusBadge\nshown: selected printer in list"]
@@ -211,11 +304,26 @@ Measure, Build, Verify, Stage 0. Source: [`ui-interactive-map-stage3-5-cal.dot`]
 ```graphviz
 digraph ICCeryUIStage345Cal {
   graph [label="ICCery UI — Stage 3 Measure / 4 Build / 5 Verify / Stage 0 Calibrate",
-         labelloc=t, fontsize=14, fontname="Helvetica"]
-  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
-  edge [fontname="Helvetica", fontsize=8]
+    labelloc=t,
+    fontname="Helvetica",
+    fontsize=16,
+    fontcolor="#e6edf3",
+    bgcolor="#0d1117",
+    pad="0.4",
+    nodesep=0.35,
+    ranksep=0.55]
+  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
+        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
+        penwidth=1.2, margin="0.22,0.14"]
+  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
 
   subgraph cluster_s3 {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="stage-3  Stage3View.swift / MeasurementWorkflowViewModel"
     d3 [label="btnDetectInstruments  Button\ndisabled: isDetecting"]
     i3 [label="chartreadInstrumentSelect  Picker.menu\nAuto + instlist ports"]
@@ -239,6 +347,12 @@ digraph ICCeryUIStage345Cal {
   }
 
   subgraph cluster_s4 {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="stage-4  Stage4View.swift / ProfileWorkflowViewModel"
     alg [label="colprofAlgorithm  Picker"]
     q [label="colprofQuality  Picker"]
@@ -259,6 +373,12 @@ digraph ICCeryUIStage345Cal {
   }
 
   subgraph cluster_s5 {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="stage-5  Stage5View.swift"
     vf [label="btnVerifyProfile  Button\ndisabled: !canVerify\ncanVerify: createdProfileURL AND !profcheckRunning"]
     ppi [label="profcheckProgressIndicator\nshown: isProfcheckRunning"]
@@ -273,6 +393,12 @@ digraph ICCeryUIStage345Cal {
   }
 
   subgraph cluster_coll {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Install collision alert"
     io [label="profileOverwriteBtn"]
     ir [label="profileRenameBtn"]
@@ -280,6 +406,12 @@ digraph ICCeryUIStage345Cal {
   }
 
   subgraph cluster_cal {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="stage-cal  CalibrationView.swift (Stage 0)"
     ccs [label="Colour Space  Picker.segmented\nRGB | CMYK  (no a11y id)"]
     cst [label="calSteps  TextField.number"]
@@ -303,11 +435,26 @@ Settings, Spot Read, Gamut, media, project alerts. Source: [`ui-interactive-map-
 ```graphviz
 digraph ICCeryUISheets {
   graph [label="ICCery UI — sheets, Spot Read, Gamut, Settings, project alerts",
-         labelloc=t, fontsize=14, fontname="Helvetica"]
-  node [shape=box, style=rounded, fontname="Helvetica", fontsize=9]
-  edge [fontname="Helvetica", fontsize=8]
+    labelloc=t,
+    fontname="Helvetica",
+    fontsize=16,
+    fontcolor="#e6edf3",
+    bgcolor="#0d1117",
+    pad="0.4",
+    nodesep=0.35,
+    ranksep=0.55]
+  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
+        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
+        penwidth=1.2, margin="0.22,0.14"]
+  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
 
   subgraph cluster_set {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="SettingsView.swift  (openSettingsBtn)"
     ad [label="Argyll dir  TextField+Browse\nempty => bundled sidecars"]
     di [label="Default instrument  Picker\nNone + i1/p3/CM/SS/20/22/41/51\nseeds Stage 3 + Spot Read\ndoes NOT change instrumentSelect"]
@@ -324,11 +471,23 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_about {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="AboutView.swift"
     ab [label="aboutDialog\naboutVersion, aboutBuildDate\ncloseAboutBtn  Esc"]
   }
 
   subgraph cluster_sp {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="savePresetDialog  PresetDialogs.swift"
     spn [label="savePresetName  TextField"]
     spd [label="savePresetDesc  TextField"]
@@ -337,6 +496,12 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_mp {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="managePresetsDialog"
     prw [label="presetRow-{id}\nBuilt-in: no delete\nelse btnExportPreset-{id}\nbtnDeletePreset-{id}"]
     pim [label="btnImportPreset"]
@@ -345,6 +510,12 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_sm {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="saveMediaRecipeDialog  MediaLibraryDialogs.swift"
     smf [label="saveMediaName/Notes/Paper/Ink  TextField x4"]
     smr [label="saveMediaPrinter/Preset/ColourSpace/Cal  read-only"]
@@ -354,6 +525,12 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_mm {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="manageMediaDialog"
     mll [label="mediaLibraryList\nmediaRow-{id}\nbtnMediaLibraryApply-{id}\nbtnMediaLibraryDelete-{id}\ndouble-click = Apply"]
     mmn [label="manageMediaNotice  Caption\nshown: manageApplyNotice != nil\nin-sheet copy of failed Apply (#170)"]
@@ -364,6 +541,12 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_spot {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="spotReadView  SpotReadView.swift (#148)"
     ssm [label="spotSidecarMissing\nshown: !sidecarAvailable\nhides instrument/transport"]
     sdet [label="btnSpotDetectInstruments\ndisabled: detecting OR running"]
@@ -383,6 +566,12 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_gamut {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="gamutView  GamutView.swift (#147)"
     gls [label="gamutLayer-srgb  Toggle\nsRGB always loaded; can hide"]
     glp [label="gamutLayer-profile  Toggle\ndisabled: no session .gam"]
@@ -400,12 +589,18 @@ digraph ICCeryUISheets {
   }
 
   subgraph cluster_proj {
+    style="filled,rounded"
+    fillcolor="#161b22"
+    color="#30363d"
+    fontcolor="#79c0ff"
+    fontsize=13
+
     label="Project alerts  RootView + ProjectUI"
     pna [label="projectNewAlert\nbtnProjectNewCancel / Confirm"]
     pda [label="Dirty save alert\nbtnProjectDirtySave\nbtnProjectDirtyDiscard\nbtnProjectDirtyCancel"]
     prs [label="projectRelocateSheet\nshown: cwd missing on Open\nbtnProjectRelocateCancel\nbtnProjectRelocate"]
   }
 
-  mutex [shape=note, label="Mutex\nSpot Read disabled while Stage 3 chartread runs\nOpening Spot Read never kills chartread_{basename}\nFailed media Apply keeps manage sheet open\nWindow noticeText is occluded — use manageMediaNotice"]
+  mutex [shape=note, style=filled, fillcolor="#3d2f00", fontcolor="#f0e6c8", color="#d4a72c", label="Mutex\nSpot Read disabled while Stage 3 chartread runs\nOpening Spot Read never kills chartread_{basename}\nFailed media Apply keeps manage sheet open\nWindow noticeText is occluded — use manageMediaNotice"]
 }
 ```
-- 
2.39.5


From 191bcb02804f3618d6654471aa3a740a00a86bf0 Mon Sep 17 00:00:00 2001
From: gronod <gronod@users.noreply.git.i3omb.com>
Date: Mon, 14 Sep 2026 14:44:59 +0000
Subject: [PATCH 6/8] docs: replace hairball graphs with small overviews and
 tables

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.
---
 docs/ui-interactive-map-sheets.dot       |  185 +---
 docs/ui-interactive-map-shell.dot        |  190 +---
 docs/ui-interactive-map-stage1-2.dot     |  127 +--
 docs/ui-interactive-map-stage3-5-cal.dot |  145 +--
 docs/ui-interactive-map.md               | 1017 ++++++++++------------
 5 files changed, 535 insertions(+), 1129 deletions(-)

diff --git a/docs/ui-interactive-map-sheets.dot b/docs/ui-interactive-map-sheets.dot
index 8fe87ab..c370b6e 100644
--- a/docs/ui-interactive-map-sheets.dot
+++ b/docs/ui-interactive-map-sheets.dot
@@ -1,170 +1,21 @@
 digraph ICCeryUISheets {
-  graph [label="ICCery UI — sheets, Spot Read, Gamut, Settings, project alerts",
-    labelloc=t,
-    fontname="Helvetica",
-    fontsize=16,
-    fontcolor="#e6edf3",
-    bgcolor="#0d1117",
-    pad="0.4",
-    nodesep=0.35,
-    ranksep=0.55]
-  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
-        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
-        penwidth=1.2, margin="0.22,0.14"]
-  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
+  bgcolor=white
+  fontcolor=black
+  pad=0.4
+  rankdir=TB
+  nodesep=0.4
+  ranksep=0.5
+  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
+  edge [color=black]
 
-  subgraph cluster_set {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="SettingsView.swift  (openSettingsBtn)"
-    ad [label="Argyll dir  TextField+Browse\nempty => bundled sidecars"]
-    di [label="Default instrument  Picker\nNone + i1/p3/CM/SS/20/22/41/51\nseeds Stage 3 + Spot Read\ndoes NOT change instrumentSelect"]
-    led [label="Enable i1Pro 2 LEDs  Toggle"]
-    dg [label="settingsDeltaEGood  TextField"]
-    dw [label="settingsDeltaEWarning  TextField\nSave refuses unless Warning > Good"]
-    sd [label="settingsCalStaleDays  TextField"]
-    il [label="Install location  Picker\nUser | System library"]
-    ao [label="Ask before overwriting  Toggle"]
-    oc [label="Open ColorSync after install  Toggle"]
-    ll [label="Log level  Picker"]
-    lg [label="Open log folder / Copy path / Copy excerpt"]
-    ss [label="Cancel / Save\nSave stays if validation fails\nframe 560x620"]
-  }
-
-  subgraph cluster_about {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="AboutView.swift"
-    ab [label="aboutDialog\naboutVersion, aboutBuildDate\ncloseAboutBtn  Esc"]
-  }
-
-  subgraph cluster_sp {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="savePresetDialog  PresetDialogs.swift"
-    spn [label="savePresetName  TextField"]
-    spd [label="savePresetDesc  TextField"]
-    spc [label="btnCloseSavePresetDialog"]
-    sps [label="btnConfirmSavePreset\ndisabled: name trimmed empty"]
-  }
-
-  subgraph cluster_mp {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="managePresetsDialog"
-    prw [label="presetRow-{id}\nBuilt-in: no delete\nelse btnExportPreset-{id}\nbtnDeletePreset-{id}"]
-    pim [label="btnImportPreset"]
-    pea [label="btnExportActivePreset\nshown: selected custom preset"]
-    pcl [label="btnCloseManagePresetsDialog"]
-  }
-
-  subgraph cluster_sm {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="saveMediaRecipeDialog  MediaLibraryDialogs.swift"
-    smf [label="saveMediaName/Notes/Paper/Ink  TextField x4"]
-    smr [label="saveMediaPrinter/Preset/ColourSpace/Cal  read-only"]
-    smc [label="saveMediaApplyCal  Toggle\ndisabled: !calApplyable\ncalApplyable: path exists, not CAL_"]
-    smx [label="btnCloseSaveMediaDialog"]
-    sms [label="btnConfirmSaveMedia\ndisabled: name|paper|ink empty\nOR colour-space mismatch"]
-  }
-
-  subgraph cluster_mm {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="manageMediaDialog"
-    mll [label="mediaLibraryList\nmediaRow-{id}\nbtnMediaLibraryApply-{id}\nbtnMediaLibraryDelete-{id}\ndouble-click = Apply"]
-    mmn [label="manageMediaNotice  Caption\nshown: manageApplyNotice != nil\nin-sheet copy of failed Apply (#170)"]
-    mla [label="btnMediaLibraryApply\ndisabled: selection == nil"]
-    mlc [label="btnMediaLibraryCaptureFromManage\ndismiss then open capture"]
-    mlx [label="btnCloseManageMediaDialog"]
-    mld [label="Delete alert  Cancel / Delete"]
-  }
-
-  subgraph cluster_spot {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="spotReadView  SpotReadView.swift (#148)"
-    ssm [label="spotSidecarMissing\nshown: !sidecarAvailable\nhides instrument/transport"]
-    sdet [label="btnSpotDetectInstruments\ndisabled: detecting OR running"]
-    sis [label="spotInstrumentSelect  Picker\ndisabled: isRunning"]
-    sdm [label="spotDefaultMissing\nshown: defaultMissing"]
-    ssd [label="spotSetDefault  Toggle"]
-    sxy [label="spotXYHint  shown: selected is XY"]
-    sst [label="btnSpotStart\nshown: !isRunning\ndisabled: !canStart\ncanStart: sidecar, !detecting, !running,\n!chartreadRunning, cwd"]
-    sca [label="btnSpotCalibrate\nshown: running AND calibrating"]
-    str [label="btnSpotTrigger  Read\nshown: running AND awaitingStrip"]
-    ssp [label="btnSpotStop  shown: isRunning"]
-    sls [label="spotLastSample / Lab / XYZ / DeltaE\nspotLabImplausible if L not 0..100\nspotDeltaE hidden on first sample"]
-    sht [label="spotHistoryTable\nrows: spotHistoryRow-{uuid}\nclick restores sample, no trigger"]
-    scp [label="btnSpotCopyLab\ndisabled: displayedSample == nil"]
-    sex [label="btnSpotExportCsv\ndisabled: samples empty"]
-    scl [label="btnCloseSpotRead  Esc; onDismiss = Stop"]
-  }
-
-  subgraph cluster_gamut {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="gamutView  GamutView.swift (#147)"
-    gls [label="gamutLayer-srgb  Toggle\nsRGB always loaded; can hide"]
-    glp [label="gamutLayer-profile  Toggle\ndisabled: no session .gam"]
-    glc [label="gamutLayer-compare  Toggle\ndisabled: no compare layer"]
-    gac [label="btnGamutAddCompare  Menu\nbtnGamutOpenGam / btnGamutOpenProfile"]
-    grc [label="btnGamutRemoveCompare\ndisabled: compare layer nil"]
-    gst [label="btnGamutSampleTiff"]
-    gun [label="gamutViewerUnavailable\nshown: no Metal\ntoggles + inspect still enabled"]
-    grs [label="btnResetGamutCamera  R"]
-    gle [label="gamutLabEntryL/A/B  TextField x3"]
-    gin [label="btnGamutInspectLab\ndisabled: !canInspectLab"]
-    gip [label="gamutInspectPanel"]
-    gcl [label="btnCloseGamut  Esc"]
-    gtf [label="gamutTiffPreview sheet\nshowingTiffPreview\nbtnCloseGamutTiffPreview"]
-  }
-
-  subgraph cluster_proj {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Project alerts  RootView + ProjectUI"
-    pna [label="projectNewAlert\nbtnProjectNewCancel / Confirm"]
-    pda [label="Dirty save alert\nbtnProjectDirtySave\nbtnProjectDirtyDiscard\nbtnProjectDirtyCancel"]
-    prs [label="projectRelocateSheet\nshown: cwd missing on Open\nbtnProjectRelocateCancel\nbtnProjectRelocate"]
-  }
-
-  mutex [shape=note, style=filled, fillcolor="#3d2f00", fontcolor="#f0e6c8", color="#d4a72c", label="Mutex\nSpot Read disabled while Stage 3 chartread runs\nOpening Spot Read never kills chartread_{basename}\nFailed media Apply keeps manage sheet open\nWindow noticeText is occluded — use manageMediaNotice"]
+  Root [label="RootView.swift hosts every sheet"]
+  Root -> Settings
+  Root -> About
+  Root -> savePresetDialog
+  Root -> managePresetsDialog
+  Root -> saveMediaRecipeDialog
+  Root -> manageMediaDialog
+  Root -> spotReadView
+  Root -> gamutView
+  Root -> ProjectAlerts
 }
diff --git a/docs/ui-interactive-map-shell.dot b/docs/ui-interactive-map-shell.dot
index c4727e2..cf7f2b2 100644
--- a/docs/ui-interactive-map-shell.dot
+++ b/docs/ui-interactive-map-shell.dot
@@ -1,167 +1,33 @@
 digraph ICCeryUIShell {
-  graph [label="ICCery UI — shell, sidebar, stepper, File menu\nids are accessibility identifiers. Gating: WizardGating.swift",
-    labelloc=t,
-    fontname="Helvetica",
-    fontsize=16,
-    fontcolor="#e6edf3",
-    bgcolor="#0d1117",
-    pad="0.4",
-    nodesep=0.35,
-    ranksep=0.55]
-  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
-        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
-        penwidth=1.2, margin="0.22,0.14"]
-  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
+  bgcolor=white
+  fontcolor=black
+  pad=0.4
+  rankdir=TB
+  nodesep=0.4
+  ranksep=0.5
+  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
+  edge [color=black]
 
-  win [label="WindowGroup ICCery\nICCeryApp.swift\n1280x800, min 1100x700"]
-  root [label="RootView.swift\nsheets and alerts live here"]
-  win -> root
+  Window [label="WindowGroup  ICCeryApp.swift"]
+  Root [label="RootView.swift\nsheets and alerts"]
+  Sidebar [label="SidebarView.swift  270pt"]
+  Banner [label="noticeText  NoticeBanner"]
+  Stage [label="WizardStageContent"]
 
-  subgraph cluster_chrome {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
+  Window -> Root
+  Root -> Sidebar
+  Root -> Banner
+  Root -> Stage
 
-    label="Persistent chrome"
-    side [label="SidebarView.swift\n270 pt"]
-    ban [label="noticeText  NoticeBanner.swift\nshown: wizard.notice != nil\nauto-hide 6s; close has no id"]
-    stage [label="WizardStageContent\nswitch wizard.stage"]
-  }
-  root -> side
-  root -> ban
-  root -> stage
-
-  subgraph cluster_header {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Header"
-    sSet [label="openSettingsBtn  Button\nalways on → Settings sheet"]
-    sAbt [label="openAboutBtn  Button\nalways on → About"]
-    sHlp [label="btnToggleAllHelp  Button\ntoggles showingAllHelp overlays"]
-  }
-  side -> sSet
-  side -> sAbt
-  side -> sHlp
-
-  subgraph cluster_preset {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Presets (#11)"
-    pre [label="presetSelect  Picker.menu\nnone + ProfilingPreset.id\napply on change; none is not factory reset"]
-    preS [label="btnSavePresetModal  Button\nalways on"]
-    preM [label="btnOpenPresetsDialog  Button\nalways on"]
-  }
-  side -> pre
-  side -> preS
-  side -> preM
-
-  subgraph cluster_media {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Media library (#146)"
-    med [label="mediaSelect  Picker.menu\nnone + MediaRecipe.id\nnever reuses presetSelect"]
-    medSt [label="mediaRecipeStale  Caption\nshown: staleReasons nonempty"]
-    medC [label="btnMediaLibraryCapture  Button\ndisabled: selectedPrinter empty"]
-    medM [label="btnMediaLibraryManage  Button\nalways on"]
-  }
-  side -> med
-  side -> medSt
-  side -> medC
-  side -> medM
-
-  subgraph cluster_studio {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Studio (not stepper)"
-    calB [label="btnCalibratePrinter  Button\nalways on; Stage 0"]
-    gamB [label="btnViewGamut  Button\nSAME id as Stage 5\nalways on; no .gam = sRGB only"]
-    spotB [label="btnSpotRead  Button\ndisabled: no cwd OR chartread running"]
-  }
-  side -> calB
-  side -> gamB
-  side -> spotB
-
-  subgraph cluster_step {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Stepper 1-5 (disk is truth)"
-    step [label="StepperRow  Button.plain\ndisabled/opacity 0.45 unless isUnlocked\nbackward always; calibrate is not a row"]
-    nGate [shape=note, style=filled, fillcolor="#3d2f00", fontcolor="#f0e6c8", color="#d4a72c", label="WizardGating.swift\n1 always\n2 .ti1\n3 .ti1 AND .ti2\n4 .ti3 (not .ti2 alone)\n5 .ti3 AND .icc/.icm\nre-probe on window key (#151)"]
-  }
-  side -> step
-  step -> nGate [style=dashed]
-
-  subgraph cluster_chip {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="projectChip  ProjectUI.swift (#149)"
-    cn [label="projectChipName\nbound name or No project"]
-    cp [label="projectChipPath\nshown if bound"]
-    cs [label="projectChipStale\nshown: diskBehindNotes"]
-    cr [label="btnProjectReveal\nshown if bound"]
-    csv [label="btnProjectSave\nshown if bound\ndisabled: !canSave\ncanSave: bound + basename + cwd\nCAL_ still enabled (refusal banner)"]
-    co [label="btnProjectOpen\nshown if NOT bound"]
-  }
-  side -> cn
-  side -> cp
-  side -> cs
-  side -> cr
-  side -> csv
-  side -> co
-
-  subgraph cluster_menu {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="File menu  ProjectCommands / ICCeryApp.swift"
-    mN [label="menuProjectNew  Cmd-N"]
-    mO [label="menuProjectOpen  Cmd-O"]
-    mR [label="menuProjectRecents  Menu\ndisabled: recents empty\nprojectRecent-{hash}\nmenuProjectRecentsClear"]
-    mS [label="menuProjectSave  Cmd-S\ndisabled: !canSave"]
-    mSa [label="menuProjectSaveAs  Shift-Cmd-S\ndisabled: !canSaveAs\ncanSaveAs: basename + cwd"]
-    mRp [label="menuProjectReport\ndisabled: !canReport"]
-    mCl [label="menuProjectClose\ndisabled: !isBound"]
-  }
-
-  st1 [label="stage-1  Stage1View.swift"]
-  st2 [label="stage-2  Stage2View.swift"]
-  st3 [label="stage-3  Stage3View.swift"]
-  st4 [label="stage-4  Stage4View.swift"]
-  st5 [label="stage-5  Stage5View.swift"]
-  st0 [label="stage-cal  CalibrationView.swift"]
-  stage -> st1
-  stage -> st2
-  stage -> st3
-  stage -> st4
-  stage -> st5
-  stage -> st0
+  Sidebar -> Presets
+  Sidebar -> Media
+  Sidebar -> Studio
+  Sidebar -> Stepper
+  Sidebar -> ProjectChip
+  Stage -> S1 [label="stage-1"]
+  Stage -> S2 [label="stage-2"]
+  Stage -> S3 [label="stage-3"]
+  Stage -> S4 [label="stage-4"]
+  Stage -> S5 [label="stage-5"]
+  Stage -> Cal [label="stage-cal"]
 }
diff --git a/docs/ui-interactive-map-stage1-2.dot b/docs/ui-interactive-map-stage1-2.dot
index 1be2da5..b3e6fb1 100644
--- a/docs/ui-interactive-map-stage1-2.dot
+++ b/docs/ui-interactive-map-stage1-2.dot
@@ -1,110 +1,25 @@
 digraph ICCeryUIStage12 {
-  graph [label="ICCery UI — Stage 1 Generate Target / Stage 2 Lay Out and Print",
-    labelloc=t,
-    fontname="Helvetica",
-    fontsize=16,
-    fontcolor="#e6edf3",
-    bgcolor="#0d1117",
-    pad="0.4",
-    nodesep=0.35,
-    ranksep=0.55]
-  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
-        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
-        penwidth=1.2, margin="0.22,0.14"]
-  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
+  bgcolor=white
+  fontcolor=black
+  pad=0.4
+  rankdir=TB
+  nodesep=0.4
+  ranksep=0.5
+  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
+  edge [color=black]
 
-  subgraph cluster_s1 {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
+  S1 [label="stage-1  Stage1View.swift"]
+  S1 -> colourSpace
+  S1 -> Patches
+  S1 -> TargetFile
+  S1 -> Advanced
+  S1 -> btnGenerate
+  S1 -> targenLog
 
-    label="stage-1  Stage1View.swift"
-    csp [label="colourSpace  Picker.segmented\nRGB | CMYK"]
-    pcp [label="patchCountPreset  Picker"]
-    pcc [label="patchCountCustom  TextField.number\nshown: patchPreset == custom"]
-    wp [label="whitePatches  Stepper  0..50"]
-    bp [label="blackPatches  Stepper  0..50"]
-    tb [label="targetBasename  TextField"]
-    bb [label="btnBrowse  Button"]
-    wd [label="btnSelectWorkDir  Button"]
-    oe [label="btnOpenExisting  Button\n.ti1 or .ti2 (+ matching .ti1)"]
-    imp [label="btn-import-dataset  Button\n.ti3 / txt / cgats / csv\nunlocks stage 4"]
-    spd [label="selectedPathDisplay  Text"]
-    adv [label="targenAdvancedDetails  DisclosureGroup\nUI tests pre-expand"]
-    gen [label="btnGenerate  Button\ndisabled: !canGenerate OR targenRunning\ncanGenerate: valid basename AND directory"]
-    tlog [label="targenLogContainer / targenLog\nProcessLogView.swift"]
-  }
-
-  subgraph cluster_adv {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Advanced (hidden until disclosure open)"
-    ag [label="targenGreySteps  Toggle+TextField\nfield iff toggle on"]
-    as1 [label="targenSingleChannelSteps  Toggle+TextField"]
-    an [label="targenNeutralSteps  Toggle+TextField"]
-    anc [label="targenNeutralConcentration  Toggle+Slider 0..1"]
-    aa [label="targenAdaptation  Toggle+Slider 0..1"]
-    ap [label="targenPrecondProfile  TextField"]
-    apb [label="btnBrowsePrecondProfile  Button"]
-    ahq [label="targenHighQuality  Toggle  OFPS -G"]
-    aal [label="targenAlgorithm  Picker"]
-    ail [label="targenInkLimitGroup  Toggle+TextField\nshown: colourSpace == cmyk"]
-    ad [label="targenDarkEmphasis  Toggle+Slider 0..3"]
-    adp [label="targenDevicePower  Toggle+Slider 0..3"]
-  }
-  adv -> ag [style=dashed]
-
-  subgraph cluster_s2 {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="stage-2  Stage2View.swift"
-    cmw [label="cmWarningBanner  always visible, not a control"]
-    ins [label="instrumentSelect  Picker\nPrintInstrument chart code, NOT USB port"]
-    pgs [label="pageSizeSelect  Picker"]
-    cps [label="customPageSizeRow\nshown: pageSize == custom\ncustomPageW / customPageH mm"]
-    bit [label="bitDepth  Picker  8-bit | 16-bit\n(no a11y id on picker)"]
-    dpi [label="tiffDpi  Stepper  72..600"]
-    lo [label="printtargLayoutOrder  Picker"]
-    seed [label="printtargCustomSeedGroup\nshown: layoutOrder == customSeed\nid printtargCustomSeed"]
-    tle [label="btnToggleLabelEdit  Button\nEdit label / Use automatic"]
-    mp [label="targetMetadataPrinter  TextField"]
-    mi [label="targetMetadataInkSet  TextField"]
-    md [label="targetMetadataDriverPaper  TextField"]
-    ma [label="targetMetadataActualPaper  TextField"]
-    lpv [label="targetLabelPreview  TextField or Text\nTextField iff labelIsCustom"]
-    lay [label="btnCreateLayout  Button\ndisabled: printtargRunning OR basename empty"]
-    plog [label="printtargLogContainer  DisclosureGroup"]
-    gal [label="tiffGallery  shown: printtargResult != nil\ngalleryInfo, galleryGrid\ngalleryPage-{index}\nbtnPrintPage-{index}\nPrint disabled: isPrinting OR no printer"]
-  }
-
-  subgraph cluster_print {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="rawPrintPanel"
-    ps [label="printerSelect  Picker  CUPS queues"]
-    psb [label="printerStatusBadge\nshown: selected printer in list"]
-    prf [label="btnRefreshPrinters  Button"]
-    ppr [label="btnPrinterProperties  Button\ndisabled: selectedPrinter empty"]
-    ptr [label="printerTraySelect  Picker\nshown: trays nonempty"]
-    pmt [label="printerMediaTypeSelect  Picker\nshown: mediaTypes nonempty"]
-    por [label="btnOrientPortrait  Button"]
-    lan [label="btnOrientLandscape  Button"]
-    pal [label="btnPrintAll  Button\ndisabled: isPrinting OR no result OR no printer"]
-    a3 [label="btnAdvanceToStage3  Button\ndisabled: no result OR !isUnlocked(measure)"]
-    pnt [label="printNotificationText\nshown: printNotice != nil"]
-  }
+  S2 [label="stage-2  Stage2View.swift"]
+  S2 -> Layout
+  S2 -> Label
+  S2 -> btnCreateLayout
+  S2 -> tiffGallery
+  S2 -> rawPrintPanel
 }
diff --git a/docs/ui-interactive-map-stage3-5-cal.dot b/docs/ui-interactive-map-stage3-5-cal.dot
index 8b94efc..652682f 100644
--- a/docs/ui-interactive-map-stage3-5-cal.dot
+++ b/docs/ui-interactive-map-stage3-5-cal.dot
@@ -1,124 +1,31 @@
-digraph ICCeryUIStage345Cal {
-  graph [label="ICCery UI — Stage 3 Measure / 4 Build / 5 Verify / Stage 0 Calibrate",
-    labelloc=t,
-    fontname="Helvetica",
-    fontsize=16,
-    fontcolor="#e6edf3",
-    bgcolor="#0d1117",
-    pad="0.4",
-    nodesep=0.35,
-    ranksep=0.55]
-  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
-        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
-        penwidth=1.2, margin="0.22,0.14"]
-  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
+digraph ICCeryUIStage345 {
+  bgcolor=white
+  fontcolor=black
+  pad=0.4
+  rankdir=TB
+  nodesep=0.4
+  ranksep=0.5
+  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
+  edge [color=black]
 
-  subgraph cluster_s3 {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
+  S3 [label="stage-3  Stage3View.swift"]
+  S3 -> Instrument
+  S3 -> Transport
+  S3 -> swatchGrid
+  S3 -> Averaging
 
-    label="stage-3  Stage3View.swift / MeasurementWorkflowViewModel"
-    d3 [label="btnDetectInstruments  Button\ndisabled: isDetecting"]
-    i3 [label="chartreadInstrumentSelect  Picker.menu\nAuto + instlist ports"]
-    xyh [label="xyTableHint  Caption\nshown: selected is XY"]
-    xyp [label="xyTablePanel  shown: isXY\nxyStepPlace Align Scan Remove"]
-    pr [label="chartreadPrompt  Text"]
-    err [label="chartreadLastError  Caption\nshown: chartreadNotice != nil"]
-    sr [label="btnStartRead  Button\nshown: !running\ndisabled: !canStartRead\ncanStart: basename AND cwd AND !running"]
-    cal3 [label="btnCalibrate  Button\nshown: running AND calibrating"]
-    trg [label="btnTrigger  Button\nshown: running AND awaitingStrip"]
-    de [label="btnDoneReadEarly  Button\nshown: awaitingStrip"]
-    acc [label="btnAccept  Button\nshown: place | align | continue | warning"]
-    rty [label="btnRetry  Button\nshown: state == error"]
-    dn [label="btnDoneRead  Button\nshown: allStripsRead"]
-    cnc [label="btnCancel  Button\nshown: isChartreadRunning"]
-    sw [label="swatchGrid  swatch-{rowId}{loc}"]
-    rst [label="readStats  Text"]
-    avg [label="chartreadAveragingPanel\nshown: passes nonempty OR isFinished"]
-    mas [label="btnMeasureAnotherSheet  Button\ndisabled: !isFinished OR running"]
-    fa [label="btnFinishAndAverage  Button\ndisabled: !canFinish OR isFinishing\ncanFinish: isFinished AND passes nonempty"]
-  }
+  S4 [label="stage-4  Stage4View.swift"]
+  S4 -> colprof
+  S4 -> btnCreateProfile
 
-  subgraph cluster_s4 {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
+  S5 [label="stage-5  Stage5View.swift"]
+  S5 -> btnVerifyProfile
+  S5 -> btnViewGamut
+  S5 -> btnInstallProfile
+  S5 -> History
 
-    label="stage-4  Stage4View.swift / ProfileWorkflowViewModel"
-    alg [label="colprofAlgorithm  Picker"]
-    q [label="colprofQuality  Picker"]
-    fwa [label="colprofFwa  Picker"]
-    fwap [label="colprofFwaCustomPath  TextField\nshown: custom spectrum"]
-    fwab [label="btnBrowseFwaSp  Button\nshown with custom path"]
-    ill [label="colprofIlluminant  TextField"]
-    obs [label="colprofObserver  TextField"]
-    ivc [label="colprofInputViewCond  TextField"]
-    ovc [label="colprofOutputViewCond  TextField"]
-    desc [label="colprofDescription  TextField"]
-    cpr [label="colprofCopyright  TextField"]
-    ac [label="colprofApplyCalibration  Toggle"]
-    cf [label="colprofCalibrationFile  TextField\nshown: applyCalibration"]
-    cfb [label="btnBrowseCalibrationFile  Button\nshown: applyCalibration"]
-    cp [label="btnCreateProfile  Button\ndisabled: !canCreateProfile\ncanCreate: basename AND cwd AND !colprofRunning"]
-    cpi [label="colprofProgressIndicator\nshown: isColprofRunning"]
-  }
-
-  subgraph cluster_s5 {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="stage-5  Stage5View.swift"
-    vf [label="btnVerifyProfile  Button\ndisabled: !canVerify\ncanVerify: createdProfileURL AND !profcheckRunning"]
-    ppi [label="profcheckProgressIndicator\nshown: isProfcheckRunning"]
-    vg5 [label="btnViewGamut  Button\nDUPLICATE id with sidebar\ndisabled: createdGamutURL == nil"]
-    inst [label="btnInstallProfile  Button\ndisabled: createdProfileURL == nil"]
-    df [label="driftPrinterFilter  Picker"]
-    eh [label="btnExportHistory  Button"]
-    ch [label="btnClearHistory  Button"]
-    ht [label="verificationHistoryTable"]
-    dc [label="driftChart  DriftChartView.swift\nnot interactive"]
-    dalt [label="driftAlert / profcheckWarningBanner\nshown on fail / warning"]
-  }
-
-  subgraph cluster_coll {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Install collision alert"
-    io [label="profileOverwriteBtn"]
-    ir [label="profileRenameBtn"]
-    ic [label="profileCancelCollisionBtn\nshown: showingInstallCollision\nAND askBeforeOverwriteProfile"]
-  }
-
-  subgraph cluster_cal {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="stage-cal  CalibrationView.swift (Stage 0)"
-    ccs [label="Colour Space  Picker.segmented\nRGB | CMYK  (no a11y id)"]
-    cst [label="calSteps  TextField.number"]
-    cwp [label="White patches  TextField.number\n(no a11y id)"]
-    cin [label="calInkExplore  TextField\nshown: colourSpace == cmyk"]
-    cne [label="calNeutralEmphasis  Toggle.checkbox"]
-    cg [label="btnCalGenerate  Button\ndisabled: empty basename OR no cwd OR isGenerating"]
-    cl [label="btnCalLayout  Button\nsame disable as Generate"]
-    cm [label="btnCalMeasure  Button\ndisabled: calibrationTi3URL == nil"]
-    cc [label="btnCalCompute  Button\ndisabled: !canCompute\ncanCompute: .ti3 exists AND !isComputing"]
-    cat [label="calApplyToggle  Toggle\nshown: computedCalURL != nil"]
-    cr [label="btnCalReturn  Button  Esc\nrestores original basename"]
-  }
+  Cal [label="stage-cal  CalibrationView.swift"]
+  Cal -> Wedge
+  Cal -> Workflow
+  Cal -> btnCalReturn
 }
diff --git a/docs/ui-interactive-map.md b/docs/ui-interactive-map.md
index cf4da03..3f4eb48 100644
--- a/docs/ui-interactive-map.md
+++ b/docs/ui-interactive-map.md
@@ -1,606 +1,473 @@
 # Interactive UI map
 
-GraphViz diagrams for Gitea Kroki 0.30.1 (PlantUML's Graal image needs AVX2; this host has none).
+Accessibility **ids**, source files, and enable / hide / disable rules for ICCery v2 (`develop`).
 
-Colours are set **inside the SVG** (dark fill, light type, opaque background) so Gitea dark mode does not turn nodes into black boxes on a transparent canvas.
+Gitea Kroki 0.30.1 cannot run PlantUML on this host (Graal native image needs AVX2). Overview graphs below are small GraphViz `dot` diagrams with an **opaque white canvas and black type** so they stay readable in dark mode. Detail is in the tables — those are the useful map.
 
-Node labels are accessibility identifiers, source files, and enable / hide / disable rules.
+---
 
 ## Shell
 
-Window, sidebar, stepper, File menu. Source: [`ui-interactive-map-shell.dot`](ui-interactive-map-shell.dot)
-
 ```graphviz
 digraph ICCeryUIShell {
-  graph [label="ICCery UI — shell, sidebar, stepper, File menu\nids are accessibility identifiers. Gating: WizardGating.swift",
-    labelloc=t,
-    fontname="Helvetica",
-    fontsize=16,
-    fontcolor="#e6edf3",
-    bgcolor="#0d1117",
-    pad="0.4",
-    nodesep=0.35,
-    ranksep=0.55]
-  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
-        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
-        penwidth=1.2, margin="0.22,0.14"]
-  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
-
-  win [label="WindowGroup ICCery\nICCeryApp.swift\n1280x800, min 1100x700"]
-  root [label="RootView.swift\nsheets and alerts live here"]
-  win -> root
-
-  subgraph cluster_chrome {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Persistent chrome"
-    side [label="SidebarView.swift\n270 pt"]
-    ban [label="noticeText  NoticeBanner.swift\nshown: wizard.notice != nil\nauto-hide 6s; close has no id"]
-    stage [label="WizardStageContent\nswitch wizard.stage"]
-  }
-  root -> side
-  root -> ban
-  root -> stage
-
-  subgraph cluster_header {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Header"
-    sSet [label="openSettingsBtn  Button\nalways on → Settings sheet"]
-    sAbt [label="openAboutBtn  Button\nalways on → About"]
-    sHlp [label="btnToggleAllHelp  Button\ntoggles showingAllHelp overlays"]
-  }
-  side -> sSet
-  side -> sAbt
-  side -> sHlp
-
-  subgraph cluster_preset {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Presets (#11)"
-    pre [label="presetSelect  Picker.menu\nnone + ProfilingPreset.id\napply on change; none is not factory reset"]
-    preS [label="btnSavePresetModal  Button\nalways on"]
-    preM [label="btnOpenPresetsDialog  Button\nalways on"]
-  }
-  side -> pre
-  side -> preS
-  side -> preM
-
-  subgraph cluster_media {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Media library (#146)"
-    med [label="mediaSelect  Picker.menu\nnone + MediaRecipe.id\nnever reuses presetSelect"]
-    medSt [label="mediaRecipeStale  Caption\nshown: staleReasons nonempty"]
-    medC [label="btnMediaLibraryCapture  Button\ndisabled: selectedPrinter empty"]
-    medM [label="btnMediaLibraryManage  Button\nalways on"]
-  }
-  side -> med
-  side -> medSt
-  side -> medC
-  side -> medM
-
-  subgraph cluster_studio {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Studio (not stepper)"
-    calB [label="btnCalibratePrinter  Button\nalways on; Stage 0"]
-    gamB [label="btnViewGamut  Button\nSAME id as Stage 5\nalways on; no .gam = sRGB only"]
-    spotB [label="btnSpotRead  Button\ndisabled: no cwd OR chartread running"]
-  }
-  side -> calB
-  side -> gamB
-  side -> spotB
-
-  subgraph cluster_step {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Stepper 1-5 (disk is truth)"
-    step [label="StepperRow  Button.plain\ndisabled/opacity 0.45 unless isUnlocked\nbackward always; calibrate is not a row"]
-    nGate [shape=note, style=filled, fillcolor="#3d2f00", fontcolor="#f0e6c8", color="#d4a72c", label="WizardGating.swift\n1 always\n2 .ti1\n3 .ti1 AND .ti2\n4 .ti3 (not .ti2 alone)\n5 .ti3 AND .icc/.icm\nre-probe on window key (#151)"]
-  }
-  side -> step
-  step -> nGate [style=dashed]
-
-  subgraph cluster_chip {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="projectChip  ProjectUI.swift (#149)"
-    cn [label="projectChipName\nbound name or No project"]
-    cp [label="projectChipPath\nshown if bound"]
-    cs [label="projectChipStale\nshown: diskBehindNotes"]
-    cr [label="btnProjectReveal\nshown if bound"]
-    csv [label="btnProjectSave\nshown if bound\ndisabled: !canSave\ncanSave: bound + basename + cwd\nCAL_ still enabled (refusal banner)"]
-    co [label="btnProjectOpen\nshown if NOT bound"]
-  }
-  side -> cn
-  side -> cp
-  side -> cs
-  side -> cr
-  side -> csv
-  side -> co
-
-  subgraph cluster_menu {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="File menu  ProjectCommands / ICCeryApp.swift"
-    mN [label="menuProjectNew  Cmd-N"]
-    mO [label="menuProjectOpen  Cmd-O"]
-    mR [label="menuProjectRecents  Menu\ndisabled: recents empty\nprojectRecent-{hash}\nmenuProjectRecentsClear"]
-    mS [label="menuProjectSave  Cmd-S\ndisabled: !canSave"]
-    mSa [label="menuProjectSaveAs  Shift-Cmd-S\ndisabled: !canSaveAs\ncanSaveAs: basename + cwd"]
-    mRp [label="menuProjectReport\ndisabled: !canReport"]
-    mCl [label="menuProjectClose\ndisabled: !isBound"]
-  }
-
-  st1 [label="stage-1  Stage1View.swift"]
-  st2 [label="stage-2  Stage2View.swift"]
-  st3 [label="stage-3  Stage3View.swift"]
-  st4 [label="stage-4  Stage4View.swift"]
-  st5 [label="stage-5  Stage5View.swift"]
-  st0 [label="stage-cal  CalibrationView.swift"]
-  stage -> st1
-  stage -> st2
-  stage -> st3
-  stage -> st4
-  stage -> st5
-  stage -> st0
+  bgcolor=white
+  fontcolor=black
+  pad=0.4
+  rankdir=TB
+  nodesep=0.4
+  ranksep=0.5
+  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
+  edge [color=black]
+  Window [label="WindowGroup  ICCeryApp.swift"]
+  Root [label="RootView.swift  sheets and alerts"]
+  Sidebar [label="SidebarView.swift  270pt"]
+  Banner [label="noticeText  NoticeBanner"]
+  Stage [label="WizardStageContent"]
+  Window -> Root
+  Root -> Sidebar
+  Root -> Banner
+  Root -> Stage
+  Sidebar -> Presets
+  Sidebar -> Media
+  Sidebar -> Studio
+  Sidebar -> Stepper
+  Sidebar -> ProjectChip
+  Stage -> S1 [label="stage-1"]
+  Stage -> S2 [label="stage-2"]
+  Stage -> S3 [label="stage-3"]
+  Stage -> S4 [label="stage-4"]
+  Stage -> S5 [label="stage-5"]
+  Stage -> Cal [label="stage-cal"]
 }
 ```
 
+Window is `ICCeryApp.swift` (1280×800, min 1100×700). Almost every sheet is presented from `RootView.swift`, not the 270 pt sidebar.
+
+`noticeText` (`NoticeBanner.swift`): shown when `wizard.notice != nil`. Auto-hides after 6s unless `autoHideAfter` is nil. Close (xmark) has no accessibility id. Behind a modal sheet it is not in the AX tree — Manage Media uses `manageMediaNotice` instead (#170).
+
+### Sidebar header — `SidebarView.swift`
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `openSettingsBtn` | Button (gear) | always | never |
+| `openAboutBtn` | Button (info) | always | never |
+| `btnToggleAllHelp` | Button | always | never — toggles yellow help dots |
+
+### Presets — `SidebarView.swift` / `PresetDialogs.swift`
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `presetSelect` | Picker.menu | always | never. `none` does **not** factory-reset |
+| `btnSavePresetModal` | Button | always | never |
+| `btnOpenPresetsDialog` | Button | always | never |
+
+### Media library — `SidebarView.swift` / `MediaLibraryDialogs.swift`
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `mediaSelect` | Picker.menu | always | never. Failed Apply snaps back to `none` |
+| `mediaRecipeStale` | Caption | `staleReasons[selected]` nonempty | — |
+| `btnMediaLibraryCapture` | Button | always | `print.selectedPrinter` empty (needs Stage 2 queue) |
+| `btnMediaLibraryManage` | Button | always | never |
+
+### Studio (not the stepper)
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `btnCalibratePrinter` | Button | always | never. Enters Stage 0 (`stage-cal`) |
+| `btnViewGamut` | Button | always | **never on the sidebar**. Same id as Stage 5, where it **is** disabled if there is no `.gam` |
+| `btnSpotRead` | Button | always | no working folder **or** Stage 3 `chartread` is running |
+
+### Stepper 1–5 — `SidebarView.swift` / `WizardGating.swift`
+
+Each row is a `Button.plain`. Calibrate is **not** a stepper row.
+
+| Stage | Unlocked when |
+| --- | --- |
+| 1 Generate (`stage-1`) | always |
+| 2 Lay out (`stage-2`) | `.ti1` exists |
+| 3 Measure (`stage-3`) | `.ti1` **and** `.ti2` |
+| 4 Build (`stage-4`) | `.ti3` (a `.ti2` alone is not enough) |
+| 5 Verify (`stage-5`) | `.ti3` **and** `.icc`/`.icm` |
+
+Disabled / opacity 0.45 unless `isUnlocked`. Backward is always allowed. Re-probed when the window becomes key (#151).
+
+### Project chip — `ProjectUI.swift`
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `projectChip` | container | always | — |
+| `projectChipName` | Text | always (`No project` if unbound) | — |
+| `projectChipPath` | Text | bound | — |
+| `projectChipStale` | Caption | `diskBehindNotes` | — |
+| `btnProjectReveal` | Button | bound | never |
+| `btnProjectSave` | Button | bound | `!canSave` (needs bind + basename + cwd). `CAL_` basename stays enabled so the refusal banner can fire |
+| `btnProjectOpen` | Button | **not** bound | never |
+
+### File menu — `ProjectCommands` in `ICCeryApp.swift`
+
+Menu ids are `menuProject*`, not `btnProject*`.
+
+| Id | Type | Disabled when |
+| --- | --- | --- |
+| `menuProjectNew` | Button Cmd-N | never |
+| `menuProjectOpen` | Button Cmd-O | never |
+| `menuProjectRecents` | Menu | recents empty. Items: `projectRecent-{bookmarkHash}`, `menuProjectRecentsClear` |
+| `menuProjectSave` | Button Cmd-S | `!canSave` |
+| `menuProjectSaveAs` | Button Shift-Cmd-S | `!canSaveAs` (basename + cwd; bind not required) |
+| `menuProjectReport` | Button | `!canReport` |
+| `menuProjectClose` | Button | `!isBound` |
+
+---
+
 ## Stages 1–2
 
-Generate Target, Lay Out and Print. Source: [`ui-interactive-map-stage1-2.dot`](ui-interactive-map-stage1-2.dot)
-
 ```graphviz
 digraph ICCeryUIStage12 {
-  graph [label="ICCery UI — Stage 1 Generate Target / Stage 2 Lay Out and Print",
-    labelloc=t,
-    fontname="Helvetica",
-    fontsize=16,
-    fontcolor="#e6edf3",
-    bgcolor="#0d1117",
-    pad="0.4",
-    nodesep=0.35,
-    ranksep=0.55]
-  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
-        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
-        penwidth=1.2, margin="0.22,0.14"]
-  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
-
-  subgraph cluster_s1 {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="stage-1  Stage1View.swift"
-    csp [label="colourSpace  Picker.segmented\nRGB | CMYK"]
-    pcp [label="patchCountPreset  Picker"]
-    pcc [label="patchCountCustom  TextField.number\nshown: patchPreset == custom"]
-    wp [label="whitePatches  Stepper  0..50"]
-    bp [label="blackPatches  Stepper  0..50"]
-    tb [label="targetBasename  TextField"]
-    bb [label="btnBrowse  Button"]
-    wd [label="btnSelectWorkDir  Button"]
-    oe [label="btnOpenExisting  Button\n.ti1 or .ti2 (+ matching .ti1)"]
-    imp [label="btn-import-dataset  Button\n.ti3 / txt / cgats / csv\nunlocks stage 4"]
-    spd [label="selectedPathDisplay  Text"]
-    adv [label="targenAdvancedDetails  DisclosureGroup\nUI tests pre-expand"]
-    gen [label="btnGenerate  Button\ndisabled: !canGenerate OR targenRunning\ncanGenerate: valid basename AND directory"]
-    tlog [label="targenLogContainer / targenLog\nProcessLogView.swift"]
-  }
-
-  subgraph cluster_adv {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Advanced (hidden until disclosure open)"
-    ag [label="targenGreySteps  Toggle+TextField\nfield iff toggle on"]
-    as1 [label="targenSingleChannelSteps  Toggle+TextField"]
-    an [label="targenNeutralSteps  Toggle+TextField"]
-    anc [label="targenNeutralConcentration  Toggle+Slider 0..1"]
-    aa [label="targenAdaptation  Toggle+Slider 0..1"]
-    ap [label="targenPrecondProfile  TextField"]
-    apb [label="btnBrowsePrecondProfile  Button"]
-    ahq [label="targenHighQuality  Toggle  OFPS -G"]
-    aal [label="targenAlgorithm  Picker"]
-    ail [label="targenInkLimitGroup  Toggle+TextField\nshown: colourSpace == cmyk"]
-    ad [label="targenDarkEmphasis  Toggle+Slider 0..3"]
-    adp [label="targenDevicePower  Toggle+Slider 0..3"]
-  }
-  adv -> ag [style=dashed]
-
-  subgraph cluster_s2 {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="stage-2  Stage2View.swift"
-    cmw [label="cmWarningBanner  always visible, not a control"]
-    ins [label="instrumentSelect  Picker\nPrintInstrument chart code, NOT USB port"]
-    pgs [label="pageSizeSelect  Picker"]
-    cps [label="customPageSizeRow\nshown: pageSize == custom\ncustomPageW / customPageH mm"]
-    bit [label="bitDepth  Picker  8-bit | 16-bit\n(no a11y id on picker)"]
-    dpi [label="tiffDpi  Stepper  72..600"]
-    lo [label="printtargLayoutOrder  Picker"]
-    seed [label="printtargCustomSeedGroup\nshown: layoutOrder == customSeed\nid printtargCustomSeed"]
-    tle [label="btnToggleLabelEdit  Button\nEdit label / Use automatic"]
-    mp [label="targetMetadataPrinter  TextField"]
-    mi [label="targetMetadataInkSet  TextField"]
-    md [label="targetMetadataDriverPaper  TextField"]
-    ma [label="targetMetadataActualPaper  TextField"]
-    lpv [label="targetLabelPreview  TextField or Text\nTextField iff labelIsCustom"]
-    lay [label="btnCreateLayout  Button\ndisabled: printtargRunning OR basename empty"]
-    plog [label="printtargLogContainer  DisclosureGroup"]
-    gal [label="tiffGallery  shown: printtargResult != nil\ngalleryInfo, galleryGrid\ngalleryPage-{index}\nbtnPrintPage-{index}\nPrint disabled: isPrinting OR no printer"]
-  }
-
-  subgraph cluster_print {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="rawPrintPanel"
-    ps [label="printerSelect  Picker  CUPS queues"]
-    psb [label="printerStatusBadge\nshown: selected printer in list"]
-    prf [label="btnRefreshPrinters  Button"]
-    ppr [label="btnPrinterProperties  Button\ndisabled: selectedPrinter empty"]
-    ptr [label="printerTraySelect  Picker\nshown: trays nonempty"]
-    pmt [label="printerMediaTypeSelect  Picker\nshown: mediaTypes nonempty"]
-    por [label="btnOrientPortrait  Button"]
-    lan [label="btnOrientLandscape  Button"]
-    pal [label="btnPrintAll  Button\ndisabled: isPrinting OR no result OR no printer"]
-    a3 [label="btnAdvanceToStage3  Button\ndisabled: no result OR !isUnlocked(measure)"]
-    pnt [label="printNotificationText\nshown: printNotice != nil"]
-  }
+  bgcolor=white
+  fontcolor=black
+  pad=0.4
+  rankdir=TB
+  nodesep=0.4
+  ranksep=0.5
+  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
+  edge [color=black]
+  S1 [label="stage-1  Stage1View.swift"]
+  S1 -> colourSpace
+  S1 -> Patches
+  S1 -> TargetFile
+  S1 -> Advanced
+  S1 -> btnGenerate
+  S1 -> targenLog
+  S2 [label="stage-2  Stage2View.swift"]
+  S2 -> Layout
+  S2 -> Label
+  S2 -> btnCreateLayout
+  S2 -> tiffGallery
+  S2 -> rawPrintPanel
 }
 ```
 
-## Stages 3–5 + Calibrate
+### Stage 1 — `Stage1View.swift` / `TargetWorkflowViewModel.swift`
 
-Measure, Build, Verify, Stage 0. Source: [`ui-interactive-map-stage3-5-cal.dot`](ui-interactive-map-stage3-5-cal.dot)
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `colourSpace` | Picker.segmented | always | never. RGB \| CMYK |
+| `patchCountPreset` | Picker | always | never |
+| `patchCountCustom` | TextField.number | `patchPreset == .custom` | — |
+| `whitePatches` | Stepper 0…50 | always | never |
+| `blackPatches` | Stepper 0…50 | always | never |
+| `targetBasename` | TextField | always | never |
+| `btnBrowse` | Button | always | never |
+| `btnSelectWorkDir` | Button | always | never |
+| `btnOpenExisting` | Button | always | never. `.ti1` or `.ti2` (+ matching `.ti1`) |
+| `btn-import-dataset` | Button | always | never. `.ti3` / txt / cgats / csv; unlocks stage 4 |
+| `selectedPathDisplay` | Text | always | — |
+| `targenAdvancedDetails` | DisclosureGroup | always | UI tests pre-expand it |
+| `targenGreySteps` | Toggle + TextField | inside Advanced | field only if toggle on |
+| `targenSingleChannelSteps` | Toggle + TextField | inside Advanced | field only if toggle on |
+| `targenNeutralSteps` | Toggle + TextField | inside Advanced | field only if toggle on |
+| `targenNeutralConcentration` | Toggle + Slider 0…1 | inside Advanced | slider only if toggle on |
+| `targenAdaptation` | Toggle + Slider 0…1 | inside Advanced | slider only if toggle on |
+| `targenPrecondProfile` | TextField | inside Advanced | — |
+| `btnBrowsePrecondProfile` | Button | inside Advanced | — |
+| `targenHighQuality` | Toggle | inside Advanced | — |
+| `targenAlgorithm` | Picker | inside Advanced | — |
+| `targenInkLimitGroup` | Toggle + TextField | Advanced **and** colour space is CMYK | field only if toggle on |
+| `targenDarkEmphasis` | Toggle + Slider 0…3 | inside Advanced | slider only if toggle on |
+| `targenDevicePower` | Toggle + Slider 0…3 | inside Advanced | slider only if toggle on |
+| `btnGenerate` | Button | always | `!canGenerate` or `targenRunning`. `canGenerate` = valid basename **and** directory |
+| `targenLogContainer` / `targenLog` | DisclosureGroup | always | `ProcessLogView.swift` |
+
+Those four sliders are the **only** sliders in the app.
+
+### Stage 2 — `Stage2View.swift` / `PrintSessionViewModel.swift`
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `cmWarningBanner` | Banner | always on stage 2 | not a control |
+| `instrumentSelect` | Picker | always | never. Chart **code**, not a USB port |
+| `pageSizeSelect` | Picker | always | never |
+| `customPageSizeRow` (`customPageW` / `customPageH`) | TextField.number | `pageSize == .custom` | — |
+| Bit depth picker | Picker | always | no a11y id |
+| `tiffDpi` | Stepper 72…600 | always | never |
+| `printtargLayoutOrder` | Picker | always | never |
+| `printtargCustomSeedGroup` / `printtargCustomSeed` | TextField | `layoutOrder == .customSeed` | — |
+| `btnToggleLabelEdit` | Button | always | never. Title swaps Edit / Use automatic |
+| `targetMetadataPrinter` | TextField | always | never |
+| `targetMetadataInkSet` | TextField | always | never |
+| `targetMetadataDriverPaper` | TextField | always | never |
+| `targetMetadataActualPaper` | TextField | always | never |
+| `targetLabelPreview` | TextField or Text | always | TextField only if `labelIsCustom` |
+| `btnCreateLayout` | Button | always | `printtargRunning` or basename empty |
+| `printtargLogContainer` | DisclosureGroup | always | — |
+| `tiffGallery` | Grid | `printtargResult != nil` | children: `galleryInfo`, `galleryGrid`, `galleryPage-{n}` |
+| `btnPrintPage-{n}` | Button | that gallery cell | `isPrinting` or no selected printer |
+
+#### `rawPrintPanel`
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `printerSelect` | Picker | always | never |
+| `printerStatusBadge` | Caption | selected printer is in the list | — |
+| `btnRefreshPrinters` | Button | always | never |
+| `btnPrinterProperties` | Button | always | `selectedPrinter` empty |
+| `printerTraySelect` | Picker | trays nonempty | — |
+| `printerMediaTypeSelect` | Picker | media types nonempty | — |
+| `btnOrientPortrait` | Button | always | never |
+| `btnOrientLandscape` | Button | always | never |
+| `btnPrintAll` | Button | always | printing, or no layout, or no printer |
+| `btnAdvanceToStage3` | Button | always | no layout or `!isUnlocked(.measure)` |
+| `printNotificationText` | Caption | `printNotice != nil` | — |
+
+---
+
+## Stages 3–5 and Calibrate
 
 ```graphviz
-digraph ICCeryUIStage345Cal {
-  graph [label="ICCery UI — Stage 3 Measure / 4 Build / 5 Verify / Stage 0 Calibrate",
-    labelloc=t,
-    fontname="Helvetica",
-    fontsize=16,
-    fontcolor="#e6edf3",
-    bgcolor="#0d1117",
-    pad="0.4",
-    nodesep=0.35,
-    ranksep=0.55]
-  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
-        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
-        penwidth=1.2, margin="0.22,0.14"]
-  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
-
-  subgraph cluster_s3 {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="stage-3  Stage3View.swift / MeasurementWorkflowViewModel"
-    d3 [label="btnDetectInstruments  Button\ndisabled: isDetecting"]
-    i3 [label="chartreadInstrumentSelect  Picker.menu\nAuto + instlist ports"]
-    xyh [label="xyTableHint  Caption\nshown: selected is XY"]
-    xyp [label="xyTablePanel  shown: isXY\nxyStepPlace Align Scan Remove"]
-    pr [label="chartreadPrompt  Text"]
-    err [label="chartreadLastError  Caption\nshown: chartreadNotice != nil"]
-    sr [label="btnStartRead  Button\nshown: !running\ndisabled: !canStartRead\ncanStart: basename AND cwd AND !running"]
-    cal3 [label="btnCalibrate  Button\nshown: running AND calibrating"]
-    trg [label="btnTrigger  Button\nshown: running AND awaitingStrip"]
-    de [label="btnDoneReadEarly  Button\nshown: awaitingStrip"]
-    acc [label="btnAccept  Button\nshown: place | align | continue | warning"]
-    rty [label="btnRetry  Button\nshown: state == error"]
-    dn [label="btnDoneRead  Button\nshown: allStripsRead"]
-    cnc [label="btnCancel  Button\nshown: isChartreadRunning"]
-    sw [label="swatchGrid  swatch-{rowId}{loc}"]
-    rst [label="readStats  Text"]
-    avg [label="chartreadAveragingPanel\nshown: passes nonempty OR isFinished"]
-    mas [label="btnMeasureAnotherSheet  Button\ndisabled: !isFinished OR running"]
-    fa [label="btnFinishAndAverage  Button\ndisabled: !canFinish OR isFinishing\ncanFinish: isFinished AND passes nonempty"]
-  }
-
-  subgraph cluster_s4 {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="stage-4  Stage4View.swift / ProfileWorkflowViewModel"
-    alg [label="colprofAlgorithm  Picker"]
-    q [label="colprofQuality  Picker"]
-    fwa [label="colprofFwa  Picker"]
-    fwap [label="colprofFwaCustomPath  TextField\nshown: custom spectrum"]
-    fwab [label="btnBrowseFwaSp  Button\nshown with custom path"]
-    ill [label="colprofIlluminant  TextField"]
-    obs [label="colprofObserver  TextField"]
-    ivc [label="colprofInputViewCond  TextField"]
-    ovc [label="colprofOutputViewCond  TextField"]
-    desc [label="colprofDescription  TextField"]
-    cpr [label="colprofCopyright  TextField"]
-    ac [label="colprofApplyCalibration  Toggle"]
-    cf [label="colprofCalibrationFile  TextField\nshown: applyCalibration"]
-    cfb [label="btnBrowseCalibrationFile  Button\nshown: applyCalibration"]
-    cp [label="btnCreateProfile  Button\ndisabled: !canCreateProfile\ncanCreate: basename AND cwd AND !colprofRunning"]
-    cpi [label="colprofProgressIndicator\nshown: isColprofRunning"]
-  }
-
-  subgraph cluster_s5 {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="stage-5  Stage5View.swift"
-    vf [label="btnVerifyProfile  Button\ndisabled: !canVerify\ncanVerify: createdProfileURL AND !profcheckRunning"]
-    ppi [label="profcheckProgressIndicator\nshown: isProfcheckRunning"]
-    vg5 [label="btnViewGamut  Button\nDUPLICATE id with sidebar\ndisabled: createdGamutURL == nil"]
-    inst [label="btnInstallProfile  Button\ndisabled: createdProfileURL == nil"]
-    df [label="driftPrinterFilter  Picker"]
-    eh [label="btnExportHistory  Button"]
-    ch [label="btnClearHistory  Button"]
-    ht [label="verificationHistoryTable"]
-    dc [label="driftChart  DriftChartView.swift\nnot interactive"]
-    dalt [label="driftAlert / profcheckWarningBanner\nshown on fail / warning"]
-  }
-
-  subgraph cluster_coll {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Install collision alert"
-    io [label="profileOverwriteBtn"]
-    ir [label="profileRenameBtn"]
-    ic [label="profileCancelCollisionBtn\nshown: showingInstallCollision\nAND askBeforeOverwriteProfile"]
-  }
-
-  subgraph cluster_cal {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="stage-cal  CalibrationView.swift (Stage 0)"
-    ccs [label="Colour Space  Picker.segmented\nRGB | CMYK  (no a11y id)"]
-    cst [label="calSteps  TextField.number"]
-    cwp [label="White patches  TextField.number\n(no a11y id)"]
-    cin [label="calInkExplore  TextField\nshown: colourSpace == cmyk"]
-    cne [label="calNeutralEmphasis  Toggle.checkbox"]
-    cg [label="btnCalGenerate  Button\ndisabled: empty basename OR no cwd OR isGenerating"]
-    cl [label="btnCalLayout  Button\nsame disable as Generate"]
-    cm [label="btnCalMeasure  Button\ndisabled: calibrationTi3URL == nil"]
-    cc [label="btnCalCompute  Button\ndisabled: !canCompute\ncanCompute: .ti3 exists AND !isComputing"]
-    cat [label="calApplyToggle  Toggle\nshown: computedCalURL != nil"]
-    cr [label="btnCalReturn  Button  Esc\nrestores original basename"]
-  }
+digraph ICCeryUIStage345 {
+  bgcolor=white
+  fontcolor=black
+  pad=0.4
+  rankdir=TB
+  nodesep=0.4
+  ranksep=0.5
+  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
+  edge [color=black]
+  S3 [label="stage-3  Stage3View.swift"]
+  S3 -> Instrument
+  S3 -> Transport
+  S3 -> swatchGrid
+  S3 -> Averaging
+  S4 [label="stage-4  Stage4View.swift"]
+  S4 -> colprof
+  S4 -> btnCreateProfile
+  S5 [label="stage-5  Stage5View.swift"]
+  S5 -> btnVerifyProfile
+  S5 -> btnViewGamut
+  S5 -> btnInstallProfile
+  S5 -> History
+  Cal [label="stage-cal  CalibrationView.swift"]
+  Cal -> Wedge
+  Cal -> Workflow
+  Cal -> btnCalReturn
 }
 ```
 
+### Stage 3 — `Stage3View.swift` / `MeasurementWorkflowViewModel.swift`
+
+Transport buttons **replace each other** from `chartreadState`. Stage 3 ids must not be reused on Spot Read.
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `btnDetectInstruments` | Button | always | `isDetecting` |
+| `chartreadInstrumentSelect` | Picker.menu | always | never |
+| `xyTableHint` | Caption | selected instrument is XY | — |
+| `xyTablePanel` | Place/Align/Scan/Remove | is XY | highlight = `xyStep` |
+| `chartreadPrompt` | Text | always | — |
+| `chartreadLastError` | Caption | `chartreadNotice != nil` | — |
+| `btnStartRead` | Button | **not** running | `!canStartRead` (needs basename, cwd, not running) |
+| `btnCalibrate` | Button | running **and** calibrating | — |
+| `btnTrigger` | Button | running **and** awaitingStrip | — |
+| `btnDoneReadEarly` | Button | awaitingStrip | — |
+| `btnAccept` | Button | place / align / continue / warning | title may be `Continue (send 'X')` |
+| `btnRetry` | Button | state == error | — |
+| `btnDoneRead` | Button | allStripsRead | — |
+| `btnCancel` | Button | `isChartreadRunning` | — |
+| `swatchGrid` | Scroll | always | cells `swatch-{rowId}{loc}` |
+| `readStats` | Text | always | — |
+| `chartreadAveragingPanel` | Panel | passes nonempty **or** `isFinished` | — |
+| `btnMeasureAnotherSheet` | Button | averaging panel | `!isFinished` or still running |
+| `btnFinishAndAverage` | Button | averaging panel | `!canFinish` or `isFinishing`. `canFinish` = finished **and** at least one pass |
+
+### Stage 4 — `Stage4View.swift` / `ProfileWorkflowViewModel.swift`
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `colprofAlgorithm` | Picker | always | never |
+| `colprofQuality` | Picker | always | never |
+| `colprofFwa` | Picker | always | never |
+| `colprofFwaCustomPath` | TextField | custom spectrum selected | — |
+| `btnBrowseFwaSp` | Button | with custom path | — |
+| `colprofIlluminant` | TextField | always | never |
+| `colprofObserver` | TextField | always | never |
+| `colprofInputViewCond` | TextField | always | never |
+| `colprofOutputViewCond` | TextField | always | never |
+| `colprofDescription` | TextField | always | never |
+| `colprofCopyright` | TextField | always | never |
+| `colprofApplyCalibration` | Toggle | always | never |
+| `colprofCalibrationFile` | TextField | `applyCalibration` | — |
+| `btnBrowseCalibrationFile` | Button | `applyCalibration` | — |
+| `btnCreateProfile` | Button | always | `!canCreateProfile` (basename, cwd, not running) |
+| `colprofProgressIndicator` | Progress | `isColprofRunning` | — |
+
+### Stage 5 — `Stage5View.swift`
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `btnVerifyProfile` | Button | always | `!canVerify` (no profile or profcheck running) |
+| `profcheckProgressIndicator` | Progress | `isProfcheckRunning` | — |
+| `btnViewGamut` | Button | always | `createdGamutURL == nil` — **same id as sidebar** |
+| `btnInstallProfile` | Button | always | `createdProfileURL == nil` |
+| `driftPrinterFilter` | Picker | always | never |
+| `btnExportHistory` | Button | always | never |
+| `btnClearHistory` | Button | always | never |
+| `verificationHistoryTable` | Table | always | — |
+| `driftChart` | View | always | not interactive (`DriftChartView.swift`) |
+| `driftAlert` / `profcheckWarningBanner` | Banner | fail / warning status | — |
+| `profileOverwriteBtn` | Alert button | install collision **and** ask-before-overwrite | — |
+| `profileRenameBtn` | Alert button | same | — |
+| `profileCancelCollisionBtn` | Alert button | same | — |
+
+### Stage 0 — `CalibrationView.swift` (`stage-cal`)
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| Colour space | Picker.segmented | always | no a11y id. RGB \| CMYK |
+| `calSteps` | TextField.number | always | never |
+| White patches | TextField.number | always | no a11y id |
+| `calInkExplore` | TextField | colour space is CMYK | — |
+| `calNeutralEmphasis` | Toggle.checkbox | always | never |
+| `btnCalGenerate` | Button | always | empty basename, no cwd, or `isGenerating` |
+| `btnCalLayout` | Button | always | same as Generate |
+| `btnCalMeasure` | Button | always | `calibrationTi3URL == nil` |
+| `btnCalCompute` | Button | always | `!canCompute` (no `.ti3` or computing) |
+| `calApplyToggle` | Toggle | `computedCalURL != nil` | — |
+| `btnCalReturn` | Button Esc | always | never. Restores the original basename |
+
+---
+
 ## Sheets
 
-Settings, Spot Read, Gamut, media, project alerts. Source: [`ui-interactive-map-sheets.dot`](ui-interactive-map-sheets.dot)
-
 ```graphviz
 digraph ICCeryUISheets {
-  graph [label="ICCery UI — sheets, Spot Read, Gamut, Settings, project alerts",
-    labelloc=t,
-    fontname="Helvetica",
-    fontsize=16,
-    fontcolor="#e6edf3",
-    bgcolor="#0d1117",
-    pad="0.4",
-    nodesep=0.35,
-    ranksep=0.55]
-  node [shape=box, style="filled,rounded", fontname="Helvetica", fontsize=12,
-        fontcolor="#e6edf3", fillcolor="#21262d", color="#8b949e",
-        penwidth=1.2, margin="0.22,0.14"]
-  edge [fontname="Helvetica", fontsize=10, color="#8b949e", fontcolor="#8b949e"]
-
-  subgraph cluster_set {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="SettingsView.swift  (openSettingsBtn)"
-    ad [label="Argyll dir  TextField+Browse\nempty => bundled sidecars"]
-    di [label="Default instrument  Picker\nNone + i1/p3/CM/SS/20/22/41/51\nseeds Stage 3 + Spot Read\ndoes NOT change instrumentSelect"]
-    led [label="Enable i1Pro 2 LEDs  Toggle"]
-    dg [label="settingsDeltaEGood  TextField"]
-    dw [label="settingsDeltaEWarning  TextField\nSave refuses unless Warning > Good"]
-    sd [label="settingsCalStaleDays  TextField"]
-    il [label="Install location  Picker\nUser | System library"]
-    ao [label="Ask before overwriting  Toggle"]
-    oc [label="Open ColorSync after install  Toggle"]
-    ll [label="Log level  Picker"]
-    lg [label="Open log folder / Copy path / Copy excerpt"]
-    ss [label="Cancel / Save\nSave stays if validation fails\nframe 560x620"]
-  }
-
-  subgraph cluster_about {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="AboutView.swift"
-    ab [label="aboutDialog\naboutVersion, aboutBuildDate\ncloseAboutBtn  Esc"]
-  }
-
-  subgraph cluster_sp {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="savePresetDialog  PresetDialogs.swift"
-    spn [label="savePresetName  TextField"]
-    spd [label="savePresetDesc  TextField"]
-    spc [label="btnCloseSavePresetDialog"]
-    sps [label="btnConfirmSavePreset\ndisabled: name trimmed empty"]
-  }
-
-  subgraph cluster_mp {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="managePresetsDialog"
-    prw [label="presetRow-{id}\nBuilt-in: no delete\nelse btnExportPreset-{id}\nbtnDeletePreset-{id}"]
-    pim [label="btnImportPreset"]
-    pea [label="btnExportActivePreset\nshown: selected custom preset"]
-    pcl [label="btnCloseManagePresetsDialog"]
-  }
-
-  subgraph cluster_sm {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="saveMediaRecipeDialog  MediaLibraryDialogs.swift"
-    smf [label="saveMediaName/Notes/Paper/Ink  TextField x4"]
-    smr [label="saveMediaPrinter/Preset/ColourSpace/Cal  read-only"]
-    smc [label="saveMediaApplyCal  Toggle\ndisabled: !calApplyable\ncalApplyable: path exists, not CAL_"]
-    smx [label="btnCloseSaveMediaDialog"]
-    sms [label="btnConfirmSaveMedia\ndisabled: name|paper|ink empty\nOR colour-space mismatch"]
-  }
-
-  subgraph cluster_mm {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="manageMediaDialog"
-    mll [label="mediaLibraryList\nmediaRow-{id}\nbtnMediaLibraryApply-{id}\nbtnMediaLibraryDelete-{id}\ndouble-click = Apply"]
-    mmn [label="manageMediaNotice  Caption\nshown: manageApplyNotice != nil\nin-sheet copy of failed Apply (#170)"]
-    mla [label="btnMediaLibraryApply\ndisabled: selection == nil"]
-    mlc [label="btnMediaLibraryCaptureFromManage\ndismiss then open capture"]
-    mlx [label="btnCloseManageMediaDialog"]
-    mld [label="Delete alert  Cancel / Delete"]
-  }
-
-  subgraph cluster_spot {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="spotReadView  SpotReadView.swift (#148)"
-    ssm [label="spotSidecarMissing\nshown: !sidecarAvailable\nhides instrument/transport"]
-    sdet [label="btnSpotDetectInstruments\ndisabled: detecting OR running"]
-    sis [label="spotInstrumentSelect  Picker\ndisabled: isRunning"]
-    sdm [label="spotDefaultMissing\nshown: defaultMissing"]
-    ssd [label="spotSetDefault  Toggle"]
-    sxy [label="spotXYHint  shown: selected is XY"]
-    sst [label="btnSpotStart\nshown: !isRunning\ndisabled: !canStart\ncanStart: sidecar, !detecting, !running,\n!chartreadRunning, cwd"]
-    sca [label="btnSpotCalibrate\nshown: running AND calibrating"]
-    str [label="btnSpotTrigger  Read\nshown: running AND awaitingStrip"]
-    ssp [label="btnSpotStop  shown: isRunning"]
-    sls [label="spotLastSample / Lab / XYZ / DeltaE\nspotLabImplausible if L not 0..100\nspotDeltaE hidden on first sample"]
-    sht [label="spotHistoryTable\nrows: spotHistoryRow-{uuid}\nclick restores sample, no trigger"]
-    scp [label="btnSpotCopyLab\ndisabled: displayedSample == nil"]
-    sex [label="btnSpotExportCsv\ndisabled: samples empty"]
-    scl [label="btnCloseSpotRead  Esc; onDismiss = Stop"]
-  }
-
-  subgraph cluster_gamut {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="gamutView  GamutView.swift (#147)"
-    gls [label="gamutLayer-srgb  Toggle\nsRGB always loaded; can hide"]
-    glp [label="gamutLayer-profile  Toggle\ndisabled: no session .gam"]
-    glc [label="gamutLayer-compare  Toggle\ndisabled: no compare layer"]
-    gac [label="btnGamutAddCompare  Menu\nbtnGamutOpenGam / btnGamutOpenProfile"]
-    grc [label="btnGamutRemoveCompare\ndisabled: compare layer nil"]
-    gst [label="btnGamutSampleTiff"]
-    gun [label="gamutViewerUnavailable\nshown: no Metal\ntoggles + inspect still enabled"]
-    grs [label="btnResetGamutCamera  R"]
-    gle [label="gamutLabEntryL/A/B  TextField x3"]
-    gin [label="btnGamutInspectLab\ndisabled: !canInspectLab"]
-    gip [label="gamutInspectPanel"]
-    gcl [label="btnCloseGamut  Esc"]
-    gtf [label="gamutTiffPreview sheet\nshowingTiffPreview\nbtnCloseGamutTiffPreview"]
-  }
-
-  subgraph cluster_proj {
-    style="filled,rounded"
-    fillcolor="#161b22"
-    color="#30363d"
-    fontcolor="#79c0ff"
-    fontsize=13
-
-    label="Project alerts  RootView + ProjectUI"
-    pna [label="projectNewAlert\nbtnProjectNewCancel / Confirm"]
-    pda [label="Dirty save alert\nbtnProjectDirtySave\nbtnProjectDirtyDiscard\nbtnProjectDirtyCancel"]
-    prs [label="projectRelocateSheet\nshown: cwd missing on Open\nbtnProjectRelocateCancel\nbtnProjectRelocate"]
-  }
-
-  mutex [shape=note, style=filled, fillcolor="#3d2f00", fontcolor="#f0e6c8", color="#d4a72c", label="Mutex\nSpot Read disabled while Stage 3 chartread runs\nOpening Spot Read never kills chartread_{basename}\nFailed media Apply keeps manage sheet open\nWindow noticeText is occluded — use manageMediaNotice"]
+  bgcolor=white
+  fontcolor=black
+  pad=0.4
+  rankdir=TB
+  nodesep=0.4
+  ranksep=0.5
+  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
+  edge [color=black]
+  Root [label="RootView.swift hosts every sheet"]
+  Root -> Settings
+  Root -> About
+  Root -> savePresetDialog
+  Root -> managePresetsDialog
+  Root -> saveMediaRecipeDialog
+  Root -> manageMediaDialog
+  Root -> spotReadView
+  Root -> gamutView
+  Root -> ProjectAlerts
 }
 ```
+
+### Settings — `SettingsView.swift` (560×620)
+
+| Control | Type | Notes |
+| --- | --- | --- |
+| Argyll dir + Browse | TextField | empty ⇒ bundled sidecars |
+| Default instrument | Picker | None + i1 / p3 / CM / SS / 20 / 22 / 41 / 51. Seeds Stage 3 and Spot Read. Does **not** change Stage 2 `instrumentSelect` |
+| Enable i1Pro 2 LEDs | Toggle | — |
+| `settingsDeltaEGood` | TextField | green cutoff |
+| `settingsDeltaEWarning` | TextField | amber cutoff. Save refuses unless Warning > Good |
+| `settingsCalStaleDays` | TextField | — |
+| Install location | Picker | User \| System library |
+| Ask before overwriting | Toggle | — |
+| Open ColorSync after install | Toggle | — |
+| Log level | Picker | — |
+| Open log folder / Copy path / Copy excerpt | Buttons | — |
+| Cancel / Save | Buttons | Save stays on the sheet if validation fails |
+
+### About — `AboutView.swift`
+
+`aboutDialog`, `aboutVersion`, `aboutBuildDate`, `closeAboutBtn` (Esc).
+
+### Save / manage presets — `PresetDialogs.swift`
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `savePresetName` | TextField | save sheet | — |
+| `savePresetDesc` | TextField | save sheet | — |
+| `btnCloseSavePresetDialog` | Button | save sheet | — |
+| `btnConfirmSavePreset` | Button | save sheet | name trimmed empty |
+| `presetRow-{id}` | Row | manage list | Built-in: no delete. Else `btnExportPreset-{id}`, `btnDeletePreset-{id}` |
+| `btnImportPreset` | Button | manage | — |
+| `btnExportActivePreset` | Button | selected preset is custom | — |
+| `btnCloseManagePresetsDialog` | Button | manage | — |
+
+### Save / manage media — `MediaLibraryDialogs.swift`
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `saveMediaName` / `Notes` / `Paper` / `Ink` | TextField | save sheet | — |
+| `saveMediaPrinter` / `Preset` / `ColourSpace` / `Cal` | read-only | save sheet | — |
+| `saveMediaApplyCal` | Toggle | save sheet | `!calApplyable` (path missing or `CAL_` stem) |
+| `btnCloseSaveMediaDialog` | Button | save sheet | — |
+| `btnConfirmSaveMedia` | Button | save sheet | name, paper or ink empty, **or** colour-space mismatch |
+| `mediaLibraryList` | List | manage | rows `mediaRow-{id}`; `btnMediaLibraryApply-{id}`; `btnMediaLibraryDelete-{id}`; double-click = Apply |
+| `manageMediaNotice` | Caption | `manageApplyNotice != nil` | in-sheet copy of a failed Apply (#170) |
+| `btnMediaLibraryApply` | Button | manage | `selection == nil` |
+| `btnMediaLibraryCaptureFromManage` | Button | manage | dismiss then open capture |
+| `btnCloseManageMediaDialog` | Button | manage | — |
+| Delete alert | Alert | pending delete | Cancel / Delete |
+
+Failed Apply **keeps** the manage sheet open. The window banner is occluded — use `manageMediaNotice`.
+
+### Spot Read — `SpotReadView.swift` (`spotReadView`)
+
+Enabled from the sidebar only with a working folder and no live Stage 3 `chartread`. Opening this sheet never kills `chartread_{basename}`. Close / dismiss = Stop.
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `spotSidecarMissing` | Text | sidecar missing | hides instrument + transport |
+| `btnSpotDetectInstruments` | Button | sidecar present | detecting or running |
+| `spotInstrumentSelect` | Picker | sidecar present | `isRunning` |
+| `spotDefaultMissing` | Caption | saved default not plugged in | — |
+| `spotSetDefault` | Toggle | sidecar present | — |
+| `spotXYHint` | Caption | selected is XY | XY tables belong on Stage 3 |
+| `btnSpotStart` | Button | not running | `!canStart` (sidecar, cwd, not detecting/running/chartread) |
+| `btnSpotCalibrate` | Button | running and calibrating | — |
+| `btnSpotTrigger` | Button | running and awaitingStrip | labelled Read |
+| `btnSpotStop` | Button | `isRunning` | — |
+| `spotLastSample` / `spotLabL/A/B` / `spotXYZ` / `spotDeltaE` | Display | last sample exists | `spotDeltaE` hidden on the first sample. `spotLabImplausible` if L not in 0…100 |
+| `spotHistoryTable` | List | samples nonempty | rows `spotHistoryRow-{uuid}` — click restores, does not trigger |
+| `btnSpotCopyLab` | Button | always | no displayed sample |
+| `btnSpotExportCsv` | Button | always | history empty |
+| `btnCloseSpotRead` | Button Esc | always | never |
+
+### Gamut — `GamutView.swift` (`gamutView`)
+
+| Id | Type | Shown | Disabled when |
+| --- | --- | --- | --- |
+| `gamutLayer-srgb` | Toggle.checkbox | always | never. Can hide, cannot remove |
+| `gamutLayer-profile` | Toggle | always | no session `.gam` |
+| `gamutLayer-compare` | Toggle | always | no compare layer |
+| `btnGamutAddCompare` | Menu | always | `btnGamutOpenGam` / `btnGamutOpenProfile` |
+| `btnGamutRemoveCompare` | Button | always | no compare layer |
+| `btnGamutSampleTiff` | Button | always | never |
+| `gamutViewerUnavailable` | Caption | no Metal | toggles + inspect still work |
+| `btnResetGamutCamera` | Button | always | R when focused |
+| `gamutLabEntryL/A/B` | TextField | always | — |
+| `btnGamutInspectLab` | Button | always | `!canInspectLab` |
+| `gamutInspectPanel` | Panel | inspect result | — |
+| `btnCloseGamut` | Button Esc | always | never |
+| `gamutTiffPreview` | Sheet | `showingTiffPreview` | `btnCloseGamutTiffPreview` |
+
+### Project alerts — `RootView.swift` / `ProjectUI.swift`
+
+| Id | Type | Shown |
+| --- | --- | --- |
+| `projectNewAlert` | Alert | New Project. `btnProjectNewCancel` / `btnProjectNewConfirm` |
+| Dirty save | Alert | New/Open/Close while dirty. `btnProjectDirtySave` / `btnProjectDirtyDiscard` / `btnProjectDirtyCancel` |
+| `projectRelocateSheet` | Sheet | Open when `cwd` is missing. `btnProjectRelocateCancel` / `btnProjectRelocate` |
+
+---
+
+## Mutexes
+
+- Spot Read is disabled while Stage 3 `chartread` is running.
+- Opening Spot Read does not kill `chartread_{basename}`.
+- Calibrate uses a temporary `CAL_` basename; Save Project stays enabled so the refusal banner can fire.
+- Failed media Apply keeps `manageMediaDialog` open.
+- Duplicate id: `btnViewGamut` (sidebar always on; Stage 5 off without a `.gam`).
-- 
2.39.5


From c4f037535afe9ff9fad4532727180ac3ccc96a56 Mon Sep 17 00:00:00 2001
From: gronod <gronod@users.noreply.git.i3omb.com>
Date: Mon, 14 Sep 2026 14:56:52 +0000
Subject: [PATCH 7/8] docs: restore PlantUML UI maps; draw groups as rectangles

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.
---
 docs/ui-interactive-map-sheets.dot        |  21 -
 docs/ui-interactive-map-sheets.puml       | 274 +++++++++++++
 docs/ui-interactive-map-shell.dot         |  33 --
 docs/ui-interactive-map-shell.puml        | 232 +++++++++++
 docs/ui-interactive-map-stage1-2.dot      |  25 --
 docs/ui-interactive-map-stage1-2.puml     | 216 ++++++++++
 docs/ui-interactive-map-stage3-5-cal.dot  |  31 --
 docs/ui-interactive-map-stage3-5-cal.puml | 231 +++++++++++
 docs/ui-interactive-map.md                | 475 +---------------------
 9 files changed, 960 insertions(+), 578 deletions(-)
 delete mode 100644 docs/ui-interactive-map-sheets.dot
 create mode 100644 docs/ui-interactive-map-sheets.puml
 delete mode 100644 docs/ui-interactive-map-shell.dot
 create mode 100644 docs/ui-interactive-map-shell.puml
 delete mode 100644 docs/ui-interactive-map-stage1-2.dot
 create mode 100644 docs/ui-interactive-map-stage1-2.puml
 delete mode 100644 docs/ui-interactive-map-stage3-5-cal.dot
 create mode 100644 docs/ui-interactive-map-stage3-5-cal.puml

diff --git a/docs/ui-interactive-map-sheets.dot b/docs/ui-interactive-map-sheets.dot
deleted file mode 100644
index c370b6e..0000000
--- a/docs/ui-interactive-map-sheets.dot
+++ /dev/null
@@ -1,21 +0,0 @@
-digraph ICCeryUISheets {
-  bgcolor=white
-  fontcolor=black
-  pad=0.4
-  rankdir=TB
-  nodesep=0.4
-  ranksep=0.5
-  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
-  edge [color=black]
-
-  Root [label="RootView.swift hosts every sheet"]
-  Root -> Settings
-  Root -> About
-  Root -> savePresetDialog
-  Root -> managePresetsDialog
-  Root -> saveMediaRecipeDialog
-  Root -> manageMediaDialog
-  Root -> spotReadView
-  Root -> gamutView
-  Root -> ProjectAlerts
-}
diff --git a/docs/ui-interactive-map-sheets.puml b/docs/ui-interactive-map-sheets.puml
new file mode 100644
index 0000000..f77bf98
--- /dev/null
+++ b/docs/ui-interactive-map-sheets.puml
@@ -0,0 +1,274 @@
+@startuml ICCery-UI-sheets
+title Sheets, dialogs, Spot Read, Gamut, Settings
+
+!theme plain
+skinparam backgroundColor white
+skinparam defaultFontColor black
+skinparam defaultFontSize 13
+skinparam classBackgroundColor white
+skinparam classFontColor black
+skinparam classBorderColor #222222
+skinparam classAttributeFontColor black
+skinparam rectangleBackgroundColor #F4F4F4
+skinparam rectangleBorderColor #222222
+skinparam rectangleFontColor black
+skinparam arrowColor #222222
+skinparam noteBackgroundColor #FFF6C8
+skinparam noteBorderColor #222222
+skinparam noteFontColor black
+skinparam shadowing false
+skinparam classAttributeIconSize 0
+skinparam wrapWidth 240
+skinparam nodesep 24
+skinparam ranksep 28
+rectangle "SettingsView.swift  sheet from openSettingsBtn" {
+  class "Argyll dir  [TextField+Browse]" as ad {
+    empty => bundled sidecars
+  }
+  class "Default instrument  [Picker]" as di {
+    None + i1/p3/CM/SS/20/22/41/51
+    seeds Stage 3 + Spot Read
+    does NOT change instrumentSelect
+  }
+  class "Enable i1Pro 2 LEDs  [Toggle]" as led {
+    Toggle
+  }
+  class "settingsDeltaEGood  [TextField.number]" as dg {
+    TextField.number
+  }
+  class "settingsDeltaEWarning  [TextField.number]" as dw {
+    Save refuses unless Warning > Good
+  }
+  class "settingsCalStaleDays  [TextField.number]" as sd {
+    TextField.number
+  }
+  class "Install location  [Picker]" as il {
+    User | System library
+  }
+  class "Ask before overwriting  [Toggle]" as ao {
+    Toggle
+  }
+  class "Open ColorSync after install  [Toggle]" as oc {
+    Toggle
+  }
+  class "Log level  [Picker]" as ll {
+    Picker
+  }
+  class "Open log folder / Copy path / Copy excerpt  [Button x3]" as lg {
+    Button x3
+  }
+  class "Cancel / Save  [Button]" as ss {
+    Save stays on sheet if validation fails
+    frame 560x620
+  }
+}
+
+rectangle "AboutView.swift" {
+  class "aboutDialog  [Sheet]" as ab {
+    aboutVersion, aboutBuildDate
+    closeAboutBtn  Esc
+  }
+}
+
+rectangle "savePresetDialog  PresetDialogs.swift" {
+  class "savePresetName  [TextField]" as spn {
+    TextField
+  }
+  class "savePresetDesc  [TextField]" as spd {
+    TextField
+  }
+  class "btnCloseSavePresetDialog  [Button]" as spc {
+    Button
+  }
+  class "btnConfirmSavePreset  [Button]" as sps {
+    disabled: name trimmed empty
+  }
+}
+
+rectangle "managePresetsDialog" {
+  class "presetRow-{id}  [Row]" as prw {
+    Built-in: no delete
+    else btnExportPreset-{id} btnDeletePreset-{id}
+  }
+  class "btnImportPreset  [Button]" as pim {
+    Button
+  }
+  class "btnExportActivePreset  [Button]" as pea {
+    shown: selected custom preset
+  }
+  class "btnCloseManagePresetsDialog  [Button]" as pcl {
+    Button
+  }
+}
+
+rectangle "saveMediaRecipeDialog  MediaLibraryDialogs.swift" {
+  class "saveMediaName/Notes/Paper/Ink  [TextField x4]" as smf {
+    TextField x4
+  }
+  class "saveMediaPrinter/Preset/ColourSpace/Cal  [read-only]" as smr {
+    read-only
+  }
+  class "saveMediaApplyCal  [Toggle]" as smc {
+    disabled: !calApplyable
+    calApplyable: path exists, not CAL_ stem
+  }
+  class "btnCloseSaveMediaDialog  [Button]" as smx {
+    Button
+  }
+  class "btnConfirmSaveMedia  [Button]" as sms {
+    disabled: name|paper|ink empty
+             OR captureColourSpaceMismatch
+  }
+}
+
+rectangle "manageMediaDialog" {
+  class "mediaLibraryList  [List]" as mll {
+    mediaRow-{id}
+    btnMediaLibraryApply-{id}
+    btnMediaLibraryDelete-{id}
+    double-click row = Apply
+  }
+  class "manageMediaNotice  [Caption]" as mmn {
+    shown: manageApplyNotice != nil
+    in-sheet copy of failed Apply (#170)
+  }
+  class "btnMediaLibraryApply  [Button]" as mla {
+    Apply selected
+    disabled: selection == nil
+  }
+  class "btnMediaLibraryCaptureFromManage  [Button]" as mlc {
+    dismiss then open capture
+  }
+  class "btnCloseManageMediaDialog  [Button]" as mlx {
+    Button
+  }
+  class "Delete alert  [alert]" as mld {
+    Cancel / Delete
+  }
+}
+
+rectangle "spotReadView  SpotReadView.swift  (#148)" {
+  class "spotSidecarMissing  [Text]" as ssm {
+    shown: !sidecarAvailable
+    hides instrument/transport
+  }
+  class "btnSpotDetectInstruments  [Button]" as sdet {
+    disabled: !canDetect  (detecting or running)
+  }
+  class "spotInstrumentSelect  [Picker]" as sis {
+    disabled: isRunning
+  }
+  class "spotDefaultMissing  [Caption]" as sdm {
+    shown: defaultMissing
+  }
+  class "spotSetDefault  [Toggle]" as ssd {
+    Toggle
+  }
+  class "spotXYHint  [Caption]" as sxy {
+    shown: selected is XY table
+  }
+  class "btnSpotStart  [Button]" as sst {
+    shown: !isRunning
+    disabled: !canStart
+    canStart: sidecar && !detecting && !running
+              && !chartreadRunning && cwd
+  }
+  class "btnSpotCalibrate  [Button]" as sca {
+    shown: running && calibrating
+  }
+  class "btnSpotTrigger  [Button]" as str {
+    shown: running && awaitingStrip  (Read)
+  }
+  class "btnSpotStop  [Button]" as ssp {
+    shown: isRunning
+  }
+  class "spotLastSample / Lab / XYZ / DeltaE  [Display]" as sls {
+    spotLabImplausible if L not in 0...100
+    spotDeltaE hidden on first sample
+  }
+  class "spotHistoryTable  [List]" as sht {
+    rows are buttons spotHistoryRow-{uuid}
+    click restores last sample, no trigger
+  }
+  class "btnSpotCopyLab  [Button]" as scp {
+    disabled: displayedSample == nil
+  }
+  class "btnSpotExportCsv  [Button]" as sex {
+    disabled: samples.isEmpty
+  }
+  class "btnCloseSpotRead  [Button]" as scl {
+    Esc; onDismiss = Stop
+  }
+}
+
+rectangle "gamutView  GamutView.swift  (#147)" {
+  class "gamutLayer-srgb  [Toggle.checkbox]" as gls {
+    sRGB always loaded; can hide; cannot remove
+  }
+  class "gamutLayer-profile  [Toggle]" as glp {
+    disabled: no session .gam
+  }
+  class "gamutLayer-compare  [Toggle]" as glc {
+    disabled: no compare layer
+  }
+  class "btnGamutAddCompare  [Menu]" as gac {
+    btnGamutOpenGam / btnGamutOpenProfile
+  }
+  class "btnGamutRemoveCompare  [Button]" as grc {
+    disabled: compare layer nil
+  }
+  class "btnGamutSampleTiff  [Button]" as gst {
+    Button
+  }
+  class "gamutViewerUnavailable  [Caption]" as gun {
+    shown: no Metal / SCNView failed
+    toggles + inspect still enabled
+  }
+  class "btnResetGamutCamera  [Button]" as grs {
+    R when focused
+  }
+  class "gamutLabEntryL/A/B  [TextField x3]" as gle {
+    TextField x3
+  }
+  class "btnGamutInspectLab  [Button]" as gin {
+    disabled: !canInspectLab
+  }
+  class "gamutInspectPanel  [Panel]" as gip {
+    Panel
+  }
+  class "btnCloseGamut  [Button]" as gcl {
+    Esc
+  }
+  class "gamutTiffPreview sheet  [Sheet]" as gtf {
+    showingTiffPreview
+    click pixel; btnCloseGamutTiffPreview
+  }
+}
+
+rectangle "Project alerts / relocate  RootView + ProjectUI" {
+  class "projectNewAlert  [alert]" as pna {
+    btnProjectNewCancel / btnProjectNewConfirm
+  }
+  class "Dirty save alert  [alert]" as pda {
+    btnProjectDirtySave
+    btnProjectDirtyDiscard
+    btnProjectDirtyCancel
+    shown when New/Open/Close and dirty
+  }
+  class "projectRelocateSheet  [Sheet]" as prs {
+    shown: cwd missing on Open
+    btnProjectRelocateCancel
+    btnProjectRelocate  Choose Folder…
+  }
+}
+
+note as nMutex
+  Mutex / exclusive
+  Spot Read disabled while Stage 3 chartread runs
+  Opening Spot Read never kills chartread_{basename}
+  Calibrate uses temporary CAL_ basename; Save Project stays
+  enabled so the refusal banner can fire; chip Save uses canSave
+  Failed media Apply keeps manageMediaDialog open
+  Window noticeText is occluded by that sheet — use manageMediaNotice
+end note
+@enduml
diff --git a/docs/ui-interactive-map-shell.dot b/docs/ui-interactive-map-shell.dot
deleted file mode 100644
index cf7f2b2..0000000
--- a/docs/ui-interactive-map-shell.dot
+++ /dev/null
@@ -1,33 +0,0 @@
-digraph ICCeryUIShell {
-  bgcolor=white
-  fontcolor=black
-  pad=0.4
-  rankdir=TB
-  nodesep=0.4
-  ranksep=0.5
-  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
-  edge [color=black]
-
-  Window [label="WindowGroup  ICCeryApp.swift"]
-  Root [label="RootView.swift\nsheets and alerts"]
-  Sidebar [label="SidebarView.swift  270pt"]
-  Banner [label="noticeText  NoticeBanner"]
-  Stage [label="WizardStageContent"]
-
-  Window -> Root
-  Root -> Sidebar
-  Root -> Banner
-  Root -> Stage
-
-  Sidebar -> Presets
-  Sidebar -> Media
-  Sidebar -> Studio
-  Sidebar -> Stepper
-  Sidebar -> ProjectChip
-  Stage -> S1 [label="stage-1"]
-  Stage -> S2 [label="stage-2"]
-  Stage -> S3 [label="stage-3"]
-  Stage -> S4 [label="stage-4"]
-  Stage -> S5 [label="stage-5"]
-  Stage -> Cal [label="stage-cal"]
-}
diff --git a/docs/ui-interactive-map-shell.puml b/docs/ui-interactive-map-shell.puml
new file mode 100644
index 0000000..fc9474b
--- /dev/null
+++ b/docs/ui-interactive-map-shell.puml
@@ -0,0 +1,232 @@
+@startuml ICCery-UI-shell
+title ICCery v2 — interactive UI map (develop)\nobject names, files, enable / hide rules
+caption Accessibility ids in quotes. Disk gating: WizardGating.swift. No App Sandbox.
+
+!theme plain
+skinparam backgroundColor white
+skinparam defaultFontColor black
+skinparam defaultFontSize 13
+skinparam classBackgroundColor white
+skinparam classFontColor black
+skinparam classBorderColor #222222
+skinparam classAttributeFontColor black
+skinparam rectangleBackgroundColor #F4F4F4
+skinparam rectangleBorderColor #222222
+skinparam rectangleFontColor black
+skinparam arrowColor #222222
+skinparam noteBackgroundColor #FFF6C8
+skinparam noteBorderColor #222222
+skinparam noteFontColor black
+skinparam shadowing false
+skinparam classAttributeIconSize 0
+skinparam wrapWidth 240
+skinparam nodesep 24
+skinparam ranksep 28
+class "WindowGroup ICCery  [ICCeryApp.swift]" as win {
+  1280x800, min 1100x700
+  File menu: ProjectCommands
+}
+class "RootView  [RootView.swift]" as root {
+  sidebar 270pt + stage column
+  sheets / alerts hosted here
+}
+
+win --> root
+
+rectangle "Persistent chrome" {
+  class "SidebarView  [SidebarView.swift]" as side {
+    SidebarView.swift
+  }
+  class "NoticeBanner  [NoticeBanner.swift]" as ban {
+    id noticeText
+    shown: wizard.notice != nil
+    auto-hide 6s unless nil
+    close: xmark (no a11y id)
+  }
+  class "WizardStageContent  [RootView.swift]" as stage {
+    switch wizard.stage
+  }
+}
+
+root --> side
+root --> ban
+root --> stage
+
+rectangle "Sidebar header" {
+  class "openSettingsBtn  [Button]" as sSet {
+    gearshape
+    always enabled
+    presents SettingsView sheet
+  }
+  class "openAboutBtn  [Button]" as sAbt {
+    info.circle
+    always enabled
+    presents AboutView
+  }
+  class "btnToggleAllHelp  [Button]" as sHlp {
+    questionmark.circle
+    toggles showingAllHelp
+    HelpOverlayView: yellow dots when on
+  }
+}
+side --> sSet
+side --> sAbt
+side --> sHlp
+
+rectangle "Presets (#11)" {
+  class "presetSelect  [Picker.menu]" as pre {
+    tags: none + ProfilingPreset.id
+    set applies preset immediately
+    "No preset" does not factory-reset
+  }
+  class "btnSavePresetModal  [Button]" as preS {
+    always enabled
+    showingSavePreset = true
+  }
+  class "btnOpenPresetsDialog  [Button]" as preM {
+    always enabled
+    showingManagePresets = true
+  }
+}
+side --> pre
+side --> preS
+side --> preM
+
+rectangle "Media library (#146)" {
+  class "mediaSelect  [Picker.menu]" as med {
+    tags: none + MediaRecipe.id
+    never reuses presetSelect
+    failed apply snaps back to none
+  }
+  class "mediaRecipeStale  [Caption]" as medSt {
+    shown: staleReasons[selected] nonempty
+    "Printer not installed" or "Calibration stale"
+  }
+  class "btnMediaLibraryCapture  [Button]" as medC {
+    disabled: print.selectedPrinter.isEmpty
+    needs Stage 2 queue
+  }
+  class "btnMediaLibraryManage  [Button]" as medM {
+    always enabled
+  }
+}
+side --> med
+side --> medSt
+side --> medC
+side --> medM
+
+rectangle "Studio (not stepper)" {
+  class "btnCalibratePrinter  [Button]" as calB {
+    always enabled
+    wizard.enterCalibration()
+    Stage 0, not numbered
+  }
+  class "btnViewGamut  [Button]" as gamB {
+    Sidebar copy — same id as Stage 5
+    always enabled
+    no .gam => sRGB only
+  }
+  class "btnSpotRead  [Button]" as spotB {
+    disabled: workingDirectory==nil
+             OR measurement.isChartreadRunning
+  }
+}
+side --> calB
+side --> gamB
+side --> spotB
+
+rectangle "Stepper 1–5  (disk is truth)" {
+  class "StepperRow stage N  [Button.plain]" as step {
+    WizardStage.stepperStages
+    disabled / opacity 0.45 unless isUnlocked
+    go(to:) allowed backward always
+    calibrate is NOT a stepper row
+  }
+  note as nGate
+    WizardGating.swift / WizardViewModel.isUnlocked
+    1 generate: always
+    2 layOutPrint: .ti1
+    3 measure: .ti1 AND .ti2
+    4 buildProfile: .ti3 (not .ti2 alone)
+    5 verifyInstall: .ti3 AND .icc/.icm
+    Re-probed on window key (#151)
+  end note
+}
+side --> step
+step .. nGate
+
+rectangle "Project chip (#149)  ProjectUI.swift" {
+  class "projectChip  [Container]" as chip {
+    Container
+  }
+  class "projectChipName  [Text]" as cn {
+    bound name or "No project"
+  }
+  class "projectChipPath  [Text]" as cp {
+    shown if bound; last path component
+  }
+  class "projectChipStale  [Caption]" as cs {
+    shown: diskBehindNotes
+  }
+  class "btnProjectReveal  [Button]" as cr {
+    shown if bound
+  }
+  class "btnProjectSave  [Button]" as csv {
+    shown if bound
+    disabled: !canSave
+    canSave: isBound && basename && cwd
+    CAL_ basename still enabled (refusal banner)
+  }
+  class "btnProjectOpen  [Button]" as co {
+    shown if NOT bound
+  }
+}
+side --> chip
+chip --> cn
+chip --> cp
+chip --> cs
+chip --> cr
+chip --> csv
+chip --> co
+
+rectangle "File menu  ProjectCommands / ICCeryApp.swift" {
+  class "menuProjectNew  [Button]" as mN {
+    ⌘N  requestNew()
+  }
+  class "menuProjectOpen  [Button]" as mO {
+    ⌘O
+  }
+  class "menuProjectRecents  [Menu]" as mR {
+    disabled: recents.isEmpty
+    items: projectRecent-{bookmarkHash}
+    menuProjectRecentsClear
+  }
+  class "menuProjectSave  [Button]" as mS {
+    ⌘S  disabled: !canSave
+  }
+  class "menuProjectSaveAs  [Button]" as mSa {
+    ⇧⌘S  disabled: !canSaveAs
+    canSaveAs: basename && cwd (no bind required)
+  }
+  class "menuProjectReport  [Button]" as mRp {
+    disabled: !canReport
+  }
+  class "menuProjectClose  [Button]" as mCl {
+    disabled: !isBound
+  }
+}
+
+class "stage-1 / Stage1View.swift" as st1
+stage --> st1
+class "stage-2 / Stage2View.swift" as st2
+stage --> st2
+class "stage-3 / Stage3View.swift" as st3
+stage --> st3
+class "stage-4 / Stage4View.swift" as st4
+stage --> st4
+class "stage-5 / Stage5View.swift" as st5
+stage --> st5
+class "stage-cal / CalibrationView.swift" as st0
+stage --> st0
+@enduml
+
diff --git a/docs/ui-interactive-map-stage1-2.dot b/docs/ui-interactive-map-stage1-2.dot
deleted file mode 100644
index b3e6fb1..0000000
--- a/docs/ui-interactive-map-stage1-2.dot
+++ /dev/null
@@ -1,25 +0,0 @@
-digraph ICCeryUIStage12 {
-  bgcolor=white
-  fontcolor=black
-  pad=0.4
-  rankdir=TB
-  nodesep=0.4
-  ranksep=0.5
-  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
-  edge [color=black]
-
-  S1 [label="stage-1  Stage1View.swift"]
-  S1 -> colourSpace
-  S1 -> Patches
-  S1 -> TargetFile
-  S1 -> Advanced
-  S1 -> btnGenerate
-  S1 -> targenLog
-
-  S2 [label="stage-2  Stage2View.swift"]
-  S2 -> Layout
-  S2 -> Label
-  S2 -> btnCreateLayout
-  S2 -> tiffGallery
-  S2 -> rawPrintPanel
-}
diff --git a/docs/ui-interactive-map-stage1-2.puml b/docs/ui-interactive-map-stage1-2.puml
new file mode 100644
index 0000000..93d5438
--- /dev/null
+++ b/docs/ui-interactive-map-stage1-2.puml
@@ -0,0 +1,216 @@
+@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 classBackgroundColor white
+skinparam classFontColor black
+skinparam classBorderColor #222222
+skinparam classAttributeFontColor black
+skinparam rectangleBackgroundColor #F4F4F4
+skinparam rectangleBorderColor #222222
+skinparam rectangleFontColor black
+skinparam arrowColor #222222
+skinparam noteBackgroundColor #FFF6C8
+skinparam noteBorderColor #222222
+skinparam noteFontColor black
+skinparam shadowing false
+skinparam classAttributeIconSize 0
+skinparam wrapWidth 240
+skinparam nodesep 24
+skinparam ranksep 28
+rectangle "stage-1  Stage1View.swift" {
+  class "colourSpace  [Picker.segmented]" as csp {
+    RGB | CMYK
+  }
+  class "patchCountPreset  [Picker]" as pcp {
+    PatchCountPreset.allCases
+  }
+  class "patchCountCustom  [TextField.number]" as pcc {
+    shown: patchPreset == .custom
+  }
+  class "whitePatches  [Stepper]" as wp {
+    0...50
+  }
+  class "blackPatches  [Stepper]" as bp {
+    0...50
+  }
+  class "targetBasename  [TextField]" as tb {
+    TextField
+  }
+  class "btnBrowse  [Button]" as bb {
+    save panel; sets basename
+  }
+  class "btnSelectWorkDir  [Button]" as wd {
+    Button
+  }
+  class "btnOpenExisting  [Button]" as oe {
+    .ti1 or .ti2 (+ matching .ti1)
+  }
+  class "btn-import-dataset  [Button]" as imp {
+    .ti3 / .txt / .cgats / .csv
+    unlocks stage 4
+  }
+  class "selectedPathDisplay  [Text]" as spd {
+    Text
+  }
+  class "targenAdvancedDetails  [DisclosureGroup]" as adv {
+    UI tests pre-expand
+  }
+  class "btnGenerate  [Button]" as gen {
+    disabled: !canGenerate || targenRunning
+    canGenerate: valid basename AND directory
+    label Generating… while running
+  }
+  class "targenLogContainer / targenLog  [DisclosureGroup]" as tlog {
+    ProcessLogView.swift
+  }
+}
+
+rectangle "Advanced (hidden until disclosure open)" {
+  class "targenGreySteps  [Toggle+TextField]" as ag {
+    field shown iff toggle on
+  }
+  class "targenSingleChannelSteps  [Toggle+TextField]" as as1 {
+    Toggle+TextField
+  }
+  class "targenNeutralSteps  [Toggle+TextField]" as an {
+    Toggle+TextField
+  }
+  class "targenNeutralConcentration  [Toggle+Slider]" as anc {
+    0...1  shown iff on
+  }
+  class "targenAdaptation  [Toggle+Slider]" as aa {
+    0...1
+  }
+  class "targenPrecondProfile  [TextField]" as ap {
+    TextField
+  }
+  class "btnBrowsePrecondProfile  [Button]" as apb {
+    Button
+  }
+  class "targenHighQuality  [Toggle]" as ahq {
+    OFPS -G
+  }
+  class "targenAlgorithm  [Picker]" as aal {
+    Picker
+  }
+  class "targenInkLimitGroup  [Toggle+TextField]" as ail {
+    shown: colourSpace == cmyk
+  }
+  class "targenDarkEmphasis  [Toggle+Slider]" as ad {
+    0...3
+  }
+  class "targenDevicePower  [Toggle+Slider]" as adp {
+    0...3
+  }
+}
+adv --> ag
+
+rectangle "stage-2  Stage2View.swift" {
+  class "cmWarningBanner  [Banner]" as cmw {
+    always visible on stage 2
+    not a control
+  }
+  class "instrumentSelect  [Picker]" as ins {
+    PrintInstrument — chart code, NOT USB port
+  }
+  class "pageSizeSelect  [Picker]" as pgs {
+    Picker
+  }
+  class "customPageSizeRow  [HStack]" as cps {
+    shown: pageSize == .custom
+    customPageW / customPageH  mm
+  }
+  class "bitDepth  [Picker]" as bit {
+    8-bit | 16-bit TIFF
+    (no a11y id on picker)
+  }
+  class "tiffDpi  [Stepper]" as dpi {
+    72...600
+  }
+  class "printtargLayoutOrder  [Picker]" as lo {
+    Picker
+  }
+  class "printtargCustomSeedGroup  [HStack]" as seed {
+    shown: layoutOrder == .customSeed
+    id printtargCustomSeed
+  }
+  class "btnToggleLabelEdit  [Button]" as tle {
+    toggles labelIsCustom
+    title: Edit label… / Use automatic label
+  }
+  class "targetMetadataPrinter  [TextField]" as mp {
+    TextField
+  }
+  class "targetMetadataInkSet  [TextField]" as mi {
+    TextField
+  }
+  class "targetMetadataDriverPaper  [TextField]" as md {
+    TextField
+  }
+  class "targetMetadataActualPaper  [TextField]" as ma {
+    TextField
+  }
+  class "targetLabelPreview  [TextField|Text]" as lpv {
+    TextField if labelIsCustom else Text(automatic)
+  }
+  class "btnCreateLayout  [Button]" as lay {
+    disabled: printtargRunning || basename.empty
+  }
+  class "printtargLogContainer  [DisclosureGroup]" as plog {
+    DisclosureGroup
+  }
+  class "tiffGallery  [Grid]" as gal {
+    shown: printtargResult != nil
+    galleryInfo, galleryGrid
+    galleryPage-{index}
+    btnPrintPage-{index}
+    Print disabled: isPrinting || selectedPrinter.empty
+  }
+}
+
+rectangle "rawPrintPanel" {
+  class "printerSelect  [Picker]" as ps {
+    CUPS queues
+  }
+  class "printerStatusBadge  [Caption]" as psb {
+    shown: selected printer in list
+  }
+  class "btnRefreshPrinters  [Button]" as prf {
+    Button
+  }
+  class "btnPrinterProperties  [Button]" as ppr {
+    disabled: selectedPrinter.empty
+    bound NSPrintPanel
+  }
+  class "printerTraySelect  [Picker]" as ptr {
+    shown: trays nonempty
+  }
+  class "printerMediaTypeSelect  [Picker]" as pmt {
+    shown: mediaTypes nonempty
+    also mediaTypeGroup
+  }
+  class "btnOrientPortrait  [Button]" as por {
+    Button
+  }
+  class "btnOrientLandscape  [Button]" as lan {
+    Button
+  }
+  class "btnPrintAll  [Button]" as pal {
+    disabled: isPrinting
+             || printtargResult==nil
+             || selectedPrinter.empty
+  }
+  class "btnAdvanceToStage3  [Button]" as a3 {
+    disabled: printtargResult==nil
+             || !isUnlocked(.measure)
+  }
+  class "printNotificationText  [Caption]" as pnt {
+    shown: print.printNotice != nil
+  }
+}
+@enduml
+
diff --git a/docs/ui-interactive-map-stage3-5-cal.dot b/docs/ui-interactive-map-stage3-5-cal.dot
deleted file mode 100644
index 652682f..0000000
--- a/docs/ui-interactive-map-stage3-5-cal.dot
+++ /dev/null
@@ -1,31 +0,0 @@
-digraph ICCeryUIStage345 {
-  bgcolor=white
-  fontcolor=black
-  pad=0.4
-  rankdir=TB
-  nodesep=0.4
-  ranksep=0.5
-  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
-  edge [color=black]
-
-  S3 [label="stage-3  Stage3View.swift"]
-  S3 -> Instrument
-  S3 -> Transport
-  S3 -> swatchGrid
-  S3 -> Averaging
-
-  S4 [label="stage-4  Stage4View.swift"]
-  S4 -> colprof
-  S4 -> btnCreateProfile
-
-  S5 [label="stage-5  Stage5View.swift"]
-  S5 -> btnVerifyProfile
-  S5 -> btnViewGamut
-  S5 -> btnInstallProfile
-  S5 -> History
-
-  Cal [label="stage-cal  CalibrationView.swift"]
-  Cal -> Wedge
-  Cal -> Workflow
-  Cal -> btnCalReturn
-}
diff --git a/docs/ui-interactive-map-stage3-5-cal.puml b/docs/ui-interactive-map-stage3-5-cal.puml
new file mode 100644
index 0000000..6c53b1e
--- /dev/null
+++ b/docs/ui-interactive-map-stage3-5-cal.puml
@@ -0,0 +1,231 @@
+@startuml ICCery-UI-stage3-5-cal
+title Stages 3–5, Calibrate Printer, Measure transport
+
+!theme plain
+skinparam backgroundColor white
+skinparam defaultFontColor black
+skinparam defaultFontSize 13
+skinparam classBackgroundColor white
+skinparam classFontColor black
+skinparam classBorderColor #222222
+skinparam classAttributeFontColor black
+skinparam rectangleBackgroundColor #F4F4F4
+skinparam rectangleBorderColor #222222
+skinparam rectangleFontColor black
+skinparam arrowColor #222222
+skinparam noteBackgroundColor #FFF6C8
+skinparam noteBorderColor #222222
+skinparam noteFontColor black
+skinparam shadowing false
+skinparam classAttributeIconSize 0
+skinparam wrapWidth 240
+skinparam nodesep 24
+skinparam ranksep 28
+rectangle "stage-3  Stage3View.swift / MeasurementWorkflowViewModel" {
+  class "btnDetectInstruments  [Button]" as d3 {
+    disabled: !canDetect  (!isDetecting)
+  }
+  class "chartreadInstrumentSelect  [Picker.menu]" as i3 {
+    Auto + instlist ports
+  }
+  class "xyTableHint  [Caption]" as xyh {
+    shown: selectedInstrument.isXY
+  }
+  class "xyTablePanel  [HStack]" as xyp {
+    shown: isXY
+    xyStepPlace / Align / Scan / Remove
+    highlight = xyStep
+  }
+  class "chartreadPrompt  [Text]" as pr {
+    Text
+  }
+  class "chartreadLastError  [Caption]" as err {
+    shown: chartreadNotice != nil
+  }
+  class "btnStartRead  [Button]" as sr {
+    shown: !isChartreadRunning
+    disabled: !canStartRead
+    canStart: basename && cwd && !running
+  }
+  class "btnCalibrate  [Button]" as cal3 {
+    shown: running && state==calibrating
+  }
+  class "btnTrigger  [Button]" as trg {
+    shown: running && awaitingStrip
+  }
+  class "btnDoneReadEarly  [Button]" as de {
+    shown: awaitingStrip
+  }
+  class "btnAccept  [Button]" as acc {
+    shown: tablePlaceSheet | tableAlign
+           | promptContinue | warning
+    title Continue or Continue (send 'X')
+  }
+  class "btnRetry  [Button]" as rty {
+    shown: state==error
+  }
+  class "btnDoneRead  [Button]" as dn {
+    shown: allStripsRead
+  }
+  class "btnCancel  [Button]" as cnc {
+    shown: isChartreadRunning
+  }
+  class "swatchGrid  [Scroll]" as sw {
+    swatch-{rowId}{loc}
+  }
+  class "readStats  [Text]" as rst {
+    Text
+  }
+  class "chartreadAveragingPanel  [Panel]" as avg {
+    shown: passSnapshots nonempty OR isFinished
+    passCounterBadge, passesList
+  }
+  class "btnMeasureAnotherSheet  [Button]" as mas {
+    disabled: !isFinished || isChartreadRunning
+  }
+  class "btnFinishAndAverage  [Button]" as fa {
+    disabled: !canFinish || isFinishing
+    canFinish: isFinished && passes nonempty
+  }
+}
+
+rectangle "stage-4  Stage4View.swift / ProfileWorkflowViewModel" {
+  class "colprofAlgorithm  [Picker]" as alg {
+    Picker
+  }
+  class "colprofQuality  [Picker]" as q {
+    Picker
+  }
+  class "colprofFwa  [Picker]" as fwa {
+    Picker
+  }
+  class "colprofFwaCustomPath  [TextField]" as fwap {
+    shown: custom spectrum selected
+  }
+  class "btnBrowseFwaSp  [Button]" as fwab {
+    shown with custom path
+  }
+  class "colprofIlluminant  [TextField]" as ill {
+    TextField
+  }
+  class "colprofObserver  [TextField]" as obs {
+    TextField
+  }
+  class "colprofInputViewCond  [TextField]" as ivc {
+    TextField
+  }
+  class "colprofOutputViewCond  [TextField]" as ovc {
+    TextField
+  }
+  class "colprofDescription  [TextField]" as desc {
+    TextField
+  }
+  class "colprofCopyright  [TextField]" as cpr {
+    TextField
+  }
+  class "colprofApplyCalibration  [Toggle]" as ac {
+    Toggle
+  }
+  class "colprofCalibrationFile  [TextField]" as cf {
+    shown: applyCalibration
+  }
+  class "btnBrowseCalibrationFile  [Button]" as cfb {
+    shown: applyCalibration
+  }
+  class "btnCreateProfile  [Button]" as cp {
+    disabled: !canCreateProfile
+    canCreate: basename && cwd && !colprofRunning
+  }
+  class "colprofProgressIndicator  [Progress]" as cpi {
+    shown: isColprofRunning
+  }
+}
+
+rectangle "stage-5  Stage5View.swift" {
+  class "btnVerifyProfile  [Button]" as vf {
+    disabled: !canVerify
+    canVerify: createdProfileURL && !profcheckRunning
+  }
+  class "profcheckProgressIndicator  [Progress]" as ppi {
+    shown: isProfcheckRunning
+  }
+  class "btnViewGamut  [Button]" as vg5 {
+    DUPLICATE id with sidebar
+    disabled: createdGamutURL == nil
+  }
+  class "btnInstallProfile  [Button]" as inst {
+    disabled: createdProfileURL == nil
+    may present collision alert
+  }
+  class "driftPrinterFilter  [Picker]" as df {
+    Picker
+  }
+  class "btnExportHistory  [Button]" as eh {
+    Button
+  }
+  class "btnClearHistory  [Button]" as ch {
+    Button
+  }
+  class "verificationHistoryTable  [Table]" as ht {
+    Table
+  }
+  class "driftChart  [View]" as dc {
+    DriftChartView.swift  not interactive
+  }
+  class "driftAlert / profcheckWarningBanner  [Banner]" as dalt {
+    shown on fail / warning status
+  }
+}
+
+rectangle "Install collision alert" {
+  class "profileOverwriteBtn  [Button]" as io {
+    Button
+  }
+  class "profileRenameBtn  [Button]" as ir {
+    Button
+  }
+  class "profileCancelCollisionBtn  [Button]" as ic {
+    shown: showingInstallCollision
+    && settings.askBeforeOverwriteProfile
+  }
+}
+
+rectangle "stage-cal  CalibrationView.swift  (Stage 0)" {
+  class "Colour Space  [Picker.segmented]" as ccs {
+    RGB | CMYK  (no a11y id)
+  }
+  class "calSteps  [TextField.number]" as cst {
+    TextField.number
+  }
+  class "White patches  [TextField.number]" as cwp {
+    no a11y id
+  }
+  class "calInkExplore  [TextField]" as cin {
+    shown: colourSpace == cmyk
+  }
+  class "calNeutralEmphasis  [Toggle.checkbox]" as cne {
+    Toggle.checkbox
+  }
+  class "btnCalGenerate  [Button]" as cg {
+    disabled: basename.empty || cwd==nil || isGenerating
+  }
+  class "btnCalLayout  [Button]" as cl {
+    same disable as Generate
+  }
+  class "btnCalMeasure  [Button]" as cm {
+    disabled: calibrationTi3URL == nil
+  }
+  class "btnCalCompute  [Button]" as cc {
+    disabled: !canCompute
+    canCompute: .ti3 exists && !isComputing
+  }
+  class "calApplyToggle  [Toggle]" as cat {
+    shown: computedCalURL != nil
+  }
+  class "btnCalReturn  [Button]" as cr {
+    Esc / cancelAction
+    restores original basename
+  }
+}
+@enduml
+
diff --git a/docs/ui-interactive-map.md b/docs/ui-interactive-map.md
index 3f4eb48..fd0eae5 100644
--- a/docs/ui-interactive-map.md
+++ b/docs/ui-interactive-map.md
@@ -1,473 +1,12 @@
 # Interactive UI map
 
-Accessibility **ids**, source files, and enable / hide / disable rules for ICCery v2 (`develop`).
+PlantUML class maps of every interactive control (accessibility id, type, enable / hide rules). One diagram per file so Kroki renders each.
 
-Gitea Kroki 0.30.1 cannot run PlantUML on this host (Graal native image needs AVX2). Overview graphs below are small GraphViz `dot` diagrams with an **opaque white canvas and black type** so they stay readable in dark mode. Detail is in the tables — those are the useful map.
+Packages are drawn as **rectangles**, not folders, on an opaque white canvas.
 
----
-
-## Shell
-
-```graphviz
-digraph ICCeryUIShell {
-  bgcolor=white
-  fontcolor=black
-  pad=0.4
-  rankdir=TB
-  nodesep=0.4
-  ranksep=0.5
-  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
-  edge [color=black]
-  Window [label="WindowGroup  ICCeryApp.swift"]
-  Root [label="RootView.swift  sheets and alerts"]
-  Sidebar [label="SidebarView.swift  270pt"]
-  Banner [label="noticeText  NoticeBanner"]
-  Stage [label="WizardStageContent"]
-  Window -> Root
-  Root -> Sidebar
-  Root -> Banner
-  Root -> Stage
-  Sidebar -> Presets
-  Sidebar -> Media
-  Sidebar -> Studio
-  Sidebar -> Stepper
-  Sidebar -> ProjectChip
-  Stage -> S1 [label="stage-1"]
-  Stage -> S2 [label="stage-2"]
-  Stage -> S3 [label="stage-3"]
-  Stage -> S4 [label="stage-4"]
-  Stage -> S5 [label="stage-5"]
-  Stage -> Cal [label="stage-cal"]
-}
-```
-
-Window is `ICCeryApp.swift` (1280×800, min 1100×700). Almost every sheet is presented from `RootView.swift`, not the 270 pt sidebar.
-
-`noticeText` (`NoticeBanner.swift`): shown when `wizard.notice != nil`. Auto-hides after 6s unless `autoHideAfter` is nil. Close (xmark) has no accessibility id. Behind a modal sheet it is not in the AX tree — Manage Media uses `manageMediaNotice` instead (#170).
-
-### Sidebar header — `SidebarView.swift`
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `openSettingsBtn` | Button (gear) | always | never |
-| `openAboutBtn` | Button (info) | always | never |
-| `btnToggleAllHelp` | Button | always | never — toggles yellow help dots |
-
-### Presets — `SidebarView.swift` / `PresetDialogs.swift`
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `presetSelect` | Picker.menu | always | never. `none` does **not** factory-reset |
-| `btnSavePresetModal` | Button | always | never |
-| `btnOpenPresetsDialog` | Button | always | never |
-
-### Media library — `SidebarView.swift` / `MediaLibraryDialogs.swift`
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `mediaSelect` | Picker.menu | always | never. Failed Apply snaps back to `none` |
-| `mediaRecipeStale` | Caption | `staleReasons[selected]` nonempty | — |
-| `btnMediaLibraryCapture` | Button | always | `print.selectedPrinter` empty (needs Stage 2 queue) |
-| `btnMediaLibraryManage` | Button | always | never |
-
-### Studio (not the stepper)
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `btnCalibratePrinter` | Button | always | never. Enters Stage 0 (`stage-cal`) |
-| `btnViewGamut` | Button | always | **never on the sidebar**. Same id as Stage 5, where it **is** disabled if there is no `.gam` |
-| `btnSpotRead` | Button | always | no working folder **or** Stage 3 `chartread` is running |
-
-### Stepper 1–5 — `SidebarView.swift` / `WizardGating.swift`
-
-Each row is a `Button.plain`. Calibrate is **not** a stepper row.
-
-| Stage | Unlocked when |
+| Diagram | File |
 | --- | --- |
-| 1 Generate (`stage-1`) | always |
-| 2 Lay out (`stage-2`) | `.ti1` exists |
-| 3 Measure (`stage-3`) | `.ti1` **and** `.ti2` |
-| 4 Build (`stage-4`) | `.ti3` (a `.ti2` alone is not enough) |
-| 5 Verify (`stage-5`) | `.ti3` **and** `.icc`/`.icm` |
-
-Disabled / opacity 0.45 unless `isUnlocked`. Backward is always allowed. Re-probed when the window becomes key (#151).
-
-### Project chip — `ProjectUI.swift`
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `projectChip` | container | always | — |
-| `projectChipName` | Text | always (`No project` if unbound) | — |
-| `projectChipPath` | Text | bound | — |
-| `projectChipStale` | Caption | `diskBehindNotes` | — |
-| `btnProjectReveal` | Button | bound | never |
-| `btnProjectSave` | Button | bound | `!canSave` (needs bind + basename + cwd). `CAL_` basename stays enabled so the refusal banner can fire |
-| `btnProjectOpen` | Button | **not** bound | never |
-
-### File menu — `ProjectCommands` in `ICCeryApp.swift`
-
-Menu ids are `menuProject*`, not `btnProject*`.
-
-| Id | Type | Disabled when |
-| --- | --- | --- |
-| `menuProjectNew` | Button Cmd-N | never |
-| `menuProjectOpen` | Button Cmd-O | never |
-| `menuProjectRecents` | Menu | recents empty. Items: `projectRecent-{bookmarkHash}`, `menuProjectRecentsClear` |
-| `menuProjectSave` | Button Cmd-S | `!canSave` |
-| `menuProjectSaveAs` | Button Shift-Cmd-S | `!canSaveAs` (basename + cwd; bind not required) |
-| `menuProjectReport` | Button | `!canReport` |
-| `menuProjectClose` | Button | `!isBound` |
-
----
-
-## Stages 1–2
-
-```graphviz
-digraph ICCeryUIStage12 {
-  bgcolor=white
-  fontcolor=black
-  pad=0.4
-  rankdir=TB
-  nodesep=0.4
-  ranksep=0.5
-  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
-  edge [color=black]
-  S1 [label="stage-1  Stage1View.swift"]
-  S1 -> colourSpace
-  S1 -> Patches
-  S1 -> TargetFile
-  S1 -> Advanced
-  S1 -> btnGenerate
-  S1 -> targenLog
-  S2 [label="stage-2  Stage2View.swift"]
-  S2 -> Layout
-  S2 -> Label
-  S2 -> btnCreateLayout
-  S2 -> tiffGallery
-  S2 -> rawPrintPanel
-}
-```
-
-### Stage 1 — `Stage1View.swift` / `TargetWorkflowViewModel.swift`
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `colourSpace` | Picker.segmented | always | never. RGB \| CMYK |
-| `patchCountPreset` | Picker | always | never |
-| `patchCountCustom` | TextField.number | `patchPreset == .custom` | — |
-| `whitePatches` | Stepper 0…50 | always | never |
-| `blackPatches` | Stepper 0…50 | always | never |
-| `targetBasename` | TextField | always | never |
-| `btnBrowse` | Button | always | never |
-| `btnSelectWorkDir` | Button | always | never |
-| `btnOpenExisting` | Button | always | never. `.ti1` or `.ti2` (+ matching `.ti1`) |
-| `btn-import-dataset` | Button | always | never. `.ti3` / txt / cgats / csv; unlocks stage 4 |
-| `selectedPathDisplay` | Text | always | — |
-| `targenAdvancedDetails` | DisclosureGroup | always | UI tests pre-expand it |
-| `targenGreySteps` | Toggle + TextField | inside Advanced | field only if toggle on |
-| `targenSingleChannelSteps` | Toggle + TextField | inside Advanced | field only if toggle on |
-| `targenNeutralSteps` | Toggle + TextField | inside Advanced | field only if toggle on |
-| `targenNeutralConcentration` | Toggle + Slider 0…1 | inside Advanced | slider only if toggle on |
-| `targenAdaptation` | Toggle + Slider 0…1 | inside Advanced | slider only if toggle on |
-| `targenPrecondProfile` | TextField | inside Advanced | — |
-| `btnBrowsePrecondProfile` | Button | inside Advanced | — |
-| `targenHighQuality` | Toggle | inside Advanced | — |
-| `targenAlgorithm` | Picker | inside Advanced | — |
-| `targenInkLimitGroup` | Toggle + TextField | Advanced **and** colour space is CMYK | field only if toggle on |
-| `targenDarkEmphasis` | Toggle + Slider 0…3 | inside Advanced | slider only if toggle on |
-| `targenDevicePower` | Toggle + Slider 0…3 | inside Advanced | slider only if toggle on |
-| `btnGenerate` | Button | always | `!canGenerate` or `targenRunning`. `canGenerate` = valid basename **and** directory |
-| `targenLogContainer` / `targenLog` | DisclosureGroup | always | `ProcessLogView.swift` |
-
-Those four sliders are the **only** sliders in the app.
-
-### Stage 2 — `Stage2View.swift` / `PrintSessionViewModel.swift`
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `cmWarningBanner` | Banner | always on stage 2 | not a control |
-| `instrumentSelect` | Picker | always | never. Chart **code**, not a USB port |
-| `pageSizeSelect` | Picker | always | never |
-| `customPageSizeRow` (`customPageW` / `customPageH`) | TextField.number | `pageSize == .custom` | — |
-| Bit depth picker | Picker | always | no a11y id |
-| `tiffDpi` | Stepper 72…600 | always | never |
-| `printtargLayoutOrder` | Picker | always | never |
-| `printtargCustomSeedGroup` / `printtargCustomSeed` | TextField | `layoutOrder == .customSeed` | — |
-| `btnToggleLabelEdit` | Button | always | never. Title swaps Edit / Use automatic |
-| `targetMetadataPrinter` | TextField | always | never |
-| `targetMetadataInkSet` | TextField | always | never |
-| `targetMetadataDriverPaper` | TextField | always | never |
-| `targetMetadataActualPaper` | TextField | always | never |
-| `targetLabelPreview` | TextField or Text | always | TextField only if `labelIsCustom` |
-| `btnCreateLayout` | Button | always | `printtargRunning` or basename empty |
-| `printtargLogContainer` | DisclosureGroup | always | — |
-| `tiffGallery` | Grid | `printtargResult != nil` | children: `galleryInfo`, `galleryGrid`, `galleryPage-{n}` |
-| `btnPrintPage-{n}` | Button | that gallery cell | `isPrinting` or no selected printer |
-
-#### `rawPrintPanel`
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `printerSelect` | Picker | always | never |
-| `printerStatusBadge` | Caption | selected printer is in the list | — |
-| `btnRefreshPrinters` | Button | always | never |
-| `btnPrinterProperties` | Button | always | `selectedPrinter` empty |
-| `printerTraySelect` | Picker | trays nonempty | — |
-| `printerMediaTypeSelect` | Picker | media types nonempty | — |
-| `btnOrientPortrait` | Button | always | never |
-| `btnOrientLandscape` | Button | always | never |
-| `btnPrintAll` | Button | always | printing, or no layout, or no printer |
-| `btnAdvanceToStage3` | Button | always | no layout or `!isUnlocked(.measure)` |
-| `printNotificationText` | Caption | `printNotice != nil` | — |
-
----
-
-## Stages 3–5 and Calibrate
-
-```graphviz
-digraph ICCeryUIStage345 {
-  bgcolor=white
-  fontcolor=black
-  pad=0.4
-  rankdir=TB
-  nodesep=0.4
-  ranksep=0.5
-  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
-  edge [color=black]
-  S3 [label="stage-3  Stage3View.swift"]
-  S3 -> Instrument
-  S3 -> Transport
-  S3 -> swatchGrid
-  S3 -> Averaging
-  S4 [label="stage-4  Stage4View.swift"]
-  S4 -> colprof
-  S4 -> btnCreateProfile
-  S5 [label="stage-5  Stage5View.swift"]
-  S5 -> btnVerifyProfile
-  S5 -> btnViewGamut
-  S5 -> btnInstallProfile
-  S5 -> History
-  Cal [label="stage-cal  CalibrationView.swift"]
-  Cal -> Wedge
-  Cal -> Workflow
-  Cal -> btnCalReturn
-}
-```
-
-### Stage 3 — `Stage3View.swift` / `MeasurementWorkflowViewModel.swift`
-
-Transport buttons **replace each other** from `chartreadState`. Stage 3 ids must not be reused on Spot Read.
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `btnDetectInstruments` | Button | always | `isDetecting` |
-| `chartreadInstrumentSelect` | Picker.menu | always | never |
-| `xyTableHint` | Caption | selected instrument is XY | — |
-| `xyTablePanel` | Place/Align/Scan/Remove | is XY | highlight = `xyStep` |
-| `chartreadPrompt` | Text | always | — |
-| `chartreadLastError` | Caption | `chartreadNotice != nil` | — |
-| `btnStartRead` | Button | **not** running | `!canStartRead` (needs basename, cwd, not running) |
-| `btnCalibrate` | Button | running **and** calibrating | — |
-| `btnTrigger` | Button | running **and** awaitingStrip | — |
-| `btnDoneReadEarly` | Button | awaitingStrip | — |
-| `btnAccept` | Button | place / align / continue / warning | title may be `Continue (send 'X')` |
-| `btnRetry` | Button | state == error | — |
-| `btnDoneRead` | Button | allStripsRead | — |
-| `btnCancel` | Button | `isChartreadRunning` | — |
-| `swatchGrid` | Scroll | always | cells `swatch-{rowId}{loc}` |
-| `readStats` | Text | always | — |
-| `chartreadAveragingPanel` | Panel | passes nonempty **or** `isFinished` | — |
-| `btnMeasureAnotherSheet` | Button | averaging panel | `!isFinished` or still running |
-| `btnFinishAndAverage` | Button | averaging panel | `!canFinish` or `isFinishing`. `canFinish` = finished **and** at least one pass |
-
-### Stage 4 — `Stage4View.swift` / `ProfileWorkflowViewModel.swift`
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `colprofAlgorithm` | Picker | always | never |
-| `colprofQuality` | Picker | always | never |
-| `colprofFwa` | Picker | always | never |
-| `colprofFwaCustomPath` | TextField | custom spectrum selected | — |
-| `btnBrowseFwaSp` | Button | with custom path | — |
-| `colprofIlluminant` | TextField | always | never |
-| `colprofObserver` | TextField | always | never |
-| `colprofInputViewCond` | TextField | always | never |
-| `colprofOutputViewCond` | TextField | always | never |
-| `colprofDescription` | TextField | always | never |
-| `colprofCopyright` | TextField | always | never |
-| `colprofApplyCalibration` | Toggle | always | never |
-| `colprofCalibrationFile` | TextField | `applyCalibration` | — |
-| `btnBrowseCalibrationFile` | Button | `applyCalibration` | — |
-| `btnCreateProfile` | Button | always | `!canCreateProfile` (basename, cwd, not running) |
-| `colprofProgressIndicator` | Progress | `isColprofRunning` | — |
-
-### Stage 5 — `Stage5View.swift`
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `btnVerifyProfile` | Button | always | `!canVerify` (no profile or profcheck running) |
-| `profcheckProgressIndicator` | Progress | `isProfcheckRunning` | — |
-| `btnViewGamut` | Button | always | `createdGamutURL == nil` — **same id as sidebar** |
-| `btnInstallProfile` | Button | always | `createdProfileURL == nil` |
-| `driftPrinterFilter` | Picker | always | never |
-| `btnExportHistory` | Button | always | never |
-| `btnClearHistory` | Button | always | never |
-| `verificationHistoryTable` | Table | always | — |
-| `driftChart` | View | always | not interactive (`DriftChartView.swift`) |
-| `driftAlert` / `profcheckWarningBanner` | Banner | fail / warning status | — |
-| `profileOverwriteBtn` | Alert button | install collision **and** ask-before-overwrite | — |
-| `profileRenameBtn` | Alert button | same | — |
-| `profileCancelCollisionBtn` | Alert button | same | — |
-
-### Stage 0 — `CalibrationView.swift` (`stage-cal`)
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| Colour space | Picker.segmented | always | no a11y id. RGB \| CMYK |
-| `calSteps` | TextField.number | always | never |
-| White patches | TextField.number | always | no a11y id |
-| `calInkExplore` | TextField | colour space is CMYK | — |
-| `calNeutralEmphasis` | Toggle.checkbox | always | never |
-| `btnCalGenerate` | Button | always | empty basename, no cwd, or `isGenerating` |
-| `btnCalLayout` | Button | always | same as Generate |
-| `btnCalMeasure` | Button | always | `calibrationTi3URL == nil` |
-| `btnCalCompute` | Button | always | `!canCompute` (no `.ti3` or computing) |
-| `calApplyToggle` | Toggle | `computedCalURL != nil` | — |
-| `btnCalReturn` | Button Esc | always | never. Restores the original basename |
-
----
-
-## Sheets
-
-```graphviz
-digraph ICCeryUISheets {
-  bgcolor=white
-  fontcolor=black
-  pad=0.4
-  rankdir=TB
-  nodesep=0.4
-  ranksep=0.5
-  node [shape=box, style=filled, fillcolor=white, color=black, fontcolor=black, fontsize=14]
-  edge [color=black]
-  Root [label="RootView.swift hosts every sheet"]
-  Root -> Settings
-  Root -> About
-  Root -> savePresetDialog
-  Root -> managePresetsDialog
-  Root -> saveMediaRecipeDialog
-  Root -> manageMediaDialog
-  Root -> spotReadView
-  Root -> gamutView
-  Root -> ProjectAlerts
-}
-```
-
-### Settings — `SettingsView.swift` (560×620)
-
-| Control | Type | Notes |
-| --- | --- | --- |
-| Argyll dir + Browse | TextField | empty ⇒ bundled sidecars |
-| Default instrument | Picker | None + i1 / p3 / CM / SS / 20 / 22 / 41 / 51. Seeds Stage 3 and Spot Read. Does **not** change Stage 2 `instrumentSelect` |
-| Enable i1Pro 2 LEDs | Toggle | — |
-| `settingsDeltaEGood` | TextField | green cutoff |
-| `settingsDeltaEWarning` | TextField | amber cutoff. Save refuses unless Warning > Good |
-| `settingsCalStaleDays` | TextField | — |
-| Install location | Picker | User \| System library |
-| Ask before overwriting | Toggle | — |
-| Open ColorSync after install | Toggle | — |
-| Log level | Picker | — |
-| Open log folder / Copy path / Copy excerpt | Buttons | — |
-| Cancel / Save | Buttons | Save stays on the sheet if validation fails |
-
-### About — `AboutView.swift`
-
-`aboutDialog`, `aboutVersion`, `aboutBuildDate`, `closeAboutBtn` (Esc).
-
-### Save / manage presets — `PresetDialogs.swift`
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `savePresetName` | TextField | save sheet | — |
-| `savePresetDesc` | TextField | save sheet | — |
-| `btnCloseSavePresetDialog` | Button | save sheet | — |
-| `btnConfirmSavePreset` | Button | save sheet | name trimmed empty |
-| `presetRow-{id}` | Row | manage list | Built-in: no delete. Else `btnExportPreset-{id}`, `btnDeletePreset-{id}` |
-| `btnImportPreset` | Button | manage | — |
-| `btnExportActivePreset` | Button | selected preset is custom | — |
-| `btnCloseManagePresetsDialog` | Button | manage | — |
-
-### Save / manage media — `MediaLibraryDialogs.swift`
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `saveMediaName` / `Notes` / `Paper` / `Ink` | TextField | save sheet | — |
-| `saveMediaPrinter` / `Preset` / `ColourSpace` / `Cal` | read-only | save sheet | — |
-| `saveMediaApplyCal` | Toggle | save sheet | `!calApplyable` (path missing or `CAL_` stem) |
-| `btnCloseSaveMediaDialog` | Button | save sheet | — |
-| `btnConfirmSaveMedia` | Button | save sheet | name, paper or ink empty, **or** colour-space mismatch |
-| `mediaLibraryList` | List | manage | rows `mediaRow-{id}`; `btnMediaLibraryApply-{id}`; `btnMediaLibraryDelete-{id}`; double-click = Apply |
-| `manageMediaNotice` | Caption | `manageApplyNotice != nil` | in-sheet copy of a failed Apply (#170) |
-| `btnMediaLibraryApply` | Button | manage | `selection == nil` |
-| `btnMediaLibraryCaptureFromManage` | Button | manage | dismiss then open capture |
-| `btnCloseManageMediaDialog` | Button | manage | — |
-| Delete alert | Alert | pending delete | Cancel / Delete |
-
-Failed Apply **keeps** the manage sheet open. The window banner is occluded — use `manageMediaNotice`.
-
-### Spot Read — `SpotReadView.swift` (`spotReadView`)
-
-Enabled from the sidebar only with a working folder and no live Stage 3 `chartread`. Opening this sheet never kills `chartread_{basename}`. Close / dismiss = Stop.
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `spotSidecarMissing` | Text | sidecar missing | hides instrument + transport |
-| `btnSpotDetectInstruments` | Button | sidecar present | detecting or running |
-| `spotInstrumentSelect` | Picker | sidecar present | `isRunning` |
-| `spotDefaultMissing` | Caption | saved default not plugged in | — |
-| `spotSetDefault` | Toggle | sidecar present | — |
-| `spotXYHint` | Caption | selected is XY | XY tables belong on Stage 3 |
-| `btnSpotStart` | Button | not running | `!canStart` (sidecar, cwd, not detecting/running/chartread) |
-| `btnSpotCalibrate` | Button | running and calibrating | — |
-| `btnSpotTrigger` | Button | running and awaitingStrip | labelled Read |
-| `btnSpotStop` | Button | `isRunning` | — |
-| `spotLastSample` / `spotLabL/A/B` / `spotXYZ` / `spotDeltaE` | Display | last sample exists | `spotDeltaE` hidden on the first sample. `spotLabImplausible` if L not in 0…100 |
-| `spotHistoryTable` | List | samples nonempty | rows `spotHistoryRow-{uuid}` — click restores, does not trigger |
-| `btnSpotCopyLab` | Button | always | no displayed sample |
-| `btnSpotExportCsv` | Button | always | history empty |
-| `btnCloseSpotRead` | Button Esc | always | never |
-
-### Gamut — `GamutView.swift` (`gamutView`)
-
-| Id | Type | Shown | Disabled when |
-| --- | --- | --- | --- |
-| `gamutLayer-srgb` | Toggle.checkbox | always | never. Can hide, cannot remove |
-| `gamutLayer-profile` | Toggle | always | no session `.gam` |
-| `gamutLayer-compare` | Toggle | always | no compare layer |
-| `btnGamutAddCompare` | Menu | always | `btnGamutOpenGam` / `btnGamutOpenProfile` |
-| `btnGamutRemoveCompare` | Button | always | no compare layer |
-| `btnGamutSampleTiff` | Button | always | never |
-| `gamutViewerUnavailable` | Caption | no Metal | toggles + inspect still work |
-| `btnResetGamutCamera` | Button | always | R when focused |
-| `gamutLabEntryL/A/B` | TextField | always | — |
-| `btnGamutInspectLab` | Button | always | `!canInspectLab` |
-| `gamutInspectPanel` | Panel | inspect result | — |
-| `btnCloseGamut` | Button Esc | always | never |
-| `gamutTiffPreview` | Sheet | `showingTiffPreview` | `btnCloseGamutTiffPreview` |
-
-### Project alerts — `RootView.swift` / `ProjectUI.swift`
-
-| Id | Type | Shown |
-| --- | --- | --- |
-| `projectNewAlert` | Alert | New Project. `btnProjectNewCancel` / `btnProjectNewConfirm` |
-| Dirty save | Alert | New/Open/Close while dirty. `btnProjectDirtySave` / `btnProjectDirtyDiscard` / `btnProjectDirtyCancel` |
-| `projectRelocateSheet` | Sheet | Open when `cwd` is missing. `btnProjectRelocateCancel` / `btnProjectRelocate` |
-
----
-
-## Mutexes
-
-- Spot Read is disabled while Stage 3 `chartread` is running.
-- Opening Spot Read does not kill `chartread_{basename}`.
-- Calibrate uses a temporary `CAL_` basename; Save Project stays enabled so the refusal banner can fire.
-- Failed media Apply keeps `manageMediaDialog` open.
-- Duplicate id: `btnViewGamut` (sidebar always on; Stage 5 off without a `.gam`).
+| Shell, sidebar, stepper, File menu | [ui-interactive-map-shell.puml](ui-interactive-map-shell.puml) |
+| Stages 1–2 | [ui-interactive-map-stage1-2.puml](ui-interactive-map-stage1-2.puml) |
+| Stages 3–5 + Calibrate | [ui-interactive-map-stage3-5-cal.puml](ui-interactive-map-stage3-5-cal.puml) |
+| Sheets (Settings, Spot Read, Gamut, media, project) | [ui-interactive-map-sheets.puml](ui-interactive-map-sheets.puml) |
-- 
2.39.5


From 1d056c26bfcbb6f1c5748a0e8178cf18ee5f98e2 Mon Sep 17 00:00:00 2001
From: gronod <gronod@users.noreply.git.i3omb.com>
Date: Mon, 14 Sep 2026 15:04:22 +0000
Subject: [PATCH 8/8] 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/ui-interactive-map-sheets.puml       | 323 +++++-----------------
 docs/ui-interactive-map-shell.puml        | 285 +++++--------------
 docs/ui-interactive-map-stage1-2.puml     | 273 +++++-------------
 docs/ui-interactive-map-stage3-5-cal.puml | 283 +++++--------------
 docs/ui-interactive-map.md                |  16 +-
 5 files changed, 282 insertions(+), 898 deletions(-)

diff --git a/docs/ui-interactive-map-sheets.puml b/docs/ui-interactive-map-sheets.puml
index f77bf98..d53d544 100644
--- a/docs/ui-interactive-map-sheets.puml
+++ b/docs/ui-interactive-map-sheets.puml
@@ -1,274 +1,89 @@
 @startuml ICCery-UI-sheets
-title Sheets, dialogs, Spot Read, Gamut, Settings
-
+title Sheets  Settings, presets, media, Spot Read, Gamut, project
 !theme plain
 skinparam backgroundColor white
 skinparam defaultFontColor black
 skinparam defaultFontSize 13
-skinparam classBackgroundColor white
-skinparam classFontColor black
-skinparam classBorderColor #222222
-skinparam classAttributeFontColor black
-skinparam rectangleBackgroundColor #F4F4F4
-skinparam rectangleBorderColor #222222
-skinparam rectangleFontColor black
+skinparam mapBackgroundColor white
+skinparam mapBorderColor #222222
+skinparam mapFontColor black
 skinparam arrowColor #222222
-skinparam noteBackgroundColor #FFF6C8
-skinparam noteBorderColor #222222
-skinparam noteFontColor black
 skinparam shadowing false
-skinparam classAttributeIconSize 0
-skinparam wrapWidth 240
-skinparam nodesep 24
-skinparam ranksep 28
-rectangle "SettingsView.swift  sheet from openSettingsBtn" {
-  class "Argyll dir  [TextField+Browse]" as ad {
-    empty => bundled sidecars
-  }
-  class "Default instrument  [Picker]" as di {
-    None + i1/p3/CM/SS/20/22/41/51
-    seeds Stage 3 + Spot Read
-    does NOT change instrumentSelect
-  }
-  class "Enable i1Pro 2 LEDs  [Toggle]" as led {
-    Toggle
-  }
-  class "settingsDeltaEGood  [TextField.number]" as dg {
-    TextField.number
-  }
-  class "settingsDeltaEWarning  [TextField.number]" as dw {
-    Save refuses unless Warning > Good
-  }
-  class "settingsCalStaleDays  [TextField.number]" as sd {
-    TextField.number
-  }
-  class "Install location  [Picker]" as il {
-    User | System library
-  }
-  class "Ask before overwriting  [Toggle]" as ao {
-    Toggle
-  }
-  class "Open ColorSync after install  [Toggle]" as oc {
-    Toggle
-  }
-  class "Log level  [Picker]" as ll {
-    Picker
-  }
-  class "Open log folder / Copy path / Copy excerpt  [Button x3]" as lg {
-    Button x3
-  }
-  class "Cancel / Save  [Button]" as ss {
-    Save stays on sheet if validation fails
-    frame 560x620
-  }
+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
 }
 
-rectangle "AboutView.swift" {
-  class "aboutDialog  [Sheet]" as ab {
-    aboutVersion, aboutBuildDate
-    closeAboutBtn  Esc
-  }
+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
 }
 
-rectangle "savePresetDialog  PresetDialogs.swift" {
-  class "savePresetName  [TextField]" as spn {
-    TextField
-  }
-  class "savePresetDesc  [TextField]" as spd {
-    TextField
-  }
-  class "btnCloseSavePresetDialog  [Button]" as spc {
-    Button
-  }
-  class "btnConfirmSavePreset  [Button]" as sps {
-    disabled: name trimmed empty
-  }
+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
 }
 
-rectangle "managePresetsDialog" {
-  class "presetRow-{id}  [Row]" as prw {
-    Built-in: no delete
-    else btnExportPreset-{id} btnDeletePreset-{id}
-  }
-  class "btnImportPreset  [Button]" as pim {
-    Button
-  }
-  class "btnExportActivePreset  [Button]" as pea {
-    shown: selected custom preset
-  }
-  class "btnCloseManagePresetsDialog  [Button]" as pcl {
-    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
 }
 
-rectangle "saveMediaRecipeDialog  MediaLibraryDialogs.swift" {
-  class "saveMediaName/Notes/Paper/Ink  [TextField x4]" as smf {
-    TextField x4
-  }
-  class "saveMediaPrinter/Preset/ColourSpace/Cal  [read-only]" as smr {
-    read-only
-  }
-  class "saveMediaApplyCal  [Toggle]" as smc {
-    disabled: !calApplyable
-    calApplyable: path exists, not CAL_ stem
-  }
-  class "btnCloseSaveMediaDialog  [Button]" as smx {
-    Button
-  }
-  class "btnConfirmSaveMedia  [Button]" as sms {
-    disabled: name|paper|ink empty
-             OR captureColourSpaceMismatch
-  }
+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
 }
 
-rectangle "manageMediaDialog" {
-  class "mediaLibraryList  [List]" as mll {
-    mediaRow-{id}
-    btnMediaLibraryApply-{id}
-    btnMediaLibraryDelete-{id}
-    double-click row = Apply
-  }
-  class "manageMediaNotice  [Caption]" as mmn {
-    shown: manageApplyNotice != nil
-    in-sheet copy of failed Apply (#170)
-  }
-  class "btnMediaLibraryApply  [Button]" as mla {
-    Apply selected
-    disabled: selection == nil
-  }
-  class "btnMediaLibraryCaptureFromManage  [Button]" as mlc {
-    dismiss then open capture
-  }
-  class "btnCloseManageMediaDialog  [Button]" as mlx {
-    Button
-  }
-  class "Delete alert  [alert]" as mld {
-    Cancel / Delete
-  }
+map "Project alerts" as proj {
+  projectNewAlert => Alert : New Cancel / Confirm
+  Dirty save => Alert : Save / Don't Save / Cancel
+  projectRelocateSheet => Sheet : cwd missing on Open
 }
 
-rectangle "spotReadView  SpotReadView.swift  (#148)" {
-  class "spotSidecarMissing  [Text]" as ssm {
-    shown: !sidecarAvailable
-    hides instrument/transport
-  }
-  class "btnSpotDetectInstruments  [Button]" as sdet {
-    disabled: !canDetect  (detecting or running)
-  }
-  class "spotInstrumentSelect  [Picker]" as sis {
-    disabled: isRunning
-  }
-  class "spotDefaultMissing  [Caption]" as sdm {
-    shown: defaultMissing
-  }
-  class "spotSetDefault  [Toggle]" as ssd {
-    Toggle
-  }
-  class "spotXYHint  [Caption]" as sxy {
-    shown: selected is XY table
-  }
-  class "btnSpotStart  [Button]" as sst {
-    shown: !isRunning
-    disabled: !canStart
-    canStart: sidecar && !detecting && !running
-              && !chartreadRunning && cwd
-  }
-  class "btnSpotCalibrate  [Button]" as sca {
-    shown: running && calibrating
-  }
-  class "btnSpotTrigger  [Button]" as str {
-    shown: running && awaitingStrip  (Read)
-  }
-  class "btnSpotStop  [Button]" as ssp {
-    shown: isRunning
-  }
-  class "spotLastSample / Lab / XYZ / DeltaE  [Display]" as sls {
-    spotLabImplausible if L not in 0...100
-    spotDeltaE hidden on first sample
-  }
-  class "spotHistoryTable  [List]" as sht {
-    rows are buttons spotHistoryRow-{uuid}
-    click restores last sample, no trigger
-  }
-  class "btnSpotCopyLab  [Button]" as scp {
-    disabled: displayedSample == nil
-  }
-  class "btnSpotExportCsv  [Button]" as sex {
-    disabled: samples.isEmpty
-  }
-  class "btnCloseSpotRead  [Button]" as scl {
-    Esc; onDismiss = Stop
-  }
-}
-
-rectangle "gamutView  GamutView.swift  (#147)" {
-  class "gamutLayer-srgb  [Toggle.checkbox]" as gls {
-    sRGB always loaded; can hide; cannot remove
-  }
-  class "gamutLayer-profile  [Toggle]" as glp {
-    disabled: no session .gam
-  }
-  class "gamutLayer-compare  [Toggle]" as glc {
-    disabled: no compare layer
-  }
-  class "btnGamutAddCompare  [Menu]" as gac {
-    btnGamutOpenGam / btnGamutOpenProfile
-  }
-  class "btnGamutRemoveCompare  [Button]" as grc {
-    disabled: compare layer nil
-  }
-  class "btnGamutSampleTiff  [Button]" as gst {
-    Button
-  }
-  class "gamutViewerUnavailable  [Caption]" as gun {
-    shown: no Metal / SCNView failed
-    toggles + inspect still enabled
-  }
-  class "btnResetGamutCamera  [Button]" as grs {
-    R when focused
-  }
-  class "gamutLabEntryL/A/B  [TextField x3]" as gle {
-    TextField x3
-  }
-  class "btnGamutInspectLab  [Button]" as gin {
-    disabled: !canInspectLab
-  }
-  class "gamutInspectPanel  [Panel]" as gip {
-    Panel
-  }
-  class "btnCloseGamut  [Button]" as gcl {
-    Esc
-  }
-  class "gamutTiffPreview sheet  [Sheet]" as gtf {
-    showingTiffPreview
-    click pixel; btnCloseGamutTiffPreview
-  }
-}
-
-rectangle "Project alerts / relocate  RootView + ProjectUI" {
-  class "projectNewAlert  [alert]" as pna {
-    btnProjectNewCancel / btnProjectNewConfirm
-  }
-  class "Dirty save alert  [alert]" as pda {
-    btnProjectDirtySave
-    btnProjectDirtyDiscard
-    btnProjectDirtyCancel
-    shown when New/Open/Close and dirty
-  }
-  class "projectRelocateSheet  [Sheet]" as prs {
-    shown: cwd missing on Open
-    btnProjectRelocateCancel
-    btnProjectRelocate  Choose Folder…
-  }
-}
-
-note as nMutex
-  Mutex / exclusive
-  Spot Read disabled while Stage 3 chartread runs
-  Opening Spot Read never kills chartread_{basename}
-  Calibrate uses temporary CAL_ basename; Save Project stays
-  enabled so the refusal banner can fire; chip Save uses canSave
-  Failed media Apply keeps manageMediaDialog open
-  Window noticeText is occluded by that sheet — use manageMediaNotice
-end note
+set -[hidden]down- pre
+pre -[hidden]down- media
+media -[hidden]down- spot
+spot -[hidden]down- gam
+gam -[hidden]down- proj
 @enduml
diff --git a/docs/ui-interactive-map-shell.puml b/docs/ui-interactive-map-shell.puml
index fc9474b..ff84569 100644
--- a/docs/ui-interactive-map-shell.puml
+++ b/docs/ui-interactive-map-shell.puml
@@ -1,232 +1,81 @@
 @startuml ICCery-UI-shell
-title ICCery v2 — interactive UI map (develop)\nobject names, files, enable / hide rules
-caption Accessibility ids in quotes. Disk gating: WizardGating.swift. No App Sandbox.
-
+title Shell, sidebar, stepper, File menu
 !theme plain
 skinparam backgroundColor white
 skinparam defaultFontColor black
 skinparam defaultFontSize 13
-skinparam classBackgroundColor white
-skinparam classFontColor black
-skinparam classBorderColor #222222
-skinparam classAttributeFontColor black
-skinparam rectangleBackgroundColor #F4F4F4
-skinparam rectangleBorderColor #222222
-skinparam rectangleFontColor black
+skinparam mapBackgroundColor white
+skinparam mapBorderColor #222222
+skinparam mapFontColor black
 skinparam arrowColor #222222
-skinparam noteBackgroundColor #FFF6C8
-skinparam noteBorderColor #222222
-skinparam noteFontColor black
 skinparam shadowing false
-skinparam classAttributeIconSize 0
-skinparam wrapWidth 240
-skinparam nodesep 24
-skinparam ranksep 28
-class "WindowGroup ICCery  [ICCeryApp.swift]" as win {
-  1280x800, min 1100x700
-  File menu: ProjectCommands
-}
-class "RootView  [RootView.swift]" as root {
-  sidebar 270pt + stage column
-  sheets / alerts hosted here
+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
 }
 
-win --> root
-
-rectangle "Persistent chrome" {
-  class "SidebarView  [SidebarView.swift]" as side {
-    SidebarView.swift
-  }
-  class "NoticeBanner  [NoticeBanner.swift]" as ban {
-    id noticeText
-    shown: wizard.notice != nil
-    auto-hide 6s unless nil
-    close: xmark (no a11y id)
-  }
-  class "WizardStageContent  [RootView.swift]" as stage {
-    switch wizard.stage
-  }
+map "Sidebar header" as hdr {
+  openSettingsBtn => Button : always / Settings sheet
+  openAboutBtn => Button : always / About
+  btnToggleAllHelp => Button : toggles yellow help dots
 }
 
-root --> side
-root --> ban
-root --> stage
-
-rectangle "Sidebar header" {
-  class "openSettingsBtn  [Button]" as sSet {
-    gearshape
-    always enabled
-    presents SettingsView sheet
-  }
-  class "openAboutBtn  [Button]" as sAbt {
-    info.circle
-    always enabled
-    presents AboutView
-  }
-  class "btnToggleAllHelp  [Button]" as sHlp {
-    questionmark.circle
-    toggles showingAllHelp
-    HelpOverlayView: yellow dots when on
-  }
-}
-side --> sSet
-side --> sAbt
-side --> sHlp
-
-rectangle "Presets (#11)" {
-  class "presetSelect  [Picker.menu]" as pre {
-    tags: none + ProfilingPreset.id
-    set applies preset immediately
-    "No preset" does not factory-reset
-  }
-  class "btnSavePresetModal  [Button]" as preS {
-    always enabled
-    showingSavePreset = true
-  }
-  class "btnOpenPresetsDialog  [Button]" as preM {
-    always enabled
-    showingManagePresets = true
-  }
-}
-side --> pre
-side --> preS
-side --> preM
-
-rectangle "Media library (#146)" {
-  class "mediaSelect  [Picker.menu]" as med {
-    tags: none + MediaRecipe.id
-    never reuses presetSelect
-    failed apply snaps back to none
-  }
-  class "mediaRecipeStale  [Caption]" as medSt {
-    shown: staleReasons[selected] nonempty
-    "Printer not installed" or "Calibration stale"
-  }
-  class "btnMediaLibraryCapture  [Button]" as medC {
-    disabled: print.selectedPrinter.isEmpty
-    needs Stage 2 queue
-  }
-  class "btnMediaLibraryManage  [Button]" as medM {
-    always enabled
-  }
-}
-side --> med
-side --> medSt
-side --> medC
-side --> medM
-
-rectangle "Studio (not stepper)" {
-  class "btnCalibratePrinter  [Button]" as calB {
-    always enabled
-    wizard.enterCalibration()
-    Stage 0, not numbered
-  }
-  class "btnViewGamut  [Button]" as gamB {
-    Sidebar copy — same id as Stage 5
-    always enabled
-    no .gam => sRGB only
-  }
-  class "btnSpotRead  [Button]" as spotB {
-    disabled: workingDirectory==nil
-             OR measurement.isChartreadRunning
-  }
-}
-side --> calB
-side --> gamB
-side --> spotB
-
-rectangle "Stepper 1–5  (disk is truth)" {
-  class "StepperRow stage N  [Button.plain]" as step {
-    WizardStage.stepperStages
-    disabled / opacity 0.45 unless isUnlocked
-    go(to:) allowed backward always
-    calibrate is NOT a stepper row
-  }
-  note as nGate
-    WizardGating.swift / WizardViewModel.isUnlocked
-    1 generate: always
-    2 layOutPrint: .ti1
-    3 measure: .ti1 AND .ti2
-    4 buildProfile: .ti3 (not .ti2 alone)
-    5 verifyInstall: .ti3 AND .icc/.icm
-    Re-probed on window key (#151)
-  end note
-}
-side --> step
-step .. nGate
-
-rectangle "Project chip (#149)  ProjectUI.swift" {
-  class "projectChip  [Container]" as chip {
-    Container
-  }
-  class "projectChipName  [Text]" as cn {
-    bound name or "No project"
-  }
-  class "projectChipPath  [Text]" as cp {
-    shown if bound; last path component
-  }
-  class "projectChipStale  [Caption]" as cs {
-    shown: diskBehindNotes
-  }
-  class "btnProjectReveal  [Button]" as cr {
-    shown if bound
-  }
-  class "btnProjectSave  [Button]" as csv {
-    shown if bound
-    disabled: !canSave
-    canSave: isBound && basename && cwd
-    CAL_ basename still enabled (refusal banner)
-  }
-  class "btnProjectOpen  [Button]" as co {
-    shown if NOT bound
-  }
-}
-side --> chip
-chip --> cn
-chip --> cp
-chip --> cs
-chip --> cr
-chip --> csv
-chip --> co
-
-rectangle "File menu  ProjectCommands / ICCeryApp.swift" {
-  class "menuProjectNew  [Button]" as mN {
-    ⌘N  requestNew()
-  }
-  class "menuProjectOpen  [Button]" as mO {
-    ⌘O
-  }
-  class "menuProjectRecents  [Menu]" as mR {
-    disabled: recents.isEmpty
-    items: projectRecent-{bookmarkHash}
-    menuProjectRecentsClear
-  }
-  class "menuProjectSave  [Button]" as mS {
-    ⌘S  disabled: !canSave
-  }
-  class "menuProjectSaveAs  [Button]" as mSa {
-    ⇧⌘S  disabled: !canSaveAs
-    canSaveAs: basename && cwd (no bind required)
-  }
-  class "menuProjectReport  [Button]" as mRp {
-    disabled: !canReport
-  }
-  class "menuProjectClose  [Button]" as mCl {
-    disabled: !isBound
-  }
+map "Presets" as pre {
+  presetSelect => Picker.menu : none + preset id; none is not factory reset
+  btnSavePresetModal => Button : always
+  btnOpenPresetsDialog => Button : always
 }
 
-class "stage-1 / Stage1View.swift" as st1
-stage --> st1
-class "stage-2 / Stage2View.swift" as st2
-stage --> st2
-class "stage-3 / Stage3View.swift" as st3
-stage --> st3
-class "stage-4 / Stage4View.swift" as st4
-stage --> st4
-class "stage-5 / Stage5View.swift" as st5
-stage --> st5
-class "stage-cal / CalibrationView.swift" as st0
-stage --> st0
+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
-
diff --git a/docs/ui-interactive-map-stage1-2.puml b/docs/ui-interactive-map-stage1-2.puml
index 93d5438..cbde6bb 100644
--- a/docs/ui-interactive-map-stage1-2.puml
+++ b/docs/ui-interactive-map-stage1-2.puml
@@ -1,216 +1,83 @@
 @startuml ICCery-UI-stage1-2
-title Stages 1–2 — Generate Target / Lay Out and Print
-
+title Stages 1-2  Generate Target / Lay Out and Print
 !theme plain
 skinparam backgroundColor white
 skinparam defaultFontColor black
 skinparam defaultFontSize 13
-skinparam classBackgroundColor white
-skinparam classFontColor black
-skinparam classBorderColor #222222
-skinparam classAttributeFontColor black
-skinparam rectangleBackgroundColor #F4F4F4
-skinparam rectangleBorderColor #222222
-skinparam rectangleFontColor black
+skinparam mapBackgroundColor white
+skinparam mapBorderColor #222222
+skinparam mapFontColor black
 skinparam arrowColor #222222
-skinparam noteBackgroundColor #FFF6C8
-skinparam noteBorderColor #222222
-skinparam noteFontColor black
 skinparam shadowing false
-skinparam classAttributeIconSize 0
-skinparam wrapWidth 240
-skinparam nodesep 24
-skinparam ranksep 28
-rectangle "stage-1  Stage1View.swift" {
-  class "colourSpace  [Picker.segmented]" as csp {
-    RGB | CMYK
-  }
-  class "patchCountPreset  [Picker]" as pcp {
-    PatchCountPreset.allCases
-  }
-  class "patchCountCustom  [TextField.number]" as pcc {
-    shown: patchPreset == .custom
-  }
-  class "whitePatches  [Stepper]" as wp {
-    0...50
-  }
-  class "blackPatches  [Stepper]" as bp {
-    0...50
-  }
-  class "targetBasename  [TextField]" as tb {
-    TextField
-  }
-  class "btnBrowse  [Button]" as bb {
-    save panel; sets basename
-  }
-  class "btnSelectWorkDir  [Button]" as wd {
-    Button
-  }
-  class "btnOpenExisting  [Button]" as oe {
-    .ti1 or .ti2 (+ matching .ti1)
-  }
-  class "btn-import-dataset  [Button]" as imp {
-    .ti3 / .txt / .cgats / .csv
-    unlocks stage 4
-  }
-  class "selectedPathDisplay  [Text]" as spd {
-    Text
-  }
-  class "targenAdvancedDetails  [DisclosureGroup]" as adv {
-    UI tests pre-expand
-  }
-  class "btnGenerate  [Button]" as gen {
-    disabled: !canGenerate || targenRunning
-    canGenerate: valid basename AND directory
-    label Generating… while running
-  }
-  class "targenLogContainer / targenLog  [DisclosureGroup]" as tlog {
-    ProcessLogView.swift
-  }
+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
 }
 
-rectangle "Advanced (hidden until disclosure open)" {
-  class "targenGreySteps  [Toggle+TextField]" as ag {
-    field shown iff toggle on
-  }
-  class "targenSingleChannelSteps  [Toggle+TextField]" as as1 {
-    Toggle+TextField
-  }
-  class "targenNeutralSteps  [Toggle+TextField]" as an {
-    Toggle+TextField
-  }
-  class "targenNeutralConcentration  [Toggle+Slider]" as anc {
-    0...1  shown iff on
-  }
-  class "targenAdaptation  [Toggle+Slider]" as aa {
-    0...1
-  }
-  class "targenPrecondProfile  [TextField]" as ap {
-    TextField
-  }
-  class "btnBrowsePrecondProfile  [Button]" as apb {
-    Button
-  }
-  class "targenHighQuality  [Toggle]" as ahq {
-    OFPS -G
-  }
-  class "targenAlgorithm  [Picker]" as aal {
-    Picker
-  }
-  class "targenInkLimitGroup  [Toggle+TextField]" as ail {
-    shown: colourSpace == cmyk
-  }
-  class "targenDarkEmphasis  [Toggle+Slider]" as ad {
-    0...3
-  }
-  class "targenDevicePower  [Toggle+Slider]" as adp {
-    0...3
-  }
-}
-adv --> ag
-
-rectangle "stage-2  Stage2View.swift" {
-  class "cmWarningBanner  [Banner]" as cmw {
-    always visible on stage 2
-    not a control
-  }
-  class "instrumentSelect  [Picker]" as ins {
-    PrintInstrument — chart code, NOT USB port
-  }
-  class "pageSizeSelect  [Picker]" as pgs {
-    Picker
-  }
-  class "customPageSizeRow  [HStack]" as cps {
-    shown: pageSize == .custom
-    customPageW / customPageH  mm
-  }
-  class "bitDepth  [Picker]" as bit {
-    8-bit | 16-bit TIFF
-    (no a11y id on picker)
-  }
-  class "tiffDpi  [Stepper]" as dpi {
-    72...600
-  }
-  class "printtargLayoutOrder  [Picker]" as lo {
-    Picker
-  }
-  class "printtargCustomSeedGroup  [HStack]" as seed {
-    shown: layoutOrder == .customSeed
-    id printtargCustomSeed
-  }
-  class "btnToggleLabelEdit  [Button]" as tle {
-    toggles labelIsCustom
-    title: Edit label… / Use automatic label
-  }
-  class "targetMetadataPrinter  [TextField]" as mp {
-    TextField
-  }
-  class "targetMetadataInkSet  [TextField]" as mi {
-    TextField
-  }
-  class "targetMetadataDriverPaper  [TextField]" as md {
-    TextField
-  }
-  class "targetMetadataActualPaper  [TextField]" as ma {
-    TextField
-  }
-  class "targetLabelPreview  [TextField|Text]" as lpv {
-    TextField if labelIsCustom else Text(automatic)
-  }
-  class "btnCreateLayout  [Button]" as lay {
-    disabled: printtargRunning || basename.empty
-  }
-  class "printtargLogContainer  [DisclosureGroup]" as plog {
-    DisclosureGroup
-  }
-  class "tiffGallery  [Grid]" as gal {
-    shown: printtargResult != nil
-    galleryInfo, galleryGrid
-    galleryPage-{index}
-    btnPrintPage-{index}
-    Print disabled: isPrinting || selectedPrinter.empty
-  }
+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
 }
 
-rectangle "rawPrintPanel" {
-  class "printerSelect  [Picker]" as ps {
-    CUPS queues
-  }
-  class "printerStatusBadge  [Caption]" as psb {
-    shown: selected printer in list
-  }
-  class "btnRefreshPrinters  [Button]" as prf {
-    Button
-  }
-  class "btnPrinterProperties  [Button]" as ppr {
-    disabled: selectedPrinter.empty
-    bound NSPrintPanel
-  }
-  class "printerTraySelect  [Picker]" as ptr {
-    shown: trays nonempty
-  }
-  class "printerMediaTypeSelect  [Picker]" as pmt {
-    shown: mediaTypes nonempty
-    also mediaTypeGroup
-  }
-  class "btnOrientPortrait  [Button]" as por {
-    Button
-  }
-  class "btnOrientLandscape  [Button]" as lan {
-    Button
-  }
-  class "btnPrintAll  [Button]" as pal {
-    disabled: isPrinting
-             || printtargResult==nil
-             || selectedPrinter.empty
-  }
-  class "btnAdvanceToStage3  [Button]" as a3 {
-    disabled: printtargResult==nil
-             || !isUnlocked(.measure)
-  }
-  class "printNotificationText  [Caption]" as pnt {
-    shown: print.printNotice != nil
-  }
+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
-
diff --git a/docs/ui-interactive-map-stage3-5-cal.puml b/docs/ui-interactive-map-stage3-5-cal.puml
index 6c53b1e..3d7b248 100644
--- a/docs/ui-interactive-map-stage3-5-cal.puml
+++ b/docs/ui-interactive-map-stage3-5-cal.puml
@@ -1,231 +1,84 @@
 @startuml ICCery-UI-stage3-5-cal
-title Stages 3–5, Calibrate Printer, Measure transport
-
+title Stages 3-5 and Calibrate Printer
 !theme plain
 skinparam backgroundColor white
 skinparam defaultFontColor black
 skinparam defaultFontSize 13
-skinparam classBackgroundColor white
-skinparam classFontColor black
-skinparam classBorderColor #222222
-skinparam classAttributeFontColor black
-skinparam rectangleBackgroundColor #F4F4F4
-skinparam rectangleBorderColor #222222
-skinparam rectangleFontColor black
+skinparam mapBackgroundColor white
+skinparam mapBorderColor #222222
+skinparam mapFontColor black
 skinparam arrowColor #222222
-skinparam noteBackgroundColor #FFF6C8
-skinparam noteBorderColor #222222
-skinparam noteFontColor black
 skinparam shadowing false
-skinparam classAttributeIconSize 0
-skinparam wrapWidth 240
-skinparam nodesep 24
-skinparam ranksep 28
-rectangle "stage-3  Stage3View.swift / MeasurementWorkflowViewModel" {
-  class "btnDetectInstruments  [Button]" as d3 {
-    disabled: !canDetect  (!isDetecting)
-  }
-  class "chartreadInstrumentSelect  [Picker.menu]" as i3 {
-    Auto + instlist ports
-  }
-  class "xyTableHint  [Caption]" as xyh {
-    shown: selectedInstrument.isXY
-  }
-  class "xyTablePanel  [HStack]" as xyp {
-    shown: isXY
-    xyStepPlace / Align / Scan / Remove
-    highlight = xyStep
-  }
-  class "chartreadPrompt  [Text]" as pr {
-    Text
-  }
-  class "chartreadLastError  [Caption]" as err {
-    shown: chartreadNotice != nil
-  }
-  class "btnStartRead  [Button]" as sr {
-    shown: !isChartreadRunning
-    disabled: !canStartRead
-    canStart: basename && cwd && !running
-  }
-  class "btnCalibrate  [Button]" as cal3 {
-    shown: running && state==calibrating
-  }
-  class "btnTrigger  [Button]" as trg {
-    shown: running && awaitingStrip
-  }
-  class "btnDoneReadEarly  [Button]" as de {
-    shown: awaitingStrip
-  }
-  class "btnAccept  [Button]" as acc {
-    shown: tablePlaceSheet | tableAlign
-           | promptContinue | warning
-    title Continue or Continue (send 'X')
-  }
-  class "btnRetry  [Button]" as rty {
-    shown: state==error
-  }
-  class "btnDoneRead  [Button]" as dn {
-    shown: allStripsRead
-  }
-  class "btnCancel  [Button]" as cnc {
-    shown: isChartreadRunning
-  }
-  class "swatchGrid  [Scroll]" as sw {
-    swatch-{rowId}{loc}
-  }
-  class "readStats  [Text]" as rst {
-    Text
-  }
-  class "chartreadAveragingPanel  [Panel]" as avg {
-    shown: passSnapshots nonempty OR isFinished
-    passCounterBadge, passesList
-  }
-  class "btnMeasureAnotherSheet  [Button]" as mas {
-    disabled: !isFinished || isChartreadRunning
-  }
-  class "btnFinishAndAverage  [Button]" as fa {
-    disabled: !canFinish || isFinishing
-    canFinish: isFinished && passes nonempty
-  }
+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
 }
 
-rectangle "stage-4  Stage4View.swift / ProfileWorkflowViewModel" {
-  class "colprofAlgorithm  [Picker]" as alg {
-    Picker
-  }
-  class "colprofQuality  [Picker]" as q {
-    Picker
-  }
-  class "colprofFwa  [Picker]" as fwa {
-    Picker
-  }
-  class "colprofFwaCustomPath  [TextField]" as fwap {
-    shown: custom spectrum selected
-  }
-  class "btnBrowseFwaSp  [Button]" as fwab {
-    shown with custom path
-  }
-  class "colprofIlluminant  [TextField]" as ill {
-    TextField
-  }
-  class "colprofObserver  [TextField]" as obs {
-    TextField
-  }
-  class "colprofInputViewCond  [TextField]" as ivc {
-    TextField
-  }
-  class "colprofOutputViewCond  [TextField]" as ovc {
-    TextField
-  }
-  class "colprofDescription  [TextField]" as desc {
-    TextField
-  }
-  class "colprofCopyright  [TextField]" as cpr {
-    TextField
-  }
-  class "colprofApplyCalibration  [Toggle]" as ac {
-    Toggle
-  }
-  class "colprofCalibrationFile  [TextField]" as cf {
-    shown: applyCalibration
-  }
-  class "btnBrowseCalibrationFile  [Button]" as cfb {
-    shown: applyCalibration
-  }
-  class "btnCreateProfile  [Button]" as cp {
-    disabled: !canCreateProfile
-    canCreate: basename && cwd && !colprofRunning
-  }
-  class "colprofProgressIndicator  [Progress]" as cpi {
-    shown: isColprofRunning
-  }
+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
 }
 
-rectangle "stage-5  Stage5View.swift" {
-  class "btnVerifyProfile  [Button]" as vf {
-    disabled: !canVerify
-    canVerify: createdProfileURL && !profcheckRunning
-  }
-  class "profcheckProgressIndicator  [Progress]" as ppi {
-    shown: isProfcheckRunning
-  }
-  class "btnViewGamut  [Button]" as vg5 {
-    DUPLICATE id with sidebar
-    disabled: createdGamutURL == nil
-  }
-  class "btnInstallProfile  [Button]" as inst {
-    disabled: createdProfileURL == nil
-    may present collision alert
-  }
-  class "driftPrinterFilter  [Picker]" as df {
-    Picker
-  }
-  class "btnExportHistory  [Button]" as eh {
-    Button
-  }
-  class "btnClearHistory  [Button]" as ch {
-    Button
-  }
-  class "verificationHistoryTable  [Table]" as ht {
-    Table
-  }
-  class "driftChart  [View]" as dc {
-    DriftChartView.swift  not interactive
-  }
-  class "driftAlert / profcheckWarningBanner  [Banner]" as dalt {
-    shown on fail / warning status
-  }
+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
 }
 
-rectangle "Install collision alert" {
-  class "profileOverwriteBtn  [Button]" as io {
-    Button
-  }
-  class "profileRenameBtn  [Button]" as ir {
-    Button
-  }
-  class "profileCancelCollisionBtn  [Button]" as ic {
-    shown: showingInstallCollision
-    && settings.askBeforeOverwriteProfile
-  }
+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
 }
 
-rectangle "stage-cal  CalibrationView.swift  (Stage 0)" {
-  class "Colour Space  [Picker.segmented]" as ccs {
-    RGB | CMYK  (no a11y id)
-  }
-  class "calSteps  [TextField.number]" as cst {
-    TextField.number
-  }
-  class "White patches  [TextField.number]" as cwp {
-    no a11y id
-  }
-  class "calInkExplore  [TextField]" as cin {
-    shown: colourSpace == cmyk
-  }
-  class "calNeutralEmphasis  [Toggle.checkbox]" as cne {
-    Toggle.checkbox
-  }
-  class "btnCalGenerate  [Button]" as cg {
-    disabled: basename.empty || cwd==nil || isGenerating
-  }
-  class "btnCalLayout  [Button]" as cl {
-    same disable as Generate
-  }
-  class "btnCalMeasure  [Button]" as cm {
-    disabled: calibrationTi3URL == nil
-  }
-  class "btnCalCompute  [Button]" as cc {
-    disabled: !canCompute
-    canCompute: .ti3 exists && !isComputing
-  }
-  class "calApplyToggle  [Toggle]" as cat {
-    shown: computedCalURL != nil
-  }
-  class "btnCalReturn  [Button]" as cr {
-    Esc / cancelAction
-    restores original basename
-  }
-}
+s3 -[hidden]down- s4
+s4 -[hidden]down- s5
+s5 -[hidden]down- cal
 @enduml
-
diff --git a/docs/ui-interactive-map.md b/docs/ui-interactive-map.md
index fd0eae5..b10feef 100644
--- a/docs/ui-interactive-map.md
+++ b/docs/ui-interactive-map.md
@@ -1,12 +1,12 @@
 # Interactive UI map
 
-PlantUML class maps of every interactive control (accessibility id, type, enable / hide rules). One diagram per file so Kroki renders each.
+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.
 
-Packages are drawn as **rectangles**, not folders, on an opaque white canvas.
+Each file is one stacked column (~560–780px) that Kroki actually fits in the page.
 
-| Diagram | File |
-| --- | --- |
-| Shell, sidebar, stepper, File menu | [ui-interactive-map-shell.puml](ui-interactive-map-shell.puml) |
-| Stages 1–2 | [ui-interactive-map-stage1-2.puml](ui-interactive-map-stage1-2.puml) |
-| Stages 3–5 + Calibrate | [ui-interactive-map-stage3-5-cal.puml](ui-interactive-map-stage3-5-cal.puml) |
-| Sheets (Settings, Spot Read, Gamut, media, project) | [ui-interactive-map-sheets.puml](ui-interactive-map-sheets.puml) |
+| 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 |
-- 
2.39.5