@vielzeug/assay 2.2.0 → 26.10.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vielzeug/assay",
-  "version": "2.2.0",
-  "description": "Framework-agnostic DOM testing primitives — scoped queries, event dispatch, and async waiting",
+  "version": "26.10.0",
+  "description": "Framework-agnostic DOM testing primitives — scoped queries, event dispatch, async waiting",
   "repository": {
     "type": "git",
     "url": "https://github.com/helmuthdu/vielzeug",
@@ -30,20 +30,24 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "build": "vite build && pnpm run build:bundle && pnpm run build:types",
+    "build": "vite build && pnpm --silent run build:bundle && pnpm --silent run build:types && pnpm --silent run verify:exports",
     "build:bundle": "vite build --config vite.bundle.config.ts",
     "build:types": "tsc -p tsconfig.declarations.json",
     "fix": "biome check --write src",
     "lint": "biome ci src",
-    "prepublishOnly": "pnpm run build",
+    "prepublishOnly": "pnpm --silent run build",
     "preview": "vite preview",
-    "test": "vitest"
+    "test": "vitest",
+    "verify:exports": "node verify-exports.mjs"
+  },
+  "dependencies": {
+    "@vielzeug/arsenal": "26.10.0"
   },
   "devDependencies": {
-    "@types/node": "^26.2.0",
-    "jsdom": "^30.0.1",
+    "@types/node": "^26.6.2",
+    "jsdom": "^30.1.1",
     "typescript": "^6.0.3",
-    "vite": "^8.2.1",
-    "vitest": "^4.1.10"
+    "vite": "^8.3.0",
+    "vitest": "^5.0.1"
   }
 }

package/dist/live-region.cjs

@@ -1,2 +0,0 @@
-const e=require("./errors.cjs"),t=require("./wait.cjs");var n={alert:`assertive`,status:`polite`};function r(e){let t=e.getAttribute(`aria-live`);if(t)return t;let r=e.getAttribute(`role`);return r&&r in n?n[r]:null}function i(e={}){let t=e.document??(typeof document<`u`?document:null),n=e.politeness??`polite`,i=e.root??t?.body??null;if(!i)return null;let a=Array.from(i.querySelectorAll(`[aria-live], [role="status"], [role="alert"]`));for(let t of a)if(r(t)===n&&(e.role===void 0||t.getAttribute(`role`)===e.role))return t;return null}function a(e={}){let t=e.document??(typeof document<`u`?document:null),n=e.politeness??`polite`,i=e.root??t?.body??null;return i?Array.from(i.querySelectorAll(`[aria-live], [role="status"], [role="alert"]`)).filter(t=>!(r(t)!==n||e.role!==void 0&&t.getAttribute(`role`)!==e.role)):[]}async function o(n,r={}){let a=r.politeness??`polite`,o=null;return await t.retry(()=>{let t=i({document:r.document,politeness:a,role:r.role,root:r.root});if(!t)throw new e.AssayQueryError(`No ${a} live region found.`);if(!t.textContent?.includes(n))throw new e.AssayQueryError(`Live region text "${t.textContent}" does not include "${n}".`);o=t},{interval:r.interval,message:`waitForLiveRegion("${n}")`,signal:r.signal,timeout:r.timeout}),o}async function s(n={}){let r=n.politeness??`polite`;await t.retry(()=>{let t=i({document:n.document,politeness:r,role:n.role,root:n.root});if(!t)throw new e.AssayQueryError(`No ${r} live region found.`);if(t.textContent!==``)throw new e.AssayQueryError(`Live region not cleared: "${t.textContent}".`)},{interval:n.interval,message:`waitForLiveRegionCleared`,signal:n.signal,timeout:n.timeout})}exports.queryAllLiveRegions=a,exports.queryLiveRegion=i,exports.waitForLiveRegion=o,exports.waitForLiveRegionCleared=s;
-//# sourceMappingURL=live-region.cjs.map

