politty 0.4.12 → 0.4.14

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

@@ -0,0 +1,34 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_subcommand_router = require('../../subcommand-router-C9ONv6Nq.cjs');
+const require_prompt = require('../../prompt-aXfSf27y.cjs');
+let _clack_prompts = require("@clack/prompts");
+
+//#region src/prompt/clack/index.ts
+function createClackAdapter() {
+	return {
+		text: (config) => (0, _clack_prompts.text)({
+			message: config.message,
+			...config.placeholder !== void 0 && { placeholder: config.placeholder }
+		}),
+		password: (config) => (0, _clack_prompts.password)(config),
+		confirm: (config) => (0, _clack_prompts.confirm)(config),
+		select: (config) => (0, _clack_prompts.select)(config),
+		isCancelled: _clack_prompts.isCancel
+	};
+}
+/**
+* Prompt resolver backed by @clack/prompts.
+*
+* @example
+* ```ts
+* import { runMain, defineCommand } from "politty";
+* import { prompt } from "politty/prompt/clack";
+*
+* runMain(cmd, { version: "1.0.0", prompt });
+* ```
+*/
+const prompt = (rawArgs, extracted) => require_prompt.promptMissingArgs(rawArgs, extracted, { adapter: createClackAdapter() });
+
+//#endregion
+exports.prompt = prompt;
+//# sourceMappingURL=index.cjs.map

package/dist/prompt/clack/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["isCancel","promptMissingArgs"],"sources":["../../../src/prompt/clack/index.ts"],"sourcesContent":["import { confirm, isCancel, password, select, text } from \"@clack/prompts\";\nimport type { PromptResolver } from \"../../types.js\";\nimport { promptMissingArgs } from \"../index.js\";\nimport type { PromptAdapter } from \"../types.js\";\n\nfunction createClackAdapter(): PromptAdapter {\n  return {\n    text: (config) =>\n      text({\n        message: config.message,\n        ...(config.placeholder !== undefined && { placeholder: config.placeholder }),\n      }),\n    password: (config) => password(config),\n    confirm: (config) => confirm(config),\n    select: (config) => select(config),\n    isCancelled: isCancel,\n  };\n}\n\n/**\n * Prompt resolver backed by @clack/prompts.\n *\n * @example\n * ```ts\n * import { runMain, defineCommand } from \"politty\";\n * import { prompt } from \"politty/prompt/clack\";\n *\n * runMain(cmd, { version: \"1.0.0\", prompt });\n * ```\n */\nexport const prompt: PromptResolver = (rawArgs, extracted) =>\n  promptMissingArgs(rawArgs, extracted, { adapter: createClackAdapter() });\n"],"mappings":";;;;;;AAKA,SAAS,qBAAoC;AAC3C,QAAO;EACL,OAAO,oCACA;GACH,SAAS,OAAO;GAChB,GAAI,OAAO,gBAAgB,UAAa,EAAE,aAAa,OAAO,aAAa;GAC5E,CAAC;EACJ,WAAW,wCAAoB,OAAO;EACtC,UAAU,uCAAmB,OAAO;EACpC,SAAS,sCAAkB,OAAO;EAClC,aAAaA;EACd;;;;;;;;;;;;;AAcH,MAAa,UAA0B,SAAS,cAC9CC,iCAAkB,SAAS,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC"}

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

@@ -0,0 +1,18 @@
+import { E as PromptResolver } from "../../arg-registry-r5wYN6qd.cjs";
+
+//#region src/prompt/clack/index.d.ts
+/**
+ * Prompt resolver backed by @clack/prompts.
+ *
+ * @example
+ * ```ts
+ * import { runMain, defineCommand } from "politty";
+ * import { prompt } from "politty/prompt/clack";
+ *
+ * runMain(cmd, { version: "1.0.0", prompt });
+ * ```
+ */
+declare const prompt: PromptResolver;
+//#endregion
+export { prompt };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/prompt/clack/index.ts"],"mappings":";;;;;AA8BA;;;;;;;;;cAAa,MAAA,EAAQ,cAAA"}

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

