@promptctl/cc-candybar 1.56.1 → 1.56.2

package/dist/index.mjs

@@ -149,7 +149,7 @@ Config tooling:
   Replace:  layout: [["seg1", "seg2"], ["seg3"]]
   With:     root: { v: [{ h: ["seg1", "seg2"] }, "seg3"] }
   Single-row example:  root: { h: ["seg1", "seg2"] }`,line:J(e.source,[`layout`])}),t.root!==void 0&&(n.root=pc(e,`root`,t.root)),t.actions!==void 0&&(n.actions=Tg(e,t.actions)),t.looks!==void 0&&(n.looks=p_(e,t.looks)),t.presets!==void 0&&(n.presets=h_(e,t.presets)),t.editGlobals!==void 0&&(n.editGlobals=wo(e,`editGlobals`,t.editGlobals)),t.helpers!==void 0&&(n.helpers=g_(e,t.helpers)),Sc(e,n),km(e,n),Rm(e,n),Xs(e,n,hh,`the global settings menu`),n}const sv=new Set([`globals`,`variables`,`segments`,`layout`,`root`,`actions`,`looks`,`presets`,`editGlobals`,`helpers`]);function cv(e){let t=fv(e.termCols),n=fv(e.termRows),r=pv(e.ssh),i=uv(e.tmux),a=lv(e.configEnv);return{...t!==void 0&&{termCols:t},...n!==void 0&&{termRows:n},...r!==void 0&&{ssh:r},...i!==void 0&&{tmux:i},...a!==void 0&&{configEnv:a}}}function lv(e){return typeof e==`string`&&e!==``?J_(e):void 0}function uv(e){if(e===null)return null;if(typeof e!=`object`)return;let{socket:t,pane:n,truecolor:r}=e;if(!(typeof t!=`string`||t===``)&&!(typeof n!=`string`||n===``)&&!(r!==null&&(typeof r!=`string`||r===``)))return{socket:t,pane:n,truecolor:r}}const dv=1e4;function fv(e){if(typeof e!=`number`||!Number.isFinite(e))return;let t=Math.floor(e);if(!(t<=0))return t>dv?dv:t}function pv(e){return typeof e==`boolean`?e:void 0}var mv=class extends Error{constructor(e){super(e),this.name=`ProtocolError`}};function hv(e){let t=Buffer.from(JSON.stringify(e),`utf8`),n=Buffer.alloc(4);return n.writeUInt32BE(t.length,0),Buffer.concat([n,t])}function gv(e,t){let n=Buffer.alloc(0);return function(r){for(n=Buffer.concat([n,r]);n.length>=4;){let r=n.readUInt32BE(0);if(r>16777216){t(new mv(`frame too large: ${r}`));return}if(n.length<4+r)return;let i=n.subarray(4,4+r);n=n.subarray(4+r);try{e(JSON.parse(i.toString(`utf8`)))}catch(e){let n=new mv(e instanceof Error?e.message:String(e));e instanceof Error&&(n.cause=e),t(n);return}}}}function _v(e,t,n){return new Promise((r,i)=>{let a=!1,o=t=>{if(!a){a=!0,clearTimeout(s),e.removeAllListeners();try{t()}catch{}}},s=setTimeout(()=>{o(()=>{e.destroy(),i(Error(`TIMEOUT`))})},n),c=gv(e=>o(()=>r(e)),e=>o(()=>i(e)));e.on(`data`,c),e.on(`error`,e=>o(()=>i(e))),e.on(`close`,()=>o(()=>i(Error(`socket closed before response`)))),e.write(hv(t))})}async function vv(e,t,n){let r=null;try{r=await Cv(k(),t.connectMs);let i=await _v(r,{v:3,...e},t.budgetMs);return xv(e.kind,i,n)}catch(e){return Sv(e)}finally{r&&r.destroy()}}function yv(e,t){return typeof e==`string`?e:t}function bv(e){return typeof e==`number`&&Number.isInteger(e)&&e>=0?e:0}function xv(e,t,n){let r=t;if(r.ok===!0){let r=n(t);return r===void 0?{kind:`permanent`,cause:`malformed_response`,message:`ok response without payload for "${e}" request`}:{kind:`ok`,value:r}}let i=yv(r.error,`(no error message)`);switch(r.code){case`VERSION_MISMATCH`:return{kind:`permanent`,cause:`version_mismatch`,clientV:3,daemonV:bv(r.daemonV)};case`TIMEOUT`:return{kind:`transient`,cause:`timeout`,message:i};case`BAD_REQUEST`:return{kind:`permanent`,cause:`bad_request`,message:i};case`RENDER_FAILED`:return{kind:`permanent`,cause:`render_failed`,message:i};default:return{kind:`permanent`,cause:`malformed_response`,message:`unknown error code: ${String(r.code)}`}}}function Sv(e){if(e instanceof mv||e instanceof SyntaxError)return{kind:`permanent`,cause:`malformed_response`,message:e instanceof Error?e.message:String(e)};let t=e instanceof Error?e.message:String(e);return t===`CONNECT_TIMEOUT`||t===`TIMEOUT`?{kind:`transient`,cause:`timeout`,message:t}:t.includes(`ECONNREFUSED`)||t.includes(`ENOENT`)||t.includes(`ENOTSOCK`)?{kind:`transient`,cause:`unreachable`,message:t}:{kind:`transient`,cause:`io_error`,message:t}}function Cv(e,t){return new Promise((n,r)=>{let i=g.createConnection({path:e}),a=setTimeout(()=>{i.destroy(),r(Error(`CONNECT_TIMEOUT`))},t);i.once(`connect`,()=>{clearTimeout(a),n(i)}),i.once(`error`,e=>{clearTimeout(a),r(e)})})}function wv(e){if(e.kind===`transient`)return`daemon unavailable (${e.cause}: ${e.message})\nHint: daemon may not be running. Run \`cc-candybar\` once to spawn it.`;switch(e.cause){case`version_mismatch`:{let t=e.daemonV===0?`unknown`:`v${e.daemonV}`;return`daemon protocol mismatch (client v${e.clientV} ≠ daemon ${t})`}case`bad_request`:case`render_failed`:case`malformed_response`:return`daemon error (${e.cause}): ${e.message}`}}const Tv={connectMs:50,budgetMs:150},Ev={connectMs:50,budgetMs:200};function Dv(e){let t=e.output;return typeof t==`string`?t:void 0}function Ov(e,t,n,r){return vv({kind:`render`,hookData:e,args:t,cwd:n,...r},Tv,Dv)}function kv(e,t){return vv({kind:`click`,verb:e,value:t},Ev,Dv)}let Av=null;function jv(e){if(Av!==null)return Av;r.mkdirSync(c.dirname(e),{recursive:!0});try{Av=r.statSync(e).size}catch{Av=0}return Av}function Mv(e){for(let t=2;t>=1;t--){let n=`${e}.${t}`,i=`${e}.${t+1}`;try{r.renameSync(n,i)}catch{}}try{r.renameSync(e,`${e}.1`)}catch{}Av=0}function Z(e,t){let n=`${new Date().toISOString()} [${e}] ${t}\n`;try{let e=He(),t=jv(e);r.appendFileSync(e,n),Av=t+Buffer.byteLength(n,`utf8`),Av>=5242880&&Mv(e)}catch(e){Av=null;try{process.stderr.write(`${n}cc-candybar: daemon.log unwritable: ${e.message}\n`)}catch{}}}const Nv=`CC_CANDYBAR_RSS_LIMIT_MB`;function Pv(e){let t=e[Nv];if(t===void 0)return 512;let n=/^\d+$/.test(t)?Number(t):NaN;if(!Number.isSafeInteger(n)||n<=0)throw Error(`${Nv} must be a positive integer (MB), got ${JSON.stringify(t)}`);return n}function Fv(e){return Pv(e)*2}const Iv=1024*1024;function Lv(e){return Pv(e)*Iv}function Rv(e){let t=e.rssLimitBytes??512*Iv,n=e.snapshotsKeep??3,r=!1;function i(){if(r)return!0;let i=e.rssBytes();if(i<=t)return!1;r=!0,e.log(`warn`,`RSS ${i} > limit ${t}; writing heap snapshot then shutting down`);try{let t=new Date(e.now()).toISOString().replace(/[:.]/g,`-`),r=c.join(e.snapshotDir,`heap-${t}-${e.pid}.heapsnapshot`),i=e.writeHeapSnapshot(r);e.log(`info`,`heap snapshot written: ${i}`),zv(e.listSnapshots(),n,e.removeFile)}catch(t){e.log(`warn`,`heap snapshot failed: ${t.message}`)}return e.shutdown(0),!0}function a(){let n=e.rssBytes();return n>t*.75?`rss ${n} approaching limit ${t}`:null}function o(e=6e4){let t=setInterval(()=>{i()},e);return t.unref(),{disarm:()=>clearInterval(t)}}return{checkRss:i,describeNextRestart:a,arm:o}}function zv(e,t,n){let r=[...e].sort((e,t)=>{let n=e.slice(e.lastIndexOf(`/`)+1);return t.slice(t.lastIndexOf(`/`)+1).localeCompare(n)});for(let e of r.slice(t))try{n(e)}catch{}}function Bv(e,t,n={}){let i=Ae();return{now:()=>Date.now(),pid:process.pid,snapshotDir:i,log:Z,rssBytes:()=>process.memoryUsage().rss,writeHeapSnapshot:e=>_.writeHeapSnapshot(e),listSnapshots:()=>{try{return r.readdirSync(i).filter(e=>e.startsWith(`heap-`)&&e.endsWith(`.heapsnapshot`)).map(e=>c.join(i,e))}catch{return[]}},removeFile:e=>r.unlinkSync(e),shutdown:t,startedAtMs:e,...n}}function Vv(e={}){if(ry()!==null)return;let n=e.spawn??iy,r=ey();if(r.kind===`contended`){let e=Uv();e!==null&&e>2e3&&(t.stderr.write(`cc-candybar: spawn-lock held ${e}ms (likely crashed holder) — spawning unlocked\n`),Hv(n));return}if(r.kind===`error`){t.stderr.write(`cc-candybar: spawn-lock unavailable (${r.reason}) — spawning unlocked\n`),Hv(n);return}try{Hv(n)}finally{ny()}}function Hv(e){Xv()&&Wv(e)}function Uv(){try{let e=r.statSync(Re());return Date.now()-e.mtimeMs}catch{return null}}function Wv(e){try{e()||t.stderr.write(`cc-candybar: daemon spawn returned false (unable to resolve script path?)
-`)}catch(e){t.stderr.write(`cc-candybar: daemon spawn failed: ${e.message}\n`)}}function Gv(e,t){return e===null?{kind:`allow`}:e<-1e4?{kind:`allow-future-garbage`,futureMs:-e}:e<t?{kind:`deny`}:{kind:`allow`}}function Kv(e){return Math.min(3e3*2**Math.min(Math.max(e,0),5),6e4)}function qv(e){try{let t=r.readFileSync(e,`utf8`).trim(),n=Number(t);return!Number.isInteger(n)||n<0?0:Math.min(n,5)}catch{return 0}}function Jv(e,n){try{r.mkdirSync(c.dirname(e),{recursive:!0}),r.writeFileSync(e,String(n),{mode:384})}catch(e){t.stderr.write(`cc-candybar: could not record spawn.backoff: ${e.message}\n`)}}function Yv(){try{r.unlinkSync(Be())}catch(e){e.code!==`ENOENT`&&t.stderr.write(`cc-candybar: could not reset spawn.backoff: ${e.message}\n`)}}function Xv(){let e=ze(),n=Be(),r=qv(n),i=Gv(Zv(e),Kv(r));return i.kind===`deny`?!1:(i.kind===`allow-future-garbage`&&t.stderr.write(`cc-candybar: spawn.cooldown mtime is ${i.futureMs}ms in the future — ignoring and spawning\n`),Qv(e),Jv(n,Math.min(r+1,5)),!0)}function Zv(e){try{return Date.now()-r.statSync(e).mtimeMs}catch{return null}}function Qv(e){try{r.mkdirSync(c.dirname(e),{recursive:!0}),r.writeFileSync(e,`${t.pid} ${Date.now()}\n`,{mode:384})}catch(e){t.stderr.write(`cc-candybar: could not record spawn.cooldown: ${e.message}\n`)}}let $v=null;function ey(){let e=Re();for(let n=0;n<2;n++){try{let n=r.openSync(e,`wx`,384);try{r.writeSync(n,JSON.stringify({pid:t.pid,ts:Date.now()}))}catch{}return $v={fd:n,path:e},{kind:`held`}}catch(t){let n=t.code;if(n!==`EEXIST`)return{kind:`error`,reason:`openSync(${e}): ${n??t.message}`}}if(!ty(e))return{kind:`contended`};try{r.unlinkSync(e)}catch(e){if(e.code!==`ENOENT`)return{kind:`error`,reason:`unlink stale spawn.lock: ${e.message}`}}}return{kind:`contended`}}function ty(e){try{let t=r.statSync(e);return Date.now()-t.mtimeMs>1e4}catch{return!0}}function ny(){if(!$v)return;let{fd:e,path:t}=$v;$v=null;try{r.closeSync(e)}catch{}try{r.unlinkSync(t)}catch{}}function ry(){try{return r.mkdirSync(Ae(),{recursive:!0}),null}catch(e){return`mkdir ${Ae()}: ${e.message}`}}function iy(){let e=t.execPath,n=t.argv[1];return n?we({bin:e,args:[`--max-old-space-size=${Fv(t.env)}`,n,`daemon`],category:`daemon-spawn`}).ok:!1}const ay=`cc-candybar`,oy=`dispatch`,sy=`set-state`,cy=`step-state`,ly=`copy`,uy=`open-vscode`,dy=`toolbar-toggle`,fy=`show-config-error`,py=`show-config-warning`,my=`set-config`,hy=`step-config`,gy=`reset-config`,_y=`apply-layout-op`,vy=`undo`,yy=`redo`,by=`apply-update`,xy=`doctor-run`,Sy=`doctor-fix`;function Cy(e){return e.map(encodeURIComponent).join(`/`)}function wy(e){return e.length===0?[]:e.split(`/`).map(decodeURIComponent)}function Ty(e){return`${ay}://${oy}/${e.map(e=>`e=${encodeURIComponent(`${e.verb}/${Cy(e.args)}`)}`).join(`&`)}`}function Ey(e){return new y(e).getAll(`e`).map(Dy)}function Dy(e){let t=e.indexOf(`/`);return t===-1?{verb:e,value:``}:{verb:e.slice(0,t),value:e.slice(t+1)}}const Oy=`1.56.1`;function ky(){return c.join(f.homedir(),`.claude`,`settings.json`)}function Q(e){return{kind:`ok`,value:e}}const Ay={kind:`absent`};function jy(e){return{kind:`failed`,reason:e}}function My(e,t){return e?.kind===`ok`?e.value:t}const Ny=/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;function Py(e){let t=Ny.exec(e);return t?{kind:`ok`,value:[Number(t[1]),Number(t[2]),Number(t[3])]}:{kind:`failed`,reason:`"${e}" is not a release version (expected MAJOR.MINOR.PATCH)`}}function Fy(e){return e.join(`.`)}function Iy([e,t,n],[r,i,a]){return e-r||t-i||n-a}const Ly=`@promptctl/cc-candybar`;async function Ry(e,t,n){let r=`${n}/-/package/${encodeURIComponent(e)}/dist-tags`;try{let e=await t(r,{signal:AbortSignal.timeout(5e3)});if(!e.ok)return jy(`registry responded ${e.status} for ${r}`);let n=await e.json();return typeof n.latest==`string`?Py(n.latest):Ay}catch(e){return jy(e instanceof Error?e.message:String(e))}}function zy(e,t){let n=Py(e);if(n.kind===`failed`)return{kind:`unchecked`,installed:e,reason:n.reason};switch(t.kind){case`failed`:return{kind:`unchecked`,installed:e,reason:t.reason};case`absent`:return{kind:`unchecked`,installed:e,reason:"the registry lists no `latest` dist-tag"};case`ok`:{let e=Iy(n.value,t.value);return e<0?{kind:`stale`,installed:n.value,latest:t.value}:e>0?{kind:`ahead`,installed:n.value,latest:t.value}:{kind:`current`,installed:n.value}}}}function By(e,t){switch(t.kind){case`current`:return{stream:`stdout`,text:`✓ cc-candybar ${Fy(t.installed)} is the latest release.\n`};case`ahead`:return{stream:`stdout`,text:`cc-candybar ${Fy(t.installed)} is newer than the registry's latest release (${Fy(t.latest)}): an unpublished build.\n`};case`stale`:{let n=Fy(t.latest);return{stream:`stderr`,text:`⚠ cc-candybar ${Fy(t.installed)} was staged, but the latest release is ${n}.\n  pnpm's release-age gate (minimumReleaseAge) and its dlx cache can both\n  resolve \`@latest\` to an older release without saying so.\n  To install ${n} now, name it explicitly:\n    pnpm dlx ${e}@${n} install\n`}}case`unchecked`:return{stream:`stderr`,text:`⚠ Could not check for a cc-candybar release newer than ${t.installed} (${t.reason}); the registry check was skipped.\n`}}}const Vy=`CCCandybarURLHandler`,Hy=[],Uy={"darwin-arm64":`@promptctl/cc-candybar-darwin-arm64`,"darwin-x64":`@promptctl/cc-candybar-darwin-x64`,"linux-x64":`@promptctl/cc-candybar-linux-x64`,"linux-arm64":`@promptctl/cc-candybar-linux-arm64`};function Wy(e){return/^[A-Za-z0-9_./=,:-]+$/.test(e)?e:`'${e.replace(/'/g,`'\\''`)}'`}function Gy(e,t){return[e,...t].map(Wy).join(` `)}function Ky(){return c.join(f.homedir(),`Applications`,`${Vy}.app`)}function qy(){if(process.platform!==`darwin`)throw Error(`URL handler installation requires macOS (found platform: ${process.platform}).`)}function Jy(){if(process.platform===`darwin`)return c.join(f.homedir(),`Library`,`Application Support`,`CCCandybar`);let e=process.env.XDG_DATA_HOME??c.join(f.homedir(),`.local`,`share`);return c.join(e,`cc-candybar`)}function Yy(){return c.join(Jy(),`bin`,`cc-candybar`)}function Xy(){return c.join(Jy(),`dist`,`index.mjs`)}function Zy(e,t){return[`on open location L`,`\tdo shell script "'${e.replace(/"/g,`\\"`)}' '${t.replace(/"/g,`\\"`)}' url-handle " & quoted form of L`,`end open location`].join(`
+`)}catch(e){t.stderr.write(`cc-candybar: daemon spawn failed: ${e.message}\n`)}}function Gv(e,t){return e===null?{kind:`allow`}:e<-1e4?{kind:`allow-future-garbage`,futureMs:-e}:e<t?{kind:`deny`}:{kind:`allow`}}function Kv(e){return Math.min(3e3*2**Math.min(Math.max(e,0),5),6e4)}function qv(e){try{let t=r.readFileSync(e,`utf8`).trim(),n=Number(t);return!Number.isInteger(n)||n<0?0:Math.min(n,5)}catch{return 0}}function Jv(e,n){try{r.mkdirSync(c.dirname(e),{recursive:!0}),r.writeFileSync(e,String(n),{mode:384})}catch(e){t.stderr.write(`cc-candybar: could not record spawn.backoff: ${e.message}\n`)}}function Yv(){try{r.unlinkSync(Be())}catch(e){e.code!==`ENOENT`&&t.stderr.write(`cc-candybar: could not reset spawn.backoff: ${e.message}\n`)}}function Xv(){let e=ze(),n=Be(),r=qv(n),i=Gv(Zv(e),Kv(r));return i.kind===`deny`?!1:(i.kind===`allow-future-garbage`&&t.stderr.write(`cc-candybar: spawn.cooldown mtime is ${i.futureMs}ms in the future — ignoring and spawning\n`),Qv(e),Jv(n,Math.min(r+1,5)),!0)}function Zv(e){try{return Date.now()-r.statSync(e).mtimeMs}catch{return null}}function Qv(e){try{r.mkdirSync(c.dirname(e),{recursive:!0}),r.writeFileSync(e,`${t.pid} ${Date.now()}\n`,{mode:384})}catch(e){t.stderr.write(`cc-candybar: could not record spawn.cooldown: ${e.message}\n`)}}let $v=null;function ey(){let e=Re();for(let n=0;n<2;n++){try{let n=r.openSync(e,`wx`,384);try{r.writeSync(n,JSON.stringify({pid:t.pid,ts:Date.now()}))}catch{}return $v={fd:n,path:e},{kind:`held`}}catch(t){let n=t.code;if(n!==`EEXIST`)return{kind:`error`,reason:`openSync(${e}): ${n??t.message}`}}if(!ty(e))return{kind:`contended`};try{r.unlinkSync(e)}catch(e){if(e.code!==`ENOENT`)return{kind:`error`,reason:`unlink stale spawn.lock: ${e.message}`}}}return{kind:`contended`}}function ty(e){try{let t=r.statSync(e);return Date.now()-t.mtimeMs>1e4}catch{return!0}}function ny(){if(!$v)return;let{fd:e,path:t}=$v;$v=null;try{r.closeSync(e)}catch{}try{r.unlinkSync(t)}catch{}}function ry(){try{return r.mkdirSync(Ae(),{recursive:!0}),null}catch(e){return`mkdir ${Ae()}: ${e.message}`}}function iy(){let e=t.execPath,n=t.argv[1];return n?we({bin:e,args:[`--max-old-space-size=${Fv(t.env)}`,n,`daemon`],category:`daemon-spawn`}).ok:!1}const ay=`cc-candybar`,oy=`dispatch`,sy=`set-state`,cy=`step-state`,ly=`copy`,uy=`open-vscode`,dy=`toolbar-toggle`,fy=`show-config-error`,py=`show-config-warning`,my=`set-config`,hy=`step-config`,gy=`reset-config`,_y=`apply-layout-op`,vy=`undo`,yy=`redo`,by=`apply-update`,xy=`doctor-run`,Sy=`doctor-fix`;function Cy(e){return e.map(encodeURIComponent).join(`/`)}function wy(e){return e.length===0?[]:e.split(`/`).map(decodeURIComponent)}function Ty(e){return`${ay}://${oy}/${e.map(e=>`e=${encodeURIComponent(`${e.verb}/${Cy(e.args)}`)}`).join(`&`)}`}function Ey(e){return new y(e).getAll(`e`).map(Dy)}function Dy(e){let t=e.indexOf(`/`);return t===-1?{verb:e,value:``}:{verb:e.slice(0,t),value:e.slice(t+1)}}const Oy=`1.56.2`;function ky(){return c.join(f.homedir(),`.claude`,`settings.json`)}function Q(e){return{kind:`ok`,value:e}}const Ay={kind:`absent`};function jy(e){return{kind:`failed`,reason:e}}function My(e,t){return e?.kind===`ok`?e.value:t}const Ny=/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;function Py(e){let t=Ny.exec(e);return t?{kind:`ok`,value:[Number(t[1]),Number(t[2]),Number(t[3])]}:{kind:`failed`,reason:`"${e}" is not a release version (expected MAJOR.MINOR.PATCH)`}}function Fy(e){return e.join(`.`)}function Iy([e,t,n],[r,i,a]){return e-r||t-i||n-a}const Ly=`@promptctl/cc-candybar`;async function Ry(e,t,n){let r=`${n}/-/package/${encodeURIComponent(e)}/dist-tags`;try{let e=await t(r,{signal:AbortSignal.timeout(5e3)});if(!e.ok)return jy(`registry responded ${e.status} for ${r}`);let n=await e.json();return typeof n.latest==`string`?Py(n.latest):Ay}catch(e){return jy(e instanceof Error?e.message:String(e))}}function zy(e,t){let n=Py(e);if(n.kind===`failed`)return{kind:`unchecked`,installed:e,reason:n.reason};switch(t.kind){case`failed`:return{kind:`unchecked`,installed:e,reason:t.reason};case`absent`:return{kind:`unchecked`,installed:e,reason:"the registry lists no `latest` dist-tag"};case`ok`:{let e=Iy(n.value,t.value);return e<0?{kind:`stale`,installed:n.value,latest:t.value}:e>0?{kind:`ahead`,installed:n.value,latest:t.value}:{kind:`current`,installed:n.value}}}}function By(e,t){switch(t.kind){case`current`:return{stream:`stdout`,text:`✓ cc-candybar ${Fy(t.installed)} is the latest release.\n`};case`ahead`:return{stream:`stdout`,text:`cc-candybar ${Fy(t.installed)} is newer than the registry's latest release (${Fy(t.latest)}): an unpublished build.\n`};case`stale`:{let n=Fy(t.latest);return{stream:`stderr`,text:`⚠ cc-candybar ${Fy(t.installed)} was staged, but the latest release is ${n}.\n  pnpm's release-age gate (minimumReleaseAge) and its dlx cache can both\n  resolve \`@latest\` to an older release without saying so.\n  To install ${n} now, name it explicitly:\n    pnpm dlx ${e}@${n} install\n`}}case`unchecked`:return{stream:`stderr`,text:`⚠ Could not check for a cc-candybar release newer than ${t.installed} (${t.reason}); the registry check was skipped.\n`}}}const Vy=`CCCandybarURLHandler`,Hy=[],Uy={"darwin-arm64":`@promptctl/cc-candybar-darwin-arm64`,"darwin-x64":`@promptctl/cc-candybar-darwin-x64`,"linux-x64":`@promptctl/cc-candybar-linux-x64`,"linux-arm64":`@promptctl/cc-candybar-linux-arm64`};function Wy(e){return/^[A-Za-z0-9_./=,:-]+$/.test(e)?e:`'${e.replace(/'/g,`'\\''`)}'`}function Gy(e,t){return[e,...t].map(Wy).join(` `)}function Ky(){return c.join(f.homedir(),`Applications`,`${Vy}.app`)}function qy(){if(process.platform!==`darwin`)throw Error(`URL handler installation requires macOS (found platform: ${process.platform}).`)}function Jy(){if(process.platform===`darwin`)return c.join(f.homedir(),`Library`,`Application Support`,`CCCandybar`);let e=process.env.XDG_DATA_HOME??c.join(f.homedir(),`.local`,`share`);return c.join(e,`cc-candybar`)}function Yy(){return c.join(Jy(),`bin`,`cc-candybar`)}function Xy(){return c.join(Jy(),`dist`,`index.mjs`)}function Zy(e,t){return[`on open location L`,`\tdo shell script "'${e.replace(/"/g,`\\"`)}' '${t.replace(/"/g,`\\"`)}' url-handle " & quoted form of L`,`end open location`].join(`
 `)}function Qy(e){if(!e)throw Error(`install: process.argv[1] not set`);return e.endsWith(`.mjs`)||e.endsWith(`.js`)?e:c.resolve(c.dirname(e),`..`,`dist`,`index.mjs`)}function $y(t){let n=Uy[`${process.platform}-${process.arch}`];if(n){let r=e(t);try{return{kind:`native`,sourcePath:r.resolve(`${n}/bin/cc-candybar`)}}catch{}}return{kind:`node-shim`,sourcePath:c.resolve(c.dirname(t),`..`,`bin`,`cc-candybar`)}}function eb(e,t){c.resolve(e)!==c.resolve(t)&&r.copyFileSync(e,t)}function tb(e){let t=r.openSync(e,`r`);try{let n=Buffer.alloc(2),i=r.readSync(t,n,0,2,0);if(i<2)throw Error(`install: staged render entry at ${e} is truncated (${i} byte(s)). Re-run: pnpm dlx ${Ly}@latest install`);return n.toString(`latin1`)===`#!`?`node-shim`:`native`}finally{r.closeSync(t)}}function nb(){let e=Qy(process.argv[1]);if(!r.existsSync(e))throw Error(`install: bundled dist not found at ${e}. Reinstall the package.`);let t=$y(e);if(!r.existsSync(t.sourcePath))throw Error(`install: render entry not found at ${t.sourcePath}. Reinstall the package.`);r.mkdirSync(c.dirname(Xy()),{recursive:!0}),r.mkdirSync(c.dirname(Yy()),{recursive:!0}),eb(e,Xy()),eb(t.sourcePath,Yy()),r.chmodSync(Yy(),493),r.rmSync(c.join(Jy(),`url-handler.mjs`),{force:!0});let n=tb(Yy());return process.stdout.write(`Staged cc-candybar v${Oy} runtime at ${Jy()}\n`+(n===`native`?`  render entry: native binary (${process.platform}-${process.arch})\n`:`  render entry: node shim (no native binary for ${process.platform}-${process.arch}; renders are correct but pay node startup)\n`)),{binPath:Yy(),distPath:Xy(),entryKind:n}}function rb(){return[{key:`CFBundleIdentifier`,xml:`<string>com.cccandybar.url-handler</string>`},{key:`CFBundleURLTypes`,xml:[`<array>`,`  <dict>`,`    <key>CFBundleURLName</key>`,`    <string>Claude Powerline Click Action</string>`,`    <key>CFBundleURLSchemes</key>`,`    <array>`,`      <string>${ay}</string>`,`    </array>`,`  </dict>`,`</array>`].join(`
 `)}]}function ib(e){let t=Ky();r.mkdirSync(c.dirname(t),{recursive:!0}),r.existsSync(t)&&r.rmSync(t,{recursive:!0,force:!0}),process.stdout.write(`Building ${t}\n`);let n=Ce({bin:`/usr/bin/osacompile`,args:[`-o`,t,`-e`,Zy(process.execPath,e)],category:`install.osacompile`});if(!n.ok)throw process.stderr.write(n.stderr),Error(`osacompile failed (${n.reason})`);let i=c.join(t,`Contents`,`Info.plist`);for(let{key:e}of rb())Ce({bin:`/usr/bin/plutil`,args:[`-remove`,e,i],category:`install.plutil`});for(let{key:e,xml:t}of rb()){let n=Ce({bin:`/usr/bin/plutil`,args:[`-insert`,e,`-xml`,t,i],category:`install.plutil`});if(!n.ok)throw process.stderr.write(n.stderr),Error(`plutil -insert ${e} failed (${n.reason})`)}process.stdout.write(`Registering ${ay}:// with Launch Services\n`);let a=Ce({bin:`/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister`,args:[`-f`,t],category:`install.lsregister`});if(!a.ok)throw process.stderr.write(a.stderr),Error(`lsregister failed (${a.reason})`);process.stdout.write(`✓ ${Vy}.app installed and registered.\n`),process.stdout.write(`  Test: open '${ay}://hello-world' && pbpaste\n`)}function ab(){qy(),ib(nb().distPath)}function ob(e,t=ay){let n=`${t}://`;if(!e.startsWith(n))throw Error(`expected ${n} scheme, got: ${e}`);let r=e.slice(n.length),i=r.indexOf(`/`);return i===-1?{verb:ly,value:r}:{verb:decodeURIComponent(r.slice(0,i)),value:r.slice(i+1)}}async function sb(e){e||(process.stderr.write(`url-handle: missing URL argument.
 `),process.exit(1));let t;try{t=ob(e)}catch(e){process.stderr.write(`url-handle: ${e instanceof Error?e.message:String(e)}\n`),process.exit(1)}let n=await kv(t.verb,t.value);n.kind===`ok`&&process.exit(0),n.kind===`transient`&&(Vv(),process.stderr.write(`url-handle: daemon unavailable (${n.cause}: ${n.message})\n`),process.exit(1)),process.stderr.write(cb(n)+`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptctl/cc-candybar",
-  "version": "1.56.1",
+  "version": "1.56.2",
   "description": "Statusline renderer for Claude Code — a JSON5-configurable DSL with daemon-cached data sources, byte-clean palette-aware composition, and OSC8 click verbs.",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -90,9 +90,9 @@
     "mobx": "^6.15.0"
   },
   "optionalDependencies": {
-    "@promptctl/cc-candybar-darwin-arm64": "1.56.1",
-    "@promptctl/cc-candybar-darwin-x64": "1.56.1",
-    "@promptctl/cc-candybar-linux-x64": "1.56.1",
-    "@promptctl/cc-candybar-linux-arm64": "1.56.1"
+    "@promptctl/cc-candybar-darwin-arm64": "1.56.2",
+    "@promptctl/cc-candybar-darwin-x64": "1.56.2",
+    "@promptctl/cc-candybar-linux-x64": "1.56.2",
+    "@promptctl/cc-candybar-linux-arm64": "1.56.2"
   }
 }

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-candybar",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "CCCandybar statusline setup wizard",
   "author": {
     "name": "promptctl"

package/plugin/bin/preview.sh

@@ -1,305 +1,168 @@
 #!/usr/bin/env bash
+# Render the wizard's template config against a fixture session so the user can
+# see a real bar before committing to a theme, style, charset, or preset.
+#
+# The config rendered here IS the template the wizard writes — templates/config.json
+# with its four placeholders filled by the same substitution the wizard performs —
+# so the preview cannot drift from what the wizard installs.
+# (test/plugin-templates.test.ts drives every name below through `cc-candybar check`.)
 
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 readonly SCRIPT_DIR
 readonly PLUGIN_ROOT="${SCRIPT_DIR}/.."
-
-readonly SAMPLE_JSON='{"model":{"id":"claude-sonnet-4-20250514","display_name":"Sonnet 4"},"cost":{"total_cost_usd":0.42,"message_cost_usd":0.03,"duration":"15m"},"context_window":{"context_window_size":200000,"used_percentage":35,"current_usage":{"input_tokens":50000,"cache_creation_input_tokens":10000,"cache_read_input_tokens":5000}},"cwd":"/home/user/my-project","workspace":{"current_dir":"/home/user/my-project"},"session_id":"abc123"}'
-
-setup_tui_transcript() {
-    local now_iso user_iso cwd_encoded transcript_dir
-    now_iso=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")
-    user_iso=$(date -u -d "-13 seconds" +"%Y-%m-%dT%H:%M:%S.000Z" 2>/dev/null \
-        || date -u -v-13S +"%Y-%m-%dT%H:%M:%S.000Z" 2>/dev/null \
-        || echo "${now_iso}")
-
-    # Encode the preview CWD the same way Claude Code encodes project dirs
-    # On Windows: C:\Users\foo\proj -> C--Users-foo-proj
-    # On Unix: /home/user/proj -> -home-user-proj
-    local preview_cwd
-    # Create a temp git repo so previews always show git data
-    local fake_repo
-    fake_repo="$(mktemp -d)/my-project"
-    mkdir -p "${fake_repo}"
-    git -C "${fake_repo}" init -b main --quiet 2>/dev/null
-    git -C "${fake_repo}" -c user.name="User" -c user.email="u@e.co" commit --allow-empty -m "init" --quiet 2>/dev/null
-    git -C "${fake_repo}" checkout -b feat/my-feature --quiet 2>/dev/null
-    touch "${fake_repo}/newfile.txt"
-    printf 'change\n' > "${fake_repo}/README.md"
-    git -C "${fake_repo}" add README.md 2>/dev/null
-
-    # Use native path for Node.js compatibility (Windows needs C:\... not /c/...)
-    preview_cwd="$(cd "${fake_repo}" && pwd -W 2>/dev/null || pwd)"
-    cwd_encoded="$(printf '%s' "${preview_cwd}" | sed 's|[/\\]|-|g; s|:||g')"
-    TUI_PREVIEW_CWD="${preview_cwd}"
-
-    transcript_dir="${HOME}/.claude/projects/${cwd_encoded}"
-    TUI_TRANSCRIPT="${transcript_dir}/preview-123.jsonl"
-    mkdir -p "${transcript_dir}"
-    printf '{"timestamp":"%s","type":"user","message":{"role":"user","content":[{"type":"text","text":"hello"}]}}\n' "${user_iso}" > "${TUI_TRANSCRIPT}"
-    printf '{"timestamp":"%s","type":"assistant","message":{"role":"assistant","content":[{"type":"text","text":"done"}]}}\n' "${now_iso}" >> "${TUI_TRANSCRIPT}"
-}
-
-make_tui_sample_json() {
-    local resets_5h resets_7d
-    resets_5h=$(( $(date +%s) + 15480 ))
-    resets_7d=$(( $(date +%s) + 432000 ))
-
-    printf '{"model":{"id":"claude-sonnet-4-20250514","display_name":"Sonnet 4"},"cost":{"total_cost_usd":2.85,"message_cost_usd":0.12,"total_duration_ms":16200000,"total_api_duration_ms":480000,"total_lines_added":342,"total_lines_removed":87},"context_window":{"context_window_size":200000,"used_percentage":42,"total_input_tokens":72000,"total_output_tokens":12000,"current_usage":{"input_tokens":72000,"output_tokens":12000,"cache_creation_input_tokens":15000,"cache_read_input_tokens":8000}},"rate_limits":{"five_hour":{"used_percentage":35,"resets_at":%d},"seven_day":{"used_percentage":28,"resets_at":%d}},"cwd":"%s","workspace":{"current_dir":"%s","project_dir":"%s"},"session_id":"preview-123","version":"1.0.47"}' \
-        "${resets_5h}" "${resets_7d}" "${TUI_PREVIEW_CWD}" "${TUI_PREVIEW_CWD}" "${TUI_PREVIEW_CWD}"
-}
-
-readonly PREVIEW_CONFIG='{
-  "theme": "dark",
-  "display": {
-    "style": "minimal",
-    "charset": "unicode",
-    "colorCompatibility": "auto",
-    "autoWrap": true,
-    "padding": 1,
-    "lines": [
-      {
-        "segments": {
-          "directory": { "enabled": true, "style": "fish" },
-          "git": { "enabled": true },
-          "model": { "enabled": true },
-          "session": { "enabled": true, "type": "cost", "costSource": "calculated" },
-          "today": { "enabled": true, "type": "cost" },
-          "context": { "enabled": true, "showPercentageOnly": false, "displayStyle": "text", "autocompactBuffer": 33000 }
-        }
-      }
-    ]
-  },
-  "budget": {
-    "session": { "warningThreshold": 80 },
-    "today": { "amount": 50, "warningThreshold": 80 }
-  }
-}'
-
-THEME="dark"
-STYLE="minimal"
-CHARSET="unicode"
-COMPARE_STYLES=false
-COMPARE_THEMES=false
-COMPARE_TUI_LAYOUTS=false
-BIN=""
-TEMP_FILES=()
+readonly TEMPLATE="${PLUGIN_ROOT}/templates/config.json"
+
+# The options the wizard offers, one list per template placeholder. Each name
+# must be one the daemon accepts; the test pins that against the real domains.
+readonly THEMES=(dark light nord tokyo-night rose-pine gruvbox catppuccin-mocha dracula solarized-dark monokai)
+readonly STYLES=(powerline capsule plain)
+readonly CHARSETS=(unicode ascii)
+readonly PRESETS=(default compact verbose)
+
+THEME="${THEMES[0]}"
+STYLE="${STYLES[0]}"
+CHARSET="${CHARSETS[0]}"
+PRESET="${PRESETS[0]}"
+COMPARE=""
+
+WORK="$(mktemp -d)"
+readonly WORK
+readonly REPO="${WORK}/my-project"
+readonly TRANSCRIPT="${WORK}/preview.jsonl"
+CLIENT=()
 
 # shellcheck disable=SC2329
 cleanup() {
-    for f in "${TEMP_FILES[@]}"; do
-        rm -f "${f}"
-    done
+    rm -rf "${WORK}"
 }
 trap cleanup EXIT
 
-test_binary() {
-    local bin="$1"
-    printf '{}' | "${bin}" --help >/dev/null 2>&1
-}
-
-find_binary() {
-    local npm_bin="${PLUGIN_ROOT}/../bin/cc-candybar"
-    local dist_file="${PLUGIN_ROOT}/../dist/index.mjs"
-    if [[ -f "${npm_bin}" ]] && [[ -f "${dist_file}" ]] && test_binary "${npm_bin}"; then
-        printf '%s' "${npm_bin}"
+# The statusline client: this checkout's shim (developing against a checkout),
+# an installed cc-candybar on PATH, else the published package via npx.
+find_client() {
+    local checkout_bin="${PLUGIN_ROOT}/../bin/cc-candybar"
+    if [[ -x "${checkout_bin}" ]] && [[ -f "${PLUGIN_ROOT}/../dist/index.mjs" ]]; then
+        CLIENT=("${checkout_bin}")
         return 0
     fi
-
     local path_bin
-    if path_bin="$(command -v cc-candybar 2>/dev/null)" && test_binary "${path_bin}"; then
-        printf '%s' "${path_bin}"
+    if path_bin="$(command -v cc-candybar)"; then
+        CLIENT=("${path_bin}")
         return 0
     fi
-
-    printf 'npx'
-    return 0
+    CLIENT=(npx -y @promptctl/cc-candybar@latest)
 }
 
-make_temp_config() {
-    local preview_theme="$1"
-    local preview_style="$2"
-    local preview_charset="$3"
-    local tmp
-
-    tmp="$(mktemp)"
-    TEMP_FILES+=("${tmp}")
-    printf '%s' "${PREVIEW_CONFIG}" |
-        sed -e "s/\"theme\": \"dark\"/\"theme\": \"${preview_theme}\"/" \
-            -e "s/\"style\": \"minimal\"/\"style\": \"${preview_style}\"/" \
-            -e "s/\"charset\": \"unicode\"/\"charset\": \"${preview_charset}\"/" \
-            >"${tmp}"
-    printf '%s' "${tmp}"
+# A git repo on a feature branch with one untracked file, so the git segment has
+# something to show, and a two-turn transcript for the session-derived segments.
+make_fixture() {
+    mkdir -p "${REPO}"
+    git -C "${REPO}" init -b main --quiet
+    git -C "${REPO}" -c user.name="User" -c user.email="u@e.co" commit --allow-empty -m "init" --quiet
+    git -C "${REPO}" checkout -b feat/my-feature --quiet
+    touch "${REPO}/newfile.txt"
+
+    local now_iso
+    now_iso="$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")"
+    printf '{"timestamp":"%s","type":"user","message":{"role":"user","content":[{"type":"text","text":"hello"}]}}\n' "${now_iso}" >"${TRANSCRIPT}"
+    printf '{"timestamp":"%s","type":"assistant","message":{"role":"assistant","content":[{"type":"text","text":"done"}]}}\n' "${now_iso}" >>"${TRANSCRIPT}"
 }
 
-run_preview() {
-    local preview_theme="$1"
-    local preview_style="$2"
-    local preview_charset="$3"
-    local tmp_config
-
-    tmp_config="$(make_temp_config "${preview_theme}" "${preview_style}" "${preview_charset}")"
-
-    if [[ "${BIN}" == "npx" ]]; then
-        printf '%s' "${SAMPLE_JSON}" | FORCE_COLOR=3 npx -y @promptctl/cc-candybar@latest \
-            --config="${tmp_config}"
-    else
-        printf '%s' "${SAMPLE_JSON}" | FORCE_COLOR=3 "${BIN}" \
-            --config="${tmp_config}"
-    fi
+# One Claude Code status hook payload, shaped like the daemon's required input.
+sample_json() {
+    printf '{"hook_event_name":"Status","session_id":"preview-123","transcript_path":"%s","cwd":"%s","workspace":{"current_dir":"%s","project_dir":"%s"},"model":{"id":"claude-opus-4-8","display_name":"Opus 4.8"},"version":"1.0.47","cost":{"total_cost_usd":2.85,"total_duration_ms":16200000,"total_api_duration_ms":480000,"total_lines_added":342,"total_lines_removed":87},"context_window":{"context_window_size":200000,"used_percentage":42,"total_input_tokens":72000,"total_output_tokens":12000,"current_usage":{"input_tokens":72000,"output_tokens":12000,"cache_creation_input_tokens":15000,"cache_read_input_tokens":8000}},"rate_limits":{"five_hour":{"used_percentage":35,"resets_at":%d},"seven_day":{"used_percentage":28,"resets_at":%d}}}' \
+        "${TRANSCRIPT}" "${REPO}" "${REPO}" "${REPO}" \
+        "$(($(date +%s) + 15480))" "$(($(date +%s) + 432000))"
 }
 
-run_preview_config() {
-    local config_file="$1"
-    local sample_data="$2"
-
-    if [[ "${BIN}" == "npx" ]]; then
-        printf '%s' "${sample_data}" | FORCE_COLOR=3 npx -y @promptctl/cc-candybar@latest \
-            --config="${config_file}"
-    else
-        printf '%s' "${sample_data}" | FORCE_COLOR=3 "${BIN}" \
-            --config="${config_file}"
-    fi
+# The one render request, sent from inside the fixture repo (the daemon reads
+# git state from the client's working directory).
+render_request() {
+    (cd "${REPO}" && sample_json | "${CLIENT[@]}" "$@")
 }
 
-run_compare_tui_layouts() {
-    local layouts=(compact standard full)
-    local label
-    local template_file tmp tui_json fake_repo
-
-    setup_tui_transcript
-    tui_json="$(make_tui_sample_json)"
-    fake_repo="${TUI_PREVIEW_CWD}"
+probe_daemon() {
+    { "${CLIENT[@]}" daemon-stats --json >/dev/null; } 2>&1
+}
 
-    for label in "${layouts[@]}"; do
-        template_file="${PLUGIN_ROOT}/templates/config-tui-${label}.json"
-        if [[ ! -f "${template_file}" ]]; then
-            printf '%s: template not found\n\n' "${label}"
-            continue
+# The first request on a cold daemon spawns it in the background and prints an
+# empty line; a preview must not be that line. Kick once, then wait until the
+# daemon answers or the deadline passes. The bound is wall-clock, not a probe
+# count: a probe through npx costs seconds, a native one milliseconds.
+ensure_daemon() {
+    local probe deadline=$((SECONDS + 15))
+    if probe="$(probe_daemon)"; then
+        return 0
+    fi
+    render_request >/dev/null
+    until probe="$(probe_daemon)"; do
+        if ((SECONDS >= deadline)); then
+            printf 'preview: the cc-candybar daemon did not start within 15s: %s\n' "${probe}" >&2
+            exit 1
         fi
-
-        tmp="$(mktemp)"
-        TEMP_FILES+=("${tmp}")
-        sed -e "s/replace:THEME/${THEME}/g" \
-            -e "s/replace:CHARSET/${CHARSET}/g" \
-            -e "s/\"replace:TODAY_BUDGET\"/50/g" \
-            "${template_file}" >"${tmp}"
-
-        printf '%s:\n' "${label}"
-        run_preview_config "${tmp}" "${tui_json}"
-        printf '\n\n'
+        sleep 0.1
     done
-
-    # Clean up fake transcript and git repo
-    rm -f "${TUI_TRANSCRIPT}" 2>/dev/null
-    rm -rf "${fake_repo%/my-project}" 2>/dev/null
 }
 
-run_compare_styles() {
-    local styles=(minimal powerline capsule tui)
-    local s
-
-    for s in "${styles[@]}"; do
-        printf '%s:\n' "${s}"
-        run_preview "${THEME}" "${s}" "${CHARSET}"
-        printf '\n\n'
-    done
+# The wizard's substitution, exactly: the template with its four placeholders
+# filled. Prints the written path.
+fill_template() {
+    local theme="$1" style="$2" charset="$3" preset="$4"
+    local out="${WORK}/config-${theme}-${style}-${charset}-${preset}.json"
+    sed -e "s/replace:THEME/${theme}/" \
+        -e "s/replace:STYLE/${style}/" \
+        -e "s/replace:CHARSET/${charset}/" \
+        -e "s/replace:PRESET/${preset}/" \
+        "${TEMPLATE}" >"${out}"
+    printf '%s' "${out}"
 }
 
-run_compare_themes() {
-    local themes=(dark light nord tokyo-night rose-pine gruvbox)
-    local t
-
-    for t in "${themes[@]}"; do
-        printf '%s:\n' "${t}"
-        run_preview "${t}" "${STYLE}" "${CHARSET}"
-        printf '\n\n'
-    done
+render() {
+    render_request --config="$(fill_template "$@")"
+    printf '\n'
 }
 
 parse_args() {
     while [[ $# -gt 0 ]]; do
         case "$1" in
-            --theme=*)
-                THEME="${1#*=}"
-                shift
-                ;;
-            --theme)
-                [[ $# -ge 2 ]] || {
-                    printf 'Missing value for --theme\n' >&2
-                    exit 1
-                }
-                THEME="$2"
-                shift 2
-                ;;
-            --style=*)
-                STYLE="${1#*=}"
-                shift
-                ;;
-            --style)
-                [[ $# -ge 2 ]] || {
-                    printf 'Missing value for --style\n' >&2
-                    exit 1
-                }
-                STYLE="$2"
-                shift 2
-                ;;
-            --charset=*)
-                CHARSET="${1#*=}"
-                shift
-                ;;
-            --charset)
-                [[ $# -ge 2 ]] || {
-                    printf 'Missing value for --charset\n' >&2
-                    exit 1
-                }
-                CHARSET="$2"
-                shift 2
-                ;;
-            --compare-styles)
-                COMPARE_STYLES=true
-                shift
-                ;;
-            --compare-themes)
-                COMPARE_THEMES=true
-                shift
-                ;;
-            --compare-tui-layouts)
-                COMPARE_TUI_LAYOUTS=true
-                shift
-                ;;
+            --theme=*) THEME="${1#*=}" ;;
+            --style=*) STYLE="${1#*=}" ;;
+            --charset=*) CHARSET="${1#*=}" ;;
+            --preset=*) PRESET="${1#*=}" ;;
+            --compare-themes) COMPARE="themes" ;;
+            --compare-styles) COMPARE="styles" ;;
+            --compare-charsets) COMPARE="charsets" ;;
+            --compare-presets) COMPARE="presets" ;;
             *)
                 printf 'Unknown option: %s\n' "$1" >&2
-                exit 1
+                printf 'Usage: preview.sh [--theme=NAME] [--style=NAME] [--charset=NAME] [--preset=NAME] [--compare-themes|--compare-styles|--compare-charsets|--compare-presets]\n' >&2
+                exit 2
                 ;;
         esac
+        shift
     done
 }
 
 main() {
     parse_args "$@"
-    BIN="$(find_binary)"
-
-    if [[ "${COMPARE_STYLES}" == "true" ]]; then
-        run_compare_styles
-        exit 0
-    fi
-
-    if [[ "${COMPARE_THEMES}" == "true" ]]; then
-        run_compare_themes
-        exit 0
-    fi
-
-    if [[ "${COMPARE_TUI_LAYOUTS}" == "true" ]]; then
-        run_compare_tui_layouts
-        exit 0
-    fi
-
-    run_preview "${THEME}" "${STYLE}" "${CHARSET}"
-    printf '\n'
-    exit 0
+    find_client
+    make_fixture
+    ensure_daemon
+    # The flag values are checked once, as the wizard's user would see them
+    # (exit 1 names the error). A compare varies one axis over its array, whose
+    # members test/plugin-templates.test.ts pins to the loader's own domain.
+    "${CLIENT[@]}" check "$(fill_template "${THEME}" "${STYLE}" "${CHARSET}" "${PRESET}")" >/dev/null
+
+    local name
+    case "${COMPARE}" in
+        "") render "${THEME}" "${STYLE}" "${CHARSET}" "${PRESET}" ;;
+        themes) for name in "${THEMES[@]}"; do printf '%s:\n' "${name}"; render "${name}" "${STYLE}" "${CHARSET}" "${PRESET}"; printf '\n'; done ;;
+        styles) for name in "${STYLES[@]}"; do printf '%s:\n' "${name}"; render "${THEME}" "${name}" "${CHARSET}" "${PRESET}"; printf '\n'; done ;;
+        charsets) for name in "${CHARSETS[@]}"; do printf '%s:\n' "${name}"; render "${THEME}" "${STYLE}" "${name}" "${PRESET}"; printf '\n'; done ;;
+        presets) for name in "${PRESETS[@]}"; do printf '%s:\n' "${name}"; render "${THEME}" "${STYLE}" "${CHARSET}" "${name}"; printf '\n'; done ;;
+    esac
 }
 
 main "$@"