craftdriver 0.0.1

package/dist/lib/elementHandle.js

@@ -0,0 +1,46 @@
+import { until } from './wait.js';
+import fs from 'fs/promises';
+import { expectSelector } from './expect.js';
+import { getKeyValue } from './keys.js';
+export class ElementHandle {
+    driver;
+    by;
+    constructor(driver, by) {
+        this.driver = driver;
+        this.by = by;
+    }
+    async click() {
+        const el = await this.driver.wait(until.elementIsVisible(this.by), { timeout: 5000 });
+        await el.click();
+    }
+    async type(text, options) {
+        const el = await this.driver.wait(until.elementIsVisible(this.by), {
+            timeout: options?.timeout ?? 5000,
+        });
+        await el.click();
+        await el.sendKeys(text);
+    }
+    async press(key) {
+        // assumes element is focused after click/type; ensure focus by clicking first
+        const el = await this.driver.wait(until.elementIsVisible(this.by), { timeout: 5000 });
+        await el.click();
+        const code = getKeyValue(key);
+        await this.driver.keyPressCode(code, 1);
+    }
+    async screenshot(path) {
+        const el = await this.driver.wait(until.elementIsVisible(this.by), { timeout: 5000 });
+        const b64 = await el.screenshotBase64();
+        const buf = Buffer.from(b64, 'base64');
+        if (path)
+            await fs.writeFile(path, buf);
+        return buf;
+    }
+    async text() {
+        const el = await this.driver.findElement(this.by);
+        return await el.getText();
+    }
+    expect() {
+        return expectSelector(this.driver, this.by);
+    }
+}
+//# sourceMappingURL=elementHandle.js.map

package/dist/lib/elementHandle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementHandle.js","sourceRoot":"","sources":["../../src/lib/elementHandle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAiB,MAAM,WAAW,CAAC;AAEvD,MAAM,OAAO,aAAa;IAEd;IACA;IAFV,YACU,MAAc,EACd,EAAM;QADN,WAAM,GAAN,MAAM,CAAQ;QACd,OAAE,GAAF,EAAE,CAAI;IACb,CAAC;IAEJ,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACtF,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,OAA8B;QACrD,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YACjE,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI;SAClC,CAAC,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAa;QACvB,8EAA8E;QAC9E,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACtF,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAa;QAC5B,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACtF,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACvC,IAAI,IAAI;YAAE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACxC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClD,OAAO,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM;QACJ,OAAO,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/lib/expect.d.ts

@@ -0,0 +1,17 @@
+import type { By } from './by.js';
+import type { Driver } from './driver.js';
+export interface ExpectApi {
+    toHaveText(text: string | RegExp, opts?: {
+        timeout?: number;
+    }): Promise<void>;
+    toBeVisible(opts?: {
+        timeout?: number;
+    }): Promise<void>;
+    not: {
+        toBeVisible(opts?: {
+            timeout?: number;
+        }): Promise<void>;
+    };
+}
+export declare function expectSelector(driver: Driver, by: By): ExpectApi;
+//# sourceMappingURL=expect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/lib/expect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,WAAW,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,GAAG,EAAE;QACH,WAAW,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACzD,CAAC;CACH;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,SAAS,CAuDhE"}

package/dist/lib/expect.js

