rnxsim 0.1.445 → 0.1.447

package/README.md

@@ -174,6 +174,9 @@ During source development, each Vite bridge owns one
 `~/.rnx/dev-bridges/<port>.json` heartbeat record. CLI defaults select the
 current `PORT_OFFSET`, then the current checkout, then the canonical `:7668`
 bridge, so concurrent worktrees cannot replace or delete one another's address.
+Each Vite shell also publishes its exact bridge at `/__sootsim/bridge`, so a
+launcher that reuses a shell from another isolated `RNX_HOME` stays in that
+shell's bridge world without reading the other process's lockfile directory.
 
 **The sim** is a browser/Electron *page* launched by a CLI driver. Inside that
 page run three workers: the **shell worker** owns device and native state, the

package/cli/commands/detox.ts

@@ -86,6 +86,7 @@ export async function runDetox(args: string[], opts: RunDetoxOpts = {}): Promise
       prev === '-t' ||
       prev === '--testNamePattern' ||
       prev === '--grep' ||
+      prev === '--outputFile' ||
       prev === '--maxWorkers' ||
       prev === '--shard'
     )
@@ -154,11 +155,28 @@ export async function runDetox(args: string[], opts: RunDetoxOpts = {}): Promise
     // scope roots + testMatch to the discovered test dir so jest doesn't
     // scan the entire repo (which causes haste collisions in monorepos).
     const presetPath = resolve(resolveDetoxDir(), 'jest-preset.cjs')
+    // an external suite may optionally declare its own ignore patterns via e2e/jest-ignore.cjs
+    const suiteIgnoreFile = testDir ? join(testDir, 'e2e', 'jest-ignore.cjs') : null
+    let suiteIgnorePatterns: string[] = []
+    if (suiteIgnoreFile && existsSync(suiteIgnoreFile)) {
+      try {
+        const req = createRequire(import.meta.url)
+        const exported = req(suiteIgnoreFile)
+        suiteIgnorePatterns = Array.isArray(exported)
+          ? exported
+          : Array.isArray(exported.testPathIgnorePatterns)
+            ? exported.testPathIgnorePatterns
+            : []
+      } catch {}
+    }
     tempConfig = join(tmpdir(), `rnx-detox-${process.pid}.config.cjs`)
     const cfg = {
       rootDir: testDir,
       roots: ['<rootDir>'],
       testMatch: ['<rootDir>/**/*.test.ts', '<rootDir>/**/*.test.js'],
+      ...(suiteIgnorePatterns.length > 0
+        ? { testPathIgnorePatterns: suiteIgnorePatterns }
+        : {}),
     }
     writeFileSync(
       tempConfig,

package/cli/commands/inspect.ts

@@ -475,9 +475,9 @@ function printRenderProfile(worker: string, rp: Record<string, any> | undefined)
       )
     }
   }
