@uniaria/testing 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andrey Yamanov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# @uniaria/testing
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+How UniAria checks that a component behaves the same in every adapter. A
+component's behavior is described once, as a conformance suite of scenarios
+that mount it, drive it with real mouse, keyboard and touch input, and check
+the DOM, focus, events, state and what a screen reader says. Each adapter
+implements one `mount` function, and every suite runs against it in Chromium,
+Firefox and WebKit.
+
+Use it to write an adapter for another framework and prove it with the suites
+the React and custom-element adapters pass, or to test components of your own
+with real input and spoken output.
+
+> **Pre-release.** The API can change in any 0.x version.
+
+## Install
+
+```sh
+pnpm add -D @uniaria/testing vitest @vitest/browser-playwright
+```
+
+It needs Vitest 5 in browser mode with the Playwright provider. Real screen
+readers need [`@guidepup/guidepup`](https://www.guidepup.dev), an optional
+peer.
+
+| Entry                       | Runs in                     | Has                                                                  |
+| --------------------------- | --------------------------- | -------------------------------------------------------------------- |
+| `@uniaria/testing`          | Anywhere, Node included     | `defineConformance`, the markup templates and the contract types     |
+| `@uniaria/testing/browser`  | Vitest browser mode         | `runConformance`, real input, `emulateMedia` and `spokenPhrases`     |
+| `@uniaria/testing/commands` | Node, in your Vitest config | `uniCommands` and `screenReaderCommands`, the Node side of the above |
+
+## Documentation
+
+The [Testing API](https://github.com/tenphi/uniaria/blob/main/docs/api/testing.md)
+page, in the repository's
+[`docs`](https://github.com/tenphi/uniaria/tree/main/docs) folder.
+
+## License
+
+[MIT](https://github.com/tenphi/uniaria/blob/main/LICENSE)

package/dist/browser.d.ts

@@ -0,0 +1,73 @@
+import { _ as ConformanceAdapter, a as MouseButton, i as KeyboardInput, m as TouchInput, n as ConformanceSuite, o as PointerInput } from "./scenario-DMaR4JJc.js";
+import { t as MediaFeatures } from "./commands-DPaip6f1.js";
+//#region src/conformance/input.d.ts
+declare module 'vitest/browser' {
+  interface BrowserCommands {
+    uniPointerDown(selector: string, button: MouseButton): Promise<void>;
+    uniPointerMove(selector: string, where: 'center' | 'outside'): Promise<void>;
+    uniPointerUp(button: MouseButton): Promise<void>;
+    uniWheel(deltaX: number, deltaY: number): Promise<void>;
+    uniKeyDown(key: string): Promise<void>;
+    uniKeyUp(key: string): Promise<void>;
+    uniTouchSupported(): Promise<boolean>;
+    uniTouch(phase: 'touchStart' | 'touchMove' | 'touchEnd' | 'touchCancel', selector?: string, where?: 'center' | 'outside'): Promise<void>;
+  }
+}
+/** Whether this browser takes `touch` input (Chromium only). */
+export declare function isTouchSupported(): Promise<boolean>;
+export declare const pointer: PointerInput;
+export declare const keyboard: KeyboardInput;
+export declare const touch: TouchInput;
+/**
+ * Releases every button and key a scenario left held, and cancels a touch
+ * left down, so it presses nothing in the next scenario.
+ */
+export declare function releaseInput(): Promise<void>;
+//#endregion
+//#region src/media.d.ts
+declare module 'vitest/browser' {
+  interface BrowserCommands {
+    uniEmulateMedia(features: MediaFeatures): Promise<void>;
+  }
+}
+/**
+ * Emulates media features for the whole page until set again; `null` ends
+ * a feature's emulation. Reset what you set after each test, since the
+ * page outlives it. Resolves once the page has restyled: Firefox and WebKit
+ * re-evaluate their stylesheets' media queries on the next frame, after
+ * `matchMedia()` already answers.
+ */
+export declare function emulateMedia(features: MediaFeatures): Promise<void>;
+//#endregion
+//#region src/conformance/run.d.ts
+interface RunOptions {
+  /**
+   * The highest roadmap phase this adapter implements. Scenarios tagged with
+   * a later phase are skipped. Default: run everything.
+   */
+  readonly phase?: number;
+  /**
+   * Runs the scenarios that need a real screen reader
+   * (`needs: ['screenReader']`), and only those, with the machine's screen
+   * reader started for the whole file. Without it they aren't registered.
+   * Needs `screenReaderCommands` from `@uniaria/testing/commands`.
+   */
+  readonly screenReader?: boolean;
+}
+export declare function runConformance(adapter: ConformanceAdapter, suites: readonly ConformanceSuite<any, any>[], options?: RunOptions): void;
+//#endregion
+//#region src/conformance/spoken.d.ts
+/**
+ * Spoken output through `@guidepup/virtual-screen-reader`, the simulated
+ * screen reader every pull request runs. It reads the accessibility tree the
+ * browser exposes, so phrases follow the library's format:
+ * `button, Save, disabled`.
+ */
+/**
+ * Reads `container` (the whole document by default) from start to end and
+ * returns every phrase, `document` to `end of document`.
+ */
+export declare function spokenPhrases(container?: Element): Promise<string[]>;
+//#endregion
+export type { MediaFeatures, RunOptions };
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.js

@@ -0,0 +1,352 @@
+import { s as partSelector } from "./template-Cn6bp45u.js";
+import { commands, userEvent } from "vitest/browser";
+import { afterAll, afterEach, beforeAll, describe, expect, it } from "vitest";
+import { virtual } from "@guidepup/virtual-screen-reader";
+//#region src/conformance/input.ts
+/**
+* Browser side of the conformance input helpers: real mouse, keyboard and
+* touch input through the Playwright commands in `../commands.ts`. Held
+* buttons, keys and fingers are tracked so the runner can release them after
+* each scenario, even one that failed mid-press.
+*/
+const heldButtons = /* @__PURE__ */ new Set();
+const heldKeys = /* @__PURE__ */ new Set();
+let isFingerDown = false;
+let touchSupport;
+/** Whether this browser takes `touch` input (Chromium only). */
+function isTouchSupported() {
+	return touchSupport ??= commands.uniTouchSupported();
+}
+/** A selector that finds exactly this element, without touching the DOM. */
+function selectorFor(element) {
+	const steps = [];
+	let node = element;
+	while (node.parentElement) {
+		const index = Array.prototype.indexOf.call(node.parentElement.children, node);
+		steps.unshift(`${node.localName}:nth-child(${index + 1})`);
+		node = node.parentElement;
+	}
+	return [node.localName, ...steps].join(" > ");
+}
+const down = async (target, options) => {
+	const button = options?.button ?? "left";
+	await commands.uniPointerDown(selectorFor(target), button);
+	heldButtons.add(button);
+};
+const up = async (options) => {
+	const button = options?.button ?? "left";
+	await commands.uniPointerUp(button);
+	heldButtons.delete(button);
+};
+/** How long `pointer.wheel` waits for its event to reach the page. */
+const WHEEL_TIMEOUT = 1e3;
+/** How long `pointer.wheel` waits for its event after a scroll. */
+const SCROLL_GRACE = 250;
+/**
+* Resolves once the page gets a `wheel` event: Firefox's wheel command can
+* resolve before it. A scroll gives the event `SCROLL_GRACE` more, then
+* resolves: WebKit sends no `wheel` event while a button is held, only the
+* scroll, and a scroll can come first that isn't this wheel's (Firefox
+* scrolling one ahead of its event, or one left from an earlier step). A
+* wheel that neither reaches the page nor scrolls gives up after
+* `WHEEL_TIMEOUT`.
+*
+* It resolves in a task after the event, not in the capture listener:
+* there, the caller would go on in the microtasks after that listener,
+* before the event reached the page's own listeners.
+*/
+function wheelArrival() {
+	return new Promise((resolve) => {
+		let timer = setTimeout(done, WHEEL_TIMEOUT);
+		function done() {
+			clearTimeout(timer);
+			window.removeEventListener("wheel", done, true);
+			window.removeEventListener("scroll", scrolled, true);
+			setTimeout(resolve);
+		}
+		function scrolled() {
+			window.removeEventListener("scroll", scrolled, true);
+			clearTimeout(timer);
+			timer = setTimeout(done, SCROLL_GRACE);
+		}
+		window.addEventListener("wheel", done, true);
+		window.addEventListener("scroll", scrolled, true);
+	});
+}
+const pointer = {
+	down,
+	up,
+	move: (target) => commands.uniPointerMove(selectorFor(target), "center"),
+	moveOutside: (target) => commands.uniPointerMove(selectorFor(target), "outside"),
+	async wheel({ deltaX = 0, deltaY = 0 }) {
+		const arrival = wheelArrival();
+		await commands.uniWheel(deltaX, deltaY);
+		await arrival;
+	},
+	async click(target, options) {
+		await down(target, options);
+		await up(options);
+	}
+};
+const keyDown = async (key) => {
+	await commands.uniKeyDown(key);
+	heldKeys.add(key);
+};
+const keyUp = async (key) => {
+	await commands.uniKeyUp(key);
+	heldKeys.delete(key);
+};
+const keyboard = {
+	down: keyDown,
+	up: keyUp,
+	async press(key) {
+		await keyDown(key);
+		await keyUp(key);
+	},
+	tab: (options) => userEvent.tab({ shift: options?.isBackward ?? false })
+};
+const touchDown = async (target) => {
+	await commands.uniTouch("touchStart", selectorFor(target));
+	isFingerDown = true;
+};
+const touchUp = async () => {
+	await commands.uniTouch("touchEnd");
+	isFingerDown = false;
+};
+const touch = {
+	down: touchDown,
+	up: touchUp,
+	move: (target) => commands.uniTouch("touchMove", selectorFor(target)),
+	moveOutside: (target) => commands.uniTouch("touchMove", selectorFor(target), "outside"),
+	async tap(target) {
+		await touchDown(target);
+		await touchUp();
+	}
+};
+/**
+* Releases every button and key a scenario left held, and cancels a touch
+* left down, so it presses nothing in the next scenario.
+*/
+async function releaseInput() {
+	for (const button of [...heldButtons]) await up({ button });
+	for (const key of [...heldKeys]) await keyUp(key);
+	if (isFingerDown) {
+		await commands.uniTouch("touchCancel");
+		isFingerDown = false;
+	}
+}
+//#endregion
+//#region src/media.ts
+/**
+* Media emulation for browser tests, through the `uniEmulateMedia` command
+* in `../commands.ts`: forced colors (Chromium only), `prefers-contrast`,
+* reduced motion and the color scheme.
+*/
+/**
+* Emulates media features for the whole page until set again; `null` ends
+* a feature's emulation. Reset what you set after each test, since the
+* page outlives it. Resolves once the page has restyled: Firefox and WebKit
+* re-evaluate their stylesheets' media queries on the next frame, after
+* `matchMedia()` already answers.
+*/
+async function emulateMedia(features) {
+	await commands.uniEmulateMedia(features);
+	for (let frame = 0; frame < 2; frame++) await new Promise((resolve) => requestAnimationFrame(resolve));
+}
+//#endregion
+//#region src/conformance/screen-reader.ts
+/**
+* Browser side of the real screen reader (`ScreenReaderInput`): the
+* Guidepup commands in `../screen-reader-commands.ts`. The runner starts it
+* once per file and scenarios reach it through their context.
+*/
+let name;
+/** Starts the machine's screen reader and moves it into the page. */
+async function startScreenReader() {
+	name = await commands.uniScreenReaderStart();
+}
+async function stopScreenReader() {
+	name = void 0;
+	await commands.uniScreenReaderStop();
+}
+const screenReader = {
+	get name() {
+		if (!name) throw new Error("[@uniaria/testing] No screen reader runs.");
+		return name;
+	},
+	async startFrom(element) {
+		await pointer.click(element);
+		await commands.uniScreenReaderSettle();
+	},
+	press: (key) => commands.uniScreenReaderPress(key),
+	type: (text) => commands.uniScreenReaderType(text),
+	next: () => commands.uniScreenReaderNext(),
+	async readFocus() {
+		const focus = await commands.uniScreenReaderReadFocus();
+		console.info(`[${name}] ${expect.getState().currentTestName} (focus): ${JSON.stringify(focus)}`);
+		return focus;
+	},
+	async spoken() {
+		const phrases = await commands.uniScreenReaderSpoken();
+		console.info(`[${name}] ${expect.getState().currentTestName}: ${JSON.stringify(phrases)}`);
+		return phrases.join(" / ");
+	}
+};
+/** The context's screen reader where none runs. */
+const noScreenReader = new Proxy({}, { get() {
+	throw new Error("[@uniaria/testing] A real screen reader runs only in the screen-reader project, for scenarios that declare needs: ['screenReader'].");
+} });
+//#endregion
+//#region src/conformance/spoken.ts
+/**
+* Spoken output through `@guidepup/virtual-screen-reader`, the simulated
+* screen reader every pull request runs. It reads the accessibility tree the
+* browser exposes, so phrases follow the library's format:
+* `button, Save, disabled`.
+*/
+/** Upper bound on steps, so a broken tree cannot hang a test. */
+const MAX_STEPS = 500;
+/**
+* Reads `container` (the whole document by default) from start to end and
+* returns every phrase, `document` to `end of document`.
+*/
+async function spokenPhrases(container = document.body) {
+	if (listening) throw new Error("[@uniaria/testing] spoken() reads the page with the same virtual screen reader; it cannot run while listening to live regions.");
+	await virtual.start({ container });
+	try {
+		for (let step = 0; step < MAX_STEPS && await virtual.lastSpokenPhrase() !== "end of document"; step++) await virtual.next();
+		return await virtual.spokenPhraseLog();
+	} finally {
+		await virtual.stop();
+	}
+}
+/** How the virtual screen reader logs a live region: `assertive: Saved`. */
+const LIVE_PHRASE = /^(assertive|polite): /;
+let listening = false;
+/**
+* Starts the virtual screen reader on `container` (the whole document by
+* default) so it hears live regions, and returns a reader for what they have
+* announced since, in order: `assertive: Saved`, `polite: 3 results`. A
+* region only speaks when content changes inside it after listening starts,
+* as with a real screen reader. Stop with `stopListening()`.
+*/
+async function listenLive(container = document.body) {
+	if (listening) throw new Error("[@uniaria/testing] Already listening to live regions.");
+	await virtual.start({ container });
+	listening = true;
+	return async () => (await virtual.spokenPhraseLog()).filter((phrase) => LIVE_PHRASE.test(phrase));
+}
+/** Stops `listenLive()`, if it is listening. */
+async function stopListening() {
+	if (!listening) return;
+	listening = false;
+	await virtual.stop();
+}
+//#endregion
+//#region src/conformance/run.ts
+/**
+* Runs conformance suites against one adapter as Vitest browser tests. The
+* runner owns everything adapter-neutral: a fresh container per mount, part
+* lookup, the event log, real input, spoken output, cleanup after each
+* scenario, and skipping scenarios from later roadmap phases or that need
+* input the browser can't take.
+*
+* An adapter's conformance test file is one call:
+* `runConformance(reactAdapter, suites, { phase: 1 })`. Its screen-reader
+* file passes `screenReader: true` too.
+*/
+const needsScreenReader = (child) => child.kind === "group" ? child.children.some(needsScreenReader) : child.needs.includes("screenReader");
+/** Whether a run registers this child: a screen-reader run, only theirs. */
+const isInRun = (child, isScreenReaderRun) => child.kind === "group" ? child.children.some((each) => isInRun(each, isScreenReaderRun)) : needsScreenReader(child) === isScreenReaderRun;
+function partsOf(container, component, name) {
+	return Array.from(container.querySelectorAll(partSelector(component, name)));
+}
+function toNodes(template) {
+	return Array.isArray(template) ? template : [template];
+}
+function runConformance(adapter, suites, options = {}) {
+	const phase = options.phase ?? Number.POSITIVE_INFINITY;
+	const isScreenReaderRun = options.screenReader ?? false;
+	if (isScreenReaderRun) {
+		beforeAll(startScreenReader);
+		afterAll(stopScreenReader);
+	}
+	for (const suite of suites) {
+		if (!suite.children.some((child) => isInRun(child, isScreenReaderRun))) continue;
+		describe(`${suite.component} (${adapter.name})`, () => {
+			const mounted = [];
+			afterEach(async () => {
+				await releaseInput();
+				await stopListening();
+				for (const { mount, container } of mounted.splice(0)) {
+					await mount.unmount();
+					container.remove();
+				}
+				if (document.activeElement instanceof HTMLElement) document.activeElement.blur();
+				for (const region of document.querySelectorAll("[aria-live]")) region.replaceChildren();
+			});
+			const context = {
+				pointer,
+				keyboard,
+				touch,
+				screenReader: isScreenReaderRun ? screenReader : noScreenReader,
+				spoken: () => spokenPhrases(),
+				listen: () => listenLive(),
+				async mount(mountOptions) {
+					const container = document.createElement("div");
+					document.body.appendChild(container);
+					const events = [];
+					const mount = await adapter.mount({
+						component: suite.component,
+						props: mountOptions.props ?? {},
+						template: toNodes(mountOptions.template),
+						events: mountOptions.events ?? [],
+						record: (name, detail) => events.push({
+							name,
+							detail
+						}),
+						container
+					});
+					mounted.push({
+						mount,
+						container
+					});
+					return {
+						container,
+						events,
+						part(name = "root") {
+							const found = partsOf(container, suite.component, name);
+							if (found.length !== 1) throw new Error(`Expected one "${name}" part of ${suite.component}, found ${found.length}. Check the root's data-uni, an outside part's data-uni-part, or data-element inside the root.`);
+							return found[0];
+						},
+						parts: (name) => partsOf(container, suite.component, name),
+						eventNames: () => events.map((event) => event.name),
+						clearEvents: () => {
+							events.length = 0;
+						},
+						state: () => mount.state(),
+						setProps: (props) => mount.setProps(props),
+						call: (action) => mount.call(action),
+						renderCount: () => mount.renderCount()
+					};
+				}
+			};
+			const register = (children) => {
+				for (const child of children) {
+					if (!isInRun(child, isScreenReaderRun)) continue;
+					if (child.kind === "group") describe(child.name, () => register(child.children));
+					else if (child.phase > phase) it.skip(`${child.name} (phase ${child.phase})`);
+					else it(child.name, async ({ skip }) => {
+						if (child.needs.includes("touch") && !await isTouchSupported()) skip("needs touch input, which only Chromium takes");
+						await child.run(context);
+					});
+				}
+			};
+			register(suite.children);
+		});
+	}
+}
+//#endregion
+export { emulateMedia, isTouchSupported, keyboard, pointer, releaseInput, runConformance, spokenPhrases, touch };
+
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","names":[],"sources":["../src/conformance/input.ts","../src/media.ts","../src/conformance/screen-reader.ts","../src/conformance/spoken.ts","../src/conformance/run.ts"],"sourcesContent":["/**\n * Browser side of the conformance input helpers: real mouse, keyboard and\n * touch input through the Playwright commands in `../commands.ts`. Held\n * buttons, keys and fingers are tracked so the runner can release them after\n * each scenario, even one that failed mid-press.\n */\n\nimport { commands, userEvent } from 'vitest/browser';\n\nimport type {\n  KeyboardInput,\n  MouseButton,\n  PointerInput,\n  TouchInput,\n} from './scenario';\n\ndeclare module 'vitest/browser' {\n  interface BrowserCommands {\n    uniPointerDown(selector: string, button: MouseButton): Promise<void>;\n    uniPointerMove(\n      selector: string,\n      where: 'center' | 'outside',\n    ): Promise<void>;\n    uniPointerUp(button: MouseButton): Promise<void>;\n    uniWheel(deltaX: number, deltaY: number): Promise<void>;\n    uniKeyDown(key: string): Promise<void>;\n    uniKeyUp(key: string): Promise<void>;\n    uniTouchSupported(): Promise<boolean>;\n    uniTouch(\n      phase: 'touchStart' | 'touchMove' | 'touchEnd' | 'touchCancel',\n      selector?: string,\n      where?: 'center' | 'outside',\n    ): Promise<void>;\n  }\n}\n\nconst heldButtons = new Set<MouseButton>();\nconst heldKeys = new Set<string>();\nlet isFingerDown = false;\nlet touchSupport: Promise<boolean> | undefined;\n\n/** Whether this browser takes `touch` input (Chromium only). */\nexport function isTouchSupported(): Promise<boolean> {\n  return (touchSupport ??= commands.uniTouchSupported());\n}\n\n/** A selector that finds exactly this element, without touching the DOM. */\nexport function selectorFor(element: Element): string {\n  const steps: string[] = [];\n  let node: Element = element;\n  while (node.parentElement) {\n    const index = Array.prototype.indexOf.call(\n      node.parentElement.children,\n      node,\n    );\n    steps.unshift(`${node.localName}:nth-child(${index + 1})`);\n    node = node.parentElement;\n  }\n  return [node.localName, ...steps].join(' > ');\n}\n\nconst down: PointerInput['down'] = async (target, options) => {\n  const button = options?.button ?? 'left';\n  await commands.uniPointerDown(selectorFor(target), button);\n  heldButtons.add(button);\n};\n\nconst up: PointerInput['up'] = async (options) => {\n  const button = options?.button ?? 'left';\n  await commands.uniPointerUp(button);\n  heldButtons.delete(button);\n};\n\n/** How long `pointer.wheel` waits for its event to reach the page. */\nconst WHEEL_TIMEOUT = 1000;\n\n/** How long `pointer.wheel` waits for its event after a scroll. */\nconst SCROLL_GRACE = 250;\n\n/**\n * Resolves once the page gets a `wheel` event: Firefox's wheel command can\n * resolve before it. A scroll gives the event `SCROLL_GRACE` more, then\n * resolves: WebKit sends no `wheel` event while a button is held, only the\n * scroll, and a scroll can come first that isn't this wheel's (Firefox\n * scrolling one ahead of its event, or one left from an earlier step). A\n * wheel that neither reaches the page nor scrolls gives up after\n * `WHEEL_TIMEOUT`.\n *\n * It resolves in a task after the event, not in the capture listener:\n * there, the caller would go on in the microtasks after that listener,\n * before the event reached the page's own listeners.\n */\nexport function wheelArrival(): Promise<void> {\n  return new Promise((resolve) => {\n    let timer = setTimeout(done, WHEEL_TIMEOUT);\n    function done() {\n      clearTimeout(timer);\n      window.removeEventListener('wheel', done, true);\n      window.removeEventListener('scroll', scrolled, true);\n      setTimeout(resolve);\n    }\n    function scrolled() {\n      window.removeEventListener('scroll', scrolled, true);\n      clearTimeout(timer);\n      timer = setTimeout(done, SCROLL_GRACE);\n    }\n    window.addEventListener('wheel', done, true);\n    window.addEventListener('scroll', scrolled, true);\n  });\n}\n\nexport const pointer: PointerInput = {\n  down,\n  up,\n  move: (target) => commands.uniPointerMove(selectorFor(target), 'center'),\n  moveOutside: (target) =>\n    commands.uniPointerMove(selectorFor(target), 'outside'),\n  async wheel({ deltaX = 0, deltaY = 0 }) {\n    const arrival = wheelArrival();\n    await commands.uniWheel(deltaX, deltaY);\n    await arrival;\n  },\n  async click(target, options) {\n    await down(target, options);\n    await up(options);\n  },\n};\n\nconst keyDown: KeyboardInput['down'] = async (key) => {\n  await commands.uniKeyDown(key);\n  heldKeys.add(key);\n};\n\nconst keyUp: KeyboardInput['up'] = async (key) => {\n  await commands.uniKeyUp(key);\n  heldKeys.delete(key);\n};\n\nexport const keyboard: KeyboardInput = {\n  down: keyDown,\n  up: keyUp,\n  async press(key) {\n    await keyDown(key);\n    await keyUp(key);\n  },\n  tab: (options) => userEvent.tab({ shift: options?.isBackward ?? false }),\n};\n\nconst touchDown: TouchInput['down'] = async (target) => {\n  await commands.uniTouch('touchStart', selectorFor(target));\n  isFingerDown = true;\n};\n\nconst touchUp: TouchInput['up'] = async () => {\n  await commands.uniTouch('touchEnd');\n  isFingerDown = false;\n};\n\nexport const touch: TouchInput = {\n  down: touchDown,\n  up: touchUp,\n  move: (target) => commands.uniTouch('touchMove', selectorFor(target)),\n  moveOutside: (target) =>\n    commands.uniTouch('touchMove', selectorFor(target), 'outside'),\n  async tap(target) {\n    await touchDown(target);\n    await touchUp();\n  },\n};\n\n/**\n * Releases every button and key a scenario left held, and cancels a touch\n * left down, so it presses nothing in the next scenario.\n */\nexport async function releaseInput(): Promise<void> {\n  for (const button of [...heldButtons]) await up({ button });\n  for (const key of [...heldKeys]) await keyUp(key);\n  if (isFingerDown) {\n    await commands.uniTouch('touchCancel');\n    isFingerDown = false;\n  }\n}\n","/**\n * Media emulation for browser tests, through the `uniEmulateMedia` command\n * in `../commands.ts`: forced colors (Chromium only), `prefers-contrast`,\n * reduced motion and the color scheme.\n */\n\nimport { commands } from 'vitest/browser';\n\nimport type { MediaFeatures } from './commands';\n\nexport type { MediaFeatures } from './commands';\n\ndeclare module 'vitest/browser' {\n  interface BrowserCommands {\n    uniEmulateMedia(features: MediaFeatures): Promise<void>;\n  }\n}\n\n/**\n * Emulates media features for the whole page until set again; `null` ends\n * a feature's emulation. Reset what you set after each test, since the\n * page outlives it. Resolves once the page has restyled: Firefox and WebKit\n * re-evaluate their stylesheets' media queries on the next frame, after\n * `matchMedia()` already answers.\n */\nexport async function emulateMedia(features: MediaFeatures): Promise<void> {\n  await commands.uniEmulateMedia(features);\n  for (let frame = 0; frame < 2; frame++) {\n    await new Promise((resolve) => requestAnimationFrame(resolve));\n  }\n}\n","/**\n * Browser side of the real screen reader (`ScreenReaderInput`): the\n * Guidepup commands in `../screen-reader-commands.ts`. The runner starts it\n * once per file and scenarios reach it through their context.\n */\n\nimport { expect } from 'vitest';\nimport { commands } from 'vitest/browser';\n\nimport { pointer } from './input';\nimport type { ScreenReaderInput, ScreenReaderName } from './scenario';\n\ndeclare module 'vitest/browser' {\n  interface BrowserCommands {\n    uniScreenReaderStart(): Promise<ScreenReaderName>;\n    uniScreenReaderStop(): Promise<void>;\n    uniScreenReaderSettle(): Promise<void>;\n    uniScreenReaderPress(key: string): Promise<void>;\n    uniScreenReaderType(text: string): Promise<void>;\n    uniScreenReaderNext(): Promise<void>;\n    uniScreenReaderReadFocus(): Promise<string>;\n    uniScreenReaderSpoken(): Promise<string[]>;\n  }\n}\n\nlet name: ScreenReaderName | undefined;\n\n/** Starts the machine's screen reader and moves it into the page. */\nexport async function startScreenReader(): Promise<void> {\n  name = await commands.uniScreenReaderStart();\n}\n\nexport async function stopScreenReader(): Promise<void> {\n  name = undefined;\n  await commands.uniScreenReaderStop();\n}\n\nexport const screenReader: ScreenReaderInput = {\n  get name() {\n    if (!name) throw new Error('[@uniaria/testing] No screen reader runs.');\n    return name;\n  },\n  async startFrom(element) {\n    // A real click: focus from script can leave the keyboard in the\n    // browser's toolbar, where the next Tab would go.\n    await pointer.click(element);\n    await commands.uniScreenReaderSettle();\n  },\n  press: (key) => commands.uniScreenReaderPress(key),\n  type: (text) => commands.uniScreenReaderType(text),\n  next: () => commands.uniScreenReaderNext(),\n  async readFocus() {\n    const focus = await commands.uniScreenReaderReadFocus();\n    // eslint-disable-next-line no-console\n    console.info(\n      `[${name}] ${expect.getState().currentTestName} (focus): ${JSON.stringify(focus)}`,\n    );\n    return focus;\n  },\n  async spoken() {\n    const phrases = await commands.uniScreenReaderSpoken();\n    // The nightly log is the record of what each screen reader said.\n    // eslint-disable-next-line no-console\n    console.info(\n      `[${name}] ${expect.getState().currentTestName}: ${JSON.stringify(phrases)}`,\n    );\n    return phrases.join(' / ');\n  },\n};\n\n/** The context's screen reader where none runs. */\nexport const noScreenReader: ScreenReaderInput = new Proxy(\n  {} as ScreenReaderInput,\n  {\n    get() {\n      throw new Error(\n        \"[@uniaria/testing] A real screen reader runs only in the screen-reader project, for scenarios that declare needs: ['screenReader'].\",\n      );\n    },\n  },\n);\n","/**\n * Spoken output through `@guidepup/virtual-screen-reader`, the simulated\n * screen reader every pull request runs. It reads the accessibility tree the\n * browser exposes, so phrases follow the library's format:\n * `button, Save, disabled`.\n */\n\nimport { virtual } from '@guidepup/virtual-screen-reader';\n\n/** Upper bound on steps, so a broken tree cannot hang a test. */\nconst MAX_STEPS = 500;\n\n/**\n * Reads `container` (the whole document by default) from start to end and\n * returns every phrase, `document` to `end of document`.\n */\nexport async function spokenPhrases(\n  container: Element = document.body,\n): Promise<string[]> {\n  if (listening) {\n    throw new Error(\n      '[@uniaria/testing] spoken() reads the page with the same virtual screen reader; it cannot run while listening to live regions.',\n    );\n  }\n  await virtual.start({ container });\n  try {\n    for (\n      let step = 0;\n      step < MAX_STEPS &&\n      (await virtual.lastSpokenPhrase()) !== 'end of document';\n      step++\n    ) {\n      await virtual.next();\n    }\n    return await virtual.spokenPhraseLog();\n  } finally {\n    await virtual.stop();\n  }\n}\n\n/** How the virtual screen reader logs a live region: `assertive: Saved`. */\nconst LIVE_PHRASE = /^(assertive|polite): /;\n\nlet listening = false;\n\n/**\n * Starts the virtual screen reader on `container` (the whole document by\n * default) so it hears live regions, and returns a reader for what they have\n * announced since, in order: `assertive: Saved`, `polite: 3 results`. A\n * region only speaks when content changes inside it after listening starts,\n * as with a real screen reader. Stop with `stopListening()`.\n */\nexport async function listenLive(\n  container: Element = document.body,\n): Promise<() => Promise<string[]>> {\n  if (listening) {\n    throw new Error('[@uniaria/testing] Already listening to live regions.');\n  }\n  await virtual.start({ container });\n  listening = true;\n  return async () =>\n    (await virtual.spokenPhraseLog()).filter((phrase) =>\n      LIVE_PHRASE.test(phrase),\n    );\n}\n\n/** Stops `listenLive()`, if it is listening. */\nexport async function stopListening(): Promise<void> {\n  if (!listening) return;\n  listening = false;\n  await virtual.stop();\n}\n","/**\n * Runs conformance suites against one adapter as Vitest browser tests. The\n * runner owns everything adapter-neutral: a fresh container per mount, part\n * lookup, the event log, real input, spoken output, cleanup after each\n * scenario, and skipping scenarios from later roadmap phases or that need\n * input the browser can't take.\n *\n * An adapter's conformance test file is one call:\n * `runConformance(reactAdapter, suites, { phase: 1 })`. Its screen-reader\n * file passes `screenReader: true` too.\n */\n\nimport { afterAll, afterEach, beforeAll, describe, it } from 'vitest';\n\nimport type {\n  AdapterMount,\n  ConformanceAdapter,\n  MountOptions,\n  Mounted,\n  RecordedEvent,\n} from './contract';\nimport {\n  isTouchSupported,\n  keyboard,\n  pointer,\n  releaseInput,\n  touch,\n} from './input';\nimport type {\n  ConformanceSuite,\n  Scenario,\n  ScenarioContext,\n  ScenarioGroup,\n} from './scenario';\nimport {\n  noScreenReader,\n  screenReader,\n  startScreenReader,\n  stopScreenReader,\n} from './screen-reader';\nimport { listenLive, spokenPhrases, stopListening } from './spoken';\nimport type { TemplateNode } from './template';\nimport { partSelector } from './template';\n\nexport interface RunOptions {\n  /**\n   * The highest roadmap phase this adapter implements. Scenarios tagged with\n   * a later phase are skipped. Default: run everything.\n   */\n  readonly phase?: number;\n  /**\n   * Runs the scenarios that need a real screen reader\n   * (`needs: ['screenReader']`), and only those, with the machine's screen\n   * reader started for the whole file. Without it they aren't registered.\n   * Needs `screenReaderCommands` from `@uniaria/testing/commands`.\n   */\n  readonly screenReader?: boolean;\n}\n\ntype Child = Scenario<unknown, unknown> | ScenarioGroup<unknown, unknown>;\n\nconst needsScreenReader = (child: Child): boolean =>\n  child.kind === 'group'\n    ? child.children.some(needsScreenReader)\n    : child.needs.includes('screenReader');\n\n/** Whether a run registers this child: a screen-reader run, only theirs. */\nconst isInRun = (child: Child, isScreenReaderRun: boolean): boolean =>\n  child.kind === 'group'\n    ? child.children.some((each) => isInRun(each, isScreenReaderRun))\n    : needsScreenReader(child) === isScreenReaderRun;\n\nfunction partsOf(container: HTMLElement, component: string, name: string) {\n  return Array.from(\n    container.querySelectorAll<HTMLElement>(partSelector(component, name)),\n  );\n}\n\nfunction toNodes(\n  template: TemplateNode | readonly TemplateNode[],\n): readonly TemplateNode[] {\n  return Array.isArray(template) ? template : [template as TemplateNode];\n}\n\nexport function runConformance(\n  adapter: ConformanceAdapter,\n  // Suites differ in their props and state types.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  suites: readonly ConformanceSuite<any, any>[],\n  options: RunOptions = {},\n): void {\n  const phase = options.phase ?? Number.POSITIVE_INFINITY;\n  const isScreenReaderRun = options.screenReader ?? false;\n\n  if (isScreenReaderRun) {\n    // Starting takes seconds, and the screen reader is one per machine.\n    beforeAll(startScreenReader);\n    afterAll(stopScreenReader);\n  }\n\n  for (const suite of suites) {\n    if (!suite.children.some((child) => isInRun(child, isScreenReaderRun))) {\n      continue;\n    }\n    describe(`${suite.component} (${adapter.name})`, () => {\n      const mounted: { mount: AdapterMount; container: HTMLElement }[] = [];\n\n      afterEach(async () => {\n        await releaseInput();\n        await stopListening();\n        for (const { mount, container } of mounted.splice(0)) {\n          await mount.unmount();\n          container.remove();\n        }\n        if (document.activeElement instanceof HTMLElement) {\n          document.activeElement.blur();\n        }\n        // Live regions outside the containers (the announcer's) keep their\n        // messages for seconds, and the next scenario's spoken() reads the\n        // whole document.\n        for (const region of document.querySelectorAll('[aria-live]')) {\n          region.replaceChildren();\n        }\n      });\n\n      const context: ScenarioContext<unknown, unknown> = {\n        pointer,\n        keyboard,\n        touch,\n        screenReader: isScreenReaderRun ? screenReader : noScreenReader,\n        spoken: () => spokenPhrases(),\n        listen: () => listenLive(),\n        async mount(mountOptions: MountOptions<unknown>) {\n          const container = document.createElement('div');\n          document.body.appendChild(container);\n          const events: RecordedEvent[] = [];\n\n          const mount = await adapter.mount({\n            component: suite.component,\n            props: (mountOptions.props ?? {}) as Record<string, unknown>,\n            template: toNodes(mountOptions.template),\n            events: mountOptions.events ?? [],\n            record: (name, detail) => events.push({ name, detail }),\n            container,\n          });\n          mounted.push({ mount, container });\n\n          const result: Mounted<unknown, unknown> = {\n            container,\n            events,\n            part(name = 'root') {\n              const found = partsOf(container, suite.component, name);\n              if (found.length !== 1) {\n                throw new Error(\n                  `Expected one \"${name}\" part of ${suite.component}, found ${found.length}. ` +\n                    \"Check the root's data-uni, an outside part's data-uni-part, or data-element inside the root.\",\n                );\n              }\n              return found[0]!;\n            },\n            parts: (name) => partsOf(container, suite.component, name),\n            eventNames: () => events.map((event) => event.name),\n            clearEvents: () => {\n              events.length = 0;\n            },\n            state: () => mount.state(),\n            setProps: (props) =>\n              mount.setProps(props as Record<string, unknown>),\n            call: (action) => mount.call(action),\n            renderCount: () => mount.renderCount(),\n          };\n          return result;\n        },\n      };\n\n      const register = (children: readonly Child[]) => {\n        for (const child of children) {\n          if (!isInRun(child, isScreenReaderRun)) continue;\n          if (child.kind === 'group') {\n            describe(child.name, () => register(child.children));\n          } else if (child.phase > phase) {\n            it.skip(`${child.name} (phase ${child.phase})`);\n          } else {\n            it(child.name, async ({ skip }) => {\n              if (\n                child.needs.includes('touch') &&\n                !(await isTouchSupported())\n              ) {\n                skip('needs touch input, which only Chromium takes');\n              }\n              await child.run(context);\n            });\n          }\n        }\n      };\n      register(suite.children);\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/commands-DPaip6f1.d.ts

@@ -0,0 +1,61 @@
+import { BrowserCommand } from "vitest/node";
+//#region src/screen-reader-commands.d.ts
+declare const screenReaderCommands: {
+  uniScreenReaderStart: BrowserCommand<[], any>;
+  uniScreenReaderStop: BrowserCommand<[], any>;
+  uniScreenReaderSettle: BrowserCommand<[], any>;
+  uniScreenReaderPress: BrowserCommand<[key: string], any>;
+  uniScreenReaderType: BrowserCommand<[text: string], any>;
+  uniScreenReaderNext: BrowserCommand<[], any>;
+  uniScreenReaderReadFocus: BrowserCommand<[], any>;
+  uniScreenReaderSpoken: BrowserCommand<[], any>;
+};
+//#endregion
+//#region src/commands.d.ts
+type MouseButton = 'left' | 'right' | 'middle';
+declare const uniPointerDown: BrowserCommand<[selector: string, button: MouseButton]>;
+declare const uniPointerMove: BrowserCommand<[selector: string, where: 'center' | 'outside']>;
+declare const uniPointerUp: BrowserCommand<[button: MouseButton]>;
+/** Turns the wheel wherever the pointer is. */
+declare const uniWheel: BrowserCommand<[deltaX: number, deltaY: number]>;
+declare const uniKeyDown: BrowserCommand<[key: string]>;
+declare const uniKeyUp: BrowserCommand<[key: string]>;
+type TouchPhase = 'touchStart' | 'touchMove' | 'touchEnd' | 'touchCancel';
+/**
+ * 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.
+ */
+declare const uniTouchSupported: BrowserCommand<[]>;
+/**
+ * A finger at the target's centre (or 24px below it, `outside`) for
+ * `touchStart` and `touchMove`; lifted for `touchEnd` and `touchCancel`.
+ */
+declare const uniTouch: BrowserCommand<[phase: TouchPhase, selector?: string, where?: 'center' | 'outside']>;
+/** Media features Playwright emulates; `null` ends a feature's emulation. */
+interface MediaFeatures {
+  readonly forcedColors?: 'active' | 'none' | null;
+  readonly contrast?: 'more' | 'no-preference' | null;
+  readonly reducedMotion?: 'reduce' | 'no-preference' | null;
+  readonly colorScheme?: 'light' | 'dark' | 'no-preference' | null;
+}
+/**
+ * Emulates media features for the whole page, frames included. Forced
+ * colors work in Chromium only.
+ */
+declare const uniEmulateMedia: BrowserCommand<[features: MediaFeatures]>;
+declare const uniCommands: {
+  uniTouchSupported: BrowserCommand<[], any>;
+  uniTouch: BrowserCommand<[phase: TouchPhase, selector?: string | undefined, where?: "center" | "outside" | undefined], any>;
+  uniPointerDown: BrowserCommand<[selector: string, button: MouseButton], any>;
+  uniPointerMove: BrowserCommand<[selector: string, where: "center" | "outside"], any>;
+  uniPointerUp: BrowserCommand<[button: MouseButton], any>;
+  uniWheel: BrowserCommand<[deltaX: number, deltaY: number], any>;
+  uniKeyDown: BrowserCommand<[key: string], any>;
+  uniKeyUp: BrowserCommand<[key: string], any>;
+  uniEmulateMedia: BrowserCommand<[features: MediaFeatures], any>;
+};
+//#endregion
+export { uniKeyUp as a, uniPointerUp as c, uniWheel as d, screenReaderCommands as f, uniKeyDown as i, uniTouch as l, uniCommands as n, uniPointerDown as o, uniEmulateMedia as r, uniPointerMove as s, MediaFeatures as t, uniTouchSupported as u };
+//# sourceMappingURL=commands-DPaip6f1.d.ts.map

package/dist/commands.d.ts

@@ -0,0 +1,2 @@
+import { a as uniKeyUp, c as uniPointerUp, d as uniWheel, f as screenReaderCommands, i as uniKeyDown, l as uniTouch, n as uniCommands, o as uniPointerDown, r as uniEmulateMedia, s as uniPointerMove, t as MediaFeatures, u as uniTouchSupported } from "./commands-DPaip6f1.js";
+export { MediaFeatures, screenReaderCommands, uniCommands, uniEmulateMedia, uniKeyDown, uniKeyUp, uniPointerDown, uniPointerMove, uniPointerUp, uniTouch, uniTouchSupported, uniWheel };