peachsim 0.1.1620 → 0.1.1635

package/dist-lib/scripts/dev-server-scanner.cjs

@@ -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 */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; } catch {}
 "use strict";
 var __create = Object.create;
@@ -319,7 +319,7 @@ function hasOwnKeys(value) {
 }
 function hasPeachConfig(config) {
   if (!config) return false;
-  return config.nativeRenderer !== void 0 || typeof config.runtimeVersion === "string" && config.runtimeVersion.length > 0 || hasOwnKeys(config.modules) || hasOwnKeys(config.turboModules) || hasOwnKeys(config.nativeModules) || hasOwnKeys(config.nativeViews) || hasOwnKeys(config.env) || hasOwnKeys(config.network?.remap) || hasOwnKeys(config.settings) || hasOwnKeys(config.initialState);
+  return config.nativeRenderer !== void 0 || config.mapKit !== void 0 || typeof config.runtimeVersion === "string" && config.runtimeVersion.length > 0 || hasOwnKeys(config.modules) || hasOwnKeys(config.turboModules) || hasOwnKeys(config.nativeModules) || hasOwnKeys(config.nativeViews) || hasOwnKeys(config.env) || hasOwnKeys(config.network?.remap) || hasOwnKeys(config.settings) || hasOwnKeys(config.initialProps) || hasOwnKeys(config.initialState);
 }
 function applyPeachConfigToUrl(url, config) {
   const parsed = new URL(url);
@@ -331,18 +331,16 @@ function applyPeachConfigToUrl(url, config) {
   return parsed.toString();
 }
 
-// src/kotlinDiscoveryContract.ts
-var KOTLIN_DISCOVERY_PATH = "/__peach/kotlin-host";
-var KOTLIN_GUEST_PATH = "/__peach/kotlin-guest.js";
-function parseKotlinHostDiscovery(value) {
-  if (!value || typeof value !== "object") return null;
-  if (!("framework" in value) || value.framework !== "kotlin" || !("projectName" in value) || typeof value.projectName !== "string" || !("status" in value) || value.status !== "compiling" && value.status !== "ready" && value.status !== "error")
-    return null;
-  return {
-    framework: value.framework,
-    projectName: value.projectName,
-    status: value.status
-  };
+// src/expo-manifest-body.ts
+function parseExpoManifestBody(body) {
+  const opening = /^(--[^\r\n]+)\r?\n/.exec(body);
+  if (!opening) return JSON.parse(body);
+  for (const part of body.split(opening[1])) {
+    const headerEnd = part.search(/\r?\n\r?\n/);
+    if (headerEnd < 0 || !/\bname="manifest"/.test(part.slice(0, headerEnd))) continue;
+    return JSON.parse(part.slice(headerEnd).trim());
+  }
+  throw new Error("Expo manifest response has no manifest part");
 }
 
 // src/native-dev-bundle-url.ts
@@ -389,6 +387,75 @@ function normalizeNativeDevBundleUrl(bundleUrl) {
   }
 }
 
+// src/dev-bundle-resolution.ts
+function shouldProxyLoopbackProbe(targetUrl) {
+  if (typeof window === "undefined") return false;
+  try {
+    const parsed = new URL(targetUrl);
+    return isLoopbackHost(parsed.hostname) && isLoopbackHost(window.location.hostname) && parsed.origin !== window.location.origin;
+  } catch {
+    return false;
+  }
+}
+async function fetchDevProbe(targetUrl, init) {
+  const requestInit = {
+    ...init,
+    cache: init?.cache ?? "no-store"
+  };
+  if (!shouldProxyLoopbackProbe(targetUrl)) {
+    return fetch(targetUrl, requestInit);
+  }
+  return fetch(`/__fetch-proxy?url=${encodeURIComponent(targetUrl)}`, requestInit);
+}
+var MANIFEST_PROBE_TIMEOUT_MS = 3e4;
+var manifestRequests = /* @__PURE__ */ new Map();
+async function fetchDevManifest(baseUrl) {
+  const normalizedBaseUrl = baseUrl.replace(/\/+$/, "");
+  const existing = manifestRequests.get(normalizedBaseUrl);
+  if (existing) return (await existing)?.clone();
+  const pending = fetchDevProbe(`${normalizedBaseUrl}/`, {
+    headers: { "expo-platform": "ios" }
+  }).then(async (res) => {
+    const body = await res.arrayBuffer();
+    return new Response(body.byteLength ? body : null, {
+      status: res.status,
+      headers: res.headers
+    });
+  }).catch(() => void 0);
+  let probeDeadline;
+  const request = Promise.race([
+    pending,
+    new Promise((resolve2) => {
+      probeDeadline = setTimeout(() => resolve2("timeout"), MANIFEST_PROBE_TIMEOUT_MS);
+    })
+  ]).then((answered) => {
+    if (answered === "timeout")
+      throw new Error(
+        `Metro manifest request timed out after ${MANIFEST_PROBE_TIMEOUT_MS / 1e3}s: ${normalizedBaseUrl}/. Wait for the dev server to finish starting or check its manifest endpoint.`
+      );
+    return answered;
+  }).finally(() => {
+    clearTimeout(probeDeadline);
+    manifestRequests.delete(normalizedBaseUrl);
+  });
+  manifestRequests.set(normalizedBaseUrl, request);
+  return (await request)?.clone();
+}
+
+// src/kotlinDiscoveryContract.ts
+var KOTLIN_DISCOVERY_PATH = "/__peach/kotlin-host";
+var KOTLIN_GUEST_PATH = "/__peach/kotlin-guest.js";
+function parseKotlinHostDiscovery(value) {
+  if (!value || typeof value !== "object") return null;
+  if (!("framework" in value) || value.framework !== "kotlin" || !("projectName" in value) || typeof value.projectName !== "string" || !("status" in value) || value.status !== "compiling" && value.status !== "ready" && value.status !== "error")
+    return null;
+  return {
+    framework: value.framework,
+    projectName: value.projectName,
+    status: value.status
+  };
+}
+
 // src/oneWidgetContract.ts
 var HOME_WIDGET_FAMILIES = [
   "systemSmall",
@@ -1138,6 +1205,28 @@ function httpGet(hostname, port, path, method = "GET", timeout = TIMEOUT_MS, hea
     });
   });
 }
