rnxsim 0.1.380 → 0.1.382

package/cli/ws-bridge.ts

@@ -1,10 +1,10 @@
-// sootsim CLI ↔ sim WS bridge
+// rnx CLI ↔ sim WS bridge
 //
 // the rnx runtime opens a WebSocket server (default port 7668) that
 // accepts JSON commands like `{ type: 'evaluate', code: 'window.__sootsimTest.getNodeCount()' }`
 // or `{ type: 'call', path: 'SootSim.bridges.mainShell.launchApp', args: ['photos'] }`
 // and responds with `{ id, result }` or `{ id, error }`. CLI commands use
-// this to drive a running sootsim instance from the terminal.
+// this to drive a running rnx instance from the terminal.
 
 import fs from 'node:fs'
 import path from 'node:path'
@@ -22,7 +22,13 @@ import {
   rnxHomeDir,
   type DevBridgeLockfile,
 } from '../src/home-paths'
-import { clearCurrentSimId, getCliIdentity, readCurrentSimId } from './current-sim'
+import { createCloudBridgeForParsed } from './cloud-client'
+import {
+  clearCurrentSimId,
+  getCliIdentity,
+  readCurrentSim,
+  readCurrentSimId,
+} from './current-sim'
 
 // --- bridge world resolution ---------------------------------------------
 //
