zod-args-parser 2.0.0-beta.1 → 2.0.0-beta.2

package/lib/types/cli-error/cli-error.d.ts

@@ -0,0 +1,152 @@
+import type { CliErrorImpl, CliErrorOptionUnion } from "../types/error-types.ts";
+export declare class CliError extends Error implements CliErrorImpl {
+    readonly code: "MissingPreparedTypes" | "CannotFindCliDefinition" | "UnknownSubcommand" | "CommandWithoutOptions" | "UnknownOption" | "DuplicateOptionProvided" | "InvalidNegationForNonBooleanOption" | "PositionalArgumentNotAllowed" | "MissingRequiredOption" | "MissingRequiredArgument" | "OptionMissingValue" | "FlagAssignedValue" | "NoOptionsToValidate" | "NoArgumentsToValidate" | "UnknownOptionValidation" | "UnknownArgumentValidation" | "SchemaValidationFailed" | "MutuallyExclusiveConflict" | "RequiredDependencyMissing" | "AsyncSchemaNotSupported" | "CoercionFailed" | "MissingDefinitionName" | "MissingOnExecute" | "MissingSchema" | "EmptyDefinitionGroup" | "InvalidDefinitionOptionName" | "DuplicateDefinitionName" | "InvalidDefinitionArgumentName" | "InvalidOptionalArgumentDefinition" | "EmptyStringAliasName" | "SelfRequire" | "UnknownRequireName" | "SelfConflict" | "UnknownConflictName" | "DefinitionRequiresConflictOverlap" | "SubcommandHelpNotFound";
+    readonly cause: "Internal" | "Parse" | "Validation" | "Definition";
+    readonly context: {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly kind: "option" | "argument";
+        readonly name: string;
+    } | {
+        readonly cliName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly kind: "option" | "argument";
+        readonly name: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly kind: "option" | "argument" | "subcommands";
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly optionName: string;
+        readonly negatedAliasName?: string | undefined;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly kind: "option" | "subcommand";
+        readonly name: string;
+        readonly duplicatedAlias?: string | undefined;
+        readonly foundInKind: "option" | "argument" | "subcommand";
+        readonly foundInName?: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly name: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly name: string;
+        readonly allowPositionals: boolean;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly optionName?: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly kind: "option" | "argument";
+        readonly name: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly kind: "option" | "argument";
+        readonly name: string;
+        readonly requiredName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly kind: "option" | "argument";
+        readonly name: string;
+        readonly intersectedNames: readonly string[];
+    } | {
+        readonly cliName: string;
+        readonly subcommandName: string;
+    } | {
+        readonly commandName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly optionName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly optionName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly optionName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly optionName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly argumentName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly optionName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly argumentName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly optionName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly flag: string;
+        readonly value: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly optionName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly argumentName: string;
+    } | {
+        readonly commandKind: "command" | "subcommand";
+        readonly commandName: string;
+        readonly kind: "option" | "argument";
+        readonly name: string;
+        readonly inputValue: unknown;
+        readonly issues: ReadonlyArray<import("@standard-schema/spec").StandardSchemaV1.Issue>;
+    } | {
+        readonly kind: "option" | "argument";
+        readonly name: string;
+        readonly conflictedOptions: readonly string[];
+        readonly conflictedArguments: readonly string[];
+    } | {
+        readonly kind: "option" | "argument";
+        readonly name: string;
+        readonly missingOptions: readonly string[];
+        readonly missingArguments: readonly string[];
+    } | {
+        value: unknown;
+        schema: import("../types/schema-types.ts").SchemaType;
+    } | {
+        readonly providedValue: unknown;
+        readonly coerceToType: string;
+    };
+    constructor(options: CliErrorOptionUnion);
+    static errorMessage(options: CliErrorOptionUnion): string;
+}
+//# sourceMappingURL=cli-error.d.ts.map

package/lib/types/cli-error/cli-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-error.d.ts","sourceRoot":"","sources":["../../../src/cli-error/cli-error.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEjF,qBAAa,QAAS,SAAQ,KAAM,YAAW,YAAY;IACzD,QAAQ,CAAC,IAAI,w7BAAC;IACd,QAAQ,CAAC,KAAK,qDAAC;IACf,QAAQ,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAC;gBAEL,OAAO,EAAE,mBAAmB;IAQxC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM;CAsB1D"}

package/lib/types/cli-error/error-cause.d.ts

