zod-args-parser 1.2.8 → 2.0.0-beta.0

package/lib/typescript/types.d.ts

@@ -1,294 +0,0 @@
-import type * as Z3 from "zod/v3";
-import type * as Z4 from "zod/v4/core";
-import type { ParseResult } from "./parser/parse/parse-types.js";
-import type { ValidateResult } from "./parser/validate/validate-type.js";
-export type SchemaV3 = Z3.ZodTypeAny;
-export type SchemaV4 = Z4.$ZodType;
-export type Schema = SchemaV3 | SchemaV4;
-export type ZodInferOutput<T extends Schema> = T extends SchemaV4 ? Z4.infer<T> : T extends SchemaV3 ? Z3.infer<T> : never;
-export type ZodInferInput<T extends Schema> = T extends SchemaV4 ? Z4.input<T> : T extends SchemaV3 ? Z3.input<T> : never;
-export interface Subcommand {
-    /**
-     * - The subcommand name
-     * - Make sure to not duplicate commands and aliases.
-     *
-     * @example
-     *   name: "test";
-     *   name: "run-app";
-     */
-    name: string;
-    /**
-     * - The description of the subcommand.
-     * - Used for generating the help message.
-     */
-    description?: string;
-    /** - The usage message in the help message. */
-    usage?: string;
-    /** - Used for generating the help message. */
-    placeholder?: string;
-    /**
-     * - Provide an example to show to the user.
-     * - Used for generating the help message.
-     */
-    example?: string;
-    /**
-     * - The aliases of the subcommand.
-     * - Make sure to not duplicate aliases and commands.
-     */
-    aliases?: string[];
-    /**
-     * - Allows positional arguments for this subcommand.
-     * - Unlike `arguments`, which are strictly typed, positional arguments are untyped and represented as a string array of
-     *   variable length.
-     * - When enabled and `arguments` are provided, `arguments` will be parsed first. Any remaining arguments will be
-     *   considered positional arguments and added to the `positional` property in the result.
-     */
-    allowPositional?: boolean;
-    /**
-     * - The options of the command.
-     * - Those options are specific to this subcommand.
-     */
-    options?: [Option, ...Option[]];
-    /**
-     * - Specifies a list of strictly typed arguments.
-     * - The order is important; for example, the first argument will be validated against the first specified type.
-     * - It is recommended to not use optional arguments as the parser will fill the arguments by order and can't determine
-     *   which arguments are optional.
-     */
-    arguments?: [Argument, ...Argument[]];
-    /**
-     * - The action is executed with the result of the parsed arguments.
-     * - To get typescript types use `setAction` instead of this.
-     *
-     * @example
-     *   const helpCommand = createSubcommand({ name: "help", options: [...] });
-     *   helpCommand.setAction(res => console.log(res));
-     */
-    action?: (data?: any) => any;
-    /**
-     * - The preValidation hook is executed before the action.
-     * - To get typescript types use `setPreValidationHook` instead of this.
-     *
-     * @example
-     *   const helpCommand = createSubcommand({ name: "help", options: [...] });
-     *   helpCommand.setPreValidationHook(ctx => console.log(ctx));
-     */
-    preValidation?: (context?: any) => any;
-}
-export type Cli = Prettify<Omit<Subcommand, "name" | "aliases" | "placeholder"> & {
-    /** - The name of the CLI program. */
-    cliName: string;
-}>;
-export interface Option {
-    /**
-     * The name of the option, use a valid **JavaScript** variable name.\
-     * **Supports:** `camelCase`, `PascalCase`, `snake_case`, and `SCREAMING_SNAKE_CASE`.\
-     * **Examples:**
-     *
-     * - `I` or `i` ➡️ `-i`
-     * - `InputDir`, `inputDir`, or `INPUT_DIR` ➡️ `--input-dir`
-     * - `Help`, `help`, or `HELP` ➡️ `--help`
-     */
-    name: string;
-    /**
-     * - The will be used to validate the user input.
-     *
-     * @see https://zod.dev/api
-     */
-    type: Schema;
-    /**
-     * - The description of the option.
-     * - Used for generating the help message.
-     */
-    description?: string;
-    /** - Used for generating the help message. */
-    placeholder?: string;
-    /**
-     * - The example of using the option.
-     * - Used for generating the help message.
-     */
-    example?: string;
-    /**
-     * - The aliases of the option, use `CamelCase`.
-     * - Here you can specify short names or flags.
-     * - Make sure to not duplicate aliases.
-     */
-    aliases?: [string, ...string[]];
-}
-export interface Argument {
-    /** - The name of the argument. */
-    name: string;
-    /**
-     * - The will be used to validate the user input.
-     *
-     * @see https://zod.dev/api
-     */
-    type: Schema;
-    /**
-     * - The description of the argument.
-     * - Used for generating the help message.
-     */
-    description?: string;
-    /**
-     * - The example of using the argument.
-     * - Used for generating the help message.
-     */
-    example?: string;
-}
-export type ColorFunctionType = (...text: unknown[]) => string;
-/** - The colors to use for the help message. */
-export type HelpMessageStyle = Record<"title" | "description" | "default" | "optional" | "exampleTitle" | "example" | "command" | "option" | "argument" | "placeholder" | "punctuation", ColorFunctionType>;
-/**
- * - Infer the options type from a subcommand.
- *
- * @deprecated Use `InferOptionsOutput` instead.
- */
-export type InferOptionsType<T extends Partial<Subcommand>> = InferOptionsOutput<T>;
-/**
- * - Infer the options output type (after zod validation) from a subcommand.
- *
- * @example
- *   const subcommand = createSubcommand({ name: "build", options: [...] });
- *   type OptionsType = InferOptionsOutput<typeof subcommand>;
- */
-export type InferOptionsOutput<T extends Partial<Subcommand>> = T["options"] extends infer U extends Option[] ? ToOptional<{
-    [K in U[number]["name"]]: ZodInferOutput<Extract<U[number], {
-        name: K;
-    }>["type"]>;
-}> : undefined;
-/**
- * - Infer the options input type (before zod validation) from a subcommand.
- *
- * @example
- *   const subcommand = createSubcommand({ name: "build", options: [...] });
- *   type OptionsType = InferOptionsInput<typeof subcommand>;
- */
-export type InferOptionsInput<T extends Partial<Subcommand>> = T["options"] extends infer U extends Option[] ? ToOptional<{
-    [K in U[number]["name"]]: ZodInferInput<Extract<U[number], {
-        name: K;
-    }>["type"]>;
-}> : undefined;
-/**
- * - Infer the arguments output type (after zod validation) from a subcommand.
- *
- * @deprecated Use `InferArgumentsOutput` instead.
- */
-export type InferArgumentsType<T extends Partial<Subcommand>> = InferArgumentsOutput<T>;
-/**
- * - Infer the arguments output type (after zod validation) from a subcommand.
- *
- * @example
- *   const subcommand = createSubcommand({ name: "build", arguments: [...] });
- *   type ArgumentsType = InferArgumentsOutput<typeof subcommand>;
- */
-export type InferArgumentsOutput<T extends Partial<Subcommand>> = T["arguments"] extends infer U extends Argument[] ? {
-    [K in keyof U]: U[K] extends {
-        type: Schema;
-    } ? ZodInferOutput<U[K]["type"]> : never;
-} : undefined;
-/**
- * - Infer the arguments Input type (before zod validation) from a subcommand.
- *
- * @example
- *   const subcommand = createSubcommand({ name: "build", arguments: [...] });
- *   type ArgumentsType = InferArgumentsInput<typeof subcommand>;
- */
-export type InferArgumentsInput<T extends Partial<Subcommand>> = T["arguments"] extends infer U extends Argument[] ? {
-    [K in keyof U]: U[K] extends {
-        type: Schema;
-    } ? ZodInferInput<U[K]["type"]> : never;
-} : undefined;
-/** `{ some props } & { other props }` => `{ some props, other props }` */
-export type Prettify<T> = {
-    [K in keyof T]: T[K];
-} & {};
-/** Allow string type for literal union and get auto completion */
-export type LiteralUnion<T extends string> = T | (string & {});
-/** Extract the undefined properties from an object */
-export type UndefinedProperties<T> = {
-    [P in keyof T]-?: undefined extends T[P] ? P : never;
-}[keyof T];
-/** Make undefined properties optional? */
-export type ToOptional<T> = Prettify<Partial<Pick<T, UndefinedProperties<T>>> & Pick<T, Exclude<keyof T, UndefinedProperties<T>>>>;
-export type NoSubcommand = {
-    name: undefined;
-};
-export type PrintMethods<N extends Subcommand["name"]> = {
-    printCliHelp: (style?: Partial<HelpMessageStyle>) => void;
-    printSubcommandHelp: (subcommand: LiteralUnion<NonNullable<N>>, style?: Partial<HelpMessageStyle>) => void;
-};
-export type UnsafeParseResult<S extends Partial<Subcommand>[]> = CheckDuplicatedSubcommands<S> extends infer E extends string ? E : Prettify<ValidateResult<S> & PrintMethods<NonNullable<S[number]["name"]>>>;
-export type SafeParseResult<S extends Partial<Subcommand>[]> = CheckDuplicatedSubcommands<S> extends infer E extends string ? E : Prettify<({
-    success: false;
-    error: Error;
-} | {
-    success: true;
-    data: ValidateResult<S>;
-}) & PrintMethods<NonNullable<S[number]["name"]>>>;
-export type ActionsFunctions<T extends Subcommand | Cli> = {
-    setAction: (actions: (data: UnsafeParseResult<[T]>) => void) => void;
-    setPreValidationHook: (hook: (context: ParseResult<[T]>) => void) => void;
-};
-/** - Combine `name` and `aliases` to a `string[]` */
-type MapNameAndAliasesToStringArray<T extends {
-    name?: string;
-    aliases?: string[];
-}[]> = T extends [
-    infer First extends Subcommand,
-    ...infer Rest
-] ? Rest extends {
-    name?: string;
-    aliases?: string[];
-}[] ? [
-    First["name"],
-    ...(First["aliases"] extends string[] ? First["aliases"] : []),
-    ...MapNameAndAliasesToStringArray<Rest>
-] : [First["name"], ...(First["aliases"] extends string[] ? First["aliases"] : [])] : [];
-/**
- * - Find duplicated items in an array and return it
- * - Return `false` if not found
- */
-type IsDuplicatesInArray<Input extends any[]> = Input extends [infer Item, ...infer Rest] ? Rest extends any[] ? Item extends Rest[number] ? Item : IsDuplicatesInArray<Rest> : false : false;
-/**
- * - Check if there are duplicated options including aliases in `subcommand`
- * - Return an error message if duplicated is found
- * - Return `undefined` if not found
- */
-export type CheckDuplicatedOptions<T extends {
-    options?: Option[];
-}> = T["options"] extends infer O extends Option[] ? IsDuplicatesInArray<MapNameAndAliasesToStringArray<O>> extends infer Name extends string ? `>>> Error: Duplicated Options. Check the options with the name \`${Name}\` <<<` : undefined : undefined;
-/**
- * - Check for duplicated subcommands including aliases
- * - Return an error message if duplicated is found
- * - Return the `undefined` if no error
- */
-type CheckDuplicatedSubcommands<T extends Partial<Subcommand>[]> = IsDuplicatesInArray<MapNameAndAliasesToStringArray<T>> extends infer Name extends string ? `>>> Error: Duplicated Subcommand. Check the subcommands with the name \`${Name}\` <<<` : undefined;
-/**
- * - Check for duplicated arguments
- * - Return an error message if duplicated is found
- * - Return the `undefined` if no error
- */
-export type CheckDuplicatedArguments<T extends {
-    arguments?: Argument[];
-}> = T["arguments"] extends infer A extends Argument[] ? IsDuplicatesInArray<MapNameAndAliasesToStringArray<A>> extends infer Name extends string ? `>>> Error: Duplicated Arguments. Check the arguments with the name \`${Name}\` <<<` : undefined : undefined;
-type OptionalUnion = Z3.ZodOptional<Z3.ZodAny> | Z4.$ZodOptional | Z3.ZodDefault<Z3.ZodAny> | Z4.$ZodDefault;
-/**
- * - Insures that only the last argument is optional
- * - Insures no optional arguments are allowed when `allowPositional` is enabled
- */
-export type CheckArgumentsOptional<T extends {
-    allowPositional?: boolean;
-    arguments?: readonly Argument[];
-}> = T["arguments"] extends readonly [...infer Rest, infer Last] ? Last extends {
-    type: OptionalUnion;
-} ? T["allowPositional"] extends true ? `>>> Error: Cannot have optional arguments when \`allowPositional\` is enabled. The argument \`${Last extends {
-    name: string;
-} ? Last["name"] : ""}\` should not be optional <<<` : T : Extract<Rest[number], {
-    type: OptionalUnion;
-}> extends never ? T : T["allowPositional"] extends true ? `>>> Error: Cannot have optional arguments when \`allowPositional\` is enabled. The argument \`${Rest[number] extends {
-    name: string;
-} ? Rest[number]["name"] : ""}\` should not be optional <<<` : `>>> Error: Only the last argument may be optional. The argument \`${Rest[number] extends {
-    name: string;
-} ? Rest[number]["name"] : ""}\` should not be optional <<<` : T;
-export {};
-//# sourceMappingURL=types.d.ts.map

