@jakubmazanec/args 2.0.0-next.f9ef3d7 → 2.0.0-unstable.19a45fc

package/build/Arguments.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=Arguments.js.map

package/build/Arguments.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/ArgumentsCommand.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ArgumentsCommand.js.map

package/build/ArgumentsCommand.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/{dist → build}/ArgumentsOptions.d.ts

@@ -1,5 +1,5 @@
 import { type TupleToUnion } from '@jakubmazanec/ts-utils';
-import { type CountOptionConfig, type BooleansOptionConfig, type NumbersOptionConfig, type StringsOptionConfig, type OptionConfig, type BooleanOptionConfig, type NumberOptionConfig, type StringOptionConfig } from './OptionConfig.js';
+import { type BooleanOptionConfig, type BooleansOptionConfig, type CountOptionConfig, type NumberOptionConfig, type NumbersOptionConfig, type OptionConfig, type StringOptionConfig, type StringsOptionConfig } from './OptionConfig.js';
 import { type OptionsConfig } from './OptionsConfig.js';
 import { type ParserConfig } from './ParserConfig.js';
 type BooleanOptionConfigToArgumentsOption<O extends BooleanOptionConfig | BooleansOptionConfig> = O extends BooleanOptionConfig ? O['defaultValue'] extends boolean ? boolean : boolean | undefined : O extends BooleansOptionConfig ? O['defaultValue'] extends readonly boolean[] ? boolean[] : boolean[] | undefined : never;

package/build/ArgumentsOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ArgumentsOptions.js.map

package/build/ArgumentsOptions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/{dist → build}/ArgumentsParameters.d.ts

@@ -1,32 +1,26 @@
 import { type TupleToUnion } from '@jakubmazanec/ts-utils';
-import { type ParameterConfig, type BooleanParameterConfig, type NumberParameterConfig, type StringParameterConfig } from './ParameterConfig.js';
+import { type BooleanParameterConfig, type NumberParameterConfig, type ParameterConfig, type StringParameterConfig } from './ParameterConfig.js';
 import { type ParametersConfig } from './ParametersConfig.js';
 import { type ParserConfig } from './ParserConfig.js';
 type NumberParameterConfigToArgumentsParameter<O extends NumberParameterConfig> = O['choices'] extends readonly number[] ? O['defaultValue'] extends number ? TupleToUnion<O['choices']> : TupleToUnion<O['choices']> | undefined : O['defaultValue'] extends number ? number : number | undefined;
 type StringParameterConfigToArgumentsParameter<O extends StringParameterConfig> = O['choices'] extends readonly string[] ? O['defaultValue'] extends string ? TupleToUnion<O['choices']> : TupleToUnion<O['choices']> | undefined : O['defaultValue'] extends string ? string : string | undefined;
 type BooleanParameterConfigToArgumentsParameter<O extends BooleanParameterConfig> = O['defaultValue'] extends boolean ? boolean : boolean | undefined;
 type ParameterConfigToArgumentsParameter<O extends ParameterConfig> = O extends NumberParameterConfig ? NumberParameterConfigToArgumentsParameter<O> : O extends StringParameterConfig ? StringParameterConfigToArgumentsParameter<O> : O extends BooleanParameterConfig ? BooleanParameterConfigToArgumentsParameter<O> : never;
