sootsim 0.1.111 → 0.1.113

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (146) hide show
  1. package/dist-cli/bin.js +3 -3
  2. package/dist-cli/chunks/{agent-ZXHGIPSY.js → agent-3JTU2UL4.js} +2 -2
  3. package/dist-cli/chunks/{agent-wrapper-5EACYKWZ.js → agent-wrapper-CR7GJ7FP.js} +2 -2
  4. package/dist-cli/chunks/{assert-LDEGLMEF.js → assert-N2OG5JQ3.js} +2 -2
  5. package/dist-cli/chunks/auto-bootstrap-RUMSH2SU.js +2 -0
  6. package/dist-cli/chunks/beta-WAJQAPBI.js +2 -0
  7. package/dist-cli/chunks/{chunk-53MJ3O5G.js → chunk-2OGV4GCY.js} +1 -1
  8. package/dist-cli/chunks/{chunk-SKLP2DGB.js → chunk-2SXHMBEC.js} +1 -1
  9. package/dist-cli/chunks/{chunk-JMD73BNN.js → chunk-3EQEJK4E.js} +2 -2
  10. package/dist-cli/chunks/chunk-3J3AQWIW.js +1 -0
  11. package/dist-cli/chunks/{chunk-67OJIOOH.js → chunk-3MBITUPW.js} +1 -1
  12. package/dist-cli/chunks/{chunk-ENWSR3JU.js → chunk-3OUCFCUV.js} +2 -2
  13. package/dist-cli/chunks/{chunk-4PBNEPVZ.js → chunk-4IA3F7NN.js} +2 -2
  14. package/dist-cli/chunks/{chunk-UVFLQ6P3.js → chunk-4K22TYNZ.js} +2 -2
  15. package/dist-cli/chunks/{chunk-GSIYERHY.js → chunk-5ALMZP2C.js} +7 -7
  16. package/dist-cli/chunks/{chunk-P2CHBVZW.js → chunk-5QY6UIVH.js} +2 -2
  17. package/dist-cli/chunks/{chunk-DR65C56B.js → chunk-73HWAXE2.js} +2 -2
  18. package/dist-cli/chunks/{chunk-XXHWZFQP.js → chunk-7HFQ2NWW.js} +2 -2
  19. package/dist-cli/chunks/{chunk-A25NMNNP.js → chunk-AC7WDB6V.js} +1 -1
  20. package/dist-cli/chunks/{chunk-QW3UTSSW.js → chunk-BKUVXSRQ.js} +1 -1
  21. package/dist-cli/chunks/{chunk-TVV3D6FW.js → chunk-D43UWL27.js} +2 -2
  22. package/dist-cli/chunks/{chunk-S4HNANRQ.js → chunk-D5KQSLTO.js} +2 -2
  23. package/dist-cli/chunks/{chunk-JYPK3NGB.js → chunk-E3H5ZULL.js} +1 -1
  24. package/dist-cli/chunks/{chunk-3SAP2ISO.js → chunk-EBWNCJET.js} +2 -2
  25. package/dist-cli/chunks/{chunk-SIB5KIJ4.js → chunk-FXSPK6L3.js} +1 -1
  26. package/dist-cli/chunks/{chunk-YU6GZ5NB.js → chunk-H7MKPGGV.js} +3 -3
  27. package/dist-cli/chunks/{chunk-AQQWYSLA.js → chunk-IZYZPIRZ.js} +2 -2
  28. package/dist-cli/chunks/chunk-K24H4XOV.js +1 -0
  29. package/dist-cli/chunks/{chunk-S7L3E2YD.js → chunk-K5LENBS5.js} +1 -1
  30. package/dist-cli/chunks/{chunk-G2SLRKMB.js → chunk-L76VLJIZ.js} +2 -2
  31. package/dist-cli/chunks/{chunk-BG6OWTOI.js → chunk-LQTTCT5C.js} +1 -1
  32. package/dist-cli/chunks/{chunk-EDSFZIXQ.js → chunk-LW3KJUVL.js} +1 -1
  33. package/dist-cli/chunks/{chunk-CMEVVRAR.js → chunk-MWQUK6QO.js} +3 -3
  34. package/dist-cli/chunks/{chunk-PQZFDY2A.js → chunk-MYNBI2ND.js} +1 -1
  35. package/dist-cli/chunks/{chunk-2D66SUNA.js → chunk-NIUQAJCI.js} +2 -2
  36. package/dist-cli/chunks/{chunk-N4JCA64R.js → chunk-OIWS3EXW.js} +2 -2
  37. package/dist-cli/chunks/{chunk-77CHXDYW.js → chunk-RMJMYLLR.js} +2 -2
  38. package/dist-cli/chunks/{chunk-LRXVXOBZ.js → chunk-RURKHOVS.js} +1 -1
  39. package/dist-cli/chunks/{chunk-EVLFOAYO.js → chunk-UUFG4HVZ.js} +1 -1
  40. package/dist-cli/chunks/chunk-VX6D2AI3.js +1 -0
  41. package/dist-cli/chunks/{chunk-YD5QHV5V.js → chunk-WGJRZVLO.js} +1 -1
  42. package/dist-cli/chunks/{chunk-754NJLTU.js → chunk-WOKSYJIY.js} +2 -2
  43. package/dist-cli/chunks/{chunk-GJNF7NDM.js → chunk-WSGVQEXB.js} +3 -3
  44. package/dist-cli/chunks/{chunk-C2YM755N.js → chunk-XK275OXC.js} +1 -1
  45. package/dist-cli/chunks/{chunk-2F23CQGP.js → chunk-XKKCAC3J.js} +2 -2
  46. package/dist-cli/chunks/{chunk-GQLGVNOO.js → chunk-XODSEUOW.js} +2 -2
  47. package/dist-cli/chunks/{chunk-6O7ZPHMU.js → chunk-XU6LOLAB.js} +2 -2
  48. package/dist-cli/chunks/{chunk-IBCFP7H3.js → chunk-XXORXONW.js} +2 -2
  49. package/dist-cli/chunks/chunk-YHK6RX3N.js +2 -0
  50. package/dist-cli/chunks/{chunk-FLW46VDB.js → chunk-ZVE6F53R.js} +2 -2
  51. package/dist-cli/chunks/cli-version-2F4UFHUR.js +2 -0
  52. package/dist-cli/chunks/{compat-M5B7FWA5.js → compat-F6VRDJEA.js} +3 -3
  53. package/dist-cli/chunks/{config-HEZJL2XE.js → config-K2VVAYH6.js} +2 -2
  54. package/dist-cli/chunks/control-UCTK6SGP.js +2 -0
  55. package/dist-cli/chunks/{cpu-profile-X3JC344V.js → cpu-profile-6SQKDUCL.js} +2 -2
  56. package/dist-cli/chunks/{daemon-NGNG4RSE.js → daemon-AWSYWILR.js} +2 -2
  57. package/dist-cli/chunks/{debug-GEQPT5ZQ.js → debug-PX35BAY4.js} +3 -3
  58. package/dist-cli/chunks/{detox-YWFH3NLO.js → detox-5SPMUGEX.js} +2 -2
  59. package/dist-cli/chunks/{device-CBX6IAYH.js → device-ACGNWZ3G.js} +2 -2
  60. package/dist-cli/chunks/{diagnose-ZLUHR42I.js → diagnose-V2VT4ASE.js} +2 -2
  61. package/dist-cli/chunks/drivers-G4ZQAYTR.js +2 -0
  62. package/dist-cli/chunks/{electron-ZLRMHUYW.js → electron-Y6E5R4SF.js} +3 -3
  63. package/dist-cli/chunks/flow-I642RDRA.js +2 -0
  64. package/dist-cli/chunks/help-BPNT2YES.js +2 -0
  65. package/dist-cli/chunks/{hints-PHI7CRGD.js → hints-2V7ZHG6L.js} +2 -2
  66. package/dist-cli/chunks/{home-paths-Z73CLQBV.js → home-paths-MVPKADD6.js} +2 -2
  67. package/dist-cli/chunks/inspect-DNRAUTAB.js +974 -0
  68. package/dist-cli/chunks/install-BMWYQTOZ.js +2 -0
  69. package/dist-cli/chunks/{install-desktop-GYU74OUP.js → install-desktop-CYJDYA53.js} +3 -3
  70. package/dist-cli/chunks/{keys-VL6BSLHF.js → keys-FUYSXI2L.js} +2 -2
  71. package/dist-cli/chunks/{launch-YQYFQBHR.js → launch-PQ6QTEP7.js} +3 -3
  72. package/dist-cli/chunks/{login-TPOBFENS.js → login-BMFJHJ3B.js} +4 -4
  73. package/dist-cli/chunks/{logout-XYTNNS2V.js → logout-PG2JFWQL.js} +2 -2
  74. package/dist-cli/chunks/{maestro-FQYRGDX7.js → maestro-2QFWLFF4.js} +2 -2
  75. package/dist-cli/chunks/{preview-L743LEXV.js → preview-L6YAPMSD.js} +2 -2
  76. package/dist-cli/chunks/{profile-7XRSHEEP.js → profile-2QQGLQBN.js} +2 -2
  77. package/dist-cli/chunks/{react-VD7WKMQT.js → react-ZKAMEZ6H.js} +3 -3
  78. package/dist-cli/chunks/{record-WJ7NBGQL.js → record-XZNFFK4K.js} +2 -2
  79. package/dist-cli/chunks/runtime-4X66LQCP.js +2 -0
  80. package/dist-cli/chunks/{runtime-delivery-VPDXWAX4.js → runtime-delivery-R5E2YPXP.js} +2 -2
  81. package/dist-cli/chunks/{screenshot-IQZRQQA5.js → screenshot-5BDZO36S.js} +2 -2
  82. package/dist-cli/chunks/{screenshot-mode-A6SXP6ZJ.js → screenshot-mode-OUMQT4EP.js} +2 -2
  83. package/dist-cli/chunks/{screenshots-X5KKZTAP.js → screenshots-RTIXDSFS.js} +2 -2
  84. package/dist-cli/chunks/{server-7I7V4H3O.js → server-ZF2XUVP7.js} +2 -2
  85. package/dist-cli/chunks/setup-repo-BBC3QXE7.js +2 -0
  86. package/dist-cli/chunks/{skills-WSSHVDJO.js → skills-YN2QLIXK.js} +2 -2
  87. package/dist-cli/chunks/{start-GS4VLBF6.js → start-5HZPS3B6.js} +4 -4
  88. package/dist-cli/chunks/store-JJAGDHAI.js +2 -0
  89. package/dist-cli/chunks/telemetry-MRP2ISHT.js +2 -0
  90. package/dist-cli/chunks/{test-K53D2IP2.js → test-RQWNRURE.js} +3 -3
  91. package/dist-cli/chunks/{three-mode-GH7JMUUR.js → three-mode-STWOAVTT.js} +2 -2
  92. package/dist-cli/chunks/{timeline-NRBWDOXR.js → timeline-NZS6LDPR.js} +2 -2
  93. package/dist-cli/chunks/{upgrade-YKNCFMWK.js → upgrade-PM4RZ7CD.js} +2 -2
  94. package/dist-cli/chunks/upload-LLA3GT6U.js +2 -0
  95. package/dist-cli/chunks/{web-MZGLRPIR.js → web-YQE55355.js} +2 -2
  96. package/dist-cli/chunks/{what-happened-XYUFUXYC.js → what-happened-4HEXIQ23.js} +2 -2
  97. package/dist-cli/chunks/{whoami-ZHYQ3OGI.js → whoami-RZVBLNXN.js} +2 -2
  98. package/dist-lib/agent-daemon-client.cjs +1 -1
  99. package/dist-lib/agent-events.cjs +1 -1
  100. package/dist-lib/agent-sessions.cjs +1 -1
  101. package/dist-lib/attached-projects.cjs +1 -1
  102. package/dist-lib/auth/shared-session.cjs +1 -1
  103. package/dist-lib/backend-origin.cjs +1 -1
  104. package/dist-lib/beta.cjs +1 -1
  105. package/dist-lib/beta.mjs +1 -1
  106. package/dist-lib/bridge-constants.cjs +1 -1
  107. package/dist-lib/cli-constants.cjs +1 -1
  108. package/dist-lib/config.cjs +1 -1
  109. package/dist-lib/detox/index.cjs +1 -1
  110. package/dist-lib/dev-bundle-resolution.cjs +1 -1
  111. package/dist-lib/home-paths.cjs +1 -1
  112. package/dist-lib/host/bridge-host.cjs +1 -1
  113. package/dist-lib/host/fetch-proxy-handler.cjs +1 -1
  114. package/dist-lib/host/fetch-proxy-overrides.cjs +1 -1
  115. package/dist-lib/host/fetch-proxy-overrides.mjs +1 -1
  116. package/dist-lib/host/websocket-proxy.cjs +1 -1
  117. package/dist-lib/index.cjs +1 -1
  118. package/dist-lib/metro.cjs +1 -1
  119. package/dist-lib/profiles.cjs +1 -1
  120. package/dist-lib/render-mode.cjs +1 -1
  121. package/dist-lib/scripts/demo-app-registry.cjs +1 -1
  122. package/dist-lib/scripts/dev-server-scanner.cjs +1 -1
  123. package/dist-lib/sdk.cjs +1440 -0
  124. package/dist-lib/sdk.mjs +1360 -0
  125. package/dist-lib/skills.cjs +1 -1
  126. package/dist-lib/vite.cjs +1 -1
  127. package/package.json +8 -2
  128. package/src/sdk.ts +7 -0
  129. package/dist-cli/chunks/auto-bootstrap-OMA34BND.js +0 -2
  130. package/dist-cli/chunks/beta-OP6TYKKB.js +0 -2
  131. package/dist-cli/chunks/chunk-HKLM27ZP.js +0 -2
  132. package/dist-cli/chunks/chunk-MGSBDS2H.js +0 -1
  133. package/dist-cli/chunks/chunk-PTS25DZY.js +0 -1
  134. package/dist-cli/chunks/chunk-QH6IAFTO.js +0 -1
  135. package/dist-cli/chunks/cli-version-CBQ3OVJZ.js +0 -2
  136. package/dist-cli/chunks/control-SE4RPPWW.js +0 -2
  137. package/dist-cli/chunks/drivers-G5RZDGGI.js +0 -2
  138. package/dist-cli/chunks/flow-2JI67ETK.js +0 -2
  139. package/dist-cli/chunks/help-MXGX7BJE.js +0 -2
  140. package/dist-cli/chunks/inspect-N4AXJMZ4.js +0 -980
  141. package/dist-cli/chunks/install-FWXT4NDF.js +0 -2
  142. package/dist-cli/chunks/runtime-GNVSGKXO.js +0 -2
  143. package/dist-cli/chunks/setup-repo-Y4AUXZJI.js +0 -2
  144. package/dist-cli/chunks/store-YI2AYLU5.js +0 -2
  145. package/dist-cli/chunks/telemetry-DNQFR4IP.js +0 -2
  146. package/dist-cli/chunks/upload-IZSNPSBB.js +0 -2