package/lib/typescript/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC;AACrC,MAAM,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC;AACnC,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzC,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,QAAQ,GAC7D,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GACX,CAAC,SAAS,QAAQ,GAChB,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GACX,KAAK,CAAC;AAEZ,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,QAAQ,GAC5D,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GACX,CAAC,SAAS,QAAQ,GAChB,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GACX,KAAK,CAAC;AAEZ,MAAM,WAAW,UAAU;IACzB;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAEhC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IAEtC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC;IAE7B;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC;CACxC;AAED,MAAM,MAAM,GAAG,GAAG,QAAQ,CACxB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC,GAAG;IACrD,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB,CACF,CAAC;AAEF,MAAM,WAAW,MAAM;IACrB;;;;;;;;OAQG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,QAAQ;IACvB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;AAE/D,gDAAgD;AAChD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CACjC,OAAO,GACP,aAAa,GACb,SAAS,GACT,UAAU,GACV,cAAc,GACd,SAAS,GACT,SAAS,GACT,QAAQ,GACR,UAAU,GACV,aAAa,GACb,aAAa,EACf,iBAAiB,CAClB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,OAAO,CAAC,UAAU,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAEpF;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,MAAM,CAAC,SAAS,MAAM,EAAE,GACzG,UAAU,CAAC;KAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,MAAM,CAAC,CAAC;CAAE,CAAC,GACjG,SAAS,CAAC;AAEd;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,MAAM,CAAC,SAAS,MAAM,EAAE,GACxG,UAAU,CAAC;KAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,MAAM,CAAC,CAAC;CAAE,CAAC,GAChG,SAAS,CAAC;AAEd;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,OAAO,CAAC,UAAU,CAAC,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAExF;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,SAAS,MAAM,CAAC,SAAS,QAAQ,EAAE,GAC/G;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK;CAAE,GACxF,SAAS,CAAC;AAEd;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,SAAS,MAAM,CAAC,SAAS,QAAQ,EAAE,GAC9G;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK;CAAE,GACvF,SAAS,CAAC;AAEd,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAExD,kEAAkE;AAClE,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE/D,sDAAsD;AACtD,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AAEvG,0CAA0C;AAC1C,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,QAAQ,CAClC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAC7F,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAE/C,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,IAAI;IACvD,YAAY,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAC1D,mBAAmB,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;CAC5G,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,OAAO,CAAC,UAAU,CAAC,EAAE,IAC3D,0BAA0B,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,SAAS,MAAM,GACxD,CAAC,GACD,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,OAAO,CAAC,UAAU,CAAC,EAAE,IACzD,0BAA0B,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,SAAS,MAAM,GACxD,CAAC,GACD,QAAQ,CACN,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,GAC7E,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAC/C,CAAC;AAER,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,UAAU,GAAG,GAAG,IAAI;IACzD,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;IACrE,oBAAoB,EAAE,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;CAC3E,CAAC;AAEF,qDAAqD;AACrD,KAAK,8BAA8B,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,IAAI,CAAC,SAAS;IACjG,MAAM,KAAK,SAAS,UAAU;IAC9B,GAAG,MAAM,IAAI;CACd,GACG,IAAI,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,GAClD;IACE,KAAK,CAAC,MAAM,CAAC;IACb,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;IAC9D,GAAG,8BAA8B,CAAC,IAAI,CAAC;CACxC,GACD,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,GACjF,EAAE,CAAC;AAEP;;;GAGG;AACH,KAAK,mBAAmB,CAAC,KAAK,SAAS,GAAG,EAAE,IAAI,KAAK,SAAS,CAAC,MAAM,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,GACrF,IAAI,SAAS,GAAG,EAAE,GAChB,IAAI,SAAS,IAAI,CAAC,MAAM,CAAC,GACvB,IAAI,GACJ,mBAAmB,CAAC,IAAI,CAAC,GAC3B,KAAK,GACP,KAAK,CAAC;AAEV;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS;IAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,MAAM,CAAC,SAAS,MAAM,EAAE,GAChH,mBAAmB,CAAC,8BAA8B,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,IAAI,SAAS,MAAM,GACtF,oEAAoE,IAAI,QAAQ,GAChF,SAAS,GACX,SAAS,CAAC;AAEd;;;;GAIG;AACH,KAAK,0BAA0B,CAAC,CAAC,SAAS,OAAO,CAAC,UAAU,CAAC,EAAE,IAC7D,mBAAmB,CAAC,8BAA8B,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,IAAI,SAAS,MAAM,GACpF,2EAA2E,IAAI,QAAQ,GACvF,SAAS,CAAC;AAEhB;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,CAAC,CAAC,SAAS;IAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,IAAI,CAAC,CAAC,WAAW,CAAC,SAAS,MAAM,CAAC,SACzG,QAAQ,EAAE,GACR,mBAAmB,CAAC,8BAA8B,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,IAAI,SAAS,MAAM,GACtF,wEAAwE,IAAI,QAAQ,GACpF,SAAS,GACX,SAAS,CAAC;AAEd,KAAK,aAAa,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC;AAE7G;;;GAGG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;CAAE,IACzG,CAAC,CAAC,WAAW,CAAC,SAAS,SAAS,CAAC,GAAG,MAAM,IAAI,EAAE,MAAM,IAAI,CAAC,GACvD,IAAI,SAAS;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GAClC,CAAC,CAAC,iBAAiB,CAAC,SAAS,IAAI,GAC/B,iGAAiG,IAAI,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,+BAA+B,GACjL,CAAC,GACH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC,SAAS,KAAK,GAC1D,CAAC,GACD,CAAC,CAAC,iBAAiB,CAAC,SAAS,IAAI,GAC/B,iGAAiG,IAAI,CAAC,MAAM,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,+BAA+B,GACjM,qEAAqE,IAAI,CAAC,MAAM,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,+BAA+B,GAC3K,CAAC,CAAC"}

