@e2edev/web 0.11.0-canary-20260921180210

package/dist/cdp-recovery.js

@@ -0,0 +1,84 @@
+import { EngineError } from 'e2e/engine';
+import { connectCdp } from './browser-connection.js';
+import { registerCdpSelectors, requireCdpShadowTracking } from './cdp-selectors.js';
+import { connectionAbort } from './operation-budget.js';
+/** A failed reconnect must never quietly provision another session. */
+export function recoveryFailed(detail) {
+    return new EngineError('ENGINE_FAILURE', `CDP recovery failed: ${detail}`, { retryable: false });
+}
+/** Reads protocol identity, independent of URL, document contents, and tab order. */
+export async function targetIdentity(page) {
+    const session = await page.context().newCDPSession(page);
+    try {
+        return (await session.send('Target.getTargetInfo')).targetInfo;
+    }
+    finally {
+        await session.detach().catch(() => undefined);
+    }
+}
+/** Owns an uncommitted connection until its identity is proven; aborted and late connections detach. */
+export async function attachPersistent(resolve, budget, previous) {
+    const { signal } = budget;
+    const deadline = Date.now() + budget.timeoutMs;
+    const check = () => { if (signal.aborted)
+        throw connectionAbort(signal, 'CDP connection'); };
+    check();
+    const endpoint = await resolve(signal);
+    check();
+    if (typeof endpoint !== 'string' || endpoint.trim() === '')
+        throw recoveryFailed('the endpoint is empty');
+    const remaining = deadline - Date.now();
+    if (remaining <= 0)
+        throw new EngineError('OPERATION_TIMEOUT', 'CDP connection timed out', { retryable: false });
+    const browser = await connectCdp(endpoint, remaining);
+    const detach = () => { void browser.close().catch(() => undefined); };
+    signal.addEventListener('abort', detach, { once: true });
+    try {
+        check();
+        const session = await browser.newBrowserCDPSession();
+        let contextId;
+        try {
+            const contexts = await session.send('Target.getBrowserContexts');
+            if (contexts.browserContextIds.length > 0) {
+                throw recoveryFailed('the remote browser must contain only its dedicated default context');
+            }
+            contextId = contexts.defaultBrowserContextId;
+        }
+        finally {
+            await session.detach().catch(() => undefined);
+        }
+        check();
+        const context = browser.contexts()[0];
+        if (context === undefined)
+            throw recoveryFailed('the default context is missing');
+        if (contextId === undefined || contextId === '')
+            throw recoveryFailed('the default context identity is unavailable');
+        if (previous !== undefined && contextId !== previous.contextId) {
+            throw recoveryFailed('reconnectEndpoint returned a different browser');
+        }
+        await registerCdpSelectors(context, { signal, timeoutMs: deadline - Date.now() });
+        check();
+        if (previous?.target === undefined)
+            return { browser, context, page: null, identity: { contextId } };
+        for (const page of context.pages()) {
+            const target = await targetIdentity(page);
+            check();
+            if (target.targetId !== previous.target.targetId)
+                continue;
+            if (target.browserContextId !== previous.target.browserContextId) {
+                throw recoveryFailed('the original page belongs to a different context');
+            }
+            await requireCdpShadowTracking(page, { signal, timeoutMs: deadline - Date.now() });
+            return { browser, context, page, identity: { contextId, target } };
+        }
+        throw recoveryFailed('the original page no longer exists');
+    }
+    catch (cause) {
+        await browser.close().catch(() => undefined);
+        throw cause;
+    }
+    finally {
+        signal.removeEventListener('abort', detach);
+    }
+}
+//# sourceMappingURL=cdp-recovery.js.map

package/dist/cdp-recovery.js.map

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

package/dist/cdp-selectors.d.ts

