@mobilewright/core 0.0.1

package/dist/device.d.ts

@@ -0,0 +1,34 @@
+import type { AppInfo, ConnectionConfig, LaunchOptions, MobilewrightDriver, Orientation, RecordingOptions, RecordingResult, Session } from '@mobilewright/protocol';
+import { Screen } from './screen.js';
+import type { LocatorOptions } from './locator.js';
+export interface DeviceOptions {
+    locatorDefaults?: LocatorOptions;
+}
+export declare class Device {
+    readonly driver: MobilewrightDriver;
+    private cleanupCallbacks;
+    private _screen;
+    private readonly opts;
+    constructor(driver: MobilewrightDriver, opts?: DeviceOptions);
+    /** Register a callback to run on close(). Used by launchers for cleanup. */
+    onClose(callback: () => Promise<void>): void;
+    connect(config: ConnectionConfig): Promise<Session>;
+    disconnect(): Promise<void>;
+    /** Full cleanup: disconnect + run any registered cleanup callbacks. */
+    close(): Promise<void>;
+    get screen(): Screen;
+    getOrientation(): Promise<Orientation>;
+    setOrientation(orientation: Orientation): Promise<void>;
+    openUrl(url: string): Promise<void>;
+    /** Alias for openUrl — matches Playwright's page.goto(). */
+    goto(url: string): Promise<void>;
+    launchApp(bundleId: string, opts?: LaunchOptions): Promise<void>;
+    terminateApp(bundleId: string): Promise<void>;
+    listApps(): Promise<AppInfo[]>;
+    getForegroundApp(): Promise<AppInfo>;
+    installApp(path: string): Promise<void>;
+    uninstallApp(bundleId: string): Promise<void>;
+    startRecording(opts: RecordingOptions): Promise<void>;
+    stopRecording(): Promise<RecordingResult>;
+}
+//# sourceMappingURL=device.d.ts.map

package/dist/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,OAAO,EACR,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,cAAc,CAAC;CAClC;AAED,qBAAa,MAAM;IACjB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;gBAEzB,MAAM,EAAE,kBAAkB,EAAE,IAAI,GAAE,aAAkB;IAKhE,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAMtC,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAInD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,uEAAuE;IACjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,IAAI,MAAM,IAAI,MAAM,CAGnB;IAIK,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAItC,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,4DAA4D;IACtD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAI9B,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAIpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;CAGhD"}

package/dist/device.js

@@ -0,0 +1,73 @@
+import { Screen } from './screen.js';
+export class Device {
+    constructor(driver, opts = {}) {
+        this.cleanupCallbacks = [];
+        this._screen = null;
+        this.driver = driver;
+        this.opts = opts;
+    }
+    /** Register a callback to run on close(). Used by launchers for cleanup. */
+    onClose(callback) {
+        this.cleanupCallbacks.push(callback);
+    }
+    // ─── Connection lifecycle ────────────────────────────────────
+    async connect(config) {
+        return this.driver.connect(config);
+    }
+    async disconnect() {
+        await this.driver.disconnect();
+    }
+    /** Full cleanup: disconnect + run any registered cleanup callbacks. */
+    async close() {
+        await this.disconnect();
+        for (const cb of this.cleanupCallbacks) {
+            await cb();
+        }
+        this.cleanupCallbacks = [];
+    }
+    get screen() {
+        this._screen ??= new Screen(this.driver, this.opts.locatorDefaults);
+        return this._screen;
+    }
+    // ─── Device control ──────────────────────────────────────────
+    async getOrientation() {
+        return this.driver.getOrientation();
+    }
+    async setOrientation(orientation) {
+        return this.driver.setOrientation(orientation);
+    }
+    async openUrl(url) {
+        return this.driver.openUrl(url);
+    }
+    /** Alias for openUrl — matches Playwright's page.goto(). */
+    async goto(url) {
+        return this.openUrl(url);
+    }
+    // ─── App control ─────────────────────────────────────────────
+    async launchApp(bundleId, opts) {
+        return this.driver.launchApp(bundleId, opts);
+    }
+    async terminateApp(bundleId) {
+        return this.driver.terminateApp(bundleId);
+    }
+    async listApps() {
+        return this.driver.listApps();
+    }
+    async getForegroundApp() {
+        return this.driver.getForegroundApp();
+    }
+    async installApp(path) {
+        return this.driver.installApp(path);
+    }
+    async uninstallApp(bundleId) {
+        return this.driver.uninstallApp(bundleId);
+    }
+    // ─── Recording ─────────────────────────────────────────────────
+    async startRecording(opts) {
+        return this.driver.startRecording(opts);
+    }
+    async stopRecording() {
+        return this.driver.stopRecording();
+    }
+}
+//# sourceMappingURL=device.js.map

