zod-args-parser 1.0.0

package/README.md

@@ -0,0 +1,215 @@
+# zod-args-parser
+
+A strictly typed command-line arguments parser powered by Zod.
+
+## Features
+
+- **Strict typing for subcommands, options, and arguments**.
+- **Flag coupling support**: e.g., `-rf` to combine `-r` and `-f` flags.
+- **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.
+
+## Installation
+
+```bash
+npm install zod-args-parser
+```
+
+## Usage
+
+```ts
+import { createCli, createSubcommand, safeParse } from "zod-args-parser";
+
+// Create a CLI schema
+// This will be used when no subcommands are provided
+const cliProgram = 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(),
+    },
+  ],
+});
+
+// Execute this function when the CLI is run
+cliProgram.setAction(results => {
+  const { help } = results;
+  if (help) results.printCliHelp();
+});
+
+// Create a subcommand schema
+const helpCommandSchema = createSubcommand({
+  name: "help",
+  placeholder: "<command>",
+  description: "Print help message for command",
+  arguments: [
+    {
+      name: "command",
+      description: "Command to print help for",
+      type: z.enum(["build", "help", "init"]).optional(),
+    },
+  ],
+});
+
+// Execute this function when the `help` subcommand is run
+helpCommandSchema.setAction(results => {
+  const [command] = results.arguments;
+  if (command) results.printSubcommandHelp(command);
+  else results.printCliHelp();
+});
+
+const results = safeParse(
+  process.argv.slice(2),
+  cliProgram,
+  helpCommandSchema,
+  // Add more subcommands
+);
+
+// ! Error
+if (!results.success) {
+  console.error(results.error.message);
+  console.log("\n`my-cli --help` for more information, or `my-cli help <command>` for command-specific help\n");
+  process.exit(1);
+}
+```
+
+## Types Utility
+
+```ts
+import { createSubcommand } from "zod-args-parser";
+import type { InferOptionsType, InferArgumentsType } from "zod-args-parser";
+
+const subcommand = createSubcommand({
+  name: "subcommand",
+  options: [
+    { name: "numberOption", type: z.coerce.number() },
+    { name: "stringOption", type: z.string() },
+    { name: "booleanOption", type: z.boolean() },
+    { name: "optionalOption", type: z.boolean().optional() },
+  ],
+  arguments: [
+    { name: "stringArgument", type: z.string() },
+    { name: "numberArgument", type: z.coerce.number() },
+    { name: "booleanArgument", type: z.boolean() },
+  ],
+});
+
+type Options = InferOptionsType<typeof subcommand>;
+// { numberOption: number; stringOption: string; booleanOption: boolean; optionalOption?: boolean | undefined; }
+
+type Arguments = InferArgumentsType<typeof subcommand>;
+// [string, number, boolean]
+```
+
+## API
+
+### `createSubcommand(input: Subcommand)`
+
+Defines a subcommand with associated options and arguments.
+
+- `name: string`  
+  The name of the subcommand.
+
+- `aliases?: string[]`  
+  An array of aliases for the subcommand.
+
+- `description?: string`  
+  A description of the subcommand for the help message.
+
+- `placeholder?: string`  
+  A placeholder displayed in the help message alongside the subcommand name.
+
+- `example?: string`  
+  An example of subcommand usage for the help message.
+
+- `allowPositional?: boolean`  
+  Allows positional arguments for this subcommand.  
+  Positional arguments are untyped (`string[]`) when enabled with the typed `arguments` any extra arguments, beyond the typed `arguments`, are parsed as positional and stored in the `positional` property.
+
+- `options?: Option[]`  
+  An array of options for the subcommand.
+
+  - `name: string`  
+    The name of the option. Should be a valid variable name in JavaScript.
+
+  - `aliases?: string[]`  
+    An array of aliases for the option.
+
+  - `type: ZodType`  
+    Specifies the type of the option using Zod.
+
+    **Examples:**
+
+    - `type: z.boolean().default(false);`
+    - `type: z.coerce.number(); // coerces value to a number`
+    - `type: z.preprocess(parseStringToArrFn, z.array(z.coerce.number())); // array of numbers`
+
+  - `description?: string`  
+    A description of the option for the help message.
+
+  - `placeholder?: string`  
+    Placeholder text for the option in the help message.
+
+  - `example?: string`  
+    An example of option usage for the help message.
+
+- `arguments?: Argument[]`  
+  An array of arguments for the subcommand.
+
+  - `name: string`  
+    The name of the argument for display in the help message.
+
+  - `type: ZodType`  
+    Specifies the type of the argument using Zod.
+
+    **Examples:**
+
+    - `type: z.boolean();`
+    - `type: z.coerce.number(); // coerces value to a number`
+
+  - `description?: string`  
+    A description of the argument for the help message.
+
+  - `example?: string`  
+    An example of argument usage for the help message.
+
+### Results
+
+- `subcommand: string | undefined`  
+  The name of the executed subcommand.  
+  If no subcommand is executed, this will be `undefined`.
+
+- `arguments?: any[]`  
+  An array representing defined arguments for the subcommand, e.g., `[string, number]`.  
+  Only defined if the subcommand has specified `arguments`.
+
+- `positional?: string[]`  
+  Contains positional arguments as `string[]` if `allowPositional` is enabled for the subcommand.
+
+- `printCliHelp(options?: PrintHelpOpt): void`  
+  Prints the CLI help message.  
+  Accepts an optional `options` object to disable colors or customize colors.
+
+- `printSubcommandHelp(subcommand: string, options?: PrintHelpOpt): void`  
+  Prints the help message for a specified subcommand.
+
+- `[key: optionName]: optionType`  
+   Represents options specified in the CLI or subcommand with their respective types.
+
+### `parse(args: string[], cli: Cli, ...subcommands: Subcommand[]): UnSafeParseResult`
+
+Parses the provided arguments and returns a `Results` object.  
+Throws an error if parsing fails.
+
+### `safeParse(args: string[], cli: Cli, ...subcommands: Subcommand[]): SafeParseResult`
+
+Parses the provided arguments and returns:
+
+```ts
+{ success: false, error: Error } | { success: true, data: ResultObj }
+```