@@ -0,0 +1,18 @@
+import { E as PromptResolver } from "../../arg-registry-CkPDokIu.js";
+
+//#region src/prompt/clack/index.d.ts
+/**
+ * Prompt resolver backed by @clack/prompts.
+ *
+ * @example
+ * ```ts
+ * import { runMain, defineCommand } from "politty";
+ * import { prompt } from "politty/prompt/clack";
+ *
+ * runMain(cmd, { version: "1.0.0", prompt });
+ * ```
+ */
+declare const prompt: PromptResolver;
+//#endregion
+export { prompt };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/prompt/clack/index.ts"],"mappings":";;;;;AA8BA;;;;;;;;;cAAa,MAAA,EAAQ,cAAA"}

package/dist/prompt/clack/index.js

@@ -0,0 +1,32 @@
+import { t as promptMissingArgs } from "../../prompt-BKHqGrFw.js";
+import { confirm, isCancel, password, select, text } from "@clack/prompts";
+
+//#region src/prompt/clack/index.ts
+function createClackAdapter() {
+	return {
+		text: (config) => text({
+			message: config.message,
+			...config.placeholder !== void 0 && { placeholder: config.placeholder }
+		}),
+		password: (config) => password(config),
+		confirm: (config) => confirm(config),
+		select: (config) => select(config),
+		isCancelled: isCancel
+	};
+}
+/**
+* Prompt resolver backed by @clack/prompts.
+*
+* @example
+* ```ts
+* import { runMain, defineCommand } from "politty";
+* import { prompt } from "politty/prompt/clack";
+*
+* runMain(cmd, { version: "1.0.0", prompt });
+* ```
+*/
+const prompt = (rawArgs, extracted) => promptMissingArgs(rawArgs, extracted, { adapter: createClackAdapter() });
+
+//#endregion
+export { prompt };
+//# sourceMappingURL=index.js.map

package/dist/prompt/clack/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/prompt/clack/index.ts"],"sourcesContent":["import { confirm, isCancel, password, select, text } from \"@clack/prompts\";\nimport type { PromptResolver } from \"../../types.js\";\nimport { promptMissingArgs } from \"../index.js\";\nimport type { PromptAdapter } from \"../types.js\";\n\nfunction createClackAdapter(): PromptAdapter {\n  return {\n    text: (config) =>\n      text({\n        message: config.message,\n        ...(config.placeholder !== undefined && { placeholder: config.placeholder }),\n      }),\n    password: (config) => password(config),\n    confirm: (config) => confirm(config),\n    select: (config) => select(config),\n    isCancelled: isCancel,\n  };\n}\n\n/**\n * Prompt resolver backed by @clack/prompts.\n *\n * @example\n * ```ts\n * import { runMain, defineCommand } from \"politty\";\n * import { prompt } from \"politty/prompt/clack\";\n *\n * runMain(cmd, { version: \"1.0.0\", prompt });\n * ```\n */\nexport const prompt: PromptResolver = (rawArgs, extracted) =>\n  promptMissingArgs(rawArgs, extracted, { adapter: createClackAdapter() });\n"],"mappings":";;;;AAKA,SAAS,qBAAoC;AAC3C,QAAO;EACL,OAAO,WACL,KAAK;GACH,SAAS,OAAO;GAChB,GAAI,OAAO,gBAAgB,UAAa,EAAE,aAAa,OAAO,aAAa;GAC5E,CAAC;EACJ,WAAW,WAAW,SAAS,OAAO;EACtC,UAAU,WAAW,QAAQ,OAAO;EACpC,SAAS,WAAW,OAAO,OAAO;EAClC,aAAa;EACd;;;;;;;;;;;;;AAcH,MAAa,UAA0B,SAAS,cAC9C,kBAAkB,SAAS,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC"}

package/dist/prompt/index.cjs

@@ -0,0 +1,7 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_prompt = require('../prompt-aXfSf27y.cjs');
+
+exports.getFieldsToPrompt = require_prompt.getFieldsToPrompt;
+exports.isInteractive = require_prompt.isInteractive;
+exports.promptMissingArgs = require_prompt.promptMissingArgs;
+exports.resolvePromptConfig = require_prompt.resolvePromptConfig;

package/dist/prompt/index.d.cts

