peachsim 0.1.1620 → 0.1.1635

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1620 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1635 | (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);
@@ -6,14 +6,20 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // src/bridge-contract.ts
 var SEMANTIC_READY_CONTENT_NODE_FLOOR = 100;
 var HEADLESS_TENANT_FETCH_HUNG_MARKER = "headless tenant fetch hung";
-function readyProbeHasContent(probe) {
-  return probe.paintedAppContent === true || (probe.browserSurfaceCount ?? 0) > 0 || probe.liveFrameActive || probe.targets > 0 || probe.nodes >= SEMANTIC_READY_CONTENT_NODE_FLOOR;
+function readyProbeContentBasis(probe) {
+  if (probe.paintedAppContent === true) return "paintedAppContent";
+  if ((probe.browserSurfaceCount ?? 0) > 0) return "browserSurface";
+  if (probe.liveFrameActive) return "liveFrame";
+  if (probe.targets > 0) return "targets";
+  if (probe.flag === true && probe.nodes >= SEMANTIC_READY_CONTENT_NODE_FLOOR)
+    return "nodeFloor";
+  return "";
 }
-function readyProbeHasTargetContent(probe) {
-  return probe.paintedAppContent === true || (probe.browserSurfaceCount ?? 0) > 0 || probe.liveFrameActive || probe.targets > 0;
+function readyProbeHasContent(probe) {
+  return readyProbeContentBasis({ ...probe, flag: true }) !== "";
 }
 function readyProbeIsReady(probe) {
-  return (probe.flag === true ? readyProbeHasContent(probe) : readyProbeHasTargetContent(probe)) && probe.externalReady !== false && !probe.externalError && !probe.loadingText;
+  return readyProbeContentBasis(probe) !== "" && probe.externalReady !== false && !probe.externalError && !probe.loadingText;
 }
 
 // src/bridge-contract-input.ts
@@ -863,7 +869,10 @@ function waitReadyStatus(result, ready) {
     externalError: probe?.externalError ?? "",
     suppressedEntryError: probe?.suppressedEntryError ?? "",
     errors: probe?.errors ?? 0,
-    bridgeError: result.error ?? ""
+    bridgeError: result.error ?? "",
+    paintedAppContent: probe?.paintedAppContent ?? false,
+    treeQuietMs: probe?.treeQuietMs ?? 0,
+    readyBasis: probe ? readyProbeContentBasis(probe) : ""
   };
 }
 async function inspectWaitSelector(bridge, testId, timeoutMs = 5e3, opts = {}) {
@@ -1479,6 +1488,28 @@ async function resolveTargetCoords(bridge, target) {
   };
 }
 
+// cli/maestro-accessibility.ts
+function accessibilityBounds(node) {
+  const left = Math.trunc(node.frame.x);
+  const top = Math.trunc(node.frame.y);
+  return {
+    x: left,
+    y: top,
+    width: Math.trunc(node.frame.x + node.frame.width) - left,
+    height: Math.trunc(node.frame.y + node.frame.height) - top
+  };
+}
+function sameNativeAccessibilityShape(a, b, bounds) {
+  if ((a.testID ?? "") !== (b.testID ?? "") || (a.label ?? "") !== (b.label ?? "") || (a.placeholder ?? "") !== (b.placeholder ?? "") || (a.value ?? "") !== (b.value ?? "") || a.enabled !== b.enabled || a.selected !== b.selected || a.checked !== b.checked || a.clickable !== b.clickable || (a.hasFocus ?? false) !== (b.hasFocus ?? false) || JSON.stringify(bounds(a)) !== JSON.stringify(bounds(b)) || a.children.length !== b.children.length) {
+    return false;
+  }
+  for (const [index, child] of a.children.entries()) {
+    const other = b.children[index];
+    if (!other || !sameNativeAccessibilityShape(child, other, bounds)) return false;
+  }
+  return true;
+}
+
 // cli/commands/inspect/settling.ts
 var RuntimeReadinessUnsupportedError = class extends Error {
   constructor(runtimeVersion, missingFields) {
@@ -1511,6 +1542,7 @@ async function waitForSootsimIdle({
   stablePolls = 3,
   strict = false,
   paintStill = false,
+  maestro = false,
   motionOnly = false,
   transitionStartWindowMs = 80,
   transitionTimeoutMs = 4e3
@@ -1542,12 +1574,15 @@ async function waitForSootsimIdle({
       const pollMs = ${Math.max(1, Math.round(pollMs))}
       const strict = ${strict ? "true" : "false"}
       const paintStill = ${paintStill ? "true" : "false"}
+      const maestro = ${maestro ? "true" : "false"}
+      const accessibilityBounds = ${accessibilityBounds.toString()}
+      const sameNativeAccessibilityShape = ${sameNativeAccessibilityShape.toString()}
       const motionOnly = ${motionOnly ? "true" : "false"}
       // full mounted-geometry observation needs at least two hierarchy reads
       // plus the stillness window, which a sub-second budget cannot afford:
       // tight budgets (auto-wait) settle on worker stillness plus root
       // membership, generous ones confirm the geometry too.
-      const fullGeometry = ${!motionOnly && maxMs >= 1e3 ? "true" : "false"}
+      const fullGeometry = ${!maestro && !motionOnly && maxMs >= 1e3 ? "true" : "false"}
       const requiredStillMs = paintStill ? 0 : ${Math.max(1, Math.round(stablePolls)) * Math.max(1, Math.round(pollMs))}
       const minimumStablePolls = paintStill ? 1 : ${Math.min(2, Math.max(1, Math.round(stablePolls)))}
       const composite = paintStill ? window.SootSim?.bridges?.liveComposite : null
@@ -1669,6 +1704,9 @@ async function waitForSootsimIdle({
           // 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.
+          const accessibilityRead = maestro
+            ? answer(() => window.__sootsimTest.captureAccessibilityTree()).catch(() => null)
+            : null
           const motionRead = strict
             ? answer(() => window.__sootsimTest?.listAnimations?.()).catch(() => null)
             : null
@@ -1678,9 +1716,12 @@ async function waitForSootsimIdle({
           // the compositor rejects a stats request it is too busy to answer.
           const compositorRead = answer(() => window.__sootsimCompositor.getStats()).catch(() => BUSY)
           const countsRead = motionOnly ? null : answer(() => 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 = answer(() => window.__sootsimTest?.getNodeCount?.()).catch(() => null)
+          // mounted-root membership: the count of nodes that can reach the
+          // window moves while the screen mounts, unmounts or recycles, in
+          // either render mode. a screen a pushed one covers or an inactive
+          // tab stays mounted out of the window, so what it mounts is not
+          // screen motion.
+          const nodeCountRead = answer(() => window.__sootsimTest?.getWindowNodeCount?.()).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
@@ -1710,7 +1751,7 @@ async function waitForSootsimIdle({
             const motion = await motionRead
             if (motion === BUSY) workerBusy = true
             else if (Array.isArray(motion)) {
-              const blocking = motion.filter((anim) => anim.realm === 'shell' && anim.priority !== 'low')
+              const blocking = motion.filter((anim) => anim.realm === 'shell' && anim.priority !== 'low' && anim.visible !== false)
               shellAnimating = blocking.length > 0
               // name what holds the settle so a timeout points at its owner.
               shellBlockers = blocking
@@ -1742,6 +1783,8 @@ async function waitForSootsimIdle({
               stats.hasActiveAnims === true ||
               stats.hasActiveBlockingNativeAnimations === true ||
               (!paintStill && stats.hasPendingBlockingAnimationFrames === true)
+            // the runtime reports only layout work that can reach the window:
+            // a covered screen or inactive tab committing does not hold it.
             layoutDirty =
               stats.layoutDirty === true && stats.renderRequested === true
             // a freshly-pushed screen showing a skeleton is layout-stable
@@ -1774,6 +1817,11 @@ async function waitForSootsimIdle({
           const total = await nodeCountRead
           if (total === BUSY) workerBusy = true
           nodeCount = typeof total === 'number' ? total : null
+          const accessibility = accessibilityRead ? await accessibilityRead : null
+          const nativeHierarchy = Array.isArray(accessibility) && accessibility.length > 0
+            ? accessibility
+            : null
+          if (accessibility === BUSY) workerBusy = true
           let hierarchy = hierarchyRead ? await hierarchyRead : null
           if (hierarchy === BUSY) {
             workerBusy = true
@@ -1833,9 +1881,15 @@ async function waitForSootsimIdle({
               webViewStarting = true
               webViewBlocker = 'preview progress element displayed'
             } else {
-              const unreadyWebView = document.querySelector(
+              // a loading document with no area (an app's hidden worker or
+              // executor frame) paints nothing, and a screenshot on device
+              // does not wait for it.
+              const unreadyWebView = [...document.querySelectorAll(
                 '[data-sootsim-webview-loading="true"], [data-sootsim-webview-mode="placeholder"]'
-              )
+              )].find((view) => {
+                const frame = view.querySelector('iframe')
+                return !frame || frame.clientWidth > 0 || frame.clientHeight > 0
+              })
               if (unreadyWebView) {
                 webViewStarting = true
                 webViewBlocker = 'webView document still loading'
@@ -1854,7 +1908,7 @@ async function waitForSootsimIdle({
               pixelFrameToken = token
             }
           }
-          return { layout: nodes.join(';'), screenPixels, animating, shellAnimating, shellBlockers, layoutDirty, pendingFetches, workerBusy, webViewStarting, webViewBlocker, renderStatsAvailable, requestTotal, requestInFlight, appCommits, nodeCount }
+          return { layout: nodes.join(';'), nativeHierarchy, 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
@@ -1868,6 +1922,7 @@ async function waitForSootsimIdle({
         // so the generic request counters are a courtesy, not a gate: honor them
         // only within this grace once the screen is visually still.
         const networkQuietGraceMs = 1200
+        let lastNativeHierarchy = null
         let lastLayout = ''
         let lastScreenPixels = null
         let screenChangedPolls = 0
@@ -1895,6 +1950,9 @@ async function waitForSootsimIdle({
           }
           return true
         }
+        const hierarchyUnchanged = (current, previous) =>
+          current !== null && previous !== null && current.length === previous.length &&
+          current.every((node, index) => sameNativeAccessibilityShape(node, previous[index], accessibilityBounds))
         const IDLE_HELD = { idleHeld: true }
         while (true) {
           if (clockNow() >= deadline) {
@@ -1940,7 +1998,7 @@ async function waitForSootsimIdle({
           // the loop head drains a transition still in flight before it ends.
           if (snapshot.workerBusy && clockNow() >= deadline && report) continue
           polls++
-          report = { snapshot, layout: lastLayout, screenPixels: lastScreenPixels, requestTotal: lastRequestTotal, appCommits: lastAppCommits, nodeCount: lastNodeCount }
+          report = { snapshot, nativeHierarchy: lastNativeHierarchy, layout: lastLayout, screenPixels: lastScreenPixels, requestTotal: lastRequestTotal, appCommits: lastAppCommits, nodeCount: lastNodeCount }
           if (snapshot.layoutDirty) dirtyPolls++
           if (snapshot.animating || snapshot.shellAnimating) animatingPolls++
           if (snapshot.webViewStarting) webViewStartingPolls++
@@ -1961,7 +2019,15 @@ async function waitForSootsimIdle({
           // strictOk and adds shell motion plus the blocking-stats floor. a
           // null count or commit reading means the runtime does not report
           // it, which reads as stable the way a missing stats block does.
-          const visuallyStill =
+          // native screen checks observe output, not animation ownership. after
+          // its 3 s pixel phase, iOS accepts two equal native TreeNodes even
+          // while paint-only playback continues. overlap hierarchy reads so
+          // neither the gesture nor screenshot deadline grows.
+          const maestroStill = snapshot.screenPixels !== null && !snapshot.workerBusy && !snapshot.webViewStarting && (
+            !screenChanged || (clockNow() - start >= 3000 &&
+              hierarchyUnchanged(snapshot.nativeHierarchy, lastNativeHierarchy))
+          )
+          const visuallyStill = maestro ? maestroStill :
             strictOk &&
             !snapshot.animating &&
             !snapshot.layoutDirty &&
@@ -1989,7 +2055,7 @@ async function waitForSootsimIdle({
             // grace (continuous background traffic must not block forever).
             if (
               stillProven() &&
-              (motionOnly || networkQuiet || clockNow() - visuallyStillSince >= networkQuietGraceMs)
+              (maestro || motionOnly || networkQuiet || clockNow() - visuallyStillSince >= networkQuietGraceMs)
             ) {
               if (transitionWait) {
                 await transitionWait
@@ -2001,6 +2067,7 @@ async function waitForSootsimIdle({
             stillPolls = []
             visuallyStillSince = 0
           }
+          lastNativeHierarchy = snapshot.nativeHierarchy
           lastLayout = snapshot.layout
           lastScreenPixels = snapshot.screenPixels
           lastRequestTotal = snapshot.requestTotal
@@ -2023,20 +2090,21 @@ async function waitForSootsimIdle({
         }
         const last = report.snapshot
         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 (' + last.shellBlockers + ')')
-        if (last.layoutDirty) blockers.push('layout still dirty')
-        if (last.appCommits !== null && report.appCommits !== null && last.appCommits !== report.appCommits) blockers.push('layout commits still landing')
-        if (last.nodeCount !== null && report.nodeCount !== null && last.nodeCount !== report.nodeCount) blockers.push('node count still changing')
-        if (!motionOnly && last.pendingFetches > 0) blockers.push(last.pendingFetches + ' image fetches pending')
+        if (!maestro && strict && !last.renderStatsAvailable) blockers.push('render stats unavailable')
+        if (!maestro && last.animating) blockers.push('animations still running')
+        if (!maestro && last.shellAnimating) blockers.push('shell animations still running (' + last.shellBlockers + ')')
+        if (!maestro && last.layoutDirty) blockers.push('layout still dirty')
+        if (!maestro && last.appCommits !== null && report.appCommits !== null && last.appCommits !== report.appCommits) blockers.push('layout commits still landing')
+        if (!maestro && last.nodeCount !== null && report.nodeCount !== null && last.nodeCount !== report.nodeCount) blockers.push('node count still changing')
+        if (!maestro && !motionOnly && last.pendingFetches > 0) blockers.push(last.pendingFetches + ' image fetches pending')
         if (last.workerBusy) blockers.push('a render worker too busy to report')
         if (last.webViewStarting) blockers.push(last.webViewBlocker || 'webView still starting')
-        if (last.layout !== report.layout) blockers.push('layout still changing')
+        if (!maestro && last.layout !== report.layout) blockers.push('layout still changing')
+        if (maestro && !hierarchyUnchanged(last.nativeHierarchy, report.nativeHierarchy)) blockers.push(last.nativeHierarchy === null ? 'native accessibility hierarchy unavailable' : 'native accessibility hierarchy still changing')
         if (paintStill && !last.screenPixels) blockers.push('screen pixels unavailable')
         else if (paintStill && !screenUnchanged(last.screenPixels, report.screenPixels)) blockers.push('screen pixels still changing')
-        if (!motionOnly && last.requestInFlight > 0) blockers.push(last.requestInFlight + ' requests in flight')
-        else if (!motionOnly && last.requestTotal !== report.requestTotal) blockers.push('new requests issued')
+        if (!maestro && !motionOnly && last.requestInFlight > 0) blockers.push(last.requestInFlight + ' requests in flight')
+        else if (!maestro && !motionOnly && last.requestTotal !== report.requestTotal) blockers.push('new requests issued')
         if (polls < 2) blockers.push('sim too busy to poll twice')
         // the last read is still: motion ended too near the deadline for the
         // stillness window to hold before it.
@@ -2078,8 +2146,10 @@ async function waitForSootsimIdle({
 async function waitReadyAndSettle(bridge, timeoutMs, options = {}) {
   const start = Date.now();
   const remaining = () => Math.max(0, start + timeoutMs - Date.now());
+  let accepted = null;
   const result = (status, idle2) => ({
     status,
+    accepted,
     idle: idle2,
     elapsedMs: Date.now() - start
   });
@@ -2088,6 +2158,7 @@ async function waitReadyAndSettle(bridge, timeoutMs, options = {}) {
     idle = null;
     const ready = await inspectWaitReady(bridge, remaining(), options);
     if (!ready.ready) return result(ready, idle);
+    accepted = ready;
     idle = await waitForSootsimIdle({
       bridge,
       simId: options.simId,
@@ -2511,6 +2582,20 @@ async function openAppUrl(bridge, target) {
   return normalized;
 }
 
+// src/launchMetadataContract.ts
+var LAUNCH_METADATA_QUERY_PARAM = "launchMetadata";
+var LAUNCH_METADATA_KEYS = [
+  "appFonts",
+  "appSplash",
+  "appCatalog",
+  "nativeAppIdentity",
+  "nativeFirebase",
+  "appManifest",
+  "packageVersions",
+  "dotEnv",
+  "env"
+];
+
 // src/sleep.ts
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -2579,10 +2664,8 @@ var TARGET_SEARCH_PARAMS = [
   "open",
   "port",
   "inspectOpen",
-  "appFonts",
-  "appManifest",
-  "appSplash",
-  "appCatalog"
+  ...LAUNCH_METADATA_KEYS,
+  LAUNCH_METADATA_QUERY_PARAM
 ];
 function buildSimOpenUrl(currentUrl, target) {
   const url = new URL(currentUrl);
@@ -3037,7 +3120,6 @@ export {
   layoutGetNativeEval,
   rankInteractive,
   readyProbeHasContent,
-  readyProbeHasTargetContent,
   readyProbeIsReady,
   resolveFindMode,
   resolveMaxMsFlag,