+async function probeManifest(hostname, port, timeout) {
+  let deadline;
+  try {
+    return await Promise.race([
+      fetchDevManifest(buildLoopbackProbeBaseUrl("http:", hostname, port)).then(
+        async (res) => res ? {
+          statusCode: res.status,
+          body: await res.text(),
+          contentType: res.headers.get("content-type") || "",
+          hostname
+        } : null
+      ),
+      new Promise((resolve2) => {
+        deadline = setTimeout(() => resolve2(null), timeout);
+      })
+    ]);
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(deadline);
+  }
+}
 var FALLBACK_PORTS = [
   8081,
   8082,
@@ -1485,7 +1574,7 @@ async function resolveLocalIconPath(hostname, port, rawIcon) {
 function applyManifest(result, manifestRes, buildIconProxyUrl) {
   if (!manifestRes) return result;
   try {
-    const manifest = JSON.parse(manifestRes.body);
+    const manifest = parseExpoManifestBody(manifestRes.body);
     const client = manifest?.extra?.expoClient || manifest?.extra || {};
     if (client.name) result.projectName = client.name;
     if (typeof client.primaryColor === "string") result.primaryColor = client.primaryColor;
@@ -1579,16 +1668,7 @@ function enrichWithManifest(result, buildIconProxyUrl) {
 }
 async function fetchManifestEnrichment(result, buildIconProxyUrl) {
   const hostname = normalizeHostname(new URL(result.bundleUrl).hostname);
-  const manifestRes = await httpGet(
-    hostname,
-    result.port,
-    "/",
-    "GET",
-    ENRICH_TIMEOUT_MS,
-    {
-      "expo-platform": "ios"
-    }
-  );
+  const manifestRes = await probeManifest(hostname, result.port, ENRICH_TIMEOUT_MS);
   if (!manifestRes || manifestRes.statusCode !== 200) return;
   const parsed = applyManifest(
     {
@@ -1637,9 +1717,7 @@ async function probePort(port, buildIconProxyUrl, listeningProcess, verdict) {
     Promise.all([
       skipPatched ? Promise.resolve(null) : httpGet(probeHostname, port, "/__peachsim/"),
       httpGet(probeHostname, port, "/status"),
-      skipManifest ? Promise.resolve(null) : httpGet(probeHostname, port, "/", "GET", MANIFEST_TIMEOUT_MS, {
-        "expo-platform": "ios"
-      }),
+      skipManifest ? Promise.resolve(null) : probeManifest(probeHostname, port, MANIFEST_TIMEOUT_MS),
       skipExpo ? Promise.resolve(null) : httpGet(probeHostname, port, "/_expo/status"),
       httpGet(probeHostname, port, SWIFT_DISCOVERY_PATH),
       httpGet(probeHostname, port, KOTLIN_DISCOVERY_PATH),

package/dist-lib/sdk.cjs

@@ -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 */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;
@@ -87,7 +87,6 @@ __export(sdk_exports, {
   layoutGetNativeEval: () => layoutGetNativeEval,
   rankInteractive: () => rankInteractive,
   readyProbeHasContent: () => readyProbeHasContent,
-  readyProbeHasTargetContent: () => readyProbeHasTargetContent,
   readyProbeIsReady: () => readyProbeIsReady,
   resolveFindMode: () => resolveFindMode,
   resolveMaxMsFlag: () => resolveMaxMsFlag,
@@ -112,14 +111,20 @@ module.exports = __toCommonJS(sdk_exports);
 // 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
@@ -969,7 +974,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 = {}) {
@@ -1585,6 +1593,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) {
@@ -1617,6 +1647,7 @@ async function waitForSootsimIdle({
   stablePolls = 3,
   strict = false,
   paintStill = false,
+  maestro = false,
   motionOnly = false,
   transitionStartWindowMs = 80,
   transitionTimeoutMs = 4e3
@@ -1648,12 +1679,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
@@ -1775,6 +1809,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
@@ -1784,9 +1821,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
@@ -1816,7 +1856,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
@@ -1848,6 +1888,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
@@ -1880,6 +1922,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
@@ -1939,9 +1986,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'
@@ -1960,7 +2013,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
@@ -1974,6 +2027,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
@@ -2001,6 +2055,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) {
@@ -2046,7 +2103,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++
@@ -2067,7 +2124,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 &&
@@ -2095,7 +2160,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
@@ -2107,6 +2172,7 @@ async function waitForSootsimIdle({
             stillPolls = []
             visuallyStillSince = 0
           }
+          lastNativeHierarchy = snapshot.nativeHierarchy
           lastLayout = snapshot.layout
           lastScreenPixels = snapshot.screenPixels
           lastRequestTotal = snapshot.requestTotal
@@ -2129,20 +2195,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.
@@ -2184,8 +2251,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
   });
@@ -2194,6 +2263,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,
@@ -2617,6 +2687,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));
@@ -2685,10 +2769,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);
@@ -3144,7 +3226,6 @@ var SimClient = class {
   layoutGetNativeEval,
   rankInteractive,
   readyProbeHasContent,
-  readyProbeHasTargetContent,
   readyProbeIsReady,
   resolveFindMode,
   resolveMaxMsFlag,