ORIX DJ accessibility report
Date: 2026-11-21.
This report describes what the ORIX DJ interface exposes to assistive technology and to the keyboard. It was produced by reading the interface source code (App/Sources/App, App/Sources/DesignSystem, App/Sources/Features), not by operating the application with assistive technology. The interface folders were being edited while the report was written: it reflects the code as read on 2026-11-21, and line numbers given below can have moved since.
It is a code review, not a conformance statement. Section 12 lists what was not verified; in short, nobody has walked the application with VoiceOver, no Accessibility Inspector audit has been run, and nothing was tested with assistive hardware.
Related documents: design system, brand guidelines, testing, architecture overview, waveform architecture, security report.
1. Method
- Every file of
App/Sources/DesignSystemandApp/Sources/Appwas read in full, as were the deck, mixer, effects, waveform, Studio and Perform views. The other feature views (Library, Automation Studio, Auto DJ, Claude Studio, MIDI, Recording, Docs, Settings) were read through every line that declares a control, a gesture, a dialog or an accessibility modifier, with the surrounding code read where a control needed context. Controllers and models were skimmed. - Modifier counts were taken with
grep -rnEoverApp/Sourcesand are given in section 2 as an inventory only; the descriptions come from reading the views. - Contrast ratios were computed from the token hex values with the WCAG 2 relative-luminance formula, using a short script written for this report (
/tmp/orixdj-a11y/contrast.py, not part of the repository).
2. Inventory
Occurrences in App/Sources on 2026-11-21:
| Construct | Count |
|---|---|
accessibilityLabel |
181 |
accessibilityValue |
54 |
accessibilityIdentifier |
392 |
accessibilityElement(children:) |
56 |
accessibilityHidden |
26 |
accessibilityAddTraits |
16 |
accessibilityAdjustableAction |
5 |
accessibilityHint |
2 |
accessibilityAction |
1 |
.help( (tooltips) |
96 |
keyboardShortcut |
43 |
onKeyPress |
12 |
.focusable() |
2 (Knob, Fader) |
accessibilityReduceMotion, accessibilityDifferentiateWithoutColor, colorSchemeContrast, dynamicTypeSize, accessibilityReduceTransparency |
0 |
| Posted accessibility notifications (announcements) | 0 |
The counts understate coverage in one respect: the shared components (Knob, Fader, LevelMeter, ToggleChip, DeckBadge, StudioIconButton) each declare their label and value once and are instantiated many times. Identifiers (accessibilityIdentifier) are for UI automation and are not spoken; the UI tests added on 2026-11-21 (UITests/ORIXDJUITests.swift, nine methods) use about forty of them; the rest are not exercised by any test.
3. Shared components
Details are in the design system; the accessibility behaviour is summarised here because every screen relies on it.
| Component | Label | Value | Actions | Keyboard |
|---|---|---|---|---|
Knob / ParamKnob |
the knob's label | engine display string with unit; also the tooltip | adjustable, step 0.05 of the range | focusable; arrows step 0.02; Delete resets; focus ring in the tint |
Fader |
passed by the caller ("Channel fader A", "Crossfader", "Tempo") | display string | adjustable, step 0.05 | focusable; Up/Down or Left/Right step 0.02; no keyboard reset |
LevelMeter |
passed by the caller ("Level, deck A", "Master left") | "N decibels", or "clipping" | none (read-only) | not focusable |
ToggleChip |
its title, or an override | "on" / "off", plus the isSelected trait |
button | standard button |
PadButton |
its title, or an override when the title is a symbol | none unless the caller adds one | button | standard button |
DeckBadge |
"Deck A" to "Deck D" | none | none | none |
StudioIconButton |
its title (also the tooltip), even when only the icon is drawn | caller adds "shown" / "hidden" for pane toggles | button | standard button |
RatingStars |
container "Rating", buttons "1 stars" to "5 stars" | "n of 5" | buttons | standard buttons |
Knob, Fader, LevelMeter, the platter and the overview waveform use accessibilityElement(children: .ignore), so each is a single element rather than a group of shapes.
4. Screens
4.1 Main window frame (RootView.swift)
- Section bar. Ten buttons, each a symbol and a title (Studio, Library, Effects, Auto DJ, Automation, Docs, Claude, Record, MIDI, Perform). The selected one has the
isSelectedtrait, a raised background and semibold text. Identifierssection-<name>. The brand mark and name are hidden from assistive technology. - Master clock. One element, label "Master clock", value "N beats per minute". The four beat lamps are hidden. The text "Master A" / "Free clock" is visible but is not part of the spoken value.
- Record indicator. Present only while recording: a button labelled "Recording in progress" with the elapsed time as value. Visually it is a red dot, the word "REC" and the time.
- Status strip. Audio state is combined into one element (symbol plus device text, or "Silent mode (no audio device)", or "Audio stopped", or the error text). DSP load is text with a tooltip. Overloads ("N overloads") and clipping ("Clipped") are labels with a warning symbol and a tooltip. Analysis progress, MIDI count, Auto DJ state and the number of running automations are text labels with symbols. "Emergency Stop" is a labelled button with a tooltip stating its effect.
- Notice capsule. Transient messages are plain text with the identifier
notice. They are not announced: the code posts no accessibility notification, so a VoiceOver user is not told that a notice appeared. Several errors are reported only this way (see section 11). - File drop. Audio files can be dropped on the window; the keyboard equivalent is File > Import Music… (Command-I).
4.2 Decks (Features/Decks/DeckView.swift)
Each deck is an accessibility container labelled "Deck A" (to D), identifier deck-A.
| Control | Label | Value | Notes |
|---|---|---|---|
| Deck badge | "Deck A" | letter always shown | |
| Title and artist | plain text | "Empty" / "Load a track from the library" when empty | |
| Load progress | "Loading deck A" | progress | |
| Master marker | text "Master" with a crown symbol | tooltip; also a tinted card border | |
| Key readout | "Key" | full key name | visible text is the Camelot code and short name; tooltip gives the confidence and says estimates can be wrong |
| Tempo readout | "Tempo" | "N BPM" | visible second line shows the pitch offset in percent, or "no tempo" |
| Time readout | "Time" | "m:ss elapsed, m:ss remaining" | remaining time turns to the warning colour under 30 s while playing; the number itself is the non-colour cue |
| CUE | "Cue, deck A" | tooltip; Option-click stores the cue point | |
| Play / pause | "Play deck A" / "Pause deck A" | icon changes and the button fills when playing | |
| SYNC, KEY LOCK | chip title | on / off | tooltips |
| MSTR | "Master clock" | on / off | |
| Tempo fader | "Tempo" | signed percent | adjustable; caption "TEMPO ±8 %" |
| Key shift minus / plus | "Key down one semitone" / "Key up one semitone" | the value between them ("+2 st") is plain text; double-click resets | |
| Loop IN / OUT | "Loop in" / "Loop out" | ||
| Loop lengths | "Loop N beats" | isSelected when active |
active length is also drawn filled |
| Halve / double loop | "Halve loop" / "Double loop" | ||
| EXIT / RELOOP | its title | title changes with state | |
| Beat jump | "Jump N beats" | ||
| Hot cues 1 to 8 | "Hot cue N, deck A" | the stored time, or "empty" | pad shows its number, and its time when set; Option-click clears |
| QUANT, REV | chip title | on / off | |
| BRAKE, TAP, BEAT HERE, BAR HERE | title | tooltips on TAP, BEAT HERE, BAR HERE | |
| Grid nudge | "Move grid 5 milliseconds earlier" / "later" | ||
| Grid tempo | "Halve the tempo" / "Double the tempo" | ||
| Platter (Vinyl layout) | "Platter, deck A" | position | adjustable in steps of 0.25 s; tooltip |
All deck controls except the header are disabled while the deck is empty. Loading a track by drag and drop has three non-drag alternatives in the library: the Load buttons, the context menu ("Load to Deck A") and the Return key.
4.3 Mixer (Features/Mixer/MixerView.swift)
Containers: "Mixer", then "Channel A" (to D) and "Master".
- Channel: knobs Trim, High, Mid (or Hi-Mid and Lo-Mid with four bands), Low and Filter, each a
ParamKnobwhose value text is hidden visually but available as tooltip and accessibility value. The headphone chip is labelled "Headphone cue, deck A" (its visible title is "CUE", or only a headphones symbol with four decks). "Channel fader A" is adjustable, with its value also printed below. "Level, deck A" meter. The crossfader-side selector is three buttons, "Crossfader side A", "Bypass the crossfader", "Crossfader side B", withisSelectedon the current one, a filled background and a tooltip. - Master: knob "Level"; chip "LIMIT" (on / off, tooltip with ceiling and look-ahead); "Limiter gain reduction" with value "N decibels" or "off" (visible "GR -1.2 dB" / "GR off"); "Master output" with value "clipping" / "not clipping" (visible "CLIP" / "OK"); knobs "Cue Mix" and "Phones"; meters "Master left" and "Master right"; a numeric peak in dB.
- Crossfader: fader "Crossfader" with value "N % B", letters A and B at its ends, and three curve buttons (their capitalised names,
isSelectedon the current one, shared tooltip explaining the three curves).
4.4 Effects (Features/Effects/EffectsView.swift)
- Rack selector: buttons "Master", "Deck A" and so on, with
isSelected, an accent border and, when effects are active, a text badge "N on". - Menus "Add Effect" and "Chains" (standard menus), button "Bypass All" with a tooltip.
- A sentence describes where the rack sits in the signal path. Flow arrows are hidden from assistive technology; the terminals ("Mix", "Deck A", "Fader", "Master") are text.
- Each effect module is a container labelled with the effect name. Power button: " power", value "on" / "off"; the visible state is the filled button plus the word "On" or "Bypassed". Buttons "Move earlier in the chain", "Move later in the chain", "Remove the effect". A "Mix" knob and one knob or chip per parameter, labelled with the parameter name from the DSP catalogue, with the parameter documentation as tooltip. The script path of the effect is shown as text with a tooltip.
- Reordering is by buttons, not by drag, so it is keyboard and VoiceOver operable.
4.5 Waveforms (Features/Waveforms/WaveformViews.swift)
- Scrolling waveform (Metal): container "Waveform, deck A" with value "m:ss of m:ss" or "empty", containing the buttons "Zoom out" and "Zoom in". Scrubbing (drag) and pinch zoom are pointer gestures only; the scrolling waveform has no adjustable action. The same seek function is available on the overview and the platter.
- Overview: one element "Track overview, deck A", value "N %", adjustable in steps of one fiftieth of the track. Cue point, hot cues, loop region and played portion are drawn but not described individually; hot cues are described on their pads.
- The waveform is a visual representation of audio. Its content (band energies, beat grid lines) has no text alternative beyond tempo, key and time on the deck.
- Messages over the waveform ("Drop a track here, or load one from the library", "No waveform: the track has not been analysed") are text.
4.6 Library (Features/Library/*)
- Sidebar. Each source is a button with its name as label, "N tracks" as value and
isSelected; selection is also a raised background and a leading accent bar. "New" buttons carry the section title as an accessibility hint. Rename, Edit Rules and Delete are in a context menu. Rows accept dropped tracks; the non-drag route is the track context menu ("Add to Crate", "Add to Playlist"). - Toolbar. Search field "Search the library"; "Clear search"; "Library source" menu with the current source as value (compact browser); "Import…"; "Natural Order"; inspector toggle "Track inspector" with value "shown" / "hidden"; a text count.
- Track table. A standard SwiftUI
Tablewith sortable columns (Title, Artist, BPM, Key, Time, Match, Rating, Genre, Added, Plays), so row navigation, selection and sorting use system behaviour. Return loads the selected track on a free deck; double-click does the same. State marks are symbols with labels: "Missing file" (warning triangle, tooltip with the path), "Not analysed", "Favourite". The Key cell shows the Camelot code and speaks the musical key name. The Match cell is a symbol, words and a number, exposed as "Match with deck A" with the summary as value. Load buttons are the deck letter in the deck colour, labelled "Load on deck A", with the value "unavailable, the deck is playing" when disabled. - Context menu. Load to Deck, Add to Crate, Add to Playlist, favourites, Rating, Edit Tags…, Show in Finder, Analyse Again, Remove from Library…, and for playlists Move Up / Move Down, which is the non-drag way to reorder.
- Inspector. Favourite button (value on / off), rating stars, tag field "New tag", "Remove tag " buttons, "File path" with the path as value, artwork labelled "Artwork" or "No artwork in this file", and "Waveform overview" with value "m:ss long, N cues".
- Smart-crate editor. Every rule control is labelled with its rule number ("Rule 2 field", "Rule 2 comparison", "Rule 2 value", "Rule 2 upper value", "Remove rule 2"); the error and count lines are text.
- Dialogs. Name prompts, removal confirmation, tag sheet and the import-failure list are standard alerts, confirmation dialogs and sheets with default and cancel actions.
4.7 Automation Studio (Features/AutomationStudio/*)
- Toolbar. A segmented mode picker (Editor, Presets, Visual Builder) and
StudioIconButtons whose titles include the shortcut ("Save (⌘S)", "Validate (⌘B)", "Run (⌘R)", "Simulate (⌘D)", "Format (⌥⌘L)"). Pane toggles expose "shown" / "hidden". The Stop control is a menu. Emergency Stop is repeated here. - Editor tabs. Each open script is one element labelled with its name plus ", edited" when it has unsaved changes, with the button trait and
isSelected. The unsaved dot is hidden from assistive technology; the word "edited" is also printed. The close button is labelled "Close ". - Editor. An AppKit
NSTextViewlabelled "Script editor", so text navigation, selection, undo and the find bar use the system text accessibility. Syntax colours are decorative. Diagnostics are underlines with a tooltip and are repeated as text in the Problems panel; the status line shows "N errors" / "N warnings" as buttons with symbols. The completion list is a container "Completions" whose rows haveisSelected; it is driven from the keyboard (Escape or Control-Space to open, arrows, Return or Tab to accept, Escape to close). - Gutter. Labelled "Editor gutter: breakpoints and folding". Breakpoints and folding are toggled by mouse click only (
ScriptEditor.swift,mouseDown, line 931). There is no menu command or key for either. - Script Explorer. Search field, sort picker, "Favourites" chip (on / off), rows that are buttons with a context menu (Open, Rename…, Duplicate, favourites, Edit Tags…, Version History…, Export…, Delete…), and preset categories with the value "expanded" / "collapsed".
- Inspector. Standard pickers, number fields and toggles; simulated deck toggles are labelled "Deck A loaded" and "Deck A playing"; "Remove trigger".
- Bottom panels. Six tab buttons (Console, Simulator, Debugger, Problems, Log, Monitor) with
isSelectedand a text badge for counts.- Console: each output line is labelled ": "; the input field is "Console input" with history on the Up and Down arrows and completion on Tab.
- Problems: each entry is a button labelled ", line L, column C: " with the hint "Shows the location in the editor".
- Simulator: the timeline (a
Canvas) is one element "Simulation timeline" whose value states the length and names each parameter curve; trace rows are buttons labelled "Beat N, : , line L". - Debugger: Start / Restart, Continue, Step, Stop with titles; state shown as text.
- Log: Kind and Run pickers, an "Autoscroll" checkbox, Clear.
- Monitor: per-run Pause / Resume / Stop buttons; run state is a word with a symbol (Running, Paused, Finished, Stopped, Failed).
- Visual Builder. Blocks are edited with menus, pickers, number fields and steppers. Block order is changed with "Move block up" / "Move block down" and "Remove block" buttons, not by dragging. The target menu is labelled "Parameter" with the current target as value; the validity line and the generated script are text.
4.8 Auto DJ (Features/AutoDJ/AutoDJView.swift)
- Start and Stop buttons with tooltips; a statement that Auto DJ is deterministic and local.
- "Queue source" menu with the current source as value; "Restore Removed"; a text count.
- Queue rows are containers. Tempo and key are labelled elements ("Tempo", "Key" with the musical name). The link to the next track is one element "Into the next track" with value "tempo change …, " and ", above the limit" when it applies, so the over-limit state is in words. Row buttons: "Play first", "Move up", "Move down", "Remove from the queue".
- Settings: "Transition style" and "Transition length" pickers, switches with a title and a detail line, a stepper "Largest tempo change" with value "N percent".
- Live status: "Auto DJ state" with the state as value (symbol and word). The generated transition script is exposed as "ORIX Script" with the source as value, with "Open in Editor".
4.9 Claude Studio (Features/ClaudeStudio/*)
- Without a key: an explanation and one button, "Open Settings → AI".
- Task selector buttons with
isSelectedand a summary tooltip; the request editor is "Request to Claude"; example buttons; "Review and Send" / "Send" (Command-Return); "Stop" (Command-period) while a request runs; "New Conversation". - Context panel: one switch per shared item with a title, a detail line and a tooltip; "Script to share" picker; "Preview of the shared context" as selectable text; the sentence "Audio is never uploaded…".
- Confirmation sheet: the text to be sent, a disclosure "Show the language reference", Cancel (Escape) and Send (Return).
- Proposals: validity, validation results, simulation summary, requirements and risks are text with symbols; the script is "Proposed script" with the source as value; the diff view labels each line "Added", "Removed" or "Unchanged" in addition to its colour; actions Save, Edit, Test, Copy, Run… are titled buttons with tooltips, and Run asks for confirmation.
- Token usage is one labelled element spelling out model and token counts.
4.10 MIDI (Features/MIDI/MIDIView.swift)
- Devices: each device row and each statistic is combined into one element; "Rescan" and "Reset" buttons; an explanatory element when no device is present.
- Monitor: "Pause the monitor" chip (on / off; its title changes between "Pause" and "Paused"), "Clear", and message rows combined into single elements.
- Mapping: "Profile" menu with the profile name as value; profile state and "unsaved" as text; Revert, Save (Command-S), Activate / Deactivate; an actions menu. Each mapping row labels every control with its row number: "MIDI Learn for mapping N" (value "waiting for a control" or the control description), "Target" (value: group, name and kind), "Mode of mapping N", "Minimum of mapping N, percent", "Maximum of mapping N, percent", "Invert mapping N", "Soft takeover for mapping N", "Relative encoding of mapping N", "Sensitivity of mapping N", "Delete mapping N". Row problems are text.
- MIDI Learn waits for hardware input by nature; mappings can also be created and edited entirely with the menus and fields, and imported from a file.
4.11 Recording (Features/Recording/RecordingView.swift)
- Record button: label "Record" / "Stop recording", value "not recording" / "recording, m:ss", shortcut Shift-Command-R, tooltip. The shape changes from a circle to a square, and the words "READY" / "RECORDING" appear next to it with a symbol. "Elapsed time" readout.
- Meters "Master left" / "Master right". Facts (file size, free disk space, gaps) are combined label-value elements. Warnings are labels with symbols and full sentences (gaps, the reason a recording stopped, low disk space).
- Takes: each take is a button with its name, value "m:ss long" plus ", recovered take", and
isSelected; context menu Show in Finder / Move to Trash…; per-file buttons "Show in Finder" and "Add to the library"; "Refresh the list". - Trim and export: the waveform is a container "Take waveform with trim handles"; the two handles are elements "Trim start" and "Trim end" with the time as value and an adjustable action (step: the larger of 0.05 s and one two-hundredth of the take). The same values are editable as number fields. "Whole Take", a "Normalise the peak to −1 dBFS" checkbox, a "Gain" slider with value in decibels, "Format" picker, "File name" field, Export (Command-E), "Export progress", and an error line.
- The export report is a set of combined label-value elements, with a clipping warning in words.
4.12 Perform (Features/Performance/PerformanceView.swift)
- One container per deck ("Deck A") with a large badge, a level meter, the title, key, tempo, "Time remaining", both waveforms, CUE ("Cue, deck A"), play / pause, SYNC, eight hot-cue buttons ("Hot cue N, deck A", value "set" / "empty") and a horizontal "Channel fader A".
- Crossfader with A and B letters.
- A large "EMERGENCY STOP" button with a symbol and a sentence stating its effect; identifier
perform-emergency-stop. - Master panel: horizontal meters, a numeric peak, "Limiter" and "Output" status lines (the output line reads "CLIPPING" or "clean").
- Automation panel: each run with its name, bar position, a progress bar labelled " progress" and a Stop button; eight trigger pads labelled "Fire trigger N".
- Status panel: Recording, MIDI, Audio, DSP load and Clock as combined label-value lines; Start / Stop Recording.
- In this section a stored hot cue cannot be cleared (there is no Option-click handling), and the hot-cue value does not include the stored time.
4.13 Docs (Features/Docs/*)
- Search field "Search the documentation" (Command-F focuses it; Escape clears it), "Clear search", a result count, results as buttons labelled ": ", chapter group titles with the header trait.
- Chapter list: each row is one element with the button trait,
isSelected, and an explicit accessibility action that opens it; sub-page disclosure buttons are labelled "Show the pages of " / "Hide the pages of <title>".</li> <li>Reader: Markdown headings carry the header trait; body text, tables and code are selectable; tables are containers labelled "Table, N columns, M rows"; unordered list bullets are hidden; search highlights are labelled "Search match". Code blocks are labelled "ORIX Script code" or "Text block" with the source as value, with buttons Run in Simulator, Open in Editor and Copy. Results of a run are text; errors use a symbol and words ("Does not compile").</li> <li>Text size: "Smaller text" and "Larger text" buttons with the current percentage exposed as "Text size"; shortcuts Command-plus, Command-equals, Command-minus and Command-0. The scale runs from 80 % to 180 % in steps of 10 % and is stored (<code>docs.textScale</code>).</li> <li>Previous / Next chapter buttons and a section menu.</li> </ul> <h3 id="414-settings-featuressettings" tabindex="-1"><a class="heading-anchor" href="#414-settings-featuressettings" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 4.14 Settings (<code>Features/Settings/*</code>)</h3> <p>A standard <code>Settings</code> window with a <code>TabView</code> of seven tabs (Audio, Mixer, Library, Appearance, AI, Automation, About), each a label with a symbol. Controls are standard pickers, switches, sliders, steppers, text fields and buttons. Where a control's own label is hidden for layout (<code>labelsHidden()</code>), an explicit <code>accessibilityLabel</code> is given ("Output device", "Sample rate", "Buffer size", "Master output pair", "Headphone cue output pair", "Split cue", "EQ bands", "Crossfader curve", "Master limiter", "Deck count", "Deck mode", "Theme", "Model", "Effort"). Sliders speak a value with a unit ("N seconds", "N milliseconds"). Readouts (<code>SettingsReadout</code>) are single label-value elements. The API key field is a <code>SecureField</code> labelled "Anthropic API key"; the stored key is shown masked and labelled "Stored key, masked". Audio state lines are labels with symbols. The waveform palette options are radio-style buttons with a radio symbol, a three-letter swatch (L, M, H), a title, <code>isSelected</code> and the value "selected" / "not selected".</p> <p>Two toggles in the AI tab ("Ask before every request", "Retry declined requests on a fallback model") and two steppers use <code>labelsHidden()</code> without a separate <code>accessibilityLabel</code>; they pass a title to the control, which SwiftUI normally keeps as the accessibility label when the visible label is hidden. That behaviour was not verified with VoiceOver.</p> <h2 id="5-keyboard-access" tabindex="-1"><a class="heading-anchor" href="#5-keyboard-access" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 5. Keyboard access</h2> <h3 id="51-menu-commands-appsourcesapporixdjappswift" tabindex="-1"><a class="heading-anchor" href="#51-menu-commands-appsourcesapporixdjappswift" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 5.1 Menu commands (<code>App/Sources/App/ORIXDJApp.swift</code>)</h3> <table> <thead> <tr> <th>Menu</th> <th>Command</th> <th>Shortcut</th> </tr> </thead> <tbody> <tr> <td>File</td> <td>New Automation</td> <td>Command-N</td> </tr> <tr> <td>File</td> <td>Open Project…</td> <td>Command-O</td> </tr> <tr> <td>File</td> <td>Save Project</td> <td>Option-Command-S</td> </tr> <tr> <td>File</td> <td>Save Project As…</td> <td>Shift-Option-Command-S</td> </tr> <tr> <td>File</td> <td>Import Music…</td> <td>Command-I</td> </tr> <tr> <td>Decks</td> <td>Play / Pause Deck A, B, C, D</td> <td>Command-1, 2, 3, 4</td> </tr> <tr> <td>Decks</td> <td>Cue Deck A, B, C, D</td> <td>Shift-Command-1, 2, 3, 4</td> </tr> <tr> <td>Decks</td> <td>Two Decks, Four Decks</td> <td>none</td> </tr> <tr> <td>Automation</td> <td>Run Script</td> <td>Command-R</td> </tr> <tr> <td>Automation</td> <td>Stop All Automations</td> <td>Command-period</td> </tr> <tr> <td>Automation</td> <td>Emergency Stop</td> <td>Shift-Command-Escape</td> </tr> <tr> <td>Automation</td> <td>Fire Trigger 1 to 8</td> <td>Control-Option-1 to 8</td> </tr> <tr> <td>View</td> <td>Studio, Library, Effects, Auto DJ, Automation, Docs, Claude, Record, MIDI</td> <td>Control-1 to Control-9</td> </tr> <tr> <td>View</td> <td>Perform</td> <td>Control-0</td> </tr> <tr> <td>Help</td> <td>ORIX Script Documentation</td> <td>Command-?</td> </tr> </tbody> </table> <p>Every section and the safety control are therefore reachable without the pointer. Settings opens with the system Command-comma.</p> <h3 id="52-section-shortcuts" tabindex="-1"><a class="heading-anchor" href="#52-section-shortcuts" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 5.2 Section shortcuts</h3> <table> <thead> <tr> <th>Section</th> <th>Command</th> <th>Shortcut</th> <th>How it is declared</th> </tr> </thead> <tbody> <tr> <td>Automation Studio</td> <td>Save, Save As</td> <td>Command-S, Shift-Command-S</td> <td>hidden buttons in the view, and again in the editor's key handling</td> </tr> <tr> <td>Automation Studio</td> <td>Run, Stop</td> <td>Command-R, Command-period</td> <td>same</td> </tr> <tr> <td>Automation Studio</td> <td>Validate, Simulate, Format</td> <td>Command-B, Command-D, Option-Command-L</td> <td>same</td> </tr> <tr> <td>Script editor</td> <td>Find, Find and Replace, Find Next, Find Previous</td> <td>Command-F, Option-Command-F, Command-G, Shift-Command-G</td> <td>editor key handling</td> </tr> <tr> <td>Script editor</td> <td>Open completions</td> <td>Escape or Control-Space</td> <td>editor key handling</td> </tr> <tr> <td>Console</td> <td>History, complete</td> <td>Up / Down, Tab</td> <td><code>onKeyPress</code> on the input field</td> </tr> <tr> <td>Docs</td> <td>Find in Documentation</td> <td>Command-F</td> <td>hidden button</td> </tr> <tr> <td>Docs</td> <td>Larger, Smaller, Actual Size</td> <td>Command-plus or Command-equals, Command-minus, Command-0</td> <td>hidden buttons</td> </tr> <tr> <td>Claude Studio</td> <td>Send, Stop</td> <td>Command-Return, Command-period</td> <td>buttons</td> </tr> <tr> <td>Record</td> <td>Record / Stop</td> <td>Shift-Command-R</td> <td>button</td> </tr> <tr> <td>Record</td> <td>Export</td> <td>Command-E</td> <td>button</td> </tr> <tr> <td>MIDI</td> <td>Save profile</td> <td>Command-S</td> <td>button</td> </tr> <tr> <td>Library</td> <td>Load selected track</td> <td>Return</td> <td><code>onKeyPress</code> on the table</td> </tr> <tr> <td>Dialogs and sheets</td> <td>default, cancel</td> <td>Return, Escape</td> <td><code>.defaultAction</code>, <code>.cancelAction</code></td> </tr> </tbody> </table> <p>The section shortcuts declared on hidden buttons are active only while that section is shown, because only one section view exists at a time. They do not appear in the menu bar, so they are discoverable only through tooltips (the Automation toolbar titles include them) and documentation.</p> <h3 id="53-focus" tabindex="-1"><a class="heading-anchor" href="#53-focus" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 5.3 Focus</h3> <ul> <li><code>Knob</code> and <code>Fader</code> are explicitly focusable and draw their own focus indicator in the control's tint. Whether the Tab key reaches them depends on how the system routes keyboard navigation to SwiftUI <code>focusable()</code> views; this was not tested.</li> <li>All other controls are standard buttons, pickers, fields, tables and menus. On macOS, moving focus between buttons with Tab requires the system setting "Keyboard navigation" to be on; the application does not change that.</li> <li>Focus is managed explicitly in three places: the Claude request editor, the console input (focus returns to it after a command or an accepted completion) and the search fields of the Library and Docs.</li> <li>The scrolling waveform (Metal view) and the level meters are not focusable.</li> </ul> <h3 id="54-pointer-only-interactions" tabindex="-1"><a class="heading-anchor" href="#54-pointer-only-interactions" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 5.4 Pointer-only interactions</h3> <table> <thead> <tr> <th>Interaction</th> <th>Where</th> <th>Equivalent</th> </tr> </thead> <tbody> <tr> <td>Scrub by dragging the scrolling waveform</td> <td><code>WaveformViews.swift:24</code></td> <td>overview adjustable action; platter adjustable action; beat jump buttons</td> </tr> <tr> <td>Pinch to zoom the waveform</td> <td><code>WaveformViews.swift:31</code></td> <td>Zoom in / Zoom out buttons; zoom slider in Settings</td> </tr> <tr> <td>Drag a track to a deck or a crate</td> <td><code>DeckView.swift</code>, <code>LibrarySidebar.swift</code></td> <td>Load buttons, Return, context menu</td> </tr> <tr> <td>Reorder playlist rows by drag</td> <td><code>LibraryTrackTable.swift</code></td> <td>Move Up / Move Down in the context menu</td> </tr> <tr> <td>Drag trim region on the take waveform</td> <td><code>RecordingView.swift:524</code></td> <td>adjustable trim handles; number fields</td> </tr> <tr> <td>Double-click a knob to reset</td> <td><code>Components.swift:64</code></td> <td>Delete key</td> </tr> <tr> <td>Double-click a fader to reset</td> <td><code>Components.swift:157</code></td> <td>none (see gaps)</td> </tr> <tr> <td>Option-click CUE to store the cue point</td> <td><code>DeckView.swift:127</code></td> <td>none (see gaps)</td> </tr> <tr> <td>Option-click a hot cue to clear it</td> <td><code>DeckView.swift:218</code></td> <td>none (see gaps)</td> </tr> <tr> <td>Double-click the key-shift value to reset</td> <td><code>DeckView.swift:158</code></td> <td>step back with the plus / minus buttons</td> </tr> <tr> <td>Click the gutter for breakpoints and folding</td> <td><code>ScriptEditor.swift:931</code></td> <td>none (see gaps)</td> </tr> <tr> <td>Shift-drag for fine adjustment</td> <td><code>Components.swift:61</code>, <code>155</code></td> <td>arrow keys step 0.02</td> </tr> </tbody> </table> <h2 id="6-state-that-does-not-depend-on-colour" tabindex="-1"><a class="heading-anchor" href="#6-state-that-does-not-depend-on-colour" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 6. State that does not depend on colour</h2> <table> <thead> <tr> <th>State</th> <th>Colour</th> <th>Other cue</th> </tr> </thead> <tbody> <tr> <td>Deck identity</td> <td>deck colour</td> <td>letter in <code>DeckBadge</code>, on the platter, on load buttons, in every label</td> </tr> <tr> <td>Latching control on / off</td> <td>tint fill</td> <td>whole chip inverts; value "on" / "off"; <code>isSelected</code></td> </tr> <tr> <td>Playing</td> <td>filled play button</td> <td>icon changes from play to pause; label changes</td> </tr> <tr> <td>Master deck</td> <td>tinted border</td> <td>"Master" capsule with a crown; MSTR chip; "Master A" in the clock</td> </tr> <tr> <td>Level</td> <td>green / amber / red</td> <td>bar length; fixed 0 dBFS mark; numeric dB next to master and recording meters</td> </tr> <tr> <td>Clipping</td> <td>red</td> <td>words "CLIP" / "OK", "Clipped", "CLIPPING" / "clean"; meter value "clipping"</td> </tr> <tr> <td>Limiter working</td> <td>amber text</td> <td>number "GR -N dB"</td> </tr> <tr> <td>Overloads, audio stopped</td> <td>amber</td> <td>symbol and words</td> </tr> <tr> <td>Recording</td> <td>red</td> <td>"REC" with time; "RECORDING" / "READY"; button shape changes; label and value</td> </tr> <tr> <td>Remaining time under 30 s</td> <td>amber</td> <td>the number itself; no additional cue</td> </tr> <tr> <td>Effect on / bypassed</td> <td>accent border and power fill</td> <td>words "On" / "Bypassed"; value on / off</td> </tr> <tr> <td>Active loop length, curve</td> <td>filled pad</td> <td><code>isSelected</code>; EXIT / RELOOP title changes</td> </tr> <tr> <td>Hot cue stored</td> <td>pad colour</td> <td>stored time printed on the pad; value time / "empty"</td> </tr> <tr> <td>Selected tab, source, take, rack</td> <td>raised background</td> <td>font weight; <code>isSelected</code>; accent bar or underline</td> </tr> <tr> <td>Unsaved script</td> <td>amber dot</td> <td>word "edited"; label suffix ", edited"</td> </tr> <tr> <td>Missing file, not analysed</td> <td>amber / grey symbol</td> <td>distinct symbols; labels; tooltip</td> </tr> <tr> <td>Harmonic match</td> <td>symbol tint</td> <td>distinct symbol; words and numbers</td> </tr> <tr> <td>Diagnostics</td> <td>red / amber</td> <td>distinct symbols; severity word in the label; line and column</td> </tr> <tr> <td>Run state</td> <td>green / amber / red</td> <td>word and distinct symbol (Running, Paused, Finished, Stopped, Failed)</td> </tr> <tr> <td>Diff lines</td> <td>colour</td> <td>per-line label Added / Removed / Unchanged</td> </tr> <tr> <td>Waveform bands</td> <td>three hues</td> <td>nested outline sizes on the overview; selectable palettes</td> </tr> <tr> <td>Beat lamps</td> <td>accent on beat 1, cyan on 2 to 4</td> <td>position of the lit lamp; BPM as text; lamps are decorative</td> </tr> </tbody> </table> <p>Two places where colour carries most of the information: the beat-grid, cue and hot-cue lines inside the waveforms (each also has a non-visual equivalent on the deck controls), and the syntax colours of the editor (decorative).</p> <h2 id="7-reduce-motion" tabindex="-1"><a class="heading-anchor" href="#7-reduce-motion" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 7. Reduce Motion</h2> <p><code>grep</code> finds no use of <code>accessibilityReduceMotion</code> (or the AppKit equivalent) anywhere in the application. What moves:</p> <ul> <li>The scrolling waveform, redrawn by Metal at 60 frames per second while a deck plays and 15 when it is idle (<code>WaveformRenderer.swift</code>). It scrolls continuously under a fixed playhead.</li> <li>Level meters, readouts and playheads, refreshed from the model (30 times per second for live state according to the comment in <code>AppModel.swift</code>).</li> <li>The platter position marker in the Vinyl layout.</li> <li>The beat lamps in the section bar, which change on each beat.</li> <li>The notice capsule, which fades in and out over 0.15 s (the only declared SwiftUI animation; there is no <code>withAnimation</code>, no repeating animation and no symbol effect in the code).</li> </ul> <p>None of this is decorative animation, but the scrolling waveform is large continuous motion and it does not change when Reduce Motion is on. A user sensitive to motion can choose the Minimal or Standard deck layout (no platter), but cannot stop the waveform from scrolling. This is a gap.</p> <h2 id="8-colour-vision-contrast-and-transparency" tabindex="-1"><a class="heading-anchor" href="#8-colour-vision-contrast-and-transparency" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 8. Colour vision, contrast and transparency</h2> <ul> <li><strong>Colour-blind palette.</strong> Settings > Appearance offers four waveform palettes; "Colour-blind safe (blue / orange / yellow)" uses <code>#0072B2</code>, <code>#E69F00</code>, <code>#F0E442</code>, and "Monochrome" separates the bands by brightness only. The palette applies to both waveform views. It does not change deck colours, hot-cue colours or status colours, which rely on the letter, number and word cues of section 6. The claim in the Settings text that the three colours "stay distinct with the common forms of colour-vision deficiency" was not checked with a simulator for this report.</li> <li><strong>Increase Contrast.</strong> Not handled: the code does not read <code>colorSchemeContrast</code>, and the palette has no high-contrast variant. Borders use <code>hairline</code>, which is between 1.14:1 and 1.40:1 against the surfaces (computed).</li> <li><strong>Differentiate Without Colour.</strong> Not read by the code. The default design already pairs colour with text or shape in the cases listed in section 6.</li> <li><strong>Reduce Transparency.</strong> Not read by the code. The interface uses opaque surfaces; translucency is limited to a few tinted fills.</li> <li><strong>Light and dark.</strong> Both appearances are supported through dynamic colours, with dark as the default.</li> </ul> <h3 id="computed-contrast-of-the-tokens" tabindex="-1"><a class="heading-anchor" href="#computed-contrast-of-the-tokens" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> Computed contrast of the tokens</h3> <p>Full tables are in the <a href="../design/design-system.md#26-computed-contrast">design system</a>. Summary of the computed values:</p> <table> <thead> <tr> <th>Pair</th> <th>Light</th> <th>Dark</th> </tr> </thead> <tbody> <tr> <td><code>textPrimary</code> on canvas / surface / raised</td> <td>17.09 / 18.61 / 16.35</td> <td>17.63 / 16.04 / 14.32</td> </tr> <tr> <td><code>textSecondary</code> on canvas / surface / raised</td> <td>5.72 / 6.23 / 5.47</td> <td>8.38 / 7.63 / 6.81</td> </tr> <tr> <td><code>textTertiary</code> on canvas / surface / raised</td> <td>5.29 / 5.76 / 5.06</td> <td>6.68 / 6.08 / 5.43</td> </tr> <tr> <td><code>danger</code> on surface</td> <td>5.82</td> <td>6.39</td> </tr> <tr> <td><code>warning</code> on surface</td> <td>6.22</td> <td>10.56</td> </tr> <tr> <td><code>success</code> on surface</td> <td>5.83</td> <td>9.17</td> </tr> <tr> <td><code>accent</code> on surface</td> <td>6.20</td> <td>5.64</td> </tr> <tr> <td>Lowest deck colour on surface (deck B light, deck C dark)</td> <td>5.13</td> <td>6.48</td> </tr> <tr> <td>Near-black text on a lit control, lowest and highest over the token fills</td> <td>3.14 to 3.80</td> <td>6.02 to 10.67</td> </tr> <tr> <td>CUE label <code>#FF9F0A</code> on <code>surfaceRaised</code></td> <td>1.81</td> <td>7.66</td> </tr> <tr> <td>Amber knob arc <code>#FBBF24</code> on <code>surfaceRaised</code></td> <td>1.47</td> <td>9.43</td> </tr> <tr> <td>White on the Perform Emergency Stop red <code>#C0283A</code></td> <td>5.82</td> <td>5.82</td> </tr> </tbody> </table> <p>The comment in <code>Tokens.swift</code> ("Text colours reach at least 4.5:1 … on canvas, surface and raised surface, in both appearances") is confirmed by computation for the three text tokens. The dark appearance has no computed pair below 4.5:1 for text. The light appearance has three: the text of lit controls, the CUE label, and (as a graphic, below 3:1) the amber knob arcs. Text sizes matter here: most labels are 9 to 12 pt, which is small text under WCAG, so the 4.5:1 threshold applies rather than 3:1.</p> <h2 id="9-text-size" tabindex="-1"><a class="heading-anchor" href="#9-text-size" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 9. Text size</h2> <p>macOS has no Dynamic Type; the application-level controls are these:</p> <ul> <li>All interface fonts are fixed point sizes (<code>Font.system(size:)</code>), many between 8 and 11 pt (deck captions at 8 and 9 pt, knob labels at 10 pt, status strip at 11 pt). They do not follow any system text-size preference, and there is no interface scale setting.</li> <li>Several labels use <code>lineLimit(1)</code> with <code>minimumScaleFactor(0.7)</code>, so a 10 pt knob label can be drawn at 7 pt when space is short.</li> <li>The Docs reader is the exception: its text scales from 80 % to 180 % with shortcuts and buttons, and the setting persists.</li> <li>The script editor uses a fixed 12.5 pt monospaced font with no size control.</li> <li>The window has a minimum size of 1180 x 800 and the layout is dense by design; system display scaling or Zoom are the available means of enlargement.</li> </ul> <h2 id="10-localisation" tabindex="-1"><a class="heading-anchor" href="#10-localisation" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 10. Localisation</h2> <ul> <li><code>App/Info.plist</code> declares <code>CFBundleLocalizations</code> <code>en</code> and <code>fr-CA</code>. <code>project.yml</code> sets the development language to <code>en</code> and prefers string catalogs.</li> <li><code>Scripts/localize.py</code> rebuilds <code>App/Resources/Localizable.xcstrings</code> from the <code>.stringsdata</code> files the compiler emits during a build, and fills in French-Canadian values from <code>Scripts/translations-fr-CA.json</code>. It marks keys without two consecutive letters as not translatable and prints how many keys have French. With <code>--missing</code> it writes <code>build/missing-fr.json</code>.</li> <li>On 2026-11-21 neither <code>App/Resources/Localizable.xcstrings</code> nor <code>Scripts/translations-fr-CA.json</code> existed in the repository, and there is no <code>.lproj</code> folder. <code>App/Resources</code> contains only the asset catalog. The only language that actually exists is therefore English, at 100 %; French-Canadian is declared but 0 % complete. A build made in this state would advertise fr-CA and show English.</li> <li>Preparation in code: most visible strings are <code>LocalizedStringKey</code> literals (<code>Text("…")</code>, <code>Button("…")</code>, labels, tooltips, accessibility labels) and 99 use <code>String(localized:)</code>, so they would be extracted. Not everything is: <code>PadButton</code> takes a <code>String</code> and shows it with <code>Text(verbatim:)</code>, so pad legends ("IN", "OUT", "BEAT HERE", "BAR HERE", "TAP", "BRAKE", "EXIT", "RELOOP", curve names) cannot be translated as written; many status strings are built with <code>String(format:)</code> or interpolation into <code>Text(verbatim:)</code> ("GR %.1f dB", "DSP %.0f %%", "no tempo", "Auto DJ: <state>"); notices passed to <code>model.show(notice:)</code> are plain Swift strings; effect and parameter names come from the DSP catalogue in English.</li> <li>Number and time formats (<code>formatTime</code>, <code>formatBPM</code>, <code>String(format:)</code>) use fixed formats with a full stop as decimal separator, not the user's locale.</li> <li>Accessibility labels follow the same mechanism as visible text, so they would be translated with it. Some compose English fragments ("(n) stars", "Loop (x) beats"), which need plural handling in a catalog.</li> <li>Right-to-left layout was not considered; neither declared language needs it.</li> </ul> <h2 id="11-gaps-found" tabindex="-1"><a class="heading-anchor" href="#11-gaps-found" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 11. Gaps found</h2> <p>Line numbers are as read on 2026-11-21.</p> <h3 id="controls-without-a-keyboard-or-voiceover-route" tabindex="-1"><a class="heading-anchor" href="#controls-without-a-keyboard-or-voiceover-route" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> Controls without a keyboard or VoiceOver route</h3> <table> <thead> <tr> <th>#</th> <th>Gap</th> <th>Location</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>Breakpoints and code folding can be toggled only by clicking the gutter. No menu command, key or accessibility action. A keyboard or VoiceOver user cannot set a breakpoint.</td> <td><code>Features/AutomationStudio/ScriptEditor.swift:931</code> (<code>CodeGutterView.mouseDown</code>)</td> </tr> <tr> <td>2</td> <td>Storing the cue point is Option-click on CUE only.</td> <td><code>Features/Decks/DeckView.swift:127</code></td> </tr> <tr> <td>3</td> <td>Clearing a hot cue is Option-click only; in Perform it is not possible at all.</td> <td><code>Features/Decks/DeckView.swift:218</code>; <code>Features/Performance/PerformanceView.swift:76</code></td> </tr> <tr> <td>4</td> <td><code>Fader</code> has no keyboard reset (the knob has Delete); reset is double-click only. Affects tempo, crossfader and channel faders.</td> <td><code>DesignSystem/Components.swift:157</code></td> </tr> <tr> <td>5</td> <td>Key-shift reset is a double-click on a text label that is not a control.</td> <td><code>Features/Decks/DeckView.swift:158</code></td> </tr> <tr> <td>6</td> <td>The scrolling waveform has no adjustable action; scrub and pinch are pointer only (equivalents exist elsewhere). Its label and value are set on a <code>.contain</code> container, which may not be read as an element.</td> <td><code>Features/Waveforms/WaveformViews.swift:24</code>, <code>53</code></td> </tr> <tr> <td>7</td> <td>Editor tabs are selected with <code>onTapGesture</code> on a non-button view. They carry the button trait but, unlike the Docs chapter rows, no explicit <code>accessibilityAction</code>, and they are not keyboard focusable. There is no next / previous tab command.</td> <td><code>Features/AutomationStudio/AutomationStudioView.swift:236</code></td> </tr> <tr> <td>8</td> <td>Docs chapter rows are also <code>onTapGesture</code> views: they have an accessibility action but are not reachable with Tab.</td> <td><code>Features/Docs/DocsView.swift:169</code></td> </tr> <tr> <td>9</td> <td>Completion rows in the editor accept a click through <code>onTapGesture</code>; the keyboard route exists, a VoiceOver activation route was not verified.</td> <td><code>Features/AutomationStudio/ScriptEditor.swift:997</code></td> </tr> </tbody> </table> <h3 id="labels-and-announcements" tabindex="-1"><a class="heading-anchor" href="#labels-and-announcements" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> Labels and announcements</h3> <table> <thead> <tr> <th>#</th> <th>Gap</th> <th>Location</th> </tr> </thead> <tbody> <tr> <td>10</td> <td>Notices are never announced. Errors from loops, hot cues, track loading, saving and the "rack is full" case reach the user only as a capsule that disappears.</td> <td><code>App/RootView.swift:38</code>; <code>App/AppModel.swift:279</code></td> </tr> <tr> <td>11</td> <td>No icon-only button without a label was found: every <code>Image</code>-only button read has an <code>accessibilityLabel</code>, a titled <code>Label</code>, or is a <code>StudioIconButton</code>. This is a negative result from reading and from a <code>grep</code> heuristic, not from an audit tool.</td> <td>all feature views</td> </tr> <tr> <td>12</td> <td>Section headings (<code>SectionLabel</code>, <code>PaneHeader</code>, settings card titles) do not carry the header trait, so heading navigation works only inside the Docs reader.</td> <td><code>DesignSystem/Components.swift:25</code></td> </tr> <tr> <td>13</td> <td>The deck "Time" element speaks track time remaining (<code>s.remaining</code>), while the visible figure is remaining time at the current rate (<code>s.remaining / rate</code>). The two differ when the tempo is not 0 %.</td> <td><code>Features/Decks/DeckView.swift:100</code>, <code>104</code></td> </tr> <tr> <td>14</td> <td>The master clock value omits which deck is master, although it is displayed.</td> <td><code>App/RootView.swift:113</code></td> </tr> <tr> <td>15</td> <td>Level meters are exposed as live values that change many times per second; whether this is read sensibly or is noisy with VoiceOver is unknown. Clipping is not announced.</td> <td><code>DesignSystem/Components.swift:210</code></td> </tr> <tr> <td>16</td> <td>Only two accessibility hints exist; behaviour that is explained in tooltips (<code>.help</code>, 96 of them) is not available as hints. Whether VoiceOver reads these tooltips was not verified.</td> <td>all</td> </tr> </tbody> </table> <h3 id="visual" tabindex="-1"><a class="heading-anchor" href="#visual" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> Visual</h3> <table> <thead> <tr> <th>#</th> <th>Gap</th> <th>Location</th> </tr> </thead> <tbody> <tr> <td>17</td> <td>Light appearance: near-black text on lit controls computes to 3.14:1 to 3.80:1.</td> <td><code>DesignSystem/Components.swift:231</code>, <code>258</code>, <code>273</code>; <code>Features/Mixer/MixerView.swift:72</code></td> </tr> <tr> <td>18</td> <td>Light appearance: the CUE label <code>#FF9F0A</code> computes to 1.81:1 on <code>surfaceRaised</code>; the amber knob arcs to 1.47:1. These literals are not appearance-aware.</td> <td><code>Features/Decks/DeckView.swift:121</code>; <code>Features/Performance/PerformanceView.swift:63</code>; <code>Features/Mixer/MixerView.swift:114</code></td> </tr> <tr> <td>19</td> <td>Control borders (<code>hairline</code>) are 1.14:1 to 1.40:1; unlit buttons are distinguished from the panel mostly by the <code>surfaceRaised</code> fill, which differs from <code>surface</code> by a small luminance step.</td> <td><code>DesignSystem/Tokens.swift:35</code></td> </tr> <tr> <td>20</td> <td>No Reduce Motion handling; the waveform always scrolls.</td> <td><code>Features/Waveforms/WaveformRenderer.swift:224</code></td> </tr> <tr> <td>21</td> <td>No Increase Contrast, Differentiate Without Colour or Reduce Transparency handling.</td> <td>whole application</td> </tr> <tr> <td>22</td> <td>Fixed small text (8 to 11 pt), scaled down further by <code>minimumScaleFactor(0.7)</code>; no interface scale; editor font not adjustable.</td> <td><code>DesignSystem/Tokens.swift:77</code>; <code>DesignSystem/Components.swift:73</code></td> </tr> <tr> <td>23</td> <td>Remaining time under 30 s is signalled by colour change only (plus the number). There is no sound or announcement.</td> <td><code>Features/Decks/DeckView.swift:101</code></td> </tr> </tbody> </table> <h3 id="localisation-and-tests" tabindex="-1"><a class="heading-anchor" href="#localisation-and-tests" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> Localisation and tests</h3> <table> <thead> <tr> <th>#</th> <th>Gap</th> <th>Location</th> </tr> </thead> <tbody> <tr> <td>24</td> <td>fr-CA is declared but no catalog or translation file exists.</td> <td><code>App/Info.plist</code>; <code>Scripts/localize.py</code></td> </tr> <tr> <td>25</td> <td><code>PadButton</code> titles and many formatted strings are not localisable as written.</td> <td><code>DesignSystem/Components.swift:243</code>, <code>255</code></td> </tr> <tr> <td>26</td> <td>The UI tests (nine methods, added on 2026-11-21 while this report was being written) use about forty identifiers and assert a few labels and values (for example "Play deck B" / "Pause deck B", <code>sync-B</code> value "on", effect power "on" / "off"). They do not check the other labels, any keyboard path or VoiceOver behaviour, and no run of them is recorded here.</td> <td><code>UITests/ORIXDJUITests.swift</code></td> </tr> <tr> <td>27</td> <td>Section shortcuts on hidden buttons are not in the menu bar. Command-R and Command-period are declared both in the Automation menu and on hidden buttons in the Automation Studio, and Command-period again in Claude Studio; which handler wins in each context was not tested.</td> <td><code>App/ORIXDJApp.swift:87</code>; <code>Features/AutomationStudio/AutomationStudioView.swift:79</code>; <code>Features/ClaudeStudio/ClaudeStudioView.swift:264</code></td> </tr> </tbody> </table> <h2 id="12-not-verified" tabindex="-1"><a class="heading-anchor" href="#12-not-verified" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 12. Not verified</h2> <p>Stated explicitly so that this report is not read as more than it is:</p> <ul> <li><strong>No VoiceOver walkthrough by a person.</strong> Nobody has navigated ORIX DJ with VoiceOver. Reading order, the grouping produced by the containers, what is actually spoken for each element, the behaviour of adjustable actions, and whether fast-changing values are usable are all unverified.</li> <li><strong>No Accessibility Inspector audit.</strong> None was run for this report and none is claimed. No automated audit (<code>performAccessibilityAudit</code> or similar) exists in the tests.</li> <li><strong>No testing with assistive hardware or software</strong>: no Switch Control, Voice Control, Full Keyboard Access walkthrough, braille display, screen magnifier or alternative pointer was used.</li> <li><strong>Keyboard paths were read, not exercised.</strong> Tab order, whether focus reaches <code>Knob</code> and <code>Fader</code>, shortcut conflicts and the behaviour of the hidden shortcut buttons were not tried in a running build.</li> <li><strong>Contrast is computed, not measured.</strong> Ratios come from token hex values. Rendered pixels (anti-aliasing of 8 to 10 pt text, opacity blends such as <code>tint.opacity(0.55)</code>, the Metal waveform shader output) were not sampled.</li> <li><strong>Colour-vision claims were not simulated.</strong> The colour-blind-safe palette was not checked with a deficiency simulator.</li> <li><strong>No user with a disability has evaluated the application.</strong></li> <li><strong>Localisation was not run.</strong> <code>Scripts/localize.py</code> was read, not executed; no French build exists.</li> <li><strong>MIDI hardware.</strong> No MIDI controller was attached during development (see the project environment notes), so MIDI Learn as an alternative input path was exercised only with virtual endpoints.</li> <li><strong>The code was changing.</strong> Views in <code>App/Sources/Features</code> were being edited on the day of the review; anything added or removed after the reading is not reflected.</li> </ul> <h2 id="13-suggested-order-of-work" tabindex="-1"><a class="heading-anchor" href="#13-suggested-order-of-work" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> 13. Suggested order of work</h2> <p>This is a recommendation derived from the gaps, not a plan that has been agreed.</p> <ol> <li>Give every pointer-only action a command: breakpoint toggle and fold in the editor (gap 1), set cue and clear hot cue (gaps 2, 3), fader reset (gap 4).</li> <li>Post an announcement when a notice is shown, at least for errors (gap 10).</li> <li>Make the three literals appearance-aware and choose a text colour for lit controls per appearance (gaps 17, 18).</li> <li>Honour Reduce Motion in the scrolling waveform, for example by redrawing at a low rate or showing a static window that pages (gap 20).</li> <li>Do a VoiceOver walkthrough and an Accessibility Inspector audit of each section, then turn the findings into UI tests using the identifiers that already exist (gap 26).</li> <li>Create the string catalog and the French-Canadian translation file, or remove <code>fr-CA</code> from <code>Info.plist</code> until they exist (gap 24).</li> </ol>