docs(docs): UX_TESTS pin threshold and ruling header

This commit is contained in:
bchanot committed 2026-11-21 22:16:51 +01:00
1 parent 8c4c980686
commit 295413c5f9
2 files changed
+3 -3

No files matched your search

@@ -469,7 +469,7 @@ apps/app/src/components/shell/AppLayout.tsx, apps/app/src/state/leaveGuardStore.
### Owner decisions 2026-11-20 (addendum 3)
- Criterion 32: validated by the owner on the trial build; REOPENED by the owner (2026-11-20) until re-verified on the final code (the 44 px add buttons move the pinned thresholds): short windows and several rows of view chips (plan Task 7 Step 4b).
- Criterion 32 re-verified on the final code (2026-11-20): one row of view chips (equine sheet) passes, whole editor-geometry spec including short windows; several rows (eight long-named views, 3 to 5 rows) FAIL: the stuck column overflows the window bottom by 64.3 px (1 024 × 768), 53.3 px (1 180 × 820), 76.0 px (1 180 × 700), 24.3 px (1 280 × 800); the test is committed as test.fixme. The pinned budget counts one row of chips since Task 17 (at 1 280 px neither the add row nor the budget changed). Criterion 32 stays OPEN, owner decision pending (superseded below).
- Criterion 32 (2026-11-21): the owner chose one horizontally scrolling chip row (board `v1-2-6-u2-chips/`). Implemented (commits 9148bb27 to 190471d4): the criterion 32 test passes at 1 024 × 768, 1 180 × 820, 1 180 × 700 and 1 280 × 800 (one chip top, the row overflows inside itself, scroll walk green); real DOM parts 162 / 154 px match the CSS budget. Residuals accepted by the owner: a row scroll closes an open « Défaire / Refaire » hold bubble; the chevron hit areas are a swipe dead zone at the row ends; some focus behaviours proven only in Chromium. Controller rulings during execution, submitted to the owner (not owner-accepted): the keyboard-focus reveal deviation and the language-switch vertical measurement below the draft header. Pending the owner's final check on the tablet (fling, drag under a chevron, pinch-zoom). Tests: `docs/development/V1-2-6_UX_TESTS.md`.
- Criterion 32 (2026-11-21): the owner chose one horizontally scrolling chip row (board `v1-2-6-u2-chips/`). Implemented (commits 9148bb27 to 190471d4): the criterion 32 test passes at 1 024 × 768, 1 180 × 820, 1 180 × 700 and 1 280 × 800 (one chip top, the row overflows inside itself, scroll walk green); real DOM parts 162 / 154 px match the CSS budget. Residuals accepted by the owner: a row scroll closes an open « Défaire / Refaire » hold bubble; the chevron hit areas are a swipe dead zone at the row ends; some focus behaviours proven only in Chromium. Controller rulings during execution, accepted by the owner 2026-11-21: the keyboard-focus reveal deviation and the language-switch vertical measurement below the draft header. Pending the owner's final check on the tablet (fling, drag under a chevron, pinch-zoom). Tests: `docs/development/V1-2-6_UX_TESTS.md`.
- Criterion 12 reworded: « The add buttons: a pointer press (click or tap) arms their tool, the
shape is placed or traced on the drawing and the dialog opens itself; a keyboard press (Enter,
Space) places the shape at the centre and opens the dialog; a second single pointer press on an
+2 -2
View File
@@ -61,14 +61,14 @@ 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 644 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, 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 |
| 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 |
| Residual risks (one scrolling row; the three residuals owner-accepted 2026-11-21, the two rulings below submitted to the owner) | 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 (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) |
| « Placer au centre » (2026-11-21) | the fourth slot of the add row, reserved, shown while a creation tool is armed and nothing is in progress (frame built, a category, a detail view for a link); one placement function shared with Enter on the drawing and the add buttons' keyboard path; unit `editor-add-buttons.test.tsx` (« Placer au centre » describe: availability, activation by click / Enter / Space / detail 0, focus return, stale hint, guards proven by mutation including the unbuilt-drawing frame guard, exact fr/en strings), e2e `editor-annotations.spec.ts` (1 024 / 1 180 / 1 280 px: shown, four buttons on one line, no shift, opens the dialog; 1 280 px double-click keeps the dialog) |