peachsim 0.1.1406 → 0.1.1463

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1406 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1463 | (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);
@@ -7,10 +7,10 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 var SEMANTIC_READY_CONTENT_NODE_FLOOR = 100;
 var HEADLESS_TENANT_FETCH_HUNG_MARKER = "headless tenant fetch hung";
 function readyProbeHasContent(probe) {
-  return (probe.browserSurfaceCount ?? 0) > 0 || probe.liveFrameActive || probe.targets > 0 || probe.nodes >= SEMANTIC_READY_CONTENT_NODE_FLOOR;
+  return probe.paintedAppContent === true || (probe.browserSurfaceCount ?? 0) > 0 || probe.liveFrameActive || probe.targets > 0 || probe.nodes >= SEMANTIC_READY_CONTENT_NODE_FLOOR;
 }
 function readyProbeHasTargetContent(probe) {
-  return (probe.browserSurfaceCount ?? 0) > 0 || probe.liveFrameActive || probe.targets > 0;
+  return probe.paintedAppContent === true || (probe.browserSurfaceCount ?? 0) > 0 || probe.liveFrameActive || probe.targets > 0;
 }
 function readyProbeIsReady(probe) {
   return (probe.flag === true ? readyProbeHasContent(probe) : readyProbeHasTargetContent(probe)) && probe.externalReady !== false && !probe.externalError && !probe.loadingText;
@@ -1336,7 +1336,7 @@ function formatTimelinePayload(kind, d) {
     case "notification":
       return `${d.title ?? ""}${d.body ? ` \u2014 ${d.body}` : ""}`;
     case "fetch":
-      return `${d.method ?? "GET"} ${d.url ?? ""}${d.status ? ` -> ${d.status}` : ""}`;
+      return `${d.method ?? "GET"} ${d.url ?? ""}${d.status ? ` -> ${d.status}` : ""}${d.error ? ` -> ${d.error}` : ""}`;
     case "console":
     case "console-log":
       return `${d.level ?? "log"}: ${(d.message ?? "").toString().slice(0, 120)}`;
@@ -1431,6 +1431,18 @@ var RuntimeReadinessUnsupportedError = class extends Error {
     this.name = "RuntimeReadinessUnsupportedError";
   }
 };
+var IdleObservationError = class extends Error {
+  constructor(elapsedMs, failure) {
+    const detail = failure instanceof Error ? failure.message : String(failure);
+    super(`idle observation failed after ${elapsedMs}ms: ${detail}`, {
+      cause: failure
+    });
+    this.elapsedMs = elapsedMs;
+    this.failure = failure;
+    __publicField(this, "code", "idle_observation_failed");
+    this.name = "IdleObservationError";
+  }
+};
 async function waitForSootsimIdle({
   bridge,
   simId,
@@ -1441,6 +1453,7 @@ async function waitForSootsimIdle({
   paintStill = false
 }) {
   let result;
+  const observationStartedAt = Date.now();
   try {
     result = await bridge.send(
       {
@@ -1471,27 +1484,23 @@ async function waitForSootsimIdle({
       let screenPixels = null
       try {
 
-        // route-aware settle: a tap that pushes/pops a screen is async \u2014 the
-        // old screen still renders for a moment, then the new one mounts and
-        // its content loads. a pure layout-hash check reports "idle" on the
-        // outgoing screen or on the incoming skeleton, so a driver re-taps
-        // and stacks duplicate navigations. drain any in-flight screen
-        // transition FIRST, bounded by the overall budget. when no
-        // transition is happening this returns in ~80ms (startWindowMs), so
-        // a plain button tap barely pays for it.
-        try {
-          const wfst = window.__sootsimTest?.waitForScreenTransitions
-          if (typeof wfst === 'function') {
+        // discover transitions while observing layout. when motion starts,
+        // observations from before its completion cannot prove the new screen.
+        let transitionWait = (async () => {
+          try {
+            const wfst = window.__sootsimTest?.waitForScreenTransitions
             const remaining = deadline - Date.now()
-            if (remaining > 120) {
-              await wfst({
+            if (typeof wfst === 'function' && remaining > 120) {
+              const transition = await wfst({
                 timeoutMs: Math.min(remaining - 80, 4000),
                 settleMs: 64,
                 startWindowMs: 80,
               })
+              return transition?.started === true
             }
-          }
-        } catch {}
+          } catch {}
+          return false
+        })()
 
         // a worker that cannot answer within the remaining budget is busy, not
         // idle: its poll reads as unsettled. bounding each read by the budget
@@ -1516,17 +1525,51 @@ async function waitForSootsimIdle({
           let nodeCount = null
           let renderStatsAvailable = false
           let shellAnimating = false
+          let shellBlockers = ''
           let webViewStarting = false
           let webViewBlocker = ''
+          // the reads are independent, so they run concurrently: a loaded sim
+          // answers each one late, and a poll that waits for them in turn
+          // costs their sum, which fits too few polls in the budget to settle.
           // strict also waits out shell motion: a system alert, sheet or menu
           // animates in the shell worker while the app's own stats read still,
           // so its presentation is complete only once the shell's list empties.
-          if (strict) {
-            const motion = await answer(() => window.__sootsimTest?.listAnimations?.()).catch(() => null)
+          const motionRead = strict
+            ? answer(() => window.__sootsimTest?.listAnimations?.()).catch(() => null)
+            : null
+          const statsRead = answer(() => window.__sootsimRenderHost?.queryStats?.()).catch(() => null)
+          // image preparation ends in the tenant before the compositor decodes
+          // and realizes its pixels. both owners must finish before settling.
+          // the compositor rejects a stats request it is too busy to answer.
+          const compositorRead = answer(() => window.__sootsimCompositor.getStats()).catch(() => BUSY)
+          const countsRead = Promise.resolve().then(() => window.__sootsimTest?.getRequestCounts?.()).catch(() => null)
+          // mounted-root membership: the live node count moves while the tree
+          // mounts, unmounts or recycles, in either render mode.
+          const nodeCountRead = Promise.resolve().then(() => window.__sootsimTest?.getNodeCount?.()).catch(() => null)
+          // the mounted hierarchy in render-worker mode comes from the test
+          // bridge: window.__sootsimRoot is an empty placeholder there, so a
+          // walk over it hashes every screen to the same empty string while
+          // it moves. listInspectable is the worker-backed read describe
+          // uses; a worker too busy to answer it reads as unsettled. tight
+          // budgets skip this read and settle on the cheaper signals above.
+          const hierarchyRead =
+            fullGeometry && typeof window.__sootsimTest?.listInspectable === 'function'
+              ? answer(() => window.__sootsimTest.listInspectable({})).catch(() => null)
+              : null
+          if (motionRead) {
+            const motion = await motionRead
             if (motion === BUSY) workerBusy = true
-            else shellAnimating = Array.isArray(motion) && motion.some((anim) => anim.realm === 'shell' && anim.priority !== 'low')
+            else if (Array.isArray(motion)) {
+              const blocking = motion.filter((anim) => anim.realm === 'shell' && anim.priority !== 'low')
+              shellAnimating = blocking.length > 0
+              // name what holds the settle so a timeout points at its owner.
+              shellBlockers = blocking
+                .slice(0, 4)
+                .map((anim) => anim.source + '/' + anim.kind + '#' + anim.id + ' at ' + anim.current + (anim.loop ? ' loop' : ''))
+                .join(', ')
+            }
           }
-          const stats = await answer(() => window.__sootsimRenderHost?.queryStats?.()).catch(() => null)
+          const stats = await statsRead
           if (stats === BUSY) {
             workerBusy = true
           } else if (stats) {
@@ -1563,10 +1606,7 @@ async function waitForSootsimIdle({
             // mounting or remounting, even with no animation flag raised.
             appCommits = typeof stats.appCommitCount === 'number' ? stats.appCommitCount : null
           }
-          // image preparation ends in the tenant before the compositor decodes
-          // and realizes its pixels. both owners must finish before settling.
-          // the compositor rejects a stats request it is too busy to answer.
-          const compositor = await answer(() => window.__sootsimCompositor.getStats()).catch(() => BUSY)
+          const compositor = await compositorRead
           if (compositor === BUSY) {
             workerBusy = true
           } else {
@@ -1577,31 +1617,12 @@ async function waitForSootsimIdle({
               webViewBlocker = 'compositor webView capture not settled'
             }
           }
-          try {
-            const counts = await window.__sootsimTest?.getRequestCounts?.()
-            requestTotal = typeof counts?.total === 'number' ? counts.total : 0
-            requestInFlight = typeof counts?.inFlight === 'number' ? counts.inFlight : 0
-          } catch {}
-          // mounted-root membership: the live node count moves while the tree
-          // mounts, unmounts or recycles, in either render mode.
-          try {
-            const total = await window.__sootsimTest?.getNodeCount?.()
-            nodeCount = typeof total === 'number' ? total : null
-          } catch {}
-          // the mounted hierarchy in render-worker mode comes from the test
-          // bridge: window.__sootsimRoot is an empty placeholder there, so a
-          // walk over it hashes every screen to the same empty string while
-          // it moves. listInspectable is the worker-backed read describe
-          // uses; a worker too busy to answer it reads as unsettled. tight
-          // budgets skip this read and settle on the cheaper signals above.
-          let hierarchy = null
-          if (fullGeometry && typeof window.__sootsimTest?.listInspectable === 'function') {
-            try {
-              hierarchy = await answer(() => window.__sootsimTest.listInspectable({}))
-            } catch {
-              hierarchy = null
-            }
-          }
+          const counts = await countsRead
+          requestTotal = typeof counts?.total === 'number' ? counts.total : 0
+          requestInFlight = typeof counts?.inFlight === 'number' ? counts.inFlight : 0
+          const total = await nodeCountRead
+          nodeCount = typeof total === 'number' ? total : null
+          let hierarchy = hierarchyRead ? await hierarchyRead : null
           if (hierarchy === BUSY) {
             workerBusy = true
             hierarchy = null
@@ -1677,7 +1698,7 @@ async function waitForSootsimIdle({
               pixelFrameToken = token
             }
           }
-          return { layout: nodes.join(';'), screenPixels, animating, shellAnimating, layoutDirty, pendingFetches, workerBusy, webViewStarting, webViewBlocker, renderStatsAvailable, requestTotal, requestInFlight, appCommits, nodeCount }
+          return { layout: nodes.join(';'), screenPixels, animating, shellAnimating, shellBlockers, layoutDirty, pendingFetches, workerBusy, webViewStarting, webViewBlocker, renderStatsAvailable, requestTotal, requestInFlight, appCommits, nodeCount }
         }
 
         // how long generic background network is allowed to keep us waiting AFTER
@@ -1764,6 +1785,19 @@ async function waitForSootsimIdle({
               Date.now() - visuallyStillSince >= requiredStillMs &&
               (networkQuiet || Date.now() - visuallyStillSince >= networkQuietGraceMs)
             ) {
+              if (transitionWait) {
+                const started = await transitionWait
+                transitionWait = null
+                if (started) {
+                  lastLayout = ''
+                  lastRequestTotal = -1
+                  lastAppCommits = null
+                  lastNodeCount = null
+                  stable = 0
+                  visuallyStillSince = 0
+                  continue
+                }
+              }
               return { settled: true, elapsed: Date.now() - start, blockedBy: '' }
             }
           } else {
@@ -1782,7 +1816,7 @@ async function waitForSootsimIdle({
         const blockers = []
         if (strict && !last.renderStatsAvailable) blockers.push('render stats unavailable')
         if (last.animating) blockers.push('animations still running')
-        if (last.shellAnimating) blockers.push('shell animations still running')
+        if (last.shellAnimating) blockers.push('shell animations still running (' + last.shellBlockers + ')')
         if (last.layoutDirty) blockers.push('layout still dirty')
         if (last.appCommits !== null && lastAppCommits !== null && last.appCommits !== lastAppCommits) blockers.push('layout commits still landing')
         if (last.nodeCount !== null && lastNodeCount !== null && last.nodeCount !== lastNodeCount) blockers.push('node count still changing')
@@ -1813,12 +1847,7 @@ async function waitForSootsimIdle({
       }
     );
   } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-      settled: false,
-      elapsed: maxMs,
-      blockedBy: message
-    };
+    throw new IdleObservationError(Math.max(0, Date.now() - observationStartedAt), error);
   }
   if (result?.error === "runtime_readiness_unsupported" && typeof result.runtimeVersion === "string" && Array.isArray(result.missingFields) && result.missingFields.every((field) => typeof field === "string")) {
     throw new RuntimeReadinessUnsupportedError(
@@ -2453,7 +2482,12 @@ var SimClient = class {
     if (!status.ready) throw new SimReadyTimeoutError(status);
     return status;
   }
-  /** wait for layout/animation/transition settle after an interaction. */
+  /**
+   * wait for layout/animation/transition settle after an interaction.
+   * a still-busy guest returns settled false with its own elapsed time.
+   * a failed idle read throws IdleObservationError with the host elapsed
+   * time and the original failure.
+   */
   settle(opts = {}) {
     return waitForSootsimIdle({
       bridge: this,
@@ -2724,9 +2758,11 @@ var SimClient = class {
 };
 export {
   DEBUG_CHANNELS,
+  IdleObservationError,
   LAYOUT_GET_NATIVE_EVAL,
   MERGED_CONSOLE_COUNT_EVAL,
   NOISY_TIMELINE_KINDS,
+  RuntimeReadinessUnsupportedError,
   SimClient,
   SimClientError,
   SimConnectError,