@@ -1,980 +0,0 @@
1
- /*! sootsim v0.1.111 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
- import{a as V}from"./chunk-4PBNEPVZ.js";import{a as gt,b as yt}from"./chunk-67OJIOOH.js";import{a as Ue,h as he,k as oe}from"./chunk-CMEVVRAR.js";import{b as ht,c as bt,j as wt}from"./chunk-UVFLQ6P3.js";import"./chunk-IBCFP7H3.js";import{a as Q,b as E,c as C,d as _e,e as re,f as X,g as ye,h as ue,i as mt,j as pt,k as Ae,l as ft}from"./chunk-P2CHBVZW.js";import{B as ct,D as le,E as dt,K as ut,a as ge,b as Ke,c as ze,d as Ye,e as Ge,f as Xe,g as Ve,h as Qe,i as Ie,j as Ne,n as Fe,o as Ze,p as et,q as tt,r as ot,s as st,t as nt,u as rt,v as it,w as at,x as lt}from"./chunk-XXHWZFQP.js";import"./chunk-53MJ3O5G.js";import{c as Le,e as qe,f as We,g as He,h as Me}from"./chunk-S4HNANRQ.js";import{b as Je}from"./chunk-SKLP2DGB.js";import"./chunk-DR65C56B.js";import"./chunk-BG6OWTOI.js";import"./chunk-PTS25DZY.js";import"./chunk-2D66SUNA.js";import"./chunk-LRXVXOBZ.js";import{a as Be}from"./chunk-EVLFOAYO.js";import{a as ke,c as Te}from"./chunk-QW3UTSSW.js";import{a as je}from"./chunk-HKLM27ZP.js";import"./chunk-SIB5KIJ4.js";import"./chunk-EDSFZIXQ.js";import"./chunk-PQZFDY2A.js";import{existsSync as so,mkdirSync as no,readFileSync as ro,rmSync as xt,writeFileSync as io}from"fs";import{tmpdir as ao}from"os";import{dirname as lo,join as co,resolve as uo}from"path";var me=1,mo="SOOTSIM_INSPECT_NOTICE_PATH",po=300*1e3,fo=15e3;function $t(){return uo(process.env[mo]||co(ao(),"sootsim-inspect-notice-state.json"))}function go(o,c){return Object.fromEntries(Object.entries(o).filter(([,i])=>typeof i?.signature=="string"&&Number.isFinite(i?.updatedAt)&&c-i.updatedAt<=po))}function yo(o){let c=$t();if(!so(c))return{version:me,entries:{}};try{let i=JSON.parse(ro(c,"utf8"));return i.version!==me||!i.entries||typeof i.entries!="object"?(xt(c,{force:!0}),{version:me,entries:{}}):{version:me,entries:go(i.entries,o)}}catch{return xt(c,{force:!0}),{version:me,entries:{}}}}function ho(o){let c=$t();no(lo(c),{recursive:!0}),io(c,JSON.stringify(o,null,2)+`
3
- `)}function bo(o,c){let i=c.trim()||"default";return`${o}:${i}`}function Pe(o,c,i,l={}){let f=l.nowMs??Date.now(),a=l.cooldownMs??fo,g=yo(f),b=bo(o,c),k=g.entries[b];return k&&k.signature===i&&f-k.updatedAt<a?!1:(g.entries[b]={signature:i,updatedAt:f},ho(g),!0)}async function vt(o,c={args:[]}){let i=await ze(o);if(E(c.args)){C(i);return}console.log(` nodes: ${i.nodes}`)}function Oe(o,c){let i=o.indexOf(c);return i>=0&&i+1<o.length?o[i+1]:null}async function St(o){let{bridge:c,args:i,positional:l}=o,f=i.includes("--verbose")||i.includes("-v"),a=E(i),g=f&&!a,b=i.includes("--watch")||i.includes("-w"),k=1e3,M=i.includes("--compact"),h=i.includes("--no-xy"),S=i.includes("--no-clipped"),_=i.includes("--include-occluded"),T=Oe(i,"--testid-like"),R=Oe(i,"--only"),J=Oe(i,"--subtree"),u=l[1]&&!l[1].startsWith("-")?l[1]:void 0,Y=u?/[*?]/.test(u):!1,j=!Y&&!R?u:void 0,D=R??(Y?u:void 0),Z=async()=>{await ye(c,{verbose:g});let $=await Xe(c,{describe:!0,verbose:f,filter:j||"",testIdLike:T||void 0,onlyGlob:D||void 0,subtreeRoot:J||void 0,compact:M,hideXy:h,includeOccluded:_}),I=$?.tree,W=$?.shell,L=$?.keyboard;if(a){C({shell:W,tree:I??"",keyboard:L});return}if(W&&typeof W=="object"){let B=[W.state?`state=${W.state}`:null,W.activeApp?`app=${W.activeApp}`:null,W.showSwitcher?"switcher":null,W.switcherPhase&&W.switcherPhase!=="idle"?`phase=${W.switcherPhase}`:null].filter(Boolean);B.length>0&&console.log(` shell: ${B.join(" ")}`)}if(typeof I=="string"&&I.startsWith("__SUBTREE_NOT_FOUND__:")){let B=I.slice(22);console.log(` subtree root not found: ${B}`),V("subtree-root-not-found",B);return}if(!I){let B=$?.nodeCount??0;console.log(" no matching nodes found"),!(j||T||D||J)&&B<10&&V("app-still-loading",B);return}let z=I,te=0;if(S&&typeof z=="string"){let B=z.split(`
4
- `),ae=[];for(let ce of B){if(ce.includes("(clipped:")){te+=1;continue}ae.push(ce)}z=ae.join(`
5
- `)}console.log(z),te>0&&console.log(` ${te} clipped row(s) hidden (omit --no-clipped to see)`);let ne=j||T||D||J;if((j||T||D)&&!b&&V("describe-filter-context"),!ne&&!b&&I.split(`
6
- `).length>=80&&V("describe-use-filters"),L&&L.visible){let B=L.spec,ae=[B?.keyboardType?`type=${B.keyboardType}`:null,B?.returnKeyType&&B.returnKeyType!=="default"?`return=${B.returnKeyType}`:null,L.mode!=="letters"?`mode=${L.mode}`:null,L.shifted?"shift":null,L.capsLock?"caps":null,B?.autoCapitalize&&B.autoCapitalize!=="sentences"?`autoCap=${B.autoCapitalize}`:null,L.accessoryBarId?`accessory=${L.accessoryBarId}`:null].filter(Boolean);console.log(`
7
- keyboard: ${ae.join(" ")||"visible"}`)}};if(b)for(console.log(` watching... (Ctrl+C to stop)
8
- `);;)console.clear(),await Z(),await Q(k);else await Z()}var wo=["SOOTSIM_AGENT","CLAUDECODE","CLAUDE_CODE_ENTRYPOINT","CLAUDE_CODE_SESSION_ID","CODEX_THREAD_ID","CURSOR_TRACE_ID","AIDER_MODEL"];function be(){if(process.env.SOOTSIM_AGENT==="0")return!1;for(let o of wo){let c=process.env[o];if(c&&c.trim()&&c!=="0")return!0}return!1}async function kt(o){let{bridge:c,args:i,effectiveArgs:l,positional:f,inspectUsage:a}=o,g=$=>{let I=l.indexOf($);return I>=0&&I+1<l.length?l[I+1]:null},b=$=>l.includes($),k=g("--testid")||g("--test-id"),M=g("--role"),h=g("--type"),S=g("--text"),_=b("--pressable"),T=b("--visible"),R=b("--interactive-targets")||b("--actions"),J=!k&&!M&&!h&&!S&&!_&&!T&&!R?f[1]:null,u=S??J,Y=await Qe(c,{testId:k,role:M,type:h,text:u,pressable:_,visible:T,interactive:R});Y||(console.error(a("find","<text> | --text <t> | --testid <id> | --role <r> | --type <t> | --pressable | --visible | --interactive-targets")),process.exit(1));let{mode:j,result:D}=Y,Z=E(i),ee=i.includes("--verbose")||i.includes("--dump");if(Z)j==="interactive-targets"&&Array.isArray(D)?C(Ie(D).map($=>({...$,tap:Ne($)}))):C(D??null);else if(Array.isArray(D))if(D.length===0){console.log(` no ${j} nodes found`);let $=await c.send({type:"evaluate",code:"(async () => (await window.__sootsimTest?.getNodeCount?.()) || 0)()"});typeof $=="number"&&$<10&&V("app-still-loading",$)}else if(j==="interactive-targets"){let $=Ie(D);console.log(` found ${$.length} interactive target${$.length===1?"":"s"} (sorted by score):`);for(let I of $.slice(0,20)){let W=I.absolutePosition?`@(${Math.round(I.absolutePosition.x)},${Math.round(I.absolutePosition.y)})`:"",L=I.layout?`${Math.round(I.layout.width)}x${Math.round(I.layout.height)}`:"?x?",z=I.text?` "${I.text.slice(0,30)}"`:"",te=I.testID?` #${I.testID}`:"",ne=I.accessibilityLabel?` \u24D8"${String(I.accessibilityLabel).slice(0,24)}"`:"",fe=I.accessibilityRole?`[${I.accessibilityRole}]`:I.type,B=Ne(I);console.log(` ${fe}${z}${ne}${te} ${L} ${W}`),console.log(` \u2192 ${B}`),ee&&console.log(Re(JSON.stringify(I,null,2)," "))}$.length>20&&console.log(` ... and ${$.length-20} more`)}else{console.log(` found ${D.length} node${D.length===1?"":"s"} (${j}):`);for(let $ of D.slice(0,20)){let I=$.absolutePosition?`@(${Math.round($.absolutePosition.x)},${Math.round($.absolutePosition.y)})`:"",W=$.layout?`${Math.round($.layout.width)}x${Math.round($.layout.height)}`:"?x?",L=$.text?` "${$.text.slice(0,30)}"`:"",z=$.testID?` #${$.testID}`:"",te=$.pressable?" (tap)":"",ne=$.accessibilityRole?`[${$.accessibilityRole}]`:$.type;console.log(` ${ne}${L}${z} ${W} ${I}${te}`),ee&&console.log(Re(JSON.stringify($,null,2)," "))}D.length>20&&console.log(` ... and ${D.length-20} more`)}else if(D==null)console.log(` not found: ${u||k||M||h||""||j}`),k&&V("wait-selector-for-missing-testid",k);else{let $=D;if($.type&&$.absolutePosition){let I=`@(${Math.round($.absolutePosition.x)},${Math.round($.absolutePosition.y)})`,W=$.layout?`${Math.round($.layout.width)}x${Math.round($.layout.height)}`:"?x?",L=$.text?` "${$.text.slice(0,40)}"`:"",z=$.testID?` #${$.testID}`:"",te=$.pressable?" (tap)":"",ne=$.accessibilityRole?`[${$.accessibilityRole}]`:$.type;console.log(` ${ne}${L}${z} ${W} ${I}${te}`),ee&&console.log(Re(JSON.stringify($,null,2)," "))}else console.log(JSON.stringify(D,null,2))}}function Re(o,c){return o.split(`
9
- `).map(i=>c+i).join(`
10
- `)}async function Tt(o,c={}){let i=await ct(o);if("error"in i&&(console.error(i.error),process.exit(1)),c.json){console.log(JSON.stringify(i,null,2));return}let{visible:l,spec:f,mode:a,shifted:g,capsLock:b,accessoryBarId:k}=i,M=[];M.push(`keyboard: ${l?"visible":"hidden"}`),f?(M.push(` type: ${f.keyboardType}`),M.push(` returnKey: ${f.returnKeyType}`),M.push(` autoCap: ${f.autoCapitalize}`),M.push(` autoCorrect: ${f.autoCorrect?"on":"off"}`),M.push(` appearance: ${f.keyboardAppearance}`),f.secureTextEntry&&M.push(" secureTextEntry: true"),f.enablesReturnKeyAutomatically&&M.push(` return: ${f.currentTextIsEmpty?"disabled (empty)":"enabled"}`)):M.push(" spec: <none> (shown via dev-tools with no TextInput)"),M.push(` mode: ${a}${g?" (shifted)":""}${b?" (caps)":""}`),k&&M.push(` accessoryBar: ${k}`),console.log(M.join(`
11
- `))}async function Mt(o){let c=await o.bridge.listSims(),i=o.args.includes("--all"),l=o.args.find((b,k)=>o.args[k-1]==="--bundle"),f=o.args.find((b,k)=>o.args[k-1]==="--app-port"),a=o.args.includes("--primary"),g=c.filter(b=>!(a&&!b.isPrimary||l&&!(b.url??"").includes(l)||f&&!(b.url??"").includes(`/rn/${f}`)||!i&&!l&&!f&&!a&&!(b.url&&(b.url.includes("bundle=")||b.url.includes("/index.bundle")))&&b.id!==o.simId));if(E(o.args)){C(g.map(b=>({...b,active:b.id===o.simId})));return}wt(g,o.simId),g.length<c.length&&!E(o.args)&&console.log(` (${c.length-g.length} more hidden \u2014 pass --all to show)`)}function ie(o){return o<1024?`${o}B`:o<1024*1024?`${(o/1024).toFixed(1)}KB`:`${(o/1024/1024).toFixed(1)}MB`}function we(o,c){return c<=0?"?":`${(o/c*100).toFixed(0)}%`}async function It(o,c={args:[]}){let i=await ut(o);if(E(c.args)){C(i);return}if(console.log(" memory:"),i.imageLoader){let l=i.imageLoader;console.log(" image-loader cache"),console.log(` entries: ${l.cacheEntries} / ${l.cacheMaxEntries} (${we(l.cacheEntries,l.cacheMaxEntries)})`),console.log(` pixel bytes: ${ie(l.cachePixelBytes)} / ${ie(l.cachePixelBudget)} (${we(l.cachePixelBytes,l.cachePixelBudget)})`),console.log(` pending: ${l.pendingFetches} fetches, ${l.pendingBytes} bytes`),console.log(` failed uris: ${l.failedUris}`),console.log(` snapshots: ${l.snapshots}`),console.log(` camera frames: ${l.cameraFrames}`)}else console.log(" image-loader cache: not available (engine pre-rebuild?)");if(i.workerHeap){let l=i.workerHeap;console.log(" worker heap (chrome only)"),console.log(` used: ${ie(l.usedJSHeapSize)} / ${ie(l.jsHeapSizeLimit)} (${we(l.usedJSHeapSize,l.jsHeapSizeLimit)})`),console.log(` total: ${ie(l.totalJSHeapSize)}`)}if(i.hostHeap){let l=i.hostHeap;console.log(" host heap (chrome only)"),console.log(` used: ${ie(l.usedJSHeapSize)} / ${ie(l.jsHeapSizeLimit)} (${we(l.usedJSHeapSize,l.jsHeapSizeLimit)})`),console.log(` total: ${ie(l.totalJSHeapSize)}`)}}function pe(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 l=o.indexOf("--text");return l>=0&&o[l+1]?{mode:"text",value:o[l+1]}:null}async function xe(o,c){let i=JSON.stringify(c.value),l=c.mode==="testid"?`(await t.findByTestId(${i})) || (await t.findById(${i}))`:`await t.findByText(${i})`;return await o.send({type:"evaluate",code:`(async () => {
12
- const t = window.__sootsimTest
13
- if (!t) return null
14
- const n = ${l}
15
- if (!n || !n.absolutePosition || !n.layout) return null
16
- const resolved =
17
- typeof n.nodeId === 'number' && typeof t.resolveTapTarget === 'function'
18
- ? await t.resolveTapTarget(n.nodeId)
19
- : null
20
- const cx =
21
- typeof resolved?.cx === 'number'
22
- ? resolved.cx
23
- : n.absolutePosition.x + (n.layout.width || 0) / 2
24
- const cy =
25
- typeof resolved?.cy === 'number'
26
- ? resolved.cy
27
- : n.absolutePosition.y + (n.layout.height || 0) / 2
28
- return {
29
- x: cx,
30
- y: cy,
31
- id: n.id ?? null,
32
- testID: n.testID ?? null,
33
- text: ${JSON.stringify(c.mode==="text")} ? ${i} : (n.text ?? n.accessibilityLabel ?? null),
34
- type: n.type ?? null,
35
- }
36
- })()`})??null}async function Nt(o,c={}){let{nav:i,keyboard:l,shell:f}=await dt(o);if(c.json){console.log(JSON.stringify({shell:f??null,nav:i,keyboard:l},null,2));return}let a=[];if(f){let g=f.activeApp??f.state??"<none>",b=f.showSwitcher?" (app switcher open)":"",k=typeof f.launchProgress=="number"&&f.launchProgress<.98?` launching (${Math.round(f.launchProgress*100)}%)`:"";a.push(`shell: ${g}${b}${k}`)}else a.push("shell: <unavailable>");if(i){let g=i.transitionPhase!=="idle"?` (${i.transitionPhase}, ${i.activeTransitionCount} active)`:"";if(a.push(`nav: phase=${i.transitionPhase}${g}`),i.screens.length===0)a.push(" <no registered screens \u2014 app may not use react-native-screens>");else for(let b of i.screens){let k=b.isActive?"\u25B6":" ",M=b.routeName?` ${b.routeName}`:"",h=b.headerHeight>0?` header=${b.headerHeight}`:"",S=b.largeTitleState&&b.largeTitleState!=="expanded"?` large-title=${b.largeTitleState}`:"";a.push(` ${k} #${b.id}${M}${h}${S}`)}}else a.push("nav: <runtime not available>");if(l&&l.visible){let g=l.spec?.keyboardType??"default",b=l.spec?.returnKeyType??"default";a.push(`keyboard: visible (${g}, return=${b}, mode=${l.mode??"?"})`)}else a.push("keyboard: hidden");console.log(a.join(`
37
- `))}async function Ft(o){let{bridge:c,args:i,positional:l}=o,f=l[1]?Number(l[1])*1e3:3e3,a=i.includes("--strict"),{elapsed:g,settled:b}=await oe({bridge:c,maxMs:f,strict:a});console.log(b?` settled in ${g}ms`:` timed out after ${g}ms (may still be animating)`)}async function _t(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 Q(c*1e3),console.log(` slept ${c}s`)}async function At(o){let{bridge:c,args:i,positional:l}=o,f=l[1]?Number(l[1]):5,{tree:a}=await Ye(c,f);if(E(i)){C({depth:f,tree:a??null});return}console.log(typeof a=="string"?a:JSON.stringify(a,null,2))}async function Pt(o,c={args:[]}){let i=await Ge(o);if(E(c.args)){C(i);return}console.log(i.url)}async function Ot(o){let{wsPort:c,commandTimeoutMs:i,simId:l,simIdSource:f,positional:a}=o,g=a[1]?Number(a[1]):30,b=Math.max(1e3,(Number.isFinite(g)?g:30)*1e3),k=Math.max(1,Math.ceil(b/500));console.log(" waiting for sim reconnect...");let M=await mt(c,i,l,{attempts:k,simIdSource:f});M||(console.error(" timed out waiting for sim reconnect"),process.exit(1)),M.bridge.close(),he({source:"inspect wait",step:{wait:b},summary:`wait ${Math.round(b/1e3)}s`}),console.log(` ready: ${M.count} nodes`)}var Rt=new Set(["app-launch","toast","keyboard","screen","route","alert","actionsheet","picker","notification","fetch","console","shell","scroll","gesture","text-input","react-commit","animation","reanimated"]);function $e(o,c){let i=o.indexOf(c);if(i>=0&&i+1<o.length)return o[i+1]}function xo(o,c){if(!c.filter&&!c.equals)return!0;let i=o.data,l=[];if(i&&typeof i=="object")for(let a of["url","displayUrl","message","name","activeName","path","pathname","title","phase","event","type","kind"]){let g=i[a];typeof g=="string"&&g.length>0&&l.push(g)}let f=l.join(" ");return c.equals?l.some(a=>a===c.equals):c.filter?f.toLowerCase().includes(c.filter.toLowerCase()):!0}async function Et(o){let{bridge:c,args:i,positional:l,inspectUsage:f}=o,a=l[1];a||(console.error(f("wait event","<kind> [--max-ms 5000] [--filter <substring>] [--equals <exact>] [--since now|cursor]")),process.exit(1)),Rt.has(a)||console.error(` warning: '${a}' is not a known timeline kind \u2014 waiting anyway. known: ${[...Rt].sort().join(", ")}`);let g=$e(i,"--max-ms"),b=g&&Number.isFinite(Number(g))?Math.max(100,Number(g)):5e3,k=$e(i,"--filter"),M=$e(i,"--equals"),h=$e(i,"--since")??"now",S=i.includes("--json"),_=Date.now(),T=_+b,R=200,J=_;for(;Date.now()<T;){let Y={kinds:[a],since:h==="cursor"?void 0:J,limit:50},j=await c.send({type:"evaluate",code:`(async () => {
38
- const t = window.SootSim?.bridges?.timeline
39
- if (!t) return { ok: false, error: 'timeline bridge missing' }
40
- return { ok: true, result: await t.recent(${JSON.stringify(Y)}) }
41
- })()`});(!j||!j.ok)&&(console.error(` could not query timeline: ${j&&"error"in j?j.error:"unknown"}`),process.exit(1));let D=j.result.events??[];for(let Z of D)if(xo(Z,{filter:k,equals:M})){let ee=Date.now()-_;console.log(S?JSON.stringify({found:!0,elapsedMs:ee,event:Z}):` ${a} event after ${ee}ms${k?` (filter: ${k})`:""}${M?` (equals: ${M})`:""}`);return}j.result.watermark&&j.result.watermark>J&&(J=j.result.watermark),await new Promise(Z=>setTimeout(Z,R))}let u=Date.now()-_;S?console.log(JSON.stringify({found:!1,elapsedMs:u,kind:a,filter:k,equals:M})):console.error(` \u26A0 wait event ${a} timed out after ${u}ms${k?` (filter: ${k})`:""}${M?` (equals: ${M})`:""}`),process.exit(1)}async function Ct(o){let{bridge:c,args:i}=o,l=i.includes("--strict"),f=ge(i,3e3),{elapsed:a,settled:g}=await oe({bridge:c,maxMs:f,strict:l});g?console.log(` idle in ${a}ms`):(console.error(` \u26A0 wait idle timed out after ${a}ms (may still be animating)`),process.exit(1))}async function Dt(o){let{bridge:c,args:i}=o,l=ge(i,2e4),{ready:f,elapsedMs:a,nodes:g,targets:b,flag:k,loadingText:M,externalReady:h,externalError:S,errors:_}=await Ze(c,l,{onProgress(R){console.error(` still waiting after ${R.elapsedMs}ms \u2014 ${Fe(R)} (nodes: ${R.nodes}, targets: ${R.targets}, errors: ${R.errors})`)}});if(f){let R=l-a,J=Math.max(100,Math.min(1e4,R)),u=await oe({bridge:c,maxMs:J,pollMs:32,stablePolls:2});u.settled||(console.error(` \u26A0 wait ready timed out after ${a+u.elapsed}ms \u2014 app mounted but did not settle (nodes: ${g}, targets: ${b})`),process.exit(1)),console.log(` ready in ${a+u.elapsed}ms: ${g} nodes, ${b} targets`);return}let T=Fe({externalError:S,loadingText:M,externalReady:h,flag:k,targets:b});console.error(` \u26A0 wait ready timed out after ${a}ms \u2014 ${T} (nodes: ${g}, targets: ${b}, errors: ${_})`),process.exit(1)}async function Bt(o){let{bridge:c,args:i,positional:l,inspectUsage:f}=o,a=l[1];a||(console.error(f("wait selector","<testid> [--max-ms 5000] [--gone]")),process.exit(1));let g=i.indexOf("--max-ms"),b=g>=0&&i[g+1]?Math.max(100,Number(i[g+1])):5e3,k=i.includes("--gone"),{found:M,node:h,elapsed:S}=await et(c,a,b,{gone:k});if(k){M?console.log(` #${a} gone after ${S}ms`):(console.error(` \u26A0 wait selector #${a} --gone timed out after ${S??b}ms (still present)`),process.exit(1));return}if(M&&h){let _=h.absolutePosition?`@(${Math.round(h.absolutePosition.x)},${Math.round(h.absolutePosition.y)})`:"",T=h.layout?`${Math.round(h.layout.width)}x${Math.round(h.layout.height)}`:"?x?";console.log(` found #${a} in ${S}ms ${T} ${_}`)}else console.error(` \u26A0 wait selector #${a} timed out after ${S??b}ms`),process.exit(1)}function Kt(o){return o==null?"\u2014":o<1024?`${o}B`:o<1024*1024?`${(o/1024).toFixed(1)}K`:`${(o/1024/1024).toFixed(1)}M`}function zt(o){return o==null?" \u2026":o<1e3?`${o}ms`.padStart(5):`${(o/1e3).toFixed(2)}s`.padStart(5)}function jt(){process.stderr.write(` the sim is not responding. recover it with:
42
- sootsim close --sim <id> # force-close the wedged sim
43
- sootsim list # confirm it's gone
44
- `)}async function vo(o){try{return await o.send({type:"evaluate",code:"1"},{timeoutMs:3e3}),!0}catch{return!1}}async function So(o,c){try{let i=await o.send({type:"evaluate",code:`(async () => {
45
- const t = window.__sootsimTest
46
- if (!t || typeof t.queryAll !== 'function') return []
47
- try {
48
- // queryAll is async in render-worker mode (the canonical mode now)
49
- // because the call has to round-trip the worker \u2014 must await it.
50
- // a sync result is still handled fine since await on a non-Promise
51
- // is a no-op.
52
- const nodes = await t.queryAll({})
53
- if (!Array.isArray(nodes)) return []
54
- const out = new Set()
55
- for (const n of nodes) {
56
- const id = n && (n.testID || n.id)
57
- if (typeof id === 'string' && id) out.add(id)
58
- }
59
- return Array.from(out)
60
- } catch {
61
- return []
62
- }
63
- })()`});if(!Array.isArray(i)||i.length===0)return;let l=c.toLowerCase(),f=i.map(a=>({id:a,score:ko(l,a.toLowerCase())})).filter(a=>a.score<l.length+4).sort((a,g)=>a.score-g.score).slice(0,5);if(f.length===0)return;console.error(" similar testIDs:");for(let a of f)console.error(` ${a.id}`)}catch{}}function ko(o,c){if(c===o)return 0;if(c.includes(o))return 1;if(o.includes(c))return 2;let i=0;for(;i<o.length&&i<c.length&&o[i]===c[i];)i+=1;return To(o,c)-i}function To(o,c){if(o===c)return 0;if(!o.length)return c.length;if(!c.length)return o.length;let i=new Array(c.length+1),l=new Array(c.length+1);for(let f=0;f<=c.length;f++)i[f]=f;for(let f=1;f<=o.length;f++){l[0]=f;for(let g=1;g<=c.length;g++)l[g]=Math.min(i[g]+1,l[g-1]+1,i[g-1]+(o[f-1]===c[g-1]?0:1));let a=i;i=l,l=a}return i[c.length]}function Mo(o){return o.error?"err":o.status==null?" \u2026 ":String(o.status)}function Io(o){return o.externalError?`guest app errored: ${o.externalError}`:o.loadingText?`still showing "${o.loadingText}"`:o.externalReady===!1?"guest app is still loading":o.flag!==!0?"guest app has not emitted sootsim:externalAppReady":o.targets<=0?"ready flag emitted but no visible app content is inspectable yet":"node tree is still changing"}function Jt(o){let c=re(o.startTs),i=Mo(o).padEnd(3),l=o.method.padEnd(5),f=Kt(o.size).padStart(6),a=zt(o.durationMs);console.log(` [${c}] ${i} ${l} ${f} ${a} ${o.displayUrl}`),o.error&&console.log(` error: ${o.error}`)}function No(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",re(o.startTs)],["duration",zt(o.durationMs).trim()],["size",Kt(o.size)],["content-type",o.type??"\u2014"]];for(let[i,l]of c)console.log(` ${i.padEnd(13)} ${l}`)}var Fo={error:"\x1B[31m",warn:"\x1B[33m",info:"\x1B[36m",debug:"\x1B[35m",log:"\x1B[37m"},Lt="\x1B[0m",_o="\x1B[2m";function qt(o,c){let i=re(o.ts),l=o.level.toUpperCase().padEnd(5),f=o.args.join(" ");if(c){let a=Fo[o.level];console.log(` ${_o}[${i}]${Lt} ${a}${l}${Lt} ${f}`)}else console.log(` [${i}] ${l} ${f}`);if(o.stack&&o.level==="error"){let a=o.stack.split(`
64
- `).slice(0,5);for(let g of a)console.log(` ${g.trim()}`)}}var se="__sootsimCliPerf",Ao=120;async function Wt(o,c){let i=o.find((_,T)=>o[T-1]==="--id"),l=o.find((_,T)=>o[T-1]==="--text");if(i||l){let _=await c.send({type:"evaluate",code:gt({id:i,text:l})});if(!_)throw new Error(i?`no node with id "${i}"`:`no node matching text "${l}"`);let{x:T,y:R,w:J,h:u}=_;return{x:T,y:R,w:J,h:u}}let f=o.find((_,T)=>o[T-1]==="--area");if(f){let _=f.split(",").map(Y=>Number(Y.trim()));if(_.length!==4||_.some(Y=>!Number.isFinite(Y)))throw new Error(`--area expects x,y,w,h (got "${f}")`);let[T,R,J,u]=_;return{x:T,y:R,w:J,h:u}}let a=_=>{let T=o.find((J,u)=>o[u-1]===_);if(T==null)return null;let R=Number(T);return Number.isFinite(R)?R:null},g=a("--x"),b=a("--y"),k=a("--w"),M=a("--h");if(g!=null||b!=null||k!=null||M!=null)return{x:g??0,y:b??0,w:k??1,h:M??1};let S=o.filter((_,T)=>T>0&&!_.startsWith("-")&&o[T-1]!=="--output"&&o[T-1]!=="--area"&&o[T-1]!=="--id"&&o[T-1]!=="--text"&&o[T-1]!=="--x"&&o[T-1]!=="--y"&&o[T-1]!=="--w"&&o[T-1]!=="--h").map(Number).filter(_=>Number.isFinite(_));if(S.length>=2){let[_,T,R=1,J=1]=S;return{x:_,y:T,w:R,h:J}}return null}function Ee(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,l]of Object.entries(c)){let f="\u2588".repeat(Math.ceil(l/o.length*40));console.log(` ${i.padEnd(6)} ${f} ${l}`)}}async function ve(o,c,i){let l=Date.now()+c,f=await le(o,c);for(;;){if(i(f))return{settled:!0,state:f};if(Date.now()>=l)return{settled:!1,state:f};await Q(16),f=await le(o)}}async function De(o){return o.send({type:"evaluate",code:`(async () => {
65
- const kb = window.__sootsimKeyboard
66
- const test = window.__sootsimTest
67
- if (!kb) return { error: 'keyboard bridge not available' }
68
- const visible = kb.isVisible()
69
- const mode = kb.getMode()
70
- let focused = null
71
- if (test && typeof test.getFocusedNode === 'function') {
72
- try {
73
- focused = await test.getFocusedNode()
74
- } catch {}
75
- }
76
- let runtimeSnapshot = null
77
- if (test && typeof test.getFocusKeyboardSnapshot === 'function') {
78
- try {
79
- runtimeSnapshot = await test.getFocusKeyboardSnapshot()
80
- } catch {}
81
- }
82
- return {
83
- visible,
84
- mode,
85
- focusedInput: focused ? {
86
- nodeId: focused.nodeId ?? null,
87
- testID: focused.testID || null,
88
- id: focused.id || null,
89
- placeholder: focused.placeholder || null,
90
- text: focused.text || null,
91
- } : null,
92
- phase: runtimeSnapshot?.keyboard?.phase ?? null,
93
- frame: runtimeSnapshot?.keyboard?.frame ?? null,
94
- focusedRect: runtimeSnapshot?.focused?.rect ?? null,
95
- }
96
- })()`})}async function Po(o,c=600){let i=Date.now()+c;for(;Date.now()<=i;){let l=await De(o);if(l.visible)return l;await Q(30)}return De(o)}async function Se(o,c){let i=await De(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 Ht(o,c,i){return c==="appearance"?o.send({type:"evaluate",code:`(async () => {
97
- const requested = ${JSON.stringify(i??"toggle")}
98
- const rootBg = (document.documentElement?.style?.background || '').toLowerCase()
99
- const inferredCurrent = rootBg.includes('33') ? 'dark' : 'light'
100
- let next = requested
101
- if (requested === 'toggle') {
102
- next = inferredCurrent === 'dark' ? 'light' : 'dark'
103
- }
104
- // engine accepts 'auto' since the schema picker landed; pass through.
105
- window.postMessage({ type: 'soot-action', action: 'set-appearance', value: next }, '*')
106
- const applied = next === 'auto'
107
- ? (window.matchMedia?.('(prefers-color-scheme: dark)')?.matches ? 'dark' : 'light')
108
- : next
109
- return { ok: true, requested, value: next, applied }
110
- })()`}):o.send({type:"evaluate",code:`(async () => {
111
- window.dispatchEvent(new CustomEvent(${JSON.stringify(c==="lock"?"sootsim:toggleLock":"sootsim:shake")}))
112
- return { ok: true, action: ${JSON.stringify(c)} }
113
- })()`})}function Oo(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 l=o.match(/^Key([A-Z])$/);return l?l[1].toLowerCase():null}function Ro(o){if(typeof o!="string")return null;let c=o.replace(/\s+/g," ").trim();return c?c.slice(0,80):null}function Yt(...o){for(let c of o){if(typeof c!="string")continue;let i=c.trim();if(i)return i}return null}function Eo(o){let c=o.indexOf("--node-id");if(c<0)return null;let i=o[c+1];if(!i)return null;let l=Number(i);return Number.isInteger(l)&&l>0?l:null}async function q(o,c,i){let l=he({source:o,step:c,summary:i});l.active&&(l.replaced?console.error(` draft: replaced unkept action "${l.replaced.summary}" \u2014 \`flow keep\` commits one action at a time`):console.error(" draft: action pending \u2014 `sootsim flow keep` to commit"))}function Ut(o,c,i){if(!i||i.hit===!1)return null;let l=Yt(i.responderTestID,i.testID);if(l)return{step:{tapOn:{id:l}},summary:`tap #${l}`};let f=Ro(i.text);return f?{step:{tapOn:f},summary:`tap "${f}"`}:{step:{tapAtCoords:{x:o,y:c}},summary:`tap @${Math.round(o)},${Math.round(c)}`}}function Ce(o,c,i){let l=Yt(c?.testID,c?.id);return l?{step:{tapOn:{id:l}},summary:`tap #${l}`}:i==="id"?{step:{tapOn:{id:o}},summary:`tap #${o}`}:{step:{tapOn:o},summary:`tap "${o}"`}}async function hn(o,c){let i=o[0]==="get"||o[0]==="do"||o[0]==="debug"||o[0]==="wait"?o[0]:null,l=i?o.slice(1):o,f=Le(l,{port:c.port,commandTimeoutMs:c.timeoutMs,stripBooleanFlags:["--verbose","-v","--help","-h","--clear-state","--json","--all","--watch","-w","--strict","--no-wait","--dump","--failed","--slow","--tail","-f","--interactive-targets","--actions","--internal","--compact","--no-xy","--no-clipped","--include-occluded"],stripValueFlags:["--output","--nth","--index","--testid","--test-id","--text","--node-id","--max-ms","--filter","--limit","--level","--threshold","--equals","--since","--testid-like","--only","--subtree"]}),a=f.positional,g=a[0],b=i==="get"||i==="do"||i==="debug"||i==="wait"?i:"inspect",k=typeof l[0]=="string"&&Be.has(l[0]),M=k?l[0]:null,h=e=>k&&e===l[0]?`sootsim ${e}`:`sootsim ${b} ${e}`,S=(e,t)=>` usage: ${h(e)}${t?` ${t}`:""}`;if(!g||o.includes("--help")||o.includes("-h")){let e={bridgePort:7668,defaultShellUrl:je};if(b==="do"||b==="get"||b==="debug"||b==="wait"){let r=ke(b,e);r&&(console.log(`${r}
114
- `),process.exit(0))}if(M==="shell"){let r=Te("shell",e);r&&(console.log(`${r}
115
- `),process.exit(0))}let t=Te("inspect",e),n=["do","get","debug","wait"].map(r=>ke(r,e)).filter(r=>r!=null).join(`
116
-
117
- `);console.log(`${t??""}
118
-
119
- ${n}
120
- `),process.exit(0)}let _=f.wsPort,T=f.simId,R=f.simIdSource,J=f.commandTimeoutMs;if(g==="list"&&l.some(e=>e==="--drivers"||e==="-D")){let{buildDriverListRows:e}=await import("./drivers-G5RZDGGI.js"),t=e();console.log(` available drivers (${t.length}):
121
- `);let n=Math.max(...t.map(s=>s.id.length),6),r=Math.max(...t.map(s=>s.kind.length),4);for(let s of t){let d=s.available?"\u2713":"\u2717",m=s.id.padEnd(n),y=s.kind.padEnd(r);console.log(` ${d} ${m} ${y} ${s.description}`),s.available&&s.detail?console.log(` ${s.detail}`):!s.available&&s.reason&&console.log(` unavailable: ${s.reason}`)}return}let u=qe(f),Y=T||"default",j=new Set(["errors","warnings","requests","js","eval","reload","globals","perf","list","wait","sleep"]),D=200;function Z(e){let t=e.replace(/\s+/g," ").trim();if(!t)return"";if(/^<(!doctype html|html|\?xml)|<body[\s>]/i.test(t)){let r=/<title[^>]*>([^<]+)<\/title>/i.exec(e)?.[1]?.trim(),s=/<body[^>]*>([\s\S]*?)<\//i.exec(e)?.[1]?.replace(/<[^>]+>/g," ").replace(/\s+/g," ").trim().slice(0,80),d=r||s||"html error page";return`<html ${e.length}B> "${d}" (body elided \u2014 add --json for the full payload)`}return t.length<=D?t:`${t.slice(0,D)}\u2026 (+${t.length-D} more bytes)`}function ee(e){let t=e.displayUrl||e.url;return e.status!=null?`${e.method} ${t} -> ${e.status}${e.statusText?` ${e.statusText}`:""}`:e.error?`${e.method} ${t} -> ${e.error}`:`${e.method} ${t}`}async function $(e){let t=be()?5e3:1500;try{let{settled:n,elapsed:r}=await oe({bridge:e,maxMs:t,pollMs:32,stablePolls:2});n||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.
122
- `)}catch{}}function I(e){return!(!e||e.hit===!1||e.ok===!1||e.pointerTapHandled===!1&&!e.keyboardOpened&&!e.isTextInput)}function W(e,t){return{id:e.target?.id??e.match?.id??e.node?.id??null,testID:e.target?.testID??e.match?.testID??e.node?.testID??null,text:e.target?.text??e.target?.accessibilityLabel??e.match?.text??e.match?.accessibilityLabel??e.node?.text??t??null,type:e.target?.type??e.match?.type??e.node?.type??null}}async function L(e){let t=0,n=null,r=null;try{await oe({bridge:u,maxMs:be()?3e3:1200,pollMs:32,stablePolls:2})}catch{}let s=Date.now()+(be()?5e3:2500);for(;Date.now()<=s||t===0;){t++;let d=await e.resolve();if(n=d,d?.error==="bridge-not-ready"||d?.ambiguous||d?.nthOutOfRange)return{payload:d,result:null,attempts:t,failure:"special"};if(d&&typeof d.cx=="number"&&typeof d.cy=="number"){let y=await u.send({type:"tap",x:d.cx,y:d.cy,target:W(d,e.textFallback)});if(r=y,I(y))return{payload:d,result:y,attempts:t}}let m=s-Date.now();if(m<=0)break;try{await oe({bridge:u,maxMs:Math.min(m,700),pollMs:32,stablePolls:2})}catch{await Q(Math.min(120,m))}}return{payload:n,result:r,attempts:t,failure:n&&typeof n.cx=="number"?"missed":"not-found"}}function z(e,t){console.error(` tap failed: ${e} stayed visible but did not receive a hittable press after ${t.attempts} attempt${t.attempts===1?"":"s"}`),t.result&&console.error(` last result: ${JSON.stringify(t.result)}`)}async function te(){try{return await u.send({type:"evaluate",code:`(() => ({
123
- console: window.__sootsimConsole?.count?.() || null,
124
- requests: window.__sootsimTest?.getRequestCounts?.() || null,
125
- }))()`})||{console:null,requests:null}}catch{return{console:null,requests:null}}}async function ne(e={}){let t=e.counts!==void 0?e.counts:await X(u,"getRequestCounts");if(!t||typeof t!="object")return;let n=Math.max(0,Number(t.failed)||0);if(n===0||!e.includeTail&&!Pe("requests",Y,String(n))||(console.log(`
126
- network: ${n} failed request${n===1?"":"s"}`),console.log(` inspect: ${h("requests")} 5`),!e.includeTail))return;let r=await X(u,"getFailedRequests",5);if(!(!Array.isArray(r)||r.length===0)){console.log(`
127
- recent failed requests:
128
- `);for(let s of r){let d=re(s.timestamp);console.log(` [${d}] ${ee(s)}`),s.responseBody?console.log(` ${Z(s.responseBody)}`):s.error&&console.log(` ${s.error}`)}}}async function fe(e={}){let t=e.counts!==void 0?e.counts:await u.send({type:"evaluate",code:"window.__sootsimConsole?.count?.() || { errors: 0, warnings: 0, total: 0 }"});if(!t||typeof t!="object")return;let n=t,r=Math.max(0,Number(n.errors)||0),s=Math.max(0,Number(n.warnings)||0);if(r===0&&s===0||!e.includeTail&&!Pe("console",Y,`${r}:${s}`))return;let d=[];if(r>0&&d.push(`${r} console error${r===1?"":"s"}`),s>0&&d.push(`${s} console warning${s===1?"":"s"}`),console.log(`
129
- console: ${d.join(", ")}`),console.log(` inspect: ${h("errors")} 5`),s>0&&console.log(` inspect: ${h("warnings")} 5`),!e.includeTail||r===0)return;let m=await u.send({type:"evaluate",code:"window.__sootsimConsole?.getErrors?.(5) || []"});if(!(!Array.isArray(m)||m.length===0)){console.log(`
130
- recent console errors:
131
- `);for(let y of m){let p=re(y.timestamp),x=Array.isArray(y.args)?y.args.map(A=>typeof A=="object"?JSON.stringify(A):String(A)).join(" "):String(y);console.log(` [${p}] ${x}`)}}}let B=["console","fetch","toast","alert","notification","screen","app-launch","keyboard","route","actionsheet","picker","shell","scroll","gesture","text-input","animation","reanimated"];async function ae(e){let t=Je(),n=null;try{n=await He(e,`(() => {
132
- const tl = window.SootSim && window.SootSim.bridges && window.SootSim.bridges.timeline
133
- if (!tl || typeof tl.summary !== 'function') return null
134
- const cursorKey = ${JSON.stringify(t)}
135
- const summary = tl.summary({ sinceCursor: cursorKey })
136
- let consoleSplit = null
137
- if (summary && summary.byKind && summary.byKind.console) {
138
- const events = tl.recent({ sinceCursor: cursorKey, kinds: 'console', limit: 100000 }).events
139
- consoleSplit = { error: 0, warn: 0 }
140
- for (const ev of events) {
141
- const lvl = ev && ev.data && ev.data.level
142
- if (lvl === 'error') consoleSplit.error++
143
- else if (lvl === 'warn') consoleSplit.warn++
144
- }
145
- }
146
- return summary ? { summary, consoleSplit } : null
147
- })()`)}catch{return}if(!n||!n.summary||!n.summary.total)return;let r=n.summary.byKind??{},s=[],d=new Set;for(let m of B){let y=r[m];if(y)if(d.add(m),m==="console"&&n.consoleSplit){let{error:p,warn:x}=n.consoleSplit;p>0&&s.push(`${p} error${p===1?"":"s"}`),x>0&&s.push(`${x} warning${x===1?"":"s"}`)}else s.push(`${y} ${m}${y===1?"":"s"}`)}for(let[m,y]of Object.entries(r))!d.has(m)&&y&&s.push(`${y} ${m}${y===1?"":"s"}`);if(s.length!==0&&(console.log(`
148
- since last: ${s.join(" \xB7 ")} \u2014 sootsim what-happened`),n.summary.lastAt))try{await Me(e,"SootSim.bridges.timeline.cursorAdvance",t,n.summary.lastAt)}catch{}}let ce=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"]),Gt=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"]),Xt=(o.includes("--verbose")||o.includes("-v"))&&!o.includes("--json");b==="do"&&g==="shell"&&(console.error(" `sootsim do shell` was removed. use `sootsim shell ...` instead."),process.exit(1)),ce.has(g)&&await We(u),Gt.has(g)&&await ye(u,{verbose:Xt});try{switch(g){case"list":{await Mt({bridge:u,simId:T,args:l});break}case"tree":{await At({bridge:u,args:l,positional:a});break}case"a11y":{let e=await Ve(u);if(!Array.isArray(e)||e.length===0){console.log(" no accessible nodes found");break}if(o.includes("--json"))console.log(JSON.stringify(e,null,2));else{console.log(` accessibility tree (${e.length} nodes):
149
- `);for(let t of e){let n=[];if(n.push(`[${t.role}]`),t.label){let r=t.label.length>50?t.label.slice(0,47)+"...":t.label;n.push(`"${r}"`)}if(t.hint&&n.push(`(hint: "${t.hint}")`),t.testID&&n.push(`#${t.testID}`),t.state){let r=[];t.state.disabled&&r.push("disabled"),t.state.selected&&r.push("selected"),t.state.checked===!0&&r.push("checked"),t.state.checked==="mixed"&&r.push("mixed"),t.state.busy&&r.push("busy"),t.state.expanded===!0&&r.push("expanded"),t.state.expanded===!1&&r.push("collapsed"),r.length&&n.push(`{${r.join(", ")}}`)}t.position&&n.push(`@(${t.position.x},${t.position.y})`),t.size&&n.push(`${t.size.w}x${t.size.h}`),console.log(" "+n.join(" "))}}break}case"find":{await kt({bridge:u,args:o,effectiveArgs:l,positional:a,inspectUsage:S});break}case"count":{await vt(u,{args:l});break}case"keyboard":{await Tt(u,{json:o.includes("--json")});break}case"screens":{await Nt(u,{json:o.includes("--json")});break}case"memory":{await It(u,{args:l});break}case"wait":{await Ot({wsPort:_,commandTimeoutMs:J,simId:T,simIdSource:R,positional:a});break}case"sleep":{await _t({positional:a,inspectUsage:S});break}case"settle":{await Ft({bridge:u,args:o,positional:a});break}case"ready":{await Dt({bridge:u,args:o});break}case"idle":{await Ct({bridge:u,args:o,positional:a});break}case"selector":{await Bt({bridge:u,args:o,positional:a,inspectUsage:S});break}case"event":{await Et({bridge:u,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 u.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((y,p)=>o[p-1]==="--output")||"/tmp/sootsim-inspect.png",n=await Wt(o,u),r={type:"screenshot"};n&&(r.crop=n);let d=(await u.send(r)).replace(/^data:image\/png;base64,/,"");n&&console.log(` area: x=${n.x} y=${n.y} w=${n.w} h=${n.h}`),(await import("fs")).writeFileSync(t,Buffer.from(d,"base64")),console.log(` saved: ${t}`);break}case"sample-color":{let e=await Wt(o,u);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 u.send({type:"evaluate",code:yt(e)});if(o.includes("--json"))console.log(JSON.stringify(t,null,2));else{let{r:n,g:r,b:s,a:d,hex:m,samples:y}=t,p=e.w===1&&e.h===1?`@(${e.x},${e.y})`:`@(${e.x},${e.y}) ${e.w}x${e.h}`;console.log(` ${m} rgba(${n}, ${r}, ${s}, ${d}) ${p} ${y} 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 u.send({type:"evaluate",code:`(async () => {
150
- const t = window.__sootsimTest
151
- const q = ${JSON.stringify(e)}
152
- let node = null
153
- let via = null
154
- if (t.findByTestId) { node = await t.findByTestId(q); if (node) via = 'testID' }
155
- if (!node && t.findById) { node = await t.findById(q); if (node) via = 'id' }
156
- if (!node && t.findByText) { node = await t.findByText(q); if (node) via = 'text' }
157
- if (!node) return { matcher: q, found: false }
158
-
159
- // read the resolved transform (if any) off the style \u2014 useful
160
- // because canvas nodes often animate via transform and describe
161
- // output strips that.
162
- const transform =
163
- node.style && Array.isArray(node.style.transform)
164
- ? node.style.transform
165
- : node.style && node.style.transform
166
- ? node.style.transform
167
- : null
168
-
169
- // parent chain \u2014 walk up from the node so the JSON dump is
170
- // self-describing.
171
- const parentChain = []
172
- const root = window.__sootsimRoot
173
- if (root && node.id != null) {
174
- const findPath = (n, targetId, path) => {
175
- if (!n) return null
176
- if (n.id === targetId) return path
177
- if (n.children) {
178
- for (const child of n.children) {
179
- const nextPath = [
180
- ...path,
181
- {
182
- type: n.type || 'view',
183
- testID: n.props?.testID || null,
184
- text: n.text || null,
185
- },
186
- ]
187
- const found = findPath(child, targetId, nextPath)
188
- if (found) return found
189
- }
190
- }
191
- return null
192
- }
193
- const chain = findPath(root, node.id, [])
194
- if (chain) parentChain.push(...chain)
195
- }
196
-
197
- return {
198
- matcher: q,
199
- found: true,
200
- resolvedVia: via,
201
- node,
202
- transform,
203
- parentChain,
204
- }
205
- })()`});console.log(JSON.stringify(t,null,2));break}case"tap":{let e=Number(a[1]),t=Number(a[2]),n=pe(o);if(n){let d=await L({textFallback:n.mode==="text"?n.value:void 0,resolve:async()=>{let p=await xe(u,n);return p?{cx:p.x,cy:p.y,match:{id:n.mode==="testid"?n.value:p.id??null,testID:n.mode==="testid"?n.value:p.testID??null,text:n.mode==="text"?n.value:p.text??null,type:p.type??null},target:{id:p.id??null,testID:p.testID??null,text:p.text??null,type:p.type??null}}:null}}),m=d.payload;(!m||typeof m.cx!="number")&&(console.error(` not found: ${n.value}`),n.mode==="testid"&&V("wait-selector-for-missing-testid",n.value),process.exit(1)),I(d.result)||(z(`${n.mode} "${n.value}"`,d),process.exit(1));let y=Ut(m.cx,m.cy,d.result);y&&await q("inspect tap",y.step,y.summary),console.log(JSON.stringify({...d.attempts>1?{attempts:d.attempts}:{},...d.result},null,2));break}(!Number.isFinite(e)||!Number.isFinite(t))&&(console.error(S("tap","<x> <y> | --testid <id> | --text <t>")),process.exit(1));let r=await u.send({type:"tap",x:e,y:t}),s=Ut(e,t,r);s&&await q("inspect tap",s.step,s.summary),console.log(JSON.stringify(r,null,2));break}case"drag":case"swipe":{let e=Number(a[1]),t=Number(a[2]),n=Number(a[3]),r=Number(a[4]),s=g==="swipe"?10:12,d=g==="swipe"?8:16,m=a[5]?Number(a[5]):s,y=a[6]?Number(a[6]):d;(!Number.isFinite(e)||!Number.isFinite(t)||!Number.isFinite(n)||!Number.isFinite(r)||!Number.isFinite(m)||!Number.isFinite(y))&&(console.error(S(g,"<x1> <y1> <x2> <y2> [steps] [stepMs]")),process.exit(1));let p=await u.send({type:"evaluate",code:`(async () => {
206
- const interact = window.__sootsimInteract
207
- if (!interact?.drag) return { ok: false, reason: 'no interact.drag' }
208
- const value = await interact.drag(${e}, ${t}, ${n}, ${r}, ${Math.max(1,Math.round(m))}, ${Math.max(0,Math.round(y))})
209
- return { ok: !!value, value }
210
- })()`});if(p?.ok){let x=Math.max(1,Math.round(Math.max(1,m)*Math.max(0,y)));await q(`inspect ${g}`,{swipe:{start:`${e}, ${t}`,end:`${n}, ${r}`,duration:x}},`${g} ${e},${t} -> ${n},${r}`)}console.log(JSON.stringify(p,null,2));break}case"pinch":{let e=Number(a[1]),t=Number(a[2]),n=Number(a[3]),r=Number(a[4]),s=Number(a[5]),d=Number(a[6]),m=Number(a[7]),y=Number(a[8]),p=a[9]?Number(a[9]):12,x=a[10]?Number(a[10]):16;(!Number.isFinite(e)||!Number.isFinite(t)||!Number.isFinite(n)||!Number.isFinite(r)||!Number.isFinite(s)||!Number.isFinite(d)||!Number.isFinite(m)||!Number.isFinite(y)||!Number.isFinite(p)||!Number.isFinite(x))&&(console.error(S("pinch","<x1> <y1> <x2> <y2> <x1'> <y1'> <x2'> <y2'> [steps] [stepMs]")),process.exit(1));let A=await u.send({type:"evaluate",code:`(async () => {
211
- const interact = window.__sootsimInteract
212
- if (!interact?.pinch) return { ok: false, reason: 'no interact.pinch' }
213
- const value = await interact.pinch(${e}, ${t}, ${n}, ${r}, ${s}, ${d}, ${m}, ${y}, ${Math.max(1,Math.round(p))}, ${Math.max(0,Math.round(x))})
214
- return { ok: !!value, value }
215
- })()`});A?.ok&&await q("inspect pinch",{pinch:{from:[e,t,n,r],to:[s,d,m,y],steps:Math.max(1,Math.round(p)),stepMs:Math.max(0,Math.round(x))}},`pinch (${e},${t}) (${n},${r}) -> (${s},${d}) (${m},${y})`),console.log(JSON.stringify(A,null,2));break}case"tap-text":{let e=a[1];e||(console.error(S("tap-text","<text>")),process.exit(1));let t=G=>{let O=o.indexOf(G);return O>=0&&O+1<o.length?o[O+1]:null},n=G=>o.includes(G),r=t("--nth")??t("--index"),s=r!==null?Number(r):null;s!==null&&!Number.isFinite(s)&&(console.error(` --nth/--index requires an integer, got: ${r}`),process.exit(1));let d=t("--within"),m=t("--role"),y=n("--exact"),p=n("--first"),x=t("--min-y"),A=t("--max-y"),H=t("--min-x"),U=t("--max-x");for(let[G,O]of[["--min-y",x],["--max-y",A],["--min-x",H],["--max-x",U]])O!==null&&!Number.isFinite(Number(O))&&(console.error(` ${G} requires a number, got: ${O}`),process.exit(1));let K=o.indexOf("--near"),N=null;if(K>=0){let G=Number(o[K+1]),O=Number(o[K+2]);(!Number.isFinite(G)||!Number.isFinite(O))&&(console.error(" --near requires two numbers: --near <x> <y>"),process.exit(1)),N={x:G,y:O}}let w=JSON.stringify({query:e,exact:y,role:m,within:d,minX:H!==null?Number(H):null,maxX:U!==null?Number(U):null,minY:x!==null?Number(x):null,maxY:A!==null?Number(A):null,near:N,nth:s,first:p}),P=await L({textFallback:e,resolve:()=>u.send({type:"evaluate",code:`(async () => {
216
- const t = window.__sootsimTest
217
- if (!t) return { error: 'bridge-not-ready' }
218
- const F = ${w}
219
-
220
- const res = await t.queryTextCandidates({
221
- query: F.query,
222
- exact: !!F.exact,
223
- ...(F.role ? { role: F.role } : {}),
224
- })
225
-
226
- let candidates = res.candidates || []
227
-
228
- candidates = candidates.filter((c) => {
229
- const ax = c.info.absolutePosition && c.info.absolutePosition.x
230
- const ay = c.info.absolutePosition && c.info.absolutePosition.y
231
- if (F.minX !== null && !(ax >= F.minX)) return false
232
- if (F.maxX !== null && !(ax <= F.maxX)) return false
233
- if (F.minY !== null && !(ay >= F.minY)) return false
234
- if (F.maxY !== null && !(ay <= F.maxY)) return false
235
- if (F.within && !c.ancestorTestIDs.includes(F.within)) return false
236
- return true
237
- })
238
-
239
- if (F.near) {
240
- candidates.sort((a, b) => {
241
- const ax = (a.info.absolutePosition && a.info.absolutePosition.x) || 0
242
- const ay = (a.info.absolutePosition && a.info.absolutePosition.y) || 0
243
- const bx = (b.info.absolutePosition && b.info.absolutePosition.x) || 0
244
- const by = (b.info.absolutePosition && b.info.absolutePosition.y) || 0
245
- return (
246
- Math.hypot(ax - F.near.x, ay - F.near.y) -
247
- Math.hypot(bx - F.near.x, by - F.near.y)
248
- )
249
- })
250
- } else {
251
- candidates.sort((a, b) => {
252
- const ay = (a.info.absolutePosition && a.info.absolutePosition.y) || 0
253
- const by = (b.info.absolutePosition && b.info.absolutePosition.y) || 0
254
- if (Math.abs(ay - by) > 2) return ay - by
255
- const ax = (a.info.absolutePosition && a.info.absolutePosition.x) || 0
256
- const bx = (b.info.absolutePosition && b.info.absolutePosition.x) || 0
257
- return ax - bx
258
- })
259
- }
260
-
261
- const total = candidates.length
262
- if (total === 0) return { matched: 0, total: 0 }
263
-
264
- let idx = 0
265
- if (F.nth !== null) {
266
- idx = F.nth < 0 ? total + F.nth : F.nth
267
- if (idx < 0 || idx >= total) {
268
- return { matched: 0, total, nthOutOfRange: true, nth: F.nth }
269
- }
270
- } else if (total > 1 && !F.first && !F.near) {
271
- return {
272
- ambiguous: true,
273
- total,
274
- candidates: candidates.slice(0, 10).map((c, i) => ({
275
- idx: i,
276
- nodeId: c.info.nodeId,
277
- type: c.info.type,
278
- testID: c.info.testID,
279
- text: (c.info.text || '').slice(0, 60),
280
- abs: c.info.absolutePosition,
281
- layout: c.info.layout
282
- ? {
283
- width: Math.round(c.info.layout.width || 0),
284
- height: Math.round(c.info.layout.height || 0),
285
- }
286
- : null,
287
- ancestorTestIDs: (c.ancestorTestIDs || []).slice(0, 5),
288
- })),
289
- }
290
- }
291
-
292
- const picked = candidates[idx]
293
- const n = picked.info
294
- if (!n.absolutePosition || !n.layout) return { matched: 0, total }
295
-
296
- const resolved =
297
- typeof n.nodeId === 'number' &&
298
- typeof t.resolveTapTarget === 'function'
299
- ? await t.resolveTapTarget(n.nodeId)
300
- : null
301
- const target = (resolved && resolved.target) || n
302
- const cx =
303
- resolved && typeof resolved.cx === 'number'
304
- ? resolved.cx
305
- : n.absolutePosition.x + (n.layout.width || 0) / 2
306
- const cy =
307
- resolved && typeof resolved.cy === 'number'
308
- ? resolved.cy
309
- : n.absolutePosition.y + (n.layout.height || 0) / 2
310
- return {
311
- cx,
312
- cy,
313
- match: {
314
- nodeId: n.nodeId ?? null,
315
- id: n.id,
316
- testID: n.testID,
317
- type: n.type,
318
- },
319
- target: {
320
- nodeId: target.nodeId ?? null,
321
- id: target.id,
322
- testID: target.testID,
323
- text:
324
- target.text ??
325
- target.accessibilityLabel ??
326
- n.text ??
327
- n.accessibilityLabel ??
328
- null,
329
- type: target.type,
330
- },
331
- strategy: (resolved && resolved.strategy) || 'matched-node',
332
- total,
333
- idx,
334
- }
335
- })()`})}),F=P.payload;if(F?.error==="bridge-not-ready"&&(console.error(" sootsim test bridge not ready"),process.exit(1)),F?.ambiguous){let G=F.candidates;console.error(` ambiguous: ${F.total} matches for "${e}"`);for(let O of G){let Vt=O.abs?`@(${Math.round(O.abs.x)},${Math.round(O.abs.y)})`:"",Qt=O.layout?` ${O.layout.width}x${O.layout.height}`:"",Zt=O.testID?` #${O.testID}`:"",eo=O.text?` "${O.text}"`:"",to=O.ancestorTestIDs.length>0?` within ${O.ancestorTestIDs.slice(0,3).map(oo=>`#${oo}`).join(" > ")}`:"";console.error(` [${O.idx}] <${O.type}>${eo}${Zt} ${Vt}${Qt}${to}`)}F.total>G.length&&console.error(` ... and ${F.total-G.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)}F?.nthOutOfRange&&(console.error(` not found: nth ${F.nth} of ${F.total} match${F.total===1?"":"es"} for "${e}"`),process.exit(1)),(!F||typeof F.cx!="number")&&(console.error(` not found: ${e}`),process.exit(1)),I(P.result)||(z(`text "${e}"`,P),process.exit(1));let de=Ce(e,{id:F.target?.id??null,testID:F.target?.testID??null,type:F.target?.type??null,cx:F.cx,cy:F.cy},"text");await q("inspect tap-text",de.step,de.summary),console.log(JSON.stringify({matched:F.match,tapped:{nodeId:F.target?.nodeId??null,id:F.target?.id??null,testID:F.target?.testID??null,type:F.target?.type??null,cx:F.cx,cy:F.cy},...F.strategy&&F.strategy!=="matched-node"?{strategy:F.strategy}:{},...F.total>1||s!==null?{nth:{index:F.idx,total:F.total}}:{},...P.attempts>1?{attempts:P.attempts}:{},result:P.result},null,2));break}case"tap-best":{let e=a[1];e||(console.error(S("tap-best","<query>")),process.exit(1));let t=JSON.stringify(e),r=await L({textFallback:e,resolve:async()=>{let y=await u.send({type:"evaluate",code:`(async () => {
336
- const t = window.__sootsimTest
337
- if (!t) return { error: 'bridge-not-ready' }
338
- // try testID first \u2014 strongest signal of "this is the
339
- // intended tap target".
340
- const byTestId =
341
- (await t.findByTestId(${t})) || (await t.findById(${t}))
342
- if (byTestId && byTestId.absolutePosition && byTestId.layout) {
343
- return {
344
- strategy: 'testid',
345
- node: {
346
- nodeId: byTestId.nodeId ?? null,
347
- id: byTestId.id,
348
- testID: byTestId.testID,
349
- type: byTestId.type,
350
- text: byTestId.text,
351
- absolutePosition: byTestId.absolutePosition,
352
- layout: byTestId.layout,
353
- },
354
- }
355
- }
356
- // text fallback. findByText returns null when there are
357
- // 0 or 2+ matches \u2014 to disambiguate we'd send the user
358
- // back to tap-text with --nth, which is the right
359
- // failure mode.
360
- const byText = await t.findByText(${t})
361
- if (byText && byText.absolutePosition && byText.layout) {
362
- return {
363
- strategy: 'text',
364
- node: {
365
- nodeId: byText.nodeId ?? null,
366
- id: byText.id,
367
- testID: byText.testID,
368
- type: byText.type,
369
- text: byText.text,
370
- absolutePosition: byText.absolutePosition,
371
- layout: byText.layout,
372
- },
373
- }
374
- }
375
- return { strategy: 'none' }
376
- })()`});if(!("node"in y))return y;let p=y.node,x=p.absolutePosition.x+p.layout.width/2,A=p.absolutePosition.y+p.layout.height/2;return{...y,cx:x,cy:A,target:{id:p.id,testID:p.testID,text:y.strategy==="text"?e:p.text,type:p.type}}}}),s=r.payload;s||(console.error(` tap-best: no testID or visible text matched "${e}". try \`sootsim find --interactive-targets\` to list candidates.`),process.exit(1)),"error"in s&&(console.error(` ${s.error}`),process.exit(1)),s.strategy==="none"&&(console.error(` tap-best: no testID or visible text matched "${e}". try \`sootsim find --interactive-targets\` to list candidates.`),process.exit(1));let d=s.node;I(r.result)||(z(`best "${e}"`,r),process.exit(1));let m=Ce(e,{id:d.id,testID:d.testID,type:d.type,cx:s.cx,cy:s.cy},s.strategy==="testid"?"id":"text");await q("inspect tap-best",m.step,m.summary),console.log(JSON.stringify({matched:{strategy:s.strategy,nodeId:d.nodeId,id:d.id,testID:d.testID,type:d.type,text:d.text},tapped:{cx:s.cx,cy:s.cy},...r.attempts>1?{attempts:r.attempts}:{},result:r.result},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),r=await L({resolve:()=>u.send({type:"evaluate",code:`(async () => {
377
- const t = window.__sootsimTest
378
- if (!t) return null
379
- const n = (await t.findByTestId(${t})) || (await t.findById(${t}))
380
- if (!n || !n.absolutePosition || !n.layout) return { cx: null }
381
- const resolved =
382
- typeof n.nodeId === 'number' && typeof t.resolveTapTarget === 'function'
383
- ? await t.resolveTapTarget(n.nodeId)
384
- : null
385
- const target = (resolved && resolved.target) || n
386
- const cx =
387
- resolved && typeof resolved.cx === 'number'
388
- ? resolved.cx
389
- : n.absolutePosition.x + (n.layout.width || 0) / 2
390
- const cy =
391
- resolved && typeof resolved.cy === 'number'
392
- ? resolved.cy
393
- : n.absolutePosition.y + (n.layout.height || 0) / 2
394
- return {
395
- cx,
396
- cy,
397
- match: {
398
- nodeId: n.nodeId ?? null,
399
- id: n.id,
400
- testID: n.testID,
401
- text: n.text ?? n.accessibilityLabel ?? null,
402
- type: n.type,
403
- },
404
- target: {
405
- nodeId: target.nodeId ?? null,
406
- id: target.id,
407
- testID: target.testID,
408
- text:
409
- target.text ??
410
- target.accessibilityLabel ??
411
- n.text ??
412
- n.accessibilityLabel ??
413
- null,
414
- type: target.type,
415
- },
416
- strategy: (resolved && resolved.strategy) || 'matched-node',
417
- }
418
- })()`})}),s=r.payload;(!s||typeof s.cx!="number")&&(console.error(` not found: ${e}`),await So(u,e),process.exit(1)),I(r.result)||(z(`id "${e}"`,r),process.exit(1));let d=Ce(e,{id:s.target?.id??null,testID:s.target?.testID??null,type:s.target?.type??null,cx:s.cx,cy:s.cy},"id");await q("inspect tap-id",d.step,d.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}:{},...r.attempts>1?{attempts:r.attempts}:{},result:r.result},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 n=JSON.stringify(e),r=await u.send({type:"evaluate",code:`(async () => {
419
- const t = window.__sootsimTest
420
- if (!t) return null
421
- const n = await (t.findByTestId(${n}) || t.findById(${n}))
422
- if (!n || !n.absolutePosition || !n.layout) return null
423
- return {
424
- cx: n.absolutePosition.x + (n.layout.width || 0) / 2,
425
- cy: n.absolutePosition.y + (n.layout.height || 0) / 2,
426
- id: n.id,
427
- testID: n.testID,
428
- type: n.type,
429
- isTextInput: !!n.isTextInput,
430
- placeholder: n.placeholder || null,
431
- }
432
- })()`});(!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 s=await u.send({type:"tap",x:r.cx,y:r.cy,target:{id:r.id??e,testID:r.testID??e,text:null,type:r.type??null}}),d=await Po(u);d.visible||(console.error(` keyboard did not open after tapping ${e}`),process.exit(1));let m=d.focusedInput;m&&(m.testID===e||m.id===e||(console.error(` focus routing mismatch after tap: requested ${JSON.stringify(e)} but focus is on ${JSON.stringify(m.testID??m.id??null)}. did the tap land on an outer Pressable wrapper?`),process.exit(1))),await u.send({type:"keyboard",action:"type",text:t}),await q("inspect type-into",{tapOn:{id:e},inputText:t},`type-into #${e} ${JSON.stringify(t)}`),console.log(JSON.stringify({target:e,isTextInput:r.isTextInput,keyboardOpened:d.visible??s?.keyboardOpened??!1,focusedInput:d.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 Se(u,"type"),await u.send({type:"keyboard",action:"type",text:e}),await q("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 Se(u,"key"),await u.send({type:"keyboard",action:"press",text:e}),await q("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 Se(u,"key-sequence");for(let t of e)await u.send({type:"keyboard",action:"press",text:t});await q("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:Oo(r)})),n=t.filter(r=>!r.key);n.length>0&&(console.error(` unsupported keycode(s): ${n.map(r=>r.code).join(", ")}`),process.exit(1)),await Se(u,"keycode");for(let r of t)await u.send({type:"keyboard",action:"press",text:r.key});await q("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 u.send({type:"keyboard",action:"dispatchKey",text:e}),await q("inspect dispatch",{dispatchKey:e},`dispatch ${JSON.stringify(e)}`),console.log(` dispatched: ${e}`);break}case"dismiss":{await u.send({type:"keyboard",action:"dismiss"}),await q("inspect dismiss",{hideKeyboard:!0},"dismiss keyboard"),console.log(" keyboard dismissed");break}case"double-tap":{let e=Number(a[1]),t=Number(a[2]),n=pe(o);if(n){let m=await xe(u,n);m||(console.error(` not found: ${n.value}`),n.mode==="testid"&&V("wait-selector-for-missing-testid",n.value),process.exit(1)),e=m.x,t=m.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 s=Math.max(0,Math.round(r)),d=await u.send({type:"evaluate",code:`(async () => {
433
- const interact = window.__sootsimInteract
434
- if (interact?.doubleTap) {
435
- return {
436
- ok: !!(await interact.doubleTap(${e}, ${t}, ${s})),
437
- gapMs: ${s},
438
- }
439
- }
440
- if (!interact?.tap) {
441
- return { ok: false, reason: 'no interact.tap', gapMs: ${s} }
442
- }
443
- const first = await interact.tap(${e}, ${t})
444
- if (!first || first.hit === false) {
445
- return { ok: false, reason: 'first tap missed', gapMs: ${s}, first }
446
- }
447
- await new Promise((resolve) => setTimeout(resolve, ${s}))
448
- const second = await interact.tap(${e}, ${t})
449
- return {
450
- ok: !!second && second.hit !== false,
451
- gapMs: ${s},
452
- first,
453
- second,
454
- }
455
- })()`});d?.ok&&await q("inspect double-tap",{doubleTapAtCoords:{x:e,y:t,gapMs:s}},`double-tap @${e},${t}`),console.log(JSON.stringify(d,null,2));break}case"long-press":{let e=Number(a[1]),t=Number(a[2]),n=pe(o);if(n){let d=await xe(u,n);d||(console.error(` not found: ${n.value}`),n.mode==="testid"&&V("wait-selector-for-missing-testid",n.value),process.exit(1)),e=d.x,t=d.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 s=await u.send({type:"evaluate",code:`(async () => {
456
- const interact = window.__sootsimInteract
457
- if (!interact?.longPress) return { ok: false, reason: 'no interact.longPress' }
458
- const value = await interact.longPress(${e}, ${t}, ${Math.max(0,Math.round(r))})
459
- return { ok: !!value, value }
460
- })()`});s?.ok&&await q("inspect long-press",{tapAtCoords:{x:e,y:t}},`long-press @${e},${t}`),console.log(JSON.stringify(s,null,2));break}case"touch":{let e=a[1],t=Number(a[2]),n=Number(a[3]),r=a[4]?Number(a[4]):999,s=e==="down"?"touchDown":e==="move"?"touchMove":e==="up"?"touchUp":e==="cancel"?"touchCancel":null;s||(console.error(S("touch","<down|move|up|cancel> <x> <y> [pointerId]")),process.exit(1)),e!=="cancel"&&(!Number.isFinite(t)||!Number.isFinite(n))&&(console.error(S("touch","<down|move|up|cancel> <x> <y> [pointerId]")),process.exit(1));let d=e==="down"?"tap":e==="move"?"move":null,m=d&&Number.isFinite(t)&&Number.isFinite(n)?`window.dispatchEvent(new CustomEvent('sootsim:agentAction', { detail: { type: '${d}', x: ${t}, y: ${n} } }));`:"",y=await u.send({type:"evaluate",code:`(async () => {
461
- ${m}
462
- const interact = window.__sootsimInteract
463
- if (!interact?.${s}) return { ok: false, reason: 'no interact.${s}' }
464
- const value = ${e==="cancel"?`await interact.${s}(${Math.max(1,Math.round(r))})`:`await interact.${s}(${t}, ${n}, ${Math.max(1,Math.round(r))})`}
465
- return { ok: !!value, value }
466
- })()`});y?.ok&&e!=="cancel"&&await q("inspect touch",{tapAtCoords:{x:t,y:n}},`touch ${e} @${t},${n}`),console.log(JSON.stringify(y,null,2));break}case"gesture":{let e=["scroll-up","scroll-down","scroll-left","scroll-right","swipe-from-left-edge","swipe-from-right-edge","swipe-from-top-edge","swipe-from-bottom-edge"],t=a[1],n=a[2]?Number(a[2]):220;(!t||!Number.isFinite(n))&&(console.error(S("gesture","<preset> [durationMs]")),console.error(` presets: ${e.join(", ")}`),process.exit(1)),e.includes(t)||(console.error(` unknown gesture preset: ${t}`),console.error(` presets: ${e.join(", ")}`),process.exit(1));let r=await u.send({type:"evaluate",code:`(async () => {
467
- const spec = globalThis.__sootsimDeviceSpec || {}
468
- return {
469
- width: spec.width || window.innerWidth || 393,
470
- height: spec.height || window.innerHeight || 852,
471
- statusBarHeight: spec.statusBarHeight || 0,
472
- homeIndicatorHeight: spec.homeIndicatorHeight || 0,
473
- }
474
- })()`}),s=Number(r?.width)||393,d=Number(r?.height)||852,m=Number(r?.statusBarHeight)||0,y=Number(r?.homeIndicatorHeight)||0,p=Math.round(s/2),x=Math.round(d/2),A=Math.max(24,m+18),H=Math.max(24,y+18),U=18,K=Math.min(220,Math.round(d*.24)),N=Math.min(180,Math.round(s*.32)),w=p,v=x,P=p,F=x;switch(t){case"scroll-up":v=x+Math.round(K/2),F=x-Math.round(K/2);break;case"scroll-down":v=x-Math.round(K/2),F=x+Math.round(K/2);break;case"scroll-left":w=p+Math.round(N/2),P=p-Math.round(N/2);break;case"scroll-right":w=p-Math.round(N/2),P=p+Math.round(N/2);break;case"swipe-from-left-edge":w=U,v=x,P=Math.min(s-U,U+N);break;case"swipe-from-right-edge":w=s-U,v=x,P=Math.max(U,s-U-N);break;case"swipe-from-top-edge":w=p,v=A,F=Math.min(d-H,A+K);break;case"swipe-from-bottom-edge":w=p,v=d-H,F=Math.max(A,d-H-K);break}let de=Math.max(8,Math.round(n/16)),G=Math.max(1,Math.round(n/de)),O=await u.send({type:"evaluate",code:`(async () => {
475
- const interact = window.__sootsimInteract
476
- if (!interact?.drag) return { ok: false, reason: 'no interact.drag' }
477
- const value = await interact.drag(${w}, ${v}, ${P}, ${F}, ${de}, ${G})
478
- return { ok: !!value, value }
479
- })()`});O?.ok&&await q("inspect gesture",{swipe:{start:`${w}, ${v}`,end:`${P}, ${F}`,duration:Math.max(1,Math.round(n))}},`gesture ${t}`),console.log(JSON.stringify({preset:t,from:{x:w,y:v},to:{x:P,y:F},result:O},null,2));break}case"scroll":{let e=pe(o),t=Eo(o),n=e?.mode==="testid"?e.value:t==null?a[1]:null,r=e||t!=null?1:2,s=Number(a[r]),d=Number(a[r+1]);(!n&&t==null||!Number.isFinite(s)||!Number.isFinite(d))&&(console.error(S("scroll","<id> <x> <y> | --testid <id> <x> <y> | --node-id <nodeId> <x> <y>")),process.exit(1));let m=await u.send({type:"evaluate",code:`(async () => {
480
- const t = window.__sootsimTest
481
- if (!t) return null
482
- const n = ${t!=null?`await t.inspectByNodeId(${JSON.stringify(t)})`:`await t.findByTestId(${JSON.stringify(n)})
483
- || await t.findById(${JSON.stringify(n)})`}
484
- if (!n || !n.absolutePosition || !n.layout) return null
485
- return {
486
- cx: n.absolutePosition.x + (n.layout.width || 0) / 2,
487
- cy: n.absolutePosition.y + (n.layout.height || 0) / 2,
488
- }
489
- })()`}),y=await X(u,"scrollTo",t!=null?{nodeId:t}:n,s,d,!1);if(y?.ok){let p=t!=null?`node ${t}`:`#${n}`;await q("inspect scroll",{scrollTo:{...t!=null?{nodeId:t}:{id:n},x:s,y:d}},`scroll ${p} -> ${s},${d}`)}console.log(JSON.stringify({...y,...m?{at:{x:m.cx,y:m.cy}}:{}},null,2));break}case"state":{let e=a[1];if(i==="get"&&!e){let n=await X(u,"getRuntimeState"),r=await u.send({type:"evaluate",code:`({
490
- errors: window.__sootsimConsole?.getErrors?.()?.length ?? 0,
491
- warnings: window.__sootsimConsole?.getWarnings?.()?.length ?? 0,
492
- })`});if(n&&typeof n=="object"&&n.diagnostics&&(n.diagnostics.errors=r?.errors??0,n.diagnostics.warnings=r?.warnings??0),n&&typeof n=="object"&&n.shell==null)try{let s=await le(u);s&&(n.shell=s)}catch{}console.log(JSON.stringify(n,null,2));break}if(!e||e==="--help"||e==="-h"){console.log(`
493
- ${h("state")} \u2014 dump raw runtime state
494
-
495
- subcommands:
496
- shell dump shell transition/layout state
497
- worker dump render-worker host/animation state
498
- keyboard dump keyboard visibility, mode, and focused input
499
- ownership dump surface ownership + pointerOnSurface delivery stats
500
- node <id> dump raw node info by id or testID
501
- scroll <id> dump scroll metrics and runtime state
502
- scroll-hit <x> <y> dump the nearest scroll ancestor at coordinates
503
- hit <x> <y> dump the hit-test ancestry at coordinates
504
- gesture <x> <y> dump gesture routing/debug info at coordinates
505
-
506
- examples:
507
- ${h("state")} shell
508
- ${h("state")} worker
509
- ${h("state")} keyboard
510
- ${h("state")} ownership
511
- ${h("state")} node photos
512
- ${h("state")} scroll feed
513
- ${h("state")} scroll-hit 360 420
514
- ${h("state")} hit 200 720
515
- `);break}let t;switch(e){case"shell":t=await le(u,500);break;case"worker":t=await Me(u,"__sootsimRenderHost.queryStats");break;case"ownership":t=await u.send({type:"evaluate",code:`(() => {
516
- const h = window.__sootsimRenderHost
517
- if (!h || typeof h.getOwnershipSnapshot !== 'function') {
518
- return { error: 'getOwnershipSnapshot not available' }
519
- }
520
- return h.getOwnershipSnapshot()
521
- })()`});break;case"keyboard":t=await u.send({type:"evaluate",code:`(async () => {
522
- const kb = window.__sootsimKeyboard
523
- const test = window.__sootsimTest
524
- if (!kb) return { error: 'keyboard bridge not available' }
525
- const layout = typeof kb.getLayout === 'function' ? kb.getLayout() : null
526
- const visible = kb.isVisible()
527
- const mode = kb.getMode()
528
- let focused = null
529
- if (test && typeof test.getFocusedNode === 'function') {
530
- try {
531
- focused = await test.getFocusedNode()
532
- } catch {}
533
- }
534
- return {
535
- visible,
536
- mode,
537
- layout,
538
- focusedInput: focused ? {
539
- nodeId: focused.nodeId ?? null,
540
- testID: focused.testID || null,
541
- id: focused.id || null,
542
- placeholder: focused.placeholder || null,
543
- text: focused.text || null,
544
- } : null,
545
- }
546
- })()`});break;case"node":{let n=a[2];n||(console.error(` usage: ${h("state")} node <id>`),process.exit(1)),t=await X(u,"findByTestId",n)||await X(u,"findById",n);break}case"scroll":{let n=a[2];n||(console.error(` usage: ${h("state")} scroll <id>`),process.exit(1)),t=await X(u,"getScrollState",n);break}case"scroll-hit":{let n=Number(a[2]),r=Number(a[3]);(!Number.isFinite(n)||!Number.isFinite(r))&&(console.error(` usage: ${h("state")} scroll-hit <x> <y>`),process.exit(1)),t=await X(u,"getScrollStateAt",n,r);break}case"hit":{let n=Number(a[2]),r=Number(a[3]);(!Number.isFinite(n)||!Number.isFinite(r))&&(console.error(` usage: ${h("state")} hit <x> <y>`),process.exit(1)),t=await X(u,"debugHitAt",n,r);break}case"gesture":{let n=Number(a[2]),r=Number(a[3]);(!Number.isFinite(n)||!Number.isFinite(r))&&(console.error(` usage: ${h("state")} gesture <x> <y>`),process.exit(1)),t=await X(u,"debugGestureAt",n,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(`
547
- ${h("shell")} \u2014 run built-in shell commands
548
-
549
- subcommands:
550
- launch <appId> [waitMs] [--clear-state]
551
- launch app and wait for settled shell state
552
- home [waitMs] go home and wait for settled shell state
553
- switcher [waitMs] open switcher and wait for settled shell state
554
- open-card <appId> [waitMs]
555
- open a specific switcher card and wait for app settle
556
- appearance <light|dark|auto|toggle>
557
- update simulator appearance
558
- lock toggle device lock state
559
- shake trigger the simulator shake gesture
560
-
561
- examples:
562
- ${h("shell")} launch photos
563
- ${h("shell")} launch rn --clear-state
564
- ${h("shell")} launch photos 1500
565
- ${h("shell")} home 500
566
- ${h("shell")} switcher 800
567
- ${h("shell")} open-card clock 800
568
- ${h("shell")} appearance dark
569
- ${h("shell")} lock
570
- `);break}let t=e==="launch"||e==="open-card"||e==="home"||e==="switcher",n=e==="launch"||e==="open-card"?a[3]:a[2],r=n?Number(n):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 s=!1,d=!1,m=null,y=o.includes("--clear-state");if(e==="launch"){let p=a[2];p||(console.error(S("shell","launch <appId> [settleMs] [--clear-state]")),process.exit(1)),y&&await u.send({type:"evaluate",code:Ue}),s=!!await ue(u,"launchApp",r,p),{settled:d,state:m}=await ve(u,Math.round(r),x=>!!x&&x.state==="app"&&x.activeApp===p&&x.showSwitcher===!1&&x.switcherPhase==="idle"&&typeof x.launchProgress=="number"&&x.launchProgress>=.98),s&&await q("inspect shell launch",y?{launchApp:{clearState:!0}}:{launchApp:{}},y?"launch app (clear state)":"launch app")}else if(e==="home")s=!!await ue(u,"goHome",r),{settled:d,state:m}=await ve(u,Math.round(r),p=>!!p&&p.state==="home"&&p.activeApp==null&&p.showSwitcher===!1&&p.switcherPhase==="idle"&&typeof p.launchProgress=="number"&&p.launchProgress>=.98);else if(e==="switcher")s=!!await ue(u,"openSwitcher",r),{settled:d,state:m}=await ve(u,Math.round(r),p=>!!p&&p.state==="app"&&p.showSwitcher===!0&&p.switcherPhase==="idle"&&typeof p.zoomLevel=="number"&&Math.abs(p.zoomLevel)<=.02&&typeof p.horizontalZoom=="number"&&Math.abs(p.horizontalZoom)<=.02),d&&(await Q(Ao),m=await le(u));else if(e==="open-card"){let p=a[2];p||(console.error(S("shell","open-card <appId> [settleMs]")),process.exit(1)),s=!!await ue(u,"openSwitcherCard",r,p),{settled:d,state:m}=await ve(u,Math.round(r),x=>!!x&&x.state==="app"&&x.activeApp===p&&x.showSwitcher===!1&&x.switcherPhase==="idle"&&typeof x.zoomLevel=="number"&&x.zoomLevel>=.98&&typeof x.horizontalZoom=="number"&&x.horizontalZoom>=.98),s&&await q("inspect shell open-card",{openSwitcherCard:{appId:p}},`open switcher card ${p}`)}else if(e==="appearance"){let p=a[2];(!p||!["light","dark","auto","toggle"].includes(p))&&(console.error(S("shell","appearance <light|dark|auto|toggle>")),process.exit(1));let x=await Ht(u,"appearance",p);if(s=!!x?.ok,m={appearance:x},s){let A=x?.applied??p;console.log(` appearance: ${A}`)}}else if(e==="lock"||e==="shake"){let p=await Ht(u,e);s=!!p?.ok,m={[e]:p}}else console.error(` unknown shell subcommand: ${e}`),process.exit(1);console.log(JSON.stringify({ok:s,settled:d,state:m},null,2));break}case"url":{await Pt(u,{args:l});break}case"reload":{let n=!1,r=!1;try{await u.send({type:"evaluate",code:"window.__sootsimConsole?.clear()"});let m=await u.send({type:"evaluate",code:`;(() => {
571
- const reloadExternalApp = window.SootSim?.bridges?.hotRemount?.reloadExternalApp
572
- if (typeof reloadExternalApp === 'function') {
573
- reloadExternalApp()
574
- return { kind: 'external-app' }
575
- }
576
- window.location.reload()
577
- return { kind: 'page' }
578
- })()`});r=!!m&&m.kind==="external-app",n=!0}catch{}console.log(" reloading...");let s=u,d=null;if(r)d=await Ae(u,{timeoutMs:1e4,errorGraceMs:3e3});else{n&&await Q(300);let m=await pt(_,J,T,{timeoutMs:1e4,simIdSource:R});m?(s=m,d=await Ae(m,{timeoutMs:1e4,errorGraceMs:3e3})):(console.log(" \u26A0 reload: bridge never reconnected within 10000ms"),s=null)}if(d)if(d.ready){let m=d.source==="nodes-fallback"?" (no ready signal, node-count fallback)":"";console.log(` ready in ${d.elapsedMs}ms: ${d.nodes} nodes${m}`)}else if(d.source==="error-bail")console.log(` \u26A0 reload bailed after ${d.elapsedMs}ms: ${d.errors} console error(s), ready signal never fired`);else{let m=Io(d);console.log(` \u26A0 reload timed out after ${d.elapsedMs}ms \u2014 ${m} (nodes: ${d.nodes}, targets: ${d.targets}, errors: ${d.errors})`)}if(s)try{let m=await s.send({type:"evaluate",code:"window.__sootsimConsole?.getErrors(10) || []"});if(s!==u&&s.close(),Array.isArray(m)&&m.length>0){console.log(`
579
- \u26A0 ${m.length} error(s) during mount:
580
- `);for(let y of m){let p=y.args.map(x=>typeof x=="object"?JSON.stringify(x):x).join(" ");if(console.log(` ${p}`),y.stack){let x=y.stack.split(`
581
- `).slice(0,2);for(let A of x)console.log(` ${A.trim()}`)}}}}catch{}d&&!d.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(` ${h("js")} SootSim.bridges.test.findByText("Sign in")`),console.error(` ${h("js")} SootSim.bridges.debug.snapshot("before")`),console.error(` ${h("js")} SootSim.bridges.keyboard.type("hello")`),console.error(` ${h("js")} SootSim.state.root.children.length`),process.exit(1));let t=e;t.startsWith("(async")||(t=`(async () => ${t})()`);let n=await u.send({type:"evaluate",code:t});console.log(JSON.stringify(n,null,2));let r=e.toLowerCase(),s=[];(r.includes("sootsim:gohome")||r.includes("gohome"))&&s.push("sootsim shell home"),(r.includes("sootsim:appswitcher")||r.includes("appswitcher"))&&s.push("sootsim shell switcher"),(r.includes("keyboard.isvisible")||r.includes("keyboard.getmode"))&&s.push("sootsim debug state keyboard"),r.includes("interact.tap")&&s.push("sootsim do tap <x> <y>"),r.includes("keyboard.type")&&s.push("sootsim do type <text>"),(r.includes("keyboard.press")||r.includes("keyboard.dispatchkey"))&&s.push("sootsim do key <name>"),r.includes("keyboard.dismiss")&&s.push("sootsim do dismiss"),r.includes("dumptree")&&s.push("sootsim get tree"),r.includes("dumpaccessibilitytree")&&s.push("sootsim get a11y"),r.includes("getnodecount")&&s.push("sootsim get count"),r.includes("findbytext")&&s.push("sootsim find <text>"),(r.includes("findbytestid")||r.includes("findbyid"))&&s.push("sootsim find --testid <id>"),r.includes("document.hidden")&&s.push("sootsim debug state keyboard (includes tab health)"),s.length>0&&V("prefer-cli-over-eval",s);break}case"globals":{let e=await u.send({type:"evaluate",code:`(async () => {
582
- const globals = {}
583
-
584
- // test bridge (proxy in worker mode)
585
- const testMethods = [
586
- 'findById', 'findByTestId', 'findByText', 'findByLabel', 'findByRole',
587
- 'findAllByRole', 'findByA11yState', 'findAllByA11yState', 'findByHint',
588
- 'findPressable', 'getStyle', 'getLayout', 'getAbsolutePosition', 'isVisible',
589
- 'queryAll', 'dumpTree', 'dumpAccessibilityTree', 'getNodeCount', 'getShellState',
590
- 'getScrollState', 'getScrollStateAt', 'scrollTo', 'waitForTree',
591
- 'waitForScreenTransitions', 'debugByText', 'debugByTestId', 'debugHitAt',
592
- 'debugGestureAt'
593
- ]
594
- globals['test (\u2192 __sootsimTest)'] = testMethods
595
-
596
- // debug
597
- if (window.__sootsimDebug) {
598
- globals['debug (\u2192 __sootsimDebug)'] = Object.keys(window.__sootsimDebug)
599
- }
600
-
601
- // interact
602
- if (window.__sootsimInteract) {
603
- globals['interact (\u2192 __sootsimInteract)'] = Object.keys(window.__sootsimInteract)
604
- }
605
-
606
- // keyboard
607
- if (window.__sootsimKeyboard) {
608
- globals['keyboard (\u2192 __sootsimKeyboard)'] = Object.keys(window.__sootsimKeyboard)
609
- }
610
-
611
- // other globals
612
- globals['other'] = [
613
- 'root (\u2192 __sootsimRoot) - live node tree',
614
- 'render() (\u2192 __sootsimForceRender) - force re-render'
615
- ]
616
-
617
- return globals
618
- })()`});console.log(` sootsim JS API:
619
- `);for(let[t,n]of Object.entries(e)){console.log(` ${t}:`);for(let r of n)console.log(` .${r}`);console.log("")}console.log(` use: ${h("js")} <expression>`),console.log(` example: ${h("js")} test.findByText("Sign in")`);break}case"describe":{await St({bridge:u,args:o,positional:a});break}case"perf":{let e=a[1];if(!e||e==="--help"||e==="-h"){console.log(`
620
- ${h("perf")} \u2014 performance profiling
621
-
622
- subcommands:
623
- stats one-shot stats (zero overhead query)
624
- start begin recording frame times (also clears prior frames)
625
- stop stop recording and report results
626
- frames [n] get last N frame times (default: 50)
627
- worst [n] get the N slowest frames (default: 20)
628
- transition <e> profile a shell transition (goHome, appSwitcher, lockScreen)
629
-
630
- the read subcommands (stats, stop, frames, worst, transition) accept
631
- --json for a machine-readable payload on stdout.
632
-
633
- examples:
634
- ${h("perf")} stats
635
- ${h("perf")} start
636
- # ... interact with the app ...
637
- ${h("perf")} stop
638
- ${h("perf")} stop --json
639
- ${h("perf")} transition goHome
640
- `);break}switch(e){case"stats":{let t=await u.send({type:"evaluate",code:`(async () => {
641
- // worker mode (host exposes these)
642
- if (window.__sootsimPerfStats) {
643
- return await window.__sootsimPerfStats()
644
- }
645
- // main-thread mode
646
- const perf = window.__sootsimPerf
647
- const a11y = window.__sootsimA11y
648
- if (!perf && !a11y) return { error: 'no perf globals available' }
649
-
650
- const frameStats = perf?.getFrameStats?.() || {}
651
- const profile = a11y?.profile?.() || {}
652
- const nodeCount = await window.__sootsimTest?.getNodeCount?.() || 0
653
-
654
- return {
655
- frames: frameStats.frames || profile.syncCount || 0,
656
- avgMs: frameStats.totalMs && frameStats.frames
657
- ? (frameStats.totalMs / frameStats.frames).toFixed(2)
658
- : profile.avgSyncMs?.toFixed(2) || '?',
659
- maxMs: frameStats.maxMs?.toFixed(2) || profile.maxSyncMs?.toFixed(2) || '?',
660
- layoutMs: frameStats.layoutTotalMs?.toFixed(2) || '?',
661
- nodeCount,
662
- jankFrames: frameStats.recentFrames?.filter(f => f > 16.67).length || 0,
663
- recentCount: frameStats.recentFrames?.length || 0,
664
- }
665
- })()`});if(t.error&&(console.error(` error: ${t.error}`),process.exit(1)),E(l)){C(t);break}let n=t.avgMs==="?"&&t.maxMs==="?",r=t.avgMs!=="?"?(1e3/parseFloat(t.avgMs)).toFixed(1):"?";console.log(" perf stats:"),console.log(` frames: ${t.frames}`),console.log(` avg: ${t.avgMs}ms (${r} 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`),n&&process.stderr.write(`
666
- \u26A0 frame timings are zero \u2014 enable them first:
667
- sootsim debug perf start # begin recording
668
- # \u2026 interact / run a flow / wait for the transition \u2026
669
- sootsim debug perf stop # full report
670
- sootsim debug perf stats # one-shot snapshot
671
- `);break}case"start":{await u.send({type:"evaluate",code:`(async () => {
672
- // worker mode
673
- if (window.__sootsimPerfStart && window.__sootsimRenderHost) {
674
- const result = window.__sootsimPerfStart()
675
- window.${se} = {
676
- active: true,
677
- mode: 'render-worker',
678
- lastSamples: [],
679
- startedAt: performance.now(),
680
- }
681
- return result
682
- }
683
- // main-thread mode
684
- window.__sootsimPerf?.enableFrameStats?.(true)
685
- window.__sootsimA11y?.resetProfile?.()
686
- window.${se} = {
687
- active: true,
688
- mode: 'main-thread',
689
- lastSamples: [],
690
- startedAt: performance.now(),
691
- }
692
- return { started: true }
693
- })()`}),console.log(` profiling started \u2014 interact with the app, then run '${h("perf")} stop'`);break}case"stop":{let t=await u.send({type:"evaluate",code:`(async () => {
694
- // worker mode
695
- if (window.__sootsimRenderHost) {
696
- const session = window.${se} || {}
697
- const priorSamples = session.active && Array.isArray(session.lastSamples)
698
- ? session.lastSamples
699
- : []
700
- const flushedSamples = await window.__sootsimRenderHost.flushSamples()
701
- const samples = priorSamples.concat(flushedSamples)
702
- window.${se} = {
703
- ...session,
704
- active: false,
705
- mode: 'render-worker',
706
- lastSamples: samples,
707
- stoppedAt: performance.now(),
708
- }
709
-
710
- const frameTimes = samples.map(sample => sample[1])
711
- const layoutTimes = samples.map(sample => sample[2])
712
- const renderTimes = samples.map(sample => sample[3])
713
- const copyTimes = samples.map(sample => sample[4])
714
- const auxTimes = samples.map(sample => sample[5] || 0)
715
- const otherTimes = samples.map(sample => sample[6] || 0)
716
- const sorted = [...frameTimes].sort((a, b) => a - b)
717
- const total = frameTimes.reduce((a, b) => a + b, 0)
718
- const avg = frameTimes.length > 0 ? total / frameTimes.length : 0
719
- const max = Math.max(...frameTimes, 0)
720
- const layoutTotal = layoutTimes.reduce((a, b) => a + b, 0)
721
- const renderTotal = renderTimes.reduce((a, b) => a + b, 0)
722
- const copyTotal = copyTimes.reduce((a, b) => a + b, 0)
723
- const auxTotal = auxTimes.reduce((a, b) => a + b, 0)
724
- const otherTotal = otherTimes.reduce((a, b) => a + b, 0)
725
-
726
- return {
727
- mode: 'render-worker',
728
- frames: frameTimes.length,
729
- totalMs: total,
730
- avgMs: avg,
731
- maxMs: max,
732
- layoutTotalMs: layoutTotal,
733
- renderTotalMs: renderTotal,
734
- copyTotalMs: copyTotal,
735
- auxTotalMs: auxTotal,
736
- otherTotalMs: otherTotal,
737
- layoutAvgMs: frameTimes.length > 0 ? layoutTotal / frameTimes.length : 0,
738
- renderAvgMs: frameTimes.length > 0 ? renderTotal / frameTimes.length : 0,
739
- copyAvgMs: frameTimes.length > 0 ? copyTotal / frameTimes.length : 0,
740
- auxAvgMs: frameTimes.length > 0 ? auxTotal / frameTimes.length : 0,
741
- otherAvgMs: frameTimes.length > 0 ? otherTotal / frameTimes.length : 0,
742
- p50: sorted[Math.floor(sorted.length * 0.5)] || 0,
743
- p95: sorted[Math.floor(sorted.length * 0.95)] || 0,
744
- p99: sorted[Math.floor(sorted.length * 0.99)] || 0,
745
- jankFrames: frameTimes.filter((f) => f > 16.67).length,
746
- sampleCount: frameTimes.length,
747
- }
748
- }
749
- // main-thread mode
750
- const perf = window.__sootsimPerf
751
- const a11y = window.__sootsimA11y
752
- if (!perf && !a11y) return { error: 'no perf globals' }
753
-
754
- const frameStats = perf?.getFrameStats?.() || {}
755
- const profile = a11y?.profile?.() || {}
756
-
757
- // calculate distribution
758
- const recent = frameStats.recentFrames || []
759
- const sorted = [...recent].sort((a, b) => a - b)
760
- const p50 = sorted[Math.floor(sorted.length * 0.5)] || 0
761
- const p95 = sorted[Math.floor(sorted.length * 0.95)] || 0
762
- const p99 = sorted[Math.floor(sorted.length * 0.99)] || 0
763
-
764
- // disable collection
765
- perf?.disableFrameStats?.()
766
- window.${se} = {
767
- ...(window.${se} || {}),
768
- active: false,
769
- mode: 'main-thread',
770
- lastSamples: recent.map((ms, index) => [index, ms, 0, 0, 0, 0, 0]),
771
- stoppedAt: performance.now(),
772
- }
773
-
774
- return {
775
- mode: 'main-thread',
776
- frames: frameStats.frames || profile.syncCount || 0,
777
- totalMs: frameStats.totalMs || 0,
778
- avgMs: frameStats.totalMs && frameStats.frames
779
- ? frameStats.totalMs / frameStats.frames
780
- : profile.avgSyncMs || 0,
781
- maxMs: frameStats.maxMs || profile.maxSyncMs || 0,
782
- layoutTotalMs: frameStats.layoutTotalMs || 0,
783
- p50, p95, p99,
784
- jankFrames: recent.filter(f => f > 16.67).length,
785
- sampleCount: recent.length,
786
- }
787
- })()`});if(t.error&&(console.error(` error: ${t.error}`),process.exit(1)),E(l)){C(t);break}let n=t.avgMs>0?(1e3/t.avgMs).toFixed(1):"?",r=t.sampleCount>0?(t.jankFrames/t.sampleCount*100).toFixed(1):"0";console.log(` profiling stopped:
788
- `),console.log(` frames: ${t.frames}`),console.log(` total: ${t.totalMs.toFixed(1)}ms`),console.log(` avg: ${t.avgMs.toFixed(2)}ms (${n} 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 n=await u.send({type:"evaluate",code:`(async () => {
789
- if (window.__sootsimRenderHost) {
790
- const session = window.${se} || {}
791
- if (session.active) {
792
- const priorSamples = Array.isArray(session.lastSamples) ? session.lastSamples : []
793
- const flushedSamples = await window.__sootsimRenderHost.flushSamples()
794
- const samples = priorSamples.concat(flushedSamples)
795
- window.__sootsimRenderHost.startSampling()
796
- window.${se} = {
797
- ...session,
798
- active: true,
799
- mode: 'render-worker',
800
- lastSamples: samples,
801
- lastFlushAt: performance.now(),
802
- }
803
- return {
804
- mode: 'render-worker',
805
- live: true,
806
- samples: samples.slice(-${t}),
807
- }
808
- }
809
- return {
810
- mode: 'render-worker',
811
- live: false,
812
- samples: (session.lastSamples || []).slice(-${t}),
813
- }
814
- }
815
- // main-thread mode
816
- const perf = window.__sootsimPerf
817
- if (!perf) return { error: 'no __sootsimPerf (try "perf start" first)' }
818
- const stats = perf.getFrameStats?.() || {}
819
- return {
820
- mode: 'main-thread',
821
- frames: (stats.recentFrames || []).slice(-${t}),
822
- }
823
- })()`});if(n.error&&(console.error(` error: ${n.error}`),process.exit(1)),E(l)){C(n);break}if(n.mode==="render-worker"){let s=Array.isArray(n.samples)?n.samples:[];if(s.length===0){console.log(` no frame data \u2014 run '${h("perf")} start' first`);break}console.log(` last ${s.length} sampled frames (ms):`),console.log(" total layout render copy aux other t+");for(let[d,m,y,p,x,A,H]of s)console.log(` ${m.toFixed(2).padStart(7)} ${y.toFixed(2).padStart(7)} ${p.toFixed(2).padStart(7)} ${x.toFixed(2).padStart(7)} ${A.toFixed(2).padStart(6)} ${H.toFixed(2).padStart(7)} ${String(d).padStart(5)}`);console.log(""),Ee(s.map(d=>d[1])),n.live&&console.log(" sampling continues");break}let r=Array.isArray(n.frames)?n.frames:Array.isArray(n)?n:[];if(r.length===0){console.log(` no frame data \u2014 run '${h("perf")} start' first`);break}console.log(` last ${r.length} frame times (ms):`),console.log(` ${r.map(s=>s.toFixed(2)).join(", ")}`),Ee(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 n=await u.send({type:"evaluate",code:`(async () => {
824
- if (window.__sootsimRenderHost) {
825
- const session = window.${se} || {}
826
- if (session.active) {
827
- const priorSamples = Array.isArray(session.lastSamples) ? session.lastSamples : []
828
- const flushedSamples = await window.__sootsimRenderHost.flushSamples()
829
- const samples = priorSamples.concat(flushedSamples)
830
- window.__sootsimRenderHost.startSampling()
831
- window.${se} = {
832
- ...session,
833
- active: true,
834
- mode: 'render-worker',
835
- lastSamples: samples,
836
- lastFlushAt: performance.now(),
837
- }
838
- return {
839
- mode: 'render-worker',
840
- live: true,
841
- samples: samples
842
- .slice()
843
- .sort((a, b) => b[1] - a[1])
844
- .slice(0, ${t}),
845
- }
846
- }
847
- const samples = Array.isArray(session.lastSamples) ? session.lastSamples : []
848
- return {
849
- mode: 'render-worker',
850
- live: false,
851
- samples: samples
852
- .slice()
853
- .sort((a, b) => b[1] - a[1])
854
- .slice(0, ${t}),
855
- }
856
- }
857
- const perf = window.__sootsimPerf
858
- if (!perf) return { error: 'no __sootsimPerf (try "perf start" first)' }
859
- const stats = perf.getFrameStats?.() || {}
860
- const recent = Array.isArray(stats.recentFrames) ? stats.recentFrames : []
861
- return {
862
- mode: 'main-thread',
863
- frames: recent.slice().sort((a, b) => b - a).slice(0, ${t}),
864
- }
865
- })()`});if(n.error&&(console.error(` error: ${n.error}`),process.exit(1)),E(l)){C(n);break}if(n.mode==="render-worker"){let s=Array.isArray(n.samples)?n.samples:[];if(s.length===0){console.log(` no frame data \u2014 run '${h("perf")} start' first`);break}console.log(` worst ${s.length} sampled frames (ms):`),console.log(" total layout render copy aux other t+");for(let[d,m,y,p,x,A,H]of s)console.log(` ${m.toFixed(2).padStart(7)} ${y.toFixed(2).padStart(7)} ${p.toFixed(2).padStart(7)} ${x.toFixed(2).padStart(7)} ${A.toFixed(2).padStart(6)} ${H.toFixed(2).padStart(7)} ${String(d).padStart(5)}`);n.live&&(console.log(""),console.log(" sampling continues"));break}let r=Array.isArray(n.frames)?n.frames:Array.isArray(n)?n:[];if(r.length===0){console.log(` no frame data \u2014 run '${h("perf")} start' first`);break}console.log(` worst ${r.length} frame times (ms):`),console.log(` ${r.map(s=>s.toFixed(2)).join(", ")}`);break}case"transition":{let t=a[2];if(!t||!["goHome","appSwitcher","lockScreen"].includes(t)){console.log(`
866
- ${h("perf")} transition <event> \u2014 profile a shell transition
867
-
868
- events:
869
- goHome swipe-to-home animation
870
- appSwitcher app switcher card animation
871
- lockScreen lock screen transition
872
-
873
- note: uses 600ms capture window \u2014 may need --timeout 10000 flag
874
-
875
- examples:
876
- ${h("perf")} transition goHome --timeout 10000
877
- ${h("perf")} transition appSwitcher
878
- `);break}let r=`sootsim:${t}`;_e(` profiling ${t} transition...`),_e(" (use --timeout 10000 if this times out)");let s=await u.send({type:"evaluate",code:`(async () => {
879
- // only supported in render-worker mode
880
- if (!window.__sootsimRenderHost) {
881
- return { error: 'transition profiling requires render-worker mode' }
882
- }
883
-
884
- // start sampling
885
- window.__sootsimRenderHost.startSampling()
886
-
887
- // give a frame for sampling to start
888
- await new Promise(r => requestAnimationFrame(() => r(undefined)))
889
-
890
- // dispatch the shell event
891
- window.dispatchEvent(new Event('${r}'))
892
-
893
- // wait 600ms for transition to complete (shell animations are ~300-500ms)
894
- // using fixed timing avoids complex animation-end detection
895
- await new Promise(r => setTimeout(r, 600))
896
-
897
- // flush samples and compute stats
898
- const samples = await window.__sootsimRenderHost.flushSamples()
899
- const frameTimes = samples.map(s => s[1])
900
- const layoutTimes = samples.map(s => s[2])
901
- const renderTimes = samples.map(s => s[3])
902
- const copyTimes = samples.map(s => s[4])
903
- const auxTimes = samples.map(s => s[5] || 0)
904
- const otherTimes = samples.map(s => s[6] || 0)
905
- const sorted = [...frameTimes].sort((a, b) => a - b)
906
- const total = frameTimes.reduce((a, b) => a + b, 0)
907
- const avg = frameTimes.length > 0 ? total / frameTimes.length : 0
908
- const max = Math.max(...frameTimes, 0)
909
- const layoutTotal = layoutTimes.reduce((a, b) => a + b, 0)
910
- const renderTotal = renderTimes.reduce((a, b) => a + b, 0)
911
- const copyTotal = copyTimes.reduce((a, b) => a + b, 0)
912
- const auxTotal = auxTimes.reduce((a, b) => a + b, 0)
913
- const otherTotal = otherTimes.reduce((a, b) => a + b, 0)
914
-
915
- return {
916
- event: '${t}',
917
- frames: frameTimes.length,
918
- totalMs: total,
919
- avgMs: avg,
920
- maxMs: max,
921
- layoutTotalMs: layoutTotal,
922
- renderTotalMs: renderTotal,
923
- copyTotalMs: copyTotal,
924
- auxTotalMs: auxTotal,
925
- otherTotalMs: otherTotal,
926
- layoutAvgMs: frameTimes.length > 0 ? layoutTotal / frameTimes.length : 0,
927
- renderAvgMs: frameTimes.length > 0 ? renderTotal / frameTimes.length : 0,
928
- copyAvgMs: frameTimes.length > 0 ? copyTotal / frameTimes.length : 0,
929
- auxAvgMs: frameTimes.length > 0 ? auxTotal / frameTimes.length : 0,
930
- otherAvgMs: frameTimes.length > 0 ? otherTotal / frameTimes.length : 0,
931
- p50: sorted[Math.floor(sorted.length * 0.5)] || 0,
932
- p95: sorted[Math.floor(sorted.length * 0.95)] || 0,
933
- p99: sorted[Math.floor(sorted.length * 0.99)] || 0,
934
- jankFrames: frameTimes.filter(f => f > 16.67).length,
935
- samples,
936
- }
937
- })()`});if(s.error&&(console.error(` error: ${s.error}`),process.exit(1)),E(l)){C(s);break}if(s.warning&&console.log(` warning: ${s.warning}`),s.frames===0){console.log(" no frames captured");break}let d=s.avgMs>0?(1e3/s.avgMs).toFixed(1):"?",m=s.frames>0?(s.jankFrames/s.frames*100).toFixed(1):"0";console.log(` ${t} transition profiled:
938
-
939
- frames: ${s.frames}
940
- total: ${s.totalMs.toFixed(1)}ms
941
- avg: ${s.avgMs.toFixed(2)}ms (${d} fps)
942
- max: ${s.maxMs.toFixed(2)}ms
943
-
944
- breakdown (avg per frame):
945
- layout: ${s.layoutAvgMs?.toFixed(2)||"?"}ms
946
- render: ${s.renderAvgMs?.toFixed(2)||"?"}ms
947
- copy: ${s.copyAvgMs?.toFixed(2)||"?"}ms
948
- aux: ${s.auxAvgMs?.toFixed(2)||"?"}ms
949
- other: ${s.otherAvgMs?.toFixed(2)||"?"}ms
950
-
951
- distribution (${s.frames} samples):
952
- p50: ${s.p50.toFixed(2)}ms
953
- p95: ${s.p95.toFixed(2)}ms
954
- p99: ${s.p99.toFixed(2)}ms
955
- jank: ${s.jankFrames} frames (${m}%) >16.67ms`),Array.isArray(s.samples)&&s.samples.length>0&&(console.log(""),Ee(s.samples.map(y=>y[1])));break}default:console.error(` unknown perf subcommand: ${e}`),console.error(" valid: stats, start, stop, frames, worst, transition"),/^--?reset$/.test(e)&&console.error(" note: 'perf start' already clears prior frames \u2014 no reset needed"),process.exit(1)}break}case"errors":{let e=a[1];if(e==="clear"){await st(u),E(l)?C({cleared:!0}):console.log(" error buffer cleared");break}let t=e?Number(e):20,n=await tt(u,t);if(E(l)){C(n);break}if(n.length===0){console.log(" no errors captured");break}console.log(` ${n.length} error(s):
956
- `);for(let r of n){let s=re(r.timestamp),d=r.args.map(m=>typeof m=="object"?JSON.stringify(m):m).join(" ");if(console.log(` [${s}] ${d}`),r.stack){let m=r.stack.split(`
957
- `).slice(0,3);for(let y of m)console.log(` ${y.trim()}`)}}break}case"warnings":{let e=a[1]?Number(a[1]):20,t=await ot(u,e);if(E(l)){C(t);break}if(t.length===0){console.log(" no warnings captured");break}console.log(` ${t.length} warning(s):
958
- `);for(let n of t){let r=re(n.timestamp),s=n.args.map(d=>typeof d=="object"?JSON.stringify(d):d).join(" ");console.log(` [${r}] ${s}`)}break}case"animations":{let e=await X(u,"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):
959
- `);for(let t of e){let n=String(t.kind).padEnd(6),r=`${Number(t.from).toFixed(2)}\u2192${Number(t.to).toFixed(2)}`,s=Number(t.current??0).toFixed(2),d=`${Math.round((t.progress??0)*100)}%`,m=`${Math.round(t.elapsedMs??0)}ms`,y=t.loop?" loop":"",p=t.layoutBound?" layout":"";console.log(` #${t.id} ${n} ${r.padEnd(14)} cur=${s.padEnd(7)} ${d.padStart(4)} ${m}${y}${p}`)}break}case"animation":{let e=a[1];(!e||e==="--help"||e==="-h")&&(console.error(` usage: ${h("animation")} <id>`),process.exit(1));let t=Number(e);Number.isFinite(t)||(console.error(` invalid id: ${e}`),process.exit(1));let n=await X(u,"getAnimation",t);console.log(JSON.stringify(n,null,2));break}case"stop-animation":{let e=a[1];(!e||e==="--help"||e==="-h")&&(console.error(` usage: ${h("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 n=await X(u,"stopAnimation",t);console.log(` stopped ${n??0} animation(s)`);break}case"requests":{let e=a[1];if(e==="clear"){await rt(u),E(l)?C({cleared:!0}):console.log(" request buffer cleared");break}let t=e==="all",n=t?a[2]:e,r=n?Number(n):20,s=await nt(u,{failed:!t,limit:r});if(E(l)){C(s);break}if(s.length===0){console.log(t?" no requests captured":" no failed requests captured");break}console.log(` ${s.length} ${t?"request(s)":"failed request(s)"}:
960
- `);for(let d of s){let m=re(d.timestamp);console.log(` [${m}] ${ee(d)}`),d.responseBody?console.log(` ${d.responseBody}`):d.error&&console.log(` ${d.error}`)}break}case"network":{let e=a[1],t=null,n=null,r=!1,s=!1,d=1e3,m=!1,y=!1;for(let N=0;N<l.length;N++){let w=l[N];if(w==="--filter")t=l[N+1]??null,N++;else if(w==="--limit"){let v=Number(l[N+1]);Number.isFinite(v)&&(n=v),N++}else if(w==="--threshold"){let v=Number(l[N+1]);Number.isFinite(v)&&v>0&&(d=v),N++}else w==="--failed"?r=!0:w==="--slow"?s=!0:w==="--tail"||w==="-f"?m=!0:w==="--json"&&(y=!0)}if(e==="clear"){await u.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 w=await u.send({type:"evaluate",code:`(() => {
961
- const obs = window.__sootsimObservability;
962
- if (!obs) return null;
963
- return obs.network.getSnapshot().find(e => e.id === ${JSON.stringify(N)}) || null;
964
- })()`});w||(console.error(` no entry with id ${N}`),process.exit(1)),y?console.log(JSON.stringify(w,null,2)):No(w);break}let p=n??(m?200:e?Number(e):20);Number.isFinite(p)||(console.error(` invalid limit: ${e} \u2014 \`network\` takes a numeric count (e.g. ${h("network")} 100).
965
- to target a specific sim, use \`--sim ${e}\` instead.`),process.exit(1));let x=async()=>{let N=await u.send({type:"evaluate",code:`(() => {
966
- const obs = window.__sootsimObservability;
967
- if (!obs) return { ok: false };
968
- return { ok: true, entries: obs.network.getSnapshot() };
969
- })()`});if(!N||!N.ok)throw new Error("observability bridge not installed \u2014 is the engine running?");return N.entries??[]},A=N=>{let w=N;if(r&&(w=w.filter(v=>!!v.error||v.status!=null&&v.status>=400)),s&&(w=w.filter(v=>v.durationMs!=null&&v.durationMs>=d)),t){let v=t.toLowerCase();w=w.filter(P=>(P.displayUrl||P.url).toLowerCase().includes(v))}return s&&!m&&(w=[...w].sort((v,P)=>(P.durationMs??0)-(v.durationMs??0))),w};if(!m){let N=await x(),w=A(N).slice(-p);if(y){console.log(JSON.stringify(w,null,2));break}if(w.length===0){N.length===0?console.log(" no network requests captured"):console.log(s?` no requests slower than ${d}ms (${N.length} total \u2014 try --threshold <ms>)`:" no matching requests");break}console.log(s?` ${w.length} request(s) slower than ${d}ms (sorted by duration desc):
970
- `:` ${w.length} request(s):
971
- `);for(let v of w)Jt(v);break}console.log(` tailing network (ctrl-c to stop)...
972
- `);let H=new Set,U=!0,K=()=>{U=!1};process.on("SIGINT",K);try{for(;U;){let N=await x(),w=A(N);for(let v of w)v.durationMs!=null&&(H.has(v.id)||(H.add(v.id),y?console.log(JSON.stringify(v)):Jt(v)));await Q(250)}}finally{process.off("SIGINT",K)}break}case"logs":{let e=a[1],t=null,n=null,r=null,s=!1,d=!1,m=!1;for(let w=0;w<l.length;w++){let v=l[w];if(v==="--filter")t=l[w+1]??null,w++;else if(v==="--limit"){let P=Number(l[w+1]);Number.isFinite(P)&&(n=P),w++}else v==="--level"?(r=l[w+1]??null,w++):v==="--tail"||v==="-f"?s=!0:v==="--json"?d=!0:(v==="--internal"||v==="--all")&&(m=!0)}let y=r?new Set(r.split(",").map(w=>w.trim()).filter(w=>w==="log"||w==="info"||w==="warn"||w==="error"||w==="debug")):null;if(e==="clear"){await at(u),console.log(" log buffer cleared");break}let p=!d&&process.stdout.isTTY===!0,x=n??(s?500:e?Number(e):50);Number.isFinite(x)||(console.error(` invalid limit: ${e} \u2014 \`logs\` takes a numeric count (e.g. ${h("logs")} 100).
973
- to target a specific sim, use \`--sim ${e}\` instead.`),process.exit(1));let A=()=>it(u),H=w=>lt(w,{level:y,filter:t,showInternal:m});if(!s){let w=await A(),v=H(w).slice(-x);if(d){console.log(JSON.stringify(v,null,2));break}if(v.length===0){console.log(w.length===0?" no logs captured":" no matching logs");break}console.log(` ${v.length} log(s):
974
- `);for(let P of v)qt(P,p);break}console.log(` tailing logs (ctrl-c to stop)...
975
- `);let U=new Set,K=!0,N=()=>{K=!1};process.on("SIGINT",N);try{for(;K;){let w=await A(),v=H(w);for(let P of v)U.has(P.id)||(U.add(P.id),d?console.log(JSON.stringify(P)):qt(P,p));await Q(250)}}finally{process.off("SIGINT",N)}break}default:console.error(` unknown subcommand: ${g}`),process.exit(1)}if(ce.has(g)&&!o.includes("--no-wait")&&process.env.SOOTSIM_NO_AUTO_WAIT!=="1"&&!await Ke(u,g)&&await $(u),!j.has(g)&&!E(l))try{await ae(u)}catch{}}catch(e){let t=e instanceof Error?e.message:String(e);console.error(` ${g??"inspect"} failed: ${t}`);let n=/^no sim connected with id (.+)$/.exec(t),r=/^command timed out after (\d+)s$/.exec(t),s=t.startsWith("sim disconnected:")||t.startsWith("bridge never reconnected")||t.startsWith("could not connect to ws://");if(n)await bt(u,_,n[1]);else if(/^no sim connected$/.test(t))ht(_);else if(r)if(await vo(u)){let m=g??"describe";process.stderr.write(` the sim is still responsive \u2014 '${m}' just exceeded the ${r[1]}s command budget.
976
- the screen's node tree is large; narrow the query or raise the budget:
977
- sootsim ${m} --testid <id> # scope to one subtree
978
- sootsim find --testid <id> # targeted single-node lookup
979
- sootsim ${m} --timeout 60000 # raise per-command budget (ms)
980
- `)}else jt();else if(s)jt();else{try{await ft(u)}catch{}try{await fe({includeTail:!0})}catch{}try{await ne({includeTail:!0})}catch{}}process.exit(1)}finally{u.close()}}export{hn as runInspect};