@unotest/web 0.9.1 → 0.11.0

package/dist/{interfaces-dbZG10RS.d.ts → interfaces-MxHi1Air.d.ts}

@@ -45,11 +45,17 @@ type LocatorStep = {
 } | {
     kind: 'nth';
     index: number;
+} | {
+    kind: 'randomNth';
 } | {
     kind: 'contentFrame';
 } | {
     kind: 'ref';
     ref: string;
+} | {
+    kind: 'intent';
+    intent: string;
+    ordinal?: 'first' | 'last' | number;
 };
 interface LocatorValue {
     readonly kind: 'locator';
@@ -163,6 +169,18 @@ type WaitState = "attached" | "detached" | "visible" | "hidden";
 interface WaitOptions extends ActionTimeout {
     state?: WaitState;
 }
+interface WaitForTextOptions extends WaitOptions {
+    /** @deprecated No-op: "first visible occurrence" is the default now.
+     *  Chat feeds and repeated labels made the old whole-list strict-mode
+     *  wait a footgun — ≥1 visible match is what "the text is on screen"
+     *  means. Kept so recorded scenarios with {first: true} stay valid. */
+    first?: boolean;
+    /** Match the full text exactly (Playwright getByText semantics).
+     *  Default: substring, which also matches INSIDE a word ("hi" hits
+     *  "anything") — pass a regex with \b anchors via the DSL for
+     *  word-boundary matching. */
+    exact?: boolean;
+}
 interface NavigationOptions extends ActionTimeout {
     /**
      * When to consider navigation done. Default: 'load'.
@@ -328,20 +346,39 @@ interface DriverPage {
     scrollIntoView(loc: LocatorValue): Promise<void>;
     /** Drag the source element onto the target. */
     dragAndDrop(from: LocatorValue, to: LocatorValue, opts?: ClickOptions): Promise<void>;
-    /** Set the input element's selected files. Accepts one or many paths. */
-    uploadFile(loc: LocatorValue, files: string | ReadonlyArray<string>): Promise<void>;
+    /** Set the input element's selected files. Accepts a path, path[], or an in-memory file buffer. */
+    uploadFile(loc: LocatorValue, files: string | ReadonlyArray<string> | {
+        name: string;
+        mimeType: string;
+        buffer: Buffer;
+    }): Promise<void>;
     /** Focus the locator then dispatch a paste-like input with `text`. */
     clipboardPaste(loc: LocatorValue, text: string): Promise<void>;
     count(loc: LocatorValue): Promise<number>;
     textContent(loc: LocatorValue): Promise<string | null>;
     inputValue(loc: LocatorValue): Promise<string>;
+    /** Checked state of a checkbox / radio / switch, `null` when the element
+     *  is none of those. Separate from `inputValue` on purpose: a checkbox's
+     *  `value` is the submitted payload ("on" by default), never its state. */
+    checkedState(loc: LocatorValue): Promise<boolean | null>;
     isVisible(loc: LocatorValue): Promise<boolean>;
     /** Read a DOM attribute on the matched element. Returns null if absent. */
     getAttribute(loc: LocatorValue, name: string): Promise<string | null>;
     waitFor(loc: LocatorValue, opts?: WaitOptions): Promise<void>;
     waitForUrl(pattern: string | RegExp, opts?: NavigationOptions): Promise<void>;
-    waitForText(text: string, opts?: WaitOptions): 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. */
+    waitForText(text: Matcher, opts?: WaitForTextOptions): Promise<void>;
     waitForNavigation(opts?: NavigationOptions): Promise<void>;
+    /** Wait for a page-level lifecycle state on the CURRENT document (no
+     *  navigation required). Diagnostics-only — it backs the pre-capture
+     *  settle for screenshots, never a DSL action: a test that waits on
+     *  "the network went quiet" instead of on visible app state is exactly
+     *  the flaky pattern the linter rejects. */
+    waitForLoadState(state: "load" | "domcontentloaded" | "networkidle", opts?: {
+        timeout?: number;
+    }): Promise<void>;
     goto(url: string, opts?: GotoOptions): Promise<void>;
     reload(opts?: ReloadOptions): Promise<void>;
     goBack(opts?: NavigationOptions): Promise<void>;
@@ -392,6 +429,16 @@ interface ElementHint {
     /** textContent (trimmed, clipped). Last-resort semantic fallback
      *  before the CSS escape hatch. */
     text?: string;
+    /** Descendant text of a STRUCTURAL container (record row / card /
+     *  tree-item / `<li>` / `<tr>`) that carries no accessible name of its
+     *  own — its identifying text lives in children, so it has no `name`/
+     *  `text` signal. Captured ONLY when short enough to name a single
+     *  record (not a whole table/section). The resolver turns it into
+     *  `getByRole(role).filter({hasText})` — the sole semantic handle on
+     *  containers materialised from unit-grounded asserts (assert_visible on
+     *  a record). Kept separate from `text` so ARIA name semantics (a
+     *  container takes its name only from aria-label/labelledby) hold. */
+    containerText?: string;
     /** href attribute for `<a>` elements lacking any of the above.
      *  Resolver emits `locator('a[href="..."]')`. */
     href?: string;