rnxsim 0.1.460 → 0.1.462

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

@@ -2,6 +2,10 @@ import {
   readBrowserCompositeCaptureRequest,
   resolveBrowserCompositeCdpClip,
 } from '../../../sootsim-engine/src/capture/browser-composite'
+import {
+  createBrowserPointerDispatcher,
+  readBrowserPointerRequest,
+} from '../../../sootsim-engine/src/render-worker/browser-pointer'
 // the detached browser host, as CJS source.
 //
 // it resolves playwright from the absolute path the driver hands it, launches
@@ -70,6 +74,8 @@ const { existsSync, mkdtempSync, readdirSync, rmSync, unlinkSync } = require('fs
 const { execSync } = require('child_process');
 const { tmpdir } = require('os');
 const { join } = require('path');
+const readBrowserPointerRequest = ${readBrowserPointerRequest.toString()};
+const createBrowserPointerDispatcher = ${createBrowserPointerDispatcher.toString()};
 const readBrowserCompositeCaptureRequest = ${readBrowserCompositeCaptureRequest.toString()};
 const resolveBrowserCompositeCdpClip = ${resolveBrowserCompositeCdpClip.toString()};
 // chrome tree reaper — playwright's browser.close() and even SIGKILLing the
@@ -428,6 +434,16 @@ const cleanupProfile = () => {
   await context.exposeBinding('__sootsimHostClose', async () => {
     await shutdown(0);
   });
+  const pointerHosts = new WeakMap();
+  await context.exposeBinding('__sootsimHostPointer', async (source, value) => {
+    let pending = pointerHosts.get(source.page);
+    if (!pending) {
+      pending = source.page.context().newCDPSession(source.page).then(session =>
+        createBrowserPointerDispatcher((method, params) => session.send(method, params)));
+      pointerHosts.set(source.page, pending);
+    }
+    await (await pending)(value);
+  });
   await context.exposeBinding('__sootsimHostCapture', async (source, value) => {
     const request = readBrowserCompositeCaptureRequest(value);
     const session = await source.page.context().newCDPSession(source.page);

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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;
@@ -35952,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,
       }
     })()`);
@@ -36024,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,
       }
     })()`);
@@ -36244,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) {
@@ -36255,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()) {
@@ -37040,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.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.462 | (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.460",
+  "version": "0.1.462",
   "description": "Vite and Metro plugins, testing drivers, and SDK exports for rnx.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",