Files
faunosteo/apps/app/tests/unit/editor-keep-alive.test.tsx
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

578 lines
20 KiB
TypeScript

/** U1 Lot B2a: tabs, Annotations sections and the Références tab stay mounted. */
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import {
act,
cleanup,
fireEvent,
render,
screen,
waitFor,
within,
} from '@testing-library/react'
import userEvent from '@testing-library/user-event'
import EditorTabBody from '@/components/editor/EditorTabBody'
import KeptPlace from '@/components/editor/KeptPlace'
import { useSheetDocument } from '@/editor/sheetDocument'
import { usePlaceVisible } from '@/lib/placeVisibility'
import { FocusConsumedContext } from '@/editor/focusRequest'
import { targetOfKey } from '@/editor/navigation'
import { useLocaleStore } from '@/state/localeStore'
import { useAnnotationWork } from '@/editor/annotations/workStore'
import { cleanSvg } from '@/editor/core/cleaning'
import {
ASSET,
drawnText,
edit,
emptyText,
insert,
point,
} from '../helpers/editorFixtures'
import {
baseText,
resetStore,
sb,
serverHas,
store,
versionAnswer,
pressAt,
} from '../helpers/editorHarness'
import { testLayer } from '../helpers/findingsHost'
import { mountDraft, setWidth } from '../helpers/editorRoute'
vi.mock('@/lib/supabase', () => ({ getSupabaseClient: () => ({}) }))
vi.mock('@faunosteo/supabase', async (orig) => ({
...(await orig<typeof import('@faunosteo/supabase')>()),
getSheetVersion: vi.fn(),
downloadSheetDrawing: vi.fn(),
saveSheetDraft: vi.fn(),
getOfficialSheetAdmin: vi.fn(),
submitSheetReview: vi.fn(),
}))
beforeEach(() => {
useLocaleStore.setState({ locale: 'fr' })
const identity = { a: 1, b: 0, c: 0, d: 1, e: 0, f: 0 }
Object.defineProperty(window.SVGElement.prototype, 'getScreenCTM', {
configurable: true,
value: () => ({ ...identity, inverse: () => identity }),
})
})
afterEach(() => {
cleanup()
resetStore()
setWidth(1024)
})
const ready = () =>
screen.findByRole('heading', { level: 1, name: 'Brouillon, version 4' })
const tab = (name: string | RegExp) => screen.getByRole('tab', { name })
const entry = (name: string | RegExp) => screen.getByRole('button', { name })
const place = (name: string) =>
document.querySelector<HTMLElement>(`[data-place="${name}"]`)!
const inPlace = (name: string) => within(place(name))
const name = (n: string) => ({ fr: n, en: n })
function findingsText(from = baseText(), nodeRefs?: string[]): string {
const text = insert(from, {
kind: 'zone',
value: { id: 'zone-a', name: name('Zone A'), categories: [] },
})
const family = edit(text, {
op: 'insert',
parent: { kind: 'zone', id: 'zone-a' },
element: {
kind: 'finding_category',
value: {
id: 'fcat-a',
kind: 'dysfunction',
name: name('Cat A'),
description: {},
reference_ids: [],
review_status: 'to_confirm',
children: [],
},
},
})
if (!nodeRefs) return family
return edit(family, {
op: 'insert',
parent: { kind: 'finding', zone_id: 'zone-a', path: ['fcat-a'] },
element: {
kind: 'finding_node',
value: {
id: 'fnode-a',
name: name('Node A'),
description: {},
reference_ids: nodeRefs,
requires_vet_referral: false,
review_status: 'to_confirm',
children: [],
},
},
})
}
async function mount(text = baseText()) {
serverHas(text, 3)
const user = userEvent.setup()
mountDraft()
await ready()
return user
}
describe('KeptPlace', () => {
function Probe() {
return <p>{usePlaceVisible() ? 'yes' : 'no'}</p>
}
it('hides its children and composes with the places around it', () => {
render(
<KeptPlace name="outer" visible>
<KeptPlace name="inner" visible={false}>
<Probe />
</KeptPlace>
<KeptPlace name="other" visible>
<Probe />
</KeptPlace>
</KeptPlace>,
)
expect(place('inner')).not.toBeVisible()
expect(place('other')).toBeVisible()
expect(screen.getAllByText('yes')).toHaveLength(1)
})
it('an own visible place inside a hidden one is not visible', () => {
render(
<KeptPlace name="outer" visible={false}>
<KeptPlace name="inner" visible>
<Probe />
</KeptPlace>
</KeptPlace>,
)
expect(screen.getByText('no')).toBeInTheDocument()
})
it('is visible outside any place', () => {
render(<Probe />)
expect(screen.getByText('yes')).toBeInTheDocument()
})
})
describe('text typed in a place that is left', () => {
it('the category add form survives Général ↔ Annotations and a section round trip', async () => {
const user = await mount()
await user.click(tab('Annotations'))
await user.click(entry('Modifier les catégories'))
const field = inPlace('annotations.categories').getByLabelText(
'Nom de la catégorie (FR)',
{ selector: '#category-new-fr' },
)
await user.type(field, 'Brouillon')
await user.click(tab('Général'))
expect(place('annotations.categories')).not.toBeVisible()
await user.click(tab('Annotations'))
expect(place('annotations.categories')).toBeVisible()
await user.click(screen.getByRole('button', { name: 'Retour au dessin' }))
await user.click(entry('Modifier les catégories'))
expect(document.querySelector('#category-new-fr')).toBe(field)
expect(field).toHaveValue('Brouillon')
expect(store.getState().unsaved).toBe(false)
})
it('the references search survives leaving and returning to the Références tab', async () => {
const user = await mount()
await user.click(tab('Références'))
const box = inPlace('references').getByRole('searchbox', {
name: 'Rechercher une référence',
})
await user.type(box, 'Smith 1999')
await user.click(tab('Annotations'))
expect(place('references')).not.toBeVisible()
await user.click(tab('Références'))
expect(box).toHaveValue('Smith 1999')
expect(store.getState().unsaved).toBe(false)
})
})
describe('findings and canvas state across a tab change', () => {
it('the findings selection and expansion survive', async () => {
const user = await mount(findingsText())
await user.click(tab('Constats'))
const zone = inPlace('findings').getByRole('treeitem', { name: /Zone A/ })
const cat = inPlace('findings').getByRole('treeitem', { name: /Cat A/ })
await user.click(cat)
expect(zone).toHaveAttribute('aria-expanded', 'true')
await user.click(tab('Général'))
await user.click(tab('Constats'))
expect(inPlace('findings').getByRole('treeitem', { name: /Cat A/ })).toBe(
cat,
)
expect(cat).toHaveAttribute('aria-selected', 'true')
expect(zone).toHaveAttribute('aria-expanded', 'true')
})
it('the canvas tool, selection and zoom survive a tab change and a section round trip', async () => {
const text = insert(drawnText(), point('anno-a', 50, 50, 5))
const user = await mount(text)
await waitFor(() =>
expect(
inPlace('annotations.drawing').getByRole('button', { name: 'Zone' }),
).toBeEnabled(),
)
const drawing = inPlace('annotations.drawing')
await user.click(drawing.getByRole('button', { name: 'Zone' }))
await user.click(drawing.getByRole('button', { name: 'Zoom avant' }))
const layer = () =>
drawing.getByTestId('annotation-canvas').firstElementChild as HTMLElement
const zoomed = layer().style.transform
expect(zoomed).not.toContain('scale(1)')
await user.click(tab('Général'))
await user.click(tab('Annotations'))
await user.click(entry('Gérer les vues'))
await user.click(screen.getByRole('button', { name: 'Retour au dessin' }))
expect(drawing.getByRole('button', { name: 'Zone' })).toHaveAttribute(
'aria-pressed',
'true',
)
expect(layer().style.transform).toBe(zoomed)
const list = drawing.getByRole('list', { name: 'Annotations de la vue' })
await user.click(within(list).getAllByRole('button')[0])
const marker = () =>
drawing
.getByTestId('annotation-canvas-drawing')
.querySelector('[data-anno-id="anno-a"]')
const stillSelected = () =>
waitFor(() => expect(marker()).toHaveAttribute('data-state', 'current'))
await stillSelected()
await user.click(tab('Général'))
await user.click(tab('Annotations'))
await stillSelected()
expect(drawing.getByTestId('annotation-properties')).toBeVisible()
})
it('the unmeasured hint opens the views section and « Retour au dessin » restores the same canvas', async () => {
serverHas(emptyText(), 3, false)
const user = userEvent.setup()
mountDraft()
await ready()
await user.click(tab('Annotations'))
const drawing = inPlace('annotations.drawing')
const canvas = drawing.getByTestId('annotation-canvas')
await user.click(drawing.getByRole('button', { name: 'Vues' }))
expect(place('annotations.views')).toBeVisible()
expect(place('annotations.drawing')).not.toBeVisible()
await user.click(screen.getByRole('button', { name: 'Retour au dessin' }))
expect(place('annotations.drawing')).toBeVisible()
expect(drawing.getByTestId('annotation-canvas')).toBe(canvas)
})
})
describe('a field still focused while a place is left', () => {
async function generalNameField(user: ReturnType<typeof userEvent.setup>) {
await user.click(tab('Général'))
const field = inPlace('general').getByLabelText('Nom (FR)', {
exact: true,
selector: '#general-name-fr',
})
await user.click(field)
fireEvent.change(field, { target: { value: 'Nom saisi' } })
return field
}
it('a click that moves no focus (Safari) still commits it, as one undo entry', async () => {
const user = await mount()
const before = store.getState().documentText
const field = await generalNameField(user)
expect(document.activeElement).toBe(field)
fireEvent.click(tab('Annotations'))
expect(JSON.parse(store.getState().documentText).name.fr).toBe('Nom saisi')
expect(store.getState().unsaved).toBe(true)
act(() => void store.getState().undoStep())
expect(store.getState().documentText).toBe(before)
})
it('an arrow key on the tab list commits it first, as one undo entry', async () => {
const user = await mount()
const before = store.getState().documentText
const field = await generalNameField(user)
fireEvent.keyDown(tab('Général'), { key: 'ArrowRight' })
expect(tab('Annotations')).toHaveAttribute('aria-selected', 'true')
expect(JSON.parse(store.getState().documentText).name.fr).toBe('Nom saisi')
expect(field).toHaveValue('Nom saisi')
expect(store.getState().unsaved).toBe(true)
act(() => void store.getState().undoStep())
expect(store.getState().documentText).toBe(before)
})
})
describe('ids and parses', () => {
const detail = {
kind: 'view',
value: {
kind: 'detail',
id: 'view-det',
name: { fr: 'Tête', en: 'Head' },
svg_asset_id: null,
view_box: { min_x: 10, min_y: 20, width: 40, height: 60 },
parent_view_id: 'view-main',
},
} as const
/** A drawing whose own elements carry ids, so a second composed copy would repeat them. */
function serveDrawingWithIds(text: string): void {
const svg =
'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">' +
'<defs><linearGradient id="fade"><stop offset="0"/></linearGradient></defs>' +
'<rect id="body" width="4" height="4" fill="url(#fade)"/></svg>'
const cleaned = cleanSvg(new TextEncoder().encode(svg))
if (!cleaned.ok || !cleaned.value.stored) throw new Error('uncleanable')
const bytes = new TextEncoder().encode(cleaned.value.stored)
const answer = versionAnswer(text, 3)
answer.drawings = [{ asset_id: ASSET, sha256: cleaned.value.sha256! }]
sb.getSheetVersion.mockResolvedValue(answer as never)
sb.downloadSheetDrawing.mockResolvedValue(bytes)
}
const composedHosts = () =>
[
...document.querySelectorAll(
'[data-testid="annotation-canvas-drawing"], [data-testid="crop-canvas-drawing"]',
),
].filter((host) => host.querySelector('svg'))
it('every place visited, a crop group open: one composed copy, no id repeats', async () => {
serveDrawingWithIds(insert(drawnText(), detail))
const user = userEvent.setup()
mountDraft()
await ready()
await waitFor(() => expect(composedHosts()).toHaveLength(1))
await user.click(entry('Gérer les vues'))
await user.click(
inPlace('annotations.views').getByRole('button', {
name: 'Modifier le recadrage',
}),
)
await waitFor(() => expect(composedHosts()).toHaveLength(1))
expect(composedHosts()[0]).toHaveAttribute(
'data-testid',
'crop-canvas-drawing',
)
await user.click(screen.getByRole('button', { name: 'Retour au dessin' }))
await user.click(entry('Modifier les catégories'))
await user.click(screen.getByRole('button', { name: 'Retour au dessin' }))
await user.click(entry(/^Régions vertébrales/))
for (const name of ['Général', 'Constats', 'Références', /Vérification/]) {
await user.click(tab(name))
}
expect(composedHosts()).toHaveLength(0)
await user.click(tab('Annotations'))
await user.click(screen.getByRole('button', { name: 'Retour au dessin' }))
await waitFor(() => expect(composedHosts()).toHaveLength(1))
const ids = [...document.querySelectorAll('[id]')].map((e) => e.id)
expect(ids.filter((id, i) => ids.indexOf(id) !== i)).toEqual([])
expect(ids.some((id) => id.includes('body'))).toBe(true)
})
it('every place reads the same parsed document per text', async () => {
await mount()
const seen: unknown[] = []
function Probe() {
seen.push(useSheetDocument())
return null
}
const first = render(
<>
<Probe />
<Probe />
</>,
)
expect(seen[0]).not.toBeNull()
expect(seen[1]).toBe(seen[0])
first.unmount()
act(() => {
store.getState().commit({
op: 'insert',
element: {
kind: 'category',
value: { id: 'cat-z', name: name('Z'), color: null },
},
})
})
seen.length = 0
render(
<>
<Probe />
<Probe />
</>,
)
expect(seen[1]).toBe(seen[0])
expect(seen[0]).toMatchObject({
categories: expect.arrayContaining([
expect.objectContaining({ id: 'cat-z' }),
]),
})
})
})
describe('a request reaches only its owner', () => {
it('a finding request focuses the findings place while others are mounted', async () => {
await mount(findingsText())
await userEvent.setup().click(tab('Constats'))
await userEvent.setup().click(tab('Général'))
const consumed = vi.fn()
const { unmount } = render(
<FocusConsumedContext value={consumed}>
<EditorTabBody
tab="findings"
visited={['general', 'annotations', 'findings']}
readOnly={false}
navigate={vi.fn()}
reloadSheet={vi.fn()}
layer={testLayer}
focus={{
target: targetOfKey({
kind: 'finding',
zone_id: 'zone-a',
path: ['fcat-a'],
}),
serial: 9,
}}
annotations={{
section: 'drawing',
visited: ['drawing'],
onOpenSection: vi.fn(),
onBack: vi.fn(),
}}
/>
</FocusConsumedContext>,
)
await waitFor(() => expect(consumed).toHaveBeenCalledTimes(1))
expect(consumed).toHaveBeenCalledWith(9, 'found')
unmount()
})
it('after « Aller à » a finding, arrowing back onto Constats keeps the focus on the tab', async () => {
const text = insert(findingsText(), {
...point('anno-bare', 10, 10, 2),
})
const user = await mount(text)
await user.click(tab('Constats'))
await user.click(
inPlace('findings').getByRole('treeitem', { name: /Cat A/ }),
)
await user.click(tab('Annotations'))
tab('Annotations').focus()
await user.keyboard('{ArrowRight}')
expect(tab('Constats')).toHaveAttribute('aria-selected', 'true')
expect(document.activeElement).toBe(tab('Constats'))
})
})
describe('« Aller à » while a creation or a tracing is in progress', () => {
const liveText = () =>
document.querySelector('p[aria-live="polite"]')?.textContent ?? ''
function bareAnnotationText(): string {
const bare = point('anno-bare', 10, 10, 2)
const value = { ...bare.value, geometry: null, name: name('Sans tracé') }
return insert(drawnText(), { kind: 'annotation', value } as typeof bare)
}
async function gotoBare(
user: ReturnType<typeof userEvent.setup>,
start: () => Promise<void>,
) {
await waitFor(() =>
expect(
inPlace('annotations.drawing').getByRole('button', { name: 'Zone' }),
).toBeEnabled(),
)
await start()
await user.click(tab(/Vérification/))
await user.click(
inPlace('verification').getAllByRole('button', {
name: 'Aller à Sans tracé',
})[0],
)
}
it('a tracing from the Zone tool is kept and focused', async () => {
const user = await mount(bareAnnotationText())
await gotoBare(user, async () => {
await user.click(
inPlace('annotations.drawing').getByRole('button', { name: 'Zone' }),
)
pressAt(screen.getByTestId('annotation-canvas'), 20, 20)
})
expect(tab('Annotations')).toHaveAttribute('aria-selected', 'true')
const bar = within(place('annotations.drawing')).getByTestId(
'tracing-commands',
)
expect(bar).toBeVisible()
await waitFor(() => expect(document.activeElement).toBe(bar))
expect(liveText()).toContain('tracé est en cours')
})
// U2 Task 5 (R-12): « Remplacer par un polygone » is a redraw mode. With nothing placed a
// tab ends it at once; with a vertex placed the tab asks first and « Continuer » keeps it.
it('a « Remplacer par un polygone » redraw: ended by a tab when empty, asked once a vertex is placed', async () => {
const zone = point('zone-a', 0, 0, 1)
const zoneValue = {
...zone.value,
kind: 'zone',
geometry: { type: 'path', d: 'M 20 20 L 80 20 L 50 80 Z' },
}
const text = insert(bareAnnotationText(), {
kind: 'annotation',
value: zoneValue,
} as typeof zone)
const user = await mount(text)
const drawing = inPlace('annotations.drawing')
const replace = async () => {
await user.click(
await drawing.findByRole('button', {
name: 'Remplacer par un polygone',
}),
)
expect(drawing.getByTestId('tracing-commands')).toBeVisible()
}
const list = drawing.getByRole('list', { name: 'Annotations de la vue' })
await user.click(within(list).getAllByRole('button')[0])
await replace()
await user.click(tab(/Vérification/))
expect(tab(/Vérification/)).toHaveAttribute('aria-selected', 'true')
expect(useAnnotationWork.getState().mode).toBeNull()
await user.click(tab('Annotations'))
await replace()
pressAt(screen.getByTestId('annotation-canvas'), 20, 20)
await user.click(tab(/Vérification/))
expect(
await screen.findByRole('dialog', {
name: 'Abandonner le nouveau tracé ?',
}),
).toBeInTheDocument()
await user.click(screen.getByRole('button', { name: 'Continuer' }))
expect(tab('Annotations')).toHaveAttribute('aria-selected', 'true')
expect(drawing.getByTestId('tracing-commands')).toBeVisible()
})
it('a pending creation is kept and focused', async () => {
const user = await mount(bareAnnotationText())
await gotoBare(user, async () => {
await user.click(
inPlace('annotations.drawing').getByRole('button', {
name: 'Ajouter un point',
}),
)
})
const panel = within(place('annotations.drawing')).getByTestId(
'annotation-creation',
)
expect(panel).toBeVisible()
await waitFor(() =>
expect(document.activeElement).toHaveAttribute('data-creation-heading'),
)
expect(liveText()).toContain('création est en cours')
})
})