/** * Characterisation (Step 1): the zone-click chain of EditorRoute * (onZoneClick → detail / fallback / spine / bilateral / toggle), the * disclaimer-once-per-session rule, the zone removal and the pickers' * integration with the store. Exercised through the rendered route on the * real Horse.svg / Horse_head.svg, with loadSvg mocked to read the files. * * Limitation: the chain lives inside the route component (audit 13 §4, no * unit seam). These tests go through the DOM; plan Step 5 extracts the * chain into a service and will replace them with unit tests one-to-one. */ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest' import { render, screen, waitFor, within, cleanup } from '@testing-library/react' import userEvent from '@testing-library/user-event' import { MemoryRouter } from 'react-router-dom' import { readFileSync } from 'node:fs' import { fileURLToPath } from 'node:url' import { dirname, resolve } from 'node:path' import EditorRoute from '@/app/routes/EditorRoute' import { useReportStore } from '@/state/reportStore' import { useLocaleStore } from '@/state/localeStore' import { fr } from '@/i18n/fr' import minimal from '../fixtures/report-v2.minimal.json' import type { Report } from '@/domain/schema/report' const HERE = dirname(fileURLToPath(import.meta.url)) const FILES: Record = { '/species/equine/Horse.svg': readFileSync(resolve(HERE, '../../public/species/equine/Horse.svg'), 'utf8'), '/species/equine/Horse_head.svg': readFileSync(resolve(HERE, '../../public/species/equine/Horse_head.svg'), 'utf8'), } vi.mock('@/anatomy/svgLoader', () => ({ loadSvg: vi.fn(async (path: string) => { const text = FILES[path] if (!text) throw new Error(`unexpected path ${path}`) const doc = new DOMParser().parseFromString(text, 'image/svg+xml') return doc.documentElement as unknown as SVGSVGElement }), })) const HINGE = 'point-mpbwyyc9' // Charnière C7-T1, plain point const HIP = 'point-mpbwtst0' // bilateral const CERVICAL = 'zone-mpbx5hx2' // vertebral-precision const TRIGGER = 'zone-mpby55kd' // opens-detail=head const ATM = 'point-mpbyo7zq' // in Horse_head.svg const DISCLAIMER_FLAG = 'osteo:disclaimer-shown' function seedReport(observations: Report['observations'] = []) { useReportStore.setState({ report: null, activeObservationIndex: 0 }) useReportStore.getState().initReport({ ...(minimal as Report), observations, } as Omit) } const zonesOf = (i = 0) => useReportStore.getState().report!.observations[i].zones const activeIndex = () => useReportStore.getState().activeObservationIndex async function mount() { const utils = render( , ) // Main SVG rendered and parsed (bones map ready once the trigger exists). await waitFor(() => expect(document.querySelector(`[data-anno-id="${TRIGGER}"]`)).not.toBeNull()) // Give the bones state effect a tick so onZoneClick resolves ids. await waitFor(() => expect(screen.queryByRole('dialog', { name: fr['editor.disclaimer_title'] })).toBeNull()) return utils } function clickZone(id: string, scope: ParentNode = document) { const els = scope.querySelectorAll(`[data-anno-id="${id}"]`) expect(els.length, id).toBeGreaterThan(0) els[0].dispatchEvent(new Event('click', { bubbles: true })) } beforeEach(() => { useLocaleStore.setState({ locale: 'fr' }) sessionStorage.clear() sessionStorage.setItem(DISCLAIMER_FLAG, '1') window.scrollTo = vi.fn() as unknown as typeof window.scrollTo seedReport() }) afterEach(() => { cleanup() vi.restoreAllMocks() }) describe('disclaimer', () => { it('shows the catalog scope_disclaimer once per session and records the flag', async () => { sessionStorage.removeItem(DISCLAIMER_FLAG) render( , ) const dialog = await screen.findByRole('dialog', { name: fr['editor.disclaimer_title'] }) expect(dialog.textContent).toContain('Aucun diagnostic médical') await userEvent.click(within(dialog).getByRole('button', { name: fr['common.understood'] })) expect(sessionStorage.getItem(DISCLAIMER_FLAG)).toBe('1') await waitFor(() => expect(screen.queryByRole('dialog')).toBeNull()) }) }) describe('plain zone (toggle)', () => { it('adds the zone on first click and removes it on second click', async () => { await mount() clickZone(HINGE) await waitFor(() => expect(zonesOf()).toEqual([{ boneId: HINGE }])) clickZone(HINGE) await waitFor(() => expect(zonesOf()).toEqual([])) }) it('highlights the zone of the active observation with data-state="current"', async () => { await mount() clickZone(HINGE) await waitFor(() => expect(document.querySelector(`[data-anno-id="${HINGE}"]`)?.getAttribute('data-state')).toBe('current'), ) }) }) describe('no active observation (fallback)', () => { it('re-activates the last observation and drops the click (user must click again)', async () => { await mount() // Collapse the only card through the UI (sets activeObservationIndex to -1). await userEvent.click(screen.getByRole('button', { name: `${fr['observation.collapse_aria']} 1` })) await waitFor(() => expect(activeIndex()).toBe(-1)) clickZone(HINGE) await waitFor(() => expect(activeIndex()).toBe(0)) expect(zonesOf()).toEqual([]) clickZone(HINGE) await waitFor(() => expect(zonesOf()).toEqual([{ boneId: HINGE }])) }) }) describe('detail trigger', () => { it('opens the detail modal, never adds the trigger as a zone, and zones clicked inside carry detailSourceId', async () => { await mount() clickZone(TRIGGER) const dialog = await screen.findByRole('dialog', { name: `${fr['editor.detail_title_prefix']}head` }) expect(zonesOf()).toEqual([]) await waitFor(() => expect(dialog.querySelector(`[data-anno-id="${ATM}"]`)).not.toBeNull()) clickZone(ATM, dialog) await waitFor(() => expect(zonesOf()).toEqual([{ boneId: ATM, detailSourceId: 'head' }])) // Toggle off from inside the modal uses the same (boneId, detailSourceId) identity. clickZone(ATM, dialog) await waitFor(() => expect(zonesOf()).toEqual([])) }) }) describe('spine zone (vertebral-precision)', () => { it('adds the zone, opens the picker on the matching region, and never toggles off on re-click', async () => { await mount() clickZone(CERVICAL) const dialog = await screen.findByRole('dialog', { name: /Préciser les vertèbres/ }) expect(zonesOf()).toEqual([{ boneId: CERVICAL }]) expect(within(dialog).getByRole('tab', { name: fr['vertebra.region.C'] })).toHaveAttribute('aria-selected', 'true') await userEvent.click(within(dialog).getByRole('button', { name: 'C3' })) await userEvent.click(within(dialog).getByRole('button', { name: fr['common.confirm'] })) await waitFor(() => expect(zonesOf()).toEqual([{ boneId: CERVICAL, vertebrae: [{ region: 'C', index: 3 }] }])) clickZone(CERVICAL) await screen.findByRole('dialog', { name: /Préciser les vertèbres/ }) expect(zonesOf()).toHaveLength(1) }) it('cancelling the picker leaves a spine zone without vertebrae', async () => { await mount() clickZone(CERVICAL) const dialog = await screen.findByRole('dialog', { name: /Préciser les vertèbres/ }) await userEvent.click(within(dialog).getByRole('button', { name: fr['common.cancel'] })) await waitFor(() => expect(screen.queryByRole('dialog')).toBeNull()) expect(zonesOf()).toEqual([{ boneId: CERVICAL }]) }) it('picking another region in the picker spawns that region zone and pruning to zero removes a zone', async () => { await mount() clickZone(CERVICAL) let dialog = await screen.findByRole('dialog', { name: /Préciser les vertèbres/ }) await userEvent.click(within(dialog).getByRole('button', { name: 'C3' })) await userEvent.click(within(dialog).getByRole('tab', { name: fr['vertebra.region.L'] })) await userEvent.click(within(dialog).getByRole('button', { name: 'L2' })) await userEvent.click(within(dialog).getByRole('button', { name: fr['common.confirm'] })) await waitFor(() => expect(zonesOf()).toEqual([ { boneId: CERVICAL, vertebrae: [{ region: 'C', index: 3 }] }, { boneId: 'zone-mpbx1rm9', vertebrae: [{ region: 'L', index: 2 }] }, ]), ) clickZone(CERVICAL) dialog = await screen.findByRole('dialog', { name: /Préciser les vertèbres/ }) await userEvent.click(within(dialog).getByRole('button', { name: 'C3' })) // uncheck await userEvent.click(within(dialog).getByRole('button', { name: fr['common.confirm'] })) await waitFor(() => expect(zonesOf()).toEqual([{ boneId: 'zone-mpbx1rm9', vertebrae: [{ region: 'L', index: 2 }] }])) }) }) describe('bilateral zone', () => { it('asks for a side, adds one zone per side, and clears both when both are present', async () => { await mount() clickZone(HIP) let dialog = await screen.findByRole('dialog', { name: 'Hanche (coxo-fémorale)' }) await userEvent.click(within(dialog).getByRole('button', { name: fr['lateral.left'] })) await waitFor(() => expect(zonesOf()).toEqual([{ boneId: HIP, side: 'left' }])) clickZone(HIP) dialog = await screen.findByRole('dialog', { name: 'Hanche (coxo-fémorale)' }) expect(within(dialog).getByRole('button', { name: fr['lateral.left'] })).toBeDisabled() await userEvent.click(within(dialog).getByRole('button', { name: fr['lateral.right'] })) await waitFor(() => expect(zonesOf()).toEqual([ { boneId: HIP, side: 'left' }, { boneId: HIP, side: 'right' }, ]), ) clickZone(HIP) await waitFor(() => expect(zonesOf()).toEqual([])) expect(screen.queryByRole('dialog')).toBeNull() }) it('"both" adds the missing sides only', async () => { await mount() clickZone(HIP) const dialog = await screen.findByRole('dialog', { name: 'Hanche (coxo-fémorale)' }) await userEvent.click(within(dialog).getByRole('button', { name: fr['lateral.both'] })) await waitFor(() => expect(zonesOf()).toEqual([ { boneId: HIP, side: 'left' }, { boneId: HIP, side: 'right' }, ]), ) }) }) describe('zone removal and orphan findings', () => { it('KNOWN: removing a zone via ✕ keeps the findings attached to its catalog zone', async () => { seedReport([ { id: 'obs-a', zones: [{ boneId: HINGE }], findings: [ { zoneId: 'c7-t1', path: ['c7-t1-dysfunctions', 'segmental', 'fixation'], labelFrSnapshot: 'Fixation de la charnière', labelEnSnapshot: 'Junction fixation', }, ], freeTextFindings: [], comment: '', }, ]) await mount() const remove = await screen.findByRole('button', { name: `${fr['observation.remove_zone']} Charnière C7-T1 (cervico-thoracique)`, }) await userEvent.click(remove) await waitFor(() => expect(zonesOf()).toEqual([])) expect(useReportStore.getState().report!.observations[0].findings).toHaveLength(1) }) it('shows one findings picker per (catalog zone, side) resolved by label match', async () => { seedReport([ { id: 'obs-b', zones: [ { boneId: HIP, side: 'left' }, { boneId: HIP, side: 'right' }, { boneId: HINGE }, { boneId: TRIGGER }, ], findings: [], freeTextFindings: [], comment: '', }, ]) await mount() await screen.findByRole('button', { name: /Hanche \(coxo-fémorale\) \(Gauche\)/ }) screen.getByRole('button', { name: /Hanche \(coxo-fémorale\) \(Droite\)/ }) screen.getByRole('button', { name: /^Charnière C7-T1 \(cervico-thoracique\)$/ }) // The trigger has no label and no catalog zone: exactly 3 pickers, and its // badge falls back to the raw boneId. expect(document.querySelectorAll('[aria-controls^="findings-zone-"]')).toHaveLength(3) expect( screen.getByRole('button', { name: `${fr['observation.remove_zone']} ${TRIGGER}` }), ).toBeInTheDocument() }) })