@@ -0,0 +1,14 @@
+/** Registers the closed-root masking selector in a CDP default context. */
+import type { BrowserContext, Page } from 'playwright';
+import { type ConnectionBudget } from './operation-budget.ts';
+/**
+ * Playwright 1.63 seeds custom selectors only in newly created contexts, not
+ * the persistent context returned by connectOverCDP. Its public register API
+ * rejects an already registered name before reaching that context. Use the
+ * same context channel as selectors.register, without allocating global names
+ * on every reconnect. Missing channel support must prevent masked capture.
+ */
+export declare function registerCdpSelectors(context: BrowserContext, budget: ConnectionBudget): Promise<void>;
+/** Existing closed roots cannot be recovered if their document loaded without the tracking hook. */
+export declare function requireCdpShadowTracking(page: Page, budget: ConnectionBudget): Promise<void>;
+//# sourceMappingURL=cdp-selectors.d.ts.map

package/dist/cdp-selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-selectors.d.ts","sourceRoot":"","sources":["../src/cdp-selectors.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAU/E;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB3G;AAED,oGAAoG;AACpG,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CASlG"}

package/dist/cdp-selectors.js

@@ -0,0 +1,48 @@
+/** Registers the closed-root masking selector in a CDP default context. */
+import { EngineError } from 'e2e/engine';
+import { connectionAbort } from './operation-budget.js';
+import { CLOSED_SHADOW_ROOTS_KEY, CLOSED_SHADOW_SELECTOR_ENGINE, CLOSED_SHADOW_SELECTOR_ENGINE_SOURCE } from './read-node.js';
+/**
+ * Playwright 1.63 seeds custom selectors only in newly created contexts, not
+ * the persistent context returned by connectOverCDP. Its public register API
+ * rejects an already registered name before reaching that context. Use the
+ * same context channel as selectors.register, without allocating global names
+ * on every reconnect. Missing channel support must prevent masked capture.
+ */
+export async function registerCdpSelectors(context, budget) {
+    if (budget.signal.aborted)
+        throw connectionAbort(budget.signal, 'CDP selector registration');
+    if (budget.timeoutMs <= 0) {
+        throw new EngineError('OPERATION_TIMEOUT', 'CDP selector registration timed out', { retryable: false });
+    }
+    const channel = Reflect.get(context, '_channel');
+    const register = channel !== null && typeof channel === 'object' ? Reflect.get(channel, 'registerSelectorEngine') : undefined;
+    if (typeof register !== 'function') {
+        throw new EngineError('UNSUPPORTED_CAPABILITY', 'this Playwright version cannot install secure-field masks in the CDP context', { retryable: false });
+    }
+    try {
+        await channel.registerSelectorEngine({ selectorEngine: {
+                name: CLOSED_SHADOW_SELECTOR_ENGINE,
+                source: `(${CLOSED_SHADOW_SELECTOR_ENGINE_SOURCE})(undefined)`,
+                contentScript: false,
+            } }, { timeout: budget.timeoutMs, signal: budget.signal });
+    }
+    catch (cause) {
+        // A version that seeds CDP contexts already has our process-wide registration.
+        const duplicate = `"${CLOSED_SHADOW_SELECTOR_ENGINE}" selector engine has been already registered`;
+        if (!(cause instanceof Error) || !cause.message.endsWith(duplicate))
+            throw cause;
+    }
+}
+/** Existing closed roots cannot be recovered if their document loaded without the tracking hook. */
+export async function requireCdpShadowTracking(page, budget) {
+    if (budget.signal.aborted)
+        throw connectionAbort(budget.signal, 'CDP tracking verification');
+    const tracked = await Promise.all(page.frames().map((frame) => frame.evaluate((key) => Reflect.get(globalThis, Symbol.for(key)) instanceof WeakMap, CLOSED_SHADOW_ROOTS_KEY)));
+    if (budget.signal.aborted)
+        throw connectionAbort(budget.signal, 'CDP tracking verification');
+    if (tracked.some((present) => !present)) {
+        throw new EngineError('ENGINE_FAILURE', 'CDP recovery failed: secure-field tracking is unavailable after a document changed while disconnected', { retryable: false });
+    }
+}
+//# sourceMappingURL=cdp-selectors.js.map