package/dist/live-region.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"live-region.cjs","names":[],"sources":["../src/live-region.ts"],"sourcesContent":["import { AssayQueryError } from './errors';\nimport { retry, type WaitOptions } from './wait';\n\n/** Politeness levels for ARIA live regions. */\nexport type LiveRegionPoliteness = 'assertive' | 'off' | 'polite';\n\n/**\n * ARIA roles that carry an implicit `aria-live` value per the WAI-ARIA spec.\n * `role=\"status\"` → `polite`, `role=\"alert\"` → `assertive`. Elements with these\n * roles are live regions even without an explicit `aria-live` attribute.\n */\nconst IMPLICIT_ROLE_POLITENESS: Record<string, LiveRegionPoliteness> = {\n  alert: 'assertive',\n  status: 'polite',\n};\n\nexport interface LiveRegionQueryOptions {\n  /** The document to search. Defaults to the global `document`. */\n  document?: Document;\n  /** Politeness to match via `aria-live` (or implicit role). Defaults to `'polite'`. */\n  politeness?: LiveRegionPoliteness;\n  /** ARIA role to match (e.g. `'status'`, `'alert'`). Omit to match any role. */\n  role?: string;\n  /** Root to scope the query. Defaults to `document.body`. */\n  root?: ParentNode;\n}\n\n/**\n * Resolves the effective politeness of an element: explicit `aria-live` wins,\n * otherwise falls back to the implicit value from `role=\"status\"`/`role=\"alert\"`.\n * Returns `null` when the element is not a live region.\n */\nfunction resolvePoliteness(el: HTMLElement): LiveRegionPoliteness | null {\n  const explicit = el.getAttribute('aria-live');\n\n  if (explicit) return explicit as LiveRegionPoliteness;\n\n  const role = el.getAttribute('role');\n\n  if (role && role in IMPLICIT_ROLE_POLITENESS) return IMPLICIT_ROLE_POLITENESS[role];\n\n  return null;\n}\n\n/**\n * Queries the first live region matching the given politeness (and optional role)\n * within `root`. Returns `null` when none exists — safe to call before the region\n * has been lazily created.\n *\n * Matches both explicit `aria-live` attributes and implicit roles (`status` →\n * polite, `alert` → assertive) per the WAI-ARIA spec.\n *\n * @example\n * const region = queryLiveRegion({ politeness: 'polite' });\n * expect(region).not.toBeNull();\n */\nexport function queryLiveRegion(options: LiveRegionQueryOptions = {}): HTMLElement | null {\n  const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n  const politeness = options.politeness ?? 'polite';\n  const root = options.root ?? doc?.body ?? null;\n\n  if (!root) return null;\n\n  const candidates = Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]'));\n\n  for (const el of candidates) {\n    if (resolvePoliteness(el) !== politeness) continue;\n\n    if (options.role !== undefined && el.getAttribute('role') !== options.role) continue;\n\n    return el;\n  }\n\n  return null;\n}\n\n/**\n * Queries all live regions matching the given politeness (and optional role)\n * within `root`. Useful for asserting no duplicate regions were created.\n *\n * @example\n * expect(queryAllLiveRegions({ politeness: 'polite' })).toHaveLength(1);\n */\nexport function queryAllLiveRegions(options: LiveRegionQueryOptions = {}): HTMLElement[] {\n  const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n  const politeness = options.politeness ?? 'polite';\n  const root = options.root ?? doc?.body ?? null;\n\n  if (!root) return [];\n\n  return Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]')).filter((el) => {\n    if (resolvePoliteness(el) !== politeness) return false;\n\n    if (options.role !== undefined && el.getAttribute('role') !== options.role) return false;\n\n    return true;\n  });\n}\n\nexport interface WaitForLiveRegionOptions extends WaitOptions {\n  /** The document to search. Defaults to the global `document`. */\n  document?: Document;\n  /** Politeness to match via `aria-live`. Defaults to `'polite'`. */\n  politeness?: LiveRegionPoliteness;\n  /** ARIA role to match. Omit to match any role. */\n  role?: string;\n  /** Root to scope the query. Defaults to `document.body`. */\n  root?: ParentNode;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and contains\n * `text` (substring match). Throws `AssayTimeoutError` on timeout.\n *\n * Handles the clear-then-set announce pattern: the region may briefly be empty\n * before the message is written, so polling until the text appears is the\n * correct approach rather than a single snapshot assertion.\n *\n * @example\n * await waitForLiveRegion({ text: '3 results found' });\n * await waitForLiveRegion({ politeness: 'assertive', text: 'Session expired' });\n */\nexport async function waitForLiveRegion(text: string, options: WaitForLiveRegionOptions = {}): Promise<HTMLElement> {\n  const politeness = options.politeness ?? 'polite';\n  let matched: HTMLElement | null = null;\n\n  await retry(\n    () => {\n      const region = queryLiveRegion({\n        document: options.document,\n        politeness,\n        role: options.role,\n        root: options.root,\n      });\n\n      if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n      if (!region.textContent?.includes(text)) {\n        throw new AssayQueryError(`Live region text \"${region.textContent}\" does not include \"${text}\".`);\n      }\n\n      matched = region;\n    },\n    {\n      interval: options.interval,\n      message: `waitForLiveRegion(\"${text}\")`,\n      signal: options.signal,\n      timeout: options.timeout,\n    },\n  );\n\n  // `retry` only resolves once the assertion stops throwing, so `matched` is set.\n  return matched!;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and is empty\n * (cleared). Throws `AssayTimeoutError` on timeout.\n *\n * @example\n * await waitForLiveRegionCleared();\n */\nexport async function waitForLiveRegionCleared(options: WaitForLiveRegionOptions = {}): Promise<void> {\n  const politeness = options.politeness ?? 'polite';\n\n  await retry(\n    () => {\n      const region = queryLiveRegion({\n        document: options.document,\n        politeness,\n        role: options.role,\n        root: options.root,\n      });\n\n      if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n      if (region.textContent !== '') {\n        throw new AssayQueryError(`Live region not cleared: \"${region.textContent}\".`);\n      }\n    },\n    {\n      interval: options.interval,\n      message: 'waitForLiveRegionCleared',\n      signal: options.signal,\n      timeout: options.timeout,\n    },\n  );\n}\n"],"mappings":"wDAWA,IAAM,EAAiE,CACrE,MAAO,YACP,OAAQ,QACV,EAkBA,SAAS,EAAkB,EAA8C,CACvE,IAAM,EAAW,EAAG,aAAa,WAAW,EAE5C,GAAI,EAAU,OAAO,EAErB,IAAM,EAAO,EAAG,aAAa,MAAM,EAInC,OAFI,GAAQ,KAAQ,EAAiC,EAAyB,GAEvE,IACT,CAcA,SAAgB,EAAgB,EAAkC,CAAC,EAAuB,CACxF,IAAM,EAAM,EAAQ,WAAa,OAAO,SAAa,IAAc,SAAW,MACxE,EAAa,EAAQ,YAAc,SACnC,EAAO,EAAQ,MAAQ,GAAK,MAAQ,KAE1C,GAAI,CAAC,EAAM,OAAO,KAElB,IAAM,EAAa,MAAM,KAAK,EAAK,iBAA8B,8CAA8C,CAAC,EAEhH,IAAK,IAAM,KAAM,EACX,KAAkB,CAAE,IAAM,IAE1B,EAAQ,OAAS,IAAA,IAAa,EAAG,aAAa,MAAM,IAAM,EAAQ,MAEtE,OAAO,EAGT,OAAO,IACT,CASA,SAAgB,EAAoB,EAAkC,CAAC,EAAkB,CACvF,IAAM,EAAM,EAAQ,WAAa,OAAO,SAAa,IAAc,SAAW,MACxE,EAAa,EAAQ,YAAc,SACnC,EAAO,EAAQ,MAAQ,GAAK,MAAQ,KAI1C,OAFK,EAEE,MAAM,KAAK,EAAK,iBAA8B,8CAA8C,CAAC,CAAC,CAAC,OAAQ,GAG5G,EAFI,EAAkB,CAAE,IAAM,GAE1B,EAAQ,OAAS,IAAA,IAAa,EAAG,aAAa,MAAM,IAAM,EAAQ,KAGvE,EARiB,CAAC,CASrB,CAyBA,eAAsB,EAAkB,EAAc,EAAoC,CAAC,EAAyB,CAClH,IAAM,EAAa,EAAQ,YAAc,SACrC,EAA8B,KA4BlC,OA1BA,MAAM,EAAA,UACE,CACJ,IAAM,EAAS,EAAgB,CAC7B,SAAU,EAAQ,SAClB,aACA,KAAM,EAAQ,KACd,KAAM,EAAQ,IAChB,CAAC,EAED,GAAI,CAAC,EAAQ,MAAM,IAAI,EAAA,gBAAgB,MAAM,EAAW,oBAAoB,EAE5E,GAAI,CAAC,EAAO,aAAa,SAAS,CAAI,EACpC,MAAM,IAAI,EAAA,gBAAgB,qBAAqB,EAAO,YAAY,sBAAsB,EAAK,GAAG,EAGlG,EAAU,CACZ,EACA,CACE,SAAU,EAAQ,SAClB,QAAS,sBAAsB,EAAK,IACpC,OAAQ,EAAQ,OAChB,QAAS,EAAQ,OACnB,CACF,EAGO,CACT,CASA,eAAsB,EAAyB,EAAoC,CAAC,EAAkB,CACpG,IAAM,EAAa,EAAQ,YAAc,SAEzC,MAAM,EAAA,UACE,CACJ,IAAM,EAAS,EAAgB,CAC7B,SAAU,EAAQ,SAClB,aACA,KAAM,EAAQ,KACd,KAAM,EAAQ,IAChB,CAAC,EAED,GAAI,CAAC,EAAQ,MAAM,IAAI,EAAA,gBAAgB,MAAM,EAAW,oBAAoB,EAE5E,GAAI,EAAO,cAAgB,GACzB,MAAM,IAAI,EAAA,gBAAgB,6BAA6B,EAAO,YAAY,GAAG,CAEjF,EACA,CACE,SAAU,EAAQ,SAClB,QAAS,2BACT,OAAQ,EAAQ,OAChB,QAAS,EAAQ,OACnB,CACF,CACF"}

