# V1-2.6 U1 corrections after the owner's first trial Status: PROPOSAL, 2026-11-09. Owner brief « V1-2.6 UX — Arbitrages du premier essai propriétaire » (2026-11-09), answering the trial diagnosis of the same day. Design, documentation and plan only: nothing here authorises code. Lot R0 (boards) is delivered in `docs/design/v1-2-6-r0/` and awaits the owner's graphic validation; R1 to R4 start only on their own explicit authorisation. Contract: `.claude/tasks/contracts/2026-11-09-v1-2-6-trial-arbitrations.md`. Companion: `TRIAL_STACK.md` (the dedicated manual trial stack, request §5). ## 1. Owner decisions (2026-11-09) | # | Decision | |---|---| | D1 | A fifth main tab « Références » between Constats and Vérification becomes the main access to the reference library. The header « Références » button is removed. | | D2 | A contextual panel stays, opened from a finding's detail, filtered on its citations, with « Tout afficher » leading to the tab. About 34 rem wide within the available space, a lateral slide of 150 to 200 ms, `prefers-reduced-motion` honoured. | | D3 | The tab shows collapsible tiles: closed = short citation, type, citation count; open = full information, DOI, URL, actions. Instant search with a clear button. Sort by document order (default), A to Z, citation count or type. Sorting never changes the document; reorder commands only while document order is shown. | | D4 | Kept: unsaved changes, focus, « Aller à », permissions, read-only mode, accessibility tests. Below 640 px, Références goes in the « Plus » menu. Boards validated before any UI code. | | D5 | History reads « Défaire » / « Refaire » instead of « Annuler » / « Rétablir », with explicit accessible names, the keyboard shortcuts kept and the distinction from dialog « Annuler » buttons kept. | | D6 | A « Désélectionner » button near « Supprimer ». Escape deselects when no dialog, priority panel, menu or tracing in progress consumes it. Deselecting is interface state: no document change, no history entry. A click on an empty part of the drawing is left to U2 (superseded by D6b). | | D6b | Owner, 2026-11-12, after the U1 manual test on the trial stack: a click or a tap on the drawing anywhere but on an annotation deselects (a bone or any non-interactive SVG shape, an empty part of the drawing); a click on an annotation still selects it; a drag, a pan, a zoom or a touch navigation gesture never deselects; with nothing selected a click changes nothing; same behaviour with a mouse and on a touch screen. Joins R1, beside « Désélectionner » and Escape. | | D7 | Sheet list: instant search with clear, sort by last modification (default) or name, the last-modification date visible, better Administration home cards. No section built on UUIDs, names, slugs or test conventions; generic for every species; no artificial test filter. | | D8 | A dedicated, persistent manual trial stack, separate from the automated sandbox: technical plan only, nothing created, reset or deleted now (`TRIAL_STACK.md`). | | D9 | Three separate test anomalies tracked apart from U1 and U2: A fictitious fingerprints, B working copy never archived by `sheets-admin.sandbox.ts`, C integrity failure invisible in catalogue cards (section 5). | | D10 | Lots R0 (boards), R1 (history labels, deselect), R2 (References tab), R3 (sheet list), R4 (catalogue integrity warning, independent fix). Any SQL schema or Rust core change needs its own checkpoint. | ## 2. What these decisions supersede | Earlier validated item | Where | New state | |---|---|---| | U1 AC1: « no … « Références » … tab remains » | U1 contract `.claude/tasks/contracts/2026-11-06-v1-2-6-ux-u1-1123.md:373-375` | Five tabs (D1). | | U1 AC3: panel opened from the header button and from a finding; focus back to the opener, else the header button | same contract :381-389 | Opened from a finding only; focus back to the finding's « n référence(s) » button. Scrim, `inert` tab panels, Escape / ✕ / scrim close and read-only behaviour unchanged. | | U1 AC4 and T15 (history part): visible « Annuler » / « Rétablir », name « Annuler la dernière modification » | contract :390-397, `V1-2-6_UX_DECISIONS.md:309-322` | « Défaire » / « Refaire » (D5). T15's form wording (« Abandonner », « Abandonner les modifications ») unchanged. | | U1 AC10: no horizontal scroll with the references panel open | contract :420-421 | Kept, re-checked with the 34 rem panel. | | U1 AC12, AC13: « Aller à » a reference opens the side panel | contract :425-431 | « Aller à » a reference opens the Références tab, the tile open and focused. | | U1 AC17: panel tests « open from header and finding »; keyboard order with the panel | contract :439-446 | Tests rewritten for the tab and the finding-only panel; the panel keeps its place in the keyboard order when open. | | Checkpoint choice 5: Général and Constats under « Plus » below 640 px | `V1-2-6_UX_U1_CHECKPOINT.md:24` | Général, Constats and Références under « Plus ». | | Checkpoint choice 10: search on citation, DOI and URL; ↑/↓ only on the unfiltered list | same file :29 | Carried to the tab: same search fields; reorder only in document order and without an active search. | | Checkpoint choice 15: « Références » announced as a panel | same file :34 | Announced as a tab, like the four others. | | Board 11 (references side panel as the main access) | `docs/design/v1-2-6/11-constats-references-desktop.png` | Replaced by boards 23 to 27 once validated. | | BDR-099 item 5 (collapsible references rejected) | memory | Not contradicted: it concerned the catalogue page on a phone (`docs/design/README.md`, accepted deviation 2), not the editor. | | U2b F5 (filter panel in the references panel's slot) | `V1-2-6_UX_FINDINGS_NAV.md:104-126` | Unaffected: the panel slot stays, used by the contextual references panel now and by the filter panel in U2b. | ## 3. Lots Every lot: one commit or more per coherent change, pushed; gates in this order: `pnpm typecheck`, `pnpm lint`, `pnpm test:run`, `pnpm build`, `pnpm e2e:ui`, then the shell suite on the sandbox as it stands, with its exact result (the four `admin.spec.ts:717` failures of the taken working-copy slot, anomaly B, are fixed: row B of section 5). Every removed or rewritten assertion is mapped to its replacement in the commit message (R-24). Design gates: the boards of R0 as validated, `impeccable detect` on the changed components, a fresh design review before the lot closes. ### R0 — Boards and owner validation (this delivery) Boards 23 to 30 in `docs/design/v1-2-6-r0/` (sources, data generated from the equine draft, `REVUE.md`). Exit: the owner validates each board, or asks for corrections; the validated boards then join `docs/design/README.md` as the reference of R1 to R4. ### R1 — History labels and deselection (D5, D6, D6b) Delivered 2026-11-12 on `feature/v1-2-anatomical-sheets`: `7dda61d` (D5 labels), `bbb1668` (« Désélectionner » and Escape), `bbdfd27` + `a1ee194` (D6b), `ab823f4` + `2327d61` + `0849e54` (browser specs), `0d1edac` (design review fix: 44 px touch target below xl, 6 px icon gap), review fixes `132756e`, `6ed90ef`, `9807ed2`. Final gates on `a180b9e` (the source at HEAD differs only by the comment of `6ef5223`): typecheck, lint, build ok; unit tests app 1381, supabase 180, core-wasm 66; `e2e:ui` 227 passed; `e2e:shell` full suite on the sandbox 197 passed, 4 failed, 99 skipped. Status (owner, 2026-11-12): accepted technically on the report; the owner's manual validation on db:trial is still to do. Decision record BDR-113 (R1 editor only), learnings LRN-128 to LRN-130. The 4 failures are the `admin.spec.ts:717` timeouts (anomaly B, the taken working-copy slot), the same as in the 188 / 90 / 4 baseline; every new R1 test passed. Follow-up `927537b` (owner brief « V1-2.6 — R1 — Dernier retour utilisateur », 2026-11-12): the « Sélection : … » tag is screen-reader-only (`sr-only`, not a live region) in the editor and the read-only twin, so the drawing no longer moves when the selection changes; board `04` (and board `26` of `v1-2-6-r0/`) deviation recorded in `docs/design/README.md`; one unit test and two layout-stability specs in `editor-deselect.spec.ts` (desktop, read-only twin at 375 px). Gates on that commit: typecheck, lint, `pnpm test:run` (app 120 files, 1382 tests) green; `e2e:shell` on `db:sandbox`, six editor specs (deselect, equine, access, annotations, geometry, journey): 37 passed, 37 skipped (other viewport), 0 failed. Final status (owner, 2026-11-12, brief « Validation finale R1, correctif E2E et GO R2 »): R1 VALIDATED FUNCTIONALLY. The ten manual R1 checks on db:trial passed, and the owner confirmed in the browser that the drawing no longer moves on selection and deselection; `927537b` and `00936c8` accepted. Limits kept: the ToolNotes hint above the canvas still moves the drawing one line when it is cleared by a selection, the selection itself is not announced to screen readers, iOS Safari is not validated, and the graphic gaps listed under « Behaviour and limits » and the TODO R1 follow-ups. The criteria below are the contract as written. - Labels: `editor.history.*` keys in `apps/app/src/i18n/fr.ts` and `en.ts` (FR « Défaire » / « Refaire », names « Défaire la dernière modification » and « Refaire la dernière modification défaite »; EN « Undo » / « Redo » unchanged); `HistoryButtons.tsx` keeps its structure. Shortcuts unchanged: Ctrl/⌘+Z undo, Ctrl/⌘+Maj+Z redo (`apps/app/src/editor/useUndoShortcuts.ts:19-23`). Every prose string that names the history « Annuler » is reworded; dialog « Annuler » buttons untouched. - « Désélectionner »: a secondary button beside « Supprimer » (`PropertiesPanel.tsx:257-284`), shown while an annotation is selected, in read-only modes too (selection is interface state); it dispatches the existing « no selection » path that « Toutes les annotations » uses (`PropertiesPanel.tsx:93-108`). - Escape: today a tracing consumes it when the canvas box has focus (`usePlacement.ts:82`), the references panel when not already handled (`ReferencesPanel.tsx:234`), dialogs natively (`ModalDialog.tsx:111`). One handler on the workspace, at the bubbling phase, deselects only when `event.defaultPrevented` is false, no dialog is open, no menu is open and no tracing runs; each consumer marks the key handled. The « Plus » menu's own Escape path is checked first (it has no explicit handler today). - Click on the drawing (D6b). Today, with the select tool, `clickHandler` in `apps/app/src/editor/annotations/useCanvasGestures.ts:57-68` calls `onSelect` only when the target has a `[data-anno-id]` ancestor (`annotationIdOf`, `useCanvasBuild.ts:91-94`) and ignores every other click: that is the defect. Change: the other branch calls a new `onDeselect` input; `EditableAnnotations.tsx` (`CanvasStage`) wires it to the same deselect path as the button, and only when an annotation is selected (nothing selected: no dispatch, so a pending keyboard creation, its typed fields and the « Filtrer par nom » term stay). The read-only twin (`AnnotationsTab.tsx:187`) draws through `CatalogueCanvas`, whose click listener (`CatalogueCanvas.tsx:99-104`) gets an optional `onEmpty` with the same rule; the catalogue reader page (`SheetRoute.tsx:150`) passes none and is unchanged. - Interactive means any `[data-anno-id]` element of the composed view: a point (hitbox and disc), a zone (filled, `pointer-events` all, `docs/ANNOTATION-RENDERING.md`), a detail link. A click inside a zone selects that zone, as today. Everything else in the canvas box deselects: a shape of the drawing (bone, outline, any path, rect, circle or group), the drawing's background, the box margin around the drawing. - Drawing tools (point, zone, link) and a tracing: unchanged, a click places or adds a vertex. - Gestures: the existing `swallowClick` of `useFraming` (a press that moved more than 4 CSS px: pan, marker drag, pinch) already keeps the click from acting; in addition a press during which a second pointer came down (a two-finger tap or a pinch that moved less than 4 px) never deselects, tracked in the canvas hooks so that `useFraming`, shared with the catalogue reader, is unchanged. The wheel, Ctrl+wheel, the keyboard pan and zoom, the zoom buttons and a touch scroll of the page (it ends in `pointercancel`) produce no click on the drawing. - Effect: the selection and its contextual panel are reset (the overview comes back); document text, handle version, history length and the save line unchanged; no save, no history entry. A field typed in the panel and not blurred is committed by its own blur before the click, exactly as with « Toutes les annotations » today. - Focus and announcement: the click leaves the focus on the drawing box it landed on (no jump to the list row, which stays the rule of the « Désélectionner » button, A6); the same polite announcement as the button. - Unit tests for D6b (`apps/app/tests/unit/editor-annotations-tab.test.tsx`, happy-dom; the test drawing has an inner ``): with a selection, a click on the drawing's inner ``, on its root `` and on the box margin each deselect, document text, handle version and history length unchanged; a click on another marker selects it, on the selected one keeps it; nothing selected, a click on the `` changes nothing and a pending keyboard creation keeps its typed name; a press moved more than 4 px on the `` (pan), a marker drag and a press with a second pointer keep the selection; undo after a click deselect undoes the previous edit; the focus stays on the box and the announcement is made; the read-only twin deselects on the ``; `CatalogueCanvas` without `onEmpty` keeps today's behaviour. - Unit tests: deselect leaves the document text and the history length unchanged; undo after a deselect undoes the previous edit; the Escape matrix (dialog, menu, panel, tracing, nothing open) with one consumer each time; focus after « Désélectionner »: the annotation's list row if it still exists, else the drawing, with no new selection and a polite announcement (A6 as ratified); accessible names of both history buttons in FR and EN; read-only modes show « Désélectionner » and no « Supprimer ». - E2E: the journeys that name « Annuler » / « Rétablir » rewritten one for one; a new desktop spec for the button and Escape; axe on Annotations with a selection. For D6b, in that spec (Chromium, `pnpm e2e:shell` against `pnpm db:sandbox`, never the trial stack): real clicks on the inner `` and `` of the drawing written by `e2e/support/editor.ts:78-80`, on the drawing's background and on the box margin, then on another marker; a drag pan on the zoomed drawing and a marker drag keeping the selection; a touch context (`hasTouch`, as in `editor-geometry.spec.ts:419`) where a tap deselects and a touch drag does not. `editor-equine.spec.ts`: one click on a bone path of the historical horse drawing of the working copy deselects. #### Behaviour and limits (as built) - Owner decisions at the gates. G1: Escape moves the focus only when it was inside the properties panel (to the annotation's list row if it still exists, else to the drawing); from anywhere else the focus stays where it was. G2: the « Supprimer » button style is unchanged. - D6b in plain terms: the rule follows the press, not the click target. A press that begins outside every `[data-anno-id]` element and ends as a click deselects. A press that began on an annotation never deselects, even if it ends elsewhere. A drag, a pan, a zoom, a pinch or a press that gained a second finger never deselects. - Escape from outside the editor workspace (sidebar, application header) does nothing. - Escape with the focus on the page (`body`) respects the layers above: an open modal dialog (delete, phone drawer) keeps the selection, and while the references panel is open Escape closes the panel first and keeps the selection. In « Plus », Escape typed in a text field or outside the workspace is left alone. - A pen tap follows the touch rule: the decision is taken in the tap's own click, and only when that click's target is not an annotation; only the mouse acts at the pointer-up. A hover move after a press is not part of it, and a new press by the same pointer outside the box cancels a stale one. - The read-only twin keeps its keyboard pan and zoom (arrows, +, -, 0) when it deselects. - A value refused as « non appliqué » in the properties panel is lost when the panel closes, as with « Toutes les annotations ». - « Toutes les annotations » keeps its focus behaviour: when its row is filtered out, the focus falls to the page. - The vertex handles of a selected polygon are display-only: a press on the part of a handle outside the zone's fill deselects. - A touch tap whose click Chromium drops does not deselect; a second tap does. This is rare: a field blur commit rebuilds the drawing between the synthesized mousedown and the click. - Chromium touch adjustment can turn a tap about 6 px outside a marker into a selection of that marker (no deselect announcement then). - Proof of the touch guards: Chromium only, through CDP touch with a capture-phase event recorder (identical over three runs, `.superpowers/sdd/2026-11-12-r1-history-deselect-1141/task-5a-report.md`). A tap on empty: 1 pointerdown, 1 pointerup, 0 pointercancel, 1 click, deselect. A one-finger drag on a movable point: 0 click. A two-finger tap and a pinch: 1 non-primary pointerdown, 2 pointerup, 0 click, selection kept. A one-finger drag on the read-only twin: 1 pointercancel (the browser pan took the touch), 0 click. iOS Safari is unverified: a manual check is listed in the TODO, it is not a proof. - The « Sélection : … » tag is not shown (screen-reader-only text, not live): the highlight and the properties panel carry the selection, and the drawing keeps its place when the selection changes (owner, 2026-11-12). ### R2 — The Références tab (D1 to D4) - Tab model: `EDITOR_TABS` gains `references` between `findings` and `verification` (`apps/app/src/editor/tabs.ts:6-11`), `SHOWN.small` keeps it under « Plus » (:18). The id collides with the panel's `data-place` name `references`: the panel place is renamed first (internal name, no visible effect). Touched with it: `navigation.ts` `targetOfKey` (:65-81, reference keys go to the tab), `focusRequest.ts:19-22`, `useEditorNavigation.ts`, `EditorTabBody.tsx:16-23`, `EditorWorkspace.tsx:85-131`, `verification.ts`, i18n keys. - Tab content: tiles built from `ReferenceRow` / `ReferenceForm` (`components/editor/references/`), a disclosure button per tile (`aria-expanded`, `aria-controls`), the toolbar with a search field and its explicit clear button (focus back to the field), a native `