zod-args-parser 1.0.2 → 1.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Ahmed Alabsi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -6,6 +6,7 @@ A strictly typed command-line arguments parser powered by Zod.
 
 - **Strict typing for subcommands, options, and arguments**.
 - **Flag coupling support**: e.g., `-rf` to combine `-r` and `-f` flags.
+- **Negative flag support**: e.g., `--no-verbose` to negate `--verbose`.
 - **Flexible option value formatting**: Supports both `--input-dir path` and `--input-dir=path` styles.
 - **Help message generation**: Built-in methods to generate help text for the CLI and each subcommand.
 
@@ -18,28 +19,57 @@ npm install zod-args-parser
 ## Usage
 
 ```ts
-import { createCli, createSubcommand, safeParse } from "zod-args-parser";
+import { z } from "zod";
+import { createCli, createSubcommand, createOptions, safeParse } from "zod-args-parser";
+
+// Share same options between subcommands
+const sharedOptions = createOptions([
+  {
+    name: "verbose",
+    description: "Verbose mode",
+    type: z.boolean().optional(),
+  },
+]);
 
 // 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
@@ -65,7 +95,7 @@ helpCommandSchema.setAction(results => {
 
 const results = safeParse(
   process.argv.slice(2),
-  cliProgram,
+  cliSchema,
   helpCommandSchema,
   // Add more subcommands
 );
@@ -108,9 +138,7 @@ type Arguments = InferArgumentsType<typeof subcommand>;
 
 ## API
 
-### `createSubcommand(input: Subcommand)`
-
-Defines a subcommand with associated options and arguments.
+### `Subcommand`
 
 - `name: string`  
   The name of the subcommand.
@@ -121,6 +149,9 @@ Defines a subcommand with associated options and arguments.
 - `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.
 
@@ -135,7 +166,7 @@ Defines a subcommand with associated options and arguments.
   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":"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,GAKjH,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,CAACC,MAAM,CACzBK,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,CAAG,GAAAC,aAAM,EAClBb,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,CACD2B,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,CAAC,CAE5E,KAAM,CAAAyC,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":[]}
+{"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":"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","ignoreList":[]}