package/lib/commonjs/help.js

@@ -0,0 +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};

package/lib/commonjs/help.js.map

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

package/lib/commonjs/index.js

@@ -0,0 +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;

package/lib/commonjs/index.js.map

@@ -0,0 +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":[]}

package/lib/commonjs/parser.js

@@ -0,0 +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};}}

package/lib/commonjs/parser.js.map

@@ -0,0 +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":[]}

package/lib/commonjs/types.js

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

package/lib/commonjs/types.js.map

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

package/lib/commonjs/utils.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.addIndentLn=addIndentLn;exports.concat=concat;exports.decoupleFlags=decoupleFlags;exports.getDefaultValueFromSchema=getDefaultValueFromSchema;exports.getOrdinalPlacement=getOrdinalPlacement;exports.indent=indent;exports.isBooleanSchema=isBooleanSchema;exports.isFlagArg=isFlagArg;exports.isOptionArg=isOptionArg;exports.ln=ln;exports.noName=noName;exports.print=print;exports.println=println;exports.stringToBoolean=stringToBoolean;exports.transformArg=transformArg;exports.transformOptionToArg=transformOptionToArg;var _nodeAssert=_interopRequireDefault(require("node:assert"));var _zod=require("zod");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}function transformArg(name){(0,_nodeAssert.default)(name.startsWith("-"),`[transformArg] Invalid arg name: ${name}`);name=name.startsWith("--")?name.substring(2):name.substring(1);return name.replace(/-([a-z])/g,g=>g[1].toUpperCase());}function transformOptionToArg(name){name=name.replace(/^[A-Z]/g,g=>g.toLowerCase());if(name.length===1)return`-${name}`;return`--${name.replace(/[A-Z]/g,g=>"-"+g.toLowerCase())}`;}function isFlagArg(name){return /^-[a-z]$/.test(name);}function isOptionArg(name){if(typeof name!=="string")return false;return isFlagArg(name)||name.startsWith("--");}function noName(name){if(name.length===1)return name;return"no"+name.replace(/^[a-z]/,g=>g.toUpperCase());}function stringToBoolean(str){if(str.toLowerCase()==="true")return true;if(str.toLowerCase()==="false")return false;throw new Error(`[stringToBoolean] Invalid boolean value: "${str}"; Expected "true" or "false"`);}function getOrdinalPlacement(index){if(index<0)return"";const suffixes=["th","st","nd","rd"];const lastDigit=index%10;const lastTwoDigits=index%100;const suffix=lastDigit===1&&lastTwoDigits!==11?suffixes[1]:lastDigit===2&&lastTwoDigits!==12?suffixes[2]:lastDigit===3&&lastTwoDigits!==13?suffixes[3]:suffixes[0];return`${index+1}${suffix}`;}function isBooleanSchema(schema){let type=schema;while(type){if(type instanceof _zod.z.ZodBoolean){return true;}if(type instanceof _zod.z.ZodLiteral){return type.value===true||type.value===false;}type=type._def.innerType;}return false;}function getDefaultValueFromSchema(schema){let type=schema;while(type){if(type instanceof _zod.z.ZodDefault){const defaultValue=type._def.defaultValue();return defaultValue;}type=type._def.innerType;}return undefined;}function decoupleFlags(args){const flagsRe=/^-[a-z]{2,}$/i;const result=[];for(let i=0;i<args.length;i++){const arg=args[i];const isCoupled=flagsRe.test(arg);if(!isCoupled){result.push(arg);continue;}const decoupledArr=arg.substring(1).split("").map(c=>"-"+c);result.push(...decoupledArr);}return result;}function print(){for(var _len=arguments.length,messages=new Array(_len),_key=0;_key<_len;_key++){messages[_key]=arguments[_key];}return process.stdout.write(messages.join(" "));}function println(){for(var _len2=arguments.length,messages=new Array(_len2),_key2=0;_key2<_len2;_key2++){messages[_key2]=arguments[_key2];}messages=messages.filter(Boolean);return console.log(...messages);}function ln(count){return"\n".repeat(count);}function indent(count){return" ".repeat(count);}function addIndentLn(message){let indent=arguments.length>1&&arguments[1]!==undefined?arguments[1]:"";return message.replace(/\n/g,`\n${indent}`);}function concat(){for(var _len3=arguments.length,messages=new Array(_len3),_key3=0;_key3<_len3;_key3++){messages[_key3]=arguments[_key3];}messages=messages.filter(Boolean);return messages.join(" ");}

