sootsim 0.1.227 → 0.1.229

package/dist-cli/chunks/{record-2F54QS6Y.js → record-NAYAEQPD.js}

@@ -1,15 +1,15 @@
-/*! sootsim v0.1.227 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as P}from"./chunk-J2JAOIMN.js";import"./chunk-E3DLUOFK.js";import{a as Z,c as ee}from"./chunk-4BLOZ3AF.js";import"./chunk-UGWURWHN.js";import"./chunk-7K5K5NKB.js";import{d as Y}from"./chunk-3L5EXWCP.js";import{g as b,i as v,j as Q}from"./chunk-35EAEAN4.js";import"./chunk-44Z2X5R4.js";import"./chunk-2BQOZATN.js";import"./chunk-J7IFVTWX.js";import{b as X}from"./chunk-E75EBS77.js";import"./chunk-NU755HCE.js";import"./chunk-F5HOYUD2.js";import{existsSync as we,mkdirSync as E,readdirSync as he,readFileSync as be,rmSync as J,writeFileSync as I}from"fs";import{homedir as ve,tmpdir as ye}from"os";import{dirname as W,extname as oe,join as N,resolve as Se}from"path";var z=24e4,Re=9e4,$e=3e4;async function D(e,r,o,i){let t=Math.max(2e4,i+$e);try{return await e.send({type:"evaluate",code:r},{timeoutMs:t})}catch(n){let s=n instanceof Error?n.message:String(n);/^command timed out after \d+s$/.test(s)&&(console.error(`  ${o} stalled \u2014 the render host did not finish within ${Math.round(t/1e3)}s; it is likely contended or wedged.
+/*! sootsim v0.1.229 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{a as P}from"./chunk-7IBNJPSB.js";import"./chunk-JK4AGL2U.js";import{a as Z,c as ee}from"./chunk-SPBHQVJ4.js";import"./chunk-HKZICBKI.js";import"./chunk-OWSZCLYZ.js";import{d as Y}from"./chunk-THDVL3ST.js";import{g as b,i as v,j as Q}from"./chunk-6Q3M6FMW.js";import"./chunk-UGFZIHBA.js";import"./chunk-WRPO6J3Z.js";import"./chunk-AB7XCG3A.js";import{c as X}from"./chunk-4O73AHYA.js";import"./chunk-TWUPMUWQ.js";import"./chunk-U4OPCVAL.js";import{existsSync as we,mkdirSync as E,readdirSync as he,readFileSync as be,rmSync as J,writeFileSync as N}from"fs";import{homedir as ve,tmpdir as ye}from"os";import{dirname as W,extname as oe,join as C,resolve as Se}from"path";var z=24e4,Re=9e4,$e=3e4;async function D(e,r,o,i){let t=Math.max(2e4,i+$e);try{return await e.send({type:"evaluate",code:r},{timeoutMs:t})}catch(n){let s=n instanceof Error?n.message:String(n);/^command timed out after \d+s$/.test(s)&&(console.error(`  ${o} stalled \u2014 the render host did not finish within ${Math.round(t/1e3)}s; it is likely contended or wedged.
   the capture lock auto-releases, so simply retry the recording.
   if it persists, recover the sim with \`sootsim close --sim <id>\`.`),process.exit(1)),/render host not available|already streaming|already recording|lock already held/i.test(s)&&(console.error(`  ${o} failed: ${s}
   a prior recording was abandoned and its capture is still
   releasing. the lock self-heals in ~${Math.round((i+2e4)/1e3)}s \u2014 retry then, or recover now with
-  \`sootsim close --sim <id>\` and reopen the sim.`),process.exit(1)),console.error(`  ${o} failed: ${s}`),process.exit(1)}}var _e=new Set(["--sim","--port","-p","--mode","--duration","--fps","--format","--output","-o","--frames","--max-width","--origin","--owner","--repo"]),xe=new Set(["start","stop","cancel","status","prelude-start","upload"]);function Oe(e){for(let r=0;r<e.length;r++){let o=e[r];if(o.startsWith("-")){_e.has(o)&&r++;continue}return xe.has(o)?{name:o,index:r}:null}return null}function ke(){let e=process.env,r=(e.SOOT_BRANCH||e.GITHUB_HEAD_REF||e.GITHUB_REF_NAME||"").trim(),o=(e.SOOT_SHA||e.GITHUB_SHA||"").trim(),i=(e.SOOT_PR_NUMBER||"").trim(),t=i?Number.parseInt(i,10):Number.NaN,n=(e.SOOT_PR_TITLE||"").trim();return{branch:r||void 0,commitSha:o||void 0,pullRequestNumber:Number.isFinite(t)&&t>0?t:void 0,pullRequestTitle:n||void 0}}function re(e){let r=l(e,"--owner")?.trim(),o=l(e,"--repo")?.trim();return(r&&!o||!r&&o)&&(console.error("  --owner and --repo must be provided together"),process.exit(1)),r&&o?{owner:r,repo:o}:null}async function qe(e,r){let o=Oe(e);if(o){let d=[...e.slice(0,o.index),...e.slice(o.index+1)];if(o.name==="start"){await Ie(d,r);return}if(o.name==="prelude-start"){await Ne(d,r);return}if(o.name==="upload"){let{runUpload:y}=await import("./upload-KRBS3Y7Q.js");await y(d,r);return}if(o.name==="stop"){await Pe(d,r);return}if(o.name==="cancel"){await Fe(d,r);return}await Ae(d,r);return}let i=b(e,{port:r.port,stripBooleanFlags:["--no-shell","--shell-only","--open"],stripValueFlags:["--mode","--duration","--fps","--format","--output","--frames","--max-width","--origin","--owner","--repo"]}),t=ie(l(e,"--mode")),n=e.includes("--shell-only")?"shell":e.includes("--no-shell")?"tenant":void 0,s=l(e,"--format");s&&!["webm","mp4","gif","png"].includes(s)&&(console.error(`  invalid --format "${s}" \u2014 expected webm | mp4 | gif | png`),process.exit(1));let c=l(e,"--output"),a=Number(l(e,"--duration")??"10");(!Number.isFinite(a)||a<=0)&&(console.error(`  invalid --duration "${l(e,"--duration")}" \u2014 expected a positive number of seconds`),process.exit(1));let m=600;a>m&&(console.error(`  invalid --duration "${l(e,"--duration")}" \u2014 exceeds the ${m}s (10m) maximum`),process.exit(1));let u=Number(l(e,"--fps")??"30"),p=l(e,"--frames");if(p!==void 0){let d=Number(p);(!Number.isInteger(d)||d<=0)&&(console.error(`  invalid --frames "${p}" \u2014 expected a positive integer count`),process.exit(1))}let x=e.includes("--open"),j=l(e,"--max-width")?Number(l(e,"--max-width")):void 0,g=Math.max(100,Math.round(a*1e3)),K=l(e,"--origin"),pe=re(e);if(t==="live"||t==="combined"){c&&console.log(`  note: --output is ignored for --mode ${t} \u2014 the recording uploads to /preview/<id>`),n&&t==="live"&&console.log(`  note: --${n==="shell"?"shell-only":"no-shell"} is ignored for --mode live \u2014 live recordings capture events only, no video`),await P("record",{originOverride:K,allowGitHubAuth:!0});let d=v({...i,commandTimeoutMs:6e4});try{await q(d),await ae(d,t),t==="combined"&&await B(d),await de(d,K,pe);let y=await ce(d,t,t==="combined"?n:void 0);y.ok||(console.error(`  start failed: recording store refused to start (${t})`+(y.error?`: ${y.error}`:"")),process.exit(1)),console.log(`  recording ${t} for ${a}s`),await new Promise(_=>setTimeout(_,g)),await le(d);let O=await ue(d);me(O,x,t)}finally{d.close()}return}let C=p?Number(p):null,R=Te(s,c,C);x&&console.log("  note: --open is ignored for local-file capture \u2014 it applies to --mode live/combined");let h=v({...i,commandTimeoutMs:6e4});try{if(await te(h),await B(h),R==="png"){let $=C??10,w=U(c,`sootsim-frames-${M()}`);c&&oe(c)&&console.log(`  note: --frames writes multiple pngs, so --output "${c}" is a directory \u2014 frame-NNN.png files land inside it`),E(w,{recursive:!0});for(let f of he(w))/^frame-\d+\.png$/.test(f)&&J(N(w,f),{force:!0});console.log(`  sampling ${$} frames over ${a}s \u2192 ${w}`);let S=await h.send({type:"evaluate",code:`window.__sootsimRecorder.startFrameCapture({ count: ${$}, durationMs: ${g}${n?`, layers: ${JSON.stringify(n)}`:""} })`});(!S.ok||!S.requestId)&&(console.error(`  frame capture start failed: ${S.error??"unknown error"}`),process.exit(1)),await new Promise(f=>setTimeout(f,g));let fe=Date.now()+Math.max(5e3,g),A=null;for(;;){let f=await h.send({type:"evaluate",code:`window.__sootsimRecorder.getFrameCaptureResult(${S.requestId})`});if(f||(console.error("  frame capture result missing"),process.exit(1)),f.done){f.ok||(console.error(`  frame capture failed: ${f.error??"unknown error"}`),process.exit(1)),A=f.frames??[];break}Date.now()>=fe&&(console.error("  frame capture timed out"),process.exit(1)),await new Promise(F=>setTimeout(F,100))}A.forEach((f,F)=>{let ge=`${w}/frame-${String(F+1).padStart(3,"0")}.png`;I(ge,Buffer.from(f.data,"base64"))}),console.log(`  saved ${A.length} frames`);return}if(R==="gif"){let $=C??Math.max(10,Math.round(a*u/3)),w=U(c,`sootsim-${M()}.gif`);E(W(w),{recursive:!0}),console.log(`  encoding gif: ${$} frames over ${a}s \u2192 ${w}`);let S=await D(h,`window.__sootsimRecorder.captureGif({ frames: ${$}, durationMs: ${g}${j?`, maxWidth: ${j}`:""}${n?`, layers: ${JSON.stringify(n)}`:""} })`,"gif encode",g);S||(console.error("  gif capture returned no frames"),process.exit(1)),I(w,Buffer.from(S.data,"base64")),console.log(`  saved: ${w} (${G(S.size)})`);return}let d=U(c,`sootsim-${M()}.${R}`);E(W(d),{recursive:!0});let y={format:R,fps:u,durationMs:g};n&&(y.layers=n);let O=await D(h,`window.__sootsimRecorder.start(${JSON.stringify(y)})`,`${R} start`,g);O.ok||(console.error(`  start failed: ${O.error??"unknown error"}`),/render host not available|already streaming|already recording|lock already held/i.test(O.error??"")&&console.error("  a prior recording was abandoned and its capture is still\n  releasing. retry in ~20s, or recover now with\n  `sootsim close --sim <id>` then reopen the sim."),process.exit(1)),console.log(`  recording ${R} for ${a}s \u2192 ${d}`),await new Promise($=>setTimeout($,g));let _=await D(h,"window.__sootsimRecorder.stop()",`${R} encode/flush`,g);_.ok||(console.error(`  stop failed: ${_.error??"unknown error"}`),process.exit(1)),_.size||(console.error("  recorder returned an empty blob \u2014 nothing written"),process.exit(1)),await ne(h,d),console.log(`  saved: ${d} (${G(_.size)})`)}finally{h.close()}}var Ee=6e3;async function L(e,r){try{return await e.send({type:"evaluate",code:r},{timeoutMs:Ee})}catch(o){let i=o instanceof Error?o.message:String(o);throw/^command timed out after \d+s$/.test(i)&&(console.error("  sim did not respond \u2014 it is connected to the bridge but has not\n  loaded an app (or its page is unresponsive). run `sootsim list`\n  and target a sim with a loaded app via --sim <id>."),process.exit(1)),o}}async function te(e){await L(e,'typeof window.__sootsimRecorder !== "undefined"')||(console.error("  window.__sootsimRecorder missing \u2014 is sootsim engine running in this sim?"),process.exit(1))}async function B(e){let{hidden:r}=await Q(e);r&&(console.error(`  refusing to record: the sootsim tab is hidden, so frame capture
+  \`sootsim close --sim <id>\` and reopen the sim.`),process.exit(1)),console.error(`  ${o} failed: ${s}`),process.exit(1)}}var _e=new Set(["--sim","--port","-p","--mode","--duration","--fps","--format","--output","-o","--frames","--max-width","--origin","--owner","--repo"]),xe=new Set(["start","stop","cancel","status","prelude-start","upload"]);function ke(e){for(let r=0;r<e.length;r++){let o=e[r];if(o.startsWith("-")){_e.has(o)&&r++;continue}return xe.has(o)?{name:o,index:r}:null}return null}function Oe(){let e=process.env,r=(e.CONTRAST_BRANCH||e.GITHUB_HEAD_REF||e.GITHUB_REF_NAME||"").trim(),o=(e.CONTRAST_SHA||e.GITHUB_SHA||"").trim(),i=(e.CONTRAST_PR_NUMBER||"").trim(),t=i?Number.parseInt(i,10):Number.NaN,n=(e.CONTRAST_PR_TITLE||"").trim();return{branch:r||void 0,commitSha:o||void 0,pullRequestNumber:Number.isFinite(t)&&t>0?t:void 0,pullRequestTitle:n||void 0}}function re(e){let r=l(e,"--owner")?.trim(),o=l(e,"--repo")?.trim();return(r&&!o||!r&&o)&&(console.error("  --owner and --repo must be provided together"),process.exit(1)),r&&o?{owner:r,repo:o}:null}async function qe(e,r){let o=ke(e);if(o){let d=[...e.slice(0,o.index),...e.slice(o.index+1)];if(o.name==="start"){await Ne(d,r);return}if(o.name==="prelude-start"){await Ce(d,r);return}if(o.name==="upload"){let{runUpload:y}=await import("./upload-OF4CO6WM.js");await y(d,r);return}if(o.name==="stop"){await Pe(d,r);return}if(o.name==="cancel"){await Fe(d,r);return}await Ae(d,r);return}let i=b(e,{port:r.port,stripBooleanFlags:["--no-shell","--shell-only","--open"],stripValueFlags:["--mode","--duration","--fps","--format","--output","--frames","--max-width","--origin","--owner","--repo"]}),t=ie(l(e,"--mode")),n=e.includes("--shell-only")?"shell":e.includes("--no-shell")?"tenant":void 0,s=l(e,"--format");s&&!["webm","mp4","gif","png"].includes(s)&&(console.error(`  invalid --format "${s}" \u2014 expected webm | mp4 | gif | png`),process.exit(1));let c=l(e,"--output"),a=Number(l(e,"--duration")??"10");(!Number.isFinite(a)||a<=0)&&(console.error(`  invalid --duration "${l(e,"--duration")}" \u2014 expected a positive number of seconds`),process.exit(1));let m=600;a>m&&(console.error(`  invalid --duration "${l(e,"--duration")}" \u2014 exceeds the ${m}s (10m) maximum`),process.exit(1));let u=Number(l(e,"--fps")??"30"),p=l(e,"--frames");if(p!==void 0){let d=Number(p);(!Number.isInteger(d)||d<=0)&&(console.error(`  invalid --frames "${p}" \u2014 expected a positive integer count`),process.exit(1))}let x=e.includes("--open"),j=l(e,"--max-width")?Number(l(e,"--max-width")):void 0,g=Math.max(100,Math.round(a*1e3)),K=l(e,"--origin"),pe=re(e);if(t==="live"||t==="combined"){c&&console.log(`  note: --output is ignored for --mode ${t} \u2014 the recording uploads to /preview/<id>`),n&&t==="live"&&console.log(`  note: --${n==="shell"?"shell-only":"no-shell"} is ignored for --mode live \u2014 live recordings capture events only, no video`),await P("record",{originOverride:K,allowGitHubAuth:!0});let d=v({...i,commandTimeoutMs:6e4});try{await q(d),await ae(d,t),t==="combined"&&await T(d),await de(d,K,pe);let y=await ce(d,t,t==="combined"?n:void 0);y.ok||(console.error(`  start failed: recording store refused to start (${t})`+(y.error?`: ${y.error}`:"")),process.exit(1)),console.log(`  recording ${t} for ${a}s`),await new Promise(_=>setTimeout(_,g)),await le(d);let k=await ue(d);me(k,x,t)}finally{d.close()}return}let I=p?Number(p):null,R=Be(s,c,I);x&&console.log("  note: --open is ignored for local-file capture \u2014 it applies to --mode live/combined");let h=v({...i,commandTimeoutMs:6e4});try{if(await te(h),await T(h),R==="png"){let $=I??10,w=U(c,`sootsim-frames-${M()}`);c&&oe(c)&&console.log(`  note: --frames writes multiple pngs, so --output "${c}" is a directory \u2014 frame-NNN.png files land inside it`),E(w,{recursive:!0});for(let f of he(w))/^frame-\d+\.png$/.test(f)&&J(C(w,f),{force:!0});console.log(`  sampling ${$} frames over ${a}s \u2192 ${w}`);let S=await h.send({type:"evaluate",code:`window.__sootsimRecorder.startFrameCapture({ count: ${$}, durationMs: ${g}${n?`, layers: ${JSON.stringify(n)}`:""} })`});(!S.ok||!S.requestId)&&(console.error(`  frame capture start failed: ${S.error??"unknown error"}`),process.exit(1)),await new Promise(f=>setTimeout(f,g));let fe=Date.now()+Math.max(5e3,g),A=null;for(;;){let f=await h.send({type:"evaluate",code:`window.__sootsimRecorder.getFrameCaptureResult(${S.requestId})`});if(f||(console.error("  frame capture result missing"),process.exit(1)),f.done){f.ok||(console.error(`  frame capture failed: ${f.error??"unknown error"}`),process.exit(1)),A=f.frames??[];break}Date.now()>=fe&&(console.error("  frame capture timed out"),process.exit(1)),await new Promise(F=>setTimeout(F,100))}A.forEach((f,F)=>{let ge=`${w}/frame-${String(F+1).padStart(3,"0")}.png`;N(ge,Buffer.from(f.data,"base64"))}),console.log(`  saved ${A.length} frames`);return}if(R==="gif"){let $=I??Math.max(10,Math.round(a*u/3)),w=U(c,`sootsim-${M()}.gif`);E(W(w),{recursive:!0}),console.log(`  encoding gif: ${$} frames over ${a}s \u2192 ${w}`);let S=await D(h,`window.__sootsimRecorder.captureGif({ frames: ${$}, durationMs: ${g}${j?`, maxWidth: ${j}`:""}${n?`, layers: ${JSON.stringify(n)}`:""} })`,"gif encode",g);S||(console.error("  gif capture returned no frames"),process.exit(1)),N(w,Buffer.from(S.data,"base64")),console.log(`  saved: ${w} (${G(S.size)})`);return}let d=U(c,`sootsim-${M()}.${R}`);E(W(d),{recursive:!0});let y={format:R,fps:u,durationMs:g};n&&(y.layers=n);let k=await D(h,`window.__sootsimRecorder.start(${JSON.stringify(y)})`,`${R} start`,g);k.ok||(console.error(`  start failed: ${k.error??"unknown error"}`),/render host not available|already streaming|already recording|lock already held/i.test(k.error??"")&&console.error("  a prior recording was abandoned and its capture is still\n  releasing. retry in ~20s, or recover now with\n  `sootsim close --sim <id>` then reopen the sim."),process.exit(1)),console.log(`  recording ${R} for ${a}s \u2192 ${d}`),await new Promise($=>setTimeout($,g));let _=await D(h,"window.__sootsimRecorder.stop()",`${R} encode/flush`,g);_.ok||(console.error(`  stop failed: ${_.error??"unknown error"}`),process.exit(1)),_.size||(console.error("  recorder returned an empty blob \u2014 nothing written"),process.exit(1)),await ne(h,d),console.log(`  saved: ${d} (${G(_.size)})`)}finally{h.close()}}var Ee=6e3;async function L(e,r){try{return await e.send({type:"evaluate",code:r},{timeoutMs:Ee})}catch(o){let i=o instanceof Error?o.message:String(o);throw/^command timed out after \d+s$/.test(i)&&(console.error("  sim did not respond \u2014 it is connected to the bridge but has not\n  loaded an app (or its page is unresponsive). run `sootsim list`\n  and target a sim with a loaded app via --sim <id>."),process.exit(1)),o}}async function te(e){await L(e,'typeof window.__sootsimRecorder !== "undefined"')||(console.error("  window.__sootsimRecorder missing \u2014 is sootsim engine running in this sim?"),process.exit(1))}async function T(e){let{hidden:r}=await Q(e);r&&(console.error(`  refusing to record: the sootsim tab is hidden, so frame capture
   would be throttled to ~1fps and produce a frozen-looking file.
   bring the chrome window to the foreground (un-minimize / switch to
-  its tab) or run the recording in headless playwright, then retry.`),process.exit(1))}async function ne(e,r){let o=[],i=0;for(;;){let t=await e.send({type:"evaluate",code:`window.__sootsimRecorder.getBlobBase64({ offset: ${i}, chunk: 2097152 })`});if(!t)throw new Error("no blob available on recorder");if(o.push(Buffer.from(t.data,"base64")),i=t.offset,t.done)break}I(r,Buffer.concat(o))}function l(e,r){let o=e.indexOf(r);if(!(o<0||o===e.length-1))return e[o+1]}function Be(e){if(!e)return;let r=oe(e).toLowerCase().replace(/^\./,"");if(r==="webm"||r==="mp4"||r==="gif")return r;if(r==="png")return"png"}function Te(e,r,o){return e||(o!=null?"png":Be(r)??"webm")}function M(){return new Date().toISOString().replace(/[:T]/g,"-").replace(/\..+/,"")}function Me(){let e=N(ve(),".sootsim","recordings");return E(e,{recursive:!0}),e}function U(e,r){return e?Se(process.cwd(),e):N(Me(),r)}function G(e){return e<1024?`${e}B`:e<1024*1024?`${(e/1024).toFixed(1)}KB`:`${(e/(1024*1024)).toFixed(2)}MB`}function ie(e){if(!e)return"video";if(e==="video"||e==="live"||e==="combined")return e;console.error(`  invalid --mode "${e}" \u2014 expected video | live | combined`),process.exit(1)}function H(){return N(ye(),`sootsim-recording-${X()}.json`)}function T(){let e=H();if(!we(e))return null;try{return{mode:"video",...JSON.parse(be(e,"utf8"))}}catch{return J(e,{force:!0}),null}}function Ue(e){I(H(),JSON.stringify(e,null,2))}function k(){J(H(),{force:!0})}function V(e,r){e&&r.simId&&e!==r.simId&&console.log(`  note: the tracked recording session is on sim ${r.simId}, not the
+  its tab) or run the recording in headless playwright, then retry.`),process.exit(1))}async function ne(e,r){let o=[],i=0;for(;;){let t=await e.send({type:"evaluate",code:`window.__sootsimRecorder.getBlobBase64({ offset: ${i}, chunk: 2097152 })`});if(!t)throw new Error("no blob available on recorder");if(o.push(Buffer.from(t.data,"base64")),i=t.offset,t.done)break}N(r,Buffer.concat(o))}function l(e,r){let o=e.indexOf(r);if(!(o<0||o===e.length-1))return e[o+1]}function Te(e){if(!e)return;let r=oe(e).toLowerCase().replace(/^\./,"");if(r==="webm"||r==="mp4"||r==="gif")return r;if(r==="png")return"png"}function Be(e,r,o){return e||(o!=null?"png":Te(r)??"webm")}function M(){return new Date().toISOString().replace(/[:T]/g,"-").replace(/\..+/,"")}function Me(){let e=C(ve(),".sootsim","recordings");return E(e,{recursive:!0}),e}function U(e,r){return e?Se(process.cwd(),e):C(Me(),r)}function G(e){return e<1024?`${e}B`:e<1024*1024?`${(e/1024).toFixed(1)}KB`:`${(e/(1024*1024)).toFixed(2)}MB`}function ie(e){if(!e)return"video";if(e==="video"||e==="live"||e==="combined")return e;console.error(`  invalid --mode "${e}" \u2014 expected video | live | combined`),process.exit(1)}function H(){return C(ye(),`sootsim-recording-${X()}.json`)}function B(){let e=H();if(!we(e))return null;try{return{mode:"video",...JSON.parse(be(e,"utf8"))}}catch{return J(e,{force:!0}),null}}function Ue(e){N(H(),JSON.stringify(e,null,2))}function O(){J(H(),{force:!0})}function V(e,r){e&&r.simId&&e!==r.simId&&console.log(`  note: the tracked recording session is on sim ${r.simId}, not the
   requested sim ${e}. record state is global (not per-sim);
-  this command acts on that session regardless of --sim.`)}async function Ie(e,r){let o=T();o&&(console.error(`  recording already in progress (started ${o.startedAt}, sim ${o.simId??"?"}). run \`sootsim record stop\` first, or \`sootsim record cancel\` to discard.`),process.exit(1));let i=b(e,{port:r.port,stripBooleanFlags:["--no-shell","--shell-only"],stripValueFlags:["--mode","--fps","--format","--max-width","--origin","--owner","--repo"]}),t=ie(l(e,"--mode")),n=e.includes("--shell-only")?"shell":e.includes("--no-shell")?"tenant":void 0,s=l(e,"--format"),c=s==="mp4"?"mp4":"webm";s&&c!==s&&(console.error(`  record start only supports webm or mp4 (got: ${s}). for gif/png use atomic mode: sootsim record --format ${s} --duration <s>`),process.exit(1));let a=Number(l(e,"--fps")??"30"),m=re(e),u=v({...i,commandTimeoutMs:t==="live"||t==="combined"?Re:15e3});try{if(t==="live"||t==="combined"){n&&t==="live"&&console.log(`  note: --${n==="shell"?"shell-only":"no-shell"} is ignored for --mode live \u2014 live recordings capture events only, no video`),await P("record",{originOverride:l(e,"--origin"),allowGitHubAuth:!0}),await q(u),await ae(u,t),t==="combined"&&await B(u),await de(u,l(e,"--origin"),m);let p=await ce(u,t,t==="combined"?n:void 0);p.ok||(console.error(`  start failed: recording store refused to start (${t})`+(p.error?`: ${p.error}`:"")),process.exit(1))}else{await te(u),await B(u);let p={format:c,fps:a};n&&(p.layers=n);let x=await u.send({type:"evaluate",code:`window.__sootsimRecorder.start(${JSON.stringify(p)})`});x.ok||(console.error(`  start failed: ${x.error??"unknown error"}`),process.exit(1))}Ue({simId:i.simId??null,mode:t,format:c,fps:a,layers:n,startedAt:new Date().toISOString()}),console.log(t==="video"?`  recording ${c} @ ${a}fps${n?` (${n})`:""} \u2014 run \`sootsim record stop --output <path>\` when done`:`  recording ${t} \u2014 run \`sootsim record stop\` when done (add --open to launch the preview URL)`)}finally{u.close()}}async function Ne(e,r){let o=T();o&&(console.error(`  recording already in progress (started ${o.startedAt}, sim ${o.simId??"?"}). run \`sootsim record stop\` first, or \`sootsim record cancel\` to discard.`),process.exit(1));let i=b(e,{port:r.port,stripBooleanFlags:[],stripValueFlags:["--origin"]}),t=v({...i,commandTimeoutMs:15e3});try{if(await q(t),await B(t),!await t.send({type:"evaluate",code:`(() => {
+  this command acts on that session regardless of --sim.`)}async function Ne(e,r){let o=B();o&&(console.error(`  recording already in progress (started ${o.startedAt}, sim ${o.simId??"?"}). run \`sootsim record stop\` first, or \`sootsim record cancel\` to discard.`),process.exit(1));let i=b(e,{port:r.port,stripBooleanFlags:["--no-shell","--shell-only"],stripValueFlags:["--mode","--fps","--format","--max-width","--origin","--owner","--repo"]}),t=ie(l(e,"--mode")),n=e.includes("--shell-only")?"shell":e.includes("--no-shell")?"tenant":void 0,s=l(e,"--format"),c=s==="mp4"?"mp4":"webm";s&&c!==s&&(console.error(`  record start only supports webm or mp4 (got: ${s}). for gif/png use atomic mode: sootsim record --format ${s} --duration <s>`),process.exit(1));let a=Number(l(e,"--fps")??"30"),m=re(e),u=v({...i,commandTimeoutMs:t==="live"||t==="combined"?Re:15e3});try{if(t==="live"||t==="combined"){n&&t==="live"&&console.log(`  note: --${n==="shell"?"shell-only":"no-shell"} is ignored for --mode live \u2014 live recordings capture events only, no video`),await P("record",{originOverride:l(e,"--origin"),allowGitHubAuth:!0}),await q(u),await ae(u,t),t==="combined"&&await T(u),await de(u,l(e,"--origin"),m);let p=await ce(u,t,t==="combined"?n:void 0);p.ok||(console.error(`  start failed: recording store refused to start (${t})`+(p.error?`: ${p.error}`:"")),process.exit(1))}else{await te(u),await T(u);let p={format:c,fps:a};n&&(p.layers=n);let x=await u.send({type:"evaluate",code:`window.__sootsimRecorder.start(${JSON.stringify(p)})`});x.ok||(console.error(`  start failed: ${x.error??"unknown error"}`),process.exit(1))}Ue({simId:i.simId??null,mode:t,format:c,fps:a,layers:n,startedAt:new Date().toISOString()}),console.log(t==="video"?`  recording ${c} @ ${a}fps${n?` (${n})`:""} \u2014 run \`sootsim record stop --output <path>\` when done`:`  recording ${t} \u2014 run \`sootsim record stop\` when done (add --open to launch the preview URL)`)}finally{u.close()}}async function Ce(e,r){let o=B();o&&(console.error(`  recording already in progress (started ${o.startedAt}, sim ${o.simId??"?"}). run \`sootsim record stop\` first, or \`sootsim record cancel\` to discard.`),process.exit(1));let i=b(e,{port:r.port,stripBooleanFlags:[],stripValueFlags:["--origin"]}),t=v({...i,commandTimeoutMs:15e3});try{if(await q(t),await T(t),!await t.send({type:"evaluate",code:`(() => {
         const start = window.SootSim?.bridges?.startRecordingPrelude
         if (typeof start !== 'function') return false
         return Promise.resolve(start()).then((value) => value === true)
@@ -25,7 +25,7 @@ import{a as P}from"./chunk-J2JAOIMN.js";import"./chunk-E3DLUOFK.js";import{a as
             ? eventRecorder.isRecording() === true
             : false;
         return { store: store ? store.state : undefined, headless, eventRecording };
-      })()`});return r?r.store==="recording"||r.headless==="recording"?"recording":r.store==="processing"?"processing":r.eventRecording?"prelude":r.store==="idle"||r.headless==="idle"?"idle":null:null}catch{return null}}async function Ce(e){let r=await e.send({type:"evaluate",code:`(() => {
+      })()`});return r?r.store==="recording"||r.headless==="recording"?"recording":r.store==="processing"?"processing":r.eventRecording?"prelude":r.store==="idle"||r.headless==="idle"?"idle":null:null}catch{return null}}async function Ie(e){let r=await e.send({type:"evaluate",code:`(() => {
         const store = window.SootSim?.bridges?.getRecordingState?.();
         const eventRecorder = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder;
         const hadStoreRecording = store && store.state !== 'idle';
@@ -40,7 +40,7 @@ import{a as P}from"./chunk-J2JAOIMN.js";import"./chunk-E3DLUOFK.js";import{a as
         const r = window.__sootsimRecorder;
         if (r && typeof r.forceRelease === 'function') return await r.forceRelease();
         return false;
-      })()`}).catch(()=>!1);return{store:r,headless:o}}async function Ae(e,r){let o=T();if(o){V(b(e,{port:r.port}).simId,o),o.mode==="video"?console.log(`  recording ${o.mode} (${o.format} @ ${o.fps}fps) on sim ${o.simId??"?"} since ${o.startedAt}`):console.log(`  recording ${o.mode} on sim ${o.simId??"?"} since ${o.startedAt}`);return}let i=b(e,{port:r.port}),t=v({...i,commandTimeoutMs:8e3});try{let n=await se(t);if(n==="recording"||n==="processing"||n==="prelude"){if(n==="prelude"){console.log("  a recording preview prelude is active. hidden setup is being\n  captured for the next live/combined preview recording. finish\n  it with `sootsim record start --mode combined`, or discard it\n  with `sootsim record cancel`.");return}console.log(`  a recording is in progress (engine state: ${n}), but not via
+      })()`}).catch(()=>!1);return{store:r,headless:o}}async function Ae(e,r){let o=B();if(o){V(b(e,{port:r.port}).simId,o),o.mode==="video"?console.log(`  recording ${o.mode} (${o.format} @ ${o.fps}fps) on sim ${o.simId??"?"} since ${o.startedAt}`):console.log(`  recording ${o.mode} on sim ${o.simId??"?"} since ${o.startedAt}`);return}let i=b(e,{port:r.port}),t=v({...i,commandTimeoutMs:8e3});try{let n=await se(t);if(n==="recording"||n==="processing"||n==="prelude"){if(n==="prelude"){console.log("  a recording preview prelude is active. hidden setup is being\n  captured for the next live/combined preview recording. finish\n  it with `sootsim record start --mode combined`, or discard it\n  with `sootsim record cancel`.");return}console.log(`  a recording is in progress (engine state: ${n}), but not via
   \`record start\` \u2014 it was started by an atomic \`record --duration\`
   run or the in-browser record button, which own their own lifecycle.
   if that controlling run is still alive it will finish on its own
@@ -48,7 +48,7 @@ import{a as P}from"./chunk-J2JAOIMN.js";import"./chunk-E3DLUOFK.js";import{a as
   process; live/combined upload to /preview/<id>). if the run was
   killed, the recording is abandoned and will NOT finish \u2014 reclaim
   it now with \`sootsim record cancel\`, or it auto-reclaims when the
-  abandoned capture's deadline lapses.`)}else console.log("  no recording in progress")}finally{t.close()}}async function Fe(e,r){let o=T();if(!o){let s=b(e,{port:r.port}),c=v({...s,commandTimeoutMs:8e3});try{let a=await se(c);if(a==="recording"||a==="processing"||a==="prelude"){let m=await Ce(c);m.store&&a==="prelude"?console.log("  recording preview prelude cancelled"):m.store||m.headless?console.log("  reclaimed an abandoned recording (started by an atomic\n  `record --duration` run or the record button whose owner is\n  gone). the recorder is idle again \u2014 live/combined can start."):console.log("  a recording is in progress and still owned by a live atomic\n  `record --duration` run or the in-browser record button \u2014 it\n  will finish on its own and nothing was reclaimed.")}else console.log("  no recording in progress")}finally{c.close()}return}let i=b(e,{port:r.port});V(i.simId,o);let t=o.simId??i.simId??void 0,n=v({...i,simId:t,commandTimeoutMs:15e3});try{o.mode==="live"||o.mode==="combined"?await n.send({type:"evaluate",code:"void window.SootSim?.bridges?.cancelRecording?.()"}):await n.send({type:"evaluate",code:"window.__sootsimRecorder.stop()"})}catch{}finally{k(),n.close()}console.log("  recording cancelled")}async function Pe(e,r){let o=T();o||(console.error("  no recording in progress. start one with `sootsim record start`."),process.exit(1));let i=b(e,{port:r.port,stripBooleanFlags:["--open"],stripValueFlags:["--output"]});V(i.simId,o);let t=o.simId??i.simId??void 0,n=e.includes("--open"),s=v({...i,simId:t,commandTimeoutMs:o.mode==="live"||o.mode==="combined"?z:6e4});try{if(o.mode==="live"||o.mode==="combined"){await le(s);let u=await ue(s);k(),me(u,n,o.mode);return}let c=l(e,"--output"),a=U(c,`sootsim-${M()}.${o.format}`);E(W(a),{recursive:!0});let m=await s.send({type:"evaluate",code:"window.__sootsimRecorder.stop()"});m.ok||(console.error(`  stop failed: ${m.error??"unknown error"}`),k(),process.exit(1)),m.size||(console.error("  recorder returned an empty blob \u2014 nothing written"),k(),process.exit(1)),await ne(s,a),k(),console.log(`  saved: ${a} (${G(m.size)})`)}finally{s.close()}}async function q(e){await L(e,'typeof window.SootSim?.bridges?.startRecording === "function" && typeof window.SootSim?.bridges?.stopRecording === "function"')||(console.error("  SootSim.bridges.startRecording missing \u2014 is sootsim engine running in this sim?"),process.exit(1))}async function ae(e,r){await L(e,`(() => {
+  abandoned capture's deadline lapses.`)}else console.log("  no recording in progress")}finally{t.close()}}async function Fe(e,r){let o=B();if(!o){let s=b(e,{port:r.port}),c=v({...s,commandTimeoutMs:8e3});try{let a=await se(c);if(a==="recording"||a==="processing"||a==="prelude"){let m=await Ie(c);m.store&&a==="prelude"?console.log("  recording preview prelude cancelled"):m.store||m.headless?console.log("  reclaimed an abandoned recording (started by an atomic\n  `record --duration` run or the record button whose owner is\n  gone). the recorder is idle again \u2014 live/combined can start."):console.log("  a recording is in progress and still owned by a live atomic\n  `record --duration` run or the in-browser record button \u2014 it\n  will finish on its own and nothing was reclaimed.")}else console.log("  no recording in progress")}finally{c.close()}return}let i=b(e,{port:r.port});V(i.simId,o);let t=o.simId??i.simId??void 0,n=v({...i,simId:t,commandTimeoutMs:15e3});try{o.mode==="live"||o.mode==="combined"?await n.send({type:"evaluate",code:"void window.SootSim?.bridges?.cancelRecording?.()"}):await n.send({type:"evaluate",code:"window.__sootsimRecorder.stop()"})}catch{}finally{O(),n.close()}console.log("  recording cancelled")}async function Pe(e,r){let o=B();o||(console.error("  no recording in progress. start one with `sootsim record start`."),process.exit(1));let i=b(e,{port:r.port,stripBooleanFlags:["--open"],stripValueFlags:["--output"]});V(i.simId,o);let t=o.simId??i.simId??void 0,n=e.includes("--open"),s=v({...i,simId:t,commandTimeoutMs:o.mode==="live"||o.mode==="combined"?z:6e4});try{if(o.mode==="live"||o.mode==="combined"){await le(s);let u=await ue(s);O(),me(u,n,o.mode);return}let c=l(e,"--output"),a=U(c,`sootsim-${M()}.${o.format}`);E(W(a),{recursive:!0});let m=await s.send({type:"evaluate",code:"window.__sootsimRecorder.stop()"});m.ok||(console.error(`  stop failed: ${m.error??"unknown error"}`),O(),process.exit(1)),m.size||(console.error("  recorder returned an empty blob \u2014 nothing written"),O(),process.exit(1)),await ne(s,a),O(),console.log(`  saved: ${a} (${G(m.size)})`)}finally{s.close()}}async function q(e){await L(e,'typeof window.SootSim?.bridges?.startRecording === "function" && typeof window.SootSim?.bridges?.stopRecording === "function"')||(console.error("  SootSim.bridges.startRecording missing \u2014 is sootsim engine running in this sim?"),process.exit(1))}async function ae(e,r){await L(e,`(() => {
       const fn = window.__sootsimCaptureBundle
       if (typeof fn !== 'function') return false
       const snap = fn()
@@ -56,7 +56,7 @@ import{a as P}from"./chunk-J2JAOIMN.js";import"./chunk-E3DLUOFK.js";import{a as
     })()`)||(console.error(`  --mode ${r} needs a guest app bundle to upload to /preview/<id>,
   but this sim has no bundle loaded (a built-in shell screen like
   photos/settings/home has none). open a metro/guest app first, or
-  use \`--mode video\` for a local screen recording with no upload.`),process.exit(1))}async function de(e,r,o){let i=Z();if(!i)return;let t=i.kind==="api-key"?i.secret:i.token,n=ke(),s=i.kind==="github"?{...ee(i),owner:o?.owner,repo:o?.repo,...n}:o?{owner:o.owner,repo:o.repo,...n}:null,c=r?r.replace(/\/$/,""):null;await e.send({type:"evaluate",code:`(() => {
+  use \`--mode video\` for a local screen recording with no upload.`),process.exit(1))}async function de(e,r,o){let i=Z();if(!i)return;let t=i.kind==="api-key"?i.secret:i.token,n=Oe(),s=i.kind==="github"?{...ee(i),owner:o?.owner,repo:o?.repo,...n}:o?{owner:o.owner,repo:o.repo,...n}:null,c=r?r.replace(/\/$/,""):null;await e.send({type:"evaluate",code:`(() => {
       const set = window.SootSim && window.SootSim.bridges && window.SootSim.bridges.setSession
       if (typeof set !== 'function') return false
       set({ token: ${JSON.stringify(t)}, user: null })
@@ -67,4 +67,4 @@ import{a as P}from"./chunk-J2JAOIMN.js";import"./chunk-E3DLUOFK.js";import{a as
     })()`})||(console.error("  SootSim.bridges.setSession missing \u2014 this sim is running an engine\n  build without CLI-injected preview auth. reload the sim or open a\n  fresh one (`sootsim open --new`); if it persists, update sootsim."),process.exit(1))}async function ce(e,r,o){let i=o?JSON.stringify(o):"undefined";return await e.send({type:"evaluate",code:`window.SootSim.bridges.startRecording(${JSON.stringify(r)}, ${i}, { skipEntitlement: true })`})===!0?{ok:!0,error:null}:{ok:!1,error:await e.send({type:"evaluate",code:"(window.SootSim?.bridges?.getRecordingStartError?.() ?? null)"}).catch(()=>null)??null}}async function le(e){await e.send({type:"evaluate",code:"void window.SootSim.bridges.stopRecording()"})}async function ue(e){let r=Date.now()+z;for(;Date.now()<r;){let o=await e.send({type:"evaluate",code:"(() => { const s = window.SootSim?.bridges?.getRecordingState?.(); return s ? { state: s.state, lastUpload: s.lastUpload, uploadError: s.uploadError } : null })()"});if(o&&o.state==="idle"){if(o.uploadError)return{uploadError:o.uploadError};if(o.lastUpload?.previewUrl)return{previewUrl:o.lastUpload.previewUrl,eventCount:o.lastUpload.eventCount}}await new Promise(i=>setTimeout(i,300))}return{uploadError:`upload did not settle within ${z/1e3}s`}}function me(e,r,o){e.uploadError&&(console.error(`  upload failed: ${e.uploadError}`),process.exit(1)),e.previewUrl||(console.error("  upload returned no preview URL"),process.exit(1)),console.log(`  preview: ${e.previewUrl}`),console.log(`  note: this URL is content-addressed \u2014 re-recording the same bundle
   replaces this capture at the same /preview/<id>.`),(o==="live"||o==="combined")&&typeof e.eventCount=="number"&&console.log(`  captured ${e.eventCount} event${e.eventCount===1?"":"s"}`),(o==="live"||o==="combined")&&e.eventCount===0&&console.log(o==="combined"?`  note: this combined recording captured no events \u2014 the Live tab has
   nothing to replay. Video will play the captured screen recording.`:`  note: this live recording captured no events \u2014 the preview has nothing
-  to replay and will boot a fresh interactive session instead.`),r&&Y(e.previewUrl)}export{Be as extToFormat,Te as resolveFormat,qe as runRecord,l as valueOf};
+  to replay and will boot a fresh interactive session instead.`),r&&Y(e.previewUrl)}export{Te as extToFormat,Be as resolveFormat,qe as runRecord,l as valueOf};

package/dist-cli/chunks/runtime-LR63M7XX.js

@@ -0,0 +1,2 @@
+/*! sootsim v0.1.229 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{a}from"./chunk-PNLTVAPK.js";import"./chunk-XQHCHVHE.js";import"./chunk-6Q3M6FMW.js";import"./chunk-AB7XCG3A.js";import"./chunk-4O73AHYA.js";import"./chunk-TWUPMUWQ.js";import"./chunk-U4OPCVAL.js";export{a as runRuntime};

package/dist-cli/chunks/screenshot-command-HFNYL2CY.js

@@ -0,0 +1,151 @@
+/*! sootsim v0.1.229 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{a as re,b as ne,f as se}from"./chunk-S4CJUMUZ.js";import"./chunk-7IBNJPSB.js";import{a as k}from"./chunk-UCVK6JDW.js";import{b as Q}from"./chunk-P3ORPGKZ.js";import{a as ee}from"./chunk-VKVRAWJR.js";import"./chunk-JK4AGL2U.js";import{a as te,b as oe}from"./chunk-SPBHQVJ4.js";import"./chunk-BZOTL2IQ.js";import"./chunk-PY65YXHI.js";import"./chunk-6VQIZJLG.js";import"./chunk-DXF6DHIR.js";import"./chunk-SHBXXKJW.js";import"./chunk-HKZICBKI.js";import"./chunk-OWSZCLYZ.js";import"./chunk-THDVL3ST.js";import"./chunk-V2TABN7W.js";import"./chunk-FF7GZMWQ.js";import{r as K}from"./chunk-3FYUTNM4.js";import{g as A,h as X,i as R,j as J,k as Z,l as M,m as $}from"./chunk-6Q3M6FMW.js";import"./chunk-SYZKYAPC.js";import"./chunk-UGFZIHBA.js";import"./chunk-WRPO6J3Z.js";import"./chunk-CE3XI55C.js";import"./chunk-AZWH6YSL.js";import"./chunk-AB7XCG3A.js";import"./chunk-4O73AHYA.js";import"./chunk-GVOFX6LJ.js";import"./chunk-TWUPMUWQ.js";import"./chunk-TJXRSDEU.js";import{a as x,b as j,c as I,d as L,e as U,f as F,g as E}from"./chunk-OUJVQUX4.js";import"./chunk-U4OPCVAL.js";import{mkdirSync as ce,writeFileSync as ie}from"fs";import{dirname as le,resolve as ue}from"path";async function de(e,t){let o=Le(e);(o.includes("--help")||o.includes("-h"))&&(console.log(`
+sootsim screenshot \u2014 capture the canvas as a PNG
+
+usage:
+  sootsim screenshot [output] [options]
+  sootsim screenshot [options] --output <path>
+
+options:
+  --output <path>     output file path (default: /tmp/sootsim-inspect.png)
+                      first positional arg works too: \`screenshot /tmp/x.png\`
+  --with-frame        wrap the captured screen in a tight device frame
+  --no-frame          capture the raw screen bitmap (default)
+  --no-shell          tenant-only capture (no status bar, keyboard, toasts,
+                      notification center, or other shell overlays). use for
+                      clean app screenshots when a shell surface is in the way.
+  --shell-only        capture only the shell chrome, no tenant content
+  --area x,y,w,h      crop to a logical sootsim rect
+  --id <testID>       crop to a node's bounding box
+  --text <text>       crop to a node found by text content
+  --gallery           crawl and capture multiple screens as HTML gallery
+  --themes            capture light and dark variants
+
+examples:
+  sootsim screenshot
+  sootsim screenshot --no-shell --output app.png
+  sootsim screenshot --with-frame --output framed.png
+  sootsim screenshot --area 0,200,393,400 --output hero.png
+  sootsim screenshot --id loginButton --output button.png
+`),process.exit(0));let i=Ue(o);if(i.length>0){for(let{flag:p,suggestion:g}of i)console.error(g?`  unknown flag: ${p} (did you mean ${g}?)`:`  unknown flag: ${p}`);console.error("  run `sootsim screenshot --help` for the list of supported flags"),process.exit(1)}let r=o.includes("--gallery"),s=o.includes("--themes"),n=ze(o),a=_e(o);if(r||s)return n&&(console.error("  --with-frame is not supported with --gallery / --themes"),process.exit(1)),ae(o,t);n&&o.some(p=>p==="--area"||p==="--id"||p==="--text")&&(console.error("  --with-frame only supports full-screen capture for now"),console.error("  remove --area / --id / --text, or capture raw and compose later"),process.exit(1));let c=A(o,{port:t.port,stripBooleanFlags:["--with-frame","--no-frame","--no-shell","--shell-only"],stripValueFlags:["--output","--area","--id","--text"]}),l=me(o),u=await Be(o);if(await Re(c.wsPort)){try{await Oe(c,l,u,n,a)}catch(p){console.error(`  screenshot failed: ${p instanceof Error?p.message:String(p)}`),process.exit(1)}return}n&&(console.error("  --with-frame requires a running sootsim bridge"),console.error("  open the app in a live sim first, then rerun the command"),process.exit(1)),u&&(console.error("  --area / --id / --text require a running sootsim bridge"),console.error("  start one with `sootsim serve`, `sootsim desktop`, or your project dev server"),process.exit(1)),await ae(o,t)}async function Re(e){let t=X(e,{commandTimeoutMs:1e3});try{return await t.listSims(),!0}catch{return!1}finally{t.close()}}async function Be(e){let t=e.find((r,s)=>e[s-1]==="--area");if(t){let r=t.split(",").map(l=>Number(l.trim()));if(r.length!==4||r.some(l=>!Number.isFinite(l)))throw new Error(`--area expects x,y,w,h (got "${t}")`);let[s,n,a,c]=r;return{x:s,y:n,w:a,h:c}}let o=e.find((r,s)=>e[s-1]==="--id"),i=e.find((r,s)=>e[s-1]==="--text");return o||i?{__matcher:{id:o,text:i}}:null}async function Oe(e,t,o,i,r){let s=R({...e,commandTimeoutMs:45e3});try{(await J(s)).hidden&&process.stderr.write(`  \u26A0 screenshot will capture the LAST PAINTED canvas \u2014 likely stale.
+  navigation/\`shell\` commands sent before this screenshot may not
+  have repainted yet. focus the tab manually or \`sootsim --sim <id>\`
+  to target a visible sim before capturing.
+
+`);let a=Number(process.env.CONTRAST_SCREENSHOT_READY_MAX_MS)||9e4,c=await K(s,a);if(!c.ready)throw new Error(`app not ready to capture after ${Math.round(c.elapsedMs/1e3)}s`+(c.loadingText?` (still showing "${c.loadingText}")`:"")+"; refusing to capture the boot/loading card. retry once the app paints.");let l=o,u=o?.__matcher;if(u){let v=await s.send({type:"evaluate",code:Q(u)});if(!v)throw new Error(u.id?`no node with id "${u.id}"`:`no node matching text "${u.text}"`);l=v}let d=l?{x:l.x,y:l.y,w:l.w,h:l.h}:void 0,p={type:"screenshot"};r&&(p.layers=r),d&&(p.crop=d);let g=await s.send(p);if(typeof g!="string"||g.length<="data:image/png;base64,".length)throw new Error("screenshot capture returned no image data \u2014 the sim is connected but not painting; check `sootsim get errors`");let m=g.replace(/^data:image\/png;base64,/,"");d&&console.log(`  area:  x=${d.x} y=${d.y} w=${d.w} h=${d.h}`),r&&console.log(`  layers: ${r}`);let w=ue(process.cwd(),t||"/tmp/sootsim-inspect.png");ce(le(w),{recursive:!0});let S=Buffer.from(m,"base64");if(i){let v=await Te(s);if(!v)throw new Error("could not read current device model from the target sim");let Ae=await re(S,v);ie(w,Ae),console.log(`  frame: ${v}`)}else ie(w,S);console.log(`  saved: ${w}`)}finally{s.close()}}async function Te(e){let t=await M(e,"SootSim.bridges.settings.get")??{deviceModel:null},o=typeof t.deviceModel=="string"?t.deviceModel:null;return!o||!(o in E)?null:o}function ze(e){let t=!1;for(let o of e)o==="--with-frame"&&(t=!0),o==="--no-frame"&&(t=!1);return t}function _e(e){if(e.includes("--shell-only"))return"shell";if(e.includes("--no-shell"))return"tenant"}var je=new Set(["--help","-h","--verbose","-v","--with-frame","--no-frame","--no-shell","--shell-only","--gallery","--themes"]),pe=new Set(["--output","--area","--id","--text","--url","--port","--timeout","--sim"]),Ie={"--rect":"--area","--crop":"--area","--region":"--area","--bounds":"--area","--box":"--area","--xywh":"--area","--out":"--output","-o":"--output","--file":"--output","--path":"--output","--testid":"--id","--test-id":"--id","--test_id":"--id"};function Le(e){let t=[],o={"-o":"--output","--out":"--output","--file":"--output","--path":"--output","--testid":"--id","--test-id":"--id","--test_id":"--id","--rect":"--area","--crop":"--area","--region":"--area","--bounds":"--area","--box":"--area","--xywh":"--area"};for(let i of e){let r=o[i];t.push(r??i)}return t}function Ue(e){let t=[];for(let o=0;o<e.length;o++){let i=e[o];if(i.startsWith("-")){if(pe.has(i)){o++;continue}je.has(i)||t.push({flag:i,suggestion:Ie[i]})}}return t}function me(e){let t=e.find((o,i)=>e[i-1]==="--output");if(t)return t;for(let o=0;o<e.length;o++){let i=e[o];if(i.startsWith("-")){pe.has(i)&&o++;continue}return i}}async function ae(e,t){let o=me(e)||"sootsim-screenshot.png",i=e.includes("--gallery"),r=e.find((a,c)=>e[c-1]==="--url")||`http://localhost:${t.port||5173}`,{chromium:s}=await import("playwright"),n=await k(a=>s.launch(a),{headless:!0});try{if(i)console.log("  capturing gallery..."),console.log("  (gallery mode not yet implemented)");else{let a=await n.newPage({viewport:{width:500,height:900}});await a.goto(r,{waitUntil:"networkidle"}),await a.waitForTimeout(2e3);let c=ue(process.cwd(),o);ce(le(c),{recursive:!0}),await a.screenshot({path:c}),console.log(`  saved: ${c}`),await a.close()}}catch(a){console.error(`  screenshot failed: ${a.message}`),process.exitCode=1}finally{await n.close()}}import{mkdirSync as V,readFileSync as et,writeFileSync as ve}from"fs";import{tmpdir as to}from"os";import T from"path";import{mkdirSync as fe,readFileSync as He,writeFileSync as ge}from"fs";import H from"path";function he(e){return e.replace(/\\/g,"/").replace(/\.png$/i,"").trim().split("/").filter(Boolean).join("--").replace(/[^A-Za-z0-9-]+/g,"-").replace(/-+/g,"-").replace(/^-|-$/g,"")||"slide"}function Y(e){return e.replaceAll("&","&amp;").replaceAll("<","&lt;").replaceAll(">","&gt;").replaceAll('"',"&quot;")}function Ye(e){let t=e.trim();return/^#[0-9a-f]{3}$/i.test(t)?`#${t[1]}${t[1]}${t[2]}${t[2]}${t[3]}${t[3]}`:t}function B(e,t){let o=Ye(e),i=Math.max(0,Math.min(1,t)),r=o.match(/^#([0-9a-f]{6})$/i);if(r){let s=r[1],n=Number.parseInt(s.slice(0,2),16),a=Number.parseInt(s.slice(2,4),16),c=Number.parseInt(s.slice(4,6),16);return`rgba(${n}, ${a}, ${c}, ${i})`}return o.startsWith("rgb(")?o.replace(/^rgb\((.+)\)$/i,`rgba($1, ${i})`):o}function Ge(e){if(e.type==="solid")return e.color||"#000000";let t=e.direction??180,o=e.stops?.map(i=>`${i.color} ${i.offset}%`).join(", ")||"#000000 0%, #111111 100%";return`linear-gradient(${t}deg, ${o})`}function We(e){let t=e.glow;return t?`radial-gradient(circle at 50% 24%, ${B(t,.46)} 0%, ${B(t,.2)} 24%, rgba(0,0,0,0) 62%)`:"none"}function G(e){switch(e){case"tilted-left":return"perspective(2400px) rotateY(10deg) rotateZ(-2deg)";case"tilted-right":return"perspective(2400px) rotateY(-10deg) rotateZ(2deg)";case"cut-bottom":return"translateY(10%) scale(1.08)";case"cut-top":return"translateY(-16%) scale(1.08)";case"straight":default:return"none"}}function we(...e){let t=e.map(o=>o.trim()).filter(o=>o.length>0&&o!=="none");return t.length>0?t.join(" "):"none"}function W(e){let t=B(e.color,e.opacity),o=B(e.color,e.opacity*.52);return`drop-shadow(0 34px ${e.spread}px ${o}) drop-shadow(0 0 ${e.blur}px ${t})`}function q(e,t){return!t.glow||e.color&&e.color!==x.color?e:{...e,color:t.glow}}function qe(e,t){if(e==="editorial-left"){let r=Math.round(t.height*.056),s=Math.round(t.height*.022);return{copyStyle:["position:absolute",`top:${Math.round(t.height*.12)}px`,`left:${Math.round(t.width*.085)}px`,`width:${Math.round(t.width*.42)}px`,"text-align:left","z-index:3"].join(";"),titleStyle:`font-size:${r}px;line-height:0.92;`,subStyle:`font-size:${s}px;line-height:1.36;max-width:${Math.round(t.width*.36)}px;`,eyebrowStyle:"align-items:flex-start;",deviceStyle:(n,a,c)=>{let l=Math.round(t.width*.68*(a.scale??n.scale)),u=Math.round(t.height*(.03+n.offsetY+(a.offsetY??0))),d=a.pose||n.pose||"tilted-right",p=q(n.shadow,c);return["position:absolute",`top:${Math.round(t.height*.18)+u}px`,`left:${Math.round(t.width*.56)}px`,`width:${l}px`,"transform-origin:center center",`transform:${G(d)}`,`filter:${W(p)}`,"z-index:2"].join(";")}}}if(e==="minimal-bottom"){let r=Math.round(t.height*.041),s=Math.round(t.height*.019);return{copyStyle:["position:absolute",`left:${Math.round(t.width*.12)}px`,`right:${Math.round(t.width*.12)}px`,`bottom:${Math.round(t.height*.085)}px`,"text-align:center","z-index:3"].join(";"),titleStyle:`font-size:${r}px;line-height:0.96;`,subStyle:`font-size:${s}px;line-height:1.34;max-width:${Math.round(t.width*.56)}px;margin:0 auto;`,eyebrowStyle:"align-items:center;",deviceStyle:(n,a,c)=>{let l=Math.round(t.width*.84*(a.scale??n.scale)),u=Math.round(t.height*(n.offsetY+(a.offsetY??0))),d=a.pose||n.pose,p=q(n.shadow,c);return["position:absolute",`top:${Math.round(t.height*.075)+u}px`,"left:50%",`width:${l}px`,"transform-origin:center center",`transform:${we("translateX(-50%)",G(d))}`,`filter:${W(p)}`,"z-index:2"].join(";")}}}let o=Math.round(t.height*.04),i=Math.round(t.height*.019);return{copyStyle:["position:absolute",`top:${Math.round(t.height*.084)}px`,"left:50%",`width:${Math.round(t.width*.88)}px`,"transform:translateX(-50%)","text-align:center","z-index:3"].join(";"),titleStyle:`font-size:${o}px;line-height:0.92;`,subStyle:`font-size:${i}px;line-height:1.34;max-width:${Math.round(t.width*.6)}px;margin:0 auto;`,eyebrowStyle:"align-items:center;",deviceStyle:(r,s,n)=>{let a=Math.round(t.width*.64*(s.scale??r.scale)),c=Math.round(t.height*(r.offsetY+(s.offsetY??0))),l=s.pose||r.pose,u=q(r.shadow,n);return["position:absolute",`top:${Math.round(t.height*.28)+c}px`,"left:50%",`width:${a}px`,"transform-origin:center top",`transform:${we("translateX(-50%)",G(l))}`,`filter:${W(u)}`,"z-index:2"].join(";")}}}function Ve({canvas:e,compose:t,slide:o,imageDataUrl:i}){let r=o.background??t.background,s=qe(t.text.preset,e),n=t.text.preset!=="none"&&!!(o.eyebrow||o.headline||o.subheadline),a=s.deviceStyle(t.frame,o,r),c=o.headline?`<div style="font-weight:780;white-space:pre-line;text-wrap:balance;${s.titleStyle}">${Y(o.headline)}</div>`:"",l=o.subheadline?`<div style="margin-top:${Math.round(e.height*.018)}px;color:${t.text.subColor};white-space:pre-line;text-wrap:balance;${s.subStyle}">${Y(o.subheadline)}</div>`:"",u=o.eyebrow?`<div style="display:flex;${s.eyebrowStyle}margin-bottom:${Math.round(e.height*.016)}px;"><div style="font-size:${Math.round(e.height*.014)}px;font-weight:700;letter-spacing:0.18em;text-transform:uppercase;color:${t.text.eyebrowColor};">${Y(o.eyebrow)}</div></div>`:"";return`<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <style>
+      html, body {
+        margin: 0;
+        width: ${e.width}px;
+        height: ${e.height}px;
+        overflow: hidden;
+        background: transparent;
+      }
+      body {
+        font-family: "SF Pro Display", "Helvetica Neue", system-ui, sans-serif;
+      }
+      #canvas {
+        position: relative;
+        width: ${e.width}px;
+        height: ${e.height}px;
+        overflow: hidden;
+        background: ${Ge(r)};
+        color: ${t.text.color};
+        isolation: isolate;
+      }
+      #glow {
+        position: absolute;
+        inset: 0;
+        background: ${We(r)};
+        pointer-events: none;
+      }
+      #copy {
+        ${s.copyStyle};
+      }
+      #device {
+        ${a};
+      }
+      #device img {
+        display: block;
+        width: 100%;
+        height: auto;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="canvas">
+      <div id="glow"></div>
+      ${n?`<div id="copy">${u}${c}${l}</div>`:""}
+      <div id="device"><img src="${i}" alt="" /></div>
+    </div>
+  </body>
+</html>`}async function ye(e,t,o){let i=[],r=o??await(async()=>{let{chromium:n}=await import("playwright");return k(a=>n.launch(a),{headless:!0})})();try{let n=await r.newContext({viewport:{width:1280,height:720}});try{for(let a of t){let l=`data:image/png;base64,${He(a.imagePath).toString("base64")}`;for(let u of e.canvases){let d=await n.newPage();try{await d.setViewportSize({width:u.width,height:u.height}),await d.setContent(Ve({canvas:u,compose:e,slide:a.slide,imageDataUrl:l}),{waitUntil:"load"}),await d.waitForTimeout(20);let p=H.join(e.outDir,u.name,e.locale);fe(p,{recursive:!0});let g=H.join(p,`${a.slide.assetKey}.png`),f=await d.screenshot({type:"png",clip:{x:0,y:0,width:u.width,height:u.height}});ge(g,f),i.push({slideId:a.slide.id,canvas:u.name,locale:e.locale,outputPath:g,sourcePath:a.imagePath})}finally{await d.close()}}}}finally{await n.close()}}finally{!o&&typeof r.close=="function"&&await r.close()}fe(e.outDir,{recursive:!0});let s=H.join(e.outDir,"manifest.json");return ge(s,JSON.stringify({generatedAt:new Date().toISOString(),locale:e.locale,outputs:i},null,2)),{manifestPath:s,outputs:i.map(n=>n.outputPath),entries:i}}function D(e){return typeof e=="string"&&e.length>0?e:void 0}async function Se(e){let o=`${e.origin.replace(/\/$/,"")}/api/sootsim/screenshot-decks?org=${encodeURIComponent(e.org)}&repo=${encodeURIComponent(e.repo)}`,i=await fetch(o,{headers:{Authorization:e.authHeader}});if(!i.ok){let a=await i.text().catch(()=>"");throw new Error(`org deck fetch failed (${i.status} ${i.statusText}) for ${e.org}/${e.repo}${a?` \u2014 ${a.slice(0,200)}`:""}`)}let s=(await i.json()).decks?.[0];if(!s||!s.config||typeof s.config!="object")return null;let n=s.config.frames;return Array.isArray(n)?n.map(a=>{let c=a??{};return{title:D(c.title),subtitle:D(c.subtitle),bgTop:D(c.bgTop),bgBottom:D(c.bgBottom),titleColor:D(c.titleColor)}}):null}function be(e,t){e.compose.slides.forEach((o,i)=>{let r=t[i];if(r&&(r.title!=null&&(o.headline=r.title),r.subtitle!=null&&(o.subheadline=r.subtitle),r.bgTop&&r.bgBottom)){let s={type:"gradient",direction:180,stops:[{offset:0,color:I(r.bgTop)},{offset:1,color:I(r.bgBottom)}]};o.background=s}})}import{readFileSync as Ke}from"fs";import P from"path";function h(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function O(e,t){if(!h(e))throw new Error(`${t} must be an object`);return e}function y(e,t=""){return typeof e=="string"?e:t}function b(e){return typeof e=="string"&&e.trim().length>0?e.trim():null}function xe(e,t){return typeof e=="boolean"?e:t}function C(e,t){return typeof e=="number"&&Number.isFinite(e)?e:t}function Pe(e,t){return typeof e!="string"||e.trim().length===0?t:Object.prototype.hasOwnProperty.call(E,e)?e:null}function $e(e,t){if(typeof e=="string"){let r=F(e);if(!r)throw new Error(`unknown background preset: ${e}`);return r}if(!h(e))return U(t);let o=e.type==="solid"||e.type==="gradient"?e.type:t.type;if(o==="solid")return{type:o,color:y(e.color,t.color??"#000000"),glow:b(e.glow)??t.glow};let i=Array.isArray(e.stops)?e.stops.map(r=>{if(!h(r))return null;let s=C(r.offset,Number.NaN),n=b(r.color);return!Number.isFinite(s)||!n?null:{offset:s,color:n}}).filter(r=>!!r):t.stops?.map(r=>({...r}))??[];return{type:o,direction:C(e.direction,t.direction??180),glow:b(e.glow)??t.glow,stops:i.length>0?i:t.stops?.map(r=>({...r}))??[]}}function Xe(e){let o=(Array.isArray(e)?e:["iphone-6-9"]).map(i=>{if(typeof i!="string")throw new Error("compose.canvases entries must be strings");let r=L(i);if(!r)throw new Error(`unknown canvas preset: ${i}`);return r});if(o.length===0)throw new Error("compose.canvases must include at least one preset");return o}function Je(e){switch(e){case"editorial-left":case"minimal-bottom":case"none":case"bold-top":return e;default:return"bold-top"}}function Ze(e){switch(e){case"plan":case"flow":case"auto":return e;default:return"auto"}}function ke(e){switch(e){case"straight":case"tilted-left":case"tilted-right":case"cut-bottom":case"cut-top":return e;default:return}}function N(e,t){return P.isAbsolute(t)?t:P.resolve(e,t)}function Qe(e,t){if(!Array.isArray(e)||e.length===0)throw new Error("compose.slides must be a non-empty array");return e.map((o,i)=>{let r=O(o,`compose.slides[${i}]`),s=b(r.screenshot);if(!s)throw new Error(`compose.slides[${i}].screenshot is required`);let n=b(r.id),a=he(n||s);return{id:n||a,assetKey:a,screenshot:s,headline:y(r.headline),subheadline:y(r.subheadline),eyebrow:y(r.eyebrow),pose:ke(r.pose),scale:typeof r.scale=="number"&&Number.isFinite(r.scale)?r.scale:void 0,offsetY:typeof r.offsetY=="number"&&Number.isFinite(r.offsetY)?r.offsetY:void 0,background:r.theme||r.background?$e(r.theme??r.background,t):void 0}})}function Ce(e){let t=P.resolve(e),o=P.dirname(t),i=ee.parse(Ke(t,"utf8")),r=O(i,"screenshots plan"),s=O(r.capture??{},"capture"),n=O(r.compose??{},"compose"),a=typeof r.app=="number"?String(r.app):b(r.app),c=Pe(r.device,null),l=N(o,y(s.out,P.join(".sootsim","screenshots","capture"))),u=b(s.from),d=b(s.flow);if(!u&&!d)throw new Error("capture.flow or capture.from is required");let p=s.mode==="raw"||s.mode==="framed"||s.mode==="raw+framed"?s.mode:"raw+framed",g=Ze(s.pathMode),f=$e(n.background??"cyan",F("cyan")),m={show:xe(n.frame&&h(n.frame)?n.frame.show:void 0,!0),style:Pe(n.frame&&h(n.frame)?n.frame.style:null,null)||c||j,pose:ke(n.frame&&h(n.frame)?n.frame.pose:void 0)||"straight",scale:C(n.frame&&h(n.frame)?n.frame.scale:void 0,1),offsetY:C(n.frame&&h(n.frame)?n.frame.offsetY:void 0,0),shadow:{color:y(n.frame&&h(n.frame)&&h(n.frame.shadow)?n.frame.shadow.color:void 0,x.color),blur:C(n.frame&&h(n.frame)&&h(n.frame.shadow)?n.frame.shadow.blur:void 0,x.blur),spread:C(n.frame&&h(n.frame)&&h(n.frame.shadow)?n.frame.shadow.spread:void 0,x.spread),opacity:C(n.frame&&h(n.frame)&&h(n.frame.shadow)?n.frame.shadow.opacity:void 0,x.opacity)}};return{planPath:t,planDir:o,appTarget:a,deviceModel:c,capture:{flowPath:d?N(o,d):null,fromDir:u?N(o,u):null,outDir:l,rawDir:u?N(o,u):P.join(l,"raw"),framedDir:P.join(l,"framed"),mode:p,pathMode:g,simId:b(s.sim),openInNewSim:xe(s.new,!1)},compose:{outDir:N(o,y(n.out,P.join(".sootsim","screenshots","exports"))),locale:y(n.locale,"en"),canvases:Xe(n.canvases),frame:m,background:f,text:{preset:Je(n.text&&h(n.text)?n.text.preset:void 0),color:y(n.text&&h(n.text)?n.text.color:void 0,"#ffffff"),subColor:y(n.text&&h(n.text)?n.text.subColor:void 0,"rgba(232,240,247,0.86)"),eyebrowColor:y(n.text&&h(n.text)?n.text.eyebrowColor:void 0,"rgba(229,242,255,0.72)")},slides:Qe(n.slides,f)}}}function tt(e){return e.capture.pathMode==="plan"||e.capture.pathMode==="flow"?e.capture.pathMode:e.capture.fromDir?"flow":"plan"}function ot(e,t){if(!e.capture.flowPath)throw new Error("capture flow path is required to build flow args");let o=[e.capture.flowPath],i=tt(e);o.push("--screenshots",e.capture.rawDir),i==="flow"&&o.push("--screenshot-paths","flow");let r=t.appTarget??e.appTarget,s=t.deviceModel??e.deviceModel,n=t.simId??e.capture.simId;return r&&o.push("--url",r),s&&o.push("--device",s),n&&o.push("--sim",n),e.capture.openInNewSim&&o.push("--new"),o}function z(e,t){return T.isAbsolute(t)?t:T.join(e.capture.rawDir,t)}function rt(e){return T.join(e.capture.outDir,"manifest.json")}async function nt(e,t){if(!e.capture.flowPath)return;V(e.capture.rawDir,{recursive:!0});let o=ot(e,t),i=await se(o);if(i!==0)throw new Error(`flow capture failed with exit code ${i}`)}async function st(e,t){let o=new Map;V(e.capture.framedDir,{recursive:!0});let i=t??await(async()=>{let{chromium:r}=await import("playwright");return k(s=>r.launch(s),{headless:!0})})();try{let r=await ne(i);try{for(let s of e.compose.slides){let n=z(e,s.screenshot),a=et(n),c=await r.compose(a,e.compose.frame.style),l=T.join(e.capture.framedDir,`${s.assetKey}.png`);ve(l,c),o.set(s.id,l)}}finally{await r.close()}}finally{!t&&typeof i.close=="function"&&await i.close()}return o}function it(e,t,o){let i=[],r=[];V(e.capture.outDir,{recursive:!0});let s=rt(e),n=e.compose.slides.map(a=>{let c=z(e,a.screenshot),l=t.get(a.id)??null;return i.push(c),l&&r.push(l),{id:a.id,screenshot:a.screenshot,rawPath:c,framedPath:l}});return ve(s,JSON.stringify({generatedAt:new Date().toISOString(),deviceModel:o,mode:e.capture.mode,rawDir:e.capture.rawDir,framedDir:e.capture.framedDir,slides:n},null,2)),{manifestPath:s,rawDir:e.capture.rawDir,framedDir:e.capture.framedDir,rawFiles:i,framedFiles:r}}function at(e,t){return e.compose.slides.map(o=>({slide:o,imagePath:e.compose.frame.show===!0?t.get(o.id)??z(e,o.screenshot):z(e,o.screenshot)}))}async function Me(e,t={}){let o=Ce(e);t.orgDeckFrames&&t.orgDeckFrames.length>0&&be(o,t.orgDeckFrames);let i=t.deviceModel??o.deviceModel;t.composeOnly||await nt(o,t);let r=o.capture.mode!=="raw"||!t.captureOnly&&o.compose.frame.show===!0,n=r||!t.captureOnly?await(async()=>{let{chromium:a}=await import("playwright");return k(c=>a.launch(c),{headless:!0})})():null;try{let a=r?await st(o,n??void 0):new Map,c=it(o,a,i);if(t.captureOnly)return{plan:o,capture:c,compose:null};let l=at(o,a),u=await ye(o.compose,l,n??void 0);return{plan:o,capture:c,compose:u}}finally{n&&typeof n.close=="function"&&await n.close()}}async function De(e,t={}){if(e.includes("--help")||e.includes("-h"))return console.log(`
+sootsim screenshot appstore \u2014 capture and compose app-store screenshot sets
+
+usage:
+  sootsim screenshot appstore --plan <plan.yaml> [options]
+
+options:
+  --plan <path>         screenshot plan yaml
+  --sim <id>            reuse a live sim for capture
+  --app <target>        override plan app target (port, url, or shell url)
+  --device <model>      override plan capture device for this run
+  --org <slug>          overlay copy/colors from a team's org screenshot deck
+  --repo <name>         repo for --org (both required to pull the org deck)
+  --api-origin <url>    contrast origin to fetch the deck from (default: the
+                        signed-in session origin, else https://contrast.dev)
+  --capture-only        stop after raw/framed intermediates
+  --compose-only        skip flow capture, reuse existing raw screenshots
+
+examples:
+  sootsim screenshot appstore --plan app-store.yaml
+  sootsim screenshot appstore --plan app-store.yaml --sim a9
+  sootsim screenshot appstore --plan app-store.yaml --org acme --repo mobile
+`),0;let o=m=>e.find((w,S)=>e[S-1]===m),i=new Set(["--plan","--sim","--app","--device","--org","--repo","--api-origin"]),r=e.filter((m,w)=>{if(m.startsWith("-"))return!1;let S=e[w-1];return!S||!i.has(S)}),s=o("--plan")||r[0];if(!s)return console.error("  error: screenshots plan path is required (`--plan <path>`)."),1;let n=o("--sim")?.trim()||null,a=o("--app")?.trim()||null,c=o("--device")?.trim()||null,l=o("--org")?.trim()||null,u=o("--repo")?.trim()||null,d=o("--api-origin")?.trim()||null,p=e.includes("--capture-only"),g=e.includes("--compose-only"),f=null;if(l||u){if(!l||!u)return console.error("  error: --org and --repo must be passed together."),1;let m=te();if(!m)return console.error("  error: --org/--repo needs auth \u2014 run `sootsim login` or set SOOTSIM_API_KEY."),1;let w=d||(m.kind==="session"?m.origin:"https://contrast.dev");try{f=await Se({org:l,repo:u,origin:w,authHeader:oe(m)})}catch(S){return console.error(`  ${S.message}`),1}!f||f.length===0?console.log(`  note: no org deck for ${l}/${u} \u2014 composing with the plan's copy/colors.`):console.log(`  org deck: ${f.length} slide(s) from ${l}/${u}`)}try{let m=await Me(s,{simId:n,appTarget:a,deviceModel:c,captureOnly:p,composeOnly:g,orgDeckFrames:f});return console.log(`  capture manifest: ${m.capture.manifestPath}`),m.compose?(console.log(`  compose manifest: ${m.compose.manifestPath}`),console.log(`  exports: ${m.compose.outputs.length}`)):console.log("  compose skipped"),0}catch(m){return console.error(`  screenshots failed: ${m.message}`),1}}import{mkdirSync as ct,writeFileSync as lt}from"node:fs";import{dirname as ut,isAbsolute as dt,join as Ne,resolve as pt}from"node:path";var mt=`
+sootsim screenshot slides \u2014 compose App Store screenshots in the live sim
+
+usage:
+  sootsim screenshot slides                       list slides (alias: slides list)
+  sootsim screenshot slides set <n> [fields]      patch a slide's copy/colors
+  sootsim screenshot slides add                   append a blank slide (focuses it)
+  sootsim screenshot slides remove <n>            delete a slide
+  sootsim screenshot slides focus <n>             open a slide (device flips into it)
+  sootsim screenshot slides overview              back to the gallery
+  sootsim screenshot slides capture [<n>]         capture the live frame into a slide
+  sootsim screenshot slides export [<n>] [--out <dir>]
+                                                  write composed App-Store PNG(s)
+
+set fields:
+  --title <text>          headline
+  --subtitle <text>       subheadline
+  --bg-top <color>        gradient top    (white gray slate black cyan blue
+  --bg-bottom <color>     gradient bottom  teal green lime gold orange coral
+  --title-color <color>   copy color override, or "auto"   red berry magenta
+  --title-size <s>        sm | md | lg | none              gray-light
+  --underlay <s>          black | white | none             gray-dark \u2026)
+  --shadow <s>            light | medium | strong | none
+
+notes:
+  slides are addressed by 1-based index. screenshot mode is auto-enabled.
+  capture shoots whatever the sim currently shows \u2014 navigate the app first
+  (sootsim do tap-id \u2026), then capture.
+
+examples:
+  sootsim screenshot slides set 1 --title "The ultimate MMA community." --bg-top cyan --bg-bottom black
+  sootsim screenshot slides capture 1
+  sootsim screenshot slides export --out ./exports
+`,ht={"--title":"title","--subtitle":"subtitle","--bg-top":"bgTop","--bg-bottom":"bgBottom","--title-color":"titleColor","--title-size":"titleSize","--underlay":"titleUnderlay","--shadow":"titleShadow","--out":"out"};function ft(e){let t=[],o={},i=!1;for(let r=0;r<e.length;r+=1){let s=e[r];if(s==="--json"){i=!0;continue}let n=s.indexOf("="),a=n>0?s.slice(0,n):s,c=ht[a];if(c){n>0?o[c]=s.slice(n+1):(o[c]=e[r+1]??"",r+=1);continue}t.push(s)}return{rest:t,values:o,json:i}}function gt(e){if(!e)return;let t=Number(e);return Number.isInteger(t)&&t>0?t:e}async function wt(e){if(!await Z(e,`(async () => {
+      if (window.SootSim?.bridges?.settings?.get?.()?.screenshotMode) return true
+      window.dispatchEvent(new CustomEvent('sootsim:shell-command', {
+        detail: { type: 'fire-action', id: 'toggle-screenshot-mode' },
+      }))
+      const deadline = Date.now() + 2000
+      while (Date.now() < deadline) {
+        if (window.SootSim?.bridges?.settings?.get?.()?.screenshotMode) return true
+        await new Promise((r) => setTimeout(r, 40))
+      }
+      return false
+    })()`,{acquireLock:!0}))throw new Error("could not enable screenshot mode \u2014 is this a browser sim with the screenshot plugin? (electron has no screenshot mode)")}function yt(e){console.log(`  ${e.projectName} \u2014 canvas ${e.canvas} (${e.exportSize.width}\xD7${e.exportSize.height}), device ${e.deviceModel}`);for(let t of e.slides){let o=[t.focused?"focused":t.active?"active":null,t.captured?`captured${t.captureMode==="3d"?" 3d":""}`:"no capture"].filter(Boolean).join(", "),i=t.title?`"${t.title}"`:"(no title)",r=[`bg ${t.bgTop}\u2192${t.bgBottom}`,t.titleColor?`color ${t.titleColor}`:null,t.titleSize?`size ${t.titleSize}`:null,t.titleUnderlay?`underlay ${t.titleUnderlay}`:null,t.titleShadow?`shadow ${t.titleShadow}`:null].filter(Boolean).join(", ");console.log(`  ${t.index}. ${i} \u2014 ${r} [${o}]`),t.subtitle&&console.log(`     ${t.subtitle}`)}}function St(e){let t=e.match(/^data:[^;]+;base64,(.+)$/);if(!t)throw new Error("export returned an unexpected payload");return Buffer.from(t[1],"base64")}async function Fe(e,t){if(e.includes("--help")||e.includes("-h")){console.log(mt);return}let{rest:o,values:i,json:r}=ft(e),s=A(o,{port:t.port,commandTimeoutMs:45e3}),n=s.positional[0]??"list",a=gt(s.positional[1]),c=R(s),l=u=>{r?console.log(JSON.stringify(u,null,2)):yt(u)};try{switch(await wt(c),n){case"list":{l(await M(c,"SootSim.bridges.screenshotControl.getState"));break}case"set":{if(a==null)throw new Error("usage: sootsim screenshot slides set <n> --title \u2026 (see --help)");let u={};for(let d of["title","subtitle","bgTop","bgBottom","titleColor","titleSize","titleUnderlay","titleShadow"])i[d]!=null&&(u[d]=i[d]);if(Object.keys(u).length===0)throw new Error("nothing to set \u2014 pass at least one field (see --help)");l(await $(c,"SootSim.bridges.screenshotControl.setSlide",a,u));break}case"add":{l(await $(c,"SootSim.bridges.screenshotControl.addSlide"));break}case"remove":{if(a==null)throw new Error("usage: sootsim screenshot slides remove <n>");l(await $(c,"SootSim.bridges.screenshotControl.removeSlide",a));break}case"focus":{if(a==null)throw new Error("usage: sootsim screenshot slides focus <n>");l(await $(c,"SootSim.bridges.screenshotControl.focusSlide",a));break}case"overview":{l(await $(c,"SootSim.bridges.screenshotControl.overview"));break}case"capture":{let u=await $(c,"SootSim.bridges.screenshotControl.capture",...a!=null?[a]:[]);l(u);break}case"export":{let u=i.out?dt(i.out)?i.out:pt(process.cwd(),i.out):Ne(process.cwd(),"screenshots"),d=await M(c,"SootSim.bridges.screenshotControl.getState"),p=a!=null?d.slides.filter(f=>f.index===a||f.id===a):d.slides.filter(f=>f.captured);if(p.length===0)throw new Error(a!=null?`no slide ${a}`:"no captured slides to export \u2014 capture first");let g=[];for(let f of p){let m=await M(c,"SootSim.bridges.screenshotControl.exportSlide",f.index),w=Ne(u,m.name);ct(ut(w),{recursive:!0}),lt(w,St(m.dataUrl)),g.push(w),console.log(`  saved: ${w} (${m.width}\xD7${m.height})`)}r&&console.log(JSON.stringify({written:g},null,2));break}default:throw new Error(`unknown subcommand "${n}" \u2014 see sootsim screenshot slides --help`)}}finally{c.close()}}var bt=new Set(["--sim","--port","-p","--output","-o","--out","--plan","--app","--device","--org","--repo","--api-origin","--branch","--platform","--slides","--shell-origin","--timeout"]),xt=new Set(["capture","slides","appstore"]);function Ee(e){for(let t=0;t<e.length;t++){let o=e[t];if(o.startsWith("-")){bt.has(o)&&t++;continue}return xt.has(o)?{name:o,index:t}:null}return null}function _(e,t){return[...e.slice(0,t),...e.slice(t+1)]}function Pt(e){let t=[];for(let o=0;o<e.length;o++){if(e[o]==="--sim"){o++;continue}t.push(e[o])}return t}async function Po(e,t){let o=Ee(e);if(!o||o.name==="capture"){await de(o?_(e,o.index):e,t);return}if(o.name==="slides"){await Fe(_(e,o.index),t);return}let i=_(e,o.index),r=Ee(i);if(r?.name==="capture")try{let{runScreenshotsCapture:s}=await import("./screenshots-capture-JCBFMJFS.js");return await s(Pt(_(i,r.index)))}catch(s){if(s instanceof Error&&"code"in s&&s.code==="ERR_MODULE_NOT_FOUND")return console.error("screenshot appstore capture is repo-only tooling \u2014 it needs the sootsim workspace (playwright is not shipped with the published CLI)."),1;throw s}return De(i,t)}export{Po as runScreenshotCommand};

package/dist-cli/chunks/{screenshots-capture-DIICN24R.js → screenshots-capture-JCBFMJFS.js}

@@ -1,5 +1,5 @@
-/*! sootsim v0.1.227 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{b as M}from"./chunk-KBSJA7HK.js";import{a as x}from"./chunk-4BLOZ3AF.js";import"./chunk-2BQOZATN.js";import"./chunk-NU755HCE.js";import"./chunk-F5HOYUD2.js";import{execSync as T}from"node:child_process";import{mkdirSync as D,mkdtempSync as O,rmSync as E,writeFileSync as j}from"node:fs";import{tmpdir as G}from"node:os";import{dirname as q,isAbsolute as B,join as U,resolve as L}from"node:path";import{chromium as W}from"playwright-core";var z=`
+/*! sootsim v0.1.229 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{b as M}from"./chunk-UCVK6JDW.js";import{a as x}from"./chunk-SPBHQVJ4.js";import"./chunk-WRPO6J3Z.js";import"./chunk-TWUPMUWQ.js";import"./chunk-U4OPCVAL.js";import{execSync as T}from"node:child_process";import{mkdirSync as D,mkdtempSync as O,rmSync as E,writeFileSync as j}from"node:fs";import{tmpdir as G}from"node:os";import{dirname as q,isAbsolute as B,join as U,resolve as L}from"node:path";import{chromium as W}from"playwright-core";var z=`
 sootsim screenshot appstore capture \u2014 headlessly capture + upload App Store slides
 
 usage:
@@ -32,7 +32,7 @@ examples:
   sootsim screenshot appstore capture needs a logged-in session.
   run \`sootsim login\` first (the captured slides upload to that account).
 
-`),process.exit(1)}function V(t){let e=t.replace(/^\[|\]$/g,"").toLowerCase();return e==="localhost"||e.endsWith(".localhost")||e==="::1"||/^127(?:\.\d{1,3}){3}$/.test(e)}function Y(t){let e=new URL(t);if(V(e.hostname)){let s=(Number(e.port)||3e3)-3e3;if(s>=0&&s<=1e3)return e.port=String(5173+s),e.origin}return e.hostname==="sootbean.com"||e.hostname.endsWith(".sootbean.com")?"https://sootsim.com":t}function K(){try{return Number(T("sysctl -n vm.loadavg").toString().trim().split(/\s+/)[1])||0}catch{return 0}}async function Q(t,e,n,s){let i=await fetch(`${t}/api/sootsim/screenshot-decks?org=${encodeURIComponent(n)}&repo=${encodeURIComponent(s)}`,{headers:{authorization:`Bearer ${e}`}});if(!i.ok)return[];let a=await i.json().catch(()=>null),d=[];for(let g of a?.decks??[])Array.isArray(g.config?.frames)&&d.push(...g.config.frames);return d}async function X(t,e,n,s){let i=await fetch(`${t}/api/sootsim/screenshot-capture?ref=${encodeURIComponent(s)}&org=${encodeURIComponent(n)}`,{headers:{authorization:`Bearer ${e}`}});return i.ok?`data:image/png;base64,${Buffer.from(await i.arrayBuffer()).toString("base64")}`:null}async function Z(t,e){let n=Date.now()+e;for(;Date.now()<n;){for(let s of t.frames())if(await s.evaluate(()=>!!globalThis.SootSim?.bridges?.screenshotControl).catch(()=>!1))return s;await t.waitForTimeout(250)}throw new Error("screenshot bridge never appeared \u2014 the build shell did not boot screenshot mode (check --branch/--platform has a ready build, and you are logged in)")}async function I(t){return t.evaluate(async()=>{let n=globalThis.SootSim?.bridges?.screenshotControl;if(!n)throw new Error("screenshotControl missing");return n.getState()})}async function _(t){await t.evaluate(async()=>{let e=globalThis.SootSim?.bridges?.settings,n=Date.now()+3e3;for(;Date.now()<n;){if(e?.get?.()?.screenshotMode)return;await new Promise(s=>setTimeout(s,50))}e&&!e.get().screenshotMode&&(e.set("screenshotMode",!0),e.get().showFrame||e.set("showFrame",!0))})}async function ee(t,e,n,s){await t.evaluate(async([i,a,d])=>{let g=globalThis.SootSim,h=g?.bridges?.screenshotControl;if(!h)throw new Error("screenshotControl missing");let w=b=>new Promise(u=>setTimeout(u,b));if(a){h.focusSlide(i);let b=Date.now()+3e4,u=g?.bridges?.threeMode;for(;Date.now()<b&&(u=g?.bridges?.threeMode,!(u?.setScreenImage&&u?.captureStage&&u?.getState?.()?.ready));)await w(150);await w(1e3);let c=a;u?.configure?.({colorway:c.colorway,background:c.background,...c.customGradient?{customGradient:c.customGradient}:{},setting:c.setting,focus:c.focus,environment:c.environmentActive?{pins:c.environmentPins??{},effects:c.environmentEffects??{}}:!1,pose:{phonePosition:c.phonePosition,phoneRotation:c.phoneRotation,cameraPosition:c.cameraPosition,target:c.target}}),await w(900),d&&u?.setScreenImage&&(u.setScreenImage(d),await w(1200))}await h.capture(i)},[e,n,s])}async function ue(t){if(t.includes("--help")||t.includes("-h"))return console.log(z),0;let e=H(t);if(!e.org||!e.repo)return process.stderr.write(`  --org and --repo are required (see --help)
+`),process.exit(1)}function V(t){let e=t.replace(/^\[|\]$/g,"").toLowerCase();return e==="localhost"||e.endsWith(".localhost")||e==="::1"||/^127(?:\.\d{1,3}){3}$/.test(e)}function Y(t){let e=new URL(t);if(V(e.hostname)){let s=(Number(e.port)||3e3)-3e3;if(s>=0&&s<=1e3)return e.port=String(5173+s),e.origin}return e.hostname==="contrast.dev"||e.hostname.endsWith(".contrast.dev")?"https://sootsim.com":t}function K(){try{return Number(T("sysctl -n vm.loadavg").toString().trim().split(/\s+/)[1])||0}catch{return 0}}async function Q(t,e,n,s){let i=await fetch(`${t}/api/sootsim/screenshot-decks?org=${encodeURIComponent(n)}&repo=${encodeURIComponent(s)}`,{headers:{authorization:`Bearer ${e}`}});if(!i.ok)return[];let a=await i.json().catch(()=>null),d=[];for(let g of a?.decks??[])Array.isArray(g.config?.frames)&&d.push(...g.config.frames);return d}async function X(t,e,n,s){let i=await fetch(`${t}/api/sootsim/screenshot-capture?ref=${encodeURIComponent(s)}&org=${encodeURIComponent(n)}`,{headers:{authorization:`Bearer ${e}`}});return i.ok?`data:image/png;base64,${Buffer.from(await i.arrayBuffer()).toString("base64")}`:null}async function Z(t,e){let n=Date.now()+e;for(;Date.now()<n;){for(let s of t.frames())if(await s.evaluate(()=>!!globalThis.SootSim?.bridges?.screenshotControl).catch(()=>!1))return s;await t.waitForTimeout(250)}throw new Error("screenshot bridge never appeared \u2014 the build shell did not boot screenshot mode (check --branch/--platform has a ready build, and you are logged in)")}async function I(t){return t.evaluate(async()=>{let n=globalThis.SootSim?.bridges?.screenshotControl;if(!n)throw new Error("screenshotControl missing");return n.getState()})}async function _(t){await t.evaluate(async()=>{let e=globalThis.SootSim?.bridges?.settings,n=Date.now()+3e3;for(;Date.now()<n;){if(e?.get?.()?.screenshotMode)return;await new Promise(s=>setTimeout(s,50))}e&&!e.get().screenshotMode&&(e.set("screenshotMode",!0),e.get().showFrame||e.set("showFrame",!0))})}async function ee(t,e,n,s){await t.evaluate(async([i,a,d])=>{let g=globalThis.SootSim,h=g?.bridges?.screenshotControl;if(!h)throw new Error("screenshotControl missing");let w=b=>new Promise(u=>setTimeout(u,b));if(a){h.focusSlide(i);let b=Date.now()+3e4,u=g?.bridges?.threeMode;for(;Date.now()<b&&(u=g?.bridges?.threeMode,!(u?.setScreenImage&&u?.captureStage&&u?.getState?.()?.ready));)await w(150);await w(1e3);let c=a;u?.configure?.({colorway:c.colorway,background:c.background,...c.customGradient?{customGradient:c.customGradient}:{},setting:c.setting,focus:c.focus,environment:c.environmentActive?{pins:c.environmentPins??{},effects:c.environmentEffects??{}}:!1,pose:{phonePosition:c.phonePosition,phoneRotation:c.phoneRotation,cameraPosition:c.cameraPosition,target:c.target}}),await w(900),d&&u?.setScreenImage&&(u.setScreenImage(d),await w(1200))}await h.capture(i)},[e,n,s])}async function ue(t){if(t.includes("--help")||t.includes("-h"))return console.log(z),0;let e=H(t);if(!e.org||!e.repo)return process.stderr.write(`  --org and --repo are required (see --help)
 `),1;let{token:n,origin:s}=J(),i=(e.apiOrigin??s).replace(/\/$/,""),a=(e.shellOrigin??Y(i)).replace(/\/$/,""),d=await Q(i,n,e.org,e.repo);if(!e.dryRun&&!e.force&&d.length>0)return process.stderr.write(`  refusing to overwrite the existing ${e.org}/${e.repo} deck (${d.length} slide(s)). re-run with --force to replace it, or --dry-run to preview.
 `),1;let g=K(),h=Number(T("sysctl -n hw.ncpu").toString().trim())||8;if(g>h)return process.stderr.write(`  load average ${g.toFixed(1)} exceeds ${h} cores \u2014 tear down other work first.
 `),1;let w=`${a}/build/${encodeURIComponent(e.org)}/${encodeURIComponent(e.repo)}/${encodeURIComponent(e.branch)}?platform=${encodeURIComponent(e.platform)}&ssMode=1`,b=O(U(G(),"sootsim-capture-")),{browser:u,reapNow:c}=await M(r=>W.launchPersistentContext(b,r),{headless:!0,viewport:{width:393,height:852},deviceScaleFactor:3,args:["--enable-unsafe-webgpu","--enable-features=Vulkan,WebGPU","--hide-scrollbars"]});await u.addInitScript(r=>{try{localStorage.setItem("sootsim.session.token",r)}catch{}},n);let y=[],p=u.pages()[0]??await u.newPage();e.dryRun?await p.route(/\/api\/sootsim\/screenshot-(decks|capture)/,r=>r.request().method()==="PUT"?r.abort():r.continue()):p.on("response",r=>{let m=r.url();r.request().method()==="PUT"&&(m.includes("/api/sootsim/screenshot-decks")?y.push({kind:"deck",status:r.status()}):m.includes("/api/sootsim/screenshot-capture")&&y.push({kind:"capture",status:r.status()}))});let R=[];p.on("pageerror",r=>R.push(r.message));let N=p.waitForResponse(r=>r.url().includes("/api/sootsim/screenshot-decks")&&r.request().method()==="GET",{timeout:e.timeoutMs}).catch(()=>null);try{await p.goto(w,{waitUntil:"domcontentloaded",timeout:e.timeoutMs});let r=await Z(p,e.timeoutMs);await _(r),await N,await p.waitForTimeout(800);let m=await I(r);if(m.slides.length===0)return process.stderr.write(`  the deck has no slides to capture \u2014 add slides in the composer first.