package/dist/live-region.d.ts

@@ -1,66 +0,0 @@
-import { type WaitOptions } from './wait';
-/** Politeness levels for ARIA live regions. */
-export type LiveRegionPoliteness = 'assertive' | 'off' | 'polite';
-export interface LiveRegionQueryOptions {
-    /** The document to search. Defaults to the global `document`. */
-    document?: Document;
-    /** Politeness to match via `aria-live` (or implicit role). Defaults to `'polite'`. */
-    politeness?: LiveRegionPoliteness;
-    /** ARIA role to match (e.g. `'status'`, `'alert'`). Omit to match any role. */
-    role?: string;
-    /** Root to scope the query. Defaults to `document.body`. */
-    root?: ParentNode;
-}
-/**
- * Queries the first live region matching the given politeness (and optional role)
- * within `root`. Returns `null` when none exists — safe to call before the region
- * has been lazily created.
- *
- * Matches both explicit `aria-live` attributes and implicit roles (`status` →
- * polite, `alert` → assertive) per the WAI-ARIA spec.
- *
- * @example
- * const region = queryLiveRegion({ politeness: 'polite' });
- * expect(region).not.toBeNull();
- */
-export declare function queryLiveRegion(options?: LiveRegionQueryOptions): HTMLElement | null;
-/**
- * Queries all live regions matching the given politeness (and optional role)
- * within `root`. Useful for asserting no duplicate regions were created.
- *
- * @example
- * expect(queryAllLiveRegions({ politeness: 'polite' })).toHaveLength(1);
- */
-export declare function queryAllLiveRegions(options?: LiveRegionQueryOptions): HTMLElement[];
-export interface WaitForLiveRegionOptions extends WaitOptions {
-    /** The document to search. Defaults to the global `document`. */
-    document?: Document;
-    /** Politeness to match via `aria-live`. Defaults to `'polite'`. */
-    politeness?: LiveRegionPoliteness;
-    /** ARIA role to match. Omit to match any role. */
-    role?: string;
-    /** Root to scope the query. Defaults to `document.body`. */
-    root?: ParentNode;
-}
-/**
- * Retries until a live region matching the politeness/role exists and contains
- * `text` (substring match). Throws `AssayTimeoutError` on timeout.
- *
- * Handles the clear-then-set announce pattern: the region may briefly be empty
- * before the message is written, so polling until the text appears is the
- * correct approach rather than a single snapshot assertion.
- *
- * @example
- * await waitForLiveRegion({ text: '3 results found' });
- * await waitForLiveRegion({ politeness: 'assertive', text: 'Session expired' });
- */
-export declare function waitForLiveRegion(text: string, options?: WaitForLiveRegionOptions): Promise<HTMLElement>;
-/**
- * Retries until a live region matching the politeness/role exists and is empty
- * (cleared). Throws `AssayTimeoutError` on timeout.
- *
- * @example
- * await waitForLiveRegionCleared();
- */
-export declare function waitForLiveRegionCleared(options?: WaitForLiveRegionOptions): Promise<void>;
-//# sourceMappingURL=live-region.d.ts.map