-type ParametersConfigToArgumentsParameters<O extends ParametersConfig> = O extends readonly [
+type ParametersConfigToArgumentsParameters<O extends ParametersConfig> = O extends (readonly [
     ParameterConfig,
     ParameterConfig,
     ParameterConfig,
     ParameterConfig,
     ParameterConfig,
     ParameterConfig
-] ? readonly [
+]) ? readonly [
     ParameterConfigToArgumentsParameter<O[0]>,
     ParameterConfigToArgumentsParameter<O[1]>,
     ParameterConfigToArgumentsParameter<O[2]>,
     ParameterConfigToArgumentsParameter<O[3]>,
     ParameterConfigToArgumentsParameter<O[4]>,
     ParameterConfigToArgumentsParameter<O[5]>
-] : O extends readonly [
-    ParameterConfig,
-    ParameterConfig,
-    ParameterConfig,
-    ParameterConfig,
-    ParameterConfig
-] ? readonly [
+] : O extends (readonly [ParameterConfig, ParameterConfig, ParameterConfig, ParameterConfig, ParameterConfig]) ? readonly [
     ParameterConfigToArgumentsParameter<O[0]>,
     ParameterConfigToArgumentsParameter<O[1]>,
     ParameterConfigToArgumentsParameter<O[2]>,
@@ -42,14 +36,14 @@ type ParametersConfigToArgumentsParameters<O extends ParametersConfig> = O exten
     ParameterConfigToArgumentsParameter<O[1]>,
     ParameterConfigToArgumentsParameter<O[2]>
 ] : O extends readonly [ParameterConfig, ParameterConfig] ? readonly [ParameterConfigToArgumentsParameter<O[0]>, ParameterConfigToArgumentsParameter<O[1]>] : O extends readonly [ParameterConfig] ? readonly [ParameterConfigToArgumentsParameter<O[0]>] : never;
-type ParametersConfigToVariadicArgumentsParameters<O extends ParametersConfig> = O extends readonly [
+type ParametersConfigToVariadicArgumentsParameters<O extends ParametersConfig> = O extends (readonly [
     ParameterConfig,
     ParameterConfig,
     ParameterConfig,
     ParameterConfig,
     ParameterConfig,
     ParameterConfig
-] ? readonly [
+]) ? readonly [
     ParameterConfigToArgumentsParameter<O[0]>,
     ParameterConfigToArgumentsParameter<O[1]>,
     ParameterConfigToArgumentsParameter<O[2]>,
@@ -57,13 +51,7 @@ type ParametersConfigToVariadicArgumentsParameters<O extends ParametersConfig> =
     ParameterConfigToArgumentsParameter<O[4]>,
     ParameterConfigToArgumentsParameter<O[5]>,
     ...(readonly string[])
-] : O extends readonly [
-    ParameterConfig,
-    ParameterConfig,
-    ParameterConfig,
-    ParameterConfig,
-    ParameterConfig
-] ? readonly [
+] : O extends (readonly [ParameterConfig, ParameterConfig, ParameterConfig, ParameterConfig, ParameterConfig]) ? readonly [
     ParameterConfigToArgumentsParameter<O[0]>,
     ParameterConfigToArgumentsParameter<O[1]>,
     ParameterConfigToArgumentsParameter<O[2]>,
@@ -87,5 +75,7 @@ type ParametersConfigToVariadicArgumentsParameters<O extends ParametersConfig> =
     ...(readonly string[])
 ] : O extends readonly [ParameterConfig] ? readonly [ParameterConfigToArgumentsParameter<O[0]>, ...(readonly string[])] : readonly [...(readonly string[])];
 /** Parsed parameters. */
-export type ArgumentsParameters<O extends ParserConfig> = Omit<O, 'parameters'> extends O ? O['allowUnknownParameters'] extends true ? [...string[]] : null : O['parameters'] extends undefined ? null : O['allowUnknownParameters'] extends true ? ParametersConfigToVariadicArgumentsParameters<NonNullable<O['parameters']>> : ParametersConfigToArgumentsParameters<NonNullable<O['parameters']>>;
+export type ArgumentsParameters<O extends ParserConfig> = Omit<O, 'parameters'> extends O ? O['allowUnknownParameters'] extends true ? [
+    ...string[]
+] : null : O['parameters'] extends undefined ? null : O['allowUnknownParameters'] extends true ? ParametersConfigToVariadicArgumentsParameters<NonNullable<O['parameters']>> : ParametersConfigToArgumentsParameters<NonNullable<O['parameters']>>;
 export {};

package/build/ArgumentsParameters.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ArgumentsParameters.js.map

package/build/ArgumentsParameters.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/ArgumentsUnknownOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ArgumentsUnknownOptions.js.map

package/build/ArgumentsUnknownOptions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/Argv.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=Argv.js.map

package/build/Argv.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/CommandConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=CommandConfig.js.map

package/build/CommandConfig.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/CommandsConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=CommandsConfig.js.map

package/build/CommandsConfig.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/LongOptionName.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=LongOptionName.js.map

package/build/LongOptionName.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/OptionConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=OptionConfig.js.map

package/build/OptionConfig.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/OptionsConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=OptionsConfig.js.map

package/build/OptionsConfig.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/ParameterConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ParameterConfig.js.map

package/build/ParameterConfig.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/ParametersConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ParametersConfig.js.map

package/build/ParametersConfig.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/ParserConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ParserConfig.js.map

package/build/ParserConfig.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/ParsingError.js

@@ -0,0 +1,9 @@
+"use strict";
+import { createCustomError } from "@jakubmazanec/error";
+export const ParsingError = createCustomError("ParsingError", {
+  INVALID_PARAMETER: 'Invalid parameter value "{0}" found. Allowed values for parameter "{1}" are: {2}.',
+  UNKNOWN_PARAMETER: 'Unknown parameter "{0}" found. Unknown parameters are not allowed.',
+  INVALID_OPTION: 'Invalid option value "{0}" found. Allowed values for option "{1}" are: {2}.',
+  UNKNOWN_OPTION: 'Unknown option "{0}" found. Unknown options are not allowed.'
+});
+//# sourceMappingURL=ParsingError.js.map

package/build/ParsingError.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../source/ParsingError.ts"],
+  "sourcesContent": ["import {createCustomError} from '@jakubmazanec/error';\n\n/**\n * A subclass of `Error` that indicates a parsing failure.\n */\nexport const ParsingError = createCustomError('ParsingError', {\n  INVALID_PARAMETER:\n    'Invalid parameter value \"{0}\" found. Allowed values for parameter \"{1}\" are: {2}.',\n  UNKNOWN_PARAMETER: 'Unknown parameter \"{0}\" found. Unknown parameters are not allowed.',\n  INVALID_OPTION: 'Invalid option value \"{0}\" found. Allowed values for option \"{1}\" are: {2}.',\n  UNKNOWN_OPTION: 'Unknown option \"{0}\" found. Unknown options are not allowed.',\n});\n"],
+  "mappings": ";AAAA,SAAQ,yBAAwB;AAKzB,aAAM,eAAe,kBAAkB,gBAAgB;AAAA,EAC5D,mBACE;AAAA,EACF,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,gBAAgB;AAClB,CAAC;",
+  "names": []
+}

package/build/ShortOptionName.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ShortOptionName.js.map

package/build/ShortOptionName.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/ValidationError.js

@@ -0,0 +1,14 @@
+"use strict";
+import { createCustomError } from "@jakubmazanec/error";
+export const ValidationError = createCustomError("ValidationError", {
+  INVALID_COMMAND: 'Command "{0}" has invalid format. Only words consisting of letters, numbers or dashes separated by single space are allowed.',
+  MISSING_PARAMETER: 'Parameter "{0}" is required but its value is undefined.',
+  INVALID_PARAMETER_DEFAULT_AND_CHOICES: 'Parameter "{0}" has invalid default value "{1}". Default value must be one of the `choices` elements.',
+  INVALID_PARAMETER_ORDER: 'Parameter "{0}" has invalid order. All parameters before must have a default value or be required too',
+  MISSING_OPTION: 'Option "{0}" is required but its value is undefined.',
+  INVALID_OPTION_DEFAULT_AND_CHOICES: 'Option "{0}" has invalid default value "{1}". Default value must be one of the `choices` elements.',
+  INVALID_OPTION_NAME: 'Option "{0}" has invalid name. Only names consisting of letters, numbers or dashes are allowed.',
+  REPEATED_OPTION_NAME: 'Option "{0}" has invalid short name "{1}". Short option names must be unique.',
+  INVALID_OPTION_ARITY: 'Option "{0}" has invalid number of values. Found "{1}", require "{2}".'
+});
+//# sourceMappingURL=ValidationError.js.map

package/build/ValidationError.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../source/ValidationError.ts"],
+  "sourcesContent": ["import {createCustomError} from '@jakubmazanec/error';\n\n/**\n * A subclass of `Error` that indicates a validation issue.\n */\nexport const ValidationError = createCustomError('ValidationError', {\n  INVALID_COMMAND:\n    'Command \"{0}\" has invalid format. Only words consisting of letters, numbers or dashes separated by single space are allowed.',\n  MISSING_PARAMETER: 'Parameter \"{0}\" is required but its value is undefined.',\n  INVALID_PARAMETER_DEFAULT_AND_CHOICES:\n    'Parameter \"{0}\" has invalid default value \"{1}\". Default value must be one of the `choices` elements.',\n  INVALID_PARAMETER_ORDER:\n    'Parameter \"{0}\" has invalid order. All parameters before must have a default value or be required too',\n  MISSING_OPTION: 'Option \"{0}\" is required but its value is undefined.',\n  INVALID_OPTION_DEFAULT_AND_CHOICES:\n    'Option \"{0}\" has invalid default value \"{1}\". Default value must be one of the `choices` elements.',\n  INVALID_OPTION_NAME:\n    'Option \"{0}\" has invalid name. Only names consisting of letters, numbers or dashes are allowed.',\n  REPEATED_OPTION_NAME:\n    'Option \"{0}\" has invalid short name \"{1}\". Short option names must be unique.',\n  INVALID_OPTION_ARITY: 'Option \"{0}\" has invalid number of values. Found \"{1}\", require \"{2}\".',\n});\n"],
+  "mappings": ";AAAA,SAAQ,yBAAwB;AAKzB,aAAM,kBAAkB,kBAAkB,mBAAmB;AAAA,EAClE,iBACE;AAAA,EACF,mBAAmB;AAAA,EACnB,uCACE;AAAA,EACF,yBACE;AAAA,EACF,gBAAgB;AAAA,EAChB,oCACE;AAAA,EACF,qBACE;AAAA,EACF,sBACE;AAAA,EACF,sBAAsB;AACxB,CAAC;",
+  "names": []
+}