package/lib/commonjs/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.createCli=createCli;exports.createSubcommand=createSubcommand;Object.defineProperty(exports,"parse",{enumerable:true,get:function(){return _parser.parse;}});exports.printSubcommandHelp=exports.printCliHelp=void 0;Object.defineProperty(exports,"safeParse",{enumerable:true,get:function(){return _parser.safeParse;}});var _help=require("./help.js");var _parser=require("./parser.js");function createSubcommand(input){return Object.assign(input,{setAction:action=>input.action=action});}function createCli(input){return Object.assign(input,{setAction:action=>input.action=action});}const{printCliHelp,printSubcommandHelp}=_help.help;exports.printSubcommandHelp=printSubcommandHelp;exports.printCliHelp=printCliHelp;
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.createCli=createCli;exports.createOptions=createOptions;exports.createSubcommand=createSubcommand;Object.defineProperty(exports,"parse",{enumerable:true,get:function(){return _parser.parse;}});exports.printSubcommandHelp=exports.printCliHelp=void 0;Object.defineProperty(exports,"safeParse",{enumerable:true,get:function(){return _parser.safeParse;}});var _help=require("./help.js");var _parser=require("./parser.js");function createSubcommand(input){return Object.assign(input,{setAction:action=>input.action=action});}function createCli(input){return Object.assign(input,{setAction:action=>input.action=action});}function createOptions(options){return options;}const{printCliHelp,printSubcommandHelp}=_help.help;exports.printSubcommandHelp=printSubcommandHelp;exports.printCliHelp=printCliHelp;

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_help","require","_parser","createSubcommand","input","Object","assign","setAction","action","createCli","printCliHelp","printSubcommandHelp","help","exports"],"sourceRoot":"../../src","sources":["index.ts"],"sourcesContent":["import { help } from \"./help.js\";\nimport { parse, safeParse } from \"./parser.js\";\n\nimport type { ActionFn, Cli, Prettify, Subcommand, UnSafeParseResult } from \"./types.js\";\n\nfunction createSubcommand<const T extends Subcommand>(input: T & Subcommand): Prettify<T & ActionFn<T>> {\n  return Object.assign(input, {\n    setAction: (action: (res: UnSafeParseResult<[T]>) => void) => (input.action = action),\n  });\n}\n\nfunction createCli<const T extends Cli>(input: T & Cli): Prettify<T & ActionFn<T>> {\n  return Object.assign(input, {\n    setAction: (action: (res: UnSafeParseResult<[T]>) => void) => (input.action = action),\n  });\n}\n\nconst { printCliHelp, printSubcommandHelp } = help;\n\nexport { createCli, createSubcommand, parse, printCliHelp, printSubcommandHelp, safeParse };\n\nexport type * from \"./types.js\";\n"],"mappings":"0YAAA,IAAAA,KAAA,CAAAC,OAAA,cACA,IAAAC,OAAA,CAAAD,OAAA,gBAIA,QAAS,CAAAE,gBAAgBA,CAA6BC,KAAqB,CAA6B,CACtG,MAAO,CAAAC,MAAM,CAACC,MAAM,CAACF,KAAK,CAAE,CAC1BG,SAAS,CAAGC,MAA6C,EAAMJ,KAAK,CAACI,MAAM,CAAGA,MAChF,CAAC,CAAC,CACJ,CAEA,QAAS,CAAAC,SAASA,CAAsBL,KAAc,CAA6B,CACjF,MAAO,CAAAC,MAAM,CAACC,MAAM,CAACF,KAAK,CAAE,CAC1BG,SAAS,CAAGC,MAA6C,EAAMJ,KAAK,CAACI,MAAM,CAAGA,MAChF,CAAC,CAAC,CACJ,CAEA,KAAM,CAAEE,YAAY,CAAEC,mBAAoB,CAAC,CAAGC,UAAI,CAACC,OAAA,CAAAF,mBAAA,CAAAA,mBAAA,CAAAE,OAAA,CAAAH,YAAA,CAAAA,YAAA","ignoreList":[]}
+{"version":3,"names":["_help","require","_parser","createSubcommand","input","Object","assign","setAction","action","createCli","createOptions","options","printCliHelp","printSubcommandHelp","help","exports"],"sourceRoot":"../../src","sources":["index.ts"],"sourcesContent":["import { help } from \"./help.js\";\nimport { parse, safeParse } from \"./parser.js\";\n\nimport type {\n  ActionFn,\n  CheckDuplicatedOptions,\n  Cli,\n  Option,\n  Prettify,\n  Subcommand,\n  UnSafeParseResult,\n} from \"./types.js\";\n\nfunction createSubcommand<const T extends Subcommand>(input: CheckDuplicatedOptions<T>): Prettify<T & ActionFn<T>> {\n  return Object.assign(input, {\n    setAction: (action: (res: UnSafeParseResult<[T]>) => void) => (input.action = action),\n  });\n}\n\nfunction createCli<const T extends Cli>(input: CheckDuplicatedOptions<T>): Prettify<T & ActionFn<T>> {\n  return Object.assign(input, {\n    setAction: (action: (res: UnSafeParseResult<[T]>) => void) => (input.action = action),\n  });\n}\n\nfunction createOptions<const T extends [Option, ...Option[]]>(options: T): T {\n  return options;\n}\n\nconst { printCliHelp, printSubcommandHelp } = help;\n\nexport { createCli, createSubcommand, createOptions, parse, printCliHelp, printSubcommandHelp, safeParse };\n\nexport type * from \"./types.js\";\n"],"mappings":"8aAAA,IAAAA,KAAA,CAAAC,OAAA,cACA,IAAAC,OAAA,CAAAD,OAAA,gBAYA,QAAS,CAAAE,gBAAgBA,CAA6BC,KAAgC,CAA6B,CACjH,MAAO,CAAAC,MAAM,CAACC,MAAM,CAACF,KAAK,CAAE,CAC1BG,SAAS,CAAGC,MAA6C,EAAMJ,KAAK,CAACI,MAAM,CAAGA,MAChF,CAAC,CAAC,CACJ,CAEA,QAAS,CAAAC,SAASA,CAAsBL,KAAgC,CAA6B,CACnG,MAAO,CAAAC,MAAM,CAACC,MAAM,CAACF,KAAK,CAAE,CAC1BG,SAAS,CAAGC,MAA6C,EAAMJ,KAAK,CAACI,MAAM,CAAGA,MAChF,CAAC,CAAC,CACJ,CAEA,QAAS,CAAAE,aAAaA,CAAwCC,OAAU,CAAK,CAC3E,MAAO,CAAAA,OAAO,CAChB,CAEA,KAAM,CAAEC,YAAY,CAAEC,mBAAoB,CAAC,CAAGC,UAAI,CAACC,OAAA,CAAAF,mBAAA,CAAAA,mBAAA,CAAAE,OAAA,CAAAH,YAAA,CAAAA,YAAA","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};