politty 0.4.13 → 0.4.15

package/README.md

@@ -9,7 +9,7 @@ From simple scripts to complex CLI tools with subcommands, validation, and auto-
 - **Zod Native**: Use Zod schemas directly for argument definition and validation
 - **Type Safety**: Full TypeScript support with automatic type inference for parsed arguments
 - **Flexible Argument Definition**: Support for positional arguments, flags, aliases, arrays, and environment variable fallbacks
-- **Subcommands**: Build Git-style nested subcommands (with lazy loading support)
+- **Subcommands**: Build Git-style nested subcommands (with lazy loading and alias support)
 - **Lifecycle Management**: Guaranteed `setup` → `run` → `cleanup` execution order
 - **Signal Handling**: Proper SIGINT/SIGTERM handling with guaranteed cleanup execution
 - **Auto Help Generation**: Automatically generate help text from definitions
@@ -149,6 +149,7 @@ import { arg, defineCommand, runMain } from "politty";
 const initCommand = defineCommand({
   name: "init",
   description: "Initialize a project",
+  aliases: ["i"],
   args: z.object({
     template: arg(z.string().default("default"), {
       alias: "t",
@@ -163,6 +164,7 @@ const initCommand = defineCommand({
 const buildCommand = defineCommand({
   name: "build",
   description: "Build the project",
+  aliases: ["b"],
   args: z.object({
     output: arg(z.string().default("dist"), {
       alias: "o",
@@ -194,7 +196,9 @@ Example usage:
 
 ```bash
 $ my-cli init -t react
+$ my-cli i -t react        # alias for init
 $ my-cli build -o out -m
+$ my-cli b -o out -m        # alias for build
 $ my-cli --help
 ```
 
@@ -246,6 +250,7 @@ Define a command.
 | `name`        | `string`                      | Command name        |
 | `description` | `string?`                     | Command description |
 | `args`        | `ZodSchema`                   | Argument schema     |
+| `aliases`     | `string[]?`                   | Command aliases     |
 | `subCommands` | `Record<string, Command>?`    | Subcommands         |
 | `setup`       | `(context) => Promise<void>?` | Setup hook          |
 | `run`         | `(args) => T?`                | Run function        |
@@ -393,6 +398,7 @@ The `playground/` directory contains many examples:
 - `10-subcommands` - Subcommands
 - `12-discriminated-union` - Discriminated Union
 - `21-lazy-subcommands` - Lazy loading
+- `26-command-alias` - Command aliases
 
 ## License
 

package/dist/{arg-registry-CeIRoLaB.d.cts → arg-registry-CB5gGtzp.d.cts}

@@ -9,8 +9,17 @@ interface ResolvedFieldMeta {
   name: string;
   /** CLI option name (kebab-case, for command line usage) */
   cliName: string;
-  /** Short alias (e.g., 'v' for --verbose) */
-  alias?: string | undefined;
+  /**
+   * Aliases for this option, normalized to an array.
+   * 1-char entries are short aliases (`-v`); multi-char entries are long
+   * aliases (`--to-be`).
+   */
+  alias?: string[] | undefined;
+  /**
+   * Aliases that are accepted at parse time but hidden from help,
+   * generated docs, and shell completion.
+   */
+  hiddenAlias?: string[] | undefined;
   /** Argument description */
   description?: string | undefined;
   /** Whether this is a positional argument */
@@ -237,6 +246,8 @@ interface CommandBase<TArgsSchema extends ArgsSchema | undefined = undefined, TA
   name: string;
   /** Command description */
   description?: string | undefined;
+  /** Alternative names for this command (used as subcommand aliases) */
+  aliases?: string[] | undefined;
   /** Argument schema (preserves the original Zod schema type) */
   args: TArgsSchema;
   /** Subcommands */
@@ -586,17 +597,34 @@ interface BaseArgMeta<TValue = unknown> {
 }
 /**
  * Metadata for regular arguments (non-builtin aliases)
+ *
+ * `alias` accepts either a single string or an array of strings.
+ * Single-character entries become short options (e.g. `-v`); multi-character
+ * entries become additional long options (e.g. `--to-be` for `--tobe`).
  */
 interface RegularArgMeta<TValue = unknown> extends BaseArgMeta<TValue> {
-  /** Short alias (e.g., 'v' for --verbose) */
-  alias?: string;
+  /**
+   * Alias name(s) for this option.
+   * - 1-char string  → short alias (`-v`)
+   * - >1-char string → long alias (`--long-name`)
+   * - array          → multiple aliases of either kind
+   */
+  alias?: string | string[] | readonly string[];
+  /**
+   * Alias name(s) that are accepted by the parser but hidden from help,
+   * generated docs, and shell completion. Useful for legacy or deprecated
+   * names that should still work without being advertised.
+   */
+  hiddenAlias?: string | string[] | readonly string[];
 }
 /**
  * Metadata for overriding built-in aliases (-h, -H)
  */
 interface BuiltinOverrideArgMeta<TValue = unknown> extends BaseArgMeta<TValue> {
-  /** Built-in alias to override ('h' or 'H') */
-  alias: "h" | "H";
+  /** Built-in alias to override ('h' or 'H'), optionally combined with extra aliases */
+  alias: "h" | "H" | Array<"h" | "H" | string> | ReadonlyArray<"h" | "H" | string>;
+  /** Hidden aliases (accepted but not surfaced in help/docs/completion) */
+  hiddenAlias?: string | string[] | readonly string[];
   /** Must be true to override built-in aliases */
   overrideBuiltinAlias: true;
 }
@@ -628,18 +656,31 @@ type ArgMeta<TValue = unknown> = RegularArgMeta<TValue> | BuiltinOverrideArgMeta
  * ```
  */
 /**
- * Type helper to validate ArgMeta
- * Forces a type error if alias is "h" or "H" without overrideBuiltinAlias: true
+ * Detect whether `A` contains a reserved alias ("h" or "H"), for either a
+ * plain string or a tuple/array of strings. Uses `[A] extends [never]` to
+ * prevent distribution returning `never` for missing fields.
+ */
+type ContainsReservedAlias<A> = [A] extends [never] ? false : A extends "h" | "H" ? true : A extends readonly (infer E)[] ? [Extract<E, "h" | "H">] extends [never] ? false : true : false;
+type ReservedAliasTypeError<M> = { [K in keyof M]: M[K] } & {
+  __typeError: "Alias 'h' or 'H' requires overrideBuiltinAlias: true";
+};
+type AliasFieldOf<M> = M extends {
+  alias: infer A;
+} ? A : never;
+type HiddenAliasFieldOf<M> = M extends {
+  hiddenAlias: infer H;
+} ? H : never;
+/**
+ * Type helper to validate ArgMeta.
+ * Forces a type error when a reserved alias ("h" / "H") is used without
+ * `overrideBuiltinAlias: true`, whether the alias is provided as a string
+ * or as part of an array, and whether it appears in `alias` or `hiddenAlias`.
  */
 type ValidateArgMeta<M> = M extends {
-  alias: "h" | "H";
-} ? M extends {
   overrideBuiltinAlias: true;
-} ? M : { [K in keyof M]: M[K] } & {
-  __typeError: "Alias 'h' or 'H' requires overrideBuiltinAlias: true";
-} : M;
+} ? M : ContainsReservedAlias<AliasFieldOf<M>> extends true ? ReservedAliasTypeError<M> : ContainsReservedAlias<HiddenAliasFieldOf<M>> extends true ? ReservedAliasTypeError<M> : M;
 declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M>): T;
 //#endregion
 export { RunResultSuccess as A, UnknownKeysMode as B, Logger as C, RunCommandOptions as D, PromptResolver as E, LazyCommand as F, getUnknownKeysMode as H, isLazyCommand as I, lazy as L, SetupContext as M, SubCommandValue as N, RunResult as O, SubCommandsRecord as P, ExtractedFields as R, LogStream as S, NonRunnableCommand as T, toCamelCase as U, extractFields as V, toKebabCase as W, GlobalCleanupContext as _, EffectContext as a, LogEntry as b, arg as c, CleanupContext as d, CollectedLogs as f, GlobalArgs as g, Example as h, CustomCompletion as i, RunnableCommand as j, RunResultFailure as k, AnyCommand as l, CommandBase as m, CompletionMeta as n, PromptMeta as o, Command as p, CompletionType as r, PromptType as s, ArgMeta as t, ArgsSchema as u, GlobalSetupContext as v, MainOptions as w, LogLevel as x, IsEmpty as y, ResolvedFieldMeta as z };
-//# sourceMappingURL=arg-registry-CeIRoLaB.d.cts.map
+//# sourceMappingURL=arg-registry-CB5gGtzp.d.cts.map

package/dist/arg-registry-CB5gGtzp.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-registry-CB5gGtzp.d.cts","names":[],"sources":["../src/core/schema-extractor.ts","../src/lazy.ts","../src/types.ts","../src/core/arg-registry.ts"],"mappings":"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"}

package/dist/{arg-registry-6E4C5MTC.d.ts → arg-registry-Dw0f11Zc.d.ts}

@@ -9,8 +9,17 @@ interface ResolvedFieldMeta {
   name: string;
   /** CLI option name (kebab-case, for command line usage) */
   cliName: string;
-  /** Short alias (e.g., 'v' for --verbose) */
-  alias?: string | undefined;
+  /**
+   * Aliases for this option, normalized to an array.
+   * 1-char entries are short aliases (`-v`); multi-char entries are long
+   * aliases (`--to-be`).
+   */
+  alias?: string[] | undefined;
+  /**
+   * Aliases that are accepted at parse time but hidden from help,
+   * generated docs, and shell completion.
+   */
+  hiddenAlias?: string[] | undefined;
   /** Argument description */
   description?: string | undefined;
   /** Whether this is a positional argument */
@@ -237,6 +246,8 @@ interface CommandBase<TArgsSchema extends ArgsSchema | undefined = undefined, TA
   name: string;
   /** Command description */
   description?: string | undefined;
+  /** Alternative names for this command (used as subcommand aliases) */
+  aliases?: string[] | undefined;
   /** Argument schema (preserves the original Zod schema type) */
   args: TArgsSchema;
   /** Subcommands */
@@ -586,17 +597,34 @@ interface BaseArgMeta<TValue = unknown> {
 }
 /**
  * Metadata for regular arguments (non-builtin aliases)
+ *
+ * `alias` accepts either a single string or an array of strings.
+ * Single-character entries become short options (e.g. `-v`); multi-character
+ * entries become additional long options (e.g. `--to-be` for `--tobe`).
  */
 interface RegularArgMeta<TValue = unknown> extends BaseArgMeta<TValue> {
-  /** Short alias (e.g., 'v' for --verbose) */
-  alias?: string;
+  /**
+   * Alias name(s) for this option.
+   * - 1-char string  → short alias (`-v`)
+   * - >1-char string → long alias (`--long-name`)
+   * - array          → multiple aliases of either kind
+   */
+  alias?: string | string[] | readonly string[];
+  /**
+   * Alias name(s) that are accepted by the parser but hidden from help,
+   * generated docs, and shell completion. Useful for legacy or deprecated
+   * names that should still work without being advertised.
+   */
+  hiddenAlias?: string | string[] | readonly string[];
 }
 /**
  * Metadata for overriding built-in aliases (-h, -H)
  */
 interface BuiltinOverrideArgMeta<TValue = unknown> extends BaseArgMeta<TValue> {
-  /** Built-in alias to override ('h' or 'H') */
-  alias: "h" | "H";
+  /** Built-in alias to override ('h' or 'H'), optionally combined with extra aliases */
+  alias: "h" | "H" | Array<"h" | "H" | string> | ReadonlyArray<"h" | "H" | string>;
+  /** Hidden aliases (accepted but not surfaced in help/docs/completion) */
+  hiddenAlias?: string | string[] | readonly string[];
   /** Must be true to override built-in aliases */
   overrideBuiltinAlias: true;
 }
@@ -628,18 +656,31 @@ type ArgMeta<TValue = unknown> = RegularArgMeta<TValue> | BuiltinOverrideArgMeta
  * ```
  */
 /**
- * Type helper to validate ArgMeta
- * Forces a type error if alias is "h" or "H" without overrideBuiltinAlias: true
+ * Detect whether `A` contains a reserved alias ("h" or "H"), for either a
+ * plain string or a tuple/array of strings. Uses `[A] extends [never]` to
+ * prevent distribution returning `never` for missing fields.
+ */
+type ContainsReservedAlias<A> = [A] extends [never] ? false : A extends "h" | "H" ? true : A extends readonly (infer E)[] ? [Extract<E, "h" | "H">] extends [never] ? false : true : false;
+type ReservedAliasTypeError<M> = { [K in keyof M]: M[K] } & {
+  __typeError: "Alias 'h' or 'H' requires overrideBuiltinAlias: true";
+};
+type AliasFieldOf<M> = M extends {
+  alias: infer A;
+} ? A : never;
+type HiddenAliasFieldOf<M> = M extends {
+  hiddenAlias: infer H;
+} ? H : never;
+/**
+ * Type helper to validate ArgMeta.
+ * Forces a type error when a reserved alias ("h" / "H") is used without
+ * `overrideBuiltinAlias: true`, whether the alias is provided as a string
+ * or as part of an array, and whether it appears in `alias` or `hiddenAlias`.
  */
 type ValidateArgMeta<M> = M extends {
-  alias: "h" | "H";
-} ? M extends {
   overrideBuiltinAlias: true;
-} ? M : { [K in keyof M]: M[K] } & {
-  __typeError: "Alias 'h' or 'H' requires overrideBuiltinAlias: true";
-} : M;
+} ? M : ContainsReservedAlias<AliasFieldOf<M>> extends true ? ReservedAliasTypeError<M> : ContainsReservedAlias<HiddenAliasFieldOf<M>> extends true ? ReservedAliasTypeError<M> : M;
 declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M>): T;
 //#endregion
 export { RunResultSuccess as A, UnknownKeysMode as B, Logger as C, RunCommandOptions as D, PromptResolver as E, LazyCommand as F, getUnknownKeysMode as H, isLazyCommand as I, lazy as L, SetupContext as M, SubCommandValue as N, RunResult as O, SubCommandsRecord as P, ExtractedFields as R, LogStream as S, NonRunnableCommand as T, toCamelCase as U, extractFields as V, toKebabCase as W, GlobalCleanupContext as _, EffectContext as a, LogEntry as b, arg as c, CleanupContext as d, CollectedLogs as f, GlobalArgs as g, Example as h, CustomCompletion as i, RunnableCommand as j, RunResultFailure as k, AnyCommand as l, CommandBase as m, CompletionMeta as n, PromptMeta as o, Command as p, CompletionType as r, PromptType as s, ArgMeta as t, ArgsSchema as u, GlobalSetupContext as v, MainOptions as w, LogLevel as x, IsEmpty as y, ResolvedFieldMeta as z };
-//# sourceMappingURL=arg-registry-6E4C5MTC.d.ts.map
+//# sourceMappingURL=arg-registry-Dw0f11Zc.d.ts.map

package/dist/arg-registry-Dw0f11Zc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-registry-Dw0f11Zc.d.ts","names":[],"sources":["../src/core/schema-extractor.ts","../src/lazy.ts","../src/types.ts","../src/core/arg-registry.ts"],"mappings":";;;AAwCA;;;AAAA,UAAiB,iBAAA;EAwCF;EAtCb,IAAA;EA0CoC;EAxCpC,OAAA;EAwCwE;;;;;EAlCxE,KAAA;EAOA;;;;EAFA,WAAA;EAeA;EAbA,WAAA;EAiBA;EAfA,UAAA;EAeU;EAbV,WAAA;EAiBA;;;;EAZA,GAAA;EAkBA;EAhBA,QAAA;EAgBoC;EAdpC,YAAA;EAc6D;EAZ7D,IAAA;EAYwE;EAVxE,MAAA,EAAQ,CAAA,CAAE,OAAA;EAgBoB;EAd9B,oBAAA;EAgBQ;EAdR,UAAA;EAwBU;EAtBV,UAAA,GAAa,cAAA;EA0BE;EAxBf,MAAA,GAAS,UAAA;EAiCuB;EA/BhC,MAAA,KAAW,KAAA,WAAgB,OAAA,EAAS,aAAA,YAAyB,WAAA;AAAA;;;;UAM9C,eAAA;EAQf;EANA,MAAA,EAAQ,iBAAA;EAQG;EANX,MAAA,EAAQ,UAAA;EAQN;EANF,UAAA;EAOE;EALF,aAAA;EAQe;EANf,QAAA,GAAW,KAAA;IACT,kBAAA;IACA,MAAA,EAAQ,iBAAA;IACR,WAAA;EAAA;EAqBQ;EAlBV,YAAA,GAAe,eAAA;;EAEf,WAAA;EAgByB;AA6C3B;;;;;EAtDE,eAAA,EAAiB,eAAA;AAAA;;;;AA0MnB;;;KAjMY,eAAA;;AAmNZ;;;;;AA6UA;;iBAnfgB,kBAAA,CAAmB,MAAA,EAAQ,CAAA,CAAE,OAAA,GAAU,eAAA;;;ACzJvD;;;;iBD6SgB,WAAA,CAAY,GAAA;;;;;;;;;;;;iBAkBZ,WAAA,CAAY,GAAA;;;;;;;iBA6UZ,aAAA,CAAc,MAAA,EAAQ,UAAA,GAAa,eAAA;;;;;;;;UC5oBlC,WAAA,WAAsB,UAAA,GAAa,UAAA;EAAA,SACzC,gBAAA;EAAA,SACA,IAAA,EAAM,CAAA;EAAA,SACN,IAAA,QAAY,OAAA,CAAQ,UAAA;AAAA;;;;iBAMf,aAAA,CAAc,KAAA,YAAiB,KAAA,IAAS,WAAA;;;;;;;;;;;;;;;;;;;;;;;ADiExD;;;;;;iBC/BgB,IAAA,WAAe,UAAA,CAAA,CAC7B,IAAA,EAAM,CAAA,EACN,IAAA,QAAY,OAAA,CAAQ,UAAA,IACnB,WAAA,CAAY,CAAA;;;ADtBf;;;;;;;;;;AAAA,UExBiB,UAAA;;;;KAKL,OAAA,YAAmB,CAAA;;;;UAKd,OAAA;EF8Cf;EE5CA,GAAA;EF8CQ;EE5CR,IAAA;EF8CA;EE5CA,MAAA;AAAA;;;;;UAOe,MAAA;EF6CqB;EE3CpC,GAAA,CAAI,OAAA;EF2CyD;EEzC7D,KAAA,CAAM,OAAA;AAAA;AF+CR;;;AAAA,KExCY,UAAA,GAAa,CAAA,CAAE,OAAA,CAAQ,MAAA;;;;UAKlB,YAAA;EF4DE;EE1DjB,IAAA,EAAM,KAAA;AAAA;;;;UAMS,cAAA;EFiCf;EE/BA,IAAA,EAAM,KAAA;EFmCN;EEjCA,KAAA,GAAQ,KAAA;AAAA;;;;UAOO,kBAAA;;;;UAKA,oBAAA;EFoCiB;EElChC,KAAA,GAAQ,KAAA;AAAA;;;;AFwFV;;UEhFiB,WAAA,qBACK,UAAA;EF+EgD;EE3EpE,IAAA;EF2E2C;EEzE3C,WAAA;EFyEqD;EEvErD,OAAA;EFuEoE;EErEpE,IAAA,EAAM,WAAA;EFyNmB;EEvNzB,WAAA,GAAc,iBAAA;EFuNY;EErN1B,KAAA,KAAU,OAAA,EAAS,YAAA,CAAa,KAAA,aAAkB,OAAA;EFuOpC;EErOd,OAAA,KAAY,OAAA,EAAS,cAAA,CAAe,KAAA,aAAkB,OAAA;;EAEtD,KAAA;EFmOqC;EEjOrC,QAAA,GAAW,OAAA;AAAA;;;;;;;UASI,eAAA,qBACK,UAAA,sEAGZ,WAAA,CAAY,WAAA,EAAa,KAAA;;EAEjC,GAAA,GAAM,IAAA,EAAM,KAAA,KAAU,OAAA;AAAA;AD7GxB;;;;;AAAA,UCqHiB,kBAAA,qBACK,UAAA,mDAEZ,WAAA,CAAY,WAAA,EAAa,KAAA;EDrHJ;ECuH7B,GAAA;AAAA;;;;KAMU,OAAA,qBACU,UAAA,gEAGlB,eAAA,CAAgB,WAAA,EAAa,KAAA,EAAO,OAAA,IAAW,kBAAA,CAAmB,WAAA,EAAa,KAAA;;;;;;;KAS9E,OAAA;;ADpIL;;;KC2IK,SAAA;;;;;KAMO,UAAA,GAAa,OAAA,CAAQ,UAAA,cAAwB,OAAA,EAAS,SAAA;AD/GlE;;;AAAA,KCoHY,eAAA,GAAkB,UAAA,UAAoB,OAAA,CAAQ,UAAA,KAAe,WAAA;;;;KAK7D,iBAAA,GAAoB,MAAA,SAAe,eAAA;;;;;;KAOnC,cAAA,IACV,OAAA,EAAS,MAAA,mBACT,SAAA,EAAW,eAAA,KACR,OAAA,CAAQ,MAAA;;;;UAKI,WAAA;EDrId;ECuID,OAAA;EDvIc;ECyId,KAAA;;EAEA,WAAA;;EAEA,cAAA;EA3LyB;EA6LzB,MAAA,GAAS,MAAA;EA7LgB;EA+LzB,UAAA,GAAa,UAAA;EA1LH;EA4LV,KAAA,KAAU,OAAA,EAAS,kBAAA,YAA8B,OAAA;EA5LhC;EA8LjB,OAAA,KAAY,OAAA,EAAS,oBAAA,YAAgC,OAAA;EA9LvB;EAgM9B,aAAA;EA3LsB;EA6LtB,MAAA,GAAS,cAAA;AAAA;;;;UAMM,iBAAA;EA7LT;EA+LN,KAAA;EAxLqB;EA0LrB,WAAA;EA1LqB;EA4LrB,cAAA;EA1LI;EA4LJ,MAAA,GAAS,MAAA;EA1LH;EA4LN,UAAA,GAAa,UAAA;EA5LQ;EA8LrB,KAAA,KAAU,OAAA,EAAS,kBAAA,YAA8B,OAAA;EAvL7B;EAyLpB,OAAA,KAAY,OAAA,EAAS,oBAAA,YAAgC,OAAA;EAzLrB;EA2LhC,MAAA,GAAS,cAAA;AAAA;;;AA9JX;KA+LY,QAAA;;;;KAKA,SAAA;;;;UAKK,QAAA;EAlLD;EAoLd,OAAA;EAlLmB;EAoLnB,SAAA,EAAW,IAAA;EAlLyB;EAoLpC,KAAA,EAAO,QAAA;EApL+C;EAsLtD,MAAA,EAAQ,SAAA;AAAA;;;;UAMO,aAAA;EAxMf;EA0MA,OAAA,EAAS,QAAA;AAAA;;;;UAMM,gBAAA;EAtMf;EAwMA,OAAA;EAxMgC;EA0MhC,MAAA,EAAQ,CAAA;EA1M0C;EA4MlD,KAAA;EA1MqB;EA4MrB,QAAA;EA5MY;EA8MZ,IAAA,EAAM,aAAA;AAAA;;;;UAMS,gBAAA;EAvMA;EAyMf,OAAA;EAzM8B;EA2M9B,MAAA;EAvMoB;EAyMpB,KAAA,EAAO,KAAA;EAvMK;EAyMZ,QAAA;EA3MQ;EA6MR,IAAA,EAAM,aAAA;AAAA;;;;KAMI,SAAA,gBAAyB,gBAAA,CAAiB,CAAA,IAAK,gBAAA;;;;AFtS3D;;KGjCY,cAAA;;;;UAKK,gBAAA;EHwE8C;EGtE7D,OAAA;EHsEwE;EGpExE,YAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;AH0EF;;;;;;KGxCY,cAAA;EHwDK,+BGtDf,IAAA,GAAO,cAAA,EH+DyB;EG7DhC,MAAA,GAAS,gBAAA;AAAA;EHsCD,+DGnC4D,UAAA;EAChE,OAAA;AAAA;EHsCJ,yEGnC8E,OAAA;EAC1E,UAAA;AAAA;;;;;;;;;;;KAcM,UAAA;;AHgDZ;;;;;AA6CA;;;;;;;;;;AAoJA;;;;;AAkBA;UG3OiB,UAAA;;EAEf,OAAA;EHyOqC;EGvOrC,IAAA,GAAO,UAAA;EHojBoB;EGljB3B,OAAA,GAAU,KAAA;IAAiB,KAAA;IAAe,KAAA;EAAA;EHkjBO;EGhjBjD,OAAA;AAAA;;;;AF5FF;KEmGY,aAAA;EFnGgB,6BEqG1B,IAAA,UFrGkD;EEuGlD,IAAA,EAAM,QAAA,CAAS,MAAA;AAAA,KACZ,OAAA,CAAQ,UAAA;EACP,UAAA,GAAa,QAAA,CAAS,MAAA;AAAA;EACtB,UAAA,GAAa,QAAA,CAAS,UAAA;AAAA;;;;UAKX,WAAA;EF7GA;EE+Gf,WAAA;EF9GqB;EEgHrB,UAAA;EFhHuC;EEkHvC,WAAA;EF5Gc;;;;;;;;;AAkChB;;;;;EEyFE,GAAA;EFvFY;EEyFZ,UAAA,GAAa,cAAA;EFxFZ;;;;;;;;;;;;;EEsGD,MAAA,GAAS,UAAA;;;;ADpJX;;;;;AAKA;;;;;AAKA;;EC0JE,MAAA,IAAU,KAAA,EAAO,MAAA,EAAQ,OAAA,EAAS,aAAA,YAAyB,WAAA;AAAA;;;;;;AD7I7D;;UCuJiB,cAAA,2BAAyC,WAAA,CAAY,MAAA;EDvJ/C;;;;;;EC8JrB,KAAA;EDnJU;;;;;ECyJV,WAAA;AAAA;;;ADpJF;UC0JiB,sBAAA,2BAAiD,WAAA,CAAY,MAAA;ED1JjD;EC4J3B,KAAA,cAAmB,KAAA,uBAA4B,aAAA;ED5JnB;EC8J5B,WAAA;ED5JM;EC8JN,oBAAA;AAAA;ADxJF;;;AAAA,KC8JY,OAAA,qBAA4B,cAAA,CAAe,MAAA,IAAU,sBAAA,CAAuB,MAAA;;;ADnJxF;;;;;AAKA;;;;;AAUA;;;;;;;;;;;;;;;;KCwKK,qBAAA,OAA4B,CAAA,4BAE7B,CAAA,4BAEE,CAAA,iCACG,OAAA,CAAQ,CAAA;AAAA,KAKZ,sBAAA,oBACS,CAAA,GAAI,CAAA,CAAE,CAAA;EAElB,WAAA;AAAA;AAAA,KAGG,YAAA,MAAkB,CAAA;EAAY,KAAA;AAAA,IAAmB,CAAA;AAAA,KACjD,kBAAA,MAAwB,CAAA;EAAY,WAAA;AAAA,IAAyB,CAAA;;;;;;;KAQ7D,eAAA,MAAqB,CAAA;EAAY,oBAAA;AAAA,IAClC,CAAA,GACA,qBAAA,CAAsB,YAAA,CAAa,CAAA,kBACjC,sBAAA,CAAuB,CAAA,IACvB,qBAAA,CAAsB,kBAAA,CAAmB,CAAA,kBACvC,sBAAA,CAAuB,CAAA,IACvB,CAAA;AAAA,iBAEQ,GAAA,WAAc,CAAA,CAAE,OAAA,CAAA,CAAS,MAAA,EAAQ,CAAA,GAAI,CAAA;AAAA,iBACrC,GAAA,WAAc,CAAA,CAAE,OAAA,YAAmB,OAAA,CAAQ,CAAA,CAAE,MAAA,CAAO,CAAA,GAAA,CAClE,MAAA,EAAQ,CAAA,EACR,IAAA,EAAM,eAAA,CAAgB,CAAA,IACrB,CAAA"}

package/dist/augment.d.cts

@@ -1,4 +1,4 @@
-import { t as ArgMeta } from "./arg-registry-CeIRoLaB.cjs";
+import { t as ArgMeta } from "./arg-registry-CB5gGtzp.cjs";
 
 //#region src/augment.d.ts
 declare module "zod" {
@@ -9,7 +9,8 @@ declare module "zod" {
     description?: string;
     positional?: boolean;
     placeholder?: string;
-    alias?: string;
+    alias?: string | string[] | readonly string[];
+    hiddenAlias?: string | string[] | readonly string[];
     overrideBuiltinAlias?: boolean;
   }
 }

package/dist/augment.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"augment.d.cts","names":[],"sources":["../src/augment.ts"],"mappings":";;;;YAiBY,UAAA;IACR,OAAA,GAAU,OAAA;EAAA;EAAA,UAGF,UAAA;IACR,WAAA;IACA,UAAA;IACA,WAAA;IACA,KAAA;IACA,oBAAA;EAAA;AAAA"}
+{"version":3,"file":"augment.d.cts","names":[],"sources":["../src/augment.ts"],"mappings":";;;;YAiBY,UAAA;IACR,OAAA,GAAU,OAAA;EAAA;EAAA,UAGF,UAAA;IACR,WAAA;IACA,UAAA;IACA,WAAA;IACA,KAAA;IACA,WAAA;IACA,oBAAA;EAAA;AAAA"}

package/dist/augment.d.ts

@@ -1,4 +1,4 @@
-import { t as ArgMeta } from "./arg-registry-6E4C5MTC.js";
+import { t as ArgMeta } from "./arg-registry-Dw0f11Zc.js";
 
 //#region src/augment.d.ts
 declare module "zod" {
@@ -9,7 +9,8 @@ declare module "zod" {
     description?: string;
     positional?: boolean;
     placeholder?: string;
-    alias?: string;
+    alias?: string | string[] | readonly string[];
+    hiddenAlias?: string | string[] | readonly string[];
     overrideBuiltinAlias?: boolean;
   }
 }

package/dist/augment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"augment.d.ts","names":[],"sources":["../src/augment.ts"],"mappings":";;;;YAiBY,UAAA;IACR,OAAA,GAAU,OAAA;EAAA;EAAA,UAGF,UAAA;IACR,WAAA;IACA,UAAA;IACA,WAAA;IACA,KAAA;IACA,oBAAA;EAAA;AAAA"}
+{"version":3,"file":"augment.d.ts","names":[],"sources":["../src/augment.ts"],"mappings":";;;;YAiBY,UAAA;IACR,OAAA,GAAU,OAAA;EAAA;EAAA,UAGF,UAAA;IACR,WAAA;IACA,UAAA;IACA,WAAA;IACA,KAAA;IACA,WAAA;IACA,oBAAA;EAAA;AAAA"}

package/dist/completion/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_completion = require('../completion-D3LUac1o.cjs');
+const require_completion = require('../completion-B5fgnUGm.cjs');
 
 exports.CompletionDirective = require_completion.CompletionDirective;
 exports.createCompletionCommand = require_completion.createCompletionCommand;

package/dist/completion/index.d.cts

@@ -1,2 +1,2 @@
-import { C as CompletableSubcommand, D as CompletionResult, E as CompletionOptions, O as ShellType, S as CompletableOption, T as CompletionGenerator, _ as CompletionDirective, a as getSupportedShells, b as CompletionType, c as resolveValueCompletion, d as ShellFormatOptions, f as formatForShell, g as CompletionCandidate, h as CandidateResult, i as generateCompletion, l as extractCompletionData, m as hasCompleteCommand, n as createCompletionCommand, o as withCompletionCommand, p as createDynamicCompleteCommand, r as detectShell, s as ValueCompletionField, t as WithCompletionOptions, u as extractPositionals, v as generateCandidates, w as CompletionData, x as parseCompletionContext, y as CompletionContext } from "../index-BW02tH1-.cjs";
+import { C as CompletableSubcommand, D as CompletionResult, E as CompletionOptions, O as ShellType, S as CompletableOption, T as CompletionGenerator, _ as CompletionDirective, a as getSupportedShells, b as CompletionType, c as resolveValueCompletion, d as ShellFormatOptions, f as formatForShell, g as CompletionCandidate, h as CandidateResult, i as generateCompletion, l as extractCompletionData, m as hasCompleteCommand, n as createCompletionCommand, o as withCompletionCommand, p as createDynamicCompleteCommand, r as detectShell, s as ValueCompletionField, t as WithCompletionOptions, u as extractPositionals, v as generateCandidates, w as CompletionData, x as parseCompletionContext, y as CompletionContext } from "../index-C1gGgUeB.cjs";
 export { CandidateResult, CompletableOption, CompletableSubcommand, CompletionCandidate, CompletionContext, CompletionData, CompletionDirective, CompletionGenerator, CompletionOptions, CompletionResult, CompletionType, ShellFormatOptions, ShellType, ValueCompletionField, WithCompletionOptions, createCompletionCommand, createDynamicCompleteCommand, detectShell, extractCompletionData, extractPositionals, formatForShell, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, withCompletionCommand };

package/dist/completion/index.d.ts

@@ -1,2 +1,2 @@
-import { C as CompletableSubcommand, D as CompletionResult, E as CompletionOptions, O as ShellType, S as CompletableOption, T as CompletionGenerator, _ as CompletionDirective, a as getSupportedShells, b as CompletionType, c as resolveValueCompletion, d as ShellFormatOptions, f as formatForShell, g as CompletionCandidate, h as CandidateResult, i as generateCompletion, l as extractCompletionData, m as hasCompleteCommand, n as createCompletionCommand, o as withCompletionCommand, p as createDynamicCompleteCommand, r as detectShell, s as ValueCompletionField, t as WithCompletionOptions, u as extractPositionals, v as generateCandidates, w as CompletionData, x as parseCompletionContext, y as CompletionContext } from "../index-C3UtsvgY.js";
+import { C as CompletableSubcommand, D as CompletionResult, E as CompletionOptions, O as ShellType, S as CompletableOption, T as CompletionGenerator, _ as CompletionDirective, a as getSupportedShells, b as CompletionType, c as resolveValueCompletion, d as ShellFormatOptions, f as formatForShell, g as CompletionCandidate, h as CandidateResult, i as generateCompletion, l as extractCompletionData, m as hasCompleteCommand, n as createCompletionCommand, o as withCompletionCommand, p as createDynamicCompleteCommand, r as detectShell, s as ValueCompletionField, t as WithCompletionOptions, u as extractPositionals, v as generateCandidates, w as CompletionData, x as parseCompletionContext, y as CompletionContext } from "../index-Dg9Fpz0R.js";
 export { CandidateResult, CompletableOption, CompletableSubcommand, CompletionCandidate, CompletionContext, CompletionData, CompletionDirective, CompletionGenerator, CompletionOptions, CompletionResult, CompletionType, ShellFormatOptions, ShellType, ValueCompletionField, WithCompletionOptions, createCompletionCommand, createDynamicCompleteCommand, detectShell, extractCompletionData, extractPositionals, formatForShell, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, withCompletionCommand };

package/dist/completion/index.js

@@ -1,3 +1,3 @@
-import { a as withCompletionCommand, c as formatForShell, d as generateCandidates, f as extractCompletionData, i as getSupportedShells, l as parseCompletionContext, m as resolveValueCompletion, n as detectShell, o as createDynamicCompleteCommand, p as extractPositionals, r as generateCompletion, s as hasCompleteCommand, t as createCompletionCommand, u as CompletionDirective } from "../completion-DzaT2YCN.js";
+import { a as withCompletionCommand, c as formatForShell, d as generateCandidates, f as extractCompletionData, i as getSupportedShells, l as parseCompletionContext, m as resolveValueCompletion, n as detectShell, o as createDynamicCompleteCommand, p as extractPositionals, r as generateCompletion, s as hasCompleteCommand, t as createCompletionCommand, u as CompletionDirective } from "../completion-Ca5ESJlG.js";
 
 export { CompletionDirective, createCompletionCommand, createDynamicCompleteCommand, detectShell, extractCompletionData, extractPositionals, formatForShell, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, withCompletionCommand };