execbro 2.0.0 → 2.1.0

package/build/__tests__/unit/coordinateMiss.test.d.ts

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

package/build/__tests__/unit/coordinateMiss.test.d.ts.map

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

package/build/__tests__/unit/coordinateMiss.test.js

@@ -0,0 +1,111 @@
+import { describe, it, expect } from "@jest/globals";
+import { explainCoordinateMiss } from "../../pro/coordinateMiss.js";
+const pressable = (over = {}) => ({
+    label: null,
+    component: null,
+    testID: null,
+    center: { x: 0, y: 0 },
+    bounds: { x: 0, y: 0, width: 0, height: 0 },
+    ...over,
+});
+/**
+ * Modelled on the real repro: an "Insufficient Balance" bottom sheet with an OK
+ * button, over a screen whose own buttons are covered by the sheet.
+ */
+const sheetState = {
+    route: { name: "OneGiftAtATime", params: null, stack: [] },
+    overlays: [
+        {
+            type: "BottomSheet",
+            title: null,
+            pressables: [
+                pressable({
+                    label: "OK",
+                    component: "Button",
+                    center: { x: 210, y: 834 },
+                    bounds: { x: 20, y: 806, width: 380, height: 56 },
+                }),
+            ],
+            texts: [
+                {
+                    text: "It looks like there aren't enough funds to add this gift.",
+                    center: { x: 210, y: 734 },
+                    bounds: { x: 41, y: 700, width: 338, height: 70 },
+                },
+            ],
+        },
+    ],
+    pressables: [
+        // Sits directly under the sheet's OK button (same band) — a tap there
+        // reaches OK, not this.
+        pressable({
+            label: "Proceed to Checkout",
+            component: "Button",
+            center: { x: 210, y: 838 },
+            bounds: { x: 20, y: 810, width: 380, height: 56 },
+            blockedByOverlay: true,
+        }),
+        // Higher up the screen, covered by the sheet but overlapping nothing
+        // reachable — the pure "you targeted something behind an overlay" case.
+        pressable({
+            label: "Clear Cart and Add New Item",
+            component: "Button",
+            center: { x: 210, y: 774 },
+            bounds: { x: 20, y: 746, width: 380, height: 56 },
+            blockedByOverlay: true,
+        }),
+    ],
+    texts: [],
+    images: [],
+};
+describe("explainCoordinateMiss", () => {
+    it("names the text it hit and points at the nearest reachable pressable", () => {
+        // The exact miss from the live session: 100pt above the OK button.
+        const d = explainCoordinateMiss({ x: 210, y: 734 }, sheetState);
+        expect(d).not.toBeNull();
+        expect(d.hit).toContain("It looks like there aren't enough funds");
+        expect(d.nearest?.label).toBe("OK");
+        expect(d.nearest?.center).toEqual({ x: 210, y: 834 });
+        expect(d.nearest?.direction).toBe("below");
+        expect(d.suggestion).toContain("(210, 834)");
+    });
+    it("says so when the point landed on something an overlay covers", () => {
+        // "Clear Cart and Add New Item" is visible in the screenshot but unreachable.
+        const d = explainCoordinateMiss({ x: 210, y: 774 }, sheetState);
+        expect(d.blockedByOverlay).toBe(true);
+        expect(d.hit).toContain("Clear Cart and Add New Item");
+        expect(d.hit).toContain("BottomSheet");
+        expect(d.suggestion).toMatch(/Dismiss the BottomSheet/);
+        // It must still offer the reachable alternative.
+        expect(d.suggestion).toContain("(210, 834)");
+    });
+    it("prefers the reachable overlay button when it overlaps a covered element", () => {
+        // (210,834) is inside BOTH the sheet's OK button and the covered
+        // "Proceed to Checkout" beneath it. The touch reaches OK, so the
+        // diagnosis must describe OK — not the element behind it.
+        const d = explainCoordinateMiss({ x: 210, y: 834 }, sheetState);
+        expect(d.hit).toContain("OK");
+        expect(d.hit).not.toContain("Proceed to Checkout");
+        expect(d.blockedByOverlay).toBe(false);
+        expect(d.suggestion).toContain("coordinates were correct");
+        expect(d.suggestion).toMatch(/onPress handler/);
+        // No "nearest" steer — the aim was fine.
+        expect(d.nearest).toBeUndefined();
+    });
+    it("reports empty space when the point hit nothing at all", () => {
+        const d = explainCoordinateMiss({ x: 5, y: 20 }, sheetState);
+        expect(d.hit).toBe("no element (empty space)");
+        expect(d.nearest?.label).toBe("OK");
+    });
+    it("converts suggested coordinates into the caller's space", () => {
+        // Caller works in screenshot pixels at ~2.19 px per point.
+        const d = explainCoordinateMiss({ x: 210, y: 734 }, sheetState, (v) => Math.round(v * 2.19));
+        expect(d.nearest?.center).toEqual({ x: 460, y: 1826 });
+        expect(d.suggestion).toContain("(460, 1826)");
+    });
+    it("returns null when the screen state carries nothing to reason about", () => {
+        const empty = { route: null, overlays: [], pressables: [], texts: [], images: [] };
+        expect(explainCoordinateMiss({ x: 1, y: 1 }, empty)).toBeNull();
+    });
+});
+//# sourceMappingURL=coordinateMiss.test.js.map

