# 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). Q: pen pointer rule for D6b (criterion 14)? / A: [ruling 2026-11-12, controller, after the final code review] pen follows the TOUCH rule (verdict applied in the tap's own click, only when its target has no [data-anno-id]); the mouse alone acts at pointerup and swallows the next click. Reason: on stylus platforms the click is built after the lift on the layout without the selection and could land on « Ajouter … »; cost if wrong: a pen tap after a field blur-rebuild needs a second tap. Criterion 14's « mouse/pen » reads « mouse » for pointerup, « touch and pen » for the click. Q: path of the deselect helper? / A: [ruling 2026-11-12] apps/app/src/editor/annotations/deselect.ts as the plan specified (FILE SCOPE line was loose). ## 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: MET exit=0 marker-found :: LABELS_OK 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: MET exit=0 marker-found :: HISTORY_OK 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: MET exit=0 marker-found :: READER_UNCHANGED_OK 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: MET exit=0 marker-found :: STATIC_UNIT_OK 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: MET exit=0 marker-found :: SCOPE_PUSH_OK 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. 12. [gated 2026-11-12] Escape focus (G1, owner): focus inside the properties panel → A6 (row if visible, else the drawing box); focus anywhere else → stays where it is. Escape deselects from anywhere inside the editor workspace (header and tab row included) or with the focus on the page body, only on the shown annotation body; from outside the workspace nothing happens. 13. [gated 2026-11-12] « Supprimer » (G2, owner): unchanged style (filled danger button, no icon), to the right of « Désélectionner » in a row with a top border. 14. [gated 2026-11-12] D6b decision (plan rev 3): the verdict comes from the press (pointerdown target without [data-anno-id], primary button, no second pointer anywhere in the page, no contextmenu, accumulated movement ≤ 4 px); mouse/pen apply it at pointerup and swallow the following click; touch applies it in the tap's own click and only when that click's target has no [data-anno-id]. A press that begins on the selected marker never deselects (even when its click is retargeted to the box by pointer capture). 15. [gated 2026-11-12] « Désélectionner » is not rendered while a tracing runs; a press on it keeps a typed field focused until its handler commits it, so one press always closes the panel. ## FILE SCOPE apps/app/src/catalogue/useEmptyTap.ts (new); 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/*.