@harnessed-ts/resolve 0.0.0-stage → 0.7.0

package/dist/inject.js

@@ -0,0 +1,3 @@
+export { PAGE_API_GLOBAL, encodeSelector, filesOnDisk, injectPath, injectSource } from './chunk-BYG4HMLR.js';
+//# sourceMappingURL=inject.js.map
+//# sourceMappingURL=inject.js.map

package/dist/inject.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"inject.js"}

package/dist/page-api.d.ts

@@ -0,0 +1,57 @@
+import type { BoundingBox, FileTarget, Selector } from '@harnessed-ts/core';
+import type { Point } from './box';
+import { PAGE_API_GLOBAL } from './global-name';
+import type { WireSelector } from './wire';
+export { PAGE_API_GLOBAL };
+/**
+ * Settings a remote driver passes on every call. The page has no access to the
+ * test process's `configure()`, so the runtime config travels with the call
+ * rather than being pushed once.
+ */
+/** A selector as handed over the wire, or as-is when caller and page share a realm. */
+type Wire = Selector | WireSelector;
+export interface PageApiOptions {
+    testIdAttribute: string;
+    timeout: number;
+}
+/**
+ * The resolver as seen from inside a page a driver does not share a realm with
+ * — WebdriverIO, Puppeteer, TestCafe. Every argument is serialisable except
+ * `root`, which is an element handle the driver passes back in (or `null` for
+ * the document body).
+ *
+ * The same functions back the dom driver, so role, label, strictness, index
+ * and frame semantics cannot differ between a driver resolving in-process and
+ * one resolving through this.
+ */
+export interface PageApi {
+    /** How many nodes match. The scope waits; the count does not. */
+    count(root: Element | null, scope: Wire[], selector: Wire, options: PageApiOptions): Promise<number>;
+    /** The single node a strict operation acts on, waiting for it. */
+    one(root: Element | null, scope: Wire[], selector: Wire, options: PageApiOptions): Promise<Element>;
+    /** Every match, after waiting for the scope. `nth` is ignored, as for any list. */
+    all(root: Element | null, scope: Wire[], selector: Wire, options: PageApiOptions): Promise<Element[]>;
+    /** The single node now, or `null`. For runtimes that do their own retrying. */
+    oneNow(root: Element | null, scope: Wire[], selector: Wire, options: PageApiOptions): Element | null;
+    /** Every match now. */
+    allNow(root: Element | null, scope: Wire[], selector: Wire, options: PageApiOptions): Element[];
+    /**
+     * Whether an element is visible by layout, within its own document only. A
+     * driver that enters frames from outside the page asks about each iframe it
+     * crossed in that iframe's own document, which also covers a cross-origin
+     * frame no in-page walk could cross.
+     */
+    visible(element: Element): boolean;
+    /**
+     * The element's box in its own document's viewport, or `null` when it draws
+     * none. A driver that enters frames from outside adds each crossed frame's
+     * `origin` itself.
+     */
+    box(element: Element): BoundingBox | null;
+    /** Where an iframe's document is drawn, in the iframe's own document. */
+    origin(iframe: Element): Point;
+    /** What an upload would set: the file input's `multiple`, or what the element is instead. */
+    fileTarget(element: Element): FileTarget;
+}
+export declare function createPageApi(document: Document): PageApi;
+//# sourceMappingURL=page-api.d.ts.map

package/dist/page-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-api.d.ts","sourceRoot":"","sources":["../src/page-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAI/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAE1C,OAAO,EAAE,eAAe,EAAE,CAAA;AAE1B;;;;GAIG;AACH,uFAAuF;AACvF,KAAK,IAAI,GAAG,QAAQ,GAAG,YAAY,CAAA;AAEnC,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,OAAO;IACtB,iEAAiE;IACjE,KAAK,CACH,IAAI,EAAE,OAAO,GAAG,IAAI,EACpB,KAAK,EAAE,IAAI,EAAE,EACb,QAAQ,EAAE,IAAI,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAAA;IAClB,kEAAkE;IAClE,GAAG,CACD,IAAI,EAAE,OAAO,GAAG,IAAI,EACpB,KAAK,EAAE,IAAI,EAAE,EACb,QAAQ,EAAE,IAAI,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CAAA;IACnB,mFAAmF;IACnF,GAAG,CACD,IAAI,EAAE,OAAO,GAAG,IAAI,EACpB,KAAK,EAAE,IAAI,EAAE,EACb,QAAQ,EAAE,IAAI,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IACrB,+EAA+E;IAC/E,MAAM,CACJ,IAAI,EAAE,OAAO,GAAG,IAAI,EACpB,KAAK,EAAE,IAAI,EAAE,EACb,QAAQ,EAAE,IAAI,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,GAAG,IAAI,CAAA;IACjB,uBAAuB;IACvB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,EAAE,CAAA;IAC/F;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAA;IAClC;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAAA;IACzC,yEAAyE;IACzE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAAA;IAC9B,6FAA6F;IAC7F,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAA;CACzC;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAgDzD"}

package/dist/resolve.d.ts

@@ -0,0 +1,38 @@
+import type { Selector } from '@harnessed-ts/core';
+/** Every match for one selector, without waiting. Zero is an answer. */
+export declare function queryAll(root: HTMLElement, selector: Selector): HTMLElement[];
+/**
+ * Walks the scope chain down to the element the final selector is queried within.
+ * Waiting is correct here: a container that has not rendered yet is not the same
+ * thing as a target that is absent.
+ */
+export declare function resolveScope(container: HTMLElement, scope: readonly Selector[], timeout?: number): Promise<HTMLElement>;
+/** A frame link that cannot be entered — a wiring mistake, never "not rendered yet". */
+export declare class FrameEntryError extends Error {
+    name: string;
+}
+/** The single node a strict operation acts on. */
+export declare function resolveOne(container: HTMLElement, scope: readonly Selector[], selector: Selector, timeout?: number): Promise<HTMLElement>;
+/**
+ * How many nodes match. The scope chain still waits, but the final count uses the
+ * non-waiting query so that zero answers immediately rather than throwing after a
+ * retry timeout. This is the behaviour Playwright already had.
+ */
+export declare function countAll(container: HTMLElement, scope: readonly Selector[], selector: Selector, timeout?: number): Promise<number>;
+/** The scope chain's innermost element now, or `null` if a link is not on screen. */
+export declare function resolveScopeNow(container: HTMLElement, scope: readonly Selector[]): HTMLElement | null;
+/** The single node a strict operation acts on now, or `null` if it is not on screen. */
+export declare function resolveOneNow(container: HTMLElement, scope: readonly Selector[], selector: Selector): HTMLElement | null;
+/**
+ * Every match now, agreeing with `countAll` on every scope it cannot resolve:
+ * an absent or ambiguous scope is an empty list, and only a frame that cannot
+ * be entered throws.
+ */
+export declare function resolveAllNow(container: HTMLElement, scope: readonly Selector[], selector: Selector): HTMLElement[];
+/**
+ * Every match for a list operation: the scope waits, the list does not, and
+ * `nth` is ignored — each result is addressed by its own index afterwards. The
+ * one definition of "the list" for in-process and injected drivers alike.
+ */
+export declare function resolveAll(container: HTMLElement, scope: readonly Selector[], selector: Selector, timeout?: number): Promise<HTMLElement[]>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AA8BlD,wEAAwE;AACxE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,WAAW,EAAE,CAmB7E;AAwED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAUtB;AAED,wFAAwF;AACxF,qBAAa,eAAgB,SAAQ,KAAK;IAC/B,IAAI,SAAoB;CAClC;AA6BD,kDAAkD;AAClD,wBAAsB,UAAU,CAC9B,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAItB;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAYjB;AAUD,qFAAqF;AACrF,wBAAgB,eAAe,CAC7B,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,SAAS,QAAQ,EAAE,GACzB,WAAW,GAAG,IAAI,CAUpB;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,QAAQ,EAAE,QAAQ,GACjB,WAAW,GAAG,IAAI,CAMpB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,QAAQ,EAAE,QAAQ,GACjB,WAAW,EAAE,CAaf;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,EAAE,CAAC,CAExB"}