@@ -0,0 +1,5 @@
+import type { ErrorCauseI } from "../types/error-types.ts";
+export declare const ErrorCause: {
+    [K in keyof ErrorCauseI]: K;
+};
+//# sourceMappingURL=error-cause.d.ts.map

package/lib/types/cli-error/error-cause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-cause.d.ts","sourceRoot":"","sources":["../../../src/cli-error/error-cause.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,eAAO,MAAM,UAAU,EAAE;KAAG,CAAC,IAAI,MAAM,WAAW,GAAG,CAAC;CAKpD,CAAC"}

package/lib/types/cli-error/error-code/definition-error-code.d.ts

@@ -0,0 +1,5 @@
+import type { DefinitionErrorI } from "../../types/error-types.ts";
+export declare const DefinitionErrorCode: {
+    [K in keyof DefinitionErrorI]: K;
+};
+//# sourceMappingURL=definition-error-code.d.ts.map

package/lib/types/cli-error/error-code/definition-error-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-error-code.d.ts","sourceRoot":"","sources":["../../../../src/cli-error/error-code/definition-error-code.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,eAAO,MAAM,mBAAmB,EAAE;KAAG,CAAC,IAAI,MAAM,gBAAgB,GAAG,CAAC;CAgBlE,CAAC"}

package/lib/types/cli-error/error-code/internal-error-code.d.ts

@@ -0,0 +1,5 @@
+import type { InternalErrorI } from "../../types/error-types.ts";
+export declare const InternalErrorCode: {
+    [K in keyof InternalErrorI]: K;
+};
+//# sourceMappingURL=internal-error-code.d.ts.map

package/lib/types/cli-error/error-code/internal-error-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-error-code.d.ts","sourceRoot":"","sources":["../../../../src/cli-error/error-code/internal-error-code.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,eAAO,MAAM,iBAAiB,EAAE;KAAG,CAAC,IAAI,MAAM,cAAc,GAAG,CAAC;CAG9D,CAAC"}

package/lib/types/cli-error/error-code/parse-error-code.d.ts

@@ -0,0 +1,5 @@
+import type { ParseErrorI } from "../../types/error-types.ts";
+export declare const ParseErrorCode: {
+    [K in keyof ParseErrorI]: K;
+};
+//# sourceMappingURL=parse-error-code.d.ts.map

package/lib/types/cli-error/error-code/parse-error-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-error-code.d.ts","sourceRoot":"","sources":["../../../../src/cli-error/error-code/parse-error-code.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,eAAO,MAAM,cAAc,EAAE;KAAG,CAAC,IAAI,MAAM,WAAW,GAAG,CAAC;CAWxD,CAAC"}

package/lib/types/cli-error/error-code/validation-error-code.d.ts

@@ -0,0 +1,5 @@
+import type { ValidationErrorI } from "../../types/error-types.ts";
+export declare const ValidationErrorCode: {
+    [K in keyof ValidationErrorI]: K;
+};
+//# sourceMappingURL=validation-error-code.d.ts.map

package/lib/types/cli-error/error-code/validation-error-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error-code.d.ts","sourceRoot":"","sources":["../../../../src/cli-error/error-code/validation-error-code.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,eAAO,MAAM,mBAAmB,EAAE;KAAG,CAAC,IAAI,MAAM,gBAAgB,GAAG,CAAC;CAUlE,CAAC"}

package/lib/types/cli-error/error-message/definition-error-message.d.ts

@@ -0,0 +1,3 @@
+import type { CliErrorOptionByCause } from "../../types/error-types.ts";
+export declare function definitionErrorMessage({ code, context }: CliErrorOptionByCause<"Definition">): string;
+//# sourceMappingURL=definition-error-message.d.ts.map

package/lib/types/cli-error/error-message/definition-error-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-error-message.d.ts","sourceRoot":"","sources":["../../../../src/cli-error/error-message/definition-error-message.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,wBAAgB,sBAAsB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,qBAAqB,CAAC,YAAY,CAAC,UA2I5F"}

package/lib/types/cli-error/error-message/internal-error-message.d.ts

@@ -0,0 +1,3 @@
+import type { CliErrorOptionByCause } from "../../types/error-types.ts";
+export declare function internalErrorMessage({ code, context }: CliErrorOptionByCause<"Internal">): string;
+//# sourceMappingURL=internal-error-message.d.ts.map

package/lib/types/cli-error/error-message/internal-error-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-error-message.d.ts","sourceRoot":"","sources":["../../../../src/cli-error/error-message/internal-error-message.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,wBAAgB,oBAAoB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,qBAAqB,CAAC,UAAU,CAAC,UAcxF"}

