rnxsim 0.1.459 → 0.1.461

package/cli/bridge-flow-runner.ts

@@ -784,6 +784,11 @@ export class SootSimBridgeFlowRunner {
         text: node.text || null,
         absolutePosition: node.absolutePosition,
         layout: node.layout,
+        // the engine's authoritative answer to "is this painted": layout
+        // bounds minus clipping and minus every frontward sibling, overlay
+        // and portal that fully covers it. visibility assertions read this,
+        // never the raw layout box.
+        visibleFrame: node.visibleFrame || null,
         isTextInput: !!node.isTextInput,
       }
     })()`)
@@ -861,6 +866,8 @@ export class SootSimBridgeFlowRunner {
         text: node.text || null,
         absolutePosition: node.absolutePosition,
         layout: node.layout,
+        // authoritative visibility, as in findElement above.
+        visibleFrame: node.visibleFrame || null,
         isTextInput: !!node.isTextInput,
       }
     })()`)
@@ -1170,13 +1177,15 @@ export class SootSimBridgeFlowRunner {
       }
       await sleep(200)
     }
-    // when assertVisible misses, fall back to a "found but off-screen" hint
-    // so a vertically-scrolled or modal-occluded element doesn't look the
-    // same as a missing element. assertVisible failures in demo flows
-    // burned time debugging which case it was; the diff is one bridge call.
+    // report the geometry rather than a guess at the cause. a zero visibleFrame
+    // says the node paints nothing; it cannot on its own separate scrolled-away
+    // from painted-over, so print the frame and let the reader judge. a missing
+    // node stays clearly distinct from a found one. the diff is one bridge call.
     const found = await this.findElement(opts)
+    const frame = found?.visibleFrame
     const detail = found
-      ? ` (matched node at y=${Math.round(found.absolutePosition.y)} h=${Math.round(found.layout.height)} — off-screen)`
+      ? ` (matched node at y=${Math.round(found.absolutePosition.y)} h=${Math.round(found.layout.height)}, ` +
+        `visibleFrame ${JSON.stringify(frame ?? null)})`
       : ' (no matching node in tree)'
     throw new Error(`assertVisible: ${JSON.stringify(opts)} not visible${detail}`)
   }
@@ -1192,13 +1201,32 @@ export class SootSimBridgeFlowRunner {
     }
   }
 
