politty 0.4.12 → 0.4.13

package/README.md

@@ -13,6 +13,7 @@ From simple scripts to complex CLI tools with subcommands, validation, and auto-
 - **Lifecycle Management**: Guaranteed `setup` → `run` → `cleanup` execution order
 - **Signal Handling**: Proper SIGINT/SIGTERM handling with guaranteed cleanup execution
 - **Auto Help Generation**: Automatically generate help text from definitions
+- **Interactive Prompts**: Prompt for missing arguments with pluggable adapters (clack, inquirer)
 - **Discriminated Union**: Support for mutually exclusive argument sets
 
 ## Requirements
@@ -278,14 +279,15 @@ if (result.success) {
 
 Attach metadata to an argument.
 
-| Metadata      | Type       | Description                          |
-| ------------- | ---------- | ------------------------------------ |
-| `positional`  | `boolean?` | Treat as positional argument         |
-| `alias`       | `string?`  | Short alias (e.g., `-v`)             |
-| `description` | `string?`  | Argument description                 |
-| `placeholder` | `string?`  | Placeholder shown in help            |
-| `env`         | `string?`  | Environment variable name (fallback) |
-| `completion`  | `object?`  | Shell completion configuration       |
+| Metadata      | Type          | Description                                                              |
+| ------------- | ------------- | ------------------------------------------------------------------------ |
+| `positional`  | `boolean?`    | Treat as positional argument                                             |
+| `alias`       | `string?`     | Short alias (e.g., `-v`)                                                 |
+| `description` | `string?`     | Argument description                                                     |
+| `placeholder` | `string?`     | Placeholder shown in help                                                |
+| `env`         | `string?`     | Environment variable name (fallback)                                     |
+| `completion`  | `object?`     | Shell completion configuration                                           |
+| `prompt`      | `PromptMeta?` | Interactive prompt configuration ([docs](./docs/interactive-prompts.md)) |
 
 ## Shell Completion
 
@@ -375,6 +377,7 @@ For detailed documentation, see the `docs/` directory:
 - [Getting Started](./docs/getting-started.md) - Installation and creating your first command
 - [Essentials](./docs/essentials.md) - Core concepts explained
 - [Advanced Features](./docs/advanced-features.md) - Subcommands, Discriminated Union
+- [Interactive Prompts](./docs/interactive-prompts.md) - Prompt for missing arguments interactively
 - [Recipes](./docs/recipes.md) - Testing, configuration, error handling
 - [API Reference](./docs/api-reference.md) - Detailed API reference
 - [Doc Generation](./docs/doc-generation.md) - Automatic documentation generation

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

@@ -1,5 +1,119 @@
 import { z } from "zod";
 
+//#region src/core/schema-extractor.d.ts
+/**
+ * Resolved metadata for an argument field
+ */
+interface ResolvedFieldMeta {
+  /** Field name (camelCase, as defined in schema) */
+  name: string;
+  /** CLI option name (kebab-case, for command line usage) */
+  cliName: string;
+  /** Short alias (e.g., 'v' for --verbose) */
+  alias?: string | undefined;
+  /** Argument description */
+  description?: string | undefined;
+  /** Whether this is a positional argument */
+  positional: boolean;
+  /** Placeholder for help display */
+  placeholder?: string | undefined;
+  /**
+   * Environment variable name(s) to read value from.
+   * If an array, earlier entries take priority.
+   */
+  env?: string | string[] | undefined;
+  /** Whether this argument is required */
+  required: boolean;
+  /** Default value if any */
+  defaultValue?: unknown;
+  /** Detected type from schema */
+  type: "string" | "number" | "boolean" | "array" | "unknown";
+  /** Original Zod schema */
+  schema: z.ZodType;
+  /** True if this overrides built-in aliases (-h, -H) */
+  overrideBuiltinAlias?: true;
+  /** Enum values if detected from schema (z.enum) */
+  enumValues?: string[] | undefined;
+  /** Completion metadata from arg() */
+  completion?: CompletionMeta | undefined;
+  /** Prompt metadata from arg() for interactive input */
+  prompt?: PromptMeta | undefined;
+  /** Side-effect callback from arg() metadata */
+  effect?: ((value: unknown, context: EffectContext) => void | PromiseLike<void>) | undefined;
+}
+/**
+ * Extracted fields from a schema
+ */
+interface ExtractedFields {
+  /** All field definitions */
+  fields: ResolvedFieldMeta[];
+  /** Original schema for validation */
+  schema: ArgsSchema;
+  /** Schema type */
+  schemaType: "object" | "discriminatedUnion" | "union" | "xor" | "intersection";
+  /** Discriminator key (for discriminatedUnion) */
+  discriminator?: string;
+  /** Variants (for discriminatedUnion) */
+  variants?: Array<{
+    discriminatorValue: string;
+    fields: ResolvedFieldMeta[];
+    description?: string;
+  }>;
+  /** Options (for union) */
+  unionOptions?: ExtractedFields[];
+  /** Schema description */
+  description?: string;
+  /**
+   * Unknown keys handling mode
+   * - "strict": Unknown keys cause validation errors (z.strictObject or z.object().strict())
+   * - "strip": Unknown keys trigger warnings (default, z.object())
+   * - "passthrough": Unknown keys are silently ignored (z.looseObject or z.object().passthrough())
+   */
+  unknownKeysMode: UnknownKeysMode;
+}
+/**
+ * Unknown keys handling mode for object schemas
+ * - "strict": Unknown keys cause validation errors
+ * - "strip": Unknown keys are silently ignored (default)
+ * - "passthrough": Unknown keys are passed through
+ */
+type UnknownKeysMode = "strict" | "strip" | "passthrough";
+/**
+ * Detect unknown keys handling mode from a Zod object schema
+ *
+ * In Zod v4:
+ * - Default (strip): _def.catchall is undefined
+ * - strict: _def.catchall is ZodNever (type = "never")
+ * - passthrough: _def.catchall is ZodUnknown (type = "unknown")
+ */
+declare function getUnknownKeysMode(schema: z.ZodType): UnknownKeysMode;
+/**
+ * Convert camelCase to kebab-case
+ * @example toKebabCase("dryRun") => "dry-run"
+ * @example toKebabCase("outputDir") => "output-dir"
+ * @example toKebabCase("XMLParser") => "xml-parser"
+ */
+declare function toKebabCase(str: string): string;
+/**
+ * Convert hyphen-separated sequences to camelCase.
+ *
+ * Replaces `-x` (hyphen followed by a lowercase letter) with the uppercase
+ * variant. Non-hyphenated input (e.g., already camelCase) is returned as-is.
+ *
+ * @param str - A string that may contain hyphens
+ * @example toCamelCase("dry-run") => "dryRun"
+ * @example toCamelCase("output-dir") => "outputDir"
+ * @example toCamelCase("dryRun") => "dryRun"
+ */
+declare function toCamelCase(str: string): string;
+/**
+ * Extract all fields from a schema
+ *
+ * @param schema - The args schema (ZodObject, ZodDiscriminatedUnion, etc.)
+ * @returns Extracted field information
+ */
+declare function extractFields(schema: ArgsSchema): ExtractedFields;
+//#endregion
 //#region src/lazy.d.ts
 /**
  * A lazily-loaded command that carries synchronous metadata for
@@ -184,6 +298,12 @@ type SubCommandValue = AnyCommand | (() => Promise<AnyCommand>) | LazyCommand;
  * Record of subcommands indexed by name
  */
 type SubCommandsRecord = Record<string, SubCommandValue>;
+/**
+ * Async callback to resolve missing argument values interactively.
+ * Called after env fallback, before Zod validation.
+ * Provided by adapter subpath modules (e.g. `politty/prompt/clack`).
+ */
+type PromptResolver = (rawArgs: Record<string, unknown>, extracted: ExtractedFields) => Promise<Record<string, unknown>>;
 /**
  * Options for runMain (CLI entry point)
  */
@@ -206,6 +326,8 @@ interface MainOptions {
   cleanup?: ((context: GlobalCleanupContext) => void | Promise<void>) | undefined;
   /** Whether to display errors to stderr before process.exit (default: true) */
   displayErrors?: boolean;
+  /** Prompt resolver for interactive missing-arg prompts (e.g. from `politty/prompt/clack`). */
+  prompt?: PromptResolver | undefined;
 }
 /**
  * Options for runCommand (programmatic/test usage)
@@ -225,6 +347,8 @@ interface RunCommandOptions {
   setup?: ((context: GlobalSetupContext) => void | Promise<void>) | undefined;
   /** Global cleanup hook (runs after command execution, always executes even on error) */
   cleanup?: ((context: GlobalCleanupContext) => void | Promise<void>) | undefined;
+  /** Prompt resolver for interactive missing-arg prompts (e.g. from `politty/prompt/clack`). */
+  prompt?: PromptResolver | undefined;
 }
 /**
  * Log level type
@@ -344,6 +468,52 @@ type CompletionMeta = {
   /** Glob patterns for file matching (only applies when type is "file") */matcher?: string[];
   extensions?: never;
 });