package/lib/types/cli-error/error-message/parse-error-message.d.ts

@@ -0,0 +1,3 @@
+import type { CliErrorOptionByCause } from "../../types/error-types.ts";
+export declare function parseErrorMessage({ code, context }: CliErrorOptionByCause<"Parse">): string;
+//# sourceMappingURL=parse-error-message.d.ts.map

package/lib/types/cli-error/error-message/parse-error-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-error-message.d.ts","sourceRoot":"","sources":["../../../../src/cli-error/error-message/parse-error-message.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,qBAAqB,CAAC,OAAO,CAAC,UAuElF"}

package/lib/types/cli-error/error-message/validation-error-message.d.ts

@@ -0,0 +1,3 @@
+import type { CliErrorOptionByCause } from "../../types/error-types.ts";
+export declare function validationErrorMessage({ code, context }: CliErrorOptionByCause<"Validation">): string;
+//# sourceMappingURL=validation-error-message.d.ts.map

package/lib/types/cli-error/error-message/validation-error-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error-message.d.ts","sourceRoot":"","sources":["../../../../src/cli-error/error-message/validation-error-message.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,wBAAgB,sBAAsB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,qBAAqB,CAAC,YAAY,CAAC,UAkG5F"}

package/lib/types/coerce/coerce-methods.d.ts

