bob-core 1.3.4 → 1.3.6

package/dist/cjs/bob-core.js

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

package/dist/cjs/package-CH7KBlFr.cjs

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

package/dist/esm/bob-core.js

@@ -513,7 +513,7 @@ class k extends E {
   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", s = (await import("./package-Bo2EHkpi.js"))?.default?.version ?? "0.0.0";
+    const t = this.opts.commandRegistry.getCommands(), e = this.opts.cliName ?? "Bob CLI", n = this.opts.cliVersion ?? "0.0.0", s = (await import("./package-War71qwn.js"))?.default?.version ?? "0.0.0";
     console.log(o`${e} {green ${n}} (core: {yellow ${s}})
 
 {yellow Usage}:

package/dist/esm/package-War71qwn.js

@@ -0,0 +1,29 @@
+const s = "bob-core", t = "1.3.6", e = "BOB Core", i = "module", r = ["/dist"], n = { ".": { import: "./dist/esm/bob-core.js", require: "./dist/cjs/bob-core.cjs" } }, o = { "*": { "*": ["./dist/cjs/*.d.ts"] } }, c = { start: "node -r @swc-node/register debug/main.ts", build: "rimraf ./dist && vite build", 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: s,
+  version: t,
+  description: e,
+  type: i,
+  files: r,
+  exports: n,
+  typesVersions: o,
+  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,
+  n as exports,
+  r as files,
+  d as license,
+  s as name,
+  c as scripts,
+  i as type,
+  o as typesVersions,
+  t as version
+};

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

@@ -0,0 +1,26 @@
+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;
+    version?: string;
+};
+export declare class Cli<C> {
+    readonly commandRegistry: CommandRegistry;
+    private readonly exceptionHandler;
+    private readonly ctx?;
+    private readonly helpCommand;
+    get CommandRegistryClass(): typeof CommandRegistry;
+    get HelpCommandClass(): typeof HelpCommand;
+    get ExceptionHandlerClass(): typeof ExceptionHandler;
+    constructor(opts?: CliOptions<C>);
+    setCommandResolver(resolver: (path: string) => Promise<Command<C>>): void;
+    withCommands(...commands: Array<Command<C> | {
+        new (): Command<C>;
+    } | string>): Promise<void>;
+    runCommand(command: string | Command, ...args: any[]): Promise<number>;
+    runHelpCommand(): Promise<number>;
+    protected registerCommand(command: Command<C>): void;
+}

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

@@ -0,0 +1,45 @@
+import { CommandParser } from './CommandParser.js';
+import { CommandOption } from './contracts/index.js';
+import { CommandIO } from './CommandIO.js';
+export type CommandExample = {
+    description: string;
+    command: string;
+};
+export declare abstract class Command<C = any> {
+    abstract signature: string;
+    abstract description: string;
+    protected ctx: C;
+    protected helperDefinitions: {
+        [key: string]: string;
+    };
+    protected commandsExamples: CommandExample[];
+    protected parser: CommandParser;
+    protected io: CommandIO;
+    protected abstract handle(): Promise<void | number>;
+    protected preHandle?(): Promise<void | number>;
+    protected get CommandParserClass(): typeof CommandParser;
+    protected get CommandIOClass(): typeof CommandIO;
+    protected defaultOptions(): CommandOption<Command<C>>[];
+    get command(): string;
+    run(ctx: C, ...args: any[]): Promise<number>;
+    protected setOption(name: string, value: any): void;
+    protected setArgument(name: string, value: any): void;
+    protected option<T = string>(key: string): T | null;
+    protected option<T = string>(key: string, defaultValue: T): NoInfer<T>;
+    protected optionBoolean(key: string, defaultValue?: boolean): boolean;
+    protected optionArray<T = string>(key: string, defaultValue?: Array<T>): Array<NoInfer<T>>;
+    protected optionNumber(key: string): number | null;
+    protected optionNumber(key: string, defaultValue: number): number;
+    protected argument<T = string>(key: string): T | null;
+    protected argument<T = string>(key: string, defaultValue: T): NoInfer<T>;
+    protected argumentArray<T = string>(key: string, defaultValue?: Array<any>): Array<T>;
+    protected argumentBoolean(key: string, defaultValue?: boolean): boolean;
+    protected argumentNumber(key: string, defaultValue?: number | null): number | null;
+    /**
+     * Prompt utils
+     */
+    askForConfirmation(...opts: Parameters<typeof this.io.askForConfirmation>): ReturnType<typeof this.io.askForConfirmation>;
+    askForInput(...opts: Parameters<typeof this.io.askForInput>): ReturnType<typeof this.io.askForInput>;
+    askForSelect(...opts: Parameters<typeof this.io.askForSelect>): ReturnType<typeof this.io.askForSelect>;
+    newLoader(...opts: Parameters<typeof this.io.newLoader>): ReturnType<typeof this.io.newLoader>;
+}

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

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

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

@@ -0,0 +1,48 @@
+import { CommandOption } from './contracts/index.js';
+import { CommandIO } from './CommandIO.js';
+export type ArgSignature = {
+    name: string;
+    type: 'string' | 'boolean' | 'array';
+    optional?: boolean;
+    variadic?: boolean;
+    alias?: string[];
+    help?: string;
+    defaultValue: string | boolean | Array<string> | null;
+    isOption?: boolean;
+};
+export declare class CommandParser {
+    protected readonly io: CommandIO;
+    protected readonly signature: string;
+    protected readonly helperDefinitions: {
+        [key: string]: string;
+    };
+    protected readonly defaultCommandOptions: CommandOption<any>[];
+    command: string;
+    private arguments;
+    private options;
+    private argumentsSignature;
+    private optionSignatures;
+    private optionAliases;
+    constructor(io: CommandIO, signature: string, helperDefinitions: {
+        [key: string]: string;
+    }, defaultCommandOptions: CommandOption<any>[], ...args: any[]);
+    option(name: string): any;
+    setOption(name: string, value: any): void;
+    optionHelp(name: string): string | undefined;
+    argument(name: string): any;
+    setArgument(name: string, value: any): void;
+    argumentHelp(name: string): string | undefined;
+    getArgumentSignatures(): {
+        [argument: string]: ArgSignature;
+    };
+    getOptionSignatures(): {
+        [option: string]: ArgSignature;
+    };
+    private getParamValue;
+    private handleArguments;
+    private handleOptions;
+    private parseSignature;
+    private parseDefaultOptions;
+    private parseParamSignature;
+    validate(): Promise<void>;
+}

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

@@ -0,0 +1,20 @@
+import { Command } from './Command.js';
+import { CommandIO } from './CommandIO.js';
+export type CommandResolver = (path: string) => Promise<Command>;
+export declare class CommandRegistry {
+    private readonly commands;
+    protected readonly io: CommandIO;
+    get commandSuffix(): string;
+    protected get CommandIOClass(): typeof CommandIO;
+    constructor();
+    getAvailableCommands(): string[];
+    getCommands(): Command[];
+    private commandResolver;
+    setCommandResolver(resolver: (path: string) => Promise<Command>): void;
+    registerCommand(command: Command, force?: boolean): void;
+    loadCommandsPath(commandsPath: string): Promise<void>;
+    runCommand(ctx: any, command: string | Command, ...args: any[]): Promise<number>;
+    private suggestCommand;
+    private askRunSimilarCommand;
+    private listCommandsFiles;
+}

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

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

package/dist/esm/src/commands/HelpCommand.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '../Command.js';
+import { CommandRegistry } from '../CommandRegistry.js';
+export type HelpCommandOptions = {
+    commandRegistry: CommandRegistry;
+    cliName?: string;
+    cliVersion?: string;
+};
+export default class HelpCommand extends Command {
+    private opts;
+    signature: string;
+    description: string;
+    constructor(opts: HelpCommandOptions);
+    protected handle(): Promise<void>;
+}

package/dist/esm/src/contracts/CommandOption.d.ts

@@ -0,0 +1,7 @@
+export interface CommandOption<C> {
+    option: string;
+    alias?: string[];
+    defaultValue: string | boolean | Array<string> | null;
+    description?: string;
+    handler(this: C): Promise<number | void>;
+}

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

@@ -0,0 +1 @@
+export * from './CommandOption.js';

package/dist/esm/src/errors/BadCommandOption.d.ts

@@ -0,0 +1,11 @@
+import { BobError } from './BobError.js';
+export type OptionProps = {
+    option: string;
+    value?: string;
+    reason?: string;
+};
+export declare class BadCommandOption extends BobError {
+    readonly param: OptionProps;
+    constructor(param: OptionProps);
+    pretty(): void;
+}

package/dist/esm/src/errors/BadCommandParameter.d.ts

@@ -0,0 +1,11 @@
+import { BobError } from './BobError.js';
+export type ParameterProps = {
+    param: string;
+    value?: string;
+    reason?: string;
+};
+export declare class BadCommandParameter extends BobError {
+    readonly param: ParameterProps;
+    constructor(param: ParameterProps);
+    pretty(): void;
+}

package/dist/esm/src/errors/BobError.d.ts

@@ -0,0 +1,3 @@
+export declare abstract class BobError extends Error {
+    abstract pretty(): void;
+}

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

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

package/dist/esm/src/errors/InvalidOption.d.ts

@@ -0,0 +1,8 @@
+import { BobError } from './BobError.js';
+import { ArgSignature } from '../CommandParser.js';
+export declare class InvalidOption extends BobError {
+    private option;
+    private optionsSignature;
+    constructor(option: string, optionsSignature: ArgSignature[]);
+    pretty(): void;
+}

package/dist/esm/src/errors/MissingRequiredArgumentValue.d.ts

@@ -0,0 +1,7 @@
+import { BobError } from './BobError.js';
+import { ArgSignature } from '../CommandParser.js';
+export declare class MissingRequiredArgumentValue extends BobError {
+    readonly paramSignature: ArgSignature;
+    constructor(paramSignature: ArgSignature);
+    pretty(): void;
+}

package/dist/esm/src/errors/MissingSignatureArgument.d.ts

@@ -0,0 +1,8 @@
+import { BobError } from './BobError.js';
+import { ArgSignature } from '../CommandParser.js';
+export declare class MissingSignatureArgument extends BobError {
+    private argument;
+    private argumentSignatures;
+    constructor(argument: string, argumentSignatures: ArgSignature[]);
+    pretty(): void;
+}

package/dist/esm/src/errors/MissingSignatureOption.d.ts

@@ -0,0 +1,8 @@
+import { BobError } from './BobError.js';
+import { ArgSignature } from '../CommandParser.js';
+export declare class MissingSignatureOption extends BobError {
+    private option;
+    private optionsSignature;
+    constructor(option: string, optionsSignature: ArgSignature[]);
+    pretty(): void;
+}

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

@@ -0,0 +1,3 @@
+export * from './BobError.js';
+export * from './BadCommandParameter.js';
+export * from './BadCommandOption.js';

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

@@ -0,0 +1,6 @@
+export * from './Command.js';
+export * from './CommandIO.js';
+export * from './Cli.js';
+export * from './errors/index.js';
+export * from './contracts/index.js';
+export * from './options/index.js';

package/dist/esm/src/lib/string.d.ts

@@ -0,0 +1 @@
+export declare function generateSpace(nb: number): string;

package/dist/esm/src/options/HelpOption.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '../Command.js';
+import { CommandOption } from '../contracts/index.js';
+export declare class HelpOption implements CommandOption<Command> {
+    option: string;
+    alias: string[];
+    defaultValue: boolean;
+    description: string;
+    handler(this: Command): Promise<number | void>;
+}

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

@@ -0,0 +1 @@
+export * from './HelpOption.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bob-core",
-  "version": "1.3.4",
+  "version": "1.3.6",
   "description": "BOB Core",
   "type": "module",
   "files": [
@@ -15,7 +15,7 @@
   "typesVersions": {
     "*": {
       "*": [
-        "./dist/types/*.d.ts"
+        "./dist/cjs/*.d.ts"
       ]
     }
   },

package/dist/cjs/package-DhC03y1s.cjs

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

package/dist/esm/package-Bo2EHkpi.js

@@ -1,29 +0,0 @@
-const s = "bob-core", t = "1.3.4", e = "BOB Core", i = "module", r = ["/dist"], n = { ".": { import: "./dist/esm/bob-core.js", require: "./dist/cjs/bob-core.cjs" } }, o = { "*": { "*": ["./dist/types/*.d.ts"] } }, c = { start: "node -r @swc-node/register debug/main.ts", build: "rimraf ./dist && vite build", 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: s,
-  version: t,
-  description: e,
-  type: i,
-  files: r,
-  exports: n,
-  typesVersions: o,
-  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,
-  n as exports,
-  r as files,
-  d as license,
-  s as name,
-  c as scripts,
-  i as type,
-  o as typesVersions,
-  t as version
-};

package/dist/types/package.json

@@ -1,3 +0,0 @@
-{
-  "type": "commonjs"
-}