package/lib/commonjs/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_nodeAssert","_interopRequireDefault","require","_zod","e","__esModule","default","transformArg","name","assert","startsWith","substring","replace","g","toUpperCase","transformOptionToArg","toLowerCase","length","isFlagArg","test","isOptionArg","noName","stringToBoolean","str","Error","getOrdinalPlacement","index","suffixes","lastDigit","lastTwoDigits","suffix","isBooleanSchema","schema","type","z","ZodBoolean","ZodLiteral","value","_def","innerType","getDefaultValueFromSchema","ZodDefault","defaultValue","undefined","decoupleFlags","args","flagsRe","result","i","arg","isCoupled","push","decoupledArr","split","map","c","print","_len","arguments","messages","Array","_key","process","stdout","write","join","println","_len2","_key2","filter","Boolean","console","log","ln","count","repeat","indent","addIndentLn","message","concat","_len3","_key3"],"sourceRoot":"../../src","sources":["utils.ts"],"sourcesContent":["import assert from \"node:assert\";\nimport { z } from \"zod\";\n\n/**\n * @param name - Should start with `'--'`\n * @returns - The transformed name E.g. `--input-dir` -> `InputDir`\n */\nexport function transformArg(name: string): string {\n  assert(name.startsWith(\"-\"), `[transformArg] Invalid arg name: ${name}`);\n  name = name.startsWith(\"--\") ? name.substring(2) : name.substring(1);\n  return name.replace(/-([a-z])/g, g => g[1].toUpperCase());\n}\n\n/** - Reverse of `transformArg`. E.g. `InputDir` -> `--input-dir` , `i` -> `-i` */\nexport function transformOptionToArg(name: string): string {\n  name = name.replace(/^[A-Z]/g, g => g.toLowerCase()); // first letter always lower case\n  if (name.length === 1) return `-${name}`;\n  return `--${name.replace(/[A-Z]/g, g => \"-\" + g.toLowerCase())}`;\n}\n\n/** - Check if an arg string is a short arg. E.g. `-i` -> `true` */\nexport function isFlagArg(name: string): boolean {\n  return /^-[a-z]$/.test(name);\n}\n\n/** - Check if an arg string is an options arg. E.g. `--input-dir` -> `true` , `-i` -> `true` */\nexport function isOptionArg(name: string | boolean): boolean {\n  if (typeof name !== \"string\") return false;\n  return isFlagArg(name) || name.startsWith(\"--\");\n}\n\n/**\n * - Transform option name to no name. E.g. `include` -> `noInclude`\n * - For short name like `-i` it will be ignored\n */\nexport function noName(name: string): string {\n  if (name.length === 1) return name;\n  return \"no\" + name.replace(/^[a-z]/, g => g.toUpperCase());\n}\n\n/** - Convert string to boolean. E.g. `\"true\"` -> `true` , `\"false\"` -> `false` */\nexport function stringToBoolean(str: string): boolean {\n  if (str.toLowerCase() === \"true\") return true;\n  if (str.toLowerCase() === \"false\") return false;\n  throw new Error(`[stringToBoolean] Invalid boolean value: \"${str}\"; Expected \"true\" or \"false\"`);\n}\n\nexport function getOrdinalPlacement(index: number): string {\n  if (index < 0) return \"\";\n\n  const suffixes = [\"th\", \"st\", \"nd\", \"rd\"];\n  const lastDigit = index % 10;\n  const lastTwoDigits = index % 100;\n\n  const suffix =\n    lastDigit === 1 && lastTwoDigits !== 11\n      ? suffixes[1]\n      : lastDigit === 2 && lastTwoDigits !== 12\n        ? suffixes[2]\n        : lastDigit === 3 && lastTwoDigits !== 13\n          ? suffixes[3]\n          : suffixes[0];\n\n  return `${index + 1}${suffix}`;\n}\n\n/** - Check if a schema is a boolean */\nexport function isBooleanSchema(schema: z.ZodTypeAny): boolean {\n  let type = schema;\n  while (type) {\n    if (type instanceof z.ZodBoolean) {\n      return true;\n    }\n\n    if (type instanceof z.ZodLiteral) {\n      return type.value === true || type.value === false;\n    }\n\n    type = type._def.innerType;\n  }\n\n  return false;\n}\n\nexport function getDefaultValueFromSchema(schema: z.ZodTypeAny): unknown | undefined {\n  let type = schema;\n  while (type) {\n    if (type instanceof z.ZodDefault) {\n      const defaultValue = type._def.defaultValue();\n      return defaultValue;\n    }\n\n    type = type._def.innerType;\n  }\n\n  return undefined;\n}\n\n/** - Decouple flags E.g. `-rf` -> `-r, -f` */\nexport function decoupleFlags(args: string[]): string[] {\n  const flagsRe = /^-[a-z]{2,}$/i;\n\n  const result = [];\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n    const isCoupled = flagsRe.test(arg);\n\n    if (!isCoupled) {\n      result.push(arg);\n      continue;\n    }\n\n    const decoupledArr = arg\n      .substring(1)\n      .split(\"\")\n      .map(c => \"-\" + c);\n\n    result.push(...decoupledArr);\n  }\n\n  return result;\n}\n\n/** Print */\nexport function print(...messages: string[]) {\n  return process.stdout.write(messages.join(\" \"));\n}\n\n/** Print line */\nexport function println(...messages: string[]) {\n  messages = messages.filter(Boolean);\n  return console.log(...messages);\n}\n\n/** New line */\nexport function ln(count: number) {\n  return \"\\n\".repeat(count);\n}\n\n/** Space */\nexport function indent(count: number) {\n  return \" \".repeat(count);\n}\n\n/** Add indent before each new line */\nexport function addIndentLn(message: string, indent: string = \"\") {\n  return message.replace(/\\n/g, `\\n${indent}`);\n}\n\n/** Concat strings */\nexport function concat(...messages: string[]) {\n  messages = messages.filter(Boolean);\n  return messages.join(\" \");\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/module/help.js

@@ -0,0 +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};

package/lib/module/help.js.map

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

package/lib/module/index.js

@@ -0,0 +1 @@
+import{help}from"./help.js";import{parse,safeParse}from"./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;export{createCli,createSubcommand,parse,printCliHelp,printSubcommandHelp,safeParse};

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["help","parse","safeParse","createSubcommand","input","Object","assign","setAction","action","createCli","printCliHelp","printSubcommandHelp"],"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":"AAAA,OAASA,IAAI,KAAQ,WAAW,CAChC,OAASC,KAAK,CAAEC,SAAS,KAAQ,aAAa,CAI9C,QAAS,CAAAC,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,CAAGX,IAAI,CAElD,OAASS,SAAS,CAAEN,gBAAgB,CAAEF,KAAK,CAAES,YAAY,CAAEC,mBAAmB,CAAET,SAAS","ignoreList":[]}

package/lib/module/parser.js

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