politty 0.4.13 → 0.4.14

package/dist/{index-BW02tH1-.d.cts → index-BLySW_2k.d.ts}

@@ -1,4 +1,4 @@
-import { l as AnyCommand, p as Command, u as ArgsSchema, z as ResolvedFieldMeta } from "./arg-registry-CeIRoLaB.cjs";
+import { l as AnyCommand, p as Command, u as ArgsSchema, z as ResolvedFieldMeta } from "./arg-registry-CkPDokIu.js";
 import { z } from "zod";
 
 //#region src/completion/types.d.ts
@@ -43,8 +43,11 @@ interface CompletableOption {
   name: string;
   /** CLI name (kebab-case, e.g., "dry-run") */
   cliName: string;
-  /** Short alias (e.g., "v") */
-  alias?: string | undefined;
+  /**
+   * Aliases for this option (both short and long).
+   * 1-char entries are short (`-v`); multi-char entries are long (`--to-be`).
+   */
+  alias?: string[] | undefined;
   /** Description for completion */
   description?: string | undefined;
   /** Whether this option takes a value */
@@ -367,4 +370,4 @@ interface WithCompletionOptions {
 declare function withCompletionCommand<T extends AnyCommand>(command: T, options?: string | WithCompletionOptions): T;
 //#endregion
 export { CompletableSubcommand as C, CompletionResult as D, CompletionOptions as E, ShellType as O, CompletableOption as S, CompletionGenerator as T, CompletionDirective as _, getSupportedShells as a, CompletionType as b, resolveValueCompletion as c, ShellFormatOptions as d, formatForShell as f, CompletionCandidate as g, CandidateResult as h, generateCompletion as i, extractCompletionData as l, hasCompleteCommand as m, createCompletionCommand as n, withCompletionCommand as o, createDynamicCompleteCommand as p, detectShell as r, ValueCompletionField as s, WithCompletionOptions as t, extractPositionals as u, generateCandidates as v, CompletionData as w, parseCompletionContext as x, CompletionContext as y };
-//# sourceMappingURL=index-BW02tH1-.d.cts.map
+//# sourceMappingURL=index-BLySW_2k.d.ts.map

package/dist/index-BLySW_2k.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BLySW_2k.d.ts","names":[],"sources":["../src/completion/types.ts","../src/completion/dynamic/context-parser.ts","../src/completion/dynamic/candidate-generator.ts","../src/completion/dynamic/complete-command.ts","../src/completion/dynamic/shell-formatter.ts","../src/completion/extractor.ts","../src/completion/value-completion-resolver.ts","../src/completion/index.ts"],"mappings":"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"}

package/dist/{index-C3UtsvgY.d.ts → index-DPswv0Vt.d.cts}

@@ -1,4 +1,4 @@
-import { l as AnyCommand, p as Command, u as ArgsSchema, z as ResolvedFieldMeta } from "./arg-registry-6E4C5MTC.js";
+import { l as AnyCommand, p as Command, u as ArgsSchema, z as ResolvedFieldMeta } from "./arg-registry-r5wYN6qd.cjs";
 import { z } from "zod";
 
 //#region src/completion/types.d.ts
@@ -43,8 +43,11 @@ interface CompletableOption {
   name: string;
   /** CLI name (kebab-case, e.g., "dry-run") */
   cliName: string;
-  /** Short alias (e.g., "v") */
-  alias?: string | undefined;
+  /**
+   * Aliases for this option (both short and long).
+   * 1-char entries are short (`-v`); multi-char entries are long (`--to-be`).
+   */
+  alias?: string[] | undefined;
   /** Description for completion */
   description?: string | undefined;
   /** Whether this option takes a value */
@@ -367,4 +370,4 @@ interface WithCompletionOptions {
 declare function withCompletionCommand<T extends AnyCommand>(command: T, options?: string | WithCompletionOptions): T;
 //#endregion
 export { CompletableSubcommand as C, CompletionResult as D, CompletionOptions as E, ShellType as O, CompletableOption as S, CompletionGenerator as T, CompletionDirective as _, getSupportedShells as a, CompletionType as b, resolveValueCompletion as c, ShellFormatOptions as d, formatForShell as f, CompletionCandidate as g, CandidateResult as h, generateCompletion as i, extractCompletionData as l, hasCompleteCommand as m, createCompletionCommand as n, withCompletionCommand as o, createDynamicCompleteCommand as p, detectShell as r, ValueCompletionField as s, WithCompletionOptions as t, extractPositionals as u, generateCandidates as v, CompletionData as w, parseCompletionContext as x, CompletionContext as y };
-//# sourceMappingURL=index-C3UtsvgY.d.ts.map
+//# sourceMappingURL=index-DPswv0Vt.d.cts.map

package/dist/index-DPswv0Vt.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DPswv0Vt.d.cts","names":[],"sources":["../src/completion/types.ts","../src/completion/dynamic/context-parser.ts","../src/completion/dynamic/candidate-generator.ts","../src/completion/dynamic/complete-command.ts","../src/completion/dynamic/shell-formatter.ts","../src/completion/extractor.ts","../src/completion/value-completion-resolver.ts","../src/completion/index.ts"],"mappings":"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"}

package/dist/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_lazy = require('./lazy-qPy4cMnv.cjs');
-const require_completion = require('./completion-D3LUac1o.cjs');
-const require_runner = require('./runner-DA48D-3K.cjs');
+const require_lazy = require('./lazy-AGV9Pkt5.cjs');
+const require_completion = require('./completion-CAekGYS4.cjs');
+const require_runner = require('./runner-CY5fOsSh.cjs');
 
 exports.CaseVariantCollisionError = require_runner.CaseVariantCollisionError;
 exports.DuplicateAliasError = require_runner.DuplicateAliasError;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as RunResultSuccess, B as UnknownKeysMode, C as Logger, D as RunCommandOptions, E as PromptResolver, F as LazyCommand, H as getUnknownKeysMode, I as isLazyCommand, L as lazy, M as SetupContext, N as SubCommandValue, O as RunResult, P as SubCommandsRecord, R as ExtractedFields, S as LogStream, T as NonRunnableCommand, U as toCamelCase, V as extractFields, W as toKebabCase, _ as GlobalCleanupContext, a as EffectContext, b as LogEntry, c as arg, d as CleanupContext, f as CollectedLogs, g as GlobalArgs, h as Example, i as CustomCompletion, j as RunnableCommand, k as RunResultFailure, l as AnyCommand, m as CommandBase, n as CompletionMeta, o as PromptMeta, p as Command, r as CompletionType, s as PromptType, t as ArgMeta, u as ArgsSchema, v as GlobalSetupContext, w as MainOptions, x as LogLevel, y as IsEmpty, z as ResolvedFieldMeta } from "./arg-registry-CeIRoLaB.cjs";
-import { D as CompletionResult, E as CompletionOptions, i as generateCompletion, o as withCompletionCommand, t as WithCompletionOptions } from "./index-BW02tH1-.cjs";
+import { A as RunResultSuccess, B as UnknownKeysMode, C as Logger, D as RunCommandOptions, E as PromptResolver, F as LazyCommand, H as getUnknownKeysMode, I as isLazyCommand, L as lazy, M as SetupContext, N as SubCommandValue, O as RunResult, P as SubCommandsRecord, R as ExtractedFields, S as LogStream, T as NonRunnableCommand, U as toCamelCase, V as extractFields, W as toKebabCase, _ as GlobalCleanupContext, a as EffectContext, b as LogEntry, c as arg, d as CleanupContext, f as CollectedLogs, g as GlobalArgs, h as Example, i as CustomCompletion, j as RunnableCommand, k as RunResultFailure, l as AnyCommand, m as CommandBase, n as CompletionMeta, o as PromptMeta, p as Command, r as CompletionType, s as PromptType, t as ArgMeta, u as ArgsSchema, v as GlobalSetupContext, w as MainOptions, x as LogLevel, y as IsEmpty, z as ResolvedFieldMeta } from "./arg-registry-r5wYN6qd.cjs";
+import { D as CompletionResult, E as CompletionOptions, i as generateCompletion, o as withCompletionCommand, t as WithCompletionOptions } from "./index-DPswv0Vt.cjs";
 import { z } from "zod";
 
 //#region src/core/case-types.d.ts

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/core/case-types.ts","../src/core/case-proxy.ts","../src/core/command.ts","../src/core/runner.ts","../src/output/help-generator.ts","../src/output/logger.ts","../src/output/markdown-renderer.ts","../src/parser/argv-parser.ts","../src/validator/validation-errors.ts","../src/validator/command-validator.ts","../src/validator/zod-validator.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/core/case-types.ts","../src/core/case-proxy.ts","../src/core/command.ts","../src/core/runner.ts","../src/output/help-generator.ts","../src/output/logger.ts","../src/output/markdown-renderer.ts","../src/parser/argv-parser.ts","../src/validator/validation-errors.ts","../src/validator/command-validator.ts","../src/validator/zod-validator.ts"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as RunResultSuccess, B as UnknownKeysMode, C as Logger, D as RunCommandOptions, E as PromptResolver, F as LazyCommand, H as getUnknownKeysMode, I as isLazyCommand, L as lazy, M as SetupContext, N as SubCommandValue, O as RunResult, P as SubCommandsRecord, R as ExtractedFields, S as LogStream, T as NonRunnableCommand, U as toCamelCase, V as extractFields, W as toKebabCase, _ as GlobalCleanupContext, a as EffectContext, b as LogEntry, c as arg, d as CleanupContext, f as CollectedLogs, g as GlobalArgs, h as Example, i as CustomCompletion, j as RunnableCommand, k as RunResultFailure, l as AnyCommand, m as CommandBase, n as CompletionMeta, o as PromptMeta, p as Command, r as CompletionType, s as PromptType, t as ArgMeta, u as ArgsSchema, v as GlobalSetupContext, w as MainOptions, x as LogLevel, y as IsEmpty, z as ResolvedFieldMeta } from "./arg-registry-6E4C5MTC.js";
-import { D as CompletionResult, E as CompletionOptions, i as generateCompletion, o as withCompletionCommand, t as WithCompletionOptions } from "./index-C3UtsvgY.js";
+import { A as RunResultSuccess, B as UnknownKeysMode, C as Logger, D as RunCommandOptions, E as PromptResolver, F as LazyCommand, H as getUnknownKeysMode, I as isLazyCommand, L as lazy, M as SetupContext, N as SubCommandValue, O as RunResult, P as SubCommandsRecord, R as ExtractedFields, S as LogStream, T as NonRunnableCommand, U as toCamelCase, V as extractFields, W as toKebabCase, _ as GlobalCleanupContext, a as EffectContext, b as LogEntry, c as arg, d as CleanupContext, f as CollectedLogs, g as GlobalArgs, h as Example, i as CustomCompletion, j as RunnableCommand, k as RunResultFailure, l as AnyCommand, m as CommandBase, n as CompletionMeta, o as PromptMeta, p as Command, r as CompletionType, s as PromptType, t as ArgMeta, u as ArgsSchema, v as GlobalSetupContext, w as MainOptions, x as LogLevel, y as IsEmpty, z as ResolvedFieldMeta } from "./arg-registry-CkPDokIu.js";
+import { D as CompletionResult, E as CompletionOptions, i as generateCompletion, o as withCompletionCommand, t as WithCompletionOptions } from "./index-BLySW_2k.js";
 import { z } from "zod";
 
 //#region src/core/case-types.d.ts

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/core/case-types.ts","../src/core/case-proxy.ts","../src/core/command.ts","../src/core/runner.ts","../src/output/help-generator.ts","../src/output/logger.ts","../src/output/markdown-renderer.ts","../src/parser/argv-parser.ts","../src/validator/validation-errors.ts","../src/validator/command-validator.ts","../src/validator/zod-validator.ts"],"mappings":";;;;;;;;;;AAcA;;;;;;;;KAAY,SAAA,qBAA8B,CAAA,gDACnC,CAAA,GAAI,SAAA,CAAU,CAAA,IAAK,SAAA,CAAU,CAAA,MAChC,CAAA;;;;;;;;;;;;;;KAeC,cAAA,qBAAmC,CAAA,yCACpC,IAAA,cACE,KAAA,SAAc,SAAA,CAAU,KAAA,IACtB,KAAA,OACI,SAAA,CAAU,KAAA,MAChB,KAAA,SAAc,SAAA,CAAU,KAAA,OACnB,KAAA,GAAQ,cAAA,CAAe,IAAA,MAC1B,IAAA,wCACE,IAAA,SAAa,SAAA,CAAU,IAAA,QACjB,SAAA,CAAU,KAAA,IAAS,IAAA,GAAO,cAAA,CAAe,IAAA,SAC1C,SAAA,CAAU,KAAA,IAAS,cAAA,CAAe,IAAA,UACnC,SAAA,CAAU,KAAA,MACpB,CAAA;;;AA3BE;KAgCD,kBAAA,qBAAuC,CAAA,yBAA0B,CAAA,GAAI,CAAA;;;;;;;;;KAU9D,SAAA,qBAA8B,kBAAA,CAAmB,cAAA,CAAe,CAAA;;;;;;;;;;;;;KAchE,gBAAA,MAAsB,CAAA,mBAC9B,CAAA,iBACc,CAAA,IAAK,SAAA,CAAU,CAAA,aAAc,CAAA,CAAE,CAAA,oBAE/B,CAAA,IAAK,SAAA,CAAU,CAAA,aAAc,CAAA,CAAE,CAAA;;;;;;;AA9DjD;;;;;iBCFgB,mBAAA,WAA8B,MAAA,kBAAA,CAC5C,GAAA,EAAK,CAAA,GACJ,gBAAA,CAAiB,CAAA;;;;;ADApB;;KEGK,SAAA,gBAAyB,WAAA,SAAoB,CAAA,CAAE,OAAA,GAChD,gBAAA,CAAiB,CAAA,CAAE,KAAA,CAAM,WAAA,KACzB,MAAA;;;;;;KAOQ,UAAA,4BACV,OAAA,CAAQ,WAAA,iBAA4B,UAAA,GAAa,UAAA,GAAa,gBAAA,CAAiB,WAAA;;;;KAK5E,YAAA,6BAAyC,UAAA,CAAW,SAAA,CAAU,WAAA,GAAc,WAAA;;;;;;;UAQvE,mBAAA,qBAAwC,UAAA;EAChD,IAAA;EACA,WAAA;EACA,IAAA,GAAO,WAAA;EACP,WAAA,GAAc,iBAAA;EACd,KAAA,IAAS,OAAA;IAAW,IAAA,EAAM,YAAA,CAAa,WAAA,EAAa,WAAA;EAAA,aAA0B,OAAA;EAC9E,GAAA,IAAO,IAAA,EAAM,YAAA,CAAa,WAAA,EAAa,WAAA,MAAiB,OAAA;EACxD,OAAA,IAAW,OAAA;IACT,IAAA,EAAM,YAAA,CAAa,WAAA,EAAa,WAAA;IAChC,KAAA,GAAQ,KAAA;EAAA,aACG,OAAA;EACb,KAAA;EACA,QAAA,GAAW,OAAA;AAAA;;;;UAMI,cAAA,qBACK,UAAA,4CAGZ,mBAAA,CAAoB,WAAA,EAAa,OAAA,EAAS,WAAA;EAClD,GAAA,GAAM,IAAA,EAAM,YAAA,CAAa,WAAA,EAAa,WAAA,MAAiB,OAAA;AAAA;;;;UAMxC,iBAAA,qBACK,UAAA,mCAEZ,IAAA,CAAK,mBAAA,CAAoB,WAAA,QAAmB,WAAA;EACpD,GAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AF9BG;;;;;;;;iBEsFW,aAAA,qBACM,UAAA,wDAEN,UAAA,CAAA,CAEd,MAAA,EAAQ,cAAA,CAAe,WAAA,EAAa,OAAA,EAAS,WAAA,IAC5C,eAAA,CAAgB,WAAA,EAAa,YAAA,CAAa,WAAA,EAAa,WAAA,GAAc,OAAA;AAAA,iBAGxD,aAAA,qBACM,UAAA,wCACN,UAAA,CAAA,CAEd,MAAA,EAAQ,iBAAA,CAAkB,WAAA,EAAa,WAAA,IACtC,kBAAA,CAAmB,WAAA,EAAa,YAAA,CAAa,WAAA,EAAa,WAAA;;AFrF7D;;;;;;;;;;;;;;AAcA;;;;;;iBEqHgB,mBAAA,aAAA,CAAA;EAAA,qBACO,UAAA,0CACnB,MAAA,EAAQ,cAAA,CAAe,WAAA,EAAa,OAAA,EAAS,WAAA,IAC5C,eAAA,CAAgB,WAAA,EAAa,YAAA,CAAa,WAAA,EAAa,WAAA,GAAc,OAAA;EAAA,qBACnD,UAAA,0BACnB,MAAA,EAAQ,iBAAA,CAAkB,WAAA,EAAa,WAAA,IACtC,kBAAA,CAAmB,WAAA,EAAa,YAAA,CAAa,WAAA,EAAa,WAAA;AAAA;;;;;;;AFrL/D;;;;;;;;;;;;;;;;;;;;;;iBGwEsB,UAAA,mBAAA,CACpB,OAAA,EAAS,UAAA,EACT,IAAA,YACA,OAAA,GAAS,iBAAA,GACR,OAAA,CAAQ,SAAA,CAAU,OAAA;;;AH1Ef;;;;;;;;;;;;;;;;;;;;;iBGgKgB,OAAA,CAAQ,OAAA,EAAS,UAAA,EAAY,OAAA,GAAS,WAAA,GAAmB,OAAA;;;;;;UCnK9D,yBAAA;EJCI;EICnB,IAAA;EJDwC;EIGxC,OAAA;EJFmB;EIInB,OAAA;AAAA;;;;UAee,cAAA;EJpBK;EIsBpB,WAAA;EJtB2D;EIwB3D,QAAA;EJxBgF;EI0BhF,WAAA;EJzBS;EI2BT,eAAA,GAAkB,eAAA;AAAA;;;;UAMH,WAAA;EJjBZ;EImBH,eAAA;EJnBiB;EIqBjB,qBAAA;EJnB4B;EIqB5B,YAAA,GAAe,yBAAA;EJnBK;EIqBpB,OAAA,GAAU,cAAA;AAAA;;;;;;;;iBAwhBI,YAAA,CAAa,OAAA,EAAS,UAAA,EAAY,OAAA,EAAS,WAAA;;;;;;iBCtiB3C,eAAA,CAAgB,OAAA;;AL5BhC;;iBKmCgB,cAAA,CAAA;;;;cAuBH,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuCA,OAAA;;;;;;;;;;;cAYA,MAAA;ELjFW;;;;EACnB;;;;EAZoE;;;;EAE3C;;;;EAGxB;;;;EACa;;;;EACwB;;;;;;;;;;;;AAxB3C;;;;;;;;;;;;iBMOgB,YAAA,CAAa,IAAA;;;;;;;;;iBA6Cb,cAAA,CAAe,QAAA;;;;;;UC7Dd,UAAA;EPSL;EOPV,OAAA,EAAS,MAAA;EPOU;EOLnB,WAAA;EPMK;EOJL,IAAA;AAAA;;;;UAMe,aAAA;EPDZ;EOGH,QAAA,GAAW,GAAA;EPL6B;EOOxC,YAAA,GAAe,GAAA;EPPuD;EOStE,UAAA,GAAa,GAAA;EPRR;;;;;;EOeL,YAAA,GAAe,GAAA;AAAA;APdX;;;;;;;;;;;;;;;;;;;;;AAAA,iBOsCU,SAAA,CAAU,IAAA,YAAgB,OAAA,GAAS,aAAA,GAAqB,UAAA;;;;;;cCnD3D,qBAAA,SAA8B,KAAA;cAC7B,OAAA;AAAA;;;;cASD,kBAAA,SAA2B,KAAA;cAC1B,OAAA;AAAA;;;;cASD,mBAAA,SAA4B,KAAA;cAC3B,OAAA;AAAA;;;;cASD,mBAAA,SAA4B,KAAA;cAC3B,OAAA;AAAA;;;;cASD,yBAAA,SAAkC,KAAA;cACjC,OAAA;AAAA;;;;AR9Bd;;USSiB,sBAAA;ETTyB;ESWxC,WAAA;ETVmB;ESYnB,IAAA;ETZkC;ESmBlC,OAAA;ETlBE;ESoBF,KAAA;AAAA;;;;KAMU,uBAAA;EACN,KAAA;AAAA;EACA,KAAA;EAAc,MAAA,EAAQ,sBAAA;AAAA;;;;UAKX,sBAAA;ETlBZ;ESoBH,WAAA;AAAA;;;;;;;iBAsLc,uBAAA,CAAwB,SAAA,EAAW,eAAA;;;;;;;;;iBAkBnC,wBAAA,CAAyB,SAAA,EAAW,eAAA;;;;;;;;;;;;;iBAoBpC,wBAAA,CAAyB,SAAA,EAAW,eAAA;;;;;;;;;;;;;;iBAqBpC,uBAAA,CACd,SAAA,EAAW,eAAA,EACX,eAAA;;;;;;;iBAoBc,6BAAA,CAA8B,SAAA,EAAW,eAAA;;;;;;;;;iBAgBzC,6BAAA,CACd,UAAA,EAAY,eAAA,EACZ,UAAA,EAAY,eAAA;;;;;ATjST;;;;;;;;;;;AAeL;;;iBS4UsB,eAAA,CACpB,OAAA,EAAS,UAAA,EACT,OAAA,GAAS,sBAAA,GACR,OAAA,CAAQ,uBAAA;;;;;;;iBAqCK,6BAAA,CAA8B,MAAA,EAAQ,sBAAA;;;;;;UCxarC,eAAA;EVQI;EUNnB,IAAA;EVMwC;EUJxC,OAAA;EVKmB;EUHnB,IAAA;EVGkC;EUDlC,QAAA;EVEE;EUAF,QAAA;AAAA;;;;KAMU,gBAAA;EACN,OAAA;EAAe,IAAA,EAAM,CAAA;AAAA;EACrB,OAAA;EAAgB,MAAA,EAAQ,eAAA;AAAA;;;;iBA4Cd,sBAAA,CAAuB,MAAA,EAAQ,eAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/core/case-types.ts","../src/core/case-proxy.ts","../src/core/command.ts","../src/core/runner.ts","../src/output/help-generator.ts","../src/output/logger.ts","../src/output/markdown-renderer.ts","../src/parser/argv-parser.ts","../src/validator/validation-errors.ts","../src/validator/command-validator.ts","../src/validator/zod-validator.ts"],"mappings":";;;;;;;;;;AAcA;;;;;;;;KAAY,SAAA,qBAA8B,CAAA,gDACnC,CAAA,GAAI,SAAA,CAAU,CAAA,IAAK,SAAA,CAAU,CAAA,MAChC,CAAA;;;;;;;;;;;;;;KAeC,cAAA,qBAAmC,CAAA,yCACpC,IAAA,cACE,KAAA,SAAc,SAAA,CAAU,KAAA,IACtB,KAAA,OACI,SAAA,CAAU,KAAA,MAChB,KAAA,SAAc,SAAA,CAAU,KAAA,OACnB,KAAA,GAAQ,cAAA,CAAe,IAAA,MAC1B,IAAA,wCACE,IAAA,SAAa,SAAA,CAAU,IAAA,QACjB,SAAA,CAAU,KAAA,IAAS,IAAA,GAAO,cAAA,CAAe,IAAA,SAC1C,SAAA,CAAU,KAAA,IAAS,cAAA,CAAe,IAAA,UACnC,SAAA,CAAU,KAAA,MACpB,CAAA;;;AA3BE;KAgCD,kBAAA,qBAAuC,CAAA,yBAA0B,CAAA,GAAI,CAAA;;;;;;;;;KAU9D,SAAA,qBAA8B,kBAAA,CAAmB,cAAA,CAAe,CAAA;;;;;;;;;;;;;KAchE,gBAAA,MAAsB,CAAA,mBAC9B,CAAA,iBACc,CAAA,IAAK,SAAA,CAAU,CAAA,aAAc,CAAA,CAAE,CAAA,oBAE/B,CAAA,IAAK,SAAA,CAAU,CAAA,aAAc,CAAA,CAAE,CAAA;;;;;;;AA9DjD;;;;;iBCFgB,mBAAA,WAA8B,MAAA,kBAAA,CAC5C,GAAA,EAAK,CAAA,GACJ,gBAAA,CAAiB,CAAA;;;;;ADApB;;KEGK,SAAA,gBAAyB,WAAA,SAAoB,CAAA,CAAE,OAAA,GAChD,gBAAA,CAAiB,CAAA,CAAE,KAAA,CAAM,WAAA,KACzB,MAAA;;;;;;KAOQ,UAAA,4BACV,OAAA,CAAQ,WAAA,iBAA4B,UAAA,GAAa,UAAA,GAAa,gBAAA,CAAiB,WAAA;;;;KAK5E,YAAA,6BAAyC,UAAA,CAAW,SAAA,CAAU,WAAA,GAAc,WAAA;;;;;;;UAQvE,mBAAA,qBAAwC,UAAA;EAChD,IAAA;EACA,WAAA;EACA,IAAA,GAAO,WAAA;EACP,WAAA,GAAc,iBAAA;EACd,KAAA,IAAS,OAAA;IAAW,IAAA,EAAM,YAAA,CAAa,WAAA,EAAa,WAAA;EAAA,aAA0B,OAAA;EAC9E,GAAA,IAAO,IAAA,EAAM,YAAA,CAAa,WAAA,EAAa,WAAA,MAAiB,OAAA;EACxD,OAAA,IAAW,OAAA;IACT,IAAA,EAAM,YAAA,CAAa,WAAA,EAAa,WAAA;IAChC,KAAA,GAAQ,KAAA;EAAA,aACG,OAAA;EACb,KAAA;EACA,QAAA,GAAW,OAAA;AAAA;;;;UAMI,cAAA,qBACK,UAAA,4CAGZ,mBAAA,CAAoB,WAAA,EAAa,OAAA,EAAS,WAAA;EAClD,GAAA,GAAM,IAAA,EAAM,YAAA,CAAa,WAAA,EAAa,WAAA,MAAiB,OAAA;AAAA;;;;UAMxC,iBAAA,qBACK,UAAA,mCAEZ,IAAA,CAAK,mBAAA,CAAoB,WAAA,QAAmB,WAAA;EACpD,GAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AF9BG;;;;;;;;iBEsFW,aAAA,qBACM,UAAA,wDAEN,UAAA,CAAA,CAEd,MAAA,EAAQ,cAAA,CAAe,WAAA,EAAa,OAAA,EAAS,WAAA,IAC5C,eAAA,CAAgB,WAAA,EAAa,YAAA,CAAa,WAAA,EAAa,WAAA,GAAc,OAAA;AAAA,iBAGxD,aAAA,qBACM,UAAA,wCACN,UAAA,CAAA,CAEd,MAAA,EAAQ,iBAAA,CAAkB,WAAA,EAAa,WAAA,IACtC,kBAAA,CAAmB,WAAA,EAAa,YAAA,CAAa,WAAA,EAAa,WAAA;;AFrF7D;;;;;;;;;;;;;;AAcA;;;;;;iBEqHgB,mBAAA,aAAA,CAAA;EAAA,qBACO,UAAA,0CACnB,MAAA,EAAQ,cAAA,CAAe,WAAA,EAAa,OAAA,EAAS,WAAA,IAC5C,eAAA,CAAgB,WAAA,EAAa,YAAA,CAAa,WAAA,EAAa,WAAA,GAAc,OAAA;EAAA,qBACnD,UAAA,0BACnB,MAAA,EAAQ,iBAAA,CAAkB,WAAA,EAAa,WAAA,IACtC,kBAAA,CAAmB,WAAA,EAAa,YAAA,CAAa,WAAA,EAAa,WAAA;AAAA;;;;;;;AFrL/D;;;;;;;;;;;;;;;;;;;;;;iBGwEsB,UAAA,mBAAA,CACpB,OAAA,EAAS,UAAA,EACT,IAAA,YACA,OAAA,GAAS,iBAAA,GACR,OAAA,CAAQ,SAAA,CAAU,OAAA;;;AH1Ef;;;;;;;;;;;;;;;;;;;;;iBGgKgB,OAAA,CAAQ,OAAA,EAAS,UAAA,EAAY,OAAA,GAAS,WAAA,GAAmB,OAAA;;;;;;UClK9D,yBAAA;EJAI;EIEnB,IAAA;EJFwC;EIIxC,OAAA;EJHmB;EIKnB,OAAA;AAAA;;;;UAee,cAAA;EJrBK;EIuBpB,WAAA;EJvB2D;EIyB3D,QAAA;EJzBgF;EI2BhF,WAAA;EJ1BS;EI4BT,eAAA,GAAkB,eAAA;AAAA;;;;UAMH,WAAA;EJlBZ;EIoBH,eAAA;EJpBiB;EIsBjB,qBAAA;EJpB4B;EIsB5B,YAAA,GAAe,yBAAA;EJpBK;EIsBpB,OAAA,GAAU,cAAA;AAAA;;;;;;;;iBAgjBI,YAAA,CAAa,OAAA,EAAS,UAAA,EAAY,OAAA,EAAS,WAAA;;;;;;iBC/jB3C,eAAA,CAAgB,OAAA;;AL5BhC;;iBKmCgB,cAAA,CAAA;;;;cAuBH,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuCA,OAAA;;;;;;;;;;;cAYA,MAAA;ELjFW;;;;EACnB;;;;EAZoE;;;;EAE3C;;;;EAGxB;;;;EACa;;;;EACwB;;;;;;;;;;;;AAxB3C;;;;;;;;;;;;iBMOgB,YAAA,CAAa,IAAA;;;;;;;;;iBA6Cb,cAAA,CAAe,QAAA;;;;;;UC7Dd,UAAA;EPSL;EOPV,OAAA,EAAS,MAAA;EPOU;EOLnB,WAAA;EPMK;EOJL,IAAA;AAAA;;;;UAMe,aAAA;EPDZ;EOGH,QAAA,GAAW,GAAA;EPL6B;EOOxC,YAAA,GAAe,GAAA;EPPuD;EOStE,UAAA,GAAa,GAAA;EPRR;;;;;;EOeL,YAAA,GAAe,GAAA;AAAA;APdX;;;;;;;;;;;;;;;;;;;;;AAAA,iBOsCU,SAAA,CAAU,IAAA,YAAgB,OAAA,GAAS,aAAA,GAAqB,UAAA;;;;;;cCnD3D,qBAAA,SAA8B,KAAA;cAC7B,OAAA;AAAA;;;;cASD,kBAAA,SAA2B,KAAA;cAC1B,OAAA;AAAA;;;;cASD,mBAAA,SAA4B,KAAA;cAC3B,OAAA;AAAA;;;;cASD,mBAAA,SAA4B,KAAA;cAC3B,OAAA;AAAA;;;;cASD,yBAAA,SAAkC,KAAA;cACjC,OAAA;AAAA;;;;AR9Bd;;USciB,sBAAA;ETdyB;ESgBxC,WAAA;ETfmB;ESiBnB,IAAA;ETjBkC;ESwBlC,OAAA;ETvBE;ESyBF,KAAA;AAAA;;;;KAMU,uBAAA;EACN,KAAA;AAAA;EACA,KAAA;EAAc,MAAA,EAAQ,sBAAA;AAAA;;;;UAKX,sBAAA;ETvBZ;ESyBH,WAAA;AAAA;;;;;;;iBA4Mc,uBAAA,CAAwB,SAAA,EAAW,eAAA;;;;;;;;;iBAkBnC,wBAAA,CAAyB,SAAA,EAAW,eAAA;;;;;;;;;;;;;iBAoBpC,wBAAA,CAAyB,SAAA,EAAW,eAAA;;;;;;;;;;;;;;iBAqBpC,uBAAA,CACd,SAAA,EAAW,eAAA,EACX,eAAA;;;;;;;iBAuBc,6BAAA,CAA8B,SAAA,EAAW,eAAA;;;;;;;;;iBAgBzC,6BAAA,CACd,UAAA,EAAY,eAAA,EACZ,UAAA,EAAY,eAAA;;;;;AT/TT;;;;;;;;;;;AAeL;;;iBS0WsB,eAAA,CACpB,OAAA,EAAS,UAAA,EACT,OAAA,GAAS,sBAAA,GACR,OAAA,CAAQ,uBAAA;;;;;;;iBAqCK,6BAAA,CAA8B,MAAA,EAAQ,sBAAA;;;;;;UCtcrC,eAAA;EVQI;EUNnB,IAAA;EVMwC;EUJxC,OAAA;EVKmB;EUHnB,IAAA;EVGkC;EUDlC,QAAA;EVEE;EUAF,QAAA;AAAA;;;;KAMU,gBAAA;EACN,OAAA;EAAe,IAAA,EAAM,CAAA;AAAA;EACrB,OAAA;EAAgB,MAAA,EAAQ,eAAA;AAAA;;;;iBA4Cd,sBAAA,CAAuB,MAAA,EAAQ,eAAA"}

package/dist/index.js

@@ -1,5 +1,5 @@
-import { C as logger, D as createDualCaseProxy, E as symbols, S as isColorEnabled, T as styles, _ as PositionalConfigError, a as parseArgv, b as renderInline, c as validateCommand, d as validateDuplicateFields, f as validatePositionalConfig, g as DuplicateFieldError, h as DuplicateAliasError, i as formatValidationErrors, l as validateCrossSchemaCollisions, m as CaseVariantCollisionError, n as runMain, o as formatCommandValidationErrors, p as validateReservedAliases, s as validateCaseVariantCollisions, t as runCommand, u as validateDuplicateAliases, v as ReservedAliasError, w as setColorEnabled, x as renderMarkdown, y as generateHelp } from "./runner-CnG-Ncz0.js";
-import { c as toKebabCase, i as extractFields, l as arg, n as lazy, o as getUnknownKeysMode, s as toCamelCase, t as isLazyCommand } from "./lazy-xrzxwnru.js";
-import { a as withCompletionCommand, g as defineCommand, h as createDefineCommand, r as generateCompletion } from "./completion-DzaT2YCN.js";
+import { C as logger, D as createDualCaseProxy, E as symbols, S as isColorEnabled, T as styles, _ as PositionalConfigError, a as parseArgv, b as renderInline, c as validateCommand, d as validateDuplicateFields, f as validatePositionalConfig, g as DuplicateFieldError, h as DuplicateAliasError, i as formatValidationErrors, l as validateCrossSchemaCollisions, m as CaseVariantCollisionError, n as runMain, o as formatCommandValidationErrors, p as validateReservedAliases, s as validateCaseVariantCollisions, t as runCommand, u as validateDuplicateAliases, v as ReservedAliasError, w as setColorEnabled, x as renderMarkdown, y as generateHelp } from "./runner-DSZw1AsW.js";
+import { c as toCamelCase, i as extractFields, l as toKebabCase, n as lazy, s as getUnknownKeysMode, t as isLazyCommand, u as arg } from "./lazy-DiMJSDMB.js";
+import { a as withCompletionCommand, g as defineCommand, h as createDefineCommand, r as generateCompletion } from "./completion-yHz8Pdr7.js";
 
 export { CaseVariantCollisionError, DuplicateAliasError, DuplicateFieldError, PositionalConfigError, ReservedAliasError, arg, createDefineCommand, createDualCaseProxy, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateCompletion, generateHelp, getUnknownKeysMode, isColorEnabled, isLazyCommand, lazy, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, toCamelCase, toKebabCase, validateCaseVariantCollisions, validateCommand, validateCrossSchemaCollisions, validateDuplicateAliases, validateDuplicateFields, validatePositionalConfig, validateReservedAliases, withCompletionCommand };

package/dist/{lazy-qPy4cMnv.cjs → lazy-AGV9Pkt5.cjs}

@@ -1,4 +1,4 @@
-const require_subcommand_router = require('./subcommand-router-BnHpqyRk.cjs');
+const require_subcommand_router = require('./subcommand-router-C9ONv6Nq.cjs');
 let zod = require("zod");
 
 //#region src/core/arg-registry.ts
@@ -202,10 +202,26 @@ function resolveFieldMeta(name, schema) {
 	const description = argMeta?.description ?? extractDescription(schema);
 	const cliName = toKebabCase(name);
 	const enumValues = extractEnumValues(schema);
+	const aliasPattern = /^[A-Za-z0-9][A-Za-z0-9-]*$/;
+	const normalizeAliasList = (input, metaKey) => {
+		if (input == null) return void 0;
+		const normalized = (Array.isArray(input) ? input : [input]).map((a) => {
+			if (typeof a !== "string") throw new Error(`Invalid ${metaKey} for field "${name}": expected string or string[], received ${typeof a}.`);
+			const candidate = a.trim().replace(/^-+/, "");
+			if (candidate.length === 0 || !aliasPattern.test(candidate)) throw new Error(`Invalid ${metaKey} "${a}" for field "${name}": aliases must match ${aliasPattern}.`);
+			return candidate;
+		});
+		const result = Array.from(new Set(normalized));
+		return result.length > 0 ? result : void 0;
+	};
+	const alias = normalizeAliasList(argMeta?.alias, "alias");
+	const visibleSet = new Set(alias ?? []);
+	const hiddenAlias = normalizeAliasList(argMeta?.hiddenAlias, "hiddenAlias")?.filter((a) => !visibleSet.has(a));
 	const meta = {
 		name,
 		cliName,
-		alias: argMeta?.alias,
+		alias,
+		hiddenAlias: hiddenAlias && hiddenAlias.length > 0 ? hiddenAlias : void 0,
 		description,
 		positional: argMeta?.positional ?? false,
 		placeholder: argMeta?.placeholder,
@@ -223,6 +239,15 @@ function resolveFieldMeta(name, schema) {
 	return meta;
 }
 /**
+* Get the combined list of visible + hidden aliases for a field.
+* Used by the parser and validators which treat both equally,
+* while help/docs/completion rely on `field.alias` only.
+*/
+function getAllAliases(field) {
+	if (!field.alias && !field.hiddenAlias) return [];
+	return [...field.alias ?? [], ...field.hiddenAlias ?? []];
+}
+/**
 * Get shape from a ZodObject
 */
 function getObjectShape(schema) {
@@ -491,6 +516,12 @@ Object.defineProperty(exports, 'extractFields', {
     return extractFields;
   }
 });
+Object.defineProperty(exports, 'getAllAliases', {
+  enumerable: true,
+  get: function () {
+    return getAllAliases;
+  }
+});
 Object.defineProperty(exports, 'getExtractedFields', {
   enumerable: true,
   get: function () {
@@ -533,4 +564,4 @@ Object.defineProperty(exports, 'toKebabCase', {
     return toKebabCase;
   }
 });
-//# sourceMappingURL=lazy-qPy4cMnv.cjs.map
+//# sourceMappingURL=lazy-AGV9Pkt5.cjs.map

package/dist/lazy-AGV9Pkt5.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-AGV9Pkt5.cjs","names":["z","getArgMeta","getArgMetaFromRegistry"],"sources":["../src/core/arg-registry.ts","../src/core/schema-extractor.ts","../src/lazy.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport type { GlobalArgs, IsEmpty } from \"../types.js\";\n\n/**\n * Built-in completion types\n */\nexport type CompletionType = \"file\" | \"directory\" | \"none\";\n\n/**\n * Custom completion specification\n */\nexport interface CustomCompletion {\n  /** Static list of choices for completion */\n  choices?: string[];\n  /** Shell command to execute for dynamic completion */\n  shellCommand?: string;\n}\n\n/**\n * Completion metadata for an argument\n *\n * @example\n * ```ts\n * // File completion with extension filter\n * input: arg(z.string(), {\n *   completion: { type: \"file\", extensions: [\"json\", \"yaml\"] }\n * })\n *\n * // Directory completion\n * outputDir: arg(z.string(), {\n *   completion: { type: \"directory\" }\n * })\n *\n * // Custom static choices\n * logLevel: arg(z.string(), {\n *   completion: { custom: { choices: [\"debug\", \"info\", \"warn\", \"error\"] } }\n * })\n *\n * // Dynamic completion from shell command\n * branch: arg(z.string(), {\n *   completion: { custom: { shellCommand: \"git branch --format='%(refname:short)'\" } }\n * })\n *\n * // File completion with glob pattern matcher\n * envFile: arg(z.string(), {\n *   completion: { type: \"file\", matcher: [\".env.*\"] }\n * })\n * ```\n */\nexport type CompletionMeta = {\n  /** Built-in completion type */\n  type?: CompletionType;\n  /** Custom completion (takes precedence over type if both specified) */\n  custom?: CustomCompletion;\n} & (\n  | {\n      /** File extension filter (only applies when type is \"file\") */ extensions?: string[];\n      matcher?: never;\n    }\n  | {\n      /** Glob patterns for file matching (only applies when type is \"file\") */ matcher?: string[];\n      extensions?: never;\n    }\n);\n\n/**\n * Prompt input type for interactive prompts\n *\n * - \"text\": free-form text input (default for string schemas)\n * - \"password\": masked text input\n * - \"confirm\": yes/no prompt (default for boolean schemas)\n * - \"select\": single selection from choices (default for enum schemas)\n * - \"file\": file path input (inherited from completion type)\n * - \"directory\": directory path input (inherited from completion type)\n */\nexport type PromptType = \"text\" | \"password\" | \"confirm\" | \"select\" | \"file\" | \"directory\";\n\n/**\n * Prompt metadata for interactive input when a value is missing.\n * Used by the `politty/prompt` module to request user input for unresolved arguments.\n *\n * @example\n * ```ts\n * // Custom prompt message\n * name: arg(z.string(), {\n *   prompt: { message: \"What is your name?\" }\n * })\n *\n * // Password input (masked)\n * token: arg(z.string(), {\n *   prompt: { type: \"password\", message: \"Enter API token\" }\n * })\n *\n * // Select with custom choices\n * region: arg(z.string(), {\n *   prompt: { choices: [\"us-east-1\", \"eu-west-1\", \"ap-northeast-1\"] }\n * })\n * ```\n */\nexport interface PromptMeta {\n  /** Prompt message shown to the user. Defaults to the field's description or name. */\n  message?: string;\n  /** Explicit prompt type. Overrides auto-detection from schema/completion. */\n  type?: PromptType;\n  /** Choices for select prompt. Overrides enum values from schema. */\n  choices?: Array<string | { label: string; value: string }>;\n  /** Whether to enable prompting for this field (default: true when prompt is set) */\n  enabled?: boolean;\n}\n\n/**\n * Context provided to effect callbacks.\n * When GlobalArgs is extended via declaration merging, `globalArgs` is typed accordingly.\n */\nexport type EffectContext = {\n  /** Field name (camelCase) */\n  name: string;\n  /** Validated args for this schema (global args for global effects, command args for command effects) */\n  args: Readonly<Record<string, unknown>>;\n} & (IsEmpty<GlobalArgs> extends true\n  ? { globalArgs?: Readonly<Record<string, unknown>> }\n  : { globalArgs?: Readonly<GlobalArgs> });\n\n/**\n * Base metadata shared by all argument types\n */\nexport interface BaseArgMeta<TValue = unknown> {\n  /** Argument description */\n  description?: string;\n  /** Treat as positional argument */\n  positional?: boolean;\n  /** Placeholder for help display */\n  placeholder?: string;\n  /**\n   * Environment variable name(s) to read value from.\n   * If an array is provided, earlier entries take priority.\n   * CLI arguments always take precedence over environment variables.\n   *\n   * @example\n   * ```ts\n   * // Single env var\n   * port: arg(z.coerce.number(), { env: \"PORT\" })\n   *\n   * // Multiple env vars (PORT takes priority over SERVER_PORT)\n   * port: arg(z.coerce.number(), { env: [\"PORT\", \"SERVER_PORT\"] })\n   * ```\n   */\n  env?: string | string[];\n  /** Completion configuration for shell tab-completion */\n  completion?: CompletionMeta;\n  /**\n   * Interactive prompt configuration for missing values.\n   * When set, the `politty/prompt` module will prompt the user interactively\n   * if this argument is not provided via CLI args or environment variables.\n   *\n   * @example\n   * ```ts\n   * name: arg(z.string(), {\n   *   description: \"User name\",\n   *   prompt: { message: \"What is your name?\" },\n   * })\n   * ```\n   */\n  prompt?: PromptMeta;\n  /**\n   * Side-effect callback executed after argument parsing and validation.\n   * Runs before the command lifecycle (setup/run/cleanup).\n   * Use Zod .transform() for value transformation instead.\n   *\n   * @example\n   * ```ts\n   * verbose: arg(z.boolean().default(false), {\n   *   alias: \"v\",\n   *   effect: (value) => {\n   *     if (value) logger.setLevel(\"debug\");\n   *   },\n   * })\n   * ```\n   */\n  effect?: (value: TValue, context: EffectContext) => void | PromiseLike<void>;\n}\n\n/**\n * Metadata for regular arguments (non-builtin aliases)\n *\n * `alias` accepts either a single string or an array of strings.\n * Single-character entries become short options (e.g. `-v`); multi-character\n * entries become additional long options (e.g. `--to-be` for `--tobe`).\n */\nexport interface RegularArgMeta<TValue = unknown> extends BaseArgMeta<TValue> {\n  /**\n   * Alias name(s) for this option.\n   * - 1-char string  → short alias (`-v`)\n   * - >1-char string → long alias (`--long-name`)\n   * - array          → multiple aliases of either kind\n   */\n  alias?: string | string[] | readonly string[];\n  /**\n   * Alias name(s) that are accepted by the parser but hidden from help,\n   * generated docs, and shell completion. Useful for legacy or deprecated\n   * names that should still work without being advertised.\n   */\n  hiddenAlias?: string | string[] | readonly string[];\n}\n\n/**\n * Metadata for overriding built-in aliases (-h, -H)\n */\nexport interface BuiltinOverrideArgMeta<TValue = unknown> extends BaseArgMeta<TValue> {\n  /** Built-in alias to override ('h' or 'H'), optionally combined with extra aliases */\n  alias: \"h\" | \"H\" | Array<\"h\" | \"H\" | string> | ReadonlyArray<\"h\" | \"H\" | string>;\n  /** Hidden aliases (accepted but not surfaced in help/docs/completion) */\n  hiddenAlias?: string | string[] | readonly string[];\n  /** Must be true to override built-in aliases */\n  overrideBuiltinAlias: true;\n}\n\n/**\n * Metadata options for argument definition\n */\nexport type ArgMeta<TValue = unknown> = RegularArgMeta<TValue> | BuiltinOverrideArgMeta<TValue>;\n\n/**\n * Custom registry for politty argument metadata\n * This avoids polluting Zod's GlobalMeta\n */\nexport const argRegistry = z.registry<ArgMeta>();\n\n/**\n * Register metadata for a Zod schema\n *\n * @param schema - The Zod schema\n * @param meta - Argument metadata\n * @returns The same schema (for chaining)\n *\n * @example\n * ```ts\n * import { z } from \"zod\";\n * import { arg, defineCommand } from \"politty\";\n *\n * const cmd = defineCommand({\n *   args: z.object({\n *     name: arg(z.string(), { description: \"User name\", positional: true }),\n *     verbose: arg(z.boolean().default(false), { alias: \"v\" }),\n *   }),\n *   run: (args) => {\n *     console.log(args.name, args.verbose);\n *   },\n * });\n * ```\n */\n/**\n * Detect whether `A` contains a reserved alias (\"h\" or \"H\"), for either a\n * plain string or a tuple/array of strings. Uses `[A] extends [never]` to\n * prevent distribution returning `never` for missing fields.\n */\ntype ContainsReservedAlias<A> = [A] extends [never]\n  ? false\n  : A extends \"h\" | \"H\"\n    ? true\n    : A extends readonly (infer E)[]\n      ? [Extract<E, \"h\" | \"H\">] extends [never]\n        ? false\n        : true\n      : false;\n\ntype ReservedAliasTypeError<M> = {\n  [K in keyof M]: M[K];\n} & {\n  __typeError: \"Alias 'h' or 'H' requires overrideBuiltinAlias: true\";\n};\n\ntype AliasFieldOf<M> = M extends { alias: infer A } ? A : never;\ntype HiddenAliasFieldOf<M> = M extends { hiddenAlias: infer H } ? H : never;\n\n/**\n * Type helper to validate ArgMeta.\n * Forces a type error when a reserved alias (\"h\" / \"H\") is used without\n * `overrideBuiltinAlias: true`, whether the alias is provided as a string\n * or as part of an array, and whether it appears in `alias` or `hiddenAlias`.\n */\ntype ValidateArgMeta<M> = M extends { overrideBuiltinAlias: true }\n  ? M\n  : ContainsReservedAlias<AliasFieldOf<M>> extends true\n    ? ReservedAliasTypeError<M>\n    : ContainsReservedAlias<HiddenAliasFieldOf<M>> extends true\n      ? ReservedAliasTypeError<M>\n      : M;\n\nexport function arg<T extends z.ZodType>(schema: T): T;\nexport function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(\n  schema: T,\n  meta: ValidateArgMeta<M>,\n): T;\nexport function arg<T extends z.ZodType>(schema: T, meta?: ValidateArgMeta<ArgMeta>): T {\n  if (meta) {\n    argRegistry.add(schema, meta as ArgMeta);\n  }\n  return schema;\n}\n\n/**\n * Get metadata for a schema from the registry\n *\n * @param schema - The Zod schema\n * @returns The metadata if registered, undefined otherwise\n */\nexport function getArgMeta(schema: z.ZodType): ArgMeta | undefined {\n  return argRegistry.get(schema);\n}\n","import type { z } from \"zod\";\nimport type { AnyCommand, ArgsSchema } from \"../types.js\";\nimport {\n  getArgMeta as getArgMetaFromRegistry,\n  type ArgMeta,\n  type CompletionMeta,\n  type EffectContext,\n  type PromptMeta,\n} from \"./arg-registry.js\";\n\n/**\n * Get ArgMeta from both the custom registry and Zod's _def\n * Priority: custom registry > _def.argMeta\n */\nfunction getArgMeta(schema: z.ZodType): ArgMeta | undefined {\n  // First check custom registry\n  const fromRegistry = getArgMetaFromRegistry(schema);\n  if (fromRegistry) return fromRegistry;\n  // Check Zod native meta\n  // Some Zod versions or extensions use a global registry accessed via .meta()\n  if (typeof (schema as any).meta === \"function\") {\n    const meta = (schema as any).meta();\n    if (meta && typeof meta === \"object\") {\n      return meta as ArgMeta;\n    }\n  }\n\n  // Then check _def.argMeta (for augmented Zod types)\n  const def = (schema as any)._def;\n  if (def?.argMeta) return def.argMeta;\n\n  // Also check _def.meta just in case\n  if (def?.meta) return def.meta as ArgMeta;\n\n  return undefined;\n}\n\n/**\n * Resolved metadata for an argument field\n */\nexport interface ResolvedFieldMeta {\n  /** Field name (camelCase, as defined in schema) */\n  name: string;\n  /** CLI option name (kebab-case, for command line usage) */\n  cliName: string;\n  /**\n   * Aliases for this option, normalized to an array.\n   * 1-char entries are short aliases (`-v`); multi-char entries are long\n   * aliases (`--to-be`).\n   */\n  alias?: string[] | undefined;\n  /**\n   * Aliases that are accepted at parse time but hidden from help,\n   * generated docs, and shell completion.\n   */\n  hiddenAlias?: string[] | undefined;\n  /** Argument description */\n  description?: string | undefined;\n  /** Whether this is a positional argument */\n  positional: boolean;\n  /** Placeholder for help display */\n  placeholder?: string | undefined;\n  /**\n   * Environment variable name(s) to read value from.\n   * If an array, earlier entries take priority.\n   */\n  env?: string | string[] | undefined;\n  /** Whether this argument is required */\n  required: boolean;\n  /** Default value if any */\n  defaultValue?: unknown;\n  /** Detected type from schema */\n  type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"unknown\";\n  /** Original Zod schema */\n  schema: z.ZodType;\n  /** True if this overrides built-in aliases (-h, -H) */\n  overrideBuiltinAlias?: true;\n  /** Enum values if detected from schema (z.enum) */\n  enumValues?: string[] | undefined;\n  /** Completion metadata from arg() */\n  completion?: CompletionMeta | undefined;\n  /** Prompt metadata from arg() for interactive input */\n  prompt?: PromptMeta | undefined;\n  /** Side-effect callback from arg() metadata */\n  effect?: ((value: unknown, context: EffectContext) => void | PromiseLike<void>) | undefined;\n}\n\n/**\n * Extracted fields from a schema\n */\nexport interface ExtractedFields {\n  /** All field definitions */\n  fields: ResolvedFieldMeta[];\n  /** Original schema for validation */\n  schema: ArgsSchema;\n  /** Schema type */\n  schemaType: \"object\" | \"discriminatedUnion\" | \"union\" | \"xor\" | \"intersection\";\n  /** Discriminator key (for discriminatedUnion) */\n  discriminator?: string;\n  /** Variants (for discriminatedUnion) */\n  variants?: Array<{\n    discriminatorValue: string;\n    fields: ResolvedFieldMeta[];\n    description?: string;\n  }>;\n  /** Options (for union) */\n  unionOptions?: ExtractedFields[];\n  /** Schema description */\n  description?: string;\n  /**\n   * Unknown keys handling mode\n   * - \"strict\": Unknown keys cause validation errors (z.strictObject or z.object().strict())\n   * - \"strip\": Unknown keys trigger warnings (default, z.object())\n   * - \"passthrough\": Unknown keys are silently ignored (z.looseObject or z.object().passthrough())\n   */\n  unknownKeysMode: UnknownKeysMode;\n}\n\n/**\n * Unknown keys handling mode for object schemas\n * - \"strict\": Unknown keys cause validation errors\n * - \"strip\": Unknown keys are silently ignored (default)\n * - \"passthrough\": Unknown keys are passed through\n */\nexport type UnknownKeysMode = \"strict\" | \"strip\" | \"passthrough\";\n\n// Internal type for accessing zod v4 internals\ninterface ZodV4Def {\n  type?: string;\n  innerType?: z.ZodType;\n  schema?: z.ZodType;\n  defaultValue?: unknown;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  shape?: Record<string, any>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  options?: any[];\n  discriminator?: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  left?: any;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  right?: any;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  catchall?: any;\n  /** Pipe input schema (zod v4 transform/refine) */\n  in?: z.ZodType;\n  /** Pipe output schema (zod v4 transform/refine) */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  out?: any;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype ZodSchemaWithDef = z.ZodType & { def?: ZodV4Def; _def?: ZodV4Def; type?: string; shape?: any };\n\n/**\n * Get the type name from a zod schema (v4 compatible)\n */\nfunction getTypeName(schema: z.ZodType): string | undefined {\n  const s = schema as ZodSchemaWithDef;\n  return s.def?.type ?? s._def?.type ?? s.type;\n}\n\n/**\n * Detect unknown keys handling mode from a Zod object schema\n *\n * In Zod v4:\n * - Default (strip): _def.catchall is undefined\n * - strict: _def.catchall is ZodNever (type = \"never\")\n * - passthrough: _def.catchall is ZodUnknown (type = \"unknown\")\n */\nexport function getUnknownKeysMode(schema: z.ZodType): UnknownKeysMode {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const catchall = def?.catchall;\n\n  if (!catchall) {\n    // Default behavior: strip unknown keys (but we want to warn)\n    return \"strip\";\n  }\n\n  const catchallType = getTypeName(catchall);\n\n  if (catchallType === \"never\") {\n    // z.strictObject() or z.object().strict() - reject unknown keys\n    return \"strict\";\n  }\n\n  if (catchallType === \"unknown\" || catchallType === \"any\") {\n    // z.looseObject() or z.object().passthrough() - allow unknown keys\n    return \"passthrough\";\n  }\n\n  // Unknown catchall type, default to strip behavior\n  return \"strip\";\n}\n\n/**\n * Get the inner schema, unwrapping optional, nullable, default, etc.\n */\nfunction unwrapSchema(schema: z.ZodType): z.ZodType {\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"optional\" || typeName === \"nullable\" || typeName === \"default\") {\n    const innerSchema = def?.innerType;\n    if (innerSchema) {\n      return unwrapSchema(innerSchema);\n    }\n  }\n\n  // Handle effects (transform, refine, etc.)\n  if (typeName === \"pipe\") {\n    const innerSchema = def?.in ?? def?.schema;\n    if (innerSchema) {\n      return unwrapSchema(innerSchema);\n    }\n  }\n\n  return schema;\n}\n\n/**\n * Detect the base type of a schema\n */\nfunction detectType(schema: z.ZodType): \"string\" | \"number\" | \"boolean\" | \"array\" | \"unknown\" {\n  const innerSchema = unwrapSchema(schema);\n  const typeName = getTypeName(innerSchema);\n\n  switch (typeName) {\n    case \"string\":\n    case \"enum\":\n      return \"string\";\n    case \"number\":\n    case \"int\":\n      return \"number\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"array\":\n      return \"array\";\n    default:\n      return \"unknown\";\n  }\n}\n\n/**\n * Extract enum values from a schema if it's an enum type\n *\n * @param schema - The Zod schema to extract enum values from\n * @returns Array of enum values if schema is an enum, undefined otherwise\n */\nexport function extractEnumValues(schema: z.ZodType): string[] | undefined {\n  const innerSchema = unwrapSchema(schema);\n  const typeName = getTypeName(innerSchema);\n  const s = innerSchema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"enum\") {\n    // Zod v4: enum values are in def.entries or def.values\n    const entries = (def as { entries?: Record<string, string> })?.entries;\n    if (entries && typeof entries === \"object\") {\n      return Object.values(entries);\n    }\n\n    // Check for values array (some Zod versions)\n    const values = (def as { values?: string[] })?.values;\n    if (Array.isArray(values)) {\n      return values;\n    }\n\n    // Fallback: check for options property on schema\n    const options = (s as { options?: string[] }).options;\n    if (Array.isArray(options)) {\n      return options;\n    }\n  }\n\n  // Handle array types: extract enum values from the element type\n  if (typeName === \"array\") {\n    const element = (def as { element?: z.ZodType })?.element;\n    if (element) {\n      return extractEnumValues(element);\n    }\n  }\n\n  // Also handle literal union patterns (z.literal(\"a\").or(z.literal(\"b\")))\n  if (typeName === \"union\") {\n    const options = def?.options;\n    if (Array.isArray(options)) {\n      const literalValues: string[] = [];\n      for (const option of options) {\n        const optionTypeName = getTypeName(option);\n        if (optionTypeName === \"literal\") {\n          const optionDef = (option as ZodSchemaWithDef).def ?? (option as ZodSchemaWithDef)._def;\n          const value = (optionDef as { value?: unknown; values?: unknown[] })?.value;\n          const values = (optionDef as { value?: unknown; values?: unknown[] })?.values;\n          const literalValue = value ?? values?.[0];\n          if (typeof literalValue === \"string\") {\n            literalValues.push(literalValue);\n          }\n        }\n      }\n      // Only return if all options are string literals\n      if (literalValues.length === options.length && literalValues.length > 0) {\n        return literalValues;\n      }\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Convert camelCase to kebab-case\n * @example toKebabCase(\"dryRun\") => \"dry-run\"\n * @example toKebabCase(\"outputDir\") => \"output-dir\"\n * @example toKebabCase(\"XMLParser\") => \"xml-parser\"\n */\nexport function toKebabCase(str: string): string {\n  return str\n    .replace(/([a-z])([A-Z])/g, \"$1-$2\")\n    .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1-$2\")\n    .toLowerCase();\n}\n\n/**\n * Convert hyphen-separated sequences to camelCase.\n *\n * Replaces `-x` (hyphen followed by a lowercase letter) with the uppercase\n * variant. Non-hyphenated input (e.g., already camelCase) is returned as-is.\n *\n * @param str - A string that may contain hyphens\n * @example toCamelCase(\"dry-run\") => \"dryRun\"\n * @example toCamelCase(\"output-dir\") => \"outputDir\"\n * @example toCamelCase(\"dryRun\") => \"dryRun\"\n */\nexport function toCamelCase(str: string): string {\n  return str.replace(/-([a-z])/g, (_, char) => char.toUpperCase());\n}\n\n/**\n * Check if a schema is required (not optional or has default)\n *\n * Note: We only check isOptional(), not isNullable(), because CLI arguments\n * are either present (string value) or absent (undefined), never null.\n * Also, some coerce types incorrectly report isNullable()=true.\n */\nfunction isRequired(schema: z.ZodType): boolean {\n  return !schema.isOptional();\n}\n\n/**\n * Extract default value from schema if present\n */\nfunction extractDefaultValue(schema: z.ZodType): unknown {\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"default\") {\n    const defaultValue = def?.defaultValue;\n    // In zod v4, defaultValue can be a direct value or a function\n    if (typeof defaultValue === \"function\") {\n      return defaultValue();\n    }\n    return defaultValue;\n  }\n\n  // Check for nested default in optional/nullable\n  if (typeName === \"optional\" || typeName === \"nullable\") {\n    const innerSchema = def?.innerType;\n    if (innerSchema) {\n      return extractDefaultValue(innerSchema);\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Extract description from schema\n */\nfunction extractDescription(schema: z.ZodType): string | undefined {\n  // Check direct description\n  if (schema.description) {\n    return schema.description;\n  }\n\n  // Check inner schema for wrapped types\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"optional\" || typeName === \"nullable\" || typeName === \"default\") {\n    const innerSchema = def?.innerType;\n    if (innerSchema) {\n      return extractDescription(innerSchema);\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Resolve field metadata from schema and argRegistry\n */\nfunction resolveFieldMeta(name: string, schema: z.ZodType): ResolvedFieldMeta {\n  // Get metadata from argRegistry\n  const argMeta = getArgMeta(schema) ?? getArgMeta(unwrapSchema(schema));\n\n  // Priority: argRegistry > schema.describe()\n  const description = argMeta?.description ?? extractDescription(schema);\n\n  // Convert camelCase field name to kebab-case for CLI usage\n  const cliName = toKebabCase(name);\n\n  // Extract enum values from schema\n  const enumValues = extractEnumValues(schema);\n\n  // Normalize alias-like inputs to a deduped, validated array (or undefined when empty).\n  // Leading dashes are stripped for convenience; entries that still fail the pattern after\n  // stripping cause a validation error so that invalid aliases are never silently ignored.\n  const aliasPattern = /^[A-Za-z0-9][A-Za-z0-9-]*$/;\n  const normalizeAliasList = (\n    input: unknown,\n    metaKey: \"alias\" | \"hiddenAlias\",\n  ): string[] | undefined => {\n    if (input == null) return undefined;\n    const arr = Array.isArray(input) ? input : [input];\n    const normalized = arr.map((a) => {\n      if (typeof a !== \"string\") {\n        throw new Error(\n          `Invalid ${metaKey} for field \"${name}\": expected string or string[], received ${typeof a}.`,\n        );\n      }\n      const candidate = a.trim().replace(/^-+/, \"\");\n      if (candidate.length === 0 || !aliasPattern.test(candidate)) {\n        throw new Error(\n          `Invalid ${metaKey} \"${a}\" for field \"${name}\": aliases must match ${aliasPattern}.`,\n        );\n      }\n      return candidate;\n    });\n    const result = Array.from(new Set(normalized));\n    return result.length > 0 ? result : undefined;\n  };\n\n  const alias = normalizeAliasList(argMeta?.alias, \"alias\");\n  // Filter hiddenAlias so it never overlaps with visible alias (visible wins)\n  const visibleSet = new Set(alias ?? []);\n  const hiddenAliasRaw = normalizeAliasList(\n    (argMeta as { hiddenAlias?: string | string[] } | undefined)?.hiddenAlias,\n    \"hiddenAlias\",\n  );\n  const hiddenAlias = hiddenAliasRaw?.filter((a) => !visibleSet.has(a));\n  const hiddenAliasFinal = hiddenAlias && hiddenAlias.length > 0 ? hiddenAlias : undefined;\n\n  const meta: ResolvedFieldMeta = {\n    name,\n    cliName,\n    alias,\n    hiddenAlias: hiddenAliasFinal,\n    description,\n    positional: argMeta?.positional ?? false,\n    placeholder: argMeta?.placeholder,\n    env: argMeta?.env,\n    required: isRequired(schema),\n    defaultValue: extractDefaultValue(schema),\n    type: detectType(schema),\n    schema,\n    enumValues,\n    completion: argMeta?.completion,\n    prompt: argMeta?.prompt,\n    effect: argMeta?.effect,\n  };\n\n  // Add overrideBuiltinAlias only if it's true\n  if (argMeta && \"overrideBuiltinAlias\" in argMeta && argMeta.overrideBuiltinAlias === true) {\n    meta.overrideBuiltinAlias = true;\n  }\n\n  return meta;\n}\n\n/**\n * Get the combined list of visible + hidden aliases for a field.\n * Used by the parser and validators which treat both equally,\n * while help/docs/completion rely on `field.alias` only.\n */\nexport function getAllAliases(field: ResolvedFieldMeta): string[] {\n  if (!field.alias && !field.hiddenAlias) return [];\n  return [...(field.alias ?? []), ...(field.hiddenAlias ?? [])];\n}\n\n/**\n * Get shape from a ZodObject\n */\nfunction getObjectShape(schema: z.ZodType): Record<string, z.ZodType> {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  return def?.shape ?? s.shape ?? {};\n}\n\n/**\n * Extract fields from a ZodObject\n */\nfunction extractFromObject(schema: z.ZodType): ResolvedFieldMeta[] {\n  const shape = getObjectShape(schema);\n  return Object.entries(shape).map(([name, fieldSchema]) => resolveFieldMeta(name, fieldSchema));\n}\n\n/**\n * Extract fields from a discriminated union\n */\nfunction extractFromDiscriminatedUnion(schema: z.ZodType): ExtractedFields {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const discriminator = def?.discriminator ?? \"\";\n  const options = def?.options ?? [];\n\n  // Collect all unique fields across all variants\n  const allFieldsMap = new Map<string, ResolvedFieldMeta>();\n  const variants: ExtractedFields[\"variants\"] = [];\n\n  for (const option of options) {\n    const shape = getObjectShape(option as z.ZodObject<z.ZodRawShape>);\n    const variantFields: ResolvedFieldMeta[] = [];\n\n    // Get discriminator value from the variant's discriminator schema.\n    // Supports z.literal() and single-value z.enum() discriminators.\n    let discriminatorValue = \"\";\n    const discriminatorSchema = shape[discriminator];\n    if (discriminatorSchema) {\n      const typeName = getTypeName(discriminatorSchema);\n      if (typeName === \"literal\") {\n        const litDef =\n          (discriminatorSchema as ZodSchemaWithDef).def ??\n          (discriminatorSchema as ZodSchemaWithDef)._def;\n        // In Zod v4, literal values are in _def.values array\n        const value = (litDef as { value?: unknown; values?: unknown[] })?.value;\n        const values = (litDef as { value?: unknown; values?: unknown[] })?.values;\n        discriminatorValue = String(value ?? values?.[0] ?? \"\");\n      } else if (typeName === \"enum\") {\n        // Only single-value enums map to one variant. Multi-value enums\n        // (z.enum(['a','b'])) on a single variant are not standard for\n        // discriminatedUnion and are not extracted here.\n        const enumValues = extractEnumValues(discriminatorSchema);\n        if (enumValues && enumValues.length === 1) {\n          discriminatorValue = enumValues[0]!;\n        }\n      }\n    }\n\n    for (const [name, fieldSchema] of Object.entries(shape)) {\n      const fieldMeta = resolveFieldMeta(name, fieldSchema);\n      variantFields.push(fieldMeta);\n\n      // Add to all fields map (first occurrence wins for metadata)\n      if (!allFieldsMap.has(name)) {\n        allFieldsMap.set(name, fieldMeta);\n      }\n    }\n\n    // Extract description from the variant option\n    const variantDescription = extractDescription(option as z.ZodType);\n\n    variants.push({\n      discriminatorValue,\n      fields: variantFields,\n      ...(variantDescription ? { description: variantDescription } : {}),\n    });\n  }\n\n  const description = extractDescription(schema);\n  return {\n    fields: Array.from(allFieldsMap.values()),\n    schema: schema as ArgsSchema,\n    schemaType: \"discriminatedUnion\",\n    unknownKeysMode: getUnknownKeysMode(schema),\n    discriminator,\n    variants,\n    ...(description ? { description } : {}),\n  };\n}\n\n/**\n * Extract fields from a union-like schema (union or xor)\n */\nfunction extractFromUnionLike(schema: z.ZodType, schemaType: \"union\" | \"xor\"): ExtractedFields {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const options = def?.options ?? [];\n\n  // Collect all unique fields across all options\n  const allFieldsMap = new Map<string, ResolvedFieldMeta>();\n  const unionOptions: ExtractedFields[] = [];\n\n  for (const option of options) {\n    // Extract fields for this option recursively\n    // We cast to ArgsSchema because we expect options to be objects or other supported types\n    const extracted = extractFields(option as ArgsSchema);\n    unionOptions.push(extracted);\n\n    // Add to combined fields map\n    for (const field of extracted.fields) {\n      if (!allFieldsMap.has(field.name)) {\n        allFieldsMap.set(field.name, field);\n      }\n    }\n  }\n\n  const description = extractDescription(schema);\n  return {\n    fields: Array.from(allFieldsMap.values()),\n    schema: schema as ArgsSchema,\n    schemaType,\n    unknownKeysMode: getUnknownKeysMode(schema),\n    unionOptions,\n    ...(description ? { description } : {}),\n  };\n}\n\n/**\n * Extract fields from an intersection\n */\nfunction extractFromIntersection(schema: z.ZodType): ExtractedFields {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const left = def?.left;\n  const right = def?.right;\n\n  const allFieldsMap = new Map<string, ResolvedFieldMeta>();\n\n  // Helper to extract fields from a sub-schema\n  const extractSubFields = (subSchema: z.ZodType | undefined) => {\n    if (!subSchema) return;\n\n    const extracted = extractFields(subSchema as ArgsSchema);\n    for (const field of extracted.fields) {\n      if (!allFieldsMap.has(field.name)) {\n        allFieldsMap.set(field.name, field);\n      }\n    }\n  };\n\n  extractSubFields(left);\n  extractSubFields(right);\n\n  const description = extractDescription(schema);\n  return {\n    fields: Array.from(allFieldsMap.values()),\n    schema: schema as ArgsSchema,\n    schemaType: \"intersection\",\n    unknownKeysMode: getUnknownKeysMode(schema),\n    ...(description ? { description } : {}),\n  };\n}\n\n/**\n * Cache for extractFields results to avoid redundant schema extraction\n */\nconst extractFieldsCache = new WeakMap<ArgsSchema, ExtractedFields>();\n\n/**\n * Extract all fields from a schema\n *\n * @param schema - The args schema (ZodObject, ZodDiscriminatedUnion, etc.)\n * @returns Extracted field information\n */\nexport function extractFields(schema: ArgsSchema): ExtractedFields {\n  const cached = extractFieldsCache.get(schema);\n  if (cached) return cached;\n\n  let result: ExtractedFields;\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  switch (typeName) {\n    case \"object\": {\n      const description = extractDescription(schema);\n      result = {\n        fields: extractFromObject(schema),\n        schema,\n        schemaType: \"object\",\n        unknownKeysMode: getUnknownKeysMode(schema),\n        ...(description ? { description } : {}),\n      };\n      break;\n    }\n\n    case \"union\":\n      // In Zod v4, discriminatedUnion has type \"union\" with a discriminator property\n      if (def?.discriminator) {\n        result = extractFromDiscriminatedUnion(schema);\n      } else {\n        result = extractFromUnionLike(schema, \"union\");\n      }\n      break;\n\n    case \"xor\":\n      result = extractFromUnionLike(schema, \"xor\");\n      break;\n\n    case \"intersection\":\n      result = extractFromIntersection(schema);\n      break;\n\n    case \"pipe\": {\n      // Handle transform/refine on top-level schema (e.g., z.object({...}).transform(...))\n      const pipeInner = def?.in ?? def?.schema;\n      if (pipeInner) {\n        const innerResult = extractFields(pipeInner as ArgsSchema);\n        const pipeDescription = extractDescription(schema);\n        result = {\n          ...innerResult,\n          schema,\n          ...(pipeDescription ? { description: pipeDescription } : {}),\n        };\n        break;\n      }\n      const pipeDescription = extractDescription(schema);\n      result = {\n        fields: [],\n        schema,\n        schemaType: \"object\",\n        unknownKeysMode: getUnknownKeysMode(schema),\n        ...(pipeDescription ? { description: pipeDescription } : {}),\n      };\n      break;\n    }\n\n    default: {\n      const description = extractDescription(schema);\n      // Fallback: try to treat as object\n      result = {\n        fields: [],\n        schema,\n        schemaType: \"object\",\n        unknownKeysMode: getUnknownKeysMode(schema),\n        ...(description ? { description } : {}),\n      };\n      break;\n    }\n  }\n\n  extractFieldsCache.set(schema, result);\n  return result;\n}\n\n/**\n * Get extracted fields from a command\n *\n * @param command - The command to extract fields from\n * @returns Extracted field information, or null if command has no args schema\n */\nexport function getExtractedFields(command: AnyCommand): ExtractedFields | null {\n  if (!command.args) {\n    return null;\n  }\n  return extractFields(command.args);\n}\n","/**\n * Lazy-loaded subcommand with synchronous metadata\n */\n\nimport type { AnyCommand, SubCommandValue } from \"./types.js\";\n\n/**\n * Marker property for LazyCommand identification\n */\nconst LAZY_BRAND = \"__politty_lazy__\" as const;\n\n/**\n * A lazily-loaded command that carries synchronous metadata for\n * static analysis (completion, help) while deferring full module\n * loading to execution time.\n */\nexport interface LazyCommand<T extends AnyCommand = AnyCommand> {\n  readonly __politty_lazy__: true;\n  readonly meta: T;\n  readonly load: () => Promise<AnyCommand>;\n}\n\n/**\n * Type guard: check if a value is a LazyCommand\n */\nexport function isLazyCommand(value: unknown): value is LazyCommand {\n  return (\n    typeof value === \"object\" && value !== null && LAZY_BRAND in value && value[LAZY_BRAND] === true\n  );\n}\n\n/**\n * Create a lazily-loaded subcommand with synchronous metadata.\n *\n * The `meta` command provides names, descriptions, and args schema\n * for static analysis (completion scripts, help text) without loading\n * the full command module.\n *\n * The `load` function is called only at execution time.\n *\n * @example\n * ```ts\n * import { lazy, defineCommand } from \"politty\";\n *\n * const cli = defineCommand({\n *   name: \"mycli\",\n *   subCommands: {\n *     deploy: lazy(\n *       defineCommand({\n *         name: \"deploy\",\n *         description: \"Deploy the application\",\n *         args: z.object({ env: arg(z.string()) }),\n *       }),\n *       () => import(\"./deploy.js\").then((m) => m.deployCommand),\n *     ),\n *   },\n * });\n * ```\n */\nexport function lazy<T extends AnyCommand>(\n  meta: T,\n  load: () => Promise<AnyCommand>,\n): LazyCommand<T> {\n  return {\n    [LAZY_BRAND]: true as const,\n    meta,\n    load,\n  };\n}\n\n/**\n * Resolve synchronous metadata from a SubCommandValue.\n * Returns null for legacy async subcommands whose metadata is unavailable.\n */\nexport function resolveSubCommandMeta(subCmd: SubCommandValue): AnyCommand | null {\n  if (isLazyCommand(subCmd)) return subCmd.meta;\n  if (typeof subCmd === \"function\") return null;\n  return subCmd;\n}\n"],"mappings":"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"}

package/dist/{lazy-xrzxwnru.js → lazy-DiMJSDMB.js}

@@ -201,10 +201,26 @@ function resolveFieldMeta(name, schema) {
 	const description = argMeta?.description ?? extractDescription(schema);
 	const cliName = toKebabCase(name);
 	const enumValues = extractEnumValues(schema);
+	const aliasPattern = /^[A-Za-z0-9][A-Za-z0-9-]*$/;
+	const normalizeAliasList = (input, metaKey) => {
+		if (input == null) return void 0;
+		const normalized = (Array.isArray(input) ? input : [input]).map((a) => {
+			if (typeof a !== "string") throw new Error(`Invalid ${metaKey} for field "${name}": expected string or string[], received ${typeof a}.`);
+			const candidate = a.trim().replace(/^-+/, "");
+			if (candidate.length === 0 || !aliasPattern.test(candidate)) throw new Error(`Invalid ${metaKey} "${a}" for field "${name}": aliases must match ${aliasPattern}.`);
+			return candidate;
+		});
+		const result = Array.from(new Set(normalized));
+		return result.length > 0 ? result : void 0;
+	};
+	const alias = normalizeAliasList(argMeta?.alias, "alias");
+	const visibleSet = new Set(alias ?? []);
+	const hiddenAlias = normalizeAliasList(argMeta?.hiddenAlias, "hiddenAlias")?.filter((a) => !visibleSet.has(a));
 	const meta = {
 		name,
 		cliName,
-		alias: argMeta?.alias,
+		alias,
+		hiddenAlias: hiddenAlias && hiddenAlias.length > 0 ? hiddenAlias : void 0,
 		description,
 		positional: argMeta?.positional ?? false,
 		placeholder: argMeta?.placeholder,
@@ -222,6 +238,15 @@ function resolveFieldMeta(name, schema) {
 	return meta;
 }
 /**
+* Get the combined list of visible + hidden aliases for a field.
+* Used by the parser and validators which treat both equally,
+* while help/docs/completion rely on `field.alias` only.
+*/
+function getAllAliases(field) {
+	if (!field.alias && !field.hiddenAlias) return [];
+	return [...field.alias ?? [], ...field.hiddenAlias ?? []];
+}
+/**
 * Get shape from a ZodObject
 */
 function getObjectShape(schema) {
@@ -478,5 +503,5 @@ function resolveSubCommandMeta(subCmd) {
 }
 
 //#endregion
-export { getExtractedFields as a, toKebabCase as c, extractFields as i, arg as l, lazy as n, getUnknownKeysMode as o, resolveSubCommandMeta as r, toCamelCase as s, isLazyCommand as t };
-//# sourceMappingURL=lazy-xrzxwnru.js.map
+export { getAllAliases as a, toCamelCase as c, extractFields as i, toKebabCase as l, lazy as n, getExtractedFields as o, resolveSubCommandMeta as r, getUnknownKeysMode as s, isLazyCommand as t, arg as u };
+//# sourceMappingURL=lazy-DiMJSDMB.js.map

package/dist/lazy-DiMJSDMB.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-DiMJSDMB.js","names":["getArgMeta","getArgMetaFromRegistry"],"sources":["../src/core/arg-registry.ts","../src/core/schema-extractor.ts","../src/lazy.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport type { GlobalArgs, IsEmpty } from \"../types.js\";\n\n/**\n * Built-in completion types\n */\nexport type CompletionType = \"file\" | \"directory\" | \"none\";\n\n/**\n * Custom completion specification\n */\nexport interface CustomCompletion {\n  /** Static list of choices for completion */\n  choices?: string[];\n  /** Shell command to execute for dynamic completion */\n  shellCommand?: string;\n}\n\n/**\n * Completion metadata for an argument\n *\n * @example\n * ```ts\n * // File completion with extension filter\n * input: arg(z.string(), {\n *   completion: { type: \"file\", extensions: [\"json\", \"yaml\"] }\n * })\n *\n * // Directory completion\n * outputDir: arg(z.string(), {\n *   completion: { type: \"directory\" }\n * })\n *\n * // Custom static choices\n * logLevel: arg(z.string(), {\n *   completion: { custom: { choices: [\"debug\", \"info\", \"warn\", \"error\"] } }\n * })\n *\n * // Dynamic completion from shell command\n * branch: arg(z.string(), {\n *   completion: { custom: { shellCommand: \"git branch --format='%(refname:short)'\" } }\n * })\n *\n * // File completion with glob pattern matcher\n * envFile: arg(z.string(), {\n *   completion: { type: \"file\", matcher: [\".env.*\"] }\n * })\n * ```\n */\nexport type CompletionMeta = {\n  /** Built-in completion type */\n  type?: CompletionType;\n  /** Custom completion (takes precedence over type if both specified) */\n  custom?: CustomCompletion;\n} & (\n  | {\n      /** File extension filter (only applies when type is \"file\") */ extensions?: string[];\n      matcher?: never;\n    }\n  | {\n      /** Glob patterns for file matching (only applies when type is \"file\") */ matcher?: string[];\n      extensions?: never;\n    }\n);\n\n/**\n * Prompt input type for interactive prompts\n *\n * - \"text\": free-form text input (default for string schemas)\n * - \"password\": masked text input\n * - \"confirm\": yes/no prompt (default for boolean schemas)\n * - \"select\": single selection from choices (default for enum schemas)\n * - \"file\": file path input (inherited from completion type)\n * - \"directory\": directory path input (inherited from completion type)\n */\nexport type PromptType = \"text\" | \"password\" | \"confirm\" | \"select\" | \"file\" | \"directory\";\n\n/**\n * Prompt metadata for interactive input when a value is missing.\n * Used by the `politty/prompt` module to request user input for unresolved arguments.\n *\n * @example\n * ```ts\n * // Custom prompt message\n * name: arg(z.string(), {\n *   prompt: { message: \"What is your name?\" }\n * })\n *\n * // Password input (masked)\n * token: arg(z.string(), {\n *   prompt: { type: \"password\", message: \"Enter API token\" }\n * })\n *\n * // Select with custom choices\n * region: arg(z.string(), {\n *   prompt: { choices: [\"us-east-1\", \"eu-west-1\", \"ap-northeast-1\"] }\n * })\n * ```\n */\nexport interface PromptMeta {\n  /** Prompt message shown to the user. Defaults to the field's description or name. */\n  message?: string;\n  /** Explicit prompt type. Overrides auto-detection from schema/completion. */\n  type?: PromptType;\n  /** Choices for select prompt. Overrides enum values from schema. */\n  choices?: Array<string | { label: string; value: string }>;\n  /** Whether to enable prompting for this field (default: true when prompt is set) */\n  enabled?: boolean;\n}\n\n/**\n * Context provided to effect callbacks.\n * When GlobalArgs is extended via declaration merging, `globalArgs` is typed accordingly.\n */\nexport type EffectContext = {\n  /** Field name (camelCase) */\n  name: string;\n  /** Validated args for this schema (global args for global effects, command args for command effects) */\n  args: Readonly<Record<string, unknown>>;\n} & (IsEmpty<GlobalArgs> extends true\n  ? { globalArgs?: Readonly<Record<string, unknown>> }\n  : { globalArgs?: Readonly<GlobalArgs> });\n\n/**\n * Base metadata shared by all argument types\n */\nexport interface BaseArgMeta<TValue = unknown> {\n  /** Argument description */\n  description?: string;\n  /** Treat as positional argument */\n  positional?: boolean;\n  /** Placeholder for help display */\n  placeholder?: string;\n  /**\n   * Environment variable name(s) to read value from.\n   * If an array is provided, earlier entries take priority.\n   * CLI arguments always take precedence over environment variables.\n   *\n   * @example\n   * ```ts\n   * // Single env var\n   * port: arg(z.coerce.number(), { env: \"PORT\" })\n   *\n   * // Multiple env vars (PORT takes priority over SERVER_PORT)\n   * port: arg(z.coerce.number(), { env: [\"PORT\", \"SERVER_PORT\"] })\n   * ```\n   */\n  env?: string | string[];\n  /** Completion configuration for shell tab-completion */\n  completion?: CompletionMeta;\n  /**\n   * Interactive prompt configuration for missing values.\n   * When set, the `politty/prompt` module will prompt the user interactively\n   * if this argument is not provided via CLI args or environment variables.\n   *\n   * @example\n   * ```ts\n   * name: arg(z.string(), {\n   *   description: \"User name\",\n   *   prompt: { message: \"What is your name?\" },\n   * })\n   * ```\n   */\n  prompt?: PromptMeta;\n  /**\n   * Side-effect callback executed after argument parsing and validation.\n   * Runs before the command lifecycle (setup/run/cleanup).\n   * Use Zod .transform() for value transformation instead.\n   *\n   * @example\n   * ```ts\n   * verbose: arg(z.boolean().default(false), {\n   *   alias: \"v\",\n   *   effect: (value) => {\n   *     if (value) logger.setLevel(\"debug\");\n   *   },\n   * })\n   * ```\n   */\n  effect?: (value: TValue, context: EffectContext) => void | PromiseLike<void>;\n}\n\n/**\n * Metadata for regular arguments (non-builtin aliases)\n *\n * `alias` accepts either a single string or an array of strings.\n * Single-character entries become short options (e.g. `-v`); multi-character\n * entries become additional long options (e.g. `--to-be` for `--tobe`).\n */\nexport interface RegularArgMeta<TValue = unknown> extends BaseArgMeta<TValue> {\n  /**\n   * Alias name(s) for this option.\n   * - 1-char string  → short alias (`-v`)\n   * - >1-char string → long alias (`--long-name`)\n   * - array          → multiple aliases of either kind\n   */\n  alias?: string | string[] | readonly string[];\n  /**\n   * Alias name(s) that are accepted by the parser but hidden from help,\n   * generated docs, and shell completion. Useful for legacy or deprecated\n   * names that should still work without being advertised.\n   */\n  hiddenAlias?: string | string[] | readonly string[];\n}\n\n/**\n * Metadata for overriding built-in aliases (-h, -H)\n */\nexport interface BuiltinOverrideArgMeta<TValue = unknown> extends BaseArgMeta<TValue> {\n  /** Built-in alias to override ('h' or 'H'), optionally combined with extra aliases */\n  alias: \"h\" | \"H\" | Array<\"h\" | \"H\" | string> | ReadonlyArray<\"h\" | \"H\" | string>;\n  /** Hidden aliases (accepted but not surfaced in help/docs/completion) */\n  hiddenAlias?: string | string[] | readonly string[];\n  /** Must be true to override built-in aliases */\n  overrideBuiltinAlias: true;\n}\n\n/**\n * Metadata options for argument definition\n */\nexport type ArgMeta<TValue = unknown> = RegularArgMeta<TValue> | BuiltinOverrideArgMeta<TValue>;\n\n/**\n * Custom registry for politty argument metadata\n * This avoids polluting Zod's GlobalMeta\n */\nexport const argRegistry = z.registry<ArgMeta>();\n\n/**\n * Register metadata for a Zod schema\n *\n * @param schema - The Zod schema\n * @param meta - Argument metadata\n * @returns The same schema (for chaining)\n *\n * @example\n * ```ts\n * import { z } from \"zod\";\n * import { arg, defineCommand } from \"politty\";\n *\n * const cmd = defineCommand({\n *   args: z.object({\n *     name: arg(z.string(), { description: \"User name\", positional: true }),\n *     verbose: arg(z.boolean().default(false), { alias: \"v\" }),\n *   }),\n *   run: (args) => {\n *     console.log(args.name, args.verbose);\n *   },\n * });\n * ```\n */\n/**\n * Detect whether `A` contains a reserved alias (\"h\" or \"H\"), for either a\n * plain string or a tuple/array of strings. Uses `[A] extends [never]` to\n * prevent distribution returning `never` for missing fields.\n */\ntype ContainsReservedAlias<A> = [A] extends [never]\n  ? false\n  : A extends \"h\" | \"H\"\n    ? true\n    : A extends readonly (infer E)[]\n      ? [Extract<E, \"h\" | \"H\">] extends [never]\n        ? false\n        : true\n      : false;\n\ntype ReservedAliasTypeError<M> = {\n  [K in keyof M]: M[K];\n} & {\n  __typeError: \"Alias 'h' or 'H' requires overrideBuiltinAlias: true\";\n};\n\ntype AliasFieldOf<M> = M extends { alias: infer A } ? A : never;\ntype HiddenAliasFieldOf<M> = M extends { hiddenAlias: infer H } ? H : never;\n\n/**\n * Type helper to validate ArgMeta.\n * Forces a type error when a reserved alias (\"h\" / \"H\") is used without\n * `overrideBuiltinAlias: true`, whether the alias is provided as a string\n * or as part of an array, and whether it appears in `alias` or `hiddenAlias`.\n */\ntype ValidateArgMeta<M> = M extends { overrideBuiltinAlias: true }\n  ? M\n  : ContainsReservedAlias<AliasFieldOf<M>> extends true\n    ? ReservedAliasTypeError<M>\n    : ContainsReservedAlias<HiddenAliasFieldOf<M>> extends true\n      ? ReservedAliasTypeError<M>\n      : M;\n\nexport function arg<T extends z.ZodType>(schema: T): T;\nexport function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(\n  schema: T,\n  meta: ValidateArgMeta<M>,\n): T;\nexport function arg<T extends z.ZodType>(schema: T, meta?: ValidateArgMeta<ArgMeta>): T {\n  if (meta) {\n    argRegistry.add(schema, meta as ArgMeta);\n  }\n  return schema;\n}\n\n/**\n * Get metadata for a schema from the registry\n *\n * @param schema - The Zod schema\n * @returns The metadata if registered, undefined otherwise\n */\nexport function getArgMeta(schema: z.ZodType): ArgMeta | undefined {\n  return argRegistry.get(schema);\n}\n","import type { z } from \"zod\";\nimport type { AnyCommand, ArgsSchema } from \"../types.js\";\nimport {\n  getArgMeta as getArgMetaFromRegistry,\n  type ArgMeta,\n  type CompletionMeta,\n  type EffectContext,\n  type PromptMeta,\n} from \"./arg-registry.js\";\n\n/**\n * Get ArgMeta from both the custom registry and Zod's _def\n * Priority: custom registry > _def.argMeta\n */\nfunction getArgMeta(schema: z.ZodType): ArgMeta | undefined {\n  // First check custom registry\n  const fromRegistry = getArgMetaFromRegistry(schema);\n  if (fromRegistry) return fromRegistry;\n  // Check Zod native meta\n  // Some Zod versions or extensions use a global registry accessed via .meta()\n  if (typeof (schema as any).meta === \"function\") {\n    const meta = (schema as any).meta();\n    if (meta && typeof meta === \"object\") {\n      return meta as ArgMeta;\n    }\n  }\n\n  // Then check _def.argMeta (for augmented Zod types)\n  const def = (schema as any)._def;\n  if (def?.argMeta) return def.argMeta;\n\n  // Also check _def.meta just in case\n  if (def?.meta) return def.meta as ArgMeta;\n\n  return undefined;\n}\n\n/**\n * Resolved metadata for an argument field\n */\nexport interface ResolvedFieldMeta {\n  /** Field name (camelCase, as defined in schema) */\n  name: string;\n  /** CLI option name (kebab-case, for command line usage) */\n  cliName: string;\n  /**\n   * Aliases for this option, normalized to an array.\n   * 1-char entries are short aliases (`-v`); multi-char entries are long\n   * aliases (`--to-be`).\n   */\n  alias?: string[] | undefined;\n  /**\n   * Aliases that are accepted at parse time but hidden from help,\n   * generated docs, and shell completion.\n   */\n  hiddenAlias?: string[] | undefined;\n  /** Argument description */\n  description?: string | undefined;\n  /** Whether this is a positional argument */\n  positional: boolean;\n  /** Placeholder for help display */\n  placeholder?: string | undefined;\n  /**\n   * Environment variable name(s) to read value from.\n   * If an array, earlier entries take priority.\n   */\n  env?: string | string[] | undefined;\n  /** Whether this argument is required */\n  required: boolean;\n  /** Default value if any */\n  defaultValue?: unknown;\n  /** Detected type from schema */\n  type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"unknown\";\n  /** Original Zod schema */\n  schema: z.ZodType;\n  /** True if this overrides built-in aliases (-h, -H) */\n  overrideBuiltinAlias?: true;\n  /** Enum values if detected from schema (z.enum) */\n  enumValues?: string[] | undefined;\n  /** Completion metadata from arg() */\n  completion?: CompletionMeta | undefined;\n  /** Prompt metadata from arg() for interactive input */\n  prompt?: PromptMeta | undefined;\n  /** Side-effect callback from arg() metadata */\n  effect?: ((value: unknown, context: EffectContext) => void | PromiseLike<void>) | undefined;\n}\n\n/**\n * Extracted fields from a schema\n */\nexport interface ExtractedFields {\n  /** All field definitions */\n  fields: ResolvedFieldMeta[];\n  /** Original schema for validation */\n  schema: ArgsSchema;\n  /** Schema type */\n  schemaType: \"object\" | \"discriminatedUnion\" | \"union\" | \"xor\" | \"intersection\";\n  /** Discriminator key (for discriminatedUnion) */\n  discriminator?: string;\n  /** Variants (for discriminatedUnion) */\n  variants?: Array<{\n    discriminatorValue: string;\n    fields: ResolvedFieldMeta[];\n    description?: string;\n  }>;\n  /** Options (for union) */\n  unionOptions?: ExtractedFields[];\n  /** Schema description */\n  description?: string;\n  /**\n   * Unknown keys handling mode\n   * - \"strict\": Unknown keys cause validation errors (z.strictObject or z.object().strict())\n   * - \"strip\": Unknown keys trigger warnings (default, z.object())\n   * - \"passthrough\": Unknown keys are silently ignored (z.looseObject or z.object().passthrough())\n   */\n  unknownKeysMode: UnknownKeysMode;\n}\n\n/**\n * Unknown keys handling mode for object schemas\n * - \"strict\": Unknown keys cause validation errors\n * - \"strip\": Unknown keys are silently ignored (default)\n * - \"passthrough\": Unknown keys are passed through\n */\nexport type UnknownKeysMode = \"strict\" | \"strip\" | \"passthrough\";\n\n// Internal type for accessing zod v4 internals\ninterface ZodV4Def {\n  type?: string;\n  innerType?: z.ZodType;\n  schema?: z.ZodType;\n  defaultValue?: unknown;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  shape?: Record<string, any>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  options?: any[];\n  discriminator?: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  left?: any;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  right?: any;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  catchall?: any;\n  /** Pipe input schema (zod v4 transform/refine) */\n  in?: z.ZodType;\n  /** Pipe output schema (zod v4 transform/refine) */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  out?: any;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype ZodSchemaWithDef = z.ZodType & { def?: ZodV4Def; _def?: ZodV4Def; type?: string; shape?: any };\n\n/**\n * Get the type name from a zod schema (v4 compatible)\n */\nfunction getTypeName(schema: z.ZodType): string | undefined {\n  const s = schema as ZodSchemaWithDef;\n  return s.def?.type ?? s._def?.type ?? s.type;\n}\n\n/**\n * Detect unknown keys handling mode from a Zod object schema\n *\n * In Zod v4:\n * - Default (strip): _def.catchall is undefined\n * - strict: _def.catchall is ZodNever (type = \"never\")\n * - passthrough: _def.catchall is ZodUnknown (type = \"unknown\")\n */\nexport function getUnknownKeysMode(schema: z.ZodType): UnknownKeysMode {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const catchall = def?.catchall;\n\n  if (!catchall) {\n    // Default behavior: strip unknown keys (but we want to warn)\n    return \"strip\";\n  }\n\n  const catchallType = getTypeName(catchall);\n\n  if (catchallType === \"never\") {\n    // z.strictObject() or z.object().strict() - reject unknown keys\n    return \"strict\";\n  }\n\n  if (catchallType === \"unknown\" || catchallType === \"any\") {\n    // z.looseObject() or z.object().passthrough() - allow unknown keys\n    return \"passthrough\";\n  }\n\n  // Unknown catchall type, default to strip behavior\n  return \"strip\";\n}\n\n/**\n * Get the inner schema, unwrapping optional, nullable, default, etc.\n */\nfunction unwrapSchema(schema: z.ZodType): z.ZodType {\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"optional\" || typeName === \"nullable\" || typeName === \"default\") {\n    const innerSchema = def?.innerType;\n    if (innerSchema) {\n      return unwrapSchema(innerSchema);\n    }\n  }\n\n  // Handle effects (transform, refine, etc.)\n  if (typeName === \"pipe\") {\n    const innerSchema = def?.in ?? def?.schema;\n    if (innerSchema) {\n      return unwrapSchema(innerSchema);\n    }\n  }\n\n  return schema;\n}\n\n/**\n * Detect the base type of a schema\n */\nfunction detectType(schema: z.ZodType): \"string\" | \"number\" | \"boolean\" | \"array\" | \"unknown\" {\n  const innerSchema = unwrapSchema(schema);\n  const typeName = getTypeName(innerSchema);\n\n  switch (typeName) {\n    case \"string\":\n    case \"enum\":\n      return \"string\";\n    case \"number\":\n    case \"int\":\n      return \"number\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"array\":\n      return \"array\";\n    default:\n      return \"unknown\";\n  }\n}\n\n/**\n * Extract enum values from a schema if it's an enum type\n *\n * @param schema - The Zod schema to extract enum values from\n * @returns Array of enum values if schema is an enum, undefined otherwise\n */\nexport function extractEnumValues(schema: z.ZodType): string[] | undefined {\n  const innerSchema = unwrapSchema(schema);\n  const typeName = getTypeName(innerSchema);\n  const s = innerSchema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"enum\") {\n    // Zod v4: enum values are in def.entries or def.values\n    const entries = (def as { entries?: Record<string, string> })?.entries;\n    if (entries && typeof entries === \"object\") {\n      return Object.values(entries);\n    }\n\n    // Check for values array (some Zod versions)\n    const values = (def as { values?: string[] })?.values;\n    if (Array.isArray(values)) {\n      return values;\n    }\n\n    // Fallback: check for options property on schema\n    const options = (s as { options?: string[] }).options;\n    if (Array.isArray(options)) {\n      return options;\n    }\n  }\n\n  // Handle array types: extract enum values from the element type\n  if (typeName === \"array\") {\n    const element = (def as { element?: z.ZodType })?.element;\n    if (element) {\n      return extractEnumValues(element);\n    }\n  }\n\n  // Also handle literal union patterns (z.literal(\"a\").or(z.literal(\"b\")))\n  if (typeName === \"union\") {\n    const options = def?.options;\n    if (Array.isArray(options)) {\n      const literalValues: string[] = [];\n      for (const option of options) {\n        const optionTypeName = getTypeName(option);\n        if (optionTypeName === \"literal\") {\n          const optionDef = (option as ZodSchemaWithDef).def ?? (option as ZodSchemaWithDef)._def;\n          const value = (optionDef as { value?: unknown; values?: unknown[] })?.value;\n          const values = (optionDef as { value?: unknown; values?: unknown[] })?.values;\n          const literalValue = value ?? values?.[0];\n          if (typeof literalValue === \"string\") {\n            literalValues.push(literalValue);\n          }\n        }\n      }\n      // Only return if all options are string literals\n      if (literalValues.length === options.length && literalValues.length > 0) {\n        return literalValues;\n      }\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Convert camelCase to kebab-case\n * @example toKebabCase(\"dryRun\") => \"dry-run\"\n * @example toKebabCase(\"outputDir\") => \"output-dir\"\n * @example toKebabCase(\"XMLParser\") => \"xml-parser\"\n */\nexport function toKebabCase(str: string): string {\n  return str\n    .replace(/([a-z])([A-Z])/g, \"$1-$2\")\n    .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1-$2\")\n    .toLowerCase();\n}\n\n/**\n * Convert hyphen-separated sequences to camelCase.\n *\n * Replaces `-x` (hyphen followed by a lowercase letter) with the uppercase\n * variant. Non-hyphenated input (e.g., already camelCase) is returned as-is.\n *\n * @param str - A string that may contain hyphens\n * @example toCamelCase(\"dry-run\") => \"dryRun\"\n * @example toCamelCase(\"output-dir\") => \"outputDir\"\n * @example toCamelCase(\"dryRun\") => \"dryRun\"\n */\nexport function toCamelCase(str: string): string {\n  return str.replace(/-([a-z])/g, (_, char) => char.toUpperCase());\n}\n\n/**\n * Check if a schema is required (not optional or has default)\n *\n * Note: We only check isOptional(), not isNullable(), because CLI arguments\n * are either present (string value) or absent (undefined), never null.\n * Also, some coerce types incorrectly report isNullable()=true.\n */\nfunction isRequired(schema: z.ZodType): boolean {\n  return !schema.isOptional();\n}\n\n/**\n * Extract default value from schema if present\n */\nfunction extractDefaultValue(schema: z.ZodType): unknown {\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"default\") {\n    const defaultValue = def?.defaultValue;\n    // In zod v4, defaultValue can be a direct value or a function\n    if (typeof defaultValue === \"function\") {\n      return defaultValue();\n    }\n    return defaultValue;\n  }\n\n  // Check for nested default in optional/nullable\n  if (typeName === \"optional\" || typeName === \"nullable\") {\n    const innerSchema = def?.innerType;\n    if (innerSchema) {\n      return extractDefaultValue(innerSchema);\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Extract description from schema\n */\nfunction extractDescription(schema: z.ZodType): string | undefined {\n  // Check direct description\n  if (schema.description) {\n    return schema.description;\n  }\n\n  // Check inner schema for wrapped types\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"optional\" || typeName === \"nullable\" || typeName === \"default\") {\n    const innerSchema = def?.innerType;\n    if (innerSchema) {\n      return extractDescription(innerSchema);\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Resolve field metadata from schema and argRegistry\n */\nfunction resolveFieldMeta(name: string, schema: z.ZodType): ResolvedFieldMeta {\n  // Get metadata from argRegistry\n  const argMeta = getArgMeta(schema) ?? getArgMeta(unwrapSchema(schema));\n\n  // Priority: argRegistry > schema.describe()\n  const description = argMeta?.description ?? extractDescription(schema);\n\n  // Convert camelCase field name to kebab-case for CLI usage\n  const cliName = toKebabCase(name);\n\n  // Extract enum values from schema\n  const enumValues = extractEnumValues(schema);\n\n  // Normalize alias-like inputs to a deduped, validated array (or undefined when empty).\n  // Leading dashes are stripped for convenience; entries that still fail the pattern after\n  // stripping cause a validation error so that invalid aliases are never silently ignored.\n  const aliasPattern = /^[A-Za-z0-9][A-Za-z0-9-]*$/;\n  const normalizeAliasList = (\n    input: unknown,\n    metaKey: \"alias\" | \"hiddenAlias\",\n  ): string[] | undefined => {\n    if (input == null) return undefined;\n    const arr = Array.isArray(input) ? input : [input];\n    const normalized = arr.map((a) => {\n      if (typeof a !== \"string\") {\n        throw new Error(\n          `Invalid ${metaKey} for field \"${name}\": expected string or string[], received ${typeof a}.`,\n        );\n      }\n      const candidate = a.trim().replace(/^-+/, \"\");\n      if (candidate.length === 0 || !aliasPattern.test(candidate)) {\n        throw new Error(\n          `Invalid ${metaKey} \"${a}\" for field \"${name}\": aliases must match ${aliasPattern}.`,\n        );\n      }\n      return candidate;\n    });\n    const result = Array.from(new Set(normalized));\n    return result.length > 0 ? result : undefined;\n  };\n\n  const alias = normalizeAliasList(argMeta?.alias, \"alias\");\n  // Filter hiddenAlias so it never overlaps with visible alias (visible wins)\n  const visibleSet = new Set(alias ?? []);\n  const hiddenAliasRaw = normalizeAliasList(\n    (argMeta as { hiddenAlias?: string | string[] } | undefined)?.hiddenAlias,\n    \"hiddenAlias\",\n  );\n  const hiddenAlias = hiddenAliasRaw?.filter((a) => !visibleSet.has(a));\n  const hiddenAliasFinal = hiddenAlias && hiddenAlias.length > 0 ? hiddenAlias : undefined;\n\n  const meta: ResolvedFieldMeta = {\n    name,\n    cliName,\n    alias,\n    hiddenAlias: hiddenAliasFinal,\n    description,\n    positional: argMeta?.positional ?? false,\n    placeholder: argMeta?.placeholder,\n    env: argMeta?.env,\n    required: isRequired(schema),\n    defaultValue: extractDefaultValue(schema),\n    type: detectType(schema),\n    schema,\n    enumValues,\n    completion: argMeta?.completion,\n    prompt: argMeta?.prompt,\n    effect: argMeta?.effect,\n  };\n\n  // Add overrideBuiltinAlias only if it's true\n  if (argMeta && \"overrideBuiltinAlias\" in argMeta && argMeta.overrideBuiltinAlias === true) {\n    meta.overrideBuiltinAlias = true;\n  }\n\n  return meta;\n}\n\n/**\n * Get the combined list of visible + hidden aliases for a field.\n * Used by the parser and validators which treat both equally,\n * while help/docs/completion rely on `field.alias` only.\n */\nexport function getAllAliases(field: ResolvedFieldMeta): string[] {\n  if (!field.alias && !field.hiddenAlias) return [];\n  return [...(field.alias ?? []), ...(field.hiddenAlias ?? [])];\n}\n\n/**\n * Get shape from a ZodObject\n */\nfunction getObjectShape(schema: z.ZodType): Record<string, z.ZodType> {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  return def?.shape ?? s.shape ?? {};\n}\n\n/**\n * Extract fields from a ZodObject\n */\nfunction extractFromObject(schema: z.ZodType): ResolvedFieldMeta[] {\n  const shape = getObjectShape(schema);\n  return Object.entries(shape).map(([name, fieldSchema]) => resolveFieldMeta(name, fieldSchema));\n}\n\n/**\n * Extract fields from a discriminated union\n */\nfunction extractFromDiscriminatedUnion(schema: z.ZodType): ExtractedFields {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const discriminator = def?.discriminator ?? \"\";\n  const options = def?.options ?? [];\n\n  // Collect all unique fields across all variants\n  const allFieldsMap = new Map<string, ResolvedFieldMeta>();\n  const variants: ExtractedFields[\"variants\"] = [];\n\n  for (const option of options) {\n    const shape = getObjectShape(option as z.ZodObject<z.ZodRawShape>);\n    const variantFields: ResolvedFieldMeta[] = [];\n\n    // Get discriminator value from the variant's discriminator schema.\n    // Supports z.literal() and single-value z.enum() discriminators.\n    let discriminatorValue = \"\";\n    const discriminatorSchema = shape[discriminator];\n    if (discriminatorSchema) {\n      const typeName = getTypeName(discriminatorSchema);\n      if (typeName === \"literal\") {\n        const litDef =\n          (discriminatorSchema as ZodSchemaWithDef).def ??\n          (discriminatorSchema as ZodSchemaWithDef)._def;\n        // In Zod v4, literal values are in _def.values array\n        const value = (litDef as { value?: unknown; values?: unknown[] })?.value;\n        const values = (litDef as { value?: unknown; values?: unknown[] })?.values;\n        discriminatorValue = String(value ?? values?.[0] ?? \"\");\n      } else if (typeName === \"enum\") {\n        // Only single-value enums map to one variant. Multi-value enums\n        // (z.enum(['a','b'])) on a single variant are not standard for\n        // discriminatedUnion and are not extracted here.\n        const enumValues = extractEnumValues(discriminatorSchema);\n        if (enumValues && enumValues.length === 1) {\n          discriminatorValue = enumValues[0]!;\n        }\n      }\n    }\n\n    for (const [name, fieldSchema] of Object.entries(shape)) {\n      const fieldMeta = resolveFieldMeta(name, fieldSchema);\n      variantFields.push(fieldMeta);\n\n      // Add to all fields map (first occurrence wins for metadata)\n      if (!allFieldsMap.has(name)) {\n        allFieldsMap.set(name, fieldMeta);\n      }\n    }\n\n    // Extract description from the variant option\n    const variantDescription = extractDescription(option as z.ZodType);\n\n    variants.push({\n      discriminatorValue,\n      fields: variantFields,\n      ...(variantDescription ? { description: variantDescription } : {}),\n    });\n  }\n\n  const description = extractDescription(schema);\n  return {\n    fields: Array.from(allFieldsMap.values()),\n    schema: schema as ArgsSchema,\n    schemaType: \"discriminatedUnion\",\n    unknownKeysMode: getUnknownKeysMode(schema),\n    discriminator,\n    variants,\n    ...(description ? { description } : {}),\n  };\n}\n\n/**\n * Extract fields from a union-like schema (union or xor)\n */\nfunction extractFromUnionLike(schema: z.ZodType, schemaType: \"union\" | \"xor\"): ExtractedFields {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const options = def?.options ?? [];\n\n  // Collect all unique fields across all options\n  const allFieldsMap = new Map<string, ResolvedFieldMeta>();\n  const unionOptions: ExtractedFields[] = [];\n\n  for (const option of options) {\n    // Extract fields for this option recursively\n    // We cast to ArgsSchema because we expect options to be objects or other supported types\n    const extracted = extractFields(option as ArgsSchema);\n    unionOptions.push(extracted);\n\n    // Add to combined fields map\n    for (const field of extracted.fields) {\n      if (!allFieldsMap.has(field.name)) {\n        allFieldsMap.set(field.name, field);\n      }\n    }\n  }\n\n  const description = extractDescription(schema);\n  return {\n    fields: Array.from(allFieldsMap.values()),\n    schema: schema as ArgsSchema,\n    schemaType,\n    unknownKeysMode: getUnknownKeysMode(schema),\n    unionOptions,\n    ...(description ? { description } : {}),\n  };\n}\n\n/**\n * Extract fields from an intersection\n */\nfunction extractFromIntersection(schema: z.ZodType): ExtractedFields {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const left = def?.left;\n  const right = def?.right;\n\n  const allFieldsMap = new Map<string, ResolvedFieldMeta>();\n\n  // Helper to extract fields from a sub-schema\n  const extractSubFields = (subSchema: z.ZodType | undefined) => {\n    if (!subSchema) return;\n\n    const extracted = extractFields(subSchema as ArgsSchema);\n    for (const field of extracted.fields) {\n      if (!allFieldsMap.has(field.name)) {\n        allFieldsMap.set(field.name, field);\n      }\n    }\n  };\n\n  extractSubFields(left);\n  extractSubFields(right);\n\n  const description = extractDescription(schema);\n  return {\n    fields: Array.from(allFieldsMap.values()),\n    schema: schema as ArgsSchema,\n    schemaType: \"intersection\",\n    unknownKeysMode: getUnknownKeysMode(schema),\n    ...(description ? { description } : {}),\n  };\n}\n\n/**\n * Cache for extractFields results to avoid redundant schema extraction\n */\nconst extractFieldsCache = new WeakMap<ArgsSchema, ExtractedFields>();\n\n/**\n * Extract all fields from a schema\n *\n * @param schema - The args schema (ZodObject, ZodDiscriminatedUnion, etc.)\n * @returns Extracted field information\n */\nexport function extractFields(schema: ArgsSchema): ExtractedFields {\n  const cached = extractFieldsCache.get(schema);\n  if (cached) return cached;\n\n  let result: ExtractedFields;\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  switch (typeName) {\n    case \"object\": {\n      const description = extractDescription(schema);\n      result = {\n        fields: extractFromObject(schema),\n        schema,\n        schemaType: \"object\",\n        unknownKeysMode: getUnknownKeysMode(schema),\n        ...(description ? { description } : {}),\n      };\n      break;\n    }\n\n    case \"union\":\n      // In Zod v4, discriminatedUnion has type \"union\" with a discriminator property\n      if (def?.discriminator) {\n        result = extractFromDiscriminatedUnion(schema);\n      } else {\n        result = extractFromUnionLike(schema, \"union\");\n      }\n      break;\n\n    case \"xor\":\n      result = extractFromUnionLike(schema, \"xor\");\n      break;\n\n    case \"intersection\":\n      result = extractFromIntersection(schema);\n      break;\n\n    case \"pipe\": {\n      // Handle transform/refine on top-level schema (e.g., z.object({...}).transform(...))\n      const pipeInner = def?.in ?? def?.schema;\n      if (pipeInner) {\n        const innerResult = extractFields(pipeInner as ArgsSchema);\n        const pipeDescription = extractDescription(schema);\n        result = {\n          ...innerResult,\n          schema,\n          ...(pipeDescription ? { description: pipeDescription } : {}),\n        };\n        break;\n      }\n      const pipeDescription = extractDescription(schema);\n      result = {\n        fields: [],\n        schema,\n        schemaType: \"object\",\n        unknownKeysMode: getUnknownKeysMode(schema),\n        ...(pipeDescription ? { description: pipeDescription } : {}),\n      };\n      break;\n    }\n\n    default: {\n      const description = extractDescription(schema);\n      // Fallback: try to treat as object\n      result = {\n        fields: [],\n        schema,\n        schemaType: \"object\",\n        unknownKeysMode: getUnknownKeysMode(schema),\n        ...(description ? { description } : {}),\n      };\n      break;\n    }\n  }\n\n  extractFieldsCache.set(schema, result);\n  return result;\n}\n\n/**\n * Get extracted fields from a command\n *\n * @param command - The command to extract fields from\n * @returns Extracted field information, or null if command has no args schema\n */\nexport function getExtractedFields(command: AnyCommand): ExtractedFields | null {\n  if (!command.args) {\n    return null;\n  }\n  return extractFields(command.args);\n}\n","/**\n * Lazy-loaded subcommand with synchronous metadata\n */\n\nimport type { AnyCommand, SubCommandValue } from \"./types.js\";\n\n/**\n * Marker property for LazyCommand identification\n */\nconst LAZY_BRAND = \"__politty_lazy__\" as const;\n\n/**\n * A lazily-loaded command that carries synchronous metadata for\n * static analysis (completion, help) while deferring full module\n * loading to execution time.\n */\nexport interface LazyCommand<T extends AnyCommand = AnyCommand> {\n  readonly __politty_lazy__: true;\n  readonly meta: T;\n  readonly load: () => Promise<AnyCommand>;\n}\n\n/**\n * Type guard: check if a value is a LazyCommand\n */\nexport function isLazyCommand(value: unknown): value is LazyCommand {\n  return (\n    typeof value === \"object\" && value !== null && LAZY_BRAND in value && value[LAZY_BRAND] === true\n  );\n}\n\n/**\n * Create a lazily-loaded subcommand with synchronous metadata.\n *\n * The `meta` command provides names, descriptions, and args schema\n * for static analysis (completion scripts, help text) without loading\n * the full command module.\n *\n * The `load` function is called only at execution time.\n *\n * @example\n * ```ts\n * import { lazy, defineCommand } from \"politty\";\n *\n * const cli = defineCommand({\n *   name: \"mycli\",\n *   subCommands: {\n *     deploy: lazy(\n *       defineCommand({\n *         name: \"deploy\",\n *         description: \"Deploy the application\",\n *         args: z.object({ env: arg(z.string()) }),\n *       }),\n *       () => import(\"./deploy.js\").then((m) => m.deployCommand),\n *     ),\n *   },\n * });\n * ```\n */\nexport function lazy<T extends AnyCommand>(\n  meta: T,\n  load: () => Promise<AnyCommand>,\n): LazyCommand<T> {\n  return {\n    [LAZY_BRAND]: true as const,\n    meta,\n    load,\n  };\n}\n\n/**\n * Resolve synchronous metadata from a SubCommandValue.\n * Returns null for legacy async subcommands whose metadata is unavailable.\n */\nexport function resolveSubCommandMeta(subCmd: SubCommandValue): AnyCommand | null {\n  if (isLazyCommand(subCmd)) return subCmd.meta;\n  if (typeof subCmd === \"function\") return null;\n  return subCmd;\n}\n"],"mappings":"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"}

package/dist/prompt/clack/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_subcommand_router = require('../../subcommand-router-BnHpqyRk.cjs');
+const require_subcommand_router = require('../../subcommand-router-C9ONv6Nq.cjs');
 const require_prompt = require('../../prompt-aXfSf27y.cjs');
 let _clack_prompts = require("@clack/prompts");
 

package/dist/prompt/clack/index.d.cts

@@ -1,4 +1,4 @@
-import { E as PromptResolver } from "../../arg-registry-CeIRoLaB.cjs";
+import { E as PromptResolver } from "../../arg-registry-r5wYN6qd.cjs";
 
 //#region src/prompt/clack/index.d.ts
 /**

package/dist/prompt/clack/index.d.ts

@@ -1,4 +1,4 @@
-import { E as PromptResolver } from "../../arg-registry-6E4C5MTC.js";
+import { E as PromptResolver } from "../../arg-registry-CkPDokIu.js";
 
 //#region src/prompt/clack/index.d.ts
 /**

package/dist/prompt/index.d.cts

@@ -1,4 +1,4 @@
-import { R as ExtractedFields, z as ResolvedFieldMeta } from "../arg-registry-CeIRoLaB.cjs";
+import { R as ExtractedFields, z as ResolvedFieldMeta } from "../arg-registry-r5wYN6qd.cjs";
 
 //#region src/prompt/types.d.ts
 /**

package/dist/prompt/index.d.ts

@@ -1,4 +1,4 @@
-import { R as ExtractedFields, z as ResolvedFieldMeta } from "../arg-registry-6E4C5MTC.js";
+import { R as ExtractedFields, z as ResolvedFieldMeta } from "../arg-registry-CkPDokIu.js";
 
 //#region src/prompt/types.d.ts
 /**

package/dist/prompt/inquirer/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_subcommand_router = require('../../subcommand-router-BnHpqyRk.cjs');
+const require_subcommand_router = require('../../subcommand-router-C9ONv6Nq.cjs');
 const require_prompt = require('../../prompt-aXfSf27y.cjs');
 let _inquirer_prompts = require("@inquirer/prompts");
 

package/dist/prompt/inquirer/index.d.cts

@@ -1,4 +1,4 @@
-import { E as PromptResolver } from "../../arg-registry-CeIRoLaB.cjs";
+import { E as PromptResolver } from "../../arg-registry-r5wYN6qd.cjs";
 
 //#region src/prompt/inquirer/index.d.ts
 /**

package/dist/prompt/inquirer/index.d.ts

@@ -1,4 +1,4 @@
-import { E as PromptResolver } from "../../arg-registry-6E4C5MTC.js";
+import { E as PromptResolver } from "../../arg-registry-CkPDokIu.js";
 
 //#region src/prompt/inquirer/index.d.ts
 /**