package/dist/device.js.map

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

package/dist/expect.d.ts

@@ -0,0 +1,30 @@
+import type { Locator } from './locator.js';
+export interface ExpectOptions {
+    timeout?: number;
+}
+/**
+ * Playwright-style expect with auto-retry for mobile locators.
+ *
+ * Usage:
+ *   expect(locator).toBeVisible()
+ *   expect(locator).not.toBeVisible()
+ *   expect(locator).toHaveText('Hello')
+ */
+export declare function expect(locator: Locator): LocatorAssertions;
+declare class LocatorAssertions {
+    private readonly locator;
+    private readonly negated;
+    constructor(locator: Locator, negated: boolean);
+    get not(): LocatorAssertions;
+    toBeVisible(opts?: ExpectOptions): Promise<void>;
+    toBeEnabled(opts?: ExpectOptions): Promise<void>;
+    toHaveText(expected: string | RegExp, opts?: ExpectOptions): Promise<void>;
+    toContainText(expected: string, opts?: ExpectOptions): Promise<void>;
+    private assertText;
+    private retryUntil;
+}
+export declare class ExpectError extends Error {
+    constructor(message: string);
+}
+export {};
+//# sourceMappingURL=expect.d.ts.map

package/dist/expect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../src/expect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM5C,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAE1D;AAED,cAAM,iBAAiB;IAEnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO;IAGnC,IAAI,GAAG,IAAI,iBAAiB,CAE3B;IAEK,WAAW,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhD,WAAW,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1E,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;YAO5D,UAAU;YAsBV,UAAU;CAkBzB;AAED,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B"}

package/dist/expect.js

@@ -0,0 +1,74 @@
+import { sleep } from './sleep.js';
+const DEFAULT_TIMEOUT = 5_000;
+const POLL_INTERVAL = 100;
+/**
+ * Playwright-style expect with auto-retry for mobile locators.
+ *
+ * Usage:
+ *   expect(locator).toBeVisible()
+ *   expect(locator).not.toBeVisible()
+ *   expect(locator).toHaveText('Hello')
+ */
+export function expect(locator) {
+    return new LocatorAssertions(locator, false);
+}
+class LocatorAssertions {
+    constructor(locator, negated) {
+        this.locator = locator;
+        this.negated = negated;
+    }
+    get not() {
+        return new LocatorAssertions(this.locator, !this.negated);
+    }
+    async toBeVisible(opts) {
+        await this.retryUntil(() => this.locator.isVisible({ timeout: 0 }), (visible) => (this.negated ? !visible : visible), opts?.timeout ?? DEFAULT_TIMEOUT, this.negated
+            ? 'Expected element to NOT be visible, but it was'
+            : 'Expected element to be visible, but it was not');
+    }
+    async toBeEnabled(opts) {
+        await this.retryUntil(() => this.locator.isEnabled({ timeout: 0 }), (enabled) => (this.negated ? !enabled : enabled), opts?.timeout ?? DEFAULT_TIMEOUT, this.negated
+            ? 'Expected element to NOT be enabled, but it was'
+            : 'Expected element to be enabled, but it was not');
+    }
+    async toHaveText(expected, opts) {
+        await this.assertText((text) => expected instanceof RegExp ? expected.test(text) : text === expected, expected, opts);
+    }
+    async toContainText(expected, opts) {
+        await this.assertText((text) => text.includes(expected), expected, opts);
+    }
+    async assertText(predicate, expected, opts) {
+        let lastText = '';
+        await this.retryUntil(async () => {
+            try {
+                lastText = await this.locator.getText({ timeout: 0 });
+            }
+            catch {
+                lastText = '';
+            }
+            return lastText;
+        }, (text) => {
+            const matches = predicate(text);
+            return this.negated ? !matches : matches;
+        }, opts?.timeout ?? DEFAULT_TIMEOUT, () => this.negated
+            ? `Expected element NOT to have text "${expected}", but got "${lastText}"`
+            : `Expected element to have text "${expected}", but got "${lastText}"`);
+    }
+    async retryUntil(poll, predicate, timeout, failMessage) {
+        const deadline = Date.now() + timeout;
+        while (true) {
+            if (predicate(await poll()))
+                return;
+            if (Date.now() >= deadline) {
+                throw new ExpectError(typeof failMessage === 'function' ? failMessage() : failMessage);
+            }
+            await sleep(POLL_INTERVAL);
+        }
+    }
+}
+export class ExpectError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ExpectError';
+    }
+}
+//# sourceMappingURL=expect.js.map