package/dist/visible.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Whether an element is visible by layout — Playwright's definition, for drivers
+ * that run in a real browser beside the page (Vitest browser mode, Ember, Cypress).
+ * jsdom computes no layout, so the dom driver cannot use this and reads computed
+ * style instead.
+ *
+ * Visible means a non-empty box that `visibility` does not hide. `display: none`
+ * anywhere above gives an empty box, so it needs no check of its own. Opacity
+ * does not count: a transparent box is still there to click, and Playwright
+ * reports it visible.
+ *
+ * Inside a frame, the iframe has to be visible too — a hidden frame hides its
+ * content. The walk crosses frames up to `home` (by default, every reachable
+ * one), so a driver passes its own document to stop at the frames its scope
+ * actually entered.
+ */
+export declare function isVisibleInLayout(element: Element, home?: Document): boolean;
+//# sourceMappingURL=visible.d.ts.map

package/dist/visible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visible.d.ts","sourceRoot":"","sources":["../src/visible.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAO5E"}

package/dist/webdriver-page-script.d.ts

@@ -0,0 +1,48 @@
+import type { PageApiOptions } from './page-api';
+import type { WireSelector } from './wire';
+/**
+ * What the in-page script does with the target it resolves. Reads happen in the
+ * page, in the same round-trip as the resolution: a WebDriver command costs a
+ * few milliseconds each way, and a read that first fetched an element reference
+ * and then asked about it would pay that twice.
+ */
+export type PageOp = 'frame' | 'frameNow' | 'element' | 'probe' | 'visible' | 'count' | 'texts' | 'text' | 'value' | 'attribute' | 'enabled' | 'checked' | 'selected' | 'select' | 'clear' | 'focus' | 'blur' | 'box' | 'upload';
+/**
+ * The script's answer. A page error comes back as a value rather than a thrown
+ * script error, so its name and message arrive intact — a thrown one reaches the
+ * test wrapped in protocol noise, and under WebDriver Classic is logged as a
+ * driver failure as well.
+ */
+export type PageReply = {
+    kind: 'missing';
+} | {
+    kind: 'ok';
+    value: unknown;
+    url: string;
+} | {
+    kind: 'error';
+    name: string;
+    message: string;
+};
+/** Raised in the page by the shared resolver: strictness, index and frame rules. */
+export declare class PageError extends Error {
+    constructor(name: string, message: string);
+}
+/** The shared resolver's refusal of a frame it cannot enter. Never "not there yet". */
+export declare function isFrameEntryError(error: unknown): boolean;
+/**
+ * An element as WebDriver returns it from a script, before the driver's client
+ * wraps it (WebdriverIO's `$()`; selenium-webdriver hands back a `WebElement`
+ * already).
+ */
+export type ElementRef = {
+    'element-6066-11e4-a52e-4f735466cecf': string;
+};
+/**
+ * Runs IN THE PAGE, serialised with `Function.prototype.toString`, so it must
+ * close over nothing: every input arrives as an argument. Elements are
+ * only ever returned as object properties, each at most once — WebDriver BiDi
+ * serialises an element repeated in a result, or one inside an array, as `{}`.
+ */
+export declare function pageScript(name: string, op: PageOp, scope: WireSelector[], selector: WireSelector, options: PageApiOptions, arg: string | null): Promise<PageReply>;
+//# sourceMappingURL=webdriver-page-script.d.ts.map

package/dist/webdriver-page-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webdriver-page-script.d.ts","sourceRoot":"","sources":["../src/webdriver-page-script.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,cAAc,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GACd,OAAO,GACP,UAAU,GACV,SAAS,GACT,OAAO,GACP,SAAS,GACT,OAAO,GACP,OAAO,GACP,MAAM,GACN,OAAO,GACP,WAAW,GACX,SAAS,GACT,SAAS,GACT,UAAU,GACV,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM,GACN,KAAK,GACL,QAAQ,CAAA;AAEZ;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpD,oFAAoF;AACpF,qBAAa,SAAU,SAAQ,KAAK;gBACtB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI1C;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,qCAAqC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1E;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,YAAY,EAAE,EACrB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,OAAO,CAAC,SAAS,CAAC,CAyJpB"}

package/dist/webdriver.cjs

@@ -0,0 +1,272 @@
+'use strict';
+
+var core = require('@harnessed-ts/core');
+var fs = require('fs');
+require('os');
+var path = require('path');
+var url = require('url');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+// src/webdriver.ts
+
+// src/global-name.ts
+var PAGE_API_GLOBAL = "__harnessedResolve";
+
+// src/wire.ts
+function isRegExp(value) {
+  return Object.prototype.toString.call(value) === "[object RegExp]";
+}
+function encodeValue(value) {
+  if (isRegExp(value)) return { $regexp: value.source, flags: value.flags };
+  if (Array.isArray(value)) return value.map(encodeValue);
+  if (typeof value === "object" && value !== null) {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, inner]) => [key, encodeValue(inner)])
+    );
+  }
+  return value;
+}
+function encodeSelector(selector) {
+  return encodeValue(selector);
+}
+
+// src/inject.ts
+function injectPath() {
+  if (typeof __filename === "string") return path.join(path.dirname(__filename), "inject.global.js");
+  return url.fileURLToPath(new URL("./inject.global.js", (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('webdriver.cjs', document.baseURI).href))));
+}
+var cached;
+function injectSource() {
+  if (cached === void 0) cached = fs.readFileSync(injectPath(), "utf8");
+  return cached;
+}
+
+// src/webdriver-page-script.ts
+var PageError = class extends Error {
+  constructor(name, message) {
+    super(message);
+    this.name = name;
+  }
+};
+function isFrameEntryError(error) {
+  return error instanceof PageError && error.name === "FrameEntryError";
+}
+async function pageScript(name, op, scope, selector, options, arg) {
+  const api = window[name];
+  if (api === void 0) return { kind: "missing" };
+  const one = () => api.one(null, scope, selector, options);
+  const iframe = async (found) => {
+    if (found !== null && found.localName !== "iframe") {
+      await api.count(null, [...scope, selector], selector, options);
+    }
+    return {
+      element: found,
+      origin: found === null ? { x: 0, y: 0 } : api.origin(found),
+      // Whether the iframe is visible in its own document: content in a hidden
+      // frame is hidden, whatever its own style says.
+      visible: found !== null && api.visible(found)
+    };
+  };
+  try {
+    let value;
+    switch (op) {
+      case "frame":
+        value = await iframe(await one());
+        break;
+      case "frameNow":
+        value = await iframe(api.oneNow(null, scope, selector, options));
+        break;
+      case "element":
+        value = { element: await one() };
+        break;
+      case "probe": {
+        const matches = api.allNow(null, scope, selector, options);
+        value = { count: matches.length, element: matches.length === 1 ? matches[0] : null };
+        break;
+      }
+      case "visible": {
+        const matches = api.allNow(null, scope, selector, options);
+        value = {
+          count: matches.length,
+          visible: matches.length === 1 && api.visible(matches[0])
+        };
+        break;
+      }
+      case "count":
+        value = await api.count(null, scope, selector, options);
+        break;
+      case "texts": {
+        const matches = await api.all(null, scope, selector, options);
+        const index = selector.nth;
+        const listed = index === void 0 ? matches : matches.slice(index, index + 1);
+        value = listed.map((element) => element.textContent ?? "");
+        break;
+      }
+      case "text":
+        value = (await one()).textContent ?? "";
+        break;
+      case "value":
+        value = (await one()).value ?? "";
+        break;
+      case "attribute":
+        value = (await one()).getAttribute(arg ?? "");
+        break;
+      case "enabled": {
+        const element = await one();
+        value = {
+          disabled: element.disabled === true || element.closest(":disabled") !== null,
+          aria: element.getAttribute("aria-disabled")
+        };
+        break;
+      }
+      case "checked": {
+        const element = await one();
+        value = {
+          element,
+          aria: element.getAttribute("aria-checked"),
+          native: Boolean(element.checked)
+        };
+        break;
+      }
+      case "selected": {
+        const element = await one();
+        value = [...element.selectedOptions ?? []].map((option) => option.value);
+        break;
+      }
+      case "select": {
+        const element = await one();
+        value = {
+          element,
+          multiple: element.multiple,
+          selected: [...element.selectedOptions ?? []].map((option) => option.value),
+          // What each option can be chosen by: its value, or the label it shows.
+          options: [...element.options ?? []].map((option) => ({
+            value: option.value,
+            label: option.label.trim()
+          }))
+        };
+        break;
+      }
+      case "clear": {
+        const element = await one();
+        const direct = ["range", "date", "datetime-local", "month", "week", "time", "color"];
+        element.focus();
+        if (typeof element.select === "function") element.select();
+        else window.getSelection()?.selectAllChildren(element);
+        value = {
+          element,
+          direct: element.localName === "input" && direct.includes(element.type),
+          filled: (element.value ?? element.textContent ?? "") !== ""
+        };
+        break;
+      }
+      case "box":
+        value = api.box(await one());
+        break;
+      case "upload": {
+        const element = await one();
+        const control = element.localName === "label" ? element.control : null;
+        const input = control ?? element;
+        value = {
+          element: input,
+          target: api.fileTarget(element),
+          filled: (input.files?.length ?? 0) > 0
+        };
+        break;
+      }
+      case "focus":
+        ;
+        (await one()).focus();
+        value = null;
+        break;
+      case "blur":
+        ;
+        (await one()).blur();
+        value = null;
+        break;
+    }
+    return { kind: "ok", value, url: location.href };
+  } catch (error) {
+    const { name: name2 = "Error", message = String(error) } = error ?? {};
+    return { kind: "error", name: name2, message };
+  }
+}
+
+// src/webdriver.ts
+var classic;
+function classicScript() {
+  if (classic === void 0) classic = `return (${pageScript.toString()}).apply(null, arguments)`;
+  return classic;
+}
+async function callPage(driver, site, op, scope, selector, timeout, arg = null) {
+  core.checkTestIds(scope, selector);
+  const args = [
+    PAGE_API_GLOBAL,
+    op,
+    scope.map(encodeSelector),
+    encodeSelector(selector),
+    // The page cannot see this process's configure(), so the settings travel.
+    { testIdAttribute: core.getConfig().testIdAttribute, timeout },
+    arg
+  ];
+  const ask = async () => await driver.run(site, args);
+  let reply = await ask();
+  if (reply.kind === "missing") {
+    await driver.inject(site, injectSource());
+    reply = await ask();
+  }
+  if (reply.kind === "missing") {
+    throw new Error("harnessed: the resolver could not be injected into the page.");
+  }
+  if (reply.kind === "error") throw core.reviveStrictViolation(new PageError(reply.name, reply.message));
+  if (site.top) driver.sawUrl?.(reply.url);
+  return reply.value;
+}
+function splitAtFrames(scope) {
+  const hops = [];
+  let current = [];
+  for (const link of scope) {
+    if (link.frame === true) {
+      hops.push({ scope: current, link });
+      current = [];
+    } else {
+      current.push(link);
+    }
+  }
+  return { hops, rest: current };
+}
+var FrameAbsent = class extends Error {
+  name = "FrameAbsent";
+};
+async function walk(driver, scope, options, operation) {
+  const deadline = Date.now() + options.timeout;
+  const remaining = () => Math.max(0, deadline - Date.now());
+  const { hops, rest } = splitAtFrames(scope);
+  let site = driver.top();
+  let entered = false;
+  try {
+    for (const hop of hops) {
+      const op = options.waiting ? "frame" : "frameNow";
+      const found = await callPage(driver, site, op, hop.scope, hop.link, remaining());
+      if (found.element === null) throw new FrameAbsent();
+      const iframe = await driver.element(site, found.element);
+      await options.onFrame?.(iframe, { visible: found.visible });
+      const origin = { x: site.origin.x + found.origin.x, y: site.origin.y + found.origin.y };
+      site = await driver.enterFrame(site, iframe, origin);
+      entered = true;
+    }
+    return await operation(site, rest, remaining);
+  } finally {
+    if (entered) await driver.leaveFrames();
+  }
+}
+
+exports.FrameAbsent = FrameAbsent;
+exports.PageError = PageError;
+exports.callPage = callPage;
+exports.classicScript = classicScript;
+exports.isFrameEntryError = isFrameEntryError;
+exports.pageScript = pageScript;
+exports.walk = walk;
+//# sourceMappingURL=webdriver.cjs.map
+//# sourceMappingURL=webdriver.cjs.map

