@mobilewright/driver-mobilecli 0.0.1

package/dist/driver.d.ts

@@ -0,0 +1,37 @@
+import type { AppInfo, ConnectionConfig, DeviceInfo, GestureSequence, HardwareButton, LaunchOptions, ListDevicesOptions, MobilewrightDriver, Orientation, RecordingOptions, RecordingResult, ScreenSize, ScreenshotOptions, Session, SwipeDirection, SwipeOptions, ViewNode } from '@mobilewright/protocol';
+export declare const DEFAULT_URL = "ws://localhost:12000/ws";
+export declare class MobilecliDriver implements MobilewrightDriver {
+    private session;
+    private readonly serverUrl;
+    constructor(opts?: {
+        url?: string;
+    });
+    connect(config: ConnectionConfig): Promise<Session>;
+    disconnect(): Promise<void>;
+    getViewHierarchy(): Promise<ViewNode[]>;
+    tap(x: number, y: number): Promise<void>;
+    doubleTap(x: number, y: number): Promise<void>;
+    longPress(x: number, y: number, duration?: number): Promise<void>;
+    typeText(text: string): Promise<void>;
+    swipe(direction: SwipeDirection, opts?: SwipeOptions): Promise<void>;
+    gesture(gestures: GestureSequence): Promise<void>;
+    pressButton(button: HardwareButton): Promise<void>;
+    screenshot(opts?: ScreenshotOptions): Promise<Buffer>;
+    getScreenSize(): Promise<ScreenSize>;
+    getOrientation(): Promise<Orientation>;
+    setOrientation(orientation: Orientation): Promise<void>;
+    startRecording(opts: RecordingOptions): Promise<void>;
+    stopRecording(): Promise<RecordingResult>;
+    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>;
+    listDevices(opts?: ListDevicesOptions): Promise<DeviceInfo[]>;
+    openUrl(url: string): Promise<void>;
+    /** RPC call on the active session, auto-injecting deviceId. */
+    private call;
+    private requireSession;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,gBAAgB,EAChB,UAAU,EAGV,eAAe,EACf,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EAEX,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,YAAY,EACZ,QAAQ,EACT,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,WAAW,4BAA4B,CAAC;AA6ErD,qBAAa,eAAgB,YAAW,kBAAkB;IACxD,OAAO,CAAC,OAAO,CAAyE;IACxF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE;IAM7B,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBnD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,gBAAgB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKvC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,KAAK,CAAC,SAAS,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpE,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlD,UAAU,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAWrD,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAMpC,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAKtC,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAMzC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAS9B,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IASpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,WAAW,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAsB7D,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC,+DAA+D;IAC/D,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,cAAc;CAIvB"}

package/dist/driver.js

@@ -0,0 +1,178 @@
+import { RpcClient } from './rpc-client.js';
+export const DEFAULT_URL = 'ws://localhost:12000/ws';
+function elementToViewNode(el) {
+    const bounds = el.rect ?? { x: 0, y: 0, width: 0, height: 0 };
+    return {
+        type: el.type ?? 'Unknown',
+        label: el.label || undefined,
+        identifier: el.identifier || el.name || undefined,
+        value: el.value || undefined,
+        text: el.label || undefined,
+        isVisible: typeof el.visible === 'boolean' ? el.visible : bounds.width > 0 && bounds.height > 0,
+        isEnabled: el.enabled ?? true,
+        bounds,
+        children: el.children?.map(elementToViewNode) ?? [],
+        raw: el,
+    };
+}
+export class MobilecliDriver {
+    constructor(opts) {
+        this.session = null;
+        this.serverUrl = opts?.url ?? DEFAULT_URL;
+    }
+    // ─── Connection ──────────────────────────────────────────────
+    async connect(config) {
+        const url = config.url ?? this.serverUrl;
+        const rpc = new RpcClient(url, config.timeout);
+        await rpc.connect();
+        let platform;
+        if (config.platform) {
+            platform = config.platform;
+        }
+        else {
+            const result = await rpc.call('device.info', { deviceId: config.deviceId });
+            const info = result.device ?? result;
+            platform = info.platform?.toLowerCase() === 'android' ? 'android' : 'ios';
+        }
+        this.session = { deviceId: config.deviceId, platform, rpc };
+        return { deviceId: config.deviceId, platform };
+    }
+    async disconnect() {
+        this.requireSession().rpc.disconnect();
+        this.session = null;
+    }
+    // ─── Element Operations ──────────────────────────────────────
+    async getViewHierarchy() {
+        const result = await this.call('device.dump.ui');
+        return result.elements.map(elementToViewNode);
+    }
+    async tap(x, y) {
+        await this.call('device.io.tap', { x, y });
+    }
+    async doubleTap(x, y) {
+        await this.call('device.io.tap', { x, y });
+        await this.call('device.io.tap', { x, y });
+    }
+    async longPress(x, y, duration) {
+        await this.call('device.io.longpress', { x, y, ...(duration !== undefined && { duration }) });
+    }
+    async typeText(text) {
+        await this.call('device.io.text', { text });
+    }
+    async swipe(direction, opts) {
+        await this.call('device.io.swipe', {
+            direction,
+            ...(opts?.distance !== undefined && { distance: opts.distance }),
+            ...(opts?.duration !== undefined && { duration: opts.duration }),
+            ...(opts?.startX !== undefined && { startX: opts.startX }),
+            ...(opts?.startY !== undefined && { startY: opts.startY }),
+        });
+    }
+    async gesture(gestures) {
+        await this.call('device.io.gesture', { pointers: gestures.pointers });
+    }
+    async pressButton(button) {
+        await this.call('device.io.button', { button });
+    }
+    // ─── Screen Operations ───────────────────────────────────────
+    async screenshot(opts) {
+        const result = await this.call('device.screenshot', {
+            ...(opts?.format && { format: opts.format }),
+            ...(opts?.quality !== undefined && { quality: opts.quality }),
+        });
+        let b64 = result.data;
+        const commaIdx = b64.indexOf(',');
+        if (commaIdx !== -1)
+            b64 = b64.slice(commaIdx + 1);
+        return Buffer.from(b64, 'base64');
+    }
+    async getScreenSize() {
+        const result = await this.call('device.info');
+        const info = result.device;
+        return info.screenSize ?? { width: info.screenWidth ?? 0, height: info.screenHeight ?? 0 };
+    }
+    async getOrientation() {
+        const result = await this.call('device.io.orientation.get');
+        return result.orientation === 'landscape' ? 'landscape' : 'portrait';
+    }
+    async setOrientation(orientation) {
+        await this.call('device.io.orientation.set', { orientation });
+    }
+    // ─── Recording Operations ─────────────────────────────────────
+    async startRecording(opts) {
+        await this.call('device.screenrecord', {
+            output: opts.output,
+            ...(opts.timeLimit && { timeLimit: opts.timeLimit }),
+        });
+    }
+    async stopRecording() {
+        return this.call('device.screenrecord.stop');
+    }
+    // ─── App Operations ──────────────────────────────────────────
+    async launchApp(bundleId, opts) {
+        await this.call('device.apps.launch', {
+            bundleId,
+            ...(opts?.locale && { locale: opts.locale }),
+        });
+    }
+    async terminateApp(bundleId) {
+        await this.call('device.apps.terminate', { bundleId });
+    }
+    async listApps() {
+        const result = await this.call('device.apps.list');
+        return result.apps.map((app) => ({
+            bundleId: app.bundleId ?? app.packageName ?? '',
+            name: app.appName,
+            version: app.version,
+        }));
+    }
+    async getForegroundApp() {
+        const result = await this.call('device.apps.foreground');
+        return {
+            bundleId: result.bundleId ?? result.packageName ?? '',
+            name: result.appName,
+            version: result.version,
+        };
+    }
+    async installApp(path) {
+        await this.call('device.apps.install', { path });
+    }
+    async uninstallApp(bundleId) {
+        await this.call('device.apps.uninstall', { bundleId });
+    }
+    // ─── Device Operations ───────────────────────────────────────
+    async listDevices(opts) {
+        const rpc = new RpcClient(this.serverUrl);
+        await rpc.connect();
+        try {
+            const result = await rpc.call('devices.list', opts ? { ...opts } : undefined);
+            return result.devices.map((d) => ({
+                id: d.id ?? d.udid ?? '',
+                name: d.name,
+                platform: d.platform,
+                type: d.type,
+                state: d.state,
+                model: d.model,
+                osVersion: d.version,
+            }));
+        }
+        finally {
+            await rpc.disconnect();
+        }
+    }
+    async openUrl(url) {
+        await this.call('device.url', { url });
+    }
+    // ─── Helpers ─────────────────────────────────────────────────
+    /** RPC call on the active session, auto-injecting deviceId. */
+    call(method, params) {
+        const session = this.requireSession();
+        return session.rpc.call(method, { deviceId: session.deviceId, ...params });
+    }
+    requireSession() {
+        if (!this.session)
+            throw new Error('No active session. Call connect() first.');
+        return this.session;
+    }
+}
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { MobilecliDriver, DEFAULT_URL } from './driver.js';
+export { resolveMobilecliBinary } from './resolve-binary.js';
+export { RpcClient } from './rpc-client.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,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { MobilecliDriver, DEFAULT_URL } from './driver.js';
+export { resolveMobilecliBinary } from './resolve-binary.js';
+export { RpcClient } from './rpc-client.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,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/integration.test.d.ts

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

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

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

package/dist/integration.test.js

@@ -0,0 +1,36 @@
+/**
+ * Integration test that connects to a real mobilecli server.
+ *
+ * Requires:
+ *   - mobilecli server running on localhost:12000
+ *   - A booted iOS simulator or Android emulator
+ *   - MOBILEWRIGHT_INTEGRATION=1 environment variable
+ *   - MOBILEWRIGHT_DEVICE_ID=<udid> environment variable
+ */
+import { test, expect } from '@playwright/test';
+import { MobilecliDriver } from './driver.js';
+const INTEGRATION = process.env['MOBILEWRIGHT_INTEGRATION'] === '1';
+const DEVICE_ID = process.env['MOBILEWRIGHT_DEVICE_ID'] ?? '';
+test.describe('mobilecli integration', () => {
+    test.skip(!INTEGRATION, 'Requires MOBILEWRIGHT_INTEGRATION=1');
+    test('connects, dumps UI hierarchy, and takes a screenshot', async () => {
+        const driver = new MobilecliDriver();
+        const session = await driver.connect({
+            deviceId: DEVICE_ID,
+        });
+        expect(session.platform).toMatch(/^(ios|android)$/);
+        // Dump view hierarchy
+        const hierarchy = await driver.getViewHierarchy();
+        expect(hierarchy.length).toBeGreaterThan(0);
+        expect(hierarchy[0].type).toBeTruthy();
+        // Take screenshot
+        const screenshot = await driver.screenshot();
+        expect(screenshot).toBeInstanceOf(Buffer);
+        expect(screenshot.length).toBeGreaterThan(100);
+        // Get orientation
+        const orientation = await driver.getOrientation();
+        expect(orientation).toMatch(/^(portrait|landscape)$/);
+        await driver.disconnect();
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.js","sourceRoot":"","sources":["../src/integration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,KAAK,GAAG,CAAC;AACpE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,EAAE,CAAC;AAE9D,IAAI,CAAC,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IAC1C,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,qCAAqC,CAAC,CAAC;IAE/D,IAAI,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAErC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;YACnC,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAEpD,sBAAsB;QACtB,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAClD,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;QAEvC,kBAAkB;QAClB,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC7C,MAAM,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QAE/C,kBAAkB;QAClB,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;QAClD,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAEtD,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/parsers/android-hierarchy-parser.d.ts

@@ -0,0 +1,24 @@
+import type { ViewNode } from '@mobilewright/protocol';
+/**
+ * Parses Android UIAutomator XML hierarchy into ViewNode[].
+ *
+ * UIAutomator XML looks like:
+ * <hierarchy rotation="0">
+ *   <node index="0" text="" resource-id="" class="android.widget.FrameLayout"
+ *     package="com.example" content-desc="" checkable="false" checked="false"
+ *     clickable="false" enabled="true" focusable="false" focused="false"
+ *     scrollable="false" long-clickable="false" password="false"
+ *     selected="false" visible-to-user="true"
+ *     bounds="[0,0][1080,1920]">
+ *     <node ... />
+ *   </node>
+ * </hierarchy>
+ *
+ * Key differences from iOS:
+ * - All elements are <node> tags; the type is in the "class" attribute
+ * - bounds format is "[left,top][right,bottom]"
+ * - content-desc is the accessibility label
+ * - resource-id is the identifier
+ */
+export declare function parseAndroidHierarchy(xml: string): ViewNode[];
+//# sourceMappingURL=android-hierarchy-parser.d.ts.map

package/dist/parsers/android-hierarchy-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"android-hierarchy-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/android-hierarchy-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,CAE7D"}

package/dist/parsers/android-hierarchy-parser.js

@@ -0,0 +1,78 @@
+import { parseXmlHierarchy } from './shared.js';
+/**
+ * Parses Android UIAutomator XML hierarchy into ViewNode[].
+ *
+ * UIAutomator XML looks like:
+ * <hierarchy rotation="0">
+ *   <node index="0" text="" resource-id="" class="android.widget.FrameLayout"
+ *     package="com.example" content-desc="" checkable="false" checked="false"
+ *     clickable="false" enabled="true" focusable="false" focused="false"
+ *     scrollable="false" long-clickable="false" password="false"
+ *     selected="false" visible-to-user="true"
+ *     bounds="[0,0][1080,1920]">
+ *     <node ... />
+ *   </node>
+ * </hierarchy>
+ *
+ * Key differences from iOS:
+ * - All elements are <node> tags; the type is in the "class" attribute
+ * - bounds format is "[left,top][right,bottom]"
+ * - content-desc is the accessibility label
+ * - resource-id is the identifier
+ */
+export function parseAndroidHierarchy(xml) {
+    return parseXmlHierarchy(xml, 'hierarchy', androidNodeFromAttrs);
+}
+function androidNodeFromAttrs(_tagName, attrs) {
+    // Shorten class name: "android.widget.Button" -> "Button"
+    const fullClass = attrs.get('class') || 'View';
+    const type = fullClass.includes('.')
+        ? fullClass.split('.').pop()
+        : fullClass;
+    // resource-id often looks like "com.example:id/login_button"
+    // Extract just the id part after "/"
+    const rawResourceId = attrs.get('resource-id') || '';
+    const identifier = rawResourceId.includes('/')
+        ? rawResourceId.split('/').pop()
+        : rawResourceId || undefined;
+    const contentDesc = attrs.get('content-desc') || '';
+    const text = attrs.get('text') || '';
+    const raw = {};
+    for (const [k, v] of attrs) {
+        raw[k] = v;
+    }
+    return {
+        type,
+        label: contentDesc || undefined,
+        identifier: identifier || undefined,
+        value: undefined,
+        text: text || undefined,
+        placeholder: attrs.get('hint') || undefined,
+        isVisible: attrs.get('visible-to-user') !== 'false',
+        isEnabled: attrs.get('enabled') === 'true',
+        isSelected: attrs.get('selected') === 'true' ? true : undefined,
+        isFocused: attrs.get('focused') === 'true' ? true : undefined,
+        bounds: parseBounds(attrs.get('bounds') || ''),
+        children: [],
+        raw,
+    };
+}
+/**
+ * Parse Android bounds format "[left,top][right,bottom]" -> {x, y, width, height}
+ */
+function parseBounds(boundsStr) {
+    const match = boundsStr.match(/\[(\d+),(\d+)\]\[(\d+),(\d+)\]/);
+    if (!match)
+        return { x: 0, y: 0, width: 0, height: 0 };
+    const left = Number(match[1]);
+    const top = Number(match[2]);
+    const right = Number(match[3]);
+    const bottom = Number(match[4]);
+    return {
+        x: left,
+        y: top,
+        width: right - left,
+        height: bottom - top,
+    };
+}
+//# sourceMappingURL=android-hierarchy-parser.js.map

package/dist/parsers/android-hierarchy-parser.js.map

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

package/dist/parsers/android-hierarchy-parser.test.d.ts

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

package/dist/parsers/android-hierarchy-parser.test.d.ts.map

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

package/dist/parsers/android-hierarchy-parser.test.js

@@ -0,0 +1,107 @@
+import { test, expect } from '@playwright/test';
+import { parseAndroidHierarchy } from './android-hierarchy-parser.js';
+const SAMPLE_ANDROID_XML = `
+<hierarchy rotation="0">
+  <node index="0" text="" resource-id="" class="android.widget.FrameLayout" package="com.example.app" content-desc="" checkable="false" checked="false" clickable="false" enabled="true" focusable="false" focused="false" scrollable="false" long-clickable="false" password="false" selected="false" visible-to-user="true" bounds="[0,0][1080,1920]">
+    <node index="0" text="" resource-id="com.example.app:id/toolbar" class="android.widget.Toolbar" package="com.example.app" content-desc="Login" enabled="true" visible-to-user="true" bounds="[0,50][1080,150]">
+      <node index="0" text="Login" resource-id="" class="android.widget.TextView" package="com.example.app" content-desc="" enabled="true" visible-to-user="true" bounds="[40,60][200,140]"/>
+    </node>
+    <node index="1" text="" resource-id="com.example.app:id/email_input" class="android.widget.EditText" package="com.example.app" content-desc="Email" enabled="true" visible-to-user="true" focused="false" bounds="[20,200][1060,280]" hint="Enter email"/>
+    <node index="2" text="" resource-id="com.example.app:id/password_input" class="android.widget.EditText" package="com.example.app" content-desc="Password" enabled="true" visible-to-user="true" bounds="[20,300][1060,380]"/>
+    <node index="3" text="Sign In" resource-id="com.example.app:id/login_btn" class="android.widget.Button" package="com.example.app" content-desc="" enabled="true" visible-to-user="true" bounds="[20,420][1060,500]"/>
+    <node index="4" text="Forgot Password?" resource-id="com.example.app:id/forgot_link" class="android.widget.TextView" package="com.example.app" content-desc="" enabled="true" visible-to-user="false" bounds="[20,520][1060,570]"/>
+    <node index="5" text="" resource-id="com.example.app:id/remember_switch" class="android.widget.Switch" package="com.example.app" content-desc="Remember Me" enabled="true" visible-to-user="true" selected="false" bounds="[20,600][100,660]"/>
+  </node>
+</hierarchy>`;
+test.describe('parseAndroidHierarchy', () => {
+    test('parses root element correctly', () => {
+        const nodes = parseAndroidHierarchy(SAMPLE_ANDROID_XML);
+        expect(nodes).toHaveLength(1);
+        expect(nodes[0].type).toBe('FrameLayout');
+    });
+    test('builds correct tree structure', () => {
+        const nodes = parseAndroidHierarchy(SAMPLE_ANDROID_XML);
+        const root = nodes[0];
+        expect(root.children).toHaveLength(6); // Toolbar + 2 EditText + Button + TextView + Switch
+    });
+    test('shortens class names to simple type', () => {
+        const nodes = parseAndroidHierarchy(SAMPLE_ANDROID_XML);
+        const root = nodes[0];
+        const types = root.children.map((c) => c.type);
+        expect(types).toEqual([
+            'Toolbar',
+            'EditText',
+            'EditText',
+            'Button',
+            'TextView',
+            'Switch',
+        ]);
+    });
+    test('parses Android bounds format [left,top][right,bottom]', () => {
+        const nodes = parseAndroidHierarchy(SAMPLE_ANDROID_XML);
+        const root = nodes[0];
+        // Root: [0,0][1080,1920]
+        expect(root.bounds).toEqual({
+            x: 0,
+            y: 0,
+            width: 1080,
+            height: 1920,
+        });
+        // Email input: [20,200][1060,280]
+        const emailInput = root.children[1];
+        expect(emailInput.bounds).toEqual({
+            x: 20,
+            y: 200,
+            width: 1040,
+            height: 80,
+        });
+    });
+    test('extracts resource-id as identifier', () => {
+        const nodes = parseAndroidHierarchy(SAMPLE_ANDROID_XML);
+        const root = nodes[0];
+        const emailInput = root.children[1];
+        expect(emailInput.identifier).toBe('email_input');
+        const loginBtn = root.children[3];
+        expect(loginBtn.identifier).toBe('login_btn');
+    });
+    test('uses content-desc as label', () => {
+        const nodes = parseAndroidHierarchy(SAMPLE_ANDROID_XML);
+        const root = nodes[0];
+        const emailInput = root.children[1];
+        expect(emailInput.label).toBe('Email');
+    });
+    test('parses text property', () => {
+        const nodes = parseAndroidHierarchy(SAMPLE_ANDROID_XML);
+        const root = nodes[0];
+        const loginBtn = root.children[3];
+        expect(loginBtn.text).toBe('Sign In');
+    });
+    test('parses visible-to-user', () => {
+        const nodes = parseAndroidHierarchy(SAMPLE_ANDROID_XML);
+        const root = nodes[0];
+        const loginBtn = root.children[3];
+        expect(loginBtn.isVisible).toBe(true);
+        const forgotLink = root.children[4];
+        expect(forgotLink.isVisible).toBe(false);
+    });
+    test('handles nested children', () => {
+        const nodes = parseAndroidHierarchy(SAMPLE_ANDROID_XML);
+        const toolbar = nodes[0].children[0];
+        expect(toolbar.type).toBe('Toolbar');
+        expect(toolbar.label).toBe('Login');
+        expect(toolbar.children).toHaveLength(1);
+        expect(toolbar.children[0].type).toBe('TextView');
+        expect(toolbar.children[0].text).toBe('Login');
+    });
+    test('handles empty hierarchy', () => {
+        const nodes = parseAndroidHierarchy('<hierarchy rotation="0"/>');
+        expect(nodes).toHaveLength(0);
+    });
+    test('preserves raw attributes', () => {
+        const nodes = parseAndroidHierarchy(SAMPLE_ANDROID_XML);
+        const root = nodes[0];
+        expect(root.raw).toBeDefined();
+        expect(root.raw['package']).toBe('com.example.app');
+    });
+});
+//# sourceMappingURL=android-hierarchy-parser.test.js.map

package/dist/parsers/android-hierarchy-parser.test.js.map

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

package/dist/parsers/index.d.ts

@@ -0,0 +1,3 @@
+export { parseIosHierarchy } from './ios-hierarchy-parser.js';
+export { parseAndroidHierarchy } from './android-hierarchy-parser.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/parsers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/parsers/index.js

@@ -0,0 +1,3 @@
+export { parseIosHierarchy } from './ios-hierarchy-parser.js';
+export { parseAndroidHierarchy } from './android-hierarchy-parser.js';
+//# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/parsers/ios-hierarchy-parser.d.ts

@@ -0,0 +1,22 @@
+import type { ViewNode } from '@mobilewright/protocol';
+/**
+ * Parses iOS WDA (WebDriverAgent) XML hierarchy into ViewNode[].
+ *
+ * WDA XML looks like:
+ * <AppiumAUT>
+ *   <XCUIElementTypeApplication type="XCUIElementTypeApplication"
+ *     name="MyApp" label="MyApp" enabled="true" visible="true"
+ *     accessible="false" x="0" y="0" width="390" height="844">
+ *     <XCUIElementTypeWindow ...>
+ *       <XCUIElementTypeButton name="loginButton" label="Log In"
+ *         enabled="true" visible="true" x="20" y="100" width="350" height="44"/>
+ *     </XCUIElementTypeWindow>
+ *   </XCUIElementTypeApplication>
+ * </AppiumAUT>
+ *
+ * Each element tag IS the type (e.g. XCUIElementTypeButton).
+ * Attributes include: type, name, label, value, enabled, visible,
+ * accessible, x, y, width, height, index, selected, focused.
+ */
+export declare function parseIosHierarchy(xml: string): ViewNode[];
+//# sourceMappingURL=ios-hierarchy-parser.d.ts.map

package/dist/parsers/ios-hierarchy-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios-hierarchy-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/ios-hierarchy-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,CAEzD"}

package/dist/parsers/ios-hierarchy-parser.js

@@ -0,0 +1,60 @@
+import { parseXmlHierarchy } from './shared.js';
+/**
+ * Parses iOS WDA (WebDriverAgent) XML hierarchy into ViewNode[].
+ *
+ * WDA XML looks like:
+ * <AppiumAUT>
+ *   <XCUIElementTypeApplication type="XCUIElementTypeApplication"
+ *     name="MyApp" label="MyApp" enabled="true" visible="true"
+ *     accessible="false" x="0" y="0" width="390" height="844">
+ *     <XCUIElementTypeWindow ...>
+ *       <XCUIElementTypeButton name="loginButton" label="Log In"
+ *         enabled="true" visible="true" x="20" y="100" width="350" height="44"/>
+ *     </XCUIElementTypeWindow>
+ *   </XCUIElementTypeApplication>
+ * </AppiumAUT>
+ *
+ * Each element tag IS the type (e.g. XCUIElementTypeButton).
+ * Attributes include: type, name, label, value, enabled, visible,
+ * accessible, x, y, width, height, index, selected, focused.
+ */
+export function parseIosHierarchy(xml) {
+    return parseXmlHierarchy(xml, 'AppiumAUT', iosNodeFromAttrs);
+}
+function iosNodeFromAttrs(tagName, attrs) {
+    // Strip "XCUIElementType" prefix for cleaner type names
+    const type = tagName.startsWith('XCUIElementType')
+        ? tagName.slice('XCUIElementType'.length)
+        : tagName;
+    const raw = {};
+    for (const [k, v] of attrs) {
+        raw[k] = v;
+    }
+    return {
+        type,
+        label: attrs.get('label') || undefined,
+        identifier: attrs.get('name') || undefined,
+        value: attrs.get('value') || undefined,
+        text: undefined,
+        placeholder: attrs.get('placeholderValue') || undefined,
+        isVisible: attrs.get('visible') === 'true',
+        isEnabled: attrs.get('enabled') === 'true',
+        isSelected: attrs.get('selected') === 'true' ? true : undefined,
+        isFocused: attrs.get('focused') === 'true' ? true : undefined,
+        bounds: {
+            x: parseNumericAttribute(attrs.get('x')),
+            y: parseNumericAttribute(attrs.get('y')),
+            width: parseNumericAttribute(attrs.get('width')),
+            height: parseNumericAttribute(attrs.get('height')),
+        },
+        children: [],
+        raw,
+    };
+}
+function parseNumericAttribute(val) {
+    if (val === undefined)
+        return 0;
+    const n = Number(val);
+    return Number.isFinite(n) ? n : 0;
+}
+//# sourceMappingURL=ios-hierarchy-parser.js.map

package/dist/parsers/ios-hierarchy-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios-hierarchy-parser.js","sourceRoot":"","sources":["../../src/parsers/ios-hierarchy-parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,gBAAgB,CACvB,OAAe,EACf,KAA0B;IAE1B,wDAAwD;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAChD,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC;QACzC,CAAC,CAAC,OAAO,CAAC;IAEZ,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;QAC3B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAED,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,SAAS;QACtC,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,SAAS;QAC1C,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,SAAS;QACtC,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,SAAS;QACvD,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,MAAM;QAC1C,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,MAAM;QAC1C,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAC/D,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAC7D,MAAM,EAAE;YACN,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,KAAK,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAChD,MAAM,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;SACnD;QACD,QAAQ,EAAE,EAAE;QACZ,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAuB;IACpD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/dist/parsers/ios-hierarchy-parser.test.d.ts

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

package/dist/parsers/ios-hierarchy-parser.test.d.ts.map

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

package/dist/parsers/ios-hierarchy-parser.test.js

@@ -0,0 +1,102 @@
+import { test, expect } from '@playwright/test';
+import { parseIosHierarchy } from './ios-hierarchy-parser.js';
+const SAMPLE_IOS_XML = `
+<AppiumAUT>
+  <XCUIElementTypeApplication type="XCUIElementTypeApplication" name="TestApp" label="TestApp" enabled="true" visible="true" x="0" y="0" width="390" height="844">
+    <XCUIElementTypeWindow type="XCUIElementTypeWindow" enabled="true" visible="true" x="0" y="0" width="390" height="844">
+      <XCUIElementTypeOther type="XCUIElementTypeOther" enabled="true" visible="true" x="0" y="0" width="390" height="844">
+        <XCUIElementTypeNavigationBar type="XCUIElementTypeNavigationBar" name="Login" label="Login" enabled="true" visible="true" x="0" y="47" width="390" height="44">
+          <XCUIElementTypeStaticText type="XCUIElementTypeStaticText" name="Login" label="Login" enabled="true" visible="true" x="164" y="53" width="62" height="32"/>
+        </XCUIElementTypeNavigationBar>
+        <XCUIElementTypeTextField type="XCUIElementTypeTextField" name="emailField" label="Email" value="" enabled="true" visible="true" x="20" y="120" width="350" height="44" placeholderValue="Enter email"/>
+        <XCUIElementTypeSecureTextField type="XCUIElementTypeSecureTextField" name="passwordField" label="Password" value="" enabled="true" visible="true" x="20" y="180" width="350" height="44" placeholderValue="Enter password"/>
+        <XCUIElementTypeButton type="XCUIElementTypeButton" name="loginButton" label="Sign In" enabled="true" visible="true" x="20" y="250" width="350" height="50"/>
+        <XCUIElementTypeButton type="XCUIElementTypeButton" name="forgotPassword" label="Forgot Password?" enabled="true" visible="false" x="20" y="320" width="350" height="30"/>
+        <XCUIElementTypeSwitch type="XCUIElementTypeSwitch" name="rememberMe" label="Remember Me" value="0" enabled="true" visible="true" selected="false" x="20" y="370" width="51" height="31"/>
+      </XCUIElementTypeOther>
+    </XCUIElementTypeWindow>
+  </XCUIElementTypeApplication>
+</AppiumAUT>`;
+test.describe('parseIosHierarchy', () => {
+    test('parses root element correctly', () => {
+        const nodes = parseIosHierarchy(SAMPLE_IOS_XML);
+        expect(nodes).toHaveLength(1);
+        expect(nodes[0].type).toBe('Application');
+        expect(nodes[0].identifier).toBe('TestApp');
+        expect(nodes[0].label).toBe('TestApp');
+    });
+    test('builds correct tree structure', () => {
+        const nodes = parseIosHierarchy(SAMPLE_IOS_XML);
+        const app = nodes[0];
+        expect(app.children).toHaveLength(1); // Window
+        const window = app.children[0];
+        expect(window.type).toBe('Window');
+        expect(window.children).toHaveLength(1); // Other
+        const other = window.children[0];
+        expect(other.children).toHaveLength(6); // NavBar + TextField + SecureTextField + 2 Buttons + Switch
+    });
+    test('strips XCUIElementType prefix from type names', () => {
+        const nodes = parseIosHierarchy(SAMPLE_IOS_XML);
+        const other = nodes[0].children[0].children[0];
+        const types = other.children.map((c) => c.type);
+        expect(types).toEqual([
+            'NavigationBar',
+            'TextField',
+            'SecureTextField',
+            'Button',
+            'Button',
+            'Switch',
+        ]);
+    });
+    test('parses bounds correctly', () => {
+        const nodes = parseIosHierarchy(SAMPLE_IOS_XML);
+        const other = nodes[0].children[0].children[0];
+        const emailField = other.children[1]; // TextField
+        expect(emailField.bounds).toEqual({
+            x: 20,
+            y: 120,
+            width: 350,
+            height: 44,
+        });
+    });
+    test('parses visibility and enabled state', () => {
+        const nodes = parseIosHierarchy(SAMPLE_IOS_XML);
+        const other = nodes[0].children[0].children[0];
+        const loginButton = other.children[3]; // Sign In button
+        expect(loginButton.isVisible).toBe(true);
+        expect(loginButton.isEnabled).toBe(true);
+        const forgotPassword = other.children[4]; // Hidden button
+        expect(forgotPassword.isVisible).toBe(false);
+    });
+    test('parses accessibility identifiers and labels', () => {
+        const nodes = parseIosHierarchy(SAMPLE_IOS_XML);
+        const other = nodes[0].children[0].children[0];
+        const emailField = other.children[1];
+        expect(emailField.identifier).toBe('emailField');
+        expect(emailField.label).toBe('Email');
+        expect(emailField.placeholder).toBe('Enter email');
+    });
+    test('parses value and selected state', () => {
+        const nodes = parseIosHierarchy(SAMPLE_IOS_XML);
+        const other = nodes[0].children[0].children[0];
+        const toggle = other.children[5]; // Switch
+        expect(toggle.value).toBe('0');
+        expect(toggle.label).toBe('Remember Me');
+    });
+    test('preserves raw attributes', () => {
+        const nodes = parseIosHierarchy(SAMPLE_IOS_XML);
+        const other = nodes[0].children[0].children[0];
+        const emailField = other.children[1];
+        expect(emailField.raw).toBeDefined();
+        expect(emailField.raw['placeholderValue']).toBe('Enter email');
+    });
+    test('handles empty XML', () => {
+        const nodes = parseIosHierarchy('');
+        expect(nodes).toHaveLength(0);
+    });
+    test('handles self-closing AppiumAUT', () => {
+        const nodes = parseIosHierarchy('<AppiumAUT/>');
+        expect(nodes).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=ios-hierarchy-parser.test.js.map

package/dist/parsers/ios-hierarchy-parser.test.js.map

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

package/dist/parsers/shared.d.ts

@@ -0,0 +1,9 @@
+import type { ViewNode } from '@mobilewright/protocol';
+/**
+ * Walk XML as a sequence of open/close/self-closing tags, calling
+ * `createNode` for each non-wrapper element. Handles wrapper elements
+ * (like AppiumAUT, hierarchy) by promoting their children.
+ */
+export declare function parseXmlHierarchy(xml: string, wrapperTag: string, createNode: (tagName: string, attrs: Map<string, string>) => ViewNode): ViewNode[];
+export declare function parseAttributes(attrString: string): Map<string, string>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/parsers/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/parsers/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,QAAQ,GACpE,QAAQ,EAAE,CAqEZ;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQvE"}

package/dist/parsers/shared.js

@@ -0,0 +1,94 @@
+/**
+ * Walk XML as a sequence of open/close/self-closing tags, calling
+ * `createNode` for each non-wrapper element. Handles wrapper elements
+ * (like AppiumAUT, hierarchy) by promoting their children.
+ */
+export function parseXmlHierarchy(xml, wrapperTag, createNode) {
+    const nodes = [];
+    const stack = [];
+    const tagRegex = /<(\/?)(\w+)((?:\s+[\w:-]+="[^"]*")*)\s*(\/?)>/g;
+    let match;
+    while ((match = tagRegex.exec(xml)) !== null) {
+        const [, isClose, tagName, attrString, isSelfClose] = match;
+        if (isClose) {
+            const node = stack.pop();
+            if (node) {
+                const parent = stack[stack.length - 1];
+                if (parent) {
+                    parent.children.push(node);
+                }
+                else {
+                    nodes.push(node);
+                }
+            }
+            continue;
+        }
+        // Skip wrapper elements
+        if (tagName === wrapperTag) {
+            if (!isSelfClose) {
+                stack.push({
+                    type: '__wrapper__',
+                    isVisible: true,
+                    isEnabled: true,
+                    bounds: { x: 0, y: 0, width: 0, height: 0 },
+                    children: [],
+                });
+            }
+            continue;
+        }
+        const attrs = parseAttributes(attrString);
+        const node = createNode(tagName, attrs);
+        if (isSelfClose) {
+            const parent = stack[stack.length - 1];
+            if (parent) {
+                parent.children.push(node);
+            }
+            else {
+                nodes.push(node);
+            }
+        }
+        else {
+            stack.push(node);
+        }
+    }
+    // Drain any remaining stack (shouldn't happen with valid XML)
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (node.type === '__wrapper__') {
+            nodes.push(...node.children);
+        }
+        else {
+            const parent = stack[stack.length - 1];
+            if (parent) {
+                parent.children.push(node);
+            }
+            else {
+                nodes.push(node);
+            }
+        }
+    }
+    return unwrapWrappers(nodes);
+}
+export function parseAttributes(attrString) {
+    const attrs = new Map();
+    const attrRegex = /([\w:-]+)="([^"]*)"/g;
+    let attrMatch;
+    while ((attrMatch = attrRegex.exec(attrString)) !== null) {
+        attrs.set(attrMatch[1], attrMatch[2]);
+    }
+    return attrs;
+}
+function unwrapWrappers(nodes) {
+    const result = [];
+    for (const node of nodes) {
+        if (node.type === '__wrapper__') {
+            result.push(...unwrapWrappers(node.children));
+        }
+        else {
+            node.children = unwrapWrappers(node.children);
+            result.push(node);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=shared.js.map

package/dist/parsers/shared.js.map

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

package/dist/resolve-binary.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Walk up from cwd looking for `node_modules/@mobilenext/mobilecli`.
+ * Uses cwd instead of import.meta.url so it works when Playwright
+ * transpiles the source to CJS.
+ */
+export declare function resolveMobilecliBinary(): string;
+//# sourceMappingURL=resolve-binary.d.ts.map

package/dist/resolve-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-binary.d.ts","sourceRoot":"","sources":["../src/resolve-binary.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAkB/C"}

package/dist/resolve-binary.js

@@ -0,0 +1,29 @@
+import { join, dirname } from 'node:path';
+import { existsSync } from 'node:fs';
+/**
+ * Walk up from cwd looking for `node_modules/@mobilenext/mobilecli`.
+ * Uses cwd instead of import.meta.url so it works when Playwright
+ * transpiles the source to CJS.
+ */
+export function resolveMobilecliBinary() {
+    let dir = process.cwd();
+    while (true) {
+        const candidate = join(dir, 'node_modules', '@mobilenext', 'mobilecli');
+        if (existsSync(join(candidate, 'package.json'))) {
+            const binary = process.platform === 'darwin'
+                ? (process.arch === 'arm64' ? 'mobilecli-darwin-arm64' : 'mobilecli-darwin-amd64')
+                : process.platform === 'linux'
+                    ? (process.arch === 'arm64' ? 'mobilecli-linux-arm64' : 'mobilecli-linux-amd64')
+                    : null;
+            if (!binary)
+                throw new Error(`Unsupported platform: ${process.platform}-${process.arch}`);
+            return join(candidate, 'bin', binary);
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error('@mobilenext/mobilecli is not installed');
+}
+//# sourceMappingURL=resolve-binary.js.map

package/dist/resolve-binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-binary.js","sourceRoot":"","sources":["../src/resolve-binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IACpC,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACxB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;QACxE,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ;gBAC1C,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,wBAAwB,CAAC;gBAClF,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO;oBAC5B,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,uBAAuB,CAAC;oBAChF,CAAC,CAAC,IAAI,CAAC;YACX,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1F,OAAO,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/rpc-client.d.ts

@@ -0,0 +1,31 @@
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export declare class RpcClient {
+    private url;
+    private requestTimeout;
+    private ws;
+    private nextId;
+    private pending;
+    private connectionPromise;
+    constructor(url: string, requestTimeout?: number);
+    connect(): Promise<void>;
+    call<T = unknown>(method: string, params?: Record<string, unknown>): Promise<T>;
+    disconnect(): Promise<void>;
+    get isConnected(): boolean;
+    private handleMessage;
+}
+//# sourceMappingURL=rpc-client.d.ts.map

package/dist/rpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-client.d.ts","sourceRoot":"","sources":["../src/rpc-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAQD,qBAAa,SAAS;IAOlB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,cAAc;IAPxB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,iBAAiB,CAA8B;gBAG7C,GAAG,EAAE,MAAM,EACX,cAAc,SAAS;IAG3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0CxB,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAgCP,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,OAAO,CAAC,aAAa;CA8BtB"}

package/dist/rpc-client.js

@@ -0,0 +1,112 @@
+import WebSocket from 'ws';
+export class RpcClient {
+    constructor(url, requestTimeout = 30_000) {
+        this.url = url;
+        this.requestTimeout = requestTimeout;
+        this.ws = null;
+        this.nextId = 1;
+        this.pending = new Map();
+        this.connectionPromise = null;
+    }
+    async connect() {
+        if (this.ws?.readyState === WebSocket.OPEN)
+            return;
+        if (this.connectionPromise)
+            return this.connectionPromise;
+        this.connectionPromise = new Promise((resolve, reject) => {
+            const ws = new WebSocket(this.url);
+            const timeout = setTimeout(() => {
+                ws.terminate();
+                reject(new Error(`Connection to ${this.url} timed out`));
+            }, this.requestTimeout);
+            ws.on('open', () => {
+                clearTimeout(timeout);
+                this.ws = ws;
+                this.connectionPromise = null;
+                resolve();
+            });
+            ws.on('error', (err) => {
+                clearTimeout(timeout);
+                this.connectionPromise = null;
+                reject(err);
+            });
+            ws.on('message', (data) => {
+                this.handleMessage(data);
+            });
+            ws.on('close', () => {
+                this.ws = null;
+                // Reject all pending requests
+                for (const [id, req] of this.pending) {
+                    clearTimeout(req.timer);
+                    req.reject(new Error('WebSocket connection closed'));
+                    this.pending.delete(id);
+                }
+            });
+        });
+        return this.connectionPromise;
+    }
+    async call(method, params) {
+        await this.connect();
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            throw new Error('WebSocket is not connected');
+        }
+        const id = this.nextId++;
+        const request = {
+            jsonrpc: '2.0',
+            id,
+            method,
+            ...(params !== undefined && { params }),
+        };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`RPC call "${method}" timed out after ${this.requestTimeout}ms`));
+            }, this.requestTimeout);
+            this.pending.set(id, {
+                resolve: resolve,
+                reject,
+                timer,
+            });
+            this.ws.send(JSON.stringify(request));
+        });
+    }
+    async disconnect() {
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    get isConnected() {
+        return this.ws?.readyState === WebSocket.OPEN;
+    }
+    handleMessage(data) {
+        let response;
+        try {
+            response = JSON.parse(data.toString());
+        }
+        catch {
+            return; // Ignore malformed messages
+        }
+        const pending = this.pending.get(response.id);
+        if (!pending)
+            return;
+        this.pending.delete(response.id);
+        clearTimeout(pending.timer);
+        if (response.error) {
+            // Surface the detail from mobilecli — response.error.data often
+            // contains the real error (e.g. "exit status 4") while
+            // response.error.message is just "Server error".
+            const detail = typeof response.error.data === 'string'
+                ? response.error.data
+                : response.error.message;
+            const err = new Error(detail);
+            err.code = response.error.code;
+            err.data = response.error.data;
+            pending.reject(err);
+        }
+        else {
+            pending.resolve(response.result);
+        }
+    }
+}
+//# sourceMappingURL=rpc-client.js.map

package/dist/rpc-client.js.map

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

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@mobilewright/driver-mobilecli",
+  "version": "0.0.1",
+  "description": "mobilecli driver for Mobilewright",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "prepublishOnly": "tsc -b"
+  },
+  "files": ["dist"],
+  "dependencies": {
+    "@mobilewright/protocol": "^0.0.1",
+    "fast-xml-parser": "^5.0.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.0"
+  }
+}