package/lib/typescript/zod-utilities.d.ts

@@ -1,28 +0,0 @@
-import type * as Z3 from "zod/v3";
-import type * as Z4 from "zod/v4/core";
-import type { Schema } from "./types.ts";
-/** - Safe parse a value against a schema */
-export declare function safeParseSchema(schema: Schema, value: unknown): Z4.util.SafeParseError<unknown> | Z3.SafeParseSuccess<any> | Z3.SafeParseError<any>;
-/** - Check if a schema is a boolean */
-export declare function isBooleanSchema(schema: Schema): boolean;
-/** - Get the default value of a schema */
-export declare function schemaDefaultValue(schema: Schema): unknown;
-/** - Get the description of a schema */
-export declare function schemaDescription(schema: Schema): string | undefined;
-/** - Check if a schema is optional */
-export declare function isOptionalSchema(schema: Schema): schema is Z4.$ZodOptional;
-/**
- * A preprocessing function for Zod that converts a string to an array of strings.
- *
- * @param stringValue - The string value given by zod.
- * @param separator - The separator to use when splitting the string. Defaults to ",".
- */
-export declare function stringToArray(stringValue: string, separator?: string): string[];
-/**
- * A preprocessing function for Zod that converts a string to a `Set` of strings.
- *
- * @param stringValue - The string value given by zod.
- * @param separator - The separator to use when splitting the string. Defaults to ",".
- */
-export declare function stringToSet(stringValue: string, separator?: string): Set<string>;
-//# sourceMappingURL=zod-utilities.d.ts.map

