@unotest/web 0.49.0 → 0.49.1

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-CTMGjJIs.js';
+import { E as ElementHint } from '../interfaces-D5ePwBX6.js';
 import '../config/schema.js';
 import 'zod';
 
@@ -434,6 +434,21 @@ declare function readComputedStyle(el: Element, property: string): string;
  *  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;
+/** What `getImageSize` reads off an element: its tag, whether the image
+ *  has settled (`complete`: loaded, failed, or nothing to load), its
+ *  natural size, and whether it is lazy — a lazy image outside the
+ *  viewport never starts loading, which is the usual reason it never
+ *  settles. */
+interface ImageState {
+    tag: string;
+    complete: boolean;
+    width: number;
+    height: number;
+    lazy: boolean;
+}
+declare function readImageState(el: Element): ImageState;
+/** Whether an `<img>` has settled — the predicate `getImageSize` waits on. */
+declare function isImageComplete(el: Element): boolean;
 /** 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;
@@ -449,4 +464,4 @@ declare function inspectElementRaw(el: Element, args: {
     };
 }): ElementHintRaw;
 
-export { type ElementHintRaw, ariaSnapshotAlgorithm, countRunningAnimations, findElementAlgorithm, inspectElementRaw, outlineAlgorithm, pasteValue, pickerOverlayAlgorithm, readCheckedState, readComputedStyle, readDisabledState, readLocalStorageItem, semanticDomAlgorithm, serializeRuntimeDom, writeLocalStorageItem };
+export { type ElementHintRaw, type ImageState, ariaSnapshotAlgorithm, countRunningAnimations, findElementAlgorithm, inspectElementRaw, isImageComplete, outlineAlgorithm, pasteValue, pickerOverlayAlgorithm, readCheckedState, readComputedStyle, readDisabledState, readImageState, readLocalStorageItem, semanticDomAlgorithm, serializeRuntimeDom, writeLocalStorageItem };

package/dist/inspection/page-inject.js

@@ -2801,6 +2801,25 @@ function countRunningAnimations(el) {
   return el.getAnimations({ subtree: true }).filter((a) => a.playState === "running" && a.effect?.getComputedTiming().iterations !== Infinity).length;
 }
 __name(countRunningAnimations, "countRunningAnimations");
+function readImageState(el) {
+  globalThis.__name ??= (fn) => fn;
+  const tag = el.tagName.toLowerCase();
+  if (tag !== "img") return { tag, complete: true, width: 0, height: 0, lazy: false };
+  const img = el;
+  return {
+    tag,
+    complete: img.complete,
+    width: img.naturalWidth,
+    height: img.naturalHeight,
+    lazy: img.loading === "lazy"
+  };
+}
+__name(readImageState, "readImageState");
+function isImageComplete(el) {
+  globalThis.__name ??= (fn) => fn;
+  return el.complete;
+}
+__name(isImageComplete, "isImageComplete");
 function writeLocalStorageItem([key, value]) {
   globalThis.__name ??= (fn) => fn;
   localStorage.setItem(key, value);
@@ -3013,12 +3032,14 @@ export {
   countRunningAnimations,
   findElementAlgorithm,
   inspectElementRaw,
+  isImageComplete,
   outlineAlgorithm,
   pasteValue,
   pickerOverlayAlgorithm,
   readCheckedState,
   readComputedStyle,
   readDisabledState,
+  readImageState,
   readLocalStorageItem,
   semanticDomAlgorithm,
   serializeRuntimeDom,

package/dist/{interfaces-CTMGjJIs.d.ts → interfaces-D5ePwBX6.d.ts}

@@ -654,6 +654,13 @@ interface DriverPage {
      *  `getComputedStyle(el).getPropertyValue(property)` gives it — custom
      *  properties (`--accent`) included; "" for one that is not set. */
     computedStyle(loc: LocatorValue, property: string): Promise<string>;
+    /** Natural size of the matched `<img>` once it has settled (loaded or
+     *  failed), within the action timeout; `null` when it has no pixels —
+     *  broken, or no src. The one query that waits: "still loading" is not
+     *  an answer, and reading too early would report a good image as broken.
+     *  A `LocatorError` for an element that is not an `<img>`, a
+     *  `TimeoutError` for one that never settles. */
+    imageSize(loc: LocatorValue): Promise<ImageSize | null>;
     /** 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. */
@@ -729,6 +736,11 @@ interface BoundingBox {
     width: number;
     height: number;
 }
+/** An image's natural size, in its own pixels. */
+interface ImageSize {
+    width: number;
+    height: number;
+}
 /** How `inspectElement` reads the element's `readable` text. By default
  *  whitespace folded and clipped to 200 — a hint. `whole` keeps the text as
  *  it is, up to `limit` characters, for a refusal that quotes it (#256). */
@@ -857,4 +869,4 @@ interface PageConsole {
     errors: readonly PageErrorEntry[];
 }
 
-export { type AttachOptions as A, type BoundingBox as B, type CaptureFrame as C, type DriverContext as D, type ElementHint as E, type FillOptions as F, type GotoOptions as G, type HoverOptions as H, type LocatorValue as L, type NetworkEntry as N, type PageConsole as P, type ReloadOptions as R, type ScreenshotOptions as S, type Viewport as V, type WebDriver as W, type CaptureRect as a, type LaunchOptions as b, type ContextOptions as c, type ActionTimeout as d, type CheckOptions as e, type ClickOptions as f, type CookieOptions as g, type DriverPage as h, type NavigationOptions as i, type PressOptions as j, type SelectOptions as k, type ViewportSize as l, type WaitOptions as m, type WaitState as n, type DriverDownload as o, type LocatorStep as p, appendStep as q, describeLocator as r, isLocatorValue as s, rootedAt as t };
+export { type AttachOptions as A, type BoundingBox as B, type CaptureFrame as C, type DriverContext as D, type ElementHint as E, type FillOptions as F, type GotoOptions as G, type HoverOptions as H, type ImageSize as I, type LocatorValue as L, type NetworkEntry as N, type PageConsole as P, type ReloadOptions as R, type ScreenshotOptions as S, type Viewport as V, type WebDriver as W, type CaptureRect as a, type LaunchOptions as b, type ContextOptions as c, type ActionTimeout as d, type CheckOptions as e, type ClickOptions as f, type CookieOptions as g, type DriverPage as h, type NavigationOptions as i, type PressOptions as j, type SelectOptions as k, type ViewportSize as l, type WaitOptions as m, type WaitState as n, type DriverDownload as o, type LocatorStep as p, appendStep as q, describeLocator as r, isLocatorValue as s, rootedAt as t };