execbro 1.10.22 → 1.10.24

package/README.md

@@ -34,6 +34,7 @@ Linking your installation here is also **required to unlock [ExecBro Pro](#prici
 - **JavaScript Execution** - Run code directly in your app (REPL-style) and inspect results
 - **Global State Debugging** - Discover and inspect Apollo Client, Redux stores, Expo Router, and custom globals. Wire stores and other app internals straight into the agent with the optional [SDK](#install-the-sdk-recommended) for direct, reliable state access
 - **Bundle Error Detection** - Get Metro bundler errors and compilation issues with file locations
+- **Tap-to-Source** - Point at any element with RN's Element Inspector and get back the absolute source file and line where it is rendered, resolved from the React fiber's `_debugStack` via Metro symbolication. Works on React 19, where `_debugSource` no longer exists. Selections are buffered in the background, so taps you make during a manual inspector session are captured without asking the agent first
 
 ### Device Control
 
@@ -57,7 +58,7 @@ Linking your installation here is also **required to unlock [ExecBro Pro](#prici
 - **Auto-Discovery** - Scans Metro on ports 8081, 8082, 19000-19002 automatically
 - **Multi-Device Support** - Connects to all Bridgeless targets simultaneously, with per-device log and network buffers
 - **Auto-Reconnection** - Exponential backoff (up to 8 attempts) when connection drops
-- **Efficient Buffering** - Circular buffers: 500 logs, 200 network requests
+- **Efficient Buffering** - Circular buffers: 500 logs, 200 network requests, 100 inspector selections
 - **Platform Support** - Expo SDK 54+ (Bridgeless) and React Native 0.70+ (Hermes)
 
 ## Setup

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

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

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

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

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

@@ -0,0 +1,67 @@
+import { describe, it, expect } from "@jest/globals";
+import { buildSelectionProbeExpression, buildDebugStackHarvestExpression, } from "../../core/componentSource.js";
+describe("buildSelectionProbeExpression", () => {
+    const expr = buildSelectionProbeExpression();
+    it("looks up the React DevTools hook and iterates renderer ids", () => {
+        expect(expr).toContain("__REACT_DEVTOOLS_GLOBAL_HOOK__");
+        expect(expr).toContain("getFiberRoots");
+        expect(expr).toContain("hook.renderers");
+        expect(expr).not.toMatch(/getFiberRoots\(\s*2\s*\)/);
+    });
+    it("searches for InspectorPanel", () => {
+        expect(expr).toContain("InspectorPanel");
+    });
+    it("compares by object identity against the global stash", () => {
+        expect(expr).toContain("__execbro_lastInspected");
+        expect(expr).toContain("!==");
+    });
+    it("does not measure anything (must stay cheap per tick)", () => {
+        expect(expr).not.toContain("measureInWindow");
+    });
+    it("is Hermes-safe: no arrow functions, template literals or optional chaining", () => {
+        expect(expr).not.toContain("=>");
+        expect(expr).not.toContain("?.");
+        expect(expr).not.toContain("`");
+    });
+    it("is ASCII-only", () => {
+        // eslint-disable-next-line no-control-regex
+        expect(/^[\x00-\x7F]*$/.test(expr)).toBe(true);
+    });
+});
+describe("buildDebugStackHarvestExpression", () => {
+    const expr = buildDebugStackHarvestExpression(210, 450);
+    it("evaluates to a Promise", () => {
+        expect(expr.trim().startsWith("new Promise(")).toBe(true);
+    });
+    it("interpolates the target coordinates", () => {
+        expect(expr).toContain("210");
+        expect(expr).toContain("450");
+    });
+    it("reads _debugStack and falls back to _debugSource", () => {
+        expect(expr).toContain("_debugStack");
+        expect(expr).toContain("_debugSource");
+    });
+    it("walks the return chain", () => {
+        expect(expr).toContain(".return");
+    });
+    it("measures host fibers to hit-test", () => {
+        expect(expr).toContain("measureInWindow");
+    });
+    it("handles Fabric publicInstance and string-typed host fibers", () => {
+        expect(expr).toContain("publicInstance");
+        expect(expr).toMatch(/typeof\s+\w+(\.\w+)*\s*===\s*['"]string['"]/);
+    });
+    it("defaults the ancestor cap to 30 and honours an override", () => {
+        // Real trees bury user components deep behind library wrappers — a tapped
+        // SearchBar measured 12 ancestors above the hit fiber, HomeScreen 22.
+        expect(buildDebugStackHarvestExpression(1, 2)).toContain("maxAncestors = 30");
+        expect(buildDebugStackHarvestExpression(1, 2, 3)).toContain("maxAncestors = 3");
+    });
+    it("is Hermes-safe and ASCII-only", () => {
+        expect(expr).not.toContain("=>");
+        expect(expr).not.toContain("?.");
+        // eslint-disable-next-line no-control-regex
+        expect(/^[\x00-\x7F]*$/.test(expr)).toBe(true);
+    });
+});
+//# sourceMappingURL=componentSource.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,91 @@
+import { describe, it, expect, beforeEach, jest } from "@jest/globals";
+import { resolveStacksToSource } from "../../core/componentSource.js";
+import { clearSymbolicateCache } from "../../core/symbolicate.js";
+const BUNDLE = "http://192.168.0.102:8081/AppEntry.bundle//&platform=ios&dev=true";
+function stackFor(renderSiteLine) {
+    return [
+        "Error: react-stack-top-frame",
+        `    at anonymous (${BUNDLE}:19648:90)`,
+        `    at HomeScreen (${BUNDLE}:${renderSiteLine}:64)`,
+    ].join("\n");
+}
+describe("resolveStacksToSource", () => {
+    beforeEach(() => {
+        clearSymbolicateCache();
+        globalThis.fetch = jest.fn();
+    });
+    it("resolves the render-site frame (index 1) to a user source file", async () => {
+        globalThis.fetch.mockResolvedValue({
+            ok: true,
+            json: async () => ({
+                stack: [
+                    { file: "/x/src/HomeScreen.tsx", lineNumber: 105, column: 10, methodName: "HomeScreen", collapse: false },
+                ],
+            }),
+        });
+        const out = await resolveStacksToSource([{ component: "SearchBar", stack: stackFor(342013) }]);
+        expect(out.source).toEqual({ file: "/x/src/HomeScreen.tsx", line: 105, column: 10 });
+        expect(out.sourceUnavailable).toBeUndefined();
+        // Only the render-site frame is sent, not the jsx-runtime frame.
+        const sent = JSON.parse(globalThis.fetch.mock.calls[0][1].body);
+        expect(sent.stack.length).toBe(1);
+        expect(sent.stack[0].lineNumber).toBe(342013);
+    });
+    it("returns ancestors for each component with a resolved frame", async () => {
+        globalThis.fetch.mockResolvedValue({
+            ok: true,
+            json: async () => ({
+                stack: [
+                    { file: "/x/src/HomeScreen.tsx", lineNumber: 105, column: 10, methodName: "HomeScreen", collapse: false },
+                    { file: "/x/src/HomeScreen.tsx", lineNumber: 101, column: 8, methodName: "HomeScreen", collapse: false },
+                ],
+            }),
+        });
+        const out = await resolveStacksToSource([
+            { component: "SearchBar", stack: stackFor(342013) },
+            { component: "HomeScreen", stack: stackFor(342005) },
+        ]);
+        expect(out.ancestors).toEqual([
+            { component: "SearchBar", file: "/x/src/HomeScreen.tsx", line: 105 },
+            { component: "HomeScreen", file: "/x/src/HomeScreen.tsx", line: 101 },
+        ]);
+    });
+    it("uses _debugSource directly without calling Metro", async () => {
+        const out = await resolveStacksToSource([
+            { component: "SearchBar", stack: "", file: "/x/src/HomeScreen.tsx", lineNumber: 105, column: 10 },
+        ]);
+        expect(out.source).toEqual({ file: "/x/src/HomeScreen.tsx", line: 105, column: 10 });
+        expect(globalThis.fetch.mock.calls.length).toBe(0);
+    });
+    it("reports library-only when every frame is collapsed", async () => {
+        globalThis.fetch.mockResolvedValue({
+            ok: true,
+            json: async () => ({
+                stack: [
+                    { file: "/x/node_modules/rn/ScrollView.js", lineNumber: 1942, column: 4, methodName: "Wrapper", collapse: true },
+                ],
+            }),
+        });
+        const out = await resolveStacksToSource([{ component: "ScrollView", stack: stackFor(70218) }]);
+        expect(out.source).toBeNull();
+        expect(out.sourceUnavailable).toBe("library-only");
+    });
+    it("reports symbolicate-unreachable when Metro is down", async () => {
+        globalThis.fetch.mockRejectedValue(new Error("ECONNREFUSED"));
+        const out = await resolveStacksToSource([{ component: "SearchBar", stack: stackFor(342013) }]);
+        expect(out.source).toBeNull();
+        expect(out.sourceUnavailable).toBe("symbolicate-unreachable");
+        expect(out.ancestors).toEqual([]);
+    });
+    it("reports no-debug-stack for an empty stack list", async () => {
+        const out = await resolveStacksToSource([]);
+        expect(out.source).toBeNull();
+        expect(out.sourceUnavailable).toBe("no-debug-stack");
+    });
+    it("reports no-debug-stack when stacks have no usable frames", async () => {
+        const out = await resolveStacksToSource([{ component: "X", stack: "Error: nothing here" }]);
+        expect(out.source).toBeNull();
+        expect(out.sourceUnavailable).toBe("no-debug-stack");
+    });
+});
+//# sourceMappingURL=componentSourceResolve.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,61 @@
+import { describe, it, expect, beforeEach, jest } from "@jest/globals";
+const executeInApp = jest.fn();
+jest.unstable_mockModule("../../core/jsExecute.js", () => ({
+    executeInApp,
+    markConnectionEstablished: jest.fn(),
+}));
+const { harvestStacksAtPoint, harvestStacksAtFrame } = await import("../../core/inspector.js");
+const OK = {
+    success: true,
+    result: JSON.stringify({ stacks: [{ component: "Text", stack: "Error\n    at a (http://h:8081/b:1:1)" }] }),
+};
+describe("harvestStacksAtPoint", () => {
+    beforeEach(() => {
+        executeInApp.mockReset();
+    });
+    it("returns the harvested stacks", async () => {
+        executeInApp.mockResolvedValueOnce(OK);
+        const out = await harvestStacksAtPoint(210, 450);
+        expect(out).toEqual([{ component: "Text", stack: "Error\n    at a (http://h:8081/b:1:1)" }]);
+    });
+    it("passes the coordinates into the expression", async () => {
+        executeInApp.mockResolvedValueOnce(OK);
+        await harvestStacksAtPoint(210, 450);
+        const expr = executeInApp.mock.calls[0][0];
+        expect(expr).toContain("210");
+        expect(expr).toContain("450");
+    });
+    it("returns an empty list when the evaluate fails", async () => {
+        executeInApp.mockResolvedValueOnce({ success: false, error: "disconnected" });
+        expect(await harvestStacksAtPoint(1, 2)).toEqual([]);
+    });
+    it("returns an empty list on unparseable output", async () => {
+        executeInApp.mockResolvedValueOnce({ success: true, result: "not json" });
+        expect(await harvestStacksAtPoint(1, 2)).toEqual([]);
+    });
+    it("returns an empty list when the evaluate throws", async () => {
+        executeInApp.mockRejectedValueOnce(new Error("boom"));
+        expect(await harvestStacksAtPoint(1, 2)).toEqual([]);
+    });
+});
+describe("harvestStacksAtFrame", () => {
+    beforeEach(() => {
+        executeInApp.mockReset();
+    });
+    it("harvests at the centre of the frame", async () => {
+        executeInApp.mockResolvedValueOnce(OK);
+        await harvestStacksAtFrame({ left: 100, top: 200, width: 50, height: 20 });
+        const expr = executeInApp.mock.calls[0][0];
+        expect(expr).toContain("125");
+        expect(expr).toContain("210");
+    });
+    it("returns an empty list without evaluating for a null frame", async () => {
+        expect(await harvestStacksAtFrame(null)).toEqual([]);
+        expect(executeInApp.mock.calls.length).toBe(0);
+    });
+    it("returns an empty list without evaluating for an incomplete frame", async () => {
+        expect(await harvestStacksAtFrame({ left: 1, top: 2 })).toEqual([]);
+        expect(executeInApp.mock.calls.length).toBe(0);
+    });
+});
+//# sourceMappingURL=inspectorHarvest.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,74 @@
+import { describe, it, expect, beforeEach, jest } from "@jest/globals";
+import { enrichWithSource, getSelectionHistory } from "../../core/inspector.js";
+import { selectionBuffer } from "../../core/selectionBuffer.js";
+import { clearSymbolicateCache } from "../../core/symbolicate.js";
+const BUNDLE = "http://192.168.0.102:8081/AppEntry.bundle//&platform=ios";
+const STACK = ["Error: top", `    at anonymous (${BUNDLE}:1:1)`, `    at HomeScreen (${BUNDLE}:342013:64)`].join("\n");
+describe("enrichWithSource", () => {
+    beforeEach(() => {
+        clearSymbolicateCache();
+        globalThis.fetch = jest.fn();
+    });
+    it("adds source and ancestors to the payload", async () => {
+        globalThis.fetch.mockResolvedValue({
+            ok: true,
+            json: async () => ({
+                stack: [{ file: "/x/Home.tsx", lineNumber: 105, column: 10, methodName: "HomeScreen", collapse: false }],
+            }),
+        });
+        const out = await enrichWithSource({ element: "Text" }, [{ component: "Text", stack: STACK }]);
+        expect(out.element).toBe("Text");
+        expect(out.source).toEqual({ file: "/x/Home.tsx", line: 105, column: 10 });
+        expect(out.ancestors).toEqual([{ component: "Text", file: "/x/Home.tsx", line: 105 }]);
+    });
+    it("preserves the payload and attaches a reason when unavailable", async () => {
+        const out = await enrichWithSource({ element: "Text", path: "a > b" }, []);
+        expect(out.element).toBe("Text");
+        expect(out.path).toBe("a > b");
+        expect(out.source).toBeUndefined();
+        expect(out.sourceUnavailable).toBe("no-debug-stack");
+    });
+    it("never throws when Metro is unreachable", async () => {
+        globalThis.fetch.mockRejectedValue(new Error("ECONNREFUSED"));
+        const out = await enrichWithSource({ element: "Text" }, [{ component: "Text", stack: STACK }]);
+        expect(out.element).toBe("Text");
+        expect(out.sourceUnavailable).toBe("symbolicate-unreachable");
+    });
+});
+describe("getSelectionHistory", () => {
+    beforeEach(() => {
+        clearSymbolicateCache();
+        selectionBuffer.clear();
+        globalThis.fetch = jest.fn();
+    });
+    it("returns buffered entries newest first with resolved source", async () => {
+        globalThis.fetch.mockResolvedValue({
+            ok: true,
+            json: async () => ({
+                stack: [{ file: "/x/Home.tsx", lineNumber: 105, column: 10, methodName: "HomeScreen", collapse: false }],
+            }),
+        });
+        selectionBuffer.add({
+            id: "s1", device: "iPhone Air", timestamp: 1,
+            element: "Text", path: "App > Text", hierarchy: ["App", "Text"],
+            frame: { left: 1, top: 2, width: 3, height: 4 }, style: null,
+            stacks: [{ component: "Text", stack: STACK }],
+        });
+        const out = await getSelectionHistory({ limit: 5 });
+        expect(out.length).toBe(1);
+        expect(out[0].element).toBe("Text");
+        expect(out[0].source).toEqual({ file: "/x/Home.tsx", line: 105, column: 10 });
+    });
+    it("returns an empty array when the buffer is empty", async () => {
+        expect(await getSelectionHistory({})).toEqual([]);
+    });
+    it("filters by device", async () => {
+        selectionBuffer.add({
+            id: "s1", device: "Pixel 7", timestamp: 1, element: "A", path: "A",
+            hierarchy: ["A"], frame: null, style: null, stacks: [],
+        });
+        expect((await getSelectionHistory({ device: "iPhone Air" })).length).toBe(0);
+        expect((await getSelectionHistory({ device: "Pixel 7" })).length).toBe(1);
+    });
+});
+//# sourceMappingURL=inspectorSource.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,86 @@
+import { describe, it, expect, beforeEach } from "@jest/globals";
+import { SelectionBuffer } from "../../core/selectionBuffer.js";
+let counter = 0;
+function makeEntry(overrides = {}) {
+    counter += 1;
+    return {
+        id: overrides.id ?? `sel-${counter}`,
+        device: overrides.device ?? "iPhone Air",
+        timestamp: overrides.timestamp ?? 1000 + counter,
+        element: overrides.element ?? "Text",
+        path: overrides.path ?? "App > HomeScreen > Text",
+        hierarchy: overrides.hierarchy ?? ["App", "HomeScreen", "Text"],
+        frame: overrides.frame ?? { left: 10, top: 20, width: 30, height: 40 },
+        style: overrides.style ?? null,
+        stacks: overrides.stacks ?? [],
+    };
+}
+describe("SelectionBuffer", () => {
+    let buffer;
+    beforeEach(() => {
+        buffer = new SelectionBuffer(3);
+    });
+    it("starts empty", () => {
+        expect(buffer.size).toBe(0);
+        expect(buffer.list()).toEqual([]);
+        expect(buffer.latest()).toBeUndefined();
+    });
+    it("adds an entry and reports it as accepted", () => {
+        expect(buffer.add(makeEntry({ id: "a" }))).toBe(true);
+        expect(buffer.size).toBe(1);
+    });
+    it("evicts oldest beyond max size", () => {
+        buffer.add(makeEntry({ id: "a", path: "p-a" }));
+        buffer.add(makeEntry({ id: "b", path: "p-b" }));
+        buffer.add(makeEntry({ id: "c", path: "p-c" }));
+        buffer.add(makeEntry({ id: "d", path: "p-d" }));
+        expect(buffer.size).toBe(3);
+        expect(buffer.list().map((e) => e.id)).toEqual(["d", "c", "b"]);
+    });
+    it("lists newest first", () => {
+        buffer.add(makeEntry({ id: "a", path: "p-a" }));
+        buffer.add(makeEntry({ id: "b", path: "p-b" }));
+        expect(buffer.list().map((e) => e.id)).toEqual(["b", "a"]);
+    });
+    it("rejects a duplicate of the most recent entry on the same device", () => {
+        buffer.add(makeEntry({ id: "a", path: "same", frame: { left: 1, top: 2, width: 3, height: 4 } }));
+        const accepted = buffer.add(makeEntry({ id: "b", path: "same", frame: { left: 1, top: 2, width: 3, height: 4 } }));
+        expect(accepted).toBe(false);
+        expect(buffer.size).toBe(1);
+    });
+    it("accepts a repeat of the same element on a different device", () => {
+        buffer.add(makeEntry({ id: "a", path: "same", device: "iPhone Air" }));
+        const accepted = buffer.add(makeEntry({ id: "b", path: "same", device: "Pixel 7" }));
+        expect(accepted).toBe(true);
+        expect(buffer.size).toBe(2);
+    });
+    it("accepts the same path again once another selection intervened", () => {
+        buffer.add(makeEntry({ id: "a", path: "one" }));
+        buffer.add(makeEntry({ id: "b", path: "two" }));
+        expect(buffer.add(makeEntry({ id: "c", path: "one" }))).toBe(true);
+        expect(buffer.size).toBe(3);
+    });
+    it("filters by device", () => {
+        buffer.add(makeEntry({ id: "a", device: "iPhone Air", path: "p-a" }));
+        buffer.add(makeEntry({ id: "b", device: "Pixel 7", path: "p-b" }));
+        expect(buffer.list({ device: "Pixel 7" }).map((e) => e.id)).toEqual(["b"]);
+    });
+    it("honours limit", () => {
+        buffer.add(makeEntry({ id: "a", path: "p-a" }));
+        buffer.add(makeEntry({ id: "b", path: "p-b" }));
+        expect(buffer.list({ limit: 1 }).map((e) => e.id)).toEqual(["b"]);
+    });
+    it("latest respects the device filter", () => {
+        buffer.add(makeEntry({ id: "a", device: "iPhone Air", path: "p-a" }));
+        buffer.add(makeEntry({ id: "b", device: "Pixel 7", path: "p-b" }));
+        expect(buffer.latest("iPhone Air").id).toBe("a");
+        expect(buffer.latest().id).toBe("b");
+    });
+    it("clear empties the buffer", () => {
+        buffer.add(makeEntry({ id: "a" }));
+        buffer.clear();
+        expect(buffer.size).toBe(0);
+        expect(buffer.latest()).toBeUndefined();
+    });
+});
+//# sourceMappingURL=selectionBuffer.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,109 @@
+import { describe, it, expect, beforeEach, afterEach, jest } from "@jest/globals";
+const executeInApp = jest.fn();
+jest.unstable_mockModule("../../core/jsExecute.js", () => ({ executeInApp }));
+const { pollOnce, startSelectionPoller, stopSelectionPoller, isSelectionPollerRunning } = await import("../../core/selectionPoller.js");
+const { selectionBuffer } = await import("../../core/selectionBuffer.js");
+function probeResult(overrides = {}) {
+    return {
+        success: true,
+        result: JSON.stringify({
+            active: true,
+            selected: true,
+            changed: true,
+            element: "Text",
+            path: "App > HomeScreen > Text",
+            hierarchy: ["App", "HomeScreen", "Text"],
+            frame: { left: 100, top: 200, width: 50, height: 20 },
+            style: { fontSize: 17 },
+            ...overrides,
+        }),
+    };
+}
+function harvestResult() {
+    return {
+        success: true,
+        result: JSON.stringify({
+            stacks: [{ component: "Text", stack: "Error\n    at anonymous (http://h:8081/b:1:1)" }],
+        }),
+    };
+}
+describe("selectionPoller", () => {
+    beforeEach(() => {
+        executeInApp.mockReset();
+        selectionBuffer.clear();
+        delete process.env.EXECBRO_DISABLE_SELECTION_POLL;
+    });
+    afterEach(() => {
+        stopSelectionPoller("iPhone Air");
+    });
+    it("buffers an entry when the probe reports a change", async () => {
+        executeInApp.mockResolvedValueOnce(probeResult()).mockResolvedValueOnce(harvestResult());
+        const buffered = await pollOnce("iPhone Air");
+        expect(buffered).toBe(true);
+        expect(selectionBuffer.size).toBe(1);
+        const entry = selectionBuffer.latest();
+        expect(entry.element).toBe("Text");
+        expect(entry.device).toBe("iPhone Air");
+        expect(entry.stacks.length).toBe(1);
+    });
+    it("harvests at the centre of the inspected frame", async () => {
+        executeInApp.mockResolvedValueOnce(probeResult()).mockResolvedValueOnce(harvestResult());
+        await pollOnce("iPhone Air");
+        // frame {left:100, top:200, width:50, height:20} -> centre (125, 210)
+        const harvestExpr = executeInApp.mock.calls[1][0];
+        expect(harvestExpr).toContain("125");
+        expect(harvestExpr).toContain("210");
+    });
+    it("does not harvest when nothing changed", async () => {
+        executeInApp.mockResolvedValueOnce({
+            success: true,
+            result: JSON.stringify({ active: true, selected: true, changed: false }),
+        });
+        const buffered = await pollOnce("iPhone Air");
+        expect(buffered).toBe(false);
+        expect(executeInApp.mock.calls.length).toBe(1);
+        expect(selectionBuffer.size).toBe(0);
+    });
+    it("does not harvest when the inspector is not mounted", async () => {
+        executeInApp.mockResolvedValueOnce({
+            success: true,
+            result: JSON.stringify({ active: false, selected: false, changed: false }),
+        });
+        expect(await pollOnce("iPhone Air")).toBe(false);
+        expect(executeInApp.mock.calls.length).toBe(1);
+    });
+    it("still buffers when the harvest fails, with empty stacks", async () => {
+        executeInApp
+            .mockResolvedValueOnce(probeResult())
+            .mockResolvedValueOnce({ success: false, error: "timeout" });
+        expect(await pollOnce("iPhone Air")).toBe(true);
+        expect(selectionBuffer.latest().stacks).toEqual([]);
+    });
+    it("buffers without harvesting when the frame is null", async () => {
+        executeInApp.mockResolvedValueOnce(probeResult({ frame: null }));
+        expect(await pollOnce("iPhone Air")).toBe(true);
+        expect(executeInApp.mock.calls.length).toBe(1);
+        expect(selectionBuffer.latest().stacks).toEqual([]);
+    });
+    it("swallows a failed probe without throwing", async () => {
+        executeInApp.mockResolvedValueOnce({ success: false, error: "disconnected" });
+        await expect(pollOnce("iPhone Air")).resolves.toBe(false);
+    });
+    it("swallows unparseable probe output", async () => {
+        executeInApp.mockResolvedValueOnce({ success: true, result: "not json" });
+        await expect(pollOnce("iPhone Air")).resolves.toBe(false);
+    });
+    it("does not start when disabled by env var", () => {
+        process.env.EXECBRO_DISABLE_SELECTION_POLL = "1";
+        startSelectionPoller("iPhone Air");
+        expect(isSelectionPollerRunning("iPhone Air")).toBe(false);
+    });
+    it("start is idempotent and stop halts it", () => {
+        startSelectionPoller("iPhone Air");
+        startSelectionPoller("iPhone Air");
+        expect(isSelectionPollerRunning("iPhone Air")).toBe(true);
+        stopSelectionPoller("iPhone Air");
+        expect(isSelectionPollerRunning("iPhone Air")).toBe(false);
+    });
+});
+//# sourceMappingURL=selectionPoller.test.js.map

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

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

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

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

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

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