bob-core 1.2.2 → 1.2.3

package/dist/bob-core.cjs

@@ -0,0 +1,8 @@
+"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-D1PCfkN9.cjs")))?.default?.version??"0.0.0";console.log(a`${t} {green ${n}} (core: {yellow ${i}})
+
+{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;

package/dist/bob-core.js

@@ -0,0 +1,515 @@
+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 {
+}
+class $ extends h {
+  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.`);
+  }
+}
+class f extends h {
+  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}:`);
+      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}`);
+      }
+      t("");
+    }
+    t(a`  {white.bgRed  ERROR } Option {bold.yellow ${this.option}} is missing in the signature.`);
+  }
+}
+class y extends h {
+  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}:`);
+      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}`);
+      }
+      t("");
+    }
+    t(a`  {white.bgRed  ERROR } Argument {bold.yellow ${this.argument}} is missing in the signature.`);
+  }
+}
+class b extends h {
+  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}:`);
+      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}`);
+      }
+      t("");
+    }
+    t(a`  {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);
+  }
+  command;
+  arguments = {};
+  options = {};
+  argumentsSignature = {};
+  optionSignatures = {};
+  optionAliases = {};
+  option(t) {
+    if (!this.optionSignatures[t])
+      throw new f(t, Object.values(this.optionSignatures));
+    return this.options[t];
+  }
+  setOption(t, e) {
+    if (!this.optionSignatures[t])
+      throw new f(t, Object.values(this.optionSignatures));
+    this.options[t] = e;
+  }
+  optionHelp(t) {
+    if (!this.optionSignatures[t])
+      throw new f(t, Object.values(this.optionSignatures));
+    return this.optionSignatures[t].help;
+  }
+  argument(t) {
+    if (!this.argumentsSignature[t])
+      throw new y(t, Object.values(this.argumentsSignature));
+    return this.arguments[t];
+  }
+  setArgument(t, e) {
+    if (!this.argumentsSignature[t])
+      throw new y(t, Object.values(this.argumentsSignature));
+    this.arguments[t] = e;
+  }
+  argumentHelp(t) {
+    if (!this.argumentsSignature[t])
+      throw new y(t, Object.values(this.argumentsSignature));
+    return this.argumentsSignature[t].help;
+  }
+  getArgumentSignatures() {
+    return this.argumentsSignature;
+  }
+  getOptionSignatures() {
+    return this.optionSignatures;
+  }
+  getParamValue(t, e) {
+    return e.type === "boolean" ? t === "true" || t === "1" ? !0 : t === "false" || t === "0" ? !1 : !!t : e.type === "array" ? t ? Array.isArray(t) ? t : [t] : [] : t ?? e.defaultValue;
+  }
+  handleArguments(t) {
+    for (const [e, n] of Object.entries(this.arguments)) {
+      const i = this.argumentsSignature[e];
+      if (i.variadic)
+        this.arguments[e] = t;
+      else {
+        const o = t.shift();
+        this.arguments[e] = this.getParamValue(o, i);
+      }
+    }
+  }
+  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]);
+    }
+  }
+  parseSignature(t) {
+    for (const e of t) {
+      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;
+      } else
+        this.arguments[n.name] = n.defaultValue ?? null, this.argumentsSignature[n.name] = n;
+    }
+  }
+  parseDefaultOptions() {
+    if (this.defaultCommandOptions.length) {
+      for (const t of this.defaultCommandOptions)
+        if (this.optionSignatures[t.option] = {
+          name: t.option,
+          type: t.defaultValue == null ? "string" : typeof t.defaultValue,
+          optional: !0,
+          alias: t.alias,
+          variadic: !1,
+          help: t.description,
+          defaultValue: t.defaultValue ?? null,
+          isOption: !0
+        }, this.options[t.option] = t.defaultValue, t.alias)
+          for (const e of t.alias)
+            this.optionAliases[e] = t.option;
+    }
+  }
+  parseParamSignature(t) {
+    const e = {
+      name: t,
+      optional: !1,
+      type: "string",
+      help: void 0,
+      defaultValue: null,
+      variadic: !1,
+      isOption: !1
+    };
+    if (e.name.includes(":")) {
+      const [n, i] = e.name.split(":");
+      e.name = n.trim(), e.help = i.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;
+    } 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());
+    }
+    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() {
+    for (const [t, e] of Object.entries(this.arguments)) {
+      const n = this.argumentsSignature[t];
+      if (!e && !n.optional)
+        throw new $(n);
+      if (!e?.length && n.variadic && !n.optional)
+        throw new $(n);
+    }
+  }
+}
+function w(m) {
+  return new Array(m + 5).join(" ");
+}
+class A {
+  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 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;
+    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}]}`;
+        }
+        s.variadic && (u += a` {white (variadic)}`), t(u);
+      }
+    }
+    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(u);
+      }
+    }
+    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}}`);
+    }
+    return -1;
+  }
+}
+class V {
+  ctx;
+  helperDefinitions = {};
+  commandsExamples = [];
+  parser;
+  get CommandParserClass() {
+    return O;
+  }
+  defaultOptions() {
+    return [new A()];
+  }
+  get command() {
+    return this.parser ? this.parser.command : this.signature.split(" ")[0];
+  }
+  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;
+      }
+    return this.parser.validate(), await this.handle() ?? 0;
+  }
+  setOption(t, e) {
+    this.parser.setOption(t, e);
+  }
+  setArgument(t, e) {
+    this.parser.setArgument(t, e);
+  }
+  option(t, e = null) {
+    return this.parser.option(t) ?? e;
+  }
+  optionBoolean(t, e = !1) {
+    return this.parser.option(t) ?? e;
+  }
+  optionArray(t, e = []) {
+    const n = this.parser.option(t);
+    if (!Array.isArray(n))
+      throw new Error(`Option ${t} is not an array`);
+    return n.length ? n : e;
+  }
+  optionNumber(t, e = null) {
+    const n = this.parser.option(t);
+    return n ? typeof n == "number" ? n : parseInt(n) : e;
+  }
+  argument(t, e = null) {
+    return this.parser.argument(t) ?? e;
+  }
+  argumentArray(t, e = []) {
+    const n = this.parser.argument(t);
+    if (!Array.isArray(n))
+      throw new Error(`Argument ${t} is not an array`);
+    return n?.length ? n : e;
+  }
+  argumentBoolean(t, e = !1) {
+    return this.parser.argument(t) ?? e;
+  }
+  argumentNumber(t, e = null) {
+    const n = this.parser.argument(t);
+    return n ? typeof n == "number" ? n : parseInt(n) : e;
+  }
+}
+class x extends h {
+  constructor(t, e) {
+    super(`Command "${t}" not found.`), this.command = t, this.similarCommands = e;
+  }
+  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.`);
+  }
+}
+class E {
+  commands = {};
+  get commandSuffix() {
+    return "Command";
+  }
+  constructor() {
+  }
+  getAvailableCommands() {
+    return Object.keys(this.commands);
+  }
+  getCommands() {
+    return Object.values(this.commands);
+  }
+  commandResolver = async (t) => {
+    const e = (await import(t)).default;
+    let n;
+    return e?.default ? n = new e.default() : n = new e(), n;
+  };
+  setCommandResolver(t) {
+    this.commandResolver = t;
+  }
+  registerCommand(t, e = !1) {
+    const n = t.signature.split(" ")[0];
+    if (!n)
+      throw new Error("Command signature is invalid, it must have a command name.");
+    if (!e && this.commands[n])
+      throw new Error(`Command ${n} already registered.`);
+    this.commands[n] = t;
+  }
+  async loadCommandsPath(t) {
+    for await (const e of this.listCommandsFiles(t))
+      try {
+        const n = await this.commandResolver(e);
+        this.registerCommand(n);
+      } catch (n) {
+        throw new Error(`Command ${e} failed to load. ${n}`);
+      }
+  }
+  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);
+      return r ? await this.runCommand(t, r, ...n) : 1;
+    }
+    return await i.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);
+    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;
+    }
+    throw new x(t, r);
+  }
+  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();
+      });
+    });
+  }
+  async *listCommandsFiles(t) {
+    const e = v.readdirSync(t, { withFileTypes: !0 });
+    for (const n of e) {
+      const i = C.resolve(t, n.name);
+      if (n.isDirectory())
+        yield* this.listCommandsFiles(C.resolve(t, n.name));
+      else {
+        if (!i.endsWith(`${this.commandSuffix}.ts`) && !i.endsWith(`${this.commandSuffix}.js`))
+          continue;
+        yield i;
+      }
+    }
+  }
+}
+class j extends V {
+  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-B_d-lCr-.js"))?.default?.version ?? "0.0.0";
+    console.log(a`${e} {green ${n}} (core: {yellow ${i}})
+
+{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 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}`);
+      }
+    }
+  }
+}
+class B extends h {
+  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}`);
+  }
+}
+class M extends h {
+  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}`);
+  }
+}
+class H {
+  handle(t) {
+    if (t instanceof h)
+      return t.pretty(), -1;
+    throw t;
+  }
+}
+class N {
+  commandRegistry;
+  exceptionHandler;
+  ctx;
+  helpCommand;
+  get CommandRegistryClass() {
+    return E;
+  }
+  get HelpCommandClass() {
+    return j;
+  }
+  get ExceptionHandlerClass() {
+    return H;
+  }
+  constructor(t = {}) {
+    this.ctx = t.ctx, this.commandRegistry = new this.CommandRegistryClass(), this.exceptionHandler = new this.ExceptionHandlerClass(), this.helpCommand = new this.HelpCommandClass({
+      cliName: t.name,
+      cliVersion: t.version,
+      commandRegistry: this.commandRegistry
+    });
+  }
+  setCommandResolver(t) {
+    this.commandRegistry.setCommandResolver(t);
+  }
+  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) : await this.runHelpCommand();
+  }
+  async runHelpCommand() {
+    return await this.runCommand(this.helpCommand);
+  }
+  registerCommand(t) {
+    this.commandRegistry.registerCommand(t);
+  }
+}
+export {
+  M as BadCommandOption,
+  B as BadCommandParameter,
+  h as BobError,
+  N as Cli,
+  V as Command,
+  A as HelpOption
+};

