zod-args-parser 2.0.0-alpha.0 → 2.0.0-beta.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"io-types.d.ts","sourceRoot":"","sources":["../../../src/types/io-types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/types/metadata-types.d.ts

@@ -0,0 +1,75 @@
+import type { SchemaType } from "./schema-types.ts";
+interface MetadataBase {
+    /** Empty string if not provided */
+    description: string;
+    /** Empty string if not provided */
+    descriptionMarkdown: string;
+    /** Empty string if not provided */
+    example: string;
+    /** Whether the metadata is hidden from the documentation. */
+    hidden: boolean;
+}
+export interface CliMetadata extends Omit<MetadataBase, "hidden"> {
+    /** The name of the cli program. */
+    name: string;
+    /** Empty string if not provided */
+    usage: string;
+    /** Whether the cli program allows positionals arguments. */
+    allowPositionals: boolean;
+    /** Empty array if not provided */
+    options: OptionMetadata[];
+    /** Empty array if not provided */
+    arguments: ArgumentMetadata[];
+    /** Empty array if not provided */
+    subcommands: SubcommandMetadata[];
+}
+export interface SubcommandMetadata extends MetadataBase {
+    /** The subcommand name. */
+    name: string;
+    /** Empty array if not provided */
+    aliases: string[];
+    /** Empty string if not provided */
+    placeholder: string;
+    /** Empty string if not provided */
+    usage: string;
+    /** Whether the subcommand allows positionals arguments. */
+    allowPositionals: boolean;
+    /** Empty array if not provided */
+    options: OptionMetadata[];
+    /** Empty array if not provided */
+    arguments: ArgumentMetadata[];
+}
+export interface OptionMetadata extends MetadataBase {
+    /** The option name. */
+    name: string;
+    /** The option name as argument. E.g. `--option-name` */
+    nameAsArg: string;
+    /** Empty array if not provided. */
+    aliases: string[];
+    /** Empty array if not provided. E.g. `[--alias-name, ...]` */
+    aliasesAsArgs: string[];
+    /** Empty string if not provided */
+    placeholder: string;
+    /** The default value of the option. */
+    defaultValue: unknown;
+    /** Empty string if not provided. */
+    defaultValueAsString: string;
+    /** Is optional. */
+    optional: boolean;
+    /** Standard Schema V1. */
+    schema: SchemaType;
+}
+export interface ArgumentMetadata extends MetadataBase {
+    /** The argument name. */
+    name: string;
+    /** The default value of the argument. */
+    defaultValue: unknown;
+    /** The default value of the argument as string. */
+    defaultValueAsString: string;
+    /** Is optional. */
+    optional: boolean;
+    /** Standard Schema V1. */
+    schema: SchemaType;
+}
+export {};
+//# sourceMappingURL=metadata-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-types.d.ts","sourceRoot":"","sources":["../../../src/types/metadata-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,UAAU,YAAY;IACpB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IAEpB,mCAAmC;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAEhB,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC;IAC/D,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IAEd,4DAA4D;IAC5D,gBAAgB,EAAE,OAAO,CAAC;IAE1B,kCAAkC;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;IAE1B,kCAAkC;IAClC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAE9B,kCAAkC;IAClC,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IAEb,kCAAkC;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IAEpB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IAEd,2DAA2D;IAC3D,gBAAgB,EAAE,OAAO,CAAC;IAE1B,kCAAkC;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;IAE1B,kCAAkC;IAClC,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IAEb,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,YAAY,EAAE,OAAO,CAAC;IAEtB,oCAAoC;IACpC,oBAAoB,EAAE,MAAM,CAAC;IAE7B,mBAAmB;IACnB,QAAQ,EAAE,OAAO,CAAC;IAElB,0BAA0B;IAC1B,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IAEb,yCAAyC;IACzC,YAAY,EAAE,OAAO,CAAC;IAEtB,mDAAmD;IACnD,oBAAoB,EAAE,MAAM,CAAC;IAE7B,mBAAmB;IACnB,QAAQ,EAAE,OAAO,CAAC;IAElB,0BAA0B;IAC1B,MAAM,EAAE,UAAU,CAAC;CACpB"}

package/lib/typescript/types/schema-types.d.ts

@@ -0,0 +1,6 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+export type SchemaType<T = unknown> = StandardSchemaV1<T>;
+export type InferSchemaInputType<T extends SchemaType> = StandardSchemaV1.InferInput<T>;
+export type InferSchemaOutputType<T extends SchemaType> = StandardSchemaV1.InferOutput<T>;
+export type SchemaResult<T = unknown> = StandardSchemaV1.Result<T>;
+//# sourceMappingURL=schema-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-types.d.ts","sourceRoot":"","sources":["../../../src/types/schema-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAE1D,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,UAAU,IAAI,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAExF,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,UAAU,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAE1F,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,61 @@
+import type { Cli, Subcommand } from "./definitions-types.ts";
+import type { PrintHelpOptions } from "./help-message-types.ts";
+import type { InferInputType, InputTypeWide, OutputType, OutputTypeWide } from "./io-types.ts";
+type PrimitiveTypeNames = "string" | "number" | "boolean" | "object" | "unknown";
+export type CoerceTypes = PrimitiveTypeNames | `${PrimitiveTypeNames}[]` | `set<${PrimitiveTypeNames}>` | (string & {});
+export interface CoerceMethod<Value> {
+    (terminalInput: string): Value;
+    type?: CoerceTypes;
+}
+type GetSubcommandsNames<T extends Partial<Subcommand>> = T extends Cli ? T["subcommands"] extends infer S extends readonly [Subcommand, ...Subcommand[]] ? {
+    [Index in keyof S]: S[Index] extends {
+        name: string;
+    } ? S[Index]["name"] : never;
+}[number] : never : never;
+type Unsubscribe = () => void;
+export interface AttachedMethods<T extends Cli | Subcommand> {
+    /**
+     * Add a handler to be called when the subcommand/cli is executed.
+     *
+     * @example
+     *   const unsubscribe = cli.onExecute(result => console.log(result));
+     */
+    onExecute: (handler: (data: OutputType<[T]>) => void) => Unsubscribe;
+    execute: InferInputType<T> extends infer InputType ? undefined extends InputType ? (input?: InputType) => void : (input: InputType) => void : never;
+    /** **WARNING**: This will only be available after the CLI schema has been created */
+    generateCliHelpMessage?: (options?: PrintHelpOptions) => string;
+    /**
+     * **WARNING**: This will only be available after the CLI schema has been created
+     *
+     * @throws {Error} - When the subcommand is not found
+     */
+    generateSubcommandHelpMessage?: (subcommandName: GetSubcommandsNames<T> | (string & {}), options?: PrintHelpOptions) => string;
+}
+export interface AttachedMethodsWide {
+    onExecute: (handler: (data: OutputTypeWide) => void) => Unsubscribe;
+    execute: (input?: InputTypeWide) => void;
+    generateCliHelpMessage?: (options?: PrintHelpOptions) => void;
+    /** @throws {Error} - When the subcommand is not found */
+    generateSubcommandHelpMessage?: (subcommandName: string, options?: PrintHelpOptions) => void;
+}
+export type CliOutputType<S extends Cli> = OutputType<[S]> | (S["subcommands"] extends readonly [Subcommand, ...Subcommand[]] ? OutputType<S["subcommands"]> : never);
+export type CliParseResult<S extends Cli> = {
+    value: CliOutputType<S>;
+    error?: undefined;
+} | {
+    value?: never;
+    error: Error;
+};
+export type CliParseResultWide = {
+    value: OutputTypeWide;
+    error?: undefined;
+} | {
+    value?: never;
+    error: Error;
+};
+export interface ValidateMethods<S extends Cli> {
+    run(input: string | string[]): CliParseResult<S>;
+    runAsync(input: string | string[]): Promise<CliParseResult<S>>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/F,KAAK,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AACjF,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,GAAG,kBAAkB,IAAI,GAAG,OAAO,kBAAkB,GAAG,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAExH,MAAM,WAAW,YAAY,CAAC,KAAK;IACjC,CAAC,aAAa,EAAE,MAAM,GAAG,KAAK,CAAC;IAC/B,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,KAAK,mBAAmB,CAAC,CAAC,SAAS,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,GAAG,GACnE,CAAC,CAAC,aAAa,CAAC,SAAS,MAAM,CAAC,SAAS,SAAS,CAAC,UAAU,EAAE,GAAG,UAAU,EAAE,CAAC,GAC7E;KAAG,KAAK,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK;CAAE,CAAC,MAAM,CAAC,GAC5F,KAAK,GACP,KAAK,CAAC;AAEV,KAAK,WAAW,GAAG,MAAM,IAAI,CAAC;AAE9B,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,GAAG,GAAG,UAAU;IACzD;;;;;OAKG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,WAAW,CAAC;IAGrE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,SAAS,MAAM,SAAS,GAC9C,SAAS,SAAS,SAAS,GACzB,CAAC,KAAK,CAAC,EAAE,SAAS,KAAK,IAAI,GAC3B,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAC5B,KAAK,CAAC;IAEV,qFAAqF;IACrF,sBAAsB,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,gBAAgB,KAAK,MAAM,CAAC;IAEhE;;;;OAIG;IACH,6BAA6B,CAAC,EAAE,CAC9B,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,EACtD,OAAO,CAAC,EAAE,gBAAgB,KACvB,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,KAAK,WAAW,CAAC;IACpE,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;IACzC,sBAAsB,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC9D,yDAAyD;IACzD,6BAA6B,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC9F;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,GAAG,IACnC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GACf,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,SAAS,CAAC,UAAU,EAAE,GAAG,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;AAE7G,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,GAAG,IACpC;IAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GAC9C;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpC,MAAM,MAAM,kBAAkB,GAAG;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEhH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,GAAG;IAC5C,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;CAChE"}

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

@@ -0,0 +1,17 @@
+/** `{ some props } & { other props }` => `{ some props, other props }` */
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** 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> = Partial<Pick<T, UndefinedProperties<T>>> & Pick<T, Exclude<keyof T, UndefinedProperties<T>>>;
+/** If every property in a record is optional, widen the type to `T | undefined`. */
+export type AllowUndefinedIfOptional<T> = {
+    [K in keyof T]-?: object extends Pick<T, K> ? never : K;
+}[keyof T] extends never ? T | undefined : T;
+/** Widen literal and tuples */
+export type Widen<T> = T extends string ? string : T extends number ? number : T extends boolean ? boolean : T extends readonly (infer U)[] ? Widen<U>[] : T extends Set<infer U> ? Set<Widen<U>> : T;
+//# sourceMappingURL=utilities-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utilities-types.d.ts","sourceRoot":"","sources":["../../../src/types/utilities-types.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAExD,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,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,GAClE,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpD,oFAAoF;AACpF,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI;KACvC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;CACxD,CAAC,MAAM,CAAC,CAAC,SAAS,KAAK,GACpB,CAAC,GAAG,SAAS,GACb,CAAC,CAAC;AAEN,+BAA+B;AAE/B,MAAM,MAAM,KAAK,CAAC,CAAC,IACjB,CAAC,SAAS,MAAM,GAAG,MAAM,GACzB,CAAC,SAAS,MAAM,GAAG,MAAM,GACzB,CAAC,SAAS,OAAO,GAAG,OAAO,GAC3B,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,GAC3C,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GACtC,CAAC,CAAC"}

package/lib/typescript/utilities.d.ts

@@ -1,11 +1,16 @@
-import { SubcommandMetadata } from "./metadata/metadata-types.js";
-/**
- * Converts a string to its corresponding boolean value if the string is "true" or "false" (case-insensitive).
- *
- * @param string - The input string to convert.
- * @returns `true` if the input is "true", `false` if the input is "false", or the original string otherwise.
- */
-export declare function stringToBoolean(string: string): boolean | string;
+import type { Argument, Option, PreparedType } from "./types/definitions-types.ts";
+import type { SubcommandMetadata } from "./types/metadata-types.ts";
+import type { SchemaResult, SchemaType } from "./types/schema-types.ts";
+import type { CoerceMethod } from "./types/types.ts";
+/** @throws */
+export declare function validateSync(schema: SchemaType, value?: unknown): SchemaResult;
+export declare function defaultValueAndIsOptional(schema: SchemaType): {
+    defaultValue: unknown;
+    optional: boolean;
+};
+export declare function PrepareType(schema: SchemaType, coerceHandler: CoerceMethod<unknown>): PreparedType;
+export declare function prepareDefinitionTypes(definition: Record<string, Argument> | Record<string, Option> | undefined): void;
+export declare function toKebabCase(input: string): string;
 /**
  * Converts a zero-based index into its human-readable ordinal form.
  *
@@ -21,11 +26,20 @@ export declare function generateOrdinalSuffix(index: number): string;
 export declare function ln(count: number): string;
 /** Space */
 export declare function indent(count: number): string;
-/** Concat strings */
-export declare function concat(...messages: string[]): string;
+/** Indents every line in the given text by the provided number of spaces. Empty lines are preserved. */
+export declare function indentLines(text: string, spaces: number): string;
 export declare function stringifyValue(value: unknown): string;
 /** Insert text at the end of the first line */
 export declare function insertAtEndOfFirstLine(string: string, insert: string): string;
 /** Get the placeholder for a subcommand */
 export declare function subcommandPlaceholder(metadata: SubcommandMetadata): string;
+/** Parse a string into an argv (array of arguments) */
+export declare function parseArgv(input: string): string[];
+/**
+ * Escape HTML characters inside HTML tags in a Markdown string, but leave code blocks, inline code, and HTML comments
+ * unchanged.
+ */
+export declare function escapeHtmlTags(markdown: string): string;
+export declare function stripAnsi(string: string): string;
+export declare function findDuplicateStrings(values: readonly string[]): string[];
 //# sourceMappingURL=utilities.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../src/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAUhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA2B3D;AAED,eAAe;AACf,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,UAE/B;AAED,YAAY;AACZ,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,UAGnC;AAED,qBAAqB;AACrB,wBAAgB,MAAM,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,UAG3C;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcrD;AAED,+CAA+C;AAC/C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAIpE;AAED,2CAA2C;AAC3C,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAoB1E"}
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../src/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,cAAc;AACd,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,YAAY,CAO9E;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAQ1G;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAUlG;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,QAY/G;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA2B3D;AAED,eAAe;AACf,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,UAE/B;AAED,YAAY;AACZ,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,UAGnC;AAED,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcrD;AAED,+CAA+C;AAC/C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAIpE;AAED,2CAA2C;AAC3C,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAwB1E;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA4EjD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgBvD;AAoBD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAcxE"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zod-args-parser",
-  "version": "2.0.0-alpha.0",
-  "description": "A strictly typed command-line arguments parser powered by Zod.",
+  "version": "2.0.0-beta.1",
+  "description": "A TypeScript-first CLI argument parser with schema-based validation.",
   "author": "Ahmed ALABSI <alabsi91@gmail.com>",
   "license": "MIT",
   "repository": {
@@ -10,20 +10,21 @@
   },
   "type": "module",
   "scripts": {
-    "dev": "tsx watch example/index.ts",
-    "build": "node scripts/build.mjs",
-    "test": "eslint src/** --fix && tsc --noEmit && tsx test/test.ts",
+    "dev": "tsx --watch example/index.ts",
+    "build": "node scripts/build.ts",
+    "test": "node --test && echo Checking types... && tsgo --noEmit && echo Linting... && eslint --config eslint.config.js --fix",
     "prepare": "npm run test && npm run build"
   },
-  "types": "./lib/typescript/index.d.ts",
   "exports": {
     ".": {
-      "import": "./lib/module/index.mjs",
-      "require": "./lib/commonjs/index.cjs",
-      "default": "./lib/module/index.mjs",
-      "types": "./lib/typescript/index.d.ts"
+      "types": "./lib/typescript/index.d.ts",
+      "browser": "./lib/esm/index.js",
+      "import": "./lib/mjs/index.mjs",
+      "require": "./lib/cjs/index.cjs"
     }
   },
+  "jsdelivr": "./lib/iife/index.js",
+  "unpkg": "./lib/iife/index.js",
   "files": [
     "lib",
     "src"
@@ -33,32 +34,34 @@
     "cli",
     "arguments",
     "parser",
+    "schema",
+    "validation",
     "zod",
     "typescript"
   ],
   "devDependencies": {
-    "@babel/core": "^7.28.5",
-    "@babel/preset-env": "^7.28.5",
-    "@babel/preset-typescript": "^7.28.5",
-    "@eslint/js": "^9.38.0",
-    "@types/babel__core": "^7.20.5",
-    "@types/node": "^24.9.1",
-    "babel-plugin-replace-import-extension": "^1.1.5",
-    "eslint": "^9.38.0",
+    "@eslint/js": "^9.39.1",
+    "@eslint/markdown": "^7.5.1",
+    "@trivago/prettier-plugin-sort-imports": "^6.0.0",
+    "@types/node": "^24.10.0",
+    "@typescript/native-preview": "^7.0.0-dev.20251104.1",
+    "esbuild": "^0.27.0",
+    "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
-    "eslint-plugin-unicorn": "^61.0.2",
+    "eslint-plugin-unicorn": "^62.0.0",
     "glob": "^11.0.3",
-    "globals": "^16.4.0",
+    "globals": "^16.5.0",
     "prettier": "^3.6.2",
-    "prettier-plugin-jsdoc": "^1.3.3",
-    "tsx": "^4.20.6",
+    "prettier-plugin-jsdoc": "^1.5.0",
+    "terser": "^5.44.1",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.46.2",
+    "typescript-eslint": "^8.46.4",
     "zod": "^4.1.12"
   },
-  "peerDependencies": {
-    "chalk": "*",
-    "zod": "^3.25.0 || ^4.0.0"
+  "dependencies": {
+    "@standard-schema/spec": "^1.0.0",
+    "chalk": "^5.6.2",
+    "marked": "^17.0.0"
   }
 }

package/src/autocomplete-scripts/bash-autocomplete-script.ts

@@ -1,6 +1,6 @@
-import { transformOptionToArgument } from "../parser/parse/parser-helpers.js";
+import { transformOptionToArgument } from "../parse/parser-utilities.ts";
 
-import type { Cli, Subcommand } from "../types.js";
+import type { Cli } from "../types/definitions-types.ts";
 
 /**
  * - Generate bash autocomplete script for your CLI
@@ -10,15 +10,16 @@ import type { Cli, Subcommand } from "../types.js";
  *   - Add the following line: `source <generated script path>`
  *   - Save and reopen bash to take effect
  */
-export function generateBashAutocompleteScript(...parameters: [Cli, ...Subcommand[]]): string {
-  const [cli, ...subcommands] = parameters;
+export function generateBashAutocompleteScript(cliDefinition: Cli): string {
+  const subcommands = cliDefinition.subcommands ?? [];
 
   type MappedCommands = Record<string, { options: string[]; aliases: string[] }>;
 
   const mappedCommands: MappedCommands = {};
+
   for (const subcommand of subcommands) {
     mappedCommands[subcommand.name] = {
-      options: subcommand.options?.map(option => transformOptionToArgument(option.name)) ?? [],
+      options: subcommand.options ? Object.keys(subcommand.options).map(key => transformOptionToArgument(key)) : [],
       aliases: subcommand.aliases ?? [],
     };
   }
@@ -30,15 +31,18 @@ export function generateBashAutocompleteScript(...parameters: [Cli, ...Subcomman
     switchCase += "      ;;\n";
   }
 
-  if (cli.options?.length) {
+  if (cliDefinition.options?.length) {
+    const optionsNames = cliDefinition.options
+      ? Object.keys(cliDefinition.options).map(key => transformOptionToArgument(key))
+      : [];
     switchCase += `    "-"*)\n`;
-    switchCase += `      opts="${cli.options.map(option => transformOptionToArgument(option.name)).join(" ")}"\n`;
+    switchCase += `      opts="${optionsNames.join(" ")}"\n`;
     switchCase += "      ;;\n";
   }
 
   return `# Auto-generated by zod-args-parser
 
-_${cli.cliName}_autocomplete() {
+_${cliDefinition.cliName}_autocomplete() {
   local cur prev commands opts subcommand used_opts filtered_opts
 
   cur="\${COMP_WORDS[COMP_CWORD]}"
@@ -76,6 +80,6 @@ ${switchCase}
   fi
 }
 
-complete -F _${cli.cliName}_autocomplete ${cli.cliName}
+complete -F _${cliDefinition.cliName}_autocomplete ${cliDefinition.cliName}
 `;
 }

package/src/autocomplete-scripts/powershell-autocomplete-script.ts

@@ -1,6 +1,6 @@
-import { transformOptionToArgument } from "../parser/parse/parser-helpers.js";
+import { transformOptionToArgument } from "../parse/parser-utilities.ts";
 
-import type { Cli, Subcommand } from "../types.js";
+import type { Cli } from "../types/definitions-types.ts";
 
 /**
  * - Generates a PowerShell autocomplete script for your CLI.
@@ -13,15 +13,17 @@ import type { Cli, Subcommand } from "../types.js";
  *   - Add the following line: `. "<generated script path>"`
  *   - Save and reopen powershell to take effect
  */
-export function generatePowerShellAutocompleteScript(...parameters: [Cli, ...Subcommand[]]): string {
-  const [cli, ...subcommands] = parameters;
+export function generatePowerShellAutocompleteScript(cliDefinition: Cli): string {
+  const subcommands = cliDefinition.subcommands ?? [];
+  const meta = cliDefinition.meta ?? {};
 
   type MappedCommands = Record<string, { options: string[]; aliases: string[] }>;
 
   const mappedCommands: MappedCommands = {};
+
   for (const subcommand of subcommands) {
     mappedCommands[subcommand.name] = {
-      options: subcommand.options?.map(option => transformOptionToArgument(option.name)) ?? [],
+      options: subcommand.options ? Object.keys(subcommand.options).map(key => transformOptionToArgument(key)) : [],
       aliases: subcommand.aliases ?? [],
     };
   }
@@ -29,7 +31,11 @@ export function generatePowerShellAutocompleteScript(...parameters: [Cli, ...Sub
   const subcommandsString = Object.keys(mappedCommands)
     .map(key => `'${key}'`)
     .join(", ");
-  const cliOptionsString = cli.options?.map(option => `'${transformOptionToArgument(option.name)}'`).join(", ") || "";
+
+  const optionsNames = cliDefinition.options
+    ? Object.keys(cliDefinition.options).map(key => transformOptionToArgument(key))
+    : [];
+  const cliOptionsString = optionsNames.map(option => `'${option}'`).join(", ");
 
   let switchCase = "switch ($subcommand) {\n";
   for (const [key, { options, aliases }] of Object.entries(mappedCommands)) {
@@ -41,37 +47,39 @@ export function generatePowerShellAutocompleteScript(...parameters: [Cli, ...Sub
   }
   switchCase += `        default { @(${cliOptionsString}) }\n    }`;
 
+  const description = meta.description ?? meta.descriptionMarkdown;
+
   let functionInfo = "";
-  if (cli.description) {
-    functionInfo = `<#\n.DESCRIPTION\n${cli.description}\n${cli.example ? `\n.EXAMPLE\n${cli.example}` : ""}\n#>`;
+  if (description) {
+    functionInfo = `<#\n.DESCRIPTION\n${description}\n${meta.example ? `\n.EXAMPLE\n${meta.example}` : ""}\n#>`;
   }
 
   return `# Auto-generated by zod-args-parser
 
 ${functionInfo}
-function ${cli.cliName} {
+function ${cliDefinition.cliName} {
     param(
         [Parameter(Position = 0, Mandatory = $false)]
         [string]$subcommand,
         [Parameter(Position = 1, ValueFromRemainingArguments = $true)]
         [string[]]$arguments
     )
-    $scriptPath = (Get-Command '${cli.cliName}.ps1').Source
+    $scriptPath = (Get-Command '${cliDefinition.cliName}.ps1').Source
     if ($scriptPath) {
         $argumentList = @($subcommand) + ($arguments | Where-Object { $_ -notin '--', '--%' }) | Where-Object { $_ -ne '' }
         & $scriptPath @argumentList
         return
     }
-    Write-Error "Could not find '${cli.cliName}.ps1' script"
+    Write-Error "Could not find '${cliDefinition.cliName}.ps1' script"
 }
 
-Register-ArgumentCompleter -CommandName '${cli.cliName}' -ParameterName 'subcommand' -ScriptBlock {
+Register-ArgumentCompleter -CommandName '${cliDefinition.cliName}' -ParameterName 'subcommand' -ScriptBlock {
     param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)
     $subcommands = @(${subcommandsString}${subcommandsString && cliOptionsString ? ", " : ""}${cliOptionsString})
     $subcommands | Where-Object { $_ -like "$wordToComplete*" }
 }
 
-Register-ArgumentCompleter -CommandName '${cli.cliName}' -ParameterName 'arguments' -ScriptBlock {
+Register-ArgumentCompleter -CommandName '${cliDefinition.cliName}' -ParameterName 'arguments' -ScriptBlock {
     param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)
     $subcommand = $commandAst.CommandElements[1].Value
     $arguments = ${switchCase}

package/src/autocomplete-scripts/zsh-autocomplete-script.ts

@@ -1,6 +1,6 @@
-import { transformOptionToArgument } from "../parser/parse/parser-helpers.js";
+import { transformOptionToArgument } from "../parse/parser-utilities.ts";
 
-import type { Cli, Option, Subcommand } from "../types.js";
+import type { Cli, Subcommand } from "../types/definitions-types.ts";
 
 /**
  * - Generates a ZSH autocomplete script for your CLI.
@@ -10,34 +10,38 @@ import type { Cli, Option, Subcommand } from "../types.js";
  *   - Add the following line: `source <generated script path>`
  *   - Save and reopen zsh to take effect
  */
-export function generateZshAutocompleteScript(...parameters: [Cli, ...Subcommand[]]): string {
-  const [cli, ...subcommands] = parameters;
+export function generateZshAutocompleteScript(cliDefinition: Cli): string {
+  const subcommands = cliDefinition.subcommands ?? [];
 
-  const genArguments = (options: Option[]) => {
-    return options
-      ?.map(option => `'${transformOptionToArgument(option.name)}[${option.description ?? ""}]'`)
-      .join(" \\\n            ");
+  const genArguments = (command: Subcommand) => {
+    const optionsNameDesc = command.options
+      ? Object.entries(command.options).map(
+          ([name, value]) => `'${transformOptionToArgument(name)}[${value.meta?.description ?? ""}]'`,
+        )
+      : [];
+
+    return optionsNameDesc.join(" \\\n            ");
   };
 
   const genSubCommand = (subcommand: Subcommand) => {
     const options = subcommand.options;
-    if (!options || options.length === 0) return "";
-    return `${subcommand.name})
-          _arguments \\
-            ${genArguments(options)} \\
-            '*: :_files' \\
+    if (!options) return "";
+    return String.raw`${subcommand.name})
+          _arguments \
+            ${genArguments(subcommand)} \
+            '*: :_files' \
             && ret=0
           ;;`;
   };
 
-  return `# Auto-generated by zod-args-parser
+  return String.raw`# Auto-generated by zod-args-parser
 
-_${cli.cliName}_autocomplete() {
+_${cliDefinition.cliName}_autocomplete() {
   local ret=1
 
-  _arguments -C \\
-    '1: :_${cli.cliName}_commands' \\
-    '*:: :->subcmds' \\
+  _arguments -C \
+    '1: :_${cliDefinition.cliName}_commands' \
+    '*:: :->subcmds' \
     && ret=0
 
   case $state in
@@ -48,8 +52,8 @@ _${cli.cliName}_autocomplete() {
           .filter(Boolean)
           .join("\n        ")}
         *)
-          _arguments \\
-            '*: :_files' \\
+          _arguments \
+            '*: :_files' \
             && ret=0
           ;;
       esac
@@ -59,14 +63,14 @@ _${cli.cliName}_autocomplete() {
   return $ret
 }
   
-_${cli.cliName}_commands() {
+_${cliDefinition.cliName}_commands() {
   local -a commands=(
-    ${subcommands.map(subcommand => `"${subcommand.name}:${subcommand.description ?? ""}"`).join("\n    ")}
+    ${subcommands.map(subcommand => `"${subcommand.name}:${subcommand.meta?.description ?? ""}"`).join("\n    ")}
   )
 
   _describe -t subcommands 'subcommand' commands
 }
 
-compdef _${cli.cliName}_autocomplete ${cli.cliName}
+compdef _${cliDefinition.cliName}_autocomplete ${cliDefinition.cliName}
 `;
 }