package/lib/typescript/zod-utilities.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"zod-utilities.d.ts","sourceRoot":"","sources":["../../src/zod-utilities.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAsB,MAAM,YAAY,CAAC;AAM7D,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,uFAM7D;AAED,uCAAuC;AACvC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAMvD;AAgDD,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAM1D;AA+CD,wCAAwC;AACxC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBpE;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC,YAAY,CAM1E;AAmCD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,EAAE,CAKpF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAGrF"}

package/src/help-message/format-cli.ts

@@ -1,141 +0,0 @@
-import { getCliMetadata } from "../metadata/get-cli-metadata.js";
-import { concat, indent, ln, subcommandPlaceholder } from "../utilities.js";
-import { formatHelpMessageArguments } from "./format-arguments.js";
-import { formatHelpMessageOptions } from "./format-options.js";
-import { formatHelpMessageCommands } from "./format-subcommands.js";
-import { helpMessageStyles } from "./styles.js";
-
-import type { Cli, HelpMessageStyle, Subcommand } from "../types.js";
-
-export function formatCliHelpMessage(
-  parameters: readonly [Cli, ...Subcommand[]],
-  style?: Partial<HelpMessageStyle>,
-): string {
-  const c = helpMessageStyles.default;
-  if (style) Object.assign(c, style);
-
-  const metadata = getCliMetadata(parameters);
-
-  const formatTitle = (title: string) => c.title(` ${title.toUpperCase()}`);
-
-  let message = "";
-
-  // CLI usage
-  const usage =
-    metadata.usage ||
-    concat(
-      c.punctuation("$"),
-      c.description(metadata.name),
-      metadata.subcommands.length > 0 ? c.command("[command]") : "",
-      metadata.options.length > 0 ? c.option("[options]") : "",
-      metadata.arguments.length > 0 ? c.argument("<arguments>") : "",
-      metadata.allowPositional ? c.argument("<positionals>") : "",
-    );
-  message += formatTitle("Usage") + ln(1);
-  message += indent(2) + usage + ln(2);
-
-  // CLI description
-  if (metadata.description) {
-    message += formatTitle("Description") + ln(1);
-    message += indent(2) + c.description(metadata.description).replace(/\n+/g, "\n" + indent(2)) + ln(2);
-  }
-
-  let longest = 0;
-
-  // Prepare CLI options
-  const optionsMetadata = metadata.options;
-
-  let longestOptionTitle = 0;
-  for (const metadata of optionsMetadata) {
-    const names = [...metadata.aliasesAsArgs, metadata.nameAsArg].join(", ");
-    const optLength = names.length + metadata.placeholder.length;
-    if (optLength > longestOptionTitle) {
-      longestOptionTitle = optLength;
-    }
-  }
-
-  if (longestOptionTitle > longest) {
-    longest = longestOptionTitle;
-  }
-
-  // Prepare CLI commands
-  const subcommandsMetadata = metadata.subcommands;
-
-  let longestSubcommandTitle = 0;
-  for (const metadata of subcommandsMetadata) {
-    const names = [...metadata.aliases, metadata.name].join(", ");
-    const placeholder = subcommandPlaceholder(metadata);
-    const optLength = names.length + placeholder.length;
-    if (optLength > longestSubcommandTitle) {
-      longestSubcommandTitle = optLength;
-    }
-  }
-
-  if (longestSubcommandTitle > longest) {
-    longest = longestSubcommandTitle;
-  }
-
-  // Prepare CLI arguments
-  const argumentsMetadata = metadata.arguments;
-
-  let longestArgumentTitle = 0;
-  for (const argument of argumentsMetadata) {
-    if (argument.name.length > longestArgumentTitle) {
-      longestArgumentTitle = argument.name.length;
-    }
-  }
-
-  if (longestArgumentTitle > longest) {
-    longest = longestArgumentTitle;
-  }
-
-  // CLI options
-  message += formatHelpMessageOptions(optionsMetadata, c, longest);
-
-  // CLI commands
-  message += formatHelpMessageCommands(subcommandsMetadata, c, longest);
-
-  // CLI arguments
-  message += formatHelpMessageArguments(argumentsMetadata, c, longest);
-
-  // CLI example
-  if (metadata.example) {
-    message += formatTitle("Example");
-    message += ln(1);
-    const normalizeExample = metadata.example.replace(/\n+/g, "\n" + indent(3));
-    message += concat(indent(2), c.example(normalizeExample), ln(2));
-  }
-
-  return message;
-}
-
-export function formatSubcommandHelpMessage(
-  subcommand: Subcommand,
-  printStyle?: Partial<HelpMessageStyle>,
-  cliName = "",
-) {
-  const c = helpMessageStyles.default;
-  if (printStyle) Object.assign(c, printStyle);
-
-  const usage =
-    subcommand.usage ||
-    concat(
-      c.punctuation("$"),
-      cliName,
-      c.command(subcommand.name),
-      subcommand.options?.length ? c.option("[options]") : "",
-      subcommand.arguments?.length || subcommand.allowPositional ? c.argument("<arguments>") : "",
-    );
-
-  const asCli: Cli = { cliName, usage, ...subcommand };
-
-  return formatCliHelpMessage([asCli], c);
-}
-
-export function printCliHelp(parameters: readonly [Cli, ...Subcommand[]], style?: Partial<HelpMessageStyle>) {
-  console.log(formatCliHelpMessage(parameters, style));
-}
-
-export function printSubcommandHelp(subcommand: Subcommand, style?: Partial<HelpMessageStyle>, cliName = "") {
-  console.log(formatSubcommandHelpMessage(subcommand, style, cliName));
-}