package/dist/package-B_d-lCr-.js

@@ -0,0 +1,29 @@
+const t = "bob-core", s = "1.2.3", e = "BOB Core", i = "module", n = ["/dist"], o = { ".": { types: "./dist/types/index.d.ts", import: "./dist/bob-core.js", require: "./dist/bob-core.cjs" } }, r = "./dist/types/index.d.ts", c = { start: "node -r @swc-node/register debug/main.ts", build: "rimraf ./dist && vite build --config vite.config.ts", prepare: "npm run build", test: "vitest run" }, p = "Léo Hubert", d = "ISC", m = { "@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" }, u = {
+  name: t,
+  version: s,
+  description: e,
+  type: i,
+  files: n,
+  exports: o,
+  types: r,
+  scripts: c,
+  author: p,
+  license: d,
+  devDependencies: m,
+  dependencies: a
+};
+export {
+  p as author,
+  u as default,
+  a as dependencies,
+  e as description,
+  m as devDependencies,
+  o as exports,
+  n as files,
+  d as license,
+  t as name,
+  c as scripts,
+  i as type,
+  r as types,
+  s as version
+};

package/dist/package-D1PCfkN9.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="bob-core",t="1.2.3",s="BOB Core",i="module",n=["/dist"],o={".":{types:"./dist/types/index.d.ts",import:"./dist/bob-core.js",require:"./dist/bob-core.cjs"}},r="./dist/types/index.d.ts",c={start:"node -r @swc-node/register debug/main.ts",build:"rimraf ./dist && vite build --config vite.config.ts",prepare:"npm run build",test:"vitest run"},p="Léo Hubert",d="ISC",a={"@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"},l={name:e,version:t,description:s,type:i,files:n,exports:o,types:r,scripts:c,author:p,license:d,devDependencies:a,dependencies:m};exports.author=p;exports.default=l;exports.dependencies=m;exports.description=s;exports.devDependencies=a;exports.exports=o;exports.files=n;exports.license=d;exports.name=e;exports.scripts=c;exports.type=i;exports.types=r;exports.version=t;

