@uniaria/testing 0.0.0-stage → 0.1.0

package/dist/commands.js

@@ -0,0 +1,341 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+//#region src/screen-reader-commands.ts
+/**
+* Node-side commands that drive a real screen reader through Guidepup
+* (`@guidepup/guidepup`, an optional peer): VoiceOver on macOS and NVDA on
+* Windows, for the scenarios that need one (design doc, Testing and
+* accessibility: real screen readers, nightly). Register them beside
+* `uniCommands` in a browser project that runs headed, one file at a time,
+* on a machine prepared with `@guidepup/setup` (`setup --ci`, then
+* `install`).
+*
+* Keys go through the operating system, as a user's would, so the browser
+* window has to be in front and the screen reader inside the page: starting
+* does what `@guidepup/playwright` does (MIT), ported because that package
+* needs `@playwright/test`.
+*/
+let running;
+const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** Playwright's browsers as macOS knows them, most likely first. */
+const MAC_BUNDLE_IDS = {
+	chromium: ["com.google.chrome.for.testing", "org.chromium.Chromium"],
+	firefox: ["org.mozilla.nightlyunofficial", "org.mozilla.nightly"],
+	webkit: ["org.webkit.Playwright"]
+};
+/** Playwright's browsers as their Windows window titles end. */
+const WINDOWS_NAMES = {
+	chromium: ["Google Chrome for Testing", "Chromium"],
+	firefox: ["Nightly", "Firefox"],
+	webkit: ["Playwright"]
+};
+function browserName(context) {
+	return context.context.browser()?.browserType().name() ?? "chromium";
+}
+function active() {
+	if (!running) throw new Error("[@uniaria/testing] No screen reader is running: the screen-reader project starts one for each file.");
+	return running;
+}
+/** Lower case, punctuation as spaces: how window titles are compared. */
+const clean = (text) => text.toLowerCase().replace(/[|¦:;'"`\-‐–—·_()[\]{}\\^~]/g, " ").replace(/\s+/g, " ").trim();
+/** Brings the browser in front by its bundle id, trying each in turn. */
+async function activateMac(ids) {
+	const run = promisify(execFile);
+	for (const id of ids) try {
+		await run("osascript", ["-e", `tell application id "${id}" to activate`]);
+		return;
+	} catch {}
+	throw new Error(`[@uniaria/testing] Could not bring the browser in front (${ids.join(", ")}).`);
+}
+/**
+* Brings the browser in front and moves VoiceOver into its web content
+* through the item chooser, as `@guidepup/playwright` does.
+*/
+async function enterPageWithVoiceOver(guidepup, context) {
+	const { voiceOver, MacOSKeyCodes, voiceOverKeyCodeCommands } = guidepup;
+	const silence = () => voiceOver.perform({ keyCode: MacOSKeyCodes.Control }, { capture: false });
+	await activateMac(MAC_BUNDLE_IDS[browserName(context)] ?? []);
+	await silence();
+	await context.page.bringToFront();
+	await context.page.evaluate(() => {
+		const marker = document.createElement("input");
+		marker.id = "__uniaria_screen_reader_marker__";
+		marker.readOnly = true;
+		marker.tabIndex = -1;
+		marker.setAttribute("aria-label", "Start");
+		marker.style.cssText = "position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)";
+		document.body.prepend(marker);
+	});
+	try {
+		for (let attempt = 0;; attempt++) {
+			await silence();
+			await delay(100);
+			await voiceOver.perform({ keyCode: MacOSKeyCodes.Escape }, { capture: false });
+			await delay(100);
+			await voiceOver.perform(voiceOverKeyCodeCommands.openItemChooser);
+			if ((await voiceOver.lastSpokenPhrase()).toLowerCase().includes("item chooser")) break;
+			if (attempt === 10) throw new Error("[@uniaria/testing] VoiceOver did not open its item chooser.");
+		}
+		let isFound = false;
+		for (const character of "web content") {
+			await silence();
+			await delay(100);
+			await voiceOver.type(character, { capture: "initial" });
+			if ((await voiceOver.lastSpokenPhrase()).toLowerCase().includes("web content")) {
+				isFound = true;
+				break;
+			}
+		}
+		if (!isFound) throw new Error("[@uniaria/testing] VoiceOver found no \"web content\" in its item chooser.");
+		await voiceOver.perform({ keyCode: MacOSKeyCodes.Enter }, { capture: false });
+		await voiceOver.interact({ capture: false });
+		await delay(100);
+	} finally {
+		await context.page.evaluate(() => document.getElementById("__uniaria_screen_reader_marker__")?.remove());
+	}
+}
+/**
+* Switches windows until NVDA reports the browser's title, then puts NVDA
+* in browse mode at the top of the page, as `@guidepup/playwright` does.
+*/
+async function enterPageWithNvda(guidepup, context) {
+	const { nvda, NVDAKeyCodeCommands, WindowsKeyCodes, WindowsModifiers } = guidepup;
+	const title = clean(await context.page.title());
+	const names = (WINDOWS_NAMES[browserName(context)] ?? []).map(clean);
+	const isBrowser = (window) => title.length > 0 && window.startsWith(title) || names.some((name) => window.includes(name));
+	await nvda.perform(NVDAKeyCodeCommands.exitFocusMode, { capture: false });
+	await delay(100);
+	for (let attempt = 0;; attempt++) {
+		await nvda.perform(NVDAKeyCodeCommands.reportTitle);
+		if (isBrowser(clean(await nvda.lastSpokenPhrase()))) break;
+		if (attempt === 10) throw new Error("[@uniaria/testing] NVDA could not bring the browser in front.");
+		await nvda.perform({
+			keyCode: [WindowsKeyCodes.Escape],
+			modifiers: [WindowsModifiers.Alt]
+		}, { capture: false });
+		await delay(500);
+	}
+	await context.page.bringToFront();
+	const body = context.page.locator("body");
+	await body.focus();
+	await body.click();
+	await body.blur();
+	for (const command of [
+		NVDAKeyCodeCommands.readNextFocusableItem,
+		NVDAKeyCodeCommands.toggleBetweenBrowseAndFocusMode,
+		NVDAKeyCodeCommands.toggleBetweenBrowseAndFocusMode,
+		NVDAKeyCodeCommands.exitFocusMode
+	]) {
+		await nvda.perform(command, { capture: false });
+		await delay(100);
+	}
+	for (let attempt = 0;; attempt++) {
+		await nvda.perform(NVDAKeyCodeCommands.reportCurrentFocus);
+		const focus = clean(await nvda.lastSpokenPhrase());
+		if (focus.includes("document") || title && focus.includes(title)) break;
+		if (attempt === 6) throw new Error(`[@uniaria/testing] NVDA could not move Chrome's focus into the page: ${focus}.`);
+		await nvda.press("F6", { capture: false });
+		await delay(300);
+	}
+}
+/**
+* Starts the operating system's screen reader and moves it into the page.
+* Returns which one runs; a second call while it runs returns the same.
+*/
+const uniScreenReaderStart = async (context) => {
+	if (running) return running.name;
+	const name = process.platform === "darwin" ? "voiceover" : process.platform === "win32" ? "nvda" : void 0;
+	if (!name) throw new Error(`[@uniaria/testing] No screen reader to drive on ${process.platform}: VoiceOver needs macOS, NVDA needs Windows.`);
+	const guidepup = await import("@guidepup/guidepup");
+	const reader = name === "voiceover" ? guidepup.voiceOver : guidepup.nvda;
+	await reader.start();
+	try {
+		if (name === "voiceover") await enterPageWithVoiceOver(guidepup, context);
+		else await enterPageWithNvda(guidepup, context);
+		await reader.clearSpokenPhraseLog();
+	} catch (error) {
+		await reader.stop().catch(() => void 0);
+		throw error;
+	}
+	running = {
+		name,
+		reader,
+		guidepup,
+		read: 0,
+		hidden: /* @__PURE__ */ new Set()
+	};
+	return name;
+};
+/** Stops the screen reader, if one runs. */
+const uniScreenReaderStop = async () => {
+	const current = running;
+	running = void 0;
+	await current?.reader.stop().catch(() => void 0);
+};
+/**
+* Records what the screen reader is saying now, then forgets everything it
+* has said: the next key's phrases are its own. Shift is the key it presses,
+* which neither screen reader speaks.
+*/
+const uniScreenReaderSettle = async () => {
+	const current = active();
+	await delay(500);
+	await current.reader.press("Shift");
+	await current.reader.clearSpokenPhraseLog();
+	current.read = 0;
+	current.hidden.clear();
+};
+/**
+* What the screen reader holds for the element with keyboard focus: NVDA
+* reads it again (NVDA+Tab), VoiceOver gives the text of the item in its
+* cursor, which follows keyboard focus (a key to describe it would turn
+* that tracking off). `spoken` leaves NVDA's report out.
+*/
+async function readFocus(current) {
+	const { guidepup } = current;
+	if (current.name === "voiceover") return guidepup.voiceOver.itemText();
+	const from = (await current.reader.spokenPhraseLog()).length;
+	await guidepup.nvda.perform(guidepup.NVDAKeyCodeCommands.reportCurrentFocus);
+	const log = await current.reader.spokenPhraseLog();
+	for (let index = from; index < log.length; index++) current.hidden.add(index);
+	return log.slice(from).join(" / ");
+}
+/**
+* With `UNIARIA_SCREEN_READERS=discover`, logs what the screen reader holds
+* for the focused element after each key, to tell a focus that went astray
+* from one it didn't announce.
+*/
+async function reportFocus(current, after) {
+	if (process.env.UNIARIA_SCREEN_READERS !== "discover") return;
+	console.log(`[${current.name}] focus after ${after}: ${JSON.stringify(await readFocus(current))}`);
+}
+/** Presses a key through the screen reader and waits for its speech. */
+const uniScreenReaderPress = async (_context, key) => {
+	const current = active();
+	await current.reader.press(key);
+	await reportFocus(current, key);
+};
+/** Types text through the screen reader, a key per character. */
+const uniScreenReaderType = async (_context, text) => {
+	const current = active();
+	await current.reader.type(text);
+	await reportFocus(current, JSON.stringify(text));
+};
+/** What the screen reader holds for the element with keyboard focus. */
+const uniScreenReaderReadFocus = () => readFocus(active());
+/** Moves the screen reader's cursor to the next item. */
+const uniScreenReaderNext = async () => {
+	await active().reader.next();
+};
+/** The phrases spoken since the last call, in order. */
+const uniScreenReaderSpoken = async () => {
+	const current = active();
+	const log = await current.reader.spokenPhraseLog();
+	const fresh = log.slice(current.read).filter((_, index) => !current.hidden.has(current.read + index));
+	current.read = log.length;
+	return fresh;
+};
+const screenReaderCommands = {
+	uniScreenReaderStart,
+	uniScreenReaderStop,
+	uniScreenReaderSettle,
+	uniScreenReaderPress,
+	uniScreenReaderType,
+	uniScreenReaderNext,
+	uniScreenReaderReadFocus,
+	uniScreenReaderSpoken
+};
+//#endregion
+//#region src/commands.ts
+/** How far below a target `moveOutside` puts the pointer. */
+const OUTSIDE_OFFSET = 24;
+async function boxOf(context, selector) {
+	const locator = (await context.frame()).locator(selector);
+	await locator.scrollIntoViewIfNeeded();
+	const box = await locator.boundingBox();
+	if (!box) throw new Error(`Conformance input: "${selector}" has no box.`);
+	return box;
+}
+const uniPointerDown = async (context, selector, button) => {
+	const box = await boxOf(context, selector);
+	await context.page.mouse.move(box.x + box.width / 2, box.y + box.height / 2);
+	await context.page.mouse.down({ button });
+};
+const uniPointerMove = async (context, selector, where) => {
+	const box = await boxOf(context, selector);
+	const y = where === "center" ? box.y + box.height / 2 : box.y + box.height + OUTSIDE_OFFSET;
+	await context.page.mouse.move(box.x + box.width / 2, y, { steps: 2 });
+};
+const uniPointerUp = async (context, button) => {
+	await context.page.mouse.up({ button });
+};
+/** Turns the wheel wherever the pointer is. */
+const uniWheel = async (context, deltaX, deltaY) => {
+	await context.page.mouse.wheel(deltaX, deltaY);
+};
+const uniKeyDown = async (context, key) => {
+	await context.page.keyboard.down(key);
+};
+const uniKeyUp = async (context, key) => {
+	await context.page.keyboard.up(key);
+};
+/** One DevTools session per page, for touch input. */
+const sessions = /* @__PURE__ */ new WeakMap();
+function isChromium(context) {
+	return context.context.browser()?.browserType().name() === "chromium";
+}
+/**
+* Whether `uniTouch` works in this browser. Only Chromium takes real touch
+* input through DevTools (`Input.dispatchTouchEvent`); Playwright's own
+* touchscreen needs `hasTouch` on the whole context, which would make every
+* other test run as if on a touch device.
+*/
+const uniTouchSupported = (context) => isChromium(context);
+/**
+* A finger at the target's centre (or 24px below it, `outside`) for
+* `touchStart` and `touchMove`; lifted for `touchEnd` and `touchCancel`.
+*/
+const uniTouch = async (context, phase, selector, where = "center") => {
+	if (!isChromium(context)) throw new Error("Conformance input: touch needs Chromium.");
+	let session = sessions.get(context.page);
+	if (!session) {
+		session = context.context.newCDPSession(context.page);
+		sessions.set(context.page, session);
+	}
+	const touchPoints = [];
+	if (selector !== void 0) {
+		const box = await boxOf(context, selector);
+		const y = where === "center" ? box.y + box.height / 2 : box.y + box.height + OUTSIDE_OFFSET;
+		touchPoints.push({
+			x: box.x + box.width / 2,
+			y,
+			id: 0
+		});
+	}
+	await (await session).send("Input.dispatchTouchEvent", {
+		type: phase,
+		touchPoints
+	});
+};
+/**
+* Emulates media features for the whole page, frames included. Forced
+* colors work in Chromium only.
+*/
+const uniEmulateMedia = async (context, features) => {
+	await context.page.emulateMedia(features);
+};
+const uniCommands = {
+	uniTouchSupported,
+	uniTouch,
+	uniPointerDown,
+	uniPointerMove,
+	uniPointerUp,
+	uniWheel,
+	uniKeyDown,
+	uniKeyUp,
+	uniEmulateMedia
+};
+//#endregion
+export { screenReaderCommands, uniCommands, uniEmulateMedia, uniKeyDown, uniKeyUp, uniPointerDown, uniPointerMove, uniPointerUp, uniTouch, uniTouchSupported, uniWheel };
+
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","names":[],"sources":["../src/screen-reader-commands.ts","../src/commands.ts"],"sourcesContent":["/**\n * Node-side commands that drive a real screen reader through Guidepup\n * (`@guidepup/guidepup`, an optional peer): VoiceOver on macOS and NVDA on\n * Windows, for the scenarios that need one (design doc, Testing and\n * accessibility: real screen readers, nightly). Register them beside\n * `uniCommands` in a browser project that runs headed, one file at a time,\n * on a machine prepared with `@guidepup/setup` (`setup --ci`, then\n * `install`).\n *\n * Keys go through the operating system, as a user's would, so the browser\n * window has to be in front and the screen reader inside the page: starting\n * does what `@guidepup/playwright` does (MIT), ported because that package\n * needs `@playwright/test`.\n */\n\nimport { execFile } from 'node:child_process';\nimport { promisify } from 'node:util';\n\nimport type * as GuidepupModule from '@guidepup/guidepup';\nimport type {} from '@vitest/browser-playwright';\nimport type { BrowserCommand, BrowserCommandContext } from 'vitest/node';\n\nimport type { ScreenReaderName } from './conformance/scenario';\n\ntype Guidepup = typeof GuidepupModule;\ntype Reader = Guidepup['voiceOver'] | Guidepup['nvda'];\n\ninterface Running {\n  readonly name: ScreenReaderName;\n  readonly reader: Reader;\n  readonly guidepup: Guidepup;\n  /** How much of the spoken phrase log `spoken` has returned. */\n  read: number;\n  /** Log entries `spoken` leaves out: focus reports while discovering. */\n  readonly hidden: Set<number>;\n}\n\nlet running: Running | undefined;\n\nconst delay = (ms: number) =>\n  new Promise<void>((resolve) => setTimeout(resolve, ms));\n\n/** Playwright's browsers as macOS knows them, most likely first. */\nconst MAC_BUNDLE_IDS: Readonly<Record<string, readonly string[]>> = {\n  chromium: ['com.google.chrome.for.testing', 'org.chromium.Chromium'],\n  firefox: ['org.mozilla.nightlyunofficial', 'org.mozilla.nightly'],\n  webkit: ['org.webkit.Playwright'],\n};\n\n/** Playwright's browsers as their Windows window titles end. */\nconst WINDOWS_NAMES: Readonly<Record<string, readonly string[]>> = {\n  chromium: ['Google Chrome for Testing', 'Chromium'],\n  firefox: ['Nightly', 'Firefox'],\n  webkit: ['Playwright'],\n};\n\nfunction browserName(context: BrowserCommandContext): string {\n  return context.context.browser()?.browserType().name() ?? 'chromium';\n}\n\nfunction active(): Running {\n  if (!running) {\n    throw new Error(\n      '[@uniaria/testing] No screen reader is running: the screen-reader project starts one for each file.',\n    );\n  }\n  return running;\n}\n\n/** Lower case, punctuation as spaces: how window titles are compared. */\nconst clean = (text: string) =>\n  text\n    .toLowerCase()\n    .replace(/[|¦:;'\"`\\-‐–—·_()[\\]{}\\\\^~]/g, ' ')\n    .replace(/\\s+/g, ' ')\n    .trim();\n\n/** Brings the browser in front by its bundle id, trying each in turn. */\nasync function activateMac(ids: readonly string[]): Promise<void> {\n  const run = promisify(execFile);\n  for (const id of ids) {\n    try {\n      await run('osascript', ['-e', `tell application id \"${id}\" to activate`]);\n      return;\n    } catch {\n      // Not this build; try the next id.\n    }\n  }\n  throw new Error(\n    `[@uniaria/testing] Could not bring the browser in front (${ids.join(', ')}).`,\n  );\n}\n\n/**\n * Brings the browser in front and moves VoiceOver into its web content\n * through the item chooser, as `@guidepup/playwright` does.\n */\nasync function enterPageWithVoiceOver(\n  guidepup: Guidepup,\n  context: BrowserCommandContext,\n): Promise<void> {\n  const { voiceOver, MacOSKeyCodes, voiceOverKeyCodeCommands } = guidepup;\n  const silence = () =>\n    voiceOver.perform({ keyCode: MacOSKeyCodes.Control }, { capture: false });\n  await activateMac(MAC_BUNDLE_IDS[browserName(context)] ?? []);\n  await silence();\n  await context.page.bringToFront();\n  // Something the item chooser can find as \"web content\".\n  await context.page.evaluate(() => {\n    const marker = document.createElement('input');\n    marker.id = '__uniaria_screen_reader_marker__';\n    marker.readOnly = true;\n    marker.tabIndex = -1;\n    marker.setAttribute('aria-label', 'Start');\n    marker.style.cssText =\n      'position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)';\n    document.body.prepend(marker);\n  });\n  try {\n    for (let attempt = 0; ; attempt++) {\n      await silence();\n      await delay(100);\n      await voiceOver.perform(\n        { keyCode: MacOSKeyCodes.Escape },\n        { capture: false },\n      );\n      await delay(100);\n      await voiceOver.perform(voiceOverKeyCodeCommands.openItemChooser);\n      if (\n        (await voiceOver.lastSpokenPhrase())\n          .toLowerCase()\n          .includes('item chooser')\n      ) {\n        break;\n      }\n      if (attempt === 10) {\n        throw new Error(\n          '[@uniaria/testing] VoiceOver did not open its item chooser.',\n        );\n      }\n    }\n    let isFound = false;\n    for (const character of 'web content') {\n      await silence();\n      await delay(100);\n      await voiceOver.type(character, { capture: 'initial' });\n      if (\n        (await voiceOver.lastSpokenPhrase())\n          .toLowerCase()\n          .includes('web content')\n      ) {\n        isFound = true;\n        break;\n      }\n    }\n    if (!isFound) {\n      throw new Error(\n        '[@uniaria/testing] VoiceOver found no \"web content\" in its item chooser.',\n      );\n    }\n    await voiceOver.perform(\n      { keyCode: MacOSKeyCodes.Enter },\n      { capture: false },\n    );\n    await voiceOver.interact({ capture: false });\n    await delay(100);\n  } finally {\n    await context.page.evaluate(() =>\n      document.getElementById('__uniaria_screen_reader_marker__')?.remove(),\n    );\n  }\n}\n\n/**\n * Switches windows until NVDA reports the browser's title, then puts NVDA\n * in browse mode at the top of the page, as `@guidepup/playwright` does.\n */\nasync function enterPageWithNvda(\n  guidepup: Guidepup,\n  context: BrowserCommandContext,\n): Promise<void> {\n  const { nvda, NVDAKeyCodeCommands, WindowsKeyCodes, WindowsModifiers } =\n    guidepup;\n  const title = clean(await context.page.title());\n  const names = (WINDOWS_NAMES[browserName(context)] ?? []).map(clean);\n  const isBrowser = (window: string) =>\n    (title.length > 0 && window.startsWith(title)) ||\n    names.some((name) => window.includes(name));\n  await nvda.perform(NVDAKeyCodeCommands.exitFocusMode, { capture: false });\n  await delay(100);\n  for (let attempt = 0; ; attempt++) {\n    await nvda.perform(NVDAKeyCodeCommands.reportTitle);\n    if (isBrowser(clean(await nvda.lastSpokenPhrase()))) break;\n    if (attempt === 10) {\n      throw new Error(\n        '[@uniaria/testing] NVDA could not bring the browser in front.',\n      );\n    }\n    await nvda.perform(\n      {\n        keyCode: [WindowsKeyCodes.Escape],\n        modifiers: [WindowsModifiers.Alt],\n      },\n      { capture: false },\n    );\n    await delay(500);\n  }\n  await context.page.bringToFront();\n  const body = context.page.locator('body');\n  await body.focus();\n  await body.click();\n  await body.blur();\n  // Firefox can leave NVDA on the whole browser after switching windows;\n  // moving to a focusable item and toggling the mode twice brings browse\n  // mode back (nvaccess/nvda#5758).\n  for (const command of [\n    NVDAKeyCodeCommands.readNextFocusableItem,\n    NVDAKeyCodeCommands.toggleBetweenBrowseAndFocusMode,\n    NVDAKeyCodeCommands.toggleBetweenBrowseAndFocusMode,\n    NVDAKeyCodeCommands.exitFocusMode,\n  ]) {\n    await nvda.perform(command, { capture: false });\n    await delay(100);\n  }\n  // Keys go where Chrome's own focus is, which can stay in its toolbar\n  // whatever the page focuses; F6 moves it on, back to the page.\n  for (let attempt = 0; ; attempt++) {\n    await nvda.perform(NVDAKeyCodeCommands.reportCurrentFocus);\n    const focus = clean(await nvda.lastSpokenPhrase());\n    if (focus.includes('document') || (title && focus.includes(title))) break;\n    if (attempt === 6) {\n      throw new Error(\n        `[@uniaria/testing] NVDA could not move Chrome's focus into the page: ${focus}.`,\n      );\n    }\n    await nvda.press('F6', { capture: false });\n    await delay(300);\n  }\n}\n\n/**\n * Starts the operating system's screen reader and moves it into the page.\n * Returns which one runs; a second call while it runs returns the same.\n */\nexport const uniScreenReaderStart: BrowserCommand<[]> = async (context) => {\n  if (running) return running.name;\n  const name: ScreenReaderName | undefined =\n    process.platform === 'darwin'\n      ? 'voiceover'\n      : process.platform === 'win32'\n        ? 'nvda'\n        : undefined;\n  if (!name) {\n    throw new Error(\n      `[@uniaria/testing] No screen reader to drive on ${process.platform}: VoiceOver needs macOS, NVDA needs Windows.`,\n    );\n  }\n  const guidepup = await import('@guidepup/guidepup');\n  const reader = name === 'voiceover' ? guidepup.voiceOver : guidepup.nvda;\n  await reader.start();\n  try {\n    if (name === 'voiceover') await enterPageWithVoiceOver(guidepup, context);\n    else await enterPageWithNvda(guidepup, context);\n    await reader.clearSpokenPhraseLog();\n  } catch (error) {\n    await reader.stop().catch(() => undefined);\n    throw error;\n  }\n  running = { name, reader, guidepup, read: 0, hidden: new Set() };\n  return name;\n};\n\n/** Stops the screen reader, if one runs. */\nexport const uniScreenReaderStop: BrowserCommand<[]> = async () => {\n  const current = running;\n  running = undefined;\n  await current?.reader.stop().catch(() => undefined);\n};\n\n/**\n * Records what the screen reader is saying now, then forgets everything it\n * has said: the next key's phrases are its own. Shift is the key it presses,\n * which neither screen reader speaks.\n */\nexport const uniScreenReaderSettle: BrowserCommand<[]> = async () => {\n  const current = active();\n  await delay(500);\n  await current.reader.press('Shift');\n  await current.reader.clearSpokenPhraseLog();\n  current.read = 0;\n  current.hidden.clear();\n};\n\n/**\n * What the screen reader holds for the element with keyboard focus: NVDA\n * reads it again (NVDA+Tab), VoiceOver gives the text of the item in its\n * cursor, which follows keyboard focus (a key to describe it would turn\n * that tracking off). `spoken` leaves NVDA's report out.\n */\nasync function readFocus(current: Running): Promise<string> {\n  const { guidepup } = current;\n  if (current.name === 'voiceover') return guidepup.voiceOver.itemText();\n  const from = (await current.reader.spokenPhraseLog()).length;\n  await guidepup.nvda.perform(guidepup.NVDAKeyCodeCommands.reportCurrentFocus);\n  const log = await current.reader.spokenPhraseLog();\n  for (let index = from; index < log.length; index++) current.hidden.add(index);\n  return log.slice(from).join(' / ');\n}\n\n/**\n * With `UNIARIA_SCREEN_READERS=discover`, logs what the screen reader holds\n * for the focused element after each key, to tell a focus that went astray\n * from one it didn't announce.\n */\nasync function reportFocus(current: Running, after: string): Promise<void> {\n  if (process.env.UNIARIA_SCREEN_READERS !== 'discover') return;\n  // eslint-disable-next-line no-console\n  console.log(\n    `[${current.name}] focus after ${after}: ${JSON.stringify(await readFocus(current))}`,\n  );\n}\n\n/** Presses a key through the screen reader and waits for its speech. */\nexport const uniScreenReaderPress: BrowserCommand<[key: string]> = async (\n  _context,\n  key,\n) => {\n  const current = active();\n  await current.reader.press(key);\n  await reportFocus(current, key);\n};\n\n/** Types text through the screen reader, a key per character. */\nexport const uniScreenReaderType: BrowserCommand<[text: string]> = async (\n  _context,\n  text,\n) => {\n  const current = active();\n  await current.reader.type(text);\n  await reportFocus(current, JSON.stringify(text));\n};\n\n/** What the screen reader holds for the element with keyboard focus. */\nexport const uniScreenReaderReadFocus: BrowserCommand<[]> = () =>\n  readFocus(active());\n\n/** Moves the screen reader's cursor to the next item. */\nexport const uniScreenReaderNext: BrowserCommand<[]> = async () => {\n  await active().reader.next();\n};\n\n/** The phrases spoken since the last call, in order. */\nexport const uniScreenReaderSpoken: BrowserCommand<[]> = async () => {\n  const current = active();\n  const log = await current.reader.spokenPhraseLog();\n  const fresh = log\n    .slice(current.read)\n    .filter((_, index) => !current.hidden.has(current.read + index));\n  current.read = log.length;\n  return fresh;\n};\n\nexport const screenReaderCommands = {\n  uniScreenReaderStart,\n  uniScreenReaderStop,\n  uniScreenReaderSettle,\n  uniScreenReaderPress,\n  uniScreenReaderType,\n  uniScreenReaderNext,\n  uniScreenReaderReadFocus,\n  uniScreenReaderSpoken,\n};\n","/**\n * Node-side Playwright commands behind the conformance input helpers. Vitest's\n * `userEvent` cannot hold a mouse button while the pointer moves, which press\n * scenarios need (press, leave, come back), so these drive Playwright's mouse\n * and keyboard directly. Register them in the browser test project:\n * `browser: { commands: uniCommands }`.\n *\n * Targets arrive as CSS selectors because elements cannot cross from the\n * browser to Node. Coordinates come from the test frame's locator, so they\n * account for the iframe Vitest runs tests in.\n *\n * `screenReaderCommands` drive the machine's real screen reader through\n * Guidepup, for a project that runs scenarios with `screenReader: true`:\n * `commands: { ...uniCommands, ...screenReaderCommands }`.\n */\n\nimport type {} from '@vitest/browser-playwright';\nimport type { BrowserCommand, BrowserCommandContext } from 'vitest/node';\n\ntype MouseButton = 'left' | 'right' | 'middle';\n\n/** How far below a target `moveOutside` puts the pointer. */\nconst OUTSIDE_OFFSET = 24;\n\nasync function boxOf(context: BrowserCommandContext, selector: string) {\n  const locator = (await context.frame()).locator(selector);\n  await locator.scrollIntoViewIfNeeded();\n  const box = await locator.boundingBox();\n  if (!box) throw new Error(`Conformance input: \"${selector}\" has no box.`);\n  return box;\n}\n\nexport const uniPointerDown: BrowserCommand<\n  [selector: string, button: MouseButton]\n> = async (context, selector, button) => {\n  const box = await boxOf(context, selector);\n  await context.page.mouse.move(box.x + box.width / 2, box.y + box.height / 2);\n  await context.page.mouse.down({ button });\n};\n\nexport const uniPointerMove: BrowserCommand<\n  [selector: string, where: 'center' | 'outside']\n> = async (context, selector, where) => {\n  const box = await boxOf(context, selector);\n  const y =\n    where === 'center'\n      ? box.y + box.height / 2\n      : box.y + box.height + OUTSIDE_OFFSET;\n  await context.page.mouse.move(box.x + box.width / 2, y, { steps: 2 });\n};\n\nexport const uniPointerUp: BrowserCommand<[button: MouseButton]> = async (\n  context,\n  button,\n) => {\n  await context.page.mouse.up({ button });\n};\n\n/** Turns the wheel wherever the pointer is. */\nexport const uniWheel: BrowserCommand<\n  [deltaX: number, deltaY: number]\n> = async (context, deltaX, deltaY) => {\n  await context.page.mouse.wheel(deltaX, deltaY);\n};\n\nexport const uniKeyDown: BrowserCommand<[key: string]> = async (\n  context,\n  key,\n) => {\n  await context.page.keyboard.down(key);\n};\n\nexport const uniKeyUp: BrowserCommand<[key: string]> = async (context, key) => {\n  await context.page.keyboard.up(key);\n};\n\ntype TouchPhase = 'touchStart' | 'touchMove' | 'touchEnd' | 'touchCancel';\n\ntype CDPSession = Awaited<\n  ReturnType<BrowserCommandContext['context']['newCDPSession']>\n>;\n\n/** One DevTools session per page, for touch input. */\nconst sessions = new WeakMap<object, Promise<CDPSession>>();\n\nfunction isChromium(context: BrowserCommandContext): boolean {\n  return context.context.browser()?.browserType().name() === 'chromium';\n}\n\n/**\n * Whether `uniTouch` works in this browser. Only Chromium takes real touch\n * input through DevTools (`Input.dispatchTouchEvent`); Playwright's own\n * touchscreen needs `hasTouch` on the whole context, which would make every\n * other test run as if on a touch device.\n */\nexport const uniTouchSupported: BrowserCommand<[]> = (context) =>\n  isChromium(context);\n\n/**\n * A finger at the target's centre (or 24px below it, `outside`) for\n * `touchStart` and `touchMove`; lifted for `touchEnd` and `touchCancel`.\n */\nexport const uniTouch: BrowserCommand<\n  [phase: TouchPhase, selector?: string, where?: 'center' | 'outside']\n> = async (context, phase, selector, where = 'center') => {\n  if (!isChromium(context)) {\n    throw new Error('Conformance input: touch needs Chromium.');\n  }\n  let session = sessions.get(context.page);\n  if (!session) {\n    session = context.context.newCDPSession(context.page);\n    sessions.set(context.page, session);\n  }\n  const touchPoints = [];\n  if (selector !== undefined) {\n    const box = await boxOf(context, selector);\n    const y =\n      where === 'center'\n        ? box.y + box.height / 2\n        : box.y + box.height + OUTSIDE_OFFSET;\n    touchPoints.push({ x: box.x + box.width / 2, y, id: 0 });\n  }\n  await (\n    await session\n  ).send('Input.dispatchTouchEvent', {\n    type: phase,\n    touchPoints,\n  });\n};\n\n/** Media features Playwright emulates; `null` ends a feature's emulation. */\nexport interface MediaFeatures {\n  readonly forcedColors?: 'active' | 'none' | null;\n  readonly contrast?: 'more' | 'no-preference' | null;\n  readonly reducedMotion?: 'reduce' | 'no-preference' | null;\n  readonly colorScheme?: 'light' | 'dark' | 'no-preference' | null;\n}\n\n/**\n * Emulates media features for the whole page, frames included. Forced\n * colors work in Chromium only.\n */\nexport const uniEmulateMedia: BrowserCommand<\n  [features: MediaFeatures]\n> = async (context, features) => {\n  await context.page.emulateMedia(features);\n};\n\nexport { screenReaderCommands } from './screen-reader-commands';\n\nexport const uniCommands = {\n  uniTouchSupported,\n  uniTouch,\n  uniPointerDown,\n  uniPointerMove,\n  uniPointerUp,\n  uniWheel,\n  uniKeyDown,\n  uniKeyUp,\n  uniEmulateMedia,\n};\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { A as h, C as RenderedRows, D as TemplateNode, E as TemplateElement, F as partSelector, I as renderTemplate, L as rows, M as isRows, N as nested, O as TemplateRows, P as partName, R as templateParts, S as RenderTemplateOptions, T as TemplateComponent, _ as ConformanceAdapter, a as MouseButton, b as Mounted, c as ScenarioContext, d as ScenarioRun, f as ScreenReaderInput, g as AdapterMount, h as defineConformance, i as KeyboardInput, j as isNested, k as VIRTUALIZER, l as ScenarioGroup, m as TouchInput, n as ConformanceSuite, o as PointerInput, p as ScreenReaderName, r as InputNeed, s as Scenario, t as ConformanceBuilder, u as ScenarioOptions, v as MountOptions, w as TemplateAttrs, x as RecordedEvent, y as MountRequest } from "./scenario-DMaR4JJc.js";
+export { type AdapterMount, type ConformanceAdapter, type ConformanceBuilder, type ConformanceSuite, type InputNeed, type KeyboardInput, type MountOptions, type MountRequest, type Mounted, type MouseButton, type PointerInput, type RecordedEvent, type RenderTemplateOptions, type RenderedRows, type Scenario, type ScenarioContext, type ScenarioGroup, type ScenarioOptions, type ScenarioRun, type ScreenReaderInput, type ScreenReaderName, type TemplateAttrs, type TemplateComponent, type TemplateElement, type TemplateNode, type TemplateRows, type TouchInput, VIRTUALIZER, defineConformance, h, isNested, isRows, nested, partName, partSelector, renderTemplate, rows, templateParts };

package/dist/index.js

@@ -0,0 +1,54 @@
+import { a as nested, c as renderTemplate, i as isRows, l as rows, n as h, o as partName, r as isNested, s as partSelector, t as VIRTUALIZER, u as templateParts } from "./template-Cn6bp45u.js";
+//#region src/conformance/scenario.ts
+/**
+* Declares a component's conformance suite:
+*
+* ```ts
+* export const buttonConformance = defineConformance<ButtonProps, ButtonState>(
+*   'button',
+*   ({ scenario, group }) => {
+*     group('keyboard', () => {
+*       scenario('Enter presses on keyup', async ({ mount, keyboard }) => { … });
+*     });
+*   },
+* );
+* ```
+*/
+function defineConformance(component, define) {
+	const root = [];
+	let current = root;
+	define({
+		scenario(name, run, options) {
+			current.push({
+				kind: "scenario",
+				name,
+				run,
+				phase: options?.phase ?? 1,
+				needs: options?.needs ?? []
+			});
+		},
+		group(name, defineGroup) {
+			const children = [];
+			current.push({
+				kind: "group",
+				name,
+				children
+			});
+			const parent = current;
+			current = children;
+			try {
+				defineGroup();
+			} finally {
+				current = parent;
+			}
+		}
+	});
+	return {
+		component,
+		children: root
+	};
+}
+//#endregion
+export { VIRTUALIZER, defineConformance, h, isNested, isRows, nested, partName, partSelector, renderTemplate, rows, templateParts };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/conformance/scenario.ts"],"sourcesContent":["/**\n * Defining conformance suites. A suite is data: a component name and a tree of\n * scenarios, written from the component's approved spec. Running it is the\n * runner's job (`@uniaria/testing/browser`), once per adapter.\n *\n * Each scenario is tagged with the roadmap phase whose features it needs.\n * An adapter run declares the phase it has reached, and later scenarios are\n * reported as skipped instead of failing (Button's touch and virtual-click\n * scenarios wait for the phase 2 interaction layer). A scenario can also need\n * input that only some browsers take (touch); elsewhere it is skipped too.\n * Scenarios that need a real screen reader run only in the screen-reader\n * project, nightly, and only they run there.\n */\n\nimport type { MountOptions, Mounted } from './contract';\n\nexport type MouseButton = 'left' | 'right' | 'middle';\n\n/** Real mouse input through Playwright, at the target's centre. */\nexport interface PointerInput {\n  /** Moves to the target and presses a button (left by default). */\n  down(target: Element, options?: { button?: MouseButton }): Promise<void>;\n  /** Moves to the target's centre with the button state unchanged. */\n  move(target: Element): Promise<void>;\n  /** Moves to a point 24px below the target. */\n  moveOutside(target: Element): Promise<void>;\n  /** Releases a button (left by default) wherever the pointer is. */\n  up(options?: { button?: MouseButton }): Promise<void>;\n  /**\n   * Turns the wheel wherever the pointer is, with the modifier keys held\n   * down: a negative `deltaY` scrolls up. One call is one `wheel` event.\n   */\n  wheel(delta: { deltaX?: number; deltaY?: number }): Promise<void>;\n  /** `down` on the target, then `up`. */\n  click(target: Element, options?: { button?: MouseButton }): Promise<void>;\n}\n\n/**\n * Real keyboard input through Playwright, sent to the focused element. Key\n * names follow Playwright: `Enter`, `Space`, `Escape`, `ArrowDown`.\n */\nexport interface KeyboardInput {\n  /** Presses and holds a key. Calling it again while held sends a repeat. */\n  down(key: string): Promise<void>;\n  up(key: string): Promise<void>;\n  /** `down`, then `up`. */\n  press(key: string): Promise<void>;\n  /** Moves focus with Tab, or Shift+Tab with `isBackward`. */\n  tab(options?: { isBackward?: boolean }): Promise<void>;\n}\n\n/**\n * Real touch input, one finger at a time, through DevTools: only Chromium\n * takes it, so scenarios that use it declare `needs: ['touch']`. The browser\n * turns it into touch and pointer events, compatibility mouse events and a\n * click, and a finger that moves away starts a scroll.\n */\nexport interface TouchInput {\n  /** Puts a finger down on the target's centre. */\n  down(target: Element): Promise<void>;\n  /** Moves the finger to the target's centre. */\n  move(target: Element): Promise<void>;\n  /** Moves the finger 24px below the target. */\n  moveOutside(target: Element): Promise<void>;\n  /** Lifts the finger wherever it is. */\n  up(): Promise<void>;\n  /** `down` on the target, then `up`. */\n  tap(target: Element): Promise<void>;\n}\n\n/** Which real screen reader a scenario runs with. */\nexport type ScreenReaderName = 'voiceover' | 'nvda';\n\n/**\n * A real screen reader driven through Guidepup: VoiceOver on macOS, NVDA on\n * Windows, both with Chromium. Keys go through the operating system, so the\n * screen reader hears them as a user's and speaks what they do. Only in\n * scenarios that declare `needs: ['screenReader']`, which run nightly.\n *\n * The screen readers word things differently (`check box` in NVDA,\n * `checkbox` in VoiceOver), so scenarios match what they need to hear, not\n * whole phrases.\n */\nexport interface ScreenReaderInput {\n  /** Which screen reader runs. */\n  readonly name: ScreenReaderName;\n  /**\n   * Clicks `element` (a text field before the component), waits for the\n   * screen reader to speak it and forgets what it said: the scenario starts\n   * from there, usually with Tab into the component.\n   */\n  startFrom(element: HTMLElement): Promise<void>;\n  /**\n   * Presses a key through the screen reader (Playwright's names: `Tab`,\n   * `ArrowDown`, `Shift+Tab`) and waits until it stops speaking.\n   */\n  press(key: string): Promise<void>;\n  /** Types text through the screen reader, a key per character. */\n  type(text: string): Promise<void>;\n  /** Moves the screen reader's own cursor to the next item. */\n  next(): Promise<void>;\n  /**\n   * What the screen reader holds for the element with keyboard focus: NVDA\n   * reads it again (NVDA+Tab), VoiceOver gives its cursor's item text. A\n   * check that holds when the speech on arrival is cut short.\n   */\n  readFocus(): Promise<string>;\n  /**\n   * What it has said since `startFrom` or the last call: each key's phrases\n   * in order, joined with ` / `.\n   */\n  spoken(): Promise<string>;\n}\n\n/** Input a scenario needs beyond mouse and keyboard. */\nexport type InputNeed = 'touch' | 'screenReader';\n\nexport interface ScenarioContext<Props, State> {\n  /** Mounts the suite's component through the adapter under test. */\n  mount(options: MountOptions<Props>): Promise<Mounted<Props, State>>;\n  pointer: PointerInput;\n  keyboard: KeyboardInput;\n  /** Only in scenarios that declare `needs: ['touch']`. */\n  touch: TouchInput;\n  /** Only in scenarios that declare `needs: ['screenReader']`. */\n  screenReader: ScreenReaderInput;\n  /**\n   * Reads the whole document with the virtual screen reader and returns every\n   * phrase, from `document` to `end of document`.\n   */\n  spoken(): Promise<string[]>;\n  /**\n   * Starts hearing live regions with the virtual screen reader. The returned\n   * function gives what they have announced since, in order, each phrase\n   * prefixed with its politeness: `assertive: Saved`. Listening lasts until\n   * the scenario ends, and `spoken()` can't run meanwhile.\n   */\n  listen(): Promise<() => Promise<string[]>>;\n}\n\nexport type ScenarioRun<Props, State> = (\n  context: ScenarioContext<Props, State>,\n) => Promise<void>;\n\nexport interface ScenarioOptions {\n  /** Roadmap phase whose features the scenario needs. Default 1. */\n  readonly phase?: number;\n  /**\n   * Input beyond mouse and keyboard. Where the browser can't take it, the\n   * scenario is skipped; a scenario that needs a real screen reader runs\n   * only where one runs.\n   */\n  readonly needs?: readonly InputNeed[];\n}\n\nexport interface Scenario<Props, State> {\n  readonly kind: 'scenario';\n  readonly name: string;\n  readonly phase: number;\n  readonly needs: readonly InputNeed[];\n  readonly run: ScenarioRun<Props, State>;\n}\n\nexport interface ScenarioGroup<Props, State> {\n  readonly kind: 'group';\n  readonly name: string;\n  readonly children: readonly (\n    Scenario<Props, State> | ScenarioGroup<Props, State>\n  )[];\n}\n\nexport interface ConformanceSuite<Props, State> {\n  /** Definition name: `button`. */\n  readonly component: string;\n  readonly children: readonly (\n    Scenario<Props, State> | ScenarioGroup<Props, State>\n  )[];\n}\n\nexport interface ConformanceBuilder<Props, State> {\n  scenario(\n    name: string,\n    run: ScenarioRun<Props, State>,\n    options?: ScenarioOptions,\n  ): void;\n  group(name: string, define: () => void): void;\n}\n\n/**\n * Declares a component's conformance suite:\n *\n * ```ts\n * export const buttonConformance = defineConformance<ButtonProps, ButtonState>(\n *   'button',\n *   ({ scenario, group }) => {\n *     group('keyboard', () => {\n *       scenario('Enter presses on keyup', async ({ mount, keyboard }) => { … });\n *     });\n *   },\n * );\n * ```\n */\nexport function defineConformance<Props, State>(\n  component: string,\n  define: (builder: ConformanceBuilder<Props, State>) => void,\n): ConformanceSuite<Props, State> {\n  type Child = Scenario<Props, State> | ScenarioGroup<Props, State>;\n  const root: Child[] = [];\n  let current = root;\n\n  define({\n    scenario(name, run, options) {\n      current.push({\n        kind: 'scenario',\n        name,\n        run,\n        phase: options?.phase ?? 1,\n        needs: options?.needs ?? [],\n      });\n    },\n    group(name, defineGroup) {\n      const children: Child[] = [];\n      current.push({ kind: 'group', name, children });\n      const parent = current;\n      current = children;\n      try {\n        defineGroup();\n      } finally {\n        current = parent;\n      }\n    },\n  });\n\n  return { component, children: root };\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA0MA,SAAgB,kBACd,WACA,QACgC;CAEhC,MAAM,OAAgB,CAAC;CACvB,IAAI,UAAU;CAEd,OAAO;EACL,SAAS,MAAM,KAAK,SAAS;GAC3B,QAAQ,KAAK;IACX,MAAM;IACN;IACA;IACA,OAAO,SAAS,SAAS;IACzB,OAAO,SAAS,SAAS,CAAC;GAC5B,CAAC;EACH;EACA,MAAM,MAAM,aAAa;GACvB,MAAM,WAAoB,CAAC;GAC3B,QAAQ,KAAK;IAAE,MAAM;IAAS;IAAM;GAAS,CAAC;GAC9C,MAAM,SAAS;GACf,UAAU;GACV,IAAI;IACF,YAAY;GACd,UAAU;IACR,UAAU;GACZ;EACF;CACF,CAAC;CAED,OAAO;EAAE;EAAW,UAAU;CAAK;AACrC"}