@@ -0,0 +1,108 @@
+import { R as ExtractedFields, z as ResolvedFieldMeta } from "../arg-registry-r5wYN6qd.cjs";
+
+//#region src/prompt/types.d.ts
+/**
+ * Resolved prompt configuration for a single field
+ */
+interface ResolvedPromptConfig {
+  /** Field metadata */
+  field: ResolvedFieldMeta;
+  /** Resolved prompt type */
+  type: "text" | "password" | "confirm" | "select";
+  /** Message to display to the user */
+  message: string;
+  /** Choices for select prompts */
+  choices?: Array<{
+    label: string;
+    value: string;
+  }>;
+}
+/**
+ * Adapter interface for prompt rendering.
+ * Implement this to use a custom prompt library instead of the default @clack/prompts.
+ */
+interface PromptAdapter {
+  /** Prompt for free-form text input */
+  text(config: {
+    message: string;
+    placeholder?: string | undefined;
+  }): Promise<string | symbol>;
+  /** Prompt for masked text input */
+  password(config: {
+    message: string;
+  }): Promise<string | symbol>;
+  /** Prompt for yes/no confirmation */
+  confirm(config: {
+    message: string;
+  }): Promise<boolean | symbol>;
+  /** Prompt for single selection from options */
+  select(config: {
+    message: string;
+    options: Array<{
+      label: string;
+      value: string;
+    }>;
+  }): Promise<string | symbol>;
+  /** Check if a prompt result indicates user cancellation */
+  isCancelled(value: unknown): boolean;
+}
+//#endregion
+//#region src/prompt/prompt-resolver.d.ts
+/**
+ * Resolve prompt configuration for a field.
+ *
+ * Priority for prompt type:
+ * 1. Explicit type from prompt.type
+ * 2. Explicit choices from prompt.choices (forces "select")
+ * 3. Inherited from completion metadata (file/directory -> "text")
+ * 4. Auto-detected from Zod schema type:
+ *    - enum (has enumValues) -> "select"
+ *    - boolean -> "confirm"
+ *    - string/number/unknown -> "text"
+ *
+ * Returns null if the field has no prompt metadata or prompting is disabled.
+ */
+declare function resolvePromptConfig(field: ResolvedFieldMeta): ResolvedPromptConfig | null;
+/**
+ * Filter fields that need prompting (missing value + prompt configured).
+ *
+ * For discriminatedUnion schemas, variant-aware narrowing is handled by the
+ * caller (promptMissingArgs) which prompts the discriminator first and then
+ * passes only the active variant's fields. For plain union schemas, this
+ * iterates all fields across every variant without narrowing.
+ *
+ * Fields with Zod defaults that also have prompt metadata will be prompted
+ * when the raw value is undefined. This is intentional: `prompt: {}` is an
+ * explicit opt-in to interactive input. Omit prompt metadata to let the
+ * default apply silently.
+ */
+declare function getFieldsToPrompt(fields: ResolvedFieldMeta[], rawArgs: Record<string, unknown>): ResolvedPromptConfig[];
+//#endregion
+//#region src/prompt/tty-detector.d.ts
+/**
+ * Detect whether the current environment supports interactive prompts.
+ * Returns false in CI, piped input, or non-TTY environments.
+ */
+declare function isInteractive(): boolean;
+//#endregion
+//#region src/prompt/index.d.ts
+/**
+ * Options for promptMissingArgs behavior
+ */
+interface PromptOptions {
+  /** Prompt adapter to use for rendering prompts */
+  adapter: PromptAdapter;
+  /** Override interactive detection (force enable/disable prompts) */
+  interactive?: boolean;
+}
+/**
+ * Prompt for missing argument values interactively.
+ *
+ * Only prompts for fields that have `prompt` metadata set via `arg()` and
+ * whose values are still undefined after CLI and env resolution.
+ * Returns rawArgs unchanged in non-interactive environments.
+ */
+declare function promptMissingArgs(rawArgs: Record<string, unknown>, extracted: ExtractedFields, options: PromptOptions): Promise<Record<string, unknown>>;
+//#endregion
+export { type PromptAdapter, PromptOptions, type ResolvedPromptConfig, getFieldsToPrompt, isInteractive, promptMissingArgs, resolvePromptConfig };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/prompt/types.ts","../../src/prompt/prompt-resolver.ts","../../src/prompt/tty-detector.ts","../../src/prompt/index.ts"],"mappings":";;;;;AAKA;UAAiB,oBAAA;;EAEf,KAAA,EAAO,iBAAA;EAAP;EAEA,IAAA;EAAA;EAEA,OAAA;EAEA;EAAA,OAAA,GAAU,KAAA;IAAQ,KAAA;IAAe,KAAA;EAAA;AAAA;AAOnC;;;;AAAA,UAAiB,aAAA;EAMuB;EAJtC,IAAA,CAAK,MAAA;IAAU,OAAA;IAAiB,WAAA;EAAA,IAAqC,OAAA;EAArE;EAEA,QAAA,CAAS,MAAA;IAAU,OAAA;EAAA,IAAoB,OAAA;EAF8B;EAIrE,OAAA,CAAQ,MAAA;IAAU,OAAA;EAAA,IAAoB,OAAA;EAFC;EAIvC,MAAA,CAAO,MAAA;IACL,OAAA;IACA,OAAA,EAAS,KAAA;MAAQ,KAAA;MAAe,KAAA;IAAA;EAAA,IAC9B,OAAA;EADO;EAGX,WAAA,CAAY,KAAA;AAAA;;;;AA5Bd;;;;;;;;;;;;;iBCYgB,mBAAA,CAAoB,KAAA,EAAO,iBAAA,GAAoB,oBAAA;ADG/D;;;;;;;;;;;;;AAAA,iBC+DgB,iBAAA,CACd,MAAA,EAAQ,iBAAA,IACR,OAAA,EAAS,MAAA,oBACR,oBAAA;;;;;;ADjFH;iBEDgB,aAAA,CAAA;;;;;;UCQC,aAAA;EHHf;EGKA,OAAA,EAAS,aAAA;EHDT;EGGA,WAAA;AAAA;;;;AHIF;;;;iBGMsB,iBAAA,CACpB,OAAA,EAAS,MAAA,mBACT,SAAA,EAAW,eAAA,EACX,OAAA,EAAS,aAAA,GACR,OAAA,CAAQ,MAAA"}

