rnxsim 0.1.317 → 0.1.319

package/dist-lib/scripts/dev-server-scanner.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.317 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.319 | (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/sdk.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.317 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.319 | (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/sdk.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.317 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.319 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.317 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.319 | (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;
@@ -577,7 +577,7 @@ var init_registry = __esm({
       "react-native-safe-area-context": {
         category: "Essentials",
         stubType: "native",
-        proofCoverage: 0.7,
+        proofCoverage: 0.95,
         versions: [
           {
             range: ">=4.0.0",
@@ -1141,13 +1141,49 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=55.0.0",
-            coverage: 0.9,
-            note: "SymbolView renders the shared SootSim SF Symbol vector and preserves the requested system name for frozen Design replay. Unknown names use the supplied fallback. unstable_getMaterialSymbolSourceAsync returns a stable URI/size shape so apps that gate on the source resolve correctly.",
-            working: "SymbolView, name object/string selection (string | { ios, android, web }), size/tintColor styling, fallback rendering, unstable_getMaterialSymbolSourceAsync",
+            coverage: 0.95,
+            note: "SymbolView renders the shared SootSim SF Symbol vector with support for monochrome, hierarchical, palette, and multicolor rendering, weight-based stroke width, and scale sizing. Unknown names use the supplied fallback. unstable_getMaterialSymbolSourceAsync returns a stable URI/size shape so apps that gate on the source resolve correctly.",
+            working: "SymbolView (named + default export), name object/string selection (string | { ios, android, web }), size, tintColor, colors array, type (monochrome/hierarchical/palette/multicolor), weight stroke-width scaling, scale multiplier sizing, animationSpec/resizeMode props, fallback rendering, unstable_getMaterialSymbolSourceAsync, type exports",
             missing: "bundled SF Symbols font (Apple license), bundled Material Symbols font (size budget), animation/effect modifiers (.bounce, .scale)"
           }
         ]
       },
+      "expo-android-shared-preferences": {
+        category: "Storage & Data",
+        stubType: "native",
+        versions: [
+          {
+            range: ">=1.0.0",
+            coverage: 1,
+            note: "native-seam only \u2014 upstream Expo module wrapper runs from the bundle; ExpoAndroidSharedPreferences provides full persistent key-value SharedPreferences operations backed by tenant localStorage",
+            working: "getString, setString, getInt, setInt, getLong, setLong, getFloat, setFloat, getBoolean, setBoolean, contains, remove, clear, default values, filename partitioning, and change listener subscriptions"
+          }
+        ]
+      },
+      "expo-winter-fetch": {
+        category: "Networking",
+        stubType: "native",
+        versions: [
+          {
+            range: ">=1.0.0",
+            coverage: 1,
+            note: "routes expo/fetch calls through the runtime fetch router, preserving the browser-native Response prototype chain and CORS proxy routing",
+            working: "fetch function (named + default export), RequestInfo/URL and RequestInit handling, response JSON/text streaming"
+          }
+        ]
+      },
+      "expo-winter-formdata": {
+        category: "Networking",
+        stubType: "native",
+        versions: [
+          {
+            range: ">=1.0.0",
+            coverage: 1,
+            note: "installFormDataPatch preserves browser-native FormData class and prototype intact, allowing browser networking stack uploads and WinterCG methods without undefined _parts crashes",
+            working: "installFormDataPatch (named + default export), append, set, get, getAll, has, delete, entries, keys, values, and iterators"
+          }
+        ]
+      },
       "expo-liquid-glass-view": {
         category: "UI Components",
         stubType: "native",
@@ -1180,10 +1216,10 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=17.0.0",
-            coverage: 0.4,
-            note: "the published SDK 57 package runs unchanged against one ExpoLocation native seam with the exact SDK subscriber contract and the shared app-scoped permission registry; the tenant worker does not currently expose browser position or orientation sources, and the simulator does not send location data to a third-party geocoder",
-            working: "upstream enums, validation, subscriber bookkeeping and permission hooks; getProviderStatusAsync, foreground/background permission getters and requests, hasServicesEnabledAsync, getLastKnownPositionAsync before a reading, unavailable motion-permission state, and isBackgroundLocationAvailableAsync=false; the native watch-id event routing, removal, and heading accuracy mapping are ready for a real tenant sensor source",
-            missing: "a worker-to-host position and device-orientation source, current and watched position readings, heading readings, an app-selected geocoder, motion activity readings, background location task registration and delivery, geofencing, and Android network-provider enablement"
+            coverage: 0.6,
+            note: "the published SDK 57 package runs unchanged against one ExpoLocation native seam backed by host browser geolocation and the shared app-scoped permission registry",
+            working: "upstream enums, validation, subscriber bookkeeping and permission hooks; getProviderStatusAsync, getCurrentPositionAsync, filtered getLastKnownPositionAsync, watchPositionAsync with native watch-id event routing and removal, foreground/background permission getters and requests, hasServicesEnabledAsync, unavailable motion-permission state, and isBackgroundLocationAvailableAsync=false",
+            missing: "device-orientation heading readings, an app-selected geocoder, motion activity readings, background location task registration and delivery, geofencing, and Android network-provider enablement"
           }
         ]
       },
@@ -1279,7 +1315,7 @@ var init_registry = __esm({
             range: ">=0.7.0",
             coverage: 0.9,
             note: "MenuView renders real iOS-style canvas menu via sootsim ContextMenu",
-            working: "MenuView, actions (title, subtitle, id, state, attributes: disabled/destructive/hidden), subactions (nested menus), onPressAction, shouldOpenOnLongPress, themeVariant, isAnchoredToRight, NativeActionEvent",
+            working: "MenuView, actions (title, subtitle, id, state, attributes: disabled/destructive/hidden), subactions (nested menus), onPressAction, onOpenMenu, onCloseMenu, shouldOpenOnLongPress, themeVariant, isAnchoredToRight, NativeActionEvent",
             missing: "keepsMenuPresented attribute (iOS 16+), image/imageColor rendering in menu items, inline element actions"
           }
         ]
@@ -3117,10 +3153,10 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=1.0.0",
-            coverage: 0,
-            note: "the reference iOS simulator performs this package's behavior. SootSim currently provides only this unsupported shape: all lock/unlock are noops : orientation cannot be forced in browser. imports and API shape receive no behavior credit",
-            working: "lockToPortrait, lockToLandscape, lockToLandscapeLeft/Right, lockToPortraitUpsideDown, lockToAllOrientationsButUpsideDown, unlockAllOrientations, getOrientation (returns PORTRAIT), getAutoRotateState (returns true), all add/remove listener methods, orientation constants",
-            missing: "lockAsync not wired to browser ScreenOrientation API"
+            coverage: 0.5,
+            note: "native-seam: the published package runs unchanged against the shared simulator orientation state. lock intent, getters, component/hooks, and NativeEventEmitter subscriptions work while the fixed device frame remains portrait.",
+            working: "published Orientation class, OrientationLocker component, hooks, OrientationType/constants, configure, lockToPortrait/PortraitUpsideDown/Landscape/Left/Right/AllButUpsideDown, unlockAllOrientations, isLocked, getInitialOrientation/getOrientation/getDeviceOrientation/getAutoRotateState, orientationDidChange/lockDidChange listeners with removal",
+            missing: "the fixed simulator viewport does not physically rotate and there is no device orientation sensor, so deviceOrientationDidChange never fires"
           }
         ]
       },