package/dist/cdp-selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-selectors.js","sourceRoot":"","sources":["../src/cdp-selectors.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAG3E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAyB,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,oCAAoC,EAAE,MAAM,gBAAgB,CAAC;AAS9H;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAuB,EAAE,MAAwB;IAC1F,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IAC7F,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,WAAW,CAAC,mBAAmB,EAAE,qCAAqC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,MAAM,OAAO,GAAY,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9H,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,WAAW,CAAC,wBAAwB,EAAE,8EAA8E,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACxJ,CAAC;IACD,IAAI,CAAC;QACH,MAAO,OAA2B,CAAC,sBAAsB,CAAC,EAAE,cAAc,EAAE;gBAC1E,IAAI,EAAE,6BAA6B;gBACnC,MAAM,EAAE,IAAI,oCAAoC,cAAc;gBAC9D,aAAa,EAAE,KAAK;aACrB,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+EAA+E;QAC/E,MAAM,SAAS,GAAG,IAAI,6BAA6B,+CAA+C,CAAC;QACnG,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,MAAM,KAAK,CAAC;IACnF,CAAC;AACH,CAAC;AAED,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAU,EAAE,MAAwB;IACjF,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IAC7F,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC5D,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,YAAY,OAAO,EAAE,uBAAuB,CAAC,CAC9G,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IAC7F,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,WAAW,CAAC,gBAAgB,EAAE,uGAAuG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACzK,CAAC;AACH,CAAC"}

package/dist/dialogs.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Native dialog routing for one attempt. Handlers are registered by the `web`
+ * fixture; the surface owns the router so a dialog that fires before a test
+ * ever touches `web` is still accounted for instead of silently dismissed.
+ */
+import type { Dialog as PwDialog } from 'playwright';
+import { ErrorLatch } from './support.ts';
+/** A native dialog as a test's handler sees it. */
+export interface Dialog {
+    /** The dialog's text. */
+    readonly message: string;
+    /** Accepts the dialog once. */
+    accept(text?: string): Promise<void>;
+    /** Dismisses the dialog once. */
+    dismiss(): Promise<void>;
+}
+export type DialogHandler = 'accept' | 'dismiss' | ((dialog: Dialog) => void | Promise<void>);
+export declare class DialogRouter {
+    private readonly latch;
+    private registrations;
+    /**
+     * `latch` is shared with the surface: a dialog failure and a route-handler
+     * failure surface through one check at the next step.
+     */
+    constructor(latch?: ErrorLatch);
+    /**
+     * Registers a handler (the newest wins) and returns its idempotent
+     * unsubscribe. Registrations are tracked by identity, so registering the
+     * same handler twice and unsubscribing once leaves one in place.
+     */
+    add(handler: DialogHandler): () => void;
+    /** Rethrows an error latched by an unhandled or failing dialog handler. */
+    throwPending(): void;
+    /** Routes one native dialog to the newest registered handler. */
+    dispatch(dialog: PwDialog): Promise<void>;
+}
+//# sourceMappingURL=dialogs.d.ts.map

package/dist/dialogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogs.d.ts","sourceRoot":"","sources":["../src/dialogs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,UAAU,EAAW,MAAM,cAAc,CAAC;AAEnD,mDAAmD;AACnD,MAAM,WAAW,MAAM;IACrB,yBAAyB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,iCAAiC;IACjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAM9F,qBAAa,YAAY;IAOX,OAAO,CAAC,QAAQ,CAAC,KAAK;IANlC,OAAO,CAAC,aAAa,CAAsB;IAE3C;;;OAGG;IACH,YAA6B,KAAK,GAAE,UAA6B,EAAI;IAErE;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,IAAI,CAMtC;IAED,2EAA2E;IAC3E,YAAY,IAAI,IAAI,CAEnB;IAED,iEAAiE;IAC3D,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD9C;CACF"}

package/dist/dialogs.js