package/dist/prompt/index.d.ts

@@ -0,0 +1,108 @@
+import { R as ExtractedFields, z as ResolvedFieldMeta } from "../arg-registry-CkPDokIu.js";
+
+//#region src/prompt/types.d.ts
+/**
+ * Resolved prompt configuration for a single field
+ */
+interface ResolvedPromptConfig {
+  /** Field metadata */
+  field: ResolvedFieldMeta;
+  /** Resolved prompt type */
+  type: "text" | "password" | "confirm" | "select";
+  /** Message to display to the user */
+  message: string;
+  /** Choices for select prompts */
+  choices?: Array<{
+    label: string;
+    value: string;
+  }>;
+}
+/**
+ * Adapter interface for prompt rendering.
+ * Implement this to use a custom prompt library instead of the default @clack/prompts.
+ */
+interface PromptAdapter {
+  /** Prompt for free-form text input */
+  text(config: {
+    message: string;
+    placeholder?: string | undefined;
+  }): Promise<string | symbol>;
+  /** Prompt for masked text input */
+  password(config: {
+    message: string;
+  }): Promise<string | symbol>;
+  /** Prompt for yes/no confirmation */
+  confirm(config: {
+    message: string;
+  }): Promise<boolean | symbol>;
+  /** Prompt for single selection from options */
+  select(config: {
+    message: string;
+    options: Array<{
+      label: string;
+      value: string;
+    }>;
+  }): Promise<string | symbol>;
+  /** Check if a prompt result indicates user cancellation */
+  isCancelled(value: unknown): boolean;
+}
+//#endregion
+//#region src/prompt/prompt-resolver.d.ts
+/**
+ * Resolve prompt configuration for a field.
+ *
+ * Priority for prompt type:
+ * 1. Explicit type from prompt.type
+ * 2. Explicit choices from prompt.choices (forces "select")
+ * 3. Inherited from completion metadata (file/directory -> "text")
+ * 4. Auto-detected from Zod schema type:
+ *    - enum (has enumValues) -> "select"
+ *    - boolean -> "confirm"
+ *    - string/number/unknown -> "text"
+ *
+ * Returns null if the field has no prompt metadata or prompting is disabled.
+ */
+declare function resolvePromptConfig(field: ResolvedFieldMeta): ResolvedPromptConfig | null;
+/**
+ * Filter fields that need prompting (missing value + prompt configured).
+ *
+ * For discriminatedUnion schemas, variant-aware narrowing is handled by the
+ * caller (promptMissingArgs) which prompts the discriminator first and then
+ * passes only the active variant's fields. For plain union schemas, this
+ * iterates all fields across every variant without narrowing.
+ *
+ * Fields with Zod defaults that also have prompt metadata will be prompted
+ * when the raw value is undefined. This is intentional: `prompt: {}` is an
+ * explicit opt-in to interactive input. Omit prompt metadata to let the
+ * default apply silently.
+ */
+declare function getFieldsToPrompt(fields: ResolvedFieldMeta[], rawArgs: Record<string, unknown>): ResolvedPromptConfig[];
+//#endregion
+//#region src/prompt/tty-detector.d.ts
+/**
+ * Detect whether the current environment supports interactive prompts.
+ * Returns false in CI, piped input, or non-TTY environments.
+ */
+declare function isInteractive(): boolean;
+//#endregion
+//#region src/prompt/index.d.ts
+/**
+ * Options for promptMissingArgs behavior
+ */
+interface PromptOptions {
+  /** Prompt adapter to use for rendering prompts */
+  adapter: PromptAdapter;
+  /** Override interactive detection (force enable/disable prompts) */
+  interactive?: boolean;
+}
+/**
+ * Prompt for missing argument values interactively.
+ *
+ * Only prompts for fields that have `prompt` metadata set via `arg()` and
+ * whose values are still undefined after CLI and env resolution.
+ * Returns rawArgs unchanged in non-interactive environments.
+ */
+declare function promptMissingArgs(rawArgs: Record<string, unknown>, extracted: ExtractedFields, options: PromptOptions): Promise<Record<string, unknown>>;
+//#endregion
+export { type PromptAdapter, PromptOptions, type ResolvedPromptConfig, getFieldsToPrompt, isInteractive, promptMissingArgs, resolvePromptConfig };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/prompt/types.ts","../../src/prompt/prompt-resolver.ts","../../src/prompt/tty-detector.ts","../../src/prompt/index.ts"],"mappings":";;;;;AAKA;UAAiB,oBAAA;;EAEf,KAAA,EAAO,iBAAA;EAAP;EAEA,IAAA;EAAA;EAEA,OAAA;EAEA;EAAA,OAAA,GAAU,KAAA;IAAQ,KAAA;IAAe,KAAA;EAAA;AAAA;AAOnC;;;;AAAA,UAAiB,aAAA;EAMuB;EAJtC,IAAA,CAAK,MAAA;IAAU,OAAA;IAAiB,WAAA;EAAA,IAAqC,OAAA;EAArE;EAEA,QAAA,CAAS,MAAA;IAAU,OAAA;EAAA,IAAoB,OAAA;EAF8B;EAIrE,OAAA,CAAQ,MAAA;IAAU,OAAA;EAAA,IAAoB,OAAA;EAFC;EAIvC,MAAA,CAAO,MAAA;IACL,OAAA;IACA,OAAA,EAAS,KAAA;MAAQ,KAAA;MAAe,KAAA;IAAA;EAAA,IAC9B,OAAA;EADO;EAGX,WAAA,CAAY,KAAA;AAAA;;;;AA5Bd;;;;;;;;;;;;;iBCYgB,mBAAA,CAAoB,KAAA,EAAO,iBAAA,GAAoB,oBAAA;ADG/D;;;;;;;;;;;;;AAAA,iBC+DgB,iBAAA,CACd,MAAA,EAAQ,iBAAA,IACR,OAAA,EAAS,MAAA,oBACR,oBAAA;;;;;;ADjFH;iBEDgB,aAAA,CAAA;;;;;;UCQC,aAAA;EHHf;EGKA,OAAA,EAAS,aAAA;EHDT;EGGA,WAAA;AAAA;;;;AHIF;;;;iBGMsB,iBAAA,CACpB,OAAA,EAAS,MAAA,mBACT,SAAA,EAAW,eAAA,EACX,OAAA,EAAS,aAAA,GACR,OAAA,CAAQ,MAAA"}