@@ -279,6 +285,7 @@ export function printBridgeWorldNotice(
 }
 
 export interface WsBridge {
+  readonly plane?: 'local' | 'cloud'
   // `opts.timeoutMs` overrides the bridge-wide commandTimeoutMs for a single
   // call — used for fast readiness probes so a dead/unresponsive sim fails in
   // seconds instead of stalling the full command timeout.
@@ -423,7 +430,7 @@ export function parseBridgeCliArgs(
       continue
     }
     // `--sim` is the canonical target flag; `--session` / `--tab` are
-    // documented aliases (CLAUDE.md, the SootSim agent skills, and engine docs all
+    // documented aliases (CLAUDE.md, the rnx agent skills, and engine docs all
     // say `--session <id>`). without these aliases an agent following the docs
     // would have `--session ef` silently ignored and get the *currently
     // pinned* sim's tree instead — wrong-app data with no error. accept the
@@ -465,9 +472,9 @@ export function parseBridgeCliArgs(
   }
 
   if (!simId) {
-    const savedSimId = readCurrentSimId()
-    if (savedSimId) {
-      simId = savedSimId.trim() || undefined
+    const savedSim = readCurrentSim()
+    if (savedSim) {
+      simId = savedSim.simId.trim() || undefined
       simIdSource = 'saved'
     }
   }
@@ -601,6 +608,7 @@ export function createBridge(wsPort: number, opts: WsBridgeOptions = {}): WsBrid
   })
 
   return {
+    plane: 'local',
     async send(cmd, callOpts) {
       // NOTE: `opts` (the createBridge closure arg) carries simId; do not
       // shadow it with the per-call arg.
@@ -711,6 +719,8 @@ export function createBridge(wsPort: number, opts: WsBridgeOptions = {}): WsBrid
 }
 
 export function createBridgeFromParsed(parsed: ParsedBridgeCliArgs): WsBridge {
+  const cloudBridge = createCloudBridgeForParsed(parsed)
+  if (cloudBridge) return cloudBridge
   return createBridge(parsed.wsPort, {
     commandTimeoutMs: parsed.commandTimeoutMs,
     simId: parsed.simId,
@@ -792,7 +802,7 @@ export async function checkSimHealth(
 }
 
 /**
- * Convenience: run arbitrary JavaScript in the sootsim page and return the
+ * Convenience: run arbitrary JavaScript in the rnx page and return the
  * result. Hides the `type: 'evaluate'` message shape. Read-only by default —
  * pass `{ acquireLock: true }` when the eval mutates user-facing state so
  * the server takes/refreshes the cli lease and blocks concurrent agents.

package/detox/expectations.ts

@@ -5,7 +5,7 @@
 import { dragScrollNode } from './gestures'
 import type { SootSimElement } from './element-types'
 import type { Matcher } from './matchers'
-import type { SootSimNodeInfo } from '@sootsim/globals'
+import type { SootSimNodeInfo } from '@rnx/globals'
 import type { Page } from 'playwright'
 
 type FindFn = (matcher: Matcher) => Promise<any>

package/detox/gestures.ts

@@ -1,9 +1,9 @@
 import { pollUntil } from '../src/poll-until'
-// pull in @sootsim/globals so window.__sootsimTest and
+// pull in @rnx/globals so window.__sootsimTest and
 // window.__sootsimFindInteractiveCanvas are typed inside page.evaluate
 // bodies. all sootsim-namespaced globals are declared canonically there —
-// add new entries to packages/sootsim-globals/src/index.ts, not here.
-import type {} from '@sootsim/globals'
+// add new entries to packages/rnx-globals/src/index.ts, not here.
+import type {} from '@rnx/globals'
 import type { Page } from 'playwright'
 
 // shape of the surface-metrics bridge response we care about. the bridge

package/detox/index.ts

@@ -1427,8 +1427,8 @@ export const device = {
   },
 
   // record the SootSim canvas via the engine's headless recorder
-  // (window.__sootsimRecorder — @sootsim/plugin-recording). this is the
-  // SAME code path `sootsim record video` drives, NOT the rail-button
+  // (window.__sootsimRecorder — @rnx/plugin-recording). this is the
+  // SAME code path `rnx record video` drives, NOT the rail-button
   // path (SootSim.bridges.startRecording wires the dialog state machine
   // and never stashes the resulting blob into __sootsimRecorder.lastBlob,
   // which is what getBlobBase64 streams from).
@@ -1471,7 +1471,7 @@ export const device = {
   },
 
   // stop the headless recorder, stream the resulting blob in chunks (same
-  // protocol as `sootsim record`), and write the webm to outPath.
+  // protocol as `rnx record`), and write the webm to outPath.
   async stopAndSaveBridgeRecording(outPath: string): Promise<string> {
     const page = getPage()
     const stopResult = await page.evaluate(async () => {

package/dist-lib/agent-daemon-client.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/agent-events.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/agent-identity.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/agent-sessions.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/attached-projects.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/auth/shared-session.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/backend-origin.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/beta.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/beta.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/beta.ts
 var IS_BETA = true;

package/dist-lib/bridge-constants.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/bridge-contract-input.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;
@@ -197,8 +197,10 @@ function parseStateOptions(value) {
   const input = recordValue(value, "state");
   const route = optionalBoolean(input, "route", "state");
   const errors = optionalBoolean(input, "errors", "state");
+  const logs = optionalBoolean(input, "logs", "state");
   const depth = optionalNumber(input, "depth", "state");
   const errorLimit = optionalNumber(input, "errorLimit", "state");
+  const logLimit = optionalNumber(input, "logLimit", "state");
   const layers = input.layers === void 0 ? void 0 : stringValue(input.layers, "state.layers");
   if (layers !== void 0 && layers !== "full" && layers !== "tenant" && layers !== "shell") {
     return validationFailure("state.layers", "must be full, tenant, or shell");
@@ -208,9 +210,11 @@ function parseStateOptions(value) {
     tree: optionalBoolean(input, "tree", "state") ?? true,
     ...route === void 0 ? {} : { route },
     ...errors === void 0 ? {} : { errors },
+    ...logs === void 0 ? {} : { logs },
     ...depth === void 0 ? {} : { depth },
     ...layers === void 0 ? {} : { layers },
-    ...errorLimit === void 0 ? {} : { errorLimit }
+    ...errorLimit === void 0 ? {} : { errorLimit },
+    ...logLimit === void 0 ? {} : { logLimit }
   };
 }
 function parseSemanticSelector(value, path) {
@@ -257,15 +261,18 @@ function parseSemanticQuery(value) {
   }
   return validationFailure("query.kind", "must be tree, find, or count");
 }
-function parseSemanticResolveSelector(value) {
-  const selector = recordValue(value, "selector");
+function semanticResolveSelector(value, path) {
+  const selector = recordValue(value, path);
   if (selector.testID !== void 0) {
-    return { testID: stringValue(selector.testID, "selector.testID") };
+    return { testID: stringValue(selector.testID, `${path}.testID`) };
   }
   if (selector.text !== void 0) {
-    return { text: stringValue(selector.text, "selector.text") };
+    return { text: stringValue(selector.text, `${path}.text`) };
   }
-  return validationFailure("selector", "must select testID or text");
+  return validationFailure(path, "must select testID or text");
+}
+function parseSemanticResolveSelector(value) {
+  return semanticResolveSelector(value, "selector");
 }
 function parseSemanticWaitOptions(value) {
   const input = recordValue(value, "waitFor");
@@ -287,7 +294,7 @@ function parseSemanticWaitOptions(value) {
   return {
     condition: {
       type,
-      testID: stringValue(condition.testID, "waitFor.condition.testID")
+      selector: semanticResolveSelector(condition.selector, "waitFor.condition.selector")
     },
     ...timeoutMs === void 0 ? {} : { timeoutMs }
   };

package/dist-lib/bridge-contract-input.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract-input.ts
 var BridgeInputError = class extends Error {
@@ -165,8 +165,10 @@ function parseStateOptions(value) {
   const input = recordValue(value, "state");
   const route = optionalBoolean(input, "route", "state");
   const errors = optionalBoolean(input, "errors", "state");
+  const logs = optionalBoolean(input, "logs", "state");
   const depth = optionalNumber(input, "depth", "state");
   const errorLimit = optionalNumber(input, "errorLimit", "state");
+  const logLimit = optionalNumber(input, "logLimit", "state");
   const layers = input.layers === void 0 ? void 0 : stringValue(input.layers, "state.layers");
   if (layers !== void 0 && layers !== "full" && layers !== "tenant" && layers !== "shell") {
     return validationFailure("state.layers", "must be full, tenant, or shell");
@@ -176,9 +178,11 @@ function parseStateOptions(value) {
     tree: optionalBoolean(input, "tree", "state") ?? true,
     ...route === void 0 ? {} : { route },
     ...errors === void 0 ? {} : { errors },
+    ...logs === void 0 ? {} : { logs },
     ...depth === void 0 ? {} : { depth },
     ...layers === void 0 ? {} : { layers },
-    ...errorLimit === void 0 ? {} : { errorLimit }
+    ...errorLimit === void 0 ? {} : { errorLimit },
+    ...logLimit === void 0 ? {} : { logLimit }
   };
 }
 function parseSemanticSelector(value, path) {
@@ -225,15 +229,18 @@ function parseSemanticQuery(value) {
   }
   return validationFailure("query.kind", "must be tree, find, or count");
 }
-function parseSemanticResolveSelector(value) {
-  const selector = recordValue(value, "selector");
+function semanticResolveSelector(value, path) {
+  const selector = recordValue(value, path);
   if (selector.testID !== void 0) {
-    return { testID: stringValue(selector.testID, "selector.testID") };
+    return { testID: stringValue(selector.testID, `${path}.testID`) };
   }
   if (selector.text !== void 0) {
-    return { text: stringValue(selector.text, "selector.text") };
+    return { text: stringValue(selector.text, `${path}.text`) };
   }
-  return validationFailure("selector", "must select testID or text");
+  return validationFailure(path, "must select testID or text");
+}
+function parseSemanticResolveSelector(value) {
+  return semanticResolveSelector(value, "selector");
 }
 function parseSemanticWaitOptions(value) {
   const input = recordValue(value, "waitFor");
@@ -255,7 +262,7 @@ function parseSemanticWaitOptions(value) {
   return {
     condition: {
       type,
-      testID: stringValue(condition.testID, "waitFor.condition.testID")
+      selector: semanticResolveSelector(condition.selector, "waitFor.condition.selector")
     },
     ...timeoutMs === void 0 ? {} : { timeoutMs }
   };

package/dist-lib/bridge-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/bridge-contract.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var SEMANTIC_READY_CONTENT_NODE_FLOOR = 100;

package/dist-lib/capture-contract.cjs

@@ -0,0 +1,107 @@
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/capture-contract.ts
+var capture_contract_exports = {};
+__export(capture_contract_exports, {
+  RNX_SCREEN_CAPTURE_VERSION: () => RNX_SCREEN_CAPTURE_VERSION,
+  isRnxCaptureRegionAtlas: () => isRnxCaptureRegionAtlas,
+  isRnxScreenCapture: () => isRnxScreenCapture
+});
+module.exports = __toCommonJS(capture_contract_exports);
+var RNX_SCREEN_CAPTURE_VERSION = 1;
+function captureRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function captureInteger(value) {
+  return typeof value === "number" && Number.isSafeInteger(value);
+}
+function captureNumber(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+function captureNullableString(value) {
+  return value === null || typeof value === "string";
+}
+function captureRect(value) {
+  return captureRecord(value) && captureNumber(value.x) && captureNumber(value.y) && captureNumber(value.width) && captureNumber(value.height);
+}
+function captureOptionalString(value) {
+  return value === void 0 || typeof value === "string";
+}
+function captureOptionalNullableString(value) {
+  return value === void 0 || captureNullableString(value);
+}
+function captureFontRegistration(value) {
+  return captureRecord(value) && typeof value.family === "string" && value.family.length > 0 && captureOptionalString(value.url) && captureOptionalString(value.sourceLabel) && captureOptionalNullableString(value.parsedFamily) && captureOptionalNullableString(value.parsedPostScript) && captureOptionalNullableString(value.fullName);
+}
+function capturePoint(value) {
+  return captureRecord(value) && captureNumber(value.x) && captureNumber(value.y);
+}
+function captureNode(value) {
+  if (!captureRecord(value) || !captureInteger(value.nodeId) || !(value.parentNodeId === null || captureInteger(value.parentNodeId)) || !Array.isArray(value.childNodeIds) || !value.childNodeIds.every(captureInteger) || !captureInteger(value.paintIndex) || typeof value.type !== "string" || !captureNullableString(value.id) || !captureNullableString(value.testID) || !captureNullableString(value.text) || !captureInteger(value.childCount) || !captureRecord(value.accessibility) || !captureRecord(value.interaction) || !captureRecord(value.layout) || !captureRecord(value.style) || !captureRecord(value.source) || !captureRecord(value.props) || !captureRecord(value.inspection)) {
+    return false;
+  }
+  const accessibility = value.accessibility;
+  if (typeof accessibility.accessible !== "boolean" || !captureNullableString(accessibility.label) || !captureNullableString(accessibility.role) || !captureNullableString(accessibility.hint) || !(accessibility.liveRegion === null || accessibility.liveRegion === "none" || accessibility.liveRegion === "polite" || accessibility.liveRegion === "assertive") || !(accessibility.state === null || captureRecord(accessibility.state)) || !(accessibility.value === null || captureRecord(accessibility.value))) {
+    return false;
+  }
+  const interaction = value.interaction;
+  if (typeof interaction.pressed !== "boolean" || typeof interaction.pressable !== "boolean" || typeof interaction.textInput !== "boolean" || !(interaction.textSelection === null || captureRecord(interaction.textSelection)) || typeof interaction.secureTextEntry !== "boolean" || !captureNullableString(interaction.placeholder) || !capturePoint(interaction.scrollOffset) || !(interaction.zoomScale === null || captureNumber(interaction.zoomScale)) || typeof interaction.nativePinchEnabled !== "boolean" || !(interaction.contentOffsetProp === null || captureRecord(interaction.contentOffsetProp)) || !(interaction.strokeDashoffsetProp === null || captureNumber(interaction.strokeDashoffsetProp))) {
+    return false;
+  }
+  const layout = value.layout;
+  if (!captureRect(layout.local) || !(layout.frame === null || captureRect(layout.frame)) || !capturePoint(layout.absolutePosition) || !(layout.visibleFrame === null || captureRect(layout.visibleFrame))) {
+    return false;
+  }
+  const style = value.style;
+  return captureRecord(style.resolved) && captureRecord(style.authored) && captureRecord(style.computed) && captureRecord(style.tokenBindings) && (value.textLines === void 0 || Array.isArray(value.textLines));
+}
+function isRnxScreenCapture(value) {
+  if (!captureRecord(value) || value.contractVersion !== RNX_SCREEN_CAPTURE_VERSION || !captureInteger(value.capturedAt) || !captureRecord(value.tree) || !(value.fonts === void 0 || Array.isArray(value.fonts) && value.fonts.length <= 200 && value.fonts.every(captureFontRegistration)) || !(value.visual === void 0 || captureRecord(value.visual))) {
+    return false;
+  }
+  const tree = value.tree;
+  const visual = value.visual;
+  return captureRecord(tree.viewport) && captureInteger(tree.viewport.width) && tree.viewport.width > 0 && captureInteger(tree.viewport.height) && tree.viewport.height > 0 && captureInteger(tree.rootNodeId) && Array.isArray(tree.nodes) && tree.nodes.every(captureNode) && (visual === void 0 || visual.kind === "png" && (visual.producer === "headless-cpu-app-surface" || visual.producer === "browser-compositor-app-surface") && typeof visual.dataUri === "string" && visual.dataUri.startsWith("data:image/png;base64,") && captureInteger(visual.pixelWidth) && visual.pixelWidth > 0 && captureInteger(visual.pixelHeight) && visual.pixelHeight > 0);
+}
+function isRnxCaptureRegionAtlas(value) {
+  if (!captureRecord(value) || value.kind !== "png-atlas" || value.producer !== "headless-cpu-app-surface" || typeof value.dataUri !== "string" || !value.dataUri.startsWith("data:image/png;base64,") || !captureNumber(value.width) || value.width <= 0 || !captureNumber(value.height) || value.height <= 0 || !captureInteger(value.pixelWidth) || value.pixelWidth <= 0 || !captureInteger(value.pixelHeight) || value.pixelHeight <= 0 || !Array.isArray(value.regions) || value.regions.length === 0 || value.regions.length > 256) {
+    return false;
+  }
+  const scale = value.pixelWidth / value.width;
+  if (!Number.isInteger(scale) || scale < 1 || scale > 4 || Math.abs(value.height * scale - value.pixelHeight) > 1e-6) {
+    return false;
+  }
+  const keys = /* @__PURE__ */ new Set();
+  for (const region of value.regions) {
+    if (!captureRecord(region) || typeof region.key !== "string" || region.key.length === 0 || keys.has(region.key) || !captureInteger(region.nodeId) || region.nodeId <= 0 || !captureRect(region.frame) || region.frame.width <= 0 || region.frame.height <= 0 || !captureRect(region.source) || region.source.x < 0 || region.source.y < 0 || region.source.width !== region.frame.width || region.source.height !== region.frame.height || region.source.x + region.source.width > value.width || region.source.y + region.source.height > value.height) {
+      return false;
+    }
+    keys.add(region.key);
+  }
+  return true;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RNX_SCREEN_CAPTURE_VERSION,
+  isRnxCaptureRegionAtlas,
+  isRnxScreenCapture
+});

package/dist-lib/capture-contract.mjs

@@ -0,0 +1,80 @@
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+
+// src/capture-contract.ts
+var RNX_SCREEN_CAPTURE_VERSION = 1;
+function captureRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function captureInteger(value) {
+  return typeof value === "number" && Number.isSafeInteger(value);
+}
+function captureNumber(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+function captureNullableString(value) {
+  return value === null || typeof value === "string";
+}
+function captureRect(value) {
+  return captureRecord(value) && captureNumber(value.x) && captureNumber(value.y) && captureNumber(value.width) && captureNumber(value.height);
+}
+function captureOptionalString(value) {
+  return value === void 0 || typeof value === "string";
+}
+function captureOptionalNullableString(value) {
+  return value === void 0 || captureNullableString(value);
+}
+function captureFontRegistration(value) {
+  return captureRecord(value) && typeof value.family === "string" && value.family.length > 0 && captureOptionalString(value.url) && captureOptionalString(value.sourceLabel) && captureOptionalNullableString(value.parsedFamily) && captureOptionalNullableString(value.parsedPostScript) && captureOptionalNullableString(value.fullName);
+}
+function capturePoint(value) {
+  return captureRecord(value) && captureNumber(value.x) && captureNumber(value.y);
+}
+function captureNode(value) {
+  if (!captureRecord(value) || !captureInteger(value.nodeId) || !(value.parentNodeId === null || captureInteger(value.parentNodeId)) || !Array.isArray(value.childNodeIds) || !value.childNodeIds.every(captureInteger) || !captureInteger(value.paintIndex) || typeof value.type !== "string" || !captureNullableString(value.id) || !captureNullableString(value.testID) || !captureNullableString(value.text) || !captureInteger(value.childCount) || !captureRecord(value.accessibility) || !captureRecord(value.interaction) || !captureRecord(value.layout) || !captureRecord(value.style) || !captureRecord(value.source) || !captureRecord(value.props) || !captureRecord(value.inspection)) {
+    return false;
+  }
+  const accessibility = value.accessibility;
+  if (typeof accessibility.accessible !== "boolean" || !captureNullableString(accessibility.label) || !captureNullableString(accessibility.role) || !captureNullableString(accessibility.hint) || !(accessibility.liveRegion === null || accessibility.liveRegion === "none" || accessibility.liveRegion === "polite" || accessibility.liveRegion === "assertive") || !(accessibility.state === null || captureRecord(accessibility.state)) || !(accessibility.value === null || captureRecord(accessibility.value))) {
+    return false;
+  }
+  const interaction = value.interaction;
+  if (typeof interaction.pressed !== "boolean" || typeof interaction.pressable !== "boolean" || typeof interaction.textInput !== "boolean" || !(interaction.textSelection === null || captureRecord(interaction.textSelection)) || typeof interaction.secureTextEntry !== "boolean" || !captureNullableString(interaction.placeholder) || !capturePoint(interaction.scrollOffset) || !(interaction.zoomScale === null || captureNumber(interaction.zoomScale)) || typeof interaction.nativePinchEnabled !== "boolean" || !(interaction.contentOffsetProp === null || captureRecord(interaction.contentOffsetProp)) || !(interaction.strokeDashoffsetProp === null || captureNumber(interaction.strokeDashoffsetProp))) {
+    return false;
+  }
+  const layout = value.layout;
+  if (!captureRect(layout.local) || !(layout.frame === null || captureRect(layout.frame)) || !capturePoint(layout.absolutePosition) || !(layout.visibleFrame === null || captureRect(layout.visibleFrame))) {
+    return false;
+  }
+  const style = value.style;
+  return captureRecord(style.resolved) && captureRecord(style.authored) && captureRecord(style.computed) && captureRecord(style.tokenBindings) && (value.textLines === void 0 || Array.isArray(value.textLines));
+}
+function isRnxScreenCapture(value) {
+  if (!captureRecord(value) || value.contractVersion !== RNX_SCREEN_CAPTURE_VERSION || !captureInteger(value.capturedAt) || !captureRecord(value.tree) || !(value.fonts === void 0 || Array.isArray(value.fonts) && value.fonts.length <= 200 && value.fonts.every(captureFontRegistration)) || !(value.visual === void 0 || captureRecord(value.visual))) {
+    return false;
+  }
+  const tree = value.tree;
+  const visual = value.visual;
+  return captureRecord(tree.viewport) && captureInteger(tree.viewport.width) && tree.viewport.width > 0 && captureInteger(tree.viewport.height) && tree.viewport.height > 0 && captureInteger(tree.rootNodeId) && Array.isArray(tree.nodes) && tree.nodes.every(captureNode) && (visual === void 0 || visual.kind === "png" && (visual.producer === "headless-cpu-app-surface" || visual.producer === "browser-compositor-app-surface") && typeof visual.dataUri === "string" && visual.dataUri.startsWith("data:image/png;base64,") && captureInteger(visual.pixelWidth) && visual.pixelWidth > 0 && captureInteger(visual.pixelHeight) && visual.pixelHeight > 0);
+}
+function isRnxCaptureRegionAtlas(value) {
+  if (!captureRecord(value) || value.kind !== "png-atlas" || value.producer !== "headless-cpu-app-surface" || typeof value.dataUri !== "string" || !value.dataUri.startsWith("data:image/png;base64,") || !captureNumber(value.width) || value.width <= 0 || !captureNumber(value.height) || value.height <= 0 || !captureInteger(value.pixelWidth) || value.pixelWidth <= 0 || !captureInteger(value.pixelHeight) || value.pixelHeight <= 0 || !Array.isArray(value.regions) || value.regions.length === 0 || value.regions.length > 256) {
+    return false;
+  }
+  const scale = value.pixelWidth / value.width;
+  if (!Number.isInteger(scale) || scale < 1 || scale > 4 || Math.abs(value.height * scale - value.pixelHeight) > 1e-6) {
+    return false;
+  }
+  const keys = /* @__PURE__ */ new Set();
+  for (const region of value.regions) {
+    if (!captureRecord(region) || typeof region.key !== "string" || region.key.length === 0 || keys.has(region.key) || !captureInteger(region.nodeId) || region.nodeId <= 0 || !captureRect(region.frame) || region.frame.width <= 0 || region.frame.height <= 0 || !captureRect(region.source) || region.source.x < 0 || region.source.y < 0 || region.source.width !== region.frame.width || region.source.height !== region.frame.height || region.source.x + region.source.width > value.width || region.source.y + region.source.height > value.height) {
+      return false;
+    }
+    keys.add(region.key);
+  }
+  return true;
+}
+export {
+  RNX_SCREEN_CAPTURE_VERSION,
+  isRnxCaptureRegionAtlas,
+  isRnxScreenCapture
+};

package/dist-lib/cli-constants.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/cloud-contract.cjs

@@ -0,0 +1,32 @@
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/cloud-contract.ts
+var cloud_contract_exports = {};
+__export(cloud_contract_exports, {
+  RNX_CLOUD_MAX_ARTIFACT_BYTES: () => RNX_CLOUD_MAX_ARTIFACT_BYTES
+});
+module.exports = __toCommonJS(cloud_contract_exports);
+var RNX_CLOUD_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RNX_CLOUD_MAX_ARTIFACT_BYTES
+});

package/dist-lib/cloud-contract.mjs

@@ -0,0 +1,7 @@
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+
+// src/cloud-contract.ts
+var RNX_CLOUD_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024;
+export {
+  RNX_CLOUD_MAX_ARTIFACT_BYTES
+};

package/dist-lib/config.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/detox/index.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -2536,8 +2536,8 @@ var device = {
     return screenshotPath;
   },
   // record the SootSim canvas via the engine's headless recorder
-  // (window.__sootsimRecorder — @sootsim/plugin-recording). this is the
-  // SAME code path `sootsim record video` drives, NOT the rail-button
+  // (window.__sootsimRecorder — @rnx/plugin-recording). this is the
+  // SAME code path `rnx record video` drives, NOT the rail-button
   // path (SootSim.bridges.startRecording wires the dialog state machine
   // and never stashes the resulting blob into __sootsimRecorder.lastBlob,
   // which is what getBlobBase64 streams from).
@@ -2567,7 +2567,7 @@ var device = {
     }
   },
   // stop the headless recorder, stream the resulting blob in chunks (same
-  // protocol as `sootsim record`), and write the webm to outPath.
+  // protocol as `rnx record`), and write the webm to outPath.
   async stopAndSaveBridgeRecording(outPath) {
     const page = getPage();
     const stopResult = await page.evaluate(async () => {

package/dist-lib/dev-bundle-resolution.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;