bob-core 1.2.4 → 1.3.1

package/dist/bob-core.cjs

@@ -1,8 +1,9 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const O=require("minimist"),a=require("chalk"),R=require("node:fs"),C=require("path"),A=require("string-similarity");function S(r){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(r){for(const t in r)if(t!=="default"){const n=Object.getOwnPropertyDescriptor(r,t);Object.defineProperty(e,t,n.get?n:{enumerable:!0,get:()=>r[t]})}}return e.default=r,Object.freeze(e)}const V=S(R),x=S(A);class c extends Error{}class $ extends c{constructor(e){super(`Argument "${e.name}" is required.`),this.paramSignature=e}pretty(){const e=console.log;this.paramSignature.help&&e(a`{yellow Help}: ${this.paramSignature.help}\n`),e(a`  {white.bgRed  ERROR } Argument {bold.yellow ${this.paramSignature.name}} is required.`)}}class f extends c{constructor(e,t){super(`Missing ${e} in the command signature`),this.option=e,this.optionsSignature=t}pretty(){const e=console.log;if(this.optionsSignature.length){e(a`{yellow Available options}:`);for(const t of this.optionsSignature){const n=t.type?a`{white (${t.type})}`:"",i=" ".repeat(20-t.name.length);e(a`  {green ${t.name}} ${i} ${t.help??"\b"} ${n}`)}e("")}e(a`  {white.bgRed  ERROR } Option {bold.yellow ${this.option}} is missing in the signature.`)}}class y extends c{constructor(e,t){super(`Missing ${e} in the command signature`),this.argument=e,this.argumentSignatures=t}pretty(){const e=console.log;if(this.argumentSignatures.length){e(a`\n{yellow Available arguments}:`);for(const t of this.argumentSignatures){const n=t.type?a`{white (${t.type})}`:"",i=" ".repeat(20-t.name.length);e(a`  {green ${t.name}} ${i} ${t.help??"\b"} ${n}`)}e("")}e(a`  {white.bgRed  ERROR } Argument {bold.yellow ${this.argument}} is missing in the signature.`)}}class E extends c{constructor(e,t){super(`Invalid option ${e} in not recognized`),this.option=e,this.optionsSignature=t}pretty(){const e=console.log;if(this.optionsSignature.length>0){e(a`\n{yellow Available options}:`);for(const t of this.optionsSignature){const n=t.type?a`{white (${t.type})}`:"",i=`--${t.name}${t.alias?.map(l=>`, -${l}`).join("")??""}`,o=" ".repeat(30-i.length);e(a`  {green ${i}} ${o} ${t.help??"\b"} ${n}`)}e("")}e(a`  {white.bgRed  ERROR } Option {bold.yellow ${this.option}} is not recognized.`)}}class j{constructor(e,t,n,...i){this.signature=e,this.helperDefinitions=t,this.defaultCommandOptions=n;const[o,...l]=e.split(/\{(.*?)\}/g).map(m=>m.trim()).filter(Boolean),{_:p,...s}=O(i);this.command=o,this.parseSignature(l),this.parseDefaultOptions(),this.handleArguments(p),this.handleOptions(s)}command;arguments={};options={};argumentsSignature={};optionSignatures={};optionAliases={};option(e){if(!this.optionSignatures[e])throw new f(e,Object.values(this.optionSignatures));return this.options[e]}setOption(e,t){if(!this.optionSignatures[e])throw new f(e,Object.values(this.optionSignatures));this.options[e]=t}optionHelp(e){if(!this.optionSignatures[e])throw new f(e,Object.values(this.optionSignatures));return this.optionSignatures[e].help}argument(e){if(!this.argumentsSignature[e])throw new y(e,Object.values(this.argumentsSignature));return this.arguments[e]}setArgument(e,t){if(!this.argumentsSignature[e])throw new y(e,Object.values(this.argumentsSignature));this.arguments[e]=t}argumentHelp(e){if(!this.argumentsSignature[e])throw new y(e,Object.values(this.argumentsSignature));return this.argumentsSignature[e].help}getArgumentSignatures(){return this.argumentsSignature}getOptionSignatures(){return this.optionSignatures}getParamValue(e,t){return t.type==="boolean"?e==="true"||e==="1"?!0:e==="false"||e==="0"?!1:!!e:t.type==="array"?e?Array.isArray(e)?e:[e]:[]:e??t.defaultValue}handleArguments(e){for(const[t,n]of Object.entries(this.arguments)){const i=this.argumentsSignature[t];if(i.variadic)this.arguments[t]=e;else{const o=e.shift();this.arguments[t]=this.getParamValue(o,i)}}}handleOptions(e){for(const[t,n]of Object.entries(e)){const i=this.optionAliases[t],o=this.optionSignatures[t]??this.optionSignatures[i];if(!o)throw new E(t,Object.values(this.optionSignatures));this.options[t]=this.getParamValue(n,o);for(const l of o.alias??[])e[l]&&(this.options[o.name]=e[l])}}parseSignature(e){for(const t of e){const n=this.parseParamSignature(t);if(n.isOption){this.options[n.name]=n.defaultValue??null,this.optionSignatures[n.name]=n;for(const i of n.alias??[])this.optionAliases[i]=n.name}else this.arguments[n.name]=n.defaultValue??null,this.argumentsSignature[n.name]=n}}parseDefaultOptions(){if(this.defaultCommandOptions.length){for(const e of this.defaultCommandOptions)if(this.optionSignatures[e.option]={name:e.option,type:e.defaultValue==null?"string":typeof e.defaultValue,optional:!0,alias:e.alias,variadic:!1,help:e.description,defaultValue:e.defaultValue??null,isOption:!0},this.options[e.option]=e.defaultValue,e.alias)for(const t of e.alias)this.optionAliases[t]=e.option}}parseParamSignature(e){const t={name:e,optional:!1,type:"string",help:void 0,defaultValue:null,variadic:!1,isOption:!1};if(t.name.includes(":")){const[n,i]=t.name.split(":");t.name=n.trim(),t.help=i.trim()}if(t.name.includes("=")){const[n,i]=t.name.split("=");t.name=n.trim(),t.defaultValue=i.trim(),t.optional=!0,t.defaultValue.length?t.defaultValue==="true"?(t.defaultValue=!0,t.type="boolean"):t.defaultValue==="false"&&(t.defaultValue=!1,t.type="boolean"):t.defaultValue=null}else t.name.startsWith("--")&&(t.optional=!0,t.defaultValue=!1,t.type="boolean");if(t.name.includes("|")){const[n,...i]=t.name.split("|");t.name=n.trim(),t.alias=i.map(o=>o.trim())}return t.name.startsWith("--")&&(t.isOption=!0,t.name=t.name.slice(2)),t.defaultValue==="*"&&(t.defaultValue=[],t.type="array"),t.name.endsWith("?")&&(t.optional=!0,t.name=t.name.slice(0,-1)),t.name.endsWith("*")&&(t.type="array",t.variadic=!0,t.defaultValue=[],t.name=t.name.slice(0,-1)),t.help=t.help??this.helperDefinitions[t.name]??this.helperDefinitions[`--${t.name}`],t}validate(){for(const[e,t]of Object.entries(this.arguments)){const n=this.argumentsSignature[e];if(!t&&!n.optional)throw new $(n);if(!t?.length&&n.variadic&&!n.optional)throw new $(n)}}}function w(r){return new Array(r+5).join(" ")}class b{option="help";alias=["h"];defaultValue=!1;description=a`Display help for the given command. When no command is given display help for the {green list} command`;async handler(){const e=console.log,t=Object.values(this.parser.getArgumentSignatures()),n=Object.values(this.parser.getOptionSignatures()).map(s=>({...s,optionWithAlias:`--${s.name}${s.alias?.map(m=>`, -${m}`).join("")??""}`})),i=t.filter(s=>!s.optional);e(a`{yellow Description}:`),e(a`  ${this.description}\n`),e(a`{yellow Usage}:`),e(a`  ${this.command} ${i.length>0?i.map(s=>`<${s.name}>`).join(" "):"\b"} [options]`);const o=Math.max(...n.map(s=>s.optionWithAlias.length))??0,l=Math.max(...t.map(s=>s.name.length))??0,p=l>o?l:o;if(t.length>0){e(a`\n{yellow Arguments}:`);for(const s of t){const m=w(p-s.name.length);let u=a`  {green ${s.name}} ${m} ${s.help??"\b"}`;if(s.defaultValue!==void 0&&s.optional){const h=s.type==="array"?JSON.stringify(s.defaultValue):s.defaultValue;u+=a` {yellow [default: ${h}]}`}s.variadic&&(u+=a` {white (variadic)}`),e(u)}}if(n.length>0){e(a`\n{yellow Options}:`);for(const s of n){const m=w(p-s.optionWithAlias.length);let u=a`{green ${s.optionWithAlias}} ${m} ${s.help??"\b"}`;if(s.type&&(u+=a` {white (${s.type})}`),s.defaultValue!==void 0&&s.optional){const h=s.type==="array"?JSON.stringify(s.defaultValue):s.defaultValue;u+=a` {yellow [default: ${h}]}`}e(u)}}if(this.commandsExamples.length>0){e(a`\n{yellow Examples}:`);let s=process.argv[0].split("/").pop();s==="node"&&(s+=" "+process.argv[1].split("/").pop());for(const[m,u]of this.commandsExamples.entries())m>0&&e(""),e(`  ${u.description}
-`),e(a`    {green ${s} ${u.command}}`)}return-1}}class v{ctx;helperDefinitions={};commandsExamples=[];parser;get CommandParserClass(){return j}defaultOptions(){return[new b]}get command(){return this.parser?this.parser.command:this.signature.split(" ")[0]}async run(e,...t){this.ctx=e;const n=this.defaultOptions();this.parser=new this.CommandParserClass(this.signature,this.helperDefinitions,n,...t);for(const i of n)if(this.parser.option(i.option)){const o=await i.handler.call(this);if(o&&o!==0)return o}return this.parser.validate(),await this.handle()??0}setOption(e,t){this.parser.setOption(e,t)}setArgument(e,t){this.parser.setArgument(e,t)}option(e,t=null){return this.parser.option(e)??t}optionBoolean(e,t=!1){return this.parser.option(e)??t}optionArray(e,t=[]){const n=this.parser.option(e);if(!Array.isArray(n))throw new Error(`Option ${e} is not an array`);return n.length?n:t}optionNumber(e,t=null){const n=this.parser.option(e);return n?typeof n=="number"?n:parseInt(n):t}argument(e,t=null){return this.parser.argument(e)??t}argumentArray(e,t=[]){const n=this.parser.argument(e);if(!Array.isArray(n))throw new Error(`Argument ${e} is not an array`);return n?.length?n:t}argumentBoolean(e,t=!1){return this.parser.argument(e)??t}argumentNumber(e,t=null){const n=this.parser.argument(e);return n?typeof n=="number"?n:parseInt(n):t}}class P extends c{constructor(e,t){super(`Command "${e}" not found.`),this.command=e,this.similarCommands=t}pretty(){const e=console.log;if(this.similarCommands.length){e(a`  {white.bgRed  ERROR } Command "${this.command}" not found, Did you mean one of these?`);for(const t of this.similarCommands)e(a`  {gray ⇂ ${t}}`)}else e(a`  {white.bgRed  ERROR } Command "${this.command}" not found.`)}}class H{commands={};get commandSuffix(){return"Command"}constructor(){}getAvailableCommands(){return Object.keys(this.commands)}getCommands(){return Object.values(this.commands)}commandResolver=async e=>{const t=(await import(e)).default;let n;return t?.default?n=new t.default:n=new t,n};setCommandResolver(e){this.commandResolver=e}registerCommand(e,t=!1){const n=e.signature.split(" ")[0];if(!n)throw new Error("Command signature is invalid, it must have a command name.");if(!t&&this.commands[n])throw new Error(`Command ${n} already registered.`);this.commands[n]=e}async loadCommandsPath(e){for await(const t of this.listCommandsFiles(e))try{const n=await this.commandResolver(t);this.registerCommand(n)}catch(n){throw new Error(`Command ${t} failed to load. ${n}`)}}async runCommand(e,t,...n){const i=typeof t=="string"?this.commands[t]:t,o=typeof t=="string"?t:i.command;if(!i){const l=await this.suggestCommand(o);return l?await this.runCommand(e,l,...n):1}return await i.run(e,...n)}async suggestCommand(e){const t=this.getAvailableCommands(),{bestMatch:n,bestMatchIndex:i,ratings:o}=x.findBestMatch(e,t),l=o.filter(p=>p.rating>.3).map(p=>p.target);if(n.rating>0&&l.length<=1||n.rating>.7&&l.length>1){const p=t[i];return await this.askRunSimilarCommand(e,p)?p:null}throw new P(e,l)}async askRunSimilarCommand(e,t){const n=require("readline").createInterface({input:process.stdin,output:process.stdout});return console.log(a`  {bgRed  ERROR } Command {yellow ${e}} not found.\n`),new Promise(i=>{n.question(a`{green Do you want to run {yellow ${t}} instead?} {white (yes/no)} [{yellow no}]\n > `,o=>{i(o==="yes"||o==="y"),n.close()})})}async*listCommandsFiles(e){const t=V.readdirSync(e,{withFileTypes:!0});for(const n of t){const i=C.resolve(e,n.name);if(n.isDirectory())yield*this.listCommandsFiles(C.resolve(e,n.name));else{if(!i.endsWith(`${this.commandSuffix}.ts`)&&!i.endsWith(`${this.commandSuffix}.js`))continue;yield i}}}}class B extends v{constructor(e){super(),this.opts=e}signature="help";description="Show help";async handle(){const e=this.opts.commandRegistry.getCommands(),t=this.opts.cliName??"Bob CLI",n=this.opts.cliVersion??"0.0.0",i=(await Promise.resolve().then(()=>require("./package-sv16L6xn.cjs")))?.default?.version??"0.0.0";console.log(a`${t} {green ${n}} (core: {yellow ${i}})
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const A=require("minimist"),o=require("chalk"),f=require("prompts"),x=require("node:fs"),$=require("path"),V=require("string-similarity");function b(l){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(l){for(const t in l)if(t!=="default"){const n=Object.getOwnPropertyDescriptor(l,t);Object.defineProperty(e,t,n.get?n:{enumerable:!0,get:()=>l[t]})}}return e.default=l,Object.freeze(e)}const E=b(x),j=b(V);class p extends Error{}class S extends p{constructor(e){super(`Argument "${e.name}" is required.`),this.paramSignature=e}pretty(){const e=console.log;e(o`{white.bgRed  ERROR } Argument {bold.yellow ${this.paramSignature.name}} is required.`)}}class y extends p{constructor(e,t){super(`Missing ${e} in the command signature`),this.option=e,this.optionsSignature=t}pretty(){const e=console.log;if(this.optionsSignature.length){e(o`{yellow Available options}:`);for(const t of this.optionsSignature){const n=t.type?o`{white (${t.type})}`:"",s=" ".repeat(20-t.name.length);e(o`  {green ${t.name}} ${s} ${t.help??"\b"} ${n}`)}e("")}e(o`{white.bgRed  ERROR } Option {bold.yellow ${this.option}} is missing in the signature.`)}}class w extends p{constructor(e,t){super(`Missing ${e} in the command signature`),this.argument=e,this.argumentSignatures=t}pretty(){const e=console.log;if(this.argumentSignatures.length){e(o`\n{yellow Available arguments}:`);for(const t of this.argumentSignatures){const n=t.type?o`{white (${t.type})}`:"",s=" ".repeat(20-t.name.length);e(o`  {green ${t.name}} ${s} ${t.help??"\b"} ${n}`)}e("")}e(o`{white.bgRed  ERROR } Argument {bold.yellow ${this.argument}} is missing in the signature.`)}}class k extends p{constructor(e,t){super(`Invalid option ${e} in not recognized`),this.option=e,this.optionsSignature=t}pretty(){const e=console.log;if(this.optionsSignature.length>0){e(o`\n{yellow Available options}:`);for(const t of this.optionsSignature){const n=t.type?o`{white (${t.type})}`:"",s=`--${t.name}${t.alias?.map(r=>`, -${r}`).join("")??""}`,i=" ".repeat(30-s.length);e(o`  {green ${s}} ${i} ${t.help??"\b"} ${n}`)}e("")}e(o`{white.bgRed  ERROR } Option {bold.yellow ${this.option}} is not recognized.`)}}class F{constructor(e,t,n,s,...i){this.io=e,this.signature=t,this.helperDefinitions=n,this.defaultCommandOptions=s;const[r,...u]=t.split(/\{(.*?)\}/g).map(c=>c.trim()).filter(Boolean),{_:a,...m}=A(i);this.command=r,this.parseSignature(u),this.parseDefaultOptions(),this.handleArguments(a),this.handleOptions(m)}command;arguments={};options={};argumentsSignature={};optionSignatures={};optionAliases={};option(e){if(!this.optionSignatures[e])throw new y(e,Object.values(this.optionSignatures));return this.options[e]}setOption(e,t){if(!this.optionSignatures[e])throw new y(e,Object.values(this.optionSignatures));this.options[e]=t}optionHelp(e){if(!this.optionSignatures[e])throw new y(e,Object.values(this.optionSignatures));return this.optionSignatures[e].help}argument(e){if(!this.argumentsSignature[e])throw new w(e,Object.values(this.argumentsSignature));return this.arguments[e]}setArgument(e,t){if(!this.argumentsSignature[e])throw new w(e,Object.values(this.argumentsSignature));this.arguments[e]=t}argumentHelp(e){if(!this.argumentsSignature[e])throw new w(e,Object.values(this.argumentsSignature));return this.argumentsSignature[e].help}getArgumentSignatures(){return this.argumentsSignature}getOptionSignatures(){return this.optionSignatures}getParamValue(e,t){return t.type==="boolean"?e==="true"||e==="1"?!0:e==="false"||e==="0"?!1:!!e:t.type==="array"?e?Array.isArray(e)?e:[e]:[]:e??t.defaultValue}handleArguments(e){for(const[t,n]of Object.entries(this.arguments)){const s=this.argumentsSignature[t];if(s.variadic)this.arguments[t]=e;else{const i=e.shift();this.arguments[t]=this.getParamValue(i,s)}}}handleOptions(e){for(const[t,n]of Object.entries(e)){const s=this.optionAliases[t],i=this.optionSignatures[t]??this.optionSignatures[s];if(!i)throw new k(t,Object.values(this.optionSignatures));this.options[t]=this.getParamValue(n,i);for(const r of i.alias??[])e[r]&&(this.options[i.name]=e[r])}}parseSignature(e){for(const t of e){const n=this.parseParamSignature(t);if(n.isOption){this.options[n.name]=n.defaultValue??null,this.optionSignatures[n.name]=n;for(const s of n.alias??[])this.optionAliases[s]=n.name}else this.arguments[n.name]=n.defaultValue??null,this.argumentsSignature[n.name]=n}}parseDefaultOptions(){if(this.defaultCommandOptions.length){for(const e of this.defaultCommandOptions)if(this.optionSignatures[e.option]={name:e.option,type:e.defaultValue==null?"string":typeof e.defaultValue=="boolean"?"boolean":Array.isArray(e.defaultValue)?"array":"string",optional:!0,alias:e.alias,variadic:!1,help:e.description,defaultValue:e.defaultValue??null,isOption:!0},this.options[e.option]=e.defaultValue,e.alias)for(const t of e.alias)this.optionAliases[t]=e.option}}parseParamSignature(e){const t={name:e,optional:!1,type:"string",help:void 0,defaultValue:null,variadic:!1,isOption:!1};if(t.name.includes(":")){const[n,s]=t.name.split(":");t.name=n.trim(),t.help=s.trim()}if(t.name.includes("=")){const[n,s]=t.name.split("=");t.name=n.trim(),t.defaultValue=s.trim(),t.optional=!0,t.defaultValue.length?t.defaultValue==="true"?(t.defaultValue=!0,t.type="boolean"):t.defaultValue==="false"&&(t.defaultValue=!1,t.type="boolean"):t.defaultValue=null}else t.name.startsWith("--")&&(t.optional=!0,t.defaultValue=!1,t.type="boolean");if(t.name.includes("|")){const[n,...s]=t.name.split("|");t.name=n.trim(),t.alias=s.map(i=>i.trim())}return t.name.startsWith("--")&&(t.isOption=!0,t.name=t.name.slice(2)),t.defaultValue==="*"&&(t.defaultValue=[],t.type="array"),t.name.endsWith("?")&&(t.optional=!0,t.name=t.name.slice(0,-1)),t.name.endsWith("*")&&(t.type="array",t.variadic=!0,t.defaultValue=[],t.name=t.name.slice(0,-1)),t.help=t.help??this.helperDefinitions[t.name]??this.helperDefinitions[`--${t.name}`],t}async validate(){for(const[e,t]of Object.entries(this.arguments)){const n=this.argumentsSignature[e];if(!t&&!n.optional){let s=null;switch(n.type){case"string":let i=o`{yellow.bold ${n.name}} is required`;n.help&&(i+=o`: {gray (${n.help})}`),i+=`
+`,s=await this.io.askForInput(i,n.defaultValue,{validate:r=>r?.trim()?.length?!0:`${n.name} cannot be empty`});break}if(s)this.setArgument(e,s);else throw new S(n)}if(!t?.length&&n.variadic&&!n.optional)throw new S(n)}}}function C(l){return new Array(l+5).join(" ")}class O{option="help";alias=["h"];defaultValue=!1;description=o`Display help for the given command. When no command is given display help for the {green list} command`;async handler(){const e=console.log,t=Object.values(this.parser.getArgumentSignatures()),n=Object.values(this.parser.getOptionSignatures()).map(a=>({...a,optionWithAlias:`--${a.name}${a.alias?.map(m=>`, -${m}`).join("")??""}`})),s=t.filter(a=>!a.optional);e(o`{yellow Description}:`),e(o`  ${this.description}\n`),e(o`{yellow Usage}:`),e(o`  ${this.command} ${s.length>0?s.map(a=>`<${a.name}>`).join(" "):"\b"} [options]`);const i=Math.max(...n.map(a=>a.optionWithAlias.length))??0,r=Math.max(...t.map(a=>a.name.length))??0,u=r>i?r:i;if(t.length>0){e(o`\n{yellow Arguments}:`);for(const a of t){const m=C(u-a.name.length);let c=o`  {green ${a.name}} ${m} ${a.help??"\b"}`;if(a.defaultValue!==void 0&&a.optional){const h=a.type==="array"?JSON.stringify(a.defaultValue):a.defaultValue;c+=o` {yellow [default: ${h}]}`}a.variadic&&(c+=o` {white (variadic)}`),e(c)}}if(n.length>0){e(o`\n{yellow Options}:`);for(const a of n){const m=C(u-a.optionWithAlias.length);let c=o`{green ${a.optionWithAlias}} ${m} ${a.help??"\b"}`;if(a.type&&(c+=o` {white (${a.type})}`),a.defaultValue!==void 0&&a.optional){const h=a.type==="array"?JSON.stringify(a.defaultValue):a.defaultValue;c+=o` {yellow [default: ${h}]}`}e(c)}}if(this.commandsExamples.length>0){e(o`\n{yellow Examples}:`);let a=process.argv[0].split("/").pop();a==="node"&&(a+=" "+process.argv[1].split("/").pop());for(const[m,c]of this.commandsExamples.entries())m>0&&e(""),e(`  ${c.description}
+`),e(o`    {green ${a} ${c.command}}`)}return-1}}class v{async askForConfirmation(e="Do you want to continue?",t){return(await f({type:"confirm",name:"value",message:e,initial:t??!1})).value}async askForInput(e,t,n){return(await f({type:"text",name:"value",message:e,initial:t,...n}))?.value??null}async askForToggle(e,t,n){return(await f({type:"toggle",name:"value",message:e,initial:t,...n}))?.value??null}async askForSelect(e,t,n){if(t.length===0)throw new Error("No options provided");const s=[];for(const r of t)typeof r=="string"?s.push({title:r,value:r}):s.push(r);return(await f({type:"select",name:"value",message:e,choices:s,...n}))?.value??null}newLoader(e="",t=["⠙","⠘","⠰","⠴","⠤","⠦","⠆","⠃","⠋","⠉"],n=100){let s=e,i=null,r=0;const u=setInterval(function(){i&&(process.stdout.write(new TextEncoder().encode("\r"+" ".repeat(i.length+5)+"\r")),i=null),process.stdout.write(new TextEncoder().encode("\r"+t[r++]+" "+s)),r=r%t.length},n),a=()=>{clearInterval(u),process.stdout.write(new TextEncoder().encode("\r"+" ".repeat(s.length+5)+"\r"))};return{[Symbol.dispose]:a,[Symbol.asyncDispose]:a,updateText:m=>{i=s,s=m},stop:a}}}class R{ctx;helperDefinitions={};commandsExamples=[];parser;io;get CommandParserClass(){return F}get CommandIOClass(){return v}defaultOptions(){return[new O]}get command(){return this.parser?this.parser.command:this.signature.split(" ")[0]}async run(e,...t){this.ctx=e;const n=this.defaultOptions();this.io=new this.CommandIOClass,this.parser=new this.CommandParserClass(this.io,this.signature,this.helperDefinitions,n,...t);for(const s of n)if(this.parser.option(s.option)){const i=await s.handler.call(this);if(i&&i!==0)return i}return await this.parser.validate(),await this.handle()??0}setOption(e,t){this.parser.setOption(e,t)}setArgument(e,t){this.parser.setArgument(e,t)}option(e,t=null){return this.parser.option(e)??t}optionBoolean(e,t=!1){return this.parser.option(e)??t}optionArray(e,t=[]){const n=this.parser.option(e);if(!Array.isArray(n))throw new Error(`Option ${e} is not an array`);return n.length?n:t}optionNumber(e,t=null){const n=this.parser.option(e);return n?typeof n=="number"?n:parseInt(n):t}argument(e,t=null){return this.parser.argument(e)??t}argumentArray(e,t=[]){const n=this.parser.argument(e);if(!Array.isArray(n))throw new Error(`Argument ${e} is not an array`);return n?.length?n:t}argumentBoolean(e,t=!1){return this.parser.argument(e)??t}argumentNumber(e,t=null){const n=this.parser.argument(e);return n?typeof n=="number"?n:parseInt(n):t}async askForConfirmation(...e){return this.io.askForConfirmation(...e)}async askForInput(...e){return this.io.askForInput(...e)}async askForSelect(...e){return this.io.askForSelect(...e)}newLoader(...e){return this.io.newLoader(...e)}}class I extends p{constructor(e){super(`Command "${e}" not found.`),this.command=e}pretty(){const e=console.log;e(o`{bgRed  ERROR } Command {yellow ${this.command}} not found.`)}}class D{commands={};io;get commandSuffix(){return"Command"}get CommandIOClass(){return v}constructor(){this.io=new this.CommandIOClass}getAvailableCommands(){return Object.keys(this.commands)}getCommands(){return Object.values(this.commands)}commandResolver=async e=>{const t=(await import(e)).default;let n;return t?.default?n=new t.default:n=new t,n};setCommandResolver(e){this.commandResolver=e}registerCommand(e,t=!1){const n=e.signature.split(" ")[0];if(!n)throw new Error("Command signature is invalid, it must have a command name.");if(!t&&this.commands[n])throw new Error(`Command ${n} already registered.`);this.commands[n]=e}async loadCommandsPath(e){for await(const t of this.listCommandsFiles(e))try{const n=await this.commandResolver(t);this.registerCommand(n)}catch(n){throw new Error(`Command ${t} failed to load. ${n}`)}}async runCommand(e,t,...n){const s=typeof t=="string"?this.commands[t]:t,i=typeof t=="string"?t:s.command;if(!s){const r=await this.suggestCommand(i);return r?await this.runCommand(e,r,...n):1}return await s.run(e,...n)}async suggestCommand(e){const t=this.getAvailableCommands(),{bestMatch:n,bestMatchIndex:s,ratings:i}=j.findBestMatch(e,t),r=i.filter(u=>u.rating>.3).map(u=>u.target);if(n.rating>0&&r.length<=1||n.rating>.7&&r.length>1){const u=t[s];return await this.askRunSimilarCommand(e,u)?u:null}if(r.length){console.log(o`{bgRed  ERROR } Command {yellow ${e}} not found.\n`);const u=await this.io.askForSelect(o`{green Did you mean to run one of these commands instead?}`,r);if(u)return u}throw new I(e)}async askRunSimilarCommand(e,t){return console.log(o`{bgRed  ERROR } Command {yellow ${e}} not found.\n`),this.io.askForConfirmation(o`{green Do you want to run {yellow ${t}} instead?} `)}async*listCommandsFiles(e){const t=E.readdirSync(e,{withFileTypes:!0});for(const n of t){const s=$.resolve(e,n.name);if(n.isDirectory())yield*this.listCommandsFiles($.resolve(e,n.name));else{if(!s.endsWith(`${this.commandSuffix}.ts`)&&!s.endsWith(`${this.commandSuffix}.js`))continue;yield s}}}}class P extends R{constructor(e){super(),this.opts=e}signature="help";description="Show help";async handle(){const e=this.opts.commandRegistry.getCommands(),t=this.opts.cliName??"Bob CLI",n=this.opts.cliVersion??"0.0.0",s=(await Promise.resolve().then(()=>require("./package-D1l4pNru.cjs")))?.default?.version??"0.0.0";console.log(o`${t} {green ${n}} (core: {yellow ${s}})
 
 {yellow Usage}:
   command [options] [arguments]
 
 {yellow Available commands}:
-`);const o=Math.max(...e.map(s=>s.command.length))??0,l={};for(const s of e){const m=s.command.split(":")[0];l[m]||(l[m]=[]),l[m].push(s)}const p=Object.entries(l).sort(([s],[m])=>s.toLowerCase().localeCompare(m.toLowerCase())).sort(([,s],[,m])=>s.length-m.length);for(const[s,m]of p){const u=m.length>1;u&&console.log(a`{yellow ${s}}:`);const h=m.sort((d,g)=>d.command.toLowerCase().localeCompare(g.command.toLowerCase()));for(const d of h){let g=w(o-d.command.length);u&&(g=g.slice(2)),console.log(a`${u?"  ":""}{green ${d.command}} ${g} ${d.description}`)}}}}class D extends c{constructor(e){let t=`Argument "${e.param}" value is invalid.`;e.reason?t+=` Reason: ${e.reason}`:t+=` Value: "${e.value}"`,super(t),this.param=e}pretty(){const e=console.log;e(a`  {white.bgRed  ERROR } Argument {bold.yellow ${this.param.param}} value is invalid. `),(this.param.value||this.param.reason)&&e(""),this.param.value&&e(a`  {blue Value}: ${this.param.value}`),this.param.reason&&e(a`  {yellow Reason}: ${this.param.reason}`)}}class M extends c{constructor(e){let t=`Option "${e.option}" value is invalid.`;e.reason?t+=` Reason: ${e.reason}`:t+=` Value: "${e.value}"`,super(t),this.param=e}pretty(){const e=console.log;e(a`  {white.bgRed  ERROR } Option {bold.yellow ${this.param.option}} value is invalid. `),(this.param.value||this.param.reason)&&e(""),this.param.value&&e(a`  {blue Value}: ${this.param.value}`),this.param.reason&&e(a`  {yellow Reason}: ${this.param.reason}`)}}class q{handle(e){if(e instanceof c)return e.pretty(),-1;throw e}}class W{commandRegistry;exceptionHandler;ctx;helpCommand;get CommandRegistryClass(){return H}get HelpCommandClass(){return B}get ExceptionHandlerClass(){return q}constructor(e={}){this.ctx=e.ctx,this.commandRegistry=new this.CommandRegistryClass,this.exceptionHandler=new this.ExceptionHandlerClass,this.helpCommand=new this.HelpCommandClass({cliName:e.name,cliVersion:e.version,commandRegistry:this.commandRegistry})}setCommandResolver(e){this.commandRegistry.setCommandResolver(e)}async withCommands(...e){for(const t of e)typeof t=="string"?await this.commandRegistry.loadCommandsPath(t):typeof t=="function"?this.registerCommand(new t):this.registerCommand(t)}async runCommand(e,...t){return e?await this.commandRegistry.runCommand(this.ctx,e,...t).catch(this.exceptionHandler.handle):await this.runHelpCommand()}async runHelpCommand(){return await this.runCommand(this.helpCommand)}registerCommand(e){this.commandRegistry.registerCommand(e)}}exports.BadCommandOption=M;exports.BadCommandParameter=D;exports.BobError=c;exports.Cli=W;exports.Command=v;exports.HelpOption=b;
+`);const i=Math.max(...e.map(a=>a.command.length))??0,r={};for(const a of e){const m=a.command.split(":")[0];r[m]||(r[m]=[]),r[m].push(a)}const u=Object.entries(r).sort(([a],[m])=>a.toLowerCase().localeCompare(m.toLowerCase())).sort(([,a],[,m])=>a.length-m.length);for(const[a,m]of u){const c=m.length>1;c&&console.log(o`{yellow ${a}}:`);const h=m.sort((d,g)=>d.command.toLowerCase().localeCompare(g.command.toLowerCase()));for(const d of h){let g=C(i-d.command.length);c&&(g=g.slice(2)),console.log(o`${c?"  ":""}{green ${d.command}} ${g} ${d.description}`)}}}}class B extends p{constructor(e){let t=`Argument "${e.param}" value is invalid.`;e.reason?t+=` Reason: ${e.reason}`:t+=` Value: "${e.value}"`,super(t),this.param=e}pretty(){const e=console.log;e(o`  {white.bgRed  ERROR } Argument {bold.yellow ${this.param.param}} value is invalid. `),(this.param.value||this.param.reason)&&e(""),this.param.value&&e(o`  {blue Value}: ${this.param.value}`),this.param.reason&&e(o`  {yellow Reason}: ${this.param.reason}`)}}class H extends p{constructor(e){let t=`Option "${e.option}" value is invalid.`;e.reason?t+=` Reason: ${e.reason}`:t+=` Value: "${e.value}"`,super(t),this.param=e}pretty(){const e=console.log;e(o`  {white.bgRed  ERROR } Option {bold.yellow ${this.param.option}} value is invalid. `),(this.param.value||this.param.reason)&&e(""),this.param.value&&e(o`  {blue Value}: ${this.param.value}`),this.param.reason&&e(o`  {yellow Reason}: ${this.param.reason}`)}}class M{handle(e){if(e instanceof p)return e.pretty(),-1;throw e}}class T{commandRegistry;exceptionHandler;ctx;helpCommand;get CommandRegistryClass(){return D}get HelpCommandClass(){return P}get ExceptionHandlerClass(){return M}constructor(e={}){this.ctx=e.ctx,this.commandRegistry=new this.CommandRegistryClass,this.exceptionHandler=new this.ExceptionHandlerClass,this.helpCommand=new this.HelpCommandClass({cliName:e.name,cliVersion:e.version,commandRegistry:this.commandRegistry})}setCommandResolver(e){this.commandRegistry.setCommandResolver(e)}async withCommands(...e){for(const t of e)typeof t=="string"?await this.commandRegistry.loadCommandsPath(t):typeof t=="function"?this.registerCommand(new t):this.registerCommand(t)}async runCommand(e,...t){return e?await this.commandRegistry.runCommand(this.ctx,e,...t).catch(this.exceptionHandler.handle):await this.runHelpCommand()}async runHelpCommand(){return await this.runCommand(this.helpCommand)}registerCommand(e){this.commandRegistry.registerCommand(e)}}exports.BadCommandOption=H;exports.BadCommandParameter=B;exports.BobError=p;exports.Cli=T;exports.Command=R;exports.CommandIO=v;exports.HelpOption=O;