package/dist/prompt/index.js

@@ -0,0 +1,3 @@
+import { i as resolvePromptConfig, n as isInteractive, r as getFieldsToPrompt, t as promptMissingArgs } from "../prompt-BKHqGrFw.js";
+
+export { getFieldsToPrompt, isInteractive, promptMissingArgs, resolvePromptConfig };

package/dist/prompt/inquirer/index.cjs

@@ -0,0 +1,49 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_subcommand_router = require('../../subcommand-router-C9ONv6Nq.cjs');
+const require_prompt = require('../../prompt-aXfSf27y.cjs');
+let _inquirer_prompts = require("@inquirer/prompts");
+
+//#region src/prompt/inquirer/index.ts
+const cancelSymbol = Symbol("inquirer-cancel");
+async function wrapCancellation(fn) {
+	try {
+		return await fn();
+	} catch (error) {
+		if (error instanceof Error && error.name === "ExitPromptError") return cancelSymbol;
+		throw error;
+	}
+}
+function createInquirerAdapter() {
+	return {
+		text: (config) => wrapCancellation(() => (0, _inquirer_prompts.input)({
+			message: config.message,
+			...config.placeholder !== void 0 && { default: config.placeholder }
+		})),
+		password: (config) => wrapCancellation(() => (0, _inquirer_prompts.password)({ message: config.message })),
+		confirm: (config) => wrapCancellation(() => (0, _inquirer_prompts.confirm)({ message: config.message })),
+		select: (config) => wrapCancellation(() => (0, _inquirer_prompts.select)({
+			message: config.message,
+			choices: config.options.map((o) => ({
+				name: o.label,
+				value: o.value
+			}))
+		})),
+		isCancelled: (value) => value === cancelSymbol
+	};
+}
+/**
+* Prompt resolver backed by @inquirer/prompts.
+*
+* @example
+* ```ts
+* import { runMain, defineCommand } from "politty";
+* import { prompt } from "politty/prompt/inquirer";
+*
+* runMain(cmd, { version: "1.0.0", prompt });
+* ```
+*/
+const prompt = (rawArgs, extracted) => require_prompt.promptMissingArgs(rawArgs, extracted, { adapter: createInquirerAdapter() });
+
+//#endregion
+exports.prompt = prompt;
+//# sourceMappingURL=index.cjs.map