package/src/metadata/get-arguments-metadata.ts

@@ -1,25 +0,0 @@
-import { stringifyValue } from "../utilities.js";
-import { isOptionalSchema, schemaDefaultValue, schemaDescription } from "../zod-utilities.js";
-
-import type { Argument } from "../types.js";
-import type { ArgumentMetadata } from "./metadata-types.js";
-
-export function getArgumentsMetadata(arguments_: Argument[]): ArgumentMetadata[] {
-  const outputMetadata: ArgumentMetadata[] = [];
-
-  for (const argument of arguments_) {
-    const defaultValue = schemaDefaultValue(argument.type);
-
-    outputMetadata.push({
-      name: argument.name,
-      description: argument.description ?? schemaDescription(argument.type) ?? "",
-      defaultValue,
-      defaultValueAsString: stringifyValue(defaultValue),
-      optional: isOptionalSchema(argument.type),
-      example: argument.example ?? "",
-      type: argument.type,
-    });
-  }
-
-  return outputMetadata;
-}

package/src/metadata/get-cli-metadata.ts

@@ -1,23 +0,0 @@
-import { getArgumentsMetadata } from "./get-arguments-metadata.js";
-import { getOptionsMetadata } from "./get-options-metadata.js";
-import { getSubcommandsMetadata } from "./get-subcommands-metadata.js";
-
-import type { Cli, Subcommand } from "../types.js";
-import type { CliMetadata } from "./metadata-types.js";
-
-export function getCliMetadata(inputData: readonly [Cli, ...Subcommand[]]): CliMetadata {
-  const [cli, ...subcommands] = inputData;
-
-  const outputMetadata: CliMetadata = {
-    name: cli.cliName,
-    description: cli.description ?? "",
-    usage: cli.usage ?? "",
-    example: cli.example ?? "",
-    allowPositional: cli.allowPositional ?? false,
-    options: cli.options ? getOptionsMetadata(cli.options) : [],
-    arguments: cli.arguments ? getArgumentsMetadata(cli.arguments) : [],
-    subcommands: subcommands ? getSubcommandsMetadata(subcommands) : [],
-  };
-
-  return outputMetadata;
-}