package/dist/live-region.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"live-region.d.ts","sourceRoot":"","sources":["../src/live-region.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEjD,+CAA+C;AAC/C,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,KAAK,GAAG,QAAQ,CAAC;AAYlE,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,sFAAsF;IACtF,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,WAAW,GAAG,IAAI,CAkBxF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,sBAA2B,GAAG,WAAW,EAAE,CAcvF;AAED,MAAM,WAAW,wBAAyB,SAAQ,WAAW;IAC3D,iEAAiE;IACjE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,mEAAmE;IACnE,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,WAAW,CAAC,CA+BlH;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBpG"}

package/dist/live-region.js

@@ -1,65 +0,0 @@
-import { AssayQueryError as e } from "./errors.js";
-import { retry as t } from "./wait.js";
-//#region src/live-region.ts
-var n = {
-	alert: "assertive",
-	status: "polite"
-};
-function r(e) {
-	let t = e.getAttribute("aria-live");
-	if (t) return t;
-	let r = e.getAttribute("role");
-	return r && r in n ? n[r] : null;
-}
-function i(e = {}) {
-	let t = e.document ?? (typeof document < "u" ? document : null), n = e.politeness ?? "polite", i = e.root ?? t?.body ?? null;
-	if (!i) return null;
-	let a = Array.from(i.querySelectorAll("[aria-live], [role=\"status\"], [role=\"alert\"]"));
-	for (let t of a) if (r(t) === n && (e.role === void 0 || t.getAttribute("role") === e.role)) return t;
-	return null;
-}
-function a(e = {}) {
-	let t = e.document ?? (typeof document < "u" ? document : null), n = e.politeness ?? "polite", i = e.root ?? t?.body ?? null;
-	return i ? Array.from(i.querySelectorAll("[aria-live], [role=\"status\"], [role=\"alert\"]")).filter((t) => !(r(t) !== n || e.role !== void 0 && t.getAttribute("role") !== e.role)) : [];
-}
-async function o(n, r = {}) {
-	let a = r.politeness ?? "polite", o = null;
-	return await t(() => {
-		let t = i({
-			document: r.document,
-			politeness: a,
-			role: r.role,
-			root: r.root
-		});
-		if (!t) throw new e(`No ${a} live region found.`);
-		if (!t.textContent?.includes(n)) throw new e(`Live region text "${t.textContent}" does not include "${n}".`);
-		o = t;
-	}, {
-		interval: r.interval,
-		message: `waitForLiveRegion("${n}")`,
-		signal: r.signal,
-		timeout: r.timeout
-	}), o;
-}
-async function s(n = {}) {
-	let r = n.politeness ?? "polite";
-	await t(() => {
-		let t = i({
-			document: n.document,
-			politeness: r,
-			role: n.role,
-			root: n.root
-		});
-		if (!t) throw new e(`No ${r} live region found.`);
-		if (t.textContent !== "") throw new e(`Live region not cleared: "${t.textContent}".`);
-	}, {
-		interval: n.interval,
-		message: "waitForLiveRegionCleared",
-		signal: n.signal,
-		timeout: n.timeout
-	});
-}
-//#endregion
-export { a as queryAllLiveRegions, i as queryLiveRegion, o as waitForLiveRegion, s as waitForLiveRegionCleared };
-
-//# sourceMappingURL=live-region.js.map