+/**
+ * Prompt input type for interactive prompts
+ *
+ * - "text": free-form text input (default for string schemas)
+ * - "password": masked text input
+ * - "confirm": yes/no prompt (default for boolean schemas)
+ * - "select": single selection from choices (default for enum schemas)
+ * - "file": file path input (inherited from completion type)
+ * - "directory": directory path input (inherited from completion type)
+ */
+type PromptType = "text" | "password" | "confirm" | "select" | "file" | "directory";
+/**
+ * Prompt metadata for interactive input when a value is missing.
+ * Used by the `politty/prompt` module to request user input for unresolved arguments.
+ *
+ * @example
+ * ```ts
+ * // Custom prompt message
+ * name: arg(z.string(), {
+ *   prompt: { message: "What is your name?" }
+ * })
+ *
+ * // Password input (masked)
+ * token: arg(z.string(), {
+ *   prompt: { type: "password", message: "Enter API token" }
+ * })
+ *
+ * // Select with custom choices
+ * region: arg(z.string(), {
+ *   prompt: { choices: ["us-east-1", "eu-west-1", "ap-northeast-1"] }
+ * })
+ * ```
+ */
+interface PromptMeta {
+  /** Prompt message shown to the user. Defaults to the field's description or name. */
+  message?: string;
+  /** Explicit prompt type. Overrides auto-detection from schema/completion. */
+  type?: PromptType;
+  /** Choices for select prompt. Overrides enum values from schema. */
+  choices?: Array<string | {
+    label: string;
+    value: string;
+  }>;
+  /** Whether to enable prompting for this field (default: true when prompt is set) */
+  enabled?: boolean;
+}
 /**
  * Context provided to effect callbacks.
  * When GlobalArgs is extended via declaration merging, `globalArgs` is typed accordingly.
@@ -383,6 +553,20 @@ interface BaseArgMeta<TValue = unknown> {
   env?: string | string[];
   /** Completion configuration for shell tab-completion */
   completion?: CompletionMeta;
