rnxsim 0.1.452 → 0.1.454

package/dist-lib/cloud.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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;
@@ -159,9 +159,7 @@ var require_proof_frame = __commonJS({
         throw new Error("proof content measurement needs RGBA pixels and dimensions");
       }
       const yStart = Math.floor(height * PROOF_CONTENT_DEFINITION.contentBandInsetFraction);
-      const yEnd = Math.ceil(
-        height * (1 - PROOF_CONTENT_DEFINITION.contentBandInsetFraction)
-      );
+      const yEnd = Math.ceil(height * (1 - PROOF_CONTENT_DEFINITION.contentBandInsetFraction));
       const bucketCounts = new Uint32Array(32 * 32 * 32);
       let totalPixels = 0;
       for (let y = yStart; y < yEnd; y++) {

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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;
@@ -349,6 +349,16 @@ function readCurrentTarget() {
 function readCurrentSimId() {
   return readCurrentTarget()?.simId ?? null;
 }
+function saveCurrentSimId(simId) {
+  const normalized = simId.trim();
+  if (!normalized) return;
+  writeSecureJsonAtomic(getCurrentSimPath(), {
+    version: CURRENT_SIM_VERSION,
+    plane: "local",
+    simId: normalized,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+}
 function clearCurrentSimId() {
   (0, import_fs2.rmSync)(getCurrentSimPath(), { force: true });
 }
@@ -752,6 +762,15 @@ function createBridge(wsPort, opts = {}) {
   });
   let warnedAboutContention = false;
   let noticedTarget = false;
+  let pinnedHostPid = null;
+  let lineageLookupInFlight = false;
+  function pickReloadedSuccessor(sims, retiredSimId) {
+    if (pinnedHostPid === null) return null;
+    const successors = (Array.isArray(sims) ? sims : []).filter(
+      (sim) => sim.id !== retiredSimId && sim.readyState === "open" && sim.meta?.sootsimHostPid === pinnedHostPid
+    );
+    return successors.length === 1 ? successors[0].id : null;
+  }
   function maybeNoticeTarget(cmdType, simId) {
     if (noticedTarget) return;
     if (process.env.SOOTSIM_QUIET_TARGET_NOTICE === "1") return;
@@ -807,7 +826,7 @@ function createBridge(wsPort, opts = {}) {
     plane: "local",
     async send(cmd, callOpts) {
       const effectiveTimeoutMs = callOpts?.timeoutMs ?? commandTimeoutMs;
-      const sendOnce = async (defaultSimId) => {
+      const sendOnce = async (defaultSimId, cmdOverride) => {
         await ready;
         const id = nextId++;
         return new Promise((resolve3, reject) => {
@@ -829,7 +848,7 @@ function createBridge(wsPort, opts = {}) {
               reject(e);
             }
           });
-          const payload = { ...cmd, id };
+          const payload = { ...cmdOverride ?? cmd, id };
           if (payload.simId === void 0 && defaultSimId) {
             payload.simId = defaultSimId;
           }
@@ -839,11 +858,36 @@ function createBridge(wsPort, opts = {}) {
       };
       const sentSimId = opts.simIdSource === "flag" ? opts.simId : readCurrentSimId() ?? opts.simId;
       try {
-        return await sendOnce(sentSimId);
+        const result = await sendOnce(sentSimId);
+        if (sentSimId && pinnedHostPid === null && !lineageLookupInFlight) {
+          lineageLookupInFlight = true;
+          void sendOnce(void 0, { type: "bridge:list-sims" }).then((sims) => {
+            if (!Array.isArray(sims)) return;
+            const pinned = sims.find((sim) => sim.id === sentSimId);
+            const hostPid = pinned?.meta?.sootsimHostPid;
+            if (typeof hostPid === "number") pinnedHostPid = hostPid;
+          }).catch(() => {
+          }).finally(() => {
+            lineageLookupInFlight = false;
+          });
+        }
+        return result;
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
         const missingSimMessage = `no sim connected with id ${sentSimId}`;
         if (opts.simIdSource !== "flag" && sentSimId && cmd.simId === void 0 && (message === missingSimMessage || message.startsWith(`${missingSimMessage};`))) {
+          const successor = pickReloadedSuccessor(
+            await sendOnce(void 0, { type: "bridge:list-sims" }),
+            sentSimId
+          );
+          if (successor) {
+            saveCurrentSimId(successor);
+            process.stderr.write(
+              `  note: sim ${sentSimId} reloaded and reconnected as ${successor}; following it
+`
+            );
+            return sendOnce(successor);
+          }
           clearCurrentSimId();
           throw new Error(
             `saved sim ${sentSimId} is gone${message.slice(missingSimMessage.length)}; run \`rnx list\` and \`rnx use <sim>\`, or open a fresh sim`
@@ -856,6 +900,13 @@ function createBridge(wsPort, opts = {}) {
       const sims = await this.send({ type: "bridge:list-sims" });
       return Array.isArray(sims) ? sims : [];
     },
+    // a caller holding its own pinned sim id (a flow runner sets simId on every
+    // command, so it never reaches the pin-following path in send) asks here
+    // after a reload retires that id. null means nothing proves what replaced
+    // it, and the caller must fail rather than guess.
+    async resolveReloadedSim(retiredSimId) {
+      return pickReloadedSuccessor(await this.listSims(), retiredSimId);
+    },
     async focusSim(simId) {
       return this.send({ type: "focus", simId });
     },
@@ -1694,8 +1745,19 @@ async function waitForSootsimIdle({
       let lastRequestTotal = -1
       let stable = 0
       let visuallyStillSince = 0
+      // counts across the whole budget: a flag that is true on every poll is a
+      // different bug from one that is true intermittently, and the two need
+      // opposite fixes (engine vs budget).
+      let polls = 0
+      let dirtyPolls = 0
+      let animatingPolls = 0
+      let layoutChangedPolls = 0
       while (Date.now() < deadline) {
         const snapshot = await readSnapshot()
+        polls++
+        if (snapshot.layoutDirty) dirtyPolls++
+        if (snapshot.animating) animatingPolls++
+        if (polls > 1 && snapshot.layout !== lastLayout) layoutChangedPolls++
         const strictOk =
           !strict ||
           (snapshot.renderStatsAvailable && !snapshot.animating && !snapshot.layoutDirty)
@@ -1716,7 +1778,7 @@ async function waitForSootsimIdle({
             stable >= requiredStablePolls &&
             (networkQuiet || Date.now() - visuallyStillSince >= networkQuietGraceMs)
           ) {
-            return { settled: true, elapsed: Date.now() - start }
+            return { settled: true, elapsed: Date.now() - start, blockedBy: '' }
           }
         } else {
           stable = 0
@@ -1726,17 +1788,33 @@ async function waitForSootsimIdle({
         lastRequestTotal = snapshot.requestTotal
         await sleep(pollMs)
       }
-      return { settled: false, elapsed: Date.now() - start }
+      const last = await readSnapshot()
+      const blockers = []
+      if (strict && !last.renderStatsAvailable) blockers.push('render stats unavailable')
+      if (last.animating) blockers.push('animations still running')
+      if (last.layoutDirty) blockers.push('layout still dirty')
+      if (last.pendingFetches > 0) blockers.push(last.pendingFetches + ' image fetches pending')
+      if (last.layout !== lastLayout) blockers.push('layout still changing')
+      if (last.requestInFlight > 0) blockers.push(last.requestInFlight + ' requests in flight')
+      return {
+        settled: false,
+        elapsed: Date.now() - start,
+        blockedBy:
+          (blockers.length ? blockers.join(', ') : 'unknown') +
+          ' over ' + polls + ' polls (layout changed ' + layoutChangedPolls +
+          'x, layoutDirty ' + dirtyPolls + 'x, animating ' + animatingPolls + 'x)',
+      }
     })()`
     },
     {
       timeoutMs: maxMs + 1e3
     }
   );
-  const { elapsed, settled } = result ?? {};
+  const { elapsed, settled, blockedBy } = result ?? {};
   return {
     elapsed: typeof elapsed === "number" ? elapsed : maxMs,
-    settled: settled === true
+    settled: settled === true,
+    blockedBy: typeof blockedBy === "string" ? blockedBy : "unknown"
   };
 }
 
@@ -2231,6 +2309,9 @@ var SimClient = class {
   listSims() {
     return this.bridge.listSims();
   }
+  resolveReloadedSim(retiredSimId) {
+    return this.bridge.resolveReloadedSim(retiredSimId);
+  }
   focusSim(simId = this.simId) {
     return this.bridge.focusSim(simId);
   }

package/dist-lib/jump-to-source-babel.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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;
@@ -1464,8 +1464,19 @@ async function waitForSootsimIdle({
       let lastRequestTotal = -1
       let stable = 0
       let visuallyStillSince = 0
+      // counts across the whole budget: a flag that is true on every poll is a
+      // different bug from one that is true intermittently, and the two need
+      // opposite fixes (engine vs budget).
+      let polls = 0
+      let dirtyPolls = 0
+      let animatingPolls = 0
+      let layoutChangedPolls = 0
       while (Date.now() < deadline) {
         const snapshot = await readSnapshot()
+        polls++
+        if (snapshot.layoutDirty) dirtyPolls++
+        if (snapshot.animating) animatingPolls++
+        if (polls > 1 && snapshot.layout !== lastLayout) layoutChangedPolls++
         const strictOk =
           !strict ||
           (snapshot.renderStatsAvailable && !snapshot.animating && !snapshot.layoutDirty)
@@ -1486,7 +1497,7 @@ async function waitForSootsimIdle({
             stable >= requiredStablePolls &&
             (networkQuiet || Date.now() - visuallyStillSince >= networkQuietGraceMs)
           ) {
-            return { settled: true, elapsed: Date.now() - start }
+            return { settled: true, elapsed: Date.now() - start, blockedBy: '' }
           }
         } else {
           stable = 0
@@ -1496,17 +1507,33 @@ async function waitForSootsimIdle({
         lastRequestTotal = snapshot.requestTotal
         await sleep(pollMs)
       }
-      return { settled: false, elapsed: Date.now() - start }
+      const last = await readSnapshot()
+      const blockers = []
+      if (strict && !last.renderStatsAvailable) blockers.push('render stats unavailable')
+      if (last.animating) blockers.push('animations still running')
+      if (last.layoutDirty) blockers.push('layout still dirty')
+      if (last.pendingFetches > 0) blockers.push(last.pendingFetches + ' image fetches pending')
+      if (last.layout !== lastLayout) blockers.push('layout still changing')
+      if (last.requestInFlight > 0) blockers.push(last.requestInFlight + ' requests in flight')
+      return {
+        settled: false,
+        elapsed: Date.now() - start,
+        blockedBy:
+          (blockers.length ? blockers.join(', ') : 'unknown') +
+          ' over ' + polls + ' polls (layout changed ' + layoutChangedPolls +
+          'x, layoutDirty ' + dirtyPolls + 'x, animating ' + animatingPolls + 'x)',
+      }
     })()`
     },
     {
       timeoutMs: maxMs + 1e3
     }
   );
-  const { elapsed, settled } = result ?? {};
+  const { elapsed, settled, blockedBy } = result ?? {};
   return {
     elapsed: typeof elapsed === "number" ? elapsed : maxMs,
-    settled: settled === true
+    settled: settled === true,
+    blockedBy: typeof blockedBy === "string" ? blockedBy : "unknown"
   };
 }
 
@@ -2001,6 +2028,9 @@ var SimClient = class {
   listSims() {
     return this.bridge.listSims();
   }
+  resolveReloadedSim(retiredSimId) {
+    return this.bridge.resolveReloadedSim(retiredSimId);
+  }
   focusSim(simId = this.simId) {
     return this.bridge.focusSim(simId);
   }

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.452 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.454 | (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);
@@ -1368,8 +1368,19 @@ async function waitForSootsimIdle({
       let lastRequestTotal = -1
       let stable = 0
       let visuallyStillSince = 0
+      // counts across the whole budget: a flag that is true on every poll is a
+      // different bug from one that is true intermittently, and the two need
+      // opposite fixes (engine vs budget).
+      let polls = 0
+      let dirtyPolls = 0
+      let animatingPolls = 0
+      let layoutChangedPolls = 0
       while (Date.now() < deadline) {
         const snapshot = await readSnapshot()
+        polls++
+        if (snapshot.layoutDirty) dirtyPolls++
+        if (snapshot.animating) animatingPolls++
+        if (polls > 1 && snapshot.layout !== lastLayout) layoutChangedPolls++
         const strictOk =
           !strict ||
           (snapshot.renderStatsAvailable && !snapshot.animating && !snapshot.layoutDirty)
@@ -1390,7 +1401,7 @@ async function waitForSootsimIdle({
             stable >= requiredStablePolls &&
             (networkQuiet || Date.now() - visuallyStillSince >= networkQuietGraceMs)
           ) {
-            return { settled: true, elapsed: Date.now() - start }
+            return { settled: true, elapsed: Date.now() - start, blockedBy: '' }
           }
         } else {
           stable = 0
@@ -1400,17 +1411,33 @@ async function waitForSootsimIdle({
         lastRequestTotal = snapshot.requestTotal
         await sleep(pollMs)
       }
-      return { settled: false, elapsed: Date.now() - start }
+      const last = await readSnapshot()
+      const blockers = []
+      if (strict && !last.renderStatsAvailable) blockers.push('render stats unavailable')
+      if (last.animating) blockers.push('animations still running')
+      if (last.layoutDirty) blockers.push('layout still dirty')
+      if (last.pendingFetches > 0) blockers.push(last.pendingFetches + ' image fetches pending')
+      if (last.layout !== lastLayout) blockers.push('layout still changing')
+      if (last.requestInFlight > 0) blockers.push(last.requestInFlight + ' requests in flight')
+      return {
+        settled: false,
+        elapsed: Date.now() - start,
+        blockedBy:
+          (blockers.length ? blockers.join(', ') : 'unknown') +
+          ' over ' + polls + ' polls (layout changed ' + layoutChangedPolls +
+          'x, layoutDirty ' + dirtyPolls + 'x, animating ' + animatingPolls + 'x)',
+      }
     })()`
     },
     {
       timeoutMs: maxMs + 1e3
     }
   );
-  const { elapsed, settled } = result ?? {};
+  const { elapsed, settled, blockedBy } = result ?? {};
   return {
     elapsed: typeof elapsed === "number" ? elapsed : maxMs,
-    settled: settled === true
+    settled: settled === true,
+    blockedBy: typeof blockedBy === "string" ? blockedBy : "unknown"
   };
 }
 
@@ -1905,6 +1932,9 @@ var SimClient = class {
   listSims() {
     return this.bridge.listSims();
   }
+  resolveReloadedSim(retiredSimId) {
+    return this.bridge.resolveReloadedSim(retiredSimId);
+  }
   focusSim(simId = this.simId) {
     return this.bridge.focusSim(simId);
   }