rnxsim 0.1.381 → 0.1.382

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.381 | (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.381 | (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.381 | (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.381 | (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.381 | (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.381 | (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.381 | (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/home-paths.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.381 | (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;
@@ -33,6 +33,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var home_paths_exports = {};
 __export(home_paths_exports, {
   ACTIVE_RUNTIME_FILE: () => ACTIVE_RUNTIME_FILE,
+  CLI_UPDATE_FILE: () => CLI_UPDATE_FILE,
   CONFIG_FILE: () => CONFIG_FILE,
   DAEMON_HEARTBEAT_STALE_MS: () => DAEMON_HEARTBEAT_STALE_MS,
   DAEMON_LOCKFILE: () => DAEMON_LOCKFILE,
@@ -43,6 +44,7 @@ __export(home_paths_exports, {
   cacheDir: () => cacheDir,
   cameraFixturesDir: () => cameraFixturesDir,
   claimDaemonLockfile: () => claimDaemonLockfile,
+  cliUpdateFilePath: () => cliUpdateFilePath,
   configFilePath: () => configFilePath,
   consumeRuntimeUpgradeNotice: () => consumeRuntimeUpgradeNotice,
   daemonAppBundlePath: () => daemonAppBundlePath,
@@ -94,6 +96,7 @@ var ACTIVE_RUNTIME_FILE = "active";
 var DAEMON_LOCKFILE = "daemon.json";
 var DEV_BRIDGES_DIR = "dev-bridges";
 var CONFIG_FILE = "config.json";
+var CLI_UPDATE_FILE = "cli-update.json";
 var DAEMON_HEARTBEAT_STALE_MS = 3e4;
 function rnxHomeDir() {
   const override = process.env[RNX_HOME_ENV];
@@ -172,6 +175,9 @@ function devBridgeLockfilePath(bridgePort) {
 function configFilePath() {
   return import_node_path.default.join(rnxHomeDir(), CONFIG_FILE);
 }
+function cliUpdateFilePath() {
+  return import_node_path.default.join(rnxHomeDir(), CLI_UPDATE_FILE);
+}
 function readSharedConfig() {
   try {
     const raw = import_node_fs.default.readFileSync(configFilePath(), "utf8");
@@ -561,6 +567,7 @@ function removeDevBridgeLockfile(owner) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ACTIVE_RUNTIME_FILE,
+  CLI_UPDATE_FILE,
   CONFIG_FILE,
   DAEMON_HEARTBEAT_STALE_MS,
   DAEMON_LOCKFILE,
@@ -571,6 +578,7 @@ function removeDevBridgeLockfile(owner) {
   cacheDir,
   cameraFixturesDir,
   claimDaemonLockfile,
+  cliUpdateFilePath,
   configFilePath,
   consumeRuntimeUpgradeNotice,
   daemonAppBundlePath,

package/dist-lib/host/bridge-host.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.381 | (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;
@@ -3787,7 +3787,7 @@ async function openUrl(url, options = {}) {
 var import_node_fs11 = __toESM(require("node:fs"), 1);
 var import_node_path11 = __toESM(require("node:path"), 1);
 
-// ../contrast-harness/src/planeProtocol.ts
+// ../rnx-box/src/planeProtocol.ts
 var PLANE_FLAG_READ_ONLY = 1;
 var PLANE_FLAG_BINARY = 2;
 function encodeBase64(bytes) {
@@ -3893,9 +3893,11 @@ var CheckoutFilePlane = class {
   // long a wedged git is waited on, never whether it is waited on, so proving
   // the kill does not have to cost the production deadline.
   listTimeoutMs;
+  trackedOnly;
   constructor(root, options = {}) {
     this.root = import_node_path10.default.resolve(root);
     this.listTimeoutMs = options.listTimeoutMs ?? LIST_FILES_TIMEOUT_MS;
+    this.trackedOnly = options.trackedOnly ?? false;
   }
   index() {
     return this.entries;
@@ -3903,7 +3905,8 @@ var CheckoutFilePlane = class {
   async refresh() {
     let stdout;
     try {
-      stdout = (0, import_node_child_process4.execFileSync)("git", ["ls-files", "-co", "--exclude-standard", "-z"], {
+      const args = this.trackedOnly ? ["ls-files", "-z"] : ["ls-files", "-co", "--exclude-standard", "-z"];
+      stdout = (0, import_node_child_process4.execFileSync)("git", args, {
         cwd: this.root,
         encoding: "utf8",
         maxBuffer: 64 * 1024 * 1024,
@@ -3923,7 +3926,7 @@ var CheckoutFilePlane = class {
     }
     if (stdout.length === 0) {
       throw new CheckoutRequiresGitError(
-        `git listed no files in ${this.root}. either git tracks nothing there and nothing untracked is visible to it, or this machine could not read the child process's output.`
+        `git listed no ${this.trackedOnly ? "tracked " : ""}files in ${this.root}. either the checkout contains no eligible files, or this machine could not read the child process's output.`
       );
     }
     const next = /* @__PURE__ */ new Map();
@@ -4613,8 +4616,8 @@ var SootSimBridgeHost = class _SootSimBridgeHost {
   static USER_BOOT_LEASE_TTL_MS = 6e4;
   static SIM_RECONNECT_TTL_MS = 3e4;
   // abandoned-tab GC. the ws heartbeat only reaps sims whose socket went
-  // dead — but a background tab from a prior `sootsim open` / QA / test run
-  // keeps its socket alive (the page still pongs) forever, so `sootsim list`
+  // dead — but a background tab from a prior `rnx open` / QA / test run
+  // keeps its socket alive (the page still pongs) forever, so `rnx list`
   // accretes dozens of zombie sims that all time out on every command (QA
   // F21-3, carried F19-2). reap a sim only when it is provably nobody's:
   // not primary, not user-focused, no CLI attached, no active lease, and no
@@ -4622,7 +4625,7 @@ var SootSimBridgeHost = class _SootSimBridgeHost {
   // terminal 4001 code, so the client closes the abandoned window instead
   // of reconnecting the zombie straight back in.
   static SIM_IDLE_REAP_TTL_MS = 30 * 6e4;
-  // automation sims (spawned by the playwright driver: `sootsim open --driver
+  // automation sims (spawned by the playwright driver: `rnx open --driver
   // playwright`, the factory/screenshot capture path — `meta.sootsimHostDriver
   // === 'playwright'`) are unattended one-shot browsers, never a human's tab. a
   // capture run opens one per slide/app/retry and the 30-min human/dev TTL lets
@@ -4652,7 +4655,7 @@ var SootSimBridgeHost = class _SootSimBridgeHost {
   // dropped, sim crashed) leave their server-side WebSocket sitting "open"
   // forever. ping every WS_HEARTBEAT_INTERVAL_MS; if the previous round's
   // ping was never answered, terminate(). that fires 'close' which runs the
-  // sim-cleanup path and stops `sootsim list` from showing 8 zombie
+  // sim-cleanup path and stops `rnx list` from showing 8 zombie
   // sims that all time out on every command.
   wsHeartbeatTimer = null;
   wsIsAlive = /* @__PURE__ */ new WeakMap();
@@ -5856,7 +5859,7 @@ var SootSimBridgeHost = class _SootSimBridgeHost {
     this.sweepRestorableSims(now);
     this.reapIdleSims(now);
   }
-  // GC abandoned sims so `sootsim list` stays usable across long dev / QA /
+  // GC abandoned sims so `rnx list` stays usable across long dev / QA /
   // test sessions (F21-3). conservative on purpose: a sim is only reaped
   // when every "someone cares about this" signal is absent.
   //
@@ -5872,7 +5875,7 @@ var SootSimBridgeHost = class _SootSimBridgeHost {
   // using is the primary and/or holds a fresh user-active lease; one that is
   // none of those and idle past the TTL is abandoned regardless of a stale
   // focus flag.
-  // automation sims are spawned by the playwright driver (`sootsim open
+  // automation sims are spawned by the playwright driver (`rnx open
   // --driver playwright`, the factory/screenshot capture path), which tags them
   // with `meta.sootsimHostDriver === 'playwright'` via the host's addInitScript.
   // they are unattended one-shot browsers, never a human's tab, so they get a
@@ -6375,6 +6378,8 @@ var SootSimBridgeHost = class _SootSimBridgeHost {
         return "evaluated page state";
       case "screenshot":
         return "captured screenshot";
+      case "capture":
+        return "captured app screen";
       case "tap":
         return "sent tap event";
       case "keyboard":

package/dist-lib/host/fetch-proxy-handler.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.381 | (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/host/fetch-proxy-overrides.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.381 | (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/host/fetch-proxy-overrides.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.381 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.382 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/host/fetch-proxy-overrides.ts
 var FETCH_PROXY_BROWSER_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36";

package/dist-lib/host/replacement-module-handler.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.381 | (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/host/websocket-proxy.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.381 | (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;