diff --git a/.claude/tasks/contracts/2026-11-12-r1-history-deselect-1141.md b/.claude/tasks/contracts/2026-11-12-r1-history-deselect-1141.md new file mode 100644 index 00000000..9734f940 --- /dev/null +++ b/.claude/tasks/contracts/2026-11-12-r1-history-deselect-1141.md @@ -0,0 +1,156 @@ +# CONTRACT — r1-history-deselect +- date: 2026-11-12 | flow: ship-feature | branch: feature/v1-2-anatomical-sheets +- status: active + +## REQUEST (verbatim — IMMUTABLE) +# FAUNOSTEO V1-2.6 — GO R1 COMPLET + D6b + +Le propriétaire approuve l'implémentation complète de R1, incluant le critère D6b ajouté après les tests manuels U1. + +La cause identifiée dans useCanvasGestures.ts est acceptée. Le périmètre proposé est validé, sous les décisions suivantes. + +## 1. Arbitrages + +A. Focus après clic : +- Le focus reste dans le schéma après une désélection par clic ou toucher. +- Utiliser un élément graphique approprié et focusable ; ne pas tenter de focaliser arbitrairement un os ou un path SVG. +- Déclencher l'annonce accessible prévue. +- Conserver la règle A6 propre au bouton Désélectionner : ligne correspondante si disponible, sinon repli sur le schéma. + +B. Zones et liens : +- Un clic sur une annotation interactive (point, zone ou lien) conserve le comportement de sélection. +- Un clic sur un élément non interactif du dessin, y compris un os ou un tracé SVG interne, désélectionne. +- Ne pas confondre les éléments SVG ordinaires et ceux porteurs d'une annotation. + +C. Livraison : +- Implémenter R1 complet, conformément aux maquettes R0 validées et à V1-2-6_U1_CORRECTIONS.md. +- Isoler D6b dans un commit distinct pour faciliter sa revue et sa traçabilité. +- Ne pas commencer R2, R3, R4, U2 ou U2b. + +D. Valeurs invalides : +- Conserver pour R1 le comportement actuel d'une valeur explicitement refusée et non appliquée : fermeture du panneau sans modification du document. +- Vérifier qu'aucune modification valide en attente d'enregistrement n'est perdue silencieusement. +- Ne pas introduire une nouvelle gestion globale des formulaires ou une modale de confirmation dans ce lot. +- Documenter le comportement et ses limites. + +## 2. Implémentation D6b + +Traiter les deux parcours : + +- useCanvasGestures.ts / EditableAnnotations.tsx pour l'éditeur modifiable. +- CatalogueCanvas.tsx / AnnotationsTab.tsx pour la consultation en lecture seule. + +Mutualiser le chemin de désélection existant lorsque c'est pertinent, sans altérer le catalogue du lecteur. + +Une désélection ne doit pas : +- Modifier le document ; +- Déclencher une sauvegarde ; +- Ajouter une opération Défaire/Refaire ; +- Annuler une création en cours lorsqu'aucune annotation n'était sélectionnée ; +- Interférer avec le déplacement d'un repère, le pan, le zoom ou le pincement. + +Le seuil de mouvement de 4 px et la protection des gestes multidoigts doivent être vérifiés sur les séquences réelles d'événements, et pas uniquement sur des clics synthétiques isolés. + +## 3. Tests + +Exécuter les tests unitaires et navigateur prévus pour R1 et D6b. + +Couvrir : +- Clic sur un point, une zone et un lien interactif ; +- Clic sur rect/path/circle non interactifs, racine SVG et marge ; +- Absence de sélection initiale ; +- Pan, zoom, déplacement d'annotation et gestes à plusieurs doigts ; +- Utilisation tactile ; +- Annonce accessible et gestion du focus ; +- Lecture seule ; +- Absence de régression du catalogue du lecteur ; +- Défaire/Refaire après désélection ; +- Persistance du document et absence d'écriture inattendue ; +- Gestion des valeurs refusées et des modifications valides en attente. + +Exécuter les suites automatisées uniquement sur leur environnement prévu. Ne jamais utiliser db:trial comme sandbox E2E jetable. + +Si un test équin nécessite des fixtures, les préparer dans un environnement automatisé isolé, sans toucher à la fiche historique ni aux données de la pile d'essai. + +iOS Safari reste une vérification manuelle ultérieure, non une preuve de compatibilité acquise. + +## 4. Livraison et contrôles + +Respecter les conventions de branche, commit et push du projet. + +Réaliser : +- Les vérifications statiques ; +- Les tests unitaires ; +- Les tests navigateur ; +- Une revue fonctionnelle indépendante ; +- Une revue de code indépendante ; +- Une vérification de sécurité ciblée sur les interactions et l'isolation des environnements. + +Documenter les écarts et limites réels, sans déclarer validé un test non exécuté. + +## 5. Restrictions + +Aucune intervention sur DEV. + +Aucune migration SQL ni modification du moteur Rust ou du worker. + +Ne pas modifier la fiche équine historique. + +Ne pas supprimer ni réinitialiser la copie de travail d'essai. + +Aucune modification des rôles, du MFA ou des secrets. + +Ne pas modifier l'exposition réseau de la pile d'essai. + +Préserver le fichier de revue ChatGPT non suivi. + +Aucune fusion ni aucun déploiement. + +## 6. Checkpoint + +Fournir : +- Le détail des modifications R1 et D6b ; +- Les commits et leur état de push ; +- Les résultats des tests et contre-revues ; +- Les éventuelles régressions ou limitations ; +- Les points à vérifier manuellement dans l'éditeur sur db:trial. + +S'arrêter à la fin de R1. + +Ne pas démarrer R2 sans nouveau feu vert. + +## CLARIFICATIONS +Q: spec of R1? / A: docs/development/V1-2-6_U1_CORRECTIONS.md §1 D5, D6, D6b, §3 R1, §6 A5, A5b, A6; board 26 (docs/design/v1-2-6-r0/26-historique-deselection.png, maquettes.html:380-391, :611-667, REVUE.md:57-60, :72, :108-111, :129-135) is normative (BDR-110). +Q: tooltip with the shortcut and Meta in aria-keyshortcuts? / A: yes, board 26 and REVUE.md:59, :108-110 (title = name + « (Ctrl+Z ou ⌘Z) » / « (Ctrl+Maj+Z ou ⇧⌘Z) », EN « (Ctrl+Z or ⌘Z) » / « (Ctrl+Shift+Z or ⇧⌘Z) »; aria-label = name only; aria-keyshortcuts adds Meta+Z / Meta+Shift+Z). +Q: suites environment? / A: unit + e2e:ui local; e2e:shell only on `pnpm db:sandbox` (already up); never db:trial, never DEV; no sandbox reset/down; exact shell count reported against the known baseline (4 failures admin.spec.ts:717, anomaly B). + +## ACCEPTANCE CRITERIA +1. FR history labels read « Défaire » / « Refaire » with names « Défaire la dernière modification » / « Refaire la dernière modification défaite »; EN undo/redo strings unchanged; fr and en key sets identical. + CHECK: cd /home/bchanot/Documents/faunosteo-v1-2/apps/app && grep -q "'editor.history.undo': 'Défaire'" src/i18n/fr.ts && grep -q "'editor.history.redo': 'Refaire'" src/i18n/fr.ts && grep -q "'editor.history.undo_title': 'Défaire la dernière modification'" src/i18n/fr.ts && grep -q "'editor.history.redo_title': 'Refaire la dernière modification défaite'" src/i18n/fr.ts && grep -q "'editor.history.undo': 'Undo'" src/i18n/en.ts && grep -q "'editor.history.redo_title': 'Redo the last undone change'" src/i18n/en.ts && ! grep -qE "'editor\.history\.(undo|redo)(_title)?': '(Annuler|Rétablir)" src/i18n/fr.ts && echo LABELS_OK + EXPECT: LABELS_OK + EVIDENCE: pending +2. History buttons: aria-label = the name, title = name + the shortcut text of board 26, aria-keyshortcuts lists Control and Meta forms; shortcuts themselves unchanged (useUndoShortcuts.ts untouched); dialog « Annuler » buttons untouched; the FR prose naming the history command (editor.views.drawing.use_parent_body, editor.views.repair.body_one/_other) says « Défaire ». + CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --quiet 541706c -- apps/app/src/editor/useUndoShortcuts.ts && grep -q "Meta+Z" apps/app/src/components/editor/HistoryButtons.tsx && grep -q "Meta+Shift+Z" apps/app/src/components/editor/HistoryButtons.tsx && ! grep -q "un seul Annuler" apps/app/src/i18n/fr.ts && ! grep -q "ce changement (Annuler)" apps/app/src/i18n/fr.ts && echo HISTORY_OK + EXPECT: HISTORY_OK + EVIDENCE: pending +3. « Désélectionner » (secondary, deselect glyph) sits to the left of « Supprimer » in the properties panel, in edit and read-only modes (read-only: no « Supprimer »); after it: the annotation's list row if visible, else the drawing box; focus never reselects; polite announcement « Aucune annotation sélectionnée. » / « No annotation selected. ». +4. Escape in the editor workspace, first applicable wins: open dialog (native, untouched) > « Plus » menu open (closes, focus on « Plus ») > references panel open (closes, focus on its opener) > tracing in progress (cancels, as today) > selection (deselects, focus per the [gated] rule, same announcement); Escape inside a text field / select never deselects; nothing applicable → nothing; acts on the shown body only (kept hidden edit body or hidden tab never changes). +5. D6b, edit canvas: with the select tool, a click/tap whose target has no [data-anno-id] ancestor deselects when an annotation is selected (bone or any drawing shape, the composed root, the box margin); a click on a point, zone or link still selects it; nothing selected → no dispatch (pending keyboard creation, typed fields, « Filtrer par nom » kept); drawing tools and tracing unchanged; a press that moved > 4 px (pan, marker drag, pinch) or during which a second pointer came down never deselects; focus ends on the canvas box (role=group, tabIndex 0), never on an SVG shape; same announcement. +6. D6b, read-only twin: CatalogueCanvas gets an optional onEmpty with the same rules, passed only by the editor's read-only twin; the catalogue reader (SheetRoute) passes none and behaves exactly as before; useFraming.ts unchanged. + CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --quiet 541706c -- apps/app/src/catalogue/useFraming.ts apps/app/src/app/routes/app/anatomy/SheetRoute.tsx && grep -q "onEmpty" apps/app/src/components/catalogue/CatalogueCanvas.tsx && grep -q "onEmpty" apps/app/src/components/editor/tabs/AnnotationsTab.tsx && echo READER_UNCHANGED_OK + EXPECT: READER_UNCHANGED_OK + EVIDENCE: pending +7. Every deselect path (button, Escape, click/tap): document text, handle version, history length, unsaved count and save state unchanged by the deselect itself; no save request; a valid typed value not yet blurred is committed (its own edit, undoable), never dropped silently; a refused « non appliqué » value: panel closes, document unchanged (current behaviour, documented); undo after a deselect undoes the previous edit. +8. Unit tests (vitest) cover items 1-7 including clicks on inner SVG elements (rect/circle/path), the root svg and the margin, pointer sequences (down/move/up then click) under and over 4 px, a second pointer, read-only twin, reader unchanged; `pnpm typecheck`, `pnpm lint`, `pnpm test:run`, `pnpm build` pass. + CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && pnpm -s typecheck >/dev/null 2>&1 && pnpm -s lint >/dev/null 2>&1 && pnpm -s test:run >/tmp/claude-1000/-home-bchanot-Documents-faunosteo/463d8810-0112-4b67-92e4-aa3c30af6089/scratchpad/r1-unit.txt 2>&1 && echo STATIC_UNIT_OK + EXPECT: STATIC_UNIT_OK + EVIDENCE: pending +9. Browser tests: `pnpm e2e:ui` passes; a new shell spec (Chromium, `pnpm db:sandbox` only) covers button, Escape matrix, D6b mouse clicks on inner shapes/root/margin/annotations, pan/zoom/marker drag, touch tap, touch drag, two-finger tap and pinch through CDP, read-only twin, persistence after reload and no save request; `editor-equine.spec.ts` clicks a bone path of the horse drawing on its own sandbox copy; the full shell suite run is reported with its exact counts against the baseline. +10. D6b lands in its own commit; commits pushed on feature/v1-2-anatomical-sheets; no change under supabase/, crates/, scripts/db-trial*.sh, docker/; the untracked review file kept. + CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && [ -z "$(git diff --name-only 541706c -- supabase crates scripts/db-trial.sh scripts/db-trial-check.sh docker)" ] && [ -f faunosteo-v1-2-6-revue-ux-chatgpt.md ] && git log --format=%s 541706c..HEAD | grep -q "D6b" && [ "$(git rev-parse HEAD)" = "$(git rev-parse @{u})" ] && echo SCOPE_PUSH_OK + EXPECT: SCOPE_PUSH_OK + EVIDENCE: pending +11. Docs: V1-2-6_U1_CORRECTIONS.md R1 status + the deselect limits (refused value, focus rules, iOS manual), BROWSER_TESTS.md (new spec, keyboard order « Défaire », « Refaire »), V1-2-6_OWNER_TRIAL.md labels, a D5 note on T15 in V1-2-6_UX_DECISIONS.md and V1-2_ANATOMICAL_SHEETS.md, ANNOTATION-RENDERING.md click paragraph (D6b); historical records (U1 checkpoint, v1-2-6 board records) untouched. + +## FILE SCOPE +apps/app/src/i18n/{fr,en}.ts; apps/app/src/components/editor/{HistoryButtons,EditorTabs,EditorWorkspace,EditorGlyph}.tsx; apps/app/src/components/editor/annotations/{PropertiesPanel,EditableAnnotations,AnnotationCanvas}.tsx; apps/app/src/components/editor/references/ReferencesPanel.tsx; apps/app/src/components/editor/tabs/AnnotationsTab.tsx; apps/app/src/components/catalogue/CatalogueCanvas.tsx; apps/app/src/editor/annotations/{useCanvasGestures,usePlacement}.ts; apps/app/src/editor/{focusRequest,useEditorNavigation}.ts; new apps/app/src/editor/{deselect,escape}.ts(x) helpers; apps/app/tests/unit/*.test.tsx (editor-history-buttons, editor-annotations-tab, editor-overview, editor-sections, editor-keep-alive, routes.catalogue, new editor-deselect / editor-escape); apps/app/e2e/shell/editor-*.spec.ts (titles/comments), new e2e/shell/editor-deselect.spec.ts, e2e/support/editor.ts, editor-equine.spec.ts; docs listed in criterion 11; .claude/tasks/*. diff --git a/.claude/tasks/plans/2026-11-12-r1-history-deselect-1141.md b/.claude/tasks/plans/2026-11-12-r1-history-deselect-1141.md new file mode 100644 index 00000000..cf9fb005 --- /dev/null +++ b/.claude/tasks/plans/2026-11-12-r1-history-deselect-1141.md @@ -0,0 +1,307 @@ +# R1 (history labels, deselection, Escape) + D6b Implementation Plan — rev 3 (3-lens challenge + re-challenge) + +> For agentic workers: executed task by task by fresh implementers (subagent-driven-development), each task +> reviewed before the next. Steps use checkbox syntax. + +**Goal:** V1-2.6 lot R1 complete: « Défaire » / « Refaire », « Désélectionner », the Escape priority, and D6b +(a click or tap on the drawing outside any annotation deselects), in the editable editor and its read-only twin. + +**Architecture:** one deselect hook (commit the focused field, clear the selection, move or keep focus, announce) +used by the button, Escape and the drawing. Escape needs no registry: only the SHOWN annotation body +(`usePlaceVisible()`) listens for Escape on `document` (bubbling, so React-level consumers that stop or mark the key +go first), and only while it has a resolved selection and no tracing; the « Plus » disclosure closes itself first +through a capture listener while open; the workspace root closes the references panel for an Escape from the header +or tab row. D6b decides on the PRESS, not the click target: a tap tracker (pointerdown target, accumulated +movement, primary/non-primary pointers anywhere in the page, contextmenu) gives an empty-tap verdict at `pointerup`. +Mouse and pen apply it at pointerup (survives the pointer capture of the move gesture, whose click targets the box, +and the canvas rebuild a blur commit triggers at mousedown) and swallow the click that follows. Touch applies it in +the tap's own click, and only if that click's target carries no `[data-anno-id]` (Chromium builds the touch click +after touchend, hit-tests the post-deselect layout and adjusts toward nearby markers: applying at pointerup would +let the click land on what moved under the finger). `useFraming` is not touched. + +**Tech stack:** React 19, TypeScript strict, Zustand editor store, Vitest + happy-dom + Testing Library, +Playwright Chromium (`pnpm e2e:shell` on `pnpm db:sandbox`). + +**Spec:** `docs/development/V1-2-6_U1_CORRECTIONS.md` §1 (D5, D6, D6b), §3 R1, §6 (A5, A5b, A6); board +`docs/design/v1-2-6-r0/26-historique-deselection.png` (normative, BDR-110), `maquettes.html:380-391, :611-667`, +`REVUE.md:57-60, :72, :108-111, :129-135`. Contract: `.claude/tasks/contracts/2026-11-12-r1-history-deselect-1141.md`. + +## Global constraints + +- Worktree `/home/bchanot/Documents/faunosteo-v1-2`, branch `feature/v1-2-anatomical-sheets`, commit in place + (auto-push); never run anything in `/home/bchanot/Documents/faunosteo`. +- No change under `supabase/`, `crates/`, `scripts/`, `docker/`; `apps/app/src/catalogue/useFraming.ts`, + `apps/app/src/editor/useUndoShortcuts.ts`, `apps/app/src/app/routes/app/anatomy/SheetRoute.tsx` unchanged; + `src/catalogue` and `src/components/catalogue` import nothing from `@/editor`. +- Every UI string through `useT()`; fr and en get the same keys; `t` never in effect or callback deps (LRN-088). +- Our code: ≤ 25 logic lines per function, ≤ 5 params, ≤ 5 locals, 100 chars per TS line; comments say why. +- Kept places: act only on what is shown; no one-shot focus in mount effects (LRN-119); twin ids keep `ro-`. +- Unit pointer events in happy-dom carry `isPrimary: true, button: 0, pointerType: 'mouse'` explicitly (happy-dom's + default `isPrimary` is false). +- Browser suites: `pnpm e2e:shell` against `pnpm db:sandbox` only (up); never db:trial, never DEV; no sandbox + reset or `down`; never edit `src` while a browser suite runs (LRN-120). +- Commits: Conventional Commits, allowed scopes (`app`, `tests`, `docs`); every rewritten or removed assertion + mapped to its replacement in the commit body (R-24). D6b code and its tests only in the D6b commit. + +## Fixed wording (board 26, REVUE.md table) + +| Key | FR | EN | +|---|---|---| +| `editor.history.undo` | Défaire | Undo (unchanged) | +| `editor.history.undo_title` | Défaire la dernière modification | Undo the last change (unchanged) | +| `editor.history.redo` | Refaire | Redo (unchanged) | +| `editor.history.redo_title` | Refaire la dernière modification défaite | Redo the last undone change (unchanged) | +| `editor.history.undo_shortcut` (new) | Ctrl+Z ou ⌘Z | Ctrl+Z or ⌘Z | +| `editor.history.redo_shortcut` (new) | Ctrl+Maj+Z ou ⇧⌘Z | Ctrl+Shift+Z or ⇧⌘Z | +| `editor.annotations.deselect` (new) | Désélectionner | Deselect | +| `editor.annotations.deselected` (new) | Aucune annotation sélectionnée. | No annotation selected. | + +FR prose: `editor.views.drawing.use_parent_body` « … et vous pouvez défaire ce changement (Défaire). … »; +`editor.views.repair.body_one` / `_other` « … et un seul Défaire les restaure ensemble. ». EN prose unchanged. +`fr.ts:1479` « Annulez, … » and every dialog « Annuler » stay. + +## Gate outcomes (filled at the validation gate before dispatch) + +- G1 Escape focus: [pending owner] recommended = focus inside the properties panel → A6 (row if visible, else the + drawing box); focus elsewhere (canvas box, view chips, tool column, add buttons) → stays where it is. +- G2 « Supprimer »: [pending owner] recommended = unchanged (filled danger button, no icon), per the board caption + « qui garde son style de danger »; only placed to the right of « Désélectionner » in the bordered row. + +## Reviewer checklist (each has its test below) + +Shown body only (Task 3 test 9); replace tracing (Task 2 test 8, Task 3 test 6, Task 4 test 10); pending valid value +then a drawing click in a real browser (Task 5 step 7); two-finger tap (Task 4 test 8, Task 5 step 5 with the event +count); filtered-out row (Task 2 test 2); selected marker click and jitter (Task 4 test 4, Task 5 step 3). + +--- + +### Task 1: history reads « Défaire » / « Refaire » (D5) — commit `feat(app): history reads Défaire / Refaire (R1, D5)` + +**Files:** `apps/app/src/i18n/fr.ts` (:1284-1287, :1444, :1473-1474), `apps/app/src/i18n/en.ts` (new shortcut keys +only), `apps/app/src/components/editor/HistoryButtons.tsx`, `EditorTabs.tsx:147` (comment only); tests +`tests/unit/editor-history-buttons.test.tsx`, `tests/unit/editor-annotations-tab.test.tsx:514`; e2e titles/comments +`e2e/shell/editor-shell-layout.spec.ts:271, :293`, `editor-shell-journeys.spec.ts:152, :160`, `editor-shell.spec.ts:149`, +`e2e/support/editor.ts:440`. + +- [ ] Dictionaries per the wording table. +- [ ] `HistoryButtons.tsx`: `SHORTCUT = { undo: 'Control+Z Meta+Z', redo: 'Control+Shift+Z Meta+Shift+Z' }`; + `aria-label={name}`, `title={`${name} (${t(`editor.history.${direction}_shortcut`)})`}`; comments :41, :53, :121 + and `EditorTabs.tsx:147` say « Défaire » / « Refaire ». +- [ ] Unit: constants and assertions to the new FR names; title = name + « (Ctrl+Z ou ⌘Z) » / « (Ctrl+Maj+Z ou + ⇧⌘Z) »; `aria-keyshortcuts` the two-form lists; visible labels `['Défaire','Refaire']`; the absence checks (:205, + `editor-annotations-tab.test.tsx:514`) become `/Défaire|Refaire/`; one EN test (names unchanged, title with + « (Ctrl+Z or ⌘Z) »); FR prose keys contain « Défaire » while `use_parent_cancel` still reads « Annuler ». +- [ ] Run `pnpm --filter @faunosteo/app exec vitest run tests/unit/editor-history-buttons.test.tsx tests/unit/i18n.dicts.test.ts tests/unit/editor-annotations-tab.test.tsx`, `pnpm typecheck`, `pnpm lint`. Commit with the R-24 map. + +### Task 2: « Désélectionner » (D6, A6) — part of commit `feat(app): Désélectionner and the Escape priority (R1, D6, A5, A6)` + +**Files:** new `apps/app/src/editor/annotations/deselect.ts`; `src/editor/useEditorNavigation.ts` (export +`CANVAS_BOX` only); `src/editor/focusRequest.ts` (export `isTextField(target)`; `commitFocusedField` uses it); +`EditorGlyph.tsx` (glyph `deselect`: `M4 8V5a1 1 0 0 1 1-1h3M16 4h3a1 1 0 0 1 1 1v3M20 16v3a1 1 0 0 1-1 1h-3M8 20H5a1 1 0 0 1-1-1v-3M9 9l6 6M15 9l-6 6`); +`annotations/PropertiesPanel.tsx`; `annotations/EditableAnnotations.tsx` (pass `busy`); i18n keys. + +- [ ] `deselect.ts`: + - `focusDrawing(): boolean` — `visibleElement(CANVAS_BOX)` focused with `{ preventScroll: true }`. + - `focusRowOrDrawing(id)` — `focusRow({ kind: 'annotation', id }) || focusDrawing()`. + - `useDeselect(id: string | null, clear: () => void)` → `{ byButton(), byKey(fromPanel: boolean) }`. `id` is the + RESOLVED selection (`selected?.id ?? null`, never the raw `selectedId`, which can name a removed annotation). + Each: `id === null` → return false; else `commitFocusedField()`, `flushSync(clear)`, focus (byButton → + `focusRowOrDrawing(id)`; byKey → `focusRowOrDrawing(id)` if `fromPanel`, else per G1), `announce(t(…deselected))` + (`AnnounceContext`), return true. `t` via a ref. +- [ ] `PropertiesPanel`: new optional prop `busy?: boolean` (a tracing runs). After the status actions, one row + `