bob-core 2.0.0-beta.14 → 2.0.0-beta.15

package/dist/cjs/index.js

@@ -1,17 +1,17 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("prompts"),a=require("chalk"),H=require("minimist"),T=require("node:fs"),S=require("path"),W=require("string-similarity");function N(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 M=N(T),_=N(W);class R{logger;constructor(e){this.logger=e}log(...e){this.logger.log(...e)}info(...e){this.logger.info(...e)}warn(...e){this.logger.warn(...e)}error(...e){this.logger.error(...e)}debug(...e){this.logger.debug(...e)}async askForConfirmation(e="Do you want to continue?",t){return(await y({type:"confirm",name:"value",message:e,initial:t??!1})).value}async askForInput(e,t,n){return(await y({type:"text",name:"value",message:e,initial:t,...n}))?.value??null}async askForDate(e,t,n){return(await y({type:"date",name:"value",message:e,initial:t,...n}))?.value??null}async askForList(e,t,n){return(await y({type:"list",name:"value",message:e,initial:t,...n}))?.value??null}async askForToggle(e,t,n){return(await y({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 i=[];for(const o of t)typeof o=="string"?i.push({title:o,value:o}):i.push(o);return(await y({type:"select",name:"value",message:e,choices:i,...n}))?.value??null}newLoader(e="",t=["⠙","⠘","⠰","⠴","⠤","⠦","⠆","⠃","⠋","⠉"],n=100){let i=e,s=null,o=0;const u=setInterval(function(){s&&(process.stdout.write(new TextEncoder().encode("\r"+" ".repeat(s.length+5)+"\r")),s=null),process.stdout.write(new TextEncoder().encode("\r"+t[o++]+" "+i)),o=o%t.length},n),m=()=>{clearInterval(u),process.stdout.write(new TextEncoder().encode("\r"+" ".repeat(i.length+5)+"\r"))};return{[Symbol.dispose]:m,[Symbol.asyncDispose]:m,updateText:c=>{s=i,i=c},stop:m}}}class f extends Error{}function q(r){if(r==="string"||r==="number")return null;if(r==="boolean")return!1;if(Array.isArray(r)&&r.length===1){if(r[0]==="string")return[];if(r[0]==="number")return[]}throw new Error("Invalid option type: "+r)}function k(r){return typeof r=="string"||Array.isArray(r)?q(r):r.default!==void 0?r.default:q(r.type)}function g(r){return typeof r=="string"||Array.isArray(r)?{alias:[],default:k(r),description:"",required:!1,secret:!1,type:r,variadic:!1}:{alias:r.alias?Array.isArray(r.alias)?r.alias:[r.alias]:[],default:r.default??k(r.type),description:r.description??"",required:r.required??!1,secret:r.secret??!1,type:r.type,variadic:r.variadic??!1}}class b extends f{constructor(e,t={}){super(`Invalid option ${e} in not recognized`),this.option=e,this.optionsSchema=t}pretty(e){const t=Object.entries(this.optionsSchema);if(t.length>0){e.log(`
-${a.yellow("Available options")}:`);for(const[n,i]of t){const s=g(i),o=typeof s.alias=="string"?[s.alias]:s.alias,u=Array.isArray(s.type)?`[${s.type[0]}]`:s.type,m=`--${n}${o.length>0?o.map(l=>`, -${l}`).join(""):""}`,c=" ".repeat(30-m.length);e.log(`  ${a.green(m)} ${c} ${s.description||"\b"} ${a.white(`(${u})`)}`)}e.log("")}e.log(`${a.white.bgRed(" ERROR ")} Option ${a.bold.yellow(this.option)} is not recognized.`)}}class O extends f{constructor(e){super(`Argument "${e}" is required.`),this.argument=e}pretty(e){e.log(`${a.white.bgRed(" ERROR ")} Argument ${a.bold.yellow(this.argument)} is required.`)}}class P extends f{constructor(e){super(`Argument "${e}" is required.`),this.option=e}pretty(e){e.log(`${a.white.bgRed(" ERROR ")} Option ${a.bold.yellow(this.option)} is required.`)}}class B extends f{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(e){e.log(`  ${a.white.bgRed(" ERROR ")} Argument ${a.bold.yellow(this.param.param)} value is invalid. `),(this.param.value||this.param.reason)&&e.log(""),this.param.value&&e.log(`  ${a.blue("Value")}: ${this.param.value}`),this.param.reason&&e.log(`  ${a.yellow("Reason")}: ${this.param.reason}`)}}class C extends f{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(e){e.log(`  ${a.white.bgRed(" ERROR ")} Option ${a.bold.yellow(this.param.option)} value is invalid. `),(this.param.value||this.param.reason)&&e.log(""),this.param.value&&e.log(`  ${a.blue("Value")}: ${this.param.value}`),this.param.reason&&e.log(`  ${a.yellow("Reason")}: ${this.param.reason}`)}}class L extends f{constructor(e){super(`Command "${e}" not found.`),this.command=e}pretty(e){e.log(`${a.bgRed(" ERROR ")} Command ${a.yellow(this.command)} not found.`)}}function w(r,e,t,n){if(r==null)return n??null;if(e==="string")return String(r);if(e==="number"){const i=Number(r);if(isNaN(i))throw new C({option:t,reason:`Expected a number, got "${r}"`});return i}if(e==="boolean")return typeof r=="boolean"?r:r==="true"||r==="1"?!0:r==="false"||r==="0"?!1:!!r;if(Array.isArray(e)){const i=e[0],s=Array.isArray(r)?r:[r];if(i==="string")return s.map(o=>String(o));if(i==="number")return s.map(o=>{const u=Number(o);if(isNaN(u))throw new C({option:t,reason:`Expected array of numbers, got "${o}" in array`});return u})}return r}class x{options;parsedOptions=null;arguments;parsedArguments=null;io;shouldPromptForMissingOptions=!0;constructor(e){this.options=e.options,this.arguments=e.arguments,this.io=e.io}init(e){const{_:t,...n}=H(e);return this.validateUnknownOptions(n),this.parsedOptions=this.handleOptions(n),this.parsedArguments=this.handleArguments(t),{options:this.parsedOptions,arguments:this.parsedArguments}}async validate(){for(const e in this.options)if(g(this.options[e]).required&&(this.parsedOptions?.[e]===void 0||this.parsedOptions?.[e]===null))throw new P(e);for(const e in this.arguments){const t=g(this.arguments[e]),n=this.parsedArguments?.[e];if(t.required&&n==null){if(this.shouldPromptForMissingOptions){const i=await this.promptForArgument(e,t);if(i&&this.parsedArguments){this.parsedArguments[e]=w(i,t.type,e);continue}}throw new O(e)}if(t.required&&t.variadic&&Array.isArray(n)&&n.length===0){if(this.shouldPromptForMissingOptions){const i=await this.promptForArgument(e,t);if(i&&this.parsedArguments){this.parsedArguments[e]=w(i,t.type,e);continue}}throw new O(e)}}}option(e,t){if(!this.parsedOptions)throw new Error("Options have not been parsed yet. Call init() first.");return this.isEmptyValue(this.parsedOptions[e])&&t!==void 0?t:this.parsedOptions[e]}setOption(e,t){if(!this.parsedOptions)throw new Error("Options have not been parsed yet. Call init() first.");if(!(e in this.options))throw new b(e,this.options);this.parsedOptions[e]=t}argument(e,t){if(!this.parsedArguments)throw new Error("Arguments have not been parsed yet. Call init() first.");return this.isEmptyValue(this.parsedArguments[e])&&t!==void 0?t:this.parsedArguments[e]}setArgument(e,t){if(!this.parsedArguments)throw new Error("Arguments have not been parsed yet. Call init() first.");if(!(e in this.arguments))throw new b(e,this.arguments);this.parsedArguments[e]=t}isEmptyValue(e){return e==null||Array.isArray(e)&&e.length===0}validateUnknownOptions(e){const t=new Set;for(const n in this.options){t.add(n);const i=g(this.options[n]);for(const s of i.alias)t.add(s)}for(const n in e)if(!t.has(n))throw new b(n,this.options)}handleOptions(e){const t={};for(const n in this.options){const i=g(this.options[n]);t[n]=this.resolveOptionValue(n,i,e)}return t}handleArguments(e){const t={},n=[...e];for(const i in this.arguments){const s=g(this.arguments[i]);if(s.variadic){t[i]=this.handleVariadicArgument(i,s,n);continue}t[i]=this.resolveArgumentValue(i,s,n.shift())}return t}handleVariadicArgument(e,t,n){return n.length?w(n,t.type,e,t.default):t.default}resolveArgumentValue(e,t,n){return n===void 0?t.default:w(n,t.type,e,t.default)}resolveOptionValue(e,t,n){let i;const s=[e,...t.alias];for(const o of s)if(o in n){i=n[o];break}if(i===void 0){if(t.required)throw new C({option:e,reason:"Required option is missing"});return t.default}return w(i,t.type,e,t.default)}optionDefinitions(){const e={};for(const t in this.options)e[t]=g(this.options[t]);return e}argumentDefinitions(){const e={};for(const t in this.arguments)e[t]=g(this.arguments[t]);return e}availableOptions(){return Object.keys(this.options)}availableArguments(){return Object.keys(this.arguments)}disablePrompting(){return this.shouldPromptForMissingOptions=!1,this}async promptForArgument(e,t){if(!Array.isArray(t.type)&&!["string","number","secret"].includes(t.type))return null;let n=`${a.yellow.bold(e)} is required`;return t.description&&(n+=`: ${a.gray(`(${t.description})`)}`),n+=` ${a.green(`(${t.type}${t.variadic==!0?"[]":""})`)}
-`,Array.isArray(t.type)?(n+=`Please provide one or more values, separated by commas:
-`,await this.io.askForList(n,void 0,{separator:",",validate:i=>{if(!i.length)return"Please enter at least one value";if(t.type[0]==="number"){for(const s of i.split(","))if(isNaN(Number(s)))return"Please enter only valid numbers"}return!0}})):await this.io.askForInput(n,void 0,{type:t.type==="number"?"number":t.secret?"password":"text",validate:i=>{if(i==null||typeof i=="string"&&!i.length)return"This value is required";if(t.type==="number"){const s=Number(i);if(isNaN(s))return"Please enter a valid number"}else if(t.type==="string"&&(typeof i!="string"||!i.length))return"Please enter a valid text";return!0}})}}function A(r){return new Array(r+5).join(" ")}class V{type="boolean";option="help";alias=["h"];default=!1;description=`Display help for the given command. When no command is given display help for the ${a.green("list")} command`;async handler(){const e=this.parser.argumentDefinitions(),t=this.parser.optionDefinitions(),n=Object.entries(e),i=Object.entries(t),s=i.map(([l,d])=>{const p=Array.isArray(d.alias)?d.alias:d.alias?[d.alias]:[];return{name:l,...d,optionWithAlias:`--${l}${p.map(h=>`, -${h}`).join("")}`}}),o=n.filter(([,l])=>l.required);this.io.log(a.yellow("Description:")),this.io.log(`  ${this.description}
-`),this.io.log(a.yellow("Usage:")),this.io.log(`  ${this.command} ${o.length>0?o.map(([l])=>`<${l}>`).join(" "):"\b"} [options]`);const u=Math.max(...s.map(l=>l.optionWithAlias.length),0),m=Math.max(...n.map(([l])=>l.length),0),c=m>u?m:u;if(n.length>0){this.io.log(`
-${a.yellow("Arguments")}:`);for(const[l,d]of n){const p=A(c-l.length);let h=`  ${a.green(l)} ${p} ${d.description??"\b"}`;if(d.default!==void 0&&!d.required){const j=(Array.isArray(d.type)?`[${d.type[0]}]`:d.type)==="array"||Array.isArray(d.type)?JSON.stringify(d.default):d.default;h+=` ${a.yellow(`[default: ${j}]`)}`}d.variadic&&(h+=` ${a.white("(variadic)")}`),this.io.log(h)}}if(i.length>0){this.io.log(`
-${a.yellow("Options")}:`);for(const l of s){const d=A(c-l.optionWithAlias.length);let p=`${a.green(l.optionWithAlias)} ${d} ${l.description??"\b"}`;if(l.type){const h=Array.isArray(l.type)?`[${l.type[0]}]`:l.type;p+=` ${a.white(`(${h})`)}`}if(l.default!==void 0&&!l.required){const F=(Array.isArray(l.type)?`[${l.type[0]}]`:l.type)==="array"||Array.isArray(l.type)?JSON.stringify(l.default):l.default;p+=` ${a.yellow(`[default: ${F}]`)}`}this.io.log(p)}}if(this.commandsExamples.length>0){this.io.log(`
-${a.yellow("Examples")}:`);let l=process.argv[0].split("/").pop();l==="node"&&(l+=" "+process.argv[1].split("/").pop());for(const[d,p]of this.commandsExamples.entries())d>0&&this.io.log(""),this.io.log(`  ${p.description}
-`),this.io.log(`    ${a.green(`${l} ${p.command}`)}`)}return-1}}class v{_command;description;group;commandsExamples=[];get command(){return this._command}ctx;io;logger;parser;disablePromptingFlag=!1;_preHandler;_handler;tmp;defaultOptions(){return[new V]}newCommandParser(e){return new x({io:e.io,options:e.options,arguments:e.arguments})}newCommandIO(e){return new R(e.logger)}constructor(e,t){this._command=e,this.description=t?.description??"",this.group=t?.group,this.tmp={options:t?.options??{},arguments:t?.arguments??{}};const n=this.defaultOptions();if(n.length>0)for(const i of n)this.tmp.options[i.option]=i}disablePrompting(){return this.disablePromptingFlag=!0,this}preHandler(e){return this._preHandler=e,this}handler(e){return this._handler=e,this}options(e){return this.tmp={options:{...this.tmp?.options??{},...e},arguments:this.tmp?.arguments??{}},this}arguments(e){return this.tmp={options:this.tmp?.options??{},arguments:{...this.tmp?.arguments??{},...e}},this}async run(e){if(!this._handler&&!this.handle)throw new Error(`No handler defined for command ${this.command||"(unknown)"}`);let t;if(this.ctx=e.ctx,this.logger=e.logger,this.io=this.newCommandIO({logger:e.logger}),e&&"args"in e){const s=this.tmp?.options??{};for(const o of this.defaultOptions())o.option in s||(s[o.option]=o);this.parser=this.newCommandParser({io:this.io,options:s,arguments:this.tmp?.arguments??{}}),t=this.parser.init(e.args);for(const o of this.defaultOptions())if(t.options[o.option]===!0){const u=await o.handler.call(this);if(u&&u!==0)return u}this.disablePromptingFlag&&this.parser.disablePrompting(),await this.parser.validate()}else t={options:e.options,arguments:e.arguments};const n=this.preHandle?await this.preHandle():null;if(n&&n!==0)return n;if(!this._handler&&this.handle)this._handler=this.handle.bind(this);else if(!this._handler)throw new Error(`No handler defined for command ${this.command||"(unknown)"}`);return await this._handler(e.ctx,t)??0}}class $ extends x{command;constructor(e){const t=$.parseSignature(e.signature,e.helperDefinitions,e.defaultOptions);super({io:e.io,options:t.options,arguments:t.arguments}),this.command=t.command}static parseSignature(e,t,n){const[i,...s]=e.split(/\{(.*?)\}/g).map(m=>m.trim()).filter(Boolean),o={},u={};for(const m of s){const{name:c,isOption:l,definition:d}=$.parseParamSignature(m,t);l?o[c]=d:u[c]=d}for(const m of n)o[m.option]={type:m.type,required:m.required,alias:m.alias,variadic:m.variadic??!1,description:m.description,default:m.default??null};return{command:i,options:o,arguments:u}}static parseParamSignature(e,t){let n=e,i=!1;const s={required:!0,type:"string",description:void 0,default:null,variadic:!1};if(n.includes(":")){const[o,u]=n.split(":");n=o.trim(),s.description=u.trim()}if(n.includes("=")){const[o,u]=n.split("=");n=o.trim(),s.default=u.trim(),s.required=!1,typeof s.default=="string"&&!s.default.length?s.default=null:s.default==="true"?(s.default=!0,s.type="boolean"):s.default==="false"&&(s.default=!1,s.type="boolean")}else n.startsWith("--")&&(s.required=!1,s.default=!1,s.type="boolean");if(n.includes("|")){const[o,...u]=n.split("|");n=o.trim(),s.alias=u.map(m=>m.trim())}return n.startsWith("--")&&(i=!0,n=n.slice(2)),s.default==="*"&&(s.default=[],s.type=["string"]),n.endsWith("?")&&(s.required=!1,n=n.slice(0,-1)),n.endsWith("*")&&(s.type=["string"],s.variadic=!0,s.default=[],n=n.slice(0,-1)),s.description=s.description??t[n]??t[`--${n}`],{name:n,isOption:i,definition:s}}}class G extends v{helperDefinitions={};get command(){return this.parser?this.parser.command:this.signature.split(" ")[0]}newCommandParser(e){return new $({io:e.io,signature:this.signature,helperDefinitions:this.helperDefinitions,defaultOptions:this.defaultOptions()})}constructor(){super("")}option(e,t=null){return this.parser.option(e,t)}argument(e,t=null){return this.parser.argument(e,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 E{level;constructor(e={}){this.level=e.level??"info"}shouldLog(e){const t=["debug","info","warn","error"],n=t.indexOf(this.level);return t.indexOf(e)>=n}setLevel(e){this.level=e}getLevel(){return this.level}log(...e){console.log(...e)}info(...e){this.shouldLog("info")&&console.log(...e)}warn(...e){this.shouldLog("warn")&&console.warn(...e)}error(...e){this.shouldLog("error")&&console.error(...e)}debug(...e){this.shouldLog("debug")&&console.log(...e)}}class I{commands={};io;logger;get CommandIOClass(){return R}constructor(e){this.logger=e??new E,this.io=new this.CommandIOClass(this.logger)}getAvailableCommands(){return Object.keys(this.commands)}getCommands(){return Object.values(this.commands)}importFile=async e=>(await import(e)).default;commandResolver=async e=>{let t=await this.importFile(e);if(!t)throw new Error(`The command at path ${e} does not have a default export.`);return t&&typeof t=="object"&&"default"in t&&(t=t.default),typeof t=="function"?new t:t instanceof v?t:null};withCommandResolver(e){return this.commandResolver=e,this}withFileImporter(e){return this.importFile=e,this}registerCommand(e,t=!1){const n=e.command;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);n instanceof v&&this.registerCommand(n)}catch(n){throw new Error(`Command ${t} failed to load. ${n}`,{cause:n})}}async runCommand(e,t,...n){const i=typeof t=="string"?this.commands[t]:t,s=typeof t=="string"?t:i.command;if(!i){const o=await this.suggestCommand(s);return o?await this.runCommand(e,o,...n):1}return await i.run({ctx:e,logger:this.logger,args:n})??0}async suggestCommand(e){const t=this.getAvailableCommands(),{bestMatch:n,bestMatchIndex:i,ratings:s}=_.findBestMatch(e,t),o=s.filter(u=>u.rating>.3).map(u=>u.target);if(n.rating>0&&o.length<=1||n.rating>.7&&o.length>1){const u=t[i];return await this.askRunSimilarCommand(e,u)?u:null}if(o.length){this.io.error(`${a.bgRed(" ERROR ")} Command ${a.yellow(e)} not found.
-`);const u=await this.io.askForSelect(a.green("Did you mean to run one of these commands instead?"),o);if(u)return u}throw new L(e)}async askRunSimilarCommand(e,t){return this.io.error(`${a.bgRed(" ERROR ")} Command ${a.yellow(e)} not found.
-`),this.io.askForConfirmation(`${a.green(`Do you want to run ${a.yellow(t)} instead?`)} `)}async*listCommandsFiles(e){const t=M.readdirSync(e,{withFileTypes:!0});for(const n of t){const i=S.resolve(e,n.name);if(n.isDirectory())yield*this.listCommandsFiles(S.resolve(e,n.name));else{if(!i.endsWith(".ts")&&!i.endsWith(".js")&&!i.endsWith(".mjs")&&!i.endsWith(".cjs"))continue;yield i}}}}class D{logger;constructor(e){this.logger=e}handle(e){if(e instanceof f)return e.pretty(this.logger),-1;throw e}}class U extends v{constructor(e){super("help",{description:a.bold("Show help information about the CLI and its commands")}),this.opts=e}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-BfDTyN7_.cjs")))?.default?.version??"0.0.0";this.io.log(`${t} ${a.green(n)} (core: ${a.yellow(i)})
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("prompts"),a=require("chalk"),H=require("minimist"),M=require("node:fs"),F=require("path");function T(s){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(s){for(const e in s)if(e!=="default"){const i=Object.getOwnPropertyDescriptor(s,e);Object.defineProperty(t,e,i.get?i:{enumerable:!0,get:()=>s[e]})}}return t.default=s,Object.freeze(t)}const W=T(M);class R{logger;constructor(t){this.logger=t.logger}log(...t){this.logger.log(...t)}info(...t){this.logger.info(...t)}warn(...t){this.logger.warn(...t)}error(...t){this.logger.error(...t)}debug(...t){this.logger.debug(...t)}async askForConfirmation(t="Do you want to continue?",e){return(await y({type:"confirm",name:"value",message:t,initial:e??!1})).value}async askForInput(t,e,i){return(await y({type:"text",name:"value",message:t,initial:e,...i}))?.value??null}async askForDate(t,e,i){return(await y({type:"date",name:"value",message:t,initial:e,...i}))?.value??null}async askForList(t,e,i){return(await y({type:"list",name:"value",message:t,initial:e,...i}))?.value??null}async askForToggle(t,e,i){return(await y({type:"toggle",name:"value",message:t,initial:e,...i}))?.value??null}async askForSelect(t,e,i){if(e.length===0)throw new Error("No options provided");const n=[];for(const o of e)typeof o=="string"?n.push({title:o,value:o}):n.push(o);return(await y({type:"select",name:"value",message:t,choices:n,...i}))?.value??null}newLoader(t="",e=["⠙","⠘","⠰","⠴","⠤","⠦","⠆","⠃","⠋","⠉"],i=100){let n=t,r=null,o=0;const m=setInterval(function(){r&&(process.stdout.write(new TextEncoder().encode("\r"+" ".repeat(r.length+5)+"\r")),r=null),process.stdout.write(new TextEncoder().encode("\r"+e[o++]+" "+n)),o=o%e.length},i),u=()=>{clearInterval(m),process.stdout.write(new TextEncoder().encode("\r"+" ".repeat(n.length+5)+"\r"))};return{[Symbol.dispose]:u,[Symbol.asyncDispose]:u,updateText:c=>{r=n,n=c},stop:u}}}class f extends Error{}function k(s){if(s==="string"||s==="number")return null;if(s==="boolean")return!1;if(Array.isArray(s)&&s.length===1){if(s[0]==="string")return[];if(s[0]==="number")return[]}throw new Error("Invalid option type: "+s)}function q(s){return typeof s=="string"||Array.isArray(s)?k(s):s.default!==void 0?s.default:k(s.type)}function g(s){return typeof s=="string"||Array.isArray(s)?{alias:[],default:q(s),description:"",required:!1,secret:!1,type:s,variadic:!1}:{alias:s.alias?Array.isArray(s.alias)?s.alias:[s.alias]:[],default:s.default??q(s.type),description:s.description??"",required:s.required??!1,secret:s.secret??!1,type:s.type,variadic:s.variadic??!1}}class $ extends f{constructor(t,e={}){super(`Invalid option ${t} in not recognized`),this.option=t,this.optionsSchema=e}pretty(t){const e=Object.entries(this.optionsSchema);if(e.length>0){t.log(`
+${a.yellow("Available options")}:`);for(const[i,n]of e){const r=g(n),o=typeof r.alias=="string"?[r.alias]:r.alias,m=Array.isArray(r.type)?`[${r.type[0]}]`:r.type,u=`--${i}${o.length>0?o.map(l=>`, -${l}`).join(""):""}`,c=" ".repeat(30-u.length);t.log(`  ${a.green(u)} ${c} ${r.description||"\b"} ${a.white(`(${m})`)}`)}t.log("")}t.log(`${a.white.bgRed(" ERROR ")} Option ${a.bold.yellow(this.option)} is not recognized.`)}}class O extends f{constructor(t){super(`Argument "${t}" is required.`),this.argument=t}pretty(t){t.log(`${a.white.bgRed(" ERROR ")} Argument ${a.bold.yellow(this.argument)} is required.`)}}class N extends f{constructor(t){super(`Argument "${t}" is required.`),this.option=t}pretty(t){t.log(`${a.white.bgRed(" ERROR ")} Option ${a.bold.yellow(this.option)} is required.`)}}class B extends f{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(t){t.log(`  ${a.white.bgRed(" ERROR ")} Argument ${a.bold.yellow(this.param.param)} value is invalid. `),(this.param.value||this.param.reason)&&t.log(""),this.param.value&&t.log(`  ${a.blue("Value")}: ${this.param.value}`),this.param.reason&&t.log(`  ${a.yellow("Reason")}: ${this.param.reason}`)}}class C extends f{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(t){t.log(`  ${a.white.bgRed(" ERROR ")} Option ${a.bold.yellow(this.param.option)} value is invalid. `),(this.param.value||this.param.reason)&&t.log(""),this.param.value&&t.log(`  ${a.blue("Value")}: ${this.param.value}`),this.param.reason&&t.log(`  ${a.yellow("Reason")}: ${this.param.reason}`)}}class P extends f{constructor(t){super(`Command "${t}" not found.`),this.command=t}pretty(t){t.log(`${a.bgRed(" ERROR ")} Command ${a.yellow(this.command)} not found.`)}}function w(s,t,e,i){if(s==null)return i??null;if(t==="string")return String(s);if(t==="number"){const n=Number(s);if(isNaN(n))throw new C({option:e,reason:`Expected a number, got "${s}"`});return n}if(t==="boolean")return typeof s=="boolean"?s:s==="true"||s==="1"?!0:s==="false"||s==="0"?!1:!!s;if(Array.isArray(t)){const n=t[0],r=Array.isArray(s)?s:[s];if(n==="string")return r.map(o=>String(o));if(n==="number")return r.map(o=>{const m=Number(o);if(isNaN(m))throw new C({option:e,reason:`Expected array of numbers, got "${o}" in array`});return m})}return s}class x{options;parsedOptions=null;arguments;parsedArguments=null;io;shouldPromptForMissingOptions=!0;constructor(t){this.options=t.options,this.arguments=t.arguments,this.io=t.io}init(t){const{_:e,...i}=H(t);return this.validateUnknownOptions(i),this.parsedOptions=this.handleOptions(i),this.parsedArguments=this.handleArguments(e),{options:this.parsedOptions,arguments:this.parsedArguments}}async validate(){for(const t in this.options)if(g(this.options[t]).required&&(this.parsedOptions?.[t]===void 0||this.parsedOptions?.[t]===null))throw new N(t);for(const t in this.arguments){const e=g(this.arguments[t]),i=this.parsedArguments?.[t];if(e.required&&i==null){if(this.shouldPromptForMissingOptions){const n=await this.promptForArgument(t,e);if(n&&this.parsedArguments){this.parsedArguments[t]=w(n,e.type,t);continue}}throw new O(t)}if(e.required&&e.variadic&&Array.isArray(i)&&i.length===0){if(this.shouldPromptForMissingOptions){const n=await this.promptForArgument(t,e);if(n&&this.parsedArguments){this.parsedArguments[t]=w(n,e.type,t);continue}}throw new O(t)}}}option(t,e){if(!this.parsedOptions)throw new Error("Options have not been parsed yet. Call init() first.");return this.isEmptyValue(this.parsedOptions[t])&&e!==void 0?e:this.parsedOptions[t]}setOption(t,e){if(!this.parsedOptions)throw new Error("Options have not been parsed yet. Call init() first.");if(!(t in this.options))throw new $(t,this.options);this.parsedOptions[t]=e}argument(t,e){if(!this.parsedArguments)throw new Error("Arguments have not been parsed yet. Call init() first.");return this.isEmptyValue(this.parsedArguments[t])&&e!==void 0?e:this.parsedArguments[t]}setArgument(t,e){if(!this.parsedArguments)throw new Error("Arguments have not been parsed yet. Call init() first.");if(!(t in this.arguments))throw new $(t,this.arguments);this.parsedArguments[t]=e}isEmptyValue(t){return t==null||Array.isArray(t)&&t.length===0}validateUnknownOptions(t){const e=new Set;for(const i in this.options){e.add(i);const n=g(this.options[i]);for(const r of n.alias)e.add(r)}for(const i in t)if(!e.has(i))throw new $(i,this.options)}handleOptions(t){const e={};for(const i in this.options){const n=g(this.options[i]);e[i]=this.resolveOptionValue(i,n,t)}return e}handleArguments(t){const e={},i=[...t];for(const n in this.arguments){const r=g(this.arguments[n]);if(r.variadic){e[n]=this.handleVariadicArgument(n,r,i);continue}e[n]=this.resolveArgumentValue(n,r,i.shift())}return e}handleVariadicArgument(t,e,i){return i.length?w(i,e.type,t,e.default):e.default}resolveArgumentValue(t,e,i){return i===void 0?e.default:w(i,e.type,t,e.default)}resolveOptionValue(t,e,i){let n;const r=[t,...e.alias];for(const o of r)if(o in i){n=i[o];break}if(n===void 0){if(e.required)throw new C({option:t,reason:"Required option is missing"});return e.default}return w(n,e.type,t,e.default)}optionDefinitions(){const t={};for(const e in this.options)t[e]=g(this.options[e]);return t}argumentDefinitions(){const t={};for(const e in this.arguments)t[e]=g(this.arguments[e]);return t}availableOptions(){return Object.keys(this.options)}availableArguments(){return Object.keys(this.arguments)}disablePrompting(){return this.shouldPromptForMissingOptions=!1,this}async promptForArgument(t,e){if(!Array.isArray(e.type)&&!["string","number","secret"].includes(e.type))return null;let i=`${a.yellow.bold(t)} is required`;return e.description&&(i+=`: ${a.gray(`(${e.description})`)}`),i+=` ${a.green(`(${e.type}${e.variadic==!0?"[]":""})`)}
+`,Array.isArray(e.type)?(i+=`Please provide one or more values, separated by commas:
+`,await this.io.askForList(i,void 0,{separator:",",validate:n=>{if(!n.length)return"Please enter at least one value";if(e.type[0]==="number"){for(const r of n.split(","))if(isNaN(Number(r)))return"Please enter only valid numbers"}return!0}})):await this.io.askForInput(i,void 0,{type:e.type==="number"?"number":e.secret?"password":"text",validate:n=>{if(n==null||typeof n=="string"&&!n.length)return"This value is required";if(e.type==="number"){const r=Number(n);if(isNaN(r))return"Please enter a valid number"}else if(e.type==="string"&&(typeof n!="string"||!n.length))return"Please enter a valid text";return!0}})}}function A(s){return new Array(s+5).join(" ")}class L{type="boolean";option="help";alias=["h"];default=!1;description=`Display help for the given command. When no command is given display help for the ${a.green("list")} command`;async handler(){const t=this.parser.argumentDefinitions(),e=this.parser.optionDefinitions(),i=Object.entries(t),n=Object.entries(e),r=n.map(([l,d])=>{const h=Array.isArray(d.alias)?d.alias:d.alias?[d.alias]:[];return{name:l,...d,optionWithAlias:`--${l}${h.map(p=>`, -${p}`).join("")}`}}),o=i.filter(([,l])=>l.required);this.io.log(a.yellow("Description:")),this.io.log(`  ${this.description}
+`),this.io.log(a.yellow("Usage:")),this.io.log(`  ${this.command} ${o.length>0?o.map(([l])=>`<${l}>`).join(" "):"\b"} [options]`);const m=Math.max(...r.map(l=>l.optionWithAlias.length),0),u=Math.max(...i.map(([l])=>l.length),0),c=u>m?u:m;if(i.length>0){this.io.log(`
+${a.yellow("Arguments")}:`);for(const[l,d]of i){const h=A(c-l.length);let p=`  ${a.green(l)} ${h} ${d.description??"\b"}`;if(d.default!==void 0&&!d.required){const j=(Array.isArray(d.type)?`[${d.type[0]}]`:d.type)==="array"||Array.isArray(d.type)?JSON.stringify(d.default):d.default;p+=` ${a.yellow(`[default: ${j}]`)}`}d.variadic&&(p+=` ${a.white("(variadic)")}`),this.io.log(p)}}if(n.length>0){this.io.log(`
+${a.yellow("Options")}:`);for(const l of r){const d=A(c-l.optionWithAlias.length);let h=`${a.green(l.optionWithAlias)} ${d} ${l.description??"\b"}`;if(l.type){const p=Array.isArray(l.type)?`[${l.type[0]}]`:l.type;h+=` ${a.white(`(${p})`)}`}if(l.default!==void 0&&!l.required){const E=(Array.isArray(l.type)?`[${l.type[0]}]`:l.type)==="array"||Array.isArray(l.type)?JSON.stringify(l.default):l.default;h+=` ${a.yellow(`[default: ${E}]`)}`}this.io.log(h)}}if(this.commandsExamples.length>0){this.io.log(`
+${a.yellow("Examples")}:`);let l=process.argv[0].split("/").pop();l==="node"&&(l+=" "+process.argv[1].split("/").pop());for(const[d,h]of this.commandsExamples.entries())d>0&&this.io.log(""),this.io.log(`  ${h.description}
+`),this.io.log(`    ${a.green(`${l} ${h.command}`)}`)}return-1}}class v{_command;description;group;commandsExamples=[];get command(){return this._command}ctx;io;logger;parser;disablePromptingFlag=!1;_preHandler;_handler;tmp;defaultOptions(){return[new L]}newCommandParser(t){return new x({io:t.io,options:t.options,arguments:t.arguments})}newCommandIO(t){return new R(t)}constructor(t,e){this._command=t,this.description=e?.description??"",this.group=e?.group,this.tmp={options:e?.options??{},arguments:e?.arguments??{}};const i=this.defaultOptions();if(i.length>0)for(const n of i)this.tmp.options[n.option]=n}disablePrompting(){return this.disablePromptingFlag=!0,this}preHandler(t){return this._preHandler=t,this}handler(t){return this._handler=t,this}options(t){return this.tmp={options:{...this.tmp?.options??{},...t},arguments:this.tmp?.arguments??{}},this}arguments(t){return this.tmp={options:this.tmp?.options??{},arguments:{...this.tmp?.arguments??{},...t}},this}async run(t){if(!this._handler&&!this.handle)throw new Error(`No handler defined for command ${this.command||"(unknown)"}`);let e;if(this.ctx=t.ctx,this.logger=t.logger,this.io=this.newCommandIO({logger:t.logger}),t&&"args"in t){const r=this.tmp?.options??{};for(const o of this.defaultOptions())o.option in r||(r[o.option]=o);this.parser=this.newCommandParser({io:this.io,options:r,arguments:this.tmp?.arguments??{}}),e=this.parser.init(t.args);for(const o of this.defaultOptions())if(e.options[o.option]===!0){const m=await o.handler.call(this);if(m&&m!==0)return m}this.disablePromptingFlag&&this.parser.disablePrompting(),await this.parser.validate()}else e={options:t.options,arguments:t.arguments};const i=this.preHandle?await this.preHandle():null;if(i&&i!==0)return i;if(!this._handler&&this.handle)this._handler=this.handle.bind(this);else if(!this._handler)throw new Error(`No handler defined for command ${this.command||"(unknown)"}`);return await this._handler(t.ctx,e)??0}}class b extends x{command;constructor(t){const e=b.parseSignature(t.signature,t.helperDefinitions,t.defaultOptions);super({io:t.io,options:e.options,arguments:e.arguments}),this.command=e.command}static parseSignature(t,e,i){const[n,...r]=t.split(/\{(.*?)\}/g).map(u=>u.trim()).filter(Boolean),o={},m={};for(const u of r){const{name:c,isOption:l,definition:d}=b.parseParamSignature(u,e);l?o[c]=d:m[c]=d}for(const u of i)o[u.option]={type:u.type,required:u.required,alias:u.alias,variadic:u.variadic??!1,description:u.description,default:u.default??null};return{command:n,options:o,arguments:m}}static parseParamSignature(t,e){let i=t,n=!1;const r={required:!0,type:"string",description:void 0,default:null,variadic:!1};if(i.includes(":")){const[o,m]=i.split(":");i=o.trim(),r.description=m.trim()}if(i.includes("=")){const[o,m]=i.split("=");i=o.trim(),r.default=m.trim(),r.required=!1,typeof r.default=="string"&&!r.default.length?r.default=null:r.default==="true"?(r.default=!0,r.type="boolean"):r.default==="false"&&(r.default=!1,r.type="boolean")}else i.startsWith("--")&&(r.required=!1,r.default=!1,r.type="boolean");if(i.includes("|")){const[o,...m]=i.split("|");i=o.trim(),r.alias=m.map(u=>u.trim())}return i.startsWith("--")&&(n=!0,i=i.slice(2)),r.default==="*"&&(r.default=[],r.type=["string"]),i.endsWith("?")&&(r.required=!1,i=i.slice(0,-1)),i.endsWith("*")&&(r.type=["string"],r.variadic=!0,r.default=[],i=i.slice(0,-1)),r.description=r.description??e[i]??e[`--${i}`],{name:i,isOption:n,definition:r}}}class _ extends v{helperDefinitions={};get command(){return this.parser?this.parser.command:this.signature.split(" ")[0]}newCommandParser(t){return new b({io:t.io,signature:this.signature,helperDefinitions:this.helperDefinitions,defaultOptions:this.defaultOptions()})}constructor(){super("")}option(t,e=null){return this.parser.option(t,e)}argument(t,e=null){return this.parser.argument(t,e)}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 S{level;constructor(t={}){this.level=t.level??"info"}shouldLog(t){const e=["debug","info","warn","error"],i=e.indexOf(this.level);return e.indexOf(t)>=i}setLevel(t){this.level=t}getLevel(){return this.level}log(...t){console.log(...t)}info(...t){this.shouldLog("info")&&console.log(...t)}warn(...t){this.shouldLog("warn")&&console.warn(...t)}error(...t){this.shouldLog("error")&&console.error(...t)}debug(...t){this.shouldLog("debug")&&console.log(...t)}}class I{getBigrams(t){const e=[],i=t.toLowerCase();for(let n=0;n<i.length-1;n++)e.push(i.slice(n,n+2));return e}calculateSimilarity(t,e){if(t===e)return 1;if(t.length<2||e.length<2)return 0;const i=this.getBigrams(t),n=this.getBigrams(e),r=new Set(n);let o=0;for(const m of i)r.has(m)&&(o++,r.delete(m));return 2*o/(i.length+n.length)}findBestMatch(t,e){const i=e.map(o=>({target:o,rating:this.calculateSimilarity(t,o)}));let n=0,r=i[0]?.rating??0;for(let o=1;o<i.length;o++)i[o].rating>r&&(r=i[o].rating,n=o);return{ratings:i,bestMatch:i[n],bestMatchIndex:n}}}class V{commands={};io;logger;stringSimilarity;newCommandIO(t){return new R(t)}constructor(t){this.logger=t?.logger??new S,this.io=this.newCommandIO({logger:this.logger}),this.stringSimilarity=t?.stringSimilarity??new I}getAvailableCommands(){return Object.keys(this.commands)}getCommands(){return Object.values(this.commands)}importFile=async t=>(await import(t)).default;commandResolver=async t=>{let e=await this.importFile(t);if(!e)throw new Error(`The command at path ${t} does not have a default export.`);return e&&typeof e=="object"&&"default"in e&&(e=e.default),typeof e=="function"?new e:e instanceof v?e:null};withCommandResolver(t){return this.commandResolver=t,this}withFileImporter(t){return this.importFile=t,this}registerCommand(t,e=!1){const i=t.command;if(!i)throw new Error("Command signature is invalid, it must have a command name.");if(!e&&this.commands[i])throw new Error(`Command ${i} already registered.`);this.commands[i]=t}async loadCommandsPath(t){for await(const e of this.listCommandsFiles(t))try{const i=await this.commandResolver(e);i instanceof v&&this.registerCommand(i)}catch(i){throw new Error(`Command ${e} failed to load. ${i}`,{cause:i})}}async runCommand(t,e,...i){const n=typeof e=="string"?this.commands[e]:e,r=typeof e=="string"?e:n.command;if(!n){const o=await this.suggestCommand(r);return o?await this.runCommand(t,o,...i):1}return await n.run({ctx:t,logger:this.logger,args:i})??0}async suggestCommand(t){const e=this.getAvailableCommands(),{bestMatch:i,bestMatchIndex:n,ratings:r}=this.stringSimilarity.findBestMatch(t,e),o=r.filter(m=>m.rating>.3).map(m=>m.target);if(i.rating>0&&o.length<=1||i.rating>.7&&o.length>1){const m=e[n];return await this.askRunSimilarCommand(t,m)?m:null}if(o.length){this.io.error(`${a.bgRed(" ERROR ")} Command ${a.yellow(t)} not found.
+`);const m=await this.io.askForSelect(a.green("Did you mean to run one of these commands instead?"),o);if(m)return m}throw new P(t)}async askRunSimilarCommand(t,e){return this.io.error(`${a.bgRed(" ERROR ")} Command ${a.yellow(t)} not found.
+`),this.io.askForConfirmation(`${a.green(`Do you want to run ${a.yellow(e)} instead?`)} `)}async*listCommandsFiles(t){const e=W.readdirSync(t,{withFileTypes:!0});for(const i of e){const n=F.resolve(t,i.name);if(i.isDirectory())yield*this.listCommandsFiles(F.resolve(t,i.name));else{if(!n.endsWith(".ts")&&!n.endsWith(".js")&&!n.endsWith(".mjs")&&!n.endsWith(".cjs"))continue;yield n}}}}class D{logger;constructor(t){this.logger=t}handle(t){if(t instanceof f)return t.pretty(this.logger),-1;throw t}}class G extends v{constructor(t){super("help",{description:a.bold("Show help information about the CLI and its commands")}),this.opts=t}async handle(){const t=this.opts.commandRegistry.getCommands(),e=this.opts.cliName??"Bob CLI",i=this.opts.cliVersion??"0.0.0",n=(await Promise.resolve().then(()=>require("./package-o2EGFSAP.cjs")))?.default?.version??"0.0.0";this.io.log(`${e} ${a.green(i)} (core: ${a.yellow(n)})
 
 ${a.yellow("Usage")}:
   command [options] [arguments]
 
 ${a.yellow("Available commands")}:
-`);const s=Math.max(...e.map(m=>m.command.length))??0,o={};for(const m of e){const c=m.group??m.command.split(":")[0];o[c]||(o[c]=[]),o[c].push(m)}const u=Object.entries(o).sort(([m],[c])=>m.toLowerCase().localeCompare(c.toLowerCase())).sort(([,m],[,c])=>m.length-c.length);for(const[m,c]of u){const l=c.length>1;l&&this.io.log(a.yellow(`${m}:`));const d=c.sort((p,h)=>p.command.toLowerCase().localeCompare(h.command.toLowerCase()));for(const p of d){let h=A(s-p.command.length);l&&(h=h.slice(2)),this.io.log(`${l?"  ":""}${a.green(p.command)} ${h} ${p.description}`)}}}}class z{ctx;logger;commandRegistry;exceptionHandler;helpCommand;newCommandRegistry(e){return new I(e.logger)}newHelpCommand(e){return new U(e)}newExceptionHandler(e){return new D(e.logger)}constructor(e={}){this.ctx=e.ctx,this.logger=e.logger??new E,this.commandRegistry=this.newCommandRegistry({logger:this.logger}),this.exceptionHandler=this.newExceptionHandler({logger:this.logger}),this.helpCommand=this.newHelpCommand({cliName:e.name,cliVersion:e.version,commandRegistry:this.commandRegistry})}withCommandResolver(e){return this.commandRegistry.withCommandResolver(e),this}withFileImporter(e){return this.commandRegistry.withFileImporter(e),this}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.bind(this.exceptionHandler)):await this.runHelpCommand()}async runHelpCommand(){return await this.runCommand(this.helpCommand)}registerCommand(e){this.commandRegistry.registerCommand(e)}}exports.BadCommandOption=C;exports.BadCommandParameter=B;exports.BobError=f;exports.Cli=z;exports.Command=v;exports.CommandIO=R;exports.CommandNotFoundError=L;exports.CommandParser=x;exports.CommandRegistry=I;exports.CommandSignatureParser=$;exports.CommandWithSignature=G;exports.ExceptionHandler=D;exports.HelpOption=V;exports.InvalidOption=b;exports.Logger=E;exports.MissingRequiredArgumentValue=O;exports.MissingRequiredOptionValue=P;
+`);const r=Math.max(...t.map(u=>u.command.length))??0,o={};for(const u of t){const c=u.group??u.command.split(":")[0];o[c]||(o[c]=[]),o[c].push(u)}const m=Object.entries(o).sort(([u],[c])=>u.toLowerCase().localeCompare(c.toLowerCase())).sort(([,u],[,c])=>u.length-c.length);for(const[u,c]of m){const l=c.length>1;l&&this.io.log(a.yellow(`${u}:`));const d=c.sort((h,p)=>h.command.toLowerCase().localeCompare(p.command.toLowerCase()));for(const h of d){let p=A(r-h.command.length);l&&(p=p.slice(2)),this.io.log(`${l?"  ":""}${a.green(h.command)} ${p} ${h.description}`)}}}}class z{ctx;logger;commandRegistry;exceptionHandler;helpCommand;newCommandRegistry(t){return new V(t)}newHelpCommand(t){return new G(t)}newExceptionHandler(t){return new D(t.logger)}constructor(t={}){this.ctx=t.ctx,this.logger=t.logger??new S,this.commandRegistry=this.newCommandRegistry({logger:this.logger}),this.exceptionHandler=this.newExceptionHandler({logger:this.logger}),this.helpCommand=this.newHelpCommand({cliName:t.name,cliVersion:t.version,commandRegistry:this.commandRegistry})}withCommandResolver(t){return this.commandRegistry.withCommandResolver(t),this}withFileImporter(t){return this.commandRegistry.withFileImporter(t),this}async withCommands(...t){for(const e of t)typeof e=="string"?await this.commandRegistry.loadCommandsPath(e):typeof e=="function"?this.registerCommand(new e):this.registerCommand(e)}async runCommand(t,...e){return t?await this.commandRegistry.runCommand(this.ctx??{},t,...e).catch(this.exceptionHandler.handle.bind(this.exceptionHandler)):await this.runHelpCommand()}async runHelpCommand(){return await this.runCommand(this.helpCommand)}registerCommand(t){this.commandRegistry.registerCommand(t)}}exports.BadCommandOption=C;exports.BadCommandParameter=B;exports.BobError=f;exports.Cli=z;exports.Command=v;exports.CommandIO=R;exports.CommandNotFoundError=P;exports.CommandParser=x;exports.CommandRegistry=V;exports.CommandSignatureParser=b;exports.CommandWithSignature=_;exports.ExceptionHandler=D;exports.HelpOption=L;exports.InvalidOption=$;exports.Logger=S;exports.MissingRequiredArgumentValue=O;exports.MissingRequiredOptionValue=N;exports.StringSimilarity=I;

package/dist/cjs/{package-BfDTyN7_.cjs → package-o2EGFSAP.cjs}

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="bob-core",t="2.0.0-beta.14",s="BOB Core",i="module",n=!1,r=["dist/**"],o={".":{import:"./dist/esm/index.js",require:"./dist/cjs/index.js"}},c={"*":{"*":["./dist/cjs/*.d.ts"]}},p={start:"node -r @swc-node/register debug/main.ts",build:"rimraf ./dist && vite build",typecheck:"tsc --noEmit",prepack:"npm run build",test:"vitest run",lint:"eslint .","lint:fix":"eslint . --fix"},d="Léo Hubert",l="ISC",a={"@eslint/js":"^9.37.0","@faker-js/faker":"^10.0.0","@swc-node/register":"^1.11.1","@trivago/prettier-plugin-sort-imports":"^5.2.2","@types/minimist":"^1.2.5","@types/node":"^20.14.5","@types/prompts":"^2.4.9","@types/string-similarity":"^4.0.2","@vitest/coverage-v8":"^3.2.4",eslint:"^9.37.0","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.4",prettier:"^3.6.2",rimraf:"^6.0.1",tsx:"^4.20.6",typescript:"^5.7.3","typescript-eslint":"^8.46.0",vite:"^7.1.6","vite-plugin-dts":"^4.5.4",vitest:"^3.2.4"},m={chalk:"^5.6.2",minimist:"^1.2.8",prompts:"^2.4.2","string-similarity":"^4.0.4"},u={name:e,version:t,description:s,type:i,sideEffects:n,files:r,exports:o,typesVersions:c,scripts:p,author:d,license:l,devDependencies:a,dependencies:m};exports.author=d;exports.default=u;exports.dependencies=m;exports.description=s;exports.devDependencies=a;exports.exports=o;exports.files=r;exports.license=l;exports.name=e;exports.scripts=p;exports.sideEffects=n;exports.type=i;exports.typesVersions=c;exports.version=t;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="bob-core",t="2.0.0-beta.15",s="BOB Core",i="module",n=!1,r=["dist/**"],o={".":{import:"./dist/esm/index.js",require:"./dist/cjs/index.js"}},c={"*":{"*":["./dist/cjs/*.d.ts"]}},p={start:"node -r @swc-node/register debug/main.ts",build:"rimraf ./dist && vite build",typecheck:"tsc --noEmit",prepack:"npm run build",test:"vitest run",lint:"eslint .","lint:fix":"eslint . --fix"},d="Léo Hubert",l="ISC",a={"@eslint/js":"^9.37.0","@faker-js/faker":"^10.0.0","@swc-node/register":"^1.11.1","@trivago/prettier-plugin-sort-imports":"^5.2.2","@types/minimist":"^1.2.5","@types/node":"^20.14.5","@types/prompts":"^2.4.9","@types/string-similarity":"^4.0.2","@vitest/coverage-v8":"^3.2.4",eslint:"^9.37.0","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.4",prettier:"^3.6.2",rimraf:"^6.0.1",tsx:"^4.20.6",typescript:"^5.7.3","typescript-eslint":"^8.46.0",vite:"^7.1.6","vite-plugin-dts":"^4.5.4",vitest:"^3.2.4"},m={chalk:"^5.6.2",minimist:"^1.2.8",prompts:"^2.4.2"},u={name:e,version:t,description:s,type:i,sideEffects:n,files:r,exports:o,typesVersions:c,scripts:p,author:d,license:l,devDependencies:a,dependencies:m};exports.author=d;exports.default=u;exports.dependencies=m;exports.description=s;exports.devDependencies=a;exports.exports=o;exports.files=r;exports.license=l;exports.name=e;exports.scripts=p;exports.sideEffects=n;exports.type=i;exports.typesVersions=c;exports.version=t;

package/dist/cjs/src/Cli.d.ts

@@ -1,5 +1,5 @@
 import { Command } from './Command.js';
-import { CommandRegistry, CommandResolver, FileImporter } from './CommandRegistry.js';
+import { CommandRegistry, CommandRegistryOptions, CommandResolver, FileImporter } from './CommandRegistry.js';
 import { ExceptionHandler } from './ExceptionHandler.js';
 import { Logger } from './Logger.js';
 import { default as HelpCommand, HelpCommandOptions } from './commands/HelpCommand.js';
@@ -16,9 +16,7 @@ export declare class Cli<C extends ContextDefinition = ContextDefinition> {
     readonly commandRegistry: CommandRegistry;
     private readonly exceptionHandler;
     private readonly helpCommand;
-    protected newCommandRegistry(opts: {
-        logger: Logger;
-    }): CommandRegistry;
+    protected newCommandRegistry(opts: CommandRegistryOptions): CommandRegistry;
     protected newHelpCommand(opts: HelpCommandOptions): HelpCommand;
     protected newExceptionHandler(opts: {
         logger: Logger;

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

@@ -1,4 +1,4 @@
-import { CommandIO } from './CommandIO.js';
+import { CommandIO, CommandIOOptions } from './CommandIO.js';
 import { CommandParser } from './CommandParser.js';
 import { Logger } from './Logger.js';
 import { CommandOption } from './contracts/index.js';
@@ -43,9 +43,7 @@ export declare class Command<C extends ContextDefinition = ContextDefinition, Op
         options: Options;
         arguments: Arguments;
     }): CommandParser<Options, Arguments>;
-    protected newCommandIO(opts: {
-        logger: Logger;
-    }): CommandIO;
+    protected newCommandIO(opts: CommandIOOptions): CommandIO;
     constructor(command: string, opts?: {
         description?: string;
         group?: string;

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

@@ -6,9 +6,12 @@ export type SelectOption = {
     selected?: boolean | undefined;
     description?: string | undefined;
 };
+export type CommandIOOptions = {
+    logger: Logger;
+};
 export declare class CommandIO {
     private logger;
-    constructor(logger: Logger);
+    constructor(opts: CommandIOOptions);
     /**
      * Logger methods
      */

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

@@ -1,15 +1,21 @@
 import { Command } from './Command.js';
-import { CommandIO } from './CommandIO.js';
+import { CommandIO, CommandIOOptions } from './CommandIO.js';
 import { Logger } from './Logger.js';
+import { StringSimilarity } from './StringSimilarity.js';
 import { ArgumentsSchema, ContextDefinition, OptionsSchema } from './lib/types.js';
 export type CommandResolver = (path: string) => Promise<Command | null>;
 export type FileImporter = (filePath: string) => Promise<unknown>;
+export type CommandRegistryOptions = {
+    logger?: Logger;
+    stringSimilarity?: StringSimilarity;
+};
 export declare class CommandRegistry {
     private readonly commands;
     protected readonly io: CommandIO;
     protected readonly logger: Logger;
-    protected get CommandIOClass(): typeof CommandIO;
-    constructor(logger?: Logger);
+    private readonly stringSimilarity;
+    protected newCommandIO(opts: CommandIOOptions): CommandIO;
+    constructor(opts?: CommandRegistryOptions);
     getAvailableCommands(): string[];
     getCommands(): Array<Command>;
     private importFile;

package/dist/cjs/src/StringSimilarity.d.ts

@@ -0,0 +1,26 @@
+export interface SimilarityResult {
+    rating: number;
+    target: string;
+}
+export interface BestMatchResult {
+    bestMatch: SimilarityResult;
+    bestMatchIndex: number;
+    ratings: SimilarityResult[];
+}
+/**
+ * String similarity calculator using Dice's Coefficient algorithm
+ */
+export declare class StringSimilarity {
+    /**
+     * Generate bigrams (character pairs) from a string
+     */
+    private getBigrams;
+    /**
+     * Calculate Dice's Coefficient similarity between two strings (0-1 scale)
+     */
+    calculateSimilarity(str1: string, str2: string): number;
+    /**
+     * Find best matching string and ratings for all candidates
+     */
+    findBestMatch(target: string, candidates: string[]): BestMatchResult;
+}

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

@@ -7,6 +7,7 @@ export * from './CommandRegistry.js';
 export * from './Cli.js';
 export * from './Logger.js';
 export * from './ExceptionHandler.js';
+export * from './StringSimilarity.js';
 export * from './lib/types.js';
 export * from './errors/index.js';
 export * from './options/index.js';

package/dist/esm/index.js

@@ -1,13 +1,12 @@
 import y from "prompts";
 import a from "chalk";
-import L from "minimist";
-import * as V from "node:fs";
+import q from "minimist";
+import * as I from "node:fs";
 import R from "path";
-import * as I from "string-similarity";
-class k {
+class S {
   logger;
   constructor(t) {
-    this.logger = t;
+    this.logger = t.logger;
   }
   /**
    * Logger methods
@@ -77,31 +76,31 @@ class k {
   async askForSelect(t, e, i) {
     if (e.length === 0)
       throw new Error("No options provided");
-    const s = [];
+    const n = [];
     for (const o of e)
-      typeof o == "string" ? s.push({ title: o, value: o }) : s.push(o);
+      typeof o == "string" ? n.push({ title: o, value: o }) : n.push(o);
     return (await y({
       type: "select",
       name: "value",
       message: t,
-      choices: s,
+      choices: n,
       ...i
     }))?.value ?? null;
   }
   newLoader(t = "", e = ["⠙", "⠘", "⠰", "⠴", "⠤", "⠦", "⠆", "⠃", "⠋", "⠉"], i = 100) {
-    let s = t, n = null, o = 0;
-    const u = setInterval(function() {
-      n && (process.stdout.write(new TextEncoder().encode("\r" + " ".repeat(n.length + 5) + "\r")), n = null), process.stdout.write(new TextEncoder().encode("\r" + e[o++] + " " + s)), o = o % e.length;
-    }, i), m = () => {
-      clearInterval(u), process.stdout.write(new TextEncoder().encode("\r" + " ".repeat(s.length + 5) + "\r"));
+    let n = t, s = null, o = 0;
+    const m = setInterval(function() {
+      s && (process.stdout.write(new TextEncoder().encode("\r" + " ".repeat(s.length + 5) + "\r")), s = null), process.stdout.write(new TextEncoder().encode("\r" + e[o++] + " " + n)), o = o % e.length;
+    }, i), u = () => {
+      clearInterval(m), process.stdout.write(new TextEncoder().encode("\r" + " ".repeat(n.length + 5) + "\r"));
     };
     return {
-      [Symbol.dispose]: m,
-      [Symbol.asyncDispose]: m,
-      updateText: (p) => {
-        n = s, s = p;
+      [Symbol.dispose]: u,
+      [Symbol.asyncDispose]: u,
+      updateText: (h) => {
+        s = n, n = h;
       },
-      stop: m
+      stop: u
     };
   }
 }
@@ -147,9 +146,9 @@ class b extends f {
     if (e.length > 0) {
       t.log(`
 ${a.yellow("Available options")}:`);
-      for (const [i, s] of e) {
-        const n = g(s), o = typeof n.alias == "string" ? [n.alias] : n.alias, u = Array.isArray(n.type) ? `[${n.type[0]}]` : n.type, m = `--${i}${o.length > 0 ? o.map((l) => `, -${l}`).join("") : ""}`, p = " ".repeat(30 - m.length);
-        t.log(`  ${a.green(m)} ${p} ${n.description || "\b"} ${a.white(`(${u})`)}`);
+      for (const [i, n] of e) {
+        const s = g(n), o = typeof s.alias == "string" ? [s.alias] : s.alias, m = Array.isArray(s.type) ? `[${s.type[0]}]` : s.type, u = `--${i}${o.length > 0 ? o.map((l) => `, -${l}`).join("") : ""}`, h = " ".repeat(30 - u.length);
+        t.log(`  ${a.green(u)} ${h} ${s.description || "\b"} ${a.white(`(${m})`)}`);
       }
       t.log("");
     }
@@ -164,7 +163,7 @@ class F extends f {
     t.log(`${a.white.bgRed(" ERROR ")} Argument ${a.bold.yellow(this.argument)} is required.`);
   }
 }
-class P extends f {
+class V extends f {
   constructor(t) {
     super(`Argument "${t}" is required.`), this.option = t;
   }
@@ -190,7 +189,7 @@ class C extends f {
     t.log(`  ${a.white.bgRed(" ERROR ")} Option ${a.bold.yellow(this.param.option)} value is invalid. `), (this.param.value || this.param.reason) && t.log(""), this.param.value && t.log(`  ${a.blue("Value")}: ${this.param.value}`), this.param.reason && t.log(`  ${a.yellow("Reason")}: ${this.param.reason}`);
   }
 }
-class D extends f {
+class P extends f {
   constructor(t) {
     super(`Command "${t}" not found.`), this.command = t;
   }
@@ -204,34 +203,34 @@ function w(r, t, e, i) {
   if (t === "string")
     return String(r);
   if (t === "number") {
-    const s = Number(r);
-    if (isNaN(s))
+    const n = Number(r);
+    if (isNaN(n))
       throw new C({
         option: e,
         reason: `Expected a number, got "${r}"`
       });
-    return s;
+    return n;
   }
   if (t === "boolean")
     return typeof r == "boolean" ? r : r === "true" || r === "1" ? !0 : r === "false" || r === "0" ? !1 : !!r;
   if (Array.isArray(t)) {
-    const s = t[0], n = Array.isArray(r) ? r : [r];
-    if (s === "string")
-      return n.map((o) => String(o));
-    if (s === "number")
-      return n.map((o) => {
-        const u = Number(o);
-        if (isNaN(u))
+    const n = t[0], s = Array.isArray(r) ? r : [r];
+    if (n === "string")
+      return s.map((o) => String(o));
+    if (n === "number")
+      return s.map((o) => {
+        const m = Number(o);
+        if (isNaN(m))
           throw new C({
             option: e,
             reason: `Expected array of numbers, got "${o}" in array`
           });
-        return u;
+        return m;
       });
   }
   return r;
 }
-class N {
+class k {
   options;
   parsedOptions = null;
   arguments;
@@ -250,7 +249,7 @@ class N {
    * @throws {BadCommandOption} If a value cannot be converted to the expected type
    */
   init(t) {
-    const { _: e, ...i } = L(t);
+    const { _: e, ...i } = q(t);
     return this.validateUnknownOptions(i), this.parsedOptions = this.handleOptions(i), this.parsedArguments = this.handleArguments(e), {
       options: this.parsedOptions,
       arguments: this.parsedArguments
@@ -263,14 +262,14 @@ class N {
   async validate() {
     for (const t in this.options)
       if (g(this.options[t]).required && (this.parsedOptions?.[t] === void 0 || this.parsedOptions?.[t] === null))
-        throw new P(t);
+        throw new V(t);
     for (const t in this.arguments) {
       const e = g(this.arguments[t]), i = this.parsedArguments?.[t];
       if (e.required && i == null) {
         if (this.shouldPromptForMissingOptions) {
-          const s = await this.promptForArgument(t, e);
-          if (s && this.parsedArguments) {
-            this.parsedArguments[t] = w(s, e.type, t);
+          const n = await this.promptForArgument(t, e);
+          if (n && this.parsedArguments) {
+            this.parsedArguments[t] = w(n, e.type, t);
             continue;
           }
         }
@@ -278,9 +277,9 @@ class N {
       }
       if (e.required && e.variadic && Array.isArray(i) && i.length === 0) {
         if (this.shouldPromptForMissingOptions) {
-          const s = await this.promptForArgument(t, e);
-          if (s && this.parsedArguments) {
-            this.parsedArguments[t] = w(s, e.type, t);
+          const n = await this.promptForArgument(t, e);
+          if (n && this.parsedArguments) {
+            this.parsedArguments[t] = w(n, e.type, t);
             continue;
           }
         }
@@ -343,9 +342,9 @@ class N {
     const e = /* @__PURE__ */ new Set();
     for (const i in this.options) {
       e.add(i);
-      const s = g(this.options[i]);
-      for (const n of s.alias)
-        e.add(n);
+      const n = g(this.options[i]);
+      for (const s of n.alias)
+        e.add(s);
     }
     for (const i in t)
       if (!e.has(i))
@@ -357,8 +356,8 @@ class N {
   handleOptions(t) {
     const e = {};
     for (const i in this.options) {
-      const s = g(this.options[i]);
-      e[i] = this.resolveOptionValue(i, s, t);
+      const n = g(this.options[i]);
+      e[i] = this.resolveOptionValue(i, n, t);
     }
     return e;
   }
@@ -367,13 +366,13 @@ class N {
    */
   handleArguments(t) {
     const e = {}, i = [...t];
-    for (const s in this.arguments) {
-      const n = g(this.arguments[s]);
-      if (n.variadic) {
-        e[s] = this.handleVariadicArgument(s, n, i);
+    for (const n in this.arguments) {
+      const s = g(this.arguments[n]);
+      if (s.variadic) {
+        e[n] = this.handleVariadicArgument(n, s, i);
         continue;
       }
-      e[s] = this.resolveArgumentValue(s, n, i.shift());
+      e[n] = this.resolveArgumentValue(n, s, i.shift());
     }
     return e;
   }
@@ -395,14 +394,14 @@ class N {
    * Handles alias resolution, defaults, and type conversion
    */
   resolveOptionValue(t, e, i) {
-    let s;
-    const n = [t, ...e.alias];
-    for (const o of n)
+    let n;
+    const s = [t, ...e.alias];
+    for (const o of s)
       if (o in i) {
-        s = i[o];
+        n = i[o];
         break;
       }
-    if (s === void 0) {
+    if (n === void 0) {
       if (e.required)
         throw new C({
           option: t,
@@ -410,7 +409,7 @@ class N {
         });
       return e.default;
     }
-    return w(s, e.type, t, e.default);
+    return w(n, e.type, t, e.default);
   }
   optionDefinitions() {
     const t = {};
@@ -452,26 +451,26 @@ class N {
 `, Array.isArray(e.type) ? (i += `Please provide one or more values, separated by commas:
 `, await this.io.askForList(i, void 0, {
       separator: ",",
-      validate: (s) => {
-        if (!s.length)
+      validate: (n) => {
+        if (!n.length)
           return "Please enter at least one value";
         if (e.type[0] === "number") {
-          for (const n of s.split(","))
-            if (isNaN(Number(n)))
+          for (const s of n.split(","))
+            if (isNaN(Number(s)))
               return "Please enter only valid numbers";
         }
         return !0;
       }
     })) : await this.io.askForInput(i, void 0, {
       type: e.type === "number" ? "number" : e.secret ? "password" : "text",
-      validate: (s) => {
-        if (s == null || typeof s == "string" && !s.length)
+      validate: (n) => {
+        if (n == null || typeof n == "string" && !n.length)
           return "This value is required";
         if (e.type === "number") {
-          const n = Number(s);
-          if (isNaN(n))
+          const s = Number(n);
+          if (isNaN(s))
             return "Please enter a valid number";
-        } else if (e.type === "string" && (typeof s != "string" || !s.length))
+        } else if (e.type === "string" && (typeof n != "string" || !n.length))
           return "Please enter a valid text";
         return !0;
       }
@@ -481,52 +480,52 @@ class N {
 function A(r) {
   return new Array(r + 5).join(" ");
 }
-class H {
+class D {
   type = "boolean";
   option = "help";
   alias = ["h"];
   default = !1;
   description = `Display help for the given command. When no command is given display help for the ${a.green("list")} command`;
   async handler() {
-    const t = this.parser.argumentDefinitions(), e = this.parser.optionDefinitions(), i = Object.entries(t), s = Object.entries(e), n = s.map(([l, d]) => {
-      const h = Array.isArray(d.alias) ? d.alias : d.alias ? [d.alias] : [];
+    const t = this.parser.argumentDefinitions(), e = this.parser.optionDefinitions(), i = Object.entries(t), n = Object.entries(e), s = n.map(([l, d]) => {
+      const c = Array.isArray(d.alias) ? d.alias : d.alias ? [d.alias] : [];
       return {
         name: l,
         ...d,
-        optionWithAlias: `--${l}${h.map((c) => `, -${c}`).join("")}`
+        optionWithAlias: `--${l}${c.map((p) => `, -${p}`).join("")}`
       };
     }), o = i.filter(([, l]) => l.required);
     this.io.log(a.yellow("Description:")), this.io.log(`  ${this.description}
 `), this.io.log(a.yellow("Usage:")), this.io.log(`  ${this.command} ${o.length > 0 ? o.map(([l]) => `<${l}>`).join(" ") : "\b"} [options]`);
-    const u = Math.max(...n.map((l) => l.optionWithAlias.length), 0), m = Math.max(...i.map(([l]) => l.length), 0), p = m > u ? m : u;
+    const m = Math.max(...s.map((l) => l.optionWithAlias.length), 0), u = Math.max(...i.map(([l]) => l.length), 0), h = u > m ? u : m;
     if (i.length > 0) {
       this.io.log(`
 ${a.yellow("Arguments")}:`);
       for (const [l, d] of i) {
-        const h = A(p - l.length);
-        let c = `  ${a.green(l)} ${h} ${d.description ?? "\b"}`;
+        const c = A(h - l.length);
+        let p = `  ${a.green(l)} ${c} ${d.description ?? "\b"}`;
         if (d.default !== void 0 && !d.required) {
-          const q = (Array.isArray(d.type) ? `[${d.type[0]}]` : d.type) === "array" || Array.isArray(d.type) ? JSON.stringify(d.default) : d.default;
-          c += ` ${a.yellow(`[default: ${q}]`)}`;
+          const L = (Array.isArray(d.type) ? `[${d.type[0]}]` : d.type) === "array" || Array.isArray(d.type) ? JSON.stringify(d.default) : d.default;
+          p += ` ${a.yellow(`[default: ${L}]`)}`;
         }
-        d.variadic && (c += ` ${a.white("(variadic)")}`), this.io.log(c);
+        d.variadic && (p += ` ${a.white("(variadic)")}`), this.io.log(p);
       }
     }
-    if (s.length > 0) {
+    if (n.length > 0) {
       this.io.log(`
 ${a.yellow("Options")}:`);
-      for (const l of n) {
-        const d = A(p - l.optionWithAlias.length);
-        let h = `${a.green(l.optionWithAlias)} ${d} ${l.description ?? "\b"}`;
+      for (const l of s) {
+        const d = A(h - l.optionWithAlias.length);
+        let c = `${a.green(l.optionWithAlias)} ${d} ${l.description ?? "\b"}`;
         if (l.type) {
-          const c = Array.isArray(l.type) ? `[${l.type[0]}]` : l.type;
-          h += ` ${a.white(`(${c})`)}`;
+          const p = Array.isArray(l.type) ? `[${l.type[0]}]` : l.type;
+          c += ` ${a.white(`(${p})`)}`;
         }
         if (l.default !== void 0 && !l.required) {
           const O = (Array.isArray(l.type) ? `[${l.type[0]}]` : l.type) === "array" || Array.isArray(l.type) ? JSON.stringify(l.default) : l.default;
-          h += ` ${a.yellow(`[default: ${O}]`)}`;
+          c += ` ${a.yellow(`[default: ${O}]`)}`;
         }
-        this.io.log(h);
+        this.io.log(c);
       }
     }
     if (this.commandsExamples.length > 0) {
@@ -534,9 +533,9 @@ ${a.yellow("Options")}:`);
 ${a.yellow("Examples")}:`);
       let l = process.argv[0].split("/").pop();
       l === "node" && (l += " " + process.argv[1].split("/").pop());
-      for (const [d, h] of this.commandsExamples.entries())
-        d > 0 && this.io.log(""), this.io.log(`  ${h.description}
-`), this.io.log(`    ${a.green(`${l} ${h.command}`)}`);
+      for (const [d, c] of this.commandsExamples.entries())
+        d > 0 && this.io.log(""), this.io.log(`  ${c.description}
+`), this.io.log(`    ${a.green(`${l} ${c.command}`)}`);
     }
     return -1;
   }
@@ -558,17 +557,17 @@ class v {
   _handler;
   tmp;
   defaultOptions() {
-    return [new H()];
+    return [new D()];
   }
   newCommandParser(t) {
-    return new N({
+    return new k({
       io: t.io,
       options: t.options,
       arguments: t.arguments
     });
   }
   newCommandIO(t) {
-    return new k(t.logger);
+    return new S(t);
   }
   constructor(t, e) {
     this._command = t, this.description = e?.description ?? "", this.group = e?.group, this.tmp = {
@@ -577,8 +576,8 @@ class v {
     };
     const i = this.defaultOptions();
     if (i.length > 0)
-      for (const s of i)
-        this.tmp.options[s.option] = s;
+      for (const n of i)
+        this.tmp.options[n.option] = n;
   }
   disablePrompting() {
     return this.disablePromptingFlag = !0, this;
@@ -614,19 +613,19 @@ class v {
     if (this.ctx = t.ctx, this.logger = t.logger, this.io = this.newCommandIO({
       logger: t.logger
     }), t && "args" in t) {
-      const n = this.tmp?.options ?? {};
+      const s = this.tmp?.options ?? {};
       for (const o of this.defaultOptions())
-        o.option in n || (n[o.option] = o);
+        o.option in s || (s[o.option] = o);
       this.parser = this.newCommandParser({
         io: this.io,
-        options: n,
+        options: s,
         arguments: this.tmp?.arguments ?? {}
       }), e = this.parser.init(t.args);
       for (const o of this.defaultOptions())
         if (e.options[o.option] === !0) {
-          const u = await o.handler.call(this);
-          if (u && u !== 0)
-            return u;
+          const m = await o.handler.call(this);
+          if (m && m !== 0)
+            return m;
         }
       this.disablePromptingFlag && this.parser.disablePrompting(), await this.parser.validate();
     } else
@@ -644,7 +643,7 @@ class v {
     return await this._handler(t.ctx, e) ?? 0;
   }
 }
-class $ extends N {
+class $ extends k {
   command;
   constructor(t) {
     const e = $.parseSignature(t.signature, t.helperDefinitions, t.defaultOptions);
@@ -659,24 +658,24 @@ class $ extends N {
    * Example: "migrate {name} {--force}" -> { command: "migrate", arguments: {name: ...}, options: {force: ...} }
    */
   static parseSignature(t, e, i) {
-    const [s, ...n] = t.split(/\{(.*?)\}/g).map((m) => m.trim()).filter(Boolean), o = {}, u = {};
-    for (const m of n) {
-      const { name: p, isOption: l, definition: d } = $.parseParamSignature(m, e);
-      l ? o[p] = d : u[p] = d;
+    const [n, ...s] = t.split(/\{(.*?)\}/g).map((u) => u.trim()).filter(Boolean), o = {}, m = {};
+    for (const u of s) {
+      const { name: h, isOption: l, definition: d } = $.parseParamSignature(u, e);
+      l ? o[h] = d : m[h] = d;
     }
-    for (const m of i)
-      o[m.option] = {
-        type: m.type,
-        required: m.required,
-        alias: m.alias,
-        variadic: m.variadic ?? !1,
-        description: m.description,
-        default: m.default ?? null
+    for (const u of i)
+      o[u.option] = {
+        type: u.type,
+        required: u.required,
+        alias: u.alias,
+        variadic: u.variadic ?? !1,
+        description: u.description,
+        default: u.default ?? null
       };
     return {
-      command: s,
+      command: n,
       options: o,
-      arguments: u
+      arguments: m
     };
   }
   /**
@@ -694,8 +693,8 @@ class $ extends N {
    * - {--opt|o}      -> option with alias
    */
   static parseParamSignature(t, e) {
-    let i = t, s = !1;
-    const n = {
+    let i = t, n = !1;
+    const s = {
       required: !0,
       type: "string",
       description: void 0,
@@ -703,18 +702,18 @@ class $ extends N {
       variadic: !1
     };
     if (i.includes(":")) {
-      const [o, u] = i.split(":");
-      i = o.trim(), n.description = u.trim();
+      const [o, m] = i.split(":");
+      i = o.trim(), s.description = m.trim();
     }
     if (i.includes("=")) {
-      const [o, u] = i.split("=");
-      i = o.trim(), n.default = u.trim(), n.required = !1, typeof n.default == "string" && !n.default.length ? n.default = null : n.default === "true" ? (n.default = !0, n.type = "boolean") : n.default === "false" && (n.default = !1, n.type = "boolean");
-    } else i.startsWith("--") && (n.required = !1, n.default = !1, n.type = "boolean");
+      const [o, m] = i.split("=");
+      i = o.trim(), s.default = m.trim(), s.required = !1, typeof s.default == "string" && !s.default.length ? s.default = null : s.default === "true" ? (s.default = !0, s.type = "boolean") : s.default === "false" && (s.default = !1, s.type = "boolean");
+    } else i.startsWith("--") && (s.required = !1, s.default = !1, s.type = "boolean");
     if (i.includes("|")) {
-      const [o, ...u] = i.split("|");
-      i = o.trim(), n.alias = u.map((m) => m.trim());
+      const [o, ...m] = i.split("|");
+      i = o.trim(), s.alias = m.map((u) => u.trim());
     }
-    return i.startsWith("--") && (s = !0, i = i.slice(2)), n.default === "*" && (n.default = [], n.type = ["string"]), i.endsWith("?") && (n.required = !1, i = i.slice(0, -1)), i.endsWith("*") && (n.type = ["string"], n.variadic = !0, n.default = [], i = i.slice(0, -1)), n.description = n.description ?? e[i] ?? e[`--${i}`], { name: i, isOption: s, definition: n };
+    return i.startsWith("--") && (n = !0, i = i.slice(2)), s.default === "*" && (s.default = [], s.type = ["string"]), i.endsWith("?") && (s.required = !1, i = i.slice(0, -1)), i.endsWith("*") && (s.type = ["string"], s.variadic = !0, s.default = [], i = i.slice(0, -1)), s.description = s.description ?? e[i] ?? e[`--${i}`], { name: i, isOption: n, definition: s };
   }
 }
 class z extends v {
@@ -753,7 +752,7 @@ class z extends v {
     return this.io.newLoader(...t);
   }
 }
-class S {
+class N {
   level;
   constructor(t = {}) {
     this.level = t.level ?? "info";
@@ -784,15 +783,58 @@ class S {
     this.shouldLog("debug") && console.log(...t);
   }
 }
+class H {
+  /**
+   * Generate bigrams (character pairs) from a string
+   */
+  getBigrams(t) {
+    const e = [], i = t.toLowerCase();
+    for (let n = 0; n < i.length - 1; n++)
+      e.push(i.slice(n, n + 2));
+    return e;
+  }
+  /**
+   * Calculate Dice's Coefficient similarity between two strings (0-1 scale)
+   */
+  calculateSimilarity(t, e) {
+    if (t === e) return 1;
+    if (t.length < 2 || e.length < 2) return 0;
+    const i = this.getBigrams(t), n = this.getBigrams(e), s = new Set(n);
+    let o = 0;
+    for (const m of i)
+      s.has(m) && (o++, s.delete(m));
+    return 2 * o / (i.length + n.length);
+  }
+  /**
+   * Find best matching string and ratings for all candidates
+   */
+  findBestMatch(t, e) {
+    const i = e.map((o) => ({
+      target: o,
+      rating: this.calculateSimilarity(t, o)
+    }));
+    let n = 0, s = i[0]?.rating ?? 0;
+    for (let o = 1; o < i.length; o++)
+      i[o].rating > s && (s = i[o].rating, n = o);
+    return {
+      ratings: i,
+      bestMatch: i[n],
+      bestMatchIndex: n
+    };
+  }
+}
 class j {
   commands = {};
   io;
   logger;
-  get CommandIOClass() {
-    return k;
+  stringSimilarity;
+  newCommandIO(t) {
+    return new S(t);
   }
   constructor(t) {
-    this.logger = t ?? new S(), this.io = new this.CommandIOClass(this.logger);
+    this.logger = t?.logger ?? new N(), this.io = this.newCommandIO({
+      logger: this.logger
+    }), this.stringSimilarity = t?.stringSimilarity ?? new H();
   }
   getAvailableCommands() {
     return Object.keys(this.commands);
@@ -833,46 +875,46 @@ class j {
       }
   }
   async runCommand(t, e, ...i) {
-    const s = typeof e == "string" ? this.commands[e] : e, n = typeof e == "string" ? e : s.command;
-    if (!s) {
-      const o = await this.suggestCommand(n);
+    const n = typeof e == "string" ? this.commands[e] : e, s = typeof e == "string" ? e : n.command;
+    if (!n) {
+      const o = await this.suggestCommand(s);
       return o ? await this.runCommand(t, o, ...i) : 1;
     }
-    return await s.run({
+    return await n.run({
       ctx: t,
       logger: this.logger,
       args: i
     }) ?? 0;
   }
   async suggestCommand(t) {
-    const e = this.getAvailableCommands(), { bestMatch: i, bestMatchIndex: s, ratings: n } = I.findBestMatch(t, e), o = n.filter((u) => u.rating > 0.3).map((u) => u.target);
+    const e = this.getAvailableCommands(), { bestMatch: i, bestMatchIndex: n, ratings: s } = this.stringSimilarity.findBestMatch(t, e), o = s.filter((m) => m.rating > 0.3).map((m) => m.target);
     if (i.rating > 0 && o.length <= 1 || i.rating > 0.7 && o.length > 1) {
-      const u = e[s];
-      return await this.askRunSimilarCommand(t, u) ? u : null;
+      const m = e[n];
+      return await this.askRunSimilarCommand(t, m) ? m : null;
     }
     if (o.length) {
       this.io.error(`${a.bgRed(" ERROR ")} Command ${a.yellow(t)} not found.
 `);
-      const u = await this.io.askForSelect(a.green("Did you mean to run one of these commands instead?"), o);
-      if (u)
-        return u;
+      const m = await this.io.askForSelect(a.green("Did you mean to run one of these commands instead?"), o);
+      if (m)
+        return m;
     }
-    throw new D(t);
+    throw new P(t);
   }
   async askRunSimilarCommand(t, e) {
     return this.io.error(`${a.bgRed(" ERROR ")} Command ${a.yellow(t)} not found.
 `), this.io.askForConfirmation(`${a.green(`Do you want to run ${a.yellow(e)} instead?`)} `);
   }
   async *listCommandsFiles(t) {
-    const e = V.readdirSync(t, { withFileTypes: !0 });
+    const e = I.readdirSync(t, { withFileTypes: !0 });
     for (const i of e) {
-      const s = R.resolve(t, i.name);
+      const n = R.resolve(t, i.name);
       if (i.isDirectory())
         yield* this.listCommandsFiles(R.resolve(t, i.name));
       else {
-        if (!s.endsWith(".ts") && !s.endsWith(".js") && !s.endsWith(".mjs") && !s.endsWith(".cjs"))
+        if (!n.endsWith(".ts") && !n.endsWith(".js") && !n.endsWith(".mjs") && !n.endsWith(".cjs"))
           continue;
-        yield s;
+        yield n;
       }
     }
   }
@@ -888,34 +930,34 @@ class W {
     throw t;
   }
 }
-class T extends v {
+class M extends v {
   constructor(t) {
     super("help", {
       description: a.bold("Show help information about the CLI and its commands")
     }), this.opts = t;
   }
   async handle() {
-    const t = this.opts.commandRegistry.getCommands(), e = this.opts.cliName ?? "Bob CLI", i = this.opts.cliVersion ?? "0.0.0", s = (await import("./package-vtMT-dat.js"))?.default?.version ?? "0.0.0";
-    this.io.log(`${e} ${a.green(i)} (core: ${a.yellow(s)})
+    const t = this.opts.commandRegistry.getCommands(), e = this.opts.cliName ?? "Bob CLI", i = this.opts.cliVersion ?? "0.0.0", n = (await import("./package-C-2LYcDa.js"))?.default?.version ?? "0.0.0";
+    this.io.log(`${e} ${a.green(i)} (core: ${a.yellow(n)})
 
 ${a.yellow("Usage")}:
   command [options] [arguments]
 
 ${a.yellow("Available commands")}:
 `);
-    const n = Math.max(...t.map((m) => m.command.length)) ?? 0, o = {};
-    for (const m of t) {
-      const p = m.group ?? m.command.split(":")[0];
-      o[p] || (o[p] = []), o[p].push(m);
+    const s = Math.max(...t.map((u) => u.command.length)) ?? 0, o = {};
+    for (const u of t) {
+      const h = u.group ?? u.command.split(":")[0];
+      o[h] || (o[h] = []), o[h].push(u);
     }
-    const u = Object.entries(o).sort(([m], [p]) => m.toLowerCase().localeCompare(p.toLowerCase())).sort(([, m], [, p]) => m.length - p.length);
-    for (const [m, p] of u) {
-      const l = p.length > 1;
-      l && this.io.log(a.yellow(`${m}:`));
-      const d = p.sort((h, c) => h.command.toLowerCase().localeCompare(c.command.toLowerCase()));
-      for (const h of d) {
-        let c = A(n - h.command.length);
-        l && (c = c.slice(2)), this.io.log(`${l ? "  " : ""}${a.green(h.command)} ${c} ${h.description}`);
+    const m = Object.entries(o).sort(([u], [h]) => u.toLowerCase().localeCompare(h.toLowerCase())).sort(([, u], [, h]) => u.length - h.length);
+    for (const [u, h] of m) {
+      const l = h.length > 1;
+      l && this.io.log(a.yellow(`${u}:`));
+      const d = h.sort((c, p) => c.command.toLowerCase().localeCompare(p.command.toLowerCase()));
+      for (const c of d) {
+        let p = A(s - c.command.length);
+        l && (p = p.slice(2)), this.io.log(`${l ? "  " : ""}${a.green(c.command)} ${p} ${c.description}`);
       }
     }
   }
@@ -927,16 +969,16 @@ class J {
   exceptionHandler;
   helpCommand;
   newCommandRegistry(t) {
-    return new j(t.logger);
+    return new j(t);
   }
   newHelpCommand(t) {
-    return new T(t);
+    return new M(t);
   }
   newExceptionHandler(t) {
     return new W(t.logger);
   }
   constructor(t = {}) {
-    this.ctx = t.ctx, this.logger = t.logger ?? new S(), this.commandRegistry = this.newCommandRegistry({
+    this.ctx = t.ctx, this.logger = t.logger ?? new N(), this.commandRegistry = this.newCommandRegistry({
       logger: this.logger
     }), this.exceptionHandler = this.newExceptionHandler({
       logger: this.logger
@@ -972,16 +1014,17 @@ export {
   f as BobError,
   J as Cli,
   v as Command,
-  k as CommandIO,
-  D as CommandNotFoundError,
-  N as CommandParser,
+  S as CommandIO,
+  P as CommandNotFoundError,
+  k as CommandParser,
   j as CommandRegistry,
   $ as CommandSignatureParser,
   z as CommandWithSignature,
   W as ExceptionHandler,
-  H as HelpOption,
+  D as HelpOption,
   b as InvalidOption,
-  S as Logger,
+  N as Logger,
   F as MissingRequiredArgumentValue,
-  P as MissingRequiredOptionValue
+  V as MissingRequiredOptionValue,
+  H as StringSimilarity
 };

package/dist/esm/{package-vtMT-dat.js → package-C-2LYcDa.js}

@@ -1,4 +1,4 @@
-const t = "bob-core", e = "2.0.0-beta.14", s = "BOB Core", i = "module", m = !1, n = ["dist/**"], r = { ".": { import: "./dist/esm/index.js", require: "./dist/cjs/index.js" } }, o = { "*": { "*": ["./dist/cjs/*.d.ts"] } }, c = { start: "node -r @swc-node/register debug/main.ts", build: "rimraf ./dist && vite build", typecheck: "tsc --noEmit", prepack: "npm run build", test: "vitest run", lint: "eslint .", "lint:fix": "eslint . --fix" }, p = "Léo Hubert", d = "ISC", l = { "@eslint/js": "^9.37.0", "@faker-js/faker": "^10.0.0", "@swc-node/register": "^1.11.1", "@trivago/prettier-plugin-sort-imports": "^5.2.2", "@types/minimist": "^1.2.5", "@types/node": "^20.14.5", "@types/prompts": "^2.4.9", "@types/string-similarity": "^4.0.2", "@vitest/coverage-v8": "^3.2.4", eslint: "^9.37.0", "eslint-config-prettier": "^10.1.8", "eslint-plugin-prettier": "^5.5.4", prettier: "^3.6.2", rimraf: "^6.0.1", tsx: "^4.20.6", typescript: "^5.7.3", "typescript-eslint": "^8.46.0", vite: "^7.1.6", "vite-plugin-dts": "^4.5.4", vitest: "^3.2.4" }, a = { chalk: "^5.6.2", minimist: "^1.2.8", prompts: "^2.4.2", "string-similarity": "^4.0.4" }, f = {
+const t = "bob-core", e = "2.0.0-beta.15", s = "BOB Core", i = "module", m = !1, n = ["dist/**"], r = { ".": { import: "./dist/esm/index.js", require: "./dist/cjs/index.js" } }, o = { "*": { "*": ["./dist/cjs/*.d.ts"] } }, c = { start: "node -r @swc-node/register debug/main.ts", build: "rimraf ./dist && vite build", typecheck: "tsc --noEmit", prepack: "npm run build", test: "vitest run", lint: "eslint .", "lint:fix": "eslint . --fix" }, p = "Léo Hubert", d = "ISC", l = { "@eslint/js": "^9.37.0", "@faker-js/faker": "^10.0.0", "@swc-node/register": "^1.11.1", "@trivago/prettier-plugin-sort-imports": "^5.2.2", "@types/minimist": "^1.2.5", "@types/node": "^20.14.5", "@types/prompts": "^2.4.9", "@types/string-similarity": "^4.0.2", "@vitest/coverage-v8": "^3.2.4", eslint: "^9.37.0", "eslint-config-prettier": "^10.1.8", "eslint-plugin-prettier": "^5.5.4", prettier: "^3.6.2", rimraf: "^6.0.1", tsx: "^4.20.6", typescript: "^5.7.3", "typescript-eslint": "^8.46.0", vite: "^7.1.6", "vite-plugin-dts": "^4.5.4", vitest: "^3.2.4" }, a = { chalk: "^5.6.2", minimist: "^1.2.8", prompts: "^2.4.2" }, f = {
   name: t,
   version: e,
   description: s,

package/dist/esm/src/Cli.d.ts

@@ -1,5 +1,5 @@
 import { Command } from './Command.js';
-import { CommandRegistry, CommandResolver, FileImporter } from './CommandRegistry.js';
+import { CommandRegistry, CommandRegistryOptions, CommandResolver, FileImporter } from './CommandRegistry.js';
 import { ExceptionHandler } from './ExceptionHandler.js';
 import { Logger } from './Logger.js';
 import { default as HelpCommand, HelpCommandOptions } from './commands/HelpCommand.js';
@@ -16,9 +16,7 @@ export declare class Cli<C extends ContextDefinition = ContextDefinition> {
     readonly commandRegistry: CommandRegistry;
     private readonly exceptionHandler;
     private readonly helpCommand;
-    protected newCommandRegistry(opts: {
-        logger: Logger;
-    }): CommandRegistry;
+    protected newCommandRegistry(opts: CommandRegistryOptions): CommandRegistry;
     protected newHelpCommand(opts: HelpCommandOptions): HelpCommand;
     protected newExceptionHandler(opts: {
         logger: Logger;

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

@@ -1,4 +1,4 @@
-import { CommandIO } from './CommandIO.js';
+import { CommandIO, CommandIOOptions } from './CommandIO.js';
 import { CommandParser } from './CommandParser.js';
 import { Logger } from './Logger.js';
 import { CommandOption } from './contracts/index.js';
@@ -43,9 +43,7 @@ export declare class Command<C extends ContextDefinition = ContextDefinition, Op
         options: Options;
         arguments: Arguments;
     }): CommandParser<Options, Arguments>;
-    protected newCommandIO(opts: {
-        logger: Logger;
-    }): CommandIO;
+    protected newCommandIO(opts: CommandIOOptions): CommandIO;
     constructor(command: string, opts?: {
         description?: string;
         group?: string;

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

@@ -6,9 +6,12 @@ export type SelectOption = {
     selected?: boolean | undefined;
     description?: string | undefined;
 };
+export type CommandIOOptions = {
+    logger: Logger;
+};
 export declare class CommandIO {
     private logger;
-    constructor(logger: Logger);
+    constructor(opts: CommandIOOptions);
     /**
      * Logger methods
      */

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

@@ -1,15 +1,21 @@
 import { Command } from './Command.js';
-import { CommandIO } from './CommandIO.js';
+import { CommandIO, CommandIOOptions } from './CommandIO.js';
 import { Logger } from './Logger.js';
+import { StringSimilarity } from './StringSimilarity.js';
 import { ArgumentsSchema, ContextDefinition, OptionsSchema } from './lib/types.js';
 export type CommandResolver = (path: string) => Promise<Command | null>;
 export type FileImporter = (filePath: string) => Promise<unknown>;
+export type CommandRegistryOptions = {
+    logger?: Logger;
+    stringSimilarity?: StringSimilarity;
+};
 export declare class CommandRegistry {
     private readonly commands;
     protected readonly io: CommandIO;
     protected readonly logger: Logger;
-    protected get CommandIOClass(): typeof CommandIO;
-    constructor(logger?: Logger);
+    private readonly stringSimilarity;
+    protected newCommandIO(opts: CommandIOOptions): CommandIO;
+    constructor(opts?: CommandRegistryOptions);
     getAvailableCommands(): string[];
     getCommands(): Array<Command>;
     private importFile;

package/dist/esm/src/StringSimilarity.d.ts

@@ -0,0 +1,26 @@
+export interface SimilarityResult {
+    rating: number;
+    target: string;
+}
+export interface BestMatchResult {
+    bestMatch: SimilarityResult;
+    bestMatchIndex: number;
+    ratings: SimilarityResult[];
+}
+/**
+ * String similarity calculator using Dice's Coefficient algorithm
+ */
+export declare class StringSimilarity {
+    /**
+     * Generate bigrams (character pairs) from a string
+     */
+    private getBigrams;
+    /**
+     * Calculate Dice's Coefficient similarity between two strings (0-1 scale)
+     */
+    calculateSimilarity(str1: string, str2: string): number;
+    /**
+     * Find best matching string and ratings for all candidates
+     */
+    findBestMatch(target: string, candidates: string[]): BestMatchResult;
+}

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

@@ -7,6 +7,7 @@ export * from './CommandRegistry.js';
 export * from './Cli.js';
 export * from './Logger.js';
 export * from './ExceptionHandler.js';
+export * from './StringSimilarity.js';
 export * from './lib/types.js';
 export * from './errors/index.js';
 export * from './options/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bob-core",
-  "version": "2.0.0-beta.14",
+  "version": "2.0.0-beta.15",
   "description": "BOB Core",
   "type": "module",
   "sideEffects": false,
@@ -56,7 +56,6 @@
   "dependencies": {
     "chalk": "^5.6.2",
     "minimist": "^1.2.8",
-    "prompts": "^2.4.2",
-    "string-similarity": "^4.0.4"
+    "prompts": "^2.4.2"
   }
 }