+  /**
+   * Interactive prompt configuration for missing values.
+   * When set, the `politty/prompt` module will prompt the user interactively
+   * if this argument is not provided via CLI args or environment variables.
+   *
+   * @example
+   * ```ts
+   * name: arg(z.string(), {
+   *   description: "User name",
+   *   prompt: { message: "What is your name?" },
+   * })
+   * ```
+   */
+  prompt?: PromptMeta;
   /**
    * Side-effect callback executed after argument parsing and validation.
    * Runs before the command lifecycle (setup/run/cleanup).
@@ -457,5 +641,5 @@ type ValidateArgMeta<M> = M extends {
 declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M>): T;
 //#endregion
-export { SubCommandValue as A, NonRunnableCommand as C, RunResultSuccess as D, RunResultFailure as E, LazyCommand as M, isLazyCommand as N, RunnableCommand as O, lazy as P, MainOptions as S, RunResult as T, IsEmpty as _, EffectContext as a, LogStream as b, ArgsSchema as c, Command as d, CommandBase as f, GlobalSetupContext as g, GlobalCleanupContext as h, CustomCompletion as i, SubCommandsRecord as j, SetupContext as k, CleanupContext as l, GlobalArgs as m, CompletionMeta as n, arg as o, Example as p, CompletionType as r, AnyCommand as s, ArgMeta as t, CollectedLogs as u, LogEntry as v, RunCommandOptions as w, Logger as x, LogLevel as y };
-//# sourceMappingURL=arg-registry-BlXeCM4p.d.cts.map
+export { RunResultSuccess as A, UnknownKeysMode as B, Logger as C, RunCommandOptions as D, PromptResolver as E, LazyCommand as F, getUnknownKeysMode as H, isLazyCommand as I, lazy as L, SetupContext as M, SubCommandValue as N, RunResult as O, SubCommandsRecord as P, ExtractedFields as R, LogStream as S, NonRunnableCommand as T, toCamelCase as U, extractFields as V, toKebabCase as W, GlobalCleanupContext as _, EffectContext as a, LogEntry as b, arg as c, CleanupContext as d, CollectedLogs as f, GlobalArgs as g, Example as h, CustomCompletion as i, RunnableCommand as j, RunResultFailure as k, AnyCommand as l, CommandBase as m, CompletionMeta as n, PromptMeta as o, Command as p, CompletionType as r, PromptType as s, ArgMeta as t, ArgsSchema as u, GlobalSetupContext as v, MainOptions as w, LogLevel as x, IsEmpty as y, ResolvedFieldMeta as z };
+//# sourceMappingURL=arg-registry-6E4C5MTC.d.ts.map

package/dist/arg-registry-6E4C5MTC.d.ts.map

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

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

@@ -1,5 +1,119 @@
 import { z } from "zod";
 
+//#region src/core/schema-extractor.d.ts
+/**
+ * Resolved metadata for an argument field
+ */
+interface ResolvedFieldMeta {
+  /** Field name (camelCase, as defined in schema) */
+  name: string;
+  /** CLI option name (kebab-case, for command line usage) */
+  cliName: string;
+  /** Short alias (e.g., 'v' for --verbose) */
+  alias?: string | undefined;
+  /** Argument description */
+  description?: string | undefined;
+  /** Whether this is a positional argument */
+  positional: boolean;
+  /** Placeholder for help display */
+  placeholder?: string | undefined;
+  /**
+   * Environment variable name(s) to read value from.
+   * If an array, earlier entries take priority.
+   */
+  env?: string | string[] | undefined;
+  /** Whether this argument is required */
+  required: boolean;
+  /** Default value if any */
+  defaultValue?: unknown;
+  /** Detected type from schema */
+  type: "string" | "number" | "boolean" | "array" | "unknown";
+  /** Original Zod schema */
+  schema: z.ZodType;
+  /** True if this overrides built-in aliases (-h, -H) */
+  overrideBuiltinAlias?: true;
+  /** Enum values if detected from schema (z.enum) */
+  enumValues?: string[] | undefined;
+  /** Completion metadata from arg() */
+  completion?: CompletionMeta | undefined;
+  /** Prompt metadata from arg() for interactive input */
+  prompt?: PromptMeta | undefined;
+  /** Side-effect callback from arg() metadata */
+  effect?: ((value: unknown, context: EffectContext) => void | PromiseLike<void>) | undefined;
+}
+/**
+ * Extracted fields from a schema
+ */
+interface ExtractedFields {
+  /** All field definitions */
+  fields: ResolvedFieldMeta[];
+  /** Original schema for validation */
+  schema: ArgsSchema;
+  /** Schema type */
+  schemaType: "object" | "discriminatedUnion" | "union" | "xor" | "intersection";
+  /** Discriminator key (for discriminatedUnion) */
+  discriminator?: string;
+  /** Variants (for discriminatedUnion) */
+  variants?: Array<{
+    discriminatorValue: string;
+    fields: ResolvedFieldMeta[];
+    description?: string;
+  }>;
+  /** Options (for union) */
+  unionOptions?: ExtractedFields[];
+  /** Schema description */
+  description?: string;
+  /**
+   * Unknown keys handling mode
+   * - "strict": Unknown keys cause validation errors (z.strictObject or z.object().strict())
+   * - "strip": Unknown keys trigger warnings (default, z.object())
+   * - "passthrough": Unknown keys are silently ignored (z.looseObject or z.object().passthrough())
+   */
+  unknownKeysMode: UnknownKeysMode;
+}
+/**
+ * Unknown keys handling mode for object schemas
+ * - "strict": Unknown keys cause validation errors
+ * - "strip": Unknown keys are silently ignored (default)
+ * - "passthrough": Unknown keys are passed through
+ */
+type UnknownKeysMode = "strict" | "strip" | "passthrough";
+/**
+ * Detect unknown keys handling mode from a Zod object schema
+ *
+ * In Zod v4:
+ * - Default (strip): _def.catchall is undefined
+ * - strict: _def.catchall is ZodNever (type = "never")
+ * - passthrough: _def.catchall is ZodUnknown (type = "unknown")
+ */
+declare function getUnknownKeysMode(schema: z.ZodType): UnknownKeysMode;
+/**
+ * Convert camelCase to kebab-case
+ * @example toKebabCase("dryRun") => "dry-run"
+ * @example toKebabCase("outputDir") => "output-dir"
+ * @example toKebabCase("XMLParser") => "xml-parser"
+ */
+declare function toKebabCase(str: string): string;
+/**
+ * Convert hyphen-separated sequences to camelCase.
+ *
+ * Replaces `-x` (hyphen followed by a lowercase letter) with the uppercase
+ * variant. Non-hyphenated input (e.g., already camelCase) is returned as-is.
+ *
+ * @param str - A string that may contain hyphens
+ * @example toCamelCase("dry-run") => "dryRun"
+ * @example toCamelCase("output-dir") => "outputDir"
+ * @example toCamelCase("dryRun") => "dryRun"
+ */
+declare function toCamelCase(str: string): string;
+/**
+ * Extract all fields from a schema
+ *
+ * @param schema - The args schema (ZodObject, ZodDiscriminatedUnion, etc.)
+ * @returns Extracted field information
+ */
+declare function extractFields(schema: ArgsSchema): ExtractedFields;
+//#endregion
 //#region src/lazy.d.ts
 /**
  * A lazily-loaded command that carries synchronous metadata for
@@ -184,6 +298,12 @@ type SubCommandValue = AnyCommand | (() => Promise<AnyCommand>) | LazyCommand;
  * Record of subcommands indexed by name
  */
 type SubCommandsRecord = Record<string, SubCommandValue>;
