@e2e-dev/web 0.11.0-canary-20260928184528

package/dist/read-node.js

@@ -0,0 +1,42 @@
+/**
+ * The wire types of the in-page semantic reader and the page functions
+ * assembled from its source for locator.evaluate, locator.evaluateAll, and
+ * page.evaluate. The reader itself lives in `in-page/read-semantics.ts`; it is
+ * serialized into the page, so every page function here is built from its
+ * source with `new Function` and stays free of module-scope captures.
+ */
+import { readSemanticsFunction } from './in-page/read-semantics.js';
+/**
+ * The one definition of a secure field.
+ *
+ * It is a selector rather than a predicate because it has to be applied from
+ * two sides that cannot share code: the in-page reader matches elements
+ * against it to mark nodes `secure`, and the engine hands the same string to
+ * the screenshot masker. One string means the tree's redaction and the image's
+ * redaction cannot describe different sets of elements, which is what the
+ * runner's pixel-clearance check relies on.
+ */
+export const SECURE_FIELD_SELECTOR = 'input[type="password" i]';
+/**
+ * Walks a whole document from its root element in one in-page call. Built
+ * from the reader's source like the batch reader below, so the caller
+ * evaluates it directly on a page or frame instead of first resolving a
+ * `:root` locator - one fewer protocol round trip per document per capture.
+ */
+export const readDocumentSemanticsFunction = new Function('options', `return (${readSemanticsFunction.toString()})(document.documentElement, options);`);
+/**
+ * Reads every matched element in one in-page round trip. A page function
+ * cannot close over module scope, so the batch function is assembled from the
+ * reader's own source (the same source `evaluate` sends) and is a
+ * self-contained function Playwright serializes and calls with the elements.
+ */
+export const readManySemanticsFunction = new Function('elements', 'options', `return elements.map((element) => (${readSemanticsFunction.toString()})(element, options));`);
+/**
+ * Reads every handle the caller already holds in one round trip, so what is
+ * read and what is later acted on are the same elements by construction rather
+ * than by a second lookup. Evaluated on the first handle so the read runs in
+ * the frame the handles belong to; `page.evaluate` would reject handles taken
+ * inside an iframe.
+ */
+export const readHandlesSemanticsFunction = new Function('_first', 'arg', `return arg.elements.map((element) => (${readSemanticsFunction.toString()})(element, arg.options));`);
+//# sourceMappingURL=read-node.js.map

package/dist/read-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-node.js","sourceRoot":"","sources":["../src/read-node.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AA4GhE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,QAAQ,CACvD,SAAS,EACT,WAAW,qBAAqB,CAAC,QAAQ,EAAE,uCAAuC,CACnC,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,QAAQ,CACnD,UAAU,EACV,SAAS,EACT,qCAAqC,qBAAqB,CAAC,QAAQ,EAAE,uBAAuB,CACJ,CAAC;AAE3F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,QAAQ,CACtD,QAAQ,EACR,KAAK,EACL,yCAAyC,qBAAqB,CAAC,QAAQ,EAAE,2BAA2B,CACa,CAAC"}

package/dist/refs.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Node reference registry for one attempt: the ids the engine mints for
+ * located and observed nodes and the Playwright targets behind them.
+ *
+ * Two populations with different lifetimes live here. Locator-backed refs
+ * from `locate` hold no live handles and are pruned oldest-first past a
+ * bound. Handle-backed refs from `observe` form one generation per
+ * observation: the whole generation is swapped atomically and the superseded
+ * one disposed in a sweep, so locator-ref eviction can never destroy a handle
+ * an in-flight observation still references.
+ */
+import { type EngineSnapshot, type NodeRef } from 'e2e/engine';
+import type { ActionTarget } from './support.ts';
+/** A complete observation and the private handles that back its semantic refs. */
+export interface CapturedObservation {
+    readonly snapshot: EngineSnapshot;
+    readonly generation: Map<string, ActionTarget>;
+}
+export declare class RefRegistry {
+    private counter;
+    private capture;
+    private readonly located;
+    private observation;
+    mintId(): string;
+    /** Reserves ids before a document can stamp them, even if its response never arrives. */
+    reserveIds(count: number): number;
+    /** Stores one located target under a fresh id, pruning the oldest past the bound. */
+    storeLocated(target: ActionTarget): string;
+    /**
+     * Ids are the engine's; revisions are the harness's. The adapter already
+     * rejected a ref from a superseded resolution, so lookup is by id alone.
+     */
+    lookup(ref: NodeRef): ActionTarget;
+    /** Starts a capture, preventing older in-flight observations from publishing afterward. */
+    beginCapture(): number;
+    /** Publishes only the current capture; pixel-only recovery also retires located refs. */
+    publish(capture: number, { snapshot, generation }: CapturedObservation): void;
+    /** Releases every ref of the attempt: located and observed alike. */
+    clear(): void;
+    /** Disposes every element handle in one observation generation. */
+    static dispose(generation: ReadonlyMap<string, ActionTarget>): void;
+}
+//# sourceMappingURL=refs.d.ts.map

