react-native-ai-debugger 1.8.1 → 1.9.1

package/README.md

@@ -22,6 +22,12 @@ ExecBro is the runtime bridge that gives your AI coding assistant live access to
 
 Have an idea or found something that could be better? Head over to [GitHub Discussions](https://github.com/igorzheludkov/react-native-ai-devtools/discussions) to share feedback, request features, and vote on what gets built next.
 
+## Pricing
+
+ExecBro is and will remain free for typical workflows. A paid tier launches in summer 2026 with a single $9/month plan covering unlimited tool calls; the free tier will be capped at 300 tool calls / 30 days at that point. Everyone already using ExecBro before the announcement gets 3 months free of the paid tier — auto-applied via your installation ID, no action required.
+
+Full details and exact dates will be published at [execbro.com/pricing](https://execbro.com/pricing) closer to launch. Until then, nothing changes for current users.
+
 ## Features
 
 ### Runtime Interaction
@@ -37,6 +43,7 @@ Have an idea or found something that could be better? Head over to [GitHub Discu
 - **iOS Simulator** - Screenshots, app management, URL handling, boot/terminate (via simctl)
 - **Android Devices** - Screenshots, app install/launch, package management (via ADB)
 - **Unified Tap** - Single `tap` tool with automatic fallback chain: fiber tree → accessibility → OCR → coordinates. Auto-detects platform, accepts pixels from screenshots. Returns post-tap screenshot and verifies visual change by default
+- **Unified Swipe** - Single `swipe` tool that auto-routes to iOS or Android based on the connected device. Accepts screenshot pixel coordinates and handles per-platform conversion. Essential for scrolling virtualized lists (FlatList/SectionList) where off-screen items aren't in the fiber tree. Platform-specific `ios_swipe` / `android_swipe` remain available as fallbacks
 - **UI Automation** - Swipe, long press, key events, and text input on both platforms. On Bridgeless/Fabric apps, `clear_focused_input` and `dismiss_keyboard` operate on whatever has focus, and `ios_input_text` / `android_input_text` accept `replace:true` to overwrite pre-filled values — all three update React state through `onChangeText` so controlled components (Formik, react-hook-form, useState) stay consistent
 - **Accessibility Inspection** - Query UI hierarchy to find elements by text, label, or resource ID
 - **OCR Text Extraction** - Extract visible text with tap-ready coordinates via Google Cloud Vision (works on any screen content)
@@ -58,7 +65,7 @@ Have an idea or found something that could be better? Head over to [GitHub Discu
 
 ### Related
 
-- **[execbro-runner](https://github.com/igorzheludkov/execbro-runner)** *(early alpha, in active development)* — queue-based autonomous task runner built on top of ExecBro. Drop in a markdown prompt and a background daemon spins up an isolated sandbox (git worktree + simulator/emulator + Metro), runs Claude Code headlessly, has the agent verify the change live on the device via ExecBro, and optionally pushes a branch with a PR URL. Fire-and-forget Claude Code runs for your React Native app.
+- **[execbro-runner](https://github.com/igorzheludkov/execbro-runner)** _(early alpha, in active development)_ — queue-based autonomous task runner built on top of ExecBro. Drop in a markdown prompt and a background daemon spins up an isolated sandbox (git worktree + simulator/emulator + Metro), runs Claude Code headlessly, has the agent verify the change live on the device via ExecBro, and optionally pushes a branch with a PR URL. Fire-and-forget Claude Code runs for your React Native app.
 
 ## Setup
 
@@ -82,13 +89,13 @@ Or edit `~/.claude.json` (user) / `.mcp.json` (project) manually:
 
 ```json
 {
-  "mcpServers": {
-    "execbro": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "react-native-ai-devtools@latest"]
+    "mcpServers": {
+        "execbro": {
+            "type": "stdio",
+            "command": "npx",
+            "args": ["-y", "react-native-ai-devtools@latest"]
+        }
     }
-  }
 }
 ```
 
@@ -101,12 +108,12 @@ Edit the config at:
 
 ```json
 {
-  "mcpServers": {
-    "execbro": {
-      "command": "npx",
-      "args": ["-y", "react-native-ai-devtools@latest"]
+    "mcpServers": {
+        "execbro": {
+            "command": "npx",
+            "args": ["-y", "react-native-ai-devtools@latest"]
+        }
     }
-  }
 }
 ```
 
@@ -132,12 +139,12 @@ args = ["-y", "react-native-ai-devtools@latest"]
 
 ```json
 {
-  "mcpServers": {
-    "execbro": {
-      "command": "npx",
-      "args": ["-y", "react-native-ai-devtools@latest"]
+    "mcpServers": {
+        "execbro": {
+            "command": "npx",
+            "args": ["-y", "react-native-ai-devtools@latest"]
+        }
     }
-  }
 }
 ```
 
@@ -147,13 +154,13 @@ Requires VS Code 1.102+ with Copilot ([docs](https://code.visualstudio.com/docs/
 
 ```json
 {
-  "servers": {
-    "execbro": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "react-native-ai-devtools@latest"]
+    "servers": {
+        "execbro": {
+            "type": "stdio",
+            "command": "npx",
+            "args": ["-y", "react-native-ai-devtools@latest"]
+        }
     }
-  }
 }
 ```
 
@@ -163,12 +170,12 @@ Requires VS Code 1.102+ with Copilot ([docs](https://code.visualstudio.com/docs/
 
 ```json
 {
-  "mcpServers": {
-    "execbro": {
-      "command": "npx",
-      "args": ["-y", "react-native-ai-devtools@latest"]
+    "mcpServers": {
+        "execbro": {
+            "command": "npx",
+            "args": ["-y", "react-native-ai-devtools@latest"]
+        }
     }
-  }
 }
 ```
 
@@ -178,13 +185,13 @@ Requires VS Code 1.102+ with Copilot ([docs](https://code.visualstudio.com/docs/
 
 ```json
 {
-  "context_servers": {
-    "execbro": {
-      "command": "npx",
-      "args": ["-y", "react-native-ai-devtools@latest"],
-      "env": {}
+    "context_servers": {
+        "execbro": {
+            "command": "npx",
+            "args": ["-y", "react-native-ai-devtools@latest"],
+            "env": {}
+        }
     }
-  }
 }
 ```
 
@@ -194,12 +201,12 @@ Edit `~/.gemini/settings.json` (user) or `.gemini/settings.json` (project):
 
 ```json
 {
-  "mcpServers": {
-    "execbro": {
-      "command": "npx",
-      "args": ["-y", "react-native-ai-devtools@latest"]
+    "mcpServers": {
+        "execbro": {
+            "command": "npx",
+            "args": ["-y", "react-native-ai-devtools@latest"]
+        }
     }
-  }
 }
 ```
 
@@ -241,14 +248,14 @@ Opt in by setting `IOS_DRIVER=idb` in your MCP server configuration:
 
 ```json
 {
-  "mcpServers": {
-    "execbro": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "react-native-ai-devtools@latest"],
-      "env": { "IOS_DRIVER": "idb" }
+    "mcpServers": {
+        "execbro": {
+            "type": "stdio",
+            "command": "npx",
+            "args": ["-y", "react-native-ai-devtools@latest"],
+            "env": { "IOS_DRIVER": "idb" }
+        }
     }
-  }
 }
 ```
 
@@ -300,22 +307,22 @@ See the [full tool reference](docs/tools.md) for all tools with descriptions. Ke
 
 1. Start your React Native app:
 
-   ```bash
-   npm start
-   # or
-   expo start
-   ```
+    ```bash
+    npm start
+    # or
+    expo start
+    ```
 
 2. In Claude Code, scan for Metro:
 
-   ```
-   Use scan_metro to find and connect to Metro
-   ```
+    ```
+    Use scan_metro to find and connect to Metro
+    ```
 
 3. Get logs:
-   ```
-   Use get_logs to see recent console output
-   ```
+    ```
+    Use get_logs to see recent console output
+    ```
 
 ## Detailed Guides
 
@@ -346,8 +353,8 @@ See the [full tool reference](docs/tools.md) for all tools with descriptions. Ke
 2. Connects to the main JS runtime via CDP (Chrome DevTools Protocol) WebSocket
 3. Enables `Runtime.enable` to receive `Runtime.consoleAPICalled` events
 4. Network capture via two paths:
-   - **With SDK**: Reads from the SDK's in-app buffer via `Runtime.evaluate` — captures all requests from startup with full headers and bodies, including cold-start events that CDP would miss
-   - **Without SDK**: Enables CDP `Network.enable` (on supported targets) or injects a JS fetch interceptor as fallback. On cold start, events emitted before the CDP connection is established are lost; subsequent reloads capture everything
+    - **With SDK**: Reads from the SDK's in-app buffer via `Runtime.evaluate` — captures all requests from startup with full headers and bodies, including cold-start events that CDP would miss
+    - **Without SDK**: Enables CDP `Network.enable` (on supported targets) or injects a JS fetch interceptor as fallback. On cold start, events emitted before the CDP connection is established are lost; subsequent reloads capture everything
 5. Stores logs and network requests in circular buffers for retrieval
 
 ## Connection Management
@@ -453,14 +460,14 @@ To disable telemetry and auto-registration, add `RN_DEBUGGER_TELEMETRY` to the `
 
 ```json
 {
-  "mcpServers": {
-    "execbro": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "react-native-ai-devtools@latest"],
-      "env": { "RN_DEBUGGER_TELEMETRY": "false" }
+    "mcpServers": {
+        "execbro": {
+            "type": "stdio",
+            "command": "npx",
+            "args": ["-y", "react-native-ai-devtools@latest"],
+            "env": { "RN_DEBUGGER_TELEMETRY": "false" }
+        }
     }
-  }
 }
 ```
 

package/build/__tests__/integration/auto-reconnect.test.d.ts

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

package/build/__tests__/integration/auto-reconnect.test.d.ts.map

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

package/build/__tests__/integration/auto-reconnect.test.js

@@ -0,0 +1,118 @@
+import { jest, describe, it, expect, beforeAll, afterAll, beforeEach, afterEach } from "@jest/globals";
+import { connectToDevice } from "../../core/connection.js";
+import { executeInApp } from "../../core/jsExecute.js";
+import { connectedApps, pendingExecutions } from "../../core/state.js";
+import { FakeCDPServer } from "../helpers/fake-cdp-server.js";
+describe("auto-reconnect via CDP wrapper", () => {
+    let server;
+    let device;
+    beforeAll(() => {
+        jest.spyOn(console, "error").mockImplementation(() => { });
+    });
+    afterAll(() => {
+        jest.restoreAllMocks();
+    });
+    beforeEach(async () => {
+        for (const [key, app] of connectedApps.entries()) {
+            try {
+                app.ws.close();
+            }
+            catch { /* ignore */ }
+            connectedApps.delete(key);
+        }
+        pendingExecutions.clear();
+        server = new FakeCDPServer();
+        const port = await server.start();
+        device = {
+            id: "test-device",
+            title: "Hermes React Native",
+            description: "Test Device",
+            appId: "com.test.app",
+            type: "node",
+            webSocketDebuggerUrl: `${server.wsUrl}/inspector/device?page=1`,
+            deviceName: "Test",
+        };
+        await connectToDevice(device, port, {
+            reconnectionConfig: { enabled: false, maxAttempts: 0, initialDelayMs: 0, maxDelayMs: 0, backoffMultiplier: 1 },
+        });
+    });
+    afterEach(async () => {
+        const closePromises = [];
+        for (const [key, app] of connectedApps.entries()) {
+            closePromises.push(new Promise((resolve) => {
+                if (app.ws.readyState === app.ws.CLOSED) {
+                    resolve();
+                }
+                else {
+                    app.ws.on("close", () => resolve());
+                    try {
+                        app.ws.close();
+                    }
+                    catch {
+                        resolve();
+                    }
+                }
+            }));
+            connectedApps.delete(key);
+        }
+        await Promise.all(closePromises);
+        pendingExecutions.clear();
+        await server.stop();
+    });
+    it("does NOT auto-retry on logical failure (ReferenceError)", async () => {
+        server.respondWithError("ReferenceError", "__FOO__ is not defined");
+        const result = await executeInApp("__FOO__", false, {
+            maxRetries: 0,
+            originatingToolName: "execute_in_app",
+        });
+        expect(result.success).toBe(false);
+        // Logical CDP exception — outer wrapper must NOT mark _meta.reconnected.
+        expect(result._meta?.reconnected).toBeFalsy();
+        expect(result.error).not.toMatch(/^reconnect/);
+        expect(result.error).toMatch(/ReferenceError/);
+    });
+    it("does NOT auto-retry on server-side timeoutMs (logical, not transport)", async () => {
+        server.respondWithTimeout(); // never replies
+        const result = await executeInApp("blockForever()", false, {
+            maxRetries: 0,
+            timeoutMs: 300,
+            originatingToolName: "execute_in_app",
+        });
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/Timeout: Expression took too long/);
+        // Critical: a server-side timer hit is logical — no reconnect.
+        expect(result._meta?.reconnected).toBeFalsy();
+        expect(result.error).not.toMatch(/^reconnect/);
+    });
+    it("attempts reconnect on transport failure and surfaces _meta on the result", async () => {
+        // Force a transport-classified failure by closing the WebSocket before the call.
+        // executeInAppInner will return "WebSocket connection is not open." → classified as ws_closed.
+        const app = [...connectedApps.values()][0];
+        try {
+            app.ws.close();
+        }
+        catch { /* ignore */ }
+        await new Promise((r) => setTimeout(r, 50));
+        const result = await executeInApp("doSomething()", false, {
+            maxRetries: 0,
+            autoReconnect: false, // disable inner reconnect so outer wrapper's path is exercised
+            originatingToolName: "execute_in_app",
+        });
+        expect(result.success).toBe(false);
+        // The outer wrapper triggered reconnect path — Metro discovery from the test process
+        // probes real ports (8081, 8082, 19000-19002). Either outcome is acceptable:
+        //   - scan_failed → error starts "reconnect_attempted:"
+        //   - retry_failed → error starts "reconnected_but_still_failed:"
+        //   - success     → result.success === true, _meta.reconnected === true
+        // What MUST hold: _meta exists and transportError captures the original message.
+        if (result.success) {
+            expect(result._meta?.reconnected).toBe(true);
+        }
+        else {
+            expect(result.error).toMatch(/^(reconnect_attempted:|reconnected_but_still_failed:)/);
+            expect(result._meta).toBeDefined();
+            expect(result._meta?.transportError).toMatch(/WebSocket connection is not open|No apps connected/);
+        }
+    });
+});
+//# sourceMappingURL=auto-reconnect.test.js.map

package/build/__tests__/integration/auto-reconnect.test.js.map

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

package/build/__tests__/integration/execute-in-app.test.js

@@ -100,10 +100,18 @@ describe("executeInApp (integration)", () => {
         expect(expr).toContain("var global");
         expect(expr).toContain("__DEV__");
     });
-    it("rejects emoji in expression", async () => {
+    it("auto-escapes emoji inside string literals before sending", async () => {
+        server.respondWithValue("\\u{1F600}", "string");
         const result = await executeInApp("'\ud83d\ude00'", false, { timeoutMs: 5000 });
-        expect(result.success).toBe(false);
-        expect(result.error).toContain("emoji");
+        expect(result.success).toBe(true);
+        // The wire expression must be pure ASCII \u2014 emoji is rewritten to \u{...}
+        // escape sequences inside the string literal so Hermes can compile it.
+        const evalMsg = server.receivedMessages.find((m) => m.method === "Runtime.evaluate" &&
+            m.params.expression.includes("\\u{1F600}"));
+        expect(evalMsg).toBeDefined();
+        const expr = evalMsg.params.expression;
+        // The raw surrogate code units must NOT appear on the wire
+        expect(/[\uD800-\uDFFF]/.test(expr)).toBe(false);
     });
     it("handles timeout gracefully", async () => {
         // Don't respond — causes timeout

package/build/__tests__/integration/execute-in-app.test.js.map

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

package/build/__tests__/integration/per-call-timeout.test.d.ts

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

package/build/__tests__/integration/per-call-timeout.test.d.ts.map

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

package/build/__tests__/integration/per-call-timeout.test.js

@@ -0,0 +1,103 @@
+import { jest, describe, it, expect, beforeAll, afterAll, beforeEach, afterEach } from "@jest/globals";
+import { connectToDevice } from "../../core/connection.js";
+import { executeInApp } from "../../core/jsExecute.js";
+import { connectedApps, pendingExecutions } from "../../core/state.js";
+import { FakeCDPServer } from "../helpers/fake-cdp-server.js";
+describe("per-call timeoutMs", () => {
+    let server;
+    let device;
+    beforeAll(() => {
+        jest.spyOn(console, "error").mockImplementation(() => { });
+    });
+    afterAll(() => {
+        jest.restoreAllMocks();
+    });
+    beforeEach(async () => {
+        for (const [key, app] of connectedApps.entries()) {
+            try {
+                app.ws.close();
+            }
+            catch { /* ignore */ }
+            connectedApps.delete(key);
+        }
+        pendingExecutions.clear();
+        server = new FakeCDPServer();
+        const port = await server.start();
+        device = {
+            id: "test-device",
+            title: "Hermes React Native",
+            description: "Test Device",
+            appId: "com.test.app",
+            type: "node",
+            webSocketDebuggerUrl: `${server.wsUrl}/inspector/device?page=1`,
+            deviceName: "Test",
+        };
+        await connectToDevice(device, port, {
+            reconnectionConfig: { enabled: false, maxAttempts: 0, initialDelayMs: 0, maxDelayMs: 0, backoffMultiplier: 1 },
+        });
+    });
+    afterEach(async () => {
+        const closePromises = [];
+        for (const [key, app] of connectedApps.entries()) {
+            closePromises.push(new Promise((resolve) => {
+                if (app.ws.readyState === app.ws.CLOSED) {
+                    resolve();
+                }
+                else {
+                    app.ws.on("close", () => resolve());
+                    try {
+                        app.ws.close();
+                    }
+                    catch {
+                        resolve();
+                    }
+                }
+            }));
+            connectedApps.delete(key);
+        }
+        await Promise.all(closePromises);
+        pendingExecutions.clear();
+        await server.stop();
+    });
+    it("forwards timeoutMs to Runtime.evaluate as the 'timeout' field", async () => {
+        server.respondWithValue(1, "number");
+        await executeInApp("doSomething()", false, { timeoutMs: 7777, originatingToolName: "execute_in_app" });
+        // Find the non-probe Runtime.evaluate call. The probe sends "1+1"; we sent "doSomething()" which
+        // becomes wrapped with the GLOBAL_POLYFILL.
+        const evalMsg = server.receivedMessages.find((m) => m.method === "Runtime.evaluate" && typeof m.params.expression === "string"
+            && m.params.expression.includes("doSomething()"));
+        expect(evalMsg).toBeDefined();
+        expect(evalMsg.params.timeout).toBe(7777);
+    });
+    it("Promise.race fires the server-side timer at the configured timeout", async () => {
+        server.respondWithTimeout();
+        const start = Date.now();
+        const result = await executeInApp("blockForever()", false, {
+            maxRetries: 0,
+            timeoutMs: 500,
+            originatingToolName: "execute_in_app",
+        });
+        const elapsed = Date.now() - start;
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/Timeout: Expression took too long/);
+        expect(elapsed).toBeGreaterThanOrEqual(450);
+        expect(elapsed).toBeLessThan(2500);
+        // Critical: a timeoutMs hit is logical, NOT transport — no reconnect marker.
+        expect(result._meta?.reconnected).toBeFalsy();
+    });
+    it("clamps timeoutMs > 120000 and reports the original in _meta", async () => {
+        server.respondWithValue(42, "number");
+        const result = await executeInApp("getAnswer()", false, {
+            timeoutMs: 3_000_000,
+            originatingToolName: "execute_in_app",
+        });
+        expect(result.success).toBe(true);
+        expect(result._meta?.timeoutClampedFrom).toBe(3_000_000);
+        // And the forwarded Hermes-side timeout must be the clamped value, not the raw input.
+        const evalMsg = server.receivedMessages.find((m) => m.method === "Runtime.evaluate" && typeof m.params.expression === "string"
+            && m.params.expression.includes("getAnswer()"));
+        expect(evalMsg).toBeDefined();
+        expect(evalMsg.params.timeout).toBe(120000);
+    });
+});
+//# sourceMappingURL=per-call-timeout.test.js.map

package/build/__tests__/integration/per-call-timeout.test.js.map

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

package/build/__tests__/setup.js

@@ -1,9 +1,7 @@
 import { afterEach } from "@jest/globals";
-import { cancelAllReconnectionTimers, clearAllConnectionState } from "../core/connectionState.js";
-import { pendingExecutions } from "../core/state.js";
-// Ensure no reconnection timers or connection state leaks between tests,
-// even when a real Metro server is running during test execution.
-afterEach(() => {
+afterEach(async () => {
+    const { cancelAllReconnectionTimers, clearAllConnectionState } = await import("../core/connectionState.js");
+    const { pendingExecutions } = await import("../core/state.js");
     cancelAllReconnectionTimers();
     clearAllConnectionState();
     pendingExecutions.clear();

package/build/__tests__/setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,yEAAyE;AACzE,kEAAkE;AAClE,SAAS,CAAC,GAAG,EAAE;IACX,2BAA2B,EAAE,CAAC;IAC9B,uBAAuB,EAAE,CAAC;IAC1B,iBAAiB,CAAC,KAAK,EAAE,CAAC;AAC9B,CAAC,CAAC,CAAC"}
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,SAAS,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CACzE,4BAA4B,CAC/B,CAAC;IACF,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC/D,2BAA2B,EAAE,CAAC;IAC9B,uBAAuB,EAAE,CAAC;IAC1B,iBAAiB,CAAC,KAAK,EAAE,CAAC;AAC9B,CAAC,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,14 @@
+import { describe, it, expect } from "@jest/globals";
+import { buildListDebugGlobalsExpression } from "../../core/debugGlobals.js";
+describe("buildListDebugGlobalsExpression", () => {
+    it("probes globalThis.__rn__ and surfaces its keys", () => {
+        const expr = buildListDebugGlobalsExpression();
+        expect(expr).toContain("__rn__");
+        expect(expr).toMatch(/rn\s*:/);
+    });
+    it("emits a hint that mentions globalThis.__rn__", () => {
+        const expr = buildListDebugGlobalsExpression();
+        expect(expr).toContain("globalThis.__rn__");
+    });
+});
+//# sourceMappingURL=debugGlobals.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debugGlobals.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/debugGlobals.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAE7E,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACtD,MAAM,IAAI,GAAG,+BAA+B,EAAE,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,MAAM,IAAI,GAAG,+BAA+B,EAAE,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

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

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

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