+/**
+ * Async callback to resolve missing argument values interactively.
+ * Called after env fallback, before Zod validation.
+ * Provided by adapter subpath modules (e.g. `politty/prompt/clack`).
+ */
+type PromptResolver = (rawArgs: Record<string, unknown>, extracted: ExtractedFields) => Promise<Record<string, unknown>>;
 /**
  * Options for runMain (CLI entry point)
  */
@@ -206,6 +326,8 @@ interface MainOptions {
   cleanup?: ((context: GlobalCleanupContext) => void | Promise<void>) | undefined;
   /** Whether to display errors to stderr before process.exit (default: true) */
   displayErrors?: boolean;
+  /** Prompt resolver for interactive missing-arg prompts (e.g. from `politty/prompt/clack`). */
+  prompt?: PromptResolver | undefined;
 }
 /**
  * Options for runCommand (programmatic/test usage)
@@ -225,6 +347,8 @@ interface RunCommandOptions {
   setup?: ((context: GlobalSetupContext) => void | Promise<void>) | undefined;
   /** Global cleanup hook (runs after command execution, always executes even on error) */
   cleanup?: ((context: GlobalCleanupContext) => void | Promise<void>) | undefined;
+  /** Prompt resolver for interactive missing-arg prompts (e.g. from `politty/prompt/clack`). */
+  prompt?: PromptResolver | undefined;
 }
 /**
  * Log level type
@@ -344,6 +468,52 @@ type CompletionMeta = {
   /** Glob patterns for file matching (only applies when type is "file") */matcher?: string[];
   extensions?: never;
 });