package/dist/prompt/inquirer/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["promptMissingArgs"],"sources":["../../../src/prompt/inquirer/index.ts"],"sourcesContent":["import { confirm, input, password, select } from \"@inquirer/prompts\";\nimport type { PromptResolver } from \"../../types.js\";\nimport { promptMissingArgs } from \"../index.js\";\nimport type { PromptAdapter } from \"../types.js\";\n\nconst cancelSymbol = Symbol(\"inquirer-cancel\");\n\nasync function wrapCancellation<T>(fn: () => Promise<T>): Promise<T | symbol> {\n  try {\n    return await fn();\n  } catch (error) {\n    if (error instanceof Error && error.name === \"ExitPromptError\") {\n      return cancelSymbol;\n    }\n    throw error;\n  }\n}\n\nfunction createInquirerAdapter(): PromptAdapter {\n  return {\n    text: (config) =>\n      wrapCancellation(() =>\n        input({\n          message: config.message,\n          ...(config.placeholder !== undefined && { default: config.placeholder }),\n        }),\n      ),\n    password: (config) => wrapCancellation(() => password({ message: config.message })),\n    confirm: (config) => wrapCancellation(() => confirm({ message: config.message })),\n    select: (config) =>\n      wrapCancellation(() =>\n        select({\n          message: config.message,\n          choices: config.options.map((o) => ({ name: o.label, value: o.value })),\n        }),\n      ),\n    isCancelled: (value) => value === cancelSymbol,\n  };\n}\n\n/**\n * Prompt resolver backed by @inquirer/prompts.\n *\n * @example\n * ```ts\n * import { runMain, defineCommand } from \"politty\";\n * import { prompt } from \"politty/prompt/inquirer\";\n *\n * runMain(cmd, { version: \"1.0.0\", prompt });\n * ```\n */\nexport const prompt: PromptResolver = (rawArgs, extracted) =>\n  promptMissingArgs(rawArgs, extracted, { adapter: createInquirerAdapter() });\n"],"mappings":";;;;;;AAKA,MAAM,eAAe,OAAO,kBAAkB;AAE9C,eAAe,iBAAoB,IAA2C;AAC5E,KAAI;AACF,SAAO,MAAM,IAAI;UACV,OAAO;AACd,MAAI,iBAAiB,SAAS,MAAM,SAAS,kBAC3C,QAAO;AAET,QAAM;;;AAIV,SAAS,wBAAuC;AAC9C,QAAO;EACL,OAAO,WACL,oDACQ;GACJ,SAAS,OAAO;GAChB,GAAI,OAAO,gBAAgB,UAAa,EAAE,SAAS,OAAO,aAAa;GACxE,CAAC,CACH;EACH,WAAW,WAAW,uDAAgC,EAAE,SAAS,OAAO,SAAS,CAAC,CAAC;EACnF,UAAU,WAAW,sDAA+B,EAAE,SAAS,OAAO,SAAS,CAAC,CAAC;EACjF,SAAS,WACP,qDACS;GACL,SAAS,OAAO;GAChB,SAAS,OAAO,QAAQ,KAAK,OAAO;IAAE,MAAM,EAAE;IAAO,OAAO,EAAE;IAAO,EAAE;GACxE,CAAC,CACH;EACH,cAAc,UAAU,UAAU;EACnC;;;;;;;;;;;;;AAcH,MAAa,UAA0B,SAAS,cAC9CA,iCAAkB,SAAS,WAAW,EAAE,SAAS,uBAAuB,EAAE,CAAC"}

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