@@ -4584,9 +4620,10 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=2.0.0",
-            coverage: 0,
-            note: "the reference iOS simulator performs this package's behavior. SootSim currently provides only this unsupported shape: setItems accepts; getItems returns []; isSupported=false; initial=null; addListener returns a removable subscription that never fires. imports and API shape receive no behavior credit",
-            missing: "no 3D Touch / long-press app-icon shortcuts in browser. apps that gate quick-action UI on isSupported take their fallback path"
+            coverage: 0.5,
+            note: "native-seam only. The published package runs unchanged against the shared dynamic shortcut registry used by the React Native quick-action packages.",
+            working: "setItems and clearing, isSupported, maxCount=4, initial=null, removable addListener subscriptions, and shared item state across expo-quick-actions, react-native-quick-actions, react-native-actions-shortcuts, and @rn-org/react-native-shortcuts",
+            missing: "the simulator home-screen app icon does not display the registered shortcuts yet, so there is no user-selected onQuickAction event or initial launch action"
           }
         ]
       },
@@ -6281,10 +6318,11 @@ var init_registry = __esm({
         stubType: "native",
         versions: [
           {
-            range: ">=1.0.0",
-            coverage: 0,
-            note: "the reference iOS simulator performs this package's behavior. SootSim currently provides only this unsupported shape: getInitialOrientation/getDeviceOrientation/getInterfaceOrientation report Portrait; lockTo/unlock accepted; full Orientation enum exposed. imports and API shape receive no behavior credit",
-            missing: "sootsim canvas is portrait-only; this matches"
+            range: ">=3.0.0",
+            coverage: 0.5,
+            note: "native-seam: the published package runs unchanged against the shared simulator orientation state, including its TurboModule and codegen event surface.",
+            working: "Orientation/OrientationType/AutoRotation enums, getInterfaceOrientation/getDeviceOrientation, lockTo/unlock/isLocked, resetSupportedInterfaceOrientations, interface and lock subscriptions, hooks, human-readable conversion helpers, isLockableOrientation; lock state stays consistent with expo-screen-orientation and react-native-orientation-locker",
+            missing: "the fixed simulator viewport does not physically rotate and there is no device orientation sensor, so device-orientation subscriptions never fire; iOS reports auto-rotation as unknown exactly like upstream"
           }
         ]
       },
@@ -7012,10 +7050,10 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=2.0.0",
-            coverage: 0.4,
+            coverage: 0.5,
             note: "orientation state and subscriptions have the right shape, but lock calls never rotate the viewport as they do in the reference iOS simulator",
-            working: "startOrientationTracking/stopOrientationTracking, lockToPortrait/lockToLandscape/unlockAllOrientations (intent tracked \u2192 isLocked correct), getCurrentOrientation (PORTRAIT \u2014 real), isLocked, getDeviceAutoRotateStatus (null, faithful iOS), onOrientationChange/onLockOrientationChange (removable subscriptions), all enums",
-            missing: "a browser cannot force device rotation, so lock* does not visually rotate and orientation-change callbacks never fire (faithful iOS-sim/browser limitation, identical to react-native-orientation-locker \u2014 not a sootsim-specific gap)"
+            working: "startOrientationTracking/stopOrientationTracking, lockToPortrait/lockToLandscape/unlockAllOrientations (shared intent tracked \u2192 isLocked correct), getCurrentOrientation (requested interface orientation), isLocked, getDeviceAutoRotateStatus (null, faithful iOS), onOrientationChange/onLockOrientationChange (emitting removable subscriptions), all enums",
+            missing: "the fixed simulator viewport does not physically rotate and there is no device orientation sensor"
           }
         ]
       },
