SPB Git

Repository Public License

accessibility.md 5.5 KB 104 lines markdown

1<!--2ORIX Monitor3File: docs/reports/accessibility.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->78# Accessibility report910State on 2026-11-21, ORIX Monitor 1.0.0 (build 1). This report separates what was **built**, what was **checked by11machine**, and what **nobody has checked**.1213## What is built1415| Area | Implementation |16|---|---|17| VoiceOver labels | Rows combine label and value; page headers carry the header trait with the subtitle as value; icon-only buttons have labels |18| Charts | `LiveChart` and `HistoryChart` replace the drawing by a text summary: latest value, minimum and maximum per series, number of gaps |19| Per-core displays | Each core is an element with "Core n" and its percentage; the heatmap reads the busiest core |20| Colour independence | Severity, memory pressure, thermal state and data quality always carry a word and a symbol; decorative meters and swatches are hidden from assistive technology |21| Contrast | Text colour tokens reach at least 4.5:1 against canvas, surface and raised surface in both appearances (computed, table below) |22| Colour-vision deficiency | Optional Okabe–Ito based metric palette |23| Reduce Motion | Readout and dashboard animations are disabled when the system setting is on; live charts never animate |24| Keyboard | Standard focus navigation; shortcuts for pause, bookmark, refresh insights, new dashboard window |25| Density | Compact, regular, comfortable (padding and spacing only) |2627### Text contrast (computed, WCAG 2 relative luminance)2829Minimum ratio of each text colour over the three backgrounds it is used on.3031| Token | Light | Dark |32|---|---|---|33| `textPrimary` | 16.3 | 14.3 |34| `textSecondary` | 5.5 | 6.8 |35| `textTertiary` | 5.1 | 5.0 |36| `success` | 5.1 | 8.2 |37| `warning` | 5.5 | 9.4 |38| `danger` | 5.1 | 5.7 |39| `accent` | 5.1 | 8.7 |4041Before this review the light values of `textTertiary`, `success`, `warning` and `accent` were between 3.2 and 4.1; they were42darkened and the app rebuilt and re-notarized. Metric palette colours are used for chart marks and icons, where the43applicable threshold is 3:1; the lowest of them is 3.2 (network, light, on the raised surface).4445## What a machine checked4647Apple's `performAccessibilityAudit` was run by `testAccessibilityAuditOfEveryPage` on twelve pages of the Debug build, in48Dark Mode, one fresh instance per page. Audit types: contrast, element detection, hit region, sufficient element49description, parent/child. The raw output is [`accessibility-audit.tsv`](accessibility-audit.tsv).5051| Page | Contrast failed | Contrast nearly passed | Parent/Child mismatch | Unknown role | Element has no description | Total |52|---|---|---|---|---|---|---|53| overview | 12 | 0 | 5 | 6 | 5 | 28 |54| cpu | 12 | 0 | 13 | 24 | 6 | 55 |55| gpu | 14 | 0 | 15 | 15 | 6 | 50 |56| memory | 11 | 0 | 23 | 15 | 5 | 54 |57| disk | 12 | 0 | 4 | 3 | 5 | 24 |58| network | 11 | 0 | 13 | 11 | 5 | 40 |59| power | 11 | 0 | 18 | 16 | 5 | 50 |60| thermal | 10 | 1 | 34 | 5 | 6 | 56 |61| history | 11 | 0 | 1 | 2 | 5 | 19 |62| insights | 11 | 0 | 1 | 1 | 5 | 18 |63| alerts | 11 | 2 | 8 | 1 | 5 | 27 |64| reports | 12 | 0 | 1 | 1 | 5 | 19 |65| **All** | **138** | **3** | **136** | **100** | **63** | **440** |6667The audit reported **no hit-region issue** on any page.6869### Reading of the results7071These are notes from an automated tool, not confirmed defects, and they have **not** been resolved. What can be said about72each group:7374- **Contrast failed (138).** The audit gives no element for any of these notes, so they could not be75  traced. The run was in Dark Mode, where every text token computes to 5.0:1 or better, so the notes are probably about76  something else: text drawn over chart areas and gradients, axis labels, system-drawn sidebar and toolbar text on the77  translucent window material, or disabled controls. That is a guess. The count did not fall after the light-mode colour78  fix, which is consistent with the run being in Dark Mode and says nothing about Light Mode, which was not audited.79- **Parent/Child mismatch (136).** Typical of SwiftUI containers whose accessibility children are80  re-parented (grids, cards, chart overlays). Not investigated individually.81- **Unknown role (100).** Mostly the combined label-and-value rows (`KeyValueRow`) and chart summaries:82  they have a label and a value but no control role, which is intended for static read-outs. Some have an empty label and83  were not identified.84- **Element has no description (63).** No element is named by the audit. Candidates are85  `Canvas` drawings and layout containers that should be hidden from assistive technology and are not.8687## What nobody has checked8889- **No person has used the app with VoiceOver.** Reading order, verbosity and whether the chart summaries are actually90  useful are unverified.91- **Light Mode** was not audited by the tool.92- **Full Keyboard Access** and Switch Control were not tried.93- **Increase Contrast** and **Reduce Transparency** system settings were not tried; the app has no specific handling for them.94- **Text size**: macOS has no Dynamic Type; text does not scale beyond what the density setting does to spacing.95- **The colour-blind-safe palette** was chosen from published values and not verified with a simulator or by an affected user.96- The French interface was not audited.9798## Next steps991001. A VoiceOver pass by a person, page by page.1012. Hide `Canvas` drawings and pure layout containers from assistive technology, then rerun the audit to see which notes remain.1023. Audit Light Mode.1034. Decide whether static rows should expose the static-text role explicitly.104
Files main
Menu

Theme