package/build/__tests__/unit/coordinateMiss.test.js.map

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

package/build/__tests__/unit/deviceResolverStaleRetry.test.d.ts

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

package/build/__tests__/unit/deviceResolverStaleRetry.test.d.ts.map

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

package/build/__tests__/unit/deviceResolverStaleRetry.test.js

@@ -0,0 +1,69 @@
+import { describe, it, expect, jest, beforeEach } from "@jest/globals";
+/**
+ * The device inventory cache was raised from 5s to 30s so back-to-back taps stop
+ * re-shelling `simctl list` / `adb devices`. That is only safe because a failed
+ * resolution retries once against a freshly queried inventory — these tests pin
+ * that contract.
+ */
+const listAllDevices = jest.fn();
+const resetDeviceDiscoveryCache = jest.fn();
+jest.unstable_mockModule("../../core/deviceDiscovery.js", () => ({
+    listAllDevices,
+    resetDeviceDiscoveryCache,
+}));
+jest.unstable_mockModule("../../core/connection.js", () => ({
+    getConnectedApps: () => [],
+}));
+jest.unstable_mockModule("../../core/projectMemory.js", () => ({
+    listDevices: () => [],
+    recordDevice: () => undefined,
+}));
+const empty = {
+    ios: { available: true, simulators: [] },
+    android: { available: true, emulators: [], physical: [] },
+    summary: { booted: 0, total: 0 },
+};
+const withBootedSim = {
+    ios: {
+        available: true,
+        simulators: [
+            { name: "iPhone Air", udid: "F93612A3-0042-4BDC-855F-8CAB1BDD76C6", state: "booted", runtime: "iOS 26.0" },
+        ],
+    },
+    android: { available: true, emulators: [], physical: [] },
+    summary: { booted: 1, total: 1 },
+};
+const { resolveDeviceTarget } = await import("../../core/deviceResolver.js");
+describe("resolveDeviceTarget stale-inventory retry", () => {
+    beforeEach(() => {
+        listAllDevices.mockReset();
+        resetDeviceDiscoveryCache.mockReset();
+    });
+    it("re-queries a fresh inventory when the device wasn't found", async () => {
+        // First pass: cached inventory is stale and has nothing. Second pass:
+        // the simulator that was booted moments ago shows up.
+        listAllDevices
+            .mockResolvedValueOnce(empty)
+            .mockResolvedValue(withBootedSim);
+        const result = await resolveDeviceTarget("F93612A3-0042-4BDC-855F-8CAB1BDD76C6");
+        expect(resetDeviceDiscoveryCache).toHaveBeenCalledTimes(1);
+        expect(result.ok).toBe(true);
+        if (result.ok)
+            expect(result.target.deviceName).toBe("iPhone Air");
+    });
+    it("does not pay for a refresh when resolution succeeds first time", async () => {
+        listAllDevices.mockResolvedValue(withBootedSim);
+        const result = await resolveDeviceTarget("F93612A3-0042-4BDC-855F-8CAB1BDD76C6");
+        expect(result.ok).toBe(true);
+        expect(resetDeviceDiscoveryCache).not.toHaveBeenCalled();
+    });
+    it("still reports the failure when a fresh inventory also has no match", async () => {
+        listAllDevices.mockResolvedValue(empty);
+        const result = await resolveDeviceTarget("F93612A3-0042-4BDC-855F-8CAB1BDD76C6");
+        expect(result.ok).toBe(false);
+        expect(resetDeviceDiscoveryCache).toHaveBeenCalledTimes(1);
+        if (!result.ok)
+            expect(result.error.code).toBe("DEVICE_NOT_FOUND");
+    });
+});
+//# sourceMappingURL=deviceResolverStaleRetry.test.js.map