+  // visibility is the engine's call, not a layout-bounds guess. the old test
+  // here was a vertical band (`y + height > 0 && y < SCREEN_H`), so a node
+  // sealed under an opaque overlay, pushed off the left or right edge, or
+  // clipped to nothing by an ancestor all read as visible — a demo flow could
+  // assert a button that no finger could reach. visibleFrame already carries
+  // the clipped, occlusion-subtracted rect, and tap-target refuses a covered
+  // node on the same basis, so assertions and taps now agree.
   private async isElementVisible(opts: { id?: string; text?: string }) {
     const element = await this.findElement(opts)
-    return !!(
-      element &&
-      element.absolutePosition.y + element.layout.height > 0 &&
-      element.absolutePosition.y < SCREEN_H
-    )
+    if (!element) return false
+    const frame = element.visibleFrame
+    const usable =
+      !!frame &&
+      Number.isFinite(frame.width) &&
+      Number.isFinite(frame.height) &&
+      Number.isFinite(frame.area)
+    if (!usable) {
+      // absent or non-numeric geometry is unknown visibility, never "hidden".
+      // returning false here would quietly hand assertNotVisible a pass it did
+      // not earn, which is the same shape of false green this change removes.
+      throw new Error(
+        `authoritative visibility unavailable for ${JSON.stringify(opts)}: the engine ` +
+          `returned visibleFrame ${JSON.stringify(frame ?? null)}`,
+      )
+    }
+    return frame.width > 0 && frame.height > 0 && frame.area > 0
   }
 
   async inputText(text: string) {
@@ -2189,18 +2217,19 @@ export class SootSimBridgeFlowRunner {
   }
 
   // evaluate a `when:` predicate. returns true if the step should run.
+  // `visible:` and `notVisible:` answer the same question assertVisible does,
+  // so they read the engine's visibleFrame too. resolving them by mere presence
+  // in the tree let a guarded step fire on a node painted over by an overlay.
   private async evaluateWhen(when: NonNullable<MaestroStep['when']>): Promise<boolean> {
     if (when.visible !== undefined) {
       const opts =
         typeof when.visible === 'string' ? { text: when.visible } : when.visible
-      const el = await this.findElement(opts)
-      return !!el
+      return this.isElementVisible(opts)
     }
     if (when.notVisible !== undefined) {
       const opts =
         typeof when.notVisible === 'string' ? { text: when.notVisible } : when.notVisible
-      const el = await this.findElement(opts)
-      return !el
+      return !(await this.isElementVisible(opts))
     }
     if (when.platform !== undefined) {
       // rnx emulates iOS — match against the context's platform the way

package/cli/drivers/playwright-sim-host.ts

@@ -1,3 +1,7 @@
+import {
+  readBrowserCompositeCaptureRequest,
+  resolveBrowserCompositeCdpClip,
+} from '../../../sootsim-engine/src/capture/browser-composite'
 // the detached browser host, as CJS source.
 //
 // it resolves playwright from the absolute path the driver hands it, launches
@@ -66,6 +70,8 @@ const { existsSync, mkdtempSync, readdirSync, rmSync, unlinkSync } = require('fs
 const { execSync } = require('child_process');
 const { tmpdir } = require('os');
 const { join } = require('path');
+const readBrowserCompositeCaptureRequest = ${readBrowserCompositeCaptureRequest.toString()};
+const resolveBrowserCompositeCdpClip = ${resolveBrowserCompositeCdpClip.toString()};
 // chrome tree reaper — playwright's browser.close() and even SIGKILLing the
 // root chrome process do NOT reliably take down the helper tree (gpu, renderer,
 // network/storage utilities). they reparent to launchd/init and survive, each
@@ -422,6 +428,24 @@ const cleanupProfile = () => {
   await context.exposeBinding('__sootsimHostClose', async () => {
     await shutdown(0);
   });
+  await context.exposeBinding('__sootsimHostCapture', async (source, value) => {
+    const request = readBrowserCompositeCaptureRequest(value);
+    const session = await source.page.context().newCDPSession(source.page);
+    try {
+      const result = await session.send('Page.captureScreenshot', {
+        format: 'png',
+        fromSurface: true,
+        captureBeyondViewport: true,
+        clip: resolveBrowserCompositeCdpClip(
+          request,
+          await session.send('Page.getLayoutMetrics'),
+        ),
+      });
+      return 'data:image/png;base64,' + result.data;
+    } finally {
+      await session.detach();
+    }
+  });
   const connectTimeoutMs = Number(process.env.SOOTSIM_PW_CONNECT_TIMEOUT_MS || 120000);
   if (connectAckFile) {
     connectAckPoll = setInterval(() => {

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var SIM_LONG_PRESS_DEFAULT_MS = 500;

package/dist-lib/capture-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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;
@@ -8732,7 +8732,7 @@ var SootSimBridgeHost = class _SootSimBridgeHost {
   inflightScan = null;
   static SCAN_FRESH_MS = 2e3;
   constructor(opts = {}) {
-    this.preferredPort = opts.port || DEFAULT_SOOTSIM_BRIDGE_PORT;
+    this.preferredPort = opts.port ?? DEFAULT_SOOTSIM_BRIDGE_PORT;
     this.port = this.preferredPort;
     this.shouldWriteLockfile = opts.writeLockfile === true;
     this.shouldWriteDevLockfile = opts.writeDevLockfile === true;
@@ -8782,9 +8782,9 @@ var SootSimBridgeHost = class _SootSimBridgeHost {
     for (let attempt = 0; attempt < this.portFallbackCount; attempt++) {
       const candidate = this.preferredPort + attempt;
       try {
-        await this.bindOnce(candidate, options?.silent === true);
-        this.effectivePort = candidate;
-        this.port = candidate;
+        const boundPort = await this.bindOnce(candidate, options?.silent === true);
+        this.effectivePort = boundPort;
+        this.port = boundPort;
         this.startedAt = Date.now();
         if (attempt > 0 && !options?.silent) {
           process.stderr.write(
@@ -8793,7 +8793,7 @@ var SootSimBridgeHost = class _SootSimBridgeHost {
           );
         }
         this.afterBind();
-        return candidate;
+        return boundPort;
       } catch (err) {
         const e = err;
         if (e?.code !== "EADDRINUSE") {
@@ -8829,6 +8829,11 @@ var SootSimBridgeHost = class _SootSimBridgeHost {
       server.once("error", onError);
       server.listen(port, "127.0.0.1", () => {
         if (settled) return;
+        const address = server.address();
+        if (!address || typeof address === "string") {
+          onError(new Error("ws bridge has no bound TCP address"));
+          return;
+        }
         settled = true;
         server.removeListener("error", onError);
         server.on("error", (err) => {
@@ -8844,7 +8849,7 @@ var SootSimBridgeHost = class _SootSimBridgeHost {
             this.wss?.emit("connection", ws, req);
           });
         });
-        resolve5();
+        resolve5(address.port);
       });
     });
   }

package/dist-lib/host/fetch-proxy-handler.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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;
@@ -4005,7 +4005,7 @@ var init_supported_native_packages = __esm({
       "@react-native-documents/viewer",
       // seam
       "@react-native-firebase/analytics",
-      // seam+coverage
+      // coverage
       "@react-native-firebase/app",
       // seam+coverage
       "@react-native-firebase/auth",
@@ -4023,7 +4023,7 @@ var init_supported_native_packages = __esm({
       "@react-native-masked-view/masked-view",
       // preset+coverage
       "@react-native-menu/menu",
-      // seam+coverage
+      // coverage
       "@react-native-ml-kit/barcode-scanning",
       // seam
       "@react-native-picker/picker",
@@ -4059,7 +4059,7 @@ var init_supported_native_packages = __esm({
       "@shopify/flash-list",
       // coverage
       "@shopify/react-native-performance",
-      // seam+coverage
+      // coverage
       "@shopify/react-native-skia",
       // preset+coverage
       "@simform_solutions/react-native-audio-waveform",
@@ -4214,8 +4214,6 @@ var init_supported_native_packages = __esm({
       // visual-proof+coverage
       "expo-sensors",
       // visual-proof
-      "expo-share-extension",
-      // seam
       "expo-sharing",
       // visual-proof
       "expo-sms",
@@ -4228,8 +4226,6 @@ var init_supported_native_packages = __esm({
       // visual-proof+coverage
       "expo-sqlite",
       // preset+coverage
-      "expo-squircle-view",
-      // seam
       "expo-store-review",
       // visual-proof+coverage
       "expo-symbols",
@@ -4241,7 +4237,7 @@ var init_supported_native_packages = __esm({
       "expo-testflight",
       // seam+coverage
       "expo-tracking-transparency",
-      // visual-proof+seam+coverage
+      // visual-proof+coverage
       "expo-updates",
       // preset+seam+coverage
       "expo-video",
@@ -4396,8 +4392,6 @@ var init_supported_native_packages = __esm({
       // coverage
       "react-native-fast-secure-storage",
       // seam+coverage
-      "react-native-fast-squircle",
-      // seam
       "react-native-fast-trie",
       // seam+coverage
       "react-native-fbsdk-next",
@@ -27738,7 +27732,7 @@ var init_bridge_host = __esm({
       inflightScan = null;
       static SCAN_FRESH_MS = 2e3;
       constructor(opts = {}) {
-        this.preferredPort = opts.port || DEFAULT_SOOTSIM_BRIDGE_PORT;
+        this.preferredPort = opts.port ?? DEFAULT_SOOTSIM_BRIDGE_PORT;
         this.port = this.preferredPort;
         this.shouldWriteLockfile = opts.writeLockfile === true;
         this.shouldWriteDevLockfile = opts.writeDevLockfile === true;
@@ -27788,9 +27782,9 @@ var init_bridge_host = __esm({
         for (let attempt = 0; attempt < this.portFallbackCount; attempt++) {
           const candidate = this.preferredPort + attempt;
           try {
-            await this.bindOnce(candidate, options?.silent === true);
-            this.effectivePort = candidate;
-            this.port = candidate;
+            const boundPort = await this.bindOnce(candidate, options?.silent === true);
+            this.effectivePort = boundPort;
+            this.port = boundPort;
             this.startedAt = Date.now();
             if (attempt > 0 && !options?.silent) {
               process.stderr.write(
@@ -27799,7 +27793,7 @@ var init_bridge_host = __esm({
               );
             }
             this.afterBind();
-            return candidate;
+            return boundPort;
           } catch (err) {
             const e = err;
             if (e?.code !== "EADDRINUSE") {
@@ -27835,6 +27829,11 @@ var init_bridge_host = __esm({
           server.once("error", onError);
           server.listen(port, "127.0.0.1", () => {
             if (settled) return;
+            const address = server.address();
+            if (!address || typeof address === "string") {
+              onError(new Error("ws bridge has no bound TCP address"));
+              return;
+            }
             settled = true;
             server.removeListener("error", onError);
             server.on("error", (err) => {
@@ -27850,7 +27849,7 @@ var init_bridge_host = __esm({
                 this.wss?.emit("connection", ws, req);
               });
             });
-            resolve9();
+            resolve9(address.port);
           });
         });
       }
@@ -35953,6 +35952,11 @@ var init_bridge_flow_runner = __esm({
         text: node.text || null,
         absolutePosition: node.absolutePosition,
         layout: node.layout,
+        // the engine's authoritative answer to "is this painted": layout
+        // bounds minus clipping and minus every frontward sibling, overlay
+        // and portal that fully covers it. visibility assertions read this,
+        // never the raw layout box.
+        visibleFrame: node.visibleFrame || null,
         isTextInput: !!node.isTextInput,
       }
     })()`);
@@ -36025,6 +36029,8 @@ var init_bridge_flow_runner = __esm({
         text: node.text || null,
         absolutePosition: node.absolutePosition,
         layout: node.layout,
+        // authoritative visibility, as in findElement above.
+        visibleFrame: node.visibleFrame || null,
         isTextInput: !!node.isTextInput,
       }
     })()`);
@@ -36245,7 +36251,8 @@ var init_bridge_flow_runner = __esm({
           await sleep3(200);
         }
         const found = await this.findElement(opts);
-        const detail = found ? ` (matched node at y=${Math.round(found.absolutePosition.y)} h=${Math.round(found.layout.height)} \u2014 off-screen)` : " (no matching node in tree)";
+        const frame = found?.visibleFrame;
+        const detail = found ? ` (matched node at y=${Math.round(found.absolutePosition.y)} h=${Math.round(found.layout.height)}, visibleFrame ${JSON.stringify(frame ?? null)})` : " (no matching node in tree)";
         throw new Error(`assertVisible: ${JSON.stringify(opts)} not visible${detail}`);
       }
       async assertNotVisible(target) {
@@ -36256,9 +36263,24 @@ var init_bridge_flow_runner = __esm({
           throw new Error(`assertNotVisible: ${JSON.stringify(opts)} IS visible${where}`);
         }
       }
+      // visibility is the engine's call, not a layout-bounds guess. the old test
+      // here was a vertical band (`y + height > 0 && y < SCREEN_H`), so a node
+      // sealed under an opaque overlay, pushed off the left or right edge, or
+      // clipped to nothing by an ancestor all read as visible — a demo flow could
+      // assert a button that no finger could reach. visibleFrame already carries
+      // the clipped, occlusion-subtracted rect, and tap-target refuses a covered
+      // node on the same basis, so assertions and taps now agree.
       async isElementVisible(opts) {
         const element = await this.findElement(opts);
-        return !!(element && element.absolutePosition.y + element.layout.height > 0 && element.absolutePosition.y < SCREEN_H);
+        if (!element) return false;
+        const frame = element.visibleFrame;
+        const usable = !!frame && Number.isFinite(frame.width) && Number.isFinite(frame.height) && Number.isFinite(frame.area);
+        if (!usable) {
+          throw new Error(
+            `authoritative visibility unavailable for ${JSON.stringify(opts)}: the engine returned visibleFrame ${JSON.stringify(frame ?? null)}`
+          );
+        }
+        return frame.width > 0 && frame.height > 0 && frame.area > 0;
       }
       async inputText(text) {
         if (!await this.waitForFocusedTextInput()) {
@@ -37041,16 +37063,17 @@ var init_bridge_flow_runner = __esm({
         this.firstLaunchDone = true;
       }
       // evaluate a `when:` predicate. returns true if the step should run.
+      // `visible:` and `notVisible:` answer the same question assertVisible does,
+      // so they read the engine's visibleFrame too. resolving them by mere presence
+      // in the tree let a guarded step fire on a node painted over by an overlay.
       async evaluateWhen(when) {
         if (when.visible !== void 0) {
           const opts = typeof when.visible === "string" ? { text: when.visible } : when.visible;
-          const el = await this.findElement(opts);
-          return !!el;
+          return this.isElementVisible(opts);
         }
         if (when.notVisible !== void 0) {
           const opts = typeof when.notVisible === "string" ? { text: when.notVisible } : when.notVisible;
-          const el = await this.findElement(opts);
-          return !el;
+          return !await this.isElementVisible(opts);
         }
         if (when.platform !== void 0) {
           return when.platform.toLowerCase() === this.js.maestro.platform.toLowerCase();

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.459 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.461 | (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/package.json

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

package/src/host/bridge-host.ts

@@ -223,6 +223,7 @@ interface BridgeForwardedCommand {
 }
 
 export interface BridgeHostOptions {
+  /** use 0 for an OS-assigned port; startAsync returns the bound address. */
   port?: number
   openUrl?: (url: string, options?: OpenUrlOptions) => Promise<void> | void
   /** Contrast-specific excludes for the agent host's dev-server scan. passed
@@ -466,7 +467,7 @@ export class SootSimBridgeHost {
   private static SCAN_FRESH_MS = 2000
 
   constructor(opts: BridgeHostOptions = {}) {
-    this.preferredPort = opts.port || DEFAULT_SOOTSIM_BRIDGE_PORT
+    this.preferredPort = opts.port ?? DEFAULT_SOOTSIM_BRIDGE_PORT
     this.port = this.preferredPort
     // default off — callers that want the lockfile (rnx serve) opt in.
     this.shouldWriteLockfile = opts.writeLockfile === true
@@ -537,9 +538,9 @@ export class SootSimBridgeHost {
     for (let attempt = 0; attempt < this.portFallbackCount; attempt++) {
       const candidate = this.preferredPort + attempt
       try {
-        await this.bindOnce(candidate, options?.silent === true)
-        this.effectivePort = candidate
-        this.port = candidate
+        const boundPort = await this.bindOnce(candidate, options?.silent === true)
+        this.effectivePort = boundPort
+        this.port = boundPort
         this.startedAt = Date.now()
         if (attempt > 0 && !options?.silent) {
           process.stderr.write(
@@ -547,7 +548,7 @@ export class SootSimBridgeHost {
           )
         }
         this.afterBind()
-        return candidate
+        return boundPort
       } catch (err: unknown) {
         const e = err as NodeJS.ErrnoException
         if (e?.code !== 'EADDRINUSE') {
@@ -566,8 +567,8 @@ export class SootSimBridgeHost {
     )
   }
 
-  private bindOnce(port: number, _silent: boolean): Promise<void> {
-    return new Promise<void>((resolve, reject) => {
+  private bindOnce(port: number, _silent: boolean): Promise<number> {
+    return new Promise<number>((resolve, reject) => {
       const server = createServer((req, res) => this.handleHttpRequest(req, res))
       let settled = false
 
@@ -589,6 +590,11 @@ export class SootSimBridgeHost {
       // 127.0.0.1 explicitly to avoid the localhost-vs-::1 DNS coinflip.
       server.listen(port, '127.0.0.1', () => {
         if (settled) return
+        const address = server.address()
+        if (!address || typeof address === 'string') {
+          onError(new Error('ws bridge has no bound TCP address'))
+          return
+        }
         settled = true
         server.removeListener('error', onError)
         server.on('error', (err) => {
@@ -603,7 +609,7 @@ export class SootSimBridgeHost {
             this.wss?.emit('connection', ws, req)
           })
         })
-        resolve()
+        resolve(address.port)
       })
     })
   }