Files
faunosteo/apps/app/tests/unit/annotations.workStore.test.ts
T
bchanot 6211046537 feat(editor): vertex handles, insert and remove, zone move, redraw
U2 Task 5. A selected polygon gets its vertex, « + » and « − » handles
(R-9, hidden « + » under two hit radii, R-18 zoom hint in the strip),
the handle cap at 40 (R-7), vertex drag and keys, the move mode on the
zone or the chosen vertex, « Redessiner » as a redraw mode kept in step
with its tracing (R-12 guard, R-13 drop), close radius in CSS px
(R-11). The numeric group leaves the properties panel (D1).

Removed or rewritten assertions (numeric group -> replacement):
- tab « shows its exact stored numbers » (Centre x field) -> the overlay
  selection circle's cx attribute, same exact value.
- tab « a numeric edit » x3 -> « an edit on the drawing »: Enter on the
  handle without a step commits nothing, a step + Enter commits once;
  a refused handle drag keeps the stored shape then a drag inside the
  frame repairs it (issues gone); Escape drops a pending series.
- tab C26 « Centre x 15 » -> overlay cx 15.
- tab C32 unmeasured « Centre x as text » -> no handle, no field.
- tab « adds and removes a vertex as part of the whole group » -> « + »
  then « − » on the drawing; « never offers to remove below three » ->
  « − » aria-disabled at 3.
- tab H8 « refused Remplacer drops the tracing » -> keeps it open with
  « Fermeture refusée » (board 33 A); « refused vertex add/remove stay
  non appliqué » -> a refused vertex drag restores the shape exactly.
- tab Désélectionner and D6b (typed Centre x committed, refused, undone)
  x6 and strip « a new commit replaces the message » -> the same with
  the Nom (FR) field (a blank name is the refused value).
- focus-request « Centre x 20 » -> overlay cx 20.
- escape « strip commands keep their Escape » -> a redraw: Escape on the
  strip or the box cancels it (R-12 row 4); kept for a new zone tracing.
- keep-alive « Remplacer tracing kept across Aller à » -> ended by a tab
  when empty, asked once a vertex is placed (R-12).
- e2e annotations: numeric cx edit + undo/redo -> handle keys + undo/
  redo; jitter/drag and Task 4 point reads -> overlay attributes (the
  stored place during the mode -> overlay-old-place); keyboard-only cy
  and vertex x typed -> handle and vertex keys.
- e2e deselect: Centre x typed/refused/committed -> Nom (FR).
- e2e geometry, shell-crossing: Centre x/cy reads -> overlay attributes.
- e2e journey: cx +3 and vertex x +4 typed -> 3 and 4 arrow steps + Enter;
  a far typed value + revert -> a far handle drag refused.
- e2e equine latency: typed cx rounds -> handle arrow + Enter rounds.
2026-11-17 20:24:49 +01:00

145 lines
4.7 KiB
TypeScript