package/dist/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../src/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAe,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAKjD,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAChD;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,WAAW,CAAmC;IAEtD,MAAM,IAAI,MAAM,CAGf;IAED,yFAAyF;IACzF,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhC;IAED,qFAAqF;IACrF,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CASzC;IAED;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAMjC;IAED,2FAA2F;IAC3F,YAAY,IAAI,MAAM,CAGrB;IAED,yFAAyF;IACzF,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,mBAAmB,GAAG,IAAI,CAO5E;IAED,qEAAqE;IACrE,KAAK,IAAI,IAAI,CAMZ;IAED,mEAAmE;IACnE,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,IAAI,CAIlE;CACF"}

package/dist/refs.js

@@ -0,0 +1,85 @@
+/**
+ * Node reference registry for one attempt: the ids the engine mints for
+ * located and observed nodes and the Playwright targets behind them.
+ *
+ * Two populations with different lifetimes live here. Locator-backed refs
+ * from `locate` hold no live handles and are pruned oldest-first past a
+ * bound. Handle-backed refs from `observe` form one generation per
+ * observation: the whole generation is swapped atomically and the superseded
+ * one disposed in a sweep, so locator-ref eviction can never destroy a handle
+ * an in-flight observation still references.
+ */
+import { EngineError } from 'e2e/engine';
+/** Located refs are pruned oldest-first past this bound so the map cannot grow unboundedly. */
+const MAX_STORED_REFS = 2048;
+export class RefRegistry {
+    counter = 0;
+    capture = 0;
+    located = new Map();
+    observation = new Map();
+    mintId() {
+        this.counter += 1;
+        return `n${this.counter}`;
+    }
+    /** Reserves ids before a document can stamp them, even if its response never arrives. */
+    reserveIds(count) {
+        const first = this.counter + 1;
+        this.counter += count;
+        return first;
+    }
+    /** Stores one located target under a fresh id, pruning the oldest past the bound. */
+    storeLocated(target) {
+        const id = this.mintId();
+        this.located.set(id, target);
+        for (const [oldest, evicted] of this.located) {
+            if (this.located.size <= MAX_STORED_REFS)
+                break;
+            this.located.delete(oldest);
+            if (evicted.kind === 'element')
+                void evicted.element.dispose().catch(() => undefined);
+        }
+        return id;
+    }
+    /**
+     * Ids are the engine's; revisions are the harness's. The adapter already
+     * rejected a ref from a superseded resolution, so lookup is by id alone.
+     */
+    lookup(ref) {
+        const target = this.located.get(ref.id) ?? this.observation.get(ref.id);
+        if (target === undefined) {
+            throw new EngineError('NODE_STALE', `node reference ${ref.id} is stale`, { retryable: true });
+        }
+        return target;
+    }
+    /** Starts a capture, preventing older in-flight observations from publishing afterward. */
+    beginCapture() {
+        this.capture += 1;
+        return this.capture;
+    }
+    /** Publishes only the current capture; pixel-only recovery also retires located refs. */
+    publish(capture, { snapshot, generation }) {
+        if (capture !== this.capture) {
+            throw new EngineError('NODE_STALE', 'observation capture was superseded', { retryable: true });
+        }
+        if (snapshot.treeUnavailable === true)
+            this.clear();
+        RefRegistry.dispose(this.observation);
+        this.observation = generation;
+    }
+    /** Releases every ref of the attempt: located and observed alike. */
+    clear() {
+        this.capture += 1;
+        RefRegistry.dispose(this.observation);
+        this.observation = new Map();
+        RefRegistry.dispose(this.located);
+        this.located.clear();
+    }
+    /** Disposes every element handle in one observation generation. */
+    static dispose(generation) {
+        for (const target of generation.values()) {
+            if (target.kind === 'element')
+                void target.element.dispose().catch(() => undefined);
+        }
+    }
+}
+//# sourceMappingURL=refs.js.map

