rnxsim 0.1.375 → 0.1.377

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.375 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.377 | (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;
@@ -126,17 +126,17 @@ function launchRnxDesktop(bundleUrl, appName) {
 var import_node_fs2 = __toESM(require("node:fs"), 1);
 var import_node_os = require("node:os");
 var import_node_path2 = __toESM(require("node:path"), 1);
-var SOOTSIM_HOME_ENV = "SOOTSIM_HOME";
+var RNX_HOME_ENV = "RNX_HOME";
 var ACTIVE_RUNTIME_FILE = "active";
 var DAEMON_LOCKFILE = "daemon.json";
 var DAEMON_HEARTBEAT_STALE_MS = 3e4;
-function sootsimHomeDir() {
-  const override = process.env[SOOTSIM_HOME_ENV];
+function rnxHomeDir() {
+  const override = process.env[RNX_HOME_ENV];
   if (override && override.length > 0) return import_node_path2.default.resolve(override);
-  return import_node_path2.default.join((0, import_node_os.homedir)(), ".sootsim");
+  return import_node_path2.default.join((0, import_node_os.homedir)(), ".rnx");
 }
 function runtimesDir() {
-  return import_node_path2.default.join(sootsimHomeDir(), "runtimes");
+  return import_node_path2.default.join(rnxHomeDir(), "runtimes");
 }
 function runtimeDir(version) {
   return import_node_path2.default.join(runtimesDir(), version);
@@ -145,7 +145,7 @@ function activeRuntimeFile() {
   return import_node_path2.default.join(runtimesDir(), ACTIVE_RUNTIME_FILE);
 }
 function daemonLockfilePath() {
-  return import_node_path2.default.join(sootsimHomeDir(), DAEMON_LOCKFILE);
+  return import_node_path2.default.join(rnxHomeDir(), DAEMON_LOCKFILE);
 }
 function readActiveRuntime() {
   try {
@@ -417,7 +417,7 @@ function findMonorepoRoot() {
   return null;
 }
 function resolveDevCheckoutRuntimeRoot() {
-  if (process.env.SOOTSIM_HOME && readActiveRuntime()) return null;
+  if (process.env.RNX_HOME && readActiveRuntime()) return null;
   const root = findMonorepoRoot();
   if (!root) return null;
   const devBuild = import_path.default.join(root, "public/sootsim");
@@ -654,7 +654,7 @@ function rnxPlugin(options = {}) {
       const port = configuredPort;
       const sootsimUrl = `http://localhost:${port}${prefix}/`;
       console.log(`[rnx] serving at ${sootsimUrl}`);
-      if (appName && !process.env.CI && !process.env.SOOTSIM_NO_OPEN) {
+      if (appName && !process.env.CI && !process.env.RNX_NO_OPEN) {
         server.httpServer?.once("listening", () => {
           const openPort = listeningPort();
           launchRnxDesktop(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rnxsim",
-  "version": "0.1.375",
+  "version": "0.1.377",
   "description": "rnx CLI, Vite and Metro plugins, and agent skills for driving React Native apps in the browser.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",
@@ -179,12 +179,7 @@
     },
     "./package.json": "./package.json"
   },
-  "bin": {
-    "rnx": "dist-cli/bin.js",
-    "rnxsim": "dist-cli/bin.js"
-  },
   "files": [
-    "dist-cli/",
     "dist-lib/",
     "src/",
     "cli/",
@@ -192,8 +187,6 @@
     "scripts/dev-server-scanner.ts",
     "scripts/optional-demo-registry.ts",
     "detox/",
-    "scripts/postinstall.cjs",
-    "scripts/preuninstall.cjs",
     "README.md",
     "LICENSE"
   ],
@@ -201,9 +194,9 @@
     "build": "bun scripts/build-cli.ts",
     "build:cli": "bun scripts/build-cli.ts",
     "build:cli-binary": "bun scripts/build-cli-binary.ts",
-    "pack:smoke": "bun scripts/pack-smoke.ts",
-    "postinstall": "node ./scripts/postinstall.cjs",
-    "preuninstall": "node ./scripts/preuninstall.cjs"
+    "smoke:cli-binary": "bun scripts/smoke-cli-binary.ts",
+    "publish:cli-binary": "bun scripts/publish-cli-binaries.ts",
+    "pack:smoke": "bun scripts/pack-smoke.ts"
   },
   "dependencies": {
     "@expo/plist": "^0.5.4",

package/scripts/dev-server-scanner.ts

@@ -17,13 +17,14 @@ import { exec } from 'child_process'
 import { readlink } from 'fs/promises'
 import http from 'http'
 import net from 'net'
+import { realpathSync } from 'node:fs'
 import { resolve } from 'node:path'
 import {
   buildLoopbackProbeBaseUrl,
   LOOPBACK_PROBE_HOSTNAMES,
   normalizeHostname,
 } from '../src/backend-origin.ts'
-import { applySootSimConfigToUrl } from '../src/config.ts'
+import { applyRNXConfigToUrl } from '../src/config.ts'
 import {
   alignLoopbackBundleUrlWithProbe,
   normalizeNativeDevBundleUrl,
@@ -547,13 +548,30 @@ function makeResult(
 }
 
 function withRuntimeConfig(port: number, bundleUrl: string, projectCwd?: string): string {
-  const knownApp = projectCwd
-    ? optionalDemoAppsSync().find(
-        (app) => app.preferredPort === port && resolve(app.dir) === resolve(projectCwd),
-      )
-    : undefined
+  let physicalProjectCwd: string | undefined
+  if (projectCwd) {
+    try {
+      physicalProjectCwd = realpathSync(resolve(projectCwd))
+    } catch {}
+  }
+  const knownApps = physicalProjectCwd
+    ? optionalDemoAppsSync().filter((app) => {
+        try {
+          return realpathSync(resolve(app.dir)) === physicalProjectCwd
+        } catch {
+          return false
+        }
+      })
+    : []
+  const exactKnownApps = knownApps.filter((app) => app.preferredPort === port)
+  const knownApp =
+    exactKnownApps.length === 1
+      ? exactKnownApps[0]
+      : exactKnownApps.length === 0 && knownApps.length === 1
+        ? knownApps[0]
+        : undefined
   const configured = knownApp?.runtimeConfig
-    ? applySootSimConfigToUrl(bundleUrl, knownApp.runtimeConfig)
+    ? applyRNXConfigToUrl(bundleUrl, knownApp.runtimeConfig)
     : bundleUrl
   return normalizeNativeDevBundleUrl(configured)
 }

package/scripts/optional-demo-registry.ts

@@ -63,7 +63,7 @@ export interface OptionalDemoApp {
   dir: string
   preferredPort: number
   framework: 'expo' | 'one' | 'rock'
-  runtimeConfig?: import('../src/config.ts').SootSimConfig
+  runtimeConfig?: import('../src/config.ts').RNXConfig
 }
 
 let cached: OptionalDemoApp[] | null = null

package/skills/contrast/SKILL.md

@@ -60,7 +60,7 @@ automation, inspecting the render tree, and managing sims.
 | `rnx version` | show the CLI + engine runtime versions you are running |
 | `rnx upgrade` | update the rnx CLI and engine runtime to the latest |
 | `rnx serve` | run the rnx bridge in the foreground |
-| `rnx runtime` | manage engine runtimes under ~/.sootsim/runtimes/ |
+| `rnx runtime` | manage engine runtimes under ~/.rnx/runtimes/ |
 | `rnx auth` | inspect active CLI auth |
 | `rnx login` | sign in for preview uploads |
 | `rnx logout` | clear the local desktop auth session |
@@ -115,7 +115,7 @@ commands in your own `sleep` or chain `do settle` "just to be safe"**.
   `type-into`, `key`, `key-sequence`, `keycode`, `drag`, `swipe`,
   `long-press`, `touch`, `gesture`, `pinch`, `scroll`, `shell`)
   the CLI polls the layout hash until it is stable for two consecutive
-  frames. budget: **400 ms for agents** (`SOOTSIM_AGENT=1`, set by the
+  frames. budget: **400 ms for agents** (`RNX_AGENT=1`, set by the
   harness), 200 ms for humans.
 
 what this means:
@@ -126,7 +126,7 @@ what this means:
   `⚠ auto-wait timed out after Nms — next command may see mid-animation
   state`, or when the transition you care about lasts longer than ~400 ms
   (full stack navigation, crossfades, video load).
-- opt-out: `--no-wait` on a single command, `SOOTSIM_NO_AUTO_WAIT=1`
+- opt-out: `--no-wait` on a single command, `RNX_NO_AUTO_WAIT=1`
   for a whole lane.
 - if a read keeps racing its write, the fix is **never** a blind `sleep` —
   prefer `wait selector`, `wait ready`, `wait idle`, or a longer

package/skills/rnx-debug/SKILL.md

@@ -129,7 +129,7 @@ rnx do settle 5                # wait up to 5s for layout stability
 rnx wait idle --max-ms 5000    # same thing under the `wait` verb
 rnx wait idle --strict         # also require animation flags clear
 rnx do tap-id play --no-wait   # skip auto-settle on one command
-SOOTSIM_NO_AUTO_WAIT=1 rnx ... # disable auto-settle for a lane
+RNX_NO_AUTO_WAIT=1 rnx ... # disable auto-settle for a lane
 ```
 
 ## branch — debugging

package/skills/rnx-test/SKILL.md

@@ -12,7 +12,7 @@ Detox runs existing imperative Jest suites through the rnx driver.
 > needs a connected, pinned sim. if `rnx describe` errors, load
 > `/rnx-setup` first.
 
-Set `SOOTSIM_NO_OPEN=1` before starting an app dev server for a Detox,
+Set `RNX_NO_OPEN=1` before starting an app dev server for a Detox,
 Maestro, or iOS-only pass. Apps can opt into a named Electron window through
 the official Vite or Metro plugin, and test-only work must not open that window.
 
@@ -236,7 +236,7 @@ upstream detox surface.
 ### one-line install
 
 ```js
-// sootsim-detox.config.cjs
+// rnx-detox.config.cjs
 module.exports = {
   preset: 'rnxsim/detox/jest-preset',
   rootDir: __dirname,

package/src/agent-identity.ts

@@ -6,7 +6,7 @@ export function agentSessionIdFromCliIdentity(identity: string | null): string |
   if (colon < 0) return identity.trim() || null
   const source = identity.slice(0, colon)
   const value = identity.slice(colon + 1).trim()
-  return source === 'SOOTSIM_CLI_IDENTITY' && value ? value : null
+  return source === 'RNX_CLI_IDENTITY' && value ? value : null
 }
 
 export function teamMachineSessionIdFromCliIdentity(

package/src/agent-sessions.ts

@@ -67,7 +67,7 @@ export function pidIsAlive(pid: number | undefined, sessionId?: string): boolean
 
 /** figure out how to re-invoke the sootsim CLI to run `agent-wrapper`.
  *  priority:
- *    1. SOOTSIM_BIN env var (explicit override)
+ *    1. RNX_BIN env var (explicit override)
  *    2. electron prod: bundled binary under process.resourcesPath/bin/
  *    3. workspace build artifacts (dist-bin/<binary> or dist-cli/bin.js)
  *       — shared between electron dev, the vite-plugin-hosted daemon, and
@@ -77,8 +77,8 @@ export function pidIsAlive(pid: number | undefined, sessionId?: string): boolean
  *    5. CLI standalone: argv[0] is the compiled binary, no prefix needed
  */
 export function resolveSootsimInvocation(): { cmd: string; prefixArgs: string[] } {
-  if (process.env.SOOTSIM_BIN) {
-    return { cmd: process.env.SOOTSIM_BIN, prefixArgs: [] }
+  if (process.env.RNX_BIN) {
+    return { cmd: process.env.RNX_BIN, prefixArgs: [] }
   }
   // electron prod: packaged binary lives under Resources/bin/.
   if (process.versions.electron) {
@@ -117,7 +117,7 @@ export function resolveSootsimInvocation(): { cmd: string; prefixArgs: string[]
     // bin-shim case falls through to the error below instead of silently
     // running `node` without args.
     throw new Error(
-      'rnx CLI not found. set SOOTSIM_BIN to the path of the rnx binary, ' +
+      'rnx CLI not found. set RNX_BIN to the path of the rnx binary, ' +
         'or build the workspace CLI via `bun run --cwd packages/sootsim build:cli`.',
     )
   }
@@ -128,7 +128,9 @@ function tryWorkspaceSootsim(): { cmd: string; prefixArgs: string[] } | null {
   try {
     const sootsimDir = resolveSootsimPackageDir()
     if (!sootsimDir) return null
-    const binaryName = `sootsim-${process.platform}-${process.arch}`
+    const binaryName = `rnx-${
+      process.platform === 'win32' ? 'windows' : process.platform
+    }-${process.arch}${process.platform === 'win32' ? '.exe' : ''}`
     const distBinary = path.join(sootsimDir, 'dist-bin', binaryName)
     if (fs.existsSync(distBinary)) return { cmd: distBinary, prefixArgs: [] }
     const distBin = path.join(sootsimDir, 'dist-cli', 'bin.js')

package/src/cli-version.ts

@@ -1,16 +1,24 @@
-// sootsim CLI version — the `sootsim` npm package version. resolved once
-// and cached. shared by `--version`, `--help`, the `upgrade` command, the
-// startup flow, and the bridge-host (which injects it into the served
-// runtime html as window.__sootsimCliVersion).
+// rnx cli version, resolved once and cached. standalone builds embed it so
+// lazy command chunks do not depend on an npm package layout at runtime.
 
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 import { rnxPublicBrand } from './public-brand.ts'
 
+declare const __RNX_CLI_VERSION__: string
+
 let cached: string | null = null
 
 export function getCliVersion(): string {
   if (cached != null) return cached
+  if (
+    typeof __RNX_CLI_VERSION__ !== 'undefined' &&
+    typeof __RNX_CLI_VERSION__ === 'string' &&
+    __RNX_CLI_VERSION__
+  ) {
+    cached = __RNX_CLI_VERSION__
+    return cached
+  }
   // prefer package resolution (works for npm/global installs); fall back to
   // the package.json next to this module's source for repo / bundled runs.
   const candidates: Array<() => string> = [

package/src/config.ts

@@ -1,4 +1,4 @@
-// sootsim.config.ts — per-app module resolution, turbo modules, env, state, and settings.
+// rnx.config.ts — per-app module resolution, turbo modules, env, state, and settings.
 //
 // usage:
 //   import { defineConfig } from 'rnxsim/config'
@@ -17,9 +17,7 @@ export type ModuleResolution =
 
 export type NativeModuleResolution = ModuleResolution | Record<string, any> // direct native module object for non-url configs
 
-export interface SootSimConfig<
-  Settings extends Record<string, any> = Record<string, any>,
-> {
+export interface RNXConfig<Settings extends Record<string, any> = Record<string, any>> {
   // host-only engine selection. omitted means the current stable runtime.
   runtimeVersion?: string
   modules?: Record<string, ModuleResolution>
@@ -48,11 +46,11 @@ export interface SootSimConfig<
   }
 }
 
-export const SOOTSIM_CONFIG_QUERY_PARAM = 'sootsimConfig'
+export const RNX_CONFIG_QUERY_PARAM = 'rnxConfig'
 
 export function defineConfig<Settings extends Record<string, any> = Record<string, any>>(
-  config: SootSimConfig<Settings>,
-): SootSimConfig<Settings> {
+  config: RNXConfig<Settings>,
+): RNXConfig<Settings> {
   return config
 }
 
@@ -60,9 +58,9 @@ function hasOwnKeys(value: Record<string, unknown> | undefined): boolean {
   return !!value && Object.keys(value).length > 0
 }
 
-export function hasSootSimConfig<
-  Settings extends Record<string, any> = Record<string, any>,
->(config?: SootSimConfig<Settings> | null): config is SootSimConfig<Settings> {
+export function hasRNXConfig<Settings extends Record<string, any> = Record<string, any>>(
+  config?: RNXConfig<Settings> | null,
+): config is RNXConfig<Settings> {
   if (!config) return false
   return (
     (typeof config.runtimeVersion === 'string' && config.runtimeVersion.length > 0) ||
@@ -76,15 +74,15 @@ export function hasSootSimConfig<
   )
 }
 
-export function mergeSootSimConfig<
+export function mergeRNXConfig<
   Settings extends Record<string, any> = Record<string, any>,
 >(
-  base?: SootSimConfig<Settings> | null,
-  override?: SootSimConfig<Settings> | null,
-): SootSimConfig<Settings> | undefined {
-  if (!hasSootSimConfig(base) && !hasSootSimConfig(override)) return undefined
-  if (!hasSootSimConfig(base)) return override ? { ...override } : undefined
-  if (!hasSootSimConfig(override)) return base ? { ...base } : undefined
+  base?: RNXConfig<Settings> | null,
+  override?: RNXConfig<Settings> | null,
+): RNXConfig<Settings> | undefined {
+  if (!hasRNXConfig(base) && !hasRNXConfig(override)) return undefined
+  if (!hasRNXConfig(base)) return override ? { ...override } : undefined
+  if (!hasRNXConfig(override)) return base ? { ...base } : undefined
 
   return {
     runtimeVersion: override.runtimeVersion ?? base.runtimeVersion,
@@ -106,29 +104,29 @@ export function mergeSootSimConfig<
   }
 }
 
-export function readSootSimConfigFromSearchParams<
+export function readRNXConfigFromSearchParams<
   Settings extends Record<string, any> = Record<string, any>,
->(searchParams: URLSearchParams): SootSimConfig<Settings> | undefined {
-  const raw = searchParams.get(SOOTSIM_CONFIG_QUERY_PARAM)
+>(searchParams: URLSearchParams): RNXConfig<Settings> | undefined {
+  const raw = searchParams.get(RNX_CONFIG_QUERY_PARAM)
   if (!raw) return undefined
   try {
-    const parsed = JSON.parse(raw) as SootSimConfig<Settings>
-    return hasSootSimConfig(parsed) ? parsed : undefined
+    const parsed = JSON.parse(raw) as RNXConfig<Settings>
+    return hasRNXConfig(parsed) ? parsed : undefined
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error)
-    console.warn(`[rnx] invalid ${SOOTSIM_CONFIG_QUERY_PARAM}: ${message}`)
+    console.warn(`[rnx] invalid ${RNX_CONFIG_QUERY_PARAM}: ${message}`)
     return undefined
   }
 }
 
-export function applySootSimConfigToUrl<
+export function applyRNXConfigToUrl<
   Settings extends Record<string, any> = Record<string, any>,
->(url: string, config?: SootSimConfig<Settings> | null): string {
+>(url: string, config?: RNXConfig<Settings> | null): string {
   const parsed = new URL(url)
-  if (hasSootSimConfig(config)) {
-    parsed.searchParams.set(SOOTSIM_CONFIG_QUERY_PARAM, JSON.stringify(config))
+  if (hasRNXConfig(config)) {
+    parsed.searchParams.set(RNX_CONFIG_QUERY_PARAM, JSON.stringify(config))
   } else {
-    parsed.searchParams.delete(SOOTSIM_CONFIG_QUERY_PARAM)
+    parsed.searchParams.delete(RNX_CONFIG_QUERY_PARAM)
   }
   return parsed.toString()
 }

package/src/disk-cleanup.ts

@@ -1,8 +1,8 @@
 import fs from 'node:fs'
 import path from 'node:path'
 import { isDisposableBrowserCacheDir } from './browser-cache'
-import { ensureSootsimHome, readLiveRuntimeVersions, sootsimHomeDir } from './home-paths'
-import { sootsimRuntime } from './runtime-delivery'
+import { ensureRnxHome, readLiveRuntimeVersions, rnxHomeDir } from './home-paths'
+import { rnxRuntime } from './runtime-delivery'
 
 const AUTOMATIC_CLEANUP_GENERATION = 1
 const AUTOMATIC_CLEANUP_COMPLETE_FILE = `automatic-cleanup-v${AUTOMATIC_CLEANUP_GENERATION}.json`
@@ -65,7 +65,7 @@ export interface AutomaticSootsimCleanupResult {
 }
 
 export function isAutomaticSootsimCleanupComplete(): boolean {
-  const completePath = path.join(sootsimHomeDir(), AUTOMATIC_CLEANUP_COMPLETE_FILE)
+  const completePath = path.join(rnxHomeDir(), AUTOMATIC_CLEANUP_COMPLETE_FILE)
   try {
     const parsed = JSON.parse(fs.readFileSync(completePath, 'utf8')) as {
       generation?: unknown
@@ -80,7 +80,7 @@ export function isAutomaticSootsimCleanupComplete(): boolean {
 // right now. complete means never again; a recent deferral means not yet.
 export function shouldSkipAutomaticSootsimCleanup(now = Date.now()): boolean {
   if (isAutomaticSootsimCleanupComplete()) return true
-  const deferredPath = path.join(sootsimHomeDir(), AUTOMATIC_CLEANUP_DEFERRED_FILE)
+  const deferredPath = path.join(rnxHomeDir(), AUTOMATIC_CLEANUP_DEFERRED_FILE)
   try {
     const parsed = JSON.parse(fs.readFileSync(deferredPath, 'utf8')) as {
       generation?: unknown
@@ -243,11 +243,11 @@ function runtimeEntries(aggressive: boolean): {
 } {
   const inUseVersions = new Set(readLiveRuntimeVersions())
   const protectVersions = [...inUseVersions]
-  const normal = sootsimRuntime.planLocalRetention({
+  const normal = rnxRuntime.planLocalRetention({
     retainVersions: 2,
     protectVersions,
   })
-  const minimal = sootsimRuntime.planLocalRetention({
+  const minimal = rnxRuntime.planLocalRetention({
     retainVersions: 1,
     protectVersions,
   })
@@ -262,7 +262,7 @@ function runtimeEntries(aggressive: boolean): {
   const entries: SootsimCleanupEntry[] = []
 
   for (const version of [...allVersions].sort()) {
-    const runtimePath = sootsimRuntime.product.runtimeDir(version)
+    const runtimePath = rnxRuntime.product.runtimeDir(version)
     let state: SootsimCleanupState = 'retained'
     let detail = 'retained runtime'
     if (inUseVersions.has(version) && version !== normal.activeVersion) {
@@ -308,7 +308,7 @@ export function planSootsimCleanup(
   options: SootsimCleanupOptions = {},
 ): SootsimCleanupPlan {
   const aggressive = options.aggressive === true
-  const home = sootsimHomeDir()
+  const home = rnxHomeDir()
   const runtimes = runtimeEntries(aggressive)
   const entries = [
     ...runtimes.entries,
@@ -345,7 +345,7 @@ export function applySootsimCleanup(
 ): SootsimCleanupResult {
   const plan = planSootsimCleanup(options)
   const retainVersions = options.aggressive === true ? 1 : 2
-  sootsimRuntime.pruneLocalRetention({
+  rnxRuntime.pruneLocalRetention({
     retainVersions,
     protectVersions: readLiveRuntimeVersions(),
   })
@@ -386,8 +386,8 @@ export function applySootsimCleanup(
 }
 
 export function applyAutomaticSootsimCleanup(): AutomaticSootsimCleanupResult {
-  ensureSootsimHome()
-  const home = sootsimHomeDir()
+  ensureRnxHome()
+  const home = rnxHomeDir()
   const completePath = path.join(home, AUTOMATIC_CLEANUP_COMPLETE_FILE)
   const deferredPath = path.join(home, AUTOMATIC_CLEANUP_DEFERRED_FILE)
   const lockPath = path.join(home, AUTOMATIC_CLEANUP_LOCK_FILE)