@@ -0,0 +1,18 @@
+import { E as PromptResolver } from "../../arg-registry-r5wYN6qd.cjs";
+
+//#region src/prompt/inquirer/index.d.ts
+/**
+ * Prompt resolver backed by @inquirer/prompts.
+ *
+ * @example
+ * ```ts
+ * import { runMain, defineCommand } from "politty";
+ * import { prompt } from "politty/prompt/inquirer";
+ *
+ * runMain(cmd, { version: "1.0.0", prompt });
+ * ```
+ */
+declare const prompt: PromptResolver;
+//#endregion
+export { prompt };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/prompt/inquirer/index.ts"],"mappings":";;;;;AAmDA;;;;;;;;;cAAa,MAAA,EAAQ,cAAA"}

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

@@ -0,0 +1,18 @@
+import { E as PromptResolver } from "../../arg-registry-CkPDokIu.js";
+
+//#region src/prompt/inquirer/index.d.ts
+/**
+ * Prompt resolver backed by @inquirer/prompts.
+ *
+ * @example
+ * ```ts
+ * import { runMain, defineCommand } from "politty";
+ * import { prompt } from "politty/prompt/inquirer";
+ *
+ * runMain(cmd, { version: "1.0.0", prompt });
+ * ```
+ */
+declare const prompt: PromptResolver;
+//#endregion
+export { prompt };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/prompt/inquirer/index.ts"],"mappings":";;;;;AAmDA;;;;;;;;;cAAa,MAAA,EAAQ,cAAA"}

package/dist/prompt/inquirer/index.js

@@ -0,0 +1,47 @@
+import { t as promptMissingArgs } from "../../prompt-BKHqGrFw.js";
+import { confirm, input, password, select } from "@inquirer/prompts";
+
+//#region src/prompt/inquirer/index.ts
+const cancelSymbol = Symbol("inquirer-cancel");
+async function wrapCancellation(fn) {
+	try {
+		return await fn();
+	} catch (error) {
+		if (error instanceof Error && error.name === "ExitPromptError") return cancelSymbol;
+		throw error;
+	}
+}
+function createInquirerAdapter() {
+	return {
+		text: (config) => wrapCancellation(() => input({
+			message: config.message,
+			...config.placeholder !== void 0 && { default: config.placeholder }
+		})),
+		password: (config) => wrapCancellation(() => password({ message: config.message })),
+		confirm: (config) => wrapCancellation(() => confirm({ message: config.message })),
+		select: (config) => wrapCancellation(() => select({
+			message: config.message,
+			choices: config.options.map((o) => ({
+				name: o.label,
+				value: o.value
+			}))
+		})),
+		isCancelled: (value) => value === cancelSymbol
+	};
+}
+/**
+* Prompt resolver backed by @inquirer/prompts.
+*
+* @example
+* ```ts
+* import { runMain, defineCommand } from "politty";
+* import { prompt } from "politty/prompt/inquirer";
+*
+* runMain(cmd, { version: "1.0.0", prompt });
+* ```
+*/
+const prompt = (rawArgs, extracted) => promptMissingArgs(rawArgs, extracted, { adapter: createInquirerAdapter() });
+
+//#endregion
+export { prompt };
+//# sourceMappingURL=index.js.map

