zod-args-parser 1.0.3 → 1.0.4

package/README.md

@@ -19,13 +19,13 @@ npm install zod-args-parser
 ## Usage
 
 ```ts
+import { z } from "zod";
 import { createCli, createSubcommand, createOptions, safeParse } from "zod-args-parser";
 
 // Share same options between subcommands
 const sharedOptions = createOptions([
   {
     name: "verbose",
-    aliases: ["v"],
     description: "Verbose mode",
     type: z.boolean().optional(),
   },
@@ -33,25 +33,43 @@ const sharedOptions = createOptions([
 
 // Create a CLI schema
 // This will be used when no subcommands are provided
-const cliProgram = createCli({
+const cliSchema = createCli({
   cliName: "my-cli",
   description: "A description for my CLI",
   example: "example of how to use my cli\nmy-cli --help",
   options: [
     {
       name: "help",
-      description: "Show this help message",
       aliases: ["h"],
-      type: z.boolean(),
+      type: z.boolean().optional().describe("Show this help message"),
+    },
+    {
+      name: "version",
+      aliases: ["v"],
+      description: "Show version",
+      type: z.boolean().optional(),
     },
     ...sharedOptions,
   ],
 });
 
-// Execute this function when the CLI is run
-cliProgram.setAction(results => {
-  const { help } = results;
-  if (help) results.printCliHelp();
+// Execute this function when the CLI is run (no subcommands)
+cliSchema.setAction(results => {
+  const { help, version, verbose } = results;
+
+  if (help) {
+    results.printCliHelp();
+    return;
+  }
+
+  if (version) {
+    console.log("v1.0.0");
+    return;
+  }
+
+  if (verbose) {
+    console.log("Verbose mode enabled");
+  }
 });
 
 // Create a subcommand schema
@@ -77,7 +95,7 @@ helpCommandSchema.setAction(results => {
 
 const results = safeParse(
   process.argv.slice(2),
-  cliProgram,
+  cliSchema,
   helpCommandSchema,
   // Add more subcommands
 );
@@ -131,6 +149,9 @@ type Arguments = InferArgumentsType<typeof subcommand>;
 - `description?: string`  
   A description of the subcommand for the help message.
 
+- `usage?: string`  
+  The usage of the subcommand for the help message.
+
 - `placeholder?: string`  
   A placeholder displayed in the help message alongside the subcommand name.
 
@@ -145,7 +166,7 @@ type Arguments = InferArgumentsType<typeof subcommand>;
   An array of options for the subcommand.
 
   - `name: string`  
-    The name of the option. Should be a valid variable name in JavaScript.
+    The name of the option. camelCase is recommended. E.g. `inputDir` -> `--input-dir`
 
   - `aliases?: string[]`  
     An array of aliases for the option.

package/lib/commonjs/help.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.help=void 0;var _chalk=_interopRequireDefault(require("chalk"));var _utils=require("./utils.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}const colors={title:_chalk.default.bold.blue,description:_chalk.default.white,default:_chalk.default.dim.italic,optional:_chalk.default.dim.italic,exampleTitle:_chalk.default.yellow,example:_chalk.default.dim.italic,command:_chalk.default.yellow,option:_chalk.default.cyan,argument:_chalk.default.green,placeholder:_chalk.default.hex("#FF9800"),punctuation:_chalk.default.white.dim};function printCliHelp(params){let printOptions=arguments.length>1&&arguments[1]!==undefined?arguments[1]:{};printOptions.colors??=true;const noColors=new Proxy(colors,{get:()=>{return function(){for(var _len=arguments.length,str=new Array(_len),_key=0;_key<_len;_key++){str[_key]=arguments[_key];}return str.join(" ");};}});const c=printOptions.colors?colors:noColors;if(printOptions.customColors){Object.assign(c,printOptions.customColors);}const isFirstParamCli="cliName"in params[0];const cliOptions=isFirstParamCli?params.shift():{};const subcommands=params;const printTitle=title=>{(0,_utils.print)(c.title(` ${title.toUpperCase()} `));};const cliName=cliOptions.cliName??"";const usage=cliOptions.usage??(0,_utils.concat)(c.punctuation("$"),cliName,subcommands.length?c.command("[command]"):"",cliOptions.options?.length?c.option("[options]"):"",cliOptions.arguments?.length||cliOptions.allowPositional?c.argument("<arguments>"):"");printTitle("Usage");(0,_utils.println)();(0,_utils.println)((0,_utils.indent)(2),usage,(0,_utils.ln)(1));if(cliOptions.description){printTitle("Description");(0,_utils.println)();(0,_utils.println)((0,_utils.indent)(2),c.description(cliOptions.description),(0,_utils.ln)(1));}let longest=0;const[optionsToPrint,longestOptionIndent]=prepareOptionsToPrint(cliOptions.options);if(longestOptionIndent>longest)longest=longestOptionIndent;const[commandsToPrint,longestSubcommandIndent]=prepareCommandsToPrint(subcommands);if(longestSubcommandIndent>longest)longest=longestSubcommandIndent;const[argsToPrint,longestArgIndent]=prepareArgumentsToPrint(cliOptions.arguments);if(longestArgIndent>longest)longest=longestArgIndent;printPreparedOptions(optionsToPrint,c,longest);printPreparedCommands(commandsToPrint,c,longest);printPreparedArguments(argsToPrint,c,longest);if(cliOptions.example){printTitle("Example");(0,_utils.println)();const normalizeExample=cliOptions.example.replace(/\n/g,"\n"+(0,_utils.indent)(3));(0,_utils.println)((0,_utils.indent)(2),c.example(normalizeExample),(0,_utils.ln)(1));}}function printSubcommandHelp(subcommand){let printOptions=arguments.length>1&&arguments[1]!==undefined?arguments[1]:{};let cliName=arguments.length>2&&arguments[2]!==undefined?arguments[2]:"";printOptions.colors??=true;const noColors=new Proxy(colors,{get:()=>{return function(){for(var _len2=arguments.length,str=new Array(_len2),_key2=0;_key2<_len2;_key2++){str[_key2]=arguments[_key2];}return str.join(" ");};}});const c=printOptions.colors?colors:noColors;if(printOptions.customColors){Object.assign(c,printOptions.customColors);}const printTitle=title=>{(0,_utils.print)(c.title(` ${title.toUpperCase()} `));};const usage=(0,_utils.concat)(c.punctuation("$"),cliName,c.command(subcommand.name),subcommand.options?.length?c.option("[options]"):"",subcommand.arguments?.length||subcommand.allowPositional?c.argument("<arguments>"):"");printTitle("Usage");(0,_utils.println)();(0,_utils.println)((0,_utils.indent)(2),usage,(0,_utils.ln)(1));if(subcommand.description){printTitle("Description");(0,_utils.println)();const normalizeDesc=subcommand.description.replace(/\n/g,"\n"+(0,_utils.indent)(3));(0,_utils.println)((0,_utils.indent)(2),c.description(normalizeDesc),(0,_utils.ln)(1));}let longest=0;const[optionsToPrint,longestOptionIndent]=prepareOptionsToPrint(subcommand.options);if(longestOptionIndent>longest)longest=longestOptionIndent;const[argsToPrint,longestArgIndent]=prepareArgumentsToPrint(subcommand.arguments);if(longestArgIndent>longest)longest=longestArgIndent;printPreparedOptions(optionsToPrint,c,longest);printPreparedArguments(argsToPrint,c,longest);if(subcommand.example){printTitle("Example");(0,_utils.println)();const normalizeExample=subcommand.example.replace(/\n/g,"\n"+(0,_utils.indent)(3));(0,_utils.println)((0,_utils.indent)(2),c.example(normalizeExample),(0,_utils.ln)(1));}}function prepareOptionsToPrint(options){if(!options||!options.length)return[[],0];const optionsToPrint=[];let longest=0;for(const option of options){const nameWithAliases=option.aliases?[...option.aliases,option.name]:[option.name];const names=Array.from(new Set(nameWithAliases.map(name=>(0,_utils.transformOptionToArg)(name)))).join(", ");const defaultValue=(0,_utils.getDefaultValueFromSchema)(option.type);const placeholder=option.placeholder??" ";optionsToPrint.push({names,placeholder,description:option.description??option.type.description??"",default:typeof defaultValue!=="undefined"?`(default: ${JSON.stringify(defaultValue)})`:"",optional:option.type.isOptional()?"[optional]":"",example:option.example??""});const optLength=names.length+placeholder.length;if(optLength>longest)longest=optLength;}return[optionsToPrint,longest];}function prepareCommandsToPrint(subcommands){if(!subcommands||!subcommands.length)return[[],0];const commandsToPrint=[];let longest=0;for(const subcommand of subcommands){const{name,aliases,description}=subcommand;const names=Array.from(new Set([...(aliases??[]),name])).join(", ");const placeholder=subcommand.placeholder??(subcommand.options?"[options]":subcommand.allowPositional?"<args>":" ");commandsToPrint.push({names,placeholder,description:description??""});const cmdLength=names.length+placeholder.length;if(cmdLength>longest)longest=cmdLength;}return[commandsToPrint,longest];}function prepareArgumentsToPrint(args){if(!args||!args.length)return[[],0];const argsToPrint=[];let longest=0;for(const arg of args){const defaultValue=(0,_utils.getDefaultValueFromSchema)(arg.type);argsToPrint.push({names:arg.name,description:arg.description??"",default:typeof defaultValue!=="undefined"?`(default: ${JSON.stringify(defaultValue)})`:"",optional:arg.type.isOptional()?"[optional]":"",example:arg.example??""});const cmdLength=arg.name.length;if(cmdLength>longest)longest=cmdLength;}return[argsToPrint,longest];}function printPreparedOptions(optionsToPrint,c,longest){if(!optionsToPrint.length)return;(0,_utils.print)(c.title(" OPTIONS "));(0,_utils.println)();for(const{names,placeholder,description,example,optional,default:def}of optionsToPrint){const optLength=names.length+(placeholder?.length??0);const spacing=longest+1-optLength;const normalizeDesc=description.replace(/\n/g,"\n"+(0,_utils.indent)(longest+7)+c.punctuation("└"));const coloredNames=names.split(/(,)/).map(name=>name===","?c.punctuation(name):c.option(name)).join("");(0,_utils.println)((0,_utils.indent)(2),coloredNames,c.placeholder(placeholder),(0,_utils.indent)(spacing),c.description(normalizeDesc),def?c.default(def):c.optional(optional));if(example){const normalizeExample=example.replace(/\n/g,"\n"+(0,_utils.indent)(longest+17));(0,_utils.println)((0,_utils.indent)(longest+6),c.punctuation("└")+c.exampleTitle("Example:"),c.example(normalizeExample));}}(0,_utils.println)();}function printPreparedCommands(commandsToPrint,c,longest){if(!commandsToPrint.length)return;(0,_utils.print)(c.title(" COMMANDS "));(0,_utils.println)();for(const{names,placeholder,description}of commandsToPrint){const optLength=names.length+(placeholder?.length??0);const spacing=longest+1-optLength;const normalizeDesc=description.replace(/\n/g,"\n"+(0,_utils.indent)(longest+7));const coloredNames=names.split(/(,)/).map(name=>name===","?c.punctuation(name):c.command(name)).join("");(0,_utils.println)((0,_utils.indent)(2),coloredNames,c.placeholder(placeholder),(0,_utils.indent)(spacing),c.description(normalizeDesc));}(0,_utils.println)();}function printPreparedArguments(argsToPrint,c,longest){if(!argsToPrint.length)return;(0,_utils.print)(c.title(" ARGUMENTS "));(0,_utils.println)();for(const{names,description,example,optional,default:def}of argsToPrint){const spacing=longest+2-names.length;const normalizeDesc=description.replace(/\n/g,"\n"+(0,_utils.indent)(longest+6)+c.punctuation("└"));(0,_utils.println)((0,_utils.indent)(2),c.argument(names),(0,_utils.indent)(spacing),c.description(normalizeDesc),def?c.default(def):c.optional(optional));if(example){const normalizeExample=example.replace(/\n/g,"\n"+(0,_utils.indent)(longest+16));(0,_utils.println)((0,_utils.indent)(longest+5),c.punctuation("└")+c.exampleTitle("Example:"),c.example(normalizeExample));}}(0,_utils.println)();}const help=exports.help={printCliHelp,printSubcommandHelp};
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.help=void 0;var _chalk=_interopRequireDefault(require("chalk"));var _utils=require("./utils.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}const colors={title:_chalk.default.bold.blue,description:_chalk.default.white,default:_chalk.default.dim.italic,optional:_chalk.default.dim.italic,exampleTitle:_chalk.default.yellow,example:_chalk.default.dim,command:_chalk.default.yellow,option:_chalk.default.cyan,argument:_chalk.default.green,placeholder:_chalk.default.hex("#FF9800"),punctuation:_chalk.default.white.dim};function printCliHelp(params){let printOptions=arguments.length>1&&arguments[1]!==undefined?arguments[1]:{};printOptions.colors??=true;const noColors=new Proxy(colors,{get:()=>{return function(){for(var _len=arguments.length,str=new Array(_len),_key=0;_key<_len;_key++){str[_key]=arguments[_key];}return str.join(" ");};}});const c=printOptions.colors?colors:noColors;if(printOptions.customColors){Object.assign(c,printOptions.customColors);}const isFirstParamCli="cliName"in params[0];const cliOptions=isFirstParamCli?params.shift():{};const subcommands=params;const printTitle=title=>{(0,_utils.print)(c.title(` ${title.toUpperCase()} `));};const cliName=cliOptions.cliName??"";const usage=cliOptions.usage??(0,_utils.concat)(c.punctuation("$"),cliName,subcommands.length?c.command("[command]"):"",cliOptions.options?.length?c.option("[options]"):"",cliOptions.arguments?.length||cliOptions.allowPositional?c.argument("<arguments>"):"");printTitle("Usage");(0,_utils.println)();(0,_utils.println)((0,_utils.indent)(2),usage,(0,_utils.ln)(1));if(cliOptions.description){printTitle("Description");(0,_utils.println)();(0,_utils.println)((0,_utils.indent)(2),c.description(cliOptions.description),(0,_utils.ln)(1));}let longest=0;const[optionsToPrint,longestOptionIndent]=prepareOptionsToPrint(cliOptions.options);if(longestOptionIndent>longest)longest=longestOptionIndent;const[commandsToPrint,longestSubcommandIndent]=prepareCommandsToPrint(subcommands);if(longestSubcommandIndent>longest)longest=longestSubcommandIndent;const[argsToPrint,longestArgIndent]=prepareArgumentsToPrint(cliOptions.arguments);if(longestArgIndent>longest)longest=longestArgIndent;printPreparedOptions(optionsToPrint,c,longest);printPreparedCommands(commandsToPrint,c,longest);printPreparedArguments(argsToPrint,c,longest);if(cliOptions.example){printTitle("Example");(0,_utils.println)();const normalizeExample=cliOptions.example.replace(/\n/g,"\n"+(0,_utils.indent)(3));(0,_utils.println)((0,_utils.indent)(2),c.example(normalizeExample),(0,_utils.ln)(1));}}function printSubcommandHelp(subcommand){let printOptions=arguments.length>1&&arguments[1]!==undefined?arguments[1]:{};let cliName=arguments.length>2&&arguments[2]!==undefined?arguments[2]:"";printOptions.colors??=true;const noColors=new Proxy(colors,{get:()=>{return function(){for(var _len2=arguments.length,str=new Array(_len2),_key2=0;_key2<_len2;_key2++){str[_key2]=arguments[_key2];}return str.join(" ");};}});const c=printOptions.colors?colors:noColors;if(printOptions.customColors){Object.assign(c,printOptions.customColors);}const printTitle=title=>{(0,_utils.print)(c.title(` ${title.toUpperCase()} `));};const usage=subcommand.usage??(0,_utils.concat)(c.punctuation("$"),cliName,c.command(subcommand.name),subcommand.options?.length?c.option("[options]"):"",subcommand.arguments?.length||subcommand.allowPositional?c.argument("<arguments>"):"");printTitle("Usage");(0,_utils.println)();(0,_utils.println)((0,_utils.indent)(2),usage,(0,_utils.ln)(1));if(subcommand.description){printTitle("Description");(0,_utils.println)();const normalizeDesc=subcommand.description.replace(/\n/g,"\n"+(0,_utils.indent)(3));(0,_utils.println)((0,_utils.indent)(2),c.description(normalizeDesc),(0,_utils.ln)(1));}let longest=0;const[optionsToPrint,longestOptionIndent]=prepareOptionsToPrint(subcommand.options);if(longestOptionIndent>longest)longest=longestOptionIndent;const[argsToPrint,longestArgIndent]=prepareArgumentsToPrint(subcommand.arguments);if(longestArgIndent>longest)longest=longestArgIndent;printPreparedOptions(optionsToPrint,c,longest);printPreparedArguments(argsToPrint,c,longest);if(subcommand.example){printTitle("Example");(0,_utils.println)();const normalizeExample=subcommand.example.replace(/\n/g,"\n"+(0,_utils.indent)(3));(0,_utils.println)((0,_utils.indent)(2),c.example(normalizeExample),(0,_utils.ln)(1));}}function prepareOptionsToPrint(options){if(!options||!options.length)return[[],0];const optionsToPrint=[];let longest=0;for(const option of options){const nameWithAliases=option.aliases?[...option.aliases,option.name]:[option.name];const names=Array.from(new Set(nameWithAliases.map(name=>(0,_utils.transformOptionToArg)(name)))).join(", ");const defaultValue=(0,_utils.getDefaultValueFromSchema)(option.type);const placeholder=option.placeholder??" ";optionsToPrint.push({names,placeholder,description:option.description??option.type.description??"",default:typeof defaultValue!=="undefined"?`(default: ${JSON.stringify(defaultValue)})`:"",optional:option.type.isOptional()?"[optional]":"",example:option.example??""});const optLength=names.length+placeholder.length;if(optLength>longest)longest=optLength;}return[optionsToPrint,longest];}function prepareCommandsToPrint(subcommands){if(!subcommands||!subcommands.length)return[[],0];const commandsToPrint=[];let longest=0;for(const subcommand of subcommands){const{name,aliases,description}=subcommand;const names=Array.from(new Set([...(aliases??[]),name])).join(", ");const placeholder=subcommand.placeholder??(subcommand.options?"[options]":subcommand.allowPositional?"<args>":" ");commandsToPrint.push({names,placeholder,description:description??""});const cmdLength=names.length+placeholder.length;if(cmdLength>longest)longest=cmdLength;}return[commandsToPrint,longest];}function prepareArgumentsToPrint(args){if(!args||!args.length)return[[],0];const argsToPrint=[];let longest=0;for(const arg of args){const defaultValue=(0,_utils.getDefaultValueFromSchema)(arg.type);argsToPrint.push({names:arg.name,description:arg.description??"",default:typeof defaultValue!=="undefined"?`(default: ${JSON.stringify(defaultValue)})`:"",optional:arg.type.isOptional()?"[optional]":"",example:arg.example??""});const cmdLength=arg.name.length;if(cmdLength>longest)longest=cmdLength;}return[argsToPrint,longest];}function printPreparedOptions(optionsToPrint,c,longest){if(!optionsToPrint.length)return;(0,_utils.print)(c.title(" OPTIONS "));(0,_utils.println)();for(const{names,placeholder,description,example,optional,default:def}of optionsToPrint){const optLength=names.length+(placeholder?.length??0);const spacing=longest+1-optLength;const normalizeDesc=description.replace(/\n/g,"\n"+(0,_utils.indent)(longest+7)+c.punctuation("└"));const coloredNames=names.split(/(,)/).map(name=>name===","?c.punctuation(name):c.option(name)).join("");(0,_utils.println)((0,_utils.indent)(2),coloredNames,c.placeholder(placeholder),(0,_utils.indent)(spacing),c.description(normalizeDesc),def?c.default(def):c.optional(optional));if(example){const normalizeExample=example.replace(/\n/g,"\n"+(0,_utils.indent)(longest+17));(0,_utils.println)((0,_utils.indent)(longest+6),c.punctuation("└")+c.exampleTitle("Example:"),c.example(normalizeExample));}}(0,_utils.println)();}function printPreparedCommands(commandsToPrint,c,longest){if(!commandsToPrint.length)return;(0,_utils.print)(c.title(" COMMANDS "));(0,_utils.println)();for(const{names,placeholder,description}of commandsToPrint){const optLength=names.length+(placeholder?.length??0);const spacing=longest+1-optLength;const normalizeDesc=description.replace(/\n/g,"\n"+(0,_utils.indent)(longest+7)+c.punctuation("└"));const coloredNames=names.split(/(,)/).map(name=>name===","?c.punctuation(name):c.command(name)).join("");(0,_utils.println)((0,_utils.indent)(2),coloredNames,c.placeholder(placeholder),(0,_utils.indent)(spacing),c.description(normalizeDesc));}(0,_utils.println)();}function printPreparedArguments(argsToPrint,c,longest){if(!argsToPrint.length)return;(0,_utils.print)(c.title(" ARGUMENTS "));(0,_utils.println)();for(const{names,description,example,optional,default:def}of argsToPrint){const spacing=longest+2-names.length;const normalizeDesc=description.replace(/\n/g,"\n"+(0,_utils.indent)(longest+6)+c.punctuation("└"));(0,_utils.println)((0,_utils.indent)(2),c.argument(names),(0,_utils.indent)(spacing),c.description(normalizeDesc),def?c.default(def):c.optional(optional));if(example){const normalizeExample=example.replace(/\n/g,"\n"+(0,_utils.indent)(longest+16));(0,_utils.println)((0,_utils.indent)(longest+5),c.punctuation("└")+c.exampleTitle("Example:"),c.example(normalizeExample));}}(0,_utils.println)();}const help=exports.help={printCliHelp,printSubcommandHelp};

package/lib/commonjs/help.js.map

@@ -1 +1 @@
-{"version":3,"names":["_chalk","_interopRequireDefault","require","_utils","e","__esModule","default","colors","title","chalk","bold","blue","description","white","dim","italic","optional","exampleTitle","yellow","example","command","option","cyan","argument","green","placeholder","hex","punctuation","printCliHelp","params","printOptions","arguments","length","undefined","noColors","Proxy","get","_len","str","Array","_key","join","c","customColors","Object","assign","isFirstParamCli","cliOptions","shift","subcommands","printTitle","print","toUpperCase","cliName","usage","concat","options","allowPositional","println","indent","ln","longest","optionsToPrint","longestOptionIndent","prepareOptionsToPrint","commandsToPrint","longestSubcommandIndent","prepareCommandsToPrint","argsToPrint","longestArgIndent","prepareArgumentsToPrint","printPreparedOptions","printPreparedCommands","printPreparedArguments","normalizeExample","replace","printSubcommandHelp","subcommand","_len2","_key2","name","normalizeDesc","nameWithAliases","aliases","names","from","Set","map","transformOptionToArg","defaultValue","getDefaultValueFromSchema","type","push","JSON","stringify","isOptional","optLength","cmdLength","args","arg","def","spacing","coloredNames","split","help","exports"],"sourceRoot":"../../src","sources":["help.ts"],"sourcesContent":["import chalk from \"chalk\";\nimport { concat, getDefaultValueFromSchema, indent, ln, print, println, transformOptionToArg } from \"./utils.js\";\n\nimport type { Argument, Cli, Option, PrintHelpOpt, Subcommand } from \"./types.js\";\n\n/** Colors */\nconst colors: NonNullable<Required<PrintHelpOpt[\"customColors\"]>> = {\n  title: chalk.bold.blue,\n  description: chalk.white,\n  default: chalk.dim.italic,\n  optional: chalk.dim.italic,\n  exampleTitle: chalk.yellow,\n  example: chalk.dim.italic,\n  command: chalk.yellow,\n  option: chalk.cyan,\n  argument: chalk.green,\n  placeholder: chalk.hex(\"#FF9800\"),\n  punctuation: chalk.white.dim,\n};\n\ntype PreparedToPrint = {\n  names: string;\n  description: string;\n  placeholder?: string;\n  example?: string;\n  default?: string;\n  optional?: string;\n};\n\nfunction printCliHelp(params: [Cli, ...Subcommand[]], printOptions: PrintHelpOpt = {}) {\n  printOptions.colors ??= true;\n\n  const noColors = new Proxy(colors, {\n    get: () => {\n      return (...str: string[]) => str.join(\" \");\n    },\n  });\n\n  const c = printOptions.colors ? colors : noColors;\n\n  if (printOptions.customColors) {\n    Object.assign(c, printOptions.customColors);\n  }\n\n  const isFirstParamCli = \"cliName\" in params[0];\n  const cliOptions = (isFirstParamCli ? params.shift() : {}) as Cli;\n  const subcommands = params as Subcommand[];\n\n  /** Print a styled title */\n  const printTitle = (title: string) => {\n    print(c.title(` ${title.toUpperCase()} `));\n  };\n\n  // Print CLI usage\n  const cliName = cliOptions.cliName ?? \"\";\n  const usage =\n    cliOptions.usage ??\n    concat(\n      c.punctuation(\"$\"),\n      cliName,\n      subcommands.length ? c.command(\"[command]\") : \"\",\n      cliOptions.options?.length ? c.option(\"[options]\") : \"\",\n      cliOptions.arguments?.length || cliOptions.allowPositional ? c.argument(\"<arguments>\") : \"\",\n    );\n  printTitle(\"Usage\");\n  println();\n  println(indent(2), usage, ln(1));\n\n  // Print CLI description\n  if (cliOptions.description) {\n    printTitle(\"Description\");\n    println();\n    println(indent(2), c.description(cliOptions.description), ln(1));\n  }\n\n  let longest = 0;\n\n  // Prepare CLI options\n  const [optionsToPrint, longestOptionIndent] = prepareOptionsToPrint(cliOptions.options);\n  if (longestOptionIndent > longest) longest = longestOptionIndent;\n\n  // Prepare CLI commands\n  const [commandsToPrint, longestSubcommandIndent] = prepareCommandsToPrint(subcommands);\n  if (longestSubcommandIndent > longest) longest = longestSubcommandIndent;\n\n  // Prepare CLI arguments\n  const [argsToPrint, longestArgIndent] = prepareArgumentsToPrint(cliOptions.arguments);\n  if (longestArgIndent > longest) longest = longestArgIndent;\n\n  // Print CLI options\n  printPreparedOptions(optionsToPrint, c, longest);\n\n  // Print CLI commands\n  printPreparedCommands(commandsToPrint, c, longest);\n\n  // Print CLI arguments\n  printPreparedArguments(argsToPrint, c, longest);\n\n  // Print CLI example\n  if (cliOptions.example) {\n    printTitle(\"Example\");\n    println();\n    const normalizeExample = cliOptions.example.replace(/\\n/g, \"\\n\" + indent(3));\n    println(indent(2), c.example(normalizeExample), ln(1));\n  }\n}\n\nfunction printSubcommandHelp(subcommand: Subcommand, printOptions: PrintHelpOpt = {}, cliName = \"\") {\n  printOptions.colors ??= true;\n\n  const noColors = new Proxy(colors, {\n    get: () => {\n      return (...str: string[]) => str.join(\" \");\n    },\n  });\n\n  const c = printOptions.colors ? colors : noColors;\n\n  if (printOptions.customColors) {\n    Object.assign(c, printOptions.customColors);\n  }\n\n  /** Print a styled title */\n  const printTitle = (title: string) => {\n    print(c.title(` ${title.toUpperCase()} `));\n  };\n\n  // Print command usage\n  const usage = concat(\n    c.punctuation(\"$\"),\n    cliName,\n    c.command(subcommand.name),\n    subcommand.options?.length ? c.option(\"[options]\") : \"\",\n    subcommand.arguments?.length || subcommand.allowPositional ? c.argument(\"<arguments>\") : \"\",\n  );\n  printTitle(\"Usage\");\n  println();\n  println(indent(2), usage, ln(1));\n\n  // Print command description\n  if (subcommand.description) {\n    printTitle(\"Description\");\n    println();\n    const normalizeDesc = subcommand.description.replace(/\\n/g, \"\\n\" + indent(3));\n    println(indent(2), c.description(normalizeDesc), ln(1));\n  }\n\n  let longest = 0;\n\n  // Prepare command options\n  const [optionsToPrint, longestOptionIndent] = prepareOptionsToPrint(subcommand.options);\n  if (longestOptionIndent > longest) longest = longestOptionIndent;\n\n  // Prepare command arguments\n  const [argsToPrint, longestArgIndent] = prepareArgumentsToPrint(subcommand.arguments);\n  if (longestArgIndent > longest) longest = longestArgIndent;\n\n  // Print command options\n  printPreparedOptions(optionsToPrint, c, longest);\n\n  // Print command arguments\n  printPreparedArguments(argsToPrint, c, longest);\n\n  // Print command example\n  if (subcommand.example) {\n    printTitle(\"Example\");\n    println();\n    const normalizeExample = subcommand.example.replace(/\\n/g, \"\\n\" + indent(3));\n    println(indent(2), c.example(normalizeExample), ln(1));\n  }\n}\n\n// * Prepare\nfunction prepareOptionsToPrint(options: Option[] | undefined): [PreparedToPrint[], number] {\n  if (!options || !options.length) return [[], 0];\n\n  const optionsToPrint: PreparedToPrint[] = [];\n  let longest = 0;\n\n  for (const option of options) {\n    const nameWithAliases = option.aliases ? [...option.aliases, option.name] : [option.name];\n    const names = Array.from(new Set(nameWithAliases.map(name => transformOptionToArg(name)))).join(\", \");\n\n    const defaultValue = getDefaultValueFromSchema(option.type);\n\n    const placeholder = option.placeholder ?? \" \";\n    optionsToPrint.push({\n      names,\n      placeholder,\n      description: option.description ?? option.type.description ?? \"\",\n      default: typeof defaultValue !== \"undefined\" ? `(default: ${JSON.stringify(defaultValue)})` : \"\",\n      optional: option.type.isOptional() ? \"[optional]\" : \"\",\n      example: option.example ?? \"\",\n    });\n\n    const optLength = names.length + placeholder.length;\n\n    if (optLength > longest) longest = optLength;\n  }\n\n  return [optionsToPrint, longest];\n}\n\nfunction prepareCommandsToPrint(subcommands: Subcommand[] | undefined): [PreparedToPrint[], number] {\n  if (!subcommands || !subcommands.length) return [[], 0];\n\n  const commandsToPrint: PreparedToPrint[] = [];\n  let longest = 0;\n\n  for (const subcommand of subcommands) {\n    const { name, aliases, description } = subcommand;\n    const names = Array.from(new Set([...(aliases ?? []), name])).join(\", \");\n\n    const placeholder =\n      subcommand.placeholder ?? (subcommand.options ? \"[options]\" : subcommand.allowPositional ? \"<args>\" : \" \");\n\n    commandsToPrint.push({ names, placeholder, description: description ?? \"\" });\n\n    const cmdLength = names.length + placeholder.length;\n    if (cmdLength > longest) longest = cmdLength;\n  }\n\n  return [commandsToPrint, longest];\n}\n\nfunction prepareArgumentsToPrint(args: Argument[] | undefined): [PreparedToPrint[], number] {\n  if (!args || !args.length) return [[], 0];\n\n  const argsToPrint: PreparedToPrint[] = [];\n  let longest = 0;\n\n  for (const arg of args) {\n    const defaultValue = getDefaultValueFromSchema(arg.type);\n\n    argsToPrint.push({\n      names: arg.name,\n      description: arg.description ?? \"\",\n      default: typeof defaultValue !== \"undefined\" ? `(default: ${JSON.stringify(defaultValue)})` : \"\",\n      optional: arg.type.isOptional() ? \"[optional]\" : \"\",\n      example: arg.example ?? \"\",\n    });\n\n    const cmdLength = arg.name.length;\n    if (cmdLength > longest) longest = cmdLength;\n  }\n\n  return [argsToPrint, longest];\n}\n\n// * Print\nfunction printPreparedOptions(optionsToPrint: PreparedToPrint[], c: typeof colors, longest: number) {\n  if (!optionsToPrint.length) return;\n\n  print(c.title(\" OPTIONS \"));\n\n  println();\n\n  for (const { names, placeholder, description, example, optional, default: def } of optionsToPrint) {\n    const optLength = names.length + (placeholder?.length ?? 0);\n    const spacing = longest + 1 - optLength;\n    const normalizeDesc = description.replace(/\\n/g, \"\\n\" + indent(longest + 7) + c.punctuation(\"└\"));\n\n    const coloredNames = names\n      .split(/(,)/)\n      .map(name => (name === \",\" ? c.punctuation(name) : c.option(name)))\n      .join(\"\");\n\n    println(\n      indent(2),\n      coloredNames,\n      c.placeholder(placeholder),\n      indent(spacing),\n      c.description(normalizeDesc),\n      def ? c.default(def) : c.optional(optional),\n    );\n\n    if (example) {\n      const normalizeExample = example.replace(/\\n/g, \"\\n\" + indent(longest + 17));\n      println(indent(longest + 6), c.punctuation(\"└\") + c.exampleTitle(\"Example:\"), c.example(normalizeExample));\n    }\n  }\n\n  println();\n}\n\nfunction printPreparedCommands(commandsToPrint: PreparedToPrint[], c: typeof colors, longest: number) {\n  if (!commandsToPrint.length) return;\n\n  print(c.title(\" COMMANDS \"));\n\n  println();\n\n  for (const { names, placeholder, description } of commandsToPrint) {\n    const optLength = names.length + (placeholder?.length ?? 0);\n    const spacing = longest + 1 - optLength;\n    const normalizeDesc = description.replace(/\\n/g, \"\\n\" + indent(longest + 7));\n\n    const coloredNames = names\n      .split(/(,)/)\n      .map(name => (name === \",\" ? c.punctuation(name) : c.command(name)))\n      .join(\"\");\n\n    println(indent(2), coloredNames, c.placeholder(placeholder), indent(spacing), c.description(normalizeDesc));\n  }\n\n  println();\n}\n\nfunction printPreparedArguments(argsToPrint: PreparedToPrint[], c: typeof colors, longest: number) {\n  if (!argsToPrint.length) return;\n\n  print(c.title(\" ARGUMENTS \"));\n\n  println();\n\n  for (const { names, description, example, optional, default: def } of argsToPrint) {\n    const spacing = longest + 2 - names.length;\n    const normalizeDesc = description.replace(/\\n/g, \"\\n\" + indent(longest + 6) + c.punctuation(\"└\"));\n\n    println(\n      indent(2),\n      c.argument(names),\n      indent(spacing),\n      c.description(normalizeDesc),\n      def ? c.default(def) : c.optional(optional),\n    );\n\n    if (example) {\n      const normalizeExample = example.replace(/\\n/g, \"\\n\" + indent(longest + 16));\n      println(indent(longest + 5), c.punctuation(\"└\") + c.exampleTitle(\"Example:\"), c.example(normalizeExample));\n    }\n  }\n\n  println();\n}\n\nexport const help = {\n  printCliHelp,\n  printSubcommandHelp,\n};\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_chalk","_interopRequireDefault","require","_utils","e","__esModule","default","colors","title","chalk","bold","blue","description","white","dim","italic","optional","exampleTitle","yellow","example","command","option","cyan","argument","green","placeholder","hex","punctuation","printCliHelp","params","printOptions","arguments","length","undefined","noColors","Proxy","get","_len","str","Array","_key","join","c","customColors","Object","assign","isFirstParamCli","cliOptions","shift","subcommands","printTitle","print","toUpperCase","cliName","usage","concat","options","allowPositional","println","indent","ln","longest","optionsToPrint","longestOptionIndent","prepareOptionsToPrint","commandsToPrint","longestSubcommandIndent","prepareCommandsToPrint","argsToPrint","longestArgIndent","prepareArgumentsToPrint","printPreparedOptions","printPreparedCommands","printPreparedArguments","normalizeExample","replace","printSubcommandHelp","subcommand","_len2","_key2","name","normalizeDesc","nameWithAliases","aliases","names","from","Set","map","transformOptionToArg","defaultValue","getDefaultValueFromSchema","type","push","JSON","stringify","isOptional","optLength","cmdLength","args","arg","def","spacing","coloredNames","split","help","exports"],"sourceRoot":"../../src","sources":["help.ts"],"sourcesContent":["import chalk from \"chalk\";\nimport { concat, getDefaultValueFromSchema, indent, ln, print, println, transformOptionToArg } from \"./utils.js\";\n\nimport type { Argument, Cli, Option, PrintHelpOpt, Subcommand } from \"./types.js\";\n\nconst colors: NonNullable<Required<PrintHelpOpt[\"customColors\"]>> = {\n  title: chalk.bold.blue,\n  description: chalk.white,\n  default: chalk.dim.italic,\n  optional: chalk.dim.italic,\n  exampleTitle: chalk.yellow,\n  example: chalk.dim,\n  command: chalk.yellow,\n  option: chalk.cyan,\n  argument: chalk.green,\n  placeholder: chalk.hex(\"#FF9800\"),\n  punctuation: chalk.white.dim,\n};\n\ntype PreparedToPrint = {\n  names: string;\n  description: string;\n  placeholder?: string;\n  example?: string;\n  default?: string;\n  optional?: string;\n};\n\nfunction printCliHelp(params: [Cli, ...Subcommand[]], printOptions: PrintHelpOpt = {}) {\n  printOptions.colors ??= true;\n\n  const noColors = new Proxy(colors, {\n    get: () => {\n      return (...str: string[]) => str.join(\" \");\n    },\n  });\n\n  const c = printOptions.colors ? colors : noColors;\n\n  if (printOptions.customColors) {\n    Object.assign(c, printOptions.customColors);\n  }\n\n  const isFirstParamCli = \"cliName\" in params[0];\n  const cliOptions = (isFirstParamCli ? params.shift() : {}) as Cli;\n  const subcommands = params as Subcommand[];\n\n  /** Print a styled title */\n  const printTitle = (title: string) => {\n    print(c.title(` ${title.toUpperCase()} `));\n  };\n\n  // Print CLI usage\n  const cliName = cliOptions.cliName ?? \"\";\n  const usage =\n    cliOptions.usage ??\n    concat(\n      c.punctuation(\"$\"),\n      cliName,\n      subcommands.length ? c.command(\"[command]\") : \"\",\n      cliOptions.options?.length ? c.option(\"[options]\") : \"\",\n      cliOptions.arguments?.length || cliOptions.allowPositional ? c.argument(\"<arguments>\") : \"\",\n    );\n  printTitle(\"Usage\");\n  println();\n  println(indent(2), usage, ln(1));\n\n  // Print CLI description\n  if (cliOptions.description) {\n    printTitle(\"Description\");\n    println();\n    println(indent(2), c.description(cliOptions.description), ln(1));\n  }\n\n  let longest = 0;\n\n  // Prepare CLI options\n  const [optionsToPrint, longestOptionIndent] = prepareOptionsToPrint(cliOptions.options);\n  if (longestOptionIndent > longest) longest = longestOptionIndent;\n\n  // Prepare CLI commands\n  const [commandsToPrint, longestSubcommandIndent] = prepareCommandsToPrint(subcommands);\n  if (longestSubcommandIndent > longest) longest = longestSubcommandIndent;\n\n  // Prepare CLI arguments\n  const [argsToPrint, longestArgIndent] = prepareArgumentsToPrint(cliOptions.arguments);\n  if (longestArgIndent > longest) longest = longestArgIndent;\n\n  // Print CLI options\n  printPreparedOptions(optionsToPrint, c, longest);\n\n  // Print CLI commands\n  printPreparedCommands(commandsToPrint, c, longest);\n\n  // Print CLI arguments\n  printPreparedArguments(argsToPrint, c, longest);\n\n  // Print CLI example\n  if (cliOptions.example) {\n    printTitle(\"Example\");\n    println();\n    const normalizeExample = cliOptions.example.replace(/\\n/g, \"\\n\" + indent(3));\n    println(indent(2), c.example(normalizeExample), ln(1));\n  }\n}\n\nfunction printSubcommandHelp(subcommand: Subcommand, printOptions: PrintHelpOpt = {}, cliName = \"\") {\n  printOptions.colors ??= true;\n\n  const noColors = new Proxy(colors, {\n    get: () => {\n      return (...str: string[]) => str.join(\" \");\n    },\n  });\n\n  const c = printOptions.colors ? colors : noColors;\n\n  if (printOptions.customColors) {\n    Object.assign(c, printOptions.customColors);\n  }\n\n  /** Print a styled title */\n  const printTitle = (title: string) => {\n    print(c.title(` ${title.toUpperCase()} `));\n  };\n\n  // Print command usage\n  const usage =\n    subcommand.usage ??\n    concat(\n      c.punctuation(\"$\"),\n      cliName,\n      c.command(subcommand.name),\n      subcommand.options?.length ? c.option(\"[options]\") : \"\",\n      subcommand.arguments?.length || subcommand.allowPositional ? c.argument(\"<arguments>\") : \"\",\n    );\n  printTitle(\"Usage\");\n  println();\n  println(indent(2), usage, ln(1));\n\n  // Print command description\n  if (subcommand.description) {\n    printTitle(\"Description\");\n    println();\n    const normalizeDesc = subcommand.description.replace(/\\n/g, \"\\n\" + indent(3));\n    println(indent(2), c.description(normalizeDesc), ln(1));\n  }\n\n  let longest = 0;\n\n  // Prepare command options\n  const [optionsToPrint, longestOptionIndent] = prepareOptionsToPrint(subcommand.options);\n  if (longestOptionIndent > longest) longest = longestOptionIndent;\n\n  // Prepare command arguments\n  const [argsToPrint, longestArgIndent] = prepareArgumentsToPrint(subcommand.arguments);\n  if (longestArgIndent > longest) longest = longestArgIndent;\n\n  // Print command options\n  printPreparedOptions(optionsToPrint, c, longest);\n\n  // Print command arguments\n  printPreparedArguments(argsToPrint, c, longest);\n\n  // Print command example\n  if (subcommand.example) {\n    printTitle(\"Example\");\n    println();\n    const normalizeExample = subcommand.example.replace(/\\n/g, \"\\n\" + indent(3));\n    println(indent(2), c.example(normalizeExample), ln(1));\n  }\n}\n\n// * Prepare\nfunction prepareOptionsToPrint(options: Option[] | undefined): [PreparedToPrint[], number] {\n  if (!options || !options.length) return [[], 0];\n\n  const optionsToPrint: PreparedToPrint[] = [];\n  let longest = 0;\n\n  for (const option of options) {\n    const nameWithAliases = option.aliases ? [...option.aliases, option.name] : [option.name];\n    const names = Array.from(new Set(nameWithAliases.map(name => transformOptionToArg(name)))).join(\", \");\n\n    const defaultValue = getDefaultValueFromSchema(option.type);\n\n    const placeholder = option.placeholder ?? \" \";\n    optionsToPrint.push({\n      names,\n      placeholder,\n      description: option.description ?? option.type.description ?? \"\",\n      default: typeof defaultValue !== \"undefined\" ? `(default: ${JSON.stringify(defaultValue)})` : \"\",\n      optional: option.type.isOptional() ? \"[optional]\" : \"\",\n      example: option.example ?? \"\",\n    });\n\n    const optLength = names.length + placeholder.length;\n\n    if (optLength > longest) longest = optLength;\n  }\n\n  return [optionsToPrint, longest];\n}\n\nfunction prepareCommandsToPrint(subcommands: Subcommand[] | undefined): [PreparedToPrint[], number] {\n  if (!subcommands || !subcommands.length) return [[], 0];\n\n  const commandsToPrint: PreparedToPrint[] = [];\n  let longest = 0;\n\n  for (const subcommand of subcommands) {\n    const { name, aliases, description } = subcommand;\n    const names = Array.from(new Set([...(aliases ?? []), name])).join(\", \");\n\n    const placeholder =\n      subcommand.placeholder ?? (subcommand.options ? \"[options]\" : subcommand.allowPositional ? \"<args>\" : \" \");\n\n    commandsToPrint.push({ names, placeholder, description: description ?? \"\" });\n\n    const cmdLength = names.length + placeholder.length;\n    if (cmdLength > longest) longest = cmdLength;\n  }\n\n  return [commandsToPrint, longest];\n}\n\nfunction prepareArgumentsToPrint(args: Argument[] | undefined): [PreparedToPrint[], number] {\n  if (!args || !args.length) return [[], 0];\n\n  const argsToPrint: PreparedToPrint[] = [];\n  let longest = 0;\n\n  for (const arg of args) {\n    const defaultValue = getDefaultValueFromSchema(arg.type);\n\n    argsToPrint.push({\n      names: arg.name,\n      description: arg.description ?? \"\",\n      default: typeof defaultValue !== \"undefined\" ? `(default: ${JSON.stringify(defaultValue)})` : \"\",\n      optional: arg.type.isOptional() ? \"[optional]\" : \"\",\n      example: arg.example ?? \"\",\n    });\n\n    const cmdLength = arg.name.length;\n    if (cmdLength > longest) longest = cmdLength;\n  }\n\n  return [argsToPrint, longest];\n}\n\n// * Print\nfunction printPreparedOptions(optionsToPrint: PreparedToPrint[], c: typeof colors, longest: number) {\n  if (!optionsToPrint.length) return;\n\n  print(c.title(\" OPTIONS \"));\n\n  println();\n\n  for (const { names, placeholder, description, example, optional, default: def } of optionsToPrint) {\n    const optLength = names.length + (placeholder?.length ?? 0);\n    const spacing = longest + 1 - optLength;\n    const normalizeDesc = description.replace(/\\n/g, \"\\n\" + indent(longest + 7) + c.punctuation(\"└\"));\n\n    const coloredNames = names\n      .split(/(,)/)\n      .map(name => (name === \",\" ? c.punctuation(name) : c.option(name)))\n      .join(\"\");\n\n    println(\n      indent(2),\n      coloredNames,\n      c.placeholder(placeholder),\n      indent(spacing),\n      c.description(normalizeDesc),\n      def ? c.default(def) : c.optional(optional),\n    );\n\n    if (example) {\n      const normalizeExample = example.replace(/\\n/g, \"\\n\" + indent(longest + 17));\n      println(indent(longest + 6), c.punctuation(\"└\") + c.exampleTitle(\"Example:\"), c.example(normalizeExample));\n    }\n  }\n\n  println();\n}\n\nfunction printPreparedCommands(commandsToPrint: PreparedToPrint[], c: typeof colors, longest: number) {\n  if (!commandsToPrint.length) return;\n\n  print(c.title(\" COMMANDS \"));\n\n  println();\n\n  for (const { names, placeholder, description } of commandsToPrint) {\n    const optLength = names.length + (placeholder?.length ?? 0);\n    const spacing = longest + 1 - optLength;\n    const normalizeDesc = description.replace(/\\n/g, \"\\n\" + indent(longest + 7) + c.punctuation(\"└\"));\n\n    const coloredNames = names\n      .split(/(,)/)\n      .map(name => (name === \",\" ? c.punctuation(name) : c.command(name)))\n      .join(\"\");\n\n    println(indent(2), coloredNames, c.placeholder(placeholder), indent(spacing), c.description(normalizeDesc));\n  }\n\n  println();\n}\n\nfunction printPreparedArguments(argsToPrint: PreparedToPrint[], c: typeof colors, longest: number) {\n  if (!argsToPrint.length) return;\n\n  print(c.title(\" ARGUMENTS \"));\n\n  println();\n\n  for (const { names, description, example, optional, default: def } of argsToPrint) {\n    const spacing = longest + 2 - names.length;\n    const normalizeDesc = description.replace(/\\n/g, \"\\n\" + indent(longest + 6) + c.punctuation(\"└\"));\n\n    println(\n      indent(2),\n      c.argument(names),\n      indent(spacing),\n      c.description(normalizeDesc),\n      def ? c.default(def) : c.optional(optional),\n    );\n\n    if (example) {\n      const normalizeExample = example.replace(/\\n/g, \"\\n\" + indent(longest + 16));\n      println(indent(longest + 5), c.punctuation(\"└\") + c.exampleTitle(\"Example:\"), c.example(normalizeExample));\n    }\n  }\n\n  println();\n}\n\nexport const help = {\n  printCliHelp,\n  printSubcommandHelp,\n};\n"],"mappings":"0FAAA,IAAAA,MAAA,CAAAC,sBAAA,CAAAC,OAAA,WACA,IAAAC,MAAA,CAAAD,OAAA,eAAiH,SAAAD,uBAAAG,CAAA,SAAAA,CAAA,EAAAA,CAAA,CAAAC,UAAA,CAAAD,CAAA,EAAAE,OAAA,CAAAF,CAAA,GAIjH,KAAM,CAAAG,MAA2D,CAAG,CAClEC,KAAK,CAAEC,cAAK,CAACC,IAAI,CAACC,IAAI,CACtBC,WAAW,CAAEH,cAAK,CAACI,KAAK,CACxBP,OAAO,CAAEG,cAAK,CAACK,GAAG,CAACC,MAAM,CACzBC,QAAQ,CAAEP,cAAK,CAACK,GAAG,CAACC,MAAM,CAC1BE,YAAY,CAAER,cAAK,CAACS,MAAM,CAC1BC,OAAO,CAAEV,cAAK,CAACK,GAAG,CAClBM,OAAO,CAAEX,cAAK,CAACS,MAAM,CACrBG,MAAM,CAAEZ,cAAK,CAACa,IAAI,CAClBC,QAAQ,CAAEd,cAAK,CAACe,KAAK,CACrBC,WAAW,CAAEhB,cAAK,CAACiB,GAAG,CAAC,SAAS,CAAC,CACjCC,WAAW,CAAElB,cAAK,CAACI,KAAK,CAACC,GAC3B,CAAC,CAWD,QAAS,CAAAc,YAAYA,CAACC,MAA8B,CAAmC,IAAjC,CAAAC,YAA0B,CAAAC,SAAA,CAAAC,MAAA,IAAAD,SAAA,MAAAE,SAAA,CAAAF,SAAA,IAAG,CAAC,CAAC,CACnFD,YAAY,CAACvB,MAAM,GAAK,IAAI,CAE5B,KAAM,CAAA2B,QAAQ,CAAG,GAAI,CAAAC,KAAK,CAAC5B,MAAM,CAAE,CACjC6B,GAAG,CAAEA,CAAA,GAAM,CACT,MAAO,oBAAAC,IAAA,CAAAN,SAAA,CAAAC,MAAA,CAAIM,GAAG,KAAAC,KAAA,CAAAF,IAAA,EAAAG,IAAA,GAAAA,IAAA,CAAAH,IAAA,CAAAG,IAAA,IAAHF,GAAG,CAAAE,IAAA,EAAAT,SAAA,CAAAS,IAAA,SAAe,CAAAF,GAAG,CAACG,IAAI,CAAC,GAAG,CAAC,GAC5C,CACF,CAAC,CAAC,CAEF,KAAM,CAAAC,CAAC,CAAGZ,YAAY,CAACvB,MAAM,CAAGA,MAAM,CAAG2B,QAAQ,CAEjD,GAAIJ,YAAY,CAACa,YAAY,CAAE,CAC7BC,MAAM,CAACC,MAAM,CAACH,CAAC,CAAEZ,YAAY,CAACa,YAAY,CAAC,CAC7C,CAEA,KAAM,CAAAG,eAAe,CAAG,SAAS,EAAI,CAAAjB,MAAM,CAAC,CAAC,CAAC,CAC9C,KAAM,CAAAkB,UAAU,CAAID,eAAe,CAAGjB,MAAM,CAACmB,KAAK,CAAC,CAAC,CAAG,CAAC,CAAS,CACjE,KAAM,CAAAC,WAAW,CAAGpB,MAAsB,CAG1C,KAAM,CAAAqB,UAAU,CAAI1C,KAAa,EAAK,CACpC,GAAA2C,YAAK,EAACT,CAAC,CAAClC,KAAK,CAAC,IAAIA,KAAK,CAAC4C,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAC5C,CAAC,CAGD,KAAM,CAAAC,OAAO,CAAGN,UAAU,CAACM,OAAO,EAAI,EAAE,CACxC,KAAM,CAAAC,KAAK,CACTP,UAAU,CAACO,KAAK,EAChB,GAAAC,aAAM,EACJb,CAAC,CAACf,WAAW,CAAC,GAAG,CAAC,CAClB0B,OAAO,CACPJ,WAAW,CAACjB,MAAM,CAAGU,CAAC,CAACtB,OAAO,CAAC,WAAW,CAAC,CAAG,EAAE,CAChD2B,UAAU,CAACS,OAAO,EAAExB,MAAM,CAAGU,CAAC,CAACrB,MAAM,CAAC,WAAW,CAAC,CAAG,EAAE,CACvD0B,UAAU,CAAChB,SAAS,EAAEC,MAAM,EAAIe,UAAU,CAACU,eAAe,CAAGf,CAAC,CAACnB,QAAQ,CAAC,aAAa,CAAC,CAAG,EAC3F,CAAC,CACH2B,UAAU,CAAC,OAAO,CAAC,CACnB,GAAAQ,cAAO,EAAC,CAAC,CACT,GAAAA,cAAO,EAAC,GAAAC,aAAM,EAAC,CAAC,CAAC,CAAEL,KAAK,CAAE,GAAAM,SAAE,EAAC,CAAC,CAAC,CAAC,CAGhC,GAAIb,UAAU,CAACnC,WAAW,CAAE,CAC1BsC,UAAU,CAAC,aAAa,CAAC,CACzB,GAAAQ,cAAO,EAAC,CAAC,CACT,GAAAA,cAAO,EAAC,GAAAC,aAAM,EAAC,CAAC,CAAC,CAAEjB,CAAC,CAAC9B,WAAW,CAACmC,UAAU,CAACnC,WAAW,CAAC,CAAE,GAAAgD,SAAE,EAAC,CAAC,CAAC,CAAC,CAClE,CAEA,GAAI,CAAAC,OAAO,CAAG,CAAC,CAGf,KAAM,CAACC,cAAc,CAAEC,mBAAmB,CAAC,CAAGC,qBAAqB,CAACjB,UAAU,CAACS,OAAO,CAAC,CACvF,GAAIO,mBAAmB,CAAGF,OAAO,CAAEA,OAAO,CAAGE,mBAAmB,CAGhE,KAAM,CAACE,eAAe,CAAEC,uBAAuB,CAAC,CAAGC,sBAAsB,CAAClB,WAAW,CAAC,CACtF,GAAIiB,uBAAuB,CAAGL,OAAO,CAAEA,OAAO,CAAGK,uBAAuB,CAGxE,KAAM,CAACE,WAAW,CAAEC,gBAAgB,CAAC,CAAGC,uBAAuB,CAACvB,UAAU,CAAChB,SAAS,CAAC,CACrF,GAAIsC,gBAAgB,CAAGR,OAAO,CAAEA,OAAO,CAAGQ,gBAAgB,CAG1DE,oBAAoB,CAACT,cAAc,CAAEpB,CAAC,CAAEmB,OAAO,CAAC,CAGhDW,qBAAqB,CAACP,eAAe,CAAEvB,CAAC,CAAEmB,OAAO,CAAC,CAGlDY,sBAAsB,CAACL,WAAW,CAAE1B,CAAC,CAAEmB,OAAO,CAAC,CAG/C,GAAId,UAAU,CAAC5B,OAAO,CAAE,CACtB+B,UAAU,CAAC,SAAS,CAAC,CACrB,GAAAQ,cAAO,EAAC,CAAC,CACT,KAAM,CAAAgB,gBAAgB,CAAG3B,UAAU,CAAC5B,OAAO,CAACwD,OAAO,CAAC,KAAK,CAAE,IAAI,CAAG,GAAAhB,aAAM,EAAC,CAAC,CAAC,CAAC,CAC5E,GAAAD,cAAO,EAAC,GAAAC,aAAM,EAAC,CAAC,CAAC,CAAEjB,CAAC,CAACvB,OAAO,CAACuD,gBAAgB,CAAC,CAAE,GAAAd,SAAE,EAAC,CAAC,CAAC,CAAC,CACxD,CACF,CAEA,QAAS,CAAAgB,mBAAmBA,CAACC,UAAsB,CAAiD,IAA/C,CAAA/C,YAA0B,CAAAC,SAAA,CAAAC,MAAA,IAAAD,SAAA,MAAAE,SAAA,CAAAF,SAAA,IAAG,CAAC,CAAC,IAAE,CAAAsB,OAAO,CAAAtB,SAAA,CAAAC,MAAA,IAAAD,SAAA,MAAAE,SAAA,CAAAF,SAAA,IAAG,EAAE,CAChGD,YAAY,CAACvB,MAAM,GAAK,IAAI,CAE5B,KAAM,CAAA2B,QAAQ,CAAG,GAAI,CAAAC,KAAK,CAAC5B,MAAM,CAAE,CACjC6B,GAAG,CAAEA,CAAA,GAAM,CACT,MAAO,oBAAA0C,KAAA,CAAA/C,SAAA,CAAAC,MAAA,CAAIM,GAAG,KAAAC,KAAA,CAAAuC,KAAA,EAAAC,KAAA,GAAAA,KAAA,CAAAD,KAAA,CAAAC,KAAA,IAAHzC,GAAG,CAAAyC,KAAA,EAAAhD,SAAA,CAAAgD,KAAA,SAAe,CAAAzC,GAAG,CAACG,IAAI,CAAC,GAAG,CAAC,GAC5C,CACF,CAAC,CAAC,CAEF,KAAM,CAAAC,CAAC,CAAGZ,YAAY,CAACvB,MAAM,CAAGA,MAAM,CAAG2B,QAAQ,CAEjD,GAAIJ,YAAY,CAACa,YAAY,CAAE,CAC7BC,MAAM,CAACC,MAAM,CAACH,CAAC,CAAEZ,YAAY,CAACa,YAAY,CAAC,CAC7C,CAGA,KAAM,CAAAO,UAAU,CAAI1C,KAAa,EAAK,CACpC,GAAA2C,YAAK,EAACT,CAAC,CAAClC,KAAK,CAAC,IAAIA,KAAK,CAAC4C,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAC5C,CAAC,CAGD,KAAM,CAAAE,KAAK,CACTuB,UAAU,CAACvB,KAAK,EAChB,GAAAC,aAAM,EACJb,CAAC,CAACf,WAAW,CAAC,GAAG,CAAC,CAClB0B,OAAO,CACPX,CAAC,CAACtB,OAAO,CAACyD,UAAU,CAACG,IAAI,CAAC,CAC1BH,UAAU,CAACrB,OAAO,EAAExB,MAAM,CAAGU,CAAC,CAACrB,MAAM,CAAC,WAAW,CAAC,CAAG,EAAE,CACvDwD,UAAU,CAAC9C,SAAS,EAAEC,MAAM,EAAI6C,UAAU,CAACpB,eAAe,CAAGf,CAAC,CAACnB,QAAQ,CAAC,aAAa,CAAC,CAAG,EAC3F,CAAC,CACH2B,UAAU,CAAC,OAAO,CAAC,CACnB,GAAAQ,cAAO,EAAC,CAAC,CACT,GAAAA,cAAO,EAAC,GAAAC,aAAM,EAAC,CAAC,CAAC,CAAEL,KAAK,CAAE,GAAAM,SAAE,EAAC,CAAC,CAAC,CAAC,CAGhC,GAAIiB,UAAU,CAACjE,WAAW,CAAE,CAC1BsC,UAAU,CAAC,aAAa,CAAC,CACzB,GAAAQ,cAAO,EAAC,CAAC,CACT,KAAM,CAAAuB,aAAa,CAAGJ,UAAU,CAACjE,WAAW,CAAC+D,OAAO,CAAC,KAAK,CAAE,IAAI,CAAG,GAAAhB,aAAM,EAAC,CAAC,CAAC,CAAC,CAC7E,GAAAD,cAAO,EAAC,GAAAC,aAAM,EAAC,CAAC,CAAC,CAAEjB,CAAC,CAAC9B,WAAW,CAACqE,aAAa,CAAC,CAAE,GAAArB,SAAE,EAAC,CAAC,CAAC,CAAC,CACzD,CAEA,GAAI,CAAAC,OAAO,CAAG,CAAC,CAGf,KAAM,CAACC,cAAc,CAAEC,mBAAmB,CAAC,CAAGC,qBAAqB,CAACa,UAAU,CAACrB,OAAO,CAAC,CACvF,GAAIO,mBAAmB,CAAGF,OAAO,CAAEA,OAAO,CAAGE,mBAAmB,CAGhE,KAAM,CAACK,WAAW,CAAEC,gBAAgB,CAAC,CAAGC,uBAAuB,CAACO,UAAU,CAAC9C,SAAS,CAAC,CACrF,GAAIsC,gBAAgB,CAAGR,OAAO,CAAEA,OAAO,CAAGQ,gBAAgB,CAG1DE,oBAAoB,CAACT,cAAc,CAAEpB,CAAC,CAAEmB,OAAO,CAAC,CAGhDY,sBAAsB,CAACL,WAAW,CAAE1B,CAAC,CAAEmB,OAAO,CAAC,CAG/C,GAAIgB,UAAU,CAAC1D,OAAO,CAAE,CACtB+B,UAAU,CAAC,SAAS,CAAC,CACrB,GAAAQ,cAAO,EAAC,CAAC,CACT,KAAM,CAAAgB,gBAAgB,CAAGG,UAAU,CAAC1D,OAAO,CAACwD,OAAO,CAAC,KAAK,CAAE,IAAI,CAAG,GAAAhB,aAAM,EAAC,CAAC,CAAC,CAAC,CAC5E,GAAAD,cAAO,EAAC,GAAAC,aAAM,EAAC,CAAC,CAAC,CAAEjB,CAAC,CAACvB,OAAO,CAACuD,gBAAgB,CAAC,CAAE,GAAAd,SAAE,EAAC,CAAC,CAAC,CAAC,CACxD,CACF,CAGA,QAAS,CAAAI,qBAAqBA,CAACR,OAA6B,CAA+B,CACzF,GAAI,CAACA,OAAO,EAAI,CAACA,OAAO,CAACxB,MAAM,CAAE,MAAO,CAAC,EAAE,CAAE,CAAC,CAAC,CAE/C,KAAM,CAAA8B,cAAiC,CAAG,EAAE,CAC5C,GAAI,CAAAD,OAAO,CAAG,CAAC,CAEf,IAAK,KAAM,CAAAxC,MAAM,GAAI,CAAAmC,OAAO,CAAE,CAC5B,KAAM,CAAA0B,eAAe,CAAG7D,MAAM,CAAC8D,OAAO,CAAG,CAAC,GAAG9D,MAAM,CAAC8D,OAAO,CAAE9D,MAAM,CAAC2D,IAAI,CAAC,CAAG,CAAC3D,MAAM,CAAC2D,IAAI,CAAC,CACzF,KAAM,CAAAI,KAAK,CAAG7C,KAAK,CAAC8C,IAAI,CAAC,GAAI,CAAAC,GAAG,CAACJ,eAAe,CAACK,GAAG,CAACP,IAAI,EAAI,GAAAQ,2BAAoB,EAACR,IAAI,CAAC,CAAC,CAAC,CAAC,CAACvC,IAAI,CAAC,IAAI,CAAC,CAErG,KAAM,CAAAgD,YAAY,CAAG,GAAAC,gCAAyB,EAACrE,MAAM,CAACsE,IAAI,CAAC,CAE3D,KAAM,CAAAlE,WAAW,CAAGJ,MAAM,CAACI,WAAW,EAAI,GAAG,CAC7CqC,cAAc,CAAC8B,IAAI,CAAC,CAClBR,KAAK,CACL3D,WAAW,CACXb,WAAW,CAAES,MAAM,CAACT,WAAW,EAAIS,MAAM,CAACsE,IAAI,CAAC/E,WAAW,EAAI,EAAE,CAChEN,OAAO,CAAE,MAAO,CAAAmF,YAAY,GAAK,WAAW,CAAG,aAAaI,IAAI,CAACC,SAAS,CAACL,YAAY,CAAC,GAAG,CAAG,EAAE,CAChGzE,QAAQ,CAAEK,MAAM,CAACsE,IAAI,CAACI,UAAU,CAAC,CAAC,CAAG,YAAY,CAAG,EAAE,CACtD5E,OAAO,CAAEE,MAAM,CAACF,OAAO,EAAI,EAC7B,CAAC,CAAC,CAEF,KAAM,CAAA6E,SAAS,CAAGZ,KAAK,CAACpD,MAAM,CAAGP,WAAW,CAACO,MAAM,CAEnD,GAAIgE,SAAS,CAAGnC,OAAO,CAAEA,OAAO,CAAGmC,SAAS,CAC9C,CAEA,MAAO,CAAClC,cAAc,CAAED,OAAO,CAAC,CAClC,CAEA,QAAS,CAAAM,sBAAsBA,CAAClB,WAAqC,CAA+B,CAClG,GAAI,CAACA,WAAW,EAAI,CAACA,WAAW,CAACjB,MAAM,CAAE,MAAO,CAAC,EAAE,CAAE,CAAC,CAAC,CAEvD,KAAM,CAAAiC,eAAkC,CAAG,EAAE,CAC7C,GAAI,CAAAJ,OAAO,CAAG,CAAC,CAEf,IAAK,KAAM,CAAAgB,UAAU,GAAI,CAAA5B,WAAW,CAAE,CACpC,KAAM,CAAE+B,IAAI,CAAEG,OAAO,CAAEvE,WAAY,CAAC,CAAGiE,UAAU,CACjD,KAAM,CAAAO,KAAK,CAAG7C,KAAK,CAAC8C,IAAI,CAAC,GAAI,CAAAC,GAAG,CAAC,CAAC,IAAIH,OAAO,EAAI,EAAE,CAAC,CAAEH,IAAI,CAAC,CAAC,CAAC,CAACvC,IAAI,CAAC,IAAI,CAAC,CAExE,KAAM,CAAAhB,WAAW,CACfoD,UAAU,CAACpD,WAAW,GAAKoD,UAAU,CAACrB,OAAO,CAAG,WAAW,CAAGqB,UAAU,CAACpB,eAAe,CAAG,QAAQ,CAAG,GAAG,CAAC,CAE5GQ,eAAe,CAAC2B,IAAI,CAAC,CAAER,KAAK,CAAE3D,WAAW,CAAEb,WAAW,CAAEA,WAAW,EAAI,EAAG,CAAC,CAAC,CAE5E,KAAM,CAAAqF,SAAS,CAAGb,KAAK,CAACpD,MAAM,CAAGP,WAAW,CAACO,MAAM,CACnD,GAAIiE,SAAS,CAAGpC,OAAO,CAAEA,OAAO,CAAGoC,SAAS,CAC9C,CAEA,MAAO,CAAChC,eAAe,CAAEJ,OAAO,CAAC,CACnC,CAEA,QAAS,CAAAS,uBAAuBA,CAAC4B,IAA4B,CAA+B,CAC1F,GAAI,CAACA,IAAI,EAAI,CAACA,IAAI,CAAClE,MAAM,CAAE,MAAO,CAAC,EAAE,CAAE,CAAC,CAAC,CAEzC,KAAM,CAAAoC,WAA8B,CAAG,EAAE,CACzC,GAAI,CAAAP,OAAO,CAAG,CAAC,CAEf,IAAK,KAAM,CAAAsC,GAAG,GAAI,CAAAD,IAAI,CAAE,CACtB,KAAM,CAAAT,YAAY,CAAG,GAAAC,gCAAyB,EAACS,GAAG,CAACR,IAAI,CAAC,CAExDvB,WAAW,CAACwB,IAAI,CAAC,CACfR,KAAK,CAAEe,GAAG,CAACnB,IAAI,CACfpE,WAAW,CAAEuF,GAAG,CAACvF,WAAW,EAAI,EAAE,CAClCN,OAAO,CAAE,MAAO,CAAAmF,YAAY,GAAK,WAAW,CAAG,aAAaI,IAAI,CAACC,SAAS,CAACL,YAAY,CAAC,GAAG,CAAG,EAAE,CAChGzE,QAAQ,CAAEmF,GAAG,CAACR,IAAI,CAACI,UAAU,CAAC,CAAC,CAAG,YAAY,CAAG,EAAE,CACnD5E,OAAO,CAAEgF,GAAG,CAAChF,OAAO,EAAI,EAC1B,CAAC,CAAC,CAEF,KAAM,CAAA8E,SAAS,CAAGE,GAAG,CAACnB,IAAI,CAAChD,MAAM,CACjC,GAAIiE,SAAS,CAAGpC,OAAO,CAAEA,OAAO,CAAGoC,SAAS,CAC9C,CAEA,MAAO,CAAC7B,WAAW,CAAEP,OAAO,CAAC,CAC/B,CAGA,QAAS,CAAAU,oBAAoBA,CAACT,cAAiC,CAAEpB,CAAgB,CAAEmB,OAAe,CAAE,CAClG,GAAI,CAACC,cAAc,CAAC9B,MAAM,CAAE,OAE5B,GAAAmB,YAAK,EAACT,CAAC,CAAClC,KAAK,CAAC,WAAW,CAAC,CAAC,CAE3B,GAAAkD,cAAO,EAAC,CAAC,CAET,IAAK,KAAM,CAAE0B,KAAK,CAAE3D,WAAW,CAAEb,WAAW,CAAEO,OAAO,CAAEH,QAAQ,CAAEV,OAAO,CAAE8F,GAAI,CAAC,EAAI,CAAAtC,cAAc,CAAE,CACjG,KAAM,CAAAkC,SAAS,CAAGZ,KAAK,CAACpD,MAAM,EAAIP,WAAW,EAAEO,MAAM,EAAI,CAAC,CAAC,CAC3D,KAAM,CAAAqE,OAAO,CAAGxC,OAAO,CAAG,CAAC,CAAGmC,SAAS,CACvC,KAAM,CAAAf,aAAa,CAAGrE,WAAW,CAAC+D,OAAO,CAAC,KAAK,CAAE,IAAI,CAAG,GAAAhB,aAAM,EAACE,OAAO,CAAG,CAAC,CAAC,CAAGnB,CAAC,CAACf,WAAW,CAAC,GAAG,CAAC,CAAC,CAEjG,KAAM,CAAA2E,YAAY,CAAGlB,KAAK,CACvBmB,KAAK,CAAC,KAAK,CAAC,CACZhB,GAAG,CAACP,IAAI,EAAKA,IAAI,GAAK,GAAG,CAAGtC,CAAC,CAACf,WAAW,CAACqD,IAAI,CAAC,CAAGtC,CAAC,CAACrB,MAAM,CAAC2D,IAAI,CAAE,CAAC,CAClEvC,IAAI,CAAC,EAAE,CAAC,CAEX,GAAAiB,cAAO,EACL,GAAAC,aAAM,EAAC,CAAC,CAAC,CACT2C,YAAY,CACZ5D,CAAC,CAACjB,WAAW,CAACA,WAAW,CAAC,CAC1B,GAAAkC,aAAM,EAAC0C,OAAO,CAAC,CACf3D,CAAC,CAAC9B,WAAW,CAACqE,aAAa,CAAC,CAC5BmB,GAAG,CAAG1D,CAAC,CAACpC,OAAO,CAAC8F,GAAG,CAAC,CAAG1D,CAAC,CAAC1B,QAAQ,CAACA,QAAQ,CAC5C,CAAC,CAED,GAAIG,OAAO,CAAE,CACX,KAAM,CAAAuD,gBAAgB,CAAGvD,OAAO,CAACwD,OAAO,CAAC,KAAK,CAAE,IAAI,CAAG,GAAAhB,aAAM,EAACE,OAAO,CAAG,EAAE,CAAC,CAAC,CAC5E,GAAAH,cAAO,EAAC,GAAAC,aAAM,EAACE,OAAO,CAAG,CAAC,CAAC,CAAEnB,CAAC,CAACf,WAAW,CAAC,GAAG,CAAC,CAAGe,CAAC,CAACzB,YAAY,CAAC,UAAU,CAAC,CAAEyB,CAAC,CAACvB,OAAO,CAACuD,gBAAgB,CAAC,CAAC,CAC5G,CACF,CAEA,GAAAhB,cAAO,EAAC,CAAC,CACX,CAEA,QAAS,CAAAc,qBAAqBA,CAACP,eAAkC,CAAEvB,CAAgB,CAAEmB,OAAe,CAAE,CACpG,GAAI,CAACI,eAAe,CAACjC,MAAM,CAAE,OAE7B,GAAAmB,YAAK,EAACT,CAAC,CAAClC,KAAK,CAAC,YAAY,CAAC,CAAC,CAE5B,GAAAkD,cAAO,EAAC,CAAC,CAET,IAAK,KAAM,CAAE0B,KAAK,CAAE3D,WAAW,CAAEb,WAAY,CAAC,EAAI,CAAAqD,eAAe,CAAE,CACjE,KAAM,CAAA+B,SAAS,CAAGZ,KAAK,CAACpD,MAAM,EAAIP,WAAW,EAAEO,MAAM,EAAI,CAAC,CAAC,CAC3D,KAAM,CAAAqE,OAAO,CAAGxC,OAAO,CAAG,CAAC,CAAGmC,SAAS,CACvC,KAAM,CAAAf,aAAa,CAAGrE,WAAW,CAAC+D,OAAO,CAAC,KAAK,CAAE,IAAI,CAAG,GAAAhB,aAAM,EAACE,OAAO,CAAG,CAAC,CAAC,CAAGnB,CAAC,CAACf,WAAW,CAAC,GAAG,CAAC,CAAC,CAEjG,KAAM,CAAA2E,YAAY,CAAGlB,KAAK,CACvBmB,KAAK,CAAC,KAAK,CAAC,CACZhB,GAAG,CAACP,IAAI,EAAKA,IAAI,GAAK,GAAG,CAAGtC,CAAC,CAACf,WAAW,CAACqD,IAAI,CAAC,CAAGtC,CAAC,CAACtB,OAAO,CAAC4D,IAAI,CAAE,CAAC,CACnEvC,IAAI,CAAC,EAAE,CAAC,CAEX,GAAAiB,cAAO,EAAC,GAAAC,aAAM,EAAC,CAAC,CAAC,CAAE2C,YAAY,CAAE5D,CAAC,CAACjB,WAAW,CAACA,WAAW,CAAC,CAAE,GAAAkC,aAAM,EAAC0C,OAAO,CAAC,CAAE3D,CAAC,CAAC9B,WAAW,CAACqE,aAAa,CAAC,CAAC,CAC7G,CAEA,GAAAvB,cAAO,EAAC,CAAC,CACX,CAEA,QAAS,CAAAe,sBAAsBA,CAACL,WAA8B,CAAE1B,CAAgB,CAAEmB,OAAe,CAAE,CACjG,GAAI,CAACO,WAAW,CAACpC,MAAM,CAAE,OAEzB,GAAAmB,YAAK,EAACT,CAAC,CAAClC,KAAK,CAAC,aAAa,CAAC,CAAC,CAE7B,GAAAkD,cAAO,EAAC,CAAC,CAET,IAAK,KAAM,CAAE0B,KAAK,CAAExE,WAAW,CAAEO,OAAO,CAAEH,QAAQ,CAAEV,OAAO,CAAE8F,GAAI,CAAC,EAAI,CAAAhC,WAAW,CAAE,CACjF,KAAM,CAAAiC,OAAO,CAAGxC,OAAO,CAAG,CAAC,CAAGuB,KAAK,CAACpD,MAAM,CAC1C,KAAM,CAAAiD,aAAa,CAAGrE,WAAW,CAAC+D,OAAO,CAAC,KAAK,CAAE,IAAI,CAAG,GAAAhB,aAAM,EAACE,OAAO,CAAG,CAAC,CAAC,CAAGnB,CAAC,CAACf,WAAW,CAAC,GAAG,CAAC,CAAC,CAEjG,GAAA+B,cAAO,EACL,GAAAC,aAAM,EAAC,CAAC,CAAC,CACTjB,CAAC,CAACnB,QAAQ,CAAC6D,KAAK,CAAC,CACjB,GAAAzB,aAAM,EAAC0C,OAAO,CAAC,CACf3D,CAAC,CAAC9B,WAAW,CAACqE,aAAa,CAAC,CAC5BmB,GAAG,CAAG1D,CAAC,CAACpC,OAAO,CAAC8F,GAAG,CAAC,CAAG1D,CAAC,CAAC1B,QAAQ,CAACA,QAAQ,CAC5C,CAAC,CAED,GAAIG,OAAO,CAAE,CACX,KAAM,CAAAuD,gBAAgB,CAAGvD,OAAO,CAACwD,OAAO,CAAC,KAAK,CAAE,IAAI,CAAG,GAAAhB,aAAM,EAACE,OAAO,CAAG,EAAE,CAAC,CAAC,CAC5E,GAAAH,cAAO,EAAC,GAAAC,aAAM,EAACE,OAAO,CAAG,CAAC,CAAC,CAAEnB,CAAC,CAACf,WAAW,CAAC,GAAG,CAAC,CAAGe,CAAC,CAACzB,YAAY,CAAC,UAAU,CAAC,CAAEyB,CAAC,CAACvB,OAAO,CAACuD,gBAAgB,CAAC,CAAC,CAC5G,CACF,CAEA,GAAAhB,cAAO,EAAC,CAAC,CACX,CAEO,KAAM,CAAA8C,IAAI,CAAAC,OAAA,CAAAD,IAAA,CAAG,CAClB5E,YAAY,CACZgD,mBACF,CAAC","ignoreList":[]}

package/lib/commonjs/parser.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.parse=parse;exports.safeParse=safeParse;var _help=require("./help.js");var _utils=require("./utils.js");function parse(argsv){for(var _len=arguments.length,params=new Array(_len>1?_len-1:0),_key=1;_key<_len;_key++){params[_key-1]=arguments[_key];}const cliOptions="cliName"in params[0]?params[0]:{};const subcommandArr=params;const allSubcommands=new Set(subcommandArr.flatMap(c=>[c.name,...(c.aliases||[])]));argsv=(0,_utils.decoupleFlags)(argsv);const results={subcommand:undefined,printCliHelp(opt){_help.help.printCliHelp(params,opt);},printSubcommandHelp(subcommandStr,opt){const subcommand=subcommandArr.find(c=>c.name===subcommandStr);if(!subcommand)return console.error(`Cannot print help for subcommand "${subcommandStr}" as it does not exist`);_help.help.printSubcommandHelp(subcommand,opt,cliOptions.cliName);}};const addRawArg=(optionName,rawArg)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});results._info[optionName].rawArg=rawArg;};const addRawValue=(optionName,rawValue)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});results._info[optionName].rawValue=rawValue;};const addSource=(optionName,source)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});results._info[optionName].source=source;};const fillOption=(optionName,value)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});Object.assign(results._info[optionName],value);};for(let i=0;i<argsv.length;i++){const arg=argsv[i];if(i===0){results.subcommand=allSubcommands.has(arg)?arg:undefined;const subcommandProps=subcommandArr.find(c=>c.name===results.subcommand);if(subcommandProps?.allowPositional)results.positional=[];if(subcommandProps?.arguments?.length)results.arguments=[];if(results.subcommand)continue;}const argAndValue=arg.split("=").filter(Boolean);const argWithEquals=arg.includes("=");const argument=argAndValue[0];const argValue=argAndValue[1];if((0,_utils.isOptionArg)(argument)){if((0,_utils.isFlagArg)(argument)&&argWithEquals){throw new Error(`Flag arguments cannot be assigned using "=": "${arg}"`);}const subcommandProps=subcommandArr.find(c=>c.name===results.subcommand);if(!subcommandProps)throw new Error(`Unknown subcommand: "${results.subcommand}"`);if(!subcommandProps.options){const msg=!results.subcommand?"options are not allowed here":`subcommand "${results.subcommand}" does not allow options`;throw new Error(`Error: ${msg}: "${argument}"`);}const optionName=(0,_utils.transformArg)(argument);if(optionName in results)throw new Error(`Duplicate option: "${argument}"`);const isNegative=argument.startsWith("--no-");const option=subcommandProps.options.find(o=>{if(o.name===optionName)return true;if(isNegative&&(0,_utils.noName)(o.name)===optionName)return true;if(!o.aliases)return false;if(o.aliases.includes(optionName))return true;if(isNegative&&o.aliases.map(_utils.noName).includes(optionName))return true;return false;});if(!option){throw new Error(`Unknown option: "${argument}"`);}const isTypeBoolean=(0,_utils.isBooleanSchema)(option.type);const nextArg=argsv[i+1];let optionValue=argWithEquals?argValue:nextArg;if(isTypeBoolean){if(argWithEquals){const parsedBoolean=(0,_utils.stringToBoolean)(argValue);optionValue=isNegative?!parsedBoolean:parsedBoolean;}else{optionValue=!isNegative;}}if(typeof optionValue==="undefined"){throw new Error(`Expected a value for "${argument}" but got nothing`);}if(!argWithEquals&&(0,_utils.isOptionArg)(optionValue)){throw new Error(`Expected a value for "${argument}" but got an argument "${nextArg}"`);}const res=option.type.safeParse(optionValue);if(!res.success){throw new Error(`Invalid value "${optionValue}" for "${argument}": ${res.error.errors[0].message}`);}results[option.name]=res.data;addRawArg(option.name,argument);const rawVal=argWithEquals?argValue:isTypeBoolean?"":nextArg;addRawValue(option.name,rawVal);fillOption(option.name,option);if(!argWithEquals&&!isTypeBoolean)i++;continue;}const subcommandProps=subcommandArr.find(c=>c.name===results.subcommand);if(subcommandProps?.arguments?.length){if(!results.arguments)results.arguments=[];const currentArgCount=results.arguments.length;if(currentArgCount<subcommandProps.arguments.length){const argType=subcommandProps.arguments[currentArgCount].type;let argValue=arg;const isTypeBoolean=(0,_utils.isBooleanSchema)(argType);if(isTypeBoolean)argValue=(0,_utils.stringToBoolean)(argValue);const res=argType.safeParse(argValue);if(!res.success){throw new Error(`The ${(0,_utils.getOrdinalPlacement)(currentArgCount)} argument "${arg}" is invalid: ${res.error.errors[0].message}`);}results.arguments.push(res.data);continue;}}if(subcommandProps?.allowPositional){if(!results.positional)results.positional=[];results.positional.push(arg);continue;}const msg=!results.subcommand?"here":`for subcommand "${results.subcommand}"`;throw new Error(`Unexpected argument "${arg}": positional arguments are not allowed ${msg}`);}const subcommandProps=subcommandArr.find(c=>c.name===results.subcommand);if(subcommandProps?.options?.length){for(const option of subcommandProps.options){if(option.name in results){addSource(option.name,"cli");fillOption(option.name,option);continue;}if(option.type.isOptional()){const hasDefault=typeof option.type._def.defaultValue==="function";if(!hasDefault)continue;results[option.name]=option.type._def.defaultValue();addSource(option.name,"default");fillOption(option.name,option);continue;}throw new Error(`Missing required option: ${(0,_utils.transformOptionToArg)(option.name)}`);}}if(subcommandProps?.arguments?.length){const currentArgCount=results.arguments?.length??0;const subcommandArgCount=subcommandProps.arguments.length;if(currentArgCount<subcommandArgCount){for(let i=currentArgCount;i<subcommandArgCount;i++){const argumentType=subcommandProps.arguments[i].type;const hasDefault=typeof argumentType._def.defaultValue==="function";if(hasDefault&&results.arguments){results.arguments.push(argumentType._def.defaultValue());continue;}if(argumentType.isOptional())continue;throw new Error(`the ${(0,_utils.getOrdinalPlacement)(i)} argument is required: "${subcommandProps.arguments[i].name}"`);}}}if(subcommandProps?.action){subcommandProps.action(results);}return results;}function safeParse(argsv){for(var _len2=arguments.length,params=new Array(_len2>1?_len2-1:0),_key2=1;_key2<_len2;_key2++){params[_key2-1]=arguments[_key2];}const cliOptions="cliName"in params[0]?params[0]:{};const subcommandArr=params;const printCliHelp=opt=>_help.help.printCliHelp(params,opt);const printSubcommandHelp=(subcommandStr,opt)=>{const subcommand=subcommandArr.find(c=>c.name===subcommandStr);if(!subcommand)return console.error(`Cannot print help for subcommand "${subcommandStr}" as it does not exist`);_help.help.printSubcommandHelp(subcommand,opt,cliOptions.cliName);};try{const data=parse(argsv,...params);delete data.printCliHelp;delete data.printSubcommandHelp;return{success:true,data:data,printCliHelp,printSubcommandHelp};}catch(e){return{success:false,error:e,printCliHelp,printSubcommandHelp};}}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.parse=parse;exports.safeParse=safeParse;var _help=require("./help.js");var _utils=require("./utils.js");function parse(argsv){for(var _len=arguments.length,params=new Array(_len>1?_len-1:0),_key=1;_key<_len;_key++){params[_key-1]=arguments[_key];}const cliOptions="cliName"in params[0]?params[0]:{};const subcommandArr=params;const allSubcommands=new Set(subcommandArr.flatMap(c=>[c.name,...(c.aliases||[])]));argsv=(0,_utils.decoupleFlags)(argsv);const results={subcommand:undefined,printCliHelp(opt){_help.help.printCliHelp(params,opt);},printSubcommandHelp(subcommandStr,opt){const subcommand=subcommandArr.find(c=>{if(c.name===subcommandStr)return true;if(!subcommandStr)return false;if(!c.aliases?.length)return false;return c.aliases.includes(subcommandStr);});if(!subcommand)return console.error(`Cannot print help for subcommand "${subcommandStr}" as it does not exist`);_help.help.printSubcommandHelp(subcommand,opt,cliOptions.cliName);}};const GetSubcommandProps=function(){let cmd=arguments.length>0&&arguments[0]!==undefined?arguments[0]:results.subcommand;return subcommandArr.find(c=>{if(c.name===cmd)return true;if(!cmd)return false;if(!c.aliases?.length)return false;return c.aliases.includes(cmd);});};const addRawArg=(optionName,rawArg)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});results._info[optionName].rawArg=rawArg;};const addRawValue=(optionName,rawValue)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});results._info[optionName].rawValue=rawValue;};const addSource=(optionName,source)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});results._info[optionName].source=source;};const fillOption=(optionName,value)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});Object.assign(results._info[optionName],value);};for(let i=0;i<argsv.length;i++){const arg=argsv[i];if(i===0){results.subcommand=allSubcommands.has(arg)?arg:undefined;const subcommandProps=GetSubcommandProps();if(subcommandProps?.allowPositional)results.positional=[];if(subcommandProps?.arguments?.length)results.arguments=[];if(results.subcommand)continue;}const argAndValue=arg.split("=").filter(Boolean);const argWithEquals=arg.includes("=");const argument=argAndValue[0];const argValue=argAndValue[1];if((0,_utils.isOptionArg)(argument)){if((0,_utils.isFlagArg)(argument)&&argWithEquals){throw new Error(`Flag arguments cannot be assigned using "=": "${arg}"`);}const subcommandProps=GetSubcommandProps();if(!subcommandProps)throw new Error(`Unknown subcommand: "${results.subcommand}"`);if(!subcommandProps.options){const msg=!results.subcommand?"options are not allowed here":`subcommand "${results.subcommand}" does not allow options`;throw new Error(`Error: ${msg}: "${argument}"`);}const optionName=(0,_utils.transformArg)(argument);const isNegative=argument.startsWith("--no-");const option=subcommandProps.options.find(o=>{if(o.name===optionName)return true;if(isNegative&&(0,_utils.noName)(o.name)===optionName)return true;if(!o.aliases)return false;if(o.aliases.includes(optionName))return true;if(isNegative&&o.aliases.map(_utils.noName).includes(optionName))return true;return false;});if(!option){throw new Error(`Unknown option: "${argument}"`);}if(option.name in results){throw new Error(`Duplicated option: "${argument}"`);}const isTypeBoolean=(0,_utils.isBooleanSchema)(option.type);const nextArg=argsv[i+1];let optionValue=argWithEquals?argValue:nextArg;if(isTypeBoolean){if(argWithEquals){const parsedBoolean=(0,_utils.stringToBoolean)(argValue);optionValue=isNegative?!parsedBoolean:parsedBoolean;}else{optionValue=!isNegative;}}if(typeof optionValue==="undefined"){throw new Error(`Expected a value for "${argument}" but got nothing`);}if(!argWithEquals&&(0,_utils.isOptionArg)(optionValue)){throw new Error(`Expected a value for "${argument}" but got an argument "${nextArg}"`);}const res=option.type.safeParse(optionValue);if(!res.success){throw new Error(`Invalid value "${optionValue}" for "${argument}": ${res.error.errors[0].message}`);}results[option.name]=res.data;addRawArg(option.name,argument);const rawVal=argWithEquals?argValue:isTypeBoolean?"":nextArg;addRawValue(option.name,rawVal);fillOption(option.name,option);if(!argWithEquals&&!isTypeBoolean)i++;continue;}const subcommandProps=GetSubcommandProps();if(subcommandProps?.arguments?.length){if(!results.arguments)results.arguments=[];const currentArgCount=results.arguments.length;if(currentArgCount<subcommandProps.arguments.length){const argType=subcommandProps.arguments[currentArgCount].type;let argValue=arg;const isTypeBoolean=(0,_utils.isBooleanSchema)(argType);if(isTypeBoolean)argValue=(0,_utils.stringToBoolean)(argValue);const res=argType.safeParse(argValue);if(!res.success){throw new Error(`The ${(0,_utils.getOrdinalPlacement)(currentArgCount)} argument "${arg}" is invalid: ${res.error.errors[0].message}`);}results.arguments.push(res.data);continue;}}if(subcommandProps?.allowPositional){if(!results.positional)results.positional=[];results.positional.push(arg);continue;}const msg=!results.subcommand?"here":`for subcommand "${results.subcommand}"`;throw new Error(`Unexpected argument "${arg}": positional arguments are not allowed ${msg}`);}const subcommandProps=GetSubcommandProps();if(subcommandProps?.options?.length){for(const option of subcommandProps.options){if(option.name in results){addSource(option.name,"cli");fillOption(option.name,option);continue;}if(option.type.isOptional()){const hasDefault=typeof option.type._def.defaultValue==="function";if(!hasDefault)continue;results[option.name]=option.type._def.defaultValue();addSource(option.name,"default");fillOption(option.name,option);continue;}throw new Error(`Missing required option: ${(0,_utils.transformOptionToArg)(option.name)}`);}}if(subcommandProps?.arguments?.length){const currentArgCount=results.arguments?.length??0;const subcommandArgCount=subcommandProps.arguments.length;if(currentArgCount<subcommandArgCount){for(let i=currentArgCount;i<subcommandArgCount;i++){const argumentType=subcommandProps.arguments[i].type;const hasDefault=typeof argumentType._def.defaultValue==="function";if(hasDefault&&results.arguments){results.arguments.push(argumentType._def.defaultValue());continue;}if(argumentType.isOptional())continue;throw new Error(`the ${(0,_utils.getOrdinalPlacement)(i)} argument is required: "${subcommandProps.arguments[i].name}"`);}}}if(subcommandProps?.action){subcommandProps.action(results);}return results;}function safeParse(argsv){for(var _len2=arguments.length,params=new Array(_len2>1?_len2-1:0),_key2=1;_key2<_len2;_key2++){params[_key2-1]=arguments[_key2];}const cliOptions="cliName"in params[0]?params[0]:{};const subcommandArr=params;const printCliHelp=opt=>_help.help.printCliHelp(params,opt);const printSubcommandHelp=(subcommandStr,opt)=>{const subcommand=subcommandArr.find(c=>c.name===subcommandStr);if(!subcommand)return console.error(`Cannot print help for subcommand "${subcommandStr}" as it does not exist`);_help.help.printSubcommandHelp(subcommand,opt,cliOptions.cliName);};try{const data=parse(argsv,...params);delete data.printCliHelp;delete data.printSubcommandHelp;return{success:true,data:data,printCliHelp,printSubcommandHelp};}catch(e){return{success:false,error:e,printCliHelp,printSubcommandHelp};}}

package/lib/commonjs/parser.js.map

@@ -1 +1 @@
-{"version":3,"names":["_help","require","_utils","parse","argsv","_len","arguments","length","params","Array","_key","cliOptions","subcommandArr","allSubcommands","Set","flatMap","c","name","aliases","decoupleFlags","results","subcommand","undefined","printCliHelp","opt","help","printSubcommandHelp","subcommandStr","find","console","error","cliName","addRawArg","optionName","rawArg","_info","Object","create","addRawValue","rawValue","addSource","source","fillOption","value","assign","i","arg","has","subcommandProps","allowPositional","positional","argAndValue","split","filter","Boolean","argWithEquals","includes","argument","argValue","isOptionArg","isFlagArg","Error","options","msg","transformArg","isNegative","startsWith","option","o","noName","map","isTypeBoolean","isBooleanSchema","type","nextArg","optionValue","parsedBoolean","stringToBoolean","res","safeParse","success","errors","message","data","rawVal","currentArgCount","argType","getOrdinalPlacement","push","isOptional","hasDefault","_def","defaultValue","transformOptionToArg","subcommandArgCount","argumentType","action","_len2","_key2","e"],"sourceRoot":"../../src","sources":["parser.ts"],"sourcesContent":["import { help } from \"./help.js\";\nimport {\n  decoupleFlags,\n  getOrdinalPlacement,\n  isBooleanSchema,\n  isFlagArg,\n  isOptionArg,\n  noName,\n  stringToBoolean,\n  transformArg,\n  transformOptionToArg,\n} from \"./utils.js\";\n\nimport type {\n  Cli,\n  NoSubcommand,\n  Option,\n  PrintHelpOpt,\n  SafeParseResult,\n  Subcommand,\n  UnSafeParseResult,\n} from \"./types.js\";\n\nexport function parse<T extends Subcommand[]>(argsv: string[], ...params: T): UnSafeParseResult<T>;\nexport function parse<T extends Subcommand[], U extends Cli>(\n  argsv: string[],\n  ...params: [U, ...T]\n): UnSafeParseResult<[...T, NoSubcommand & U]>;\n\nexport function parse<T extends Subcommand[], U extends Cli>(argsv: string[], ...params: [U, ...T]) {\n  const cliOptions = (\"cliName\" in params[0] ? params[0] : {}) as U;\n  const subcommandArr = params as unknown as T;\n  const allSubcommands = new Set<string>(subcommandArr.flatMap(c => [c.name, ...(c.aliases || [])]));\n\n  // decouple flags E.g. `-rf` -> `-r, -f`\n  argsv = decoupleFlags(argsv);\n\n  type ResultObj = Record<string, unknown> & {\n    subcommand: string | undefined;\n    positional?: string[];\n    arguments?: unknown[];\n    _info?: Record<string, { rawArg?: string; rawValue?: string; source: \"cli\" | \"default\" }>;\n    printCliHelp: (options?: PrintHelpOpt) => void;\n    printSubcommandHelp: (subcommand: any, options?: PrintHelpOpt) => void;\n  };\n\n  const results: ResultObj = {\n    subcommand: undefined,\n    printCliHelp(opt) {\n      help.printCliHelp(params, opt);\n    },\n    printSubcommandHelp(subcommandStr, opt) {\n      const subcommand = subcommandArr.find(c => c.name === subcommandStr);\n      if (!subcommand) return console.error(`Cannot print help for subcommand \"${subcommandStr}\" as it does not exist`);\n      help.printSubcommandHelp(subcommand, opt, cliOptions.cliName);\n    },\n  };\n\n  const addRawArg = (optionName: string, rawArg: string) => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    results._info[optionName].rawArg = rawArg;\n  };\n\n  const addRawValue = (optionName: string, rawValue: string) => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    results._info[optionName].rawValue = rawValue;\n  };\n\n  const addSource = (optionName: string, source: \"cli\" | \"default\") => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    results._info[optionName].source = source;\n  };\n\n  const fillOption = (optionName: string, value: Option) => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    Object.assign(results._info[optionName], value);\n  };\n\n  for (let i = 0; i < argsv.length; i++) {\n    const arg = argsv[i];\n\n    // * subcommand\n    if (i === 0) {\n      results.subcommand = allSubcommands.has(arg) ? arg : undefined;\n\n      // add positional and arguments array\n      const subcommandProps = subcommandArr.find(c => c.name === results.subcommand);\n      if (subcommandProps?.allowPositional) results.positional = [];\n      if (subcommandProps?.arguments?.length) results.arguments = [];\n\n      if (results.subcommand) continue;\n    }\n\n    // * option\n    const argAndValue = arg.split(\"=\").filter(Boolean);\n    const argWithEquals = arg.includes(\"=\");\n    const argument = argAndValue[0];\n    const argValue: string | undefined = argAndValue[1];\n\n    if (isOptionArg(argument)) {\n      if (isFlagArg(argument) && argWithEquals) {\n        throw new Error(`Flag arguments cannot be assigned using \"=\": \"${arg}\"`);\n      }\n\n      const subcommandProps = subcommandArr.find(c => c.name === results.subcommand);\n      if (!subcommandProps) throw new Error(`Unknown subcommand: \"${results.subcommand}\"`);\n\n      if (!subcommandProps.options) {\n        const msg = !results.subcommand\n          ? \"options are not allowed here\"\n          : `subcommand \"${results.subcommand}\" does not allow options`;\n        throw new Error(`Error: ${msg}: \"${argument}\"`);\n      }\n\n      const optionName = transformArg(argument);\n      if (optionName in results) throw new Error(`Duplicate option: \"${argument}\"`);\n\n      const isNegative = argument.startsWith(\"--no-\");\n\n      const option = subcommandProps.options.find(o => {\n        if (o.name === optionName) return true;\n        if (isNegative && noName(o.name) === optionName) return true;\n\n        if (!o.aliases) return false;\n        if (o.aliases.includes(optionName)) return true;\n        if (isNegative && o.aliases.map(noName).includes(optionName)) return true;\n\n        return false;\n      });\n\n      if (!option) {\n        throw new Error(`Unknown option: \"${argument}\"`);\n      }\n\n      const isTypeBoolean = isBooleanSchema(option.type);\n      const nextArg = argsv[i + 1];\n\n      let optionValue: string | boolean = argWithEquals ? argValue : nextArg;\n\n      if (isTypeBoolean) {\n        if (argWithEquals) {\n          const parsedBoolean = stringToBoolean(argValue);\n          optionValue = isNegative ? !parsedBoolean : parsedBoolean;\n        } else {\n          optionValue = !isNegative;\n        }\n      }\n\n      if (typeof optionValue === \"undefined\") {\n        throw new Error(`Expected a value for \"${argument}\" but got nothing`);\n      }\n\n      if (!argWithEquals && isOptionArg(optionValue)) {\n        throw new Error(`Expected a value for \"${argument}\" but got an argument \"${nextArg}\"`);\n      }\n\n      const res = option.type.safeParse(optionValue);\n      if (!res.success) {\n        throw new Error(`Invalid value \"${optionValue}\" for \"${argument}\": ${res.error.errors[0].message}`);\n      }\n\n      results[option.name] = res.data;\n      addRawArg(option.name, argument);\n      const rawVal = argWithEquals ? argValue : isTypeBoolean ? \"\" : nextArg;\n      addRawValue(option.name, rawVal);\n      fillOption(option.name, option);\n\n      if (!argWithEquals && !isTypeBoolean) i++;\n      continue;\n    }\n\n    const subcommandProps = subcommandArr.find(c => c.name === results.subcommand);\n\n    // * arguments\n    if (subcommandProps?.arguments?.length) {\n      if (!results.arguments) results.arguments = [];\n\n      const currentArgCount = results.arguments.length;\n\n      if (currentArgCount < subcommandProps.arguments.length) {\n        const argType = subcommandProps.arguments[currentArgCount].type;\n\n        let argValue: string | boolean = arg;\n        const isTypeBoolean = isBooleanSchema(argType);\n        if (isTypeBoolean) argValue = stringToBoolean(argValue);\n\n        const res = argType.safeParse(argValue);\n        if (!res.success) {\n          throw new Error(\n            `The ${getOrdinalPlacement(currentArgCount)} argument \"${arg}\" is invalid: ${res.error.errors[0].message}`,\n          );\n        }\n\n        results.arguments.push(res.data);\n        continue;\n      }\n    }\n\n    // * positional\n    if (subcommandProps?.allowPositional) {\n      if (!results.positional) results.positional = [];\n      results.positional.push(arg);\n      continue;\n    }\n\n    const msg = !results.subcommand ? \"here\" : `for subcommand \"${results.subcommand}\"`;\n    throw new Error(`Unexpected argument \"${arg}\": positional arguments are not allowed ${msg}`);\n  }\n\n  // check for missing options - set defaults - add _source\n  const subcommandProps = subcommandArr.find(c => c.name === results.subcommand);\n  if (subcommandProps?.options?.length) {\n    for (const option of subcommandProps.options) {\n      if (option.name in results) {\n        addSource(option.name, \"cli\");\n        fillOption(option.name, option);\n        continue;\n      }\n\n      if (option.type.isOptional()) {\n        const hasDefault = typeof option.type._def.defaultValue === \"function\";\n        if (!hasDefault) continue;\n        results[option.name] = option.type._def.defaultValue();\n        addSource(option.name, \"default\");\n        fillOption(option.name, option);\n        continue;\n      }\n\n      throw new Error(`Missing required option: ${transformOptionToArg(option.name)}`);\n    }\n  }\n\n  // check for arguments - set defaults\n  if (subcommandProps?.arguments?.length) {\n    const currentArgCount = results.arguments?.length ?? 0;\n    const subcommandArgCount = subcommandProps.arguments.length;\n\n    // missing arguments\n    if (currentArgCount < subcommandArgCount) {\n      for (let i = currentArgCount; i < subcommandArgCount; i++) {\n        const argumentType = subcommandProps.arguments[i].type;\n        const hasDefault = typeof argumentType._def.defaultValue === \"function\";\n        if (hasDefault && results.arguments) {\n          results.arguments.push(argumentType._def.defaultValue());\n          continue;\n        }\n\n        if (argumentType.isOptional()) continue;\n\n        throw new Error(`the ${getOrdinalPlacement(i)} argument is required: \"${subcommandProps.arguments[i].name}\"`);\n      }\n    }\n  }\n\n  if (subcommandProps?.action) {\n    subcommandProps.action(results);\n  }\n\n  return results as UnSafeParseResult<[...T, NoSubcommand & U]>;\n}\n\nexport function safeParse<T extends Subcommand[]>(argsv: string[], ...params: T): SafeParseResult<T>;\nexport function safeParse<T extends Subcommand[], U extends Cli>(\n  argsv: string[],\n  ...params: [U, ...T]\n): SafeParseResult<[...T, NoSubcommand & U]>;\n\nexport function safeParse<T extends Subcommand[], U extends Cli>(argsv: string[], ...params: [U, ...T]) {\n  const cliOptions = (\"cliName\" in params[0] ? params[0] : {}) as U;\n  const subcommandArr = params as Subcommand[];\n\n  const printCliHelp = (opt?: PrintHelpOpt) => help.printCliHelp(params, opt);\n  const printSubcommandHelp = (subcommandStr: NonNullable<T[number][\"name\"]>, opt?: PrintHelpOpt) => {\n    const subcommand = subcommandArr.find(c => c.name === subcommandStr);\n    if (!subcommand) return console.error(`Cannot print help for subcommand \"${subcommandStr}\" as it does not exist`);\n    help.printSubcommandHelp(subcommand, opt, cliOptions.cliName);\n  };\n\n  try {\n    const data = parse(argsv, ...params);\n    // @ts-expect-error error\n    delete data.printCliHelp;\n    // @ts-expect-error error\n    delete data.printSubcommandHelp;\n\n    return {\n      success: true,\n      data: data as Omit<typeof data, \"printCliHelp\" | \"printSubcommandHelp\">,\n      printCliHelp,\n      printSubcommandHelp,\n    };\n  } catch (e) {\n    return { success: false, error: e as Error, printCliHelp, printSubcommandHelp };\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_help","require","_utils","parse","argsv","_len","arguments","length","params","Array","_key","cliOptions","subcommandArr","allSubcommands","Set","flatMap","c","name","aliases","decoupleFlags","results","subcommand","undefined","printCliHelp","opt","help","printSubcommandHelp","subcommandStr","find","includes","console","error","cliName","GetSubcommandProps","cmd","addRawArg","optionName","rawArg","_info","Object","create","addRawValue","rawValue","addSource","source","fillOption","value","assign","i","arg","has","subcommandProps","allowPositional","positional","argAndValue","split","filter","Boolean","argWithEquals","argument","argValue","isOptionArg","isFlagArg","Error","options","msg","transformArg","isNegative","startsWith","option","o","noName","map","isTypeBoolean","isBooleanSchema","type","nextArg","optionValue","parsedBoolean","stringToBoolean","res","safeParse","success","errors","message","data","rawVal","currentArgCount","argType","getOrdinalPlacement","push","isOptional","hasDefault","_def","defaultValue","transformOptionToArg","subcommandArgCount","argumentType","action","_len2","_key2","e"],"sourceRoot":"../../src","sources":["parser.ts"],"sourcesContent":["import { help } from \"./help.js\";\nimport {\n  decoupleFlags,\n  getOrdinalPlacement,\n  isBooleanSchema,\n  isFlagArg,\n  isOptionArg,\n  noName,\n  stringToBoolean,\n  transformArg,\n  transformOptionToArg,\n} from \"./utils.js\";\n\nimport type {\n  Cli,\n  NoSubcommand,\n  Option,\n  PrintHelpOpt,\n  SafeParseResult,\n  Subcommand,\n  UnSafeParseResult,\n} from \"./types.js\";\n\nexport function parse<T extends Subcommand[]>(argsv: string[], ...params: T): UnSafeParseResult<T>;\nexport function parse<T extends Subcommand[], U extends Cli>(\n  argsv: string[],\n  ...params: [U, ...T]\n): UnSafeParseResult<[...T, NoSubcommand & U]>;\n\nexport function parse<T extends Subcommand[], U extends Cli>(argsv: string[], ...params: [U, ...T]) {\n  const cliOptions = (\"cliName\" in params[0] ? params[0] : {}) as U;\n  const subcommandArr = params as unknown as T;\n  const allSubcommands = new Set<string>(subcommandArr.flatMap(c => [c.name, ...(c.aliases || [])]));\n\n  // decouple flags E.g. `-rf` -> `-r, -f`\n  argsv = decoupleFlags(argsv);\n\n  type ResultObj = Record<string, unknown> & {\n    subcommand: string | undefined;\n    positional?: string[];\n    arguments?: unknown[];\n    _info?: Record<string, { rawArg?: string; rawValue?: string; source: \"cli\" | \"default\" }>;\n    printCliHelp: (options?: PrintHelpOpt) => void;\n    printSubcommandHelp: (subcommand: any, options?: PrintHelpOpt) => void;\n  };\n\n  const results: ResultObj = {\n    subcommand: undefined,\n    printCliHelp(opt) {\n      help.printCliHelp(params, opt);\n    },\n    printSubcommandHelp(subcommandStr, opt) {\n      const subcommand = subcommandArr.find(c => {\n        if (c.name === subcommandStr) return true;\n        if (!subcommandStr) return false;\n        if (!c.aliases?.length) return false;\n        return c.aliases.includes(subcommandStr);\n      });\n      if (!subcommand) return console.error(`Cannot print help for subcommand \"${subcommandStr}\" as it does not exist`);\n      help.printSubcommandHelp(subcommand, opt, cliOptions.cliName);\n    },\n  };\n\n  /** - Get current subcommand props */\n  const GetSubcommandProps = (cmd = results.subcommand) => {\n    return subcommandArr.find(c => {\n      if (c.name === cmd) return true;\n      if (!cmd) return false;\n      if (!c.aliases?.length) return false;\n      return c.aliases.includes(cmd);\n    });\n  };\n\n  const addRawArg = (optionName: string, rawArg: string) => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    results._info[optionName].rawArg = rawArg;\n  };\n\n  const addRawValue = (optionName: string, rawValue: string) => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    results._info[optionName].rawValue = rawValue;\n  };\n\n  const addSource = (optionName: string, source: \"cli\" | \"default\") => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    results._info[optionName].source = source;\n  };\n\n  const fillOption = (optionName: string, value: Option) => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    Object.assign(results._info[optionName], value);\n  };\n\n  for (let i = 0; i < argsv.length; i++) {\n    const arg = argsv[i];\n\n    // * subcommand\n    if (i === 0) {\n      results.subcommand = allSubcommands.has(arg) ? arg : undefined;\n\n      // add positional and arguments array\n      const subcommandProps = GetSubcommandProps();\n      if (subcommandProps?.allowPositional) results.positional = [];\n      if (subcommandProps?.arguments?.length) results.arguments = [];\n\n      if (results.subcommand) continue;\n    }\n\n    // * option\n    const argAndValue = arg.split(\"=\").filter(Boolean);\n    const argWithEquals = arg.includes(\"=\");\n    const argument = argAndValue[0];\n    const argValue: string | undefined = argAndValue[1];\n\n    if (isOptionArg(argument)) {\n      if (isFlagArg(argument) && argWithEquals) {\n        throw new Error(`Flag arguments cannot be assigned using \"=\": \"${arg}\"`);\n      }\n\n      const subcommandProps = GetSubcommandProps();\n      if (!subcommandProps) throw new Error(`Unknown subcommand: \"${results.subcommand}\"`);\n\n      if (!subcommandProps.options) {\n        const msg = !results.subcommand\n          ? \"options are not allowed here\"\n          : `subcommand \"${results.subcommand}\" does not allow options`;\n        throw new Error(`Error: ${msg}: \"${argument}\"`);\n      }\n\n      const optionName = transformArg(argument);\n      const isNegative = argument.startsWith(\"--no-\");\n\n      const option = subcommandProps.options.find(o => {\n        if (o.name === optionName) return true;\n        if (isNegative && noName(o.name) === optionName) return true;\n\n        if (!o.aliases) return false;\n        if (o.aliases.includes(optionName)) return true;\n        if (isNegative && o.aliases.map(noName).includes(optionName)) return true;\n\n        return false;\n      });\n\n      if (!option) {\n        throw new Error(`Unknown option: \"${argument}\"`);\n      }\n\n      if (option.name in results) {\n        throw new Error(`Duplicated option: \"${argument}\"`);\n      }\n\n      const isTypeBoolean = isBooleanSchema(option.type);\n      const nextArg = argsv[i + 1];\n\n      let optionValue: string | boolean = argWithEquals ? argValue : nextArg;\n\n      if (isTypeBoolean) {\n        if (argWithEquals) {\n          const parsedBoolean = stringToBoolean(argValue);\n          optionValue = isNegative ? !parsedBoolean : parsedBoolean;\n        } else {\n          optionValue = !isNegative;\n        }\n      }\n\n      if (typeof optionValue === \"undefined\") {\n        throw new Error(`Expected a value for \"${argument}\" but got nothing`);\n      }\n\n      if (!argWithEquals && isOptionArg(optionValue)) {\n        throw new Error(`Expected a value for \"${argument}\" but got an argument \"${nextArg}\"`);\n      }\n\n      const res = option.type.safeParse(optionValue);\n      if (!res.success) {\n        throw new Error(`Invalid value \"${optionValue}\" for \"${argument}\": ${res.error.errors[0].message}`);\n      }\n\n      results[option.name] = res.data;\n      addRawArg(option.name, argument);\n      const rawVal = argWithEquals ? argValue : isTypeBoolean ? \"\" : nextArg;\n      addRawValue(option.name, rawVal);\n      fillOption(option.name, option);\n\n      if (!argWithEquals && !isTypeBoolean) i++;\n      continue;\n    }\n\n    const subcommandProps = GetSubcommandProps();\n\n    // * arguments\n    if (subcommandProps?.arguments?.length) {\n      if (!results.arguments) results.arguments = [];\n\n      const currentArgCount = results.arguments.length;\n\n      if (currentArgCount < subcommandProps.arguments.length) {\n        const argType = subcommandProps.arguments[currentArgCount].type;\n\n        let argValue: string | boolean = arg;\n        const isTypeBoolean = isBooleanSchema(argType);\n        if (isTypeBoolean) argValue = stringToBoolean(argValue);\n\n        const res = argType.safeParse(argValue);\n        if (!res.success) {\n          throw new Error(\n            `The ${getOrdinalPlacement(currentArgCount)} argument \"${arg}\" is invalid: ${res.error.errors[0].message}`,\n          );\n        }\n\n        results.arguments.push(res.data);\n        continue;\n      }\n    }\n\n    // * positional\n    if (subcommandProps?.allowPositional) {\n      if (!results.positional) results.positional = [];\n      results.positional.push(arg);\n      continue;\n    }\n\n    const msg = !results.subcommand ? \"here\" : `for subcommand \"${results.subcommand}\"`;\n    throw new Error(`Unexpected argument \"${arg}\": positional arguments are not allowed ${msg}`);\n  }\n\n  // check for missing options - set defaults - add _source\n  const subcommandProps = GetSubcommandProps();\n  if (subcommandProps?.options?.length) {\n    for (const option of subcommandProps.options) {\n      if (option.name in results) {\n        addSource(option.name, \"cli\");\n        fillOption(option.name, option);\n        continue;\n      }\n\n      if (option.type.isOptional()) {\n        const hasDefault = typeof option.type._def.defaultValue === \"function\";\n        if (!hasDefault) continue;\n        results[option.name] = option.type._def.defaultValue();\n        addSource(option.name, \"default\");\n        fillOption(option.name, option);\n        continue;\n      }\n\n      throw new Error(`Missing required option: ${transformOptionToArg(option.name)}`);\n    }\n  }\n\n  // check for arguments - set defaults\n  if (subcommandProps?.arguments?.length) {\n    const currentArgCount = results.arguments?.length ?? 0;\n    const subcommandArgCount = subcommandProps.arguments.length;\n\n    // missing arguments\n    if (currentArgCount < subcommandArgCount) {\n      for (let i = currentArgCount; i < subcommandArgCount; i++) {\n        const argumentType = subcommandProps.arguments[i].type;\n        const hasDefault = typeof argumentType._def.defaultValue === \"function\";\n        if (hasDefault && results.arguments) {\n          results.arguments.push(argumentType._def.defaultValue());\n          continue;\n        }\n\n        if (argumentType.isOptional()) continue;\n\n        throw new Error(`the ${getOrdinalPlacement(i)} argument is required: \"${subcommandProps.arguments[i].name}\"`);\n      }\n    }\n  }\n\n  if (subcommandProps?.action) {\n    subcommandProps.action(results);\n  }\n\n  return results as UnSafeParseResult<[...T, NoSubcommand & U]>;\n}\n\nexport function safeParse<T extends Subcommand[]>(argsv: string[], ...params: T): SafeParseResult<T>;\nexport function safeParse<T extends Subcommand[], U extends Cli>(\n  argsv: string[],\n  ...params: [U, ...T]\n): SafeParseResult<[...T, NoSubcommand & U]>;\n\nexport function safeParse<T extends Subcommand[], U extends Cli>(argsv: string[], ...params: [U, ...T]) {\n  const cliOptions = (\"cliName\" in params[0] ? params[0] : {}) as U;\n  const subcommandArr = params as Subcommand[];\n\n  const printCliHelp = (opt?: PrintHelpOpt) => help.printCliHelp(params, opt);\n  const printSubcommandHelp = (subcommandStr: NonNullable<T[number][\"name\"]>, opt?: PrintHelpOpt) => {\n    const subcommand = subcommandArr.find(c => c.name === subcommandStr);\n    if (!subcommand) return console.error(`Cannot print help for subcommand \"${subcommandStr}\" as it does not exist`);\n    help.printSubcommandHelp(subcommand, opt, cliOptions.cliName);\n  };\n\n  try {\n    const data = parse(argsv, ...params);\n    // @ts-expect-error error\n    delete data.printCliHelp;\n    // @ts-expect-error error\n    delete data.printSubcommandHelp;\n\n    return {\n      success: true,\n      data: data as Omit<typeof data, \"printCliHelp\" | \"printSubcommandHelp\">,\n      printCliHelp,\n      printSubcommandHelp,\n    };\n  } catch (e) {\n    return { success: false, error: e as Error, printCliHelp, printSubcommandHelp };\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/module/help.js

@@ -1 +1 @@
-import chalk from"chalk";import{concat,getDefaultValueFromSchema,indent,ln,print,println,transformOptionToArg}from"./utils.js";const colors={title:chalk.bold.blue,description:chalk.white,default:chalk.dim.italic,optional:chalk.dim.italic,exampleTitle:chalk.yellow,example:chalk.dim.italic,command:chalk.yellow,option:chalk.cyan,argument:chalk.green,placeholder:chalk.hex("#FF9800"),punctuation:chalk.white.dim};function printCliHelp(params){let printOptions=arguments.length>1&&arguments[1]!==undefined?arguments[1]:{};printOptions.colors??=true;const noColors=new Proxy(colors,{get:()=>{return function(){for(var _len=arguments.length,str=new Array(_len),_key=0;_key<_len;_key++){str[_key]=arguments[_key];}return str.join(" ");};}});const c=printOptions.colors?colors:noColors;if(printOptions.customColors){Object.assign(c,printOptions.customColors);}const isFirstParamCli="cliName"in params[0];const cliOptions=isFirstParamCli?params.shift():{};const subcommands=params;const printTitle=title=>{print(c.title(` ${title.toUpperCase()} `));};const cliName=cliOptions.cliName??"";const usage=cliOptions.usage??concat(c.punctuation("$"),cliName,subcommands.length?c.command("[command]"):"",cliOptions.options?.length?c.option("[options]"):"",cliOptions.arguments?.length||cliOptions.allowPositional?c.argument("<arguments>"):"");printTitle("Usage");println();println(indent(2),usage,ln(1));if(cliOptions.description){printTitle("Description");println();println(indent(2),c.description(cliOptions.description),ln(1));}let longest=0;const[optionsToPrint,longestOptionIndent]=prepareOptionsToPrint(cliOptions.options);if(longestOptionIndent>longest)longest=longestOptionIndent;const[commandsToPrint,longestSubcommandIndent]=prepareCommandsToPrint(subcommands);if(longestSubcommandIndent>longest)longest=longestSubcommandIndent;const[argsToPrint,longestArgIndent]=prepareArgumentsToPrint(cliOptions.arguments);if(longestArgIndent>longest)longest=longestArgIndent;printPreparedOptions(optionsToPrint,c,longest);printPreparedCommands(commandsToPrint,c,longest);printPreparedArguments(argsToPrint,c,longest);if(cliOptions.example){printTitle("Example");println();const normalizeExample=cliOptions.example.replace(/\n/g,"\n"+indent(3));println(indent(2),c.example(normalizeExample),ln(1));}}function printSubcommandHelp(subcommand){let printOptions=arguments.length>1&&arguments[1]!==undefined?arguments[1]:{};let cliName=arguments.length>2&&arguments[2]!==undefined?arguments[2]:"";printOptions.colors??=true;const noColors=new Proxy(colors,{get:()=>{return function(){for(var _len2=arguments.length,str=new Array(_len2),_key2=0;_key2<_len2;_key2++){str[_key2]=arguments[_key2];}return str.join(" ");};}});const c=printOptions.colors?colors:noColors;if(printOptions.customColors){Object.assign(c,printOptions.customColors);}const printTitle=title=>{print(c.title(` ${title.toUpperCase()} `));};const usage=concat(c.punctuation("$"),cliName,c.command(subcommand.name),subcommand.options?.length?c.option("[options]"):"",subcommand.arguments?.length||subcommand.allowPositional?c.argument("<arguments>"):"");printTitle("Usage");println();println(indent(2),usage,ln(1));if(subcommand.description){printTitle("Description");println();const normalizeDesc=subcommand.description.replace(/\n/g,"\n"+indent(3));println(indent(2),c.description(normalizeDesc),ln(1));}let longest=0;const[optionsToPrint,longestOptionIndent]=prepareOptionsToPrint(subcommand.options);if(longestOptionIndent>longest)longest=longestOptionIndent;const[argsToPrint,longestArgIndent]=prepareArgumentsToPrint(subcommand.arguments);if(longestArgIndent>longest)longest=longestArgIndent;printPreparedOptions(optionsToPrint,c,longest);printPreparedArguments(argsToPrint,c,longest);if(subcommand.example){printTitle("Example");println();const normalizeExample=subcommand.example.replace(/\n/g,"\n"+indent(3));println(indent(2),c.example(normalizeExample),ln(1));}}function prepareOptionsToPrint(options){if(!options||!options.length)return[[],0];const optionsToPrint=[];let longest=0;for(const option of options){const nameWithAliases=option.aliases?[...option.aliases,option.name]:[option.name];const names=Array.from(new Set(nameWithAliases.map(name=>transformOptionToArg(name)))).join(", ");const defaultValue=getDefaultValueFromSchema(option.type);const placeholder=option.placeholder??" ";optionsToPrint.push({names,placeholder,description:option.description??option.type.description??"",default:typeof defaultValue!=="undefined"?`(default: ${JSON.stringify(defaultValue)})`:"",optional:option.type.isOptional()?"[optional]":"",example:option.example??""});const optLength=names.length+placeholder.length;if(optLength>longest)longest=optLength;}return[optionsToPrint,longest];}function prepareCommandsToPrint(subcommands){if(!subcommands||!subcommands.length)return[[],0];const commandsToPrint=[];let longest=0;for(const subcommand of subcommands){const{name,aliases,description}=subcommand;const names=Array.from(new Set([...(aliases??[]),name])).join(", ");const placeholder=subcommand.placeholder??(subcommand.options?"[options]":subcommand.allowPositional?"<args>":" ");commandsToPrint.push({names,placeholder,description:description??""});const cmdLength=names.length+placeholder.length;if(cmdLength>longest)longest=cmdLength;}return[commandsToPrint,longest];}function prepareArgumentsToPrint(args){if(!args||!args.length)return[[],0];const argsToPrint=[];let longest=0;for(const arg of args){const defaultValue=getDefaultValueFromSchema(arg.type);argsToPrint.push({names:arg.name,description:arg.description??"",default:typeof defaultValue!=="undefined"?`(default: ${JSON.stringify(defaultValue)})`:"",optional:arg.type.isOptional()?"[optional]":"",example:arg.example??""});const cmdLength=arg.name.length;if(cmdLength>longest)longest=cmdLength;}return[argsToPrint,longest];}function printPreparedOptions(optionsToPrint,c,longest){if(!optionsToPrint.length)return;print(c.title(" OPTIONS "));println();for(const{names,placeholder,description,example,optional,default:def}of optionsToPrint){const optLength=names.length+(placeholder?.length??0);const spacing=longest+1-optLength;const normalizeDesc=description.replace(/\n/g,"\n"+indent(longest+7)+c.punctuation("└"));const coloredNames=names.split(/(,)/).map(name=>name===","?c.punctuation(name):c.option(name)).join("");println(indent(2),coloredNames,c.placeholder(placeholder),indent(spacing),c.description(normalizeDesc),def?c.default(def):c.optional(optional));if(example){const normalizeExample=example.replace(/\n/g,"\n"+indent(longest+17));println(indent(longest+6),c.punctuation("└")+c.exampleTitle("Example:"),c.example(normalizeExample));}}println();}function printPreparedCommands(commandsToPrint,c,longest){if(!commandsToPrint.length)return;print(c.title(" COMMANDS "));println();for(const{names,placeholder,description}of commandsToPrint){const optLength=names.length+(placeholder?.length??0);const spacing=longest+1-optLength;const normalizeDesc=description.replace(/\n/g,"\n"+indent(longest+7));const coloredNames=names.split(/(,)/).map(name=>name===","?c.punctuation(name):c.command(name)).join("");println(indent(2),coloredNames,c.placeholder(placeholder),indent(spacing),c.description(normalizeDesc));}println();}function printPreparedArguments(argsToPrint,c,longest){if(!argsToPrint.length)return;print(c.title(" ARGUMENTS "));println();for(const{names,description,example,optional,default:def}of argsToPrint){const spacing=longest+2-names.length;const normalizeDesc=description.replace(/\n/g,"\n"+indent(longest+6)+c.punctuation("└"));println(indent(2),c.argument(names),indent(spacing),c.description(normalizeDesc),def?c.default(def):c.optional(optional));if(example){const normalizeExample=example.replace(/\n/g,"\n"+indent(longest+16));println(indent(longest+5),c.punctuation("└")+c.exampleTitle("Example:"),c.example(normalizeExample));}}println();}export const help={printCliHelp,printSubcommandHelp};
+import chalk from"chalk";import{concat,getDefaultValueFromSchema,indent,ln,print,println,transformOptionToArg}from"./utils.js";const colors={title:chalk.bold.blue,description:chalk.white,default:chalk.dim.italic,optional:chalk.dim.italic,exampleTitle:chalk.yellow,example:chalk.dim,command:chalk.yellow,option:chalk.cyan,argument:chalk.green,placeholder:chalk.hex("#FF9800"),punctuation:chalk.white.dim};function printCliHelp(params){let printOptions=arguments.length>1&&arguments[1]!==undefined?arguments[1]:{};printOptions.colors??=true;const noColors=new Proxy(colors,{get:()=>{return function(){for(var _len=arguments.length,str=new Array(_len),_key=0;_key<_len;_key++){str[_key]=arguments[_key];}return str.join(" ");};}});const c=printOptions.colors?colors:noColors;if(printOptions.customColors){Object.assign(c,printOptions.customColors);}const isFirstParamCli="cliName"in params[0];const cliOptions=isFirstParamCli?params.shift():{};const subcommands=params;const printTitle=title=>{print(c.title(` ${title.toUpperCase()} `));};const cliName=cliOptions.cliName??"";const usage=cliOptions.usage??concat(c.punctuation("$"),cliName,subcommands.length?c.command("[command]"):"",cliOptions.options?.length?c.option("[options]"):"",cliOptions.arguments?.length||cliOptions.allowPositional?c.argument("<arguments>"):"");printTitle("Usage");println();println(indent(2),usage,ln(1));if(cliOptions.description){printTitle("Description");println();println(indent(2),c.description(cliOptions.description),ln(1));}let longest=0;const[optionsToPrint,longestOptionIndent]=prepareOptionsToPrint(cliOptions.options);if(longestOptionIndent>longest)longest=longestOptionIndent;const[commandsToPrint,longestSubcommandIndent]=prepareCommandsToPrint(subcommands);if(longestSubcommandIndent>longest)longest=longestSubcommandIndent;const[argsToPrint,longestArgIndent]=prepareArgumentsToPrint(cliOptions.arguments);if(longestArgIndent>longest)longest=longestArgIndent;printPreparedOptions(optionsToPrint,c,longest);printPreparedCommands(commandsToPrint,c,longest);printPreparedArguments(argsToPrint,c,longest);if(cliOptions.example){printTitle("Example");println();const normalizeExample=cliOptions.example.replace(/\n/g,"\n"+indent(3));println(indent(2),c.example(normalizeExample),ln(1));}}function printSubcommandHelp(subcommand){let printOptions=arguments.length>1&&arguments[1]!==undefined?arguments[1]:{};let cliName=arguments.length>2&&arguments[2]!==undefined?arguments[2]:"";printOptions.colors??=true;const noColors=new Proxy(colors,{get:()=>{return function(){for(var _len2=arguments.length,str=new Array(_len2),_key2=0;_key2<_len2;_key2++){str[_key2]=arguments[_key2];}return str.join(" ");};}});const c=printOptions.colors?colors:noColors;if(printOptions.customColors){Object.assign(c,printOptions.customColors);}const printTitle=title=>{print(c.title(` ${title.toUpperCase()} `));};const usage=subcommand.usage??concat(c.punctuation("$"),cliName,c.command(subcommand.name),subcommand.options?.length?c.option("[options]"):"",subcommand.arguments?.length||subcommand.allowPositional?c.argument("<arguments>"):"");printTitle("Usage");println();println(indent(2),usage,ln(1));if(subcommand.description){printTitle("Description");println();const normalizeDesc=subcommand.description.replace(/\n/g,"\n"+indent(3));println(indent(2),c.description(normalizeDesc),ln(1));}let longest=0;const[optionsToPrint,longestOptionIndent]=prepareOptionsToPrint(subcommand.options);if(longestOptionIndent>longest)longest=longestOptionIndent;const[argsToPrint,longestArgIndent]=prepareArgumentsToPrint(subcommand.arguments);if(longestArgIndent>longest)longest=longestArgIndent;printPreparedOptions(optionsToPrint,c,longest);printPreparedArguments(argsToPrint,c,longest);if(subcommand.example){printTitle("Example");println();const normalizeExample=subcommand.example.replace(/\n/g,"\n"+indent(3));println(indent(2),c.example(normalizeExample),ln(1));}}function prepareOptionsToPrint(options){if(!options||!options.length)return[[],0];const optionsToPrint=[];let longest=0;for(const option of options){const nameWithAliases=option.aliases?[...option.aliases,option.name]:[option.name];const names=Array.from(new Set(nameWithAliases.map(name=>transformOptionToArg(name)))).join(", ");const defaultValue=getDefaultValueFromSchema(option.type);const placeholder=option.placeholder??" ";optionsToPrint.push({names,placeholder,description:option.description??option.type.description??"",default:typeof defaultValue!=="undefined"?`(default: ${JSON.stringify(defaultValue)})`:"",optional:option.type.isOptional()?"[optional]":"",example:option.example??""});const optLength=names.length+placeholder.length;if(optLength>longest)longest=optLength;}return[optionsToPrint,longest];}function prepareCommandsToPrint(subcommands){if(!subcommands||!subcommands.length)return[[],0];const commandsToPrint=[];let longest=0;for(const subcommand of subcommands){const{name,aliases,description}=subcommand;const names=Array.from(new Set([...(aliases??[]),name])).join(", ");const placeholder=subcommand.placeholder??(subcommand.options?"[options]":subcommand.allowPositional?"<args>":" ");commandsToPrint.push({names,placeholder,description:description??""});const cmdLength=names.length+placeholder.length;if(cmdLength>longest)longest=cmdLength;}return[commandsToPrint,longest];}function prepareArgumentsToPrint(args){if(!args||!args.length)return[[],0];const argsToPrint=[];let longest=0;for(const arg of args){const defaultValue=getDefaultValueFromSchema(arg.type);argsToPrint.push({names:arg.name,description:arg.description??"",default:typeof defaultValue!=="undefined"?`(default: ${JSON.stringify(defaultValue)})`:"",optional:arg.type.isOptional()?"[optional]":"",example:arg.example??""});const cmdLength=arg.name.length;if(cmdLength>longest)longest=cmdLength;}return[argsToPrint,longest];}function printPreparedOptions(optionsToPrint,c,longest){if(!optionsToPrint.length)return;print(c.title(" OPTIONS "));println();for(const{names,placeholder,description,example,optional,default:def}of optionsToPrint){const optLength=names.length+(placeholder?.length??0);const spacing=longest+1-optLength;const normalizeDesc=description.replace(/\n/g,"\n"+indent(longest+7)+c.punctuation("└"));const coloredNames=names.split(/(,)/).map(name=>name===","?c.punctuation(name):c.option(name)).join("");println(indent(2),coloredNames,c.placeholder(placeholder),indent(spacing),c.description(normalizeDesc),def?c.default(def):c.optional(optional));if(example){const normalizeExample=example.replace(/\n/g,"\n"+indent(longest+17));println(indent(longest+6),c.punctuation("└")+c.exampleTitle("Example:"),c.example(normalizeExample));}}println();}function printPreparedCommands(commandsToPrint,c,longest){if(!commandsToPrint.length)return;print(c.title(" COMMANDS "));println();for(const{names,placeholder,description}of commandsToPrint){const optLength=names.length+(placeholder?.length??0);const spacing=longest+1-optLength;const normalizeDesc=description.replace(/\n/g,"\n"+indent(longest+7)+c.punctuation("└"));const coloredNames=names.split(/(,)/).map(name=>name===","?c.punctuation(name):c.command(name)).join("");println(indent(2),coloredNames,c.placeholder(placeholder),indent(spacing),c.description(normalizeDesc));}println();}function printPreparedArguments(argsToPrint,c,longest){if(!argsToPrint.length)return;print(c.title(" ARGUMENTS "));println();for(const{names,description,example,optional,default:def}of argsToPrint){const spacing=longest+2-names.length;const normalizeDesc=description.replace(/\n/g,"\n"+indent(longest+6)+c.punctuation("└"));println(indent(2),c.argument(names),indent(spacing),c.description(normalizeDesc),def?c.default(def):c.optional(optional));if(example){const normalizeExample=example.replace(/\n/g,"\n"+indent(longest+16));println(indent(longest+5),c.punctuation("└")+c.exampleTitle("Example:"),c.example(normalizeExample));}}println();}export const help={printCliHelp,printSubcommandHelp};

package/lib/module/help.js.map

@@ -1 +1 @@
-{"version":3,"names":["chalk","concat","getDefaultValueFromSchema","indent","ln","print","println","transformOptionToArg","colors","title","bold","blue","description","white","default","dim","italic","optional","exampleTitle","yellow","example","command","option","cyan","argument","green","placeholder","hex","punctuation","printCliHelp","params","printOptions","arguments","length","undefined","noColors","Proxy","get","_len","str","Array","_key","join","c","customColors","Object","assign","isFirstParamCli","cliOptions","shift","subcommands","printTitle","toUpperCase","cliName","usage","options","allowPositional","longest","optionsToPrint","longestOptionIndent","prepareOptionsToPrint","commandsToPrint","longestSubcommandIndent","prepareCommandsToPrint","argsToPrint","longestArgIndent","prepareArgumentsToPrint","printPreparedOptions","printPreparedCommands","printPreparedArguments","normalizeExample","replace","printSubcommandHelp","subcommand","_len2","_key2","name","normalizeDesc","nameWithAliases","aliases","names","from","Set","map","defaultValue","type","push","JSON","stringify","isOptional","optLength","cmdLength","args","arg","def","spacing","coloredNames","split","help"],"sourceRoot":"../../src","sources":["help.ts"],"sourcesContent":["import chalk from \"chalk\";\nimport { concat, getDefaultValueFromSchema, indent, ln, print, println, transformOptionToArg } from \"./utils.js\";\n\nimport type { Argument, Cli, Option, PrintHelpOpt, Subcommand } from \"./types.js\";\n\n/** Colors */\nconst colors: NonNullable<Required<PrintHelpOpt[\"customColors\"]>> = {\n  title: chalk.bold.blue,\n  description: chalk.white,\n  default: chalk.dim.italic,\n  optional: chalk.dim.italic,\n  exampleTitle: chalk.yellow,\n  example: chalk.dim.italic,\n  command: chalk.yellow,\n  option: chalk.cyan,\n  argument: chalk.green,\n  placeholder: chalk.hex(\"#FF9800\"),\n  punctuation: chalk.white.dim,\n};\n\ntype PreparedToPrint = {\n  names: string;\n  description: string;\n  placeholder?: string;\n  example?: string;\n  default?: string;\n  optional?: string;\n};\n\nfunction printCliHelp(params: [Cli, ...Subcommand[]], printOptions: PrintHelpOpt = {}) {\n  printOptions.colors ??= true;\n\n  const noColors = new Proxy(colors, {\n    get: () => {\n      return (...str: string[]) => str.join(\" \");\n    },\n  });\n\n  const c = printOptions.colors ? colors : noColors;\n\n  if (printOptions.customColors) {\n    Object.assign(c, printOptions.customColors);\n  }\n\n  const isFirstParamCli = \"cliName\" in params[0];\n  const cliOptions = (isFirstParamCli ? params.shift() : {}) as Cli;\n  const subcommands = params as Subcommand[];\n\n  /** Print a styled title */\n  const printTitle = (title: string) => {\n    print(c.title(` ${title.toUpperCase()} `));\n  };\n\n  // Print CLI usage\n  const cliName = cliOptions.cliName ?? \"\";\n  const usage =\n    cliOptions.usage ??\n    concat(\n      c.punctuation(\"$\"),\n      cliName,\n      subcommands.length ? c.command(\"[command]\") : \"\",\n      cliOptions.options?.length ? c.option(\"[options]\") : \"\",\n      cliOptions.arguments?.length || cliOptions.allowPositional ? c.argument(\"<arguments>\") : \"\",\n    );\n  printTitle(\"Usage\");\n  println();\n  println(indent(2), usage, ln(1));\n\n  // Print CLI description\n  if (cliOptions.description) {\n    printTitle(\"Description\");\n    println();\n    println(indent(2), c.description(cliOptions.description), ln(1));\n  }\n\n  let longest = 0;\n\n  // Prepare CLI options\n  const [optionsToPrint, longestOptionIndent] = prepareOptionsToPrint(cliOptions.options);\n  if (longestOptionIndent > longest) longest = longestOptionIndent;\n\n  // Prepare CLI commands\n  const [commandsToPrint, longestSubcommandIndent] = prepareCommandsToPrint(subcommands);\n  if (longestSubcommandIndent > longest) longest = longestSubcommandIndent;\n\n  // Prepare CLI arguments\n  const [argsToPrint, longestArgIndent] = prepareArgumentsToPrint(cliOptions.arguments);\n  if (longestArgIndent > longest) longest = longestArgIndent;\n\n  // Print CLI options\n  printPreparedOptions(optionsToPrint, c, longest);\n\n  // Print CLI commands\n  printPreparedCommands(commandsToPrint, c, longest);\n\n  // Print CLI arguments\n  printPreparedArguments(argsToPrint, c, longest);\n\n  // Print CLI example\n  if (cliOptions.example) {\n    printTitle(\"Example\");\n    println();\n    const normalizeExample = cliOptions.example.replace(/\\n/g, \"\\n\" + indent(3));\n    println(indent(2), c.example(normalizeExample), ln(1));\n  }\n}\n\nfunction printSubcommandHelp(subcommand: Subcommand, printOptions: PrintHelpOpt = {}, cliName = \"\") {\n  printOptions.colors ??= true;\n\n  const noColors = new Proxy(colors, {\n    get: () => {\n      return (...str: string[]) => str.join(\" \");\n    },\n  });\n\n  const c = printOptions.colors ? colors : noColors;\n\n  if (printOptions.customColors) {\n    Object.assign(c, printOptions.customColors);\n  }\n\n  /** Print a styled title */\n  const printTitle = (title: string) => {\n    print(c.title(` ${title.toUpperCase()} `));\n  };\n\n  // Print command usage\n  const usage = concat(\n    c.punctuation(\"$\"),\n    cliName,\n    c.command(subcommand.name),\n    subcommand.options?.length ? c.option(\"[options]\") : \"\",\n    subcommand.arguments?.length || subcommand.allowPositional ? c.argument(\"<arguments>\") : \"\",\n  );\n  printTitle(\"Usage\");\n  println();\n  println(indent(2), usage, ln(1));\n\n  // Print command description\n  if (subcommand.description) {\n    printTitle(\"Description\");\n    println();\n    const normalizeDesc = subcommand.description.replace(/\\n/g, \"\\n\" + indent(3));\n    println(indent(2), c.description(normalizeDesc), ln(1));\n  }\n\n  let longest = 0;\n\n  // Prepare command options\n  const [optionsToPrint, longestOptionIndent] = prepareOptionsToPrint(subcommand.options);\n  if (longestOptionIndent > longest) longest = longestOptionIndent;\n\n  // Prepare command arguments\n  const [argsToPrint, longestArgIndent] = prepareArgumentsToPrint(subcommand.arguments);\n  if (longestArgIndent > longest) longest = longestArgIndent;\n\n  // Print command options\n  printPreparedOptions(optionsToPrint, c, longest);\n\n  // Print command arguments\n  printPreparedArguments(argsToPrint, c, longest);\n\n  // Print command example\n  if (subcommand.example) {\n    printTitle(\"Example\");\n    println();\n    const normalizeExample = subcommand.example.replace(/\\n/g, \"\\n\" + indent(3));\n    println(indent(2), c.example(normalizeExample), ln(1));\n  }\n}\n\n// * Prepare\nfunction prepareOptionsToPrint(options: Option[] | undefined): [PreparedToPrint[], number] {\n  if (!options || !options.length) return [[], 0];\n\n  const optionsToPrint: PreparedToPrint[] = [];\n  let longest = 0;\n\n  for (const option of options) {\n    const nameWithAliases = option.aliases ? [...option.aliases, option.name] : [option.name];\n    const names = Array.from(new Set(nameWithAliases.map(name => transformOptionToArg(name)))).join(\", \");\n\n    const defaultValue = getDefaultValueFromSchema(option.type);\n\n    const placeholder = option.placeholder ?? \" \";\n    optionsToPrint.push({\n      names,\n      placeholder,\n      description: option.description ?? option.type.description ?? \"\",\n      default: typeof defaultValue !== \"undefined\" ? `(default: ${JSON.stringify(defaultValue)})` : \"\",\n      optional: option.type.isOptional() ? \"[optional]\" : \"\",\n      example: option.example ?? \"\",\n    });\n\n    const optLength = names.length + placeholder.length;\n\n    if (optLength > longest) longest = optLength;\n  }\n\n  return [optionsToPrint, longest];\n}\n\nfunction prepareCommandsToPrint(subcommands: Subcommand[] | undefined): [PreparedToPrint[], number] {\n  if (!subcommands || !subcommands.length) return [[], 0];\n\n  const commandsToPrint: PreparedToPrint[] = [];\n  let longest = 0;\n\n  for (const subcommand of subcommands) {\n    const { name, aliases, description } = subcommand;\n    const names = Array.from(new Set([...(aliases ?? []), name])).join(\", \");\n\n    const placeholder =\n      subcommand.placeholder ?? (subcommand.options ? \"[options]\" : subcommand.allowPositional ? \"<args>\" : \" \");\n\n    commandsToPrint.push({ names, placeholder, description: description ?? \"\" });\n\n    const cmdLength = names.length + placeholder.length;\n    if (cmdLength > longest) longest = cmdLength;\n  }\n\n  return [commandsToPrint, longest];\n}\n\nfunction prepareArgumentsToPrint(args: Argument[] | undefined): [PreparedToPrint[], number] {\n  if (!args || !args.length) return [[], 0];\n\n  const argsToPrint: PreparedToPrint[] = [];\n  let longest = 0;\n\n  for (const arg of args) {\n    const defaultValue = getDefaultValueFromSchema(arg.type);\n\n    argsToPrint.push({\n      names: arg.name,\n      description: arg.description ?? \"\",\n      default: typeof defaultValue !== \"undefined\" ? `(default: ${JSON.stringify(defaultValue)})` : \"\",\n      optional: arg.type.isOptional() ? \"[optional]\" : \"\",\n      example: arg.example ?? \"\",\n    });\n\n    const cmdLength = arg.name.length;\n    if (cmdLength > longest) longest = cmdLength;\n  }\n\n  return [argsToPrint, longest];\n}\n\n// * Print\nfunction printPreparedOptions(optionsToPrint: PreparedToPrint[], c: typeof colors, longest: number) {\n  if (!optionsToPrint.length) return;\n\n  print(c.title(\" OPTIONS \"));\n\n  println();\n\n  for (const { names, placeholder, description, example, optional, default: def } of optionsToPrint) {\n    const optLength = names.length + (placeholder?.length ?? 0);\n    const spacing = longest + 1 - optLength;\n    const normalizeDesc = description.replace(/\\n/g, \"\\n\" + indent(longest + 7) + c.punctuation(\"└\"));\n\n    const coloredNames = names\n      .split(/(,)/)\n      .map(name => (name === \",\" ? c.punctuation(name) : c.option(name)))\n      .join(\"\");\n\n    println(\n      indent(2),\n      coloredNames,\n      c.placeholder(placeholder),\n      indent(spacing),\n      c.description(normalizeDesc),\n      def ? c.default(def) : c.optional(optional),\n    );\n\n    if (example) {\n      const normalizeExample = example.replace(/\\n/g, \"\\n\" + indent(longest + 17));\n      println(indent(longest + 6), c.punctuation(\"└\") + c.exampleTitle(\"Example:\"), c.example(normalizeExample));\n    }\n  }\n\n  println();\n}\n\nfunction printPreparedCommands(commandsToPrint: PreparedToPrint[], c: typeof colors, longest: number) {\n  if (!commandsToPrint.length) return;\n\n  print(c.title(\" COMMANDS \"));\n\n  println();\n\n  for (const { names, placeholder, description } of commandsToPrint) {\n    const optLength = names.length + (placeholder?.length ?? 0);\n    const spacing = longest + 1 - optLength;\n    const normalizeDesc = description.replace(/\\n/g, \"\\n\" + indent(longest + 7));\n\n    const coloredNames = names\n      .split(/(,)/)\n      .map(name => (name === \",\" ? c.punctuation(name) : c.command(name)))\n      .join(\"\");\n\n    println(indent(2), coloredNames, c.placeholder(placeholder), indent(spacing), c.description(normalizeDesc));\n  }\n\n  println();\n}\n\nfunction printPreparedArguments(argsToPrint: PreparedToPrint[], c: typeof colors, longest: number) {\n  if (!argsToPrint.length) return;\n\n  print(c.title(\" ARGUMENTS \"));\n\n  println();\n\n  for (const { names, description, example, optional, default: def } of argsToPrint) {\n    const spacing = longest + 2 - names.length;\n    const normalizeDesc = description.replace(/\\n/g, \"\\n\" + indent(longest + 6) + c.punctuation(\"└\"));\n\n    println(\n      indent(2),\n      c.argument(names),\n      indent(spacing),\n      c.description(normalizeDesc),\n      def ? c.default(def) : c.optional(optional),\n    );\n\n    if (example) {\n      const normalizeExample = example.replace(/\\n/g, \"\\n\" + indent(longest + 16));\n      println(indent(longest + 5), c.punctuation(\"└\") + c.exampleTitle(\"Example:\"), c.example(normalizeExample));\n    }\n  }\n\n  println();\n}\n\nexport const help = {\n  printCliHelp,\n  printSubcommandHelp,\n};\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["chalk","concat","getDefaultValueFromSchema","indent","ln","print","println","transformOptionToArg","colors","title","bold","blue","description","white","default","dim","italic","optional","exampleTitle","yellow","example","command","option","cyan","argument","green","placeholder","hex","punctuation","printCliHelp","params","printOptions","arguments","length","undefined","noColors","Proxy","get","_len","str","Array","_key","join","c","customColors","Object","assign","isFirstParamCli","cliOptions","shift","subcommands","printTitle","toUpperCase","cliName","usage","options","allowPositional","longest","optionsToPrint","longestOptionIndent","prepareOptionsToPrint","commandsToPrint","longestSubcommandIndent","prepareCommandsToPrint","argsToPrint","longestArgIndent","prepareArgumentsToPrint","printPreparedOptions","printPreparedCommands","printPreparedArguments","normalizeExample","replace","printSubcommandHelp","subcommand","_len2","_key2","name","normalizeDesc","nameWithAliases","aliases","names","from","Set","map","defaultValue","type","push","JSON","stringify","isOptional","optLength","cmdLength","args","arg","def","spacing","coloredNames","split","help"],"sourceRoot":"../../src","sources":["help.ts"],"sourcesContent":["import chalk from \"chalk\";\nimport { concat, getDefaultValueFromSchema, indent, ln, print, println, transformOptionToArg } from \"./utils.js\";\n\nimport type { Argument, Cli, Option, PrintHelpOpt, Subcommand } from \"./types.js\";\n\nconst colors: NonNullable<Required<PrintHelpOpt[\"customColors\"]>> = {\n  title: chalk.bold.blue,\n  description: chalk.white,\n  default: chalk.dim.italic,\n  optional: chalk.dim.italic,\n  exampleTitle: chalk.yellow,\n  example: chalk.dim,\n  command: chalk.yellow,\n  option: chalk.cyan,\n  argument: chalk.green,\n  placeholder: chalk.hex(\"#FF9800\"),\n  punctuation: chalk.white.dim,\n};\n\ntype PreparedToPrint = {\n  names: string;\n  description: string;\n  placeholder?: string;\n  example?: string;\n  default?: string;\n  optional?: string;\n};\n\nfunction printCliHelp(params: [Cli, ...Subcommand[]], printOptions: PrintHelpOpt = {}) {\n  printOptions.colors ??= true;\n\n  const noColors = new Proxy(colors, {\n    get: () => {\n      return (...str: string[]) => str.join(\" \");\n    },\n  });\n\n  const c = printOptions.colors ? colors : noColors;\n\n  if (printOptions.customColors) {\n    Object.assign(c, printOptions.customColors);\n  }\n\n  const isFirstParamCli = \"cliName\" in params[0];\n  const cliOptions = (isFirstParamCli ? params.shift() : {}) as Cli;\n  const subcommands = params as Subcommand[];\n\n  /** Print a styled title */\n  const printTitle = (title: string) => {\n    print(c.title(` ${title.toUpperCase()} `));\n  };\n\n  // Print CLI usage\n  const cliName = cliOptions.cliName ?? \"\";\n  const usage =\n    cliOptions.usage ??\n    concat(\n      c.punctuation(\"$\"),\n      cliName,\n      subcommands.length ? c.command(\"[command]\") : \"\",\n      cliOptions.options?.length ? c.option(\"[options]\") : \"\",\n      cliOptions.arguments?.length || cliOptions.allowPositional ? c.argument(\"<arguments>\") : \"\",\n    );\n  printTitle(\"Usage\");\n  println();\n  println(indent(2), usage, ln(1));\n\n  // Print CLI description\n  if (cliOptions.description) {\n    printTitle(\"Description\");\n    println();\n    println(indent(2), c.description(cliOptions.description), ln(1));\n  }\n\n  let longest = 0;\n\n  // Prepare CLI options\n  const [optionsToPrint, longestOptionIndent] = prepareOptionsToPrint(cliOptions.options);\n  if (longestOptionIndent > longest) longest = longestOptionIndent;\n\n  // Prepare CLI commands\n  const [commandsToPrint, longestSubcommandIndent] = prepareCommandsToPrint(subcommands);\n  if (longestSubcommandIndent > longest) longest = longestSubcommandIndent;\n\n  // Prepare CLI arguments\n  const [argsToPrint, longestArgIndent] = prepareArgumentsToPrint(cliOptions.arguments);\n  if (longestArgIndent > longest) longest = longestArgIndent;\n\n  // Print CLI options\n  printPreparedOptions(optionsToPrint, c, longest);\n\n  // Print CLI commands\n  printPreparedCommands(commandsToPrint, c, longest);\n\n  // Print CLI arguments\n  printPreparedArguments(argsToPrint, c, longest);\n\n  // Print CLI example\n  if (cliOptions.example) {\n    printTitle(\"Example\");\n    println();\n    const normalizeExample = cliOptions.example.replace(/\\n/g, \"\\n\" + indent(3));\n    println(indent(2), c.example(normalizeExample), ln(1));\n  }\n}\n\nfunction printSubcommandHelp(subcommand: Subcommand, printOptions: PrintHelpOpt = {}, cliName = \"\") {\n  printOptions.colors ??= true;\n\n  const noColors = new Proxy(colors, {\n    get: () => {\n      return (...str: string[]) => str.join(\" \");\n    },\n  });\n\n  const c = printOptions.colors ? colors : noColors;\n\n  if (printOptions.customColors) {\n    Object.assign(c, printOptions.customColors);\n  }\n\n  /** Print a styled title */\n  const printTitle = (title: string) => {\n    print(c.title(` ${title.toUpperCase()} `));\n  };\n\n  // Print command usage\n  const usage =\n    subcommand.usage ??\n    concat(\n      c.punctuation(\"$\"),\n      cliName,\n      c.command(subcommand.name),\n      subcommand.options?.length ? c.option(\"[options]\") : \"\",\n      subcommand.arguments?.length || subcommand.allowPositional ? c.argument(\"<arguments>\") : \"\",\n    );\n  printTitle(\"Usage\");\n  println();\n  println(indent(2), usage, ln(1));\n\n  // Print command description\n  if (subcommand.description) {\n    printTitle(\"Description\");\n    println();\n    const normalizeDesc = subcommand.description.replace(/\\n/g, \"\\n\" + indent(3));\n    println(indent(2), c.description(normalizeDesc), ln(1));\n  }\n\n  let longest = 0;\n\n  // Prepare command options\n  const [optionsToPrint, longestOptionIndent] = prepareOptionsToPrint(subcommand.options);\n  if (longestOptionIndent > longest) longest = longestOptionIndent;\n\n  // Prepare command arguments\n  const [argsToPrint, longestArgIndent] = prepareArgumentsToPrint(subcommand.arguments);\n  if (longestArgIndent > longest) longest = longestArgIndent;\n\n  // Print command options\n  printPreparedOptions(optionsToPrint, c, longest);\n\n  // Print command arguments\n  printPreparedArguments(argsToPrint, c, longest);\n\n  // Print command example\n  if (subcommand.example) {\n    printTitle(\"Example\");\n    println();\n    const normalizeExample = subcommand.example.replace(/\\n/g, \"\\n\" + indent(3));\n    println(indent(2), c.example(normalizeExample), ln(1));\n  }\n}\n\n// * Prepare\nfunction prepareOptionsToPrint(options: Option[] | undefined): [PreparedToPrint[], number] {\n  if (!options || !options.length) return [[], 0];\n\n  const optionsToPrint: PreparedToPrint[] = [];\n  let longest = 0;\n\n  for (const option of options) {\n    const nameWithAliases = option.aliases ? [...option.aliases, option.name] : [option.name];\n    const names = Array.from(new Set(nameWithAliases.map(name => transformOptionToArg(name)))).join(\", \");\n\n    const defaultValue = getDefaultValueFromSchema(option.type);\n\n    const placeholder = option.placeholder ?? \" \";\n    optionsToPrint.push({\n      names,\n      placeholder,\n      description: option.description ?? option.type.description ?? \"\",\n      default: typeof defaultValue !== \"undefined\" ? `(default: ${JSON.stringify(defaultValue)})` : \"\",\n      optional: option.type.isOptional() ? \"[optional]\" : \"\",\n      example: option.example ?? \"\",\n    });\n\n    const optLength = names.length + placeholder.length;\n\n    if (optLength > longest) longest = optLength;\n  }\n\n  return [optionsToPrint, longest];\n}\n\nfunction prepareCommandsToPrint(subcommands: Subcommand[] | undefined): [PreparedToPrint[], number] {\n  if (!subcommands || !subcommands.length) return [[], 0];\n\n  const commandsToPrint: PreparedToPrint[] = [];\n  let longest = 0;\n\n  for (const subcommand of subcommands) {\n    const { name, aliases, description } = subcommand;\n    const names = Array.from(new Set([...(aliases ?? []), name])).join(\", \");\n\n    const placeholder =\n      subcommand.placeholder ?? (subcommand.options ? \"[options]\" : subcommand.allowPositional ? \"<args>\" : \" \");\n\n    commandsToPrint.push({ names, placeholder, description: description ?? \"\" });\n\n    const cmdLength = names.length + placeholder.length;\n    if (cmdLength > longest) longest = cmdLength;\n  }\n\n  return [commandsToPrint, longest];\n}\n\nfunction prepareArgumentsToPrint(args: Argument[] | undefined): [PreparedToPrint[], number] {\n  if (!args || !args.length) return [[], 0];\n\n  const argsToPrint: PreparedToPrint[] = [];\n  let longest = 0;\n\n  for (const arg of args) {\n    const defaultValue = getDefaultValueFromSchema(arg.type);\n\n    argsToPrint.push({\n      names: arg.name,\n      description: arg.description ?? \"\",\n      default: typeof defaultValue !== \"undefined\" ? `(default: ${JSON.stringify(defaultValue)})` : \"\",\n      optional: arg.type.isOptional() ? \"[optional]\" : \"\",\n      example: arg.example ?? \"\",\n    });\n\n    const cmdLength = arg.name.length;\n    if (cmdLength > longest) longest = cmdLength;\n  }\n\n  return [argsToPrint, longest];\n}\n\n// * Print\nfunction printPreparedOptions(optionsToPrint: PreparedToPrint[], c: typeof colors, longest: number) {\n  if (!optionsToPrint.length) return;\n\n  print(c.title(\" OPTIONS \"));\n\n  println();\n\n  for (const { names, placeholder, description, example, optional, default: def } of optionsToPrint) {\n    const optLength = names.length + (placeholder?.length ?? 0);\n    const spacing = longest + 1 - optLength;\n    const normalizeDesc = description.replace(/\\n/g, \"\\n\" + indent(longest + 7) + c.punctuation(\"└\"));\n\n    const coloredNames = names\n      .split(/(,)/)\n      .map(name => (name === \",\" ? c.punctuation(name) : c.option(name)))\n      .join(\"\");\n\n    println(\n      indent(2),\n      coloredNames,\n      c.placeholder(placeholder),\n      indent(spacing),\n      c.description(normalizeDesc),\n      def ? c.default(def) : c.optional(optional),\n    );\n\n    if (example) {\n      const normalizeExample = example.replace(/\\n/g, \"\\n\" + indent(longest + 17));\n      println(indent(longest + 6), c.punctuation(\"└\") + c.exampleTitle(\"Example:\"), c.example(normalizeExample));\n    }\n  }\n\n  println();\n}\n\nfunction printPreparedCommands(commandsToPrint: PreparedToPrint[], c: typeof colors, longest: number) {\n  if (!commandsToPrint.length) return;\n\n  print(c.title(\" COMMANDS \"));\n\n  println();\n\n  for (const { names, placeholder, description } of commandsToPrint) {\n    const optLength = names.length + (placeholder?.length ?? 0);\n    const spacing = longest + 1 - optLength;\n    const normalizeDesc = description.replace(/\\n/g, \"\\n\" + indent(longest + 7) + c.punctuation(\"└\"));\n\n    const coloredNames = names\n      .split(/(,)/)\n      .map(name => (name === \",\" ? c.punctuation(name) : c.command(name)))\n      .join(\"\");\n\n    println(indent(2), coloredNames, c.placeholder(placeholder), indent(spacing), c.description(normalizeDesc));\n  }\n\n  println();\n}\n\nfunction printPreparedArguments(argsToPrint: PreparedToPrint[], c: typeof colors, longest: number) {\n  if (!argsToPrint.length) return;\n\n  print(c.title(\" ARGUMENTS \"));\n\n  println();\n\n  for (const { names, description, example, optional, default: def } of argsToPrint) {\n    const spacing = longest + 2 - names.length;\n    const normalizeDesc = description.replace(/\\n/g, \"\\n\" + indent(longest + 6) + c.punctuation(\"└\"));\n\n    println(\n      indent(2),\n      c.argument(names),\n      indent(spacing),\n      c.description(normalizeDesc),\n      def ? c.default(def) : c.optional(optional),\n    );\n\n    if (example) {\n      const normalizeExample = example.replace(/\\n/g, \"\\n\" + indent(longest + 16));\n      println(indent(longest + 5), c.punctuation(\"└\") + c.exampleTitle(\"Example:\"), c.example(normalizeExample));\n    }\n  }\n\n  println();\n}\n\nexport const help = {\n  printCliHelp,\n  printSubcommandHelp,\n};\n"],"mappings":"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","ignoreList":[]}

package/lib/module/parser.js

@@ -1 +1 @@
-import{help}from"./help.js";import{decoupleFlags,getOrdinalPlacement,isBooleanSchema,isFlagArg,isOptionArg,noName,stringToBoolean,transformArg,transformOptionToArg}from"./utils.js";export function parse(argsv){for(var _len=arguments.length,params=new Array(_len>1?_len-1:0),_key=1;_key<_len;_key++){params[_key-1]=arguments[_key];}const cliOptions="cliName"in params[0]?params[0]:{};const subcommandArr=params;const allSubcommands=new Set(subcommandArr.flatMap(c=>[c.name,...(c.aliases||[])]));argsv=decoupleFlags(argsv);const results={subcommand:undefined,printCliHelp(opt){help.printCliHelp(params,opt);},printSubcommandHelp(subcommandStr,opt){const subcommand=subcommandArr.find(c=>c.name===subcommandStr);if(!subcommand)return console.error(`Cannot print help for subcommand "${subcommandStr}" as it does not exist`);help.printSubcommandHelp(subcommand,opt,cliOptions.cliName);}};const addRawArg=(optionName,rawArg)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});results._info[optionName].rawArg=rawArg;};const addRawValue=(optionName,rawValue)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});results._info[optionName].rawValue=rawValue;};const addSource=(optionName,source)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});results._info[optionName].source=source;};const fillOption=(optionName,value)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});Object.assign(results._info[optionName],value);};for(let i=0;i<argsv.length;i++){const arg=argsv[i];if(i===0){results.subcommand=allSubcommands.has(arg)?arg:undefined;const subcommandProps=subcommandArr.find(c=>c.name===results.subcommand);if(subcommandProps?.allowPositional)results.positional=[];if(subcommandProps?.arguments?.length)results.arguments=[];if(results.subcommand)continue;}const argAndValue=arg.split("=").filter(Boolean);const argWithEquals=arg.includes("=");const argument=argAndValue[0];const argValue=argAndValue[1];if(isOptionArg(argument)){if(isFlagArg(argument)&&argWithEquals){throw new Error(`Flag arguments cannot be assigned using "=": "${arg}"`);}const subcommandProps=subcommandArr.find(c=>c.name===results.subcommand);if(!subcommandProps)throw new Error(`Unknown subcommand: "${results.subcommand}"`);if(!subcommandProps.options){const msg=!results.subcommand?"options are not allowed here":`subcommand "${results.subcommand}" does not allow options`;throw new Error(`Error: ${msg}: "${argument}"`);}const optionName=transformArg(argument);if(optionName in results)throw new Error(`Duplicate option: "${argument}"`);const isNegative=argument.startsWith("--no-");const option=subcommandProps.options.find(o=>{if(o.name===optionName)return true;if(isNegative&&noName(o.name)===optionName)return true;if(!o.aliases)return false;if(o.aliases.includes(optionName))return true;if(isNegative&&o.aliases.map(noName).includes(optionName))return true;return false;});if(!option){throw new Error(`Unknown option: "${argument}"`);}const isTypeBoolean=isBooleanSchema(option.type);const nextArg=argsv[i+1];let optionValue=argWithEquals?argValue:nextArg;if(isTypeBoolean){if(argWithEquals){const parsedBoolean=stringToBoolean(argValue);optionValue=isNegative?!parsedBoolean:parsedBoolean;}else{optionValue=!isNegative;}}if(typeof optionValue==="undefined"){throw new Error(`Expected a value for "${argument}" but got nothing`);}if(!argWithEquals&&isOptionArg(optionValue)){throw new Error(`Expected a value for "${argument}" but got an argument "${nextArg}"`);}const res=option.type.safeParse(optionValue);if(!res.success){throw new Error(`Invalid value "${optionValue}" for "${argument}": ${res.error.errors[0].message}`);}results[option.name]=res.data;addRawArg(option.name,argument);const rawVal=argWithEquals?argValue:isTypeBoolean?"":nextArg;addRawValue(option.name,rawVal);fillOption(option.name,option);if(!argWithEquals&&!isTypeBoolean)i++;continue;}const subcommandProps=subcommandArr.find(c=>c.name===results.subcommand);if(subcommandProps?.arguments?.length){if(!results.arguments)results.arguments=[];const currentArgCount=results.arguments.length;if(currentArgCount<subcommandProps.arguments.length){const argType=subcommandProps.arguments[currentArgCount].type;let argValue=arg;const isTypeBoolean=isBooleanSchema(argType);if(isTypeBoolean)argValue=stringToBoolean(argValue);const res=argType.safeParse(argValue);if(!res.success){throw new Error(`The ${getOrdinalPlacement(currentArgCount)} argument "${arg}" is invalid: ${res.error.errors[0].message}`);}results.arguments.push(res.data);continue;}}if(subcommandProps?.allowPositional){if(!results.positional)results.positional=[];results.positional.push(arg);continue;}const msg=!results.subcommand?"here":`for subcommand "${results.subcommand}"`;throw new Error(`Unexpected argument "${arg}": positional arguments are not allowed ${msg}`);}const subcommandProps=subcommandArr.find(c=>c.name===results.subcommand);if(subcommandProps?.options?.length){for(const option of subcommandProps.options){if(option.name in results){addSource(option.name,"cli");fillOption(option.name,option);continue;}if(option.type.isOptional()){const hasDefault=typeof option.type._def.defaultValue==="function";if(!hasDefault)continue;results[option.name]=option.type._def.defaultValue();addSource(option.name,"default");fillOption(option.name,option);continue;}throw new Error(`Missing required option: ${transformOptionToArg(option.name)}`);}}if(subcommandProps?.arguments?.length){const currentArgCount=results.arguments?.length??0;const subcommandArgCount=subcommandProps.arguments.length;if(currentArgCount<subcommandArgCount){for(let i=currentArgCount;i<subcommandArgCount;i++){const argumentType=subcommandProps.arguments[i].type;const hasDefault=typeof argumentType._def.defaultValue==="function";if(hasDefault&&results.arguments){results.arguments.push(argumentType._def.defaultValue());continue;}if(argumentType.isOptional())continue;throw new Error(`the ${getOrdinalPlacement(i)} argument is required: "${subcommandProps.arguments[i].name}"`);}}}if(subcommandProps?.action){subcommandProps.action(results);}return results;}export function safeParse(argsv){for(var _len2=arguments.length,params=new Array(_len2>1?_len2-1:0),_key2=1;_key2<_len2;_key2++){params[_key2-1]=arguments[_key2];}const cliOptions="cliName"in params[0]?params[0]:{};const subcommandArr=params;const printCliHelp=opt=>help.printCliHelp(params,opt);const printSubcommandHelp=(subcommandStr,opt)=>{const subcommand=subcommandArr.find(c=>c.name===subcommandStr);if(!subcommand)return console.error(`Cannot print help for subcommand "${subcommandStr}" as it does not exist`);help.printSubcommandHelp(subcommand,opt,cliOptions.cliName);};try{const data=parse(argsv,...params);delete data.printCliHelp;delete data.printSubcommandHelp;return{success:true,data:data,printCliHelp,printSubcommandHelp};}catch(e){return{success:false,error:e,printCliHelp,printSubcommandHelp};}}
+import{help}from"./help.js";import{decoupleFlags,getOrdinalPlacement,isBooleanSchema,isFlagArg,isOptionArg,noName,stringToBoolean,transformArg,transformOptionToArg}from"./utils.js";export function parse(argsv){for(var _len=arguments.length,params=new Array(_len>1?_len-1:0),_key=1;_key<_len;_key++){params[_key-1]=arguments[_key];}const cliOptions="cliName"in params[0]?params[0]:{};const subcommandArr=params;const allSubcommands=new Set(subcommandArr.flatMap(c=>[c.name,...(c.aliases||[])]));argsv=decoupleFlags(argsv);const results={subcommand:undefined,printCliHelp(opt){help.printCliHelp(params,opt);},printSubcommandHelp(subcommandStr,opt){const subcommand=subcommandArr.find(c=>{if(c.name===subcommandStr)return true;if(!subcommandStr)return false;if(!c.aliases?.length)return false;return c.aliases.includes(subcommandStr);});if(!subcommand)return console.error(`Cannot print help for subcommand "${subcommandStr}" as it does not exist`);help.printSubcommandHelp(subcommand,opt,cliOptions.cliName);}};const GetSubcommandProps=function(){let cmd=arguments.length>0&&arguments[0]!==undefined?arguments[0]:results.subcommand;return subcommandArr.find(c=>{if(c.name===cmd)return true;if(!cmd)return false;if(!c.aliases?.length)return false;return c.aliases.includes(cmd);});};const addRawArg=(optionName,rawArg)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});results._info[optionName].rawArg=rawArg;};const addRawValue=(optionName,rawValue)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});results._info[optionName].rawValue=rawValue;};const addSource=(optionName,source)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});results._info[optionName].source=source;};const fillOption=(optionName,value)=>{if(!results._info)results._info={};if(!results._info[optionName])results._info[optionName]=Object.create({});Object.assign(results._info[optionName],value);};for(let i=0;i<argsv.length;i++){const arg=argsv[i];if(i===0){results.subcommand=allSubcommands.has(arg)?arg:undefined;const subcommandProps=GetSubcommandProps();if(subcommandProps?.allowPositional)results.positional=[];if(subcommandProps?.arguments?.length)results.arguments=[];if(results.subcommand)continue;}const argAndValue=arg.split("=").filter(Boolean);const argWithEquals=arg.includes("=");const argument=argAndValue[0];const argValue=argAndValue[1];if(isOptionArg(argument)){if(isFlagArg(argument)&&argWithEquals){throw new Error(`Flag arguments cannot be assigned using "=": "${arg}"`);}const subcommandProps=GetSubcommandProps();if(!subcommandProps)throw new Error(`Unknown subcommand: "${results.subcommand}"`);if(!subcommandProps.options){const msg=!results.subcommand?"options are not allowed here":`subcommand "${results.subcommand}" does not allow options`;throw new Error(`Error: ${msg}: "${argument}"`);}const optionName=transformArg(argument);const isNegative=argument.startsWith("--no-");const option=subcommandProps.options.find(o=>{if(o.name===optionName)return true;if(isNegative&&noName(o.name)===optionName)return true;if(!o.aliases)return false;if(o.aliases.includes(optionName))return true;if(isNegative&&o.aliases.map(noName).includes(optionName))return true;return false;});if(!option){throw new Error(`Unknown option: "${argument}"`);}if(option.name in results){throw new Error(`Duplicated option: "${argument}"`);}const isTypeBoolean=isBooleanSchema(option.type);const nextArg=argsv[i+1];let optionValue=argWithEquals?argValue:nextArg;if(isTypeBoolean){if(argWithEquals){const parsedBoolean=stringToBoolean(argValue);optionValue=isNegative?!parsedBoolean:parsedBoolean;}else{optionValue=!isNegative;}}if(typeof optionValue==="undefined"){throw new Error(`Expected a value for "${argument}" but got nothing`);}if(!argWithEquals&&isOptionArg(optionValue)){throw new Error(`Expected a value for "${argument}" but got an argument "${nextArg}"`);}const res=option.type.safeParse(optionValue);if(!res.success){throw new Error(`Invalid value "${optionValue}" for "${argument}": ${res.error.errors[0].message}`);}results[option.name]=res.data;addRawArg(option.name,argument);const rawVal=argWithEquals?argValue:isTypeBoolean?"":nextArg;addRawValue(option.name,rawVal);fillOption(option.name,option);if(!argWithEquals&&!isTypeBoolean)i++;continue;}const subcommandProps=GetSubcommandProps();if(subcommandProps?.arguments?.length){if(!results.arguments)results.arguments=[];const currentArgCount=results.arguments.length;if(currentArgCount<subcommandProps.arguments.length){const argType=subcommandProps.arguments[currentArgCount].type;let argValue=arg;const isTypeBoolean=isBooleanSchema(argType);if(isTypeBoolean)argValue=stringToBoolean(argValue);const res=argType.safeParse(argValue);if(!res.success){throw new Error(`The ${getOrdinalPlacement(currentArgCount)} argument "${arg}" is invalid: ${res.error.errors[0].message}`);}results.arguments.push(res.data);continue;}}if(subcommandProps?.allowPositional){if(!results.positional)results.positional=[];results.positional.push(arg);continue;}const msg=!results.subcommand?"here":`for subcommand "${results.subcommand}"`;throw new Error(`Unexpected argument "${arg}": positional arguments are not allowed ${msg}`);}const subcommandProps=GetSubcommandProps();if(subcommandProps?.options?.length){for(const option of subcommandProps.options){if(option.name in results){addSource(option.name,"cli");fillOption(option.name,option);continue;}if(option.type.isOptional()){const hasDefault=typeof option.type._def.defaultValue==="function";if(!hasDefault)continue;results[option.name]=option.type._def.defaultValue();addSource(option.name,"default");fillOption(option.name,option);continue;}throw new Error(`Missing required option: ${transformOptionToArg(option.name)}`);}}if(subcommandProps?.arguments?.length){const currentArgCount=results.arguments?.length??0;const subcommandArgCount=subcommandProps.arguments.length;if(currentArgCount<subcommandArgCount){for(let i=currentArgCount;i<subcommandArgCount;i++){const argumentType=subcommandProps.arguments[i].type;const hasDefault=typeof argumentType._def.defaultValue==="function";if(hasDefault&&results.arguments){results.arguments.push(argumentType._def.defaultValue());continue;}if(argumentType.isOptional())continue;throw new Error(`the ${getOrdinalPlacement(i)} argument is required: "${subcommandProps.arguments[i].name}"`);}}}if(subcommandProps?.action){subcommandProps.action(results);}return results;}export function safeParse(argsv){for(var _len2=arguments.length,params=new Array(_len2>1?_len2-1:0),_key2=1;_key2<_len2;_key2++){params[_key2-1]=arguments[_key2];}const cliOptions="cliName"in params[0]?params[0]:{};const subcommandArr=params;const printCliHelp=opt=>help.printCliHelp(params,opt);const printSubcommandHelp=(subcommandStr,opt)=>{const subcommand=subcommandArr.find(c=>c.name===subcommandStr);if(!subcommand)return console.error(`Cannot print help for subcommand "${subcommandStr}" as it does not exist`);help.printSubcommandHelp(subcommand,opt,cliOptions.cliName);};try{const data=parse(argsv,...params);delete data.printCliHelp;delete data.printSubcommandHelp;return{success:true,data:data,printCliHelp,printSubcommandHelp};}catch(e){return{success:false,error:e,printCliHelp,printSubcommandHelp};}}