package/dist/{cjs → types}/src/Cli.d.ts

@@ -1,7 +1,7 @@
-import { CommandRegistry } from "./CommandRegistry.js";
-import { Command } from "./Command.js";
-import HelpCommand from "./commands/HelpCommand.js";
-import { ExceptionHandler } from "./ExceptionHandler.js";
+import { CommandRegistry } from './CommandRegistry.js';
+import { Command } from './Command.js';
+import { default as HelpCommand } from './commands/HelpCommand.js';
+import { ExceptionHandler } from './ExceptionHandler.js';
 export type CliOptions<C> = {
     ctx?: C;
     name?: string;

package/dist/{esm → types}/src/Command.d.ts

@@ -1,5 +1,5 @@
-import { CommandParser } from "./CommandParser.js";
-import { CommandOption } from "./contracts/index.js";
+import { CommandParser } from './CommandParser.js';
+import { CommandOption } from './contracts/index.js';
 export type CommandExample = {
     description: string;
     command: string;

package/dist/{cjs → types}/src/CommandParser.d.ts

@@ -1,4 +1,4 @@
-import { CommandOption } from "./contracts/index.js";
+import { CommandOption } from './contracts/index.js';
 export type ArgSignature = {
     name: string;
     type: string;

package/dist/{cjs → types}/src/CommandRegistry.d.ts

@@ -1,4 +1,4 @@
-import { Command } from "./Command.js";
+import { Command } from './Command.js';
 export type CommandResolver = (path: string) => Promise<Command>;
 export declare class CommandRegistry {
     private readonly commands;

package/dist/{cjs → types}/src/ExceptionHandler.d.ts

@@ -1,4 +1,4 @@
-import { BobError } from "./errors/index.js";
+import { BobError } from './errors/index.js';
 export declare class ExceptionHandler {
     handle(err: Error | BobError): number;
 }

package/dist/{esm → types}/src/commands/HelpCommand.d.ts

@@ -1,5 +1,5 @@
-import { Command } from "../Command.js";
-import { CommandRegistry } from "../CommandRegistry.js";
+import { Command } from '../Command.js';
+import { CommandRegistry } from '../CommandRegistry.js';
 export type HelpCommandOptions = {
     commandRegistry: CommandRegistry;
     cliName?: string;

package/dist/{esm → types}/src/errors/BadCommandOption.d.ts

@@ -1,4 +1,4 @@
-import { BobError } from "../errors/BobError.js";
+import { BobError } from './BobError.js';
 export type OptionProps = {
     option: string;
     value?: string;

package/dist/{cjs → types}/src/errors/BadCommandParameter.d.ts

@@ -1,4 +1,4 @@
-import { BobError } from "../errors/BobError.js";
+import { BobError } from './BobError.js';
 export type ParameterProps = {
     param: string;
     value?: string;

package/dist/{cjs → types}/src/errors/CommandNotFoundError.d.ts

@@ -1,4 +1,4 @@
-import { BobError } from "../errors/BobError.js";
+import { BobError } from './BobError.js';
 export declare class CommandNotFoundError extends BobError {
     readonly command: string;
     readonly similarCommands: string[];

package/dist/{esm → types}/src/errors/InvalidOption.d.ts

@@ -1,5 +1,5 @@
-import { BobError } from "../errors/BobError.js";
-import { ArgSignature } from "../CommandParser.js";
+import { BobError } from './BobError.js';
+import { ArgSignature } from '../CommandParser.js';
 export declare class InvalidOption extends BobError {
     private option;
     private optionsSignature;