package/build/__tests__/unit/deviceResolverStaleRetry.test.js.map

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

package/build/__tests__/unit/findElementTreeReuse.test.d.ts

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

package/build/__tests__/unit/findElementTreeReuse.test.d.ts.map

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

package/build/__tests__/unit/findElementTreeReuse.test.js

@@ -0,0 +1,77 @@
+import { describe, it, expect } from "@jest/globals";
+import { iosFindElement } from "../../core/ios.js";
+import { androidFindElement } from "../../core/android.js";
+/**
+ * The accessibility tap strategy runs two or three predicates over the SAME
+ * screen. Each find used to re-dump the accessibility tree (`axe describe-ui`
+ * ~210ms on iOS, a uiautomator dump on Android), so a single tap paid for the
+ * dump 2-3x. These tests pin the contract that makes the reuse possible: when a
+ * tree is supplied, no device call happens and matching runs against it.
+ *
+ * They also guard the failure mode of the optimisation — a caller passing a
+ * failed/empty tree must get an honest miss, never a silent device re-fetch.
+ */
+const iosTree = {
+    success: true,
+    rawOutput: JSON.stringify([{ frame: { x: 0, y: 0, width: 402, height: 874 } }]),
+    elements: [
+        {
+            label: "Proceed to Checkout",
+            value: "",
+            type: "Button",
+            identifier: "checkout-btn",
+            frame: { x: 20, y: 810, width: 380, height: 56 },
+            center: { x: 210, y: 838 },
+            enabled: true,
+            traits: [],
+        },
+    ],
+};
+describe("iosFindElement with a pre-fetched tree", () => {
+    it("matches against the supplied tree without touching the device", async () => {
+        // No simulator is involved: a udid that cannot exist would make a real
+        // describe-ui fail, so a match here proves the tree was used.
+        const result = await iosFindElement({ labelContains: "Checkout" }, "00000000-0000-0000-0000-000000000000", iosTree);
+        expect(result.success).toBe(true);
+        expect(result.allMatches?.length).toBe(1);
+        expect(result.allMatches?.[0].label).toBe("Proceed to Checkout");
+    });
+    it("reports a clean miss for a predicate the tree doesn't satisfy", async () => {
+        const result = await iosFindElement({ labelContains: "Nonexistent" }, "00000000-0000-0000-0000-000000000000", iosTree);
+        expect(result.found).toBeFalsy();
+        expect(result.allMatches ?? []).toHaveLength(0);
+    });
+    it("surfaces a failed tree instead of silently re-fetching", async () => {
+        const failed = { success: false, error: "axe not installed" };
+        const result = await iosFindElement({ labelContains: "Checkout" }, "00000000-0000-0000-0000-000000000000", failed);
+        expect(result.success).toBe(false);
+        expect(result.error).toBe("axe not installed");
+    });
+});
+describe("androidFindElement with a pre-fetched tree", () => {
+    const androidTree = {
+        success: true,
+        elements: [
+            {
+                text: "Proceed to Checkout",
+                resourceId: "com.app:id/checkout",
+                contentDesc: "",
+                bounds: { x: 20, y: 810, width: 380, height: 56 },
+                center: { x: 210, y: 838 },
+                clickable: true,
+            },
+        ],
+    };
+    it("matches against the supplied tree without running uiautomator", async () => {
+        const result = await androidFindElement({ textContains: "Checkout" }, "no-such-device", undefined, androidTree);
+        expect(result.success).toBe(true);
+        expect(result.allMatches?.length).toBe(1);
+    });
+    it("surfaces a failed tree instead of silently re-dumping", async () => {
+        const failed = { success: false, error: "adb offline" };
+        const result = await androidFindElement({ textContains: "Checkout" }, "no-such-device", undefined, failed);
+        expect(result.success).toBe(false);
+        expect(result.error).toBe("adb offline");
+    });
+});
+//# sourceMappingURL=findElementTreeReuse.test.js.map

