craftdriver 0.0.3 → 0.2.0

package/dist/lib/elementHandle.js

@@ -1,88 +1,263 @@
+import { By } from './by.js';
 import { until } from './wait.js';
 import fs from 'fs/promises';
 import { expectSelector } from './expect.js';
 import { getKeyValue } from './keys.js';
+import { A11y } from './a11y.js';
 export class ElementHandle {
     driver;
     by;
-    constructor(driver, by) {
+    getDefaultTimeout;
+    /** Set only for snapshot handles created via `ElementHandle.fromWebElement()`. */
+    _webElement;
+    /** Optional context switcher for frame/window scoping. */
+    _contextSwitcher;
+    constructor(driver, by, 
+    /** Returns the browser-level default timeout so per-call opts can fall back to it. */
+    getDefaultTimeout = () => 5000) {
         this.driver = driver;
         this.by = by;
+        this.getDefaultTimeout = getDefaultTimeout;
+    }
+    /**
+     * Bind this handle to a browsing context (iframe or tab).
+     * Element resolution will switch into the context before finding and switch out after.
+     */
+    withContext(switcher) {
+        this._contextSwitcher = switcher;
+        return this;
+    }
+    async _withContext(fn) {
+        if (this._contextSwitcher) {
+            await this._contextSwitcher.in();
+            try {
+                return await fn();
+            }
+            finally {
+                await this._contextSwitcher.out();
+            }
+        }
+        return fn();
+    }
+    /**
+     * Create a snapshot `ElementHandle` backed by an already-resolved WebElement.
+     * Used by `Locator.all()` and `Browser.findAll()`.
+     */
+    static fromWebElement(driver, webElement, getDefaultTimeout) {
+        const handle = new ElementHandle(driver, By.css('*'), getDefaultTimeout);
+        handle._webElement = webElement;
+        return handle;
+    }
+    /** Resolve to a located (not necessarily visible) WebElement. */
+    async _resolveLocated(options) {
+        if (this._webElement)
+            return this._webElement;
+        return this.driver.wait(until.elementLocated(this.by), {
+            timeout: options?.timeout ?? this.getDefaultTimeout(),
+        });
+    }
+    /** Resolve to a visible WebElement. */
+    async _resolveVisible(options) {
+        if (this._webElement)
+            return this._webElement;
+        return this.driver.wait(until.elementIsVisible(this.by), {
+            timeout: options?.timeout ?? this.getDefaultTimeout(),
+        });
     }
     async click(options) {
-        const el = await this.driver.wait(until.elementIsVisible(this.by), { timeout: options?.timeout ?? 5000 });
-        await el.click();
+        return this._withContext(async () => {
+            const el = await this._resolveVisible(options);
+            await el.click();
+        });
     }
     async fill(text, options) {
-        const el = await this.driver.wait(until.elementIsVisible(this.by), {
-            timeout: options?.timeout ?? 5000,
+        return this._withContext(async () => {
+            const el = await this._resolveVisible(options);
+            await el.click();
+            await el.clear();
+            await el.sendKeys(text);
         });
-        await el.click();
-        await el.clear();
-        await el.sendKeys(text);
     }
     async clear(options) {
-        const el = await this.driver.wait(until.elementIsVisible(this.by), {
-            timeout: options?.timeout ?? 5000,
+        return this._withContext(async () => {
+            const el = await this._resolveVisible(options);
+            await el.clear();
         });
-        await el.clear();
     }
     async press(key, options) {
-        // assumes element is focused after click/type; ensure focus by clicking first
-        const el = await this.driver.wait(until.elementIsVisible(this.by), { timeout: options?.timeout ?? 5000 });
-        await el.click();
-        const code = getKeyValue(key);
-        await this.driver.keyPressCode(code, 1);
-    }
-    async screenshot(path, options) {
-        const el = await this.driver.wait(until.elementIsVisible(this.by), { timeout: options?.timeout ?? 5000 });
-        const b64 = await el.screenshotBase64();
-        const buf = Buffer.from(b64, 'base64');
-        if (path)
-            await fs.writeFile(path, buf);
-        return buf;
+        return this._withContext(async () => {
+            const el = await this._resolveVisible(options);
+            await el.click();
+            const code = getKeyValue(key);
+            await this.driver.keyPressCode(code, 1);
+        });
+    }
+    /**
+     * Capture a screenshot of just this element. Optionally writes the PNG
+     * to `opts.path`. Returns the raw PNG buffer.
+     *
+     * @example
+     * const buf = await browser.find('#chart').screenshot();
+     * await browser.find('#logo').screenshot({ path: 'logo.png' });
+     */
+    async screenshot(opts) {
+        return this._withContext(async () => {
+            const el = await this._resolveVisible(opts);
+            const b64 = await el.screenshotBase64();
+            const buf = Buffer.from(b64, 'base64');
+            if (opts?.path)
+                await fs.writeFile(opts.path, buf);
+            return buf;
+        });
     }
     async text(options) {
-        const el = await this.driver.wait(until.elementLocated(this.by), { timeout: options?.timeout ?? 5000 });
-        return await el.getText();
+        return this._withContext(async () => {
+            const el = await this._resolveLocated(options);
+            return el.getText();
+        });
     }
     async value(options) {
-        const el = await this.driver.wait(until.elementLocated(this.by), { timeout: options?.timeout ?? 5000 });
-        const val = await el.getProperty('value');
-        return String(val ?? '');
+        return this._withContext(async () => {
+            const el = await this._resolveLocated(options);
+            const val = await el.getProperty('value');
+            return String(val ?? '');
+        });
+    }
+    async tagName(options) {
+        return this._withContext(async () => {
+            const el = await this._resolveLocated(options);
+            return el.getTagName();
+        });
     }
     async getAttribute(name, options) {
-        const el = await this.driver.wait(until.elementLocated(this.by), { timeout: options?.timeout ?? 5000 });
-        return await el.getAttribute(name);
+        return this._withContext(async () => {
+            const el = await this._resolveLocated(options);
+            return el.getAttribute(name);
+        });
     }
     async isVisible(options) {
         try {
-            const el = await this.driver.wait(until.elementLocated(this.by), { timeout: options?.timeout ?? 1000 });
-            return await el.isDisplayed();
+            return await this._withContext(async () => {
+                const timeout = options?.timeout ?? Math.min(this.getDefaultTimeout(), 1000);
+                const el = await this._resolveLocated({ timeout });
+                return el.isDisplayed();
+            });
         }
         catch {
             return false;
         }
     }
     async isEnabled(options) {
-        const el = await this.driver.wait(until.elementLocated(this.by), { timeout: options?.timeout ?? 5000 });
-        return await el.isEnabled();
+        return this._withContext(async () => {
+            const el = await this._resolveLocated(options);
+            return el.isEnabled();
+        });
     }
     async isChecked(options) {
-        const el = await this.driver.wait(until.elementLocated(this.by), { timeout: options?.timeout ?? 5000 });
-        return await el.isSelected();
+        return this._withContext(async () => {
+            const el = await this._resolveLocated(options);
+            return el.isSelected();
+        });
     }
     async boundingBox(options) {
         try {
-            const el = await this.driver.wait(until.elementLocated(this.by), { timeout: options?.timeout ?? 5000 });
-            return await el.getRect();
+            return await this._withContext(async () => {
+                const el = await this._resolveLocated(options);
+                return el.getRect();
+            });
         }
         catch {
             return null;
         }
     }
+    async hover(options) {
+        return this._withContext(async () => {
+            const el = await this._resolveVisible(options);
+            const rect = await el.getRect();
+            const centerX = rect.x + rect.width / 2;
+            const centerY = rect.y + rect.height / 2;
+            await this.driver.pointerMoveTo(undefined, centerX, centerY);
+        });
+    }
+    async select(value, options) {
+        return this._withContext(async () => {
+            const el = await this._resolveLocated(options);
+            const tagName = await el.getTagName();
+            if (tagName !== 'select') {
+                throw new Error(`select() can only be used on <select> elements. Found <${tagName}> instead. ` +
+                    `Use browser.click('#selector option[value="..."]') for other element types.`);
+            }
+            const script = `
+        const select = arguments[0];
+        const value = arguments[1];
+        const option = Array.from(select.options).find(opt => opt.value === value);
+        if (!option) {
+          throw new Error('Option with value "' + value + '" not found in <select>');
+        }
+        select.value = value;
+        select.dispatchEvent(new Event('change', { bubbles: true }));
+        return true;
+      `;
+            await this.driver.executeScript(script, [el, value]);
+        });
+    }
     expect() {
-        return expectSelector(this.driver, this.by);
+        return expectSelector(this.driver, this.by, this.getDefaultTimeout, this._contextSwitcher);
+    }
+    /**
+     * Set the value of an `<input type="file">` element.
+     * Accepts a single path or an array (for `multiple` inputs).
+     * Paths must be absolute and point to existing files.
+     *
+     * @throws if the element is not an `<input type="file">`.
+     */
+    async setInputFiles(filePaths, options) {
+        return this._withContext(async () => {
+            const paths = Array.isArray(filePaths) ? filePaths : [filePaths];
+            const el = await this._resolveLocated(options);
+            const tagName = await el.getTagName();
+            if (tagName.toLowerCase() !== 'input') {
+                throw new Error(`setInputFiles() requires an <input type="file"> element. Found <${tagName}> instead.`);
+            }
+            const type = await el.getAttribute('type');
+            if ((type ?? '').toLowerCase() !== 'file') {
+                throw new Error(`setInputFiles() requires an <input type="file"> element. ` +
+                    `Found <input type="${type ?? ''}"> instead.`);
+            }
+            await el.sendKeys(paths.join('\n'));
+        });
+    }
+    /**
+     * Execute JavaScript in the page with this element as the first argument.
+     *
+     * ```ts
+     * const tag = await browser.find('#btn').evaluate(el => el.tagName);
+     * const text = await browser.find('#btn').evaluate((el, cls) => el.classList.contains(cls), 'active');
+     * ```
+     *
+     * Uses Classic WebDriver `executeScript` so it works with or without BiDi.
+     */
+    async evaluate(fn, ...args) {
+        return this._withContext(async () => {
+            const el = await this._resolveLocated();
+            const fnSrc = fn.toString();
+            return this.driver.executeScript(`return (${fnSrc}).apply(null, arguments)`, [el, ...args]);
+        });
+    }
+    _a11y;
+    /**
+     * Element-scoped accessibility audit via axe-core.
+     * The audit is restricted to this element and its descendants.
+     */
+    get a11y() {
+        if (!this._a11y) {
+            this._a11y = new A11y({
+                driver: this.driver,
+                resolveTarget: () => this._resolveLocated(),
+                withContext: (fn) => this._withContext(fn),
+            });
+        }
+        return this._a11y;
     }
 }
 //# sourceMappingURL=elementHandle.js.map

package/dist/lib/elementHandle.js.map

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

package/dist/lib/errors.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Stable, machine-readable error codes for the public craftdriver API.
+ *
+ * Agents (CLI, MCP, in-process recovery loops) match on `code`, not on
+ * prose. Every public throw site should produce a `CraftdriverError`
+ * carrying one of these codes plus optional `detail`.
+ *
+ * Codes are documented in [docs/error-codes.md](../../docs/error-codes.md).
+ * Never repurpose a code; add a new one instead.
+ */
+export declare const ErrorCode: {
+    /** Selector matched zero elements at t=0. Fix the selector. */
+    readonly NO_MATCH: "NO_MATCH";
+    /** Selector matched, but element never became visible within timeout. */
+    readonly TIMEOUT_WAITING_VISIBLE: "TIMEOUT_WAITING_VISIBLE";
+    /** Element visible, but never reached requested state (enabled, checked, attached/detached, hidden). */
+    readonly TIMEOUT_WAITING_STATE: "TIMEOUT_WAITING_STATE";
+    /** Page never reached the requested load state within timeout. */
+    readonly TIMEOUT_WAITING_LOAD: "TIMEOUT_WAITING_LOAD";
+    /** Network idle / specific request / response not seen within timeout. */
+    readonly TIMEOUT_WAITING_NETWORK: "TIMEOUT_WAITING_NETWORK";
+    /** Dialog of the requested type did not appear within timeout. */
+    readonly TIMEOUT_WAITING_DIALOG: "TIMEOUT_WAITING_DIALOG";
+    /** Generic timeout where no more specific code applies. */
+    readonly TIMEOUT: "TIMEOUT";
+    /** An `expect(...)` assertion failed after auto-waiting. */
+    readonly EXPECT_MISMATCH: "EXPECT_MISMATCH";
+    /** Accessibility audit returned one or more violations. */
+    readonly A11Y_VIOLATIONS: "A11Y_VIOLATIONS";
+    /** evaluate() callback threw inside the page. */
+    readonly EVAL_THREW: "EVAL_THREW";
+    /** Argument passed to evaluate() / addInitScript() was not JSON-serializable. */
+    readonly EVAL_BAD_ARG: "EVAL_BAD_ARG";
+    /** Caller passed an invalid argument (bad enum value, wrong shape, etc.). */
+    readonly INVALID_ARGUMENT: "INVALID_ARGUMENT";
+    /** Feature exists but is not available on this browser/transport (e.g. Chromium-only over Firefox). */
+    readonly UNSUPPORTED: "UNSUPPORTED";
+    /** Method called in an invalid state (e.g. `clock.tick()` before `install()`). */
+    readonly STATE_INVALID: "STATE_INVALID";
+    /** Driver-level / transport-level failure surfaced to the caller. */
+    readonly DRIVER_ERROR: "DRIVER_ERROR";
+};
+export type ErrorCodeName = keyof typeof ErrorCode;
+export type ErrorCodeValue = (typeof ErrorCode)[ErrorCodeName];
+export interface CraftdriverErrorOptions {
+    /** Structured, JSON-serializable context for agents. */
+    detail?: Record<string, unknown>;
+    /** Optional underlying cause (preserved as `error.cause`). */
+    cause?: unknown;
+    /** Optional one-line remediation hint shown after the message. */
+    hint?: string;
+}
+/**
+ * Base class for every error thrown from the public API.
+ *
+ * - `code` is the stable machine identifier (see `ErrorCode`).
+ * - `detail` is a JSON-serializable object with structured context
+ *   (selector, timeout, candidates, etc.). Agents read this directly.
+ * - `hint` is a one-line remediation suggestion. Optional.
+ *
+ * `instanceof Error` remains `true`; existing catch sites keep working.
+ */
+export declare class CraftdriverError extends Error {
+    readonly code: ErrorCodeValue;
+    readonly detail?: Record<string, unknown>;
+    readonly hint?: string;
+    constructor(code: ErrorCodeValue, message: string, options?: CraftdriverErrorOptions);
+    /** Type guard: does this error carry the given code? */
+    static is(err: unknown, code?: ErrorCodeValue): err is CraftdriverError;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS;IACpB,+DAA+D;;IAE/D,yEAAyE;;IAEzE,wGAAwG;;IAExG,kEAAkE;;IAElE,0EAA0E;;IAE1E,kEAAkE;;IAElE,2DAA2D;;IAE3D,4DAA4D;;IAE5D,2DAA2D;;IAE3D,iDAAiD;;IAEjD,iFAAiF;;IAEjF,6EAA6E;;IAE7E,uGAAuG;;IAEvG,kFAAkF;;IAElF,qEAAqE;;CAE7D,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,SAAS,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;AAE/D,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB;IAQpF,wDAAwD;IACxD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,GAAG,IAAI,gBAAgB;CAIxE"}

package/dist/lib/errors.js

@@ -0,0 +1,73 @@
+/**
+ * Stable, machine-readable error codes for the public craftdriver API.
+ *
+ * Agents (CLI, MCP, in-process recovery loops) match on `code`, not on
+ * prose. Every public throw site should produce a `CraftdriverError`
+ * carrying one of these codes plus optional `detail`.
+ *
+ * Codes are documented in [docs/error-codes.md](../../docs/error-codes.md).
+ * Never repurpose a code; add a new one instead.
+ */
+export const ErrorCode = {
+    /** Selector matched zero elements at t=0. Fix the selector. */
+    NO_MATCH: 'NO_MATCH',
+    /** Selector matched, but element never became visible within timeout. */
+    TIMEOUT_WAITING_VISIBLE: 'TIMEOUT_WAITING_VISIBLE',
+    /** Element visible, but never reached requested state (enabled, checked, attached/detached, hidden). */
+    TIMEOUT_WAITING_STATE: 'TIMEOUT_WAITING_STATE',
+    /** Page never reached the requested load state within timeout. */
+    TIMEOUT_WAITING_LOAD: 'TIMEOUT_WAITING_LOAD',
+    /** Network idle / specific request / response not seen within timeout. */
+    TIMEOUT_WAITING_NETWORK: 'TIMEOUT_WAITING_NETWORK',
+    /** Dialog of the requested type did not appear within timeout. */
+    TIMEOUT_WAITING_DIALOG: 'TIMEOUT_WAITING_DIALOG',
+    /** Generic timeout where no more specific code applies. */
+    TIMEOUT: 'TIMEOUT',
+    /** An `expect(...)` assertion failed after auto-waiting. */
+    EXPECT_MISMATCH: 'EXPECT_MISMATCH',
+    /** Accessibility audit returned one or more violations. */
+    A11Y_VIOLATIONS: 'A11Y_VIOLATIONS',
+    /** evaluate() callback threw inside the page. */
+    EVAL_THREW: 'EVAL_THREW',
+    /** Argument passed to evaluate() / addInitScript() was not JSON-serializable. */
+    EVAL_BAD_ARG: 'EVAL_BAD_ARG',
+    /** Caller passed an invalid argument (bad enum value, wrong shape, etc.). */
+    INVALID_ARGUMENT: 'INVALID_ARGUMENT',
+    /** Feature exists but is not available on this browser/transport (e.g. Chromium-only over Firefox). */
+    UNSUPPORTED: 'UNSUPPORTED',
+    /** Method called in an invalid state (e.g. `clock.tick()` before `install()`). */
+    STATE_INVALID: 'STATE_INVALID',
+    /** Driver-level / transport-level failure surfaced to the caller. */
+    DRIVER_ERROR: 'DRIVER_ERROR',
+};
+/**
+ * Base class for every error thrown from the public API.
+ *
+ * - `code` is the stable machine identifier (see `ErrorCode`).
+ * - `detail` is a JSON-serializable object with structured context
+ *   (selector, timeout, candidates, etc.). Agents read this directly.
+ * - `hint` is a one-line remediation suggestion. Optional.
+ *
+ * `instanceof Error` remains `true`; existing catch sites keep working.
+ */
+export class CraftdriverError extends Error {
+    code;
+    detail;
+    hint;
+    constructor(code, message, options) {
+        super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);
+        this.name = 'CraftdriverError';
+        this.code = code;
+        if (options?.detail)
+            this.detail = options.detail;
+        if (options?.hint)
+            this.hint = options.hint;
+    }
+    /** Type guard: does this error carry the given code? */
+    static is(err, code) {
+        if (!(err instanceof CraftdriverError))
+            return false;
+        return code === undefined || err.code === code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,+DAA+D;IAC/D,QAAQ,EAAE,UAAU;IACpB,yEAAyE;IACzE,uBAAuB,EAAE,yBAAyB;IAClD,wGAAwG;IACxG,qBAAqB,EAAE,uBAAuB;IAC9C,kEAAkE;IAClE,oBAAoB,EAAE,sBAAsB;IAC5C,0EAA0E;IAC1E,uBAAuB,EAAE,yBAAyB;IAClD,kEAAkE;IAClE,sBAAsB,EAAE,wBAAwB;IAChD,2DAA2D;IAC3D,OAAO,EAAE,SAAS;IAClB,4DAA4D;IAC5D,eAAe,EAAE,iBAAiB;IAClC,2DAA2D;IAC3D,eAAe,EAAE,iBAAiB;IAClC,iDAAiD;IACjD,UAAU,EAAE,YAAY;IACxB,iFAAiF;IACjF,YAAY,EAAE,cAAc;IAC5B,6EAA6E;IAC7E,gBAAgB,EAAE,kBAAkB;IACpC,uGAAuG;IACvG,WAAW,EAAE,aAAa;IAC1B,kFAAkF;IAClF,aAAa,EAAE,eAAe;IAC9B,qEAAqE;IACrE,YAAY,EAAE,cAAc;CACpB,CAAC;AAcX;;;;;;;;;GASG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAiB;IACrB,MAAM,CAA2B;IACjC,IAAI,CAAU;IAEvB,YAAY,IAAoB,EAAE,OAAe,EAAE,OAAiC;QAClF,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,OAAO,EAAE,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAClD,IAAI,OAAO,EAAE,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9C,CAAC;IAED,wDAAwD;IACxD,MAAM,CAAC,EAAE,CAAC,GAAY,EAAE,IAAqB;QAC3C,IAAI,CAAC,CAAC,GAAG,YAAY,gBAAgB,CAAC;YAAE,OAAO,KAAK,CAAC;QACrD,OAAO,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC;IACjD,CAAC;CACF"}

package/dist/lib/expect.d.ts

@@ -1,5 +1,10 @@
 import type { By } from './by.js';
 import type { Driver } from './driver.js';
+/** Context switcher for frame/window scoping — used by Frame and Page. */
+export type ContextSwitcher = {
+    in: () => Promise<void>;
+    out: () => Promise<void>;
+};
 export interface ExpectApi {
     toHaveText(text: string | RegExp, opts?: {
         timeout?: number;
@@ -58,5 +63,5 @@ export interface ExpectApi {
         }): Promise<void>;
     };
 }
-export declare function expectSelector(driver: Driver, by: By): ExpectApi;
+export declare function expectSelector(driver: Driver, by: By, getDefaultTimeout?: () => number, contextSwitcher?: ContextSwitcher): ExpectApi;
 //# sourceMappingURL=expect.d.ts.map

package/dist/lib/expect.d.ts.map

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