package/build/internals/Checker.js

@@ -0,0 +1,98 @@
+"use strict";
+import { ValidationError } from "../ValidationError.js";
+import { isCommand } from "./isCommand.js";
+import { isLongOption } from "./isLongOption.js";
+export class Checker {
+  errors = [];
+  checkCommandsConfig(commandsConfig) {
+    for (let commandConfig of commandsConfig) {
+      if (!isCommand(commandConfig)) {
+        this.addError(new ValidationError("INVALID_COMMAND", { messageParameters: [commandConfig] }));
+      }
+    }
+  }
+  checkParametersConfig(parametersConfig) {
+    for (let [i, parameterConfig] of parametersConfig.entries()) {
+      if (parameterConfig.type !== "boolean" && parameterConfig.choices && // default values and chocies do not contradict each other
+      parameterConfig.defaultValue !== void 0 && !parameterConfig.choices.includes(parameterConfig.defaultValue)) {
+        this.addError(
+          new ValidationError("INVALID_PARAMETER_DEFAULT_AND_CHOICES", {
+            messageParameters: [parameterConfig.label ?? i, parameterConfig.defaultValue]
+          })
+        );
+      }
+      if (i >= 1 && parameterConfig.required === true && !parametersConfig.slice(0, i).every(
+        (previousParameterConfig) => previousParameterConfig.required === true || previousParameterConfig.defaultValue !== void 0
+      )) {
+        this.addError(
+          new ValidationError("INVALID_PARAMETER_ORDER", {
+            messageParameters: [parameterConfig.label ?? i]
+          })
+        );
+      }
+    }
+  }
+  checkOptionsConfig(optionsConfig) {
+    let usedShortOptionNames = /* @__PURE__ */ new Set([]);
+    for (let [optionName, optionConfig] of Object.entries(optionsConfig)) {
+      if (!isLongOption(`--${optionName}`)) {
+        this.addError(
+          new ValidationError("INVALID_OPTION_NAME", {
+            messageParameters: [optionName]
+          })
+        );
+      }
+      if (optionConfig.shortName && usedShortOptionNames.has(optionConfig.shortName)) {
+        this.addError(
+          new ValidationError("REPEATED_OPTION_NAME", {
+            messageParameters: [optionName, optionConfig.shortName]
+          })
+        );
+      } else if (optionConfig.shortName) {
+        usedShortOptionNames.add(optionConfig.shortName);
+      }
+      if ((optionConfig.type === "string" || optionConfig.type === "number" && !optionConfig.count) && optionConfig.choices && optionConfig.defaultValue !== void 0 && !optionConfig.choices.includes(optionConfig.defaultValue)) {
+        this.addError(
+          new ValidationError("INVALID_OPTION_DEFAULT_AND_CHOICES", {
+            messageParameters: [optionName, optionConfig.defaultValue]
+          })
+        );
+      }
+    }
+  }
+  checkParsedParameters(parametersConfig, parsedParameters) {
+    for (let [i, parameterConfig] of parametersConfig.entries()) {
+      let parsedParameter = parsedParameters[i];
+      if (parameterConfig.required === true && parsedParameter === void 0) {
+        this.addError(
+          new ValidationError("MISSING_PARAMETER", {
+            messageParameters: [parameterConfig.label ?? i]
+          })
+        );
+      }
+    }
+  }
+  checkParsedOptions(optionsConfig, parsedOptions) {
+    for (let [optionName, optionConfig] of Object.entries(optionsConfig)) {
+      let parsedOption = parsedOptions[optionName];
+      if (optionConfig.required && parsedOption === void 0) {
+        this.addError(
+          new ValidationError("MISSING_OPTION", {
+            messageParameters: [optionName]
+          })
+        );
+      }
+      if (parsedOption !== void 0 && (optionConfig.type === "string" && optionConfig.multiple || optionConfig.type === "number" && optionConfig.multiple) && typeof optionConfig.arity === "number" && Array.isArray(parsedOption) && parsedOption.length > 0 && parsedOption.length !== optionConfig.arity) {
+        this.addError(
+          new ValidationError("INVALID_OPTION_ARITY", {
+            messageParameters: [optionName, parsedOption.length, optionConfig.arity]
+          })
+        );
+      }
+    }
+  }
+  addError(error) {
+    this.errors.push(error);
+  }
+}
+//# sourceMappingURL=Checker.js.map