package/dist/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../src/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAqC,MAAM,YAAY,CAAC;AAG5E,+FAA+F;AAC/F,MAAM,eAAe,GAAG,IAAI,CAAC;AAQ7B,MAAM,OAAO,WAAW;IACd,OAAO,GAAG,CAAC,CAAC;IACZ,OAAO,GAAG,CAAC,CAAC;IACH,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IACnD,WAAW,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEtD,MAAM;QACJ,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAClB,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IAED,yFAAyF;IACzF,UAAU,CAAC,KAAa;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qFAAqF;IACrF,YAAY,CAAC,MAAoB;QAC/B,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC7B,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7C,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,eAAe;gBAAE,MAAM;YAChD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;gBAAE,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,GAAY;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,kBAAkB,GAAG,CAAC,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChG,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,2FAA2F;IAC3F,YAAY;QACV,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,yFAAyF;IACzF,OAAO,CAAC,OAAe,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAuB;QACpE,IAAI,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,oCAAoC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjG,CAAC;QACD,IAAI,QAAQ,CAAC,eAAe,KAAK,IAAI;YAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QACpD,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED,qEAAqE;IACrE,KAAK;QACH,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAClB,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QAC7B,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,mEAAmE;IACnE,MAAM,CAAC,OAAO,CAAC,UAA6C;QAC1D,KAAK,MAAM,MAAM,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;gBAAE,KAAK,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;CACF"}

package/dist/route-pattern.d.ts

@@ -0,0 +1,13 @@
+/** Route URL pattern grammar. */
+import type { TextPattern } from 'e2e/engine';
+/**
+ * Compiles a string route pattern: `*` matches within one path segment, `**`
+ * crosses `/`, `?` matches one character, `\` escapes the next character;
+ * everything else is literal. Matches against the complete URL.
+ */
+export declare function compileRoutePattern(pattern: string): RegExp;
+/** Matches a URL against a wire TextPattern (string grammar or ECMAScript regexp). */
+export declare function routePatternMatches(pattern: TextPattern, url: string): boolean;
+/** Structural equality for route patterns, used by unroute. */
+export declare function routePatternsEqual(a: TextPattern, b: TextPattern): boolean;
+//# sourceMappingURL=route-pattern.d.ts.map

package/dist/route-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-pattern.d.ts","sourceRoot":"","sources":["../src/route-pattern.ts"],"names":[],"mappings":"AAAA,iCAAiC;AAEjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9C;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0B3D;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAK9E;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAI1E"}

package/dist/route-pattern.js

@@ -0,0 +1,55 @@
+/** Route URL pattern grammar. */
+/** Escapes one character for literal use inside a regexp source. */
+function escapeRegexpChar(ch) {
+    return /[a-zA-Z0-9_-]/.test(ch) ? ch : `\\${ch}`;
+}
+/**
+ * Compiles a string route pattern: `*` matches within one path segment, `**`
+ * crosses `/`, `?` matches one character, `\` escapes the next character;
+ * everything else is literal. Matches against the complete URL.
+ */
+export function compileRoutePattern(pattern) {
+    let source = '^';
+    for (let i = 0; i < pattern.length; i += 1) {
+        const ch = pattern[i];
+        if (ch === '\\') {
+            i += 1;
+            const next = pattern[i];
+            if (next !== undefined)
+                source += escapeRegexpChar(next);
+            continue;
+        }
+        if (ch === '*') {
+            if (pattern[i + 1] === '*') {
+                i += 1;
+                source += '.*';
+            }
+            else {
+                source += '[^/]*';
+            }
+            continue;
+        }
+        if (ch === '?') {
+            source += '.';
+            continue;
+        }
+        source += escapeRegexpChar(ch);
+    }
+    return new RegExp(`${source}$`);
+}
+/** Matches a URL against a wire TextPattern (string grammar or ECMAScript regexp). */
+export function routePatternMatches(pattern, url) {
+    if (pattern.kind === 'string') {
+        return compileRoutePattern(pattern.value).test(url);
+    }
+    return new RegExp(pattern.source, pattern.flags).test(url);
+}
+/** Structural equality for route patterns, used by unroute. */
+export function routePatternsEqual(a, b) {
+    if (a.kind === 'string' && b.kind === 'string')
+        return a.value === b.value;
+    if (a.kind === 'regexp' && b.kind === 'regexp')
+        return a.source === b.source && a.flags === b.flags;
+    return false;
+}
+//# sourceMappingURL=route-pattern.js.map