@@ -0,0 +1,122 @@
+import type { ObjectCoerceMethodOptions } from "../types/types.ts";
+export declare const coerce: {
+    /**
+     * Since the terminal input is a string, this method does nothing.
+     *
+     * @since 2.0.0
+     * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}
+     */
+    string: <T extends string | undefined>(terminalInput: string) => T;
+    /**
+     * Coerces a string matching `"true"` or `"false"` (case-insensitive) to a boolean value.
+     *
+     * @since 2.0.0
+     * @throws {CliError} If input is not a valid boolean string.
+     * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}
+     */
+    boolean: {
+        <T extends boolean | undefined>(terminalInput: string): T;
+        type: string;
+    };
+    /**
+     * Coerces a string matching a number to a number value.
+     *
+     * @since 2.0.0
+     * @throws {CliError} If input is empty or not a valid number.
+     * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}
+     */
+    number: <T extends number | undefined>(terminalInput: string) => T;
+    /**
+     * Coerces a string matching a number to a bigint value.
+     *
+     * @since 2.0.0
+     * @throws {CliError} If input is empty or not a valid bigint.
+     * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}
+     */
+    bigint: <T extends bigint | undefined>(terminalInput: string) => T;
+    /**
+     * Coerces a JSON string into a JavaScript object, optionally converting certain string values into native types such
+     * as booleans, numbers, bigints, or dates.
+     *
+     * Each coercion option attempts conversion and silently falls back to the original string if the value cannot be
+     * converted.
+     *
+     * @since 2.0.0
+     * @throws {SyntaxError} 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}
+     */
+    object: (options?: ObjectCoerceMethodOptions) => <T extends Record<string, unknown> | undefined>(terminalInput: string) => T;
+    /**
+     * Converts a string to an array of strings by splitting it on the specified separator.
+     *
+     * @since 2.0.0
+     * @param separator - The separator to use to split the string.`
+     * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}
+     */
+    stringArray: (separator: string) => <T extends string[] | undefined>(terminalInput: string) => T;
+    /**
+     * Converts a string to an array of numbers by splitting it on the specified separator.
+     *
+     * Items that match the number regex will be converted to numbers.
+     *
+     * @since 2.0.0
+     * @param separator - The separator to use to split the string.`
+     * @throws {CliError} - When an item cannot be converted to a number
+     * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}
+     */
+    numberArray: (separator: string) => <T extends number[] | undefined>(terminalInput: string) => T;
+    /**
+     * Converts a string to an array of booleans by splitting it on the specified separator.
+     *
+     * Items that match `"true"` or `"false"` (case-insensitive) will be converted to booleans.
+     *
+     * @since 2.0.0
+     * @param separator - The separator to use to split the string.`
+     * @throws {CliError} - When an item cannot be converted to a boolean
+     * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}
+     */
+    booleanArray: (separator: string) => <T extends boolean[] | undefined>(terminalInput: string) => T;
+    /**
+     * Converts a string to a set of strings by splitting it on the specified separator.
+     *
+     * Items that match the number regex will be converted to numbers.
+     *
+     * @since 2.0.0
+     * @param separator - The separator to use to split the string.`
+     * @throws {CliError} - When an item cannot be converted to a number
+     * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}
+     */
+    stringSet: (separator: string) => <T extends Set<string> | undefined>(terminalInput: string) => T;
+    /**
+     * Converts a string to a set of numbers by splitting it on the specified separator.
+     *
+     * Items that match the number regex will be converted to numbers.
+     *
+     * @since 2.0.0
+     * @param separator - The separator to use to split the string.
+     * @throws {CliError} - When an item cannot be converted to a number
+     * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}
+     */
+    numberSet: (separator: string) => <T extends Set<number> | undefined>(terminalInput: string) => T;
+    /**
+     * Converts a string to a set of booleans by splitting it on the specified separator.
+     *
+     * Items that match `"true"` or `"false"` (case-insensitive) will be converted to booleans.
+     *
+     * @since 2.0.0
+     * @param separator - The separator to use to split the string.
+     * @throws {CliError} - When an item cannot be converted to a boolean
+     * @see {@link https://github.com/alabsi91/zod-args-parser/blob/main/docs/api-reference.md#coerce-helpers}
+     */
+    booleanSet: (separator: string) => <T extends Set<boolean> | undefined>(terminalInput: string) => T;
+    /**
+     * Parses a JSON string into a JavaScript object.
+     *
+     * @since 2.0.0
+     * @throws {SyntaxError} 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: <T>(terminalInput: string) => T;
+};
+//# sourceMappingURL=coerce-methods.d.ts.map

package/lib/types/coerce/coerce-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce-methods.d.ts","sourceRoot":"","sources":["../../../src/coerce/coerce-methods.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAiGnE,eAAO,MAAM,MAAM;IACjB;;;;;OAKG;aArGW,CAAC,SAAS,MAAM,GAAG,SAAS,iBAAiB,MAAM,KAAG,CAAC;IAwGrE;;;;;;OAMG;;SA1GY,CAAC,SAAS,OAAO,GAAG,SAAS,iBAAiB,MAAM,GAAG,CAAC;;;IA6GvE;;;;;;OAMG;aAtHW,CAAC,SAAS,MAAM,GAAG,SAAS,iBAAiB,MAAM,KAAG,CAAC;IAyHrE;;;;;;OAMG;aA9HW,CAAC,SAAS,MAAM,GAAG,SAAS,iBAAiB,MAAM,KAAG,CAAC;IAiIrE;;;;;;;;;;;OAWG;uBAzGoB,yBAAyB,MAC1B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iBAAiB,MAAM,KAAG,CAAC;IA2G9F;;;;;;OAMG;6BAhJ2B,MAAM,MAC5B,CAAC,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,eAAe,MAAM,KAAG,CAAC;IAkJjE;;;;;;;;;OASG;6BAvJ2B,MAAM,MAC5B,CAAC,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,eAAe,MAAM,KAAG,CAAC;IAyJjE;;;;;;;;;OASG;8BA9J4B,MAAM,MAC7B,CAAC,SAAS,OAAO,EAAE,GAAG,SAAS,EAAE,eAAe,MAAM,KAAG,CAAC;IAgKlE;;;;;;;;;OASG;2BArKyB,MAAM,MAC1B,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,EAAE,eAAe,MAAM,KAAG,CAAC;IAuKpE;;;;;;;;;OASG;2BA5KyB,MAAM,MAC1B,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,EAAE,eAAe,MAAM,KAAG,CAAC;IA8KpE;;;;;;;;;OASG;4BAnL0B,MAAM,MAC3B,CAAC,SAAS,GAAG,CAAC,OAAO,CAAC,GAAG,SAAS,EAAE,eAAe,MAAM,KAAG,CAAC;IAqLrE;;;;;;OAMG;WAzNS,CAAC,iBAAiB,MAAM,KAAG,CAAC;CA2NzC,CAAC"}

package/lib/{typescript → types}/coerce/string-to-array.d.ts

@@ -1,6 +1,6 @@
 export declare function stringToStringArray(stringValue: string, separator?: string): string[];
-/** @throws {TypeError} - Because of `stringToNumber` */
+/** @throws {CliError} - Because of `stringToNumber` */
 export declare function stringToNumberArray(stringValue: string, separator?: string): number[];
-/** @throws {TypeError} - Because of `stringToBoolean` */
+/** @throws {CliError} - Because of `stringToBoolean` */
 export declare function stringToBooleanArray(stringValue: string, separator?: string): boolean[];
 //# sourceMappingURL=string-to-array.d.ts.map

package/lib/types/coerce/string-to-array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-to-array.d.ts","sourceRoot":"","sources":["../../../src/coerce/string-to-array.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,EAAE,CAK1F;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,EAAE,CAE1F;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,OAAO,EAAE,CAE5F"}

package/lib/types/coerce/string-to-primitive.d.ts

@@ -0,0 +1,21 @@
+/** @throws {CliError} */
+export declare function stringToBoolean(string: string): boolean;
+/**
+ * Converts a string to a finite number.
+ *
+ * @throws {CliError} If input is empty, invalid, or not a finite number.
+ */
+export declare function stringToNumber(value: string): number;
+/**
+ * Converts a string to a bigint.
+ *
+ * @throws {CliError} If input is empty or not a valid bigint.
+ */
+export declare function stringToBigint(value: string): bigint;
+/**
+ * Converts a string to a valid Date object.
+ *
+ * @throws {CliError} If input is not a valid date string.
+ */
+export declare function stringToDate(value: string): Date;
+//# sourceMappingURL=string-to-primitive.d.ts.map

package/lib/types/coerce/string-to-primitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-to-primitive.d.ts","sourceRoot":"","sources":["../../../src/coerce/string-to-primitive.ts"],"names":[],"mappings":"AAIA,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAcvD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBpD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmBpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAUhD"}

package/lib/{typescript → types}/coerce/string-to-set.d.ts

@@ -1,6 +1,6 @@
 export declare function stringToStringSet(stringValue: string, separator?: string): Set<string>;
-/** @throws {TypeError} - Because of `stringToNumber` */
+/** @throws {CliError} - Because of `stringToNumber` */
 export declare function stringToNumberSet(stringValue: string, separator?: string): Set<number>;
-/** @throws {TypeError} - Because of `stringToBoolean` */
+/** @throws {CliError} - Because of `stringToBoolean` */
 export declare function stringToBooleanSet(stringValue: string, separator?: string): Set<boolean>;
 //# sourceMappingURL=string-to-set.d.ts.map

package/lib/{typescript → types}/coerce/string-to-set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string-to-set.d.ts","sourceRoot":"","sources":["../../../src/coerce/string-to-set.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAE3F;AAED,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAE3F;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,GAAG,CAAC,OAAO,CAAC,CAE7F"}
+{"version":3,"file":"string-to-set.d.ts","sourceRoot":"","sources":["../../../src/coerce/string-to-set.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAE3F;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAE3F;AAED,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,GAAG,CAAC,OAAO,CAAC,CAE7F"}

package/lib/{typescript → types}/definitions/define-cli.d.ts

@@ -1,5 +1,6 @@
 import type { Argument, Cli, Option, Subcommand } from "../types/definitions-types.ts";
 import type { AttachedMethods, ValidateMethods } from "../types/types.ts";
+import type { Prettify } from "../types/utilities-types.ts";
 type OptionsInput<T> = T extends Record<string, Option> ? {
     [OptionName in keyof T]: Option<T[OptionName]["schema"]>;
 } : T;
@@ -14,11 +15,6 @@ type SubcommandsInput<T extends readonly [Subcommand, ...Subcommand[]]> = {
 type CliInput<T extends Cli> = {
     [K in keyof T]: K extends keyof Cli ? T[K] extends readonly [Subcommand, ...Subcommand[]] ? SubcommandsInput<T[K]> : K extends "options" ? OptionsInput<T[K]> : K extends "arguments" ? ArgumentsInput<T[K]> : T[K] : never;
 };
-export declare function defineCLI<T extends Cli>(input: CliInput<T> & Cli): (T & AttachedMethods<T> & ValidateMethods<T> extends infer T_1 ? { [K in keyof T_1]: T_1[K]; } : never) & {
-    execute: (input?: import("../index.ts").InputTypeWide) => void;
-    onExecute: (handler: (Cli["_onExecute"] & {})[number]) => () => void;
-    run: (stringOrArgv: string | string[]) => import("../types/types.ts").CliParseResultWide;
-    runAsync: (stringOrArgv: string | string[]) => Promise<import("../types/types.ts").CliParseResultWide>;
-};
+export declare function defineCLI<T extends Cli>(input: CliInput<T> & Cli): Prettify<T & AttachedMethods<T> & ValidateMethods<T>>;
 export {};
 //# sourceMappingURL=define-cli.d.ts.map

package/lib/types/definitions/define-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-cli.d.ts","sourceRoot":"","sources":["../../../src/definitions/define-cli.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAuB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,KAAK,YAAY,CAAC,CAAC,IACjB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;KAAG,UAAU,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC;CAAE,GAAG,CAAC,CAAC;AAEtG,KAAK,cAAc,CAAC,CAAC,IACnB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG;KAAG,YAAY,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC;CAAE,GAAG,CAAC,CAAC;AAE9G,KAAK,gBAAgB,CAAC,CAAC,SAAS,SAAS,CAAC,UAAU,EAAE,GAAG,UAAU,EAAE,CAAC,IAAI;KACvE,eAAe,IAAI,MAAM,CAAC,GAAG;SAC3B,CAAC,IAAI,MAAM,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjF,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,GACnC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GACpD,cAAc,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,GACrC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;KAC5B,GAAG,UAAU;CACf,CAAC;AAGF,KAAK,QAAQ,CAAC,CAAC,SAAS,GAAG,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,GAAG,GAC/B,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,UAAU,EAAE,GAAG,UAAU,EAAE,CAAC,GACjD,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACtB,CAAC,SAAS,SAAS,GACjB,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClB,CAAC,SAAS,WAAW,GACnB,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACpB,CAAC,CAAC,CAAC,CAAC,GACV,KAAK;CACV,CAAC;AAEF,wBAAgB,SAAS,CAAC,CAAC,SAAS,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,GA4F6B,QAAQ,CAClG,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAC5C,CACF"}

package/lib/{typescript → types}/definitions/define-subcommand.d.ts

@@ -1,5 +1,6 @@
 import type { Argument, Option, Subcommand } from "../types/definitions-types.ts";
 import type { AttachedMethods } from "../types/types.ts";
+import type { Prettify } from "../types/utilities-types.ts";
 type OptionsInput<T> = T extends Record<string, Option> ? {
     [OptionName in keyof T]: Option<T[OptionName]["schema"]>;
 } : T;
@@ -9,9 +10,6 @@ type ArgumentsInput<T> = T extends Record<string, Argument> ? {
 type SubcommandInput<T extends Subcommand> = {
     [K in keyof T]: K extends keyof Subcommand ? K extends "options" ? OptionsInput<T[K]> : K extends "arguments" ? ArgumentsInput<T[K]> : T[K] : never;
 };
-export declare function defineSubcommand<T extends Subcommand>(input: SubcommandInput<T> & Subcommand): (T & AttachedMethods<T> extends infer T_1 ? { [K in keyof T_1]: T_1[K]; } : never) & {
-    onExecute: (handler: (Subcommand["_onExecute"] & {})[number]) => () => void;
-    execute: (input?: import("../index.ts").InputTypeWide) => void;
-};
+export declare function defineSubcommand<T extends Subcommand>(input: SubcommandInput<T> & Subcommand): Prettify<T & AttachedMethods<T>>;
 export {};
 //# sourceMappingURL=define-subcommand.d.ts.map

package/lib/types/definitions/define-subcommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-subcommand.d.ts","sourceRoot":"","sources":["../../../src/definitions/define-subcommand.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,KAAK,YAAY,CAAC,CAAC,IACjB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;KAAG,UAAU,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC;CAAE,GAAG,CAAC,CAAC;AAEtG,KAAK,cAAc,CAAC,CAAC,IACnB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG;KAAG,YAAY,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC;CAAE,GAAG,CAAC,CAAC;AAG9G,KAAK,eAAe,CAAC,CAAC,SAAS,UAAU,IAAI;KAC1C,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,UAAU,GACtC,CAAC,SAAS,SAAS,GACjB,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClB,CAAC,SAAS,WAAW,GACnB,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACpB,CAAC,CAAC,CAAC,CAAC,GACR,KAAK;CACV,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,GAyDP,QAAQ,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CACrH"}

package/lib/{typescript → types}/definitions/validate-cli-definition.d.ts

@@ -1,4 +1,4 @@
 import type { Cli } from "../types/definitions-types.ts";
-/** @throws {Error} If validation fails. */
+/** @throws {CliError} If validation fails. */
 export declare function validateCliDefinition(cliDefinition: Cli): void;
 //# sourceMappingURL=validate-cli-definition.d.ts.map

package/lib/types/definitions/validate-cli-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-cli-definition.d.ts","sourceRoot":"","sources":["../../../src/definitions/validate-cli-definition.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,GAAG,EAAc,MAAM,+BAA+B,CAAC;AAErE,8CAA8C;AAC9C,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,GAAG,QA8GvD"}

package/lib/{typescript → types}/help-message/terminal-markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-markdown.d.ts","sourceRoot":"","sources":["../../../src/help-message/terminal-markdown.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AA+HxE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,UAAU,GAAG,MAAmB,EAC1C,aAAa,GAAE,iBAAmD,GACjE,MAAM,CAYR"}
+{"version":3,"file":"terminal-markdown.d.ts","sourceRoot":"","sources":["../../../src/help-message/terminal-markdown.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AA4HxE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,UAAU,GAAG,MAAmB,EAC1C,aAAa,GAAE,iBAAmD,GACjE,MAAM,CAcR"}

package/lib/{typescript → types}/index.d.ts

@@ -15,8 +15,15 @@ export { defineCLI } from "./definitions/define-cli.ts";
 export { defineOptions } from "./definitions/define-options.ts";
 export { defineSubcommand } from "./definitions/define-subcommand.ts";
 export { coerce } from "./coerce/coerce-methods.ts";
+export { CliError } from "./cli-error/cli-error.ts";
+export { ErrorCause } from "./cli-error/error-cause.ts";
+export { DefinitionErrorCode } from "./cli-error/error-code/definition-error-code.ts";
+export { InternalErrorCode } from "./cli-error/error-code/internal-error-code.ts";
+export { ParseErrorCode } from "./cli-error/error-code/parse-error-code.ts";
+export { ValidationErrorCode } from "./cli-error/error-code/validation-error-code.ts";
 export type * from "./types/context-types.ts";
 export type * from "./types/definitions-types.ts";
+export type { CliErrorI, CliErrorOptionUnion, DefinitionErrorI, ErrorCauseI, InternalErrorI, ParseErrorI, ValidationErrorI, } from "./types/error-types.ts";
 export type * from "./types/help-message-types.ts";
 export type * from "./types/io-types.ts";
 export type * from "./types/metadata-types.ts";

package/lib/{typescript → types}/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,oDAAoD,CAAC;AACpG,OAAO,EAAE,oCAAoC,EAAE,MAAM,0DAA0D,CAAC;AAChH,OAAO,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAC;AAClG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,mBAAmB,0BAA0B,CAAC;AAC9C,mBAAmB,8BAA8B,CAAC;AAClD,mBAAmB,+BAA+B,CAAC;AACnD,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,2BAA2B,CAAC;AAC/C,mBAAmB,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,oDAAoD,CAAC;AACpG,OAAO,EAAE,oCAAoC,EAAE,MAAM,0DAA0D,CAAC;AAChH,OAAO,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAC;AAClG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAEtF,mBAAmB,0BAA0B,CAAC;AAC9C,mBAAmB,8BAA8B,CAAC;AAClD,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,WAAW,EACX,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,mBAAmB,+BAA+B,CAAC;AACnD,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,2BAA2B,CAAC;AAC/C,mBAAmB,kBAAkB,CAAC"}

package/lib/{typescript → types}/metadata/arguments-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arguments-metadata.d.ts","sourceRoot":"","sources":["../../../src/metadata/arguments-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,wBAAgB,oBAAoB,CAAC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,gBAAgB,EAAE,CAsBtG"}
+{"version":3,"file":"arguments-metadata.d.ts","sourceRoot":"","sources":["../../../src/metadata/arguments-metadata.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,wBAAgB,oBAAoB,CAAC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,gBAAgB,EAAE,CAsBtG"}

package/lib/{typescript → types}/metadata/options-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options-metadata.d.ts","sourceRoot":"","sources":["../../../src/metadata/options-metadata.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,wBAAgB,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,EAAE,CA+B9F"}
+{"version":3,"file":"options-metadata.d.ts","sourceRoot":"","sources":["../../../src/metadata/options-metadata.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,wBAAgB,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,EAAE,CA+B9F"}

package/lib/{typescript → types}/parse/context/cli-context-builder.d.ts

@@ -3,7 +3,7 @@ import type { Cli } from "../../types/definitions-types.ts";
 /**
  * Parse argv and create a cli context
  *
- * @throws {Error}
+ * @throws {CliError}
  */
 export declare function buildCliContext(argv: string[], cliDefinition: Cli): ContextWide;
 //# sourceMappingURL=cli-context-builder.d.ts.map

package/lib/{typescript → types}/parse/context/cli-context-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-context-builder.d.ts","sourceRoot":"","sources":["../../../../src/parse/context/cli-context-builder.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kCAAkC,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,GAAG,eAoOjE"}
+{"version":3,"file":"cli-context-builder.d.ts","sourceRoot":"","sources":["../../../../src/parse/context/cli-context-builder.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kCAAkC,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,GAAG,eA+VjE"}

package/lib/{typescript → types}/parse/context/object-context-builder.d.ts

@@ -1,6 +1,6 @@
 import type { ContextWide } from "../../types/context-types.ts";
 import type { Cli, Subcommand } from "../../types/definitions-types.ts";
 import type { InputTypeWide } from "../../types/io-types.ts";
-/** @throws {Error} */
+/** @throws {CliError} */
 export declare function buildObjectContext(inputValues: InputTypeWide, commandDefinition: Subcommand | Cli): ContextWide;
 //# sourceMappingURL=object-context-builder.d.ts.map

package/lib/types/parse/context/object-context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-context-builder.d.ts","sourceRoot":"","sources":["../../../../src/parse/context/object-context-builder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAY,GAAG,EAAU,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,yBAAyB;AACzB,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,GAAG,GAAG,eAcjG"}

package/lib/{typescript → types}/parse/parser-utilities.d.ts

@@ -46,4 +46,13 @@ export declare function isOptionArgument(name: string | boolean): boolean;
 export declare function negateOption(name: string): string;
 /** - Reverse of `transformArg`. E.g. `InputDir` -> `--input-dir` , `i` -> `-i` */
 export declare function transformOptionToArgument(name: string): string;
+/**
+ * Split an option with keys into name and a set of keys
+ *
+ * - `--foo` -> `[--foo, []]`
+ * - `--foo.bar` -> `[--foo, ["bar"]]`
+ * - `--foo.bar.baz` -> `[--foo, ["bar", "baz"]]`
+ * - `--foo.bar.` -> `[--foo, Set(1) ["bar"]]`
+ */
+export declare function splitAndGetKeys(option: string): [string, string[]];
 //# sourceMappingURL=parser-utilities.d.ts.map

package/lib/{typescript → types}/parse/parser-utilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser-utilities.d.ts","sourceRoot":"","sources":["../../../src/parse/parser-utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE7E;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,aAAa,EAAE,GAAG,GACjB,UAAU,GAAG,GAAG,GAAG,SAAS,CAkB9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CA+BhH;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAqB5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAyBvE;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAOD,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAMhE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,kFAAkF;AAClF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB9D"}
+{"version":3,"file":"parser-utilities.d.ts","sourceRoot":"","sources":["../../../src/parse/parser-utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE7E;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,aAAa,EAAE,GAAG,GACjB,UAAU,GAAG,GAAG,GAAG,SAAS,CAkB9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CA6BhH;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAqB5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAqBvE;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAYD,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAMhE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,kFAAkF;AAClF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB9D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAKlE"}

package/lib/{typescript → types}/parse/safe-parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safe-parse.d.ts","sourceRoot":"","sources":["../../../src/parse/safe-parse.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,aAAa,EAAE,GAAG,GAAG,kBAAkB,CAcjG;AAED,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,aAAa,EAAE,GAAG,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAerH"}
+{"version":3,"file":"safe-parse.d.ts","sourceRoot":"","sources":["../../../src/parse/safe-parse.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,aAAa,EAAE,GAAG,GAAG,kBAAkB,CAcjG;AAED,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,aAAa,EAAE,GAAG,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAYrH"}

package/lib/{typescript → types}/parse/validation/validate-context.d.ts

@@ -1,6 +1,6 @@
 import type { ContextWide } from "../../types/context-types.ts";
 import type { Cli, Subcommand } from "../../types/definitions-types.ts";
 import type { OutputTypeWide } from "../../types/io-types.ts";
-/** @throws {Error} */
+/** @throws {CliError} */
 export declare function validate(context: ContextWide, commandDefinition: Subcommand | Cli): OutputTypeWide;
 //# sourceMappingURL=validate-context.d.ts.map

package/lib/{typescript → types}/parse/validation/validate-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-context.d.ts","sourceRoot":"","sources":["../../../../src/parse/validation/validate-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,sBAAsB;AACtB,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,GAAG,GAAG,kBAcjF"}
+{"version":3,"file":"validate-context.d.ts","sourceRoot":"","sources":["../../../../src/parse/validation/validate-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,yBAAyB;AACzB,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,GAAG,GAAG,kBAcjF"}