rnxsim 0.1.522 → 0.1.523

package/cli/commands/control.ts

@@ -393,30 +393,46 @@ function localBasePort(target: string): number | null {
   }
 }
 
+// a dev server started alongside open connect may still be booting when the
+// first probe lands. retry briefly so staging does not fail on a server that
+// becomes probe-ready a few seconds later.
+const DEV_BUNDLE_RESOLVE_ATTEMPTS = 15
+const DEV_BUNDLE_RESOLVE_INTERVAL_MS = 1000
+
 async function resolveConnectionInputForCli(target: string): Promise<ResolvedDevBundle> {
   const normalized = normalizeKnownTarget(target)
   const registeredPort = /^\d+$/.test(normalized)
     ? Number(normalized)
     : localBasePort(normalized)
 
-  if (registeredPort && registeredPort > 0) {
-    const discovered = await probePort(registeredPort)
-    // a provisional bundle URL means the scanner's fast manifest probe got no
-    // answer and fell back to the generic `/index.bundle`. that is enough to
-    // LIST the server and not enough to open it, so hand the question to
-    // `resolveConnectionInput`, which asks the manifest again with a budget
-    // that fits a real dev server and returns the entry point the app names.
-    if (discovered && !discovered.bundleUrlProvisional) {
-      return {
-        bundleUrl: discovered.bundleUrl,
-        port: discovered.port,
-        framework: discovered.framework,
-        projectName: discovered.projectName,
+  let lastError: Error | null = null
+  for (let attempt = 0; attempt < DEV_BUNDLE_RESOLVE_ATTEMPTS; attempt++) {
+    if (registeredPort && registeredPort > 0) {
+      const discovered = await probePort(registeredPort)
+      // a provisional bundle URL is enough to LIST the server but not to open
+      // it; fall through to resolveConnectionInput, which asks the manifest
+      // again with a budget that fits a real dev server.
+      if (discovered && !discovered.bundleUrlProvisional) {
+        return {
+          bundleUrl: discovered.bundleUrl,
+          port: discovered.port,
+          framework: discovered.framework,
+          projectName: discovered.projectName,
+        }
       }
     }
-  }
 
-  return resolveConnectionInput(normalized)
+    try {
+      return await resolveConnectionInput(normalized)
+    } catch (error) {
+      if (!(error instanceof Error) || !error.message.startsWith("could not resolve a native bundle")) {
+        throw error
+      }
+      lastError = error
+    }
+    await sleep(DEV_BUNDLE_RESOLVE_INTERVAL_MS)
+  }
+  throw lastError ?? new Error("could not resolve a native bundle for " + normalized + " after retrying.")
 }
 
 function getShellRoutePrefix(pathname: string): string {

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var REFUSED_PERFORM_STEP_TYPES = [

package/dist-lib/capture-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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/dev-bundle-resolution.cjs

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

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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;
@@ -34247,18 +34247,30 @@ function localBasePort(target) {
 async function resolveConnectionInputForCli(target) {
   const normalized = normalizeKnownTarget(target);
   const registeredPort = /^\d+$/.test(normalized) ? Number(normalized) : localBasePort(normalized);
-  if (registeredPort && registeredPort > 0) {
-    const discovered = await probePort(registeredPort);
-    if (discovered && !discovered.bundleUrlProvisional) {
-      return {
-        bundleUrl: discovered.bundleUrl,
-        port: discovered.port,
-        framework: discovered.framework,
-        projectName: discovered.projectName
-      };
+  let lastError = null;
+  for (let attempt = 0; attempt < DEV_BUNDLE_RESOLVE_ATTEMPTS; attempt++) {
+    if (registeredPort && registeredPort > 0) {
+      const discovered = await probePort(registeredPort);
+      if (discovered && !discovered.bundleUrlProvisional) {
+        return {
+          bundleUrl: discovered.bundleUrl,
+          port: discovered.port,
+          framework: discovered.framework,
+          projectName: discovered.projectName
+        };
+      }
+    }
+    try {
+      return await resolveConnectionInput(normalized);
+    } catch (error) {
+      if (!(error instanceof Error) || !error.message.startsWith("could not resolve a native bundle")) {
+        throw error;
+      }
+      lastError = error;
     }
+    await sleep2(DEV_BUNDLE_RESOLVE_INTERVAL_MS);
   }
-  return resolveConnectionInput(normalized);
+  throw lastError ?? new Error("could not resolve a native bundle for " + normalized + " after retrying.");
 }
 function getShellRoutePrefix(pathname) {
   const normalized = pathname.replace(/\/+$/, "") || "/";
@@ -35543,7 +35555,7 @@ async function runCloseCommand(args, opts = {}) {
     bridge.close();
   }
 }
-var import_node_child_process7, import_node_fs20, import_node_os3, import_node_path22, import_settings, import_ws4, DEFAULT_DRIVER_CONNECT_TIMEOUT_MS, DRIVER_CONNECT_INTERVAL_MS, DRIVER_CONNECT_HOST_GRACE_MS, OPEN_BRIDGE_SPAWN_TIMEOUT_MS, SHELL_APPS;
+var import_node_child_process7, import_node_fs20, import_node_os3, import_node_path22, import_settings, import_ws4, DEFAULT_DRIVER_CONNECT_TIMEOUT_MS, DRIVER_CONNECT_INTERVAL_MS, DRIVER_CONNECT_HOST_GRACE_MS, OPEN_BRIDGE_SPAWN_TIMEOUT_MS, SHELL_APPS, DEV_BUNDLE_RESOLVE_ATTEMPTS, DEV_BUNDLE_RESOLVE_INTERVAL_MS;
 var init_control = __esm({
   "cli/commands/control.ts"() {
     "use strict";
@@ -35594,6 +35606,8 @@ var init_control = __esm({
       photos: "/app/photos",
       camera: "/app/camera"
     };
+    DEV_BUNDLE_RESOLVE_ATTEMPTS = 15;
+    DEV_BUNDLE_RESOLVE_INTERVAL_MS = 1e3;
   }
 });
 

package/dist-lib/swift.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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;
@@ -32,8 +32,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/swift.ts
 var swift_exports = {};
 __export(swift_exports, {
-  createSwiftModule: () => createSwiftModule,
-  createSwiftView: () => createSwiftView
+  createSwiftEntry: () => createSwiftEntry
 });
 module.exports = __toCommonJS(swift_exports);
 
@@ -190,20 +189,6 @@ function pointerExport(exports2, name) {
     return result;
   };
 }
-function maybePointerExport(exports2, name) {
-  const value = exports2[name];
-  if (value === void 0) return void 0;
-  if (typeof value !== "function") {
-    throw new Error(`swift export ${name} is not a function`);
-  }
-  return (...args) => {
-    const result = Reflect.apply(value, void 0, args);
-    if (typeof result !== "number") {
-      throw new Error(`swift export ${name} returned ${typeof result}`);
-    }
-    return result;
-  };
-}
 function voidExport(exports2, name) {
   const fn = rawExport(exports2, name);
   return (...args) => {
@@ -236,13 +221,35 @@ function instantiate(module2) {
   const initialize = voidExport(instance.exports, "_initialize");
   const mainArgv = voidExport(instance.exports, "__main_argc_argv");
   const mount = pointerExport(instance.exports, "rnx_mount");
-  const mountViewExport = maybePointerExport(instance.exports, "rnx_mount_view");
-  const hasViewExport = maybePointerExport(instance.exports, "rnx_has_view");
+  const mountViewExport = pointerExport(instance.exports, "rnx_mount_view");
+  const hasViewExport = pointerExport(instance.exports, "rnx_has_view");
   const event = pointerExport(instance.exports, "rnx_event");
   const stateExport = pointerExport(instance.exports, "rnx_state_export");
   const stateImport = voidExport(instance.exports, "rnx_state_import");
   const alloc = pointerExport(instance.exports, "rnx_alloc");
   const free = voidExport(instance.exports, "rnx_free");
+  const openURLDrain = typeof instance.exports.rnx_open_url_drain === "function" ? pointerExport(instance.exports, "rnx_open_url_drain") : null;
+  const drainOpenURLs = () => {
+    if (!openURLDrain) return;
+    let urls;
+    try {
+      urls = JSON.parse(readBuffer(openURLDrain()));
+    } catch {
+      return;
+    }
+    if (!Array.isArray(urls)) return;
+    for (const url of urls) {
+      if (typeof url !== "string") continue;
+      import_react_native.Linking.canOpenURL(url).then(
+        (open) => {
+          if (open) import_react_native.Linking.openURL(url).catch(() => {
+          });
+        },
+        () => {
+        }
+      );
+    }
+  };
   const readBuffer = (ptr) => {
     const view = new DataView(requireMemory().buffer);
     const length = view.getUint32(ptr, true);
@@ -262,41 +269,44 @@ function instantiate(module2) {
   mainArgv(0, 0);
   return {
     mount: () => {
-      if ((hasViewExport?.() ?? 0) === 1) {
+      if (hasViewExport() === 1) {
         throw new Error(
           "swift package has an RNXPackage entry, not an App entry; mount it as a view or make its @main type conform to App"
         );
       }
-      return readTree(readBuffer(mount()));
+      const tree = readTree(readBuffer(mount()));
+      drainOpenURLs();
+      return tree;
     },
     mountView: (props) => {
-      if (!mountViewExport) {
-        throw new Error(
-          "swift artifact has no rnx_mount_view export; rebuild the swift package"
-        );
-      }
-      if ((hasViewExport?.() ?? 0) !== 1) {
+      if (hasViewExport() !== 1) {
         throw new Error(
           "swift package has no RNXPackage entry; its @main type must conform to RNXPackage to mount as a view"
         );
       }
-      return readTree(
+      const tree = readTree(
         readBuffer(withPayload(props, (ptr, length) => mountViewExport(ptr, length)))
       );
+      drainOpenURLs();
+      return tree;
     },
-    hasView: () => (hasViewExport?.() ?? 0) === 1,
-    deliver: (handlerId2, payload) => readTree(
-      readBuffer(
-        withPayload(
-          payload,
-          (ptr, length) => (
-            // handler ids are opaque to the tenant: they come from the tree
-            // this instance just returned and they are only meaningful to it
-            event(handlerId2, ptr, length)
+    hasView: () => hasViewExport() === 1,
+    deliver: (handlerId2, payload) => {
+      const tree = readTree(
+        readBuffer(
+          withPayload(
+            payload,
+            (ptr, length) => (
+              // handler ids are opaque to the tenant: they come from the tree
+              // this instance just returned and they are only meaningful to it
+              event(handlerId2, ptr, length)
+            )
           )
         )
-      )
-    ),
+      );
+      drainOpenURLs();
+      return tree;
+    },
     exportState: () => readBuffer(stateExport()),
     importState: (state) => {
       withPayload(JSON.parse(state), (ptr, length) => {
@@ -378,6 +388,16 @@ function resolveModifier(modifier) {
   }
   return { ...modifier, color: resolveColor(color) };
 }
+var SwiftResourcesContext = (0, import_react.createContext)(void 0);
+function SwiftImage(props) {
+  const table = (0, import_react.useContext)(SwiftResourcesContext);
+  const { source, ...rest } = props ?? {};
+  const url = typeof source === "string" ? table?.[source] : void 0;
+  return (0, import_react.createElement)(import_ui.Image, {
+    ...rest,
+    ...source === void 0 ? {} : { source: typeof url === "string" ? { uri: url } : source }
+  });
+}
 var NODE_COMPONENTS = {
   Alert: SwiftAlert,
   BottomSheet: import_ui.BottomSheet,
@@ -390,14 +410,17 @@ var NODE_COMPONENTS = {
   Divider: import_ui.Divider,
   Ellipse: import_ui.Ellipse,
   Form: import_ui.Form,
+  GeometryReader: import_ui.GeometryReader,
   GlassEffectContainer: import_ui.GlassEffectContainer,
   Group: import_ui.Group,
   HStack: import_ui.HStack,
-  Image: import_ui.Image,
+  Image: SwiftImage,
   Label: import_ui.Label,
   LazyVStack: import_ui.LazyVStack,
+  LinearGradient: import_ui.LinearGradient,
   List: import_ui.List,
   Menu: import_ui.Menu,
+  Path: import_ui.Path,
   Picker: import_ui.Picker,
   ProgressView: import_ui.ProgressView,
   Rectangle: import_ui.Rectangle,
@@ -613,6 +636,12 @@ function nodeProps(node, deliver) {
       const size = typeof font?.size === "number" ? font.size : void 0;
       return {
         ...typeof props.systemName === "string" ? { systemName: props.systemName } : {},
+        // a bundle asset name rides as the kit image source; the kit paints
+        // its placeholder until its named-source lane lands (contrast-kit,
+        // not this mount row).
+        ...typeof props.name === "string" ? { source: props.name } : {},
+        ...props.resizable === true ? { resizable: true } : {},
+        ...typeof props.renderingMode === "string" ? { renderingMode: props.renderingMode } : {},
         ...size === void 0 ? {} : { size },
         ...pressProps(node, deliver)
       };
@@ -1095,10 +1124,26 @@ function SplitViewHost({
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native.View, { style: { flex: 1 }, children: pushed.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(NavigationStackHost, { node: { ...node, c: pushed }, deliver }) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: detail.map((child) => renderNode(child, deliver, cache)) }) })
   ] });
 }
+function SwiftAppear({
+  node,
+  deliver,
+  children
+}) {
+  const onAppear = handlerId(node, "onAppear");
+  const onDisappear = handlerId(node, "onDisappear");
+  (0, import_react.useEffect)(() => {
+    if (onAppear !== void 0) deliver(onAppear, null);
+    return () => {
+      if (onDisappear !== void 0) deliver(onDisappear, null);
+    };
+  }, []);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children });
+}
 function renderNode(node, deliver, cache) {
   const cached = cache?.entries.get(node.id);
   if (cached && sameNode(cached.node, node)) return cached.element;
-  const element = buildNode(node, deliver, cache);
+  const built = buildNode(node, deliver, cache);
+  const element = node.h?.onAppear !== void 0 || node.h?.onDisappear !== void 0 ? (0, import_react.createElement)(SwiftAppear, { key: node.id, node, deliver }, built) : built;
   cache?.entries.set(node.id, { node, element });
   return element;
 }
@@ -1140,7 +1185,8 @@ function buildNode(node, deliver, cache) {
 function SwiftTree({
   tree,
   deliver,
-  cache
+  cache,
+  resources
 }) {
   return (
     // a navigation stack at the root lays its own bar out under the status
@@ -1153,7 +1199,7 @@ function SwiftTree({
         ignoreSafeArea: tree.some(
           (node) => node.t === "NavigationStack" || node.t === "NavigationSplitView"
         ),
-        children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_native.NavigationIndependentTree, { children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_native.NavigationContainer, { children: tree.map((node) => renderNode(node, deliver, cache)) }) })
+        children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_native.NavigationIndependentTree, { children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_native.NavigationContainer, { children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SwiftResourcesContext.Provider, { value: resources, children: tree.map((node) => renderNode(node, deliver, cache)) }) }) })
       }
     )
   );
@@ -1166,19 +1212,19 @@ function rootRegistry() {
   Reflect.set(globalThis, ROOT_KEY, created);
   return created;
 }
-function slotFor(rootId, mountTree, props) {
+function slotFor(rootId, mountTree) {
   const registry = rootRegistry();
   const existing = registry.get(rootId);
   if (existing) return existing;
-  const created = { root: createRoot(mountTree, props), props };
+  const created = { root: createRoot(mountTree) };
   registry.set(rootId, created);
   return created;
 }
-function createRoot(mountTree, props) {
+function createRoot(mountTree) {
   let instance = null;
   let source = null;
   let refresh;
-  let state = { tree: null, error: null };
+  let state = { tree: null, isView: false, error: null };
   let swap = Promise.resolve();
   const listeners = /* @__PURE__ */ new Set();
   const cache = { entries: /* @__PURE__ */ new Map() };
@@ -1186,13 +1232,14 @@ function createRoot(mountTree, props) {
     state = next;
     for (const listener of listeners) listener();
   };
-  const apply = async (options) => {
+  const apply = async (options, props) => {
     const carried = instance?.exportState() ?? null;
     const created = instantiate(await compile(options.url));
     if (carried !== null) created.importState(carried);
     if (source !== options) return;
     instance = created;
-    publish({ tree: mountTree(created, props.current), error: null });
+    const mounted = mountTree(created, props);
+    publish({ tree: mounted.tree, isView: mounted.isView, error: null });
   };
   const component = function SwiftRoot() {
     const rendered = (0, import_react.useSyncExternalStore)(
@@ -1206,24 +1253,41 @@ function createRoot(mountTree, props) {
     if (!rendered.tree) return null;
     const deliver = (handlerId2, payload) => {
       if (!instance) throw new Error("swift app received an event before it mounted");
-      publish({ tree: instance.deliver(handlerId2, payload), error: null });
+      publish({
+        tree: instance.deliver(handlerId2, payload),
+        isView: rendered.isView,
+        error: null
+      });
     };
-    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SwiftTree, { tree: rendered.tree, deliver, cache });
+    const resources = source?.resources;
+    if (rendered.isView)
+      return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SwiftResourcesContext.Provider, { value: resources, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: rendered.tree.map((node) => renderNode(node, deliver, cache)) }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      SwiftTree,
+      {
+        tree: rendered.tree,
+        deliver,
+        cache,
+        resources
+      }
+    );
   };
   return {
     component,
-    use(options, refreshKey) {
-      const changed = source === null || source.hash !== options.hash || source.url !== options.url || refreshKey !== void 0 && refreshKey !== refresh;
+    use(options, refreshKey, props) {
+      const changed = source === null || source.hash !== options.hash || source.url !== options.url || JSON.stringify(source.resources ?? null) !== JSON.stringify(options.resources ?? null) || refreshKey !== void 0 && refreshKey !== refresh;
       if (changed) {
         source = options;
         refresh = refreshKey;
+        const next = props ?? {};
         swap = swap.then(
-          () => apply(options),
-          () => apply(options)
+          () => apply(options, next),
+          () => apply(options, next)
         );
         swap.catch((error) => {
           publish({
             tree: null,
+            isView: false,
             error: error instanceof Error ? error : new Error(String(error))
           });
         });
@@ -1232,11 +1296,6 @@ function createRoot(mountTree, props) {
     }
   };
 }
-function createSwiftModule(options) {
-  const rootId = options.rootId ?? "root";
-  const slot = slotFor(rootId, (instance) => instance.mount(), { current: {} });
-  return slot.root.use(options);
-}
 function propsSignature(props) {
   try {
     return JSON.stringify(props, (_key, value) => {
@@ -1253,22 +1312,21 @@ function propsSignature(props) {
     );
   }
 }
-function createSwiftView(options) {
-  const rootId = options.rootId ?? "view";
-  const slot = slotFor(rootId, (instance, props) => instance.mountView(props), {
-    current: {}
-  });
-  return function SwiftView(props) {
+function createSwiftEntry(options) {
+  const rootId = options.rootId ?? "root";
+  const slot = slotFor(
+    rootId,
+    (instance, props) => instance.hasView() ? { tree: instance.mountView(props), isView: true } : { tree: instance.mount(), isView: false }
+  );
+  return function SwiftEntry(props) {
     if (props.children !== void 0) {
-      throw new Error("swift views take data props, not children");
+      throw new Error("swift entries take data props, not children");
     }
-    slot.props.current = props;
-    const component = slot.root.use(options, propsSignature(props));
+    const component = slot.root.use(options, propsSignature(props), props);
     return (0, import_react.createElement)(component);
   };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  createSwiftModule,
-  createSwiftView
+  createSwiftEntry
 });

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.522 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.523 | (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;
@@ -829,8 +829,9 @@ function sourceStamp(packagePath) {
   }
   return hash.digest("hex").slice(0, 16);
 }
-function viewRootId(packagePath, file) {
-  return import_node_path4.default.join(packagePath, import_node_path4.default.relative(packagePath, file));
+function entryRootId(packagePath, file) {
+  const relative2 = import_node_path4.default.relative(packagePath, file).split(import_node_path4.default.sep).join(import_node_path4.default.posix.sep);
+  return `${import_node_path4.default.basename(packagePath)}${import_node_path4.default.posix.sep}${relative2}`;
 }
 function artifactUrl(project, artifact) {
   const address = devServer?.httpServer?.address();
@@ -927,14 +928,6 @@ function packageFor(file) {
     `no Package.swift above ${file}${stop === void 0 ? "" : ` (searched up to ${stop})`}; a .swift import needs a swiftpm package like the one in packages/sootsim-swift/example`
   );
 }
-function isViewPackage(packagePath) {
-  const main = /@main\s+(?:\w+\s+)*(?:struct|class|enum|actor)\s+\w+[^{]*:\s*[^{]*\bRNXPackage\b/;
-  for (const file of sourceFiles(packagePath)) {
-    const text = import_node_fs3.default.readFileSync(file, "utf8").replace(/^\s*\/\/.*$/gm, "");
-    if (main.test(text)) return true;
-  }
-  return false;
-}
 function swiftPlugin(options = {}) {
   return {
     name: "rnx-swift",
@@ -968,17 +961,9 @@ function swiftPlugin(options = {}) {
         this.warn(error instanceof Error ? error.message : String(error));
         artifact = project.artifact;
       }
-      if (isViewPackage(packagePath)) {
-        const rootId = viewRootId(packagePath, file);
-        return [
-          `import { createSwiftView } from 'rnxsim/swift'`,
-          `export default createSwiftView({ url: ${JSON.stringify(artifactUrl(project, artifact))}, hash: ${JSON.stringify(artifact.hash)}, rootId: ${JSON.stringify(rootId)} })`,
-          ""
-        ].join("\n");
-      }
       return [
-        `import { createSwiftModule } from 'rnxsim/swift'`,
-        `export default createSwiftModule({ url: ${JSON.stringify(artifactUrl(project, artifact))}, hash: ${JSON.stringify(artifact.hash)} })`,
+        `import { createSwiftEntry } from 'rnxsim/swift'`,
+        `export default createSwiftEntry({ url: ${JSON.stringify(artifactUrl(project, artifact))}, hash: ${JSON.stringify(artifact.hash)}, rootId: ${JSON.stringify(entryRootId(packagePath, file))} })`,
         ""
       ].join("\n");
     },

package/package.json

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

package/src/swift.ts

@@ -1,8 +1,7 @@
 // the runtime the `.swift` vite transform emits its module against. the
 // implementation lives beside the toolchain it drives, in sootsim-swift.
 export {
-  createSwiftModule,
-  createSwiftView,
+  createSwiftEntry,
+  type SwiftEntryOptions,
   type SwiftModuleOptions,
-  type SwiftViewOptions,
 } from '../../sootsim-swift/src/mount.tsx'

package/src/vite-plugin-swift.ts

@@ -7,7 +7,7 @@
 // artifact. both share the build below, so the artifact is compiled once.
 //
 // the hash is the hash of the built wasm, so a new hash means a genuinely
-// different app: createSwiftModule moves the @State store across it instead of
+// different app: createSwiftEntry moves the @State store across it instead of
 // remounting.
 
 import { execFile } from 'node:child_process'
@@ -108,8 +108,12 @@ export function linkedModuleRoots(packagePath: string): string[] {
 // the stamp covers the project plus the modules it links: a running dev
 // server rebuilds only when this moves, so leaving the linked sources out
 // would keep serving the artifact built before a SwiftUI module edit for as
-// long as the project's own sources stayed the same. mirrors the compile
-// service's artifact hash, which names the same closure.
+// long as the project's own sources stayed the same. it names the same
+// closure the compile service's artifact hash names, but it is not the same
+// function: the stamp hashes mtimes, which is the cheap rebuild signal for a
+// watcher, while the artifact address hashes content, which is what stays
+// stable when a checkout restores byte-identical files. a restore rebuilds
+// here and reuses the stored artifact there, by design.
 export function sourceStamp(packagePath: string): string {
   const hash = createHash('sha256')
   for (const root of [packagePath, ...linkedModuleRoots(packagePath)]) {
@@ -122,11 +126,15 @@ export function sourceStamp(packagePath: string): string {
   return hash.digest('hex').slice(0, 16)
 }
 
-// the registry slot for a view: the owning package plus the source within
-// it. two packages in one app can hold the same filename, and a bare
-// relative path would share one slot, one instance, and its state.
-export function viewRootId(packagePath: string, file: string): string {
-  return path.join(packagePath, path.relative(packagePath, file))
+// the registry slot for an entry: the owning package's own name plus the
+// source within it. two packages in one app can hold the same filename, and
+// a bare relative path would share one slot, one instance, and its state.
+// the name travels instead of the path so identical source in two checkouts
+// emits the identical module; two same-named packages sharing one app still
+// collide, and take the rootId override for that.
+export function entryRootId(packagePath: string, file: string): string {
+  const relative = path.relative(packagePath, file).split(path.sep).join(path.posix.sep)
+  return `${path.basename(packagePath)}${path.posix.sep}${relative}`
 }
 
 // the app fetches the artifact from a worker whose origin is the shell, so the
@@ -261,20 +269,6 @@ function packageFor(file: string): string {
   )
 }
 
-// whether the package mounts as a view: its @main type conforms to
-// RNXPackage instead of to App. the symbol graph is the exact read once the
-// transform emits one; until then the conformance on the @main declaration is
-// unambiguous, comments aside.
-function isViewPackage(packagePath: string): boolean {
-  const main =
-    /@main\s+(?:\w+\s+)*(?:struct|class|enum|actor)\s+\w+[^{]*:\s*[^{]*\bRNXPackage\b/
-  for (const file of sourceFiles(packagePath)) {
-    const text = fs.readFileSync(file, 'utf8').replace(/^\s*\/\/.*$/gm, '')
-    if (main.test(text)) return true
-  }
-  return false
-}
-
 export interface SwiftPluginOptions {
   // swiftpm package that owns the project's .swift sources. defaults to the
   // nearest Package.swift above each imported file, which is the vite root
@@ -338,21 +332,13 @@ export function swiftPlugin(options: SwiftPluginOptions = {}): Plugin {
         this.warn(error instanceof Error ? error.message : String(error))
         artifact = project.artifact
       }
-      // a view package mounts into its importer: the default export is the
-      // view component, rooted by its package and source path so a hot reload
-      // finds the same instance. an app package keeps the root component it
-      // always had.
-      if (isViewPackage(packagePath)) {
-        const rootId = viewRootId(packagePath, file)
-        return [
-          `import { createSwiftView } from 'rnxsim/swift'`,
-          `export default createSwiftView({ url: ${JSON.stringify(artifactUrl(project, artifact))}, hash: ${JSON.stringify(artifact.hash)}, rootId: ${JSON.stringify(rootId)} })`,
-          '',
-        ].join('\n')
-      }
+      // every import mounts through the one entry: the artifact answers
+      // whether it is a view or an app root at runtime, so the transform
+      // never re-derives the conformance from source. the entry is rooted by
+      // its package and source path so a hot reload finds the same instance.
       return [
-        `import { createSwiftModule } from 'rnxsim/swift'`,
-        `export default createSwiftModule({ url: ${JSON.stringify(artifactUrl(project, artifact))}, hash: ${JSON.stringify(artifact.hash)} })`,
+        `import { createSwiftEntry } from 'rnxsim/swift'`,
+        `export default createSwiftEntry({ url: ${JSON.stringify(artifactUrl(project, artifact))}, hash: ${JSON.stringify(artifact.hash)}, rootId: ${JSON.stringify(entryRootId(packagePath, file))} })`,
         '',
       ].join('\n')
     },