package/dist/route-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-pattern.js","sourceRoot":"","sources":["../src/route-pattern.ts"],"names":[],"mappings":"AAAA,iCAAiC;AAIjC,oEAAoE;AACpE,SAAS,gBAAgB,CAAC,EAAU;IAClC,OAAO,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,IAAI,MAAM,GAAG,GAAG,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QACvB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,CAAC,IAAI,CAAC,CAAC;YACP,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACxB,IAAI,IAAI,KAAK,SAAS;gBAAE,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACzD,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC3B,CAAC,IAAI,CAAC,CAAC;gBACP,MAAM,IAAI,IAAI,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,OAAO,CAAC;YACpB,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,CAAC;YACd,SAAS;QACX,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,mBAAmB,CAAC,OAAoB,EAAE,GAAW;IACnE,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB,CAAC,CAAc,EAAE,CAAc;IAC/D,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC;IAC3E,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC;IACpG,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/selector-engines.d.ts

@@ -0,0 +1,6 @@
+/** Every selector engine the web engine registers, in a launched browser and in a CDP context alike. */
+export declare const SELECTOR_ENGINES: readonly {
+    readonly name: string;
+    readonly source: string;
+}[];
+//# sourceMappingURL=selector-engines.d.ts.map

package/dist/selector-engines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-engines.d.ts","sourceRoot":"","sources":["../src/selector-engines.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAKxG,eAAO,MAAM,gBAAgB,EAAE,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAGzF,CAAC"}

package/dist/selector-engines.js

@@ -0,0 +1,8 @@
+/** Every selector engine the web engine registers, in a launched browser and in a CDP context alike. */
+import { CLOSED_SHADOW_SELECTOR_ENGINES } from './closed-shadow.js';
+import { EXACT_LABEL_SELECTOR_ENGINE, EXACT_LABEL_SELECTOR_ENGINE_SOURCE } from './label-selector.js';
+export const SELECTOR_ENGINES = [
+    ...CLOSED_SHADOW_SELECTOR_ENGINES,
+    { name: EXACT_LABEL_SELECTOR_ENGINE, source: EXACT_LABEL_SELECTOR_ENGINE_SOURCE },
+];
+//# sourceMappingURL=selector-engines.js.map

package/dist/selector-engines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-engines.js","sourceRoot":"","sources":["../src/selector-engines.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAExG,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AAEtG,MAAM,CAAC,MAAM,gBAAgB,GAAkE;IAC7F,GAAG,8BAA8B;IACjC,EAAE,IAAI,EAAE,2BAA2B,EAAE,MAAM,EAAE,kCAAkC,EAAE;CAClF,CAAC"}

package/dist/support.d.ts