@@ -0,0 +1,78 @@
+/**
+ * Native dialog routing for one attempt. Handlers are registered by the `web`
+ * fixture; the surface owns the router so a dialog that fires before a test
+ * ever touches `web` is still accounted for instead of silently dismissed.
+ */
+import { EngineError } from 'e2e/engine';
+import { ErrorLatch, message } from './support.js';
+export class DialogRouter {
+    latch;
+    registrations = [];
+    /**
+     * `latch` is shared with the surface: a dialog failure and a route-handler
+     * failure surface through one check at the next step.
+     */
+    constructor(latch = new ErrorLatch()) {
+        this.latch = latch;
+    }
+    /**
+     * Registers a handler (the newest wins) and returns its idempotent
+     * unsubscribe. Registrations are tracked by identity, so registering the
+     * same handler twice and unsubscribing once leaves one in place.
+     */
+    add(handler) {
+        const registration = { handler };
+        this.registrations.push(registration);
+        return () => {
+            this.registrations = this.registrations.filter((entry) => entry !== registration);
+        };
+    }
+    /** Rethrows an error latched by an unhandled or failing dialog handler. */
+    throwPending() {
+        this.latch.throwPending();
+    }
+    /** Routes one native dialog to the newest registered handler. */
+    async dispatch(dialog) {
+        const handler = this.registrations.at(-1)?.handler;
+        if (handler === undefined) {
+            this.latch.latch(new EngineError('INVALID_STATE', `unhandled ${dialog.type()} dialog: ${dialog.message()}`, { retryable: false }));
+            await dialog.dismiss().catch(() => undefined);
+            return;
+        }
+        let decided = false;
+        const publicDialog = {
+            message: dialog.message(),
+            accept: async (text) => {
+                decided = true;
+                await dialog.accept(text);
+            },
+            dismiss: async () => {
+                decided = true;
+                await dialog.dismiss();
+            },
+        };
+        try {
+            if (handler === 'accept')
+                await dialog.accept();
+            else if (handler === 'dismiss')
+                await dialog.dismiss();
+            else {
+                await handler(publicDialog);
+                // A dialog left open blocks the page, and the failure would surface
+                // later as an unrelated action timeout. The handler contract is the
+                // same as a route handler's: decide, or the step fails naming you.
+                if (!decided) {
+                    await dialog.dismiss().catch(() => undefined);
+                    this.latch.latch(new EngineError('INVALID_STATE', `dialog handler returned without calling accept or dismiss for ${dialog.type()} dialog: ${dialog.message()}`, { retryable: false }));
+                }
+            }
+        }
+        catch (cause) {
+            this.latch.latch(new EngineError('ENGINE_FAILURE', `dialog handler failed: ${message(cause)}`, {
+                retryable: false,
+                cause,
+            }));
+        }
+    }
+}
+//# sourceMappingURL=dialogs.js.map

package/dist/dialogs.js.map

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

package/dist/engine.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The Playwright engine for e2e: a browser body built with the
+ * public `defineEngine`, validated by the same rules and graded by the same
+ * capabilities as any other engine. Core imports nothing from here; this
+ * package imports the contract from `e2e/engine` and contributes the `web`
+ * fixture the way a device engine contributes `device`.
+ */
+import type { BrowserContext, Page } from 'playwright';
+import { type EngineHandle } from 'e2e/engine';
+import { type WebOptions } from './surface.ts';
+/**
+ * The live browser objects behind a `web()` handle, for agent-side code
+ * that replaces the toolset wholesale (spec chapter 16) and drives the page with
+ * its own Playwright tooling. Both accessors read the current attempt: the
+ * context exists from `startAttempt`, the page from the first `app.open()` or
+ * `web.goto()`, and either throws `INVALID_STATE` before that. The harness
+ * remains the notary for what it witnesses; a caller here acts out of band.
+ */
+export interface PlaywrightLiveSurface {
+    readonly page: () => Page;
+    readonly context: () => BrowserContext;
+}
+/** The live surface of a handle this module created, or undefined for any other engine. */
+export declare function surfaceOf(engine: EngineHandle): PlaywrightLiveSurface | undefined;
+export declare function web(options?: WebOptions): EngineHandle;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAOL,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAMlE;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,cAAc,CAAC;CACxC;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,qBAAqB,GAAG,SAAS,CAIjF;AAED,wBAAgB,GAAG,CAAC,OAAO,GAAE,UAAe,GAAG,YAAY,CA6E1D"}

