import { describe, it, expect, afterEach, vi } from 'vitest'; import { cleanup, render } from 'vitest-browser-svelte'; import { page, userEvent } from 'vitest/browser'; import HelpPopover from './HelpPopover.svelte'; afterEach(cleanup); function renderPopover(label = 'Help') { return render(HelpPopover, { props: { label } }); } describe('HelpPopover — initial state', () => { it('renders a trigger button with the given label', async () => { renderPopover(); const btn = page.getByRole('button', { name: /Help/ }); await expect.element(btn).toBeInTheDocument(); }); it('starts closed: aria-expanded is false, popover not in DOM', async () => { renderPopover(); const btn = page.getByRole('button', { name: /Help/ }); await expect.element(btn).toHaveAttribute('aria-expanded', 'false'); expect(document.querySelector('[role="region"]')).toBeNull(); }); }); describe('HelpPopover — open / close interactions', () => { it('opens on click: aria-expanded true, popover in DOM', async () => { renderPopover(); await page.getByRole('button', { name: /Help/ }).click(); const btn = page.getByRole('button', { name: /Help/ }); await expect.element(btn).toHaveAttribute('aria-expanded', 'true'); expect(document.querySelector('[role="region"]')).not.toBeNull(); }); it('closes on Esc key', async () => { renderPopover(); await page.getByRole('button', { name: /Help/ }).click(); expect(document.querySelector('[role="region"]')).not.toBeNull(); document.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true })); await vi.waitFor(() => expect(document.querySelector('[role="region"]')).toBeNull()); }); it('closes on outside click', async () => { renderPopover(); await page.getByRole('button', { name: /Help/ }).click(); expect(document.querySelector('[role="region"]')).not.toBeNull(); document.dispatchEvent(new PointerEvent('pointerdown', { bubbles: true })); await vi.waitFor(() => expect(document.querySelector('[role="region"]')).toBeNull()); }); it('opens on Enter key', async () => { renderPopover(); (document.querySelector('button[aria-expanded]') as HTMLButtonElement).focus(); await userEvent.keyboard('{Enter}'); await vi.waitFor(() => expect(document.querySelector('[role="region"]')).not.toBeNull()); }); it('opens on Space key', async () => { renderPopover(); (document.querySelector('button[aria-expanded]') as HTMLButtonElement).focus(); await userEvent.keyboard('{Space}'); await vi.waitFor(() => expect(document.querySelector('[role="region"]')).not.toBeNull()); }); }); describe('HelpPopover — hover-target', () => { it('hover styles propagate from 44px button group to inner span, not from span itself', () => { const { container } = renderPopover(); const btn = container.querySelector('button[aria-expanded]')!; const span = btn.querySelector('span')!; const btnClasses = btn.className.split(/\s+/); const spanClasses = span.className.split(/\s+/); expect(btnClasses).toContain('group'); expect(spanClasses).not.toContain('hover:border-brand-navy'); expect(spanClasses).toContain('group-hover:border-brand-navy'); expect(spanClasses).not.toContain('hover:text-brand-navy'); expect(spanClasses).toContain('group-hover:text-brand-navy'); }); it('outer button has focus-visible ring for keyboard users', () => { const { container } = renderPopover(); const btn = container.querySelector('button[aria-expanded]')!; expect(btn.className).toContain('focus-visible:ring-2'); expect(btn.className).toContain('focus-visible:ring-brand-navy'); }); }); describe('HelpPopover — aria wiring', () => { it('trigger aria-controls matches popover element id', async () => { renderPopover(); await page.getByRole('button', { name: /Help/ }).click(); const btn = document.querySelector('button[aria-expanded]') as HTMLButtonElement; const controls = btn.getAttribute('aria-controls'); expect(controls).toBeTruthy(); const popover = document.getElementById(controls!); expect(popover).not.toBeNull(); }); it('two renders produce different, predictable IDs (no Math.random — SSR safe)', async () => { const { container: c1 } = render(HelpPopover, { props: { label: 'A' } }); const { container: c2 } = render(HelpPopover, { props: { label: 'B' } }); const id1 = c1.querySelector('button[aria-controls]')?.getAttribute('aria-controls'); const id2 = c2.querySelector('button[aria-controls]')?.getAttribute('aria-controls'); expect(id1).toBeTruthy(); expect(id2).toBeTruthy(); expect(id1).not.toBe(id2); // IDs must be deterministic (counter-based), not random hex expect(id1).toMatch(/^help-popover-\d+$/); expect(id2).toMatch(/^help-popover-\d+$/); }); });