@@ -0,0 +1,147 @@
+/** Shared error translation, filename, and swipe helpers for the Playwright engine. */
+import type { ElementHandle, Locator as PwLocator, Mouse, Page } from 'playwright';
+import { EngineError, type EngineCleanupContext, type Momentum, type ScrollDirection, type ViewportPoint, type ViewportSize } from 'e2e/engine';
+export declare const DEFAULT_VIEWPORT: {
+    readonly width: 1280;
+    readonly height: 720;
+};
+/**
+ * The page's viewport in CSS pixels: the emulated size when one is set, else
+ * the window's, measured in the page, since `viewport: null` follows the
+ * window and Playwright then reports no size of its own.
+ */
+export declare function currentViewport(page: Page): Promise<ViewportSize>;
+/**
+ * A resolved node is addressed either by a deterministic locator expression or
+ * by a live element handle captured during one agent observation. Handles are
+ * always elements: the in-page observation walk records `Element` nodes only.
+ */
+export type ActionTarget = {
+    readonly kind: 'locator';
+    readonly locator: PwLocator;
+} | {
+    readonly kind: 'element';
+    readonly element: ElementHandle<Element>;
+};
+/**
+ * Action surface Locator and ElementHandle share with identical signatures.
+ * Operations whose behavior diverges between the two kinds (bounding box,
+ * evaluate, page ownership, drag) have explicit helpers below so every fork is
+ * visible at its call site instead of hidden behind a uniform interface.
+ */
+type Actionable = Pick<PwLocator, 'click' | 'dblclick' | 'fill' | 'press' | 'check' | 'uncheck' | 'hover' | 'scrollIntoViewIfNeeded' | 'selectOption' | 'setInputFiles'>;
+/** Narrows one action target to the shared Playwright action surface. */
+export declare function asActionable(target: ActionTarget): Actionable;
+/**
+ * Drags one target onto another with the pointer.
+ *
+ * `Locator.dragTo` exists but takes a locator on both sides, and a node the
+ * agent reached through its observed reference is an element handle — which used
+ * to make the whole verb unavailable for exactly the elements that have no
+ * locator: an unlabelled thumbnail, an empty drop zone. Driving the pointer
+ * works for both kinds because a handle has a bounding box like anything else.
+ *
+ */
+export declare function performPointerDrag(source: ActionTarget, destination: ActionTarget, timeout: number): Promise<void>;
+/** A failure's message with terminal control sequences removed. */
+export declare function message(cause: unknown): string;
+/** Constrains a caller-supplied artifact label to a safe filename. */
+export declare function sanitizeFilename(name: string): string;
+export declare function isPwTimeout(cause: unknown): boolean;
+export declare function invalidState(text: string): EngineError;
+export declare function cancelled(text: string): EngineError;
+/**
+ * Holds one error raised on a path nobody awaits - a native dialog nobody
+ * handled, a route handler that broke its contract - until the next step
+ * enters the surface, which then fails with the real cause, or until the
+ * attempt settles when no step follows. Rethrows once: the failure belongs
+ * to the step that observes it, not to every later one.
+ */
+export declare class ErrorLatch {
+    private pending;
+    private readonly running;
+    private abandoned;
+    /** Latches an error; the first one wins until it is thrown. Dropped once `settle` gave up on a handler. */
+    latch(error: Error): void;
+    /** Tracks one unawaited `kind` of path (a route or dialog handler) until it settles, so `settle` can wait for it. Its own rejection is the caller's to latch. */
+    track(kind: string, work: Promise<void>): void;
+    /**
+     * Rethrows the latched error once; with none latched yet, first waits,
+     * within the budget, for the tracked paths running when it was called. One
+     * of those that outlives the budget fails closed: `CLEANUP_TIMEOUT` naming
+     * it, and whatever it throws afterwards is dropped here on purpose rather
+     * than landing on a verdict already reached. A path that starts during the
+     * wait is left to the next settle.
+     */
+    settle(budget: EngineCleanupContext): Promise<void>;
+    /** Rethrows the latched error once, if any. */
+    throwPending(): void;
+}
+/**
+ * True for an error that already carries its classification: an `EngineError`
+ * or a runner error (policy, validation, timeout) from any module copy. Those
+ * must cross the boundary untouched; re-wrapping one would turn a
+ * `POLICY_DENIED` into an infrastructure failure.
+ */
+export declare function isClassified(cause: unknown): cause is Error;
+/**
+ * True for a `TestError` carrying `code`, from this module copy or another.
+ * A matcher that reads a node it may be early for asks this before deciding
+ * whether the miss is one more poll or the assertion's failure.
+ */
+export declare function isTestErrorCode(cause: unknown, code: string): cause is Error & {
+    readonly code: string;
+};
+/**
+ * How a Playwright failure maps onto the error contract. Every translator in
+ * this package and in `actions.ts` follows this table:
+ *
+ * | Playwright failure                                              | Code                      |
+ * | --------------------------------------------------------------- | ------------------------- |
+ * | already an EngineError / runner error                           | passed through untouched  |
+ * | `TimeoutError` on a read, navigation, or artifact call          | OPERATION_TIMEOUT         |
+ * | `TimeoutError` on an action, log ends before the input dispatch | NOT_ACTIONABLE            |
+ * | `TimeoutError` on an action, log shows the dispatch started     | ACTION_MAY_HAVE_COMMITTED |
+ * | element detached / not attached / no element / resolved hidden  | NODE_STALE (retryable)    |
+ * | execution context destroyed / frame detached by a navigation    | NODE_STALE (retryable)    |
+ * | not an input / not editable / not checkable                     | NOT_ACTIONABLE            |
+ * | strict mode violation, anything else                            | ENGINE_FAILURE           |
+ *
+ * The action split is read from the call log Playwright appends to a timeout
+ * message: `performing <x> action`, `<x> action done`, and `waiting for
+ * scheduled navigations to finish` are only logged once the input is being (or
+ * has been) dispatched, so a timeout whose log reaches them is uncertain and
+ * the harness must not blindly repeat it. Every earlier line (`waiting for
+ * element to be visible, enabled and stable`, `scrolling into view if
+ * needed`, `retrying <x> action`) precedes dispatch and is a plain
+ * actionability miss.
+ */
+export declare const POST_DISPATCH_PATTERN: RegExp;
+/** Translates an unexpected Playwright error at the contract boundary. */
+export declare function translatePwError(cause: unknown, operation: string): Error;
+/**
+ * Like translatePwError, but a read that lost its document to a navigation
+ * becomes retryable NODE_STALE so the runner re-reads the new document instead
+ * of failing the call. Timeouts keep their meaning: an observation that cannot
+ * be captured in time is not a race.
+ */
+export declare function navigationStaleOr(cause: unknown, operation: string): Error;
+/**
+ * Like translatePwError, but detachment/miss failures become retryable
+ * NODE_STALE. A timeout stays a timeout: `locate` resolves once and never
+ * waits, so a `TimeoutError` there is a budget that ran out, not a miss.
+ */
+export declare function staleOr(cause: unknown, operation: string): Error;
+export declare function performViewportSwipe(page: Page, direction: ScrollDirection, momentum: Momentum): Promise<void>;
+/**
+ * The browser truncates a fractional pointer coordinate, so a point composed
+ * from a fractional box (`tap({ position })` on a node at y 148.875) would
+ * land on the pixel before the one asked for; it is rounded to the nearest
+ * CSS pixel instead.
+ */
+export declare function nearestPixel(point: ViewportPoint): ViewportPoint;
+/** A pointer drag from one viewport point to another, on whole pixels, with an intermediate move so drag handlers see motion. */
+export declare function performPointDrag(mouse: Mouse, start: ViewportPoint, end: ViewportPoint): Promise<void>;
+export declare function performElementSwipe(target: ActionTarget, direction: ScrollDirection, momentum: Momentum, timeout: number): Promise<void>;
+export {};
+//# sourceMappingURL=support.d.ts.map

