sootsim 0.0.4 → 0.1.37

package/dist-cli/chunks/inspect-DRFAUJUH.js

@@ -1,1030 +0,0 @@
-/*! sootsim v0.0.4 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as U}from"./chunk-VGXARPIH.js";import{a as Ne,b as _e}from"./chunk-AFQBSK2J.js";import{a as Y,b as E,c as C,d as z,e as ie,f as V,g as te,h as Ie,i as Fe,j as fe}from"./chunk-UQ3N6FZF.js";import{a as Te,e as ae}from"./chunk-I6XGFZPA.js";import{a as me,c as pe,d as xe}from"./chunk-4VXB2DBA.js";import{b as Ae,h as Pe}from"./chunk-47S5DXXX.js";import"./chunk-OAHMYSMD.js";import{a as Me}from"./chunk-5TTQKPGH.js";import"./chunk-WVBPATRA.js";import{a as we}from"./chunk-HGFIS26A.js";import{c as $e,e as Se,f as ke,h as ve}from"./chunk-C3QLIYCS.js";import"./chunk-W7CYWXRZ.js";import"./chunk-MZPAJ5PQ.js";import"./chunk-WRF43M33.js";import"./chunk-ZF5FCFLD.js";import"./chunk-SY74J6F4.js";import"./chunk-WWDJCKMI.js";import{existsSync as mt,mkdirSync as pt,readFileSync as ft,rmSync as Oe,writeFileSync as gt}from"fs";import{tmpdir as yt}from"os";import{dirname as bt,join as ht,resolve as wt}from"path";var oe=1,xt="SOOTSIM_INSPECT_NOTICE_PATH",$t=300*1e3,St=15e3;function Ee(){return wt(process.env[xt]||ht(yt(),"sootsim-inspect-notice-state.json"))}function kt(o,c){return Object.fromEntries(Object.entries(o).filter(([,i])=>typeof i?.signature=="string"&&Number.isFinite(i?.updatedAt)&&c-i.updatedAt<=$t))}function vt(o){let c=Ee();if(!mt(c))return{version:oe,entries:{}};try{let i=JSON.parse(ft(c,"utf8"));return i.version!==oe||!i.entries||typeof i.entries!="object"?(Oe(c,{force:!0}),{version:oe,entries:{}}):{version:oe,entries:kt(i.entries,o)}}catch{return Oe(c,{force:!0}),{version:oe,entries:{}}}}function Tt(o){let c=Ee();pt(bt(c),{recursive:!0}),gt(c,JSON.stringify(o,null,2)+`
-`)}function Mt(o,c){let i=c.trim()||"default";return`${o}:${i}`}function ge(o,c,i,d={}){let u=d.nowMs??Date.now(),a=d.cooldownMs??St,b=vt(u),k=Mt(o,c),$=b.entries[k];return $&&$.signature===i&&u-$.updatedAt<a?!1:(b.entries[k]={signature:i,updatedAt:u},Tt(b),!0)}async function Re(o,c={args:[]}){let i=await o.send({type:"evaluate",code:"(async () => await window.__sootsimTest.getNodeCount())()"}),d=typeof i=="number"?i:0;if(E(c.args)){C({nodes:d});return}console.log(`  nodes: ${d}`)}function ye(o,c){let i=o.indexOf(c);return i>=0&&i+1<o.length?o[i+1]:null}async function Ce(o){let{bridge:c,args:i,positional:d}=o,u=i.includes("--verbose")||i.includes("-v"),a=E(i),b=u&&!a,k=i.includes("--watch")||i.includes("-w"),$=1e3,I=i.includes("--compact"),y=i.includes("--no-xy"),S=ye(i,"--testid-like"),A=ye(i,"--only"),v=ye(i,"--subtree"),j=d[1],l=j?/[*?]/.test(j):!1,R=!l&&!A?j:void 0,D=A??(l?j:void 0),q=async()=>{await ie(c,{verbose:b});let Z=`(async () => {
-      const t = window.__sootsimTest
-      const mainShell = window.SootSim?.bridges?.mainShell
-      const kb = window.__sootsimKeyboard
-      if (!t) return { error: 'no test bridge' }
-
-      let shell = null
-      try {
-        shell = typeof mainShell?.getState === 'function' ? await mainShell.getState() : null
-      } catch {}
-
-      const tree = await t.dumpTree(12, ${JSON.stringify({describe:!0,verbose:u,filter:R||"",testIdLike:S||void 0,onlyGlob:D||void 0,subtreeRoot:v||void 0,compact:I,hideXy:y})})
-      const nodeCount = (await t.getNodeCount?.()) || 0
-      const keyboard = kb && typeof kb.getLayout === 'function' ? kb.getLayout() : null
-      return { tree, shell, nodeCount, keyboard }
-    })()`,x=await c.send({type:"evaluate",code:Z}),J=x?.tree,H=x?.shell,K=x?.keyboard;if(a){C({shell:H,tree:J??"",keyboard:K});return}if(H&&typeof H=="object"){let e=[H.state?`state=${H.state}`:null,H.activeApp?`app=${H.activeApp}`:null,H.showSwitcher?"switcher":null,H.switcherPhase&&H.switcherPhase!=="idle"?`phase=${H.switcherPhase}`:null].filter(Boolean);e.length>0&&console.log(`  shell: ${e.join(" ")}`)}if(typeof J=="string"&&J.startsWith("__SUBTREE_NOT_FOUND__:")){let e=J.slice(22);console.log(`  subtree root not found: ${e}`),U("subtree-root-not-found",e);return}if(!J){let e=x?.nodeCount??0;console.log("  no matching nodes found"),!(R||S||D||v)&&e<10&&U("app-still-loading",e);return}if(console.log(J),!(R||S||D||v)&&!k&&J.split(`
-`).length>=80&&U("describe-use-filters"),K&&K.visible){let e=K.spec,t=[e?.keyboardType?`type=${e.keyboardType}`:null,e?.returnKeyType&&e.returnKeyType!=="default"?`return=${e.returnKeyType}`:null,K.mode!=="letters"?`mode=${K.mode}`:null,K.shifted?"shift":null,K.capsLock?"caps":null,e?.autoCapitalize&&e.autoCapitalize!=="sentences"?`autoCap=${e.autoCapitalize}`:null,K.accessoryBarId?`accessory=${K.accessoryBarId}`:null].filter(Boolean);console.log(`
-  keyboard: ${t.join(" ")||"visible"}`)}};if(k)for(console.log(`  watching... (Ctrl+C to stop)
-`);;)console.clear(),await q(),await Y($);else await q()}var Nt=["SOOTSIM_AGENT","CLAUDECODE","CLAUDE_CODE_ENTRYPOINT","CLAUDE_CODE_SESSION_ID","CODEX_THREAD_ID","CURSOR_TRACE_ID","AIDER_MODEL"];function De(){if(process.env.SOOTSIM_AGENT==="0")return!1;for(let o of Nt){let c=process.env[o];if(c&&c.trim()&&c!=="0")return!0}return!1}async function Le(o){let{bridge:c,args:i,effectiveArgs:d,positional:u,inspectUsage:a}=o,b=x=>{let J=d.indexOf(x);return J>=0&&J+1<d.length?d[J+1]:null},k=x=>d.includes(x),$=b("--testid")||b("--test-id"),I=b("--role"),y=b("--type"),S=b("--text"),A=k("--pressable"),v=k("--visible"),j=!$&&!I&&!y&&!S&&!A&&!v?u[1]:null,l=S??j,R,D;$?(D="testid",R=`(async () => {
-      const t = window.__sootsimTest
-      return (await t.findByTestId(${JSON.stringify($)})) || (await t.findById(${JSON.stringify($)}))
-    })()`):I?(D="role",R=`(async () => await window.__sootsimTest.queryAll({ hasRole: ${JSON.stringify(I)}, pruneHidden: true }))()`):y?(D="type",R=`(async () => await window.__sootsimTest.queryAll({ type: ${JSON.stringify(y)}, pruneHidden: true }))()`):A?(D="pressable",R=`(async () => {
-      const t = window.__sootsimTest
-      const all = await t.queryAll({ pruneHidden: true })
-      return all.filter(n => n.pressable)
-    })()`):v?(D="visible",R=`(async () => {
-      const all = await window.__sootsimTest.queryAll({ pruneHidden: true })
-      return all.filter(n => n.layout && n.layout.width > 0 && n.layout.height > 0)
-    })()`):l?(D="text",R=`(async () => await window.__sootsimTest.findByText(${JSON.stringify(l)}))()`):(console.error(a("find","<text> | --text <t> | --testid <id> | --role <r> | --type <t> | --pressable | --visible")),process.exit(1));let q=await c.send({type:"evaluate",code:R}),ne=E(i),Z=i.includes("--verbose")||i.includes("--dump");if(ne)C(q??null);else if(Array.isArray(q))if(q.length===0){console.log(`  no ${D} nodes found`);let x=await c.send({type:"evaluate",code:"(async () => (await window.__sootsimTest?.getNodeCount?.()) || 0)()"});typeof x=="number"&&x<10&&U("app-still-loading",x)}else{console.log(`  found ${q.length} node${q.length===1?"":"s"} (${D}):`);for(let x of q.slice(0,20)){let J=x.absolutePosition?`@(${Math.round(x.absolutePosition.x)},${Math.round(x.absolutePosition.y)})`:"",H=x.layout?`${Math.round(x.layout.width)}x${Math.round(x.layout.height)}`:"?x?",K=x.text?` "${x.text.slice(0,30)}"`:"",Q=x.testID?` #${x.testID}`:"",e=x.pressable?" (tap)":"",t=x.accessibilityRole?`[${x.accessibilityRole}]`:x.type;console.log(`    ${t}${K}${Q} ${H} ${J}${e}`),Z&&console.log(Be(JSON.stringify(x,null,2),"      "))}q.length>20&&console.log(`    ... and ${q.length-20} more`)}else if(q==null)console.log(`  not found: ${l||$||I||y||""||D}`),$&&U("wait-selector-for-missing-testid",$);else{let x=q;if(x.type&&x.absolutePosition){let J=`@(${Math.round(x.absolutePosition.x)},${Math.round(x.absolutePosition.y)})`,H=x.layout?`${Math.round(x.layout.width)}x${Math.round(x.layout.height)}`:"?x?",K=x.text?` "${x.text.slice(0,40)}"`:"",Q=x.testID?` #${x.testID}`:"",e=x.pressable?" (tap)":"",t=x.accessibilityRole?`[${x.accessibilityRole}]`:x.type;console.log(`  ${t}${K}${Q} ${H} ${J}${e}`),Z&&console.log(Be(JSON.stringify(x,null,2),"    "))}else console.log(JSON.stringify(q,null,2))}}function Be(o,c){return o.split(`
-`).map(i=>c+i).join(`
-`)}async function je(o,c={}){let i=await o.send({type:"evaluate",code:`(() => {
-      const kb = window.__sootsimKeyboard
-      if (!kb || typeof kb.getLayout !== 'function') {
-        return { error: 'keyboard bridge getLayout() not available' }
-      }
-      return kb.getLayout()
-    })()`});if("error"in i&&(console.error(i.error),process.exit(1)),c.json){console.log(JSON.stringify(i,null,2));return}let{visible:d,spec:u,mode:a,shifted:b,capsLock:k,accessoryBarId:$}=i,I=[];I.push(`keyboard: ${d?"visible":"hidden"}`),u?(I.push(`  type:          ${u.keyboardType}`),I.push(`  returnKey:     ${u.returnKeyType}`),I.push(`  autoCap:       ${u.autoCapitalize}`),I.push(`  autoCorrect:   ${u.autoCorrect?"on":"off"}`),I.push(`  appearance:    ${u.keyboardAppearance}`),u.secureTextEntry&&I.push("  secureTextEntry: true"),u.enablesReturnKeyAutomatically&&I.push(`  return:        ${u.currentTextIsEmpty?"disabled (empty)":"enabled"}`)):I.push("  spec:          <none> (shown via dev-tools with no TextInput)"),I.push(`  mode:          ${a}${b?" (shifted)":""}${k?" (caps)":""}`),$&&I.push(`  accessoryBar:  ${$}`),console.log(I.join(`
-`))}async function Je(o){let c=await o.bridge.listBrowsers();if(E(o.args)){C(c.map(i=>({...i,active:i.id===o.browserId})));return}Pe(c,o.browserId)}function X(o){return o<1024?`${o}B`:o<1024*1024?`${(o/1024).toFixed(1)}KB`:`${(o/1024/1024).toFixed(1)}MB`}function le(o,c){return c<=0?"?":`${(o/c*100).toFixed(0)}%`}async function He(o,c={args:[]}){let d=await o.send({type:"evaluate",code:`(async () => {
-      const host = window.__sootsimRenderHost
-      const stats = host?.queryStats ? await host.queryStats() : null
-      const hostMem = performance.memory
-        ? {
-            usedJSHeapSize: performance.memory.usedJSHeapSize,
-            totalJSHeapSize: performance.memory.totalJSHeapSize,
-            jsHeapSizeLimit: performance.memory.jsHeapSizeLimit,
-          }
-        : null
-      return {
-        imageLoader: stats?.memory?.imageLoader ?? null,
-        workerHeap: stats?.memory?.workerHeap ?? null,
-        hostHeap: hostMem,
-      }
-    })()`})??{};if(E(c.args)){C(d);return}if(console.log("  memory:"),d.imageLoader){let u=d.imageLoader;console.log("    image-loader cache"),console.log(`      entries:        ${u.cacheEntries} / ${u.cacheMaxEntries} (${le(u.cacheEntries,u.cacheMaxEntries)})`),console.log(`      pixel bytes:    ${X(u.cachePixelBytes)} / ${X(u.cachePixelBudget)} (${le(u.cachePixelBytes,u.cachePixelBudget)})`),console.log(`      pending:        ${u.pendingFetches} fetches, ${u.pendingBytes} bytes`),console.log(`      failed uris:    ${u.failedUris}`),console.log(`      snapshots:      ${u.snapshots}`),console.log(`      camera frames:  ${u.cameraFrames}`)}else console.log("    image-loader cache: not available (engine pre-rebuild?)");if(d.workerHeap){let u=d.workerHeap;console.log("    worker heap (chrome only)"),console.log(`      used:   ${X(u.usedJSHeapSize)} / ${X(u.jsHeapSizeLimit)} (${le(u.usedJSHeapSize,u.jsHeapSizeLimit)})`),console.log(`      total:  ${X(u.totalJSHeapSize)}`)}if(d.hostHeap){let u=d.hostHeap;console.log("    host heap (chrome only)"),console.log(`      used:   ${X(u.usedJSHeapSize)} / ${X(u.jsHeapSizeLimit)} (${le(u.usedJSHeapSize,u.jsHeapSizeLimit)})`),console.log(`      total:  ${X(u.totalJSHeapSize)}`)}}function se(o){let c=o.indexOf("--testid");if(c>=0&&o[c+1])return{mode:"testid",value:o[c+1]};let i=o.indexOf("--test-id");if(i>=0&&o[i+1])return{mode:"testid",value:o[i+1]};let d=o.indexOf("--text");return d>=0&&o[d+1]?{mode:"text",value:o[d+1]}:null}async function ce(o,c){let i=JSON.stringify(c.value),d=c.mode==="testid"?`(await t.findByTestId(${i})) || (await t.findById(${i}))`:`await t.findByText(${i})`;return await o.send({type:"evaluate",code:`(async () => {
-      const t = window.__sootsimTest
-      if (!t) return null
-      const n = ${d}
-      if (!n || !n.absolutePosition || !n.layout) return null
-      const resolved =
-        typeof n.nodeId === 'number' && typeof t.resolveTapTarget === 'function'
-          ? await t.resolveTapTarget(n.nodeId)
-          : null
-      const cx =
-        typeof resolved?.cx === 'number'
-          ? resolved.cx
-          : n.absolutePosition.x + (n.layout.width || 0) / 2
-      const cy =
-        typeof resolved?.cy === 'number'
-          ? resolved.cy
-          : n.absolutePosition.y + (n.layout.height || 0) / 2
-      return { x: cx, y: cy, testID: n.testID, text: n.text }
-    })()`})??null}async function qe(o,c={}){let i=await o.send({type:"evaluate",code:`(async () => {
-      const test = window.__sootsimTest
-      const kb = window.__sootsimKeyboard
-      const navSnap =
-        test && typeof test.getNavigationSnapshot === 'function'
-          ? test.getNavigationSnapshot()
-          : null
-      const keyboard =
-        kb && typeof kb.getLayout === 'function'
-          ? (() => {
-              const layout = kb.getLayout()
-              return layout ? {
-                visible: layout.visible,
-                mode: layout.mode,
-                spec: layout.spec
-                  ? {
-                      keyboardType: layout.spec.keyboardType,
-                      returnKeyType: layout.spec.returnKeyType,
-                    }
-                  : null,
-              } : null
-            })()
-          : null
-      return { nav: navSnap, keyboard }
-    })()`}),d=i?.nav??null,u=i?.keyboard??null,a=await V(o,500).catch(()=>null);if(c.json){console.log(JSON.stringify({shell:a??null,nav:d,keyboard:u},null,2));return}let b=[];if(a){let k=a.activeApp??a.state??"<none>",$=a.showSwitcher?" (app switcher open)":"",I=typeof a.launchProgress=="number"&&a.launchProgress<.98?` launching (${Math.round(a.launchProgress*100)}%)`:"";b.push(`shell:    ${k}${$}${I}`)}else b.push("shell:    <unavailable>");if(d){let k=d.transitionPhase!=="idle"?` (${d.transitionPhase}, ${d.activeTransitionCount} active)`:"";if(b.push(`nav:      phase=${d.transitionPhase}${k}`),d.screens.length===0)b.push("  <no registered screens \u2014 app may not use react-native-screens>");else for(let $ of d.screens){let I=$.isActive?"\u25B6":" ",y=$.routeName?` ${$.routeName}`:"",S=$.headerHeight>0?` header=${$.headerHeight}`:"",A=$.largeTitleState&&$.largeTitleState!=="expanded"?` large-title=${$.largeTitleState}`:"";b.push(`  ${I} #${$.id}${y}${S}${A}`)}}else b.push("nav:      <runtime not available>");if(u&&u.visible){let k=u.spec?.keyboardType??"default",$=u.spec?.returnKeyType??"default";b.push(`keyboard: visible (${k}, return=${$}, mode=${u.mode??"?"})`)}else b.push("keyboard: hidden");console.log(b.join(`
-`))}async function ee({bridge:o,maxMs:c,pollMs:i=50,stablePolls:d=3,strict:u=!1}){let a=await o.send({type:"evaluate",code:`(async () => {
-      const start = Date.now()
-      const deadline = start + ${Math.max(0,Math.round(c))}
-      const pollMs = ${Math.max(1,Math.round(i))}
-      const requiredStablePolls = ${Math.max(1,Math.round(d))}
-      const strict = ${u?"true":"false"}
-      const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
-      const readSnapshot = async () => {
-        let animating = false
-        try {
-          const stats = await window.__sootsimRenderHost?.queryStats?.()
-          if (stats) {
-            animating =
-              stats.hasActiveAnims === true ||
-              stats.hasActiveNativeAnimations === true ||
-              stats.hasPendingAnimationFrames === true
-          }
-        } catch {}
-        const root = window.__sootsimRoot
-        const nodes = []
-        if (root) {
-          const walk = (n) => {
-            if (n.layout && n.layout.width > 0) {
-              nodes.push(Math.round(n.layout.x) + ',' + Math.round(n.layout.y) + ',' + Math.round(n.layout.width))
-            }
-            for (const c of n.children || []) walk(c)
-          }
-          walk(root)
-        }
-        return { layout: nodes.join(';'), animating }
-      }
-
-      let lastLayout = ''
-      let stable = 0
-      while (Date.now() < deadline) {
-        const snapshot = await readSnapshot()
-        const strictOk = !strict || !snapshot.animating
-        if (strictOk && snapshot.layout === lastLayout) {
-          stable++
-          if (stable >= requiredStablePolls) {
-            return { settled: true, elapsed: Date.now() - start }
-          }
-        } else {
-          stable = 0
-        }
-        lastLayout = snapshot.layout
-        await sleep(pollMs)
-      }
-      return { settled: false, elapsed: Date.now() - start }
-    })()`}),{elapsed:b,settled:k}=a??{};return{elapsed:typeof b=="number"?b:c,settled:k===!0}}async function We(o){let{bridge:c,args:i,positional:d}=o,u=d[1]?Number(d[1])*1e3:3e3,a=i.includes("--strict"),{elapsed:b,settled:k}=await ee({bridge:c,maxMs:u,strict:a});console.log(k?`  settled in ${b}ms`:`  timed out after ${b}ms (may still be animating)`)}async function ze(o){let c=o.positional[1]?Number(o.positional[1]):.5;(!Number.isFinite(c)||c<0)&&(console.error(o.inspectUsage("sleep","[seconds]")),process.exit(1)),await Y(c*1e3),console.log(`  slept ${c}s`)}async function Ke(o){let{bridge:c,args:i,positional:d}=o,u=d[1]?Number(d[1]):5,a=await c.send({type:"evaluate",code:`(async () => await window.__sootsimTest.dumpTree(${u}))()`});if(E(i)){C({depth:u,tree:a??null});return}console.log(typeof a=="string"?a:JSON.stringify(a,null,2))}async function Ue(o,c={args:[]}){let i=await o.send({type:"evaluate",code:"window.location.href"}),d=typeof i=="string"?i:"";if(E(c.args)){C({url:d});return}console.log(d)}async function Ye(o){let{wsPort:c,commandTimeoutMs:i,browserId:d,positional:u}=o,a=u[1]?Number(u[1]):30,b=Math.max(1e3,(Number.isFinite(a)?a:30)*1e3),k=Math.max(1,Math.ceil(b/500));console.log("  waiting for browser reconnect...");let $=await Ie(c,i,d,{attempts:k});$||(console.error("  timed out waiting for browser reconnect"),process.exit(1)),$.bridge.close(),ae({source:"inspect wait",step:{wait:b},summary:`wait ${Math.round(b/1e3)}s`}),console.log(`  ready: ${$.count} nodes`)}async function Ge(o){let{bridge:c,args:i}=o,d=i.includes("--strict"),u=i.indexOf("--max-ms"),a=u>=0&&i[u+1]?Math.max(100,Number(i[u+1])):3e3,{elapsed:b,settled:k}=await ee({bridge:c,maxMs:a,strict:d});k?console.log(`  idle in ${b}ms`):(console.error(`  \u26A0 wait idle timed out after ${b}ms (may still be animating)`),process.exit(1))}async function Xe(o){let{bridge:c,args:i}=o,d=2e4,u=i.indexOf("--max-ms");u>=0&&i[u+1]&&(d=Math.max(100,Number(i[u+1])));let a=Date.now(),b=a+d,k=`(async () => {
-    const t = window.__sootsimTest
-    let nodes = 0
-    try { nodes = (await t?.getNodeCount?.()) || 0 } catch {}
-    return {
-      flag: (window).__sootsimExternalAppReady,
-      at: (window).__sootsimExternalAppReadyAt || 0,
-      nodes,
-    }
-  })()`,$={flag:void 0,at:0,nodes:0};for(;Date.now()<b;){try{$=await c.send({type:"evaluate",code:k})??$}catch{}if($.flag===!0){console.log(`  ready in ${Date.now()-a}ms: ${$.nodes} nodes (flag)`);return}await new Promise(I=>setTimeout(I,150))}console.error(`  \u26A0 wait ready timed out after ${Date.now()-a}ms \u2014 guest app did not emit sootsim:externalAppReady (nodes: ${$.nodes})`),process.exit(1)}async function Ve(o){let{bridge:c,args:i,positional:d,inspectUsage:u}=o,a=d[1];a||(console.error(u("wait selector","<testid> [--max-ms 5000]")),process.exit(1));let b=i.indexOf("--max-ms"),k=b>=0&&i[b+1]?Math.max(100,Number(i[b+1])):5e3,$=await c.send({type:"evaluate",code:`(async () => {
-      const start = Date.now()
-      const deadline = start + ${k}
-      const t = window.__sootsimTest
-      const find = async () => {
-        try {
-          return (await t?.findByTestId?.(${JSON.stringify(a)})) ||
-            (await t?.findById?.(${JSON.stringify(a)})) || null
-        } catch {}
-        return null
-      }
-      while (Date.now() < deadline) {
-        const node = await find()
-        if (node && node.layout && node.layout.width > 0 && node.layout.height > 0) {
-          return { found: true, node, elapsed: Date.now() - start }
-        }
-        await new Promise((r) => setTimeout(r, 80))
-      }
-      return { found: false, elapsed: Date.now() - start }
-    })()`}),{found:I,node:y,elapsed:S}=$??{};if(I&&y){let A=y.absolutePosition?`@(${Math.round(y.absolutePosition.x)},${Math.round(y.absolutePosition.y)})`:"",v=y.layout?`${Math.round(y.layout.width)}x${Math.round(y.layout.height)}`:"?x?";console.log(`  found #${a} in ${S}ms ${v} ${A}`)}else console.error(`  \u26A0 wait selector #${a} timed out after ${S??k}ms`),process.exit(1)}function nt(o){return o==null?"\u2014":o<1024?`${o}B`:o<1024*1024?`${(o/1024).toFixed(1)}K`:`${(o/1024/1024).toFixed(1)}M`}function rt(o){return o==null?"   \u2026":o<1e3?`${o}ms`.padStart(5):`${(o/1e3).toFixed(2)}s`.padStart(5)}function It(o){return o.error?"err":o.status==null?" \u2026 ":String(o.status)}function Ze(o){let c=new Date(o.startTs).toLocaleTimeString(),i=It(o).padEnd(3),d=o.method.padEnd(5),u=nt(o.size).padStart(6),a=rt(o.durationMs);console.log(`  [${c}] ${i} ${d} ${u} ${a}  ${o.displayUrl}`),o.error&&console.log(`           error: ${o.error}`)}function Ft(o){let c=[["id",o.id],["source",o.source],["kind",o.kind],["method",o.method],["status",o.error?`error: ${o.error}`:`${o.status??"\u2014"} ${o.statusText??""}`.trim()],["url",o.url],["started",new Date(o.startTs).toLocaleTimeString()],["duration",rt(o.durationMs).trim()],["size",nt(o.size)],["content-type",o.type??"\u2014"]];for(let[i,d]of c)console.log(`  ${i.padEnd(13)} ${d}`)}var At={error:"\x1B[31m",warn:"\x1B[33m",info:"\x1B[36m",debug:"\x1B[35m",log:"\x1B[37m"},Qe="\x1B[0m",Pt="\x1B[2m";function et(o,c){let i=new Date(o.ts).toLocaleTimeString(),d=o.level.toUpperCase().padEnd(5),u=o.args.join(" ");if(c){let a=At[o.level];console.log(`  ${Pt}[${i}]${Qe} ${a}${d}${Qe}  ${u}`)}else console.log(`  [${i}] ${d}  ${u}`);if(o.stack&&o.level==="error"){let a=o.stack.split(`
-`).slice(0,5);for(let b of a)console.log(`    ${b.trim()}`)}}var G="__sootsimCliPerf",Ot=120;async function tt(o,c){let i=o.find((A,v)=>o[v-1]==="--id"),d=o.find((A,v)=>o[v-1]==="--text");if(i||d){let A=await c.send({type:"evaluate",code:Ne({id:i,text:d})});if(!A)throw new Error(i?`no node with id "${i}"`:`no node matching text "${d}"`);let{x:v,y:j,w:l,h:R}=A;return{x:v,y:j,w:l,h:R}}let u=o.find((A,v)=>o[v-1]==="--area");if(u){let A=u.split(",").map(D=>Number(D.trim()));if(A.length!==4||A.some(D=>!Number.isFinite(D)))throw new Error(`--area expects x,y,w,h (got "${u}")`);let[v,j,l,R]=A;return{x:v,y:j,w:l,h:R}}let a=A=>{let v=o.find((l,R)=>o[R-1]===A);if(v==null)return null;let j=Number(v);return Number.isFinite(j)?j:null},b=a("--x"),k=a("--y"),$=a("--w"),I=a("--h");if(b!=null||k!=null||$!=null||I!=null)return{x:b??0,y:k??0,w:$??1,h:I??1};let S=o.filter((A,v)=>v>0&&!A.startsWith("-")&&o[v-1]!=="--output"&&o[v-1]!=="--area"&&o[v-1]!=="--id"&&o[v-1]!=="--text"&&o[v-1]!=="--x"&&o[v-1]!=="--y"&&o[v-1]!=="--w"&&o[v-1]!=="--h").map(Number).filter(A=>Number.isFinite(A));if(S.length>=2){let[A,v,j=1,l=1]=S;return{x:A,y:v,w:j,h:l}}return null}function be(o){let c={"<8":0,"8-12":0,"12-16":0,"16-20":0,"20-33":0,">33":0};for(let i of o)i<8?c["<8"]++:i<12?c["8-12"]++:i<16?c["12-16"]++:i<20?c["16-20"]++:i<33?c["20-33"]++:c[">33"]++;console.log("  histogram:");for(let[i,d]of Object.entries(c)){let u="\u2588".repeat(Math.ceil(d/o.length*40));console.log(`    ${i.padEnd(6)} ${u} ${d}`)}}async function de(o,c,i){let d=Date.now()+c,u=await V(o,c);for(;;){if(i(u))return{settled:!0,state:u};if(Date.now()>=d)return{settled:!1,state:u};await Y(16),u=await V(o)}}async function he(o){return o.send({type:"evaluate",code:`(async () => {
-      const kb = window.__sootsimKeyboard
-      const test = window.__sootsimTest
-      if (!kb) return { error: 'keyboard bridge not available' }
-      const visible = kb.isVisible()
-      const mode = kb.getMode()
-      let focused = null
-      if (test && typeof test.getFocusedNode === 'function') {
-        try {
-          focused = await test.getFocusedNode()
-        } catch {}
-      }
-      let runtimeSnapshot = null
-      if (test && typeof test.getFocusKeyboardSnapshot === 'function') {
-        try {
-          runtimeSnapshot = await test.getFocusKeyboardSnapshot()
-        } catch {}
-      }
-      return {
-        visible,
-        mode,
-        focusedInput: focused ? {
-          nodeId: focused.nodeId ?? null,
-          testID: focused.testID || null,
-          id: focused.id || null,
-          placeholder: focused.placeholder || null,
-          text: focused.text || null,
-        } : null,
-        phase: runtimeSnapshot?.keyboard?.phase ?? null,
-        frame: runtimeSnapshot?.keyboard?.frame ?? null,
-        focusedRect: runtimeSnapshot?.focused?.rect ?? null,
-      }
-    })()`})}async function Et(o,c=600){let i=Date.now()+c;for(;Date.now()<=i;){let d=await he(o);if(d.visible)return d;await Y(30)}return he(o)}async function ue(o,c){let i=await he(o);if(i.visible)return i;console.error(`  ${c} requires the iOS keyboard to be visible. focus an input first with sootsim do tap-id/tap-text or sootsim do type-into.`),process.exit(1)}async function ot(o,c,i){return c==="appearance"?o.send({type:"evaluate",code:`(async () => {
-        const requested = ${JSON.stringify(i??"toggle")}
-        const rootBg = (document.documentElement?.style?.background || '').toLowerCase()
-        const inferredCurrent = rootBg.includes('33') ? 'dark' : 'light'
-        let applied = requested
-        if (requested === 'toggle') {
-          applied = inferredCurrent === 'dark' ? 'light' : 'dark'
-        } else if (requested === 'auto') {
-          applied = window.matchMedia?.('(prefers-color-scheme: dark)')?.matches ? 'dark' : 'light'
-        }
-        window.postMessage({ type: 'soot-action', action: 'set-appearance', value: applied }, '*')
-        return { ok: true, requested, applied }
-      })()`}):o.send({type:"evaluate",code:`(async () => {
-      window.dispatchEvent(new CustomEvent(${JSON.stringify(c==="lock"?"sootsim:toggleLock":"sootsim:shake")}))
-      return { ok: true, action: ${JSON.stringify(c)} }
-    })()`})}function Rt(o){let c={Enter:"return",NumpadEnter:"return",Backspace:"delete",Delete:"delete",Space:"space",ShiftLeft:"shift",ShiftRight:"shift"};if(c[o])return c[o];let i=o.match(/^Digit([0-9])$/);if(i)return i[1];let d=o.match(/^Key([A-Z])$/);return d?d[1].toLowerCase():null}function Ct(o){if(typeof o!="string")return null;let c=o.replace(/\s+/g," ").trim();return c?c.slice(0,80):null}function at(...o){for(let c of o){if(typeof c!="string")continue;let i=c.trim();if(i)return i}return null}async function L(o,c,i){ae({source:o,step:c,summary:i})}function Dt(o,c,i){if(!i||i.hit===!1)return null;let d=at(i.responderTestID,i.testID);if(d)return{step:{tapOn:{id:d}},summary:`tap #${d}`};let u=Ct(i.text);return u?{step:{tapOn:u},summary:`tap "${u}"`}:{step:{tapAtCoords:{x:o,y:c}},summary:`tap @${Math.round(o)},${Math.round(c)}`}}function st(o,c,i){let d=at(c?.testID,c?.id);return d?{step:{tapOn:{id:d}},summary:`tap #${d}`}:i==="id"?{step:{tapOn:{id:o}},summary:`tap #${o}`}:{step:{tapOn:o},summary:`tap "${o}"`}}async function rs(o,c){let i=o[0]==="get"||o[0]==="do"||o[0]==="debug"||o[0]==="wait"?o[0]:null,d=i?o.slice(1):o,u=$e(d,{port:c.port,commandTimeoutMs:c.timeoutMs,stripBooleanFlags:["--verbose","-v","--help","-h","--clear-state","--json","--all","--watch","-w","--strict","--no-wait","--dump","--failed","--tail","-f","--internal"],stripValueFlags:["--output","--nth","--index","--testid","--test-id","--text","--max-ms","--filter","--limit","--level"]}),a=u.positional,b=a[0],k=i==="get"||i==="do"||i==="debug"||i==="wait"?i:"inspect",$=typeof d[0]=="string"&&xe.has(d[0]),I=$?d[0]:null,y=e=>$&&e===d[0]?`sootsim ${e}`:`sootsim ${k} ${e}`,S=(e,t)=>`  usage: ${y(e)}${t?` ${t}`:""}`;if(!b||o.includes("--help")||o.includes("-h")){let e={bridgePort:7668,defaultShellUrl:we};if(k==="do"||k==="get"||k==="debug"||k==="wait"){let r=me(k,e);r&&(console.log(`${r}
-`),process.exit(0))}if(I==="shell"){let r=pe("shell",e);r&&(console.log(`${r}
-`),process.exit(0))}let t=pe("inspect",e),s=["do","get","debug","wait"].map(r=>me(r,e)).filter(r=>r!=null).join(`
-
-`);console.log(`${t??""}
-
-${s}
-`),process.exit(0)}let A=u.wsPort,v=u.browserId,j=u.commandTimeoutMs;if(b==="list"&&d.some(e=>e==="--drivers"||e==="-D")){let{buildDriverListRows:e}=await import("./drivers-YIXRFFBQ.js"),t=e();console.log(`  available drivers (${t.length}):
-`);let s=Math.max(...t.map(n=>n.id.length),6),r=Math.max(...t.map(n=>n.kind.length),4);for(let n of t){let m=n.available?"\u2713":"\u2717",p=n.id.padEnd(s),h=n.kind.padEnd(r);console.log(`  ${m} ${p}  ${h}  ${n.description}`),n.available&&n.detail?console.log(`    ${n.detail}`):!n.available&&n.reason&&console.log(`    unavailable: ${n.reason}`)}return}let l=Se(u),R=v||"default",D=new Set(["errors","warnings","requests","js","eval","reload","globals","perf","list","wait","sleep"]);function q(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 ne(e){let t=De()?1200:350;try{let{settled:s,elapsed:r}=await ee({bridge:e,maxMs:t,pollMs:32,stablePolls:2});s||process.stderr.write(`  \u26A0 auto-wait timed out after ${r??t}ms \u2014 next command may see mid-animation state. use \`sootsim do settle\` for a longer wait.
-`)}catch{}}async function Z(){try{return await l.send({type:"evaluate",code:`(() => ({
-          console: window.__sootsimConsole?.count?.() || null,
-          requests: window.__sootsimTest?.getRequestCounts?.() || null,
-        }))()`})||{console:null,requests:null}}catch{return{console:null,requests:null}}}async function x(e={}){let t=e.counts!==void 0?e.counts:await z(l,"getRequestCounts");if(!t||typeof t!="object")return;let s=Math.max(0,Number(t.failed)||0);if(s===0||!e.includeTail&&!ge("requests",R,String(s))||(console.log(`
-  network: ${s} failed request${s===1?"":"s"}`),console.log(`  inspect: ${y("requests")} 5`),!e.includeTail))return;let r=await z(l,"getFailedRequests",5);if(!(!Array.isArray(r)||r.length===0)){console.log(`
-  recent failed requests:
-`);for(let n of r){let m=new Date(n.timestamp).toLocaleTimeString();console.log(`  [${m}] ${q(n)}`),n.responseBody?console.log(`    ${n.responseBody}`):n.error&&console.log(`    ${n.error}`)}}}async function J(e={}){let t=e.counts!==void 0?e.counts:await l.send({type:"evaluate",code:"window.__sootsimConsole?.count?.() || { errors: 0, warnings: 0, total: 0 }"});if(!t||typeof t!="object")return;let s=t,r=Math.max(0,Number(s.errors)||0),n=Math.max(0,Number(s.warnings)||0);if(r===0&&n===0||!e.includeTail&&!ge("console",R,`${r}:${n}`))return;let m=[];if(r>0&&m.push(`${r} console error${r===1?"":"s"}`),n>0&&m.push(`${n} console warning${n===1?"":"s"}`),console.log(`
-  console: ${m.join(", ")}`),console.log(`  inspect: ${y("errors")} 5`),n>0&&console.log(`  inspect: ${y("warnings")} 5`),!e.includeTail||r===0)return;let p=await l.send({type:"evaluate",code:"window.__sootsimConsole?.getErrors?.(5) || []"});if(!(!Array.isArray(p)||p.length===0)){console.log(`
-  recent console errors:
-`);for(let h of p){let f=new Date(h.timestamp).toLocaleTimeString(),w=Array.isArray(h.args)?h.args.map(O=>typeof O=="object"?JSON.stringify(O):String(O)).join(" "):String(h);console.log(`  [${f}] ${w}`)}}}let H=new Set(["tap","double-tap","tap-text","tap-id","type","type-into","key","key-sequence","keycode","drag","swipe","long-press","touch","gesture","pinch","scroll","shell"]),K=new Set(["a11y","capture","count","double-tap","drag","find","gesture","layout","long-press","node","pinch","sample-color","scroll","screenshot","swipe","tap","tap-id","tap-text","touch","tree","type-into"]),Q=(o.includes("--verbose")||o.includes("-v"))&&!o.includes("--json");k==="do"&&b==="shell"&&(console.error("  `sootsim do shell` was removed. use `sootsim shell ...` instead."),process.exit(1)),H.has(b)&&await ke(l),K.has(b)&&await ie(l,{verbose:Q});try{switch(b){case"list":{await Je({bridge:l,browserId:v,args:d});break}case"tree":{await Ke({bridge:l,args:d,positional:a});break}case"a11y":{let e=a[1]?Number(a[1]):5,t=await l.send({type:"evaluate",code:`(async () => {
-            const t = window.__sootsimTest
-            if (!t) return []
-            const all = await t.queryAll({ pruneHidden: true })
-            return all.filter(n => {
-              // skip zero-size nodes
-              if (!n.layout || n.layout.width <= 0 || n.layout.height <= 0) return false
-              // keep nodes with explicit accessibility roles or labels
-              if (n.accessibilityRole) return true
-              if (n.accessibilityHint) return true
-              if (n.isTextInput) return true
-              if (n.pressable) return true
-              // keep text leaf nodes
-              if (n.type === 'text' && n.text) return true
-              // keep views with intentional labels (not auto-derived)
-              if (n.accessibilityLabel && n.accessibilityLabel.length <= 30
-                  && n.accessibilityLabel !== n.text) return true
-              // skip container views without role (just concatenated child text)
-              return false
-            }).map(n => ({
-              role: n.accessibilityRole || (n.pressable ? 'button' : n.isTextInput ? 'textfield' : n.type === 'text' ? 'statictext' : 'none'),
-              label: n.accessibilityLabel || n.text || null,
-              hint: n.accessibilityHint || null,
-              state: n.accessibilityState || null,
-              testID: n.testID || null,
-              position: n.absolutePosition ? { x: Math.round(n.absolutePosition.x), y: Math.round(n.absolutePosition.y) } : null,
-              size: n.layout ? { w: Math.round(n.layout.width), h: Math.round(n.layout.height) } : null,
-            }))
-          })()`});if(!Array.isArray(t)||t.length===0){console.log("  no accessible nodes found");break}if(o.includes("--json"))console.log(JSON.stringify(t,null,2));else{console.log(`  accessibility tree (${t.length} nodes):
-`);for(let s of t){let r=[];if(r.push(`[${s.role}]`),s.label){let n=s.label.length>50?s.label.slice(0,47)+"...":s.label;r.push(`"${n}"`)}if(s.hint&&r.push(`(hint: "${s.hint}")`),s.testID&&r.push(`#${s.testID}`),s.state){let n=[];s.state.disabled&&n.push("disabled"),s.state.selected&&n.push("selected"),s.state.checked===!0&&n.push("checked"),s.state.checked==="mixed"&&n.push("mixed"),s.state.busy&&n.push("busy"),s.state.expanded===!0&&n.push("expanded"),s.state.expanded===!1&&n.push("collapsed"),n.length&&r.push(`{${n.join(", ")}}`)}s.position&&r.push(`@(${s.position.x},${s.position.y})`),s.size&&r.push(`${s.size.w}x${s.size.h}`),console.log("  "+r.join(" "))}}break}case"find":{await Le({bridge:l,args:o,effectiveArgs:d,positional:a,inspectUsage:S});break}case"count":{await Re(l,{args:d});break}case"keyboard":{await je(l,{json:o.includes("--json")});break}case"screens":{await qe(l,{json:o.includes("--json")});break}case"memory":{await He(l,{args:d});break}case"wait":{await Ye({wsPort:A,commandTimeoutMs:j,browserId:v,positional:a});break}case"sleep":{await ze({positional:a,inspectUsage:S});break}case"settle":{await We({bridge:l,args:o,positional:a});break}case"ready":{await Xe({bridge:l,args:o});break}case"idle":{await Ge({bridge:l,args:o,positional:a});break}case"selector":{await Ve({bridge:l,args:o,positional:a,inspectUsage:S});break}case"layout":{let e=a[1];e||(console.error(S("layout","<id>")),process.exit(1));let t=await l.send({type:"evaluate",code:`(async () => await window.__sootsimTest.getLayout(${JSON.stringify(e)}))()`});console.log(JSON.stringify(t,null,2));break}case"capture":case"screenshot":{let t=o.find((h,f)=>o[f-1]==="--output")||"/tmp/sootsim-inspect.png",s=await tt(o,l),r={type:"screenshot"};s&&(r.crop=s);let m=(await l.send(r)).replace(/^data:image\/png;base64,/,"");s&&console.log(`  area:  x=${s.x} y=${s.y} w=${s.w} h=${s.h}`),(await import("fs")).writeFileSync(t,Buffer.from(m,"base64")),console.log(`  saved: ${t}`);break}case"sample-color":{let e=await tt(o,l);e||(console.error(S("sample-color","<x> <y> [w] [h] | --id <testID> | --text <text>")),console.error("  samples an averaged color from the canvas. coords are logical sootsim units."),process.exit(1));let t=await l.send({type:"evaluate",code:_e(e)});if(o.includes("--json"))console.log(JSON.stringify(t,null,2));else{let{r:s,g:r,b:n,a:m,hex:p,samples:h}=t,f=e.w===1&&e.h===1?`@(${e.x},${e.y})`:`@(${e.x},${e.y}) ${e.w}x${e.h}`;console.log(`  ${p}  rgba(${s}, ${r}, ${n}, ${m})  ${f}  ${h} samples`)}break}case"node":{let e=a[1];e||(console.error(S("node","<matcher>")),console.error("  resolves testID, id, then text \u2014 dumps full node info as JSON"),process.exit(1));let t=await l.send({type:"evaluate",code:`(async () => {
-            const t = window.__sootsimTest
-            const q = ${JSON.stringify(e)}
-            let node = null
-            let via = null
-            if (t.findByTestId) { node = await t.findByTestId(q); if (node) via = 'testID' }
-            if (!node && t.findById) { node = await t.findById(q); if (node) via = 'id' }
-            if (!node && t.findByText) { node = await t.findByText(q); if (node) via = 'text' }
-            if (!node) return { matcher: q, found: false }
-
-            // read the resolved transform (if any) off the style \u2014 useful
-            // because canvas nodes often animate via transform and describe
-            // output strips that.
-            const transform =
-              node.style && Array.isArray(node.style.transform)
-                ? node.style.transform
-                : node.style && node.style.transform
-                  ? node.style.transform
-                  : null
-
-            // parent chain \u2014 walk up from the node so the JSON dump is
-            // self-describing.
-            const parentChain = []
-            const root = window.__sootsimRoot
-            if (root && node.id != null) {
-              const findPath = (n, targetId, path) => {
-                if (!n) return null
-                if (n.id === targetId) return path
-                if (n.children) {
-                  for (const child of n.children) {
-                    const nextPath = [
-                      ...path,
-                      {
-                        type: n.type || 'view',
-                        testID: n.props?.testID || null,
-                        text: n.text || null,
-                      },
-                    ]
-                    const found = findPath(child, targetId, nextPath)
-                    if (found) return found
-                  }
-                }
-                return null
-              }
-              const chain = findPath(root, node.id, [])
-              if (chain) parentChain.push(...chain)
-            }
-
-            return {
-              matcher: q,
-              found: true,
-              resolvedVia: via,
-              node,
-              transform,
-              parentChain,
-            }
-          })()`});console.log(JSON.stringify(t,null,2));break}case"tap":{let e=Number(a[1]),t=Number(a[2]),s=se(o);if(s){let m=await ce(l,s);m||(console.error(`  not found: ${s.value}`),s.mode==="testid"&&U("wait-selector-for-missing-testid",s.value),process.exit(1)),e=m.x,t=m.y}(!Number.isFinite(e)||!Number.isFinite(t))&&(console.error(S("tap","<x> <y> | --testid <id> | --text <t>")),process.exit(1));let r=await l.send({type:"tap",x:e,y:t}),n=Dt(e,t,r);n&&await L("inspect tap",n.step,n.summary),console.log(JSON.stringify(r,null,2));break}case"drag":case"swipe":{let e=Number(a[1]),t=Number(a[2]),s=Number(a[3]),r=Number(a[4]),n=b==="swipe"?10:12,m=b==="swipe"?8:16,p=a[5]?Number(a[5]):n,h=a[6]?Number(a[6]):m;(!Number.isFinite(e)||!Number.isFinite(t)||!Number.isFinite(s)||!Number.isFinite(r)||!Number.isFinite(p)||!Number.isFinite(h))&&(console.error(S(b,"<x1> <y1> <x2> <y2> [steps] [stepMs]")),process.exit(1));let f=await l.send({type:"evaluate",code:`(async () => {
-            const interact = window.__sootsimInteract
-            if (!interact?.drag) return { ok: false, reason: 'no interact.drag' }
-            const value = await interact.drag(${e}, ${t}, ${s}, ${r}, ${Math.max(1,Math.round(p))}, ${Math.max(0,Math.round(h))})
-            return { ok: !!value, value }
-          })()`});if(f?.ok){let w=Math.max(1,Math.round(Math.max(1,p)*Math.max(0,h)));await L(`inspect ${b}`,{swipe:{start:`${e}, ${t}`,end:`${s}, ${r}`,duration:w}},`${b} ${e},${t} -> ${s},${r}`)}console.log(JSON.stringify(f,null,2));break}case"pinch":{let e=Number(a[1]),t=Number(a[2]),s=Number(a[3]),r=Number(a[4]),n=Number(a[5]),m=Number(a[6]),p=Number(a[7]),h=Number(a[8]),f=a[9]?Number(a[9]):12,w=a[10]?Number(a[10]):16;(!Number.isFinite(e)||!Number.isFinite(t)||!Number.isFinite(s)||!Number.isFinite(r)||!Number.isFinite(n)||!Number.isFinite(m)||!Number.isFinite(p)||!Number.isFinite(h)||!Number.isFinite(f)||!Number.isFinite(w))&&(console.error(S("pinch","<x1> <y1> <x2> <y2> <x1'> <y1'> <x2'> <y2'> [steps] [stepMs]")),process.exit(1));let O=await l.send({type:"evaluate",code:`(async () => {
-            const interact = window.__sootsimInteract
-            if (!interact?.pinch) return { ok: false, reason: 'no interact.pinch' }
-            const value = await interact.pinch(${e}, ${t}, ${s}, ${r}, ${n}, ${m}, ${p}, ${h}, ${Math.max(1,Math.round(f))}, ${Math.max(0,Math.round(w))})
-            return { ok: !!value, value }
-          })()`});O?.ok&&await L("inspect pinch",{pinch:{from:[e,t,s,r],to:[n,m,p,h],steps:Math.max(1,Math.round(f)),stepMs:Math.max(0,Math.round(w))}},`pinch (${e},${t}) (${s},${r}) -> (${n},${m}) (${p},${h})`),console.log(JSON.stringify(O,null,2));break}case"tap-text":{let e=a[1];e||(console.error(S("tap-text","<text>")),process.exit(1));let t=_=>{let P=o.indexOf(_);return P>=0&&P+1<o.length?o[P+1]:null},s=_=>o.includes(_),r=t("--nth")??t("--index"),n=r!==null?Number(r):null;n!==null&&!Number.isFinite(n)&&(console.error(`  --nth/--index requires an integer, got: ${r}`),process.exit(1));let m=t("--within"),p=t("--role"),h=s("--exact"),f=s("--first"),w=t("--min-y"),O=t("--max-y"),B=t("--min-x"),N=t("--max-x");for(let[_,P]of[["--min-y",w],["--max-y",O],["--min-x",B],["--max-x",N]])P!==null&&!Number.isFinite(Number(P))&&(console.error(`  ${_} requires a number, got: ${P}`),process.exit(1));let M=o.indexOf("--near"),F=null;if(M>=0){let _=Number(o[M+1]),P=Number(o[M+2]);(!Number.isFinite(_)||!Number.isFinite(P))&&(console.error("  --near requires two numbers: --near <x> <y>"),process.exit(1)),F={x:_,y:P}}let W=JSON.stringify({query:e,exact:h,role:p,within:m,minX:B!==null?Number(B):null,maxX:N!==null?Number(N):null,minY:w!==null?Number(w):null,maxY:O!==null?Number(O):null,near:F,nth:n,first:f}),g=await l.send({type:"evaluate",code:`(async () => {
-            const t = window.__sootsimTest
-            if (!t) return { error: 'bridge-not-ready' }
-            const F = ${W}
-
-            const res = await t.queryTextCandidates({
-              query: F.query,
-              exact: !!F.exact,
-              ...(F.role ? { role: F.role } : {}),
-            })
-
-            let candidates = res.candidates || []
-
-            candidates = candidates.filter((c) => {
-              const ax = c.info.absolutePosition && c.info.absolutePosition.x
-              const ay = c.info.absolutePosition && c.info.absolutePosition.y
-              if (F.minX !== null && !(ax >= F.minX)) return false
-              if (F.maxX !== null && !(ax <= F.maxX)) return false
-              if (F.minY !== null && !(ay >= F.minY)) return false
-              if (F.maxY !== null && !(ay <= F.maxY)) return false
-              if (F.within && !c.ancestorTestIDs.includes(F.within)) return false
-              return true
-            })
-
-            if (F.near) {
-              candidates.sort((a, b) => {
-                const ax = (a.info.absolutePosition && a.info.absolutePosition.x) || 0
-                const ay = (a.info.absolutePosition && a.info.absolutePosition.y) || 0
-                const bx = (b.info.absolutePosition && b.info.absolutePosition.x) || 0
-                const by = (b.info.absolutePosition && b.info.absolutePosition.y) || 0
-                return (
-                  Math.hypot(ax - F.near.x, ay - F.near.y) -
-                  Math.hypot(bx - F.near.x, by - F.near.y)
-                )
-              })
-            } else {
-              candidates.sort((a, b) => {
-                const ay = (a.info.absolutePosition && a.info.absolutePosition.y) || 0
-                const by = (b.info.absolutePosition && b.info.absolutePosition.y) || 0
-                if (Math.abs(ay - by) > 2) return ay - by
-                const ax = (a.info.absolutePosition && a.info.absolutePosition.x) || 0
-                const bx = (b.info.absolutePosition && b.info.absolutePosition.x) || 0
-                return ax - bx
-              })
-            }
-
-            const total = candidates.length
-            if (total === 0) return { matched: 0, total: 0 }
-
-            let idx = 0
-            if (F.nth !== null) {
-              idx = F.nth < 0 ? total + F.nth : F.nth
-              if (idx < 0 || idx >= total) {
-                return { matched: 0, total, nthOutOfRange: true, nth: F.nth }
-              }
-            } else if (total > 1 && !F.first && !F.near) {
-              return {
-                ambiguous: true,
-                total,
-                candidates: candidates.slice(0, 10).map((c, i) => ({
-                  idx: i,
-                  nodeId: c.info.nodeId,
-                  type: c.info.type,
-                  testID: c.info.testID,
-                  text: (c.info.text || '').slice(0, 60),
-                  abs: c.info.absolutePosition,
-                  layout: c.info.layout
-                    ? {
-                        width: Math.round(c.info.layout.width || 0),
-                        height: Math.round(c.info.layout.height || 0),
-                      }
-                    : null,
-                  ancestorTestIDs: (c.ancestorTestIDs || []).slice(0, 5),
-                })),
-              }
-            }
-
-            const picked = candidates[idx]
-            const n = picked.info
-            if (!n.absolutePosition || !n.layout) return { matched: 0, total }
-
-            const resolved =
-              typeof n.nodeId === 'number' &&
-              typeof t.resolveTapTarget === 'function'
-                ? await t.resolveTapTarget(n.nodeId)
-                : null
-            const target = (resolved && resolved.target) || n
-            const cx =
-              resolved && typeof resolved.cx === 'number'
-                ? resolved.cx
-                : n.absolutePosition.x + (n.layout.width || 0) / 2
-            const cy =
-              resolved && typeof resolved.cy === 'number'
-                ? resolved.cy
-                : n.absolutePosition.y + (n.layout.height || 0) / 2
-            return {
-              cx,
-              cy,
-              match: {
-                nodeId: n.nodeId ?? null,
-                id: n.id,
-                testID: n.testID,
-                type: n.type,
-              },
-              target: {
-                nodeId: target.nodeId ?? null,
-                id: target.id,
-                testID: target.testID,
-                type: target.type,
-              },
-              strategy: (resolved && resolved.strategy) || 'matched-node',
-              total,
-              idx,
-            }
-          })()`});if(g?.error==="bridge-not-ready"&&(console.error("  sootsim test bridge not ready"),process.exit(1)),g?.ambiguous){let _=g.candidates;console.error(`  ambiguous: ${g.total} matches for "${e}"`);for(let P of _){let re=P.abs?`@(${Math.round(P.abs.x)},${Math.round(P.abs.y)})`:"",it=P.layout?` ${P.layout.width}x${P.layout.height}`:"",lt=P.testID?` #${P.testID}`:"",ct=P.text?` "${P.text}"`:"",dt=P.ancestorTestIDs.length>0?` within ${P.ancestorTestIDs.slice(0,3).map(ut=>`#${ut}`).join(" > ")}`:"";console.error(`    [${P.idx}] <${P.type}>${ct}${lt} ${re}${it}${dt}`)}g.total>_.length&&console.error(`    ... and ${g.total-_.length} more`),console.error("  pick one:"),console.error("    --nth <index>           pick the nth match (top-to-bottom, left-to-right; negatives from end)"),console.error("    --within <testID>       narrow to descendants of a node"),console.error("    --min-y / --max-y       geometric filter (pixels, absolute)"),console.error("    --min-x / --max-x       geometric filter (pixels, absolute)"),console.error("    --near <x> <y>          pick the closest match to a point"),console.error("    --exact                 exact text match (default is substring)"),console.error("    --role <role>           narrow to accessibilityRole"),console.error("    --first                 keep the old pick-first-silently behavior"),process.exit(2)}g?.nthOutOfRange&&(console.error(`  not found: nth ${g.nth} of ${g.total} match${g.total===1?"":"es"} for "${e}"`),process.exit(1)),(!g||typeof g.cx!="number")&&(console.error(`  not found: ${e}`),process.exit(1));let T=await l.send({type:"tap",x:g.cx,y:g.cy});if(T?.hit!==!1&&T?.ok!==!1){let _=st(e,{id:g.target?.id??null,testID:g.target?.testID??null,type:g.target?.type??null,cx:g.cx,cy:g.cy},"text");await L("inspect tap-text",_.step,_.summary)}console.log(JSON.stringify({matched:g.match,tapped:{nodeId:g.target?.nodeId??null,id:g.target?.id??null,testID:g.target?.testID??null,type:g.target?.type??null,cx:g.cx,cy:g.cy},...g.strategy&&g.strategy!=="matched-node"?{strategy:g.strategy}:{},...g.total>1||n!==null?{nth:{index:g.idx,total:g.total}}:{},result:T},null,2));break}case"tap-id":{let e=a[1];e||(console.error(S("tap-id","<id>")),process.exit(1));let t=JSON.stringify(e),s=await l.send({type:"evaluate",code:`(async () => {
-            const t = window.__sootsimTest
-            if (!t) return null
-            const n = (await t.findByTestId(${t})) || (await t.findById(${t}))
-            if (!n || !n.absolutePosition || !n.layout) return { cx: null }
-            const resolved =
-              typeof n.nodeId === 'number' && typeof t.resolveTapTarget === 'function'
-                ? await t.resolveTapTarget(n.nodeId)
-                : null
-            const target = (resolved && resolved.target) || n
-            const cx =
-              resolved && typeof resolved.cx === 'number'
-                ? resolved.cx
-                : n.absolutePosition.x + (n.layout.width || 0) / 2
-            const cy =
-              resolved && typeof resolved.cy === 'number'
-                ? resolved.cy
-                : n.absolutePosition.y + (n.layout.height || 0) / 2
-            return {
-              cx,
-              cy,
-              match: {
-                nodeId: n.nodeId ?? null,
-                id: n.id,
-                testID: n.testID,
-                type: n.type,
-              },
-              target: {
-                nodeId: target.nodeId ?? null,
-                id: target.id,
-                testID: target.testID,
-                type: target.type,
-              },
-              strategy: (resolved && resolved.strategy) || 'matched-node',
-            }
-          })()`});(!s||typeof s.cx!="number")&&(console.error(`  not found: ${e}`),process.exit(1));let r=await l.send({type:"tap",x:s.cx,y:s.cy});if(r?.hit!==!1&&r?.ok!==!1){let n=st(e,{id:s.target?.id??null,testID:s.target?.testID??null,type:s.target?.type??null,cx:s.cx,cy:s.cy},"id");await L("inspect tap-id",n.step,n.summary)}console.log(JSON.stringify({matched:s.match,tapped:{nodeId:s.target?.nodeId??null,id:s.target?.id??null,testID:s.target?.testID??null,type:s.target?.type??null,cx:s.cx,cy:s.cy},...s.strategy&&s.strategy!=="matched-node"?{strategy:s.strategy}:{},result:r},null,2));break}case"type-into":{let e=a[1],t=a.slice(2).join(" ");(!e||!t)&&(console.error(S("type-into","<id> <text>")),process.exit(1));let s=JSON.stringify(e),r=await l.send({type:"evaluate",code:`(async () => {
-            const t = window.__sootsimTest
-            if (!t) return null
-            const n = await (t.findByTestId(${s}) || t.findById(${s}))
-            if (!n || !n.absolutePosition || !n.layout) return null
-            return {
-              cx: n.absolutePosition.x + (n.layout.width || 0) / 2,
-              cy: n.absolutePosition.y + (n.layout.height || 0) / 2,
-              testID: n.testID,
-              isTextInput: !!n.isTextInput,
-              placeholder: n.placeholder || null,
-            }
-          })()`});(!r||typeof r.cx!="number")&&(console.error(`  not found: ${e}`),process.exit(1)),r.isTextInput||console.error(`  warning: ${e} is not a text input (isTextInput: false)`);let n=await l.send({type:"tap",x:r.cx,y:r.cy}),m=await Et(l);m.visible||(console.error(`  keyboard did not open after tapping ${e}`),process.exit(1));let p=m.focusedInput;p&&(p.testID===e||p.id===e||(console.error(`  focus routing mismatch after tap: requested ${JSON.stringify(e)} but focus is on ${JSON.stringify(p.testID??p.id??null)}. did the tap land on an outer Pressable wrapper?`),process.exit(1))),await l.send({type:"keyboard",action:"type",text:t}),await L("inspect type-into",{tapOn:{id:e},inputText:t},`type-into #${e} ${JSON.stringify(t)}`),console.log(JSON.stringify({target:e,isTextInput:r.isTextInput,keyboardOpened:m.visible??n?.keyboardOpened??!1,focusedInput:m.focusedInput??null,typed:t},null,2));break}case"type":{let e=a.slice(1).join(" ");e||(console.error(S("type","<text>")),process.exit(1)),await ue(l,"type"),await l.send({type:"keyboard",action:"type",text:e}),await L("inspect type",{inputText:e},`type ${JSON.stringify(e)}`),console.log(`  typed: ${JSON.stringify(e)}`);break}case"key":{let e=a[1];e||(console.error(S("key","<name>")),process.exit(1)),await ue(l,"key"),await l.send({type:"keyboard",action:"press",text:e}),await L("inspect key",{pressKey:e},`key ${e}`),console.log(`  pressed: ${e}`);break}case"key-sequence":{let e=a.slice(1);e.length===0&&(console.error(S("key-sequence","<key> [<key> ...]")),process.exit(1)),await ue(l,"key-sequence");for(let t of e)await l.send({type:"keyboard",action:"press",text:t});await L("inspect key-sequence",{pressKey:e.join(" ")},`key-sequence ${e.join(" ")}`),console.log(`  pressed: ${e.join(", ")}`);break}case"keycode":{let e=a.slice(1);e.length===0&&(console.error(S("keycode","<code> [<code> ...]")),process.exit(1));let t=e.map(r=>({code:r,key:Rt(r)})),s=t.filter(r=>!r.key);s.length>0&&(console.error(`  unsupported keycode(s): ${s.map(r=>r.code).join(", ")}`),process.exit(1)),await ue(l,"keycode");for(let r of t)await l.send({type:"keyboard",action:"press",text:r.key});await L("inspect keycode",{pressKey:t.map(r=>r.key).join(" ")},`keycode ${e.join(" ")}`),console.log(`  pressed: ${e.join(", ")}`);break}case"dispatch":{let e=a[1];e||(console.error(S("dispatch","<char>")),process.exit(1)),await l.send({type:"keyboard",action:"dispatchKey",text:e}),await L("inspect dispatch",{dispatchKey:e},`dispatch ${JSON.stringify(e)}`),console.log(`  dispatched: ${e}`);break}case"dismiss":{await l.send({type:"keyboard",action:"dismiss"}),await L("inspect dismiss",{hideKeyboard:!0},"dismiss keyboard"),console.log("  keyboard dismissed");break}case"double-tap":{let e=Number(a[1]),t=Number(a[2]),s=se(o);if(s){let p=await ce(l,s);p||(console.error(`  not found: ${s.value}`),s.mode==="testid"&&U("wait-selector-for-missing-testid",s.value),process.exit(1)),e=p.x,t=p.y}let r=a[3]?Number(a[3]):80;(!Number.isFinite(e)||!Number.isFinite(t)||!Number.isFinite(r))&&(console.error(S("double-tap","<x> <y> [gapMs] | --testid <id>")),process.exit(1));let n=Math.max(0,Math.round(r)),m=await l.send({type:"evaluate",code:`(async () => {
-            const interact = window.__sootsimInteract
-            if (interact?.doubleTap) {
-              return {
-                ok: !!(await interact.doubleTap(${e}, ${t}, ${n})),
-                gapMs: ${n},
-              }
-            }
-            if (!interact?.tap) {
-              return { ok: false, reason: 'no interact.tap', gapMs: ${n} }
-            }
-            const first = await interact.tap(${e}, ${t})
-            if (!first || first.hit === false) {
-              return { ok: false, reason: 'first tap missed', gapMs: ${n}, first }
-            }
-            await new Promise((resolve) => setTimeout(resolve, ${n}))
-            const second = await interact.tap(${e}, ${t})
-            return {
-              ok: !!second && second.hit !== false,
-              gapMs: ${n},
-              first,
-              second,
-            }
-          })()`});m?.ok&&await L("inspect double-tap",{doubleTapAtCoords:{x:e,y:t,gapMs:n}},`double-tap @${e},${t}`),console.log(JSON.stringify(m,null,2));break}case"long-press":{let e=Number(a[1]),t=Number(a[2]),s=se(o);if(s){let m=await ce(l,s);m||(console.error(`  not found: ${s.value}`),s.mode==="testid"&&U("wait-selector-for-missing-testid",s.value),process.exit(1)),e=m.x,t=m.y}let r=a[3]?Number(a[3]):600;(!Number.isFinite(e)||!Number.isFinite(t)||!Number.isFinite(r))&&(console.error(S("long-press","<x> <y> [durationMs] | --testid <id>")),process.exit(1));let n=await l.send({type:"evaluate",code:`(async () => {
-            const interact = window.__sootsimInteract
-            if (!interact?.longPress) return { ok: false, reason: 'no interact.longPress' }
-            const value = await interact.longPress(${e}, ${t}, ${Math.max(0,Math.round(r))})
-            return { ok: !!value, value }
-          })()`});n?.ok&&await L("inspect long-press",{tapAtCoords:{x:e,y:t}},`long-press @${e},${t}`),console.log(JSON.stringify(n,null,2));break}case"touch":{let e=a[1],t=Number(a[2]),s=Number(a[3]),r=a[4]?Number(a[4]):999,n=e==="down"?"touchDown":e==="move"?"touchMove":e==="up"?"touchUp":e==="cancel"?"touchCancel":null;n||(console.error(S("touch","<down|move|up|cancel> <x> <y> [pointerId]")),process.exit(1)),e!=="cancel"&&(!Number.isFinite(t)||!Number.isFinite(s))&&(console.error(S("touch","<down|move|up|cancel> <x> <y> [pointerId]")),process.exit(1));let m=e==="down"?"tap":e==="move"?"move":null,p=m&&Number.isFinite(t)&&Number.isFinite(s)?`window.dispatchEvent(new CustomEvent('sootsim:agentAction', { detail: { type: '${m}', x: ${t}, y: ${s} } }));`:"",h=await l.send({type:"evaluate",code:`(async () => {
-            ${p}
-            const interact = window.__sootsimInteract
-            if (!interact?.${n}) return { ok: false, reason: 'no interact.${n}' }
-            const value = ${e==="cancel"?`await interact.${n}(${Math.max(1,Math.round(r))})`:`await interact.${n}(${t}, ${s}, ${Math.max(1,Math.round(r))})`}
-            return { ok: !!value, value }
-          })()`});h?.ok&&e!=="cancel"&&await L("inspect touch",{tapAtCoords:{x:t,y:s}},`touch ${e} @${t},${s}`),console.log(JSON.stringify(h,null,2));break}case"gesture":{let e=a[1],t=a[2]?Number(a[2]):220;(!e||!Number.isFinite(t))&&(console.error(S("gesture","<preset> [durationMs]")),process.exit(1));let s=await l.send({type:"evaluate",code:`(async () => {
-            const spec = globalThis.__sootsimDeviceSpec || {}
-            return {
-              width: spec.width || window.innerWidth || 393,
-              height: spec.height || window.innerHeight || 852,
-              statusBarHeight: spec.statusBarHeight || 0,
-              homeIndicatorHeight: spec.homeIndicatorHeight || 0,
-            }
-          })()`}),r=Number(s?.width)||393,n=Number(s?.height)||852,m=Number(s?.statusBarHeight)||0,p=Number(s?.homeIndicatorHeight)||0,h=Math.round(r/2),f=Math.round(n/2),w=Math.max(24,m+18),O=Math.max(24,p+18),B=18,N=Math.min(220,Math.round(n*.24)),M=Math.min(180,Math.round(r*.32)),F=h,W=f,g=h,T=f;switch(e){case"scroll-up":W=f+Math.round(N/2),T=f-Math.round(N/2);break;case"scroll-down":W=f-Math.round(N/2),T=f+Math.round(N/2);break;case"scroll-left":F=h+Math.round(M/2),g=h-Math.round(M/2);break;case"scroll-right":F=h-Math.round(M/2),g=h+Math.round(M/2);break;case"swipe-from-left-edge":F=B,W=f,g=Math.min(r-B,B+M);break;case"swipe-from-right-edge":F=r-B,W=f,g=Math.max(B,r-B-M);break;case"swipe-from-top-edge":F=h,W=w,T=Math.min(n-O,w+N);break;case"swipe-from-bottom-edge":F=h,W=n-O,T=Math.max(w,n-O-N);break;default:console.error(`  unknown gesture preset: ${e}`),process.exit(1)}let _=Math.max(8,Math.round(t/16)),P=Math.max(1,Math.round(t/_)),re=await l.send({type:"evaluate",code:`(async () => {
-            const interact = window.__sootsimInteract
-            if (!interact?.drag) return { ok: false, reason: 'no interact.drag' }
-            const value = await interact.drag(${F}, ${W}, ${g}, ${T}, ${_}, ${P})
-            return { ok: !!value, value }
-          })()`});re?.ok&&await L("inspect gesture",{swipe:{start:`${F}, ${W}`,end:`${g}, ${T}`,duration:Math.max(1,Math.round(t))}},`gesture ${e}`),console.log(JSON.stringify({preset:e,from:{x:F,y:W},to:{x:g,y:T},result:re},null,2));break}case"scroll":{let e=se(o),t=e?.mode==="testid"?e.value:a[1],s=Number(a[e?1:2]),r=Number(a[e?2:3]);(!t||!Number.isFinite(s)||!Number.isFinite(r))&&(console.error(S("scroll","<id> <dx> <dy> | --testid <id> <dx> <dy>")),process.exit(1));let n=await l.send({type:"evaluate",code:`(async () => {
-            const t = window.__sootsimTest
-            if (!t) return null
-            const n = await t.findByTestId(${JSON.stringify(t)})
-              || await t.findById(${JSON.stringify(t)})
-            if (!n || !n.absolutePosition || !n.layout) return null
-            return {
-              cx: n.absolutePosition.x + (n.layout.width || 0) / 2,
-              cy: n.absolutePosition.y + (n.layout.height || 0) / 2,
-            }
-          })()`}),m=await z(l,"scrollTo",t,s,r,!1);m?.ok&&await L("inspect scroll",{scrollTo:{id:t,x:s,y:r}},`scroll ${t} -> ${s},${r}`),console.log(JSON.stringify({...m,...n?{at:{x:n.cx,y:n.cy}}:{}},null,2));break}case"state":{let e=a[1];if(i==="get"&&!e){let s=await z(l,"getSessionState"),r=await l.send({type:"evaluate",code:`({
-              errors: window.__sootsimConsole?.getErrors?.()?.length ?? 0,
-              warnings: window.__sootsimConsole?.getWarnings?.()?.length ?? 0,
-            })`});s&&typeof s=="object"&&s.diagnostics&&(s.diagnostics.errors=r?.errors??0,s.diagnostics.warnings=r?.warnings??0),console.log(JSON.stringify(s,null,2));break}if(!e||e==="--help"||e==="-h"){console.log(`
-  ${y("state")} \u2014 dump raw runtime state
-
-  subcommands:
-    shell               dump shell transition/layout state
-    worker              dump render-worker host/animation state
-    keyboard            dump keyboard visibility, mode, and focused input
-    ownership           dump surface ownership + pointerOnSurface delivery stats
-    node <id>           dump raw node info by id or testID
-    scroll <id>         dump scroll metrics and runtime state
-    scroll-hit <x> <y>  dump the nearest scroll ancestor at coordinates
-    hit <x> <y>         dump the hit-test ancestry at coordinates
-    gesture <x> <y>     dump gesture routing/debug info at coordinates
-
-  examples:
-    ${y("state")} shell
-    ${y("state")} worker
-    ${y("state")} keyboard
-    ${y("state")} ownership
-    ${y("state")} node photos
-    ${y("state")} scroll feed
-    ${y("state")} scroll-hit 360 420
-    ${y("state")} hit 200 720
-`);break}let t;switch(e){case"shell":t=await V(l,500);break;case"worker":t=await ve(l,"__sootsimRenderHost.queryStats");break;case"ownership":t=await l.send({type:"evaluate",code:`(() => {
-                const h = window.__sootsimRenderHost
-                if (!h || typeof h.getOwnershipSnapshot !== 'function') {
-                  return { error: 'getOwnershipSnapshot not available' }
-                }
-                return h.getOwnershipSnapshot()
-              })()`});break;case"keyboard":t=await l.send({type:"evaluate",code:`(async () => {
-                const kb = window.__sootsimKeyboard
-                const test = window.__sootsimTest
-                if (!kb) return { error: 'keyboard bridge not available' }
-                const layout = typeof kb.getLayout === 'function' ? kb.getLayout() : null
-                const visible = kb.isVisible()
-                const mode = kb.getMode()
-                let focused = null
-                if (test && typeof test.getFocusedNode === 'function') {
-                  try {
-                    focused = await test.getFocusedNode()
-                  } catch {}
-                }
-                return {
-                  visible,
-                  mode,
-                  layout,
-                  focusedInput: focused ? {
-                    nodeId: focused.nodeId ?? null,
-                    testID: focused.testID || null,
-                    id: focused.id || null,
-                    placeholder: focused.placeholder || null,
-                    text: focused.text || null,
-                  } : null,
-                }
-              })()`});break;case"node":{let s=a[2];s||(console.error(`  usage: ${y("state")} node <id>`),process.exit(1)),t=await z(l,"findByTestId",s)||await z(l,"findById",s);break}case"scroll":{let s=a[2];s||(console.error(`  usage: ${y("state")} scroll <id>`),process.exit(1)),t=await z(l,"getScrollState",s);break}case"scroll-hit":{let s=Number(a[2]),r=Number(a[3]);(!Number.isFinite(s)||!Number.isFinite(r))&&(console.error(`  usage: ${y("state")} scroll-hit <x> <y>`),process.exit(1)),t=await z(l,"getScrollStateAt",s,r);break}case"hit":{let s=Number(a[2]),r=Number(a[3]);(!Number.isFinite(s)||!Number.isFinite(r))&&(console.error(`  usage: ${y("state")} hit <x> <y>`),process.exit(1)),t=await z(l,"debugHitAt",s,r);break}case"gesture":{let s=Number(a[2]),r=Number(a[3]);(!Number.isFinite(s)||!Number.isFinite(r))&&(console.error(`  usage: ${y("state")} gesture <x> <y>`),process.exit(1)),t=await z(l,"debugGestureAt",s,r);break}default:console.error(`  unknown state subcommand: ${e}`),process.exit(1)}console.log(JSON.stringify(t,null,2));break}case"shell":{let e=a[1];if(!e||e==="--help"||e==="-h"){console.log(`
-  ${y("shell")} \u2014 run built-in shell commands
-
-  subcommands:
-    launch <appId> [waitMs] [--clear-state]
-                               launch app and wait for settled shell state
-    home [waitMs]              go home and wait for settled shell state
-    switcher [waitMs]          open switcher and wait for settled shell state
-    open-card <appId> [waitMs]
-                               open a specific switcher card and wait for app settle
-    appearance <light|dark|auto|toggle>
-                               update simulator appearance
-    lock                       toggle device lock state
-    shake                      trigger the simulator shake gesture
-
-  examples:
-    ${y("shell")} launch photos
-    ${y("shell")} launch rn --clear-state
-    ${y("shell")} launch photos 1500
-    ${y("shell")} home 500
-    ${y("shell")} switcher 800
-    ${y("shell")} open-card clock 800
-    ${y("shell")} appearance dark
-    ${y("shell")} lock
-`);break}let t=e==="launch"||e==="open-card"||e==="home"||e==="switcher",s=e==="launch"||e==="open-card"?a[3]:a[2],r=s?Number(s):350;t&&(!Number.isFinite(r)||r<0)&&(console.error(S("shell",e==="launch"||e==="open-card"?"<launch|open-card> <appId> [settleMs]":"<home|switcher> [settleMs]")),process.exit(1));let n=!1,m=!1,p=null,h=o.includes("--clear-state");if(e==="launch"){let f=a[2];f||(console.error(S("shell","launch <appId> [settleMs] [--clear-state]")),process.exit(1)),h&&await l.send({type:"evaluate",code:Te}),n=!!await te(l,"launchApp",r,f),{settled:m,state:p}=await de(l,Math.round(r),w=>!!w&&w.state==="app"&&w.activeApp===f&&w.showSwitcher===!1&&w.switcherPhase==="idle"&&typeof w.launchProgress=="number"&&w.launchProgress>=.98),n&&await L("inspect shell launch",h?{launchApp:{clearState:!0}}:{launchApp:{}},h?"launch app (clear state)":"launch app")}else if(e==="home")n=!!await te(l,"goHome",r),{settled:m,state:p}=await de(l,Math.round(r),f=>!!f&&f.state==="home"&&f.activeApp==null&&f.showSwitcher===!1&&f.switcherPhase==="idle"&&typeof f.launchProgress=="number"&&f.launchProgress>=.98);else if(e==="switcher")n=!!await te(l,"openSwitcher",r),{settled:m,state:p}=await de(l,Math.round(r),f=>!!f&&f.state==="app"&&f.showSwitcher===!0&&f.switcherPhase==="idle"&&typeof f.zoomLevel=="number"&&Math.abs(f.zoomLevel)<=.02&&typeof f.horizontalZoom=="number"&&Math.abs(f.horizontalZoom)<=.02),m&&(await Y(Ot),p=await V(l));else if(e==="open-card"){let f=a[2];f||(console.error(S("shell","open-card <appId> [settleMs]")),process.exit(1)),n=!!await te(l,"openSwitcherCard",r,f),{settled:m,state:p}=await de(l,Math.round(r),w=>!!w&&w.state==="app"&&w.activeApp===f&&w.showSwitcher===!1&&w.switcherPhase==="idle"&&typeof w.zoomLevel=="number"&&w.zoomLevel>=.98&&typeof w.horizontalZoom=="number"&&w.horizontalZoom>=.98),n&&await L("inspect shell open-card",{openSwitcherCard:{appId:f}},`open switcher card ${f}`)}else if(e==="appearance"){let f=a[2];(!f||!["light","dark","auto","toggle"].includes(f))&&(console.error(S("shell","appearance <light|dark|auto|toggle>")),process.exit(1));let w=await ot(l,"appearance",f);n=!!w?.ok,p={appearance:w}}else if(e==="lock"||e==="shake"){let f=await ot(l,e);n=!!f?.ok,p={[e]:f}}else console.error(`  unknown shell subcommand: ${e}`),process.exit(1);console.log(JSON.stringify({ok:n,settled:m,state:p},null,2));break}case"url":{await Ue(l,{args:d});break}case"reload":{let s=!1,r=!1;try{await l.send({type:"evaluate",code:"window.__sootsimConsole?.clear()"});let p=await l.send({type:"evaluate",code:`;(() => {
-              const reloadExternalApp = window.SootSim?.bridges?.hotRemount?.reloadExternalApp
-              if (typeof reloadExternalApp === 'function') {
-                reloadExternalApp()
-                return { kind: 'external-app' }
-              }
-              window.location.reload()
-              return { kind: 'page' }
-            })()`});r=!!p&&p.kind==="external-app",s=!0}catch{}console.log("  reloading...");let n=l,m=null;if(r)m=await fe(l,{timeoutMs:1e4,errorGraceMs:3e3});else{s&&await Y(300);let p=await Fe(A,j,v,{timeoutMs:1e4});p?(n=p,m=await fe(p,{timeoutMs:1e4,errorGraceMs:3e3})):(console.log("  \u26A0 reload: bridge never reconnected within 10000ms"),n=null)}if(m)if(m.ready){let p=m.source==="nodes-fallback"?" (no ready signal, node-count fallback)":"";console.log(`  ready in ${m.elapsedMs}ms: ${m.nodes} nodes${p}`)}else m.source==="error-bail"?console.log(`  \u26A0 reload bailed after ${m.elapsedMs}ms: ${m.errors} console error(s), ready signal never fired`):console.log(`  \u26A0 reload timed out after ${m.elapsedMs}ms (${m.nodes} nodes, ${m.errors} errors)`);if(n)try{let p=await n.send({type:"evaluate",code:"window.__sootsimConsole?.getErrors(10) || []"});if(n!==l&&n.close(),Array.isArray(p)&&p.length>0){console.log(`
-  \u26A0 ${p.length} error(s) during mount:
-`);for(let h of p){let f=h.args.map(w=>typeof w=="object"?JSON.stringify(w):w).join(" ");if(console.log(`    ${f}`),h.stack){let w=h.stack.split(`
-`).slice(0,2);for(let O of w)console.log(`      ${O.trim()}`)}}}}catch{}m&&!m.ready&&(process.exitCode=1);break}case"eval":case"js":{let e=a.slice(1).join(" ");e||(console.error(S("js","<javascript>")),console.error(""),console.error("  runs the snippet in the engine realm. SootSim is the"),console.error("  canonical state surface \u2014 reach into it directly."),console.error(""),console.error("  examples:"),console.error(`    ${y("js")} SootSim.bridges.test.findByText("Sign in")`),console.error(`    ${y("js")} SootSim.bridges.debug.snapshot("before")`),console.error(`    ${y("js")} SootSim.bridges.keyboard.type("hello")`),console.error(`    ${y("js")} SootSim.state.root.children.length`),process.exit(1));let t=e;t.startsWith("(async")||(t=`(async () => ${t})()`);let s=await l.send({type:"evaluate",code:t});console.log(JSON.stringify(s,null,2));let r=e.toLowerCase(),n=[];(r.includes("sootsim:gohome")||r.includes("gohome"))&&n.push("sootsim shell home"),(r.includes("sootsim:appswitcher")||r.includes("appswitcher"))&&n.push("sootsim shell switcher"),(r.includes("keyboard.isvisible")||r.includes("keyboard.getmode"))&&n.push("sootsim debug state keyboard"),r.includes("interact.tap")&&n.push("sootsim do tap <x> <y>"),r.includes("keyboard.type")&&n.push("sootsim do type <text>"),(r.includes("keyboard.press")||r.includes("keyboard.dispatchkey"))&&n.push("sootsim do key <name>"),r.includes("keyboard.dismiss")&&n.push("sootsim do dismiss"),r.includes("dumptree")&&n.push("sootsim get tree"),r.includes("dumpaccessibilitytree")&&n.push("sootsim get a11y"),r.includes("getnodecount")&&n.push("sootsim get count"),r.includes("findbytext")&&n.push("sootsim find <text>"),(r.includes("findbytestid")||r.includes("findbyid"))&&n.push("sootsim find --testid <id>"),r.includes("document.hidden")&&n.push("sootsim debug state keyboard  (includes tab health)"),n.length>0&&U("prefer-cli-over-eval",n);break}case"globals":{let e=await l.send({type:"evaluate",code:`(async () => {
-            const globals = {}
-
-            // test bridge (proxy in worker mode)
-            const testMethods = [
-              'findById', 'findByTestId', 'findByText', 'findByLabel', 'findByRole',
-              'findAllByRole', 'findByA11yState', 'findAllByA11yState', 'findByHint',
-              'findPressable', 'getStyle', 'getLayout', 'getAbsolutePosition', 'isVisible',
-              'queryAll', 'dumpTree', 'dumpAccessibilityTree', 'getNodeCount', 'getShellState',
-              'getScrollState', 'getScrollStateAt', 'scrollTo', 'waitForTree',
-              'waitForScreenTransitions', 'debugByText', 'debugByTestId', 'debugHitAt',
-              'debugGestureAt'
-            ]
-            globals['test (\u2192 __sootsimTest)'] = testMethods
-
-            // debug
-            if (window.__sootsimDebug) {
-              globals['debug (\u2192 __sootsimDebug)'] = Object.keys(window.__sootsimDebug)
-            }
-
-            // interact
-            if (window.__sootsimInteract) {
-              globals['interact (\u2192 __sootsimInteract)'] = Object.keys(window.__sootsimInteract)
-            }
-
-            // keyboard
-            if (window.__sootsimKeyboard) {
-              globals['keyboard (\u2192 __sootsimKeyboard)'] = Object.keys(window.__sootsimKeyboard)
-            }
-
-            // other globals
-            globals['other'] = [
-              'root (\u2192 __sootsimRoot) - live node tree',
-              'render() (\u2192 __sootsimForceRender) - force re-render'
-            ]
-
-            return globals
-          })()`});console.log(`  sootsim JS API:
-`);for(let[t,s]of Object.entries(e)){console.log(`  ${t}:`);for(let r of s)console.log(`    .${r}`);console.log("")}console.log(`  use: ${y("js")} <expression>`),console.log(`  example: ${y("js")} test.findByText("Sign in")`);break}case"describe":{await Ce({bridge:l,args:o,positional:a});break}case"perf":{let e=a[1];if(!e||e==="--help"||e==="-h"){console.log(`
-  ${y("perf")} \u2014 performance profiling
-
-  subcommands:
-    stats           one-shot stats (zero overhead query)
-    start           begin recording frame times
-    stop            stop recording and report results
-    frames [n]      get last N frame times (default: 50)
-    transition <e>  profile a shell transition (goHome, appSwitcher, lockScreen)
-
-  examples:
-    ${y("perf")} stats
-    ${y("perf")} start
-    # ... interact with the app ...
-    ${y("perf")} stop
-    ${y("perf")} transition goHome
-`);break}switch(e){case"stats":{let t=await l.send({type:"evaluate",code:`(async () => {
-                // worker mode (host exposes these)
-                if (window.__sootsimPerfStats) {
-                  return await window.__sootsimPerfStats()
-                }
-                // main-thread mode
-                const perf = window.__sootsimPerf
-                const a11y = window.__sootsimA11y
-                if (!perf && !a11y) return { error: 'no perf globals available' }
-
-                const frameStats = perf?.getFrameStats?.() || {}
-                const profile = a11y?.profile?.() || {}
-                const nodeCount = await window.__sootsimTest?.getNodeCount?.() || 0
-
-                return {
-                  frames: frameStats.frames || profile.syncCount || 0,
-                  avgMs: frameStats.totalMs && frameStats.frames
-                    ? (frameStats.totalMs / frameStats.frames).toFixed(2)
-                    : profile.avgSyncMs?.toFixed(2) || '?',
-                  maxMs: frameStats.maxMs?.toFixed(2) || profile.maxSyncMs?.toFixed(2) || '?',
-                  layoutMs: frameStats.layoutTotalMs?.toFixed(2) || '?',
-                  nodeCount,
-                  jankFrames: frameStats.recentFrames?.filter(f => f > 16.67).length || 0,
-                  recentCount: frameStats.recentFrames?.length || 0,
-                }
-              })()`});t.error&&(console.error(`  error: ${t.error}`),process.exit(1));let s=t.avgMs!=="?"?(1e3/parseFloat(t.avgMs)).toFixed(1):"?";console.log("  perf stats:"),console.log(`    frames:     ${t.frames}`),console.log(`    avg:        ${t.avgMs}ms (${s} fps)`),console.log(`    max:        ${t.maxMs}ms`),console.log(`    layout:     ${t.layoutMs}ms total`),console.log(`    nodes:      ${t.nodeCount}`),t.recentCount>0&&console.log(`    jank:       ${t.jankFrames}/${t.recentCount} frames >16.67ms`);break}case"start":{await l.send({type:"evaluate",code:`(async () => {
-                // worker mode
-                if (window.__sootsimPerfStart && window.__sootsimRenderHost) {
-                  const result = window.__sootsimPerfStart()
-                  window.${G} = {
-                    active: true,
-                    mode: 'render-worker',
-                    lastSamples: [],
-                    startedAt: performance.now(),
-                  }
-                  return result
-                }
-                // main-thread mode
-                window.__sootsimPerf?.enableFrameStats?.(true)
-                window.__sootsimA11y?.resetProfile?.()
-                window.${G} = {
-                  active: true,
-                  mode: 'main-thread',
-                  lastSamples: [],
-                  startedAt: performance.now(),
-                }
-                return { started: true }
-              })()`}),console.log(`  profiling started \u2014 interact with the app, then run '${y("perf")} stop'`);break}case"stop":{let t=await l.send({type:"evaluate",code:`(async () => {
-                // worker mode
-                if (window.__sootsimRenderHost) {
-                  const session = window.${G} || {}
-                  const priorSamples = session.active && Array.isArray(session.lastSamples)
-                    ? session.lastSamples
-                    : []
-                  const flushedSamples = await window.__sootsimRenderHost.flushSamples()
-                  const samples = priorSamples.concat(flushedSamples)
-                  window.${G} = {
-                    ...session,
-                    active: false,
-                    mode: 'render-worker',
-                    lastSamples: samples,
-                    stoppedAt: performance.now(),
-                  }
-
-                  const frameTimes = samples.map(sample => sample[1])
-                  const layoutTimes = samples.map(sample => sample[2])
-                  const renderTimes = samples.map(sample => sample[3])
-                  const copyTimes = samples.map(sample => sample[4])
-                  const auxTimes = samples.map(sample => sample[5] || 0)
-                  const otherTimes = samples.map(sample => sample[6] || 0)
-                  const sorted = [...frameTimes].sort((a, b) => a - b)
-                  const total = frameTimes.reduce((a, b) => a + b, 0)
-                  const avg = frameTimes.length > 0 ? total / frameTimes.length : 0
-                  const max = Math.max(...frameTimes, 0)
-                  const layoutTotal = layoutTimes.reduce((a, b) => a + b, 0)
-                  const renderTotal = renderTimes.reduce((a, b) => a + b, 0)
-                  const copyTotal = copyTimes.reduce((a, b) => a + b, 0)
-                  const auxTotal = auxTimes.reduce((a, b) => a + b, 0)
-                  const otherTotal = otherTimes.reduce((a, b) => a + b, 0)
-
-                  return {
-                    mode: 'render-worker',
-                    frames: frameTimes.length,
-                    totalMs: total,
-                    avgMs: avg,
-                    maxMs: max,
-                    layoutTotalMs: layoutTotal,
-                    renderTotalMs: renderTotal,
-                    copyTotalMs: copyTotal,
-                    auxTotalMs: auxTotal,
-                    otherTotalMs: otherTotal,
-                    layoutAvgMs: frameTimes.length > 0 ? layoutTotal / frameTimes.length : 0,
-                    renderAvgMs: frameTimes.length > 0 ? renderTotal / frameTimes.length : 0,
-                    copyAvgMs: frameTimes.length > 0 ? copyTotal / frameTimes.length : 0,
-                    auxAvgMs: frameTimes.length > 0 ? auxTotal / frameTimes.length : 0,
-                    otherAvgMs: frameTimes.length > 0 ? otherTotal / frameTimes.length : 0,
-                    p50: sorted[Math.floor(sorted.length * 0.5)] || 0,
-                    p95: sorted[Math.floor(sorted.length * 0.95)] || 0,
-                    p99: sorted[Math.floor(sorted.length * 0.99)] || 0,
-                    jankFrames: frameTimes.filter((f) => f > 16.67).length,
-                    sampleCount: frameTimes.length,
-                  }
-                }
-                // main-thread mode
-                const perf = window.__sootsimPerf
-                const a11y = window.__sootsimA11y
-                if (!perf && !a11y) return { error: 'no perf globals' }
-
-                const frameStats = perf?.getFrameStats?.() || {}
-                const profile = a11y?.profile?.() || {}
-
-                // calculate distribution
-                const recent = frameStats.recentFrames || []
-                const sorted = [...recent].sort((a, b) => a - b)
-                const p50 = sorted[Math.floor(sorted.length * 0.5)] || 0
-                const p95 = sorted[Math.floor(sorted.length * 0.95)] || 0
-                const p99 = sorted[Math.floor(sorted.length * 0.99)] || 0
-
-                // disable collection
-                perf?.disableFrameStats?.()
-                window.${G} = {
-                  ...(window.${G} || {}),
-                  active: false,
-                  mode: 'main-thread',
-                  lastSamples: recent.map((ms, index) => [index, ms, 0, 0, 0, 0, 0]),
-                  stoppedAt: performance.now(),
-                }
-
-                return {
-                  mode: 'main-thread',
-                  frames: frameStats.frames || profile.syncCount || 0,
-                  totalMs: frameStats.totalMs || 0,
-                  avgMs: frameStats.totalMs && frameStats.frames
-                    ? frameStats.totalMs / frameStats.frames
-                    : profile.avgSyncMs || 0,
-                  maxMs: frameStats.maxMs || profile.maxSyncMs || 0,
-                  layoutTotalMs: frameStats.layoutTotalMs || 0,
-                  p50, p95, p99,
-                  jankFrames: recent.filter(f => f > 16.67).length,
-                  sampleCount: recent.length,
-                }
-              })()`});t.error&&(console.error(`  error: ${t.error}`),process.exit(1));let s=t.avgMs>0?(1e3/t.avgMs).toFixed(1):"?",r=t.sampleCount>0?(t.jankFrames/t.sampleCount*100).toFixed(1):"0";console.log(`  profiling stopped:
-`),console.log(`    frames:     ${t.frames}`),console.log(`    total:      ${t.totalMs.toFixed(1)}ms`),console.log(`    avg:        ${t.avgMs.toFixed(2)}ms (${s} fps)`),console.log(`    max:        ${t.maxMs.toFixed(2)}ms`),console.log(""),t.layoutAvgMs!==void 0&&(console.log("    breakdown (avg per frame):"),console.log(`      layout:   ${t.layoutAvgMs.toFixed(2)}ms`),console.log(`      render:   ${t.renderAvgMs.toFixed(2)}ms`),console.log(`      copy:     ${t.copyAvgMs.toFixed(2)}ms`),t.auxAvgMs!==void 0&&console.log(`      aux:      ${t.auxAvgMs.toFixed(2)}ms`),t.otherAvgMs!==void 0&&console.log(`      other:    ${t.otherAvgMs.toFixed(2)}ms`),console.log("")),console.log(`    distribution (${t.sampleCount} samples):`),console.log(`      p50:      ${t.p50.toFixed(2)}ms`),console.log(`      p95:      ${t.p95.toFixed(2)}ms`),console.log(`      p99:      ${t.p99.toFixed(2)}ms`),console.log(`      jank:     ${t.jankFrames} frames (${r}%) >16.67ms`);break}case"frames":{let t=a[2]?Number(a[2]):50;(!Number.isFinite(t)||t<=0)&&(console.error(`  error: expected a positive frame count, got "${a[2]}"`),process.exit(1));let s=await l.send({type:"evaluate",code:`(async () => {
-                if (window.__sootsimRenderHost) {
-                  const session = window.${G} || {}
-                  if (session.active) {
-                    const priorSamples = Array.isArray(session.lastSamples) ? session.lastSamples : []
-                    const flushedSamples = await window.__sootsimRenderHost.flushSamples()
-                    const samples = priorSamples.concat(flushedSamples)
-                    window.__sootsimRenderHost.startSampling()
-                    window.${G} = {
-                      ...session,
-                      active: true,
-                      mode: 'render-worker',
-                      lastSamples: samples,
-                      lastFlushAt: performance.now(),
-                    }
-                    return {
-                      mode: 'render-worker',
-                      live: true,
-                      samples: samples.slice(-${t}),
-                    }
-                  }
-                  return {
-                    mode: 'render-worker',
-                    live: false,
-                    samples: (session.lastSamples || []).slice(-${t}),
-                  }
-                }
-                // main-thread mode
-                const perf = window.__sootsimPerf
-                if (!perf) return { error: 'no __sootsimPerf (try "perf start" first)' }
-                const stats = perf.getFrameStats?.() || {}
-                return {
-                  mode: 'main-thread',
-                  frames: (stats.recentFrames || []).slice(-${t}),
-                }
-              })()`});if(s.error&&(console.error(`  error: ${s.error}`),process.exit(1)),s.mode==="render-worker"){let n=Array.isArray(s.samples)?s.samples:[];if(n.length===0){console.log(`  no frame data \u2014 run '${y("perf")} start' first`);break}console.log(`  last ${n.length} sampled frames (ms):`),console.log("    total    layout   render   copy     aux    other     t+");for(let[m,p,h,f,w,O,B]of n)console.log(`    ${p.toFixed(2).padStart(7)}  ${h.toFixed(2).padStart(7)}  ${f.toFixed(2).padStart(7)}  ${w.toFixed(2).padStart(7)}  ${O.toFixed(2).padStart(6)}  ${B.toFixed(2).padStart(7)}  ${String(m).padStart(5)}`);console.log(""),be(n.map(m=>m[1])),s.live&&console.log("  sampling continues");break}let r=Array.isArray(s.frames)?s.frames:Array.isArray(s)?s:[];if(r.length===0){console.log(`  no frame data \u2014 run '${y("perf")} start' first`);break}console.log(`  last ${r.length} frame times (ms):`),console.log(`    ${r.map(n=>n.toFixed(2)).join(", ")}`),be(r);break}case"worst":{let t=a[2]?Number(a[2]):20;(!Number.isFinite(t)||t<=0)&&(console.error(`  error: expected a positive frame count, got "${a[2]}"`),process.exit(1));let s=await l.send({type:"evaluate",code:`(async () => {
-                if (window.__sootsimRenderHost) {
-                  const session = window.${G} || {}
-                  if (session.active) {
-                    const priorSamples = Array.isArray(session.lastSamples) ? session.lastSamples : []
-                    const flushedSamples = await window.__sootsimRenderHost.flushSamples()
-                    const samples = priorSamples.concat(flushedSamples)
-                    window.__sootsimRenderHost.startSampling()
-                    window.${G} = {
-                      ...session,
-                      active: true,
-                      mode: 'render-worker',
-                      lastSamples: samples,
-                      lastFlushAt: performance.now(),
-                    }
-                    return {
-                      mode: 'render-worker',
-                      live: true,
-                      samples: samples
-                        .slice()
-                        .sort((a, b) => b[1] - a[1])
-                        .slice(0, ${t}),
-                    }
-                  }
-                  const samples = Array.isArray(session.lastSamples) ? session.lastSamples : []
-                  return {
-                    mode: 'render-worker',
-                    live: false,
-                    samples: samples
-                      .slice()
-                      .sort((a, b) => b[1] - a[1])
-                      .slice(0, ${t}),
-                  }
-                }
-                const perf = window.__sootsimPerf
-                if (!perf) return { error: 'no __sootsimPerf (try "perf start" first)' }
-                const stats = perf.getFrameStats?.() || {}
-                const recent = Array.isArray(stats.recentFrames) ? stats.recentFrames : []
-                return {
-                  mode: 'main-thread',
-                  frames: recent.slice().sort((a, b) => b - a).slice(0, ${t}),
-                }
-              })()`});if(s.error&&(console.error(`  error: ${s.error}`),process.exit(1)),s.mode==="render-worker"){let n=Array.isArray(s.samples)?s.samples:[];if(n.length===0){console.log(`  no frame data \u2014 run '${y("perf")} start' first`);break}console.log(`  worst ${n.length} sampled frames (ms):`),console.log("    total    layout   render   copy     aux    other     t+");for(let[m,p,h,f,w,O,B]of n)console.log(`    ${p.toFixed(2).padStart(7)}  ${h.toFixed(2).padStart(7)}  ${f.toFixed(2).padStart(7)}  ${w.toFixed(2).padStart(7)}  ${O.toFixed(2).padStart(6)}  ${B.toFixed(2).padStart(7)}  ${String(m).padStart(5)}`);s.live&&(console.log(""),console.log("  sampling continues"));break}let r=Array.isArray(s.frames)?s.frames:Array.isArray(s)?s:[];if(r.length===0){console.log(`  no frame data \u2014 run '${y("perf")} start' first`);break}console.log(`  worst ${r.length} frame times (ms):`),console.log(`    ${r.map(n=>n.toFixed(2)).join(", ")}`);break}case"transition":{let t=a[2];if(!t||!["goHome","appSwitcher","lockScreen"].includes(t)){console.log(`
-  ${y("perf")} transition <event> \u2014 profile a shell transition
-
-  events:
-    goHome          swipe-to-home animation
-    appSwitcher     app switcher card animation
-    lockScreen      lock screen transition
-
-  note: uses 600ms capture window \u2014 may need --timeout 10000 flag
-
-  examples:
-    ${y("perf")} transition goHome --timeout 10000
-    ${y("perf")} transition appSwitcher
-`);break}let r=`sootsim:${t}`;console.log(`  profiling ${t} transition...`),console.log("  (use --timeout 10000 if this times out)");let n=await l.send({type:"evaluate",code:`(async () => {
-                // only supported in render-worker mode
-                if (!window.__sootsimRenderHost) {
-                  return { error: 'transition profiling requires render-worker mode' }
-                }
-
-                // start sampling
-                window.__sootsimRenderHost.startSampling()
-
-                // give a frame for sampling to start
-                await new Promise(r => requestAnimationFrame(() => r(undefined)))
-
-                // dispatch the shell event
-                window.dispatchEvent(new Event('${r}'))
-
-                // wait 600ms for transition to complete (shell animations are ~300-500ms)
-                // using fixed timing avoids complex animation-end detection
-                await new Promise(r => setTimeout(r, 600))
-
-                // flush samples and compute stats
-                const samples = await window.__sootsimRenderHost.flushSamples()
-                const frameTimes = samples.map(s => s[1])
-                const layoutTimes = samples.map(s => s[2])
-                const renderTimes = samples.map(s => s[3])
-                const copyTimes = samples.map(s => s[4])
-                const auxTimes = samples.map(s => s[5] || 0)
-                const otherTimes = samples.map(s => s[6] || 0)
-                const sorted = [...frameTimes].sort((a, b) => a - b)
-                const total = frameTimes.reduce((a, b) => a + b, 0)
-                const avg = frameTimes.length > 0 ? total / frameTimes.length : 0
-                const max = Math.max(...frameTimes, 0)
-                const layoutTotal = layoutTimes.reduce((a, b) => a + b, 0)
-                const renderTotal = renderTimes.reduce((a, b) => a + b, 0)
-                const copyTotal = copyTimes.reduce((a, b) => a + b, 0)
-                const auxTotal = auxTimes.reduce((a, b) => a + b, 0)
-                const otherTotal = otherTimes.reduce((a, b) => a + b, 0)
-
-                return {
-                  event: '${t}',
-                  frames: frameTimes.length,
-                  totalMs: total,
-                  avgMs: avg,
-                  maxMs: max,
-                  layoutTotalMs: layoutTotal,
-                  renderTotalMs: renderTotal,
-                  copyTotalMs: copyTotal,
-                  auxTotalMs: auxTotal,
-                  otherTotalMs: otherTotal,
-                  layoutAvgMs: frameTimes.length > 0 ? layoutTotal / frameTimes.length : 0,
-                  renderAvgMs: frameTimes.length > 0 ? renderTotal / frameTimes.length : 0,
-                  copyAvgMs: frameTimes.length > 0 ? copyTotal / frameTimes.length : 0,
-                  auxAvgMs: frameTimes.length > 0 ? auxTotal / frameTimes.length : 0,
-                  otherAvgMs: frameTimes.length > 0 ? otherTotal / frameTimes.length : 0,
-                  p50: sorted[Math.floor(sorted.length * 0.5)] || 0,
-                  p95: sorted[Math.floor(sorted.length * 0.95)] || 0,
-                  p99: sorted[Math.floor(sorted.length * 0.99)] || 0,
-                  jankFrames: frameTimes.filter(f => f > 16.67).length,
-                  samples,
-                }
-              })()`});if(n.error&&(console.error(`  error: ${n.error}`),process.exit(1)),n.warning&&console.log(`  warning: ${n.warning}`),n.frames===0){console.log("  no frames captured");break}let m=n.avgMs>0?(1e3/n.avgMs).toFixed(1):"?",p=n.frames>0?(n.jankFrames/n.frames*100).toFixed(1):"0";console.log(`  ${t} transition profiled:
-
-    frames:     ${n.frames}
-    total:      ${n.totalMs.toFixed(1)}ms
-    avg:        ${n.avgMs.toFixed(2)}ms (${m} fps)
-    max:        ${n.maxMs.toFixed(2)}ms
-
-    breakdown (avg per frame):
-      layout:   ${n.layoutAvgMs?.toFixed(2)||"?"}ms
-      render:   ${n.renderAvgMs?.toFixed(2)||"?"}ms
-      copy:     ${n.copyAvgMs?.toFixed(2)||"?"}ms
-      aux:      ${n.auxAvgMs?.toFixed(2)||"?"}ms
-      other:    ${n.otherAvgMs?.toFixed(2)||"?"}ms
-
-    distribution (${n.frames} samples):
-      p50:      ${n.p50.toFixed(2)}ms
-      p95:      ${n.p95.toFixed(2)}ms
-      p99:      ${n.p99.toFixed(2)}ms
-      jank:     ${n.jankFrames} frames (${p}%) >16.67ms`),Array.isArray(n.samples)&&n.samples.length>0&&(console.log(""),be(n.samples.map(h=>h[1])));break}default:console.error(`  unknown perf subcommand: ${e}`),process.exit(1)}break}case"errors":{let e=a[1];if(e==="clear"){await l.send({type:"evaluate",code:'window.__sootsimConsole?.clear(); "cleared"'}),E(d)?C({cleared:!0}):console.log("  error buffer cleared");break}let t=e?Number(e):20,s=await l.send({type:"evaluate",code:`window.__sootsimConsole?.getErrors(${t}) || []`}),r=Array.isArray(s)?s:[];if(E(d)){C(r);break}if(r.length===0){console.log("  no errors captured");break}console.log(`  ${r.length} error(s):
-`);for(let n of r){let m=new Date(n.timestamp).toLocaleTimeString(),p=n.args.map(h=>typeof h=="object"?JSON.stringify(h):h).join(" ");if(console.log(`  [${m}] ${p}`),n.stack){let h=n.stack.split(`
-`).slice(0,3);for(let f of h)console.log(`    ${f.trim()}`)}}break}case"warnings":{let e=a[1]?Number(a[1]):20,t=await l.send({type:"evaluate",code:`window.__sootsimConsole?.getWarnings(${e}) || []`}),s=Array.isArray(t)?t:[];if(E(d)){C(s);break}if(s.length===0){console.log("  no warnings captured");break}console.log(`  ${s.length} warning(s):
-`);for(let r of s){let n=new Date(r.timestamp).toLocaleTimeString(),m=r.args.map(p=>typeof p=="object"?JSON.stringify(p):p).join(" ");console.log(`  [${n}] ${m}`)}break}case"animations":{let e=await z(l,"listAnimations")??[];if(o.includes("--json")){console.log(JSON.stringify(e,null,2));break}if(e.length===0){console.log("  no active animations");break}console.log(`  ${e.length} active animation(s):
-`);for(let t of e){let s=String(t.kind).padEnd(6),r=`${Number(t.from).toFixed(2)}\u2192${Number(t.to).toFixed(2)}`,n=Number(t.current??0).toFixed(2),m=`${Math.round((t.progress??0)*100)}%`,p=`${Math.round(t.elapsedMs??0)}ms`,h=t.loop?" loop":"",f=t.layoutBound?" layout":"";console.log(`  #${t.id}  ${s} ${r.padEnd(14)} cur=${n.padEnd(7)} ${m.padStart(4)}  ${p}${h}${f}`)}break}case"animation":{let e=a[1];(!e||e==="--help"||e==="-h")&&(console.error(`  usage: ${y("animation")} <id>`),process.exit(1));let t=Number(e);Number.isFinite(t)||(console.error(`  invalid id: ${e}`),process.exit(1));let s=await z(l,"getAnimation",t);console.log(JSON.stringify(s,null,2));break}case"stop-animation":{let e=a[1];(!e||e==="--help"||e==="-h")&&(console.error(`  usage: ${y("stop-animation")} <id|all>`),process.exit(1));let t=e==="all"?"all":Number(e);t!=="all"&&!Number.isFinite(t)&&(console.error(`  invalid id: ${e}`),process.exit(1));let s=await z(l,"stopAnimation",t);console.log(`  stopped ${s??0} animation(s)`);break}case"requests":{let e=a[1];if(e==="clear"){await z(l,"clearRequests"),E(d)?C({cleared:!0}):console.log("  request buffer cleared");break}let t=e==="all",s=t?a[2]:e,r=s?Number(s):20,n=t?await z(l,"getRequests",r):await z(l,"getFailedRequests",r),m=Array.isArray(n)?n:[];if(E(d)){C(m);break}if(m.length===0){console.log(t?"  no requests captured":"  no failed requests captured");break}console.log(`  ${m.length} ${t?"request(s)":"failed request(s)"}:
-`);for(let p of m){let h=new Date(p.timestamp).toLocaleTimeString();console.log(`  [${h}] ${q(p)}`),p.responseBody?console.log(`    ${p.responseBody}`):p.error&&console.log(`    ${p.error}`)}break}case"network":{let e=a[1],t=null,s=null,r=!1,n=!1,m=!1;for(let N=0;N<d.length;N++){let M=d[N];if(M==="--filter")t=d[N+1]??null,N++;else if(M==="--limit"){let F=Number(d[N+1]);Number.isFinite(F)&&(s=F),N++}else M==="--failed"?r=!0:M==="--tail"||M==="-f"?n=!0:M==="--json"&&(m=!0)}if(e==="clear"){await l.send({type:"evaluate",code:'window.__sootsimObservability?.network.clear(); "cleared"'}),console.log("  network buffer cleared");break}if(e==="get"){let N=a[2];N||(console.error("  usage: sootsim network get <id>"),process.exit(1));let M=await l.send({type:"evaluate",code:`(() => {
-              const obs = window.__sootsimObservability;
-              if (!obs) return null;
-              return obs.network.getSnapshot().find(e => e.id === ${JSON.stringify(N)}) || null;
-            })()`});M||(console.error(`  no entry with id ${N}`),process.exit(1)),m?console.log(JSON.stringify(M,null,2)):Ft(M);break}let p=s??(n?200:e?Number(e):20);Number.isFinite(p)||(console.error(`  invalid limit: ${e}`),process.exit(1));let h=async()=>{let N=await l.send({type:"evaluate",code:`(() => {
-              const obs = window.__sootsimObservability;
-              if (!obs) return { ok: false };
-              return { ok: true, entries: obs.network.getSnapshot() };
-            })()`});if(!N||!N.ok)throw new Error("observability bridge not installed \u2014 is the engine running?");return N.entries??[]},f=N=>{let M=N;if(r&&(M=M.filter(F=>!!F.error||F.status!=null&&F.status>=400)),t){let F=t.toLowerCase();M=M.filter(W=>(W.displayUrl||W.url).toLowerCase().includes(F))}return M};if(!n){let N=await h(),M=f(N).slice(-p);if(m){console.log(JSON.stringify(M,null,2));break}if(M.length===0){console.log(N.length===0?"  no network requests captured":"  no matching requests");break}console.log(`  ${M.length} request(s):
-`);for(let F of M)Ze(F);break}console.log(`  tailing network (ctrl-c to stop)...
-`);let w=new Set,O=!0,B=()=>{O=!1};process.on("SIGINT",B);try{for(;O;){let N=await h(),M=f(N);for(let F of M)F.durationMs!=null&&(w.has(F.id)||(w.add(F.id),m?console.log(JSON.stringify(F)):Ze(F)));await Y(250)}}finally{process.off("SIGINT",B)}break}case"logs":{let e=a[1],t=null,s=null,r=null,n=!1,m=!1,p=!1;for(let g=0;g<d.length;g++){let T=d[g];if(T==="--filter")t=d[g+1]??null,g++;else if(T==="--limit"){let _=Number(d[g+1]);Number.isFinite(_)&&(s=_),g++}else T==="--level"?(r=d[g+1]??null,g++):T==="--tail"||T==="-f"?n=!0:T==="--json"?m=!0:(T==="--internal"||T==="--all")&&(p=!0)}let h=r?new Set(r.split(",").map(g=>g.trim()).filter(g=>g==="log"||g==="info"||g==="warn"||g==="error"||g==="debug")):null;if(e==="clear"){await l.send({type:"evaluate",code:'window.__sootsimObservability?.logs.clear(); "cleared"'}),console.log("  log buffer cleared");break}let f=!m&&process.stdout.isTTY===!0,w=s??(n?500:e?Number(e):50);Number.isFinite(w)||(console.error(`  invalid limit: ${e}`),process.exit(1));let O=async()=>{let g=await l.send({type:"evaluate",code:`(() => {
-              const obs = window.__sootsimObservability;
-              if (!obs) return { ok: false };
-              return { ok: true, entries: obs.logs.getSnapshot() };
-            })()`});if(!g||!g.ok)throw new Error("observability bridge not installed \u2014 is the engine running?");return g.entries??[]},B=g=>{let T=g.args[0];return typeof T!="string"?!1:T.startsWith("[sootsim]")},N=g=>{let T=g;if(p||(T=T.filter(_=>!B(_))),h&&(T=T.filter(_=>h.has(_.level))),t){let _=t.toLowerCase();T=T.filter(P=>P.args.join(" ").toLowerCase().includes(_))}return T};if(!n){let g=await O(),T=N(g).slice(-w);if(m){console.log(JSON.stringify(T,null,2));break}if(T.length===0){console.log(g.length===0?"  no logs captured":"  no matching logs");break}console.log(`  ${T.length} log(s):
-`);for(let _ of T)et(_,f);break}console.log(`  tailing logs (ctrl-c to stop)...
-`);let M=new Set,F=!0,W=()=>{F=!1};process.on("SIGINT",W);try{for(;F;){let g=await O(),T=N(g);for(let _ of T)M.has(_.id)||(M.add(_.id),m?console.log(JSON.stringify(_)):et(_,f));await Y(250)}}finally{process.off("SIGINT",W)}break}default:console.error(`  unknown subcommand: ${b}`),process.exit(1)}if(H.has(b)&&!o.includes("--no-wait")&&process.env.SOOTSIM_NO_AUTO_WAIT!=="1"&&await ne(l),!D.has(b)&&!E(d)){let e=await Z();try{await J({counts:e.console})}catch{}try{await x({counts:e.requests})}catch{}}}catch(e){let t=e instanceof Error?e.message:String(e);if(console.error(`  ${b??"inspect"} failed: ${t}`),/^no browser connected( with id .+)?$/.test(t))Ae(A);else{try{await Me(l)}catch{}try{await J({includeTail:!0})}catch{}try{await x({includeTail:!0})}catch{}}process.exit(1)}finally{l.close()}}export{rs as runInspect};