/** U2 Task 2: the annotation work store and its stale stamp (R-13). */
import { afterEach, describe, expect, it } from 'vitest'
import { vi } from 'vitest'
import { answerDrawing, guardDrawing } from '@/editor/annotations/drawingGuard'
import {
cancelPending,
dropStale,
guardWork,
resetWork,
setModePreview,
startMove,
useAnnotationWork,
type Preview,
} from '@/editor/annotations/workStore'
import { useEditorStore } from '@/editor/state/editorStore'
const preview = (base: string): Preview => ({
annotationId: 'a',
geometry: { type: 'circle', cx: 1, cy: 2, r: 3 },
base,
source: 'move',
})
afterEach(() => {
resetWork()
useEditorStore.setState({ documentText: '', session: 0 })
})
describe('dropStale (R-13)', () => {
it('drops what was computed on another text, keeps what was computed on this one', () => {
useAnnotationWork.setState({
preview: preview('one'),
chosen: { annotationId: 'a', vertex: 1, base: 'one' },
})
dropStale('one')
expect(useAnnotationWork.getState().preview).toEqual(preview('one'))
expect(useAnnotationWork.getState().chosen).not.toBeNull()
dropStale('two')
expect(useAnnotationWork.getState().preview).toBeNull()
expect(useAnnotationWork.getState().chosen).toBeNull()
})
it('runs on every document change of the editor store', () => {
useAnnotationWork.setState({ preview: preview('one') })
useEditorStore.setState({ documentText: 'one' })
expect(useAnnotationWork.getState().preview).not.toBeNull()
useEditorStore.setState({ documentText: 'two' })
expect(useAnnotationWork.getState().preview).toBeNull()
})
it('a new session (another sheet, the editor closed) resets the work', () => {
useAnnotationWork.setState({
mode: {
kind: 'move',
annotationId: 'a',
started: true,
base: 'one',
vertex: null,
},
})
useEditorStore.setState({ session: useEditorStore.getState().session + 1 })
expect(useAnnotationWork.getState().mode).toBeNull()
})
})
const STORED = { type: 'circle' as const, cx: 1, cy: 2, r: 3 }
const MOVED = { type: 'circle' as const, cx: 5, cy: 2, r: 3 }
describe('the move mode in the work store (R-12, R-13)', () => {
it('is started once its preview differs from the stored shape', () => {
startMove('a', 'one')
expect(guardWork(useAnnotationWork.getState())).toBeNull()
setModePreview(STORED, STORED)
expect(useAnnotationWork.getState().mode?.started).toBe(false)
setModePreview(MOVED, STORED)
const work = useAnnotationWork.getState()
expect(work.mode?.started).toBe(true)
expect(work.preview).toMatchObject({ source: 'move', base: 'one' })
expect(guardWork(work)).toBe('move')
})
it('an undo only cancels what is pending (cancelPending)', () => {
expect(cancelPending()).toBe(false)
startMove('a', 'one')
setModePreview(MOVED, STORED)
expect(cancelPending()).toBe(true)
expect(useAnnotationWork.getState()).toMatchObject({
mode: null,
preview: null,
})
useAnnotationWork.setState({
preview: { ...preview('one'), source: 'keys' },
})
expect(cancelPending()).toBe(true)
expect(useAnnotationWork.getState().preview).toBeNull()
})
it('a document change drops the mode; a started one is kept to be said', () => {
startMove('a', 'one')
dropStale('two')
expect(useAnnotationWork.getState()).toMatchObject({
mode: null,
dropped: null,
})
startMove('a', 'two')
setModePreview(MOVED, STORED)
dropStale('two')
expect(useAnnotationWork.getState().mode).not.toBeNull()
dropStale('three')
expect(useAnnotationWork.getState()).toMatchObject({
mode: null,
preview: null,
dropped: 'move',
})
})
})
describe('the drawing guard (R-12)', () => {
it('an unstarted mode ends at once and the move goes on', () => {
startMove('a', 'one')
const proceed = vi.fn()
expect(guardDrawing(proceed)).toBe(true)
expect(useAnnotationWork.getState().mode).toBeNull()
expect(useAnnotationWork.getState().question).toBeNull()
expect(proceed).not.toHaveBeenCalled()
})
it('a started mode asks; « Continuer » keeps it, « Abandonner » drops it and moves', () => {
startMove('a', 'one')
setModePreview(MOVED, STORED)
const proceed = vi.fn()
expect(guardDrawing(proceed)).toBe(false)
expect(useAnnotationWork.getState().question?.work).toBe('move')
answerDrawing(false)
const kept = useAnnotationWork.getState()
expect(kept.question).toBeNull()
expect(kept.preview?.geometry).toEqual(MOVED)
expect(proceed).not.toHaveBeenCalled()
guardDrawing(proceed)
answerDrawing(true)
expect(useAnnotationWork.getState().mode).toBeNull()
expect(proceed).toHaveBeenCalledTimes(1)
})
})