Files
faunosteo/.claude/tasks/plans/2026-11-06-v1-2-6-ux-u1.md
bchanot 2e46c14697 chore(docs): V1-2.6 UX U1 contract and challenged plan
Owner approach A and four choices recorded as gated clarifications.
Plan lots A to I after three blind challengers and one confirmation
pass; no application code, no DEV.
2026-11-06 12:37:04 +01:00

686 lines
57 KiB
Markdown

# Plan: V1-2.6 UX U1, editor shell (four tabs, sections, references panel, header history)
> For agentic workers: executed lot by lot under `subagent-driven-development` (ship-feature STEP 4); each lot is
> one coherent change, committed and pushed by the orchestrator after its own checks.
Status: REVISED after the three-lens challenge (2026-11-06, record at the end), for the owner's plan checkpoint. No
application code is written before the owner approves this plan (brief « U1 — Validation de la conception
interne »).
- Goal: replace the seven-tab level-1 shell of the draft editor by the four-tab shell of the validated v1-2-6
boards, with approach A (owner, 2026-11-06): the level-1 editors of views, categories and vertebral regions open in
full-width sections of Annotations with « Retour au dessin », References in a side panel, history in the header.
- Architecture: a pure navigation model (tab, Annotations section, references panel, focus request) held by the
editor workspace; every visited place stays mounted and is hidden with the `hidden` attribute, so no switch loses
state and no effect re-runs on a switch; the unsaved count is derived from the history the store already holds; the
store gains one display field (`lastSave`, the server's save time).
- Stack: React 19.2.6, Zustand 5, Tailwind 4 (`lg` 64rem, `xl` 80rem; preflight hides `[hidden]` with `!important`),
vitest + happy-dom, Playwright 1.64.1 + axe on the throwaway sandbox.
- Spec: contract `.claude/tasks/contracts/2026-11-06-v1-2-6-ux-u1-1123.md` (AC1-AC20, CLARIFICATIONS
[gated 2026-11-06]); `docs/development/V1-2-6_UX_PLAN.md` §3 U1 and §2 G; `docs/development/V1-2-6_UX_TESTS.md`
U1; `docs/development/V1-2-6_UX_DECISIONS.md` (T11, T15, T17, « Points from the boards for U1 and later »); level-1
contract `.claude/tasks/contracts/2026-11-03-v1-2-6-editor-1509.md` (header precedence rule, C3, C4, C5, C6, C11,
C13, C14, C16, C27, C28, C32, C34, C36, C38, C40, C41, C44, C47 as amended); boards `docs/design/v1-2-6` 01, 11,
12 A, 13 (source `maquettes.html`: `hist()` :287, `save()` :292, `overviewPanel()` :325, board 11 :615-628); board
05 of v1-2-4 for the narrow read-only mode.
- Reading list for every executor: the contract, this plan, the files named in its lot, `.claude/rules/i18n.md`,
`.claude/rules/stores.md`.
- Format: the project's lot format (precedent `.claude/tasks/plans/2026-11-03-v1-2-6-editor.md`): every choice is
closed here, executors write the code and the tests named per lot.
## Global constraints
- Worktree `/home/bchanot/Documents/faunosteo-v1-2`, branch `feature/v1-2-anatomical-sheets`, base 846994b; every
shell command starts with `cd /home/bchanot/Documents/faunosteo-v1-2 &&` (LRN-110). Commit in place, push each
commit, no sub-branch, no merge, no `gitflow.sh finish` (T13).
- Never DEV: no `pnpm db:start`, `db:reset`, `db:test`, `db:types`, `pnpm supabase …`, `e2e:avatar`,
`e2e:sheet-assets`; database work only through `pnpm db:sandbox …` (containers `faunosteo_dbsandbox_*`).
- The sandbox is shared with the level-1 owner trial stack: Lot B1 runs `pnpm db:sandbox up fresh`, which wipes the
trial accounts and data (`scripts/db-sandbox.sh:47-60`). Approving this plan authorises that wipe; no other
checkout runs the sandbox during U1.
- No change under `crates/`, `supabase/`, `scripts/`, `packages/core-wasm/src/`, `packages/supabase/src/`,
`docs/design/v1-2-6/` (AC19 CHECK); `faunosteo-v1-2-6-revue-ux-chatgpt.md` never staged.
- No U2-U6 operation (no handle, slider, rectangle, remap, role, opacity, own-colour revert, category fold, view
menu), no V1-2.7 control (no « Prévisualiser », no withdrawal), no existing function removed (owner precision 7).
- Store rules unchanged: `undoStep()` / `redoStep()`, `HISTORY_LIMIT_BYTES` 8 388 608, one commit per change on
blur, confirm or pointer-up (BDR-050), the save request, the recovery copy (C13, C27, C28), conflicts (C12, C29),
mode precedence (C38). Store addition: `lastSave` only (Lot E); the count is a selector.
- Every string through `useT`, FR/EN key parity (AC20), counts through `usePlural` (`editor/plural.ts`, C36); new
labels are proposals (C44) listed in `.claude/audits/2026-11-06-v1-2-6-u1-label-proposals.md`. Prose naming a
place is reworded in the lot that moves that place.
- Focus moves only through the navigation hook or a one-shot focus request; no kept-mounted component focuses or
scrolls in a mount effect.
- Our code: functions at most 25 logic lines, 5 params, 5 locals, 100 columns in TypeScript (project exception).
`DraftEditor`, `DraftHeader`, `EditorTabs`, `FindingsTab` and `AppLayout` already exceed 25 lines: each one this
plan touches is split along the lines below, never grown.
- Browser suites stay green at every lot: each lot from B1 rewrites the e2e assertions its change breaks (mapped in
its commit message, R-24) and runs every `apps/app/e2e/shell/editor-*.spec.ts` on the sandbox started in Lot B1
(`pnpm db:sandbox e2e-shell <spec>` per spec); a spec that breaks and is not in the lot's list is added to the
lot, never skipped. The full suites run in Lot H and in the gate order of Lot I on a new fresh sandbox.
- Queries: tests never query labels or text page-wide; they scope to the visible place (`data-place` hook, below)
or use role queries, which ignore hidden content.
## Review focus (failure modes no single lot owns; each pinned by a test in the named lot)
1. A hidden place answers instead of the visible one: a focus request consumed by a hidden body, a label or text
locator matching a hidden copy (« Nom (FR) » labels the sheet, a region and an annotation), a static `id`
repeated. Pinned in Lot B2 (requests routed to their owner, unique ids once every place is visited, Chromium spec
of the keep-alive and focus rules) and every lot's e2e scoping.
2. Undo from another place removes what a kept place still shows: the canvas's current view (with a pending
creation or a tracing on it), the selected annotation, the finding the references filter names. Pinned in Lot B1
(full canvas reset to the main view) and Lot D (filter falls back to « Tout afficher »).
3. The save line says something false: a count after undoing past the save point, after a trim by a commit, an undo
or a redo, after a restored copy, after commits or undos during a save; a time from another revision or an old
save. Pinned in Lot E (`savedDistance` table, including the sequences the challengers found; `saveLineState`
table; `readSaveTime` drops late answers and is skipped on `draft.unchanged`).
4. A width change across 1 024 px with a section or the panel open: every place turns read-only in place, unsaved
document changes kept, edit mode back on widening, no crash. Creation forms (canvas pending creation and every
`!readOnly` form) unmount as today: documented limit, section 2. Pinned in Lot H.
5. The references panel over the header: Enregistrer, Annuler and Rétablir must stay clickable with the panel open.
Pinned in Lot D (Chromium check at 1 024 and 1 280 px).
---
## Architecture (closed decisions)
### 1. Navigation model (owner precisions 1, 2, 10)
- New pure module `apps/app/src/editor/navigation.ts`:
- `ANNOTATION_SECTIONS = ['drawing', 'views', 'categories', 'regions'] as const`, `AnnotationSection`.
- `EditorTarget = { place: 'tab'; tab: EditorTabId; section: AnnotationSection | null; key: ElementKey | null }
| { place: 'references'; key: ElementKey | null; citedBy: ElementKey | null }`. One encoding: a target on
Annotations always names its section (`'drawing'` for the canvas); `section` is null on the other tabs.
- `targetOfKey(key: ElementKey): EditorTarget`: `sheet` → general; `zone`, `finding` → findings; `annotation` →
annotations/drawing; `view` → annotations/views; `category` → annotations/categories; `region` →
annotations/regions; `reference` → references (citedBy null). The only place a key meets a place.
- `FocusRequest = { target: EditorTarget; serial: number }` is defined here (Lot A) and re-exported by
`editor/focusRequest.ts` from Lot B1.
- `NavigationState = { tab; section; references: { open: boolean; citedBy: ElementKey | null }; visitedTabs:
readonly EditorTabId[]; visitedSections: readonly AnnotationSection[]; referencesMounted: boolean; focus:
FocusRequest | undefined }`; `initialNavigation(tab)`.
- `navigationReducer(state, action)`, actions `select_tab` (manual; keeps the Annotations section; no focus
request), `open_section`, `back_to_drawing`, `open_references` (citedBy) and `close_references` (both keep tab and
section: the panel opens over whatever is shown), `go_to` (target: sets tab, section or panel; `focus = { target,
serial: previous + 1 }`), `focus_consumed` (serial). Visited lists grow, never shrink.
- `useFocusRequest(focus, apply: (target) => 'found' | 'kept' | 'none')` reports `consumed(serial, outcome)`
through `FocusConsumedContext` (`kept`: the place kept a creation or tracing in progress instead of jumping,
section 4); `useRowFocus` returns `found` or `none`. A request is passed only to the body,
section or panel its target names; `FindingsTab`'s `focusId` becomes one-shot (cleared once applied,
`findings/FindingTree.tsx:31-33`, `tabs/FindingsTab.tsx:47,73,90`), so a later visit never re-focuses the tree and a
second « Aller à » to the same finding focuses it again.
- New hook `apps/app/src/editor/useEditorNavigation.ts`, called in the new `EditorWorkspace` (rendered only once the
version is ready, so `initialTab(previewState, tier)` is known at mount: lazy `useReducer` initialiser, no
render-phase `setTab`, no reset action; reloads keep `status: 'ready'`, `editorLoad.ts:136-152`). It owns the DOM
side:
- stable callbacks (`useCallback` over `dispatch`): `navigate(target, opener?)`, `selectTab(tab)`,
`openSection(section, opener)`, `backToDrawing()`, `openReferences(citedBy, opener)`, `closeReferences()`;
- before every move (tab click or key, « Plus » item, section entry, « Retour au dessin », panel open, panel close
by ✕, Escape or scrim, « Aller à », hint link), `commitFocusedField()` (new in `editor/focusRequest.ts`): when
`document.activeElement` is an `input`, `textarea` or `select` inside the editor, `blur()` it, so its
`TextField` commits on blur (`TextField.tsx:75-79`) before the place is hidden. Today an unmount commits that
text (`TextField.tsx:61-68`); kept-mounted places never unmount, and Safari and iPadOS do not move focus to a
tapped button, so the blur is forced rather than assumed (confirmation challenge);
- openers kept in a ref (`section`, `references`), never in state;
- after each programmatic move, in an effect keyed on the move: focus the request's element, else the section
heading, the panel heading, the active tab button `#editor-tab-<id>`, or « Plus » when the active tab sits in
the closed « Plus » list (< 640 px); never `body`;
- one polite live region text `{ text, serial }` on programmatic moves only (go to, hint links, section open and
back, panel open and close): « Annotations · Vues », « Références »; rendered as `<p aria-live="polite"
className="sr-only">`, distinct from the save status (AC12); a repeated text alternates a trailing no-break
space.
- `EditorTabProps` becomes `EditorPlaceProps = { readOnly: boolean; navigate: (target: EditorTarget, opener?:
HTMLElement | null) => void; focus?: FocusRequest; reloadSheet: () => void }`. The route computes `readOnly` once
and passes `!readOnly` to `useUndoShortcuts` and to the history buttons (no third spelling of the predicate).
### 2. Kept-mounted places (precision 1: no silent loss on a tab, section or panel change)
- Each visited tab panel, each visited Annotations section and the references panel once opened stay mounted inside
a plain wrapper `<div data-place="…" hidden={!visible}>` (no display class on the wrapper; Tailwind 4 preflight
forces `display: none` on `[hidden]`). Hidden content keeps its state (canvas reducer: tool, selection, pending
creation, tracing; framing; findings selection and expansion; every `DraftField` form; an open crop group) and
leaves the accessibility tree and axe.
- Why not React 19.2 `<Activity>`: it re-runs every effect on reveal, which resets zoom and pan
(`catalogue/useFraming.ts:69`, `setFraming(FIT)` on mount) and re-focuses the findings tree
(`FindingTree.tsx:31-33`)
on each return (correctness challenge). With `hidden`, no effect runs on a switch; typed text is committed by the
forced blur of section 1 before any move.
- One composed copy of a view in the page: the core gives every composition of a view the same id scope
(`fv.<view>.`, `crates/core/src/anatomy/compose.rs:164,193`), so the edit drawing (`AnnotationCanvas`) and the
views section's `CropCanvas` (`views/CropCanvas.tsx:33`, the parent view) would repeat ids and let `url(#…)`
resolve into a hidden copy. The wrapper `KeptPlace({ name, visible, children })` provides `usePlaceVisible()`
(nested: parent and own); both canvases detach their composed tree while their place is hidden and rebuild it on
show (an effect keyed on that flag; component state, zoom and pan included, stays). The Vues card rows carry no
drawing thumbnail for the same reason (visible choice 17).
- `data-place` values: `general`, `findings`, `verification`, `annotations.drawing`, `annotations.views`,
`annotations.categories`, `annotations.regions`, `references`. The tab panels themselves are
`<div role="tabpanel" id="editor-panel-<tab>" aria-label="<tab name>">` (aria-label kept as today, so a panel whose
tab sits in the closed « Plus » list still has a name); tabs carry `aria-controls` to their own panel.
- Cost control: hidden places re-render on store changes. `editor/sheetDocument.ts` gets a single-entry module cache
keyed on the document text, so all places share one `JSON.parse` per commit; the workspace passes stable props
(memoised callbacks). Lot H records the commit-to-paint time with every place visited on the equine spec; above the
500 ms budget of the UX plan, STOP and report.
- Unique ids: grep found `finding-*`, `views-main-title`, `annotation-category`, `conflict-keep-hint`, each in one
place; a Lot B2 test visits every place and asserts no `id` repeats.
- Documented limit, unchanged from level 1: a width change across 1 024 px or a recovery decision switches between
read-only and edit rendering; the canvas's pending creation and every creation form rendered under `!readOnly`
(`CategoriesSection.tsx:51`, `ReferencesTab.tsx:44`, `ViewsTab.tsx:65`, `VertebraeTab.tsx:49`,
`FindingsTab.tsx:105`) unmount then with their typed text. Keeping them would break precision 5. No tab, section or
panel change is involved.
### 3. Four tabs and the tab row (AC1, AC8)
- `apps/app/src/editor/tabs.ts`: `EDITOR_TABS = ['general', 'annotations', 'findings', 'verification']`; tiers: wide
and medium show the four; small (< 640 px) shows Annotations and Vérification with Général and Constats under the
existing « Plus » disclosure (today's rule minus the removed tabs). `initialTab` unchanged in substance (C40 as
amended).
- `EditorTabs.tsx` split into `EditorTabs` (row), `TabList` (role `tablist`, tabs only, arrows as today) and
`MoreTabs` (small tier). The row is `flex`: tablist, « Plus », then the history buttons at the right (Lot E),
outside the tablist.
- Vérification badge: visible text « n erreur(s) » / « n error(s) » through `usePlural` (keys
`editor.tab.errors_one`, `editor.tab.errors_other`), inside the tab's accessible name; the aria-hidden number goes.
### 4. Annotations: drawing, overview panel, sections (approach A, AC2, T17)
- `components/editor/tabs/AnnotationsTab.tsx` hosts the drawing workspace and each visited section. The registry
`ANNOTATION_SECTION_BODIES: Record<Exclude<AnnotationSection, 'drawing'>, { titleKey; Body }>` in
`components/editor/annotations/sections/registry.ts` is the one place later steps edit (U3 replaces `categories`,
U4 replaces `views`, U6 adds the vertebra-role path and removes `regions` when the role exists).
- Section frame `components/editor/annotations/sections/AnnotationSection.tsx`: « Retour au dessin » first, then an
`h2` (tabIndex -1), then the body full width. Opening focuses the `h2` through the hook; « Retour au dessin » →
`backToDrawing()`, focus to the overview entry that opens this section when it is rendered, else the canvas box
(focusable today for keyboard pan), never `body`.
- Bodies reuse the level-1 editors unchanged in behaviour, moved with `git mv`: `tabs/ViewsTab.tsx` →
`annotations/sections/ViewsSection.tsx` (views, upload, cleaning, attach and repair, numeric crop editor until U4);
`general/CategoriesSection.tsx` leaves `GeneralTab` and becomes the `categories` body (level-1 editor until U3);
`tabs/VertebraeTab.tsx` → `annotations/sections/RegionsSection.tsx` (↑/↓ kept, code read-only after creation,
C5). No role check is written: before U6 no role exists, so the T17 fallback entry is always shown (a comment at the
entry cites T17 and U6).
- Overview panel `components/editor/annotations/OverviewPanel.tsx` (board 01 `overviewPanel()`), in the side column
when nothing is selected or pending, in edit and read-only modes:
- « Vues » (Lot B1): one row per view (name, « Vue principale » or « Vue détaillée », « n annotations »), each a
button selecting that view (`aria-current` on the shown one); « Gérer les vues » (read-only « Voir les vues »).
Not built: « Nouvelle », ⋮ (U4, U5).
- « Catégories » (Lot B1): one chip per category (swatch, name), the count; « Modifier les catégories »
(read-only « Voir les catégories ») and « Régions vertébrales » with the region count (T17). Not built: the fold
(U3).
- « Annotations de la vue » (Lot C, owner choice): annotations of the shown view grouped by category in document
order, « Sans catégorie » only if a document holds one, count per group, « Filtrer par nom » (case- and
accent-insensitive on the displayed name, through `folded` exported from `catalogue/useCatalogue.ts:53`), every
row a button selecting the annotation (`aria-current`), all rows shown. The list under the drawing moves here.
- `PropertiesPanel` gains « Toutes les annotations » (edit and read-only, Lot C): clears the selection, shows the
overview, focuses the deselected annotation's row.
- Counts per view, category and region come from one memoised derivation of the parsed document
(`editor/annotations/overview.ts`), no core call, no network.
- When the canvas's current view no longer exists (undo, delete in the views section), edit mode dispatches the full
reset `{ type: 'view', viewId: main }` (`initialUi` clears pending creation, tracing, selection and hint,
`editor/annotations/uiState.ts:55-64`), so a pending point is never inserted on another view
(`creationAttempt.ts:38`); the read-only body sets its `viewId` to the main view and clears its selection.
The reset is dispatched only when `ui.viewId` names a view absent from the document and the main view exists
(`view` always returns a new state, `uiState.ts:57`, so an unconditional dispatch would loop).
- « Aller à » an annotation while a creation is pending (`ui.pending`) or a tracing is open (`ui.tracing`: new zone,
link or « Remplacer par un polygone »): it is kept, Annotations shows it, `apply` answers `kept`, focus goes to the
creation panel heading (`CreationPanel.tsx:90`, tabIndex -1 added) or to the tracing bar, and the live region says
a creation or a tracing is in progress (no `view` or `select` dispatch, which would drop it,
`EditableAnnotations.tsx:60-65`, `uiState.ts:56-67`); the target can be reached again once it is finished or
abandoned.
- Retargeted links (Lot B1): `UnmeasuredHint` (`PropertiesPanel.tsx:159-175`) and `ToolNotes`
(`EditableAnnotations.tsx`) navigate to `annotations/views` with the view's key; their prose and
`no_category`/`no_child_view` are reworded in the same lot.
- Layout 1 024-1 279 px (board 13, C25 as amended, Lot C): the side column sits beside the canvas from `lg`
(`lg:grid-cols-[minmax(0,1fr)_22rem]`, `EditableAnnotations.tsx:94` and the read-only body), measured before any
CSS change (LRN-094).
### 5. References side panel (AC3; owner choices: non-modal, button in the finding's detail)
- `components/editor/references/ReferencesPanel.tsx` (from `tabs/ReferencesTab.tsx`, `git mv`, Lot B1 minimal,
Lot D complete), mounted at the first opening and kept mounted (`data-place="references"`). A `section` labelled
by its `h2` « Références » (tabIndex -1).
- Position (board 11, robustness challenge): the panel and its scrim live in a `relative` container that starts after
the tab row and holds the tab panels; the panel is `absolute right-0 top-0 bottom-0`, width `min(27rem, 100%)`,
with a `sticky top-14` inner box of height `calc(100dvh - 3.5rem)` and its own scroll; it never covers the draft
header or the tab row. The scrim covers the tab panels only; while open they get `inert`. Header (Références, save
line, Abandonner, Enregistrer), tab row and Annuler/Rétablir stay usable; Ctrl+Z works (no `dialog[open]`). DOM
order: header → tab row → panel → tab panels.
- Closing: ✕ « Fermer les références », Escape inside the panel, a scrim click; focus returns to the opener when it is
connected and visible, else the header « Références » button. A `DeleteDialog` opened from the panel is the only
modal on screen (D13 unchanged).
- Content (Lot D): chip « Citées par « {nom} » (n) » when opened from a finding, « Tout afficher (N) » clears it;
field « Rechercher une référence » (case- and accent-insensitive on citation, DOI and URL, `folded`); per reference
its type, « citée n fois » and the level-1 fields and actions (edit, ↑/↓, delete with dependents listed, add form).
↑/↓ only when neither filter nor search is active. Read-only modes: no edit control.
- The filter is the finding's key, re-read from the current document on each render; a finding that no longer exists
clears it.
- « Aller à » on a reference: the reducer clears `citedBy`; the panel clears its search on that request, then focuses
the card after the commit that shows it (two phases: the card does not exist while a search hides it).
- Citation counts: pure `citationCounts(doc): ReadonlyMap<string, number>` in
`apps/app/src/editor/references/citations.ts`, counting `reference_ids` over `buildItems(doc)`
(`editor/findings/tree.ts:161`, every finding category and node), memoised on the parsed document (precision 6).
Boundary note (BDR-043, EVAL-034): a display count read from the document, no rule; the core's `sheet.dependents`
stays the authority for refused deletions.
- Opening points: header « Références » (all modes, `aria-expanded`, `aria-controls`, Lot B1); in the selected
finding's detail (`findings/FindingContent.tsx` Citations block) a button « n référence(s) » when it cites at
least one, opening the panel filtered to it (Lot D).
### 6. Header and history (AC4-AC7, T15, precisions 3, 4, 9)
- `DraftHeader.tsx` split in Lot B1 (first header control) into `DraftHeader` (title, badges), `HeaderActions`
(« Références », separator, save line, discard, « Enregistrer ») and `SaveLine`. Badges, heading focus and the
edit-mode-only rule of discard and Enregistrer unchanged; « Prévisualiser » not built; the right group wraps under
the title when the width requires it (measured in Lot H).
- `components/editor/HistoryButtons.tsx` (Lot E) at the right of the tab row on every tab: glyph + visible
« Annuler » / « Rétablir »; accessible name and `title` « Annuler la dernière modification » (T15) and « Rétablir la
dernière modification annulée » (proposal); `aria-keyshortcuts` « Control+Z », « Control+Shift+Z »; below 640 px
the label is visually hidden (name kept); 44 px targets below 1 280 px (board 13).
- Enabled exactly when the route's `!readOnly` (edit mode, no recovery pending: the shortcut's predicate) and the
store can step. Saving does not disable them (amendment of AC4, below): the store already accepts a step during a
save and keeps such changes unsaved (`editorSave.ts:118`), and Ctrl+Z is unchanged there.
- `aria-disabled` instead of `disabled`, so a button that becomes unusable keeps focus.
- `onPointerDown`: `commitFocusedField()` (section 1) first; the field's `TextField` commits on blur. The click
handler then reads `getState()` and steps when `!readOnly` and the store can step. So typed text is the last
change and the undo reverts exactly it (AC5), with an empty history too; keyboard users reach the button with
Tab, which blurs the field the same way.
- A refused blur commit (the field shows its error, `aria-invalid="true"`, e.g. `editor.field.required_names`): the
undo is skipped and focus returns to that field, so an earlier unrelated change is never undone in its place.
- No layout shift between press and release: the save line reserves the width of its longest form in both locales
(tabular figures), so the tab row does not move when the blur's commit changes the line (LRN-104).
- The tool column's pair is removed (`ToolColumn.tsx:83-84`, `:122-133`); ToolColumn's whole glyph map moves to
`components/editor/EditorGlyph.tsx` (plus `search`), one glyph table for the editor; `book` and `close` come from
`components/ui/Icon.tsx`, unchanged.
- Unsaved count, a selector (`apps/app/src/editor/saveLine.ts`, `savedDistance(state)`), no store field: the saved
text, the shown text and the history entries are the same strings (`editorLoad.ts:81-82`, `:138-139`;
`editorSave.ts:86`; `editorEdit.ts:58`, `:76`; `undo.ts:52-73`). `staleBase` → null; `documentText === savedText` →
0; else the 1-based depth of the nearest undo entry whose `text === savedText`, else the same in redo, else null.
Memoised on the identities of `documentText`, `savedText`, `undo`, `redo`. It covers load, reload, discard, restore,
every trim (commit, undo and redo all call `bounded()`), commits and undos made during a save.
- Save line (`saveLineState(state)` in the same module), first match wins:
1. a copy issue (cap or quota): today's text;
2. `saving`: « Enregistrement… »;
3. `unsaved`: « n modification(s) non enregistrée(s) » when `savedDistance` is a positive number, else
« Modifications non enregistrées »;
4. `lastSave` and `lastSave.revision === savedRevision`: « Enregistré à hh:mm · révision n » when
`lastSave.savedAt` is known, else « Enregistré · révision n »;
5. « Révision n ».
The visible line is a plain `<p>`; a separate visually hidden `role="status"` announces state changes only
(unsaved, saving, saved, copy issue), never each count change (robustness challenge).
- Store addition `lastSave: { revision: number; savedAt: string | null } | null` (`editor/state/*`): set to
`{ revision, savedAt: null }` by `applySaved` (after the server answer: effective confirmation); then, except on
`draft.unchanged` (`editorSave.ts:105`, an older save's time would be shown), `void readSaveTime(api, session,
revision)` (never awaited, the save outcome is not delayed) reads `getOfficialSheetAdmin` (existing accessor,
already used by `readConflict`) and writes `savedAt = draft_last_save.saved_at` only when
`draft_version.version_id` is this version, `draft_last_save.revision === revision`, and the session and
`lastSave` are unchanged; any failure leaves null (owner choice: server time only). Formatted with
`formatParisTime` (`editor/format.ts:18`). Reset by open and reload.
- « Abandonner les modifications » (C11 as amended, precision 9): `editor.draft.discard` relabelled; disabled rule,
confirmation and `discardChanges({ confirmed: true })` unchanged; when the dialog opens, `copyExists(userId,
versionId)` (`editor/state/recovery.ts:80`) decides whether the confirmation adds « La copie locale temporaire de
ces modifications sera aussi supprimée. », so a copy left by an earlier write after a quota refusal is named too
(`copyWritten` only tells the last write).
### 7. Shell (AC9, Lot F)
- `AppLayout.tsx`: on the editor path one of two static class sets (Tailwind needs literal classes): sidebar
`hidden xl:flex …`, menu button and brand link `xl:hidden`, top-bar `h1` `hidden xl:block`; elsewhere today's `lg`
set. Split (layout, top bar) to stay under the line limit. Today's top bar with the menu button is kept (board 13's
merged row is not built).
- `MobileDrawer.tsx`: prop `closesFrom: '64rem' | '80rem'` (default '64rem') replaces `LARGE_SCREEN`; the effect,
with `closesFrom` in its deps, closes the drawer at setup when the query already matches and on later `change`
events. AppLayout passes '80rem' on the editor. The drawer stays open from 1 024 to 1 279 px in the editor; leaving
the editor at 1 180 px with the drawer open closes it. Drawer links stay under the capture leave guard (BDR-078).
### 8. « Aller à » (AC13)
- `editor/verification.ts`: `ROOT_TAB` and `tabOf` become a table built on `targetOfKey`; `issueTarget` returns
`{ target: EditorTarget; name }` (the target carries the key, or the place alone when the key does not resolve).
`IssueList` calls `navigate(target)`; its fallback label names the place (« Aller à Vues »).
- Focus per target: general, views, categories, regions, findings rows through `focusAttrs`; an annotation: select
it, then focus the properties panel heading (`PropertiesPanel.tsx:61`, tabIndex -1 added); a reference: section 5;
nothing found: section 1's fallback chain.
### 9. Narrow read-only (AC11, C16, precision 5)
- Mode logic unchanged (`mode.ts`). Every moved form takes `readOnly` from the route: the three sections and the
panel show no edit control in any read-only mode; overview entries open sections in consultation; history buttons
disabled and Ctrl+Z off (same predicate). The store's `canEdit` stays true in narrow mode by design (recovery copy).
- No horizontal scroll at 320, 375 and 768 px, panel open included; the tab row uses the small tier and icon-only
history below 640 px.
### 10. i18n (AC16, AC20)
- Keys renamed in Lot B1: `editor.tab.views|references|vertebrae` → `editor.place.views|references|regions`, plus
`editor.place.drawing`, `editor.place.categories`; `editor.tab.general` kept (a group name in
`ReviewFigures.tsx:32`); each removed key grepped before deletion, e2e and LAN specs included
(`e2e/lan/trial-lan.spec.ts:125,148`; `Dict` is `Record<string, string>`, so typecheck does not catch a removed
key).
- Prose naming an old tab or « Annuler » reworded in the lot that moves the place: `fr.ts:1218`, `:1510`, `:1515`,
`:1516`, `:1420` (Lot B1), `:1400`, `:1425-1426` (Lot E) and EN counterparts (`en.ts:1187`, `:1389`, `:1479` and
neighbours in B1; `:1369`, `:1394-1395` in E).
---
## Lots
Each lot: `pnpm typecheck && pnpm lint && pnpm test:run` green, its e2e specs and the two sentinels green on the
sandbox, then commit (removed or rewritten assertions mapped in the message) and push.
### Lot A · Navigation model (pure)
- Files: create `apps/app/src/editor/navigation.ts`; test `apps/app/tests/unit/editor-navigation.test.ts`.
- Produces: `ANNOTATION_SECTIONS`, `AnnotationSection`, `EditorTarget`, `FocusRequest`, `NavigationState`,
`NavigationAction`, `initialNavigation`, `navigationReducer`, `targetOfKey`.
- Tests: `targetOfKey` for the eight `ElementKey` kinds; `go_to` increments the serial and sets tab, section or
panel; `select_tab` keeps section and panel and issues no request; `open_section`, `back_to_drawing`;
`open_references` and `close_references` keep tab and section (opened from the views section, the section stays);
`focus_consumed` clears only its serial; visited lists only grow.
- Commit: `feat(editor): navigation model for the four-tab shell`.
### Lot B1 · Four tabs, sections with their entries, minimal references panel, « Aller à »
- Files: `editor/{tabs,focusRequest,verification,useEditorNavigation}.ts`, `editor/annotations/focusTarget.ts`,
`components/editor/{EditorTabs,EditorTabBody,DraftHeader,HeaderActions,SaveLine}.tsx`,
`components/editor/tabs/{GeneralTab,AnnotationsTab,FindingsTab,VerificationTab}.tsx`,
`components/editor/annotations/{EditableAnnotations,PropertiesPanel,OverviewPanel,CreationPanel,TracingBar}.tsx`
(OverviewPanel: Vues and Catégories cards with their entries; CreationPanel heading and the tracing bar get
tabIndex -1 for the `kept` focus), `components/editor/annotations/sections/{registry.ts,AnnotationSection.tsx,
ViewsSection.tsx,RegionsSection.tsx}` (moved), `components/editor/general/CategoriesSection.tsx`,
`components/editor/references/ReferencesPanel.tsx` (moved from `tabs/ReferencesTab.tsx`, toggled by the header
button, level-1 content), `components/editor/findings/{FindingTree,FindingsTab}` focus one-shot,
`components/editor/verification/IssueList.tsx`, `editor/annotations/overview.ts` (counts),
`app/routes/app/admin/AdminSheetDraftRoute.tsx` (`DraftEditor` keeps session and mode; new `EditorWorkspace`
renders header, notices, tab row, places, live region), i18n keys and prose of the lot;
`e2e/support/{editor,warm-up}.ts` (`selectTab` by role with a name pattern, `place(page, name)` returning the
visible `data-place`, `openSection`, `backToDrawing`, `openReferences`, `TABS` of four), the specs that select a
removed tab (`editor-access:34-42,156-200`, `editor-drawings:57,84,133`, `editor-structures:59-63,73-78,103-109`,
`editor-geometry:204,260,347,374,399`, `editor-equine:112-131,288-299`, `editor-journey:82,101,108-111`,
`editor-recovery`, `editor-signout`), `e2e/lan/trial-lan.spec.ts:125,148`.
- No keep-alive yet: a place unmounts when left, as a tab does today; no level-1 function is unreachable at this
commit (views, categories and regions through the overview entries and « Aller à », references through the header).
- Sandbox: before the first e2e run, `pnpm db:sandbox up fresh` (wipes the trial data, authorised by this plan).
- Tests: `editor-route.test.tsx` (four tab names; tiers at 1 280, 800, 500 px with « Plus » holding Général and
Constats; arrows), `editor-mode.test.ts:99-117`, `editor-initial-tab.test.ts`, `editor-focus-request.test.tsx`
(each request reaches its owner; annotation target focuses the properties heading; not found → tab, or « Plus »
below 640 px, never `body`), `editor-verification.test.tsx` (each issue root → its target; fallback label), new
`editor-sections.test.tsx` (entries open each section, `h2` focused, « Retour au dessin » focuses the entry, the
region entry present with no role code; read-only labels; undo of a view creation while that view is shown with a
pending point and with a tracing → main view, pending and tracing cleared, and no dispatch when the shown view
still exists; « Aller à » an annotation while a creation is pending, and while a zone tracing is open, keeps it,
focuses its panel or bar and announces it). Tests rendering the moved components import their new paths
(`editor-tabs-views`, `editor-drawing-upload:94`, `editor-repair:300`, `editor-tabs-lists`,
`editor-tabs-general:105-185`), assertions kept; `editor-findings.test.tsx:32` and
`editor-annotations-tab.test.tsx:44` gain `navigate` in their props; `editor-route-recovery:93-97` moves to the
header button.
- Commit: `feat(editor): four tabs, Annotations sections, references from the header`.
### Lot B2 · Kept-mounted places
- Files: `components/editor/{EditorTabBody.tsx,KeptPlace.tsx (new),tabs/AnnotationsTab.tsx}`, route workspace
(references wrapper), `components/editor/annotations/AnnotationCanvas.tsx` and
`editor/annotations/useCanvasBuild.ts`, `components/editor/views/CropCanvas.tsx` (detach while hidden),
`editor/sheetDocument.ts` (single-entry cache),
new `apps/app/tests/unit/editor-keep-alive.test.tsx`, new `apps/app/e2e/shell/editor-shell.spec.ts` (first
journeys); rewrites `editor-route.test.tsx:135` (the hidden Annotations tab is now in the DOM) and
`editor-journey.spec.ts:309` (`getByLabel('Nom (FR)')` scoped to the visible place).
- Tests (unit): text typed in the category add form survives Général ↔ Annotations and a section round trip; findings
expansion and selection survive a tab change; the canvas tool, selection and zoom survive a tab change and the
views section round trip through the unmeasured hint; a field still focused while a programmatic move happens
(keyboard shortcut to a tab, « Aller à », Escape closing the panel from a reference field) is committed first (one
undo entry, `unsaved` true, leave guard armed); text typed in the reference add form survives closing and reopening
the panel; every place visited, a crop group open in the views section → no duplicate `id`, SVG ids included; a
request reaches only its owner while others are mounted; after an « Aller à » to a finding, arrowing back onto
Constats keeps focus on the tab; one `JSON.parse` per document text across places.
- Tests (Chromium, `editor-shell.spec.ts`): the same keep-alive rules for the category form and the zoom; focus after
« Aller à », « Retour au dessin » and a tab click checked with `document.activeElement` (happy-dom does not refuse
focus on hidden elements).
- Commit: `feat(editor): kept-mounted tabs, sections and references panel`.
### Lot C · Annotation card and side column from 1 024 px
- Files: `components/editor/annotations/{OverviewPanel,AnnotationList,EditableAnnotations,PropertiesPanel}.tsx`,
`components/editor/tabs/AnnotationsTab.tsx` (read-only body), `editor/annotations/overview.ts` (grouping, filter),
`apps/app/src/catalogue/useCatalogue.ts` (export `folded`, no other change), i18n keys of the lot; e2e specs that
select annotations from the list or query it (`editor-annotations`, `editor-geometry`, `editor-journey`,
`editor-equine.spec.ts:281,319`, `editor-structures.spec.ts:288`).
- Tests: new `editor-overview.test.tsx` (card in edit and read-only, grouping in category order, filter ignoring case
and accents, « Toutes les annotations » returns to the card with focus on the row, view rows switch the canvas
view); `editor-annotations-tab.test.tsx` list assertions move to the card (mapping); grid from `lg`; overflow
measured at 1 024 and 1 180 px before the CSS change.
- Commit: `feat(editor): board 01 annotation card, side column from 1 024 px`.
### Lot D · References panel complete
- Files: `components/editor/references/{ReferencesPanel,ReferenceRow,ReferenceForm}.tsx`,
`editor/references/citations.ts` (new), `components/editor/findings/{FindingContent,FindingDetail}.tsx` and
`components/editor/tabs/FindingsTab.tsx` (the opener passed down), route workspace (container,
scrim, `inert`), i18n keys of the lot; `editor-structures.spec.ts` references part; `editor-shell.spec.ts` panel
journeys.
- Tests (unit): `citationCounts` (nested categories and nodes, several citers, zero); new
`editor-references-panel.test.tsx`: opens from the header (focus on heading) and from a finding (chip and count,
filtered list, « Tout afficher (N) »), search on citation, DOI and URL ignoring case and accents, ↑/↓ hidden while
filtered or searching, Escape, ✕ and scrim close, focus back to the opener or the header button, tab panels `inert`
while open, Ctrl+Z reverts a reference edit while open, undo removing the cited finding clears the filter,
read-only modes show no edit control, « Aller à » on a reference hidden by an active search clears the search and
focuses its card.
- Tests (Chromium): Enregistrer, Annuler and Rétablir receive a real click (no interception) with the panel open at
1 024 and 1 280 px, page at the top and scrolled; the panel never overlaps the draft header or the tab row.
- Commit: `feat(editor): references side panel with filter, search and counts`.
### Lot E · Header history, save line, Abandonner
- Files: `components/editor/{HistoryButtons,EditorGlyph,SaveLine,HeaderActions,EditorTabs}.tsx`,
`components/editor/annotations/ToolColumn.tsx` (pair removed, glyphs from `EditorGlyph`), `editor/saveLine.ts`,
`editor/state/{editorTypes,editorBase,editorSave,editorLoad}.ts` (`lastSave` in `initialData()`, `readSaveTime`),
route (`!readOnly` to both), i18n keys and prose of the lot; e2e assertions on the old undo pair, the discard label,
« Révision n » and « modifications non enregistrées » (`editor-journey:272-285,345,372`,
`editor-annotations:129-155`, `e2e/support/editor.ts` `saveDraft` `:352-363`, `trial-lan.spec.ts:24-29,145`,
`editor-structures.spec.ts:229-231` (a `toHaveCount(0)` on the old text would pass vacuously),
`editor-recovery.spec.ts:142-146,168-172`). A press on an `aria-disabled` button in Playwright goes through
`page.mouse` at the button's box (actionability treats it as disabled).
- Tests: `savedDistance` table (load 0; commits; undo and redo around the save point; a commit after undoing past
it → null; trim by a commit, an undo and a redo → null; restore → null; save sent at 3, then two undos and three
commits in flight → null, and one undo and one commit in flight → null; nearest duplicate wins); `saveLineState`
table (five forms, priority); `readSaveTime` (written only for the same version and revision; late answer after
another save or a reload dropped; failure → no time; not called on `draft.unchanged` nor on a failed save; the save
outcome resolves before the read); new `editor-history-buttons.test.tsx` (names and titles, T15; enabled only in
edit mode without pending recovery; disabled in narrow, frozen, rights, inactive, historical, recovery pending;
enabled while saving and in step with Ctrl+Z; focus kept when the last undo empties the stack; undo from
Annotations reverts a Général change and from Constats a canvas change; typed text then header undo reverts exactly
it, with and without earlier history; pointerdown blurs the focused field; a refused blur commit (names required)
skips the undo and returns focus to the field; Ctrl+Z inside a field leaves the store
untouched; Ctrl+Z ignored while a `DeleteDialog` is open; no pair left in the tool column); save status announces
transitions only; discard confirmation with the copy sentence when `copyExists`, including a quota refusal after an
earlier write, and without it when no copy exists; cancel keeps changes and copy. Rewritten: `editor-route.test.tsx`
(`:104-119`, `:63`, `:93`, `:96`, `:118`), `editor-route-conflict.test.tsx:100,140`,
`editor-route-recovery.test.tsx:125`, `editor-annotations-tab.test.tsx:502-515` (mapping).
- Commit: `feat(editor): header history, save line and Abandonner les modifications`.
### Lot F · Editor sidebar from 1 280 px
- Files: `components/shell/{AppLayout,MobileDrawer}.tsx`, `apps/app/tests/unit/shell.AppLayout.test.tsx`;
`editor-shell.spec.ts` sidebar journeys.
- Tests: editor path uses the `xl` set, other paths the `lg` set; the drawer closes on the `80rem` query in the
editor, on `64rem` elsewhere, and at setup when the query already matches (leaving the editor at 1 180 px with the
drawer open); a drawer link with unsaved changes asks before leaving; Chromium: sidebar hidden at 1 024, 1 180,
1 279 px, shown at 1 280 px, menu reachable in one tap, drawer staying open at 1 180 px.
- Commit: `feat(app): editor sidebar hidden below 1 280 px, menu one tap away`.
### Lot G · Label proposals and parity
- Files: `.claude/audits/2026-11-06-v1-2-6-u1-label-proposals.md` (format of
`.claude/audits/2026-11-03-v1-2-6-label-proposals.md`: key, FR, EN, board, status « proposal »), dead keys removed
after grep.
- Tests: AC20 parity command.
- Commit: `docs(i18n): U1 label proposals`.
### Lot H · Browser journeys and full suites
- Files: `apps/app/e2e/shell/editor-shell.spec.ts` (completed), `docs/development/BROWSER_TESTS.md`.
- Journeys: four tabs; cross-tab undo; typed text then header undo; Ctrl+Z outside and inside a field; « Aller à »
for each issue kind; save line « n modifications non enregistrées » → « Enregistrement… » → « Enregistré à hh:mm ·
révision n »; no horizontal scroll at 1 024, 1 180, 1 279, 1 280 px on the four tabs, the three sections and with
the panel open, and at 320, 375, 768 px in read-only; a width change below 1 024 px with a section open and with the
panel open (read-only, no edit control, unsaved kept, edit back on widening); keyboard walk header → tab list →
Annuler/Rétablir → panel when open → tab panel content (tools, canvas, side column); axe with no serious or critical
violation on the four tabs, each section, the open panel and the narrow read-only mode (after animations settle,
LRN-082; from the top, LRN-089; dialog count 0 after a close, LRN-111, LRN-116); commit-to-paint time with every
place visited on the equine spec, recorded (above 500 ms: STOP).
- Regression: the whole shell suite on the sandbox; C13, C14, C16, C34, C41 journeys green (T11);
`e2e/lan/trial-lan.spec.ts` run with the trial stack of the Lot I demo, or recorded as not run with the reason.
- Commit: `test(app): browser journeys of the four-tab editor shell`.
### Lot I · Docs, gates, checkpoint
- Files: `docs/development/V1-2-6_OWNER_TRIAL.md` (U1 demo: create a non-equine sheet in the UI, switch tabs, undo a
Général change from Annotations, open References from a finding, « Gérer les vues » and « Retour au dessin »,
resize to 1 180 px; `:136`, `:151`, `:155`, `:159`, `:161` reworded), `docs/development/V1-2-6_UX_{PLAN,TESTS}.md`
(U1 tooling row and « a stale worker image is refused » moved to U6, per CLARIFICATIONS), `.claude/tasks/TODO.md`,
the contract (EVIDENCE lines).
- Gates in the AC18 order, each recorded with its command and result: `pnpm typecheck`, `pnpm lint`,
`pnpm test:run`, `pnpm build`, `pnpm e2e:ui`, a new `pnpm db:sandbox up fresh` then `pnpm db:sandbox test-db`,
`pnpm db:sandbox e2e-shell`, `pnpm db:sandbox test` (LRN-113, EVAL-042), `pnpm check:all`,
`pnpm r5:import-equine --check`; the AC19 and AC20 CHECK commands; a fresh verifier on the enriched contract; a
fresh security review on `846994b..HEAD`.
- Checkpoint report (brief §9): changes, board correspondence, tests run with results, verdicts, limits, sandbox
demo, commits and Git state, exit criteria. STOP; no U2.
---
## Edge cases (all lots)
- StrictMode open → close → open: navigation lives in `EditorWorkspace`, which mounts once the version is ready; the
route key per version id resets it; the store's session token rules unchanged.
- A recovery offer pending at opening: every place is consultation only; history disabled; sections and panel open
read-only.
- Save in flight while a section or the panel is open: navigation does not depend on `saving`.
- Conflict dialog open: page inert (modal), shortcuts off as today; places keep their state behind it.
- Leaving the page with the panel open and unsaved changes: leave guard as today (BDR-078).
## Disposition of memory (claimed by this plan)
- BDR-102 [in force]: the regions editor sits in Annotations as the T17 fallback entry, always shown before U6, no
role logic written.
- BDR-101 [in force]: T15 wording: header undo named « Annuler la dernière modification »; « Abandonner les
modifications » for C11; dialogs that close without effect keep « Annuler ».
- BDR-100 [in force]: level 1 not validated (T11); C13, C14, C16, C34, C41 re-run in Lot H.
- BDR-099 [in force]: permission states and their order in the route (`AdminSheetDraftRoute.tsx:175-235`) untouched;
fresh stack for the gate run (Lot I).
- BDR-096 [in force]: board 05 of v1-2-4 stays the narrow read-only reference (section 9).
- BDR-076 [in force]: D13: the panel is non-modal (owner choice), so no `ModalDialog`; every modal stays on it
(delete, discard, conflict, leave, drawer).
- BDR-078 [in force]: drawer and menu links under the capture leave guard at every width (Lot F test).
- BDR-079 [in force]: D11 drawer only, no tab bar; the menu opens the existing drawer.
- BDR-050 [in force]: commits on blur, confirm or pointer-up only; the header undo relies on the blur commit, forced
at pointerdown.
- BDR-006 [pattern kept]: ↑/↓ kept in the panel (unfiltered) and the regions section until U6.
- BDR-042 [rule kept]: no element ahead of the boards: « Prévisualiser », the view menu, the category fold and the
merged tablet top row are not built.
- LRN-017 / AC20: parity in Lot G and Lot I.
- LRN-057: the discard sentence reads the stored copy, the saved state the server answer and the admin read.
- LRN-082: happy-dom proves wiring only; axe and focus checked in Chromium (Lots B2, D, H).
- LRN-085: focus after a drawer navigation unchanged.
- LRN-087: wrappers forward `aria-*`; tests find sections and the panel by role and name.
- LRN-088: `useT` never an effect dependency (live regions, focus effects).
- LRN-094: overflow measured before CSS changes (Lots C, H).
- LRN-110, LRN-113, LRN-114, EVAL-042: absolute worktree, fresh sandbox in the order test-db → e2e-shell → test, the
tracked ledger, gate commands copied verbatim.
- EVAL-034: the citation count stays a TypeScript read of the document (section 5 boundary note).
- LRN-111, LRN-115, LRN-116, LRN-089, LRN-104 [already seen]: dialog count 0 after closes, destination landmark
awaited, scans from the top, click coordinates recomputed after header or tab-row shifts; LRN-115's class (a locator
hitting the wrong copy) is why queries are scoped to the visible place.
## Visible choices taken in this plan (for the owner at the plan checkpoint)
Answered by the owner on 2026-11-06 (recorded [gated] in the contract): server time on the save line; non-modal
references panel; citation button in the finding's detail; board 01 annotation card with « Toutes les
annotations ».
Taken here, to confirm or change:
1. Unsaved count = accepted changes between the shown and the saved document along the history; « Modifications non
enregistrées » without a number when the saved text is no longer in the history (restored copy, trim, a change
made after undoing past the save).
2. After `draft.unchanged`: « Enregistré · révision n », without a time.
3. Annuler and Rétablir stay enabled during a save, as Ctrl+Z (amends AC4).
4. Typed text then « Annuler »: the typed text is the last change and is undone, even when the history was empty
(AC5).
5. Below 640 px: Annotations and Vérification shown, Général and Constats under « Plus »; history icon-only.
6. From 1 024 to 1 279 px today's top bar with the menu button stays; board 13's merged row is not built; the
header's right group wraps under the title when needed.
7. Board 12 A's save-failure strip is not built; today's `SaveFailureNotice` stays.
8. « Régions vertébrales » sits in the Catégories card; read-only entries read « Voir les vues » and « Voir les
catégories ».
9. The annotation card shows every row (no « Voir les n annotations » truncation); the filter matches the displayed
name.
10. Panel: search on citation, DOI and URL; ↑/↓ only on the unfiltered list; focus on its heading at opening.
11. Undo that removes the view shown on the canvas: back to the main view, a pending creation or tracing on the
removed view is dropped (it can no longer be created there).
12. « Aller à » an annotation while a creation is pending or a tracing is open: it is kept and shown, focus on its
panel or bar, an announcement; no jump until it is finished or abandoned.
13. Keyboard order: header → tab list → Annuler/Rétablir → panel when open → tab panel content in visual order
(tools, canvas, side column); the TESTS wording « panel → canvas » would put the DOM order against the visual one.
14. Focus after « Retour au dessin »: the section's entry button, else the canvas box.
15. Announcements: « {Onglet} » or « {Onglet} · {Section} », « Références »; save status announced on state changes
only, not on each count change; the Vérification badge text is part of the tab's name.
16. Discard confirmation adds the copy sentence whenever a copy is stored.
17. Vues card rows without the drawing thumbnail of board 01: a second composition of each view would repeat the
core's ids in the page (section 2); name, kind and annotation count only.
18. A typed value the field refuses (e.g. a name left empty) is not followed by an undo: « Annuler » leaves the
history alone and returns focus to the field with its message.
## Contract amendments proposed (applied only on the owner's approval of this plan)
- AC3: non-modal panel below the tab row (owner answer), content `inert` under a scrim, header and history usable.
- AC4: « saving » leaves the list of states that disable Annuler and Rétablir (choice 3).
- AC5: typed text undone even with an empty history; pointerdown blur (choice 4).
- AC7: count and time rules of section 6 (choices 1, 2; owner answer on the time).
- AC17: keyboard order as choice 13.
- FILE SCOPE: add `apps/app/src/editor/{navigation,saveLine,useEditorNavigation,sheetDocument}.ts`,
`apps/app/src/editor/references/citations.ts`, `apps/app/src/editor/annotations/{overview,useCanvasBuild}.ts`
(overview new; the build hook detaches while hidden; the canvas reset
uses the existing `view` action of `uiState.ts`, unchanged), `apps/app/src/catalogue/useCatalogue.ts` (export
`folded` only),
`apps/app/e2e/lan/trial-lan.spec.ts`; `editor/state/*` edits limited to `lastSave` and `readSaveTime`.
- Design criteria from the owner's precisions 1-10, tagged [gated] at approval: no loss on a tab, section or panel
change (Lots B2, D tests); « Retour au dessin » focus and context; history tests on typed text, shortcuts and
section transitions; save shown only after the server answer, time only from the server; read-only below 1 024 px
on every moved form and shortcut; counts from the current document without network; no « Prévisualiser », no
withdrawal, no removed function; T17 entry without role logic; discard confirmation naming the stored copy;
sections replaceable through one registry.
- Documented limit (section 2): creation forms unmount on a width change across 1 024 px or a recovery decision, as
in level 1.
## Challenge record (2026-11-06, three blind lenses on the first draft)
- Correctness CONCERNS(6 MAJOR, 7 MINOR), robustness CONCERNS(5 MAJOR, 10 MINOR), simplicity CONCERNS(2 MAJOR,
7 MINOR); no BLOCKER tag. Every MAJOR closed by a named change:
- false unsaved count (three lenses): the hand-kept `saveDistance` and `nextSaveDistance` replaced by the
`savedDistance` selector over the history (section 6), with the challengers' sequences in Lot E;
- `<Activity>` re-runs effects on reveal (zoom reset `useFraming.ts:69`, tree focus `FindingTree.tsx:31-33`):
replaced by kept-mounted `hidden` wrappers; `focusId` one-shot; no focus in mount effects (section 2, global
constraints);
- Lot B depended on Lot D and was too large: split into B1 (tabs, sections with their entries, minimal panel,
« Aller à ») and B2 (kept-mounted places); the overview's Vues and Catégories cards move to B1;
- e2e red from B to H and blind happy-dom focus: each lot keeps its specs green on the sandbox; Chromium focus and
keep-alive spec in B2;
- LAN trial spec forgotten: `trial-lan.spec.ts` in B1, E and H;
- typed text with disabled buttons contradictory: AC5 followed, pointerdown blur, test rewritten;
- panel covering the header: anchored below the tab row, Chromium click checks in Lot D;
- pending creation written on the main view after its view vanished: full canvas reset;
- discard sentence keyed on `copyWritten`: `copyExists` read at opening;
- hidden copies matched by label and text locators: `data-place` scoping, no page-wide non-role query.
- MINOR integrated: header split and glyphs in the lots that use them; no `history.ts` (route's `!readOnly`); one
glyph table and `Icon` for book and close; counts over `buildItems`, `folded` shared; lazy initial tab, no reset
action; prose reworded in the lot that moves each place; one encoding for the drawing; drawer closes at setup when
the query matches; save status announces transitions only; panels keep an aria-label and the focus fallback reaches
« Plus »; `readSaveTime` not awaited and skipped on `draft.unchanged`; « Aller à » clears the panel search before
focusing; shared parse cache and stable callbacks; « Aller à » keeps a pending creation; documented limit widened to
every creation form.
- Confirmation pass (one fresh correctness challenger on the revised plan): CONCERNS(3 MAJOR, 5 MINOR), no BLOCKER;
it confirmed that the `savedDistance` string identity holds on every path. Closed by named changes:
- typed text left uncommitted in a hidden field when no blur fires (Safari and iPadOS taps, Escape closing the
panel): `commitFocusedField()` before every move (section 1), tests in Lot B2;
- « Aller à » dropping a tracing: the keep rule covers `ui.tracing` (section 4, Lot B1 tests);
- specs broken outside a lot's list: every lot runs all `editor-*.spec.ts`, the found breakages named in B2, C, E;
- MINOR: SVG id scope shared by the drawing and the crop preview (detach while hidden, no thumbnails); refused
blur commit skips the undo; reserved save-line width; `page.mouse` on `aria-disabled`; three-outcome `apply`,
tabIndex on the creation heading and tracing bar, guarded reset dispatch; `FocusRequest` defined in Lot A, file
lists completed (B1, D, E); `open_references` and `close_references` keep tab and section.
Per `challenge-plan.md`, no further pass; the owner decides at the gate.