package/dist/expect.js.map

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

package/dist/expect.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=expect.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expect.test.d.ts","sourceRoot":"","sources":["../src/expect.test.ts"],"names":[],"mappings":""}

package/dist/expect.test.js

@@ -0,0 +1,212 @@
+import { test, expect } from '@playwright/test';
+import { Locator } from './locator.js';
+import { expect as mwExpect, ExpectError } from './expect.js';
+function node(overrides) {
+    return {
+        isVisible: true,
+        isEnabled: true,
+        bounds: { x: 0, y: 0, width: 100, height: 44 },
+        children: [],
+        ...overrides,
+    };
+}
+function createMockDriver(hierarchy) {
+    let currentHierarchy = hierarchy;
+    const tracker = {
+        tapCalls: [],
+        doubleTapCalls: [],
+        longPressCalls: [],
+        typeTextCalls: [],
+        swipeCalls: [],
+        gestureCalls: [],
+        pressButtonCalls: [],
+        setOrientationCalls: [],
+        launchAppCalls: [],
+        terminateAppCalls: [],
+        installAppCalls: [],
+        uninstallAppCalls: [],
+        openUrlCalls: [],
+    };
+    return {
+        _tracker: tracker,
+        _setHierarchy: (h) => { currentHierarchy = h; },
+        connect: async () => ({ deviceId: 'device1', platform: 'ios' }),
+        disconnect: async () => { },
+        getViewHierarchy: async () => currentHierarchy,
+        tap: async (...args) => { tracker.tapCalls.push(args); },
+        doubleTap: async (...args) => { tracker.doubleTapCalls.push(args); },
+        longPress: async (...args) => { tracker.longPressCalls.push(args); },
+        typeText: async (...args) => { tracker.typeTextCalls.push(args); },
+        swipe: async (...args) => { tracker.swipeCalls.push(args); },
+        gesture: async (...args) => { tracker.gestureCalls.push(args); },
+        pressButton: async (...args) => { tracker.pressButtonCalls.push(args); },
+        screenshot: async () => Buffer.from(''),
+        getScreenSize: async () => ({ width: 390, height: 844 }),
+        getOrientation: async () => 'portrait',
+        setOrientation: async (...args) => { tracker.setOrientationCalls.push(args); },
+        launchApp: async (...args) => { tracker.launchAppCalls.push(args); },
+        terminateApp: async (...args) => { tracker.terminateAppCalls.push(args); },
+        listApps: async () => [],
+        getForegroundApp: async () => ({ bundleId: 'com.test' }),
+        installApp: async (...args) => { tracker.installAppCalls.push(args); },
+        uninstallApp: async (...args) => { tracker.uninstallAppCalls.push(args); },
+        listDevices: async () => [],
+        openUrl: async (...args) => { tracker.openUrlCalls.push(args); },
+        startRecording: async () => { },
+        stopRecording: async () => ({ output: '' }),
+    };
+}
+const hierarchy = [
+    node({
+        type: 'Window',
+        children: [
+            node({
+                type: 'StaticText',
+                label: 'Welcome',
+                text: 'Welcome back!',
+                identifier: 'welcomeText',
+                bounds: { x: 10, y: 10, width: 200, height: 30 },
+            }),
+            node({
+                type: 'Button',
+                label: 'Submit',
+                identifier: 'submitBtn',
+                bounds: { x: 20, y: 100, width: 200, height: 50 },
+            }),
+            node({
+                type: 'Button',
+                label: 'Hidden',
+                identifier: 'hiddenBtn',
+                isVisible: false,
+                bounds: { x: 20, y: 200, width: 200, height: 50 },
+            }),
+        ],
+    }),
+];
+test.describe('expect', () => {
+    test.describe('toBeVisible', () => {
+        test('passes when element is visible', async () => {
+            const driver = createMockDriver(hierarchy);
+            const locator = new Locator(driver, {
+                kind: 'testId',
+                value: 'submitBtn',
+            });
+            await mwExpect(locator).toBeVisible();
+        });
+        test('fails when element is not visible', async () => {
+            const driver = createMockDriver(hierarchy);
+            const locator = new Locator(driver, {
+                kind: 'testId',
+                value: 'hiddenBtn',
+            });
+            await expect(mwExpect(locator).toBeVisible({ timeout: 200 })).rejects.toThrow(ExpectError);
+        });
+    });
+    test.describe('not.toBeVisible', () => {
+        test('passes when element is not visible', async () => {
+            const driver = createMockDriver(hierarchy);
+            const locator = new Locator(driver, {
+                kind: 'testId',
+                value: 'hiddenBtn',
+            });
+            await mwExpect(locator).not.toBeVisible();
+        });
+        test('passes when element does not exist', async () => {
+            const driver = createMockDriver(hierarchy);
+            const locator = new Locator(driver, {
+                kind: 'testId',
+                value: 'nonExistent',
+            });
+            await mwExpect(locator).not.toBeVisible();
+        });
+    });
+    test.describe('toHaveText', () => {
+        test('passes with exact text match', async () => {
+            const driver = createMockDriver(hierarchy);
+            const locator = new Locator(driver, {
+                kind: 'testId',
+                value: 'welcomeText',
+            });
+            await mwExpect(locator).toHaveText('Welcome back!');
+        });
+        test('passes with regex match', async () => {
+            const driver = createMockDriver(hierarchy);
+            const locator = new Locator(driver, {
+                kind: 'testId',
+                value: 'welcomeText',
+            });
+            await mwExpect(locator).toHaveText(/welcome/i);
+        });
+        test('fails with wrong text', async () => {
+            const driver = createMockDriver(hierarchy);
+            const locator = new Locator(driver, {
+                kind: 'testId',
+                value: 'welcomeText',
+            });
+            await expect(mwExpect(locator).toHaveText('Wrong text', { timeout: 200 })).rejects.toThrow(ExpectError);
+        });
+    });
+    test.describe('toContainText', () => {
+        test('passes when text contains substring', async () => {
+            const driver = createMockDriver(hierarchy);
+            const locator = new Locator(driver, {
+                kind: 'testId',
+                value: 'welcomeText',
+            });
+            await mwExpect(locator).toContainText('back');
+        });
+    });
+    test.describe('toBeEnabled', () => {
+        test('passes when element is enabled', async () => {
+            const driver = createMockDriver(hierarchy);
+            const locator = new Locator(driver, {
+                kind: 'testId',
+                value: 'submitBtn',
+            });
+            await mwExpect(locator).toBeEnabled();
+        });
+    });
+    test.describe('auto-retry', () => {
+        test('retries until assertion passes', async () => {
+            const initialTree = [
+                node({
+                    type: 'Window',
+                    children: [
+                        node({
+                            type: 'StaticText',
+                            label: 'Status',
+                            identifier: 'status',
+                            text: 'Loading...',
+                        }),
+                    ],
+                }),
+            ];
+            const updatedTree = [
+                node({
+                    type: 'Window',
+                    children: [
+                        node({
+                            type: 'StaticText',
+                            label: 'Status',
+                            identifier: 'status',
+                            text: 'Done!',
+                        }),
+                    ],
+                }),
+            ];
+            let callCount = 0;
+            const driver = createMockDriver(initialTree);
+            // Override getViewHierarchy to switch after 3 calls
+            driver.getViewHierarchy = async () => {
+                callCount++;
+                return callCount >= 3 ? updatedTree : initialTree;
+            };
+            const locator = new Locator(driver, {
+                kind: 'testId',
+                value: 'status',
+            });
+            await mwExpect(locator).toHaveText('Done!', { timeout: 2000 });
+        });
+    });
+});
+//# sourceMappingURL=expect.test.js.map