package/lib/module/parser.js.map

@@ -1 +1 @@
-{"version":3,"names":["help","decoupleFlags","getOrdinalPlacement","isBooleanSchema","isFlagArg","isOptionArg","noName","stringToBoolean","transformArg","transformOptionToArg","parse","argsv","_len","arguments","length","params","Array","_key","cliOptions","subcommandArr","allSubcommands","Set","flatMap","c","name","aliases","results","subcommand","undefined","printCliHelp","opt","printSubcommandHelp","subcommandStr","find","console","error","cliName","addRawArg","optionName","rawArg","_info","Object","create","addRawValue","rawValue","addSource","source","fillOption","value","assign","i","arg","has","subcommandProps","allowPositional","positional","argAndValue","split","filter","Boolean","argWithEquals","includes","argument","argValue","Error","options","msg","isNegative","startsWith","option","o","map","isTypeBoolean","type","nextArg","optionValue","parsedBoolean","res","safeParse","success","errors","message","data","rawVal","currentArgCount","argType","push","isOptional","hasDefault","_def","defaultValue","subcommandArgCount","argumentType","action","_len2","_key2","e"],"sourceRoot":"../../src","sources":["parser.ts"],"sourcesContent":["import { help } from \"./help.js\";\nimport {\n  decoupleFlags,\n  getOrdinalPlacement,\n  isBooleanSchema,\n  isFlagArg,\n  isOptionArg,\n  noName,\n  stringToBoolean,\n  transformArg,\n  transformOptionToArg,\n} from \"./utils.js\";\n\nimport type {\n  Cli,\n  NoSubcommand,\n  Option,\n  PrintHelpOpt,\n  SafeParseResult,\n  Subcommand,\n  UnSafeParseResult,\n} from \"./types.js\";\n\nexport function parse<T extends Subcommand[]>(argsv: string[], ...params: T): UnSafeParseResult<T>;\nexport function parse<T extends Subcommand[], U extends Cli>(\n  argsv: string[],\n  ...params: [U, ...T]\n): UnSafeParseResult<[...T, NoSubcommand & U]>;\n\nexport function parse<T extends Subcommand[], U extends Cli>(argsv: string[], ...params: [U, ...T]) {\n  const cliOptions = (\"cliName\" in params[0] ? params[0] : {}) as U;\n  const subcommandArr = params as unknown as T;\n  const allSubcommands = new Set<string>(subcommandArr.flatMap(c => [c.name, ...(c.aliases || [])]));\n\n  // decouple flags E.g. `-rf` -> `-r, -f`\n  argsv = decoupleFlags(argsv);\n\n  type ResultObj = Record<string, unknown> & {\n    subcommand: string | undefined;\n    positional?: string[];\n    arguments?: unknown[];\n    _info?: Record<string, { rawArg?: string; rawValue?: string; source: \"cli\" | \"default\" }>;\n    printCliHelp: (options?: PrintHelpOpt) => void;\n    printSubcommandHelp: (subcommand: any, options?: PrintHelpOpt) => void;\n  };\n\n  const results: ResultObj = {\n    subcommand: undefined,\n    printCliHelp(opt) {\n      help.printCliHelp(params, opt);\n    },\n    printSubcommandHelp(subcommandStr, opt) {\n      const subcommand = subcommandArr.find(c => c.name === subcommandStr);\n      if (!subcommand) return console.error(`Cannot print help for subcommand \"${subcommandStr}\" as it does not exist`);\n      help.printSubcommandHelp(subcommand, opt, cliOptions.cliName);\n    },\n  };\n\n  const addRawArg = (optionName: string, rawArg: string) => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    results._info[optionName].rawArg = rawArg;\n  };\n\n  const addRawValue = (optionName: string, rawValue: string) => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    results._info[optionName].rawValue = rawValue;\n  };\n\n  const addSource = (optionName: string, source: \"cli\" | \"default\") => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    results._info[optionName].source = source;\n  };\n\n  const fillOption = (optionName: string, value: Option) => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    Object.assign(results._info[optionName], value);\n  };\n\n  for (let i = 0; i < argsv.length; i++) {\n    const arg = argsv[i];\n\n    // * subcommand\n    if (i === 0) {\n      results.subcommand = allSubcommands.has(arg) ? arg : undefined;\n\n      // add positional and arguments array\n      const subcommandProps = subcommandArr.find(c => c.name === results.subcommand);\n      if (subcommandProps?.allowPositional) results.positional = [];\n      if (subcommandProps?.arguments?.length) results.arguments = [];\n\n      if (results.subcommand) continue;\n    }\n\n    // * option\n    const argAndValue = arg.split(\"=\").filter(Boolean);\n    const argWithEquals = arg.includes(\"=\");\n    const argument = argAndValue[0];\n    const argValue: string | undefined = argAndValue[1];\n\n    if (isOptionArg(argument)) {\n      if (isFlagArg(argument) && argWithEquals) {\n        throw new Error(`Flag arguments cannot be assigned using \"=\": \"${arg}\"`);\n      }\n\n      const subcommandProps = subcommandArr.find(c => c.name === results.subcommand);\n      if (!subcommandProps) throw new Error(`Unknown subcommand: \"${results.subcommand}\"`);\n\n      if (!subcommandProps.options) {\n        const msg = !results.subcommand\n          ? \"options are not allowed here\"\n          : `subcommand \"${results.subcommand}\" does not allow options`;\n        throw new Error(`Error: ${msg}: \"${argument}\"`);\n      }\n\n      const optionName = transformArg(argument);\n      if (optionName in results) throw new Error(`Duplicate option: \"${argument}\"`);\n\n      const isNegative = argument.startsWith(\"--no-\");\n\n      const option = subcommandProps.options.find(o => {\n        if (o.name === optionName) return true;\n        if (isNegative && noName(o.name) === optionName) return true;\n\n        if (!o.aliases) return false;\n        if (o.aliases.includes(optionName)) return true;\n        if (isNegative && o.aliases.map(noName).includes(optionName)) return true;\n\n        return false;\n      });\n\n      if (!option) {\n        throw new Error(`Unknown option: \"${argument}\"`);\n      }\n\n      const isTypeBoolean = isBooleanSchema(option.type);\n      const nextArg = argsv[i + 1];\n\n      let optionValue: string | boolean = argWithEquals ? argValue : nextArg;\n\n      if (isTypeBoolean) {\n        if (argWithEquals) {\n          const parsedBoolean = stringToBoolean(argValue);\n          optionValue = isNegative ? !parsedBoolean : parsedBoolean;\n        } else {\n          optionValue = !isNegative;\n        }\n      }\n\n      if (typeof optionValue === \"undefined\") {\n        throw new Error(`Expected a value for \"${argument}\" but got nothing`);\n      }\n\n      if (!argWithEquals && isOptionArg(optionValue)) {\n        throw new Error(`Expected a value for \"${argument}\" but got an argument \"${nextArg}\"`);\n      }\n\n      const res = option.type.safeParse(optionValue);\n      if (!res.success) {\n        throw new Error(`Invalid value \"${optionValue}\" for \"${argument}\": ${res.error.errors[0].message}`);\n      }\n\n      results[option.name] = res.data;\n      addRawArg(option.name, argument);\n      const rawVal = argWithEquals ? argValue : isTypeBoolean ? \"\" : nextArg;\n      addRawValue(option.name, rawVal);\n      fillOption(option.name, option);\n\n      if (!argWithEquals && !isTypeBoolean) i++;\n      continue;\n    }\n\n    const subcommandProps = subcommandArr.find(c => c.name === results.subcommand);\n\n    // * arguments\n    if (subcommandProps?.arguments?.length) {\n      if (!results.arguments) results.arguments = [];\n\n      const currentArgCount = results.arguments.length;\n\n      if (currentArgCount < subcommandProps.arguments.length) {\n        const argType = subcommandProps.arguments[currentArgCount].type;\n\n        let argValue: string | boolean = arg;\n        const isTypeBoolean = isBooleanSchema(argType);\n        if (isTypeBoolean) argValue = stringToBoolean(argValue);\n\n        const res = argType.safeParse(argValue);\n        if (!res.success) {\n          throw new Error(\n            `The ${getOrdinalPlacement(currentArgCount)} argument \"${arg}\" is invalid: ${res.error.errors[0].message}`,\n          );\n        }\n\n        results.arguments.push(res.data);\n        continue;\n      }\n    }\n\n    // * positional\n    if (subcommandProps?.allowPositional) {\n      if (!results.positional) results.positional = [];\n      results.positional.push(arg);\n      continue;\n    }\n\n    const msg = !results.subcommand ? \"here\" : `for subcommand \"${results.subcommand}\"`;\n    throw new Error(`Unexpected argument \"${arg}\": positional arguments are not allowed ${msg}`);\n  }\n\n  // check for missing options - set defaults - add _source\n  const subcommandProps = subcommandArr.find(c => c.name === results.subcommand);\n  if (subcommandProps?.options?.length) {\n    for (const option of subcommandProps.options) {\n      if (option.name in results) {\n        addSource(option.name, \"cli\");\n        fillOption(option.name, option);\n        continue;\n      }\n\n      if (option.type.isOptional()) {\n        const hasDefault = typeof option.type._def.defaultValue === \"function\";\n        if (!hasDefault) continue;\n        results[option.name] = option.type._def.defaultValue();\n        addSource(option.name, \"default\");\n        fillOption(option.name, option);\n        continue;\n      }\n\n      throw new Error(`Missing required option: ${transformOptionToArg(option.name)}`);\n    }\n  }\n\n  // check for arguments - set defaults\n  if (subcommandProps?.arguments?.length) {\n    const currentArgCount = results.arguments?.length ?? 0;\n    const subcommandArgCount = subcommandProps.arguments.length;\n\n    // missing arguments\n    if (currentArgCount < subcommandArgCount) {\n      for (let i = currentArgCount; i < subcommandArgCount; i++) {\n        const argumentType = subcommandProps.arguments[i].type;\n        const hasDefault = typeof argumentType._def.defaultValue === \"function\";\n        if (hasDefault && results.arguments) {\n          results.arguments.push(argumentType._def.defaultValue());\n          continue;\n        }\n\n        if (argumentType.isOptional()) continue;\n\n        throw new Error(`the ${getOrdinalPlacement(i)} argument is required: \"${subcommandProps.arguments[i].name}\"`);\n      }\n    }\n  }\n\n  if (subcommandProps?.action) {\n    subcommandProps.action(results);\n  }\n\n  return results as UnSafeParseResult<[...T, NoSubcommand & U]>;\n}\n\nexport function safeParse<T extends Subcommand[]>(argsv: string[], ...params: T): SafeParseResult<T>;\nexport function safeParse<T extends Subcommand[], U extends Cli>(\n  argsv: string[],\n  ...params: [U, ...T]\n): SafeParseResult<[...T, NoSubcommand & U]>;\n\nexport function safeParse<T extends Subcommand[], U extends Cli>(argsv: string[], ...params: [U, ...T]) {\n  const cliOptions = (\"cliName\" in params[0] ? params[0] : {}) as U;\n  const subcommandArr = params as Subcommand[];\n\n  const printCliHelp = (opt?: PrintHelpOpt) => help.printCliHelp(params, opt);\n  const printSubcommandHelp = (subcommandStr: NonNullable<T[number][\"name\"]>, opt?: PrintHelpOpt) => {\n    const subcommand = subcommandArr.find(c => c.name === subcommandStr);\n    if (!subcommand) return console.error(`Cannot print help for subcommand \"${subcommandStr}\" as it does not exist`);\n    help.printSubcommandHelp(subcommand, opt, cliOptions.cliName);\n  };\n\n  try {\n    const data = parse(argsv, ...params);\n    // @ts-expect-error error\n    delete data.printCliHelp;\n    // @ts-expect-error error\n    delete data.printSubcommandHelp;\n\n    return {\n      success: true,\n      data: data as Omit<typeof data, \"printCliHelp\" | \"printSubcommandHelp\">,\n      printCliHelp,\n      printSubcommandHelp,\n    };\n  } catch (e) {\n    return { success: false, error: e as Error, printCliHelp, printSubcommandHelp };\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["help","decoupleFlags","getOrdinalPlacement","isBooleanSchema","isFlagArg","isOptionArg","noName","stringToBoolean","transformArg","transformOptionToArg","parse","argsv","_len","arguments","length","params","Array","_key","cliOptions","subcommandArr","allSubcommands","Set","flatMap","c","name","aliases","results","subcommand","undefined","printCliHelp","opt","printSubcommandHelp","subcommandStr","find","includes","console","error","cliName","GetSubcommandProps","cmd","addRawArg","optionName","rawArg","_info","Object","create","addRawValue","rawValue","addSource","source","fillOption","value","assign","i","arg","has","subcommandProps","allowPositional","positional","argAndValue","split","filter","Boolean","argWithEquals","argument","argValue","Error","options","msg","isNegative","startsWith","option","o","map","isTypeBoolean","type","nextArg","optionValue","parsedBoolean","res","safeParse","success","errors","message","data","rawVal","currentArgCount","argType","push","isOptional","hasDefault","_def","defaultValue","subcommandArgCount","argumentType","action","_len2","_key2","e"],"sourceRoot":"../../src","sources":["parser.ts"],"sourcesContent":["import { help } from \"./help.js\";\nimport {\n  decoupleFlags,\n  getOrdinalPlacement,\n  isBooleanSchema,\n  isFlagArg,\n  isOptionArg,\n  noName,\n  stringToBoolean,\n  transformArg,\n  transformOptionToArg,\n} from \"./utils.js\";\n\nimport type {\n  Cli,\n  NoSubcommand,\n  Option,\n  PrintHelpOpt,\n  SafeParseResult,\n  Subcommand,\n  UnSafeParseResult,\n} from \"./types.js\";\n\nexport function parse<T extends Subcommand[]>(argsv: string[], ...params: T): UnSafeParseResult<T>;\nexport function parse<T extends Subcommand[], U extends Cli>(\n  argsv: string[],\n  ...params: [U, ...T]\n): UnSafeParseResult<[...T, NoSubcommand & U]>;\n\nexport function parse<T extends Subcommand[], U extends Cli>(argsv: string[], ...params: [U, ...T]) {\n  const cliOptions = (\"cliName\" in params[0] ? params[0] : {}) as U;\n  const subcommandArr = params as unknown as T;\n  const allSubcommands = new Set<string>(subcommandArr.flatMap(c => [c.name, ...(c.aliases || [])]));\n\n  // decouple flags E.g. `-rf` -> `-r, -f`\n  argsv = decoupleFlags(argsv);\n\n  type ResultObj = Record<string, unknown> & {\n    subcommand: string | undefined;\n    positional?: string[];\n    arguments?: unknown[];\n    _info?: Record<string, { rawArg?: string; rawValue?: string; source: \"cli\" | \"default\" }>;\n    printCliHelp: (options?: PrintHelpOpt) => void;\n    printSubcommandHelp: (subcommand: any, options?: PrintHelpOpt) => void;\n  };\n\n  const results: ResultObj = {\n    subcommand: undefined,\n    printCliHelp(opt) {\n      help.printCliHelp(params, opt);\n    },\n    printSubcommandHelp(subcommandStr, opt) {\n      const subcommand = subcommandArr.find(c => {\n        if (c.name === subcommandStr) return true;\n        if (!subcommandStr) return false;\n        if (!c.aliases?.length) return false;\n        return c.aliases.includes(subcommandStr);\n      });\n      if (!subcommand) return console.error(`Cannot print help for subcommand \"${subcommandStr}\" as it does not exist`);\n      help.printSubcommandHelp(subcommand, opt, cliOptions.cliName);\n    },\n  };\n\n  /** - Get current subcommand props */\n  const GetSubcommandProps = (cmd = results.subcommand) => {\n    return subcommandArr.find(c => {\n      if (c.name === cmd) return true;\n      if (!cmd) return false;\n      if (!c.aliases?.length) return false;\n      return c.aliases.includes(cmd);\n    });\n  };\n\n  const addRawArg = (optionName: string, rawArg: string) => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    results._info[optionName].rawArg = rawArg;\n  };\n\n  const addRawValue = (optionName: string, rawValue: string) => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    results._info[optionName].rawValue = rawValue;\n  };\n\n  const addSource = (optionName: string, source: \"cli\" | \"default\") => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    results._info[optionName].source = source;\n  };\n\n  const fillOption = (optionName: string, value: Option) => {\n    if (!results._info) results._info = {};\n    if (!results._info[optionName]) results._info[optionName] = Object.create({});\n    Object.assign(results._info[optionName], value);\n  };\n\n  for (let i = 0; i < argsv.length; i++) {\n    const arg = argsv[i];\n\n    // * subcommand\n    if (i === 0) {\n      results.subcommand = allSubcommands.has(arg) ? arg : undefined;\n\n      // add positional and arguments array\n      const subcommandProps = GetSubcommandProps();\n      if (subcommandProps?.allowPositional) results.positional = [];\n      if (subcommandProps?.arguments?.length) results.arguments = [];\n\n      if (results.subcommand) continue;\n    }\n\n    // * option\n    const argAndValue = arg.split(\"=\").filter(Boolean);\n    const argWithEquals = arg.includes(\"=\");\n    const argument = argAndValue[0];\n    const argValue: string | undefined = argAndValue[1];\n\n    if (isOptionArg(argument)) {\n      if (isFlagArg(argument) && argWithEquals) {\n        throw new Error(`Flag arguments cannot be assigned using \"=\": \"${arg}\"`);\n      }\n\n      const subcommandProps = GetSubcommandProps();\n      if (!subcommandProps) throw new Error(`Unknown subcommand: \"${results.subcommand}\"`);\n\n      if (!subcommandProps.options) {\n        const msg = !results.subcommand\n          ? \"options are not allowed here\"\n          : `subcommand \"${results.subcommand}\" does not allow options`;\n        throw new Error(`Error: ${msg}: \"${argument}\"`);\n      }\n\n      const optionName = transformArg(argument);\n      const isNegative = argument.startsWith(\"--no-\");\n\n      const option = subcommandProps.options.find(o => {\n        if (o.name === optionName) return true;\n        if (isNegative && noName(o.name) === optionName) return true;\n\n        if (!o.aliases) return false;\n        if (o.aliases.includes(optionName)) return true;\n        if (isNegative && o.aliases.map(noName).includes(optionName)) return true;\n\n        return false;\n      });\n\n      if (!option) {\n        throw new Error(`Unknown option: \"${argument}\"`);\n      }\n\n      if (option.name in results) {\n        throw new Error(`Duplicated option: \"${argument}\"`);\n      }\n\n      const isTypeBoolean = isBooleanSchema(option.type);\n      const nextArg = argsv[i + 1];\n\n      let optionValue: string | boolean = argWithEquals ? argValue : nextArg;\n\n      if (isTypeBoolean) {\n        if (argWithEquals) {\n          const parsedBoolean = stringToBoolean(argValue);\n          optionValue = isNegative ? !parsedBoolean : parsedBoolean;\n        } else {\n          optionValue = !isNegative;\n        }\n      }\n\n      if (typeof optionValue === \"undefined\") {\n        throw new Error(`Expected a value for \"${argument}\" but got nothing`);\n      }\n\n      if (!argWithEquals && isOptionArg(optionValue)) {\n        throw new Error(`Expected a value for \"${argument}\" but got an argument \"${nextArg}\"`);\n      }\n\n      const res = option.type.safeParse(optionValue);\n      if (!res.success) {\n        throw new Error(`Invalid value \"${optionValue}\" for \"${argument}\": ${res.error.errors[0].message}`);\n      }\n\n      results[option.name] = res.data;\n      addRawArg(option.name, argument);\n      const rawVal = argWithEquals ? argValue : isTypeBoolean ? \"\" : nextArg;\n      addRawValue(option.name, rawVal);\n      fillOption(option.name, option);\n\n      if (!argWithEquals && !isTypeBoolean) i++;\n      continue;\n    }\n\n    const subcommandProps = GetSubcommandProps();\n\n    // * arguments\n    if (subcommandProps?.arguments?.length) {\n      if (!results.arguments) results.arguments = [];\n\n      const currentArgCount = results.arguments.length;\n\n      if (currentArgCount < subcommandProps.arguments.length) {\n        const argType = subcommandProps.arguments[currentArgCount].type;\n\n        let argValue: string | boolean = arg;\n        const isTypeBoolean = isBooleanSchema(argType);\n        if (isTypeBoolean) argValue = stringToBoolean(argValue);\n\n        const res = argType.safeParse(argValue);\n        if (!res.success) {\n          throw new Error(\n            `The ${getOrdinalPlacement(currentArgCount)} argument \"${arg}\" is invalid: ${res.error.errors[0].message}`,\n          );\n        }\n\n        results.arguments.push(res.data);\n        continue;\n      }\n    }\n\n    // * positional\n    if (subcommandProps?.allowPositional) {\n      if (!results.positional) results.positional = [];\n      results.positional.push(arg);\n      continue;\n    }\n\n    const msg = !results.subcommand ? \"here\" : `for subcommand \"${results.subcommand}\"`;\n    throw new Error(`Unexpected argument \"${arg}\": positional arguments are not allowed ${msg}`);\n  }\n\n  // check for missing options - set defaults - add _source\n  const subcommandProps = GetSubcommandProps();\n  if (subcommandProps?.options?.length) {\n    for (const option of subcommandProps.options) {\n      if (option.name in results) {\n        addSource(option.name, \"cli\");\n        fillOption(option.name, option);\n        continue;\n      }\n\n      if (option.type.isOptional()) {\n        const hasDefault = typeof option.type._def.defaultValue === \"function\";\n        if (!hasDefault) continue;\n        results[option.name] = option.type._def.defaultValue();\n        addSource(option.name, \"default\");\n        fillOption(option.name, option);\n        continue;\n      }\n\n      throw new Error(`Missing required option: ${transformOptionToArg(option.name)}`);\n    }\n  }\n\n  // check for arguments - set defaults\n  if (subcommandProps?.arguments?.length) {\n    const currentArgCount = results.arguments?.length ?? 0;\n    const subcommandArgCount = subcommandProps.arguments.length;\n\n    // missing arguments\n    if (currentArgCount < subcommandArgCount) {\n      for (let i = currentArgCount; i < subcommandArgCount; i++) {\n        const argumentType = subcommandProps.arguments[i].type;\n        const hasDefault = typeof argumentType._def.defaultValue === \"function\";\n        if (hasDefault && results.arguments) {\n          results.arguments.push(argumentType._def.defaultValue());\n          continue;\n        }\n\n        if (argumentType.isOptional()) continue;\n\n        throw new Error(`the ${getOrdinalPlacement(i)} argument is required: \"${subcommandProps.arguments[i].name}\"`);\n      }\n    }\n  }\n\n  if (subcommandProps?.action) {\n    subcommandProps.action(results);\n  }\n\n  return results as UnSafeParseResult<[...T, NoSubcommand & U]>;\n}\n\nexport function safeParse<T extends Subcommand[]>(argsv: string[], ...params: T): SafeParseResult<T>;\nexport function safeParse<T extends Subcommand[], U extends Cli>(\n  argsv: string[],\n  ...params: [U, ...T]\n): SafeParseResult<[...T, NoSubcommand & U]>;\n\nexport function safeParse<T extends Subcommand[], U extends Cli>(argsv: string[], ...params: [U, ...T]) {\n  const cliOptions = (\"cliName\" in params[0] ? params[0] : {}) as U;\n  const subcommandArr = params as Subcommand[];\n\n  const printCliHelp = (opt?: PrintHelpOpt) => help.printCliHelp(params, opt);\n  const printSubcommandHelp = (subcommandStr: NonNullable<T[number][\"name\"]>, opt?: PrintHelpOpt) => {\n    const subcommand = subcommandArr.find(c => c.name === subcommandStr);\n    if (!subcommand) return console.error(`Cannot print help for subcommand \"${subcommandStr}\" as it does not exist`);\n    help.printSubcommandHelp(subcommand, opt, cliOptions.cliName);\n  };\n\n  try {\n    const data = parse(argsv, ...params);\n    // @ts-expect-error error\n    delete data.printCliHelp;\n    // @ts-expect-error error\n    delete data.printSubcommandHelp;\n\n    return {\n      success: true,\n      data: data as Omit<typeof data, \"printCliHelp\" | \"printSubcommandHelp\">,\n      printCliHelp,\n      printSubcommandHelp,\n    };\n  } catch (e) {\n    return { success: false, error: e as Error, printCliHelp, printSubcommandHelp };\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/typescript/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/help.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAY,GAAG,EAAU,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA0BlF,iBAAS,YAAY,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC,EAAE,YAAY,GAAE,YAAiB,QA4EpF;AAED,iBAAS,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,GAAE,YAAiB,EAAE,OAAO,SAAK,QA+DjG;AAsKD,eAAO,MAAM,IAAI;;;CAGhB,CAAC"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/help.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAY,GAAG,EAAU,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAyBlF,iBAAS,YAAY,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC,EAAE,YAAY,GAAE,YAAiB,QA4EpF;AAED,iBAAS,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,GAAE,YAAiB,EAAE,OAAO,SAAK,QAiEjG;AAsKD,eAAO,MAAM,IAAI;;;CAGhB,CAAC"}

package/lib/typescript/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,GAAG,EACH,YAAY,EAGZ,eAAe,EACf,UAAU,EACV,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;AACnG,wBAAgB,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE,CAAC,SAAS,GAAG,EACzD,KAAK,EAAE,MAAM,EAAE,EACf,GAAG,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GACnB,iBAAiB,CAAC,CAAC,GAAG,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC;AA8O/C,wBAAgB,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;AACrG,wBAAgB,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE,CAAC,SAAS,GAAG,EAC7D,KAAK,EAAE,MAAM,EAAE,EACf,GAAG,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GACnB,eAAe,CAAC,CAAC,GAAG,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,GAAG,EACH,YAAY,EAGZ,eAAe,EACf,UAAU,EACV,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;AACnG,wBAAgB,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE,CAAC,SAAS,GAAG,EACzD,KAAK,EAAE,MAAM,EAAE,EACf,GAAG,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GACnB,iBAAiB,CAAC,CAAC,GAAG,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC;AA+P/C,wBAAgB,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;AACrG,wBAAgB,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE,CAAC,SAAS,GAAG,EAC7D,KAAK,EAAE,MAAM,EAAE,EACf,GAAG,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GACnB,eAAe,CAAC,CAAC,GAAG,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC"}

package/lib/typescript/types.d.ts

@@ -9,20 +9,13 @@ export type Subcommand = {
      *   name: "run-app";
      */
     name: string;
-    /**
-     * - The action is executed with the result of the parsed arguments.
-     * - To get typescript types use `setAction` instead of this.
-     *
-     * @example
-     *   const helpCommand = createSubcommand({ name: "help", options: [...] });
-     *   helpCommand.setAction(res => console.log(res));
-     */
-    action?: (results?: any) => void;
     /**
      * - The description of the subcommand.
      * - Used for generating the help message.
      */
     description?: string;
+    /** - The usage message in the help message. */
+    usage?: string;
     /** - Used for generating the help message. */
     placeholder?: string;
     /**
@@ -55,15 +48,19 @@ export type Subcommand = {
      *   which arguments are optional.
      */
     arguments?: [Argument, ...Argument[]];
+    /**
+     * - The action is executed with the result of the parsed arguments.
+     * - To get typescript types use `setAction` instead of this.
+     *
+     * @example
+     *   const helpCommand = createSubcommand({ name: "help", options: [...] });
+     *   helpCommand.setAction(res => console.log(res));
+     */
+    action?: (results?: any) => void;
 };
 export type Cli = Prettify<Omit<Subcommand, "name"> & {
     /** - The name of the CLI program. */
     cliName: string;
-    /**
-     * - The usage of the CLI program.
-     * - Used for generating the help message.
-     */
-    usage?: string;
 }>;
 export type Option = {
     /**

package/lib/typescript/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zod-args-parser",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "A strictly typed command-line arguments parser powered by Zod.",
   "author": "Ahmed ALABSI <alabsi91@gmail>",
   "license": "MIT",
@@ -10,7 +10,7 @@
   },
   "type": "module",
   "scripts": {
-    "dev": "tsx watch src/test.ts",
+    "dev": "tsx watch example/cli.ts",
     "build": "node scripts/build.mjs",
     "test": "eslint src/** --fix && tsc --noEmit && tsx test/test.ts",
     "prepare": "npm run test && npm run build"
@@ -46,6 +46,7 @@
     "@babel/core": "^7.26.0",
     "@babel/preset-env": "^7.26.0",
     "@babel/preset-typescript": "^7.26.0",
+    "@eslint/compat": "^1.2.3",
     "@eslint/js": "^9.14.0",
     "@types/babel__core": "^7.20.5",
     "@types/node": "^22.9.0",
@@ -60,4 +61,4 @@
     "typescript": "^5.6.3",
     "typescript-eslint": "^8.14.0"
   }
-}
+}

package/src/help.ts

@@ -3,14 +3,13 @@ import { concat, getDefaultValueFromSchema, indent, ln, print, println, transfor
 
 import type { Argument, Cli, Option, PrintHelpOpt, Subcommand } from "./types.js";
 
-/** Colors */
 const colors: NonNullable<Required<PrintHelpOpt["customColors"]>> = {
   title: chalk.bold.blue,
   description: chalk.white,
   default: chalk.dim.italic,
   optional: chalk.dim.italic,
   exampleTitle: chalk.yellow,
-  example: chalk.dim.italic,
+  example: chalk.dim,
   command: chalk.yellow,
   option: chalk.cyan,
   argument: chalk.green,
@@ -126,13 +125,15 @@ function printSubcommandHelp(subcommand: Subcommand, printOptions: PrintHelpOpt
   };
 
   // Print command usage
-  const usage = concat(
-    c.punctuation("$"),
-    cliName,
-    c.command(subcommand.name),
-    subcommand.options?.length ? c.option("[options]") : "",
-    subcommand.arguments?.length || subcommand.allowPositional ? c.argument("<arguments>") : "",
-  );
+  const usage =
+    subcommand.usage ??
+    concat(
+      c.punctuation("$"),
+      cliName,
+      c.command(subcommand.name),
+      subcommand.options?.length ? c.option("[options]") : "",
+      subcommand.arguments?.length || subcommand.allowPositional ? c.argument("<arguments>") : "",
+    );
   printTitle("Usage");
   println();
   println(indent(2), usage, ln(1));
@@ -293,7 +294,7 @@ function printPreparedCommands(commandsToPrint: PreparedToPrint[], c: typeof col
   for (const { names, placeholder, description } of commandsToPrint) {
     const optLength = names.length + (placeholder?.length ?? 0);
     const spacing = longest + 1 - optLength;
-    const normalizeDesc = description.replace(/\n/g, "\n" + indent(longest + 7));
+    const normalizeDesc = description.replace(/\n/g, "\n" + indent(longest + 7) + c.punctuation("└"));
 
     const coloredNames = names
       .split(/(,)/)

package/src/parser.ts

@@ -50,12 +50,27 @@ export function parse<T extends Subcommand[], U extends Cli>(argsv: string[], ..
       help.printCliHelp(params, opt);
     },
     printSubcommandHelp(subcommandStr, opt) {
-      const subcommand = subcommandArr.find(c => c.name === subcommandStr);
+      const subcommand = subcommandArr.find(c => {
+        if (c.name === subcommandStr) return true;
+        if (!subcommandStr) return false;
+        if (!c.aliases?.length) return false;
+        return c.aliases.includes(subcommandStr);
+      });
       if (!subcommand) return console.error(`Cannot print help for subcommand "${subcommandStr}" as it does not exist`);
       help.printSubcommandHelp(subcommand, opt, cliOptions.cliName);
     },
   };
 
+  /** - Get current subcommand props */
+  const GetSubcommandProps = (cmd = results.subcommand) => {
+    return subcommandArr.find(c => {
+      if (c.name === cmd) return true;
+      if (!cmd) return false;
+      if (!c.aliases?.length) return false;
+      return c.aliases.includes(cmd);
+    });
+  };
+
   const addRawArg = (optionName: string, rawArg: string) => {
     if (!results._info) results._info = {};
     if (!results._info[optionName]) results._info[optionName] = Object.create({});
@@ -88,7 +103,7 @@ export function parse<T extends Subcommand[], U extends Cli>(argsv: string[], ..
       results.subcommand = allSubcommands.has(arg) ? arg : undefined;
 
       // add positional and arguments array
-      const subcommandProps = subcommandArr.find(c => c.name === results.subcommand);
+      const subcommandProps = GetSubcommandProps();
       if (subcommandProps?.allowPositional) results.positional = [];
       if (subcommandProps?.arguments?.length) results.arguments = [];
 
@@ -106,7 +121,7 @@ export function parse<T extends Subcommand[], U extends Cli>(argsv: string[], ..
         throw new Error(`Flag arguments cannot be assigned using "=": "${arg}"`);
       }
 
-      const subcommandProps = subcommandArr.find(c => c.name === results.subcommand);
+      const subcommandProps = GetSubcommandProps();
       if (!subcommandProps) throw new Error(`Unknown subcommand: "${results.subcommand}"`);
 
       if (!subcommandProps.options) {
@@ -117,8 +132,6 @@ export function parse<T extends Subcommand[], U extends Cli>(argsv: string[], ..
       }
 
       const optionName = transformArg(argument);
-      if (optionName in results) throw new Error(`Duplicate option: "${argument}"`);
-
       const isNegative = argument.startsWith("--no-");
 
       const option = subcommandProps.options.find(o => {
@@ -136,6 +149,10 @@ export function parse<T extends Subcommand[], U extends Cli>(argsv: string[], ..
         throw new Error(`Unknown option: "${argument}"`);
       }
 
+      if (option.name in results) {
+        throw new Error(`Duplicated option: "${argument}"`);
+      }
+
       const isTypeBoolean = isBooleanSchema(option.type);
       const nextArg = argsv[i + 1];
 
@@ -173,7 +190,7 @@ export function parse<T extends Subcommand[], U extends Cli>(argsv: string[], ..
       continue;
     }
 
-    const subcommandProps = subcommandArr.find(c => c.name === results.subcommand);
+    const subcommandProps = GetSubcommandProps();
 
     // * arguments
     if (subcommandProps?.arguments?.length) {
@@ -212,7 +229,7 @@ export function parse<T extends Subcommand[], U extends Cli>(argsv: string[], ..
   }
 
   // check for missing options - set defaults - add _source
-  const subcommandProps = subcommandArr.find(c => c.name === results.subcommand);
+  const subcommandProps = GetSubcommandProps();
   if (subcommandProps?.options?.length) {
     for (const option of subcommandProps.options) {
       if (option.name in results) {

package/src/types.ts

@@ -11,22 +11,15 @@ export type Subcommand = {
    */
   name: string;
 
-  /**
-   * - The action is executed with the result of the parsed arguments.
-   * - To get typescript types use `setAction` instead of this.
-   *
-   * @example
-   *   const helpCommand = createSubcommand({ name: "help", options: [...] });
-   *   helpCommand.setAction(res => console.log(res));
-   */
-  action?: (results?: any) => void;
-
   /**
    * - The description of the subcommand.
    * - Used for generating the help message.
    */
   description?: string;
 
+  /** - The usage message in the help message. */
+  usage?: string;
+
   /** - Used for generating the help message. */
   placeholder?: string;
 
@@ -64,18 +57,22 @@ export type Subcommand = {
    *   which arguments are optional.
    */
   arguments?: [Argument, ...Argument[]];
+
+  /**
+   * - The action is executed with the result of the parsed arguments.
+   * - To get typescript types use `setAction` instead of this.
+   *
+   * @example
+   *   const helpCommand = createSubcommand({ name: "help", options: [...] });
+   *   helpCommand.setAction(res => console.log(res));
+   */
+  action?: (results?: any) => void;
 };
 
 export type Cli = Prettify<
   Omit<Subcommand, "name"> & {
     /** - The name of the CLI program. */
     cliName: string;
-
-    /**
-     * - The usage of the CLI program.
-     * - Used for generating the help message.
-     */
-    usage?: string;
   }
 >;
 

package/lib/commonjs/types.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});

package/lib/commonjs/types.js.map

@@ -1 +0,0 @@
-{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"sourcesContent":["import type { z } from \"zod\";\n\nexport type Subcommand = {\n  /**\n   * - The subcommand name, use `kebab-case`.\n   * - Make sure to not duplicate commands and aliases.\n   *\n   * @example\n   *   name: \"test\";\n   *   name: \"run-app\";\n   */\n  name: string;\n\n  /**\n   * - The action is executed with the result of the parsed arguments.\n   * - To get typescript types use `setAction` instead of this.\n   *\n   * @example\n   *   const helpCommand = createSubcommand({ name: \"help\", options: [...] });\n   *   helpCommand.setAction(res => console.log(res));\n   */\n  action?: (results?: any) => void;\n\n  /**\n   * - The description of the subcommand.\n   * - Used for generating the help message.\n   */\n  description?: string;\n\n  /** - Used for generating the help message. */\n  placeholder?: string;\n\n  /**\n   * - Provide an example to show to the user.\n   * - Used for generating the help message.\n   */\n  example?: string;\n\n  /**\n   * - The aliases of the subcommand.\n   * - Make sure to not duplicate aliases and commands.\n   */\n  aliases?: string[];\n\n  /**\n   * - Allows positional arguments for this subcommand.\n   * - Unlike `arguments`, which are strictly typed, positional arguments are untyped and represented as a string array of\n   *   variable length.\n   * - When enabled and `arguments` are provided, `arguments` will be parsed first. Any remaining arguments will be\n   *   considered positional arguments and added to the `positional` property in the result.\n   */\n  allowPositional?: boolean;\n\n  /**\n   * - The options of the command.\n   * - Those options are specific to this subcommand.\n   */\n  options?: [Option, ...Option[]];\n\n  /**\n   * - Specifies a list of strictly typed arguments.\n   * - The order is important; for example, the first argument will be validated against the first specified type.\n   * - It is recommended to not use optional arguments as the parser will fill the arguments by order and can't determine\n   *   which arguments are optional.\n   */\n  arguments?: [Argument, ...Argument[]];\n};\n\nexport type Cli = Prettify<\n  Omit<Subcommand, \"name\"> & {\n    /** - The name of the CLI program. */\n    cliName: string;\n\n    /**\n     * - The usage of the CLI program.\n     * - Used for generating the help message.\n     */\n    usage?: string;\n  }\n>;\n\nexport type Option = {\n  /**\n   * - The name of the option, use `CamelCase`.\n   * - For example: the syntax for the option `rootPath` is `--root-path`.\n   */\n  name: string;\n\n  /**\n   * - The will be used to validate the user input.\n   *\n   * @example\n   *   type: z.boolean().default(false);\n   *   type: z.coerce.number(); // will be coerced to number by Zod\n   *   type: z.preprocess(parseStringToArrFn, z.array(z.coerce.number())); // array of numbers\n   *\n   * @see https://zod.dev/?id=types\n   */\n  type: z.ZodTypeAny;\n\n  /**\n   * - The description of the option.\n   * - Used for generating the help message.\n   */\n  description?: string;\n\n  /** - Used for generating the help message. */\n  placeholder?: string;\n\n  /**\n   * - The example of using the option.\n   * - Used for generating the help message.\n   */\n  example?: string;\n\n  /**\n   * - The aliases of the option, use `CamelCase`.\n   * - Here you can specify short names or flags.\n   * - Make sure to not duplicate aliases.\n   */\n  aliases?: [string, ...string[]];\n};\n\nexport type Argument = {\n  /** - The name of the argument. */\n  name: string;\n\n  /**\n   * - The will be used to validate the user input.\n   *\n   * @example\n   *   type: z.boolean();\n   *   type: z.coerce.number(); // will be coerced to number by Zod\n   *   type: z.preprocess(ParseStringToArrFn, z.array(z.coerce.number())); // array of numbers\n   *\n   * @see https://zod.dev/?id=types\n   */\n  type: z.ZodTypeAny;\n\n  /**\n   * - The description of the argument.\n   * - Used for generating the help message.\n   */\n  description?: string;\n\n  /**\n   * - The example of using the argument.\n   * - Used for generating the help message.\n   */\n  example?: string;\n};\n\nexport type ColorFnType = (...text: unknown[]) => string;\n\nexport type PrintHelpOpt = {\n  /**\n   * - **Optional** `boolean`\n   * - Whether to print colors or not.\n   * - Default: `true`\n   */\n  colors?: boolean;\n\n  /**\n   * - **Optional** `object`\n   * - The colors to use for the help message.\n   */\n  customColors?: {\n    title?: ColorFnType;\n    description?: ColorFnType;\n    default?: ColorFnType;\n    optional?: ColorFnType;\n    exampleTitle?: ColorFnType;\n    example?: ColorFnType;\n    command?: ColorFnType;\n    option?: ColorFnType;\n    argument?: ColorFnType;\n    placeholder?: ColorFnType;\n    punctuation?: ColorFnType;\n  };\n};\n\nexport type _Info = {\n  /**\n   * - The raw argument as it was passed in\n   * - For options that have a default value and are not passed in, the raw argument will be `undefined`\n   */\n  rawArg?: string;\n  /**\n   * - The raw value of the argument as it was passed in\n   * - It will be empty string for `boolean` options. E.g. `--help` or `-h`\n   * - For options that have a default value and are not passed in, the raw value will be `undefined`\n   */\n  rawValue?: string;\n  /**\n   * - The source value of the argument:\n   * - `cli`: The argument was passed in by the user\n   * - `default`: The argument was not passed in and has a default value\n   */\n  source: \"cli\" | \"default\";\n};\n\n/**\n * - Infer the options type from a subcommand.\n *\n * @example\n *   const subcommand = createSubcommand({ name: \"build\", options: [...] });\n *   type OptionsType = InferOptionsType<typeof subcommand>;\n */\nexport type InferOptionsType<T extends Partial<Subcommand>> = T[\"options\"] extends infer U extends Option[]\n  ? ToOptional<{ [K in U[number][\"name\"]]: z.infer<Extract<U[number], { name: K }>[\"type\"]> }>\n  : undefined;\n\n/**\n * - Infer the arguments type from a subcommand.\n *\n * @example\n *   const subcommand = createSubcommand({ name: \"build\", arguments: [...] });\n *   type ArgumentsType = InferArgumentsType<typeof subcommand>;\n */\nexport type InferArgumentsType<T extends Partial<Subcommand>> = T[\"arguments\"] extends infer U extends Argument[]\n  ? { [K in keyof U]: U[K] extends { type: z.ZodTypeAny } ? z.infer<U[K][\"type\"]> : never }\n  : undefined;\n\n/** `{ some props } & { other props }` => `{ some props, other props }` */\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {};\n\n/** Allow string type for literal union and get auto completion */\nexport type LiteralUnion<T extends string> = T | (string & {});\n\n/** Extract the undefined properties from an object */\ntype UndefinedProperties<T> = { [P in keyof T]-?: undefined extends T[P] ? P : never }[keyof T];\n\n/** Make undefined properties optional? */\ntype ToOptional<T> = Prettify<\n  Partial<Pick<T, UndefinedProperties<T>>> & Pick<T, Exclude<keyof T, UndefinedProperties<T>>>\n>;\n\nexport type OptionsArr2RecordType<T extends Option[] | undefined> = T extends Option[]\n  ? ToOptional<{ [K in T[number][\"name\"]]: z.infer<Extract<T[number], { name: K }>[\"type\"]> }>\n  : object;\n\nexport type ArgumentsArr2ArrType<T extends Argument[] | undefined> = T extends Argument[]\n  ? { arguments: { [K in keyof T]: T[K] extends { type: z.ZodTypeAny } ? z.infer<T[K][\"type\"]> : never } }\n  : object;\n\nexport type Positional<S extends Partial<Subcommand>> = S[\"allowPositional\"] extends true\n  ? { positional: string[] }\n  : object;\n\nexport type Info<T extends Option[] | undefined> = T extends Option[]\n  ? {\n      _info: ToOptional<{\n        [K in T[number][\"name\"]]: Extract<T[number], { name: K }> extends infer U extends Option\n          ? undefined extends z.infer<U[\"type\"]>\n            ? undefined | Prettify<_Info & U> // if optional add undefined\n            : Prettify<_Info & U>\n          : never;\n      }>;\n    }\n  : object;\n\nexport type NoSubcommand = { name: undefined };\n\nexport type ParseResult<S extends Partial<Subcommand>[]> = {\n  [K in keyof S]: Prettify<\n    { subcommand: S[K][\"name\"] } & Positional<S[K]> &\n      Info<S[K][\"options\"]> &\n      OptionsArr2RecordType<S[K][\"options\"]> &\n      ArgumentsArr2ArrType<S[K][\"arguments\"]>\n  >;\n}[number];\n\nexport type PrintMethods<N extends Subcommand[\"name\"] | undefined> = {\n  printCliHelp: (options?: PrintHelpOpt) => void;\n  printSubcommandHelp: (subcommand: LiteralUnion<NonNullable<N>>, options?: PrintHelpOpt) => void;\n};\n\nexport type UnSafeParseResult<S extends Partial<Subcommand>[]> =\n  CheckDuplicatedSubcommands<S> extends infer E extends string\n    ? E\n    : Prettify<ParseResult<S> & PrintMethods<S[number][\"name\"]>>;\n\nexport type SafeParseResult<S extends Partial<Subcommand>[]> =\n  CheckDuplicatedSubcommands<S> extends infer E extends string\n    ? E\n    : Prettify<\n        ({ success: false; error: Error } | { success: true; data: ParseResult<S> }) & PrintMethods<S[number][\"name\"]>\n      >;\n\nexport type ActionFn<T extends Subcommand | Cli> = {\n  setAction: (actions: (res: UnSafeParseResult<[T]>) => void) => void;\n};\n\n/** - Combine `name` and `aliases` to a `string[]` */\ntype MapNameAndAliases2StrArr<T extends { name?: string; aliases?: string[] }[]> = T extends [\n  infer First extends Subcommand,\n  ...infer Rest,\n]\n  ? Rest extends { name?: string; aliases?: string[] }[]\n    ? [First[\"name\"], ...(First[\"aliases\"] extends string[] ? First[\"aliases\"] : []), ...MapNameAndAliases2StrArr<Rest>]\n    : [First[\"name\"], ...(First[\"aliases\"] extends string[] ? First[\"aliases\"] : [])]\n  : [];\n\n/**\n * - Find duplicated items in an array and return it\n * - Return `false` if not found\n */\ntype IsDuplicatesInArr<Input extends any[]> = Input extends [infer Item, ...infer Rest]\n  ? Rest extends any[]\n    ? Item extends Rest[number]\n      ? Item\n      : IsDuplicatesInArr<Rest>\n    : false\n  : false;\n\n/**\n * - Check if there are duplicated options including aliases in `subcommand`\n * - Return an error message if duplicated is found\n * - Return `subcommand` if not found\n */\nexport type CheckDuplicatedOptions<T extends Subcommand | Cli> = T[\"options\"] extends infer O extends Option[]\n  ? IsDuplicatesInArr<MapNameAndAliases2StrArr<O>> extends infer D extends string\n    ? `>>> Error: Duplicated Options \\`${D}\\` <<<`\n    : T\n  : T;\n\n/**\n * - Check for duplicated subcommands including aliases\n * - Return an error message if duplicated is found\n * - Return the `subcommand[]` if no error\n */\nexport type CheckDuplicatedSubcommands<T extends Partial<Subcommand>[]> =\n  IsDuplicatesInArr<MapNameAndAliases2StrArr<T>> extends infer D extends string\n    ? `>>> Error: Duplicated Subcommand \\`${D}\\` <<<`\n    : T;\n"],"mappings":"","ignoreList":[]}

package/lib/module/types.js

@@ -1 +0,0 @@
-export{};

package/lib/module/types.js.map

@@ -1 +0,0 @@
-{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"sourcesContent":["import type { z } from \"zod\";\n\nexport type Subcommand = {\n  /**\n   * - The subcommand name, use `kebab-case`.\n   * - Make sure to not duplicate commands and aliases.\n   *\n   * @example\n   *   name: \"test\";\n   *   name: \"run-app\";\n   */\n  name: string;\n\n  /**\n   * - The action is executed with the result of the parsed arguments.\n   * - To get typescript types use `setAction` instead of this.\n   *\n   * @example\n   *   const helpCommand = createSubcommand({ name: \"help\", options: [...] });\n   *   helpCommand.setAction(res => console.log(res));\n   */\n  action?: (results?: any) => void;\n\n  /**\n   * - The description of the subcommand.\n   * - Used for generating the help message.\n   */\n  description?: string;\n\n  /** - Used for generating the help message. */\n  placeholder?: string;\n\n  /**\n   * - Provide an example to show to the user.\n   * - Used for generating the help message.\n   */\n  example?: string;\n\n  /**\n   * - The aliases of the subcommand.\n   * - Make sure to not duplicate aliases and commands.\n   */\n  aliases?: string[];\n\n  /**\n   * - Allows positional arguments for this subcommand.\n   * - Unlike `arguments`, which are strictly typed, positional arguments are untyped and represented as a string array of\n   *   variable length.\n   * - When enabled and `arguments` are provided, `arguments` will be parsed first. Any remaining arguments will be\n   *   considered positional arguments and added to the `positional` property in the result.\n   */\n  allowPositional?: boolean;\n\n  /**\n   * - The options of the command.\n   * - Those options are specific to this subcommand.\n   */\n  options?: [Option, ...Option[]];\n\n  /**\n   * - Specifies a list of strictly typed arguments.\n   * - The order is important; for example, the first argument will be validated against the first specified type.\n   * - It is recommended to not use optional arguments as the parser will fill the arguments by order and can't determine\n   *   which arguments are optional.\n   */\n  arguments?: [Argument, ...Argument[]];\n};\n\nexport type Cli = Prettify<\n  Omit<Subcommand, \"name\"> & {\n    /** - The name of the CLI program. */\n    cliName: string;\n\n    /**\n     * - The usage of the CLI program.\n     * - Used for generating the help message.\n     */\n    usage?: string;\n  }\n>;\n\nexport type Option = {\n  /**\n   * - The name of the option, use `CamelCase`.\n   * - For example: the syntax for the option `rootPath` is `--root-path`.\n   */\n  name: string;\n\n  /**\n   * - The will be used to validate the user input.\n   *\n   * @example\n   *   type: z.boolean().default(false);\n   *   type: z.coerce.number(); // will be coerced to number by Zod\n   *   type: z.preprocess(parseStringToArrFn, z.array(z.coerce.number())); // array of numbers\n   *\n   * @see https://zod.dev/?id=types\n   */\n  type: z.ZodTypeAny;\n\n  /**\n   * - The description of the option.\n   * - Used for generating the help message.\n   */\n  description?: string;\n\n  /** - Used for generating the help message. */\n  placeholder?: string;\n\n  /**\n   * - The example of using the option.\n   * - Used for generating the help message.\n   */\n  example?: string;\n\n  /**\n   * - The aliases of the option, use `CamelCase`.\n   * - Here you can specify short names or flags.\n   * - Make sure to not duplicate aliases.\n   */\n  aliases?: [string, ...string[]];\n};\n\nexport type Argument = {\n  /** - The name of the argument. */\n  name: string;\n\n  /**\n   * - The will be used to validate the user input.\n   *\n   * @example\n   *   type: z.boolean();\n   *   type: z.coerce.number(); // will be coerced to number by Zod\n   *   type: z.preprocess(ParseStringToArrFn, z.array(z.coerce.number())); // array of numbers\n   *\n   * @see https://zod.dev/?id=types\n   */\n  type: z.ZodTypeAny;\n\n  /**\n   * - The description of the argument.\n   * - Used for generating the help message.\n   */\n  description?: string;\n\n  /**\n   * - The example of using the argument.\n   * - Used for generating the help message.\n   */\n  example?: string;\n};\n\nexport type ColorFnType = (...text: unknown[]) => string;\n\nexport type PrintHelpOpt = {\n  /**\n   * - **Optional** `boolean`\n   * - Whether to print colors or not.\n   * - Default: `true`\n   */\n  colors?: boolean;\n\n  /**\n   * - **Optional** `object`\n   * - The colors to use for the help message.\n   */\n  customColors?: {\n    title?: ColorFnType;\n    description?: ColorFnType;\n    default?: ColorFnType;\n    optional?: ColorFnType;\n    exampleTitle?: ColorFnType;\n    example?: ColorFnType;\n    command?: ColorFnType;\n    option?: ColorFnType;\n    argument?: ColorFnType;\n    placeholder?: ColorFnType;\n    punctuation?: ColorFnType;\n  };\n};\n\nexport type _Info = {\n  /**\n   * - The raw argument as it was passed in\n   * - For options that have a default value and are not passed in, the raw argument will be `undefined`\n   */\n  rawArg?: string;\n  /**\n   * - The raw value of the argument as it was passed in\n   * - It will be empty string for `boolean` options. E.g. `--help` or `-h`\n   * - For options that have a default value and are not passed in, the raw value will be `undefined`\n   */\n  rawValue?: string;\n  /**\n   * - The source value of the argument:\n   * - `cli`: The argument was passed in by the user\n   * - `default`: The argument was not passed in and has a default value\n   */\n  source: \"cli\" | \"default\";\n};\n\n/**\n * - Infer the options type from a subcommand.\n *\n * @example\n *   const subcommand = createSubcommand({ name: \"build\", options: [...] });\n *   type OptionsType = InferOptionsType<typeof subcommand>;\n */\nexport type InferOptionsType<T extends Partial<Subcommand>> = T[\"options\"] extends infer U extends Option[]\n  ? ToOptional<{ [K in U[number][\"name\"]]: z.infer<Extract<U[number], { name: K }>[\"type\"]> }>\n  : undefined;\n\n/**\n * - Infer the arguments type from a subcommand.\n *\n * @example\n *   const subcommand = createSubcommand({ name: \"build\", arguments: [...] });\n *   type ArgumentsType = InferArgumentsType<typeof subcommand>;\n */\nexport type InferArgumentsType<T extends Partial<Subcommand>> = T[\"arguments\"] extends infer U extends Argument[]\n  ? { [K in keyof U]: U[K] extends { type: z.ZodTypeAny } ? z.infer<U[K][\"type\"]> : never }\n  : undefined;\n\n/** `{ some props } & { other props }` => `{ some props, other props }` */\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {};\n\n/** Allow string type for literal union and get auto completion */\nexport type LiteralUnion<T extends string> = T | (string & {});\n\n/** Extract the undefined properties from an object */\ntype UndefinedProperties<T> = { [P in keyof T]-?: undefined extends T[P] ? P : never }[keyof T];\n\n/** Make undefined properties optional? */\ntype ToOptional<T> = Prettify<\n  Partial<Pick<T, UndefinedProperties<T>>> & Pick<T, Exclude<keyof T, UndefinedProperties<T>>>\n>;\n\nexport type OptionsArr2RecordType<T extends Option[] | undefined> = T extends Option[]\n  ? ToOptional<{ [K in T[number][\"name\"]]: z.infer<Extract<T[number], { name: K }>[\"type\"]> }>\n  : object;\n\nexport type ArgumentsArr2ArrType<T extends Argument[] | undefined> = T extends Argument[]\n  ? { arguments: { [K in keyof T]: T[K] extends { type: z.ZodTypeAny } ? z.infer<T[K][\"type\"]> : never } }\n  : object;\n\nexport type Positional<S extends Partial<Subcommand>> = S[\"allowPositional\"] extends true\n  ? { positional: string[] }\n  : object;\n\nexport type Info<T extends Option[] | undefined> = T extends Option[]\n  ? {\n      _info: ToOptional<{\n        [K in T[number][\"name\"]]: Extract<T[number], { name: K }> extends infer U extends Option\n          ? undefined extends z.infer<U[\"type\"]>\n            ? undefined | Prettify<_Info & U> // if optional add undefined\n            : Prettify<_Info & U>\n          : never;\n      }>;\n    }\n  : object;\n\nexport type NoSubcommand = { name: undefined };\n\nexport type ParseResult<S extends Partial<Subcommand>[]> = {\n  [K in keyof S]: Prettify<\n    { subcommand: S[K][\"name\"] } & Positional<S[K]> &\n      Info<S[K][\"options\"]> &\n      OptionsArr2RecordType<S[K][\"options\"]> &\n      ArgumentsArr2ArrType<S[K][\"arguments\"]>\n  >;\n}[number];\n\nexport type PrintMethods<N extends Subcommand[\"name\"] | undefined> = {\n  printCliHelp: (options?: PrintHelpOpt) => void;\n  printSubcommandHelp: (subcommand: LiteralUnion<NonNullable<N>>, options?: PrintHelpOpt) => void;\n};\n\nexport type UnSafeParseResult<S extends Partial<Subcommand>[]> =\n  CheckDuplicatedSubcommands<S> extends infer E extends string\n    ? E\n    : Prettify<ParseResult<S> & PrintMethods<S[number][\"name\"]>>;\n\nexport type SafeParseResult<S extends Partial<Subcommand>[]> =\n  CheckDuplicatedSubcommands<S> extends infer E extends string\n    ? E\n    : Prettify<\n        ({ success: false; error: Error } | { success: true; data: ParseResult<S> }) & PrintMethods<S[number][\"name\"]>\n      >;\n\nexport type ActionFn<T extends Subcommand | Cli> = {\n  setAction: (actions: (res: UnSafeParseResult<[T]>) => void) => void;\n};\n\n/** - Combine `name` and `aliases` to a `string[]` */\ntype MapNameAndAliases2StrArr<T extends { name?: string; aliases?: string[] }[]> = T extends [\n  infer First extends Subcommand,\n  ...infer Rest,\n]\n  ? Rest extends { name?: string; aliases?: string[] }[]\n    ? [First[\"name\"], ...(First[\"aliases\"] extends string[] ? First[\"aliases\"] : []), ...MapNameAndAliases2StrArr<Rest>]\n    : [First[\"name\"], ...(First[\"aliases\"] extends string[] ? First[\"aliases\"] : [])]\n  : [];\n\n/**\n * - Find duplicated items in an array and return it\n * - Return `false` if not found\n */\ntype IsDuplicatesInArr<Input extends any[]> = Input extends [infer Item, ...infer Rest]\n  ? Rest extends any[]\n    ? Item extends Rest[number]\n      ? Item\n      : IsDuplicatesInArr<Rest>\n    : false\n  : false;\n\n/**\n * - Check if there are duplicated options including aliases in `subcommand`\n * - Return an error message if duplicated is found\n * - Return `subcommand` if not found\n */\nexport type CheckDuplicatedOptions<T extends Subcommand | Cli> = T[\"options\"] extends infer O extends Option[]\n  ? IsDuplicatesInArr<MapNameAndAliases2StrArr<O>> extends infer D extends string\n    ? `>>> Error: Duplicated Options \\`${D}\\` <<<`\n    : T\n  : T;\n\n/**\n * - Check for duplicated subcommands including aliases\n * - Return an error message if duplicated is found\n * - Return the `subcommand[]` if no error\n */\nexport type CheckDuplicatedSubcommands<T extends Partial<Subcommand>[]> =\n  IsDuplicatesInArr<MapNameAndAliases2StrArr<T>> extends infer D extends string\n    ? `>>> Error: Duplicated Subcommand \\`${D}\\` <<<`\n    : T;\n"],"mappings":"","ignoreList":[]}