package/dist/bob-core.js

@@ -1,75 +1,76 @@
-import S from "minimist";
-import a from "chalk";
-import * as v from "node:fs";
-import C from "path";
-import * as R from "string-similarity";
-class h extends Error {
+import b from "minimist";
+import o from "chalk";
+import f from "prompts";
+import * as R from "node:fs";
+import $ from "path";
+import * as O from "string-similarity";
+class c extends Error {
 }
-class $ extends h {
+class v extends c {
   constructor(t) {
     super(`Argument "${t.name}" is required.`), this.paramSignature = t;
   }
   pretty() {
     const t = console.log;
-    this.paramSignature.help && t(a`{yellow Help}: ${this.paramSignature.help}\n`), t(a`  {white.bgRed  ERROR } Argument {bold.yellow ${this.paramSignature.name}} is required.`);
+    t(o`{white.bgRed  ERROR } Argument {bold.yellow ${this.paramSignature.name}} is required.`);
   }
 }
-class f extends h {
+class y extends c {
   constructor(t, e) {
     super(`Missing ${t} in the command signature`), this.option = t, this.optionsSignature = e;
   }
   pretty() {
     const t = console.log;
     if (this.optionsSignature.length) {
-      t(a`{yellow Available options}:`);
+      t(o`{yellow Available options}:`);
       for (const e of this.optionsSignature) {
-        const n = e.type ? a`{white (${e.type})}` : "", i = " ".repeat(20 - e.name.length);
-        t(a`  {green ${e.name}} ${i} ${e.help ?? "\b"} ${n}`);
+        const n = e.type ? o`{white (${e.type})}` : "", s = " ".repeat(20 - e.name.length);
+        t(o`  {green ${e.name}} ${s} ${e.help ?? "\b"} ${n}`);
       }
       t("");
     }
-    t(a`  {white.bgRed  ERROR } Option {bold.yellow ${this.option}} is missing in the signature.`);
+    t(o`{white.bgRed  ERROR } Option {bold.yellow ${this.option}} is missing in the signature.`);
   }
 }
-class y extends h {
+class w extends c {
   constructor(t, e) {
     super(`Missing ${t} in the command signature`), this.argument = t, this.argumentSignatures = e;
   }
   pretty() {
     const t = console.log;
     if (this.argumentSignatures.length) {
-      t(a`\n{yellow Available arguments}:`);
+      t(o`\n{yellow Available arguments}:`);
       for (const e of this.argumentSignatures) {
-        const n = e.type ? a`{white (${e.type})}` : "", i = " ".repeat(20 - e.name.length);
-        t(a`  {green ${e.name}} ${i} ${e.help ?? "\b"} ${n}`);
+        const n = e.type ? o`{white (${e.type})}` : "", s = " ".repeat(20 - e.name.length);
+        t(o`  {green ${e.name}} ${s} ${e.help ?? "\b"} ${n}`);
       }
       t("");
     }
-    t(a`  {white.bgRed  ERROR } Argument {bold.yellow ${this.argument}} is missing in the signature.`);
+    t(o`{white.bgRed  ERROR } Argument {bold.yellow ${this.argument}} is missing in the signature.`);
   }
 }
-class b extends h {
+class A extends c {
   constructor(t, e) {
     super(`Invalid option ${t} in not recognized`), this.option = t, this.optionsSignature = e;
   }
   pretty() {
     const t = console.log;
     if (this.optionsSignature.length > 0) {
-      t(a`\n{yellow Available options}:`);
+      t(o`\n{yellow Available options}:`);
       for (const e of this.optionsSignature) {
-        const n = e.type ? a`{white (${e.type})}` : "", i = `--${e.name}${e.alias?.map((r) => `, -${r}`).join("") ?? ""}`, o = " ".repeat(30 - i.length);
-        t(a`  {green ${i}} ${o} ${e.help ?? "\b"} ${n}`);
+        const n = e.type ? o`{white (${e.type})}` : "", s = `--${e.name}${e.alias?.map((r) => `, -${r}`).join("") ?? ""}`, i = " ".repeat(30 - s.length);
+        t(o`  {green ${s}} ${i} ${e.help ?? "\b"} ${n}`);
       }
       t("");
     }
-    t(a`  {white.bgRed  ERROR } Option {bold.yellow ${this.option}} is not recognized.`);
+    t(o`{white.bgRed  ERROR } Option {bold.yellow ${this.option}} is not recognized.`);
   }
 }
-class O {
-  constructor(t, e, n, ...i) {
-    this.signature = t, this.helperDefinitions = e, this.defaultCommandOptions = n;
-    const [o, ...r] = t.split(/\{(.*?)\}/g).map((l) => l.trim()).filter(Boolean), { _: p, ...s } = S(i);
-    this.command = o, this.parseSignature(r), this.parseDefaultOptions(), this.handleArguments(p), this.handleOptions(s);
+class x {
+  constructor(t, e, n, s, ...i) {
+    this.io = t, this.signature = e, this.helperDefinitions = n, this.defaultCommandOptions = s;
+    const [r, ...m] = e.split(/\{(.*?)\}/g).map((p) => p.trim()).filter(Boolean), { _: a, ...l } = b(i);
+    this.command = r, this.parseSignature(m), this.parseDefaultOptions(), this.handleArguments(a), this.handleOptions(l);
   }
   command;
   arguments = {};
@@ -79,32 +80,32 @@ class O {
   optionAliases = {};
   option(t) {
     if (!this.optionSignatures[t])
-      throw new f(t, Object.values(this.optionSignatures));
+      throw new y(t, Object.values(this.optionSignatures));
     return this.options[t];
   }
   setOption(t, e) {
     if (!this.optionSignatures[t])
-      throw new f(t, Object.values(this.optionSignatures));
+      throw new y(t, Object.values(this.optionSignatures));
     this.options[t] = e;
   }
   optionHelp(t) {
     if (!this.optionSignatures[t])
-      throw new f(t, Object.values(this.optionSignatures));
+      throw new y(t, Object.values(this.optionSignatures));
     return this.optionSignatures[t].help;
   }
   argument(t) {
     if (!this.argumentsSignature[t])
-      throw new y(t, Object.values(this.argumentsSignature));
+      throw new w(t, Object.values(this.argumentsSignature));
     return this.arguments[t];
   }
   setArgument(t, e) {
     if (!this.argumentsSignature[t])
-      throw new y(t, Object.values(this.argumentsSignature));
+      throw new w(t, Object.values(this.argumentsSignature));
     this.arguments[t] = e;
   }
   argumentHelp(t) {
     if (!this.argumentsSignature[t])
-      throw new y(t, Object.values(this.argumentsSignature));
+      throw new w(t, Object.values(this.argumentsSignature));
     return this.argumentsSignature[t].help;
   }
   getArgumentSignatures() {
@@ -118,23 +119,23 @@ class O {
   }
   handleArguments(t) {
     for (const [e, n] of Object.entries(this.arguments)) {
-      const i = this.argumentsSignature[e];
-      if (i.variadic)
+      const s = this.argumentsSignature[e];
+      if (s.variadic)
         this.arguments[e] = t;
       else {
-        const o = t.shift();
-        this.arguments[e] = this.getParamValue(o, i);
+        const i = t.shift();
+        this.arguments[e] = this.getParamValue(i, s);
       }
     }
   }
   handleOptions(t) {
     for (const [e, n] of Object.entries(t)) {
-      const i = this.optionAliases[e], o = this.optionSignatures[e] ?? this.optionSignatures[i];
-      if (!o)
-        throw new b(e, Object.values(this.optionSignatures));
-      this.options[e] = this.getParamValue(n, o);
-      for (const r of o.alias ?? [])
-        t[r] && (this.options[o.name] = t[r]);
+      const s = this.optionAliases[e], i = this.optionSignatures[e] ?? this.optionSignatures[s];
+      if (!i)
+        throw new A(e, Object.values(this.optionSignatures));
+      this.options[e] = this.getParamValue(n, i);
+      for (const r of i.alias ?? [])
+        t[r] && (this.options[i.name] = t[r]);
     }
   }
   parseSignature(t) {
@@ -142,8 +143,8 @@ class O {
       const n = this.parseParamSignature(e);
       if (n.isOption) {
         this.options[n.name] = n.defaultValue ?? null, this.optionSignatures[n.name] = n;
-        for (const i of n.alias ?? [])
-          this.optionAliases[i] = n.name;
+        for (const s of n.alias ?? [])
+          this.optionAliases[s] = n.name;
       } else
         this.arguments[n.name] = n.defaultValue ?? null, this.argumentsSignature[n.name] = n;
     }
@@ -153,7 +154,7 @@ class O {
       for (const t of this.defaultCommandOptions)
         if (this.optionSignatures[t.option] = {
           name: t.option,
-          type: t.defaultValue == null ? "string" : typeof t.defaultValue,
+          type: t.defaultValue == null ? "string" : typeof t.defaultValue == "boolean" ? "boolean" : Array.isArray(t.defaultValue) ? "array" : "string",
           optional: !0,
           alias: t.alias,
           variadic: !1,
@@ -176,90 +177,169 @@ class O {
       isOption: !1
     };
     if (e.name.includes(":")) {
-      const [n, i] = e.name.split(":");
-      e.name = n.trim(), e.help = i.trim();
+      const [n, s] = e.name.split(":");
+      e.name = n.trim(), e.help = s.trim();
     }
     if (e.name.includes("=")) {
-      const [n, i] = e.name.split("=");
-      e.name = n.trim(), e.defaultValue = i.trim(), e.optional = !0, e.defaultValue.length ? e.defaultValue === "true" ? (e.defaultValue = !0, e.type = "boolean") : e.defaultValue === "false" && (e.defaultValue = !1, e.type = "boolean") : e.defaultValue = null;
+      const [n, s] = e.name.split("=");
+      e.name = n.trim(), e.defaultValue = s.trim(), e.optional = !0, e.defaultValue.length ? e.defaultValue === "true" ? (e.defaultValue = !0, e.type = "boolean") : e.defaultValue === "false" && (e.defaultValue = !1, e.type = "boolean") : e.defaultValue = null;
     } else
       e.name.startsWith("--") && (e.optional = !0, e.defaultValue = !1, e.type = "boolean");
     if (e.name.includes("|")) {
-      const [n, ...i] = e.name.split("|");
-      e.name = n.trim(), e.alias = i.map((o) => o.trim());
+      const [n, ...s] = e.name.split("|");
+      e.name = n.trim(), e.alias = s.map((i) => i.trim());
     }
     return e.name.startsWith("--") && (e.isOption = !0, e.name = e.name.slice(2)), e.defaultValue === "*" && (e.defaultValue = [], e.type = "array"), e.name.endsWith("?") && (e.optional = !0, e.name = e.name.slice(0, -1)), e.name.endsWith("*") && (e.type = "array", e.variadic = !0, e.defaultValue = [], e.name = e.name.slice(0, -1)), e.help = e.help ?? this.helperDefinitions[e.name] ?? this.helperDefinitions[`--${e.name}`], e;
   }
-  validate() {
+  async validate() {
     for (const [t, e] of Object.entries(this.arguments)) {
       const n = this.argumentsSignature[t];
-      if (!e && !n.optional)
-        throw new $(n);
+      if (!e && !n.optional) {
+        let s = null;
+        switch (n.type) {
+          case "string":
+            let i = o`{yellow.bold ${n.name}} is required`;
+            n.help && (i += o`: {gray (${n.help})}`), i += `
+`, s = await this.io.askForInput(i, n.defaultValue, {
+              validate: (r) => r?.trim()?.length ? !0 : `${n.name} cannot be empty`
+            });
+            break;
+        }
+        if (s)
+          this.setArgument(t, s);
+        else
+          throw new v(n);
+      }
       if (!e?.length && n.variadic && !n.optional)
-        throw new $(n);
+        throw new v(n);
     }
   }
 }
-function w(m) {
-  return new Array(m + 5).join(" ");
+function C(u) {
+  return new Array(u + 5).join(" ");
 }
-class A {
+class V {
   option = "help";
   alias = ["h"];
   defaultValue = !1;
-  description = a`Display help for the given command. When no command is given display help for the {green list} command`;
+  description = o`Display help for the given command. When no command is given display help for the {green list} command`;
   async handler() {
-    const t = console.log, e = Object.values(this.parser.getArgumentSignatures()), n = Object.values(this.parser.getOptionSignatures()).map((s) => ({
-      ...s,
-      optionWithAlias: `--${s.name}${s.alias?.map((l) => `, -${l}`).join("") ?? ""}`
-    })), i = e.filter((s) => !s.optional);
-    t(a`{yellow Description}:`), t(a`  ${this.description}\n`), t(a`{yellow Usage}:`), t(a`  ${this.command} ${i.length > 0 ? i.map((s) => `<${s.name}>`).join(" ") : "\b"} [options]`);
-    const o = Math.max(...n.map((s) => s.optionWithAlias.length)) ?? 0, r = Math.max(...e.map((s) => s.name.length)) ?? 0, p = r > o ? r : o;
+    const t = console.log, e = Object.values(this.parser.getArgumentSignatures()), n = Object.values(this.parser.getOptionSignatures()).map((a) => ({
+      ...a,
+      optionWithAlias: `--${a.name}${a.alias?.map((l) => `, -${l}`).join("") ?? ""}`
+    })), s = e.filter((a) => !a.optional);
+    t(o`{yellow Description}:`), t(o`  ${this.description}\n`), t(o`{yellow Usage}:`), t(o`  ${this.command} ${s.length > 0 ? s.map((a) => `<${a.name}>`).join(" ") : "\b"} [options]`);
+    const i = Math.max(...n.map((a) => a.optionWithAlias.length)) ?? 0, r = Math.max(...e.map((a) => a.name.length)) ?? 0, m = r > i ? r : i;
     if (e.length > 0) {
-      t(a`\n{yellow Arguments}:`);
-      for (const s of e) {
-        const l = w(p - s.name.length);
-        let u = a`  {green ${s.name}} ${l} ${s.help ?? "\b"}`;
-        if (s.defaultValue !== void 0 && s.optional) {
-          const c = s.type === "array" ? JSON.stringify(s.defaultValue) : s.defaultValue;
-          u += a` {yellow [default: ${c}]}`;
+      t(o`\n{yellow Arguments}:`);
+      for (const a of e) {
+        const l = C(m - a.name.length);
+        let p = o`  {green ${a.name}} ${l} ${a.help ?? "\b"}`;
+        if (a.defaultValue !== void 0 && a.optional) {
+          const h = a.type === "array" ? JSON.stringify(a.defaultValue) : a.defaultValue;
+          p += o` {yellow [default: ${h}]}`;
         }
-        s.variadic && (u += a` {white (variadic)}`), t(u);
+        a.variadic && (p += o` {white (variadic)}`), t(p);
       }
     }
     if (n.length > 0) {
-      t(a`\n{yellow Options}:`);
-      for (const s of n) {
-        const l = w(p - s.optionWithAlias.length);
-        let u = a`{green ${s.optionWithAlias}} ${l} ${s.help ?? "\b"}`;
-        if (s.type && (u += a` {white (${s.type})}`), s.defaultValue !== void 0 && s.optional) {
-          const c = s.type === "array" ? JSON.stringify(s.defaultValue) : s.defaultValue;
-          u += a` {yellow [default: ${c}]}`;
+      t(o`\n{yellow Options}:`);
+      for (const a of n) {
+        const l = C(m - a.optionWithAlias.length);
+        let p = o`{green ${a.optionWithAlias}} ${l} ${a.help ?? "\b"}`;
+        if (a.type && (p += o` {white (${a.type})}`), a.defaultValue !== void 0 && a.optional) {
+          const h = a.type === "array" ? JSON.stringify(a.defaultValue) : a.defaultValue;
+          p += o` {yellow [default: ${h}]}`;
         }
-        t(u);
+        t(p);
       }
     }
     if (this.commandsExamples.length > 0) {
-      t(a`\n{yellow Examples}:`);
-      let s = process.argv[0].split("/").pop();
-      s === "node" && (s += " " + process.argv[1].split("/").pop());
-      for (const [l, u] of this.commandsExamples.entries())
-        l > 0 && t(""), t(`  ${u.description}
-`), t(a`    {green ${s} ${u.command}}`);
+      t(o`\n{yellow Examples}:`);
+      let a = process.argv[0].split("/").pop();
+      a === "node" && (a += " " + process.argv[1].split("/").pop());
+      for (const [l, p] of this.commandsExamples.entries())
+        l > 0 && t(""), t(`  ${p.description}
+`), t(o`    {green ${a} ${p.command}}`);
     }
     return -1;
   }
 }
-class V {
+class S {
+  /**
+   * Prompt utils
+   */
+  async askForConfirmation(t = "Do you want to continue?", e) {
+    return (await f({
+      type: "confirm",
+      name: "value",
+      message: t,
+      initial: e ?? !1
+    })).value;
+  }
+  async askForInput(t, e, n) {
+    return (await f({
+      type: "text",
+      name: "value",
+      message: t,
+      initial: e,
+      ...n
+    }))?.value ?? null;
+  }
+  async askForToggle(t, e, n) {
+    return (await f({
+      type: "toggle",
+      name: "value",
+      message: t,
+      initial: e,
+      ...n
+    }))?.value ?? null;
+  }
+  async askForSelect(t, e, n) {
+    if (e.length === 0)
+      throw new Error("No options provided");
+    const s = [];
+    for (const r of e)
+      typeof r == "string" ? s.push({ title: r, value: r }) : s.push(r);
+    return (await f({
+      type: "select",
+      name: "value",
+      message: t,
+      choices: s,
+      ...n
+    }))?.value ?? null;
+  }
+  newLoader(t = "", e = ["⠙", "⠘", "⠰", "⠴", "⠤", "⠦", "⠆", "⠃", "⠋", "⠉"], n = 100) {
+    let s = t, i = null, r = 0;
+    const m = setInterval(function() {
+      i && (process.stdout.write(new TextEncoder().encode("\r" + " ".repeat(i.length + 5) + "\r")), i = null), process.stdout.write(new TextEncoder().encode("\r" + e[r++] + " " + s)), r = r % e.length;
+    }, n), a = () => {
+      clearInterval(m), process.stdout.write(new TextEncoder().encode("\r" + " ".repeat(s.length + 5) + "\r"));
+    };
+    return {
+      [Symbol.dispose]: a,
+      [Symbol.asyncDispose]: a,
+      updateText: (l) => {
+        i = s, s = l;
+      },
+      stop: a
+    };
+  }
+}
+class E {
   ctx;
   helperDefinitions = {};
   commandsExamples = [];
   parser;
+  io;
   get CommandParserClass() {
-    return O;
+    return x;
+  }
+  get CommandIOClass() {
+    return S;
   }
   defaultOptions() {
-    return [new A()];
+    return [new V()];
   }
   get command() {
     return this.parser ? this.parser.command : this.signature.split(" ")[0];
@@ -267,14 +347,14 @@ class V {
   async run(t, ...e) {
     this.ctx = t;
     const n = this.defaultOptions();
-    this.parser = new this.CommandParserClass(this.signature, this.helperDefinitions, n, ...e);
-    for (const i of n)
-      if (this.parser.option(i.option)) {
-        const o = await i.handler.call(this);
-        if (o && o !== 0)
-          return o;
+    this.io = new this.CommandIOClass(), this.parser = new this.CommandParserClass(this.io, this.signature, this.helperDefinitions, n, ...e);
+    for (const s of n)
+      if (this.parser.option(s.option)) {
+        const i = await s.handler.call(this);
+        if (i && i !== 0)
+          return i;
       }
-    return this.parser.validate(), await this.handle() ?? 0;
+    return await this.parser.validate(), await this.handle() ?? 0;
   }
   setOption(t, e) {
     this.parser.setOption(t, e);
@@ -314,27 +394,42 @@ class V {
     const n = this.parser.argument(t);
     return n ? typeof n == "number" ? n : parseInt(n) : e;
   }
+  /**
+   * Prompt utils
+   */
+  async askForConfirmation(...t) {
+    return this.io.askForConfirmation(...t);
+  }
+  async askForInput(...t) {
+    return this.io.askForInput(...t);
+  }
+  async askForSelect(...t) {
+    return this.io.askForSelect(...t);
+  }
+  newLoader(...t) {
+    return this.io.newLoader(...t);
+  }
 }
-class x extends h {
-  constructor(t, e) {
-    super(`Command "${t}" not found.`), this.command = t, this.similarCommands = e;
+class j extends c {
+  constructor(t) {
+    super(`Command "${t}" not found.`), this.command = t;
   }
   pretty() {
     const t = console.log;
-    if (this.similarCommands.length) {
-      t(a`  {white.bgRed  ERROR } Command "${this.command}" not found, Did you mean one of these?`);
-      for (const e of this.similarCommands)
-        t(a`  {gray ⇂ ${e}}`);
-    } else
-      t(a`  {white.bgRed  ERROR } Command "${this.command}" not found.`);
+    t(o`{bgRed  ERROR } Command {yellow ${this.command}} not found.`);
   }
 }
-class E {
+class F {
   commands = {};
+  io;
   get commandSuffix() {
     return "Command";
   }
+  get CommandIOClass() {
+    return S;
+  }
   constructor() {
+    this.io = new this.CommandIOClass();
   }
   getAvailableCommands() {
     return Object.keys(this.commands);
@@ -368,101 +463,102 @@ class E {
       }
   }
   async runCommand(t, e, ...n) {
-    const i = typeof e == "string" ? this.commands[e] : e, o = typeof e == "string" ? e : i.command;
-    if (!i) {
-      const r = await this.suggestCommand(o);
+    const s = typeof e == "string" ? this.commands[e] : e, i = typeof e == "string" ? e : s.command;
+    if (!s) {
+      const r = await this.suggestCommand(i);
       return r ? await this.runCommand(t, r, ...n) : 1;
     }
-    return await i.run(t, ...n);
+    return await s.run(t, ...n);
   }
   async suggestCommand(t) {
-    const e = this.getAvailableCommands(), { bestMatch: n, bestMatchIndex: i, ratings: o } = R.findBestMatch(t, e), r = o.filter((p) => p.rating > 0.3).map((p) => p.target);
+    const e = this.getAvailableCommands(), { bestMatch: n, bestMatchIndex: s, ratings: i } = O.findBestMatch(t, e), r = i.filter((m) => m.rating > 0.3).map((m) => m.target);
     if (n.rating > 0 && r.length <= 1 || n.rating > 0.7 && r.length > 1) {
-      const p = e[i];
-      return await this.askRunSimilarCommand(t, p) ? p : null;
+      const m = e[s];
+      return await this.askRunSimilarCommand(t, m) ? m : null;
+    }
+    if (r.length) {
+      console.log(o`{bgRed  ERROR } Command {yellow ${t}} not found.\n`);
+      const m = await this.io.askForSelect(
+        o`{green Did you mean to run one of these commands instead?}`,
+        r
+      );
+      if (m)
+        return m;
     }
-    throw new x(t, r);
+    throw new j(t);
   }
   async askRunSimilarCommand(t, e) {
-    const n = require("readline").createInterface({
-      input: process.stdin,
-      output: process.stdout
-    });
-    return console.log(a`  {bgRed  ERROR } Command {yellow ${t}} not found.\n`), new Promise((i) => {
-      n.question(a`{green Do you want to run {yellow ${e}} instead?} {white (yes/no)} [{yellow no}]\n > `, (o) => {
-        i(o === "yes" || o === "y"), n.close();
-      });
-    });
+    return console.log(o`{bgRed  ERROR } Command {yellow ${t}} not found.\n`), this.io.askForConfirmation(o`{green Do you want to run {yellow ${e}} instead?} `);
   }
   async *listCommandsFiles(t) {
-    const e = v.readdirSync(t, { withFileTypes: !0 });
+    const e = R.readdirSync(t, { withFileTypes: !0 });
     for (const n of e) {
-      const i = C.resolve(t, n.name);
+      const s = $.resolve(t, n.name);
       if (n.isDirectory())
-        yield* this.listCommandsFiles(C.resolve(t, n.name));
+        yield* this.listCommandsFiles($.resolve(t, n.name));
       else {
-        if (!i.endsWith(`${this.commandSuffix}.ts`) && !i.endsWith(`${this.commandSuffix}.js`))
+        if (!s.endsWith(`${this.commandSuffix}.ts`) && !s.endsWith(`${this.commandSuffix}.js`))
           continue;
-        yield i;
+        yield s;
       }
     }
   }
 }
-class j extends V {
+class k extends E {
   constructor(t) {
     super(), this.opts = t;
   }
   signature = "help";
   description = "Show help";
   async handle() {
-    const t = this.opts.commandRegistry.getCommands(), e = this.opts.cliName ?? "Bob CLI", n = this.opts.cliVersion ?? "0.0.0", i = (await import("./package-B3ICsvyj.js"))?.default?.version ?? "0.0.0";
-    console.log(a`${e} {green ${n}} (core: {yellow ${i}})
+    const t = this.opts.commandRegistry.getCommands(), e = this.opts.cliName ?? "Bob CLI", n = this.opts.cliVersion ?? "0.0.0", s = (await import("./package-7cIQdc3-.js"))?.default?.version ?? "0.0.0";
+    console.log(o`${e} {green ${n}} (core: {yellow ${s}})
 
 {yellow Usage}:
   command [options] [arguments]
 
 {yellow Available commands}:
 `);
-    const o = Math.max(...t.map((s) => s.command.length)) ?? 0, r = {};
-    for (const s of t) {
-      const l = s.command.split(":")[0];
-      r[l] || (r[l] = []), r[l].push(s);
+    const i = Math.max(...t.map((a) => a.command.length)) ?? 0, r = {};
+    for (const a of t) {
+      const l = a.command.split(":")[0];
+      r[l] || (r[l] = []), r[l].push(a);
     }
-    const p = Object.entries(r).sort(([s], [l]) => s.toLowerCase().localeCompare(l.toLowerCase())).sort(([, s], [, l]) => s.length - l.length);
-    for (const [s, l] of p) {
-      const u = l.length > 1;
-      u && console.log(a`{yellow ${s}}:`);
-      const c = l.sort((d, g) => d.command.toLowerCase().localeCompare(g.command.toLowerCase()));
-      for (const d of c) {
-        let g = w(o - d.command.length);
-        u && (g = g.slice(2)), console.log(a`${u ? "  " : ""}{green ${d.command}} ${g} ${d.description}`);
+    const m = Object.entries(r).sort(([a], [l]) => a.toLowerCase().localeCompare(l.toLowerCase())).sort(([, a], [, l]) => a.length - l.length);
+    for (const [a, l] of m) {
+      const p = l.length > 1;
+      p && console.log(o`{yellow ${a}}:`);
+      const h = l.sort((d, g) => d.command.toLowerCase().localeCompare(g.command.toLowerCase()));
+      for (const d of h) {
+        let g = C(i - d.command.length);
+        p && (g = g.slice(2)), console.log(o`${p ? "  " : ""}{green ${d.command}} ${g} ${d.description}`);
       }
     }
   }
 }
-class B extends h {
+class W extends c {
   constructor(t) {
     let e = `Argument "${t.param}" value is invalid.`;
     t.reason ? e += ` Reason: ${t.reason}` : e += ` Value: "${t.value}"`, super(e), this.param = t;
   }
   pretty() {
     const t = console.log;
-    t(a`  {white.bgRed  ERROR } Argument {bold.yellow ${this.param.param}} value is invalid. `), (this.param.value || this.param.reason) && t(""), this.param.value && t(a`  {blue Value}: ${this.param.value}`), this.param.reason && t(a`  {yellow Reason}: ${this.param.reason}`);
+    t(o`  {white.bgRed  ERROR } Argument {bold.yellow ${this.param.param}} value is invalid. `), (this.param.value || this.param.reason) && t(""), this.param.value && t(o`  {blue Value}: ${this.param.value}`), this.param.reason && t(o`  {yellow Reason}: ${this.param.reason}`);
   }
 }
-class M extends h {
+class M extends c {
   constructor(t) {
     let e = `Option "${t.option}" value is invalid.`;
     t.reason ? e += ` Reason: ${t.reason}` : e += ` Value: "${t.value}"`, super(e), this.param = t;
   }
   pretty() {
     const t = console.log;
-    t(a`  {white.bgRed  ERROR } Option {bold.yellow ${this.param.option}} value is invalid. `), (this.param.value || this.param.reason) && t(""), this.param.value && t(a`  {blue Value}: ${this.param.value}`), this.param.reason && t(a`  {yellow Reason}: ${this.param.reason}`);
+    t(o`  {white.bgRed  ERROR } Option {bold.yellow ${this.param.option}} value is invalid. `), (this.param.value || this.param.reason) && t(""), this.param.value && t(o`  {blue Value}: ${this.param.value}`), this.param.reason && t(o`  {yellow Reason}: ${this.param.reason}`);
   }
 }
-class H {
+class I {
   handle(t) {
-    if (t instanceof h)
+    if (t instanceof c)
       return t.pretty(), -1;
     throw t;
   }
@@ -473,13 +569,13 @@ class N {
   ctx;
   helpCommand;
   get CommandRegistryClass() {
-    return E;
+    return F;
   }
   get HelpCommandClass() {
-    return j;
+    return k;
   }
   get ExceptionHandlerClass() {
-    return H;
+    return I;
   }
   constructor(t = {}) {
     this.ctx = t.ctx, this.commandRegistry = new this.CommandRegistryClass(), this.exceptionHandler = new this.ExceptionHandlerClass(), this.helpCommand = new this.HelpCommandClass({
@@ -507,9 +603,10 @@ class N {
 }
 export {
   M as BadCommandOption,
-  B as BadCommandParameter,
-  h as BobError,
+  W as BadCommandParameter,
+  c as BobError,
   N as Cli,
-  V as Command,
-  A as HelpOption
+  E as Command,
+  S as CommandIO,
+  V as HelpOption
 };

package/dist/{package-B3ICsvyj.js → package-7cIQdc3-.js}

@@ -1,4 +1,4 @@
-const t = "bob-core", s = "1.2.4", e = "BOB Core", i = "module", r = ["/dist"], n = { ".": { types: "./dist/types/src/index.d.ts", import: "./dist/bob-core.js", require: "./dist/bob-core.cjs" } }, o = { start: "node -r @swc-node/register debug/main.ts", build: "rimraf ./dist && vite build", prepare: "npm run build", test: "vitest run" }, c = "Léo Hubert", p = "ISC", d = { "@swc-node/register": "^1.11.1", "@types/minimist": "^1.2.5", "@types/node": "^20.14.5", "@types/prompts": "^2.4.9", "@types/string-similarity": "^4.0.2", rimraf: "^6.0.1", typescript: "^5.7.3", vite: "^7.1.6", "vite-plugin-dts": "^4.5.4", vitest: "^3.2.4" }, m = { chalk: "^4.1.2", minimist: "^1.2.8", prompts: "^2.4.2", "string-similarity": "^4.0.4" }, a = {
+const t = "bob-core", s = "1.3.1", e = "BOB Core", i = "module", r = ["/dist"], n = { ".": { types: "./dist/types/src/index.d.ts", import: "./dist/bob-core.js", require: "./dist/bob-core.cjs" } }, o = { start: "node -r @swc-node/register debug/main.ts", build: "rimraf ./dist && vite build", prepare: "npm run build", test: "vitest run" }, c = "Léo Hubert", p = "ISC", d = { "@swc-node/register": "^1.11.1", "@types/minimist": "^1.2.5", "@types/node": "^20.14.5", "@types/prompts": "^2.4.9", "@types/string-similarity": "^4.0.2", rimraf: "^6.0.1", typescript: "^5.7.3", vite: "^7.1.6", "vite-plugin-dts": "^4.5.4", vitest: "^3.2.4" }, m = { chalk: "^4.1.2", minimist: "^1.2.8", prompts: "^2.4.2", "string-similarity": "^4.0.4" }, a = {
   name: t,
   version: s,
   description: e,

package/dist/{package-sv16L6xn.cjs → package-D1l4pNru.cjs}

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="bob-core",t="1.2.4",s="BOB Core",i="module",r=["/dist"],n={".":{types:"./dist/types/src/index.d.ts",import:"./dist/bob-core.js",require:"./dist/bob-core.cjs"}},o={start:"node -r @swc-node/register debug/main.ts",build:"rimraf ./dist && vite build",prepare:"npm run build",test:"vitest run"},c="Léo Hubert",p="ISC",d={"@swc-node/register":"^1.11.1","@types/minimist":"^1.2.5","@types/node":"^20.14.5","@types/prompts":"^2.4.9","@types/string-similarity":"^4.0.2",rimraf:"^6.0.1",typescript:"^5.7.3",vite:"^7.1.6","vite-plugin-dts":"^4.5.4",vitest:"^3.2.4"},a={chalk:"^4.1.2",minimist:"^1.2.8",prompts:"^2.4.2","string-similarity":"^4.0.4"},m={name:e,version:t,description:s,type:i,files:r,exports:n,scripts:o,author:c,license:p,devDependencies:d,dependencies:a};exports.author=c;exports.default=m;exports.dependencies=a;exports.description=s;exports.devDependencies=d;exports.exports=n;exports.files=r;exports.license=p;exports.name=e;exports.scripts=o;exports.type=i;exports.version=t;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="bob-core",t="1.3.1",s="BOB Core",i="module",r=["/dist"],n={".":{types:"./dist/types/src/index.d.ts",import:"./dist/bob-core.js",require:"./dist/bob-core.cjs"}},o={start:"node -r @swc-node/register debug/main.ts",build:"rimraf ./dist && vite build",prepare:"npm run build",test:"vitest run"},c="Léo Hubert",p="ISC",d={"@swc-node/register":"^1.11.1","@types/minimist":"^1.2.5","@types/node":"^20.14.5","@types/prompts":"^2.4.9","@types/string-similarity":"^4.0.2",rimraf:"^6.0.1",typescript:"^5.7.3",vite:"^7.1.6","vite-plugin-dts":"^4.5.4",vitest:"^3.2.4"},a={chalk:"^4.1.2",minimist:"^1.2.8",prompts:"^2.4.2","string-similarity":"^4.0.4"},m={name:e,version:t,description:s,type:i,files:r,exports:n,scripts:o,author:c,license:p,devDependencies:d,dependencies:a};exports.author=c;exports.default=m;exports.dependencies=a;exports.description=s;exports.devDependencies=d;exports.exports=n;exports.files=r;exports.license=p;exports.name=e;exports.scripts=o;exports.type=i;exports.version=t;

package/dist/types/src/Command.d.ts

@@ -1,5 +1,6 @@
 import { CommandParser } from './CommandParser.js';
 import { CommandOption } from './contracts/index.js';
+import { CommandIO } from './CommandIO.js';
 export type CommandExample = {
     description: string;
     command: string;
@@ -13,8 +14,10 @@ export declare abstract class Command<C = any> {
     };
     protected commandsExamples: CommandExample[];
     protected parser: CommandParser;
+    protected io: CommandIO;
     protected abstract handle(): Promise<void | number>;
-    private get CommandParserClass();
+    protected get CommandParserClass(): typeof CommandParser;
+    protected get CommandIOClass(): typeof CommandIO;
     protected defaultOptions(): CommandOption<Command<C>>[];
     get command(): string;
     run(ctx: C, ...args: any[]): Promise<number>;
@@ -31,4 +34,11 @@ export declare abstract class Command<C = any> {
     protected argumentArray<T = string>(key: string, defaultValue?: Array<any>): Array<T>;
     protected argumentBoolean(key: string, defaultValue?: boolean): boolean;
     protected argumentNumber(key: string, defaultValue?: number | null): number | null;
+    /**
+     * Prompt utils
+     */
+    askForConfirmation(...opts: Parameters<typeof this.io.askForConfirmation>): ReturnType<typeof this.io.askForConfirmation>;
+    askForInput(...opts: Parameters<typeof this.io.askForInput>): ReturnType<typeof this.io.askForInput>;
+    askForSelect(...opts: Parameters<typeof this.io.askForSelect>): ReturnType<typeof this.io.askForSelect>;
+    newLoader(...opts: Parameters<typeof this.io.newLoader>): ReturnType<typeof this.io.newLoader>;
 }

package/dist/types/src/CommandIO.d.ts

@@ -0,0 +1,35 @@
+export type SelectOption = {
+    title: string;
+    value?: any;
+    disabled?: boolean | undefined;
+    selected?: boolean | undefined;
+    description?: string | undefined;
+};
+export declare class CommandIO {
+    /**
+     * Prompt utils
+     */
+    askForConfirmation(message?: string, defaultValue?: boolean): Promise<boolean>;
+    askForInput(message: string, defaultValue?: string | number, opts?: {
+        type?: 'text' | 'password' | 'number';
+        validate?: (value: string) => boolean | string;
+        min?: number;
+        max?: number;
+    }): Promise<string | null>;
+    askForToggle(message: string, defaultValue?: boolean, opts?: {
+        active?: string;
+        inactive?: string;
+    }): Promise<boolean>;
+    askForSelect(message: string, options: Array<string | SelectOption>, opts?: {
+        type?: 'select' | 'multiselect' | 'autocomplete' | 'autocompleteMultiselect';
+        initial?: number;
+        validate?: (value: string) => boolean;
+        suggest?: (input: string, choices: SelectOption[]) => Promise<SelectOption[]>;
+    }): Promise<string | null>;
+    newLoader(text?: string, chars?: string[], delay?: number): {
+        [Symbol.dispose]: () => void;
+        [Symbol.asyncDispose]: () => void;
+        updateText: (newText: string) => void;
+        stop: () => void;
+    };
+}

package/dist/types/src/CommandParser.d.ts

@@ -1,7 +1,8 @@
 import { CommandOption } from './contracts/index.js';
+import { CommandIO } from './CommandIO.js';
 export type ArgSignature = {
     name: string;
-    type: string;
+    type: 'string' | 'boolean' | 'array';
     optional?: boolean;
     variadic?: boolean;
     alias?: string[];
@@ -10,6 +11,7 @@ export type ArgSignature = {
     isOption?: boolean;
 };
 export declare class CommandParser {
+    protected readonly io: CommandIO;
     protected readonly signature: string;
     protected readonly helperDefinitions: {
         [key: string]: string;
@@ -21,7 +23,7 @@ export declare class CommandParser {
     private argumentsSignature;
     private optionSignatures;
     private optionAliases;
-    constructor(signature: string, helperDefinitions: {
+    constructor(io: CommandIO, signature: string, helperDefinitions: {
         [key: string]: string;
     }, defaultCommandOptions: CommandOption<any>[], ...args: any[]);
     option(name: string): any;
@@ -42,5 +44,5 @@ export declare class CommandParser {
     private parseSignature;
     private parseDefaultOptions;
     private parseParamSignature;
-    validate(): void;
+    validate(): Promise<void>;
 }

package/dist/types/src/CommandRegistry.d.ts

@@ -1,8 +1,11 @@
 import { Command } from './Command.js';
+import { CommandIO } from './CommandIO.js';
 export type CommandResolver = (path: string) => Promise<Command>;
 export declare class CommandRegistry {
     private readonly commands;
+    protected readonly io: CommandIO;
     get commandSuffix(): string;
+    protected get CommandIOClass(): typeof CommandIO;
     constructor();
     getAvailableCommands(): string[];
     getCommands(): Command[];

package/dist/types/src/errors/CommandNotFoundError.d.ts

@@ -1,7 +1,6 @@
 import { BobError } from './BobError.js';
 export declare class CommandNotFoundError extends BobError {
     readonly command: string;
-    readonly similarCommands: string[];
-    constructor(command: string, similarCommands: string[]);
+    constructor(command: string);
     pretty(): void;
 }

package/dist/types/src/index.d.ts

@@ -1,4 +1,5 @@
 export * from './Command.js';
+export * from './CommandIO.js';
 export * from './Cli.js';
 export * from './errors/index.js';
 export * from './contracts/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bob-core",
-  "version": "1.2.4",
+  "version": "1.3.1",
   "description": "BOB Core",
   "type": "module",
   "files": [