@@ -0,0 +1,56 @@
+import { until } from './wait.js';
+export function expectSelector(driver, by) {
+    function fail(message) {
+        throw new Error(message);
+    }
+    const toHaveText = async function toHaveText(expected, opts) {
+        const timeout = opts?.timeout ?? 5000;
+        const deadline = Date.now() + timeout;
+        let last = '';
+        while (Date.now() < deadline) {
+            try {
+                await driver.wait(until.elementExists(by), { timeout: Math.min(250, timeout) });
+                const found = await driver.findElement(by);
+                const text = (await found.getText())?.trim?.() ?? '';
+                last = text;
+                if (expected instanceof RegExp) {
+                    if (expected.test(text))
+                        return;
+                }
+                else if (text === expected) {
+                    return;
+                }
+            }
+            catch {
+                // retry
+            }
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+        const exp = expected instanceof RegExp ? `/${expected.source}/` : `"${expected}"`;
+        fail(`Expected element ${by.using}(${by.value}) to have text ${exp} but got "${last}"`);
+    };
+    const toBeVisible = async function toBeVisible(opts) {
+        const timeout = opts?.timeout ?? 5000;
+        try {
+            await driver.wait(until.elementIsVisible(by), { timeout });
+        }
+        catch {
+            fail(`Expected element ${by.using}(${by.value}) to be visible within ${timeout}ms`);
+        }
+    };
+    const toBeNotVisible = async function toBeNotVisible(opts) {
+        const timeout = opts?.timeout ?? 5000;
+        try {
+            await driver.wait(until.elementIsNotVisible(by), { timeout });
+        }
+        catch {
+            fail(`Expected element ${by.using}(${by.value}) to become hidden within ${timeout}ms`);
+        }
+    };
+    return {
+        toHaveText,
+        toBeVisible,
+        not: { toBeVisible: toBeNotVisible },
+    };
+}
+//# sourceMappingURL=expect.js.map

package/dist/lib/expect.js.map

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

package/dist/lib/http.d.ts

@@ -0,0 +1,7 @@
+import type { CommandResponse, RequestOptions, WebDriverEndpoint } from './types.js';
+export declare class HttpClient {
+    private endpoint;
+    constructor(endpoint: WebDriverEndpoint);
+    send<T = unknown>({ method, path, body }: RequestOptions): Promise<CommandResponse<T>>;
+}
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErF,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,iBAAiB;IAEzC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAqC7F"}

package/dist/lib/http.js

@@ -0,0 +1,47 @@
+import http from 'http';
+import https from 'https';
+import { URL } from 'url';
+export class HttpClient {
+    endpoint;
+    constructor(endpoint) {
+        this.endpoint = endpoint;
+    }
+    async send({ method, path, body }) {
+        const base = `${this.endpoint.protocol}://${this.endpoint.hostname}:${this.endpoint.port}${this.endpoint.path ?? ''}`;
+        const url = new URL(path, base);
+        const isHttps = url.protocol === 'https:';
+        const payload = body ? JSON.stringify(body) : undefined;
+        const options = {
+            method,
+            headers: {
+                'Content-Type': 'application/json; charset=utf-8',
+                Accept: 'application/json',
+                ...(payload ? { 'Content-Length': Buffer.byteLength(payload) } : {}),
+            },
+        };
+        const transport = isHttps ? https : http;
+        return await new Promise((resolve, reject) => {
+            const req = transport.request(url, options, (res) => {
+                const chunks = [];
+                res.on('data', (c) => chunks.push(Buffer.from(c)));
+                res.on('end', () => {
+                    const text = Buffer.concat(chunks).toString('utf8');
+                    if (!text)
+                        return resolve({ value: undefined });
+                    try {
+                        const json = JSON.parse(text);
+                        resolve(json);
+                    }
+                    catch (e) {
+                        reject(new Error(`Invalid JSON response: ${text}`));
+                    }
+                });
+            });
+            req.on('error', reject);
+            if (payload)
+                req.write(payload);
+            req.end();
+        });
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/lib/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG1B,MAAM,OAAO,UAAU;IACD;IAApB,YAAoB,QAA2B;QAA3B,aAAQ,GAAR,QAAQ,CAAmB;IAAG,CAAC;IAEnD,KAAK,CAAC,IAAI,CAAc,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAkB;QAC5D,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACtH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAExD,MAAM,OAAO,GAAwB;YACnC,MAAM;YACN,OAAO,EAAE;gBACP,cAAc,EAAE,iCAAiC;gBACjD,MAAM,EAAE,kBAAkB;gBAC1B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrE;SACF,CAAC;QAEF,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAE,KAAgC,CAAC,CAAC,CAAC,IAAI,CAAC;QAErE,OAAO,MAAM,IAAI,OAAO,CAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC/D,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,GAAyB,EAAE,EAAE;gBACxE,MAAM,MAAM,GAAa,EAAE,CAAC;gBAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3D,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;oBACjB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBACpD,IAAI,CAAC,IAAI;wBAAE,OAAO,OAAO,CAAC,EAAE,KAAK,EAAE,SAAyB,EAAE,CAAC,CAAC;oBAChE,IAAI,CAAC;wBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuB,CAAC;wBACpD,OAAO,CAAC,IAAI,CAAC,CAAC;oBAChB,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC,CAAC;oBACtD,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACxB,IAAI,OAAO;gBAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChC,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/lib/keyboard.d.ts

@@ -0,0 +1,14 @@
+import type { Driver } from './driver.js';
+import { type KeyValue } from './keys.js';
+export declare class KeyboardController {
+    private driver;
+    constructor(driver: Driver);
+    type(text: string): Promise<void>;
+    press(key: KeyValue, opts?: {
+        repeat?: number;
+    }): Promise<void>;
+    down(key: KeyValue): Promise<void>;
+    up(key: KeyValue): Promise<void>;
+    chord(...keys: KeyValue[]): Promise<void>;
+}
+//# sourceMappingURL=keyboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/lib/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEvD,qBAAa,kBAAkB;IACjB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/D,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,EAAE,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhC,KAAK,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAKhD"}

package/dist/lib/keyboard.js

@@ -0,0 +1,31 @@
+import { getKeyValue } from './keys.js';
+export class KeyboardController {
+    driver;
+    constructor(driver) {
+        this.driver = driver;
+    }
+    async type(text) {
+        await this.driver.typeText(text);
+    }
+    async press(key, opts) {
+        const value = getKeyValue(key);
+        await this.driver.keyPressCode(value, Math.max(1, opts?.repeat ?? 1));
+    }
+    async down(key) {
+        const value = getKeyValue(key);
+        await this.driver.keyDownCode(value);
+    }
+    async up(key) {
+        const value = getKeyValue(key);
+        await this.driver.keyUpCode(value);
+    }
+    // Press multiple keys together (e.g., Ctrl + A): downs in order, ups in reverse.
+    async chord(...keys) {
+        const codes = keys.map((k) => getKeyValue(k));
+        for (const c of codes)
+            await this.driver.keyDownCode(c);
+        for (const c of codes.slice().reverse())
+            await this.driver.keyUpCode(c);
+    }
+}
+//# sourceMappingURL=keyboard.js.map

package/dist/lib/keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../../src/lib/keyboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAiB,MAAM,WAAW,CAAC;AAEvD,MAAM,OAAO,kBAAkB;IACT;IAApB,YAAoB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAEtC,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAa,EAAE,IAA0B;QACnD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAa;QACtB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,EAAE,CAAC,GAAa;QACpB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,KAAK,CAAC,GAAG,IAAgB;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACxD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/dist/lib/keys.d.ts

@@ -0,0 +1,43 @@
+export declare const WebDriverKeyCodes: Record<string, string>;
+export type KeyValue = keyof typeof Key | string;
+export declare const Key: {
+    readonly Null: string;
+    readonly Cancel: string;
+    readonly Help: string;
+    readonly Backspace: string;
+    readonly Tab: string;
+    readonly Clear: string;
+    readonly Return: string;
+    readonly Enter: string;
+    readonly Shift: string;
+    readonly Control: string;
+    readonly Alt: string;
+    readonly Pause: string;
+    readonly Escape: string;
+    readonly Space: string;
+    readonly PageUp: string;
+    readonly PageDown: string;
+    readonly End: string;
+    readonly Home: string;
+    readonly ArrowLeft: string;
+    readonly ArrowUp: string;
+    readonly ArrowRight: string;
+    readonly ArrowDown: string;
+    readonly Insert: string;
+    readonly Delete: string;
+    readonly F1: string;
+    readonly F2: string;
+    readonly F3: string;
+    readonly F4: string;
+    readonly F5: string;
+    readonly F6: string;
+    readonly F7: string;
+    readonly F8: string;
+    readonly F9: string;
+    readonly F10: string;
+    readonly F11: string;
+    readonly F12: string;
+    readonly Meta: string;
+};
+export declare function getKeyValue(input: KeyValue): string;
+//# sourceMappingURL=keys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/lib/keys.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgEpD,CAAC;AAkCF,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,GAAG,GAAG,MAAM,CAAC;AAGjD,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCN,CAAC;AAGX,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAMnD"}

package/dist/lib/keys.js

@@ -0,0 +1,146 @@
+// WebDriver virtual key codes (PUA) per W3C WebDriver spec
+// Reference values are public spec constants; mapping implemented independently.
+export const WebDriverKeyCodes = {
+    null: '\uE000',
+    cancel: '\uE001',
+    help: '\uE002',
+    backspace: '\uE003',
+    tab: '\uE004',
+    clear: '\uE005',
+    return: '\uE006',
+    enter: '\uE007',
+    shift: '\uE008',
+    control: '\uE009',
+    alt: '\uE00A',
+    pause: '\uE00B',
+    escape: '\uE00C',
+    space: '\uE00D',
+    pageup: '\uE00E',
+    pagedown: '\uE00F',
+    end: '\uE010',
+    home: '\uE011',
+    arrowleft: '\uE012',
+    left: '\uE012',
+    arrowup: '\uE013',
+    up: '\uE013',
+    arrowright: '\uE014',
+    right: '\uE014',
+    arrowdown: '\uE015',
+    down: '\uE015',
+    insert: '\uE016',
+    delete: '\uE017',
+    semicolon: '\uE018',
+    equals: '\uE019',
+    numpad0: '\uE01A',
+    numpad1: '\uE01B',
+    numpad2: '\uE01C',
+    numpad3: '\uE01D',
+    numpad4: '\uE01E',
+    numpad5: '\uE01F',
+    numpad6: '\uE020',
+    numpad7: '\uE021',
+    numpad8: '\uE022',
+    numpad9: '\uE023',
+    multiply: '\uE024',
+    add: '\uE025',
+    separator: '\uE026',
+    subtract: '\uE027',
+    decimal: '\uE028',
+    divide: '\uE029',
+    f1: '\uE031',
+    f2: '\uE032',
+    f3: '\uE033',
+    f4: '\uE034',
+    f5: '\uE035',
+    f6: '\uE036',
+    f7: '\uE037',
+    f8: '\uE038',
+    f9: '\uE039',
+    f10: '\uE03A',
+    f11: '\uE03B',
+    f12: '\uE03C',
+    command: '\uE03D',
+    meta: '\uE03D',
+};
+// Aliases mapping for common test-friendly names to canonical keys
+const Aliases = {
+    esc: 'escape',
+    escape: 'escape',
+    enter: 'enter',
+    return: 'return',
+    space: 'space',
+    ' ': 'space',
+    arrowleft: 'arrowleft',
+    left: 'arrowleft',
+    arrowup: 'arrowup',
+    up: 'arrowup',
+    arrowright: 'arrowright',
+    right: 'arrowright',
+    arrowdown: 'arrowdown',
+    down: 'arrowdown',
+    pageup: 'pageup',
+    pagedown: 'pagedown',
+    backspace: 'backspace',
+    delete: 'delete',
+    shift: 'shift',
+    control: 'control',
+    ctrl: 'control',
+    alt: 'alt',
+    meta: 'meta',
+    command: 'command',
+};
+function normalizeName(name) {
+    return name.replace(/[_\-\s]/g, '').toLowerCase();
+}
+// Public Key enum-like for consumer code: Key.Enter, Key.Escape, etc.
+export const Key = {
+    Null: WebDriverKeyCodes.null,
+    Cancel: WebDriverKeyCodes.cancel,
+    Help: WebDriverKeyCodes.help,
+    Backspace: WebDriverKeyCodes.backspace,
+    Tab: WebDriverKeyCodes.tab,
+    Clear: WebDriverKeyCodes.clear,
+    Return: WebDriverKeyCodes.return,
+    Enter: WebDriverKeyCodes.enter,
+    Shift: WebDriverKeyCodes.shift,
+    Control: WebDriverKeyCodes.control,
+    Alt: WebDriverKeyCodes.alt,
+    Pause: WebDriverKeyCodes.pause,
+    Escape: WebDriverKeyCodes.escape,
+    Space: WebDriverKeyCodes.space,
+    PageUp: WebDriverKeyCodes.pageup,
+    PageDown: WebDriverKeyCodes.pagedown,
+    End: WebDriverKeyCodes.end,
+    Home: WebDriverKeyCodes.home,
+    ArrowLeft: WebDriverKeyCodes.arrowleft,
+    ArrowUp: WebDriverKeyCodes.arrowup,
+    ArrowRight: WebDriverKeyCodes.arrowright,
+    ArrowDown: WebDriverKeyCodes.arrowdown,
+    Insert: WebDriverKeyCodes.insert,
+    Delete: WebDriverKeyCodes.delete,
+    F1: WebDriverKeyCodes.f1,
+    F2: WebDriverKeyCodes.f2,
+    F3: WebDriverKeyCodes.f3,
+    F4: WebDriverKeyCodes.f4,
+    F5: WebDriverKeyCodes.f5,
+    F6: WebDriverKeyCodes.f6,
+    F7: WebDriverKeyCodes.f7,
+    F8: WebDriverKeyCodes.f8,
+    F9: WebDriverKeyCodes.f9,
+    F10: WebDriverKeyCodes.f10,
+    F11: WebDriverKeyCodes.f11,
+    F12: WebDriverKeyCodes.f12,
+    Meta: WebDriverKeyCodes.meta,
+};
+// Accept KeyValue and return the WebDriver key string to send.
+export function getKeyValue(input) {
+    if (typeof input !== 'string')
+        return String(input);
+    if (!input)
+        return input;
+    if (input.length === 1)
+        return input; // single character typed as-is
+    const canonical = Aliases[normalizeName(input)] ?? normalizeName(input);
+    return WebDriverKeyCodes[canonical] ?? input;
+}
+//# sourceMappingURL=keys.js.map

package/dist/lib/keys.js.map

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

package/dist/lib/locator.d.ts

@@ -0,0 +1,20 @@
+import { By } from './by.js';
+import type { Driver } from './driver.js';
+export interface ActionOptions {
+    timeout?: number;
+}
+export declare class Locator {
+    private driver;
+    private by;
+    constructor(driver: Driver, by: By);
+    locator(selector: string | By): Locator;
+    click(options?: ActionOptions): Promise<void>;
+    fill(text: string, options?: ActionOptions): Promise<void>;
+    textContent(options?: ActionOptions): Promise<string>;
+    isVisible(options?: ActionOptions): Promise<boolean>;
+    waitFor(options: {
+        state: 'attached' | 'detached' | 'visible' | 'hidden';
+        timeout?: number;
+    }): Promise<any>;
+}
+//# sourceMappingURL=locator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locator.d.ts","sourceRoot":"","sources":["../../src/lib/locator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,OAAO;IAEhB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,EAAE;gBADF,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,EAAE;IAGhB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO;IAKjC,KAAK,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9D,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAOzD,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAW9D,OAAO,CAAC,OAAO,EAAE;QACf,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;QACtD,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,GAAG,CAAC;CASjB"}

package/dist/lib/locator.js

@@ -0,0 +1,57 @@
+import { By } from './by.js';
+import { until } from './wait.js';
+export class Locator {
+    driver;
+    by;
+    constructor(driver, by) {
+        this.driver = driver;
+        this.by = by;
+    }
+    locator(selector) {
+        const next = typeof selector === 'string' ? By.css(selector) : selector;
+        return new Locator(this.driver, next);
+    }
+    async click(options = {}) {
+        const el = await this.driver.wait(until.elementIsVisible(this.by), {
+            timeout: options.timeout ?? 5000,
+        });
+        await el.click();
+    }
+    async fill(text, options = {}) {
+        const el = await this.driver.wait(until.elementIsVisible(this.by), {
+            timeout: options.timeout ?? 5000,
+        });
+        await el.click();
+        await el.sendKeys(text);
+    }
+    async textContent(options = {}) {
+        const el = await this.driver.wait(until.elementExists(this.by), {
+            timeout: options.timeout ?? 5000,
+        });
+        return (await el.getText()) ?? '';
+    }
+    async isVisible(options = {}) {
+        try {
+            const el = await this.driver.wait(until.elementExists(this.by), {
+                timeout: options.timeout ?? 5000,
+            });
+            return await el.isDisplayed();
+        }
+        catch {
+            return false;
+        }
+    }
+    waitFor(options) {
+        const { state, timeout } = options;
+        if (state === 'attached')
+            return this.driver.wait(until.elementExists(this.by), { timeout });
+        if (state === 'detached')
+            return this.driver.wait(until.elementNotExists(this.by), { timeout });
+        if (state === 'visible')
+            return this.driver.wait(until.elementIsVisible(this.by), { timeout });
+        if (state === 'hidden')
+            return this.driver.wait(until.elementIsNotVisible(this.by), { timeout });
+        return Promise.reject(new Error(`Unknown state: ${state}`));
+    }
+}
+//# sourceMappingURL=locator.js.map

package/dist/lib/locator.js.map

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

package/dist/lib/mouse.d.ts

@@ -0,0 +1,34 @@
+import type { Driver } from './driver.js';
+import { By } from './by.js';
+import { Key } from './keys.js';
+export type MouseButton = 'left' | 'middle' | 'right';
+export type Point = {
+    x: number;
+    y: number;
+};
+export type Target = string | By | Point;
+export declare class MouseController {
+    private driver;
+    constructor(driver: Driver);
+    private resolveElement;
+    move(target: Target, options?: {
+        durationMs?: number;
+    }): Promise<void>;
+    down(button?: MouseButton): Promise<void>;
+    up(button?: MouseButton): Promise<void>;
+    click(target: Target, options?: {
+        button?: MouseButton;
+        clickCount?: number;
+        modifiers?: Array<keyof typeof Key>;
+    }): Promise<void>;
+    dblclick(target: Target, options?: {
+        button?: MouseButton;
+        modifiers?: Array<keyof typeof Key>;
+    }): Promise<void>;
+    dragAndDrop(from: Target, to: Target, options?: {
+        durationMs?: number;
+        modifiers?: Array<keyof typeof Key>;
+    }): Promise<void>;
+    wheel(deltaX: number, deltaY: number, target?: Target): Promise<void>;
+}
+//# sourceMappingURL=mouse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mouse.d.ts","sourceRoot":"","sources":["../../src/lib/mouse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGhC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AACtD,MAAM,MAAM,KAAK,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7C,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC;AAQzC,qBAAa,eAAe;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;YAEpB,cAAc;IAOtB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtE,IAAI,CAAC,MAAM,GAAE,WAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,EAAE,CAAC,MAAM,GAAE,WAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,KAAK,CACT,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,OAAO,GAAG,CAAC,CAAA;KAAE,GAC3F,OAAO,CAAC,IAAI,CAAC;IAeV,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,OAAO,GAAG,CAAC,CAAA;KAAE,GACtE,OAAO,CAAC,IAAI,CAAC;IAQV,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,OAAO,GAAG,CAAC,CAAA;KAAE,GACrE,OAAO,CAAC,IAAI,CAAC;IA0BV,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAiB5E"}