From 462a22e74f50d5ebc8c8cafcc46c7a5497a7d83c Mon Sep 17 00:00:00 2001 From: bchanot Date: Thu, 19 Nov 2026 15:05:26 +0100 Subject: [PATCH] docs(docs): rev 4 fix round: trial steps, held reasons, cited tests --- docs/development/V1-2-6_OWNER_TRIAL.md | 54 ++++++++++++++++---------- docs/development/V1-2-6_UX_TESTS.md | 4 +- 2 files changed, 36 insertions(+), 22 deletions(-) diff --git a/docs/development/V1-2-6_OWNER_TRIAL.md b/docs/development/V1-2-6_OWNER_TRIAL.md index 6d1d82d5..cb6c4bef 100644 --- a/docs/development/V1-2-6_OWNER_TRIAL.md +++ b/docs/development/V1-2-6_OWNER_TRIAL.md @@ -769,26 +769,33 @@ Tablette en paysage (au moins 1 024 px de large ; en dessous, l'éditeur est en 15. Reprendre le tracé (souris, 1 280 px). Action : outil « Zone », posez quatre sommets, fermez le tracé, puis « Reprendre le tracé ». Attendu : la zone fermée reste dessinée et montre ses poignées, comme sur la planche 04 C : des sommets, des « + » au milieu des segments, et le « − » du sommet choisi. Glissez un sommet, cliquez un « + », - puis un « − », puis déplacez un sommet aux flèches. Le dessin garde la forme corrigée. Cliquez « Créer » : « Zone - créée » avec cette forme. Tant que le nom est vide, les poignées se lisent « Sommet n de cette nouvelle zone ». + puis un « − », puis déplacez un sommet aux flèches. Le dessin garde la forme corrigée. Cliquez « Revenir aux + propriétés » dans la bande, puis « Créer » dans la boîte : « Zone créée » avec cette forme. Tant que le nom est + vide, les poignées se lisent « Sommet n de cette nouvelle zone ». Une forme reprise de plus de 40 sommets n'a pas + de poignées, et la bande ne dit pas pourquoi : seuls « Revenir aux propriétés » et « Abandonner » restent. 16. Clavier Mac (ou toute touche Retour arrière). Action : sélectionnez « Vertèbres thoraciques », donnez le focus à un sommet par Tab. Appuyez sur Retour arrière : le sommet est retiré, le suivant est choisi. Au minimum de trois sommets, la touche est refusée et le message le dit. Faites Cmd+Z : le sommet revient. Sur ce même sommet, qui garde le focus, appuyez de nouveau sur Retour arrière : il est retiré une seconde fois. Appuyez sur « + » (la touche, pas le bouton) : un sommet est inséré après le sommet focalisé. Avec un lecteur d'écran, le groupe se lit « Sommets de Vertèbres thoraciques ». -17. Tablette : le focus après chaque geste. Action : faites une série (le curseur « Taille » ou des flèches sur une - poignée), puis touchez une poignée ; recommencez en touchant ailleurs sur le dessin, puis - « Déplacer … », « Redessiner », « Désélectionner » et « − ». Attendu : le focus n'est jamais perdu. La touche Tab - suivante, ou une flèche, agit là où vous l'attendez. Seul un vrai iPad sous Safari prouve ce point : Chromium donne - lui-même le focus à l'élément touché, ses tests n'en disent rien. +17. Tablette avec un clavier physique : le focus après chaque geste. Les flèches demandent un clavier ; un doigt sur + le curseur « Taille » enregistre dès qu'il se lève, sans série en attente. Action : faites une série de flèches + sur une poignée ou sur le curseur, puis touchez une poignée ; recommencez en touchant ailleurs sur le dessin, puis + « Déplacer … », « Redessiner », « Désélectionner », « − », un outil de la colonne et une pastille de vue. + Attendu, sur ces chemins : le focus n'est jamais perdu. La touche Tab suivante, ou une flèche, agit là où vous + l'attendez. Seul un vrai iPad sous Safari prouve ce point : Chromium donne lui-même le focus à l'élément touché, + ses tests n'en disent rien. 18. Tablette et fenêtres de 1 024, 1 180 et 1 280 px : la bande qui reste en haut. Action : faites défiler la page avec une annotation sélectionnée. Attendu : la bande reste entière sous la barre du haut, rien ne bouge et rien n'est caché derrière. Un Tab sur une commande de la bande ou sur un lien de la barre ne fait pas défiler la page. -19. Refaire retenu. Action : pendant une création (outil « Point » ou « Zone », avant « Créer »), donnez le focus à - « Refaire » puis à « Défaire » : un lecteur d'écran lit la raison. Appuyez dessus : la raison s'affiche sous le - dessin et rien d'autre ne se passe. Puis abandonnez la création, déplacez un point par une série de flèches sans la - valider et cliquez « Refaire » à la souris : la raison s'affiche, la série reste en attente. +19. Refaire retenu. Préparez quelque chose à défaire et à refaire : créez un point, déplacez-le d'un pas aux flèches + validé par Entrée, puis « Défaire ». Action : outil « Zone », posez un sommet (la boîte de « Point » s'ouvre tout + de suite et cache l'en-tête : prenez « Zone »), puis donnez le focus à « Refaire » puis à « Défaire » : un lecteur + d'écran lit la raison. Appuyez dessus : la raison s'affiche sous le dessin et rien d'autre ne se passe. Puis + « Annuler le tracé », déplacez le point par deux flèches sans valider et cliquez « Refaire » à la souris : la + raison s'affiche, la série reste en attente. Cliquez « Défaire » : la série est annulée, et « Refaire » remet le + déplacement d'un pas. Sans rien à refaire, « Refaire » reste grisé sans phrase. #### Acceptés pendant la construction Vous avez accepté ces quatre comportements ; ils ne sont plus à juger : @@ -842,12 +849,17 @@ Interprétations et écarts par rapport aux planches : message « deux doigts » s'affiche quand le doigt se lève, pas dès le début du glisser. - Ctrl+Z défait maintenant aussi quand le focus est sur le curseur « Taille » ou une case à cocher ; seuls les champs de texte gardent leur propre annulation. -- « Refaire » attend la fin de la modification en cours (un déplacement, un redessin ou des pas aux flèches non - enregistrés), et « Défaire » comme « Refaire » sont retenus pendant une création. Les deux phrases exactes : - « Refaire attend la fin de la modification en cours : validez-la ou annulez-la. » et « Indisponible pendant une - création : créez l'annotation ou abandonnez-la. » Un appui sur un bouton retenu affiche la raison sous le dessin - et ne fait rien d'autre ; un appui à la souris n'enregistre plus une série en attente. Ctrl+Z ou Cmd+Z pendant la - retenue reste muet. Sur un autre onglet, un appui n'affiche rien : la raison est seulement lue au focus. +- « Refaire » est suspendu pendant une modification en cours (un déplacement, un redessin ou des pas aux flèches + non enregistrés) et pendant une création ; « Défaire » est retenu pendant une création. Une raison ne s'affiche que + si le bouton servirait sans cette cause : sans rien à refaire (ou à défaire), le bouton reste grisé sans phrase, + comme avant. Les trois phrases exactes : « Refaire est suspendu pendant la modification en cours : annulez-la avec + Défaire pour pouvoir refaire. », « Refaire est suspendu pendant une création : abandonnez-la pour pouvoir + refaire. » et « Indisponible pendant une création : créez l'annotation ou abandonnez-la. » Un appui sur un bouton + retenu affiche la raison sous le dessin et ne fait rien d'autre ; un appui à la souris n'enregistre plus une série + en attente. « Défaire » pendant une modification en cours l'annule sans l'enregistrer, à la souris, au doigt ou + par Ctrl+Z, et ce qui était à refaire le reste. Quitter la poignée par Tab enregistre la série, comme avant : il + n'y a alors plus rien à refaire. Ctrl+Z ou Cmd+Z pendant une création reste muet. Sur un autre onglet, un appui + n'affiche rien : la raison est seulement lue au focus. - La touche « + » sur un sommet focalisé insère un sommet après lui, et Retour arrière retire comme Suppr. Après un Ctrl+Z, ces touches agissent sur la poignée qui a le focus. « + » sur la boîte du dessin zoome toujours. - La bande reste collée sous la barre du haut à partir de 1 024 px. La loupe peut se peindre par-dessus la bande près @@ -856,9 +868,11 @@ Interprétations et écarts par rapport aux planches : est vide (« Sommets de cette nouvelle zone »). - Un appui sur « − » à la souris choisit et focalise le sommet suivant, comme Suppr au clavier ; à la souris, la bulle « − » réapparaît sur ce sommet. -- Au toucher, une création commencée au doigt donne le focus aux commandes du tracé (au clavier il reste sur la boîte - du dessin). Un glisser au doigt choisit le sommet glissé dès le début du glisser. Après un toucher sur un point qui - ouvre sa boîte de propriétés, la fermer rend le focus à la rangée de l'annotation. +- Sous Safari, une création commencée au doigt donne le focus aux commandes du tracé (à vérifier pendant l'essai ; + sous Chromium l'outil touché le garde, puis la boîte du dessin le prend ; au clavier il reste sur la boîte du + dessin). Depuis les commandes du tracé, Entrée et Retour arrière n'atteignent pas les touches du tracé. Un glisser + au doigt choisit le sommet glissé dès le début du glisser. Après un toucher sur un point qui ouvre sa boîte de + propriétés, la fermer rend le focus à la rangée de l'annotation. - Les poignées d'une zone portent maintenant le nom de la zone, lu par les lecteurs d'écran : « Sommet 3 de Vertèbres thoraciques », « Ajouter un sommet après le sommet 3 de … », « Retirer le sommet 3 de … », et leur groupe s'appelle « Sommets de … » (liste complète ci-dessous). diff --git a/docs/development/V1-2-6_UX_TESTS.md b/docs/development/V1-2-6_UX_TESTS.md index e31418a5..cc86d1af 100644 --- a/docs/development/V1-2-6_UX_TESTS.md +++ b/docs/development/V1-2-6_UX_TESTS.md @@ -55,9 +55,9 @@ Implemented (plan `.claude/tasks/plans/2026-11-17-v1-2-6-u2.md`, rev 4; boards ` | Kind | Tests | |---|---| | Unit (tables) | the press machine (`annotations.press.test.ts`): slop per kind (4, 6 and 10 CSS px), click and drag decisions, handle priority (vertex over « − » over « + », nearest first), double click within 400 ms and 8 px opens the dialog and never inserts, a second pointer cancels; slider stops, most-used radius, snap within 8 CSS px, range (`pointSize`); midpoint insert after the segment start, « − » refused at 3 vertices (`message.vertex_min`), vertex move, no-op move, the 40-vertex cap, « + » hidden under two hit radii (`polygonEdit`); Escape action (`escape`); `missingFields` names only the missing fields in form order; keyboard map (arrows by 0.5 % of the frame's longer side, Shift ×10, Insert and Delete on a vertex, Backspace while tracing, Enter, Escape, roving focus); arrows pan only when the box itself is focused (`useFraming`, catalogue defaults unchanged); two pointers translate without scaling (`twoPointerPan`) | -| Unit (state) | every preview, keyboard series and chosen vertex carries the `documentText` it was computed on, and a stale stamp is refused (`annotations.workStore.test.ts`); a preview is cancelled and restored, never committed, on undo, document replacement, tab change and a second pointer; redo is held (the header « Refaire » `aria-disabled`, Ctrl+Shift+Z inert) while a move mode, a redraw or uncommitted arrow or slider steps are pending, so the pending work is kept, never dropped (`editor-zone-edit.test.tsx` « final review I-1 »); a held « Refaire » or « Défaire » (a creation holds both) carries its reason as the accessible description, a press shows the reason in the message line and does nothing else (a mouse press no longer commits a pending series), Ctrl+Z during a hold is silent, and another tab shows no message (`holdOf`, `HistoryButtons.tsx`); « + » and Backspace on a focused vertex handle insert and remove like Insert and Delete, and after an undo the keys act on the focused handle (`useZoneEdit.ts`); a resumed trace gets the polygon handles on its pending shape, named « cette nouvelle zone » or « ce nouvel accès » while the form has no name, with no interior drag and no handle above 40 vertices (`creationWork.ts`); an undo with a move mode, a slider or a series pending only cancels the preview (R-13); during a creation undo is inactive and « Défaire » is hidden (A12); the message line: « Point déplacé · Défaire » calls the same `undo()` as the header, any commit, undo or redo closes it, a refusal is `role="alert"` without « Défaire », 6 s, a mouse hover or the keyboard focus inside the line pauses it (WCAG 2.2.1) and a touch does not; the hint after a futile finger drag only when the line is free and never after a two-finger gesture worked (R-1); the slider commits once on release (history depth after a keyboard walk); the strip keeps a fixed height and truncates a long name before the status; dialogs mounted outside `EditOnly`: the width flip and the mode flip keep the draft, disable the save and commit nothing (R-14); a creation, a started move mode or a started redraw asks before a tab, a section, a view chip, a tool, Back, Escape, sign-out or leaving the editor, and a document change made elsewhere announces the dropped work (R-12, R-13); `Dialog` `anchor`, a click on the veil does nothing (R-6); undo history cap 8 MiB, about 47 equine steps (R-15) | +| Unit (state) | every preview, keyboard series and chosen vertex carries the `documentText` it was computed on, and a stale stamp is refused (`annotations.workStore.test.ts`); a preview is cancelled and restored, never committed, on undo, document replacement, tab change and a second pointer; redo is held (the header « Refaire » `aria-disabled`, Ctrl+Shift+Z inert) while a move mode, a redraw or uncommitted arrow or slider steps are pending, so the pending work is kept, never dropped (`editor-zone-edit.test.tsx` « final review I-1 »); a held « Refaire » or « Défaire » (a creation holds both) carries its reason as the accessible description only when its cause alone holds it (something to redo or to undo), a press shows the reason in the message line and does nothing else (a mouse press no longer commits a pending series), a mouse or touch press on « Défaire » over pending work only cancels it and keeps the redo stack, Ctrl+Z during a hold is silent, and a press while another tab is shown leaves the hidden line empty and keeps the description (`holdOf`, `HistoryButtons.tsx`, `editor-history-buttons.test.tsx`); « + » and Backspace on a focused vertex handle insert and remove like Insert and Delete, and after an undo the keys act on the focused handle (`useZoneEdit.ts`); a Safari tap (no focus move) on a tool or a view chip after a keyboard series commits it and lands the focus on the pressed button, never on `body` (`editor-zone-edit.test.tsx`); a resumed trace gets the polygon handles on its pending shape, named « cette nouvelle zone » or « ce nouvel accès » while the form has no name, with no interior drag and no handle above 40 vertices (`editor-creation-dialog.test.tsx`); an undo with a move mode, a slider or a series pending only cancels the preview (R-13); during a creation undo is inactive and « Défaire » is hidden (A12); the message line: « Point déplacé · Défaire » calls the same `undo()` as the header, any commit, undo or redo closes it, a refusal is `role="alert"` without « Défaire », 6 s, a mouse hover or the keyboard focus inside the line pauses it (WCAG 2.2.1) and a touch does not; the hint after a futile finger drag only when the line is free and never after a two-finger gesture worked (R-1); the slider commits once on release (history depth after a keyboard walk); the strip keeps a fixed height and truncates a long name before the status; dialogs mounted outside `EditOnly`: the width flip and the mode flip keep the draft, disable the save and commit nothing (R-14); a creation, a started move mode or a started redraw asks before a tab, a section, a view chip, a tool, Back, Escape, sign-out or leaving the editor, and a document change made elsewhere announces the dropped work (R-12, R-13); `Dialog` `anchor`, a click on the veil does nothing (R-6); undo history cap 8 MiB, about 47 equine steps (R-15) | | Core | the per-view minimum visible radius (`PreviewState.min_point_radius`) equals the `marker_too_small` threshold on the equine views and on edge frames (`sheet_preview.rs`, `editor-min-point-radius.test.ts`) | -| E2E mouse | drag a vertex, « + », « − », zone drag on a selected zone, redraw accepted, redraw refused by `interior_too_small` keeps and restores the old shape, undo and redo of each (`editor-zones.spec.ts`); a point: handle drag, size by a click on the track, the move mode (`editor-annotations.spec.ts`); the properties dialog opens over the right column and never over the drawing, a click on the veil does nothing, a double click on the selected zone opens it and inserts no vertex, a typed form then Back asks, a width crossing below 1 024 px keeps the draft (`editor-properties.spec.ts`); « Défaire » in the message line undoes the same entry as the header button, which carries the accessible name « Défaire la dernière modification » (T15; EN « Undo the last change ») | +| E2E mouse | drag a vertex, « + », « − », zone drag on a selected zone, redraw accepted, redraw refused by `interior_too_small` keeps and restores the old shape, undo and redo of each (`editor-zones.spec.ts`); a point: handle drag, size by a click on the track, the move mode (`editor-annotations.spec.ts`); the properties dialog opens over the right column and never over the drawing, a click on the veil does nothing, a double click on the selected zone opens it and inserts no vertex, a typed form then Back asks, a width crossing below 1 024 px keeps the draft (`editor-properties.spec.ts`); « Défaire » in the message line undoes the same entry as the header button, which carries the accessible name « Défaire la dernière modification » (T15; EN « Undo the last change »); during a held arrow series a mouse press on « Défaire » cancels it and « Refaire » restores the earlier move (`editor-annotations.spec.ts`); a Tab and Shift+Tab walk over the drawing place's native controls, and a keyboard Delete whose next vertex starts under the strip, land below the strip at 1 024, 1 180 and 1 280 px (`editor-geometry.spec.ts`) | | E2E touch (`hasTouch`, 1 024, 1 180, 1 280 px; CDP `Input.dispatchTouchEvent`) | one finger drags a vertex and the point under the loupe; every handle hit circle is at least 44 px; one finger off the handles moves nothing and shows the hint once, with no hint over a page scroll; two fingers zoom and pan; finger 1 on a vertex handle then finger 2: the drag is cancelled, the shape restored, nothing committed, the pinch zooms (Review Focus 1); the move mode by a finger; a tap on the selected shape opens the dialog and it stays open (Review Focus 5), with a chosen vertex it unchooses; the trace closes from a finger within 22 px; page scroll over the canvas with a selection and outside it (`editor-touch.spec.ts`, `editor-properties.spec.ts`, `editor-deselect.spec.ts`) | | Layout (A14) | `expectNoShift` (`e2e/support/layout.ts`) at 1 024, 1 180 and 1 280 px: no box of the canvas, the strip, the aside or the header moves, `scrollHeight` and the scrollbar gutter are unchanged, and the layout-shift sum is zero around selection, strip content, a message showing and expiring, the hint, a dialog opening and closing, mode entry and exit, and the first commit's save line; `scrollbar-gutter: stable` on the editor page only (`editor-annotations.spec.ts`) | | Keyboard | create a zone, add and remove a vertex, move the zone, validate, without a pointer; « + » inserts and Backspace removes on a focused vertex, Backspace after an undo acts on the same focused handle; Ctrl+Z on a focused handle after arrow moves only cancels the preview and a later Enter commits nothing stale; after undoing « + », « − » never removes the wrong vertex; « Désélectionner » commits a pending series |