package/dist/prompt/inquirer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/prompt/inquirer/index.ts"],"sourcesContent":["import { confirm, input, password, select } from \"@inquirer/prompts\";\nimport type { PromptResolver } from \"../../types.js\";\nimport { promptMissingArgs } from \"../index.js\";\nimport type { PromptAdapter } from \"../types.js\";\n\nconst cancelSymbol = Symbol(\"inquirer-cancel\");\n\nasync function wrapCancellation<T>(fn: () => Promise<T>): Promise<T | symbol> {\n  try {\n    return await fn();\n  } catch (error) {\n    if (error instanceof Error && error.name === \"ExitPromptError\") {\n      return cancelSymbol;\n    }\n    throw error;\n  }\n}\n\nfunction createInquirerAdapter(): PromptAdapter {\n  return {\n    text: (config) =>\n      wrapCancellation(() =>\n        input({\n          message: config.message,\n          ...(config.placeholder !== undefined && { default: config.placeholder }),\n        }),\n      ),\n    password: (config) => wrapCancellation(() => password({ message: config.message })),\n    confirm: (config) => wrapCancellation(() => confirm({ message: config.message })),\n    select: (config) =>\n      wrapCancellation(() =>\n        select({\n          message: config.message,\n          choices: config.options.map((o) => ({ name: o.label, value: o.value })),\n        }),\n      ),\n    isCancelled: (value) => value === cancelSymbol,\n  };\n}\n\n/**\n * Prompt resolver backed by @inquirer/prompts.\n *\n * @example\n * ```ts\n * import { runMain, defineCommand } from \"politty\";\n * import { prompt } from \"politty/prompt/inquirer\";\n *\n * runMain(cmd, { version: \"1.0.0\", prompt });\n * ```\n */\nexport const prompt: PromptResolver = (rawArgs, extracted) =>\n  promptMissingArgs(rawArgs, extracted, { adapter: createInquirerAdapter() });\n"],"mappings":";;;;AAKA,MAAM,eAAe,OAAO,kBAAkB;AAE9C,eAAe,iBAAoB,IAA2C;AAC5E,KAAI;AACF,SAAO,MAAM,IAAI;UACV,OAAO;AACd,MAAI,iBAAiB,SAAS,MAAM,SAAS,kBAC3C,QAAO;AAET,QAAM;;;AAIV,SAAS,wBAAuC;AAC9C,QAAO;EACL,OAAO,WACL,uBACE,MAAM;GACJ,SAAS,OAAO;GAChB,GAAI,OAAO,gBAAgB,UAAa,EAAE,SAAS,OAAO,aAAa;GACxE,CAAC,CACH;EACH,WAAW,WAAW,uBAAuB,SAAS,EAAE,SAAS,OAAO,SAAS,CAAC,CAAC;EACnF,UAAU,WAAW,uBAAuB,QAAQ,EAAE,SAAS,OAAO,SAAS,CAAC,CAAC;EACjF,SAAS,WACP,uBACE,OAAO;GACL,SAAS,OAAO;GAChB,SAAS,OAAO,QAAQ,KAAK,OAAO;IAAE,MAAM,EAAE;IAAO,OAAO,EAAE;IAAO,EAAE;GACxE,CAAC,CACH;EACH,cAAc,UAAU,UAAU;EACnC;;;;;;;;;;;;;AAcH,MAAa,UAA0B,SAAS,cAC9C,kBAAkB,SAAS,WAAW,EAAE,SAAS,uBAAuB,EAAE,CAAC"}