package/build/internals/Checker.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../source/internals/Checker.ts"],
+  "sourcesContent": ["import {type CommandsConfig} from '../CommandsConfig.js';\nimport {type OptionsConfig} from '../OptionsConfig.js';\nimport {type ParametersConfig} from '../ParametersConfig.js';\nimport {ValidationError} from '../ValidationError.js';\nimport {isCommand} from './isCommand.js';\nimport {isLongOption} from './isLongOption.js';\n\n/**\n * `Checker` is used for handling various checks before, during, and after parsing of the arguments.\n */\nexport class Checker {\n  errors: Error[] = [];\n\n  checkCommandsConfig(commandsConfig: CommandsConfig | []) {\n    for (let commandConfig of commandsConfig) {\n      if (!isCommand(commandConfig)) {\n        this.addError(new ValidationError('INVALID_COMMAND', {messageParameters: [commandConfig]}));\n      }\n    }\n  }\n\n  checkParametersConfig(parametersConfig: ParametersConfig | []) {\n    for (let [i, parameterConfig] of parametersConfig.entries()) {\n      // types of choices must be correct\n      if (\n        parameterConfig.type !== 'boolean' &&\n        parameterConfig.choices && // default values and chocies do not contradict each other\n        parameterConfig.defaultValue !== undefined &&\n        !parameterConfig.choices.includes(parameterConfig.defaultValue as never)\n      ) {\n        this.addError(\n          new ValidationError('INVALID_PARAMETER_DEFAULT_AND_CHOICES', {\n            messageParameters: [parameterConfig.label ?? i, parameterConfig.defaultValue],\n          }),\n        );\n      }\n\n      // if parameter is required, all parameters before must be required too\n      if (\n        i >= 1 &&\n        parameterConfig.required === true &&\n        !parametersConfig\n          .slice(0, i)\n          .every(\n            (previousParameterConfig) =>\n              previousParameterConfig.required === true ||\n              previousParameterConfig.defaultValue !== undefined,\n          )\n      ) {\n        this.addError(\n          new ValidationError('INVALID_PARAMETER_ORDER', {\n            messageParameters: [parameterConfig.label ?? i],\n          }),\n        );\n      }\n    }\n  }\n\n  checkOptionsConfig(optionsConfig: OptionsConfig) {\n    let usedShortOptionNames: Set<string> = new Set([]);\n\n    for (let [optionName, optionConfig] of Object.entries(optionsConfig)) {\n      // option names must be in correct format\n      if (!isLongOption(`--${optionName}`)) {\n        this.addError(\n          new ValidationError('INVALID_OPTION_NAME', {\n            messageParameters: [optionName],\n          }),\n        );\n      }\n\n      // option short names must be unique\n      if (optionConfig.shortName && usedShortOptionNames.has(optionConfig.shortName)) {\n        this.addError(\n          new ValidationError('REPEATED_OPTION_NAME', {\n            messageParameters: [optionName, optionConfig.shortName],\n          }),\n        );\n      } else if (optionConfig.shortName) {\n        usedShortOptionNames.add(optionConfig.shortName);\n      }\n\n      // default values and chocies do not contradict each other\n      if (\n        (optionConfig.type === 'string' ||\n          (optionConfig.type === 'number' && !optionConfig.count)) &&\n        optionConfig.choices &&\n        optionConfig.defaultValue !== undefined &&\n        !optionConfig.choices.includes(optionConfig.defaultValue as never)\n      ) {\n        this.addError(\n          new ValidationError('INVALID_OPTION_DEFAULT_AND_CHOICES', {\n            messageParameters: [optionName, optionConfig.defaultValue],\n          }),\n        );\n      }\n    }\n  }\n\n  checkParsedParameters(parametersConfig: ParametersConfig | [], parsedParameters: unknown[]) {\n    for (let [i, parameterConfig] of parametersConfig.entries()) {\n      let parsedParameter = parsedParameters[i];\n\n      // required parameters must have value\n      if (parameterConfig.required === true && parsedParameter === undefined) {\n        this.addError(\n          new ValidationError('MISSING_PARAMETER', {\n            messageParameters: [parameterConfig.label ?? i],\n          }),\n        );\n      }\n    }\n  }\n\n  checkParsedOptions(optionsConfig: OptionsConfig, parsedOptions: Record<string, unknown>) {\n    for (let [optionName, optionConfig] of Object.entries(optionsConfig)) {\n      let parsedOption = parsedOptions[optionName];\n\n      // check required\n      if (optionConfig.required && parsedOption === undefined) {\n        this.addError(\n          new ValidationError('MISSING_OPTION', {\n            messageParameters: [optionName],\n          }),\n        );\n      }\n\n      // check arity\n      if (\n        parsedOption !== undefined &&\n        ((optionConfig.type === 'string' && optionConfig.multiple) ||\n          (optionConfig.type === 'number' && optionConfig.multiple)) &&\n        typeof optionConfig.arity === 'number' &&\n        Array.isArray(parsedOption) &&\n        (parsedOption as unknown[]).length > 0 &&\n        (parsedOption as unknown[]).length !== optionConfig.arity\n      ) {\n        this.addError(\n          new ValidationError('INVALID_OPTION_ARITY', {\n            messageParameters: [optionName, (parsedOption as unknown[]).length, optionConfig.arity],\n          }),\n        );\n      }\n    }\n  }\n\n  addError(error: Error) {\n    this.errors.push(error);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/build/internals/CommandScope.js

@@ -0,0 +1,44 @@
+"use strict";
+export class CommandScope {
+  args;
+  config;
+  constructor(arg, normalizedCommandsConfig) {
+    let normalizedArgument = arg.toLowerCase();
+    let commandConfig = normalizedCommandsConfig.find(
+      (commandConfig2) => commandConfig2.args[0] === normalizedArgument
+    );
+    this.config = commandConfig ?? [];
+    this.args = [normalizedArgument];
+  }
+  captureArg(arg) {
+    this.args.push(arg.toLowerCase());
+    return this;
+  }
+  isComplete() {
+    let isComplete = true;
+    for (let [i, arg] of this.config.args.entries()) {
+      if (this.args[i] !== arg) {
+        isComplete = false;
+        break;
+      }
+    }
+    return isComplete;
+  }
+  isDone() {
+    let isDone = false;
+    for (let [i, arg] of this.config.args.entries()) {
+      if (this.args[i] !== arg) {
+        isDone = true;
+        break;
+      }
+    }
+    return isDone;
+  }
+  getValue() {
+    return this.config.command;
+  }
+  getArgs() {
+    return [...this.args];
+  }
+}
+//# sourceMappingURL=CommandScope.js.map

package/build/internals/CommandScope.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../source/internals/CommandScope.ts"],
+  "sourcesContent": ["import {type NormalizedCommandConfig} from './NormalizedCommandConfig.js';\nimport {type NormalizedCommandsConfig} from './NormalizedCommandsConfig.js';\n\n/**\n * `CommandScope` handles storing information about parsing of a command.\n */\nexport class CommandScope {\n  private readonly args: string[];\n  readonly config: NormalizedCommandConfig;\n\n  constructor(arg: string, normalizedCommandsConfig: NormalizedCommandsConfig) {\n    let normalizedArgument = arg.toLowerCase();\n    let commandConfig = normalizedCommandsConfig.find(\n      (commandConfig) => commandConfig.args[0] === normalizedArgument,\n    );\n\n    this.config = commandConfig ?? ([] as unknown as NormalizedCommandConfig);\n    this.args = [normalizedArgument];\n  }\n\n  captureArg(arg: string) {\n    this.args.push(arg.toLowerCase());\n\n    return this;\n  }\n\n  isComplete() {\n    let isComplete = true;\n\n    for (let [i, arg] of this.config.args.entries()) {\n      if (this.args[i] !== arg) {\n        isComplete = false;\n\n        break;\n      }\n    }\n\n    return isComplete;\n  }\n\n  isDone() {\n    let isDone = false;\n\n    for (let [i, arg] of this.config.args.entries()) {\n      if (this.args[i] !== arg) {\n        isDone = true;\n\n        break;\n      }\n    }\n\n    return isDone;\n  }\n\n  getValue() {\n    return this.config.command;\n  }\n\n  getArgs() {\n    return [...this.args];\n  }\n}\n"],
+  "mappings": ";AAMO,aAAM,aAAa;AAAA,EACP;AAAA,EACR;AAAA,EAET,YAAY,KAAa,0BAAoD;AAC3E,QAAI,qBAAqB,IAAI,YAAY;AACzC,QAAI,gBAAgB,yBAAyB;AAAA,MAC3C,CAACA,mBAAkBA,eAAc,KAAK,CAAC,MAAM;AAAA,IAC/C;AAEA,SAAK,SAAS,iBAAkB,CAAC;AACjC,SAAK,OAAO,CAAC,kBAAkB;AAAA,EACjC;AAAA,EAEA,WAAW,KAAa;AACtB,SAAK,KAAK,KAAK,IAAI,YAAY,CAAC;AAEhC,WAAO;AAAA,EACT;AAAA,EAEA,aAAa;AACX,QAAI,aAAa;AAEjB,aAAS,CAAC,GAAG,GAAG,KAAK,KAAK,OAAO,KAAK,QAAQ,GAAG;AAC/C,UAAI,KAAK,KAAK,CAAC,MAAM,KAAK;AACxB,qBAAa;AAEb;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,SAAS;AACP,QAAI,SAAS;AAEb,aAAS,CAAC,GAAG,GAAG,KAAK,KAAK,OAAO,KAAK,QAAQ,GAAG;AAC/C,UAAI,KAAK,KAAK,CAAC,MAAM,KAAK;AACxB,iBAAS;AAET;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,WAAW;AACT,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAEA,UAAU;AACR,WAAO,CAAC,GAAG,KAAK,IAAI;AAAA,EACtB;AACF;",
+  "names": ["commandConfig"]
+}

