rnxsim 0.1.365 → 0.1.367

package/src/host/bridge-host.ts

@@ -54,6 +54,7 @@ import {
   isReplacementModuleRequestUrl,
 } from './replacement-module-handler.ts'
 import { handleWebSocketProxyUpgrade } from './websocket-proxy.ts'
+import type { WsCommand } from '../bridge-contract.ts'
 
 const SOOTSIM_CROSS_ORIGIN_EMBEDDER_POLICY = 'require-corp'
 
@@ -92,17 +93,7 @@ export interface BridgeLockInfo {
   expiresInMs: number
 }
 
-export interface BridgeSimCommand {
-  id: number
-  type: 'evaluate' | 'screenshot' | 'tap' | 'keyboard' | 'tree' | 'focus' | 'close'
-  code?: string
-  x?: number
-  y?: number
-  action?: string
-  text?: string
-  depth?: number
-  simId?: string
-}
+export type BridgeSimCommand = Omit<WsCommand, 'id'> & { id: number }
 
 interface BridgeSimRegistrationMessage {
   type: 'bridge:register'
@@ -173,7 +164,7 @@ interface BridgeCliLease {
 }
 
 // interactive commands change app state and must respect the lease.
-// observational/lifecycle commands (evaluate/tree/screenshot/focus/call/close)
+// observational/lifecycle commands (evaluate/tree/query/resolve/screenshot/focus/call/close)
 // pass through without taking or checking a lease so cleanup never gets stuck
 // behind a stale cli owner.
 // `call` used to acquire a lease too, but most call paths are queries
@@ -2555,6 +2546,10 @@ export class SootSimBridgeHost {
         return msg?.action === 'type' ? 'typed text' : 'used keyboard'
       case 'tree':
         return 'dumped tree'
+      case 'query':
+        return 'queried semantic tree'
+      case 'resolve':
+        return 'resolved semantic selector'
       case 'focus':
         return 'focused sim'
       case 'close':

package/src/index.ts

@@ -27,6 +27,13 @@ export type {
   ResetResult,
   SimStateOptions,
   SimStateResult,
+  SimSemanticGeometry,
+  SimSemanticNode,
+  SimSemanticQuery,
+  SimSemanticQueryResult,
+  SimSemanticResolveResult,
+  SimSemanticResolveSelector,
+  SimSemanticSelector,
 } from './bridge-contract'
 
 export { rnxPlugin } from './vite-plugin-one'

package/src/sim-client.ts

@@ -47,6 +47,7 @@ import {
   waitForSootsimIdle,
   type WaitForSootsimIdleResult,
 } from '../cli/commands/inspect/settling'
+import { openAppUrl } from './app-url'
 import type { BridgeClaimResult, BridgeSimInfo, WsBridge } from '../cli/ws-bridge'
 import type {
   PerformOptions,
@@ -54,6 +55,9 @@ import type {
   PerformStep,
   ResetOptions,
   ResetResult,
+  SimSemanticNode,
+  SimSemanticResolveResult,
+  SimSemanticResolveSelector,
   SimStateOptions,
   SimStateResult,
 } from './bridge-contract'
@@ -144,6 +148,11 @@ export interface SimScreenshot {
   bytes: Uint8Array
 }
 
+export interface SimScreenshotOptions {
+  layers?: 'full' | 'tenant' | 'shell'
+  crop?: { x: number; y: number; w: number; h: number }
+}
+
 export interface SimClientOptions {
   /** default per-command bridge timeout. */
   commandTimeoutMs?: number
@@ -320,6 +329,11 @@ export class SimClient implements WsBridge, InspectBridge {
     )
   }
 
+  /** dispatch a route or app URL through React Native Linking in this guest. */
+  openUrl(target: string): Promise<string> {
+    return openAppUrl(this, target)
+  }
+
   /**
    * block until the guest app has mounted and painted real content.
    * throws SimReadyTimeoutError (with the last probe status) on timeout.
@@ -375,12 +389,18 @@ export class SimClient implements WsBridge, InspectBridge {
     return result ? [result as InteractiveNode] : []
   }
 
-  async tree(depth = 5): Promise<unknown> {
+  async tree(depth = 5): Promise<SimSemanticNode[]> {
     const { tree } = await inspectTree(this, depth)
-    return tree
+    return Array.isArray(tree) ? tree : []
   }
 
-  /** compact visible-UI dump with shell + keyboard state, as the CLI prints. */
+  resolve(
+    selector: SimSemanticResolveSelector,
+  ): Promise<SimSemanticResolveResult | null> {
+    return this.send({ type: 'resolve', selector })
+  }
+
+  /** compact visible semantic tree, formatted as the CLI prints it. */
   describe(opts: { filter?: string; verbose?: boolean } = {}): Promise<DescribeResult> {
     return inspectDescribe(this, {
       describe: true,
@@ -421,12 +441,7 @@ export class SimClient implements WsBridge, InspectBridge {
     return url
   }
 
-  async screenshot(
-    opts: {
-      layers?: 'full' | 'tenant' | 'shell'
-      crop?: { x: number; y: number; w: number; h: number }
-    } = {},
-  ): Promise<SimScreenshot> {
+  async screenshot(opts: SimScreenshotOptions = {}): Promise<SimScreenshot> {
     const result = await this.send({
       type: 'screenshot',
       ...(opts.layers ? { layers: opts.layers } : {}),

package/dist-cli/chunks/chunk-2JFZ5Z7Q.js

@@ -1,4 +0,0 @@
-/*! rnx v0.1.365 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import { createRequire as __sootsimCreateRequire } from 'node:module'
-var require = __sootsimCreateRequire(import.meta.url)
-var m={"--help":{type:"boolean",short:"-h"},"--version":{type:"boolean",short:"-V"},"--verbose":{type:"boolean",short:"-v"},"--port":{type:"number",short:"-p"},"--device":{type:"string",short:"-d"},"--theme":{type:"string",short:"-t"},"--headless":{type:"boolean"},"--driver":{type:"string"},"--sim":{type:"string"},"--session":{type:"string"},"--tab":{type:"string"}},p=new Set(["list","describe","find","get","do","wait","network","logs","shell"]),b=new Set(["do","get","wait","shell","debug"]),d=new Set(["detox","maestro","record","film","storage","permissions","perf","screenshot","state","reset","camera","mode","debug","timeline","what-happened","shell","assert","device","open","list","use","claim","close","compat","report-issue","desktop","login","logout","auth","setup","serve","daemon","runtime","upgrade","version","skill","config","cleanup","app-fonts","agent-wrapper","agent",...p]);function u(c){let n=c.slice(2),e={command:null,commandArgs:[],globalFlags:{},help:!1,version:!1,verbose:!1},s=0;for(;s<n.length;){let o=n[s];if(o==="--"){e.commandArgs.push(...n.slice(s+1));break}let i=Object.entries(m).find(([a,r])=>a===o||r.short===o);if(i){let[a,r]=i,l=a.replace(/^--/,"");if(r.type==="boolean")e.globalFlags[l]=!0,s++;else{let t=n[s+1];if(t===void 0||t.startsWith("-")){console.error(`  warning: ${o} requires a value`),s++;continue}if(r.type==="number"){let g=Number(t);if(Number.isNaN(g)){console.error(`  warning: ${o} requires a number, got "${t}"`),s+=2;continue}e.globalFlags[l]=g}else e.globalFlags[l]=t;s+=2}continue}if(!e.command&&!o.startsWith("-")){let a=o.indexOf("-");if(a>0){let r=o.slice(0,a),l=o.slice(a+1);if(b.has(r)&&l.length>0){e.command=r;let t=n.slice(s+1);e.commandArgs=[l,...t[0]==="--"?t.slice(1):t];break}}if(d.has(o)){e.command=o;let r=n.slice(s+1);e.commandArgs=r[0]==="--"?r.slice(1):r;break}e.commandArgs=n.slice(s);break}e.commandArgs.push(o),s++}return e.help=!!e.globalFlags.help,e.version=!!e.globalFlags.version,e.verbose=!!e.globalFlags.verbose,e}export{p as a,u as b};

package/dist-cli/chunks/chunk-4WFN4DFR.js

@@ -1,5 +0,0 @@
-/*! rnx v0.1.365 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import { createRequire as __sootsimCreateRequire } from 'node:module'
-var require = __sootsimCreateRequire(import.meta.url)
-import{l as n}from"./chunk-W3UIDI3W.js";var i=[];for(let[t,e]of Object.entries(n))e.cliFlag&&i.push({name:`--${e.cliFlag}`,short:e.cliFlagShort?`-${e.cliFlagShort}`:void 0,key:t,type:e.type==="enum"?"string":e.type,description:e.description,options:e.options,default:e.default});var a=i;function g(){let t=[];for(let e of a){let s=e.short?`${e.short}, ${e.name}`:`    ${e.name}`,o=e.options?` [${e.options.join("|")}]`:"",r=e.default!==void 0?` (default: ${e.default})`:"";t.push(`  ${s.padEnd(24)}${e.description}${o}${r}`)}return t.join(`
-`)}export{g as a};

package/dist-cli/chunks/chunk-52ES4API.js

@@ -1,38 +0,0 @@
-/*! rnx v0.1.365 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import { createRequire as __sootsimCreateRequire } from 'node:module'
-var require = __sootsimCreateRequire(import.meta.url)
-import{I,m as E,n as P,p as y,u as F,w as N}from"./chunk-622E4JET.js";import{r as h,v as B,w as A}from"./chunk-ZGH5U4AJ.js";var k={timeoutMs:1800,settleMs:48,startWindowMs:64};function w(e){return new Promise(t=>setTimeout(t,e))}function z(e){return e.includes("--json")}function K(e){process.stdout.write(`${JSON.stringify(e??null,null,2)}
-`)}function Q(e){process.stderr.write(`${e}
-`)}function b(e,t=Date.now()){let r=new Date(e),n=`${S(r.getHours())}:${S(r.getMinutes())}:${S(r.getSeconds())}`,s=t-e;if(s<0)return n;let o=Math.round(s/1e3);return o<60?`${n} +${o}s`:o<3600?`${n} +${Math.round(o/60)}m`:o<86400?`${n} +${Math.round(o/3600)}h`:`${n} +${Math.round(o/86400)}d`}function S(e){return e<10?`0${e}`:String(e)}async function O(e,t,...r){return B(e,`__sootsimTest.${t}`,...r)}async function j(e,t,...r){return A(e,`SootSim.bridges.mainShell.${t}`,...r)}async function X(e,t={}){try{let r=await O(e,"waitForScreenTransitions",k);if(!t.verbose||!r?.started)return;if(r.timedOut){console.log(`  screen transition still active after ${r.waitedMs}ms; continuing`);return}r.waitedMs>0&&console.log(`  waited ${r.waitedMs}ms for screen transition settle`)}catch{}}async function Z(e,t,r,...n){let s=Date.now()+Math.max(0,r);for(;;)try{return await j(e,t,...n)}catch(o){if(!I(o)||Date.now()>=s)throw o;await w(50)}}async function ee(e,t,r,n={}){let s=n.attempts??30,o=n.intervalMs??500,l=n.minNodeCount??10;for(let i=0;i<s;i++){let u=h(e,{commandTimeoutMs:t,simId:r,simIdSource:n.simIdSource});try{let c=await u.send({type:"evaluate",code:"(async () => (await window.__sootsimTest?.getNodeCount()) || 0)()"});if(typeof c=="number"&&c>l)return{bridge:u,count:c}}catch{}u.close(),await w(o)}return null}async function te(e,t,r,n={}){let s=n.timeoutMs??8e3,o=n.intervalMs??250,l=Date.now()+s;for(;Date.now()<l;){let i=h(e,{commandTimeoutMs:t,simId:r,simIdSource:n.simIdSource});try{return await i.send({type:"evaluate",code:"1"}),i}catch{i.close()}await w(o)}return null}async function ne(e,t={}){let r=t.timeoutMs??1e4,n=t.errorGraceMs??3e3,s=t.pollIntervalMs??200,o=Date.now(),l=o+r,i=-1,u=o,c=null,d=!1,m={ready:!1,source:"timeout",elapsedMs:0,nodes:0,targets:0,liveFrameActive:!1,liveFrameChannels:0,liveFramePublishes:0,flag:void 0,loadingText:"",externalReady:null,externalStatus:"",externalError:"",errors:0};for(;Date.now()<l;){try{let a=await e.send({type:"evaluate",code:E}),g=Date.now()-o,f=Number(a?.nodes)||0,$=Number(a?.targets)||0,C=a?.liveFrameActive===!0,W=Number(a?.liveFrameChannels)||0,q=Number(a?.liveFramePublishes)||0,x=Number(a?.errors)||0,T=a?.flag===!0,p=a?.externalReady,M=typeof a?.loadingText=="string"?a.loadingText.trim():"",D=typeof a?.externalStatus=="string"?a.externalStatus.trim():"",R=typeof a?.externalError=="string"?a.externalError.trim():"",v=typeof a?.externalError=="string"&&R.length>0;if(c=p,d=v,f!==i&&(i=f,u=g),m={ready:!1,source:"timeout",elapsedMs:g,nodes:f,targets:$,liveFrameActive:C,liveFrameChannels:W,liveFramePublishes:q,flag:a?.flag,loadingText:M,externalReady:typeof p=="boolean"?p:null,externalStatus:D,externalError:R,errors:x},T&&p!==!1&&!v&&!M&&y({liveFrameActive:C,nodes:f,targets:$})&&g-u>=P)return{...m,ready:!0,source:"flag"};if(g>=n&&x>0&&!T)return{...m,ready:!1,source:"error-bail"}}catch{}await w(s)}return c!==!1&&!d&&!m.loadingText&&y(m)?{...m,ready:!0,source:"nodes-fallback"}:{...m,ready:!1,source:"timeout",elapsedMs:Date.now()-o}}function H(e){let t=e.displayUrl||e.url;return e.status!=null?`${e.method} ${t} -> ${e.status}${e.statusText?` ${e.statusText}`:""}`:e.error?`${e.method} ${t} -> ${e.error}`:`${e.method} ${t}`}async function _(e,t,...r){return e.send({type:"call",path:`__sootsimTest.${t}`,args:r})}async function L(e,t={}){let r=await e.send({type:"evaluate",code:N});if(!r||typeof r!="object")return;let n=Math.max(0,Number(r.errors)||0),s=Math.max(0,Number(r.warnings)||0);if(n===0&&s===0)return;let o=[];if(n>0&&o.push(`${n} console error${n===1?"":"s"}`),s>0&&o.push(`${s} console warning${s===1?"":"s"}`),console.log(`
-  console: ${o.join(", ")}`),t.errorsCommand&&console.log(`  inspect: ${t.errorsCommand}`),s>0&&t.warningsCommand&&console.log(`  inspect: ${t.warningsCommand}`),!t.includeTail||n===0)return;let l=await F(e,5);if(!(!Array.isArray(l)||l.length===0)){console.log(`
-  recent console errors:
-`);for(let i of l){let u=b(i.timestamp),c=Array.isArray(i.args)?i.args.map(d=>typeof d=="object"?JSON.stringify(d):String(d)).join(" "):String(i);console.log(`  [${u}] ${c}`)}}}async function G(e,t={}){let r=await _(e,"getRequestCounts");if(!r||typeof r!="object")return;let n=Math.max(0,Number(r.failed)||0);if(n===0||(console.log(`
-  network: ${n} failed request${n===1?"":"s"}`),t.requestsCommand&&console.log(`  inspect: ${t.requestsCommand}`),!t.includeTail))return;let s=await _(e,"getFailedRequests",5);if(!(!Array.isArray(s)||s.length===0)){console.log(`
-  recent failed requests:
-`);for(let o of s){let l=b(o.timestamp);console.log(`  [${l}] ${H(o)}`),o.responseBody?console.log(`    ${o.responseBody}`):o.error&&console.log(`    ${o.error}`)}}}async function J(e){let t=await e.send({type:"evaluate",code:`(async () => {
-      const test = window.__sootsimTest
-      const mainShell = window.SootSim?.bridges?.mainShell
-      let shell = null
-      try {
-        shell = typeof mainShell?.getState === 'function' ? await mainShell.getState() : null
-      } catch {}
-      let nodeCount = 0
-      try {
-        nodeCount = typeof test?.getNodeCount === 'function' ? await test.getNodeCount() : 0
-      } catch {}
-      return {
-        url: window.location.href,
-        simId: window.__sootsimSimId || null,
-        nodeCount,
-        mode: window.__sootsimRenderHost ? 'render-worker' : 'main-thread',
-        shell: shell
-          ? {
-              state: shell.state || null,
-              activeApp: shell.activeApp || null,
-              showSwitcher: !!shell.showSwitcher,
-              switcherPhase: shell.switcherPhase || null,
-            }
-          : null,
-      }
-    })()`});if(!t||typeof t!="object")return;console.log(`
-  state:`),t.simId&&console.log(`    sim: ${t.simId}`),t.url&&console.log(`    url: ${t.url}`),t.mode&&console.log(`    mode: ${t.mode}`);let r=Number(t.nodeCount)||0;console.log(`    nodes: ${r}${r>10?" (ready)":" (not ready)"}`);let n=t.shell;if(n&&typeof n=="object"){let s=[n.state?`state=${n.state}`:null,n.activeApp?`app=${n.activeApp}`:null,n.showSwitcher?"switcher=open":null,n.switcherPhase?`phase=${n.switcherPhase}`:null].filter(Boolean);s.length>0&&console.log(`    shell: ${s.join(" ")}`)}}async function ae(e,t={}){try{await J(e)}catch{}try{await L(e,{includeTail:!0,errorsCommand:t.errorsCommand,warningsCommand:t.warningsCommand})}catch{}try{await G(e,{includeTail:!0,requestsCommand:t.requestsCommand})}catch{}}export{w as a,z as b,K as c,Q as d,b as e,O as f,X as g,Z as h,ee as i,te as j,ne as k,J as l,ae as m};