package/build/__tests__/unit/findElementTreeReuse.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findElementTreeReuse.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/findElementTreeReuse.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;;;;;GASG;AAEH,MAAM,OAAO,GAAG;IACZ,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAC/E,QAAQ,EAAE;QACN;YACI,KAAK,EAAE,qBAAqB;YAC5B,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,cAAc;YAC1B,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;YAChD,MAAM,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;YAC1B,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,EAAE;SACb;KACJ;CAC+C,CAAC;AAErD,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACpD,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC3E,uEAAuE;QACvE,8DAA8D;QAC9D,MAAM,MAAM,GAAG,MAAM,cAAc,CAC/B,EAAE,aAAa,EAAE,UAAU,EAAE,EAC7B,sCAAsC,EACtC,OAAO,CACV,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,MAAM,GAAG,MAAM,cAAc,CAC/B,EAAE,aAAa,EAAE,aAAa,EAAE,EAChC,sCAAsC,EACtC,OAAO,CACV,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAEvD,CAAC;QACL,MAAM,MAAM,GAAG,MAAM,cAAc,CAC/B,EAAE,aAAa,EAAE,UAAU,EAAE,EAC7B,sCAAsC,EACtC,MAAM,CACT,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IACxD,MAAM,WAAW,GAAG;QAChB,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE;YACN;gBACI,IAAI,EAAE,qBAAqB;gBAC3B,UAAU,EAAE,qBAAqB;gBACjC,WAAW,EAAE,EAAE;gBACf,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;gBACjD,MAAM,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;gBAC1B,SAAS,EAAE,IAAI;aAClB;SACJ;KACmD,CAAC;IAEzD,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,MAAM,GAAG,MAAM,kBAAkB,CACnC,EAAE,YAAY,EAAE,UAAU,EAAE,EAC5B,gBAAgB,EAChB,SAAS,EACT,WAAW,CACd,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAEjD,CAAC;QACL,MAAM,MAAM,GAAG,MAAM,kBAAkB,CACnC,EAAE,YAAY,EAAE,UAAU,EAAE,EAC5B,gBAAgB,EAChB,SAAS,EACT,MAAM,CACT,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/build/__tests__/unit/settleAndDiff.test.d.ts

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

package/build/__tests__/unit/settleAndDiff.test.d.ts.map

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

package/build/__tests__/unit/settleAndDiff.test.js