-  if (rp.paragraphBuilds || rp.paragraphLayouts) {
+  if (rp.paragraphBuilds || rp.prewarmParagraphBuilds || rp.paragraphLayouts) {
     console.log(
-      `      text shaping: ${rp.paragraphBuilds} shaped ${Number(rp.paragraphBuildMs ?? 0).toFixed(1)}ms · ${rp.paragraphLayouts} re-broken ${Number(rp.paragraphLayoutMs ?? 0).toFixed(1)}ms`,
+      `      text shaping: ${rp.paragraphBuilds} shaped on frame ${Number(rp.paragraphBuildMs ?? 0).toFixed(1)}ms · ${rp.prewarmParagraphBuilds ?? 0} shaped on idle ${Number(rp.prewarmParagraphBuildMs ?? 0).toFixed(1)}ms · ${rp.paragraphLayouts} re-broken ${Number(rp.paragraphLayoutMs ?? 0).toFixed(1)}ms (all phases)`,
     )
   }
   console.log(`      blur:         ${rp.avgBlurMs}ms`)

package/cli/outbound-endpoints.ts

@@ -250,8 +250,6 @@ export const DECLARED_OUTBOUND_CALLS: Record<string, OutboundCallDeclaration> =
     { category: 'contrast_user_action', count: 1 },
   'packages/sootsim-engine/src/auth/shared-session.ts :: fetch :: `${CONTRAST_ORIGIN}/api/auth/sign-out`':
     { category: 'contrast_user_action', count: 1 },
-  'packages/sootsim-engine/src/auth/UploadsMenu.tsx :: fetch :: `${CONTRAST_ORIGIN}/api/preview/uploads?limit=20`':
-    { category: 'contrast_user_action', count: 1 },
   "packages/sootsim-engine/src/billing/client.ts :: fetch :: apiUrl('/api/sootsim/billing/checkout')":
     { category: 'contrast_user_action', count: 1 },
   'packages/sootsim-engine/src/billing/client.ts :: fetch :: apiUrl(path)': {

package/detox/index.ts

@@ -7,7 +7,12 @@ import * as path from 'path'
 import { chromium } from 'playwright'
 import { launchReapedChromeScoped } from '../../../scripts/lib/reap-browser'
 import { pollUntil } from '../src/poll-until'
-import { createExpect, createWaitFor } from './expectations'
+import {
+  createExpect,
+  createWaitFor,
+  describeNodeVisibility,
+  isNodeVisible,
+} from './expectations'
 import {
   dispatchTwoFingerGesture,
   dragScrollNode,
@@ -725,6 +730,11 @@ function createSootSimElement(matcher: Matcher): SootSimElement {
       await waitForSootsimWorkletsIdle(page, 3000)
       const node = await findNodeByMatcher(matcher)
       if (!node) throw new Error(`element not found for tap: ${JSON.stringify(matcher)}`)
+      if (!isNodeVisible(node)) {
+        throw new Error(
+          `Cannot perform action due to constraint failure: element not visible (${describeNodeVisibility(node)}): ${JSON.stringify(matcher)}`,
+        )
+      }
       const defaultPoint = point ? null : await getDefaultTapPoint(page, node)
       const targetSootSimX =
         typeof point?.x === 'number'
@@ -750,6 +760,11 @@ function createSootSimElement(matcher: Matcher): SootSimElement {
       const node = await findNodeByMatcher(matcher)
       if (!node)
         throw new Error(`element not found for multiTap: ${JSON.stringify(matcher)}`)
+      if (!isNodeVisible(node)) {
+        throw new Error(
+          `Cannot perform action due to constraint failure: element not visible (${describeNodeVisibility(node)}): ${JSON.stringify(matcher)}`,
+        )
+      }
       const center = getNodeCenter(node)
       const pageCoords = await sootsimToPage(page, center.x, center.y)
 
@@ -775,6 +790,11 @@ function createSootSimElement(matcher: Matcher): SootSimElement {
       const node = await findNodeByMatcher(matcher)
       if (!node)
         throw new Error(`element not found for longPress: ${JSON.stringify(matcher)}`)
+      if (!isNodeVisible(node)) {
+        throw new Error(
+          `Cannot perform action due to constraint failure: element not visible (${describeNodeVisibility(node)}): ${JSON.stringify(matcher)}`,
+        )
+      }
       const duration = typeof pointOrDuration === 'number' ? pointOrDuration : durationArg
       const target =
         typeof pointOrDuration === 'object'

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

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

package/dist-lib/agent-events.cjs

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

package/dist-lib/agent-identity.cjs

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

package/dist-lib/agent-sessions.cjs

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

package/dist-lib/attached-projects.cjs

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

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

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

package/dist-lib/backend-origin.cjs

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

package/dist-lib/beta.cjs

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

package/dist-lib/beta.mjs

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

package/dist-lib/bridge-constants.cjs

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

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

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

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var SIM_LONG_PRESS_MAX_MS = 5e3;

package/dist-lib/bridge-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var SIM_LONG_PRESS_DEFAULT_MS = 500;

package/dist-lib/capture-contract.cjs

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/capture-contract.ts
 var RNX_SCREEN_CAPTURE_VERSION = 1;

package/dist-lib/cli-constants.cjs

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

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/cloud-contract.ts
 var RNX_CLOUD_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024;

package/dist-lib/cloud.cjs

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

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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;
@@ -2319,6 +2319,11 @@ function createSootSimElement(matcher) {
       await waitForSootsimWorkletsIdle(page, 3e3);
       const node = await findNodeByMatcher(matcher);
       if (!node) throw new Error(`element not found for tap: ${JSON.stringify(matcher)}`);
+      if (!isNodeVisible(node)) {
+        throw new Error(
+          `Cannot perform action due to constraint failure: element not visible (${describeNodeVisibility(node)}): ${JSON.stringify(matcher)}`
+        );
+      }
       const defaultPoint = point ? null : await getDefaultTapPoint(page, node);
       const targetSootSimX = typeof point?.x === "number" ? node.absolutePosition.x + point.x : defaultPoint?.x ?? node.absolutePosition.x + node.layout.width / 2;
       const targetSootSimY = typeof point?.y === "number" ? node.absolutePosition.y + point.y : defaultPoint?.y ?? node.absolutePosition.y + node.layout.height / 2;
@@ -2332,6 +2337,11 @@ function createSootSimElement(matcher) {
       const node = await findNodeByMatcher(matcher);
       if (!node)
         throw new Error(`element not found for multiTap: ${JSON.stringify(matcher)}`);
+      if (!isNodeVisible(node)) {
+        throw new Error(
+          `Cannot perform action due to constraint failure: element not visible (${describeNodeVisibility(node)}): ${JSON.stringify(matcher)}`
+        );
+      }
       const center = getNodeCenter(node);
       const pageCoords = await sootsimToPage(page, center.x, center.y);
       for (let i = 0; i < times; i++) {
@@ -2352,6 +2362,11 @@ function createSootSimElement(matcher) {
       const node = await findNodeByMatcher(matcher);
       if (!node)
         throw new Error(`element not found for longPress: ${JSON.stringify(matcher)}`);
+      if (!isNodeVisible(node)) {
+        throw new Error(
+          `Cannot perform action due to constraint failure: element not visible (${describeNodeVisibility(node)}): ${JSON.stringify(matcher)}`
+        );
+      }
       const duration = typeof pointOrDuration === "number" ? pointOrDuration : durationArg;
       const target = typeof pointOrDuration === "object" ? {
         x: node.absolutePosition.x + pointOrDuration.x,

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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/bridge-host.cjs

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

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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/jump-to-source-babel.cjs

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

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/public-brand.ts
 var name = "rnx";

package/dist-lib/metro-fingerprint-registry.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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/metro-fingerprint-registry.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/metro-fingerprint-registry.ts
 var RNX_METRO_FINGERPRINT_SCHEMA_VERSION = 2;

package/dist-lib/metro-production-bundle.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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/metro-production-bundle.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/metro-production-bundle.ts
 var RNXSIM_METRO_MODULE_PATHS_PREFIX = "globalThis.__sootsimModulePaths=";

package/dist-lib/metro.cjs

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

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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/react-native-host-modules.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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/react-native-host-modules.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/react-native-host-modules.ts
 var REACT_NATIVE_PASSTHROUGH_SPECIFIERS = [

package/dist-lib/render-mode.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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/scripts/dev-server-scanner.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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;
@@ -693,25 +693,25 @@ var init_capability_inventory_coverage = __esm({
           ios: {
             combined: {
               raw: {
-                covered: 213,
-                ratio: 0.153127246585,
+                covered: 233,
+                ratio: 0.167505391804,
                 total: 1391
               },
               weighted: {
-                covered: 1.38498343762,
-                ratio: 0.289659691768,
+                covered: 1.63749741651,
+                ratio: 0.34247124121,
                 total: 4.78141583721
               }
             },
             semantic: {
               raw: {
-                covered: 213,
-                ratio: 0.213855421687,
+                covered: 233,
+                ratio: 0.233935742972,
                 total: 996
               },
               weighted: {
-                covered: 1.38498343762,
-                ratio: 0.578085386368,
+                covered: 1.63749741651,
+                ratio: 0.683483499504,
                 total: 2.39581119032
               }
             },
@@ -1334,13 +1334,13 @@ var init_capability_outcomes2 = __esm({
             assessed: 0
           },
           ios: {
-            passedWeight: 0,
-            failedWeight: 0,
-            unassessedWeight: 0.957145688695477,
-            totalWeight: 0.957145688695477,
-            assessedWeight: 0,
-            compatibility: null,
-            assessed: 0
+            passedWeight: 0.32201435438317577,
+            failedWeight: 22084925244e-15,
+            unassessedWeight: 0.6351092493870464,
+            totalWeight: 0.9571456886954661,
+            assessedWeight: 0.3220364393084198,
+            compatibility: 0.9999314210364161,
+            assessed: 0.3364549860192514
           }
         }
       },
@@ -1469,10 +1469,11 @@ var init_capability_outcomes2 = __esm({
 });
 
 // ../compat/src/generated/react-native-root-export-coverage.ts
-var REACT_NATIVE_ROOT_EXPORT_STRICT_COVERAGE;
+var REACT_NATIVE_ROOT_EXPORT_WILL_IT_WORK_COVERAGE, REACT_NATIVE_ROOT_EXPORT_STRICT_COVERAGE;
 var init_react_native_root_export_coverage = __esm({
   "../compat/src/generated/react-native-root-export-coverage.ts"() {
     "use strict";
+    REACT_NATIVE_ROOT_EXPORT_WILL_IT_WORK_COVERAGE = 0.99;
     REACT_NATIVE_ROOT_EXPORT_STRICT_COVERAGE = 0.765;
   }
 });
@@ -1794,7 +1795,7 @@ var init_supported_native_packages = __esm({
       "react-native-fs",
       // coverage
       "react-native-gesture-handler",
-      // preset
+      // preset+coverage
       "react-native-get-device-locale",
       // coverage
       "react-native-get-location",
@@ -1872,7 +1873,7 @@ var init_supported_native_packages = __esm({
       "react-native-randombytes",
       // coverage
       "react-native-reanimated",
-      // preset+visual-proof
+      // preset+visual-proof+coverage
       "react-native-restart",
       // coverage
       "react-native-restart-newarch",
@@ -1884,7 +1885,7 @@ var init_supported_native_packages = __esm({
       "react-native-screen-corner-radius",
       // coverage
       "react-native-screens",
-      // preset+visual-proof
+      // preset+visual-proof+coverage
       "react-native-securerandom",
       // coverage
       "react-native-settings",
@@ -1993,6 +1994,13 @@ var init_unsupported_packages = __esm({
 });
 
 // ../compat/src/registry.ts
+function scoredCoverage(packageName, estimate) {
+  const outcomes = CAPABILITY_PACKAGE_OUTCOMES[packageName];
+  const measured = outcomes.byPlatform.ios.compatibility;
+  if (measured === null)
+    return { coverage: estimate, estimate, coverageSource: "estimated" };
+  return { coverage: measured, estimate, coverageSource: "measured", outcomes };
+}
 var COMPAT_CATEGORIES, POLYFILL_REGISTRY;
 var init_registry = __esm({
   "../compat/src/registry.ts"() {
@@ -2035,10 +2043,8 @@ var init_registry = __esm({
             range: ">=0.86.0 <0.87.0",
             // outcomes measure declared scenarios; strictCoverage remains an
             // independent equal-export implementation estimate.
-            coverage: CAPABILITY_PACKAGE_OUTCOMES["react-native"].byPlatform.ios.compatibility,
+            ...scoredCoverage("react-native", REACT_NATIVE_ROOT_EXPORT_WILL_IT_WORK_COVERAGE),
             strictCoverage: REACT_NATIVE_ROOT_EXPORT_STRICT_COVERAGE,
-            coverageSource: "measured",
-            outcomes: CAPABILITY_PACKAGE_OUTCOMES["react-native"],
             capabilityCoverage: CAPABILITY_INVENTORY_PACKAGE_COVERAGE["react-native"],
             note: "React Native 0.86 root surface with useful core rendering, input, scrolling, animation, list, platform, and native-module behavior",
             working: "all 99 React Native 0.86.2 public runtime root export names; flex and absolute layout, text shaping and wrapping, image loading and resize modes, touch and responder routing, controlled text input and keyboard presentation, vertical and horizontal scrolling with paging/snapping/sticky and maintained content, windowed/inverted/horizontal lists, common Animated graphs and composition, core LayoutAnimation create/update/delete geometry, alerts and action sheets, live platform/dimension/appearance state, and explicit native-module lookup",
@@ -2059,9 +2065,7 @@ var init_registry = __esm({
           },
           {
             range: ">=4.0.0 <5.0.0",
-            coverage: CAPABILITY_PACKAGE_OUTCOMES["react-native-reanimated"].byPlatform.ios.compatibility,
-            coverageSource: "measured",
-            outcomes: CAPABILITY_PACKAGE_OUTCOMES["react-native-reanimated"],
+            ...scoredCoverage("react-native-reanimated", 0.97),
             capabilityCoverage: CAPABILITY_INVENTORY_PACKAGE_COVERAGE["react-native-reanimated"],
             note: "core animations, gestures, scroll, layout transitions, common CSS opacity, transform, and processed-color transitions and keyframes, keyboard, sensors, reduced motion, native view property reads, and direct static style snapshots",
             working: "useSharedValue, useAnimatedStyle/Props/Reaction, useDerivedValue, useAnimatedScrollHandler, useScrollViewOffset, useFrameCallback, useAnimatedRef, useAnimatedKeyboard, useAnimatedSensor, useReducedMotion, entering/exiting/layout transitions, css/createCSSAnimatedComponent with cubicBezier/linear/steps timing for common opacity and transform transitions, opacity and transform keyframes with retained forwards fill, withTiming/Spring/Decay/Delay/Sequence/Repeat/Clamp, interpolate, interpolateColor, runOnJS/UI, measure, scrollTo, getViewProp (layout, opacity, zIndex, backgroundColor, boxShadow), direct setViewStyle snapshots, Easing, createAnimatedComponent, Animated.View/Text/Image/ScrollView/FlatList",
@@ -2077,9 +2081,7 @@ var init_registry = __esm({
           { range: ">=2.0.0 <2.30.0", coverage: 0.7, note: "tap, pan, long press" },
           {
             range: ">=2.30.0 <3.0.0",
-            coverage: CAPABILITY_PACKAGE_OUTCOMES["react-native-gesture-handler"].byPlatform.ios.compatibility,
-            coverageSource: "measured",
-            outcomes: CAPABILITY_PACKAGE_OUTCOMES["react-native-gesture-handler"],
+            ...scoredCoverage("react-native-gesture-handler", 0.9),
             capabilityCoverage: CAPABILITY_INVENTORY_PACKAGE_COVERAGE["react-native-gesture-handler"],
             note: "tap, pan, pinch, rotation, fling, long press, race, manual, simultaneous, force touch unavailable-hardware parity",
             working: "GestureDetector, Gesture.Tap/Pan/Pinch/Rotation/Fling/LongPress/ForceTouch/Manual/Race/Simultaneous/Exclusive/Hover, ForceTouchGestureHandler unavailable-hardware fallback (children render, forceTouchAvailable false, no force events), simultaneousWithExternalGesture/requireExternalGestureToFail/blocksExternalGesture, ScrollView/FlatList, Switch/RefreshControl, Pressable/Text, Touchables, BaseButton/RawButton/RectButton/BorderlessButton/PureNativeButton, Swipeable, ReanimatedSwipeable, DrawerLayout (the upstream component running on this seam: renderNavigationView, drawerPosition/drawerType/drawerWidth/edgeWidth, openDrawer/closeDrawer, edge-swipe drag, onDrawerOpen/onDrawerClose/onDrawerStateChanged), GestureHandlerRootView, createNativeWrapper, gestureHandlerRootHOC, PointerType/MouseButton/HoverEffect exports, velocity tracking, activeOffsets, multi-tap"
@@ -2094,9 +2096,7 @@ var init_registry = __esm({
           { range: ">=3.0.0 <4.0.0", coverage: 0.6, note: "basic screen container" },
           {
             range: ">=4.0.0",
-            coverage: CAPABILITY_PACKAGE_OUTCOMES["react-native-screens"].byPlatform.ios.compatibility,
-            coverageSource: "measured",
-            outcomes: CAPABILITY_PACKAGE_OUTCOMES["react-native-screens"],
+            ...scoredCoverage("react-native-screens", 0.95),
             capabilityCoverage: CAPABILITY_INVENTORY_PACKAGE_COVERAGE["react-native-screens"],
             note: "screen container, stack, header config, search bar, navigation props",
             working: "Screen, ScreenContainer, ScreenStack, enableFreeze/freezeEnabled with delayed React freeze, Android modal/pageSheet push fallback, Android statusBarHidden/statusBarStyle/navigationBarHidden traits, push/pop slide, replaceAnimation push/pop direction, zoom/fade/fade_from_bottom transitions, edge swipe-back, parallax behind-screen, large title collapse, header (back button, inline/large title, custom left/center/right/search bar subviews, native header bar buttons/menus/badges, crossfade), formSheet custom initial detents/corner radius/grabber/undimmed range and stacked sheets, useHeaderHeight, useTransitionProgress, FullWindowOverlay, SearchBar with stacked and iOS 26 automatic/inline/integrated/integratedCentered/integratedButton toolbar placement, Tabs.Host/Screen, lifecycle callbacks (onAppear/onDisappear/onWillAppear/onWillDisappear), onDismissed",
@@ -2125,9 +2125,7 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=13.0.0",
-            coverage: CAPABILITY_PACKAGE_OUTCOMES["react-native-svg"].byPlatform.ios.compatibility,
-            coverageSource: "measured",
-            outcomes: CAPABILITY_PACKAGE_OUTCOMES["react-native-svg"],
+            ...scoredCoverage("react-native-svg", 0.85),
             capabilityCoverage: CAPABILITY_INVENTORY_PACKAGE_COVERAGE["react-native-svg"],
             note: "full CanvasKit rendering for shapes, text, XML, gradients, references, masks, clipping, and images; SVG filter elements skipped",
             working: "Svg, Path, Circle, Rect, Line, Ellipse, Polygon, Polyline, G, Text, TSpan, Defs, LinearGradient and RadialGradient with objectBoundingBox/userSpaceOnUse coordinates, focal points and gradientTransform, Stop, Mask, ClipPath, Image, Use and Symbol references, SvgXml, SvgUri, SvgAst, SvgFromXml, SvgCss, parse, fetchText, camelCase, shape transforms, fill/stroke/opacity/dasharray, currentColor, viewBox scaling",
@@ -2243,9 +2241,7 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=1.0.0",
-            coverage: CAPABILITY_PACKAGE_OUTCOMES["react-native-keyboard-controller"].byPlatform.ios.compatibility,
-            coverageSource: "measured",
-            outcomes: CAPABILITY_PACKAGE_OUTCOMES["react-native-keyboard-controller"],
+            ...scoredCoverage("react-native-keyboard-controller", 0.88),
             capabilityCoverage: CAPABILITY_INVENTORY_PACKAGE_COVERAGE["react-native-keyboard-controller"],
             note: "native bindings stubbed (KeyboardControllerNative, KeyboardEvents, FocusedInputEvents, WindowDimensionsEvents, KeyboardControllerView + sibling native views); upstream pure-JS components, hooks, animated module, and KeyboardAvoidingView resolve from node_modules unchanged",
             working: "every upstream JS export runs through reanimated worklets; Android KeyboardGestureArea drives the existing keyboard owner through drag progress, velocity/distance settling, cancellation, focus retention, and cleanup; supported exports include KeyboardProvider, KeyboardAvoidingView, KeyboardStickyView, KeyboardAwareScrollView, KeyboardToolbar, KeyboardGestureArea, useReanimatedKeyboardAnimation, useKeyboardAnimation, useKeyboardHandler, useGenericKeyboardHandler, useKeyboardController, useKeyboardState, useKeyboardContext, useReanimatedFocusedInput, useFocusedInputHandler, useResizeMode, useWindowDimensions, KeyboardEvents, FocusedInputEvents, WindowDimensionsEvents resize events, KeyboardController (dismiss/setFocusTo/isVisible/state/preload/setInputMode/setDefaultMode), KeyboardControllerView, OverKeyboardView, KeyboardBackgroundView, KeyboardExtender, ClippingScrollView, KeyboardToolbarGroupView, and AndroidSoftInputModes",
@@ -14302,6 +14298,7 @@ function matchCompatVersion(entry, declaredVersion) {
   return {
     ...resolution,
     coverage: selected.coverage,
+    ...selected.estimate !== void 0 ? { estimate: selected.estimate } : {},
     coverageSource: selected.coverageSource ?? "estimated",
     ...selected.outcomes ? { outcomes: selected.outcomes } : {},
     note: selected.note,

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.445 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.447 | (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.445",
+  "version": "0.1.447",
   "description": "Vite and Metro plugins, testing drivers, and SDK exports for rnx.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",

package/src/shell-bridge-identity.ts

@@ -0,0 +1,15 @@
+export const SHELL_BRIDGE_IDENTITY_PATH = '/__sootsim/bridge'
+
+export interface ShellBridgeIdentity {
+  schema: 1
+  bridgePort: number
+}
+
+export function isShellBridgeIdentity(value: unknown): value is ShellBridgeIdentity {
+  if (typeof value !== 'object' || value === null) return false
+  return (
+    Reflect.get(value, 'schema') === 1 &&
+    Number.isInteger(Reflect.get(value, 'bridgePort')) &&
+    Reflect.get(value, 'bridgePort') > 0
+  )
+}

package/src/vite-plugin.ts

@@ -23,6 +23,10 @@ import {
   reactNativeDeepStubsForBuildResolver,
 } from '../../compat/src/stub-manifest.ts'
 import { resolveSootsimBridgePort } from './bridge-constants.ts'
+import {
+  SHELL_BRIDGE_IDENTITY_PATH,
+  type ShellBridgeIdentity,
+} from './shell-bridge-identity.ts'
 import {
   REANIMATED_WORKLETIZATION_REGEX,
   shouldApplyWorkletsPlugin,
@@ -842,63 +846,92 @@ export function wsBridgePlugin(options: { ownedBridgePort?: number } = {}): Plug
     name: 'sootsim-ws-bridge',
     apply: 'serve',
     configureServer(server) {
-      if (boundPort) return
-      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,
-            getShellPort: () => shellPort.read(),
-          })
+      if (!boundPort) {
+        const preferredPort = resolveSootsimBridgePort({
+          explicitPort: process.env.SOOTSIM_BRIDGE_PORT,
+          portOffset: process.env.PORT_OFFSET,
         })
-        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
+        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,
+              getShellPort: () => shellPort.read(),
+            })
           })
-        entry = {
-          boundPort,
-          close: async () => {
-            try {
-              await (await host).close()
-            } catch {}
-          },
-          owners: new Set([owner]),
-          shellPort,
+          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,
+          }
+          viteBridgeProcesses.set(preferredPort, entry)
         }
-        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()
+        })
       }
 
-      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()
+      if (!boundPort) throw new Error('rnx bridge identity was not initialized')
+      const identityPort = boundPort
+      server.middlewares.use((req, res, next) => {
+        if (req.url?.split('?')[0] !== SHELL_BRIDGE_IDENTITY_PATH) {
+          next()
+          return
+        }
+        void identityPort
+          .then((bridgePort) => {
+            if (bridgePort === null) {
+              res.statusCode = 503
+              res.end('rnx bridge unavailable')
+              return
+            }
+            const identity = {
+              schema: 1,
+              bridgePort,
+            } satisfies ShellBridgeIdentity
+            res.setHeader('Content-Type', 'application/json')
+            res.setHeader('Cache-Control', 'no-store')
+            res.end(JSON.stringify(identity))
+          })
+          .catch(() => {
+            res.statusCode = 503
+            res.end('rnx bridge unavailable')
+          })
       })
     },
     // publish the bound port to the page. head-prepend so it lands before the