@stacksjs/cli 0.75.344 → 0.75.345
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -0
- package/dist/index.js +8 -8
- package/package.json +9 -9
package/README.md
CHANGED
|
@@ -9,6 +9,18 @@ The simple way to build beautiful CLIs.
|
|
|
9
9
|
- 🚦 Elegant terminal spinners
|
|
10
10
|
- ⛑️ Helper methods to run commands
|
|
11
11
|
|
|
12
|
+
## Forwarding shutdown signals
|
|
13
|
+
|
|
14
|
+
For a supervised, long-running command, pass `forwardSignals: true` to `exec`
|
|
15
|
+
or `runCommand`. On POSIX, SIGINT and SIGTERM received by the parent are forwarded
|
|
16
|
+
to its direct child; the child remains responsible for draining its work and
|
|
17
|
+
exiting. Forwarding listeners are removed when the child exits. This is opt-in
|
|
18
|
+
and does not terminate a process tree or impose a drain deadline.
|
|
19
|
+
|
|
20
|
+
`buddy queue:work` enables forwarding automatically so a supervisor that signals
|
|
21
|
+
only Buddy still reaches the queue worker. Importing CLI prompts does not install
|
|
22
|
+
an exit handler; Ctrl+C exits an active interactive prompt only.
|
|
23
|
+
|
|
12
24
|
## Capturing bounded command output
|
|
13
25
|
|
|
14
26
|
Use the narrow `@stacksjs/cli/process` entry for a finite command whose text
|
package/dist/index.js
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
// @bun
|
|
2
|
-
import
|
|
2
|
+
import Ye from"process";async function De(e,t={silent:!0}){let n=t.packageManager??"bun",r=[n==="npm"?"install":"add"];if(t.dev)r.push("-D");if(t.preferOffline&&n!=="bun")r.push("--prefer-offline");if(t.additionalArgs)r.push(...t.additionalArgs);r.push(e);let i=await Bun.spawn([n,...r],{cwd:t.cwd??Ye.cwd(),stdout:t.silent?"ignore":"inherit",stderr:t.silent?"ignore":"inherit",stdin:"ignore",env:Ye.env}).exited;if(i!==0)throw Error(`Failed to install ${e} (exit code ${i})`)}async function nr(e,t){return De(e,t??{silent:!0})}async function or(e,t){return De(`@stacksjs/${e}`,t??{silent:!0})}import{CLI as ar,cli as ft,onUnknownSubcommand as lr}from"@stacksjs/clapp";function cr(e,t){if(typeof e==="object")t=e,e=t.name;return ft(e||"buddy")}import{existsSync as ne,readdirSync as pt}from"fs";import{join as ze}from"path";var ht=/(?:\.test|\.spec|\.bench|\.d)\.ts$/;function bt(e){return e.endsWith(".ts")&&!ht.test(e)&&!e.startsWith("_")}function yt(e){if(!ne(e))return[];let t=[],n=(r,o)=>{for(let i of pt(r,{withFileTypes:!0})){if(i.name.startsWith(".")||i.name==="node_modules")continue;if(i.isDirectory()){n(ze(r,i.name),`${o}${i.name}/`);continue}if(bt(i.name))t.push(`${o}${i.name.slice(0,-3)}`)}};return n(e,""),t.sort()}async function _e(e){if(!e||!ne(e))return{};try{let n=(await import(e)).default;if(!n||typeof n!=="object")return{error:Error(`${e} must default-export a command registry object.`)};return{registry:n}}catch(t){return{error:t}}}async function Ct(e){let{commandsDir:t}=e,n=e.registry??(await _e(e.registryPath)).registry,r=yt(t),o=new Map;for(let a of r)o.set(a,{file:a,path:ze(t,`${a}.ts`),aliases:[],enabled:!0,source:"auto"});let i=[];for(let[a,l]of Object.entries(n??{})){let s=typeof l==="string"?{file:l}:l,c=o.get(s.file);if(!c)continue;if(c.signature=a,c.aliases=s.aliases??[],c.enabled=s.enabled!==!1,c.source="registry",!i.includes(c))i.push(c)}for(let a of r){let l=o.get(a);if(l&&!i.includes(l))i.push(l)}return i}function xt(e,t,n){let r=t.trim().split(/\s+/)[0],i=e?.commands?.find((a)=>a.name===r);if(!i||typeof i.alias!=="function")return!1;for(let a of n)i.alias(a);return!0}async function mr(e,t){let n=t.onError??(()=>{}),r=t.onDebug??(()=>{});if(!ne(t.commandsDir))return r(`No ${t.commandsDir} directory, skipping application commands.`),[];let o=t.registry?{registry:t.registry}:await _e(t.registryPath);if(o.error)n(`Could not read the command registry at ${t.registryPath}`,o.error);let i=await Ct({...t,registry:o.registry}),a=[];for(let l of i){if(!l.enabled){r(`Skipping disabled command ${l.file}.`);continue}try{let s=await import(l.path);if(s.enabled===!1){r(`Skipping ${l.file}: the module exports \`enabled = false\`.`);continue}if(typeof s.default!=="function"){n(`Expected a default export function in ${l.file}.ts, but got: ${typeof s.default}`);continue}let c=e.commands?.length??0;s.default(e);let m=[...l.aliases,...s.aliases??[]];if(m.length)wt(e,l.signature,c,m,r);a.push(l)}catch(s){n(`Failed to load command ${l.file}`,s)}}return a}function wt(e,t,n,r,o){if(t&&xt(e,t,r))return;let l=(e.commands?.slice(n)??[])[0];if(!l||typeof l.alias!=="function"){o(`Could not alias '${t??"command"}': no matching command was registered.`);return}for(let s of r)l.alias(s)}function fr(e){if(typeof e==="function")return e;return(t)=>kt(t,e)}function kt(e,t){let n=e.command(t.name,t.description??"",{allowUnknownOptions:t.allowUnknownOptions});if(t.usage)n.usage(t.usage);for(let[r,o]of Object.entries(t.options??{})){let i=typeof o==="string"?{description:o}:o;n.option(r,i.description??"",{...i.default===void 0?{}:{default:i.default},...i.type?{type:i.type}:{}})}for(let r of t.aliases??[])n.alias(r);for(let r of t.examples??[])n.example(r);return n.action((...r)=>{let o=r[r.length-1];return t.handle(o,...r.slice(0,-1))}),n}function pr(e){return e}import B from"process";import{err as q,handleError as oe,ok as $t}from"@stacksjs/error-handling";import{ExitCode as K}from"@stacksjs/types";async function ie(e,t){let n=Array.isArray(e)?e:e.match(/(?:[^\s"]|"[^"]*")+/g);if(!n)return q(oe(`Failed to parse command: ${n}`,t));let r=t?.cwd??B.cwd(),o=t?.timeoutMs,[i,a,l]=Array.isArray(t?.stdio)?t.stdio:[],s=t?.silent||t?.quiet,c=Bun.spawn(n,{stdin:t?.stdin??i??"inherit",stdout:s?"ignore":t?.stdout??a??"inherit",stderr:s?"ignore":t?.stderr??l??"inherit",cwd:r,env:{...B.env,...t?.env},onExit(y,w,p,x){Ke("spawn",y,w,p,x)}});if(t?.forwardSignals){let y=(S)=>{if(c.exitCode!==null||c.signalCode)return;try{c.kill(S)}catch{}},w=()=>y("SIGINT"),p=()=>y("SIGTERM");B.on("SIGINT",w),B.on("SIGTERM",p);let x=()=>{B.off("SIGINT",w),B.off("SIGTERM",p)};c.exited.then(x,x)}if(t?.stdin==="pipe"&&t.input){if(c.stdin)c.stdin.write(t.input),c.stdin.end()}let m,C=await Promise.race([c.exited,new Promise((y)=>{if(!o)return;m=setTimeout(()=>{try{c.kill()}catch{}y(K.FatalError)},o)})]);if(m)clearTimeout(m);if(o&&C===K.FatalError&&c.exitCode===null)return q(oe(`Command timed out after ${o}ms: ${k(n.join(" "))} in ${k(r)}`,t));if(C===K.Success)return $t(c);let h=c.signalCode;if(h==="SIGTERM"||h==="SIGINT"||h==="SIGKILL"||c.exitCode===null&&C!==K.Success)return q(Error(`Command terminated by ${h??"signal"}: ${n.join(" ")}`));return q(oe(`Failed to execute command: ${k(n.join(" "))} in ${k(r)}`,t))}async function qe(e,t){let n=Array.isArray(e)?e:e.match(/(?:[^\s"]|"[^"]*")+/g);if(!n)throw b.error(`Failed to parse command: ${n}`,t),Error(`Failed to parse command: ${n}`);let r=Bun.spawnSync(n,{...t,stdin:t?.stdin??"inherit",stdout:t?.stdout??"pipe",stderr:t?.stderr??"inherit",cwd:t?.cwd??B.cwd(),env:{...B.env,...t?.env},onExit(i,a,l,s){Ke("spawnSync",i,a,l,s)}}),o=r.stdout?.toString()??"";if(t?.throwOnError&&r.exitCode!==0){let a=((r.stderr?.toString()??"").trim()||o.trim()||"(no output)").split(`
|
|
3
3
|
`).slice(0,5).join(`
|
|
4
4
|
`);throw Error(`Command failed with exit code ${r.exitCode}: ${n.join(" ")}
|
|
5
|
-
${a}`)}return o}function Ke(e,t,n,r,o){if(b.debug(`exitHandler: ${e}, exitCode: ${n}, signalCode: ${r}`),o)b.debug("Process error:",o.message)}import{handleError as Et}from"@stacksjs/error-handling";import{log as b}from"@stacksjs/logging";import{ExitCode as
|
|
6
|
-
`)}function
|
|
7
|
-
`)}var Lr=vt(["The best way to get started is to quit talking and begin doing.","The pessimist sees difficulty in every opportunity. The optimist sees opportunity in every difficulty.","Don\u2019t let yesterday take up too much of today.","You learn more from failure than from success. Don\u2019t let it stop you. Failure builds character.","It\u2019s not whether you get knocked down, it\u2019s whether you get up.","If you are working on something that you really care about, you don\u2019t have to be pushed. The vision pulls you.","People who are crazy enough to think they can change the world, are the ones who do.","Failure will never overtake me if my determination to succeed is strong enough.","Entrepreneurs are great at dealing with uncertainty and also very good at minimizing risk. That\u2019s the classic entrepreneur.","We may encounter many defeats but we must not be defeated.","Knowing is not enough; we must apply. Wishing is not enough; we must do.","Imagine your life is perfect in every respect; what would it look like?","We generate fears while we sit. We overcome them by action.","Whether you think you can or think you can\u2019t, you\u2019re right.","Security is mostly a superstition. Life is either a daring adventure or nothing."]);var nt="0.75.
|
|
5
|
+
${a}`)}return o}function Ke(e,t,n,r,o){if(b.debug(`exitHandler: ${e}, exitCode: ${n}, signalCode: ${r}`),o)b.debug("Process error:",o.message)}import{handleError as Et}from"@stacksjs/error-handling";import{log as b}from"@stacksjs/logging";import{ExitCode as Ae}from"@stacksjs/types";import{collect as vt}from"@stacksjs/collections";var g=!process.env.NO_COLOR&&(process.env.FORCE_COLOR?process.env.FORCE_COLOR!=="0":!!process.stdout?.isTTY),d={reset:g?"\x1B[0m":"",black:g?"\x1B[30m":"",red:g?"\x1B[31m":"",green:g?"\x1B[32m":"",yellow:g?"\x1B[33m":"",blue:g?"\x1B[34m":"",magenta:g?"\x1B[35m":"",cyan:g?"\x1B[36m":"",white:g?"\x1B[37m":"",gray:g?"\x1B[90m":"",lightRed:g?"\x1B[91m":"",lightGreen:g?"\x1B[92m":"",lightYellow:g?"\x1B[93m":"",lightBlue:g?"\x1B[94m":"",lightMagenta:g?"\x1B[95m":"",lightCyan:g?"\x1B[96m":"",lightGray:g?"\x1B[37m":"",bgBlack:g?"\x1B[40m":"",bgRed:g?"\x1B[41m":"",bgGreen:g?"\x1B[42m":"",bgYellow:g?"\x1B[43m":"",bgBlue:g?"\x1B[44m":"",bgMagenta:g?"\x1B[45m":"",bgCyan:g?"\x1B[46m":"",bgWhite:g?"\x1B[47m":"",bgGray:g?"\x1B[100m":"",bgLightRed:g?"\x1B[101m":"",bgLightGreen:g?"\x1B[102m":"",bgLightYellow:g?"\x1B[103m":"",bgLightBlue:g?"\x1B[104m":"",bgLightMagenta:g?"\x1B[105m":"",bgLightCyan:g?"\x1B[106m":"",bgLightGray:g?"\x1B[47m":"",bold:g?"\x1B[1m":"",dim:g?"\x1B[2m":"",italic:g?"\x1B[3m":"",underline:g?"\x1B[4m":"",inverse:g?"\x1B[7m":"",hidden:g?"\x1B[8m":"",strikethrough:g?"\x1B[9m":""},V="\x1B[",Ft="\x1B]8;;",St="\x1B]8;;\x07",Ue=(e)=>String(e);function O(e,t,n){return Math.min(Math.max(Math.floor(e),t),n)}function u(e,t=d.reset){return(n)=>{if(!g)return String(n);return`${e}${String(n)}${t}`}}function Bt(e){return e.replace(/\x1B\]8;;[^\x07]*(?:\x07|\x1B\\)/g,"").replace(/\x1B\]8;;(?:\x07|\x1B\\)/g,"")}function E(e){return Bt(e).replace(/\x1B\[[0-?]*[ -/]*[@-~]/g,"")}var He=E;function Ve(e){return Array.from(E(e)).length}var se=u(d.black),ae=u(d.red),P=u(d.green),le=u(d.yellow),ce=u(d.blue),ue=u(d.magenta),G=u(d.cyan),ge=u(d.white),L=u(d.gray),de=u(d.lightRed),me=u(d.lightGreen),fe=u(d.lightYellow),pe=u(d.lightBlue),he=u(d.lightMagenta),be=u(d.lightCyan),U=u(d.lightGray),ye=u(d.bgBlack),Ce=u(d.bgRed),xe=u(d.bgGreen),we=u(d.bgYellow),ke=u(d.bgBlue),$e=u(d.bgMagenta),N=u(d.bgCyan),ve=u(d.bgWhite),Fe=u(d.bgGray),Se=u(d.bgLightRed),Be=u(d.bgLightGreen),Oe=u(d.bgLightYellow),Le=u(d.bgLightBlue),Re=u(d.bgLightMagenta),Ie=u(d.bgLightCyan),H=u(d.bgLightGray),F=u(d.bold),R=u(d.dim),k=u(d.italic),Me=u(d.underline),Ee=u(d.inverse),Te=u(d.hidden),Pe=u(d.strikethrough),Ge=u(d.reset,"");function Je(e){return u(`${V}38;5;${O(e,0,255)}m`)}function Qe(e){return u(`${V}48;5;${O(e,0,255)}m`)}function Xe(e,t,n){return u(`${V}38;2;${O(e,0,255)};${O(t,0,255)};${O(n,0,255)}m`)}function Ze(e,t,n){return u(`${V}48;2;${O(e,0,255)};${O(t,0,255)};${O(n,0,255)}m`)}function et(e,t){let n=(o,i)=>{let a=String(o);if(!g)return a;return`${Ft}${i}\x07${a}${St}`};if(typeof t==="string")return n(e,t);let r=String(e);return(o)=>n(o,r)}var Ot={black:se,red:ae,green:P,yellow:le,blue:ce,magenta:ue,cyan:G,white:ge,gray:L,lightRed:de,lightGreen:me,lightYellow:fe,lightBlue:pe,lightMagenta:he,lightCyan:be,lightGray:U,bgBlack:ye,bgRed:Ce,bgGreen:xe,bgYellow:we,bgBlue:ke,bgMagenta:$e,bgCyan:N,bgWhite:ve,bgGray:Fe,bgLightRed:Se,bgLightGreen:Be,bgLightYellow:Oe,bgLightBlue:Le,bgLightMagenta:Re,bgLightCyan:Ie,bgLightGray:H,bold:F,dim:R,italic:k,underline:Me,inverse:Ee,hidden:Te,strikethrough:Pe,reset:Ge};function tt(e){return Ot[e]??Ue}function $r(e,t){if(typeof t==="function")return t(e);return tt(t)(e)}function Lt(){return g}var vr={black:se,red:ae,green:P,yellow:le,blue:ce,magenta:ue,cyan:G,white:ge,gray:L,lightRed:de,lightGreen:me,lightYellow:fe,lightBlue:pe,lightMagenta:he,lightCyan:be,lightGray:U,bgBlack:ye,bgRed:Ce,bgGreen:xe,bgYellow:we,bgBlue:ke,bgMagenta:$e,bgCyan:N,bgWhite:ve,bgGray:Fe,bgLightRed:Se,bgLightGreen:Be,bgLightYellow:Oe,bgLightBlue:Le,bgLightMagenta:Re,bgLightCyan:Ie,bgLightGray:H,bold:F,dim:R,italic:k,underline:Me,inverse:Ee,hidden:Te,strikethrough:Pe,reset:Ge,ansi256:Je,ansi256Bg:Qe,trueColor:Xe,trueColorBg:Ze,link:et,stripColors:He},Fr={black:se,red:ae,green:P,yellow:le,blue:ce,magenta:ue,cyan:G,white:ge,gray:L,lightRed:de,lightGreen:me,lightYellow:fe,lightBlue:pe,lightMagenta:he,lightCyan:be,lightGray:U,bgBlack:ye,bgRed:Ce,bgGreen:xe,bgYellow:we,bgBlue:ke,bgMagenta:$e,bgCyan:N,bgWhite:ve,bgGray:Fe,bgLightRed:Se,bgLightGreen:Be,bgLightYellow:Oe,bgLightBlue:Le,bgLightMagenta:Re,bgLightCyan:Ie,bgLightGray:H,bold:F,dim:R,italic:k,underline:Me,inverse:Ee,hidden:Te,strikethrough:Pe,reset:Ge,ansi256:Je,ansi256Bg:Qe,trueColor:Xe,trueColorBg:Ze,link:et,stripColors:He,grey:L,lightGrey:U,bgLightGrey:H,supportsColor:Lt};function Rt(e,t,n,r){let o=Ve(e);if(o>=t)return e;let i=r[0]||" ",a=t-o;if(n==="right")return`${i.repeat(a)}${e}`;if(n==="center"){let l=Math.floor(a/2),s=a-l;return`${i.repeat(l)}${e}${i.repeat(s)}`}return`${e}${i.repeat(a)}`}function J(e){return Math.max(0,...e.map(Ve))}function Q(e,t,n="left"){let r=String(e).split(/\r?\n/),o=typeof t==="object"?t:void 0,i=typeof t==="number"?t:o?.width??J(r),a=o?.align??n,l=o?.padChar??" ";return r.map((s)=>Rt(s,Math.max(0,i),a,l)).join(`
|
|
6
|
+
`)}function Sr(e,t){return Q(e,t,"left")}function Br(e,t){let n=String(e).split(/\r?\n/);return Q(e,t??process.stdout?.columns??J(n),"right")}function Or(e,t){let n=String(e).split(/\r?\n/);return Q(e,t??process.stdout?.columns??J(n),"center")}var It={single:{topLeft:"\u250C",topRight:"\u2510",bottomLeft:"\u2514",bottomRight:"\u2518",horizontal:"\u2500",vertical:"\u2502"},double:{topLeft:"\u2554",topRight:"\u2557",bottomLeft:"\u255A",bottomRight:"\u255D",horizontal:"\u2550",vertical:"\u2551"},round:{topLeft:"\u256D",topRight:"\u256E",bottomLeft:"\u2570",bottomRight:"\u256F",horizontal:"\u2500",vertical:"\u2502"}};function rt(e,t={}){let n=String(e).split(/\r?\n/),r=It[t.borderStyle??"single"],o=Math.max(0,t.padding??1),i=Math.max(0,t.margin??0),a=t.align??"left",l=J(n),s=l+o*2,c=typeof t.borderColor==="function"?t.borderColor:t.borderColor?tt(t.borderColor):Ue,C=c((()=>{if(!t.title)return`${r.topLeft}${r.horizontal.repeat(s)}${r.topRight}`;let x=` ${E(String(t.title))} `.slice(0,s),S=r.horizontal.repeat(Math.max(0,s-x.length));return`${r.topLeft}${x}${S}${r.topRight}`})()),h=c(`${r.bottomLeft}${r.horizontal.repeat(s)}${r.bottomRight}`),y=n.map((p)=>{let x=Q(p,{align:a,width:l}),S=`${" ".repeat(o)}${x}${" ".repeat(o)}`;return`${c(r.vertical)}${S}${c(r.vertical)}`}),w=" ".repeat(i);return[C,...y,h].map((p)=>`${w}${p}`).join(`
|
|
7
|
+
`)}var Lr=vt(["The best way to get started is to quit talking and begin doing.","The pessimist sees difficulty in every opportunity. The optimist sees opportunity in every difficulty.","Don\u2019t let yesterday take up too much of today.","You learn more from failure than from success. Don\u2019t let it stop you. Failure builds character.","It\u2019s not whether you get knocked down, it\u2019s whether you get up.","If you are working on something that you really care about, you don\u2019t have to be pushed. The vision pulls you.","People who are crazy enough to think they can change the world, are the ones who do.","Failure will never overtake me if my determination to succeed is strong enough.","Entrepreneurs are great at dealing with uncertainty and also very good at minimizing risk. That\u2019s the classic entrepreneur.","We may encounter many defeats but we must not be defeated.","Knowing is not enough; we must apply. Wishing is not enough; we must do.","Imagine your life is perfect in every respect; what would it look like?","We generate fears while we sit. We overcome them by action.","Whether you think you can or think you can\u2019t, you\u2019re right.","Security is mostly a superstition. Life is either a daring adventure or nothing."]);var nt="0.75.345";async function Ar(e,t){return new Promise((n)=>{if(t?.quiet===!1)console.log(),console.log(G(F("Stacks CLI"))+R(` v${nt}`)),console.log();if(b.info(`Running ${N(k(F(` ${e} `)))}`),t?.showPerformance===!1||t?.quiet)return n(0);return n(performance.now())})}function jr(e,t,n){let r={type:"success",useSeconds:!0,...t};return r.message=t?.message||e,new Promise((o)=>{if(n)return Et(n),o(Ae.FatalError);if(r?.startTime){let i=performance.now()-r.startTime;if(r.useSeconds)i=i/1000,i=Math.round(i*100)/100;if(r.quiet===!0)return o(Ae.Success);if(n)b.error(`[${i.toFixed(2)}${r.useSeconds?"s":"ms"}] Failed`);else if(r.type==="error")b.error(`[${i.toFixed(2)}${r.useSeconds?"s":"ms"}] ${r.message??"Failed"}`);else if(r.type==="warning")b.warn(`[${i.toFixed(2)}${r.useSeconds?"s":"ms"}] ${r.message??"Complete"}`);else if(r.type==="info")b.info(`${R(L(`[${i.toFixed(2)}${r.useSeconds?"s":"ms"}]`))} ${r.message??"Complete"}`);else b.success(`${R(L(F(`[${i.toFixed(2)}${r.useSeconds?"s":"ms"}]`)))} ${F(P(r.message??"Complete"))}`)}else if(r?.type==="info")b.info(e);else if(r?.type==="error")b.error(e);else if(r?.type==="warning")b.warn(e);else if(r?.type==="success"&&r?.quiet!==!0)b.success(e);b.flush().catch(()=>{}).then(()=>o(Ae.Success))})}import X from"process";function ot(e){if(!e)return!1;return e.startsWith("--")}function Tt(e){return e.startsWith("-")&&!ot(e)}function je(e){if(e==="true")return!0;if(e==="false")return!1;let t=Number.parseFloat(e);if(!Number.isNaN(t))return t;return e.replace(/"/g,"")}function Pt(e,t,n,r){let[o,i]=e.slice(2).split("=");if(i!==void 0)r[o]=je(i);else if(n+1<t.length&&!t[n+1]?.startsWith("-"))r[o]=t[n+1],n++;else r[o]=!0;return n}function Gt(e,t,n,r){let[o,i]=e.slice(1).split("=");if(o===void 0)return n;if(i!==void 0&&o!==void 0)for(let a=0;a<o.length;a++)r[o[a]]=je(i);else for(let a=0;a<o.length;a++)if(n+1<t.length&&a===o.length-1&&!t[n+1]?.startsWith("-"))r[o[a]]=je(t[n+1]),n++;else r[o[a]]=!0;return n}function At(e){if(e===void 0)e=X.argv.slice(2);let t=[],n={};for(let r=0;r<e.length;r++){let o=e[r];if(!o)continue;if(ot(o))r=Pt(o,e,r,n);else if(Tt(o))r=Gt(o,e,r,n);else t.push(o)}return{args:t,options:n}}function Dr(e){if(e===void 0)e=X.argv.slice(2);return At(e).args}function zr(e){e=e||{};let t={dryRun:!1,quiet:!1,verbose:!1},n=X.argv.slice(2);for(let r=0;r<n.length;r++){let o=n[r];if(o?.startsWith("--")){let a=o.substring(2).replace(/-([a-z])/gi,(l)=>l[1]?l[1].toUpperCase():"");if(r+1<n.length&&!n?.[r+1]?.startsWith("--"))if(n?.[r+1]==="true"||n?.[r+1]==="false")e[a]=n[r+1]==="true",r++;else e[a]=n[r+1],r++;else e[a]=!0}}if(Object.keys(e).length===0)return{};return{...t,...e}}function jt(e){let t=[];for(let[n,r]of Object.entries(e)){if(n==="--"||n==="_"||n==="forwardSignals"||r===!1||r===void 0||r===null)continue;if(typeof r==="object"&&!Array.isArray(r))continue;if(typeof r==="function"||typeof r==="symbol")continue;if(r===!0)t.push(`--${n}`);else t.push(`--${n}`,String(r))}return t}function Nt(e){if(Array.isArray(e)){if(e=Array.from(new Set(e)),Array.isArray(e)&&e[0]&&!e[0].startsWith("-"))e.shift();return e.join(" ")}if(typeof e==="object"&&e!==null)return jt(e).join(" ");return Nt(X.argv.slice(2))}async function qr(e,t){if(!Number.isSafeInteger(t.timeoutMs)||t.timeoutMs<1||t.timeoutMs>120000)throw Error("Invalid bounded process timeout");for(let f of[t.stdoutBytes,t.stderrBytes])if(!Number.isSafeInteger(f)||f<1||f>2000000)throw Error("Invalid bounded process output limit");let n=t.signal;if(n!==void 0&&!(n instanceof AbortSignal))throw TypeError("Invalid bounded process signal");let r=()=>Error(`${t.label} canceled`,{cause:n?.reason});if(n?.aborted)throw r();let o=process.platform!=="win32",i=Bun.spawn(e,{cwd:t.cwd,env:t.env??process.env,stdin:"ignore",stdout:"pipe",stderr:"pipe",detached:o}),a=[i.stdout.getReader(),i.stderr.getReader()],l=[],s,c=!1,m=!1,C="failed",h=[];function y(f){if(f?.code!=="ESRCH")h.push(f)}function w(){if(o)try{process.kill(-i.pid,"SIGKILL")}catch(f){y(f)}if(i.exitCode===null)try{i.kill("SIGKILL")}catch(f){y(f)}}function p(f,I="failed"){if(!c)s=f,c=!0,C=I;if(m)return;m=!0,w();for(let M of a)l.push(M.cancel().catch((z)=>{h.push(z)}))}let x=()=>p(r(),"canceled");async function S(f,I,M){let z=[],te=0;try{while(!0){let{done:_,value:re}=await f.read();if(_){let j=Buffer.concat(z,te);return t.strictUtf8===!0?new TextDecoder("utf-8",{fatal:!0,ignoreBOM:!0}).decode(j):j.toString("utf8")}if(re.byteLength>I-te){let j=Error(`${t.label} ${M} exceeds byte limit`);throw p(j,`${M} exceeds byte limit`),j}te+=re.byteLength,z.push(re)}}catch(_){throw p(_,`${M} read failed`),_}}let mt=setTimeout(()=>p(Error(`${t.label} timed out`),"timed out"),t.timeoutMs),Ne=S(a[0],t.stdoutBytes,"stdout"),We=S(a[1],t.stderrBytes,"stderr");try{if(n?.addEventListener("abort",x,{once:!0}),n?.aborted)x();let[f,I,M]=await Promise.all([i.exited,Ne,We]);if(c)throw s;return{exitCode:f,stdout:I,stderr:M}}catch(f){throw p(f),s}finally{try{n?.removeEventListener("abort",x)}catch(f){h.push(f)}if(clearTimeout(mt),!m)w();if(i.exitCode===null)p(Error(`${t.label} interrupted`));await Promise.allSettled([i.exited,Ne,We,...l]);for(let f of a)try{f.releaseLock()}catch(I){h.push(I)}if(h.length)throw AggregateError(c?[s,...h]:h,`${t.label} ${c?`${C}; `:""}process cleanup failed`)}}import{writeSync as Wt}from"fs";import{format as Z}from"util";function Vr(...e){st(1,Z(...e))}function Jr(...e){st(2,Z(...e))}async function Qr(...e){await it(process.stdout,Z(...e))}async function Xr(...e){await it(process.stderr,Z(...e))}function it(e,t){return new Promise((n,r)=>{let o=(i)=>{e.off("error",o),r(i)};e.once("error",o);try{e.write(`${t}
|
|
8
8
|
`,"utf8",(i)=>{if(i)setImmediate(()=>e.off("error",o)),r(i);else e.off("error",o),n()})}catch(i){e.off("error",o),r(i)}})}function st(e,t){let n=Buffer.from(`${t}
|
|
9
|
-
`),r=0;while(r<n.length)r+=
|
|
10
|
-
`),
|
|
11
|
-
`)}function vn(e){if(!Number.isFinite(e.total)||e.total<=0)throw TypeError(`progress() needs a positive total; got ${e.total}`);let t=e.format??"|{bar}| {percentage}% | {value}/{total}",n=e.width??Math.max(10,Math.floor(er().columns/3)),r=tr(),o=0,i=-1,a=(s)=>{let c=Math.min(1,o/e.total),m=Math.round(c*n),C={bar:"\u2588".repeat(m)+"\u2591".repeat(n-m),percentage:Math.round(c*100),value:o,total:e.total,...s},
|
|
12
|
-
`)},get value(){return o},get total(){return e.total}};return l}async function Fn(e){let t=[];for(let n of e){let r=Date.now(),o=n.skip?.();if(o){console.log(`- ${n.title}${typeof o==="string"?` (${o})`:""}`),t.push({title:n.title,status:"skipped",durationMs:0});continue}try{await n.task(),console.log(`\u2713 ${n.title}`),t.push({title:n.title,status:"done",durationMs:Date.now()-r})}catch(i){throw console.log(`\u2717 ${n.title}`),t.push({title:n.title,status:"failed",error:i instanceof Error?i:Error(String(i)),durationMs:Date.now()-r}),i}}return t}export{ar as CLI,Q as align,Je as ansi256,Qe as ansi256Bg,xt as applyAliases,ye as bgBlack,ke as bgBlue,
|
|
9
|
+
`),r=0;while(r<n.length)r+=Wt(e,n,r,n.length-r)}import v from"process";import{createInterface as Yt}from"readline";var rn=v.stdin.destroy;v.stdin.destroy=function(e){if(e)this.emit("error",e);return this};var W=null;function Dt(){if(!W){let e=v.stdin.isTTY&&v.stdout.isTTY;W=Yt({input:v.stdin,output:v.stdout,terminal:e}),W.once("close",()=>{W=null})}return W}var ee=Symbol("stdin-eof");function at(e){return new Promise((t)=>{let n=Dt(),r=!1,o=(l)=>{if(r)return;r=!0,n.off("close",i),n.off("SIGINT",a),t(l)},i=()=>o(ee),a=()=>{console.log(`
|
|
10
|
+
`),v.exit(130)};n.once("close",i),n.once("SIGINT",a);try{n.question(e,o)}catch{o(ee)}})}function lt(){if(v.argv.includes("--no-interaction"))return!1;if(v.env.CI)return!1;return Boolean(v.stdin.isTTY&&v.stdout.isTTY)}async function Y(e){if(!lt())return"";let t=await at(e);return t===ee?"":t}function ct(e,t){let n=e.toLowerCase().trim();if(!n)return t;if(n==="y"||n==="yes")return!0;if(n==="n"||n==="no")return!1;return t}async function nn(e){let t=typeof e==="string"?{message:e}:e,n=t.initial??!1,r=n?" (Y/n) ":" (y/N) ";if(!lt())return null;let o=await at(`${t.message}${r}`);if(o===ee)return null;return ct(o,n)}async function zt(e){let t=typeof e==="string"?{message:e}:e,n=t.initial??!1,r=n?" (Y/n) ":" (y/N) ",o=await Y(`${t.message}${r}`);return ct(o,n)}async function _t(e){let t=typeof e==="string"?{message:e}:e,n=t.placeholder||t.initial||"",r=n?` (${n}) `:" ";return(await Y(`${t.message}${r}`)).trim()||t.initial||""}async function qt(e){console.log(e.message),e.choices.forEach((o,i)=>{let a=i===(e.initial??0)?">":" ";console.log(`${a} ${i+1}. ${o.label}`)});let t=await Y("Select (number): "),n=Number.parseInt(t.trim(),10)-1,r=e.choices[n]??e.choices[e.initial??0];if(!r)throw Error("select prompt: no choices available");return r.value}async function Kt(e){console.log(e.message),console.log("(Enter numbers separated by commas)"),e.choices.forEach((o,i)=>{console.log(` ${i+1}. ${o.label}`)});let n=(await Y("Select (e.g., 1,3,4): ")).split(",").map((o)=>Number.parseInt(o.trim(),10)-1),r=[];for(let o of n){let i=e.choices[o];if(i)r.push(i.value)}return r}async function Ut(e){return(await Y(`${(typeof e==="string"?{message:e}:e).message} `)).trim()}var on={text:_t,confirm:zt,select:qt,multiselect:Kt,password:Ut};import{handleError as Ht}from"@stacksjs/error-handling";async function Vt(e,t){let n={...t,stdin:t?.stdin??"inherit",verbose:t?.verbose??!1};return await ie(e,n)}async function cn(e,t){let n={...t,stdio:[t?.stdin??"inherit","pipe","pipe"],verbose:t?.verbose??!1};return await ie(e,n)}async function un(e,t){let n={...t,stdio:[t?.stdin??"inherit","pipe","pipe"],verbose:t?.verbose??!1};return await qe(e,n)}async function gn(e,t){let n=[];for(let r of e){let o=await Vt(r,t);if(o.isErr)throw Ht("Error during runCommands",o.error),o.error;n.push(o)}return n}import Jt from"process";var Qt=["SIGINT","SIGTERM","SIGHUP"],A=new Map,ut=!1;function Xt(){if(ut)return;ut=!0;for(let e of Qt)Jt.on(e,async()=>{for(let[t,n]of A)try{await n()}catch(r){console.error(`[signals] cleanup '${t}' threw:`,r)}})}function fn(e,t){return Xt(),A.set(e,t),()=>{if(A.get(e)===t)A.delete(e)}}function pn(e){A.delete(e)}function hn(){return[...A.keys()]}var gt=["\u280B","\u2819","\u2839","\u2838","\u283C","\u2834","\u2826","\u2827","\u2807","\u280F"],D=process.stdout.isTTY&&!process.env.CI;function Zt(e){let t=e||"",n=0,r=null,o=!1,i=()=>{if(D)process.stdout.write("\r\x1B[K")},a=()=>{if(!D)return;i();let l=gt[n];process.stdout.write(`${l} ${t}`),n=(n+1)%gt.length};return{start(l){if(l)t=l;if(o)return;if(o=!0,D)a(),r=setInterval(a,80);else if(t)console.log(` ${t}`)},stop(l){if(o=!1,r)clearInterval(r),r=null;if(i(),l)console.log(l)},update(l){if(t=l,!D&&o)console.log(` ${l}`)},succeed(l){let s=l||t;if(o=!1,r)clearInterval(r),r=null;i(),console.log(`\u2713 ${s}`)},fail(l){let s=l||t;if(o=!1,r)clearInterval(r),r=null;i(),console.error(`\u2717 ${s}`)},get text(){return t},set text(l){if(t=l,D&&o)a()},get isSpinning(){return o}}}async function yn(e,t,n){let r=Zt(e);r.start();try{let o=await t();return r.succeed(n?.successMessage||e),o}catch(o){throw r.fail(n?.failMessage||`Failed: ${e}`),o}}import T from"process";var dt="\r\x1B[2K";function er(){return{columns:T.stdout.columns??80,rows:T.stdout.rows??24}}function tr(){return Boolean(T.stdout.isTTY)&&!T.env.CI}function kn(e,t){console.log(rt(e,t===void 0?{}:{title:t}))}function $n(e,t={}){let r=(t.columns??[...new Set(e.flatMap((s)=>Object.keys(s)))]).map((s)=>typeof s==="string"?{key:s}:s);if(r.length===0)return"";let o=(s,c)=>{let m=s[c.key];return m===void 0||m===null?"":String(m)},i=r.map((s)=>{let c=t.header===!1?"":s.header??s.key;return Math.max(E(c).length,...e.map((m)=>E(o(m,s)).length))}),a=(s,c,m)=>{let C=Math.max(0,c-E(s).length);return m==="right"?" ".repeat(C)+s:s+" ".repeat(C)},l=[];if(t.header!==!1)l.push(r.map((s,c)=>a(s.header??s.key,i[c],s.align)).join(" ").trimEnd()),l.push(r.map((s,c)=>"-".repeat(i[c])).join(" "));for(let s of e)l.push(r.map((c,m)=>a(o(s,c),i[m],c.align)).join(" ").trimEnd());return l.join(`
|
|
11
|
+
`)}function vn(e){if(!Number.isFinite(e.total)||e.total<=0)throw TypeError(`progress() needs a positive total; got ${e.total}`);let t=e.format??"|{bar}| {percentage}% | {value}/{total}",n=e.width??Math.max(10,Math.floor(er().columns/3)),r=tr(),o=0,i=-1,a=(s)=>{let c=Math.min(1,o/e.total),m=Math.round(c*n),C={bar:"\u2588".repeat(m)+"\u2591".repeat(n-m),percentage:Math.round(c*100),value:o,total:e.total,...s},h=t.replace(/\{(\w+)\}/g,(w,p)=>String(C[p]??w));if(r){T.stdout.write(`${dt}${h}`);return}let y=Math.floor(c*10);if(y>i)i=y,console.log(h)},l={update(s,c={}){o=Math.max(0,Math.min(e.total,s)),a(c)},increment(s=1){l.update(o+s)},stop(s){if(r)T.stdout.write(dt);if(s)console.log(s);else if(r)T.stdout.write(`
|
|
12
|
+
`)},get value(){return o},get total(){return e.total}};return l}async function Fn(e){let t=[];for(let n of e){let r=Date.now(),o=n.skip?.();if(o){console.log(`- ${n.title}${typeof o==="string"?` (${o})`:""}`),t.push({title:n.title,status:"skipped",durationMs:0});continue}try{await n.task(),console.log(`\u2713 ${n.title}`),t.push({title:n.title,status:"done",durationMs:Date.now()-r})}catch(i){throw console.log(`\u2717 ${n.title}`),t.push({title:n.title,status:"failed",error:i instanceof Error?i:Error(String(i)),durationMs:Date.now()-r}),i}}return t}export{ar as CLI,Q as align,Je as ansi256,Qe as ansi256Bg,xt as applyAliases,ye as bgBlack,ke as bgBlue,N as bgCyan,Fe as bgGray,xe as bgGreen,Le as bgLightBlue,Ie as bgLightCyan,H as bgLightGray,Be as bgLightGreen,Re as bgLightMagenta,Se as bgLightRed,Oe as bgLightYellow,$e as bgMagenta,Ce as bgRed,ve as bgWhite,we as bgYellow,se as black,ce as blue,F as bold,rt as box,jt as buddyOptionArgs,Nt as buddyOptions,Or as centerAlign,cr as cli,$r as colorize,vr as colors,zt as confirm,nn as confirmOrNull,G as cyan,fr as defineCommand,pr as defineCommands,R as dim,yt as discoverCommandFiles,ie as exec,qe as execSync,tt as getColor,er as getTerminalSize,L as gray,P as green,Te as hidden,nr as installPackage,or as installStack,Ar as intro,Ee as inverse,tr as isInteractive,k as italic,Fr as kolorist,Sr as leftAlign,pe as lightBlue,be as lightCyan,U as lightGray,me as lightGreen,he as lightMagenta,de as lightRed,fe as lightYellow,et as link,hn as listSignalHandlers,_e as loadCommandRegistry,mr as loadCommands,b as log,ue as magenta,Kt as multiselect,kn as note,pn as offSignal,fn as onSignal,lr as onUnknownSubcommand,jr as outro,Dr as parseArgs,At as parseArgv,zr as parseOptions,Ut as password,Vr as print,Qr as printAsync,Jr as printError,Xr as printErrorAsync,vn as progress,on as prompts,lt as promptsAreInteractive,Lr as quotes,ae as red,Ge as reset,Ct as resolveCommands,Br as rightAlign,qr as runBoundedProcess,Vt as runCommand,un as runCommandSync,gn as runCommands,cn as runProcess,qt as select,Zt as spinner,Pe as strikethrough,E as stripAnsi,He as stripColors,$n as table,Fn as tasks,_t as text,Xe as trueColor,Ze as trueColorBg,Me as underline,ge as white,yn as withSpinner,le as yellow};
|
package/package.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "@stacksjs/cli",
|
|
3
3
|
"type": "module",
|
|
4
4
|
"sideEffects": false,
|
|
5
|
-
"version": "0.75.
|
|
5
|
+
"version": "0.75.345",
|
|
6
6
|
"description": "TypeScript framework for CLI artisans. Build beautiful console apps with ease.",
|
|
7
7
|
"author": "Chris Breuer",
|
|
8
8
|
"contributors": [
|
|
@@ -70,16 +70,16 @@
|
|
|
70
70
|
},
|
|
71
71
|
"dependencies": {
|
|
72
72
|
"@stacksjs/clapp": "^0.2.12",
|
|
73
|
-
"@stacksjs/collections": "0.75.
|
|
74
|
-
"@stacksjs/error-handling": "0.75.
|
|
75
|
-
"@stacksjs/logging": "0.75.
|
|
76
|
-
"@stacksjs/types": "0.75.
|
|
73
|
+
"@stacksjs/collections": "0.75.345",
|
|
74
|
+
"@stacksjs/error-handling": "0.75.345",
|
|
75
|
+
"@stacksjs/logging": "0.75.345",
|
|
76
|
+
"@stacksjs/types": "0.75.345"
|
|
77
77
|
},
|
|
78
78
|
"devDependencies": {
|
|
79
|
-
"@stacksjs/config": "0.75.
|
|
80
|
-
"@stacksjs/path": "0.75.
|
|
81
|
-
"@stacksjs/utils": "0.75.
|
|
82
|
-
"@stacksjs/validation": "0.75.
|
|
79
|
+
"@stacksjs/config": "0.75.345",
|
|
80
|
+
"@stacksjs/path": "0.75.345",
|
|
81
|
+
"@stacksjs/utils": "0.75.345",
|
|
82
|
+
"@stacksjs/validation": "0.75.345",
|
|
83
83
|
"better-dx": "^0.2.24"
|
|
84
84
|
}
|
|
85
85
|
}
|