@@ -0,0 +1,110 @@
+import { describe, it, expect } from "@jest/globals";
+import { settleAndDiff, SETTLE_POLL_START_MS, SETTLE_STABLE_TIMEOUT_MS, NO_CHANGE_CONFIRM_MS, } from "../../pro/verifyAction.js";
+const frame = (tag) => ({
+    buffer: Buffer.from(tag),
+    width: 100,
+    height: 200,
+    scaleFactor: 1,
+});
+/**
+ * Fake clock + fake capture/compare so the settle loop is exercised without a
+ * device. `compare` treats two buffers as "unchanged" when their bytes match,
+ * which mirrors what compareScreenshots reports for identical frames.
+ */
+function harness(script, opts = {}) {
+    const captureCostMs = opts.captureCostMs ?? 200;
+    let clock = 0;
+    let captures = 0;
+    const sleeps = [];
+    return {
+        get elapsed() { return clock; },
+        get captures() { return captures; },
+        sleeps,
+        args: {
+            beforeBuffer: Buffer.from("before"),
+            statusBarHeight: 59,
+            capture: async () => {
+                // Frames are consumed in order; the last one repeats forever.
+                const tag = script[Math.min(captures, script.length - 1)];
+                captures++;
+                clock += captureCostMs;
+                return tag === "__fail__" ? null : frame(tag);
+            },
+            compare: async (a, b) => {
+                const same = a.equals(b);
+                clock += 10;
+                return {
+                    changed: !same,
+                    changeRate: same ? 0 : 0.5,
+                    changedPixels: same ? 0 : 5000,
+                    totalPixels: 10000,
+                };
+            },
+            now: () => clock,
+            sleep: async (ms) => { sleeps.push(ms); clock += ms; },
+        },
+    };
+}
+describe("settleAndDiff", () => {
+    it("returns as soon as the screen changed and two consecutive frames match", async () => {
+        // "a" differs from before and repeats -> stable on the second capture.
+        const h = harness(["a", "a", "a", "a"]);
+        const result = await settleAndDiff(h.args);
+        expect(result).not.toBeNull();
+        expect(result.settled).toBe(true);
+        expect(result.diff.changedPixels).toBeGreaterThan(0);
+        expect(h.captures).toBe(2);
+        // 150ms lead-in + 2 captures — well under the old fixed 800ms wait.
+        expect(h.elapsed).toBeLessThan(700);
+        expect(h.sleeps[0]).toBe(SETTLE_POLL_START_MS);
+    });
+    it("keeps polling while the screen is still animating", async () => {
+        // Every frame differs from the previous one until the last pair.
+        const h = harness(["a", "b", "c", "c"]);
+        const result = await settleAndDiff(h.args);
+        expect(result.settled).toBe(true);
+        expect(result.frame.buffer.toString()).toBe("c");
+        expect(h.captures).toBe(4);
+    });
+    it("catches a late change that starts after the screen first looked idle", async () => {
+        // Identical to `before` twice (idle), then a modal slides in and settles.
+        const h = harness(["before", "before", "late", "late"]);
+        const result = await settleAndDiff(h.args);
+        expect(result.settled).toBe(true);
+        expect(result.diff.changedPixels).toBeGreaterThan(0);
+        expect(result.frame.buffer.toString()).toBe("late");
+    });
+    it("honours a caller-supplied no-change window (Android emulators animate slower)", async () => {
+        const h = harness(["before", "before", "before", "before", "before", "before", "before"]);
+        const result = await settleAndDiff({ ...h.args, noChangeConfirmMs: 1500 });
+        expect(result.diff.changedPixels).toBe(0);
+        expect(h.elapsed).toBeGreaterThanOrEqual(1500);
+    });
+    it("confirms 'no change' only after the confirmation window", async () => {
+        const h = harness(["before", "before", "before", "before", "before", "before"]);
+        const result = await settleAndDiff(h.args);
+        expect(result.settled).toBe(true);
+        expect(result.diff.changedPixels).toBe(0);
+        expect(h.elapsed).toBeGreaterThanOrEqual(NO_CHANGE_CONFIRM_MS);
+        // ...but it must not burn the full stable timeout on a quiet screen.
+        expect(h.elapsed).toBeLessThan(SETTLE_STABLE_TIMEOUT_MS + 500);
+    });
+    it("gives up at the cap when the screen never stabilises", async () => {
+        const h = harness(["a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k"]);
+        const result = await settleAndDiff(h.args);
+        expect(result.settled).toBe(false);
+        expect(result.diff).toBeDefined();
+        expect(h.elapsed).toBeLessThan(SETTLE_STABLE_TIMEOUT_MS + 600);
+    });
+    it("returns null when the first capture fails", async () => {
+        const h = harness(["__fail__"]);
+        expect(await settleAndDiff(h.args)).toBeNull();
+    });
+    it("falls back to the last good frame when a later capture fails", async () => {
+        const h = harness(["a", "__fail__"]);
+        const result = await settleAndDiff(h.args);
+        expect(result).not.toBeNull();
+        expect(result.frame.buffer.toString()).toBe("a");
+    });
+});
+//# sourceMappingURL=settleAndDiff.test.js.map