package/src/metadata/get-options-metadata.ts

@@ -1,35 +0,0 @@
-import { transformOptionToArgument } from "../parser/parse/parser-helpers.js";
-import { stringifyValue } from "../utilities.js";
-import { isOptionalSchema, schemaDefaultValue, schemaDescription } from "../zod-utilities.js";
-
-import type { Option } from "../types.js";
-import type { OptionMetadata } from "./metadata-types.js";
-
-export function getOptionsMetadata(options: Option[]): OptionMetadata[] {
-  const outputMetadata: OptionMetadata[] = [];
-
-  if (!options || options.length === 0) {
-    return outputMetadata;
-  }
-
-  for (const option of options) {
-    const defaultValue = schemaDefaultValue(option.type);
-    const aliases = option.aliases ?? [];
-
-    outputMetadata.push({
-      name: option.name,
-      nameAsArg: transformOptionToArgument(option.name),
-      aliases,
-      aliasesAsArgs: aliases.map(alias => transformOptionToArgument(alias)),
-      placeholder: option.placeholder ?? "",
-      description: option.description ?? schemaDescription(option.type) ?? "",
-      optional: isOptionalSchema(option.type),
-      example: option.example ?? "",
-      defaultValue,
-      defaultValueAsString: stringifyValue(defaultValue),
-      type: option.type,
-    });
-  }
-
-  return outputMetadata;
-}