package/dist/expect.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { Locator, LocatorError, type LocatorOptions } from './locator.js';
+export { Screen } from './screen.js';
+export { Device, type DeviceOptions } from './device.js';
+export { expect, ExpectError, type ExpectOptions } from './expect.js';
+export { queryAll, type LocatorStrategy } from './query-engine.js';
+export { sleep } from './sleep.js';
+//# 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,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { Locator, LocatorError } from './locator.js';
+export { Screen } from './screen.js';
+export { Device } from './device.js';
+export { expect, ExpectError } from './expect.js';
+export { queryAll } from './query-engine.js';
+export { sleep } from './sleep.js';
+//# 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,OAAO,EAAE,OAAO,EAAE,YAAY,EAAuB,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAsB,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAwB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/locator.d.ts

@@ -0,0 +1,69 @@
+import type { MobilewrightDriver } from '@mobilewright/protocol';
+import { type LocatorStrategy } from './query-engine.js';
+export interface LocatorOptions {
+    timeout?: number;
+    pollInterval?: number;
+    stabilityDelay?: number;
+}
+export declare class Locator {
+    private readonly driver;
+    private readonly strategy;
+    private readonly options;
+    /** Create a root locator that searches the entire view hierarchy. */
+    static root(driver: MobilewrightDriver, options?: LocatorOptions): Locator;
+    constructor(driver: MobilewrightDriver, strategy: LocatorStrategy, options?: LocatorOptions);
+    getByLabel(label: string, opts?: {
+        exact?: boolean;
+    }): Locator;
+    getByTestId(testId: string): Locator;
+    getByText(text: string | RegExp, opts?: {
+        exact?: boolean;
+    }): Locator;
+    getByType(type: string): Locator;
+    getByRole(role: string, opts?: {
+        name?: string | RegExp;
+    }): Locator;
+    private child;
+    tap(opts?: {
+        timeout?: number;
+    }): Promise<void>;
+    doubleTap(opts?: {
+        timeout?: number;
+    }): Promise<void>;
+    longPress(opts?: {
+        timeout?: number;
+        duration?: number;
+    }): Promise<void>;
+    fill(text: string, opts?: {
+        timeout?: number;
+    }): Promise<void>;
+    screenshot(opts?: {
+        timeout?: number;
+    }): Promise<Buffer>;
+    isVisible(opts?: {
+        timeout?: number;
+    }): Promise<boolean>;
+    isEnabled(opts?: {
+        timeout?: number;
+    }): Promise<boolean>;
+    getText(opts?: {
+        timeout?: number;
+    }): Promise<string>;
+    waitFor(opts?: {
+        state?: 'visible' | 'hidden' | 'enabled' | 'disabled';
+        timeout?: number;
+    }): Promise<void>;
+    /** Wait for a visible node and return it. Used by getText, screenshot. */
+    private resolveVisible;
+    /** Poll until the given state is satisfied. Returns the matched node (or null for hidden/disabled). */
+    private pollUntilState;
+    /** Resolve to a single actionable node (visible, enabled, stable bounds) */
+    private resolveActionable;
+    /** Resolve without waiting — returns null if not found */
+    private resolve;
+}
+export declare class LocatorError extends Error {
+    readonly strategy: LocatorStrategy;
+    constructor(message: string, strategy: LocatorStrategy);
+}
+//# sourceMappingURL=locator.d.ts.map

package/dist/locator.d.ts.map

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