package/build/__tests__/unit/settleAndDiff.test.js.map

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

package/build/__tests__/unit/verifyAction.test.js

@@ -6,7 +6,8 @@ describe("verifyAction module", () => {
         expect(typeof mod.verifyAndCapture).toBe("function");
         expect(typeof mod.burstCaptureAndVerify).toBe("function");
         expect(typeof mod.drawTapMarker).toBe("function");
-        expect(typeof mod.SETTLE_DELAY_MS).toBe("number");
+        expect(typeof mod.settleAndDiff).toBe("function");
+        expect(typeof mod.SETTLE_POLL_START_MS).toBe("number");
         expect(typeof mod.BURST_FRAME_COUNT).toBe("number");
         expect(typeof mod.BURST_FRAME_INTERVAL_MS).toBe("number");
     });

package/build/__tests__/unit/verifyAction.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"verifyAction.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/verifyAction.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAErD,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACtD,MAAM,CAAC,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,GAAG,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,CAAC,OAAO,GAAG,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mGAAmG,EAAE,KAAK,IAAI,EAAE;QAC/G,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;YAClC,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,KAAK;YACnB,gBAAgB,EAAE,KAAK;YACvB,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,cAAc;SACzB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}
+{"version":3,"file":"verifyAction.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/verifyAction.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAErD,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACtD,MAAM,CAAC,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,GAAG,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,GAAG,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvD,MAAM,CAAC,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,CAAC,OAAO,GAAG,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mGAAmG,EAAE,KAAK,IAAI,EAAE;QAC/G,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;YAClC,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,KAAK;YACnB,gBAAgB,EAAE,KAAK;YACvB,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,cAAc;SACzB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/build/__tests__/unit/waitForMeasurements.test.d.ts

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

package/build/__tests__/unit/waitForMeasurements.test.d.ts.map

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

package/build/__tests__/unit/waitForMeasurements.test.js

@@ -0,0 +1,69 @@
+import { describe, it, expect } from "@jest/globals";
+import { waitForMeasurements, buildPendingMeasurementExpression, MEASURE_POLL_SCHEDULE_MS, MEASURE_POLL_DEADLINE_MS, } from "../../core/pressables.js";
+function harness(pendingSequence) {
+    let clock = 0;
+    let calls = 0;
+    return {
+        get elapsed() { return clock; },
+        get calls() { return calls; },
+        args: {
+            evaluatePending: async () => {
+                const v = pendingSequence[Math.min(calls, pendingSequence.length - 1)];
+                calls++;
+                clock += 15; // measured cost of the probe eval on device
+                return v;
+            },
+            now: () => clock,
+            sleep: async (ms) => { clock += ms; },
+        },
+    };
+}
+describe("waitForMeasurements", () => {
+    it("returns after the first poll when every callback already landed", async () => {
+        const h = harness([0]);
+        const result = await waitForMeasurements(h.args);
+        expect(result.pending).toBe(0);
+        expect(h.calls).toBe(1);
+        // The whole wait costs one short sleep + one probe — far below the old
+        // flat 300ms delay this replaced.
+        expect(h.elapsed).toBe(MEASURE_POLL_SCHEDULE_MS[0] + 15);
+    });
+    it("keeps polling while measurements are still outstanding", async () => {
+        const h = harness([4, 2, 0]);
+        const result = await waitForMeasurements(h.args);
+        expect(result.pending).toBe(0);
+        expect(h.calls).toBe(3);
+        expect(result.polls).toBe(3);
+    });
+    it("stops at the deadline when a callback never fires", async () => {
+        const h = harness([1]); // permanently pending
+        const result = await waitForMeasurements(h.args);
+        expect(result.pending).toBe(1);
+        // Never waits materially longer than the flat delay it replaced.
+        expect(h.elapsed).toBeLessThanOrEqual(MEASURE_POLL_DEADLINE_MS + 200);
+        expect(h.calls).toBeLessThanOrEqual(MEASURE_POLL_SCHEDULE_MS.length);
+    });
+    it("gives up immediately when the probe itself fails", async () => {
+        const h = harness([null]);
+        const result = await waitForMeasurements(h.args);
+        expect(result.pending).toBeNull();
+        expect(h.calls).toBe(1);
+    });
+});
+describe("buildPendingMeasurementExpression", () => {
+    it("counts unfilled slots across every named global", () => {
+        const expr = buildPendingMeasurementExpression(["__a", "__b"]);
+        expect(expr).toContain("globalThis.__a");
+        expect(expr).toContain("globalThis.__b");
+        // The expression must be valid, self-contained JS that reports the
+        // number of null slots — evaluate it against a stub global.
+        const globalThisStub = { __a: [{ x: 1 }, null], __b: [null] };
+        const value = new Function("globalThis", `return ${expr};`)(globalThisStub);
+        expect(value).toBe(2);
+    });
+    it("treats a missing global as nothing to wait for", () => {
+        const expr = buildPendingMeasurementExpression(["__missing"]);
+        expect(new Function("globalThis", `return ${expr};`)({})).toBe(0);
+    });
+});
+//# sourceMappingURL=waitForMeasurements.test.js.map

package/build/__tests__/unit/waitForMeasurements.test.js.map

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

package/build/core/android.d.ts

@@ -198,7 +198,9 @@ export declare function androidGetUITree(deviceId?: string, signal?: AbortSignal
 /**
  * Find element(s) in the UI tree matching the given criteria
  */
-export declare function androidFindElement(options: FindElementOptions, deviceId?: string, signal?: AbortSignal): Promise<FindElementResult>;
+/** A pre-fetched view hierarchy, as returned by androidGetUITree. */
+export type AndroidUITree = Awaited<ReturnType<typeof androidGetUITree>>;
+export declare function androidFindElement(options: FindElementOptions, deviceId?: string, signal?: AbortSignal, tree?: AndroidUITree): Promise<FindElementResult>;
 /**
  * Wait for element to appear on screen with polling
  */

package/build/core/android.d.ts.map

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

package/build/core/android.js

@@ -949,10 +949,7 @@ export async function androidGetUITree(deviceId, signal) {
         };
     }
 }
-/**
- * Find element(s) in the UI tree matching the given criteria
- */
-export async function androidFindElement(options, deviceId, signal) {
+export async function androidFindElement(options, deviceId, signal, tree) {
     try {
         // Validate that at least one search criteria is provided
         if (!options.text && !options.textContains && !options.contentDesc &&
@@ -963,7 +960,10 @@ export async function androidFindElement(options, deviceId, signal) {
                 error: "At least one search criteria (text, textContains, contentDesc, contentDescContains, or resourceId) must be provided"
             };
         }
-        const treeResult = await androidGetUITree(deviceId, signal);
+        // A caller that already dumped the hierarchy can pass it in — uiautomator
+        // dumps are the single most expensive step of an Android accessibility
+        // tap, and the tap strategy runs two passes over the same screen.
+        const treeResult = tree ?? (await androidGetUITree(deviceId, signal));
         if (!treeResult.success || !treeResult.elements) {
             return {
                 success: false,