+/**
+ * Prompt input type for interactive prompts
+ *
+ * - "text": free-form text input (default for string schemas)
+ * - "password": masked text input
+ * - "confirm": yes/no prompt (default for boolean schemas)
+ * - "select": single selection from choices (default for enum schemas)
+ * - "file": file path input (inherited from completion type)
+ * - "directory": directory path input (inherited from completion type)
+ */
+type PromptType = "text" | "password" | "confirm" | "select" | "file" | "directory";
+/**
+ * Prompt metadata for interactive input when a value is missing.
+ * Used by the `politty/prompt` module to request user input for unresolved arguments.
+ *
+ * @example
+ * ```ts
+ * // Custom prompt message
+ * name: arg(z.string(), {
+ *   prompt: { message: "What is your name?" }
+ * })
+ *
+ * // Password input (masked)
+ * token: arg(z.string(), {
+ *   prompt: { type: "password", message: "Enter API token" }
+ * })
+ *
+ * // Select with custom choices
+ * region: arg(z.string(), {
+ *   prompt: { choices: ["us-east-1", "eu-west-1", "ap-northeast-1"] }
+ * })
+ * ```
+ */
+interface PromptMeta {
+  /** Prompt message shown to the user. Defaults to the field's description or name. */
+  message?: string;
+  /** Explicit prompt type. Overrides auto-detection from schema/completion. */
+  type?: PromptType;
+  /** Choices for select prompt. Overrides enum values from schema. */
+  choices?: Array<string | {
+    label: string;
+    value: string;
+  }>;
+  /** Whether to enable prompting for this field (default: true when prompt is set) */
+  enabled?: boolean;
+}
 /**
  * Context provided to effect callbacks.
  * When GlobalArgs is extended via declaration merging, `globalArgs` is typed accordingly.
@@ -383,6 +553,20 @@ interface BaseArgMeta<TValue = unknown> {
   env?: string | string[];
   /** Completion configuration for shell tab-completion */
   completion?: CompletionMeta;
