@unotest/web 0.46.0 → 0.47.0

package/dist/inspection/page-inject.d.ts

@@ -1,6 +1,6 @@
 import { InjectedDomHelpers } from '@unotest/grounder-client/dom-walker';
 import { PickerMode } from '@unotest/protocol';
-import { E as ElementHint } from '../interfaces-CYoL4Taq.js';
+import { E as ElementHint } from '../interfaces-LE6GsJ0c.js';
 import '../config/schema.js';
 import 'zod';
 
@@ -426,6 +426,14 @@ declare function readCheckedState(el: Element): boolean | null;
 /** Disabled state — native `:disabled` (covers `<fieldset disabled>`
  *  inheritance) or `aria-disabled` on a custom widget. */
 declare function readDisabledState(el: Element): boolean;
+/** Computed value of one CSS property — custom properties included, which
+ *  `getPropertyValue` returns with the whitespace after their colon. */
+declare function readComputedStyle(el: Element, property: string): string;
+/** How many animations of the element and its descendants are still
+ *  playing towards an end. An infinite one (a spinner) never ends, so it
+ *  is not counted — waiting for it could only time out; neither is a
+ *  paused one, which ends only when the page resumes it. */
+declare function countRunningAnimations(el: Element): number;
 /** Write a localStorage item. Key and value travel as one array because
  *  Playwright's `evaluate(fn, arg)` passes a SINGLE argument. */
 declare function writeLocalStorageItem([key, value]: [string, string]): void;
@@ -441,4 +449,4 @@ declare function inspectElementRaw(el: Element, args: {
     };
 }): ElementHintRaw;
 
-export { type ElementHintRaw, ariaSnapshotAlgorithm, findElementAlgorithm, inspectElementRaw, outlineAlgorithm, pasteValue, pickerOverlayAlgorithm, readCheckedState, readDisabledState, readLocalStorageItem, semanticDomAlgorithm, serializeRuntimeDom, writeLocalStorageItem };
+export { type ElementHintRaw, ariaSnapshotAlgorithm, countRunningAnimations, findElementAlgorithm, inspectElementRaw, outlineAlgorithm, pasteValue, pickerOverlayAlgorithm, readCheckedState, readComputedStyle, readDisabledState, readLocalStorageItem, semanticDomAlgorithm, serializeRuntimeDom, writeLocalStorageItem };

package/dist/inspection/page-inject.js

@@ -2791,6 +2791,16 @@ function readDisabledState(el) {
   return el.matches(":disabled") || el.getAttribute("aria-disabled") === "true";
 }
 __name(readDisabledState, "readDisabledState");
+function readComputedStyle(el, property) {
+  globalThis.__name ??= (fn) => fn;
+  return getComputedStyle(el).getPropertyValue(property).trim();
+}
+__name(readComputedStyle, "readComputedStyle");
+function countRunningAnimations(el) {
+  globalThis.__name ??= (fn) => fn;
+  return el.getAnimations({ subtree: true }).filter((a) => a.playState === "running" && a.effect?.getComputedTiming().iterations !== Infinity).length;
+}
+__name(countRunningAnimations, "countRunningAnimations");
 function writeLocalStorageItem([key, value]) {
   globalThis.__name ??= (fn) => fn;
   localStorage.setItem(key, value);
@@ -3000,12 +3010,14 @@ function inspectElementRaw(el, args) {
 __name(inspectElementRaw, "inspectElementRaw");
 export {
   ariaSnapshotAlgorithm,
+  countRunningAnimations,
   findElementAlgorithm,
   inspectElementRaw,
   outlineAlgorithm,
   pasteValue,
   pickerOverlayAlgorithm,
   readCheckedState,
+  readComputedStyle,
   readDisabledState,
   readLocalStorageItem,
   semanticDomAlgorithm,

package/dist/{interfaces-CYoL4Taq.d.ts → interfaces-LE6GsJ0c.d.ts}

@@ -374,6 +374,11 @@ interface DownloadNameFilter {
 }
 /** A fake clock shared by every page of a context. Time runs by itself
  *  until `freeze`, and again after `run`. */
+/** Media features a page can be made to report — Playwright's values. */
+interface EmulatedMedia {
+    reducedMotion?: "reduce" | "no-preference";
+    colorScheme?: "light" | "dark" | "no-preference";
+}
 interface DriverClock {
     /** Stop time at `at`: `Date` reads it, and no timer fires until `tick`
      *  or `run`. Any instant, past or future — no timer fires on the way. */
@@ -637,11 +642,27 @@ interface DriverPage {
     isDisabled(loc: LocatorValue): Promise<boolean>;
     /** Read a DOM attribute on the matched element. Returns null if absent. */
     getAttribute(loc: LocatorValue, name: string): Promise<string | null>;
+    /** The matched element's computed value of a CSS property, as
+     *  `getComputedStyle(el).getPropertyValue(property)` gives it — custom
+     *  properties (`--accent`) included; "" for one that is not set. */
+    computedStyle(loc: LocatorValue, property: string): Promise<string>;
     /** Wait for a DOM-presence state (`attached`/`detached`/`visible`/
      *  `hidden`) or an interaction state (`enabled`/`disabled`). The latter
      *  is polled against `isDisabled`, so `aria-disabled` widgets count. */
     waitFor(loc: LocatorValue, opts?: WaitForOptions): Promise<void>;
-    waitForUrl(pattern: string | RegExp, opts?: NavigationOptions): Promise<void>;
+    /** How many finite animations of the matched element and its
+     *  descendants are still running. Infinite ones (spinners) and paused
+     *  ones are not counted: neither is going to end by itself. */
+    runningAnimations(loc: LocatorValue): Promise<number>;
+    /** Wait until `runningAnimations(loc)` is 0. Times out with a
+     *  `TimeoutError` naming the locator and how many were left. */
+    waitForAnimations(loc: LocatorValue, timeoutMs: number): Promise<void>;
+    /** A string matches as a substring of the URL, a regex unanchored. */
+    waitForUrl(pattern: Matcher, opts?: NavigationOptions): Promise<void>;
+    /** Change the media features this page reports, from now on: what
+     *  `matchMedia` and CSS `@media` see. A feature left out keeps its
+     *  current value. This page only — a tab opened later starts without it. */
+    emulateMedia(media: EmulatedMedia): Promise<void>;
     /** Wait until ≥1 VISIBLE occurrence of `text` matches (or none, with
      *  `state: 'hidden' | 'detached'`). Accepts a regex matcher in the
      *  JSON-safe `Matcher` shape. */