package/dist/webdriver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/global-name.ts","../src/wire.ts","../src/inject.ts","../src/webdriver-page-script.ts","../src/webdriver.ts"],"names":["join","dirname","fileURLToPath","readFileSync","name","checkTestIds","getConfig","reviveStrictViolation"],"mappings":";;;;;;;;;;;;AAKO,IAAM,eAAA,GAAkB,oBAAA;;;ACe/B,SAAS,SAAS,KAAA,EAAiC;AACjD,EAAA,OAAO,MAAA,CAAO,SAAA,CAAU,QAAA,CAAS,IAAA,CAAK,KAAK,CAAA,KAAM,iBAAA;AACnD;AAEA,SAAS,YAAY,KAAA,EAAyB;AAC5C,EAAA,IAAI,QAAA,CAAS,KAAK,CAAA,EAAG,OAAO,EAAE,SAAS,KAAA,CAAM,MAAA,EAAQ,KAAA,EAAO,KAAA,CAAM,KAAA,EAAM;AACxE,EAAA,IAAI,MAAM,OAAA,CAAQ,KAAK,GAAG,OAAO,KAAA,CAAM,IAAI,WAAW,CAAA;AACtD,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA,EAAM;AAC/C,IAAA,OAAO,MAAA,CAAO,WAAA;AAAA,MACZ,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,CAAE,IAAI,CAAC,CAAC,GAAA,EAAK,KAAK,MAAM,CAAC,GAAA,EAAK,WAAA,CAAY,KAAK,CAAC,CAAC;AAAA,KACvE;AAAA,EACF;AACA,EAAA,OAAO,KAAA;AACT;AAuBO,SAAS,eAAe,QAAA,EAAkC;AAC/D,EAAA,OAAO,YAAY,QAAQ,CAAA;AAC7B;;;ACxCO,SAAS,UAAA,GAAqB;AAGnC,EAAA,IAAI,OAAO,eAAe,QAAA,EAAU,OAAOA,UAAKC,YAAA,CAAQ,UAAU,GAAG,kBAAkB,CAAA;AACvF,EAAA,OAAOC,kBAAc,IAAI,GAAA,CAAI,oBAAA,EAAsB,+PAAe,CAAC,CAAA;AACrE;AAEA,IAAI,MAAA;AAMG,SAAS,YAAA,GAAuB;AACrC,EAAA,IAAI,WAAW,MAAA,EAAW,MAAA,GAASC,eAAA,CAAa,UAAA,IAAc,MAAM,CAAA;AACpE,EAAA,OAAO,MAAA;AACT;;;ACQO,IAAM,SAAA,GAAN,cAAwB,KAAA,CAAM;AAAA,EACnC,WAAA,CAAY,MAAc,OAAA,EAAiB;AACzC,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AACF;AAGO,SAAS,kBAAkB,KAAA,EAAyB;AACzD,EAAA,OAAO,KAAA,YAAiB,SAAA,IAAa,KAAA,CAAM,IAAA,KAAS,iBAAA;AACtD;AAeA,eAAsB,WACpB,IAAA,EACA,EAAA,EACA,KAAA,EACA,QAAA,EACA,SACA,GAAA,EACoB;AACpB,EAAA,MAAM,GAAA,GAAO,OAA0D,IAAI,CAAA;AAE3E,EAAA,IAAI,GAAA,KAAQ,MAAA,EAAW,OAAO,EAAE,MAAM,SAAA,EAAU;AAChD,EAAA,MAAM,MAAM,MAAM,GAAA,CAAI,IAAI,IAAA,EAAM,KAAA,EAAO,UAAU,OAAO,CAAA;AAMxD,EAAA,MAAM,MAAA,GAAS,OAAO,KAAA,KAA0B;AAC9C,IAAA,IAAI,KAAA,KAAU,IAAA,IAAQ,KAAA,CAAM,SAAA,KAAc,QAAA,EAAU;AAClD,MAAA,MAAM,GAAA,CAAI,MAAM,IAAA,EAAM,CAAC,GAAG,KAAA,EAAO,QAAQ,CAAA,EAAG,QAAA,EAAU,OAAO,CAAA;AAAA,IAC/D;AACA,IAAA,OAAO;AAAA,MACL,OAAA,EAAS,KAAA;AAAA,MACT,MAAA,EAAQ,KAAA,KAAU,IAAA,GAAO,EAAE,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAA,EAAE,GAAI,GAAA,CAAI,MAAA,CAAO,KAAK,CAAA;AAAA;AAAA;AAAA,MAG1D,OAAA,EAAS,KAAA,KAAU,IAAA,IAAQ,GAAA,CAAI,QAAQ,KAAK;AAAA,KAC9C;AAAA,EACF,CAAA;AACA,EAAA,IAAI;AACF,IAAA,IAAI,KAAA;AACJ,IAAA,QAAQ,EAAA;AAAI,MACV,KAAK,OAAA;AACH,QAAA,KAAA,GAAQ,MAAM,MAAA,CAAO,MAAM,GAAA,EAAK,CAAA;AAChC,QAAA;AAAA,MACF,KAAK,UAAA;AACH,QAAA,KAAA,GAAQ,MAAM,OAAO,GAAA,CAAI,MAAA,CAAO,MAAM,KAAA,EAAO,QAAA,EAAU,OAAO,CAAC,CAAA;AAC/D,QAAA;AAAA,MACF,KAAK,SAAA;AACH,QAAA,KAAA,GAAQ,EAAE,OAAA,EAAS,MAAM,GAAA,EAAI,EAAE;AAC/B,QAAA;AAAA,MACF,KAAK,OAAA,EAAS;AAGZ,QAAA,MAAM,UAAU,GAAA,CAAI,MAAA,CAAO,IAAA,EAAM,KAAA,EAAO,UAAU,OAAO,CAAA;AACzD,QAAA,KAAA,GAAQ,EAAE,KAAA,EAAO,OAAA,CAAQ,MAAA,EAAQ,OAAA,EAAS,OAAA,CAAQ,MAAA,KAAW,CAAA,GAAI,OAAA,CAAQ,CAAC,CAAA,GAAI,IAAA,EAAK;AACnF,QAAA;AAAA,MACF;AAAA,MACA,KAAK,SAAA,EAAW;AAEd,QAAA,MAAM,UAAU,GAAA,CAAI,MAAA,CAAO,IAAA,EAAM,KAAA,EAAO,UAAU,OAAO,CAAA;AACzD,QAAA,KAAA,GAAQ;AAAA,UACN,OAAO,OAAA,CAAQ,MAAA;AAAA,UACf,OAAA,EAAS,QAAQ,MAAA,KAAW,CAAA,IAAK,IAAI,OAAA,CAAQ,OAAA,CAAQ,CAAC,CAAY;AAAA,SACpE;AACA,QAAA;AAAA,MACF;AAAA,MACA,KAAK,OAAA;AACH,QAAA,KAAA,GAAQ,MAAM,GAAA,CAAI,KAAA,CAAM,IAAA,EAAM,KAAA,EAAO,UAAU,OAAO,CAAA;AACtD,QAAA;AAAA,MACF,KAAK,OAAA,EAAS;AACZ,QAAA,MAAM,UAAU,MAAM,GAAA,CAAI,IAAI,IAAA,EAAM,KAAA,EAAO,UAAU,OAAO,CAAA;AAC5D,QAAA,MAAM,QAAS,QAAA,CAA8B,GAAA;AAC7C,QAAA,MAAM,MAAA,GAAS,UAAU,KAAA,CAAA,GAAY,OAAA,GAAU,QAAQ,KAAA,CAAM,KAAA,EAAO,QAAQ,CAAC,CAAA;AAC7E,QAAA,KAAA,GAAQ,MAAA,CAAO,GAAA,CAAI,CAAA,OAAA,KAAW,OAAA,CAAQ,eAAe,EAAE,CAAA;AACvD,QAAA;AAAA,MACF;AAAA,MACA,KAAK,MAAA;AACH,QAAA,KAAA,GAAA,CAAS,MAAM,GAAA,EAAI,EAAG,WAAA,IAAe,EAAA;AACrC,QAAA;AAAA,MACF,KAAK,OAAA;AACH,QAAA,KAAA,GAAA,CAAU,MAAM,GAAA,EAAI,EAAwB,KAAA,IAAS,EAAA;AACrD,QAAA;AAAA,MACF,KAAK,WAAA;AACH,QAAA,KAAA,GAAA,CAAS,MAAM,GAAA,EAAI,EAAG,YAAA,CAAa,OAAO,EAAE,CAAA;AAC5C,QAAA;AAAA,MACF,KAAK,SAAA,EAAW;AACd,QAAA,MAAM,OAAA,GAAW,MAAM,GAAA,EAAI;AAG3B,QAAA,KAAA,GAAQ;AAAA,UACN,UAAU,OAAA,CAAQ,QAAA,KAAa,QAAQ,OAAA,CAAQ,OAAA,CAAQ,WAAW,CAAA,KAAM,IAAA;AAAA,UACxE,IAAA,EAAM,OAAA,CAAQ,YAAA,CAAa,eAAe;AAAA,SAC5C;AACA,QAAA;AAAA,MACF;AAAA,MACA,KAAK,SAAA,EAAW;AACd,QAAA,MAAM,OAAA,GAAW,MAAM,GAAA,EAAI;AAC3B,QAAA,KAAA,GAAQ;AAAA,UACN,OAAA;AAAA,UACA,IAAA,EAAM,OAAA,CAAQ,YAAA,CAAa,cAAc,CAAA;AAAA,UACzC,MAAA,EAAQ,OAAA,CAAQ,OAAA,CAAQ,OAAO;AAAA,SACjC;AACA,QAAA;AAAA,MACF;AAAA,MACA,KAAK,UAAA,EAAY;AACf,QAAA,MAAM,OAAA,GAAW,MAAM,GAAA,EAAI;AAC3B,QAAA,KAAA,GAAQ,CAAC,GAAI,OAAA,CAAQ,eAAA,IAAmB,EAAG,CAAA,CAAE,GAAA,CAAI,CAAA,MAAA,KAAU,MAAA,CAAO,KAAK,CAAA;AACvE,QAAA;AAAA,MACF;AAAA,MACA,KAAK,QAAA,EAAU;AACb,QAAA,MAAM,OAAA,GAAW,MAAM,GAAA,EAAI;AAC3B,QAAA,KAAA,GAAQ;AAAA,UACN,OAAA;AAAA,UACA,UAAU,OAAA,CAAQ,QAAA;AAAA,UAClB,QAAA,EAAU,CAAC,GAAI,OAAA,CAAQ,eAAA,IAAmB,EAAG,CAAA,CAAE,GAAA,CAAI,CAAA,MAAA,KAAU,MAAA,CAAO,KAAK,CAAA;AAAA;AAAA,UAEzE,OAAA,EAAS,CAAC,GAAI,OAAA,CAAQ,WAAW,EAAG,CAAA,CAAE,GAAA,CAAI,CAAA,MAAA,MAAW;AAAA,YACnD,OAAO,MAAA,CAAO,KAAA;AAAA,YACd,KAAA,EAAO,MAAA,CAAO,KAAA,CAAM,IAAA;AAAK,WAC3B,CAAE;AAAA,SACJ;AACA,QAAA;AAAA,MACF;AAAA,MACA,KAAK,OAAA,EAAS;AACZ,QAAA,MAAM,OAAA,GAAW,MAAM,GAAA,EAAI;AAE3B,QAAA,MAAM,MAAA,GAAS,CAAC,OAAA,EAAS,MAAA,EAAQ,kBAAkB,OAAA,EAAS,MAAA,EAAQ,QAAQ,OAAO,CAAA;AACnF,QAAA,OAAA,CAAQ,KAAA,EAAM;AAGd,QAAA,IAAI,OAAO,OAAA,CAAQ,MAAA,KAAW,UAAA,UAAoB,MAAA,EAAO;AAAA,aACpD,MAAA,CAAO,YAAA,EAAa,EAAG,iBAAA,CAAkB,OAAO,CAAA;AACrD,QAAA,KAAA,GAAQ;AAAA,UACN,OAAA;AAAA,UACA,QAAQ,OAAA,CAAQ,SAAA,KAAc,WAAW,MAAA,CAAO,QAAA,CAAS,QAAQ,IAAI,CAAA;AAAA,UACrE,MAAA,EAAA,CAAS,OAAA,CAAQ,KAAA,IAAS,OAAA,CAAQ,eAAe,EAAA,MAAQ;AAAA,SAC3D;AACA,QAAA;AAAA,MACF;AAAA,MACA,KAAK,KAAA;AAEH,QAAA,KAAA,GAAQ,GAAA,CAAI,GAAA,CAAI,MAAM,GAAA,EAAK,CAAA;AAC3B,QAAA;AAAA,MACF,KAAK,QAAA,EAAU;AACb,QAAA,MAAM,OAAA,GAAU,MAAM,GAAA,EAAI;AAC1B,QAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,SAAA,KAAc,OAAA,GAAW,QAA6B,OAAA,GAAU,IAAA;AAExF,QAAA,MAAM,QAAS,OAAA,IAAW,OAAA;AAC1B,QAAA,KAAA,GAAQ;AAAA,UACN,OAAA,EAAS,KAAA;AAAA,UACT,MAAA,EAAQ,GAAA,CAAI,UAAA,CAAW,OAAO,CAAA;AAAA,UAC9B,MAAA,EAAA,CAAS,KAAA,CAAM,KAAA,EAAO,MAAA,IAAU,CAAA,IAAK;AAAA,SACvC;AACA,QAAA;AAAA,MACF;AAAA,MACA,KAAK,OAAA;AACH,QAAA;AAAC,QAAA,CAAE,MAAM,GAAA,EAAI,EAAmB,KAAA,EAAM;AACtC,QAAA,KAAA,GAAQ,IAAA;AACR,QAAA;AAAA,MACF,KAAK,MAAA;AACH,QAAA;AAAC,QAAA,CAAE,MAAM,GAAA,EAAI,EAAmB,IAAA,EAAK;AACrC,QAAA,KAAA,GAAQ,IAAA;AACR,QAAA;AAAA;AAEJ,IAAA,OAAO,EAAE,IAAA,EAAM,IAAA,EAAM,KAAA,EAAO,GAAA,EAAK,SAAS,IAAA,EAAK;AAAA,EACjD,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,EAAE,IAAA,EAAAC,KAAAA,GAAO,OAAA,EAAS,OAAA,GAAU,OAAO,KAAK,CAAA,EAAE,GAAK,KAAA,IAAS,EAAC;AAC/D,IAAA,OAAO,EAAE,IAAA,EAAM,OAAA,EAAS,IAAA,EAAAA,OAAM,OAAA,EAAQ;AAAA,EACxC;AACF;;;ACxKA,IAAI,OAAA;AAMG,SAAS,aAAA,GAAwB;AACtC,EAAA,IAAI,YAAY,MAAA,EAAW,OAAA,GAAU,CAAA,QAAA,EAAW,UAAA,CAAW,UAAU,CAAA,wBAAA,CAAA;AACrE,EAAA,OAAO,OAAA;AACT;AAUA,eAAsB,QAAA,CACpB,QACA,IAAA,EACA,EAAA,EACA,OACA,QAAA,EACA,OAAA,EACA,MAAqB,IAAA,EACH;AAClB,EAAAC,iBAAA,CAAa,OAAO,QAAQ,CAAA;AAC5B,EAAA,MAAM,IAAA,GAAuB;AAAA,IAC3B,eAAA;AAAA,IACA,EAAA;AAAA,IACA,KAAA,CAAM,IAAI,cAAc,CAAA;AAAA,IACxB,eAAe,QAAQ,CAAA;AAAA;AAAA,IAEvB,EAAE,eAAA,EAAiBC,cAAA,EAAU,CAAE,iBAAiB,OAAA,EAAQ;AAAA,IACxD;AAAA,GACF;AACA,EAAA,MAAM,MAAM,YAAa,MAAM,MAAA,CAAO,GAAA,CAAI,MAAM,IAAI,CAAA;AACpD,EAAA,IAAI,KAAA,GAAQ,MAAM,GAAA,EAAI;AACtB,EAAA,IAAI,KAAA,CAAM,SAAS,SAAA,EAAW;AAC5B,IAAA,MAAM,MAAA,CAAO,MAAA,CAAO,IAAA,EAAM,YAAA,EAAc,CAAA;AACxC,IAAA,KAAA,GAAQ,MAAM,GAAA,EAAI;AAAA,EACpB;AACA,EAAA,IAAI,KAAA,CAAM,SAAS,SAAA,EAAW;AAC5B,IAAA,MAAM,IAAI,MAAM,8DAA8D,CAAA;AAAA,EAChF;AAEA,EAAA,IAAI,KAAA,CAAM,IAAA,KAAS,OAAA,EAAS,MAAMC,0BAAA,CAAsB,IAAI,SAAA,CAAU,KAAA,CAAM,IAAA,EAAM,KAAA,CAAM,OAAO,CAAC,CAAA;AAChG,EAAA,IAAI,IAAA,CAAK,GAAA,EAAK,MAAA,CAAO,MAAA,GAAS,MAAM,GAAG,CAAA;AACvC,EAAA,OAAO,KAAA,CAAM,KAAA;AACf;AAQA,SAAS,cAAc,KAAA,EAA+D;AACpF,EAAA,MAAM,OAAc,EAAC;AACrB,EAAA,IAAI,UAAsB,EAAC;AAC3B,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,IAAI,IAAA,CAAK,UAAU,IAAA,EAAM;AACvB,MAAA,IAAA,CAAK,IAAA,CAAK,EAAE,KAAA,EAAO,OAAA,EAAS,MAAM,CAAA;AAClC,MAAA,OAAA,GAAU,EAAC;AAAA,IACb,CAAA,MAAO;AACL,MAAA,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,IACnB;AAAA,EACF;AACA,EAAA,OAAO,EAAE,IAAA,EAAM,IAAA,EAAM,OAAA,EAAQ;AAC/B;AAGO,IAAM,WAAA,GAAN,cAA0B,KAAA,CAAM;AAAA,EAC5B,IAAA,GAAO,aAAA;AAClB;AA8BA,eAAsB,IAAA,CACpB,MAAA,EACA,KAAA,EACA,OAAA,EACA,SAAA,EACY;AACZ,EAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,EAAI,GAAI,OAAA,CAAQ,OAAA;AACtC,EAAA,MAAM,SAAA,GAAY,MAAM,IAAA,CAAK,GAAA,CAAI,GAAG,QAAA,GAAW,IAAA,CAAK,KAAK,CAAA;AACzD,EAAA,MAAM,EAAE,IAAA,EAAM,IAAA,EAAK,GAAI,cAAc,KAAK,CAAA;AAC1C,EAAA,IAAI,IAAA,GAAO,OAAO,GAAA,EAAI;AACtB,EAAA,IAAI,OAAA,GAAU,KAAA;AACd,EAAA,IAAI;AACF,IAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,MAAA,MAAM,EAAA,GAAK,OAAA,CAAQ,OAAA,GAAU,OAAA,GAAU,UAAA;AACvC,MAAA,MAAM,KAAA,GAAS,MAAM,QAAA,CAAS,MAAA,EAAQ,IAAA,EAAM,EAAA,EAAI,GAAA,CAAI,KAAA,EAAO,GAAA,CAAI,IAAA,EAAM,SAAA,EAAW,CAAA;AAKhF,MAAA,IAAI,KAAA,CAAM,OAAA,KAAY,IAAA,EAAM,MAAM,IAAI,WAAA,EAAY;AAClD,MAAA,MAAM,SAAS,MAAM,MAAA,CAAO,OAAA,CAAQ,IAAA,EAAM,MAAM,OAAO,CAAA;AACvD,MAAA,MAAM,QAAQ,OAAA,GAAU,MAAA,EAAQ,EAAE,OAAA,EAAS,KAAA,CAAM,SAAS,CAAA;AAE1D,MAAA,MAAM,MAAA,GAAS,EAAE,CAAA,EAAG,IAAA,CAAK,OAAO,CAAA,GAAI,KAAA,CAAM,MAAA,CAAO,CAAA,EAAG,GAAG,IAAA,CAAK,MAAA,CAAO,CAAA,GAAI,KAAA,CAAM,OAAO,CAAA,EAAE;AACtF,MAAA,IAAA,GAAO,MAAM,MAAA,CAAO,UAAA,CAAW,IAAA,EAAM,QAAQ,MAAM,CAAA;AACnD,MAAA,OAAA,GAAU,IAAA;AAAA,IACZ;AACA,IAAA,OAAO,MAAM,SAAA,CAAU,IAAA,EAAM,IAAA,EAAM,SAAS,CAAA;AAAA,EAC9C,CAAA,SAAE;AACA,IAAA,IAAI,OAAA,EAAS,MAAM,MAAA,CAAO,WAAA,EAAY;AAAA,EACxC;AACF","file":"webdriver.cjs","sourcesContent":["/**\n * Where the injected build installs itself on the page's `window`. A leaf\n * module with no imports, so the Node-side `inject` entry can name it without\n * pulling in the resolver and Testing Library, which only run in the page.\n */\nexport const PAGE_API_GLOBAL = '__harnessedResolve'\n","import type { Selector } from '@harnessed-ts/core'\n\n/**\n * A `Selector` as it crosses into a remote page. Everything in one is JSON-safe\n * except a RegExp — `role('button', { name: /save/i })` — which WebDriver,\n * CDP and TestCafe all serialise to `{}`. This encodes them as tagged objects\n * on the way out, and the page API decodes them on the way in.\n */\nexport interface WireRegExp {\n  $regexp: string\n  flags: string\n}\n\nexport type WireSelector = Record<string, unknown>\n\n/**\n * Not `instanceof`: a selector built in the test process and handed to a page\n * in the same JS engine (jsdom, a same-origin frame) carries the other realm's\n * RegExp, which `instanceof` does not recognise.\n */\nfunction isRegExp(value: unknown): value is RegExp {\n  return Object.prototype.toString.call(value) === '[object RegExp]'\n}\n\nfunction encodeValue(value: unknown): unknown {\n  if (isRegExp(value)) return { $regexp: value.source, flags: value.flags }\n  if (Array.isArray(value)) return value.map(encodeValue)\n  if (typeof value === 'object' && value !== null) {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, inner]) => [key, encodeValue(inner)]),\n    )\n  }\n  return value\n}\n\nfunction isWireRegExp(value: unknown): value is WireRegExp {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as WireRegExp).$regexp === 'string' &&\n    typeof (value as WireRegExp).flags === 'string'\n  )\n}\n\nfunction decodeValue(value: unknown): unknown {\n  if (isRegExp(value)) return new RegExp(value.source, value.flags)\n  if (isWireRegExp(value)) return new RegExp(value.$regexp, value.flags)\n  if (Array.isArray(value)) return value.map(decodeValue)\n  if (typeof value === 'object' && value !== null) {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, inner]) => [key, decodeValue(inner)]),\n    )\n  }\n  return value\n}\n\nexport function encodeSelector(selector: Selector): WireSelector {\n  return encodeValue(selector) as WireSelector\n}\n\n/** Idempotent: a selector that never left the process decodes to itself. */\nexport function decodeSelector(selector: Selector | WireSelector): Selector {\n  return decodeValue(selector) as Selector\n}\n","import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { basename, dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n// Leaf modules only: this entry runs in the test process, where the resolver\n// and Testing Library have no business loading.\nexport { PAGE_API_GLOBAL } from './global-name'\nexport { encodeSelector } from './wire'\nexport type { WireSelector } from './wire'\nexport type { PageApi, PageApiOptions } from './page-api'\n\ndeclare const __filename: string | undefined\n\n/**\n * Absolute path to the injectable build, for drivers that inject by path\n * (TestCafe's `clientScripts`, Puppeteer's `addScriptTag`).\n */\nexport function injectPath(): string {\n  // A sibling in dist/. The CJS build has __filename; the ESM build has\n  // import.meta.url and no __filename, so each takes its own branch.\n  if (typeof __filename === 'string') return join(dirname(__filename), 'inject.global.js')\n  return fileURLToPath(new URL('./inject.global.js', import.meta.url))\n}\n\nlet cached: string | undefined\n\n/**\n * The injectable build's source, for drivers that inject by evaluating a string\n * (WebdriverIO's `execute`, Puppeteer's `evaluate`). Read once per process.\n */\nexport function injectSource(): string {\n  if (cached === undefined) cached = readFileSync(injectPath(), 'utf8')\n  return cached\n}\n\nlet uploads: string | undefined\nlet written = 0\n\n/**\n * Writes files to disk for a driver whose browser only takes file paths\n * (Puppeteer's `uploadFile`, WebDriver's file input, TestCafe's\n * `setFilesToUpload`), and returns the paths in order.\n *\n * Each file gets a directory of its own, so its name survives as the path's\n * last segment even when two files share one. The browser reads the file when\n * the page does — after the upload resolves — so nothing is deleted until the\n * process exits. What travels is the name and the bytes: the browser infers\n * `type` from the extension, and `lastModified` is the time of writing.\n */\nexport async function filesOnDisk(files: readonly File[]): Promise<string[]> {\n  if (uploads === undefined) {\n    const root = mkdtempSync(join(tmpdir(), 'harnessed-uploads-'))\n    uploads = root\n    process.once('exit', () => rmSync(root, { recursive: true, force: true }))\n  }\n  const root = uploads\n  return Promise.all(\n    files.map(async file => {\n      const dir = join(root, String(written++))\n      mkdirSync(dir)\n      // basename: a name is a name, never a path out of the directory.\n      const path = join(dir, basename(file.name) || 'upload')\n      writeFileSync(path, new Uint8Array(await file.arrayBuffer()))\n      return path\n    }),\n  )\n}\n","import type { PageApi, PageApiOptions } from './page-api'\nimport type { WireSelector } from './wire'\n\n/**\n * What the in-page script does with the target it resolves. Reads happen in the\n * page, in the same round-trip as the resolution: a WebDriver command costs a\n * few milliseconds each way, and a read that first fetched an element reference\n * and then asked about it would pay that twice.\n */\nexport type PageOp =\n  | 'frame'\n  | 'frameNow'\n  | 'element'\n  | 'probe'\n  | 'visible'\n  | 'count'\n  | 'texts'\n  | 'text'\n  | 'value'\n  | 'attribute'\n  | 'enabled'\n  | 'checked'\n  | 'selected'\n  | 'select'\n  | 'clear'\n  | 'focus'\n  | 'blur'\n  | 'box'\n  | 'upload'\n\n/**\n * The script's answer. A page error comes back as a value rather than a thrown\n * script error, so its name and message arrive intact — a thrown one reaches the\n * test wrapped in protocol noise, and under WebDriver Classic is logged as a\n * driver failure as well.\n */\nexport type PageReply =\n  | { kind: 'missing' }\n  | { kind: 'ok'; value: unknown; url: string }\n  | { kind: 'error'; name: string; message: string }\n\n/** Raised in the page by the shared resolver: strictness, index and frame rules. */\nexport class PageError extends Error {\n  constructor(name: string, message: string) {\n    super(message)\n    this.name = name\n  }\n}\n\n/** The shared resolver's refusal of a frame it cannot enter. Never \"not there yet\". */\nexport function isFrameEntryError(error: unknown): boolean {\n  return error instanceof PageError && error.name === 'FrameEntryError'\n}\n\n/**\n * An element as WebDriver returns it from a script, before the driver's client\n * wraps it (WebdriverIO's `$()`; selenium-webdriver hands back a `WebElement`\n * already).\n */\nexport type ElementRef = { 'element-6066-11e4-a52e-4f735466cecf': string }\n\n/**\n * Runs IN THE PAGE, serialised with `Function.prototype.toString`, so it must\n * close over nothing: every input arrives as an argument. Elements are\n * only ever returned as object properties, each at most once — WebDriver BiDi\n * serialises an element repeated in a result, or one inside an array, as `{}`.\n */\nexport async function pageScript(\n  name: string,\n  op: PageOp,\n  scope: WireSelector[],\n  selector: WireSelector,\n  options: PageApiOptions,\n  arg: string | null,\n): Promise<PageReply> {\n  const api = (window as unknown as Record<string, PageApi | undefined>)[name]\n  // Navigation replaces the window, and the resolver with it.\n  if (api === undefined) return { kind: 'missing' }\n  const one = () => api.one(null, scope, selector, options)\n  /**\n   * A frame link must land on an iframe. When it does not, walking through the\n   * same link with the shared resolver raises its FrameEntryError, so the\n   * refusal and its wording stay the resolver's rather than a copy kept here.\n   */\n  const iframe = async (found: Element | null) => {\n    if (found !== null && found.localName !== 'iframe') {\n      await api.count(null, [...scope, selector], selector, options)\n    }\n    return {\n      element: found,\n      origin: found === null ? { x: 0, y: 0 } : api.origin(found),\n      // Whether the iframe is visible in its own document: content in a hidden\n      // frame is hidden, whatever its own style says.\n      visible: found !== null && api.visible(found),\n    }\n  }\n  try {\n    let value: unknown\n    switch (op) {\n      case 'frame':\n        value = await iframe(await one())\n        break\n      case 'frameNow':\n        value = await iframe(api.oneNow(null, scope, selector, options))\n        break\n      case 'element':\n        value = { element: await one() }\n        break\n      case 'probe': {\n        // `allNow` applies `nth` and answers at once; the caller decides what\n        // more than one match means, with the whole scope chain in hand.\n        const matches = api.allNow(null, scope, selector, options)\n        value = { count: matches.length, element: matches.length === 1 ? matches[0] : null }\n        break\n      }\n      case 'visible': {\n        // `probe`'s answer, with the layout check made in the same round-trip.\n        const matches = api.allNow(null, scope, selector, options)\n        value = {\n          count: matches.length,\n          visible: matches.length === 1 && api.visible(matches[0] as Element),\n        }\n        break\n      }\n      case 'count':\n        value = await api.count(null, scope, selector, options)\n        break\n      case 'texts': {\n        const matches = await api.all(null, scope, selector, options)\n        const index = (selector as { nth?: number }).nth\n        const listed = index === undefined ? matches : matches.slice(index, index + 1)\n        value = listed.map(element => element.textContent ?? '')\n        break\n      }\n      case 'text':\n        value = (await one()).textContent ?? ''\n        break\n      case 'value':\n        value = ((await one()) as HTMLInputElement).value ?? ''\n        break\n      case 'attribute':\n        value = (await one()).getAttribute(arg ?? '')\n        break\n      case 'enabled': {\n        const element = (await one()) as HTMLInputElement\n        // The property, and the closest `:disabled`, both see an ancestor\n        // fieldset's `disabled`; the element's own attribute does not.\n        value = {\n          disabled: element.disabled === true || element.closest(':disabled') !== null,\n          aria: element.getAttribute('aria-disabled'),\n        }\n        break\n      }\n      case 'checked': {\n        const element = (await one()) as HTMLInputElement\n        value = {\n          element,\n          aria: element.getAttribute('aria-checked'),\n          native: Boolean(element.checked),\n        }\n        break\n      }\n      case 'selected': {\n        const element = (await one()) as HTMLSelectElement\n        value = [...(element.selectedOptions ?? [])].map(option => option.value)\n        break\n      }\n      case 'select': {\n        const element = (await one()) as HTMLSelectElement\n        value = {\n          element,\n          multiple: element.multiple,\n          selected: [...(element.selectedOptions ?? [])].map(option => option.value),\n          // What each option can be chosen by: its value, or the label it shows.\n          options: [...(element.options ?? [])].map(option => ({\n            value: option.value,\n            label: option.label.trim(),\n          })),\n        }\n        break\n      }\n      case 'clear': {\n        const element = (await one()) as HTMLInputElement\n        // WebDriver sets these input types' values directly: they take no typing.\n        const direct = ['range', 'date', 'datetime-local', 'month', 'week', 'time', 'color']\n        element.focus()\n        // Selected, so one Backspace deletes it all: a real edit, which fires the\n        // input events a controlled component listens for.\n        if (typeof element.select === 'function') element.select()\n        else window.getSelection()?.selectAllChildren(element)\n        value = {\n          element,\n          direct: element.localName === 'input' && direct.includes(element.type),\n          filled: (element.value ?? element.textContent ?? '') !== '',\n        }\n        break\n      }\n      case 'box':\n        // In this document's viewport; the driver adds the frames' origins.\n        value = api.box(await one())\n        break\n      case 'upload': {\n        const element = await one()\n        const control = element.localName === 'label' ? (element as HTMLLabelElement).control : null\n        // The input itself, where a label is the target: WebDriver types paths into the input.\n        const input = (control ?? element) as HTMLInputElement\n        value = {\n          element: input,\n          target: api.fileTarget(element),\n          filled: (input.files?.length ?? 0) > 0,\n        }\n        break\n      }\n      case 'focus':\n        ;((await one()) as HTMLElement).focus()\n        value = null\n        break\n      case 'blur':\n        ;((await one()) as HTMLElement).blur()\n        value = null\n        break\n    }\n    return { kind: 'ok', value, url: location.href }\n  } catch (error) {\n    const { name = 'Error', message = String(error) } = (error ?? {}) as Partial<Error>\n    return { kind: 'error', name, message }\n  }\n}\n","import { checkTestIds, getConfig, reviveStrictViolation } from '@harnessed-ts/core'\nimport type { Selector } from '@harnessed-ts/core'\nimport type { Point } from './box'\nimport { injectSource } from './inject'\nimport { PAGE_API_GLOBAL } from './global-name'\nimport { encodeSelector } from './wire'\nimport { PageError, pageScript } from './webdriver-page-script'\nimport type { ElementRef, PageOp, PageReply } from './webdriver-page-script'\n\nexport { isFrameEntryError, PageError, pageScript } from './webdriver-page-script'\nexport type { ElementRef, PageOp, PageReply } from './webdriver-page-script'\nexport type { Point } from './box'\n\n/** What `pageScript` takes, in order: what every `WebDriverLike.run` passes it. */\nexport type PageScriptArgs = Parameters<typeof pageScript>\n\n/**\n * A document a WebDriver client is working in: the top-level one, or a frame's\n * a walk entered. A driver extends it with whatever it needs to address that\n * document (a BiDi browsing context, say).\n */\nexport interface WebDriverSite {\n  /** The top-level document, whose URL is the page's URL. */\n  readonly top: boolean\n  /** Where this document's viewport starts in the top-level one, in CSS pixels. */\n  readonly origin: Point\n}\n\n/**\n * What the shared WebDriver code needs from a client — WebdriverIO,\n * selenium-webdriver under Nightwatch — and nothing more: running a script in a\n * document, and crossing into a frame. `S` is the client's site, `E` its element.\n */\nexport interface WebDriverLike<S extends WebDriverSite, E> {\n  /** The top-level document. */\n  top(): S\n  /**\n   * Runs `pageScript` in the site's document with these arguments and returns\n   * its reply. Under WebDriver Classic, `classicScript()` is the body to send.\n   */\n  run(site: S, args: PageScriptArgs): Promise<unknown>\n  /** Evaluates the resolver's injectable source in the site's document. */\n  inject(site: S, source: string): Promise<void>\n  /** An element the page script returned, as the client's own element. */\n  element(site: S, ref: ElementRef): Promise<E>\n  /**\n   * Enters `iframe`, an element of `site`'s document, and returns the site for\n   * the frame's document, at `origin` in the top-level viewport.\n   */\n  enterFrame(site: S, iframe: E, origin: Point): Promise<S>\n  /**\n   * Undoes what entering frames changed in the session — under Classic, switches\n   * back to the top-level document. Called once after a walk that entered any.\n   */\n  leaveFrames(): Promise<void>\n  /** Hears the top-level document's URL, which every call there brings back. */\n  sawUrl?(url: string): void\n}\n\nlet classic: string | undefined\n\n/**\n * The page script as a classic Execute Script body, which awaits the promise\n * the script returns.\n */\nexport function classicScript(): string {\n  if (classic === undefined) classic = `return (${pageScript.toString()}).apply(null, arguments)`\n  return classic\n}\n\n/**\n * Runs one operation of the shared resolver in a document, injecting the\n * resolver first if the document does not have it yet.\n *\n * The presence check rides along with the call itself, so a document that\n * already has the resolver pays one round-trip, not two. Injecting happens once\n * per document: navigation replaces the window, and the resolver with it.\n */\nexport async function callPage<S extends WebDriverSite, E>(\n  driver: WebDriverLike<S, E>,\n  site: S,\n  op: PageOp,\n  scope: readonly Selector[],\n  selector: Selector,\n  timeout: number,\n  arg: string | null = null,\n): Promise<unknown> {\n  checkTestIds(scope, selector)\n  const args: PageScriptArgs = [\n    PAGE_API_GLOBAL,\n    op,\n    scope.map(encodeSelector),\n    encodeSelector(selector),\n    // The page cannot see this process's configure(), so the settings travel.\n    { testIdAttribute: getConfig().testIdAttribute, timeout },\n    arg,\n  ]\n  const ask = async () => (await driver.run(site, args)) as PageReply\n  let reply = await ask()\n  if (reply.kind === 'missing') {\n    await driver.inject(site, injectSource())\n    reply = await ask()\n  }\n  if (reply.kind === 'missing') {\n    throw new Error('harnessed: the resolver could not be injected into the page.')\n  }\n  // A strict violation comes back as core's own class, as under every driver.\n  if (reply.kind === 'error') throw reviveStrictViolation(new PageError(reply.name, reply.message))\n  if (site.top) driver.sawUrl?.(reply.url)\n  return reply.value\n}\n\n/** A scope chain cut at a frame link: the links before it, and the link itself. */\ninterface Hop {\n  scope: Selector[]\n  link: Selector\n}\n\nfunction splitAtFrames(scope: readonly Selector[]): { hops: Hop[]; rest: Selector[] } {\n  const hops: Hop[] = []\n  let current: Selector[] = []\n  for (const link of scope) {\n    if (link.frame === true) {\n      hops.push({ scope: current, link })\n      current = []\n    } else {\n      current.push(link)\n    }\n  }\n  return { hops, rest: current }\n}\n\n/** A non-waiting walk found a frame link that is not on screen. */\nexport class FrameAbsent extends Error {\n  override name = 'FrameAbsent'\n}\n\n/** What the page reports about an iframe a walk is about to enter. */\nexport interface FrameInfo {\n  /** Whether the iframe is visible by layout in its own document. */\n  readonly visible: boolean\n}\n\nexport interface WalkOptions<E> {\n  /** Wait for each frame link, or answer at once by throwing FrameAbsent. */\n  waiting: boolean\n  /** The budget for every hop and the operation together. */\n  timeout: number\n  /** Called with each iframe element, from its own document, before entering it. */\n  onFrame?: (iframe: E, info: FrameInfo) => Promise<void>\n}\n\n/**\n * Walks the scope chain's frame links, entering each frame, then runs the\n * operation in the innermost document with the links that remain.\n *\n * A WebDriver element belongs to one document: an element inside a frame cannot\n * be acted on from the top-level one, even where the page's own script could\n * reach it. So the shared resolver runs once per document — up to the iframe,\n * then inside it — and WebDriver does the crossing. That is also why\n * cross-origin frames work here, where an in-page resolver cannot enter them.\n *\n * Whatever entering changed in the session is undone afterwards, whatever\n * happened (`leaveFrames`).\n */\nexport async function walk<S extends WebDriverSite, E, T>(\n  driver: WebDriverLike<S, E>,\n  scope: readonly Selector[],\n  options: WalkOptions<E>,\n  operation: (site: S, scope: Selector[], remaining: () => number) => Promise<T>,\n): Promise<T> {\n  const deadline = Date.now() + options.timeout\n  const remaining = () => Math.max(0, deadline - Date.now())\n  const { hops, rest } = splitAtFrames(scope)\n  let site = driver.top()\n  let entered = false\n  try {\n    for (const hop of hops) {\n      const op = options.waiting ? 'frame' : 'frameNow'\n      const found = (await callPage(driver, site, op, hop.scope, hop.link, remaining())) as {\n        element: ElementRef | null\n        origin: Point\n        visible: boolean\n      }\n      if (found.element === null) throw new FrameAbsent()\n      const iframe = await driver.element(site, found.element)\n      await options.onFrame?.(iframe, { visible: found.visible })\n      // The frame's document starts where its content box does, in the document around it.\n      const origin = { x: site.origin.x + found.origin.x, y: site.origin.y + found.origin.y }\n      site = await driver.enterFrame(site, iframe, origin)\n      entered = true\n    }\n    return await operation(site, rest, remaining)\n  } finally {\n    if (entered) await driver.leaveFrames()\n  }\n}\n"]}

package/dist/webdriver.d.ts

@@ -0,0 +1,96 @@
+import type { Selector } from '@harnessed-ts/core';
+import type { Point } from './box';
+import { pageScript } from './webdriver-page-script';
+import type { ElementRef, PageOp } from './webdriver-page-script';
+export { isFrameEntryError, PageError, pageScript } from './webdriver-page-script';
+export type { ElementRef, PageOp, PageReply } from './webdriver-page-script';
+export type { Point } from './box';
+/** What `pageScript` takes, in order: what every `WebDriverLike.run` passes it. */
+export type PageScriptArgs = Parameters<typeof pageScript>;
+/**
+ * A document a WebDriver client is working in: the top-level one, or a frame's
+ * a walk entered. A driver extends it with whatever it needs to address that
+ * document (a BiDi browsing context, say).
+ */
+export interface WebDriverSite {
+    /** The top-level document, whose URL is the page's URL. */
+    readonly top: boolean;
+    /** Where this document's viewport starts in the top-level one, in CSS pixels. */
+    readonly origin: Point;
+}
+/**
+ * What the shared WebDriver code needs from a client — WebdriverIO,
+ * selenium-webdriver under Nightwatch — and nothing more: running a script in a
+ * document, and crossing into a frame. `S` is the client's site, `E` its element.
+ */
+export interface WebDriverLike<S extends WebDriverSite, E> {
+    /** The top-level document. */
+    top(): S;
+    /**
+     * Runs `pageScript` in the site's document with these arguments and returns
+     * its reply. Under WebDriver Classic, `classicScript()` is the body to send.
+     */
+    run(site: S, args: PageScriptArgs): Promise<unknown>;
+    /** Evaluates the resolver's injectable source in the site's document. */
+    inject(site: S, source: string): Promise<void>;
+    /** An element the page script returned, as the client's own element. */
+    element(site: S, ref: ElementRef): Promise<E>;
+    /**
+     * Enters `iframe`, an element of `site`'s document, and returns the site for
+     * the frame's document, at `origin` in the top-level viewport.
+     */
+    enterFrame(site: S, iframe: E, origin: Point): Promise<S>;
+    /**
+     * Undoes what entering frames changed in the session — under Classic, switches
+     * back to the top-level document. Called once after a walk that entered any.
+     */
+    leaveFrames(): Promise<void>;
+    /** Hears the top-level document's URL, which every call there brings back. */
+    sawUrl?(url: string): void;
+}
+/**
+ * The page script as a classic Execute Script body, which awaits the promise
+ * the script returns.
+ */
+export declare function classicScript(): string;
+/**
+ * Runs one operation of the shared resolver in a document, injecting the
+ * resolver first if the document does not have it yet.
+ *
+ * The presence check rides along with the call itself, so a document that
+ * already has the resolver pays one round-trip, not two. Injecting happens once
+ * per document: navigation replaces the window, and the resolver with it.
+ */
+export declare function callPage<S extends WebDriverSite, E>(driver: WebDriverLike<S, E>, site: S, op: PageOp, scope: readonly Selector[], selector: Selector, timeout: number, arg?: string | null): Promise<unknown>;
+/** A non-waiting walk found a frame link that is not on screen. */
+export declare class FrameAbsent extends Error {
+    name: string;
+}
+/** What the page reports about an iframe a walk is about to enter. */
+export interface FrameInfo {
+    /** Whether the iframe is visible by layout in its own document. */
+    readonly visible: boolean;
+}
+export interface WalkOptions<E> {
+    /** Wait for each frame link, or answer at once by throwing FrameAbsent. */
+    waiting: boolean;
+    /** The budget for every hop and the operation together. */
+    timeout: number;
+    /** Called with each iframe element, from its own document, before entering it. */
+    onFrame?: (iframe: E, info: FrameInfo) => Promise<void>;
+}
+/**
+ * Walks the scope chain's frame links, entering each frame, then runs the
+ * operation in the innermost document with the links that remain.
+ *
+ * A WebDriver element belongs to one document: an element inside a frame cannot
+ * be acted on from the top-level one, even where the page's own script could
+ * reach it. So the shared resolver runs once per document — up to the iframe,
+ * then inside it — and WebDriver does the crossing. That is also why
+ * cross-origin frames work here, where an in-page resolver cannot enter them.
+ *
+ * Whatever entering changed in the session is undone afterwards, whatever
+ * happened (`leaveFrames`).
+ */
+export declare function walk<S extends WebDriverSite, E, T>(driver: WebDriverLike<S, E>, scope: readonly Selector[], options: WalkOptions<E>, operation: (site: S, scope: Selector[], remaining: () => number) => Promise<T>): Promise<T>;
+//# sourceMappingURL=webdriver.d.ts.map

package/dist/webdriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webdriver.d.ts","sourceRoot":"","sources":["../src/webdriver.ts"],"names":[],"mappings":"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"}