+  /**
+   * Interactive prompt configuration for missing values.
+   * When set, the `politty/prompt` module will prompt the user interactively
+   * if this argument is not provided via CLI args or environment variables.
+   *
+   * @example
+   * ```ts
+   * name: arg(z.string(), {
+   *   description: "User name",
+   *   prompt: { message: "What is your name?" },
+   * })
+   * ```
+   */
+  prompt?: PromptMeta;
   /**
    * Side-effect callback executed after argument parsing and validation.
    * Runs before the command lifecycle (setup/run/cleanup).
@@ -457,5 +641,5 @@ type ValidateArgMeta<M> = M extends {
 declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M>): T;
 //#endregion
-export { SubCommandValue as A, NonRunnableCommand as C, RunResultSuccess as D, RunResultFailure as E, LazyCommand as M, isLazyCommand as N, RunnableCommand as O, lazy as P, MainOptions as S, RunResult as T, IsEmpty as _, EffectContext as a, LogStream as b, ArgsSchema as c, Command as d, CommandBase as f, GlobalSetupContext as g, GlobalCleanupContext as h, CustomCompletion as i, SubCommandsRecord as j, SetupContext as k, CleanupContext as l, GlobalArgs as m, CompletionMeta as n, arg as o, Example as p, CompletionType as r, AnyCommand as s, ArgMeta as t, CollectedLogs as u, LogEntry as v, RunCommandOptions as w, Logger as x, LogLevel as y };
-//# sourceMappingURL=arg-registry-D0MimRYf.d.ts.map
+export { RunResultSuccess as A, UnknownKeysMode as B, Logger as C, RunCommandOptions as D, PromptResolver as E, LazyCommand as F, getUnknownKeysMode as H, isLazyCommand as I, lazy as L, SetupContext as M, SubCommandValue as N, RunResult as O, SubCommandsRecord as P, ExtractedFields as R, LogStream as S, NonRunnableCommand as T, toCamelCase as U, extractFields as V, toKebabCase as W, GlobalCleanupContext as _, EffectContext as a, LogEntry as b, arg as c, CleanupContext as d, CollectedLogs as f, GlobalArgs as g, Example as h, CustomCompletion as i, RunnableCommand as j, RunResultFailure as k, AnyCommand as l, CommandBase as m, CompletionMeta as n, PromptMeta as o, Command as p, CompletionType as r, PromptType as s, ArgMeta as t, ArgsSchema as u, GlobalSetupContext as v, MainOptions as w, LogLevel as x, IsEmpty as y, ResolvedFieldMeta as z };
+//# sourceMappingURL=arg-registry-CeIRoLaB.d.cts.map

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

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

package/dist/augment.d.cts

@@ -1,4 +1,4 @@
-import { t as ArgMeta } from "./arg-registry-BlXeCM4p.cjs";
+import { t as ArgMeta } from "./arg-registry-CeIRoLaB.cjs";
 
 //#region src/augment.d.ts
 declare module "zod" {

package/dist/augment.d.ts

@@ -1,4 +1,4 @@
-import { t as ArgMeta } from "./arg-registry-D0MimRYf.js";
+import { t as ArgMeta } from "./arg-registry-6E4C5MTC.js";
 
 //#region src/augment.d.ts
 declare module "zod" {

package/dist/completion/index.cjs

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

package/dist/completion/index.d.cts

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

package/dist/completion/index.d.ts

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

package/dist/completion/index.js

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

package/dist/{completion-BADAzqT9.cjs → completion-D3LUac1o.cjs}

@@ -1,5 +1,5 @@
-const require_subcommand_router = require('./subcommand-router-BTOzDQnY.cjs');
-const require_lazy = require('./lazy-B_E2X0KR.cjs');
+const require_subcommand_router = require('./subcommand-router-BnHpqyRk.cjs');
+const require_lazy = require('./lazy-qPy4cMnv.cjs');
 let zod = require("zod");
 let node_child_process = require("node:child_process");
 
@@ -1872,4 +1872,4 @@ Object.defineProperty(exports, 'withCompletionCommand', {
     return withCompletionCommand;
   }
 });
-//# sourceMappingURL=completion-BADAzqT9.cjs.map
+//# sourceMappingURL=completion-D3LUac1o.cjs.map