diff --git a/docs/design/v1-2-6-u2-chips/README.md b/docs/design/v1-2-6-u2-chips/README.md index f0a3f61c..cd2a83a0 100644 --- a/docs/design/v1-2-6-u2-chips/README.md +++ b/docs/design/v1-2-6-u2-chips/README.md @@ -2,7 +2,7 @@ Décision du propriétaire du 2026-11-20 : les puces de vue de la colonne du dessin ne passent plus à la ligne ; elles tiennent sur une seule ligne qui défile de côté. Le propriétaire a validé les choix V1 à V6 le 2026-11-21, avec deux -précisions (V3, V4). Cette planche les montre avant tout code. Rien n'est implémenté. +précisions (V3, V4). Cette planche les montre avant tout code. Implémenté le 21 novembre 2026 (voir docs/development/V1-2-6_UX_TESTS.md). | Fichier | Contenu | |---|---| diff --git a/docs/development/V1-2-6_OWNER_TRIAL.md b/docs/development/V1-2-6_OWNER_TRIAL.md index d303e130..341b801e 100644 --- a/docs/development/V1-2-6_OWNER_TRIAL.md +++ b/docs/development/V1-2-6_OWNER_TRIAL.md @@ -846,6 +846,13 @@ Tablette en paysage (au moins 1 024 px de large ; en dessous, l'éditeur est en pose du côté libre du sommet, à l'écart de ses deux segments et des « + » affichés, entière à l'écran. Les sommets et les « + » sont plus légers qu'avant mais restent assez grands pour le doigt. Touchez un « + » : un sommet est ajouté ; « Défaire » le retire. Notez tout sommet dont la bulle cache un « + » ou sort de l'écran. +23. La rangée des vues au doigt. Action, sur la tablette, avec la fiche équine (plusieurs vues aux noms longs) : + faites glisser la rangée des puces avec un doigt, puis un coup de doigt rapide ; commencez un glissé sur un + chevron ; commencez un pincement (zoom) sur la rangée ; touchez une puce à moitié cachée sous un dégradé ; faites un + double toucher sur une puce. Attendu : la rangée défile et la page ne bouge pas, aucune vue ne s'ouvre pendant le + glissé ; un glissé qui commence sur un chevron ne défile pas (zone morte, attendu) ; le pincement zoome la page + sans ouvrir de vue ; la puce à moitié cachée s'ouvre au premier toucher ; le double toucher n'ouvre que cette vue, + jamais sa voisine. Notez tout geste qui ouvre une autre vue que celle touchée. #### Acceptés pendant la construction Vous avez accepté ces cinq comportements ; ils ne sont plus à juger : diff --git a/docs/development/V1-2-6_UX_TESTS.md b/docs/development/V1-2-6_UX_TESTS.md index 9caa5887..fed101aa 100644 --- a/docs/development/V1-2-6_UX_TESTS.md +++ b/docs/development/V1-2-6_UX_TESTS.md @@ -61,13 +61,13 @@ Implemented (plan `.claude/tasks/plans/2026-11-17-v1-2-6-u2.md`, rev 4 then rev | 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`) | | Held reason bubble (D1, criterion 33) | unit (`editor-held-bubble.test.tsx`, `editor-history-buttons.test.tsx`): a press by click, Enter, Space, mouse and touch shows the reason in a portalled `position: fixed` bubble, with and without the strip's commands to clear; one announcement per press through an always-mounted `role="status"` region, `aria-describedby` kept; closing on the hold ending, a tab change, blur, a press elsewhere, a scroll, a wheel, a touchmove, a dialog opening and Escape; the first Escape closes the bubble alone, the second reaches the creation question or drops the pending preview, in a text field Escape also reaches the field; e2e (`editor-annotations.spec.ts`) at 1 024, 1 180 and 1 280 px: the bubble inside the window, under the bar, within 8 px under its button, at most 288 px wide, over neither « Défaire » nor the strip's commands, `expectNoShift`, `scrollWidth` unchanged, axe open, repeated scrolled and from the keyboard, the scroll awaited by a helper that waits for three still animation frames | -| Pinned drawing column (Task 17, criterion 32; one row of chips, several rows: see the criterion 32 row below) | `editor-geometry.spec.ts` at 1 024, 1 180 and 1 280 px: at each scroll step the column's top is below the strip, its bottom in the window once stuck, the canvas painted at its top centre, its size constant, no sideways scroll; a focus never scrolls the page (« Défaire », a chip, a handle, the canvas box) and the add button, below the fold, is revealed below the strip; Delete and Insert on a pinned vertex keep the page still; a row selection moves neither the page nor the drawing; at 1 180 × 700 the canvas is capped and the column fits the window; at 1 024 × 600 (below 658 px) nothing is pinned and the Task 14 focus tests run there; `editor-deselect` and `editor-journey` presses no longer scroll to the page top | +| Pinned drawing column (Task 17, criterion 32; one row of chips: see the criterion 32 row below) | `editor-geometry.spec.ts` at 1 024, 1 180 and 1 280 px: at each scroll step the column's top is below the strip, its bottom in the window once stuck, the canvas painted at its top centre, its size constant, no sideways scroll; a focus never scrolls the page (« Défaire », a chip, a handle, the canvas box) and the add button, below the fold, is revealed below the strip; Delete and Insert on a pinned vertex keep the page still; a row selection moves neither the page nor the drawing; at 1 180 × 700 the canvas is capped and the column fits the window; at 1 024 × 600 (below 658 px) nothing is pinned and the Task 14 focus tests run there; `editor-deselect` and `editor-journey` presses no longer scroll to the page top | | Trial adjustments, add buttons (contract `.claude/tasks/contracts/2026-11-20-u2-trial-adjustments-1259.md`) | unit (`editor-add-buttons.test.tsx`): a pointer click on « Ajouter un point » or « Ajouter une zone » arms the tool, says where to click and opens no dialog; a click in the drawing places the point there and opens its dialog; abandoning it focuses the button; « Replacer le point » then a second click keeps the origin; a second click on the armed button disarms it, and a started zone asks first; a double-click leaves the tool armed; Enter and Space keep the centre path (C7); screen-reader path: the armed tool is announced, then Enter on the drawing places at the centre (point and zone), and with the Select tool Enter creates nothing; a redraw lends the zone tool and « Ajouter une zone » then arms a new zone; the three announcements exist in both languages. E2E mouse (`editor-annotations.spec.ts`, 1 024, 1 180, 1 280 px): a click arms « Ajouter un point », pressed like the tool, nothing moves. E2E touch (`editor-touch.spec.ts`, 1 180 px): a tap arms it, a tap in the drawing opens the dialog, the button is 44 px tall | | Open-side bubble (« − ») | unit (`annotations.removeBubble.test.ts`): sweep over the six equine polygons of the main view at zoom 1 to 6, clear of every shown « + » and of its own vertex, inside the frame; a control showing the former centre fails the criterion (thoracic, vertex 2); the part on screen when zoomed and panned, an off-screen vertex not forced, a vertex rung kept clear of another vertex on the open ray. E2E touch (`editor-touch.spec.ts`): on « Vertèbres thoraciques » zoomed, every chosen vertex keeps its bubble clear, on screen and light; a tap on « + » adds, « Défaire » restores | | Device-independent geometry (criterion 8) | `annotations.pointSize.test.ts` and the `insertMidpoint` tests of `annotations.polygonEdit.test.ts`; the handle sizes are read only by `HandleLayer` and `ZoneHandles` | | Criterion 32 on the final code (Task 7 Step 4b), 2026-11-20, superseded by the three rows below | with eight long-named detail views the chips take 3 to 5 rows and the stuck column overflows the window bottom. Measured overflow: 1 024 × 768, 5 rows, 64.3 px; 1 180 × 820, 3 rows, 53.3 px; 1 180 × 700, 3 rows, 76.0 px; 1 280 × 800, 5 rows, 24.3 px. The canvas size and the absence of sideways scroll hold; near the page end the column top also rises above the strip bottom. The test is committed as `test.fixme` in `editor-geometry.spec.ts` (« owner decision pending (criterion 32, chips on several rows) »). The pinned budget has counted ONE row of chips since Task 17 (pre-existing: at 1 280 px the add row did not change and still overflows 24.3 px). With one row (the equine sheet) the whole `editor-geometry.spec.ts` passes, short windows included. Decision pending: the budget for chips on several rows (options: raise the pinned budget per chip row (measured), let the chips scroll in one row, or accept the limit) | -| Criterion 32 with one scrolling row (2026-11-21, board `v1-2-6-u2-chips/`, owner tablet check pending) | the chips sit in one horizontally scrolling row: the criterion 32 test in `editor-geometry.spec.ts` (`test.fixme` removed) passes at 1 024 × 768, 1 180 × 820, 1 180 × 700 and 1 280 × 800 with eight long-named views: one chip top, the row overflows inside itself (`scrollWidth > clientWidth`), the scroll walk green. The real DOM parts, read back at 1 180 × 820 and 1 280 × 800, are 162 px and 154 px, equal to the CSS budget (10.125rem and 9.625rem). Runs, all `--workers=2`, 0 failed (editor-geometry, editor-annotations and editor-touch ran on 190471d4, the other specs on 068ecd57; a dated full pass at HEAD follows): editor-geometry 59 passed, editor-annotations 23, editor-touch 15, editor-drawings 3, editor-shell-layout 13, editor-access 9, editor-shell-crossing 12; unit app 2 227 passed | -| View row tests (2026-11-21) | unit `annotations.viewRow.test.ts` (reveal, hint state) and `editor-view-row.test.tsx`: a guarded view change refused with « Continuer » leaves the active view and `aria-pressed` unchanged and runs no activation reveal; the row is revealed again on the active chip when the hidden edit body is shown again; a language switch with long names recomputes the hints; a removed view whose chip had focus leaves a tab stop; a keyboard focus entering a chip from outside the row (`:focus-visible`) reveals it, a pointer focus never does. E2E (`editor-geometry.spec.ts`, `editor-shell-layout.spec.ts`): the view row at 1 024 × 768, on a phone (375), under the sticky strip, read-only (reviewer, 1 280 × 800), a pointer press on a peeking chip activates it at the first click without scrolling the row, a swipe starting on a chip activates nothing, language switch en to fr | +| Criterion 32 with one scrolling row (2026-11-21, board `v1-2-6-u2-chips/`, owner tablet check pending) | the chips sit in one horizontally scrolling row: it scrolls with a finger, a Shift + wheel, a tilt wheel or a trackpad horizontal scroll (« wheel » below means these: a plain vertical wheel does not move a horizontal row); the criterion 32 test in `editor-geometry.spec.ts` (`test.fixme` removed) passes at 1 024 × 768, 1 180 × 820, 1 180 × 700 and 1 280 × 800 with eight long-named views: one chip top, the row overflows inside itself (`scrollWidth > clientWidth`), the scroll walk green. The real DOM parts, read back at 1 180 × 820 and 1 280 × 800, are 162 px and 154 px, equal to the CSS budget (10.125rem and 9.625rem). Runs, all `--workers=2`, 0 failed (editor-geometry, editor-annotations and editor-touch ran on 190471d4, the other specs on 068ecd57; a dated full pass at HEAD follows): editor-geometry 59 passed, editor-annotations 23, editor-touch 15, editor-drawings 3, editor-shell-layout 13, editor-access 9, editor-shell-crossing 12; unit app 2 227 passed | +| View row tests (2026-11-21) | unit `annotations.viewRow.test.ts` (reveal, hint state) and `editor-view-row.test.tsx`: a guarded view change refused with « Continuer » leaves the active view and `aria-pressed` unchanged and runs no activation reveal; the row is revealed again on the active chip when the hidden edit body is shown again; a language switch with long names recomputes the hints; a removed view whose chip had focus leaves a tab stop; a keyboard focus entering a chip from outside the row (`:focus-visible`) reveals it, a pointer focus never does. A reveal is judged against where a slide in flight lands (a reversed arrow, an arrow after a chevron page), and a repeated click (`detail` above 1) on a chip is ignored. E2E (`editor-geometry.spec.ts`, `editor-shell-layout.spec.ts`): the view row at 1 024 × 768, on a phone (375), under the sticky strip, read-only (reviewer, 1 280 × 800), a pointer press on a peeking chip activates it at the first click without scrolling the row, a swipe starting on a chip activates nothing, language switch en to fr | | Residual risks (one scrolling row; the three residuals owner-accepted 2026-11-21, the two rulings below, accepted by the owner 2026-11-21) | a row scroll closes an open « Défaire / Refaire » hold bubble (closed by any scroll, owner rule kept 2026-11-20); the chevron hit areas are a swipe dead zone at the row ends; some focus behaviours are proven only in Chromium (Tab entry clear of the fades relies on `scroll-padding-inline` plus the `:focus-visible` reveal). Test scope (controller ruling during execution, accepted by the owner 2026-11-21): the language-switch vertical check is measured below the draft header, which wraps per language; the read-only twin's shown-again placement is checked with the properties dialog open; touch fling and inertia, a drag starting under a chevron and pinch-zoom are left for the owner's tablet trial. Deviation from plan rev 3 (controller ruling during execution, accepted by the owner 2026-11-21): `scroll-padding-inline` alone left a chip partly under the end fade on Tab entry, so a chip receiving keyboard focus from outside the row is revealed; a pointer focus never reveals, so the row never scrolls at a press | | Residual risks (trial adjustments) | assistive technologies activating with `detail ≥ 1` arm the tool instead of placing at the centre (mitigated 2026-11-21 by « Placer au centre » in the add row (works whatever the activation)); a fast double tap on the tablet browser: counted as a double-click (stays armed) or as two taps (arms then disarms), not verified on the device; the canvas box can be scrolled by a focus (overflow-hidden), the bubble's screen bound then lags (pre-existing, pointer choices use `preventScroll`) | | Gates of the trial adjustments (head 1f9ed523, 2026-11-20) | `pnpm typecheck && pnpm lint && pnpm test:run` green (app 154 files, 2 185 tests); `pnpm e2e:ui` 253 passed; shell suite on the 33 baseline specs by full path, never `editor-equine.spec.ts`, `--workers=2`: 352 passed, 247 skipped, 13 failed (28.1 min), the 13 failures being exactly the 13 of the 3d6aacad baseline by test name, none new (environment failures do not block the manual trial, owner decision D5) |