package/dist/support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../src/support.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,IAAI,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,WAAW,EAAuB,KAAK,oBAAoB,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAGrK,eAAO,MAAM,gBAAgB;aAAK,KAAK,EAAE,IAAI;aAAE,MAAM,EAAE,GAAG;CAAW,CAAC;AAEtE;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAIvE;AAeD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AAS3E;;;;;GAKG;AACH,KAAK,UAAU,GAAG,IAAI,CACpB,SAAS,EACP,OAAO,GACP,UAAU,GACV,MAAM,GACN,OAAO,GACP,OAAO,GACP,SAAS,GACT,OAAO,GACP,wBAAwB,GACxB,cAAc,GACd,eAAe,CAClB,CAAC;AAEF,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAE7D;AA8BD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,YAAY,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA0Df;AAMD,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG9C;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAEtD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAEnD;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,SAAS,CAAS;IAE1B,2GAA2G;IAC3G,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAGxB;IAED,iKAAiK;IACjK,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAI7C;IAED;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxD;IAED,+CAA+C;IAC/C,YAAY,IAAI,IAAI,CAMnB;CACF;AAgBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAI3D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,IAAI,KAAK,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAExG;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,qBAAqB,QACoD,CAAC;AAEvF,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAYzE;AAiBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAQ1E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAOhE;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAEhE;AAED,iIAAiI;AACjI,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5G;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAiBf"}