package/build/internals/NormalizedCommandConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=NormalizedCommandConfig.js.map

package/build/internals/NormalizedCommandConfig.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/internals/NormalizedCommandsConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=NormalizedCommandsConfig.js.map

package/build/internals/NormalizedCommandsConfig.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/internals/OptionScope.js

@@ -0,0 +1,69 @@
+"use strict";
+import camelCase from "lodash.camelcase";
+import { ParsingError } from "../ParsingError.js";
+import { castValue } from "./castValue.js";
+export class OptionScope {
+  name;
+  values = [];
+  previousParsedValue;
+  config;
+  constructor(optionName, optionsConfig, allowUnknownOptions = false) {
+    this.name = optionName;
+    if (this.name.includes("-")) {
+      this.name = camelCase(this.name);
+    }
+    let optionConfig = optionsConfig[this.name];
+    if (!optionConfig) {
+      if (!allowUnknownOptions) {
+        throw new ParsingError("UNKNOWN_OPTION", { messageParameters: [this.name] });
+      }
+      optionConfig = {
+        type: "string"
+      };
+    }
+    this.config = optionConfig;
+  }
+  captureArg(arg) {
+    let value = castValue(arg, this.config.type);
+    if ((this.config.type === "number" && !this.config.count || this.config.type === "string") && this.config.choices !== void 0 && !this.config.choices.includes(value)) {
+      throw new ParsingError("INVALID_OPTION", {
+        messageParameters: [
+          value,
+          this.name,
+          this.config.choices.map((choice) => `"${choice}"`).join(", ")
+        ]
+      });
+    }
+    if (this.config.multiple) {
+      this.values.push(value);
+    } else {
+      this.values = [value];
+    }
+  }
+  isComplete() {
+    if (!this.config.multiple && this.values.length === 1) {
+      return true;
+    }
+    if (this.config.multiple && typeof this.config.arity === "number" && this.values.length + (this.previousParsedValue ?? []).length === this.config.arity) {
+      return true;
+    }
+    return false;
+  }
+  getValue() {
+    let { config, previousParsedValue } = this;
+    let { values } = this;
+    if (config.type === "boolean" && !config.multiple && !values.length) {
+      values = [true];
+    } else if (config.type === "number" && config.count && !values.length) {
+      values = [1];
+    }
+    if (config.multiple && previousParsedValue) {
+      values = [...previousParsedValue, ...values];
+    }
+    if (config.type === "number" && config.count && previousParsedValue) {
+      values = [values[0] + previousParsedValue];
+    }
+    return config.multiple ? values : values[0];
+  }
+}
+//# sourceMappingURL=OptionScope.js.map

