zod-args-parser 2.0.0-beta.3 → 2.0.0-beta.4

package/README.md

@@ -69,7 +69,7 @@ The following example uses `zod` as the validation library, but you can use any
 
 ```ts
 import * as z from "zod";
-import { defineCLI, coerce } from "zod-args-parser";
+import { defineCLI } from "zod-args-parser";
 
 const cli = defineCLI({
   cliName: "hello",
@@ -100,7 +100,9 @@ if (result.error) {
 
 ### Creating a subcommand
 
-Subcommands are defined using the `defineSubcommand` function, which accepts a [`Subcommand`](#subcommand) definition object.
+Subcommands are defined using the `defineSubcommand` function, which accepts a `Subcommand` definition object.
+
+See [Subcommand Definition](./docs/api-reference.md#subcommand).
 
 ```ts
 import { defineSubcommand, helpMessageStyles } from "zod-args-parser";
@@ -198,10 +200,16 @@ Options can be defined directly inside the CLI or subcommand definition. Or usin
 Option names can use any common case style:
 `camelCase`, `PascalCase`, `snake_case`, or `SCREAMING_SNAKE_CASE`.
 
-- ListName `=>` --list-name
-- list-name `=>` --list-name
-- listName `=>` --list-name
-- LIST_NAME `=>` --list-name
+| name        | as argument   |
+| ----------- | ------------- |
+| `listName`  | `--list-name` |
+| `ListName`  | `--list-name` |
+| `list_name` | `--list-name` |
+| `LIST_NAME` | `--list-name` |
+| `H`         | `-h`          |
+| `h`         | `-h`          |
+
+See [Option Definition](./docs/api-reference.md#option).
 
 ```ts
 import * as z from "zod";
@@ -290,6 +298,8 @@ The order of argument definitions matters.
 2. If `allowPositionals: false` → only the last typed argument may be optional.
 3. Argument names cannot be numeric, because it affects argument ordering.
 
+See [Argument Definition](./docs/api-reference.md#argument).
+
 ```ts
 import { defineSubcommand, coerce } from "zod-args-parser";
 
@@ -318,6 +328,8 @@ const createListCommand = defineSubcommand({
 
 Options and typed arguments can be shared between subcommands/main CLI.
 
+See [Option Definition](./docs/api-reference.md#option) and [Argument Definition](./docs/api-reference.md#argument).
+
 ```ts
 // shared.ts
 import * as z from "zod";

package/lib/esm/coerce/coerce-methods.js

@@ -1,4 +1,7 @@
 // src/coerce/coerce-methods.ts
+import { CliError } from "../cli-error/cli-error.js";
+import { ErrorCause } from "../cli-error/error-cause.js";
+import { ValidationErrorCode } from "../cli-error/error-code/validation-error-code.js";
 import { walkObject } from "../utilities/utilities.js";
 import { stringToBooleanArray, stringToNumberArray, stringToStringArray } from "./string-to-array.js";
 import { stringToBigint, stringToBoolean, stringToNumber } from "./string-to-primitive.js";
@@ -6,9 +9,19 @@ import { stringToBooleanSet, stringToNumberSet, stringToStringSet } from "./stri
 var string = (terminalInput) => terminalInput;
 var number = (terminalInput) => stringToNumber(terminalInput);
 var bigint = (terminalInput) => stringToBigint(terminalInput);
-var json = (terminalInput) => JSON.parse(terminalInput);
 var boolean = (terminalInput) => stringToBoolean(terminalInput);
 boolean.type = "boolean";
+var json = (terminalInput) => {
+  try {
+    return JSON.parse(terminalInput);
+  } catch {
+    throw new CliError({
+      cause: ErrorCause.Validation,
+      code: ValidationErrorCode.CoercionFailed,
+      context: { coerceToType: "json", providedValue: terminalInput }
+    });
+  }
+};
 var stringArray = (separator) => {
   return (terminalInput) => stringToStringArray(terminalInput, separator);
 };
@@ -29,7 +42,7 @@ var booleanSet = (separator) => {
 };
 var object = (options = {}) => {
   const coerceMethod = (terminalInput) => {
-    const object2 = JSON.parse(terminalInput);
+    const object2 = json(terminalInput);
     if (!options.coerceBoolean && !options.coerceNumber && !options.coerceBigint && !options.coerceDate) {
       return object2;
     }
@@ -114,7 +127,7 @@ var coerce = {
    * converted.
    *
    * @since 2.0.0
-   * @throws {SyntaxError} If input is not a valid JSON string.
+   * @throws {CliError} If input is not a valid JSON string.
    * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/README.md##structured-object-options}
    * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}
    */
@@ -186,7 +199,7 @@ var coerce = {
    * Parses a JSON string into a JavaScript object.
    *
    * @since 2.0.0
-   * @throws {SyntaxError} If input is not a valid JSON string.
+   * @throws {CliError} If input is not a valid JSON string.
    * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}
    */
   json

package/lib/esm/coerce/coerce-methods.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/coerce/coerce-methods.ts"],
-  "sourcesContent": ["import { walkObject } from \"../utilities/utilities.ts\";\nimport { stringToBooleanArray, stringToNumberArray, stringToStringArray } from \"./string-to-array.ts\";\nimport { stringToBigint, stringToBoolean, stringToNumber } from \"./string-to-primitive.ts\";\nimport { stringToBooleanSet, stringToNumberSet, stringToStringSet } from \"./string-to-set.ts\";\n\nimport type { ObjectCoerceMethodOptions } from \"../types/types.ts\";\n\nconst string = <T extends string | undefined>(terminalInput: string): T => terminalInput as T;\nconst number = <T extends number | undefined>(terminalInput: string): T => stringToNumber(terminalInput) as T;\nconst bigint = <T extends bigint | undefined>(terminalInput: string): T => stringToBigint(terminalInput) as T;\nconst json = <T>(terminalInput: string): T => JSON.parse(terminalInput) as T;\nconst boolean = <T extends boolean | undefined>(terminalInput: string): T => stringToBoolean(terminalInput) as T;\nboolean.type = \"boolean\";\n\nconst stringArray = (separator: string) => {\n  return <T extends string[] | undefined>(terminalInput: string): T =>\n    stringToStringArray(terminalInput, separator) as T;\n};\n\nconst numberArray = (separator: string) => {\n  return <T extends number[] | undefined>(terminalInput: string): T =>\n    stringToNumberArray(terminalInput, separator) as T;\n};\n\nconst booleanArray = (separator: string) => {\n  return <T extends boolean[] | undefined>(terminalInput: string): T =>\n    stringToBooleanArray(terminalInput, separator) as T;\n};\n\nconst stringSet = (separator: string) => {\n  return <T extends Set<string> | undefined>(terminalInput: string): T =>\n    stringToStringSet(terminalInput, separator) as T;\n};\n\nconst numberSet = (separator: string) => {\n  return <T extends Set<number> | undefined>(terminalInput: string): T =>\n    stringToNumberSet(terminalInput, separator) as T;\n};\n\nconst booleanSet = (separator: string) => {\n  return <T extends Set<boolean> | undefined>(terminalInput: string): T =>\n    stringToBooleanSet(terminalInput, separator) as T;\n};\n\nconst object = (options: ObjectCoerceMethodOptions = {}) => {\n  const coerceMethod = <T extends Record<string, unknown> | undefined>(terminalInput: string): T => {\n    const object = JSON.parse(terminalInput) as T;\n\n    if (!options.coerceBoolean && !options.coerceNumber && !options.coerceBigint && !options.coerceDate) {\n      return object;\n    }\n\n    walkObject(object!, (_, value, path) => {\n      if (typeof value !== \"string\") return value;\n\n      const shouldCoerce = (boolOrArray: boolean | string[] | undefined) => {\n        if (!boolOrArray) return false;\n        if (typeof boolOrArray === \"boolean\") return boolOrArray;\n        return boolOrArray.includes(path);\n      };\n\n      if (shouldCoerce(options.coerceBoolean)) {\n        try {\n          return stringToBoolean(value);\n        } catch {\n          return value;\n        }\n      }\n\n      if (shouldCoerce(options.coerceNumber)) {\n        try {\n          return stringToNumber(value);\n        } catch {\n          return value;\n        }\n      }\n\n      if (shouldCoerce(options.coerceBigint)) {\n        try {\n          return BigInt(value);\n        } catch {\n          return value;\n        }\n      }\n\n      if (shouldCoerce(options.coerceDate)) {\n        try {\n          return new Date(value);\n        } catch {\n          return value;\n        }\n      }\n\n      return value;\n    });\n\n    return object;\n  };\n\n  return coerceMethod;\n};\n\nexport const coerce = {\n  /**\n   * Since the terminal input is a string, this method does nothing.\n   *\n   * @since 2.0.0\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  string,\n\n  /**\n   * Coerces a string matching `\"true\"` or `\"false\"` (case-insensitive) to a boolean value.\n   *\n   * @since 2.0.0\n   * @throws {CliError} If input is not a valid boolean string.\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  boolean,\n\n  /**\n   * Coerces a string matching a number to a number value.\n   *\n   * @since 2.0.0\n   * @throws {CliError} If input is empty or not a valid number.\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  number,\n\n  /**\n   * Coerces a string matching a number to a bigint value.\n   *\n   * @since 2.0.0\n   * @throws {CliError} If input is empty or not a valid bigint.\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  bigint,\n\n  /**\n   * Coerces a JSON string into a JavaScript object, optionally converting certain string values into native types such\n   * as booleans, numbers, bigints, or dates.\n   *\n   * Each coercion option attempts conversion and silently falls back to the original string if the value cannot be\n   * converted.\n   *\n   * @since 2.0.0\n   * @throws {SyntaxError} If input is not a valid JSON string.\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/README.md##structured-object-options}\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  object,\n\n  /**\n   * Converts a string to an array of strings by splitting it on the specified separator.\n   *\n   * @since 2.0.0\n   * @param separator - The separator to use to split the string.`\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  stringArray,\n\n  /**\n   * Converts a string to an array of numbers by splitting it on the specified separator.\n   *\n   * Items that match the number regex will be converted to numbers.\n   *\n   * @since 2.0.0\n   * @param separator - The separator to use to split the string.`\n   * @throws {CliError} - When an item cannot be converted to a number\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  numberArray,\n\n  /**\n   * Converts a string to an array of booleans by splitting it on the specified separator.\n   *\n   * Items that match `\"true\"` or `\"false\"` (case-insensitive) will be converted to booleans.\n   *\n   * @since 2.0.0\n   * @param separator - The separator to use to split the string.`\n   * @throws {CliError} - When an item cannot be converted to a boolean\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  booleanArray,\n\n  /**\n   * Converts a string to a set of strings by splitting it on the specified separator.\n   *\n   * Items that match the number regex will be converted to numbers.\n   *\n   * @since 2.0.0\n   * @param separator - The separator to use to split the string.`\n   * @throws {CliError} - When an item cannot be converted to a number\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  stringSet,\n\n  /**\n   * Converts a string to a set of numbers by splitting it on the specified separator.\n   *\n   * Items that match the number regex will be converted to numbers.\n   *\n   * @since 2.0.0\n   * @param separator - The separator to use to split the string.\n   * @throws {CliError} - When an item cannot be converted to a number\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  numberSet,\n\n  /**\n   * Converts a string to a set of booleans by splitting it on the specified separator.\n   *\n   * Items that match `\"true\"` or `\"false\"` (case-insensitive) will be converted to booleans.\n   *\n   * @since 2.0.0\n   * @param separator - The separator to use to split the string.\n   * @throws {CliError} - When an item cannot be converted to a boolean\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  booleanSet,\n\n  /**\n   * Parses a JSON string into a JavaScript object.\n   *\n   * @since 2.0.0\n   * @throws {SyntaxError} If input is not a valid JSON string.\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  json,\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { CliError } from \"../cli-error/cli-error.ts\";\nimport { ErrorCause } from \"../cli-error/error-cause.ts\";\nimport { ValidationErrorCode } from \"../cli-error/error-code/validation-error-code.ts\";\nimport { walkObject } from \"../utilities/utilities.ts\";\nimport { stringToBooleanArray, stringToNumberArray, stringToStringArray } from \"./string-to-array.ts\";\nimport { stringToBigint, stringToBoolean, stringToNumber } from \"./string-to-primitive.ts\";\nimport { stringToBooleanSet, stringToNumberSet, stringToStringSet } from \"./string-to-set.ts\";\n\nimport type { ObjectCoerceMethodOptions } from \"../types/types.ts\";\n\nconst string = <T extends string | undefined>(terminalInput: string): T => terminalInput as T;\nconst number = <T extends number | undefined>(terminalInput: string): T => stringToNumber(terminalInput) as T;\nconst bigint = <T extends bigint | undefined>(terminalInput: string): T => stringToBigint(terminalInput) as T;\nconst boolean = <T extends boolean | undefined>(terminalInput: string): T => stringToBoolean(terminalInput) as T;\nboolean.type = \"boolean\";\n\nconst json = <T>(terminalInput: string): T => {\n  try {\n    return JSON.parse(terminalInput) as T;\n  } catch {\n    throw new CliError({\n      cause: ErrorCause.Validation,\n      code: ValidationErrorCode.CoercionFailed,\n      context: { coerceToType: \"json\", providedValue: terminalInput },\n    });\n  }\n};\n\nconst stringArray = (separator: string) => {\n  return <T extends string[] | undefined>(terminalInput: string): T =>\n    stringToStringArray(terminalInput, separator) as T;\n};\n\nconst numberArray = (separator: string) => {\n  return <T extends number[] | undefined>(terminalInput: string): T =>\n    stringToNumberArray(terminalInput, separator) as T;\n};\n\nconst booleanArray = (separator: string) => {\n  return <T extends boolean[] | undefined>(terminalInput: string): T =>\n    stringToBooleanArray(terminalInput, separator) as T;\n};\n\nconst stringSet = (separator: string) => {\n  return <T extends Set<string> | undefined>(terminalInput: string): T =>\n    stringToStringSet(terminalInput, separator) as T;\n};\n\nconst numberSet = (separator: string) => {\n  return <T extends Set<number> | undefined>(terminalInput: string): T =>\n    stringToNumberSet(terminalInput, separator) as T;\n};\n\nconst booleanSet = (separator: string) => {\n  return <T extends Set<boolean> | undefined>(terminalInput: string): T =>\n    stringToBooleanSet(terminalInput, separator) as T;\n};\n\nconst object = (options: ObjectCoerceMethodOptions = {}) => {\n  const coerceMethod = <T extends Record<string, unknown> | undefined>(terminalInput: string): T => {\n    const object = json<T>(terminalInput);\n\n    if (!options.coerceBoolean && !options.coerceNumber && !options.coerceBigint && !options.coerceDate) {\n      return object;\n    }\n\n    walkObject(object!, (_, value, path) => {\n      if (typeof value !== \"string\") return value;\n\n      const shouldCoerce = (boolOrArray: boolean | string[] | undefined) => {\n        if (!boolOrArray) return false;\n        if (typeof boolOrArray === \"boolean\") return boolOrArray;\n        return boolOrArray.includes(path);\n      };\n\n      if (shouldCoerce(options.coerceBoolean)) {\n        try {\n          return stringToBoolean(value);\n        } catch {\n          return value;\n        }\n      }\n\n      if (shouldCoerce(options.coerceNumber)) {\n        try {\n          return stringToNumber(value);\n        } catch {\n          return value;\n        }\n      }\n\n      if (shouldCoerce(options.coerceBigint)) {\n        try {\n          return BigInt(value);\n        } catch {\n          return value;\n        }\n      }\n\n      if (shouldCoerce(options.coerceDate)) {\n        try {\n          return new Date(value);\n        } catch {\n          return value;\n        }\n      }\n\n      return value;\n    });\n\n    return object;\n  };\n\n  return coerceMethod;\n};\n\nexport const coerce = {\n  /**\n   * Since the terminal input is a string, this method does nothing.\n   *\n   * @since 2.0.0\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  string,\n\n  /**\n   * Coerces a string matching `\"true\"` or `\"false\"` (case-insensitive) to a boolean value.\n   *\n   * @since 2.0.0\n   * @throws {CliError} If input is not a valid boolean string.\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  boolean,\n\n  /**\n   * Coerces a string matching a number to a number value.\n   *\n   * @since 2.0.0\n   * @throws {CliError} If input is empty or not a valid number.\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  number,\n\n  /**\n   * Coerces a string matching a number to a bigint value.\n   *\n   * @since 2.0.0\n   * @throws {CliError} If input is empty or not a valid bigint.\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  bigint,\n\n  /**\n   * Coerces a JSON string into a JavaScript object, optionally converting certain string values into native types such\n   * as booleans, numbers, bigints, or dates.\n   *\n   * Each coercion option attempts conversion and silently falls back to the original string if the value cannot be\n   * converted.\n   *\n   * @since 2.0.0\n   * @throws {CliError} If input is not a valid JSON string.\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/README.md##structured-object-options}\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  object,\n\n  /**\n   * Converts a string to an array of strings by splitting it on the specified separator.\n   *\n   * @since 2.0.0\n   * @param separator - The separator to use to split the string.`\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  stringArray,\n\n  /**\n   * Converts a string to an array of numbers by splitting it on the specified separator.\n   *\n   * Items that match the number regex will be converted to numbers.\n   *\n   * @since 2.0.0\n   * @param separator - The separator to use to split the string.`\n   * @throws {CliError} - When an item cannot be converted to a number\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  numberArray,\n\n  /**\n   * Converts a string to an array of booleans by splitting it on the specified separator.\n   *\n   * Items that match `\"true\"` or `\"false\"` (case-insensitive) will be converted to booleans.\n   *\n   * @since 2.0.0\n   * @param separator - The separator to use to split the string.`\n   * @throws {CliError} - When an item cannot be converted to a boolean\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  booleanArray,\n\n  /**\n   * Converts a string to a set of strings by splitting it on the specified separator.\n   *\n   * Items that match the number regex will be converted to numbers.\n   *\n   * @since 2.0.0\n   * @param separator - The separator to use to split the string.`\n   * @throws {CliError} - When an item cannot be converted to a number\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  stringSet,\n\n  /**\n   * Converts a string to a set of numbers by splitting it on the specified separator.\n   *\n   * Items that match the number regex will be converted to numbers.\n   *\n   * @since 2.0.0\n   * @param separator - The separator to use to split the string.\n   * @throws {CliError} - When an item cannot be converted to a number\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  numberSet,\n\n  /**\n   * Converts a string to a set of booleans by splitting it on the specified separator.\n   *\n   * Items that match `\"true\"` or `\"false\"` (case-insensitive) will be converted to booleans.\n   *\n   * @since 2.0.0\n   * @param separator - The separator to use to split the string.\n   * @throws {CliError} - When an item cannot be converted to a boolean\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  booleanSet,\n\n  /**\n   * Parses a JSON string into a JavaScript object.\n   *\n   * @since 2.0.0\n   * @throws {CliError} If input is not a valid JSON string.\n   * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}\n   */\n  json,\n};\n"],
+  "mappings": "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",
   "names": ["object"]
 }

package/lib/esm/definitions/define-cli.js

@@ -57,30 +57,38 @@ function defineCLI(input) {
     const validateResult = validate(context, cliDefinition);
     await Promise.all(handlers.map(async (handler) => await handler(validateResult)));
   };
-  const generateHelpMethods = {
-    generateCliHelpMessage(options) {
-      return generateCliHelpMessage(cliDefinition, options);
-    },
-    generateSubcommandHelpMessage(subcommandName, options) {
-      const foundSubcommand = cliDefinition.subcommands?.find((s) => s.name === subcommandName);
-      if (!foundSubcommand) {
-        throw new CliError({
-          cause: ErrorCause.Definition,
-          code: DefinitionErrorCode.SubcommandHelpNotFound,
-          context: { cliName: cliDefinition.cliName, subcommandName }
-        });
+  const attachHelpMethods = () => {
+    const generateHelpMethods = {
+      generateCliHelpMessage(options) {
+        return generateCliHelpMessage(cliDefinition, options);
+      },
+      generateSubcommandHelpMessage(subcommandName, options) {
+        const foundSubcommand = cliDefinition.subcommands?.find((s) => s.name === subcommandName);
+        if (!foundSubcommand) {
+          throw new CliError({
+            cause: ErrorCause.Definition,
+            code: DefinitionErrorCode.SubcommandHelpNotFound,
+            context: { cliName: cliDefinition.cliName, subcommandName }
+          });
+        }
+        return generateSubcommandHelpMessage(foundSubcommand, options, cliDefinition.cliName);
+      }
+    };
+    Object.assign(cliDefinition, generateHelpMethods);
+    if (cliDefinition.subcommands) {
+      for (const subcommandSchema of cliDefinition.subcommands) {
+        Object.assign(subcommandSchema, generateHelpMethods);
       }
-      return generateSubcommandHelpMessage(foundSubcommand, options, cliDefinition.cliName);
     }
   };
-  Object.assign(cliDefinition, generateHelpMethods);
-  if (cliDefinition.subcommands) {
-    for (const subcommandSchema of cliDefinition.subcommands) {
-      Object.assign(subcommandSchema, generateHelpMethods);
-    }
-  }
-  const run = (stringOrArgv) => safeParse(stringOrArgv, cliDefinition);
-  const runAsync = (stringOrArgv) => safeParseAsync(stringOrArgv, cliDefinition);
+  const run = (stringOrArgv) => {
+    attachHelpMethods();
+    return safeParse(stringOrArgv, cliDefinition);
+  };
+  const runAsync = (stringOrArgv) => {
+    attachHelpMethods();
+    return safeParseAsync(stringOrArgv, cliDefinition);
+  };
   return Object.assign(cliDefinition, { onExecute, execute, executeAsync, run, runAsync });
 }
 export {

package/lib/esm/definitions/define-cli.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/definitions/define-cli.ts"],
-  "sourcesContent": ["import { CliError } from \"../cli-error/cli-error.ts\";\nimport { ErrorCause } from \"../cli-error/error-cause.ts\";\nimport { DefinitionErrorCode } from \"../cli-error/error-code/definition-error-code.ts\";\nimport { generateCliHelpMessage } from \"../help-message/generate-for-cli.ts\";\nimport { generateSubcommandHelpMessage } from \"../help-message/generate-for-subcommand.ts\";\nimport { buildObjectContext } from \"../parse/context/object-context-builder.ts\";\nimport { safeParse, safeParseAsync } from \"../parse/safe-parse.ts\";\nimport { validate } from \"../parse/validation/validate-context.ts\";\nimport { prepareDefinitionTypes } from \"../utilities/schema-utilities.ts\";\n\nimport type { Argument, Cli, Option, Subcommand } from \"../types/definitions-types.ts\";\nimport type { PrintHelpOptions } from \"../types/help-message-types.ts\";\nimport type { AttachedMethods, AttachedMethodsWide, ValidateMethods } from \"../types/types.ts\";\nimport type { Prettify } from \"../types/utilities-types.ts\";\n\ntype OptionsInput<T> =\n  T extends Record<string, Option> ? { [OptionName in keyof T]: Option<T[OptionName][\"schema\"]> } : T;\n\ntype ArgumentsInput<T> =\n  T extends Record<string, Argument> ? { [ArgumentName in keyof T]: Argument<T[ArgumentName][\"schema\"]> } : T;\n\ntype SubcommandsInput<T extends readonly [Subcommand, ...Subcommand[]]> = {\n  [SubcommandIndex in keyof T]: {\n    [K in keyof T[SubcommandIndex]]: T[SubcommandIndex][K] extends Record<string, Option>\n      ? OptionsInput<T[SubcommandIndex][K]>\n      : T[SubcommandIndex][K] extends Record<string, Argument>\n        ? ArgumentsInput<T[SubcommandIndex][K]>\n        : T[SubcommandIndex][K];\n  } & Subcommand;\n};\n\n// This will prevent extra keys and enable jsdoc on hover\ntype CliInput<T extends Cli> = {\n  [K in keyof T]: K extends keyof Cli\n    ? T[K] extends readonly [Subcommand, ...Subcommand[]]\n      ? SubcommandsInput<T[K]>\n      : K extends \"options\"\n        ? OptionsInput<T[K]>\n        : K extends \"arguments\"\n          ? ArgumentsInput<T[K]>\n          : T[K]\n    : never;\n};\n\nexport function defineCLI<T extends Cli>(input: CliInput<T> & Cli) {\n  const cliDefinition = input as T;\n\n  prepareDefinitionTypes(cliDefinition.options);\n  prepareDefinitionTypes(cliDefinition.arguments);\n\n  if (cliDefinition.subcommands) {\n    for (const subcommand of Object.values(cliDefinition.subcommands)) {\n      prepareDefinitionTypes(subcommand.options);\n      prepareDefinitionTypes(subcommand.arguments);\n    }\n  }\n\n  const onExecute = (handler: (Cli[\"_onExecute\"] & {})[number]) => {\n    cliDefinition._onExecute ??= [];\n    cliDefinition._onExecute.push(handler);\n\n    return () => {\n      const handlerIndex = cliDefinition._onExecute?.indexOf(handler);\n      if (!handlerIndex || handlerIndex < 0) return;\n      cliDefinition._onExecute?.splice(handlerIndex, 1);\n    };\n  };\n\n  const execute: AttachedMethodsWide[\"execute\"] = inputValues => {\n    inputValues ??= {};\n\n    const handlers = cliDefinition._onExecute;\n    if (!handlers) {\n      throw new CliError({\n        cause: ErrorCause.Definition,\n        code: DefinitionErrorCode.MissingOnExecute,\n        context: { commandKind: \"command\", commandName: cliDefinition.cliName },\n      });\n    }\n\n    const context = buildObjectContext(inputValues, cliDefinition);\n    const validateResult = validate(context, cliDefinition);\n\n    for (const handler of handlers) {\n      void handler(validateResult);\n    }\n  };\n\n  const executeAsync: AttachedMethodsWide[\"executeAsync\"] = async inputValues => {\n    inputValues ??= {};\n\n    const handlers = cliDefinition._onExecute;\n\n    if (!handlers) {\n      throw new CliError({\n        cause: ErrorCause.Definition,\n        code: DefinitionErrorCode.MissingOnExecute,\n        context: { commandKind: \"command\", commandName: cliDefinition.cliName },\n      });\n    }\n\n    const context = buildObjectContext(inputValues, cliDefinition);\n    const validateResult = validate(context, cliDefinition);\n\n    await Promise.all(handlers.map(async handler => await handler(validateResult)));\n  };\n\n  // Add print methods for CLI schema and its subcommands\n  const generateHelpMethods: Pick<AttachedMethodsWide, \"generateCliHelpMessage\" | \"generateSubcommandHelpMessage\"> = {\n    generateCliHelpMessage(options?: PrintHelpOptions) {\n      return generateCliHelpMessage(cliDefinition, options);\n    },\n    generateSubcommandHelpMessage(subcommandName: string, options?: PrintHelpOptions) {\n      const foundSubcommand = cliDefinition.subcommands?.find(s => s.name === subcommandName);\n      if (!foundSubcommand) {\n        throw new CliError({\n          cause: ErrorCause.Definition,\n          code: DefinitionErrorCode.SubcommandHelpNotFound,\n          context: { cliName: cliDefinition.cliName, subcommandName },\n        });\n      }\n      return generateSubcommandHelpMessage(foundSubcommand, options, cliDefinition.cliName);\n    },\n  };\n\n  Object.assign(cliDefinition, generateHelpMethods);\n\n  if (cliDefinition.subcommands) {\n    for (const subcommandSchema of cliDefinition.subcommands) {\n      Object.assign(subcommandSchema, generateHelpMethods);\n    }\n  }\n\n  const run = (stringOrArgv: string | string[]) => safeParse(stringOrArgv, cliDefinition);\n  const runAsync = (stringOrArgv: string | string[]) => safeParseAsync(stringOrArgv, cliDefinition);\n\n  return Object.assign(cliDefinition, { onExecute, execute, executeAsync, run, runAsync }) as Prettify<\n    T & AttachedMethods<T> & ValidateMethods<T>\n  >;\n}\n"],
-  "mappings": ";AAAA,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAC3B,SAAS,2BAA2B;AACpC,SAAS,8BAA8B;AACvC,SAAS,qCAAqC;AAC9C,SAAS,0BAA0B;AACnC,SAAS,WAAW,sBAAsB;AAC1C,SAAS,gBAAgB;AACzB,SAAS,8BAA8B;AAoChC,SAAS,UAAyB,OAA0B;AACjE,QAAM,gBAAgB;AAEtB,yBAAuB,cAAc,OAAO;AAC5C,yBAAuB,cAAc,SAAS;AAE9C,MAAI,cAAc,aAAa;AAC7B,eAAW,cAAc,OAAO,OAAO,cAAc,WAAW,GAAG;AACjE,6BAAuB,WAAW,OAAO;AACzC,6BAAuB,WAAW,SAAS;AAAA,IAC7C;AAAA,EACF;AAEA,QAAM,YAAY,CAAC,YAA8C;AAC/D,kBAAc,eAAe,CAAC;AAC9B,kBAAc,WAAW,KAAK,OAAO;AAErC,WAAO,MAAM;AACX,YAAM,eAAe,cAAc,YAAY,QAAQ,OAAO;AAC9D,UAAI,CAAC,gBAAgB,eAAe,EAAG;AACvC,oBAAc,YAAY,OAAO,cAAc,CAAC;AAAA,IAClD;AAAA,EACF;AAEA,QAAM,UAA0C,iBAAe;AAC7D,oBAAgB,CAAC;AAEjB,UAAM,WAAW,cAAc;AAC/B,QAAI,CAAC,UAAU;AACb,YAAM,IAAI,SAAS;AAAA,QACjB,OAAO,WAAW;AAAA,QAClB,MAAM,oBAAoB;AAAA,QAC1B,SAAS,EAAE,aAAa,WAAW,aAAa,cAAc,QAAQ;AAAA,MACxE,CAAC;AAAA,IACH;AAEA,UAAM,UAAU,mBAAmB,aAAa,aAAa;AAC7D,UAAM,iBAAiB,SAAS,SAAS,aAAa;AAEtD,eAAW,WAAW,UAAU;AAC9B,WAAK,QAAQ,cAAc;AAAA,IAC7B;AAAA,EACF;AAEA,QAAM,eAAoD,OAAM,gBAAe;AAC7E,oBAAgB,CAAC;AAEjB,UAAM,WAAW,cAAc;AAE/B,QAAI,CAAC,UAAU;AACb,YAAM,IAAI,SAAS;AAAA,QACjB,OAAO,WAAW;AAAA,QAClB,MAAM,oBAAoB;AAAA,QAC1B,SAAS,EAAE,aAAa,WAAW,aAAa,cAAc,QAAQ;AAAA,MACxE,CAAC;AAAA,IACH;AAEA,UAAM,UAAU,mBAAmB,aAAa,aAAa;AAC7D,UAAM,iBAAiB,SAAS,SAAS,aAAa;AAEtD,UAAM,QAAQ,IAAI,SAAS,IAAI,OAAM,YAAW,MAAM,QAAQ,cAAc,CAAC,CAAC;AAAA,EAChF;AAGA,QAAM,sBAA6G;AAAA,IACjH,uBAAuB,SAA4B;AACjD,aAAO,uBAAuB,eAAe,OAAO;AAAA,IACtD;AAAA,IACA,8BAA8B,gBAAwB,SAA4B;AAChF,YAAM,kBAAkB,cAAc,aAAa,KAAK,OAAK,EAAE,SAAS,cAAc;AACtF,UAAI,CAAC,iBAAiB;AACpB,cAAM,IAAI,SAAS;AAAA,UACjB,OAAO,WAAW;AAAA,UAClB,MAAM,oBAAoB;AAAA,UAC1B,SAAS,EAAE,SAAS,cAAc,SAAS,eAAe;AAAA,QAC5D,CAAC;AAAA,MACH;AACA,aAAO,8BAA8B,iBAAiB,SAAS,cAAc,OAAO;AAAA,IACtF;AAAA,EACF;AAEA,SAAO,OAAO,eAAe,mBAAmB;AAEhD,MAAI,cAAc,aAAa;AAC7B,eAAW,oBAAoB,cAAc,aAAa;AACxD,aAAO,OAAO,kBAAkB,mBAAmB;AAAA,IACrD;AAAA,EACF;AAEA,QAAM,MAAM,CAAC,iBAAoC,UAAU,cAAc,aAAa;AACtF,QAAM,WAAW,CAAC,iBAAoC,eAAe,cAAc,aAAa;AAEhG,SAAO,OAAO,OAAO,eAAe,EAAE,WAAW,SAAS,cAAc,KAAK,SAAS,CAAC;AAGzF;",
+  "sourcesContent": ["import { CliError } from \"../cli-error/cli-error.ts\";\nimport { ErrorCause } from \"../cli-error/error-cause.ts\";\nimport { DefinitionErrorCode } from \"../cli-error/error-code/definition-error-code.ts\";\nimport { generateCliHelpMessage } from \"../help-message/generate-for-cli.ts\";\nimport { generateSubcommandHelpMessage } from \"../help-message/generate-for-subcommand.ts\";\nimport { buildObjectContext } from \"../parse/context/object-context-builder.ts\";\nimport { safeParse, safeParseAsync } from \"../parse/safe-parse.ts\";\nimport { validate } from \"../parse/validation/validate-context.ts\";\nimport { prepareDefinitionTypes } from \"../utilities/schema-utilities.ts\";\n\nimport type { Argument, Cli, Option, Subcommand } from \"../types/definitions-types.ts\";\nimport type { PrintHelpOptions } from \"../types/help-message-types.ts\";\nimport type { AttachedMethods, AttachedMethodsWide, ValidateMethods } from \"../types/types.ts\";\nimport type { Prettify } from \"../types/utilities-types.ts\";\n\ntype OptionsInput<T> =\n  T extends Record<string, Option> ? { [OptionName in keyof T]: Option<T[OptionName][\"schema\"]> } : T;\n\ntype ArgumentsInput<T> =\n  T extends Record<string, Argument> ? { [ArgumentName in keyof T]: Argument<T[ArgumentName][\"schema\"]> } : T;\n\ntype SubcommandsInput<T extends readonly [Subcommand, ...Subcommand[]]> = {\n  [SubcommandIndex in keyof T]: {\n    [K in keyof T[SubcommandIndex]]: T[SubcommandIndex][K] extends Record<string, Option>\n      ? OptionsInput<T[SubcommandIndex][K]>\n      : T[SubcommandIndex][K] extends Record<string, Argument>\n        ? ArgumentsInput<T[SubcommandIndex][K]>\n        : T[SubcommandIndex][K];\n  } & Subcommand;\n};\n\n// This will prevent extra keys and enable jsdoc on hover\ntype CliInput<T extends Cli> = {\n  [K in keyof T]: K extends keyof Cli\n    ? T[K] extends readonly [Subcommand, ...Subcommand[]]\n      ? SubcommandsInput<T[K]>\n      : K extends \"options\"\n        ? OptionsInput<T[K]>\n        : K extends \"arguments\"\n          ? ArgumentsInput<T[K]>\n          : T[K]\n    : never;\n};\n\nexport function defineCLI<T extends Cli>(input: CliInput<T> & Cli) {\n  const cliDefinition = input as T;\n\n  prepareDefinitionTypes(cliDefinition.options);\n  prepareDefinitionTypes(cliDefinition.arguments);\n\n  if (cliDefinition.subcommands) {\n    for (const subcommand of Object.values(cliDefinition.subcommands)) {\n      prepareDefinitionTypes(subcommand.options);\n      prepareDefinitionTypes(subcommand.arguments);\n    }\n  }\n\n  const onExecute = (handler: (Cli[\"_onExecute\"] & {})[number]) => {\n    cliDefinition._onExecute ??= [];\n    cliDefinition._onExecute.push(handler);\n\n    return () => {\n      const handlerIndex = cliDefinition._onExecute?.indexOf(handler);\n      if (!handlerIndex || handlerIndex < 0) return;\n      cliDefinition._onExecute?.splice(handlerIndex, 1);\n    };\n  };\n\n  const execute: AttachedMethodsWide[\"execute\"] = inputValues => {\n    inputValues ??= {};\n\n    const handlers = cliDefinition._onExecute;\n    if (!handlers) {\n      throw new CliError({\n        cause: ErrorCause.Definition,\n        code: DefinitionErrorCode.MissingOnExecute,\n        context: { commandKind: \"command\", commandName: cliDefinition.cliName },\n      });\n    }\n\n    const context = buildObjectContext(inputValues, cliDefinition);\n    const validateResult = validate(context, cliDefinition);\n\n    for (const handler of handlers) {\n      void handler(validateResult);\n    }\n  };\n\n  const executeAsync: AttachedMethodsWide[\"executeAsync\"] = async inputValues => {\n    inputValues ??= {};\n\n    const handlers = cliDefinition._onExecute;\n\n    if (!handlers) {\n      throw new CliError({\n        cause: ErrorCause.Definition,\n        code: DefinitionErrorCode.MissingOnExecute,\n        context: { commandKind: \"command\", commandName: cliDefinition.cliName },\n      });\n    }\n\n    const context = buildObjectContext(inputValues, cliDefinition);\n    const validateResult = validate(context, cliDefinition);\n\n    await Promise.all(handlers.map(async handler => await handler(validateResult)));\n  };\n\n  const attachHelpMethods = () => {\n    // Add print methods for CLI schema and its subcommands\n    const generateHelpMethods: Pick<AttachedMethodsWide, \"generateCliHelpMessage\" | \"generateSubcommandHelpMessage\"> = {\n      generateCliHelpMessage(options?: PrintHelpOptions) {\n        return generateCliHelpMessage(cliDefinition, options);\n      },\n      generateSubcommandHelpMessage(subcommandName: string, options?: PrintHelpOptions) {\n        const foundSubcommand = cliDefinition.subcommands?.find(s => s.name === subcommandName);\n        if (!foundSubcommand) {\n          throw new CliError({\n            cause: ErrorCause.Definition,\n            code: DefinitionErrorCode.SubcommandHelpNotFound,\n            context: { cliName: cliDefinition.cliName, subcommandName },\n          });\n        }\n        return generateSubcommandHelpMessage(foundSubcommand, options, cliDefinition.cliName);\n      },\n    };\n\n    Object.assign(cliDefinition, generateHelpMethods);\n\n    if (cliDefinition.subcommands) {\n      for (const subcommandSchema of cliDefinition.subcommands) {\n        Object.assign(subcommandSchema, generateHelpMethods);\n      }\n    }\n  };\n\n  const run = (stringOrArgv: string | string[]) => {\n    attachHelpMethods();\n    return safeParse(stringOrArgv, cliDefinition);\n  };\n\n  const runAsync = (stringOrArgv: string | string[]) => {\n    attachHelpMethods();\n    return safeParseAsync(stringOrArgv, cliDefinition);\n  };\n\n  return Object.assign(cliDefinition, { onExecute, execute, executeAsync, run, runAsync }) as Prettify<\n    T & AttachedMethods<T> & ValidateMethods<T>\n  >;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/lib/esm/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts"],
-  "sourcesContent": ["export { generateCliHelpMessage } from \"./help-message/generate-for-cli.ts\";\nexport { generateSubcommandHelpMessage } from \"./help-message/generate-for-subcommand.ts\";\nexport { printCliHelp, printSubcommandHelp } from \"./help-message/print-help.ts\";\nexport { HelpMessageStyle, helpMessageStyles } from \"./help-message/styles.ts\";\n\nexport { generateBashAutocompleteScript } from \"./autocomplete-scripts/bash-autocomplete-script.ts\";\nexport { generatePowerShellAutocompleteScript } from \"./autocomplete-scripts/powershell-autocomplete-script.ts\";\nexport { generateZshAutocompleteScript } from \"./autocomplete-scripts/zsh-autocomplete-script.ts\";\nexport { generateMarkdown } from \"./markdown/generate-markdown.ts\";\n\nexport { getArgumentsMetadata } from \"./metadata/arguments-metadata.ts\";\nexport { getCliMetadata } from \"./metadata/cli-metadata.ts\";\nexport { getOptionsMetadata } from \"./metadata/options-metadata.ts\";\nexport { getSubcommandsMetadata } from \"./metadata/subcommands-metadata.ts\";\n\nexport { defineArguments } from \"./definitions/define-arguments.ts\";\nexport { defineCLI } from \"./definitions/define-cli.ts\";\nexport { defineOptions } from \"./definitions/define-options.ts\";\nexport { defineSubcommand } from \"./definitions/define-subcommand.ts\";\n\nexport { coerce } from \"./coerce/coerce-methods.ts\";\n\nexport { CliError } from \"./cli-error/cli-error.ts\";\nexport { ErrorCause } from \"./cli-error/error-cause.ts\";\nexport { DefinitionErrorCode } from \"./cli-error/error-code/definition-error-code.ts\";\nexport { InternalErrorCode } from \"./cli-error/error-code/internal-error-code.ts\";\nexport { ParseErrorCode } from \"./cli-error/error-code/parse-error-code.ts\";\nexport { ValidationErrorCode } from \"./cli-error/error-code/validation-error-code.ts\";\n\nexport type * from \"./types/context-types.ts\";\nexport type * from \"./types/definitions-types.ts\";\nexport type {\n  CliErrorI,\n  CliErrorOptionUnion,\n  DefinitionErrorI,\n  ErrorCauseI,\n  InternalErrorI,\n  ParseErrorI,\n  ValidationErrorI,\n} from \"./types/error-types.ts\";\nexport type * from \"./types/help-message-types.ts\";\nexport type * from \"./types/io-types.ts\";\nexport type * from \"./types/metadata-types.ts\";\nexport type * from \"./types/types.ts\";\n"],
+  "sourcesContent": ["export { generateCliHelpMessage } from \"./help-message/generate-for-cli.ts\";\nexport { generateSubcommandHelpMessage } from \"./help-message/generate-for-subcommand.ts\";\nexport { printCliHelp, printSubcommandHelp } from \"./help-message/print-help.ts\";\nexport { HelpMessageStyle, helpMessageStyles } from \"./help-message/styles.ts\";\n\nexport { generateBashAutocompleteScript } from \"./autocomplete-scripts/bash-autocomplete-script.ts\";\nexport { generatePowerShellAutocompleteScript } from \"./autocomplete-scripts/powershell-autocomplete-script.ts\";\nexport { generateZshAutocompleteScript } from \"./autocomplete-scripts/zsh-autocomplete-script.ts\";\nexport { generateMarkdown } from \"./markdown/generate-markdown.ts\";\n\nexport { getArgumentsMetadata } from \"./metadata/arguments-metadata.ts\";\nexport { getCliMetadata } from \"./metadata/cli-metadata.ts\";\nexport { getOptionsMetadata } from \"./metadata/options-metadata.ts\";\nexport { getSubcommandsMetadata } from \"./metadata/subcommands-metadata.ts\";\n\nexport { defineArguments } from \"./definitions/define-arguments.ts\";\nexport { defineCLI } from \"./definitions/define-cli.ts\";\nexport { defineOptions } from \"./definitions/define-options.ts\";\nexport { defineSubcommand } from \"./definitions/define-subcommand.ts\";\n\nexport { coerce } from \"./coerce/coerce-methods.ts\";\n\nexport { CliError } from \"./cli-error/cli-error.ts\";\nexport { ErrorCause } from \"./cli-error/error-cause.ts\";\nexport { DefinitionErrorCode } from \"./cli-error/error-code/definition-error-code.ts\";\nexport { InternalErrorCode } from \"./cli-error/error-code/internal-error-code.ts\";\nexport { ParseErrorCode } from \"./cli-error/error-code/parse-error-code.ts\";\nexport { ValidationErrorCode } from \"./cli-error/error-code/validation-error-code.ts\";\n\nexport type * from \"./types/context-types.ts\";\nexport type * from \"./types/definitions-types.ts\";\nexport type {\n  CliErrorI,\n  CliErrorOptionUnion,\n  DefinitionErrorI,\n  ErrorCauseI,\n  InternalErrorI,\n  ParseErrorI,\n  ValidationErrorI,\n} from \"./types/error-types.ts\";\nexport type * from \"./types/help-message-types.ts\";\nexport type * from \"./types/io-types.ts\";\nexport type * from \"./types/metadata-types.ts\";\nexport type * from \"./types/schema-types.ts\";\nexport type * from \"./types/types.ts\";\n"],
   "mappings": ";AAAA,SAAS,8BAA8B;AACvC,SAAS,qCAAqC;AAC9C,SAAS,cAAc,2BAA2B;AAClD,SAAS,kBAAkB,yBAAyB;AAEpD,SAAS,sCAAsC;AAC/C,SAAS,4CAA4C;AACrD,SAAS,qCAAqC;AAC9C,SAAS,wBAAwB;AAEjC,SAAS,4BAA4B;AACrC,SAAS,sBAAsB;AAC/B,SAAS,0BAA0B;AACnC,SAAS,8BAA8B;AAEvC,SAAS,uBAAuB;AAChC,SAAS,iBAAiB;AAC1B,SAAS,qBAAqB;AAC9B,SAAS,wBAAwB;AAEjC,SAAS,cAAc;AAEvB,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAC3B,SAAS,2BAA2B;AACpC,SAAS,yBAAyB;AAClC,SAAS,sBAAsB;AAC/B,SAAS,2BAA2B;",
   "names": []
 }

package/lib/esm/parse/context/cli-context-builder.js

@@ -3,6 +3,7 @@ import { CliError } from "../../cli-error/cli-error.js";
 import { ErrorCause } from "../../cli-error/error-cause.js";
 import { InternalErrorCode } from "../../cli-error/error-code/internal-error-code.js";
 import { ParseErrorCode } from "../../cli-error/error-code/parse-error-code.js";
+import { coerce } from "../../coerce/coerce-methods.js";
 import {
   decoupleFlags,
   findOption,
@@ -115,7 +116,7 @@ function buildCliContext(argv, cliDefinition) {
       }
       context.options ??= {};
       if (optionWithKeys) {
-        const previousObject = JSON.parse(context.options[optionName]?.stringValue || "{}");
+        const previousObject = coerce.json(context.options[optionName]?.stringValue || "{}");
         let current = previousObject;
         for (let index2 = 0; index2 < keys.length; index2++) {
           const key = keys[index2];

package/lib/esm/parse/context/cli-context-builder.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/parse/context/cli-context-builder.ts"],
-  "sourcesContent": ["import { CliError } from \"../../cli-error/cli-error.ts\";\nimport { ErrorCause } from \"../../cli-error/error-cause.ts\";\nimport { InternalErrorCode } from \"../../cli-error/error-code/internal-error-code.ts\";\nimport { ParseErrorCode } from \"../../cli-error/error-code/parse-error-code.ts\";\nimport {\n  decoupleFlags,\n  findOption,\n  findSubcommandDefinition,\n  isFlagArgument,\n  isOptionArgument,\n  splitAndGetKeys,\n} from \"../parser-utilities.ts\";\n\nimport type { ContextWide } from \"../../types/context-types.ts\";\nimport type { Cli } from \"../../types/definitions-types.ts\";\n\n/**\n * Parse argv and create a cli context\n *\n * @throws {CliError}\n */\nexport function buildCliContext(argv: string[], cliDefinition: Cli) {\n  const cliName = cliDefinition.cliName;\n  const subcommandArray = cliDefinition.subcommands ?? [];\n  const allSubcommands = new Set<string>(subcommandArray.flatMap(c => [c.name, ...(c.aliases || [])]));\n\n  // decouple flags E.g. `-rf` -> `-r, -f`\n  argv = decoupleFlags(argv);\n\n  const context: ContextWide = {\n    subcommand: undefined,\n  };\n\n  /** Get the current subcommand definition or cli definition if subcommand name is `undefined` object */\n  const getCommandDefinition = () => findSubcommandDefinition(context.subcommand, cliDefinition);\n\n  for (let index = 0; index < argv.length; index++) {\n    const argvItem = argv[index];\n\n    // * Subcommand check\n    if (index === 0) {\n      context.subcommand = allSubcommands.has(argvItem) ? argvItem : undefined;\n\n      // First argument is a subcommand. Skip to the next argument\n      if (context.subcommand) continue;\n    }\n\n    // * Option check\n\n    const argumentAndValue = argvItem.split(\"=\").filter(Boolean); // E.g --option=value -> [\"--option\", \"value\"]\n    const argumentWithEquals = argvItem.includes(\"=\"); // E.g --option=value\n    const [argument, keys] = splitAndGetKeys(argumentAndValue[0]); // E.g --option.foo.bar -> [\"--option\", [\"foo\", \"bar\"]]\n    const optionWithKeys = keys.length > 0; // E.g --option.foo.bar\n    const argumentValue: string | undefined = argumentAndValue[1];\n    const isNegated = argument.startsWith(\"--no-\");\n\n    if (isOptionArgument(argument)) {\n      const commandDefinition = getCommandDefinition();\n      const commandKind = context.subcommand === undefined ? \"command\" : \"subcommand\";\n      const commandName = context.subcommand ?? cliName;\n\n      if (isFlagArgument(argument) && argumentWithEquals) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.FlagAssignedValue,\n          context: { commandKind, commandName, flag: argument, value: argumentValue },\n        });\n      }\n\n      if (!commandDefinition) {\n        if (context.subcommand === undefined) {\n          throw new CliError({\n            cause: ErrorCause.Internal,\n            code: InternalErrorCode.CannotFindCliDefinition,\n            context: { cliName },\n          });\n        }\n\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.UnknownSubcommand,\n          context: { commandName },\n        });\n      }\n\n      if (!commandDefinition.options) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.CommandWithoutOptions,\n          context: { commandKind, commandName, optionName: argument },\n        });\n      }\n\n      const nameOptionTuple = findOption(argument, commandDefinition.options);\n      if (!nameOptionTuple) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.UnknownOption,\n          context: { commandKind, commandName, optionName: argument },\n        });\n      }\n\n      const [optionName, optionDefinition] = nameOptionTuple;\n\n      if (!optionWithKeys && context.options && optionName in context.options) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.DuplicateOptionProvided,\n          context: { commandKind, commandName, optionName },\n        });\n      }\n\n      if (!optionDefinition._preparedType) {\n        throw new CliError({\n          cause: ErrorCause.Internal,\n          code: InternalErrorCode.MissingPreparedTypes,\n          context: { commandKind, commandName, kind: \"option\", name: optionName },\n        });\n      }\n\n      const { schema, optional, defaultValue, coerceTo } = optionDefinition._preparedType;\n\n      const nextArgument = argv[index + 1];\n\n      let optionValue: string | boolean | undefined = argumentWithEquals ? argumentValue : nextArgument;\n\n      const isBoolean = coerceTo === \"boolean\";\n\n      if (isNegated && !isBoolean) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.InvalidNegationForNonBooleanOption,\n          context: { commandKind, commandName, optionName },\n        });\n      }\n\n      // infer value for boolean options\n      if (isBoolean) {\n        if (!argumentWithEquals) {\n          optionValue = \"true\";\n        }\n\n        if (isNegated && [\"true\", \"false\"].includes(optionValue.toLowerCase())) {\n          optionValue = optionValue === \"true\" ? \"false\" : \"true\";\n        }\n      }\n\n      if (optionValue === undefined || (!argumentWithEquals && isOptionArgument(optionValue))) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.OptionMissingValue,\n          context: { commandKind, commandName, optionName },\n        });\n      }\n\n      context.options ??= {};\n\n      // Handle options with keys for type `object`\n      // E.g. `--option.key.nested=value`\n      if (optionWithKeys) {\n        const previousObject = JSON.parse(context.options[optionName]?.stringValue || \"{}\") as Record<string, any>;\n\n        let current = previousObject;\n        for (let index = 0; index < keys.length; index++) {\n          const key = keys[index];\n\n          if (current[key] === undefined) {\n            current[key] = {};\n          }\n\n          if (index === keys.length - 1) {\n            current[key] = optionValue;\n            continue;\n          }\n\n          current = current[key] as Record<string, any>;\n        }\n\n        optionValue = JSON.stringify(previousObject);\n      }\n\n      context.options[optionName] = {\n        schema,\n        optional,\n        defaultValue,\n        flag: argument,\n        stringValue: optionValue,\n        source: \"terminal\",\n      };\n\n      // Skip to the next argument if it is the current option's value.\n      if (!argumentWithEquals && !isBoolean) {\n        index++;\n      }\n\n      continue;\n    }\n\n    const commandDefinition = getCommandDefinition();\n\n    // * Arguments check\n    if (commandDefinition?.arguments) {\n      context.arguments ??= {};\n\n      const currentArgumentCount = Object.keys(context.arguments).length;\n      const argumentDefinitionEntries = Object.entries(commandDefinition.arguments);\n\n      // The current argument is a typed argument and not a positional\n      if (currentArgumentCount < argumentDefinitionEntries.length) {\n        const [name, argumentDefinition] = argumentDefinitionEntries[currentArgumentCount];\n\n        if (!argumentDefinition._preparedType) {\n          throw new CliError({\n            cause: ErrorCause.Internal,\n            code: InternalErrorCode.MissingPreparedTypes,\n            context: {\n              commandKind: context.subcommand ? \"subcommand\" : \"command\",\n              commandName: context.subcommand ?? cliName,\n              kind: \"argument\",\n              name,\n            },\n          });\n        }\n\n        const { schema, optional, defaultValue } = argumentDefinition._preparedType;\n\n        context.arguments[name] = { schema, optional, defaultValue, stringValue: argvItem, source: \"terminal\" };\n        continue;\n      }\n    }\n\n    // The current argument is a positional and not a typed argument (when `allowPositionals` is enabled)\n    if (commandDefinition?.allowPositionals) {\n      context.positionals ??= [];\n      context.positionals.push(argvItem);\n      continue;\n    }\n\n    throw new CliError({\n      cause: ErrorCause.Parse,\n      code: ParseErrorCode.PositionalArgumentNotAllowed,\n      context: {\n        commandKind: context.subcommand ? \"subcommand\" : \"command\",\n        commandName: context.subcommand ?? cliName,\n        argumentName: argvItem,\n      },\n    });\n  }\n\n  const commandDefinition = getCommandDefinition();\n  if (!commandDefinition) {\n    if (context.subcommand === undefined) {\n      throw new CliError({\n        cause: ErrorCause.Internal,\n        code: InternalErrorCode.CannotFindCliDefinition,\n        context: { cliName },\n      });\n    }\n\n    throw new CliError({\n      cause: ErrorCause.Parse,\n      code: ParseErrorCode.UnknownSubcommand,\n      context: { commandName: context.subcommand ?? cliName },\n    });\n  }\n\n  // Options\n  if (commandDefinition.options) {\n    context.options ??= {};\n\n    for (const [name, optionDefinition] of Object.entries(commandDefinition.options)) {\n      // option already added to the context (found during argument parsing)\n      if (name in context.options) continue;\n\n      if (!optionDefinition._preparedType) {\n        throw new CliError({\n          cause: ErrorCause.Internal,\n          code: InternalErrorCode.MissingPreparedTypes,\n          context: {\n            commandKind: context.subcommand ? \"subcommand\" : \"command\",\n            commandName: context.subcommand ?? cliName,\n            kind: \"option\",\n            name,\n          },\n        });\n      }\n\n      const { schema, optional, defaultValue } = optionDefinition._preparedType;\n\n      if (optional) {\n        // optional without default value\n        if (defaultValue === undefined) {\n          continue;\n        }\n\n        // optional with default value\n        context.options[name] = { schema, optional, defaultValue, source: \"default\" };\n        continue;\n      }\n\n      throw new CliError({\n        cause: ErrorCause.Parse,\n        code: ParseErrorCode.MissingRequiredOption,\n        context: {\n          commandKind: context.subcommand ? \"subcommand\" : \"command\",\n          commandName: context.subcommand ?? cliName,\n          optionName: name,\n        },\n      });\n    }\n  }\n\n  // Arguments\n  if (commandDefinition.arguments) {\n    context.arguments ??= {};\n\n    const currentArgumentCount = Object.keys(context.arguments).length;\n\n    const argumentDefinitionEntries = Object.entries(commandDefinition.arguments);\n    const argumentsDefinitionLength = argumentDefinitionEntries.length;\n\n    // missing arguments\n    if (currentArgumentCount < argumentsDefinitionLength) {\n      for (let index = currentArgumentCount; index < argumentsDefinitionLength; index++) {\n        const [name, argumentDefinition] = argumentDefinitionEntries[index];\n\n        if (!argumentDefinition._preparedType) {\n          throw new CliError({\n            cause: ErrorCause.Internal,\n            code: InternalErrorCode.MissingPreparedTypes,\n            context: {\n              commandKind: context.subcommand ? \"subcommand\" : \"command\",\n              commandName: context.subcommand ?? cliName,\n              kind: \"argument\",\n              name,\n            },\n          });\n        }\n\n        const { schema, optional, defaultValue } = argumentDefinition._preparedType;\n\n        if (optional) {\n          // optional argument without default value\n          if (defaultValue === undefined) {\n            continue;\n          }\n\n          // optional argument with default value\n          context.arguments[name] = { schema, optional, defaultValue, source: \"default\" };\n          continue;\n        }\n\n        // required argument\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.MissingRequiredArgument,\n          context: {\n            commandKind: context.subcommand ? \"subcommand\" : \"command\",\n            commandName: context.subcommand ?? cliName,\n            argumentName: name,\n          },\n        });\n      }\n    }\n  }\n\n  // make sure `positionals` is defined when `allowPositionals` is enabled\n  if (commandDefinition.allowPositionals) {\n    context.positionals ??= [];\n  }\n\n  return context;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { CliError } from \"../../cli-error/cli-error.ts\";\nimport { ErrorCause } from \"../../cli-error/error-cause.ts\";\nimport { InternalErrorCode } from \"../../cli-error/error-code/internal-error-code.ts\";\nimport { ParseErrorCode } from \"../../cli-error/error-code/parse-error-code.ts\";\nimport { coerce } from \"../../coerce/coerce-methods.ts\";\nimport {\n  decoupleFlags,\n  findOption,\n  findSubcommandDefinition,\n  isFlagArgument,\n  isOptionArgument,\n  splitAndGetKeys,\n} from \"../parser-utilities.ts\";\n\nimport type { ContextWide } from \"../../types/context-types.ts\";\nimport type { Cli } from \"../../types/definitions-types.ts\";\n\n/**\n * Parse argv and create a cli context\n *\n * @throws {CliError}\n */\nexport function buildCliContext(argv: string[], cliDefinition: Cli) {\n  const cliName = cliDefinition.cliName;\n  const subcommandArray = cliDefinition.subcommands ?? [];\n  const allSubcommands = new Set<string>(subcommandArray.flatMap(c => [c.name, ...(c.aliases || [])]));\n\n  // decouple flags E.g. `-rf` -> `-r, -f`\n  argv = decoupleFlags(argv);\n\n  const context: ContextWide = {\n    subcommand: undefined,\n  };\n\n  /** Get the current subcommand definition or cli definition if subcommand name is `undefined` object */\n  const getCommandDefinition = () => findSubcommandDefinition(context.subcommand, cliDefinition);\n\n  for (let index = 0; index < argv.length; index++) {\n    const argvItem = argv[index];\n\n    // * Subcommand check\n    if (index === 0) {\n      context.subcommand = allSubcommands.has(argvItem) ? argvItem : undefined;\n\n      // First argument is a subcommand. Skip to the next argument\n      if (context.subcommand) continue;\n    }\n\n    // * Option check\n\n    const argumentAndValue = argvItem.split(\"=\").filter(Boolean); // E.g --option=value -> [\"--option\", \"value\"]\n    const argumentWithEquals = argvItem.includes(\"=\"); // E.g --option=value\n    const [argument, keys] = splitAndGetKeys(argumentAndValue[0]); // E.g --option.foo.bar -> [\"--option\", [\"foo\", \"bar\"]]\n    const optionWithKeys = keys.length > 0; // E.g --option.foo.bar\n    const argumentValue: string | undefined = argumentAndValue[1];\n    const isNegated = argument.startsWith(\"--no-\");\n\n    if (isOptionArgument(argument)) {\n      const commandDefinition = getCommandDefinition();\n      const commandKind = context.subcommand === undefined ? \"command\" : \"subcommand\";\n      const commandName = context.subcommand ?? cliName;\n\n      if (isFlagArgument(argument) && argumentWithEquals) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.FlagAssignedValue,\n          context: { commandKind, commandName, flag: argument, value: argumentValue },\n        });\n      }\n\n      if (!commandDefinition) {\n        if (context.subcommand === undefined) {\n          throw new CliError({\n            cause: ErrorCause.Internal,\n            code: InternalErrorCode.CannotFindCliDefinition,\n            context: { cliName },\n          });\n        }\n\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.UnknownSubcommand,\n          context: { commandName },\n        });\n      }\n\n      if (!commandDefinition.options) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.CommandWithoutOptions,\n          context: { commandKind, commandName, optionName: argument },\n        });\n      }\n\n      const nameOptionTuple = findOption(argument, commandDefinition.options);\n      if (!nameOptionTuple) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.UnknownOption,\n          context: { commandKind, commandName, optionName: argument },\n        });\n      }\n\n      const [optionName, optionDefinition] = nameOptionTuple;\n\n      if (!optionWithKeys && context.options && optionName in context.options) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.DuplicateOptionProvided,\n          context: { commandKind, commandName, optionName },\n        });\n      }\n\n      if (!optionDefinition._preparedType) {\n        throw new CliError({\n          cause: ErrorCause.Internal,\n          code: InternalErrorCode.MissingPreparedTypes,\n          context: { commandKind, commandName, kind: \"option\", name: optionName },\n        });\n      }\n\n      const { schema, optional, defaultValue, coerceTo } = optionDefinition._preparedType;\n\n      const nextArgument = argv[index + 1];\n\n      let optionValue: string | boolean | undefined = argumentWithEquals ? argumentValue : nextArgument;\n\n      const isBoolean = coerceTo === \"boolean\";\n\n      if (isNegated && !isBoolean) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.InvalidNegationForNonBooleanOption,\n          context: { commandKind, commandName, optionName },\n        });\n      }\n\n      // infer value for boolean options\n      if (isBoolean) {\n        if (!argumentWithEquals) {\n          optionValue = \"true\";\n        }\n\n        if (isNegated && [\"true\", \"false\"].includes(optionValue.toLowerCase())) {\n          optionValue = optionValue === \"true\" ? \"false\" : \"true\";\n        }\n      }\n\n      if (optionValue === undefined || (!argumentWithEquals && isOptionArgument(optionValue))) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.OptionMissingValue,\n          context: { commandKind, commandName, optionName },\n        });\n      }\n\n      context.options ??= {};\n\n      // Handle options with keys for type `object`\n      // E.g. `--option.key.nested=value`\n      if (optionWithKeys) {\n        const previousObject = coerce.json<Record<string, any>>(context.options[optionName]?.stringValue || \"{}\");\n\n        let current = previousObject;\n        for (let index = 0; index < keys.length; index++) {\n          const key = keys[index];\n\n          if (current[key] === undefined) {\n            current[key] = {};\n          }\n\n          if (index === keys.length - 1) {\n            current[key] = optionValue;\n            continue;\n          }\n\n          current = current[key] as Record<string, any>;\n        }\n\n        optionValue = JSON.stringify(previousObject);\n      }\n\n      context.options[optionName] = {\n        schema,\n        optional,\n        defaultValue,\n        flag: argument,\n        stringValue: optionValue,\n        source: \"terminal\",\n      };\n\n      // Skip to the next argument if it is the current option's value.\n      if (!argumentWithEquals && !isBoolean) {\n        index++;\n      }\n\n      continue;\n    }\n\n    const commandDefinition = getCommandDefinition();\n\n    // * Arguments check\n    if (commandDefinition?.arguments) {\n      context.arguments ??= {};\n\n      const currentArgumentCount = Object.keys(context.arguments).length;\n      const argumentDefinitionEntries = Object.entries(commandDefinition.arguments);\n\n      // The current argument is a typed argument and not a positional\n      if (currentArgumentCount < argumentDefinitionEntries.length) {\n        const [name, argumentDefinition] = argumentDefinitionEntries[currentArgumentCount];\n\n        if (!argumentDefinition._preparedType) {\n          throw new CliError({\n            cause: ErrorCause.Internal,\n            code: InternalErrorCode.MissingPreparedTypes,\n            context: {\n              commandKind: context.subcommand ? \"subcommand\" : \"command\",\n              commandName: context.subcommand ?? cliName,\n              kind: \"argument\",\n              name,\n            },\n          });\n        }\n\n        const { schema, optional, defaultValue } = argumentDefinition._preparedType;\n\n        context.arguments[name] = { schema, optional, defaultValue, stringValue: argvItem, source: \"terminal\" };\n        continue;\n      }\n    }\n\n    // The current argument is a positional and not a typed argument (when `allowPositionals` is enabled)\n    if (commandDefinition?.allowPositionals) {\n      context.positionals ??= [];\n      context.positionals.push(argvItem);\n      continue;\n    }\n\n    throw new CliError({\n      cause: ErrorCause.Parse,\n      code: ParseErrorCode.PositionalArgumentNotAllowed,\n      context: {\n        commandKind: context.subcommand ? \"subcommand\" : \"command\",\n        commandName: context.subcommand ?? cliName,\n        argumentName: argvItem,\n      },\n    });\n  }\n\n  const commandDefinition = getCommandDefinition();\n  if (!commandDefinition) {\n    if (context.subcommand === undefined) {\n      throw new CliError({\n        cause: ErrorCause.Internal,\n        code: InternalErrorCode.CannotFindCliDefinition,\n        context: { cliName },\n      });\n    }\n\n    throw new CliError({\n      cause: ErrorCause.Parse,\n      code: ParseErrorCode.UnknownSubcommand,\n      context: { commandName: context.subcommand ?? cliName },\n    });\n  }\n\n  // Options\n  if (commandDefinition.options) {\n    context.options ??= {};\n\n    for (const [name, optionDefinition] of Object.entries(commandDefinition.options)) {\n      // option already added to the context (found during argument parsing)\n      if (name in context.options) continue;\n\n      if (!optionDefinition._preparedType) {\n        throw new CliError({\n          cause: ErrorCause.Internal,\n          code: InternalErrorCode.MissingPreparedTypes,\n          context: {\n            commandKind: context.subcommand ? \"subcommand\" : \"command\",\n            commandName: context.subcommand ?? cliName,\n            kind: \"option\",\n            name,\n          },\n        });\n      }\n\n      const { schema, optional, defaultValue } = optionDefinition._preparedType;\n\n      if (optional) {\n        // optional without default value\n        if (defaultValue === undefined) {\n          continue;\n        }\n\n        // optional with default value\n        context.options[name] = { schema, optional, defaultValue, source: \"default\" };\n        continue;\n      }\n\n      throw new CliError({\n        cause: ErrorCause.Parse,\n        code: ParseErrorCode.MissingRequiredOption,\n        context: {\n          commandKind: context.subcommand ? \"subcommand\" : \"command\",\n          commandName: context.subcommand ?? cliName,\n          optionName: name,\n        },\n      });\n    }\n  }\n\n  // Arguments\n  if (commandDefinition.arguments) {\n    context.arguments ??= {};\n\n    const currentArgumentCount = Object.keys(context.arguments).length;\n\n    const argumentDefinitionEntries = Object.entries(commandDefinition.arguments);\n    const argumentsDefinitionLength = argumentDefinitionEntries.length;\n\n    // missing arguments\n    if (currentArgumentCount < argumentsDefinitionLength) {\n      for (let index = currentArgumentCount; index < argumentsDefinitionLength; index++) {\n        const [name, argumentDefinition] = argumentDefinitionEntries[index];\n\n        if (!argumentDefinition._preparedType) {\n          throw new CliError({\n            cause: ErrorCause.Internal,\n            code: InternalErrorCode.MissingPreparedTypes,\n            context: {\n              commandKind: context.subcommand ? \"subcommand\" : \"command\",\n              commandName: context.subcommand ?? cliName,\n              kind: \"argument\",\n              name,\n            },\n          });\n        }\n\n        const { schema, optional, defaultValue } = argumentDefinition._preparedType;\n\n        if (optional) {\n          // optional argument without default value\n          if (defaultValue === undefined) {\n            continue;\n          }\n\n          // optional argument with default value\n          context.arguments[name] = { schema, optional, defaultValue, source: \"default\" };\n          continue;\n        }\n\n        // required argument\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.MissingRequiredArgument,\n          context: {\n            commandKind: context.subcommand ? \"subcommand\" : \"command\",\n            commandName: context.subcommand ?? cliName,\n            argumentName: name,\n          },\n        });\n      }\n    }\n  }\n\n  // make sure `positionals` is defined when `allowPositionals` is enabled\n  if (commandDefinition.allowPositionals) {\n    context.positionals ??= [];\n  }\n\n  return context;\n}\n"],
+  "mappings": "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",
   "names": ["commandDefinition", "index"]
 }