package/dist/live-region.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"live-region.js","names":[],"sources":["../src/live-region.ts"],"sourcesContent":["import { AssayQueryError } from './errors';\nimport { retry, type WaitOptions } from './wait';\n\n/** Politeness levels for ARIA live regions. */\nexport type LiveRegionPoliteness = 'assertive' | 'off' | 'polite';\n\n/**\n * ARIA roles that carry an implicit `aria-live` value per the WAI-ARIA spec.\n * `role=\"status\"` → `polite`, `role=\"alert\"` → `assertive`. Elements with these\n * roles are live regions even without an explicit `aria-live` attribute.\n */\nconst IMPLICIT_ROLE_POLITENESS: Record<string, LiveRegionPoliteness> = {\n  alert: 'assertive',\n  status: 'polite',\n};\n\nexport interface LiveRegionQueryOptions {\n  /** The document to search. Defaults to the global `document`. */\n  document?: Document;\n  /** Politeness to match via `aria-live` (or implicit role). Defaults to `'polite'`. */\n  politeness?: LiveRegionPoliteness;\n  /** ARIA role to match (e.g. `'status'`, `'alert'`). Omit to match any role. */\n  role?: string;\n  /** Root to scope the query. Defaults to `document.body`. */\n  root?: ParentNode;\n}\n\n/**\n * Resolves the effective politeness of an element: explicit `aria-live` wins,\n * otherwise falls back to the implicit value from `role=\"status\"`/`role=\"alert\"`.\n * Returns `null` when the element is not a live region.\n */\nfunction resolvePoliteness(el: HTMLElement): LiveRegionPoliteness | null {\n  const explicit = el.getAttribute('aria-live');\n\n  if (explicit) return explicit as LiveRegionPoliteness;\n\n  const role = el.getAttribute('role');\n\n  if (role && role in IMPLICIT_ROLE_POLITENESS) return IMPLICIT_ROLE_POLITENESS[role];\n\n  return null;\n}\n\n/**\n * Queries the first live region matching the given politeness (and optional role)\n * within `root`. Returns `null` when none exists — safe to call before the region\n * has been lazily created.\n *\n * Matches both explicit `aria-live` attributes and implicit roles (`status` →\n * polite, `alert` → assertive) per the WAI-ARIA spec.\n *\n * @example\n * const region = queryLiveRegion({ politeness: 'polite' });\n * expect(region).not.toBeNull();\n */\nexport function queryLiveRegion(options: LiveRegionQueryOptions = {}): HTMLElement | null {\n  const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n  const politeness = options.politeness ?? 'polite';\n  const root = options.root ?? doc?.body ?? null;\n\n  if (!root) return null;\n\n  const candidates = Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]'));\n\n  for (const el of candidates) {\n    if (resolvePoliteness(el) !== politeness) continue;\n\n    if (options.role !== undefined && el.getAttribute('role') !== options.role) continue;\n\n    return el;\n  }\n\n  return null;\n}\n\n/**\n * Queries all live regions matching the given politeness (and optional role)\n * within `root`. Useful for asserting no duplicate regions were created.\n *\n * @example\n * expect(queryAllLiveRegions({ politeness: 'polite' })).toHaveLength(1);\n */\nexport function queryAllLiveRegions(options: LiveRegionQueryOptions = {}): HTMLElement[] {\n  const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n  const politeness = options.politeness ?? 'polite';\n  const root = options.root ?? doc?.body ?? null;\n\n  if (!root) return [];\n\n  return Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]')).filter((el) => {\n    if (resolvePoliteness(el) !== politeness) return false;\n\n    if (options.role !== undefined && el.getAttribute('role') !== options.role) return false;\n\n    return true;\n  });\n}\n\nexport interface WaitForLiveRegionOptions extends WaitOptions {\n  /** The document to search. Defaults to the global `document`. */\n  document?: Document;\n  /** Politeness to match via `aria-live`. Defaults to `'polite'`. */\n  politeness?: LiveRegionPoliteness;\n  /** ARIA role to match. Omit to match any role. */\n  role?: string;\n  /** Root to scope the query. Defaults to `document.body`. */\n  root?: ParentNode;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and contains\n * `text` (substring match). Throws `AssayTimeoutError` on timeout.\n *\n * Handles the clear-then-set announce pattern: the region may briefly be empty\n * before the message is written, so polling until the text appears is the\n * correct approach rather than a single snapshot assertion.\n *\n * @example\n * await waitForLiveRegion({ text: '3 results found' });\n * await waitForLiveRegion({ politeness: 'assertive', text: 'Session expired' });\n */\nexport async function waitForLiveRegion(text: string, options: WaitForLiveRegionOptions = {}): Promise<HTMLElement> {\n  const politeness = options.politeness ?? 'polite';\n  let matched: HTMLElement | null = null;\n\n  await retry(\n    () => {\n      const region = queryLiveRegion({\n        document: options.document,\n        politeness,\n        role: options.role,\n        root: options.root,\n      });\n\n      if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n      if (!region.textContent?.includes(text)) {\n        throw new AssayQueryError(`Live region text \"${region.textContent}\" does not include \"${text}\".`);\n      }\n\n      matched = region;\n    },\n    {\n      interval: options.interval,\n      message: `waitForLiveRegion(\"${text}\")`,\n      signal: options.signal,\n      timeout: options.timeout,\n    },\n  );\n\n  // `retry` only resolves once the assertion stops throwing, so `matched` is set.\n  return matched!;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and is empty\n * (cleared). Throws `AssayTimeoutError` on timeout.\n *\n * @example\n * await waitForLiveRegionCleared();\n */\nexport async function waitForLiveRegionCleared(options: WaitForLiveRegionOptions = {}): Promise<void> {\n  const politeness = options.politeness ?? 'polite';\n\n  await retry(\n    () => {\n      const region = queryLiveRegion({\n        document: options.document,\n        politeness,\n        role: options.role,\n        root: options.root,\n      });\n\n      if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n      if (region.textContent !== '') {\n        throw new AssayQueryError(`Live region not cleared: \"${region.textContent}\".`);\n      }\n    },\n    {\n      interval: options.interval,\n      message: 'waitForLiveRegionCleared',\n      signal: options.signal,\n      timeout: options.timeout,\n    },\n  );\n}\n"],"mappings":";;;AAWA,IAAM,IAAiE;CACrE,OAAO;CACP,QAAQ;AACV;AAkBA,SAAS,EAAkB,GAA8C;CACvE,IAAM,IAAW,EAAG,aAAa,WAAW;CAE5C,IAAI,GAAU,OAAO;CAErB,IAAM,IAAO,EAAG,aAAa,MAAM;CAInC,OAFI,KAAQ,KAAQ,IAAiC,EAAyB,KAEvE;AACT;AAcA,SAAgB,EAAgB,IAAkC,CAAC,GAAuB;CACxF,IAAM,IAAM,EAAQ,aAAa,OAAO,WAAa,MAAc,WAAW,OACxE,IAAa,EAAQ,cAAc,UACnC,IAAO,EAAQ,QAAQ,GAAK,QAAQ;CAE1C,IAAI,CAAC,GAAM,OAAO;CAElB,IAAM,IAAa,MAAM,KAAK,EAAK,iBAA8B,kDAA8C,CAAC;CAEhH,KAAK,IAAM,KAAM,GACX,MAAkB,CAAE,MAAM,MAE1B,EAAQ,SAAS,KAAA,KAAa,EAAG,aAAa,MAAM,MAAM,EAAQ,OAEtE,OAAO;CAGT,OAAO;AACT;AASA,SAAgB,EAAoB,IAAkC,CAAC,GAAkB;CACvF,IAAM,IAAM,EAAQ,aAAa,OAAO,WAAa,MAAc,WAAW,OACxE,IAAa,EAAQ,cAAc,UACnC,IAAO,EAAQ,QAAQ,GAAK,QAAQ;CAI1C,OAFK,IAEE,MAAM,KAAK,EAAK,iBAA8B,kDAA8C,CAAC,CAAC,CAAC,QAAQ,MAG5G,EAFI,EAAkB,CAAE,MAAM,KAE1B,EAAQ,SAAS,KAAA,KAAa,EAAG,aAAa,MAAM,MAAM,EAAQ,KAGvE,IARiB,CAAC;AASrB;AAyBA,eAAsB,EAAkB,GAAc,IAAoC,CAAC,GAAyB;CAClH,IAAM,IAAa,EAAQ,cAAc,UACrC,IAA8B;CA4BlC,OA1BA,MAAM,QACE;EACJ,IAAM,IAAS,EAAgB;GAC7B,UAAU,EAAQ;GAClB;GACA,MAAM,EAAQ;GACd,MAAM,EAAQ;EAChB,CAAC;EAED,IAAI,CAAC,GAAQ,MAAM,IAAI,EAAgB,MAAM,EAAW,oBAAoB;EAE5E,IAAI,CAAC,EAAO,aAAa,SAAS,CAAI,GACpC,MAAM,IAAI,EAAgB,qBAAqB,EAAO,YAAY,sBAAsB,EAAK,GAAG;EAGlG,IAAU;CACZ,GACA;EACE,UAAU,EAAQ;EAClB,SAAS,sBAAsB,EAAK;EACpC,QAAQ,EAAQ;EAChB,SAAS,EAAQ;CACnB,CACF,GAGO;AACT;AASA,eAAsB,EAAyB,IAAoC,CAAC,GAAkB;CACpG,IAAM,IAAa,EAAQ,cAAc;CAEzC,MAAM,QACE;EACJ,IAAM,IAAS,EAAgB;GAC7B,UAAU,EAAQ;GAClB;GACA,MAAM,EAAQ;GACd,MAAM,EAAQ;EAChB,CAAC;EAED,IAAI,CAAC,GAAQ,MAAM,IAAI,EAAgB,MAAM,EAAW,oBAAoB;EAE5E,IAAI,EAAO,gBAAgB,IACzB,MAAM,IAAI,EAAgB,6BAA6B,EAAO,YAAY,GAAG;CAEjF,GACA;EACE,UAAU,EAAQ;EAClB,SAAS;EACT,QAAQ,EAAQ;EAChB,SAAS,EAAQ;CACnB,CACF;AACF"}