@vielzeug/assay 3.0.0 → 26.10.0

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 { eventually, 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 * `alert` is assertive; `log` and `status` are polite; `marquee` and `timer` are\n * off. Elements with these roles are live regions without explicit `aria-live`.\n */\nconst IMPLICIT_ROLE_POLITENESS: Record<string, LiveRegionPoliteness> = {\n  alert: 'assertive',\n  log: 'polite',\n  marquee: 'off',\n  status: 'polite',\n  timer: 'off',\n};\nconst LIVE_REGION_SELECTOR =\n  '[aria-live], [role=\"alert\"], [role=\"log\"], [role=\"marquee\"], [role=\"status\"], [role=\"timer\"]';\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\nfunction candidates(root: ParentNode): HTMLElement[] {\n  const descendants = Array.from(root.querySelectorAll<HTMLElement>(LIVE_REGION_SELECTOR));\n  const rootElement = root as ParentNode & { matches?: (selector: string) => boolean };\n\n  return rootElement.matches?.(LIVE_REGION_SELECTOR) ? [root as HTMLElement, ...descendants] : descendants;\n}\n\nfunction matchesOptions(element: HTMLElement, politeness: LiveRegionPoliteness, role?: string): boolean {\n  return resolvePoliteness(element) === politeness && (role === undefined || element.getAttribute('role') === role);\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 explicit `aria-live` attributes and implicit live-region roles.\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  return candidates(root).find((element) => matchesOptions(element, politeness, options.role)) ?? 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 candidates(root).filter((element) => matchesOptions(element, politeness, options.role));\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('3 results found');\n * await waitForLiveRegion('Session expired', { politeness: 'assertive' });\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 eventually(\n    () => {\n      const regions = queryAllLiveRegions({\n        document: options.document,\n        politeness,\n        role: options.role,\n        root: options.root,\n      });\n      const region = regions.find((candidate) => candidate.textContent?.includes(text));\n\n      if (region) {\n        matched = region;\n        return;\n      }\n\n      if (regions.length === 0) throw new AssayQueryError(`No ${politeness} live region found.`);\n      throw new AssayQueryError(`No ${politeness} live region includes \"${text}\".`);\n    },\n    {\n      interval: options.interval,\n      message: `waitForLiveRegion(\"${text}\")`,\n      signal: options.signal,\n      timeout: options.timeout,\n    },\n  );\n\n  // `eventually` 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 eventually(\n    () => {\n      const regions = queryAllLiveRegions({\n        document: options.document,\n        politeness,\n        role: options.role,\n        root: options.root,\n      });\n\n      if (regions.some((region) => region.textContent === '')) return;\n      if (regions.length === 0) throw new AssayQueryError(`No ${politeness} live region found.`);\n      throw new AssayQueryError(`No ${politeness} live region is cleared.`);\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,IAAK,SACL,QAAS,MACT,OAAQ,SACR,MAAO,KACT,EACM,EACJ,+FAkBF,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,CAEA,SAAS,EAAW,EAAiC,CACnD,IAAM,EAAc,MAAM,KAAK,EAAK,iBAA8B,CAAoB,CAAC,EAGvF,OAAO,EAAY,UAAU,CAAoB,EAAI,CAAC,EAAqB,GAAG,CAAW,EAAI,CAC/F,CAEA,SAAS,EAAe,EAAsB,EAAkC,EAAwB,CACtG,OAAO,EAAkB,CAAO,IAAM,IAAe,IAAS,IAAA,IAAa,EAAQ,aAAa,MAAM,IAAM,EAC9G,CAaA,SAAgB,EAAgB,EAAkC,CAAC,EAAuB,CACxF,IAAM,EAAM,EAAQ,WAAa,OAAO,SAAa,IAAc,SAAW,MACxE,EAAa,EAAQ,YAAc,SACnC,EAAO,EAAQ,MAAQ,GAAK,MAAQ,KAI1C,OAFK,EAEE,EAAW,CAAI,CAAC,CAAC,KAAM,GAAY,EAAe,EAAS,EAAY,EAAQ,IAAI,CAAC,GAAK,KAF9E,IAGpB,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,EAAW,CAAI,CAAC,CAAC,OAAQ,GAAY,EAAe,EAAS,EAAY,EAAQ,IAAI,CAAC,EAF3E,CAAC,CAGrB,CAyBA,eAAsB,EAAkB,EAAc,EAAoC,CAAC,EAAyB,CAClH,IAAM,EAAa,EAAQ,YAAc,SACrC,EAA8B,KA6BlC,OA3BA,MAAM,EAAA,eACE,CACJ,IAAM,EAAU,EAAoB,CAClC,SAAU,EAAQ,SAClB,aACA,KAAM,EAAQ,KACd,KAAM,EAAQ,IAChB,CAAC,EACK,EAAS,EAAQ,KAAM,GAAc,EAAU,aAAa,SAAS,CAAI,CAAC,EAEhF,GAAI,EAAQ,CACV,EAAU,EACV,MACF,CAGA,MADI,EAAQ,SAAW,EAAS,IAAI,EAAA,gBAAgB,MAAM,EAAW,oBAAoB,EACnF,IAAI,EAAA,gBAAgB,MAAM,EAAW,yBAAyB,EAAK,GAAG,CAC9E,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,eACE,CACJ,IAAM,EAAU,EAAoB,CAClC,SAAU,EAAQ,SAClB,aACA,KAAM,EAAQ,KACd,KAAM,EAAQ,IAChB,CAAC,EAEG,MAAQ,KAAM,GAAW,EAAO,cAAgB,EAAE,EAEtD,MADI,EAAQ,SAAW,EAAS,IAAI,EAAA,gBAAgB,MAAM,EAAW,oBAAoB,EACnF,IAAI,EAAA,gBAAgB,MAAM,EAAW,yBAAyB,CACtE,EACA,CACE,SAAU,EAAQ,SAClB,QAAS,2BACT,OAAQ,EAAQ,OAChB,QAAS,EAAQ,OACnB,CACF,CACF"}

package/dist/live-region.d.ts

@@ -1,65 +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 explicit `aria-live` attributes and implicit live-region roles.
- *
- * @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('3 results found');
- * await waitForLiveRegion('Session expired', { politeness: 'assertive' });
- */
-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,EAAc,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEtD,+CAA+C;AAC/C,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,KAAK,GAAG,QAAQ,CAAC;AAiBlE,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;AA8BD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,WAAW,GAAG,IAAI,CAQxF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,sBAA2B,GAAG,WAAW,EAAE,CAQvF;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,CAgClH;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBpG"}

package/dist/live-region.js

@@ -1,73 +0,0 @@
-import { AssayQueryError as e } from "./errors.js";
-import { eventually as t } from "./wait.js";
-//#region src/live-region.ts
-var n = {
-	alert: "assertive",
-	log: "polite",
-	marquee: "off",
-	status: "polite",
-	timer: "off"
-}, r = "[aria-live], [role=\"alert\"], [role=\"log\"], [role=\"marquee\"], [role=\"status\"], [role=\"timer\"]";
-function i(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 a(e) {
-	let t = Array.from(e.querySelectorAll(r));
-	return e.matches?.(r) ? [e, ...t] : t;
-}
-function o(e, t, n) {
-	return i(e) === t && (n === void 0 || e.getAttribute("role") === n);
-}
-function s(e = {}) {
-	let t = e.document ?? (typeof document < "u" ? document : null), n = e.politeness ?? "polite", r = e.root ?? t?.body ?? null;
-	return r ? a(r).find((t) => o(t, n, e.role)) ?? null : null;
-}
-function c(e = {}) {
-	let t = e.document ?? (typeof document < "u" ? document : null), n = e.politeness ?? "polite", r = e.root ?? t?.body ?? null;
-	return r ? a(r).filter((t) => o(t, n, e.role)) : [];
-}
-async function l(n, r = {}) {
-	let i = r.politeness ?? "polite", a = null;
-	return await t(() => {
-		let t = c({
-			document: r.document,
-			politeness: i,
-			role: r.role,
-			root: r.root
-		}), o = t.find((e) => e.textContent?.includes(n));
-		if (o) {
-			a = o;
-			return;
-		}
-		throw t.length === 0 ? new e(`No ${i} live region found.`) : new e(`No ${i} live region includes "${n}".`);
-	}, {
-		interval: r.interval,
-		message: `waitForLiveRegion("${n}")`,
-		signal: r.signal,
-		timeout: r.timeout
-	}), a;
-}
-async function u(n = {}) {
-	let r = n.politeness ?? "polite";
-	await t(() => {
-		let t = c({
-			document: n.document,
-			politeness: r,
-			role: n.role,
-			root: n.root
-		});
-		if (!t.some((e) => e.textContent === "")) throw t.length === 0 ? new e(`No ${r} live region found.`) : new e(`No ${r} live region is cleared.`);
-	}, {
-		interval: n.interval,
-		message: "waitForLiveRegionCleared",
-		signal: n.signal,
-		timeout: n.timeout
-	});
-}
-//#endregion
-export { c as queryAllLiveRegions, s as queryLiveRegion, l as waitForLiveRegion, u 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 { eventually, 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 * `alert` is assertive; `log` and `status` are polite; `marquee` and `timer` are\n * off. Elements with these roles are live regions without explicit `aria-live`.\n */\nconst IMPLICIT_ROLE_POLITENESS: Record<string, LiveRegionPoliteness> = {\n  alert: 'assertive',\n  log: 'polite',\n  marquee: 'off',\n  status: 'polite',\n  timer: 'off',\n};\nconst LIVE_REGION_SELECTOR =\n  '[aria-live], [role=\"alert\"], [role=\"log\"], [role=\"marquee\"], [role=\"status\"], [role=\"timer\"]';\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\nfunction candidates(root: ParentNode): HTMLElement[] {\n  const descendants = Array.from(root.querySelectorAll<HTMLElement>(LIVE_REGION_SELECTOR));\n  const rootElement = root as ParentNode & { matches?: (selector: string) => boolean };\n\n  return rootElement.matches?.(LIVE_REGION_SELECTOR) ? [root as HTMLElement, ...descendants] : descendants;\n}\n\nfunction matchesOptions(element: HTMLElement, politeness: LiveRegionPoliteness, role?: string): boolean {\n  return resolvePoliteness(element) === politeness && (role === undefined || element.getAttribute('role') === role);\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 explicit `aria-live` attributes and implicit live-region roles.\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  return candidates(root).find((element) => matchesOptions(element, politeness, options.role)) ?? 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 candidates(root).filter((element) => matchesOptions(element, politeness, options.role));\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('3 results found');\n * await waitForLiveRegion('Session expired', { politeness: 'assertive' });\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 eventually(\n    () => {\n      const regions = queryAllLiveRegions({\n        document: options.document,\n        politeness,\n        role: options.role,\n        root: options.root,\n      });\n      const region = regions.find((candidate) => candidate.textContent?.includes(text));\n\n      if (region) {\n        matched = region;\n        return;\n      }\n\n      if (regions.length === 0) throw new AssayQueryError(`No ${politeness} live region found.`);\n      throw new AssayQueryError(`No ${politeness} live region includes \"${text}\".`);\n    },\n    {\n      interval: options.interval,\n      message: `waitForLiveRegion(\"${text}\")`,\n      signal: options.signal,\n      timeout: options.timeout,\n    },\n  );\n\n  // `eventually` 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 eventually(\n    () => {\n      const regions = queryAllLiveRegions({\n        document: options.document,\n        politeness,\n        role: options.role,\n        root: options.root,\n      });\n\n      if (regions.some((region) => region.textContent === '')) return;\n      if (regions.length === 0) throw new AssayQueryError(`No ${politeness} live region found.`);\n      throw new AssayQueryError(`No ${politeness} live region is cleared.`);\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,KAAK;CACL,SAAS;CACT,QAAQ;CACR,OAAO;AACT,GACM,IACJ;AAkBF,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;AAEA,SAAS,EAAW,GAAiC;CACnD,IAAM,IAAc,MAAM,KAAK,EAAK,iBAA8B,CAAoB,CAAC;CAGvF,OAAO,EAAY,UAAU,CAAoB,IAAI,CAAC,GAAqB,GAAG,CAAW,IAAI;AAC/F;AAEA,SAAS,EAAe,GAAsB,GAAkC,GAAwB;CACtG,OAAO,EAAkB,CAAO,MAAM,MAAe,MAAS,KAAA,KAAa,EAAQ,aAAa,MAAM,MAAM;AAC9G;AAaA,SAAgB,EAAgB,IAAkC,CAAC,GAAuB;CACxF,IAAM,IAAM,EAAQ,aAAa,OAAO,WAAa,MAAc,WAAW,OACxE,IAAa,EAAQ,cAAc,UACnC,IAAO,EAAQ,QAAQ,GAAK,QAAQ;CAI1C,OAFK,IAEE,EAAW,CAAI,CAAC,CAAC,MAAM,MAAY,EAAe,GAAS,GAAY,EAAQ,IAAI,CAAC,KAAK,OAF9E;AAGpB;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,EAAW,CAAI,CAAC,CAAC,QAAQ,MAAY,EAAe,GAAS,GAAY,EAAQ,IAAI,CAAC,IAF3E,CAAC;AAGrB;AAyBA,eAAsB,EAAkB,GAAc,IAAoC,CAAC,GAAyB;CAClH,IAAM,IAAa,EAAQ,cAAc,UACrC,IAA8B;CA6BlC,OA3BA,MAAM,QACE;EACJ,IAAM,IAAU,EAAoB;GAClC,UAAU,EAAQ;GAClB;GACA,MAAM,EAAQ;GACd,MAAM,EAAQ;EAChB,CAAC,GACK,IAAS,EAAQ,MAAM,MAAc,EAAU,aAAa,SAAS,CAAI,CAAC;EAEhF,IAAI,GAAQ;GACV,IAAU;GACV;EACF;EAGA,MADI,EAAQ,WAAW,IAAS,IAAI,EAAgB,MAAM,EAAW,oBAAoB,IACnF,IAAI,EAAgB,MAAM,EAAW,yBAAyB,EAAK,GAAG;CAC9E,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,IAAU,EAAoB;GAClC,UAAU,EAAQ;GAClB;GACA,MAAM,EAAQ;GACd,MAAM,EAAQ;EAChB,CAAC;EAEG,OAAQ,MAAM,MAAW,EAAO,gBAAgB,EAAE,GAEtD,MADI,EAAQ,WAAW,IAAS,IAAI,EAAgB,MAAM,EAAW,oBAAoB,IACnF,IAAI,EAAgB,MAAM,EAAW,yBAAyB;CACtE,GACA;EACE,UAAU,EAAQ;EAClB,SAAS;EACT,QAAQ,EAAQ;EAChB,SAAS,EAAQ;CACnB,CACF;AACF"}