package/src/metadata/get-subcommands-metadata.ts

@@ -1,32 +0,0 @@
-import { getArgumentsMetadata } from "./get-arguments-metadata.js";
-import { getOptionsMetadata } from "./get-options-metadata.js";
-
-import type { Subcommand } from "../types.js";
-import type { SubcommandMetadata } from "./metadata-types.js";
-
-export function getSubcommandsMetadata(subcommands: Subcommand[]): SubcommandMetadata[] {
-  const outputMetadata: SubcommandMetadata[] = [];
-
-  if (!subcommands || subcommands.length === 0) {
-    return outputMetadata;
-  }
-
-  for (const subcommand of subcommands) {
-    const optionsMetadata = subcommand.options ? getOptionsMetadata(subcommand.options) : [];
-    const argumentsMetadata = subcommand.arguments ? getArgumentsMetadata(subcommand.arguments) : [];
-
-    outputMetadata.push({
-      name: subcommand.name,
-      aliases: subcommand.aliases ?? [],
-      description: subcommand.description ?? "",
-      placeholder: subcommand.placeholder ?? "",
-      usage: subcommand.usage ?? "",
-      example: subcommand.example ?? "",
-      allowPositional: subcommand.allowPositional ?? false,
-      options: optionsMetadata,
-      arguments: argumentsMetadata,
-    });
-  }
-
-  return outputMetadata;
-}