import { fr } from '@/i18n/fr' import type { Page, TestInfo } from '@playwright/test' import { expect, expectAccessible, test } from '../support/browser' import { dropLateReplays, routeToSandbox } from '../support/sandbox' import { clickDrawing, clientOf, editorActor, historyButton, round2, shownNumber, shownPoints, shownShape, storedShape, pressAtBox, openEditor, pickAnnotation, pointOf, saveDraft, saveLine, seedDraft, selectionTag, selectTab, serverDocument, shapeWith, standardShape, UNSAVED_LINE, } from '../support/editor' import { expectNoShift, keepNativeFrames } from '../support/layout' // V1-2.6 A3 (contract C7, C8, C21): points, zones and links by clicks and by keyboard, // move by drag, edits on the handles (U2 Task 5), undo and redo, then the save. const dict = fr const isPhone = (info: TestInfo) => info.project.name === 'chromium-375' const creation = (page: Page) => page.getByTestId('annotation-creation') const properties = (page: Page) => page.getByTestId('annotation-properties') const list = (page: Page) => page.getByRole('list', { name: dict['editor.annotations.list'] }) const tool = (page: Page, id: string) => page.getByRole('button', { name: dict[`editor.annotations.tool.${id}`], exact: true, }) interface Names { fr: string en: string } /** Fills the creation panel; the category keeps its first choice. */ async function fillCreation(page: Page, names: Names, opens?: string) { const panel = creation(page) await panel.getByLabel(dict['editor.annotations.name_fr']).fill(names.fr) await panel.getByLabel(dict['editor.annotations.name_en']).fill(names.en) await panel .getByLabel(dict['editor.annotations.laterality']) .selectOption('unpaired') if (opens) { await panel.getByLabel(dict['editor.annotations.opens']).selectOption(opens) } } async function createFromPanel(page: Page) { await creation(page) .getByRole('button', { name: dict['editor.annotations.create'] }) .click() await expect(creation(page)).toHaveCount(0) } async function openAnnotations(page: Page) { const actor = await editorActor('fr') const seed = await seedDraft(actor, { shape: standardShape }) await openEditor(page, dict, actor, seed.sheetId) await expect(tool(page, 'point')).toBeEnabled() return { actor, seed } } test.describe('editor annotations (A3)', () => { test.use({ locale: 'fr-FR', actionTimeout: 15_000 }) test.beforeEach(async ({ context }, info) => { test.skip(isPhone(info), 'editing needs 1 024 px') // floor-guard: allow C16 editing needs >= 1024 px; phone read-only covered in editor-access await routeToSandbox(context) }) test.afterEach(async ({ context }) => { await dropLateReplays(context) }) test('point, zone and link by clicks; handle edit; undo and redo; save', async ({ page, requests, }) => { const { actor, seed } = await openAnnotations(page) requests.forbid(actor.account.email, actor.account.password) // A point: the tool, a click in the drawing, the fields the core requires. await tool(page, 'point').click() await clickDrawing(page, 300, 300) await expect(creation(page)).toBeVisible() await expectAccessible(page, 'the point creation panel') await fillCreation(page, { fr: 'Point un', en: 'Point one' }) await creation(page) .getByLabel(dict['editor.annotations.zone']) .selectOption('zone-a') await createFromPanel(page) await expect(selectionTag(page)).toContainText('Point un') await expect(properties(page)).toBeVisible() const placed = await shownNumber(page, 'cx') expect(Math.abs(placed - 300)).toBeLessThan(1) // A zone: three clicks, then « Fermer le tracé ». await tool(page, 'zone').click() for (const [x, y] of [ [600, 200], [800, 200], [700, 400], ]) await clickDrawing(page, x, y) await page .getByRole('button', { name: dict['editor.annotations.trace_close'] }) .click() await fillCreation(page, { fr: 'Zone une', en: 'Zone one' }) await createFromPanel(page) await expect(selectionTag(page)).toContainText('Zone une') // A link to the detail view: the same tracing, the opened view chosen. await tool(page, 'link').click() for (const [x, y] of [ [150, 500], [350, 500], [250, 700], ]) await clickDrawing(page, x, y) await page .getByRole('button', { name: dict['editor.annotations.trace_close'] }) .click() await fillCreation(page, { fr: 'Accès un', en: 'Access one' }, 'detail-a') await createFromPanel(page) await expect(selectionTag(page)).toContainText('Accès un') await expect(historyButton(page, dict, 'undo')).toBeEnabled() // A keyboard edit on the point's handle (two steps of 5 units), then undo and redo. await tool(page, 'select').click() await pickAnnotation(page, dict, /Point un/) await page.getByRole('button', { name: 'Point Point un' }).focus() await page.keyboard.press('ArrowRight') await page.keyboard.press('ArrowRight') await page.keyboard.press('Enter') const moved = String(round2(round2(placed + 5) + 5)) await expect(shownShape(page)).toHaveAttribute('cx', moved) await historyButton(page, dict, 'undo').click() await expect(shownShape(page)).toHaveAttribute('cx', String(placed)) await historyButton(page, dict, 'redo').click() await expect(shownShape(page)).toHaveAttribute('cx', moved) // Nothing left to redo: the button is aria-disabled and a press changes nothing. await pressAtBox(page, historyButton(page, dict, 'redo')) await expect(shownShape(page)).toHaveAttribute('cx', moved) await saveDraft(page, dict, seed.revision + 1) const saved = await serverDocument<{ annotations: { kind: string; finding_zone_id?: string | null }[] }>(seed.draftId) expect(saved.annotations.map((a) => a.kind).sort()).toEqual([ 'detail_trigger', 'point', 'zone', ]) expect( saved.annotations.find((a) => a.kind === 'point')?.finding_zone_id, ).toBe('zone-a') }) test('a click with jitter never moves; a drag moves by the pointer delta', async ({ page, requests, }) => { const { actor } = await openAnnotations(page) requests.forbid(actor.account.email, actor.account.password) await tool(page, 'point').click() await clickDrawing(page, 300, 300) await fillCreation(page, { fr: 'Mobile', en: 'Movable' }) await createFromPanel(page) await tool(page, 'select').click() const x0 = String(await shownNumber(page, 'cx')) const y0 = String(await shownNumber(page, 'cy')) expect(Math.abs(Number(x0) - 300)).toBeLessThan(1) // Jitter under the 4 px threshold: pressed, moved by 3 px, released. const from = await clientOf(page, 300, 300) await page.mouse.move(from.x, from.y) await page.mouse.down() await page.mouse.move(from.x + 2, from.y + 2) await page.mouse.up() await expect(shownShape(page)).toHaveAttribute('cx', x0) await expect(shownShape(page)).toHaveAttribute('cy', y0) // A real drag: the point follows to (400, 360) in drawing units. const to = await clientOf(page, 400, 360) await page.mouse.move(from.x, from.y) await page.mouse.down() await page.mouse.move((from.x + to.x) / 2, (from.y + to.y) / 2, { steps: 5, }) await page.mouse.move(to.x, to.y, { steps: 5 }) await page.mouse.up() await expect(shownShape(page)).not.toHaveAttribute('cx', x0) expect(Math.abs((await shownNumber(page, 'cx')) - 400)).toBeLessThan(2) expect(Math.abs((await shownNumber(page, 'cy')) - 360)).toBeLessThan(2) await page.keyboard.press('Control+z') await expect(shownShape(page)).toHaveAttribute('cx', x0) }) test('keyboard only: creation by the add buttons, numeric position, edit by the handle keys', async ({ page, requests, }) => { const { actor, seed } = await openAnnotations(page) requests.forbid(actor.account.email, actor.account.password) const add = page.getByRole('button', { name: dict['editor.annotations.add.point'], }) await add.focus() await page.keyboard.press('Enter') await expect(creation(page)).toBeVisible() await fillCreation(page, { fr: 'Clavier', en: 'Keyboard' }) const cx = creation(page).getByLabel(dict['editor.annotations.geometry.cx']) await cx.fill('250') await cx.press('Enter') await expect(cx).toHaveValue('250') await creation(page) .getByRole('button', { name: dict['editor.annotations.create'] }) .focus() await page.keyboard.press('Enter') await expect(creation(page)).toHaveCount(0) await expect(selectionTag(page)).toContainText('Clavier') await expect(shownShape(page)).toHaveAttribute('cx', '250') // The handle keys (U2 Task 5): two steps of 5 units down, one commit on Enter. const cy0 = await shownNumber(page, 'cy') await page.getByRole('button', { name: 'Point Clavier' }).focus() await page.keyboard.press('ArrowDown') await page.keyboard.press('ArrowDown') await page.keyboard.press('Enter') await expect(shownShape(page)).toHaveAttribute( 'cy', String(round2(round2(cy0 + 5) + 5)), ) // A polygon edit: the zone added by keyboard, its first vertex moved by its keys. await page .getByRole('button', { name: dict['editor.annotations.add.zone'] }) .focus() await page.keyboard.press('Enter') await fillCreation(page, { fr: 'Zone clavier', en: 'Keyboard zone' }) await creation(page) .getByRole('button', { name: dict['editor.annotations.create'] }) .focus() await page.keyboard.press('Enter') await expect(selectionTag(page)).toContainText('Zone clavier') const [[before]] = await shownPoints(page) await page.getByRole('button', { name: 'Sommet 1', exact: true }).focus() await page.keyboard.press('ArrowRight') await page.keyboard.press('ArrowRight') await page.keyboard.press('Enter') await expect .poll(async () => (await shownPoints(page))[0][0]) .toBe(round2(round2(before + 5) + 5)) await saveDraft(page, dict, seed.revision + 1) }) test('the properties of an annotation: review state and deletion', async ({ page, requests, }) => { const { actor } = await openAnnotations(page) requests.forbid(actor.account.email, actor.account.password) await tool(page, 'point').click() await clickDrawing(page, 500, 400) await fillCreation(page, { fr: 'A relire', en: 'To review' }) await createFromPanel(page) await properties(page) .getByRole('button', { name: dict['editor.annotations.mark_reviewed'] }) .click() await expect( properties(page).getByRole('button', { name: dict['editor.annotations.to_confirm'], }), ).toBeVisible() await properties(page) .getByRole('button', { name: dict['editor.action.delete'] }) .click() await page .getByRole('dialog') .getByRole('button', { name: dict['editor.delete.confirm'] }) .click() await expect(list(page)).toHaveCount(0) await expect( page.getByText(dict['editor.annotations.list_empty']), ).toBeVisible() await selectTab(page, dict, 'verification') await expectAccessible(page, 'the verification tab after a deletion') }) test.describe('the drawing never moves (A14)', () => { const button = (page: Page, key: string) => page.getByRole('button', { name: dict[key], exact: true }) const line = (page: Page) => page.getByTestId('gesture-line') async function openWithPoint(page: Page, width: number) { await page.setViewportSize({ width, height: 800 }) // Installed before any timer: the message's 6 s run on this clock (fast-forwarded below). await keepNativeFrames(page) await page.clock.install() const actor = await editorActor('fr') const point = pointOf('p-a', 'main', { cx: 500, cy: 300, r: 40 }, 'Pt A') const seed = await seedDraft(actor, { shape: shapeWith(point) }) await openEditor(page, dict, actor, seed.sheetId) await expect(tool(page, 'point')).toBeEnabled() return actor } /** A drag of the point from (500, 300) to `to`, in drawing units. */ async function dragPoint(page: Page, to: { x: number; y: number }) { const from = await clientOf(page, 500, 300) const end = await clientOf(page, to.x, to.y) await page.mouse.move(from.x, from.y) await page.mouse.down() await page.mouse.move(end.x, end.y, { steps: 6 }) await page.mouse.up() } for (const width of [1024, 1180, 1280]) { test(`at ${width} px: selection, tools, tracing, the first commit, the message`, async ({ page, requests, }) => { const actor = await openWithPoint(page, width) requests.forbid(actor.account.email, actor.account.password) // shortcut: the side panel still swaps the overview for the properties or the // creation panel until Tasks 6 and 7 (dialogs); its height is exempt there only. const swaps = ['aside-content'] as const await expectNoShift( page, async () => { await clickDrawing(page, 500, 300) await expect(selectionTag(page)).toContainText('Pt A') }, swaps, ) // The first commit: the save line changes, the message shows (the properties panel // rewrites its review badge: aside content until Task 6). await expectNoShift( page, async () => { await dragPoint(page, { x: 560, y: 330 }) await expect(line(page)).toContainText( dict['editor.annotations.message.moved.point'], ) await expect(saveLine(page)).toHaveText(UNSAVED_LINE) }, swaps, ) // Its own row, the column's width: the message is read whole. const cut = await line(page) .locator('span') .first() .evaluate((span) => span.scrollWidth > span.clientWidth) expect(cut, 'the message is cut short').toBe(false) // Its expiry, 6 s later. await expectNoShift(page, async () => { await page.clock.fastForward(6_100) await expect(line(page)).not.toContainText( dict['editor.annotations.message.moved.point'], ) }) await expectNoShift( page, async () => { await clickDrawing(page, 20, 20) await expect(selectionTag(page)).toHaveCount(0) }, swaps, ) await expectNoShift(page, () => tool(page, 'zone').click()) await expectNoShift(page, () => clickDrawing(page, 600, 150)) for (const [x, y] of [ [800, 150], [700, 400], ]) await expectNoShift(page, () => clickDrawing(page, x, y)) await expectNoShift(page, () => button(page, 'editor.annotations.trace_pop').click(), ) await expectNoShift(page, () => clickDrawing(page, 700, 400)) await expectNoShift( page, async () => { await button(page, 'editor.annotations.trace_close').click() await expect(creation(page)).toBeVisible() }, swaps, ) }) } test('the point (U2 Task 4): handle drag, size by a track click, the move mode', async ({ page, requests, }) => { const actor = await openWithPoint(page, 1280) requests.forbid(actor.account.email, actor.account.password) const swaps = ['aside-content'] as const await expectNoShift( page, async () => { await clickDrawing(page, 500, 300) await expect(selectionTag(page)).toContainText('Pt A') }, swaps, ) const handle = page.getByRole('button', { name: 'Point Pt A' }) await expect(handle).toHaveAttribute('tabindex', '0') const slider = page.getByTestId('size-slider').getByRole('slider') await expect(slider).toHaveValue('40') await expectAccessible(page, 'a selected point: handle, slider, move') // The handle follows the pointer; the drop is one commit. await expectNoShift( page, async () => { await dragPoint(page, { x: 560, y: 330 }) await expect(line(page)).toContainText( dict['editor.annotations.message.moved.point'], ) }, swaps, ) expect(Math.abs((await shownNumber(page, 'cx')) - 560)).toBeLessThan(2) // A click on the track, no drag (WCAG 2.5.7): one commit at the release. const track = (await slider.boundingBox())! await expectNoShift( page, async () => { await page.mouse.click( track.x + track.width * 0.8, track.y + track.height / 2, ) await expect(line(page)).toContainText( dict['editor.annotations.message.resized'], ) }, swaps, ) expect(await shownNumber(page, 'r')).toBeGreaterThan(40) await page.keyboard.press('Control+z') await expect(shownShape(page)).toHaveAttribute('r', '40') // The move mode: three steps (5 units each on a 1 000 px wide frame), validated once. const x0 = await shownNumber(page, 'cx') await expectNoShift( page, () => button(page, 'editor.annotations.move.point').click(), swaps, ) const right = button(page, 'editor.annotations.move.right') await expect(right).toBeVisible() await expectAccessible(page, 'the move mode') await expectNoShift( page, async () => { for (let step = 0; step < 3; step++) await right.click() }, swaps, ) // Nothing committed yet: the stored place stays, drawn as the old place. await expect(storedShape(page)).toHaveAttribute('cx', String(x0)) await expectNoShift( page, async () => { await button(page, 'editor.annotations.move.confirm').click() await expect(right).toHaveCount(0) }, swaps, ) await expect(shownShape(page)).toHaveAttribute('cx', String(x0 + 15)) await expect(storedShape(page)).toHaveCount(0) await expect(button(page, 'editor.annotations.move.point')).toBeFocused() }) test('the point handle keeps its size in CSS px under zoom (R-9)', async ({ page, requests, }) => { await page.setViewportSize({ width: 1280, height: 800 }) const actor = await editorActor('fr') const tiny = pointOf('p-t', 'main', { cx: 500, cy: 300, r: 4 }, 'Pt T') const seed = await seedDraft(actor, { shape: shapeWith(tiny) }) await openEditor(page, dict, actor, seed.sheetId) requests.forbid(actor.account.email, actor.account.password) await pickAnnotation(page, dict, /Pt T/) const hit = page.getByTestId('point-handle').locator('[data-handle]') const fit = (await hit.boundingBox())! // R-9: a 10 px hit radius with a mouse (Chromium desktop has a fine pointer). expect(Math.abs(fit.width - 20)).toBeLessThan(2) // The drawing's own scale: the measure below waits for the zoom to land. const transform = () => page .getByTestId('annotation-canvas') .evaluate( (box) => (box.firstElementChild as HTMLElement).style.transform, ) const before = await transform() await page .getByRole('button', { name: dict['catalogue.zoom.in'] }) .click() await expect.poll(transform).not.toBe(before) const zoomed = (await hit.boundingBox())! expect(Math.abs(zoomed.width - 20)).toBeLessThan(2) }) test('the editor keeps a stable scrollbar gutter; the dashboard does not', async ({ page, requests, }, info) => { test.skip( info.project.name !== 'chromium-desktop', 'measured at 1 280 px', ) const actor = await openWithPoint(page, 1280) requests.forbid(actor.account.email, actor.account.password) const gutter = () => page.evaluate( () => getComputedStyle(document.documentElement).scrollbarGutter, ) expect(await gutter()).toBe('stable') await page.goto('/app') await expect(page.locator('[data-editor-workspace]')).toHaveCount(0) expect(await gutter()).toBe('auto') }) }) })