package/dist/engine.js

@@ -0,0 +1,166 @@
+/**
+ * The Playwright engine for e2e: a browser body built with the
+ * public `defineEngine`, validated by the same rules and graded by the same
+ * capabilities as any other engine. Core imports nothing from here; this
+ * package imports the contract from `e2e/engine` and contributes the `web`
+ * fixture the way a device engine contributes `device`.
+ */
+import { ConfigurationError, defineEngine, LOCATOR_ACTION_KINDS, POINTER_ACTION_KINDS, obj, } from 'e2e/engine';
+import { createRequire } from 'node:module';
+import { PlaywrightSurface } from './surface.js';
+import { createWebFixture } from './web.js';
+/** Creates one Playwright engine: one browser per worker, one context per attempt. */
+const surfaces = new WeakMap();
+/** The live surface of a handle this module created, or undefined for any other engine. */
+export function surfaceOf(engine) {
+    const surface = surfaces.get(engine);
+    if (surface === undefined)
+        return undefined;
+    return { page: () => surface.requirePage(), context: () => surface.requireContext() };
+}
+export function web(options = {}) {
+    if (options.connect !== undefined && options.browser !== undefined && options.browser !== 'chromium') {
+        throw new ConfigurationError('INVALID_CONFIG', `web({ connect }) requires the chromium browser; CDP attach is chromium-only, got "${options.browser}"`);
+    }
+    if ('allowedOrigins' in options) {
+        throw new ConfigurationError('INVALID_CONFIG', 'web({ allowedOrigins }) is gone: navigation and secret fills are not gated by origin; remove the option');
+    }
+    if (options.headers !== undefined)
+        validateHeaders(options.headers);
+    if (options.basicAuth !== undefined)
+        validateBasicAuth(options.basicAuth);
+    if (options.testIdAttribute !== undefined)
+        validateTestIdAttribute(options.testIdAttribute);
+    const recoverable = options.connect?.reconnectEndpoint !== undefined;
+    if (recoverable && typeof options.connect?.reconnectEndpoint !== 'function') {
+        throw new ConfigurationError('INVALID_CONFIG', 'connect.reconnectEndpoint must be a function');
+    }
+    if (recoverable && (options.headers !== undefined || options.basicAuth !== undefined)) {
+        throw new ConfigurationError('INVALID_CONFIG', 'connect.reconnectEndpoint uses a persistent context; headers and basicAuth require a newly created context');
+    }
+    const surface = new PlaywrightSurface(options);
+    const handle = defineEngine({
+        name: 'web',
+        version: ownVersion(),
+        spiVersion: 1,
+        platform: 'web',
+        prepare: (info) => surface.prepare(info),
+        init: (info) => surface.init(info),
+        startAttempt: (context) => surface.startAttempt(context),
+        endAttempt: (context) => surface.endAttempt(context),
+        dispose: (context) => surface.dispose(context),
+        observe: (operation, observeOptions) => surface.observe(operation, observeOptions),
+        locate: (expression, operation) => surface.locate(expression, operation),
+        perform: (ref, action, operation) => surface.perform(ref, action, operation),
+        // A browser honors every action kind of the contract; `actions.ts` dispatches each.
+        actions: LOCATOR_ACTION_KINDS,
+        // A page takes every pointer action of the contract at a bare point too.
+        performAt: (point, action, operation) => surface.performAt(point, action, operation),
+        pointerActions: POINTER_ACTION_KINDS,
+        keyboard: {
+            type: (text, keyboardOptions, operation) => surface.typeText(text, keyboardOptions, operation),
+            press: (key, operation) => surface.pressKey(key, operation),
+        },
+        app: declaredApp(options),
+        session: {
+            open: (url, operation) => surface.open(url, operation),
+            back: (operation) => surface.back(operation),
+            restart: (operation) => surface.restart(operation),
+            ...(recoverable ? {} : { reset: (operation) => surface.reset(operation) }),
+        },
+        artifacts: {
+            screenshot: (label, operation) => surface.screenshot(label, operation),
+            startTrace: (operation) => surface.startTrace(operation),
+            stopTrace: (operation) => surface.stopTrace(operation),
+            startVideo: (operation) => surface.startVideo(operation),
+            stopVideo: (operation) => surface.stopVideo(operation),
+        },
+        ...(recoverable
+            ? {}
+            : {
+                state: {
+                    capture: (operation) => surface.captureState(operation),
+                    restore: (state, operation) => surface.restoreState(state, operation),
+                },
+            }),
+        fixtures: {
+            web: (context) => createWebFixture(surface, context),
+        },
+    });
+    surfaces.set(handle, surface);
+    return handle;
+}
+/** An HTTP header field name: one or more `token` characters (RFC 9110). */
+const HEADER_NAME = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/;
+/** A control character no HTTP field value may carry; a horizontal tab is the one the grammar allows. */
+// oxlint-disable-next-line no-control-regex -- the control characters are the point
+const FIELD_VALUE_CONTROL = /[\u0000-\u0008\u000A-\u001F\u007F]/;
+/** True for a plain object; the shape both options take. Config runs as JavaScript, so the types alone are no guard. */
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Refuses a header the browser could not send, at config load rather than at
+ * the first request: a name outside the token grammar, a value carrying a
+ * control character (a line break is a header-injection vector), or a value
+ * that is not a string at all.
+ */
+function validateHeaders(headers) {
+    if (!isRecord(headers)) {
+        throw new ConfigurationError('INVALID_CONFIG', 'web({ headers }) must be an object of header name to value');
+    }
+    for (const [name, value] of Object.entries(headers)) {
+        if (!HEADER_NAME.test(name)) {
+            throw new ConfigurationError('INVALID_CONFIG', `web({ headers }) has an invalid header name: "${name}"`);
+        }
+        if (typeof value !== 'string') {
+            throw new ConfigurationError('INVALID_CONFIG', `web({ headers }) header "${name}" must be a string, got ${typeof value}`);
+        }
+        if (FIELD_VALUE_CONTROL.test(value)) {
+            throw new ConfigurationError('INVALID_CONFIG', `web({ headers }) header "${name}" must not contain a control character`);
+        }
+    }
+}
+/** Refuses credentials the browser could not present: a missing field, or a `:` in the user name (RFC 7617). */
+function validateBasicAuth(basicAuth) {
+    if (!isRecord(basicAuth)) {
+        throw new ConfigurationError('INVALID_CONFIG', 'web({ basicAuth }) must be an object with username and password');
+    }
+    const { username, password } = basicAuth;
+    if (typeof username !== 'string' || username === '') {
+        throw new ConfigurationError('INVALID_CONFIG', 'web({ basicAuth }) requires a non-empty username string');
+    }
+    if (username.includes(':')) {
+        throw new ConfigurationError('INVALID_CONFIG', 'web({ basicAuth }) username must not contain ":"');
+    }
+    if (typeof password !== 'string') {
+        throw new ConfigurationError('INVALID_CONFIG', 'web({ basicAuth }) requires a password string');
+    }
+}
+/**
+ * An attribute name the document grammar accepts (XML `Name`, ASCII): a value
+ * outside it could never be on an element, so `getByTestId` would match nothing
+ * and every `testId` query would fail silently.
+ */
+const ATTRIBUTE_NAME = /^[A-Za-z_:][A-Za-z0-9_:.-]*$/;
+/** Refuses a test-id attribute no element could carry, at config load. */
+function validateTestIdAttribute(attribute) {
+    if (typeof attribute !== 'string' || !ATTRIBUTE_NAME.test(attribute)) {
+        throw new ConfigurationError('INVALID_CONFIG', `web({ testIdAttribute }) must be an attribute name such as "data-testid", got ${JSON.stringify(attribute)}`);
+    }
+}
+/** The app-declaration half of the options, so browser knobs never reach the manifest. */
+function declaredApp(options) {
+    const { url, environment, identity, command, readyUrl, services } = options;
+    return obj({ url, environment, identity, command, readyUrl, services });
+}
+/** This package's published version, read through require resolution. */
+function ownVersion() {
+    try {
+        return createRequire(import.meta.url)('../package.json').version;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/evaluation.d.ts

@@ -0,0 +1,11 @@
+type EvaluationResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    message: string;
+};
+/** Compiles the page-side error boundary without evaluating the caller's source in this process. */
+export declare function compileEvaluation(source: string, hasArgument: boolean): (arg: unknown) => Promise<EvaluationResult>;
+export {};
+//# sourceMappingURL=evaluation.d.ts.map

package/dist/evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation.d.ts","sourceRoot":"","sources":["../src/evaluation.ts"],"names":[],"mappings":"AAIA,KAAK,gBAAgB,GACjB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,oGAAoG;AACpG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAoBnH"}

package/dist/evaluation.js

@@ -0,0 +1,27 @@
+/** Separates exceptions thrown by trusted page code from failures of the evaluation transport. */
+import { TestError } from 'e2e/engine';
+import { message } from './support.js';
+/** Compiles the page-side error boundary without evaluating the caller's source in this process. */
+export function compileEvaluation(source, hasArgument) {
+    try {
+        return new Function('arg', `
+      return (async () => {
+        try {
+          return { ok: true, value: await (${source}\n)(${hasArgument ? 'arg' : ''}) };
+        } catch (cause) {
+          let message;
+          try {
+            message = typeof cause?.message === 'string' ? cause.message : String(cause);
+          } catch {
+            message = 'Page evaluation threw an unprintable value';
+          }
+          return { ok: false, message };
+        }
+      })();
+    `);
+    }
+    catch (cause) {
+        throw new TestError('EVALUATE_FAILED', message(cause), { cause });
+    }
+}
+//# sourceMappingURL=evaluation.js.map

package/dist/evaluation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation.js","sourceRoot":"","sources":["../src/evaluation.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAMvC,oGAAoG;AACpG,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,WAAoB;IACpE,IAAI,CAAC;QACH,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE;;;6CAGc,MAAM,OAAO,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;KAW7E,CAAgD,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `@e2edev/web` public surface: the `web()` engine factory, the
+ * `web` fixture types, and a `test` typed with that fixture. Everything else a
+ * test needs (`expect`, `credentials`) comes from `e2e` itself: this package
+ * contributes a surface, it does not re-export the test API.
+ */
+import type { Web } from './web.ts';
+export { web, surfaceOf } from './engine.ts';
+export type { PlaywrightLiveSurface } from './engine.ts';
+export type { WebBasicAuth, WebConnectOptions, WebOptions } from './surface.ts';
+export type { BrowserName } from './browser-connection.ts';
+export type { Dialog, DialogHandler } from './dialogs.ts';
+export type { Cookie, CookieFields, FrameScreen, RouteFulfillResponse, Web, WebExpectation, WebResponse, WebRoute, } from './web.ts';
+/**
+ * `test` typed with this engine's contributed `web` fixture. The same
+ * runtime `test` as `e2e`'s; only the fixture types differ.
+ */
+export declare const test: import("e2e").TestAPI<import("e2e").TestFixtures & {
+    web: Web;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EACV,MAAM,EACN,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,GAAG,EACH,cAAc,EACd,WAAW,EACX,QAAQ,GACT,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,eAAO,MAAM,IAAI;SAAsB,GAAG;EAAK,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * `@e2edev/web` public surface: the `web()` engine factory, the
+ * `web` fixture types, and a `test` typed with that fixture. Everything else a
+ * test needs (`expect`, `credentials`) comes from `e2e` itself: this package
+ * contributes a surface, it does not re-export the test API.
+ */
+import { test as base } from 'e2e';
+export { web, surfaceOf } from './engine.js';
+/**
+ * `test` typed with this engine's contributed `web` fixture. The same
+ * runtime `test` as `e2e`'s; only the fixture types differ.
+ */
+export const test = base.extend();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,MAAM,KAAK,CAAC;AAGnC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAgB7C;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAgB,CAAC"}