package/build/internals/OptionScope.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../source/internals/OptionScope.ts"],
+  "sourcesContent": ["import camelCase from 'lodash.camelcase';\n\nimport {type OptionConfig} from '../OptionConfig.js';\nimport {type OptionsConfig} from '../OptionsConfig.js';\nimport {ParsingError} from '../ParsingError.js';\nimport {castValue} from './castValue.js';\n\n/**\n * `CommandScope` handles storing information about parsing of an option..\n */\nexport class OptionScope {\n  name: string;\n\n  values: unknown[] = [];\n  previousParsedValue?: unknown[] | unknown;\n  readonly config: OptionConfig;\n\n  constructor(optionName: string, optionsConfig: OptionsConfig, allowUnknownOptions = false) {\n    this.name = optionName;\n\n    // Convert option to camel case\n    if (this.name.includes('-')) {\n      this.name = camelCase(this.name);\n    }\n\n    let optionConfig = optionsConfig[this.name];\n\n    if (!optionConfig) {\n      if (!allowUnknownOptions) {\n        throw new ParsingError('UNKNOWN_OPTION', {messageParameters: [this.name]});\n      }\n\n      optionConfig = {\n        type: 'string',\n      };\n    }\n\n    this.config = optionConfig;\n  }\n\n  captureArg(arg: string) {\n    let value = castValue(arg, this.config.type);\n\n    if (\n      ((this.config.type === 'number' && !this.config.count) || this.config.type === 'string') &&\n      this.config.choices !== undefined &&\n      !this.config.choices.includes(value as never)\n    ) {\n      throw new ParsingError('INVALID_OPTION', {\n        messageParameters: [\n          value,\n          this.name,\n          this.config.choices.map((choice) => `\"${choice}\"`).join(', '),\n        ],\n      });\n    }\n\n    if (this.config.multiple) {\n      this.values.push(value);\n    } else {\n      this.values = [value];\n    }\n  }\n\n  isComplete() {\n    if (!this.config.multiple && this.values.length === 1) {\n      return true;\n    }\n\n    if (\n      this.config.multiple &&\n      typeof this.config.arity === 'number' &&\n      this.values.length + ((this.previousParsedValue as unknown[] | undefined) ?? []).length ===\n        this.config.arity\n    ) {\n      return true;\n    }\n\n    return false;\n  }\n\n  getValue() {\n    let {config, previousParsedValue} = this;\n    let {values} = this;\n\n    if (config.type === 'boolean' && !config.multiple && !values.length) {\n      values = [true];\n    } else if (config.type === 'number' && config.count && !values.length) {\n      values = [1];\n    }\n\n    if (config.multiple && previousParsedValue) {\n      values = [...(previousParsedValue as unknown[]), ...values];\n    }\n\n    if (config.type === 'number' && config.count && previousParsedValue) {\n      values = [(values[0] as number) + (previousParsedValue as number)];\n    }\n\n    return config.multiple ? values : values[0];\n  }\n}\n"],
+  "mappings": ";AAAA,OAAO,eAAe;AAItB,SAAQ,oBAAmB;AAC3B,SAAQ,iBAAgB;AAKjB,aAAM,YAAY;AAAA,EACvB;AAAA,EAEA,SAAoB,CAAC;AAAA,EACrB;AAAA,EACS;AAAA,EAET,YAAY,YAAoB,eAA8B,sBAAsB,OAAO;AACzF,SAAK,OAAO;AAGZ,QAAI,KAAK,KAAK,SAAS,GAAG,GAAG;AAC3B,WAAK,OAAO,UAAU,KAAK,IAAI;AAAA,IACjC;AAEA,QAAI,eAAe,cAAc,KAAK,IAAI;AAE1C,QAAI,CAAC,cAAc;AACjB,UAAI,CAAC,qBAAqB;AACxB,cAAM,IAAI,aAAa,kBAAkB,EAAC,mBAAmB,CAAC,KAAK,IAAI,EAAC,CAAC;AAAA,MAC3E;AAEA,qBAAe;AAAA,QACb,MAAM;AAAA,MACR;AAAA,IACF;AAEA,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,WAAW,KAAa;AACtB,QAAI,QAAQ,UAAU,KAAK,KAAK,OAAO,IAAI;AAE3C,SACI,KAAK,OAAO,SAAS,YAAY,CAAC,KAAK,OAAO,SAAU,KAAK,OAAO,SAAS,aAC/E,KAAK,OAAO,YAAY,UACxB,CAAC,KAAK,OAAO,QAAQ,SAAS,KAAc,GAC5C;AACA,YAAM,IAAI,aAAa,kBAAkB;AAAA,QACvC,mBAAmB;AAAA,UACjB;AAAA,UACA,KAAK;AAAA,UACL,KAAK,OAAO,QAAQ,IAAI,CAAC,WAAW,IAAI,MAAM,GAAG,EAAE,KAAK,IAAI;AAAA,QAC9D;AAAA,MACF,CAAC;AAAA,IACH;AAEA,QAAI,KAAK,OAAO,UAAU;AACxB,WAAK,OAAO,KAAK,KAAK;AAAA,IACxB,OAAO;AACL,WAAK,SAAS,CAAC,KAAK;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,aAAa;AACX,QAAI,CAAC,KAAK,OAAO,YAAY,KAAK,OAAO,WAAW,GAAG;AACrD,aAAO;AAAA,IACT;AAEA,QACE,KAAK,OAAO,YACZ,OAAO,KAAK,OAAO,UAAU,YAC7B,KAAK,OAAO,UAAW,KAAK,uBAAiD,CAAC,GAAG,WAC/E,KAAK,OAAO,OACd;AACA,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,WAAW;AACT,QAAI,EAAC,QAAQ,oBAAmB,IAAI;AACpC,QAAI,EAAC,OAAM,IAAI;AAEf,QAAI,OAAO,SAAS,aAAa,CAAC,OAAO,YAAY,CAAC,OAAO,QAAQ;AACnE,eAAS,CAAC,IAAI;AAAA,IAChB,WAAW,OAAO,SAAS,YAAY,OAAO,SAAS,CAAC,OAAO,QAAQ;AACrE,eAAS,CAAC,CAAC;AAAA,IACb;AAEA,QAAI,OAAO,YAAY,qBAAqB;AAC1C,eAAS,CAAC,GAAI,qBAAmC,GAAG,MAAM;AAAA,IAC5D;AAEA,QAAI,OAAO,SAAS,YAAY,OAAO,SAAS,qBAAqB;AACnE,eAAS,CAAE,OAAO,CAAC,IAAgB,mBAA8B;AAAA,IACnE;AAEA,WAAO,OAAO,WAAW,SAAS,OAAO,CAAC;AAAA,EAC5C;AACF;",
+  "names": []
+}