rnxsim 0.1.392 → 0.1.394

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.392 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.394 | (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;
@@ -1347,35 +1347,23 @@ var init_supported_native_packages = __esm({
       "expo-apple-authentication",
       // preset
       "expo-application",
-      // visual-proof+coverage
+      // coverage
       "expo-asset",
       // preset+coverage
       "expo-audio",
       // coverage
       "expo-av",
       // coverage
-      "expo-background-fetch",
-      // visual-proof
-      "expo-background-task",
-      // visual-proof
       "expo-battery",
-      // visual-proof+coverage
+      // coverage
       "expo-blur",
       // preset+coverage
-      "expo-brightness",
-      // visual-proof
-      "expo-calendar",
-      // visual-proof
       "expo-camera",
       // coverage
-      "expo-cellular",
-      // visual-proof
       "expo-clipboard",
       // preset+coverage
       "expo-constants",
-      // preset+visual-proof+coverage
-      "expo-contacts",
-      // visual-proof
+      // preset+coverage
       "expo-crypto",
       // preset+coverage
       "expo-dev-client",
@@ -1397,27 +1385,23 @@ var init_supported_native_packages = __esm({
       "expo-ignore-battery-optimizations",
       // coverage
       "expo-image",
-      // preset+visual-proof+coverage
+      // preset+coverage
       "expo-image-manipulator",
       // coverage
       "expo-image-picker",
       // preset+coverage
       "expo-insights",
       // coverage
-      "expo-intent-launcher",
-      // visual-proof
       "expo-keep-awake",
       // coverage
       "expo-linear-gradient",
-      // preset+visual-proof+coverage
+      // preset+coverage
       "expo-linking",
       // preset+coverage
       "expo-local-authentication",
       // coverage
       "expo-localization",
       // coverage
-      "expo-mail-composer",
-      // visual-proof
       "expo-media-library",
       // coverage
       "expo-mesh-gradient",
@@ -1425,51 +1409,35 @@ var init_supported_native_packages = __esm({
       "expo-modules-core",
       // preset
       "expo-network",
-      // preset+visual-proof+coverage
+      // preset+coverage
       "expo-notifications",
       // preset+coverage
-      "expo-print",
-      // visual-proof
-      "expo-screen-capture",
-      // visual-proof
       "expo-screen-corner-radius",
       // coverage
       "expo-screen-orientation",
-      // visual-proof+coverage
+      // coverage
       "expo-secure-store",
-      // visual-proof+coverage
-      "expo-sensors",
-      // visual-proof
-      "expo-sharing",
-      // visual-proof
-      "expo-sms",
-      // visual-proof
-      "expo-speech",
-      // visual-proof
+      // coverage
       "expo-speech-recognition",
       // preset
       "expo-splash-screen",
-      // visual-proof+coverage
+      // coverage
       "expo-sqlite",
       // preset+coverage
       "expo-store-review",
-      // visual-proof+coverage
+      // coverage
       "expo-symbols",
       // coverage
       "expo-system-ui",
       // coverage
       "expo-task-manager",
-      // visual-proof+coverage
+      // coverage
       "expo-testflight",
       // coverage
       "expo-tracking-transparency",
-      // visual-proof+coverage
+      // coverage
       "expo-updates",
       // preset+coverage
-      "expo-video",
-      // visual-proof
-      "expo-video-thumbnails",
-      // visual-proof
       "expo-web-browser",
       // preset
       "expo-winter-fetch",
@@ -1493,7 +1461,7 @@ var init_supported_native_packages = __esm({
       "posthog-react-native-session-replay",
       // preset+coverage
       "react-native",
-      // preset+visual-proof+coverage
+      // preset+coverage
       "react-native-actions-shortcuts",
       // coverage
       "react-native-adjust",
@@ -1517,7 +1485,7 @@ var init_supported_native_packages = __esm({
       "react-native-bootsplash",
       // preset+coverage
       "react-native-bottom-tabs",
-      // preset+visual-proof
+      // preset
       "react-native-branch",
       // coverage
       "react-native-config",
@@ -1539,7 +1507,7 @@ var init_supported_native_packages = __esm({
       "react-native-fs",
       // coverage
       "react-native-gesture-handler",
-      // preset+visual-proof+coverage
+      // preset+coverage
       "react-native-get-device-locale",
       // coverage
       "react-native-get-location",
@@ -1567,7 +1535,7 @@ var init_supported_native_packages = __esm({
       "react-native-key-command",
       // coverage
       "react-native-keyboard-controller",
-      // preset+visual-proof
+      // preset
       "react-native-keychain",
       // coverage
       "react-native-keys",
@@ -1597,7 +1565,7 @@ var init_supported_native_packages = __esm({
       "react-native-notification-badge",
       // coverage
       "react-native-pager-view",
-      // preset+visual-proof
+      // preset
       "react-native-pdf",
       // coverage
       "react-native-permissions",
@@ -1617,7 +1585,7 @@ var init_supported_native_packages = __esm({
       "react-native-randombytes",
       // coverage
       "react-native-reanimated",
-      // preset+visual-proof+coverage
+      // preset+coverage
       "react-native-restart",
       // coverage
       "react-native-restart-newarch",
@@ -1625,11 +1593,11 @@ var init_supported_native_packages = __esm({
       "react-native-rsa-signer",
       // coverage
       "react-native-safe-area-context",
-      // preset+visual-proof+coverage
+      // preset+coverage
       "react-native-screen-corner-radius",
       // coverage
       "react-native-screens",
-      // preset+visual-proof+coverage
+      // preset+coverage
       "react-native-securerandom",
       // coverage
       "react-native-settings",
@@ -1645,7 +1613,7 @@ var init_supported_native_packages = __esm({
       "react-native-splash-screen",
       // coverage
       "react-native-svg",
-      // preset+visual-proof
+      // preset
       "react-native-system-bars",
       // coverage
       "react-native-teleport",
@@ -1659,7 +1627,7 @@ var init_supported_native_packages = __esm({
       "react-native-turbo-haptics",
       // coverage
       "react-native-uitextview",
-      // visual-proof+coverage
+      // coverage
       "react-native-ulid-jsi",
       // coverage
       "react-native-ux-cam",
@@ -1679,7 +1647,7 @@ var init_supported_native_packages = __esm({
       "react-native-webp-format",
       // coverage
       "react-native-webview",
-      // preset+visual-proof
+      // preset
       "react-native-worklets",
       // preset+coverage
       "react-native-xxhash",
@@ -21428,12 +21396,34 @@ var init_cli_constants = __esm({
 });
 
 // src/cloud-contract.ts
-var RNX_CLOUD_MAX_ARTIFACT_BYTES, RNX_CLOUD_DESIGN_MAX_STORAGE_BYTES;
+function isRnxCloudCommandType(value) {
+  return RNX_CLOUD_COMMAND_TYPE_SET.has(value);
+}
+var RNX_CLOUD_MAX_ARTIFACT_BYTES, RNX_CLOUD_DESIGN_MAX_STORAGE_BYTES, RNX_CLOUD_COMMAND_TYPES, RNX_CLOUD_COMMAND_TYPE_SET;
 var init_cloud_contract = __esm({
   "src/cloud-contract.ts"() {
     "use strict";
     RNX_CLOUD_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024;
     RNX_CLOUD_DESIGN_MAX_STORAGE_BYTES = 1024 * 1024;
+    RNX_CLOUD_COMMAND_TYPES = Object.freeze([
+      "state",
+      "query",
+      "resolve",
+      "perform",
+      "waitFor",
+      "reset",
+      "screenshot",
+      "capture",
+      "captureRegions",
+      "settle",
+      "setAppearance",
+      "openUrl",
+      "tree",
+      "tap",
+      "longPress",
+      "memory"
+    ]);
+    RNX_CLOUD_COMMAND_TYPE_SET = new Set(RNX_CLOUD_COMMAND_TYPES);
   }
 });
 
@@ -21552,27 +21542,7 @@ function cloudCommand(command) {
   for (const [key, value] of Object.entries(command)) {
     if (key !== "id" && key !== "simId") clean[key] = value;
   }
-  if (command.type === "query") {
-    const query = command.query;
-    if (!isRecord4(query) || query.kind !== "tree" && query.kind !== "find" && query.kind !== "count") {
-      throw new Error("RNX Cloud supports only structured tree, node, and count queries");
-    }
-    return clean;
-  }
-  if (command.type === "waitFor") {
-    const options = command.waitForOptions;
-    const condition = isRecord4(options) ? options.condition : null;
-    if (!isRecord4(condition) || condition.type !== "ready" && condition.type !== "present" && condition.type !== "absent") {
-      throw new Error("RNX Cloud supports only ready and selector waits");
-    }
-    return clean;
-  }
-  if (command.type === "state") return clean;
-  if (command.type === "capture" || command.type === "captureRegions") return clean;
-  if (command.type === "setAppearance" || command.type === "openUrl") return clean;
-  if (command.type === "screenshot" && command.crop === void 0 && command.captureFilter === void 0 && (command.layers === void 0 || command.layers === "tenant")) {
-    return clean;
-  }
+  if (isRnxCloudCommandType(command.type)) return clean;
   throw new Error(`RNX Cloud does not support bridge command type ${command.type}`);
 }
 function createCloudBridgeForParsed(parsed) {
@@ -23636,8 +23606,9 @@ async function inspectWaitReady(bridge, timeoutMs = 2e4, options = {}) {
     };
   }
   const probe3 = result.probe;
+  const externalError = probe3?.externalError ?? "";
   const status = {
-    ready: result.matched,
+    ready: result.matched && !externalError,
     elapsedMs: result.elapsedMs,
     nodes: probe3?.nodes ?? 0,
     targets: probe3?.targets ?? 0,
@@ -23648,7 +23619,7 @@ async function inspectWaitReady(bridge, timeoutMs = 2e4, options = {}) {
     loadingText: probe3?.loadingText ?? "",
     externalReady: probe3?.externalReady ?? null,
     externalStatus: probe3?.externalStatus ?? "",
-    externalError: probe3?.externalError ?? "",
+    externalError,
     suppressedEntryError: probe3?.suppressedEntryError ?? "",
     errors: probe3?.errors ?? 0,
     bridgeError: result.error ?? ""

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.392 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.394 | (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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rnxsim",
-  "version": "0.1.392",
+  "version": "0.1.394",
   "description": "Vite and Metro plugins, testing drivers, and SDK exports for rnx.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",

package/src/bridge-contract-input.ts

@@ -3,6 +3,7 @@
 // WebSocket routes) validates its request bodies here rather than growing a
 // second reader for the same shapes.
 
+import { SIM_LONG_PRESS_MAX_MS } from './bridge-contract'
 import type {
   ResetOptions,
   SemanticWaitOptions,
@@ -130,6 +131,17 @@ export function parsePerformStep(value: unknown, index: number): SimPerformStep
     }
     case 'longPress': {
       const durationMs = optionalNumber(step, 'durationMs', path)
+      if (
+        durationMs !== undefined &&
+        (!Number.isInteger(durationMs) ||
+          durationMs < 1 ||
+          durationMs > SIM_LONG_PRESS_MAX_MS)
+      ) {
+        validationFailure(
+          `${path}.durationMs`,
+          `must be an integer between 1 and ${SIM_LONG_PRESS_MAX_MS}`,
+        )
+      }
       return {
         type,
         x: numberValue(step.x, `${path}.x`),

package/src/bridge-contract.ts

@@ -22,6 +22,7 @@ export type BridgeCommandType =
   | 'settle'
   | 'setAppearance'
   | 'openUrl'
+  | 'memory'
   | 'tap'
   | 'longPress'
   | 'keyboard'
@@ -216,6 +217,12 @@ export interface SemanticReadyProbe {
   suppressedEntryError: string
 }
 
+// react native's own Pressable/Touchable delayLongPress default, and the
+// ceiling any transport accepts for a press-and-hold. a driver that holds
+// longer than this is describing a drag, not a long press.
+export const SIM_LONG_PRESS_DEFAULT_MS = 500
+export const SIM_LONG_PRESS_MAX_MS = 5_000
+
 export const SEMANTIC_READY_CONTENT_NODE_FLOOR = 100
 export const SEMANTIC_READY_NODE_STABLE_MS = 750
 export const SEMANTIC_READY_POLL_MS = 150

package/src/cloud-contract.ts

@@ -1,8 +1,37 @@
+import type { BridgeCommandType } from './bridge-contract'
+
 export const RNX_CLOUD_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024
 export const RNX_CLOUD_DESIGN_PARALLEL_JOB_LIMIT = 16
 export const RNX_CLOUD_DESIGN_MAX_STORAGE_ENTRIES = 256
 export const RNX_CLOUD_DESIGN_MAX_STORAGE_BYTES = 1024 * 1024
 
+export const RNX_CLOUD_COMMAND_TYPES = Object.freeze([
+  'state',
+  'query',
+  'resolve',
+  'perform',
+  'waitFor',
+  'reset',
+  'screenshot',
+  'capture',
+  'captureRegions',
+  'settle',
+  'setAppearance',
+  'openUrl',
+  'tree',
+  'tap',
+  'longPress',
+  'memory',
+]) satisfies readonly BridgeCommandType[]
+
+const RNX_CLOUD_COMMAND_TYPE_SET = new Set<string>(RNX_CLOUD_COMMAND_TYPES)
+
+export function isRnxCloudCommandType(
+  value: string,
+): value is (typeof RNX_CLOUD_COMMAND_TYPES)[number] {
+  return RNX_CLOUD_COMMAND_TYPE_SET.has(value)
+}
+
 export interface RnxCloudClaim {
   id: string
   expiresAt: number

package/src/metro-production-bundle.ts

@@ -49,3 +49,203 @@ export function readRNXMetroModuleIdentity(
   }
   return { source: bundleText.slice(0, footerStart), modulePaths }
 }
+
+// the exact layout Metro's baseJSBundle emits and the rnx runtime contract
+// depends on: a prelude, then one `__d(` or `__r(` statement per line, each
+// running until the next statement starts its own line. one reader owns this
+// recognition so the loader's identity validation, the source-map attribution
+// pass, and the cloud artifact producer cannot drift apart.
+export interface RNXMetroDefine {
+  kind: 'define'
+  moduleId: number
+  start: number
+  end: number
+  lineIndex: number
+  endLineIndex: number
+  /** the factory expression, between `__d(` and the module ID. */
+  factory: { start: number; end: number }
+  /** the dependency array, brackets included. */
+  dependencies: { start: number; end: number }
+}
+
+export interface RNXMetroRun {
+  kind: 'run'
+  start: number
+  end: number
+  lineIndex: number
+  endLineIndex: number
+}
+
+export type RNXMetroStatement = RNXMetroDefine | RNXMetroRun
+
+export interface RNXMetroBundleLayout {
+  /** everything before the first `__d(`/`__r(` line: prelude vars and polyfills. */
+  prelude: string
+  statements: RNXMetroStatement[]
+  /** `__d(` statements whose module ID could not be read. */
+  moduleIdFailures: number
+}
+
+interface DefineTail {
+  moduleId: number
+  factoryEnd: number
+  dependenciesStart: number
+  dependenciesEnd: number
+}
+
+// each `__d(...)` ends with `),<id>,[dep,dep,...]);?`. the dependency array can
+// be hundreds of entries long, so walk back from `end` instead of searching a
+// fixed tail window: skip trailing `;` and whitespace, consume the closing `)`,
+// balance `[...]` to find its opening bracket, then read the integer before it.
+function readDefineTail(source: string, start: number, end: number): DefineTail | null {
+  let cursor = end
+  while (
+    cursor > start &&
+    (source[cursor] === ' ' ||
+      source[cursor] === '\n' ||
+      source[cursor] === '\t' ||
+      source[cursor] === ';')
+  ) {
+    cursor--
+  }
+  if (source[cursor] !== ')') return null
+  cursor--
+  while (cursor > start && /\s/.test(source[cursor])) cursor--
+  if (source[cursor] !== ']') return null
+  const dependenciesEnd = cursor + 1
+  let depth = 1
+  cursor--
+  while (cursor > start && depth > 0) {
+    const character = source[cursor]
+    if (character === ']') depth++
+    else if (character === '[') depth--
+    if (depth === 0) break
+    cursor--
+  }
+  if (depth !== 0) return null
+  const dependenciesStart = cursor
+  let idEnd = cursor - 1
+  while (idEnd > start && /\s/.test(source[idEnd])) idEnd--
+  if (source[idEnd] !== ',') return null
+  // a minifier is free to write the module ID as `1e3` or `0x3e8`, so read the
+  // whole numeric literal rather than a run of decimal digits. the factory
+  // before it always ends in `}` or `)`, which stops this walk immediately.
+  let idStart = idEnd
+  while (idStart > start && /[0-9a-fA-FxX.+\-]/.test(source[idStart - 1])) idStart--
+  const literal = source.slice(idStart, idEnd)
+  if (!/^-?(?:0[xXbBoO][0-9a-fA-F]+|\d+(?:\.\d*)?(?:[eE][+-]?\d+)?)$/.test(literal)) {
+    return null
+  }
+  const moduleId = Number(literal)
+  if (!Number.isSafeInteger(moduleId)) return null
+  let factoryEnd = idStart - 1
+  while (factoryEnd > start && /\s/.test(source[factoryEnd])) factoryEnd--
+  if (source[factoryEnd] !== ',') return null
+  return {
+    moduleId,
+    factoryEnd,
+    dependenciesStart,
+    dependenciesEnd,
+  }
+}
+
+/** reads the canonical Metro production layout from footer-stripped source. */
+export function readRNXMetroBundleLayout(source: string): RNXMetroBundleLayout {
+  const lineOffsets = [0]
+  for (let index = 0; index < source.length; index++) {
+    if (source.charCodeAt(index) === 10) lineOffsets.push(index + 1)
+  }
+
+  const boundaries: number[] = []
+  for (let lineIndex = 0; lineIndex < lineOffsets.length; lineIndex++) {
+    const start = lineOffsets[lineIndex]
+    if (source.startsWith('__d(', start) || source.startsWith('__r(', start)) {
+      boundaries.push(lineIndex)
+    }
+  }
+
+  const statements: RNXMetroStatement[] = []
+  let moduleIdFailures = 0
+  for (let index = 0; index < boundaries.length; index++) {
+    const lineIndex = boundaries[index]
+    const start = lineOffsets[lineIndex]
+    const nextLineIndex = boundaries[index + 1]
+    const endLineIndex =
+      nextLineIndex !== undefined ? nextLineIndex - 1 : lineOffsets.length - 1
+    const end = nextLineIndex !== undefined ? lineOffsets[nextLineIndex] : source.length
+    if (!source.startsWith('__d(', start)) {
+      statements.push({ kind: 'run', start, end, lineIndex, endLineIndex })
+      continue
+    }
+    const tail = readDefineTail(source, start, end - 1)
+    if (!tail) {
+      moduleIdFailures++
+      continue
+    }
+    statements.push({
+      kind: 'define',
+      moduleId: tail.moduleId,
+      start,
+      end,
+      lineIndex,
+      endLineIndex,
+      factory: { start: start + '__d('.length, end: tail.factoryEnd },
+      dependencies: { start: tail.dependenciesStart, end: tail.dependenciesEnd },
+    })
+  }
+
+  return {
+    prelude: source.slice(
+      0,
+      boundaries.length > 0 ? lineOffsets[boundaries[0]] : source.length,
+    ),
+    statements,
+    moduleIdFailures,
+  }
+}
+
+/**
+ * validates the exact identity contract before a loader installs a Metro
+ * factory trap or a producer ships an artifact: every define carries a unique,
+ * readable module ID, and the identity map names those IDs and no others.
+ * serializers that emit another layout need an ingestion adapter that
+ * normalizes them to this format.
+ */
+export function validateRNXMetroModulePaths(
+  source: string,
+  modulePaths: RNXMetroModulePathMap,
+): void {
+  const layout = readRNXMetroBundleLayout(source)
+  if (layout.moduleIdFailures > 0) {
+    throw new Error(
+      `Metro module identity could not read ${layout.moduleIdFailures} module IDs`,
+    )
+  }
+  const definedIds = new Set<number>()
+  for (const statement of layout.statements) {
+    if (statement.kind !== 'define') continue
+    if (definedIds.has(statement.moduleId)) {
+      throw new Error(`Metro module identity has duplicate module ${statement.moduleId}`)
+    }
+    definedIds.add(statement.moduleId)
+    if (!Object.prototype.hasOwnProperty.call(modulePaths, String(statement.moduleId))) {
+      throw new Error(`Metro module identity is missing ${statement.moduleId}`)
+    }
+  }
+  if (definedIds.size === 0) {
+    throw new Error('Metro module identity found no canonical JavaScript modules')
+  }
+
+  for (const [key, modulePath] of Object.entries(modulePaths)) {
+    const moduleId = Number(key)
+    if (!Number.isSafeInteger(moduleId) || String(moduleId) !== key) {
+      throw new Error(`Metro module identity has invalid module ID ${key}`)
+    }
+    if (typeof modulePath !== 'string' || modulePath.length === 0) {
+      throw new Error(`Metro module identity has no path for ${key}`)
+    }
+    if (!definedIds.has(moduleId)) {
+      throw new Error(`Metro module identity has no module ${key}`)
+    }
+  }
+}