@@ -18739,18 +18777,14 @@ async function runRuntime(args, opts = {}) {
     case "install":
       return runtimeInstall(rest, opts);
     case "list":
-    case "ls":
       return runtimeList(rest);
     case "use":
       return runtimeUse(rest);
     case "remove":
-    case "rm":
       return runtimeRemove(rest);
     case "which":
-    case "active":
       return runtimeWhich();
     case "notes":
-    case "changelog":
       return runtimeNotes(rest);
     default:
       console.error(`  unknown runtime subcommand: ${sub}`);

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.317 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.319 | (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.317",
+  "version": "0.1.319",
   "description": "rnxsim CLI, Vite and Metro plugins, and agent skills for driving React Native apps in the browser.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",

package/skills/contrast/SKILL.md

@@ -37,7 +37,6 @@ automation, inspecting the render tree, and managing sims.
 | `rnxsim shell` | drive shell state and simulator chrome |
 | `rnxsim mode` | toggle screenshot and 3D display modes |
 | `rnxsim device` | inspect or change the live device preset for a sim |
-| `rnxsim inspect` | query, describe, and drive the running rnx instance |
 | `rnxsim network` | inspect live network traffic from the running rnx worker |
 | `rnxsim logs` | inspect live console output from the running rnx worker |
 | `rnxsim debug` | drive __sootsimDebug: channels, snapshots, and inspectors |

package/skills/rnx-perf/SKILL.md

@@ -170,6 +170,23 @@ the report and how to read it:
 three runs minimum; single-run p95 is noise. a fresh `perf start` between
 runs clears the buffer.
 
+### confirm which build you measured, every time
+
+Against a dev-source sim, the FIRST reload after an engine edit serves the
+PREVIOUS module. The sim reports ready, the app runs, the numbers look real, and
+they describe the build before yours. Two screenshots were read as a fidelity
+regression this way before the cause was found.
+
+So make every capture say which build it came from, rather than assuming the
+reload took. Put a marker in something the capture already returns - a counter
+name in `saveLayerReasons`, a debug event, a log line - and treat a capture with
+no marker as a capture of the wrong build. Reload twice and re-read the marker.
+
+This costs one line and it is the difference between a measurement and a guess.
+The same rule covers any A/B where you edit between arms: an arm you cannot
+identify from its own output is not evidence.
+
+
 deeper tools when the frame report isn't enough:
 
 ```sh

package/src/vite-plugin.ts

@@ -729,14 +729,27 @@ export function manifestNativeSeamRedirect(): Plugin {
   }
 }
 
+interface ViteBridgeProcessEntry {
+  boundPort: Promise<number | null>
+  close: () => Promise<void>
+  owners: Set<object>
+  shellPort: { read: () => number | null }
+}
+
+declare global {
+  var __sootsimViteBridgeProcesses: Map<number, ViteBridgeProcessEntry> | undefined
+}
+
+// vite creates the replacement server before closing the prior server during a
+// config restart. keep the independently listening bridge owned by that process
+// across the overlap so every connected sim stays on the same websocket.
+const viteBridgeProcesses = (globalThis.__sootsimViteBridgeProcesses ??= new Map())
+
 // start WS bridge server for debug CLI connectivity. exported so shell
 // vite can install it standalone (engine builds via `vite build --watch`,
 // which doesn't fire configureServer — the bridge has to run on shell).
 export function wsBridgePlugin(): Plugin {
-  let bridgeHost: {
-    startAsync?: (options?: { silent?: boolean }) => Promise<number>
-    close?: () => Promise<void> | void
-  } | null = null
+  const owner = {}
   // the port the bridge ACTUALLY bound, which is not necessarily the one it
   // asked for: the host scans forward from its preferred port on EADDRINUSE.
   // the page has to be told this value. when it derived its own guess from
@@ -749,48 +762,62 @@ export function wsBridgePlugin(): Plugin {
     apply: 'serve',
     configureServer(server) {
       if (boundPort) return
-      // lazy import to avoid pulling ws into the main bundle.
-      // note: the .ts extension is required on vite 8 / node ESM — without
-      // it, import() throws "Cannot find module" and the bridge silently
-      // never starts.
-      boundPort = import('./host/bridge-host.ts')
-        .then(({ SootSimBridgeHost }) => {
-          const host = new SootSimBridgeHost({
-            port: resolveSootsimBridgePort({
-              explicitPort: process.env.SOOTSIM_BRIDGE_PORT,
-              portOffset: process.env.PORT_OFFSET,
-            }),
+      const preferredPort = resolveSootsimBridgePort({
+        explicitPort: process.env.SOOTSIM_BRIDGE_PORT,
+        portOffset: process.env.PORT_OFFSET,
+      })
+      const readShellPort = () => {
+        const addr = server.httpServer?.address()
+        if (addr && typeof addr === 'object') return addr.port
+        return server.config.server.port || null
+      }
+      const existing = viteBridgeProcesses.get(preferredPort)
+      if (existing) {
+        existing.owners.add(owner)
+        existing.shellPort.read = readShellPort
+        boundPort = existing.boundPort
+      } else {
+        // lazy import to avoid pulling ws into the main bundle.
+        // note: the .ts extension is required on vite 8 / node ESM — without
+        // it, import() throws "Cannot find module" and the bridge silently
+        // never starts.
+        const shellPort = { read: readShellPort }
+        const host = import('./host/bridge-host.ts').then(({ SootSimBridgeHost }) => {
+          return new SootSimBridgeHost({
+            port: preferredPort,
             writeDevLockfile: true,
-            // resolved on every lockfile heartbeat: the address is null until
-            // vite's http server is listening, then the real bound port. lets
-            // CLI commands resolve the shell base URL from the same lockfile
-            // that names the bridge port (one world, no split-brain).
-            getShellPort: () => {
-              const addr = server.httpServer?.address()
-              if (addr && typeof addr === 'object') return addr.port
-              return server.config.server.port || null
-            },
+            getShellPort: () => shellPort.read(),
           })
-          bridgeHost = host
-          // startAsync, not start: the whole point is to learn the bound port.
-          return host.startAsync({ silent: true })
-        })
-        .catch((err: unknown) => {
-          // log but don't crash — some environments (e.g. production builds)
-          // don't have ws available. silently swallowing has caused debugging
-          // pain; print the message instead.
-          const message = err instanceof Error ? err.message : String(err)
-          console.warn('[rnx] ws bridge failed to start:', message)
-          return null
         })
-
-      // cleanup on server close (HMR restart)
-      server.httpServer?.on('close', () => {
-        if (bridgeHost) {
-          void bridgeHost.close?.()
-          bridgeHost = null
+        let entry: ViteBridgeProcessEntry
+        boundPort = host
+          .then((bridgeHost) => bridgeHost.startAsync({ silent: true }))
+          .catch((err: unknown) => {
+            if (viteBridgeProcesses.get(preferredPort) === entry) {
+              viteBridgeProcesses.delete(preferredPort)
+            }
+            const message = err instanceof Error ? err.message : String(err)
+            console.warn('[rnx] ws bridge failed to start:', message)
+            return null
+          })
+        entry = {
+          boundPort,
+          close: async () => {
+            try {
+              await (await host).close()
+            } catch {}
+          },
+          owners: new Set([owner]),
+          shellPort,
         }
-        boundPort = null
+        viteBridgeProcesses.set(preferredPort, entry)
+      }
+
+      server.httpServer?.once('close', () => {
+        const entry = viteBridgeProcesses.get(preferredPort)
+        if (!entry || !entry.owners.delete(owner) || entry.owners.size > 0) return
+        viteBridgeProcesses.delete(preferredPort)
+        void entry.close()
       })
     },
     // publish the bound port to the page. head-prepend so it lands before the
@@ -839,7 +866,11 @@ function sootsimConfigPlugin(
         // their parent package (e.g. foo) — vite processes aliases in order
         .sort((a, b) => b[0].length - a[0].length)
         .map(([find, file]) => ({
-          find,
+          // the bare expo entry is a facade while its package subpaths are
+          // independent upstream modules. a string alias is prefix-matched by
+          // vite, so make this one exact or expo/devtools and future subpaths
+          // become impossible paths such as expo.ts/devtools.
+          find: find === 'expo' ? /^expo$/ : find,
           replacement: path.resolve(compatStubsDir, file),
         }))