politty 0.4.15 → 0.5.0

package/dist/{index-C1gGgUeB.d.cts → index-DBMfKZ34.d.ts}

@@ -1,7 +1,19 @@
-import { l as AnyCommand, p as Command, u as ArgsSchema, z as ResolvedFieldMeta } from "./arg-registry-CB5gGtzp.cjs";
+import { _ as AnyCommand, d as ResolvedExpandCandidate, h as DynamicCompletionResolver, q as ResolvedFieldMeta, u as ExpandCompletion, v as ArgsSchema, x as Command } from "./arg-registry-6E0WHOh_.js";
 import { z } from "zod";
 
 //#region src/completion/types.d.ts
+/**
+ * A single resolved entry in an "expand" lookup table.
+ *
+ * `key` is the tuple of `dependsOn` values that triggers this entry, in the
+ * same order as the originating `dependsOn` array. `candidates` is the
+ * (already deduplicated) list returned by the user's `enumerate` callback
+ * for that combination.
+ */
+interface ExpandTableEntry {
+  readonly key: readonly string[];
+  readonly candidates: readonly ResolvedExpandCandidate[];
+}
 /**
  * Supported shell types for completion
  */
@@ -20,21 +32,68 @@ interface CompletionOptions {
   includeDescriptions?: boolean;
   /** Global args schema for deriving global options in completion */
   globalArgsSchema?: ArgsSchema;
+  /**
+   * Path to the binary whose mtime is the freshness signature.
+   * Defaults to `process.argv[1]`.
+   */
+  binPath?: string;
+  /** Program version to embed in the script header. */
+  programVersion?: string;
+  /**
+   * Cache directory for the loader to write the regenerated script into.
+   * Defaults to `${XDG_CACHE_HOME:-$HOME/.cache}/<programName>` at runtime.
+   * Setting this hardcodes the location into the generated loader.
+   */
+  cacheDir?: string;
 }
 /**
- * Value completion specification for shell scripts
+ * Value completion specification for shell scripts.
+ *
+ * Discriminated by `type`. The `dynamic` variant carries a JS resolver that
+ * the static shell scripts delegate to via `<program> __complete`. All
+ * variants share the same optional metadata fields (left undefined where
+ * inapplicable) so consumers can read `vc.choices`/`vc.extensions`/etc.
+ * without narrowing first.
  */
-type ValueCompletion = {
+type ValueCompletion = ({
   /** Completion type */type: "choices" | "file" | "directory" | "command" | "none"; /** List of valid choices (for "choices" type) */
   choices?: string[]; /** Shell command for dynamic completion (for "command" type) */
   shellCommand?: string;
+  resolve?: never;
+  dependsOn?: never;
+  table?: never;
 } & ({
   extensions?: string[];
   matcher?: never;
 } | {
   /** Glob patterns for file matching (for "file" type) */matcher?: string[];
   extensions?: never;
-});
+})) | {
+  /** In-process dynamic completion via JS callback. */type: "dynamic";
+  resolve: DynamicCompletionResolver;
+  choices?: never;
+  shellCommand?: never;
+  extensions?: never;
+  matcher?: never;
+  dependsOn?: never;
+  table?: never;
+} | {
+  /**
+   * Pre-enumerated completion baked into the generated shell script.
+   * The `table` is the cartesian product of the `dependsOn` arg values
+   * (each having a static `choices` or enum schema). At completion time
+   * the shell dispatches on the runtime values of those args — no Node
+   * is spawned.
+   */
+  type: "expand";
+  dependsOn: readonly string[];
+  table: readonly ExpandTableEntry[];
+  choices?: never;
+  shellCommand?: never;
+  resolve?: never;
+  extensions?: never;
+  matcher?: never;
+};
 /**
  * Information about a completable option
  */
@@ -48,8 +107,31 @@ interface CompletableOption {
    * 1-char entries are short (`-v`); multi-char entries are long (`--to-be`).
    */
   alias?: string[] | undefined;
+  /**
+   * Negation name to advertise in shell completions (no `--` prefix),
+   * or `undefined` to hide the negation. Mirrors `ResolvedFieldMeta.negationDisplay`.
+   */
+  negation?: string | undefined;
+  /** Description for the negation option (when distinct from the main description) */
+  negationDescription?: string | undefined;
+  /**
+   * Whether the runtime parser accepts the implicit `--no-<cliName>` (and
+   * camelCase) form for this boolean option. False when the user set
+   * `negation: false` (suppressed) or `negation: <custom name>` (only the
+   * custom name is accepted). Used by the completion context parser so
+   * dynamic resolvers see the same `parsedArgs` state the runtime would
+   * compute.
+   */
+  defaultNegationAccepted?: boolean;
   /** Description for completion */
   description?: string | undefined;
+  /**
+   * True when this option originates from a `globalArgsSchema` and was
+   * propagated into every subcommand frame. The runtime parser keeps
+   * global values visible across subcommand descent, so shell generators
+   * must keep their tracker buckets separate from per-frame state.
+   */
+  isGlobal?: boolean;
   /** Whether this option takes a value */
   takesValue: boolean;
   /** Type of value expected */
@@ -155,15 +237,31 @@ interface CompletionContext {
   usedOptions: Set<string>;
   /** Number of positional arguments already provided */
   providedPositionalCount: number;
+  /**
+   * Best-effort parsed values for the CURRENT command, keyed by camelCase
+   * field name. Includes positionals (single value or string[] for variadic
+   * positionals) and options (string for scalars, string[] for array
+   * options). Zod validation is NOT applied — values are raw strings.
+   */
+  parsedArgs: Record<string, unknown>;
+  /**
+   * Values already supplied for the option/positional currently being
+   * completed (for de-duplicating array options and oneof exclusivity in
+   * dynamic resolvers).
+   */
+  previousValues: string[];
 }
 /**
  * Parse completion context from command line arguments
  *
  * @param argv - Arguments after the program name (e.g., ["build", "--fo"])
  * @param rootCommand - The root command
+ * @param globalArgsSchema - Optional global args. When provided, options
+ *   derived from this schema are merged into every command level so dynamic
+ *   resolvers attached to global options can be reached from any subcommand.
  * @returns Completion context
  */
-declare function parseCompletionContext(argv: string[], rootCommand: AnyCommand): CompletionContext;
+declare function parseCompletionContext(argv: string[], rootCommand: AnyCommand, globalArgsSchema?: ArgsSchema): CompletionContext;
 //#endregion
 //#region src/completion/dynamic/candidate-generator.d.ts
 /**
@@ -204,9 +302,27 @@ interface CandidateResult {
   fileMatchers?: string[] | undefined;
 }
 /**
- * Generate completion candidates based on context
+ * Options for candidate generation.
+ */
+interface GenerateCandidatesOptions {
+  /**
+   * Target shell. Forwarded to dynamic resolvers so they can vary output
+   * (e.g. include descriptions only for shells that render them).
+   */
+  shell: ShellType;
+}
+/**
+ * Generate completion candidates based on context.
+ *
+ * Async because dynamic resolvers may return promises. Sync completion
+ * sources (choices/file/directory/command/none, subcommand, option name)
+ * still resolve synchronously and the await is a no-op for them.
+ *
+ * Inline option-value prefixes (`--field=foo`) on the option-value path
+ * are stripped here so resolvers and post-processing always see the
+ * value portion regardless of whether the caller pre-normalized.
  */
-declare function generateCandidates(context: CompletionContext): CandidateResult;
+declare function generateCandidates(context: CompletionContext, options: GenerateCandidatesOptions): Promise<CandidateResult>;
 //#endregion
 //#region src/completion/dynamic/complete-command.d.ts
 /**
@@ -226,9 +342,12 @@ type CompleteArgs = z.infer<typeof completeArgsSchema>;
  *
  * @param rootCommand - The root command to generate completions for
  * @param programName - The program name (optional, defaults to rootCommand.name)
+ * @param globalArgsSchema - Global args schema. Forwarded to
+ *   `parseCompletionContext` so resolvers attached to global options remain
+ *   reachable at every subcommand level.
  * @returns A command that outputs completion candidates
  */
-declare function createDynamicCompleteCommand(rootCommand: AnyCommand, _programName?: string): Command<typeof completeArgsSchema, CompleteArgs, any>;
+declare function createDynamicCompleteCommand(rootCommand: AnyCommand, _programName?: string, globalArgsSchema?: ArgsSchema): Command<typeof completeArgsSchema, CompleteArgs, any>;
 /**
  * Check if a command tree contains the __complete command
  */
@@ -269,6 +388,18 @@ declare function extractPositionals(command: AnyCommand): ResolvedFieldMeta[];
 declare function extractCompletionData(command: AnyCommand, programName: string, globalArgsSchema?: ArgsSchema): CompletionData;
 //#endregion
 //#region src/completion/value-completion-resolver.d.ts
+/**
+ * Sentinel returned when a field uses `completion.custom.expand`. The static
+ * extractor recognises this and replaces it with a fully resolved
+ * `{ type: "expand", ... }` ValueCompletion after sibling args' static
+ * values are known. Internal: never assigned onto `CompletableOption` /
+ * `CompletablePositional` directly; callers stash it in a side map keyed by
+ * field name and patch the resolved spec in afterwards.
+ */
+interface PendingExpandValueCompletion {
+  type: "pending-expand";
+  spec: ExpandCompletion;
+}
 /**
  * Minimal field interface needed for resolving value completion.
  * Both ResolvedFieldMeta and inline context-parser types satisfy this.
@@ -279,6 +410,8 @@ interface ValueCompletionField {
     custom?: {
       choices?: string[];
       shellCommand?: string;
+      resolve?: DynamicCompletionResolver;
+      expand?: ExpandCompletion;
     };
   } & ({
     extensions?: string[];
@@ -288,16 +421,23 @@ interface ValueCompletionField {
     extensions?: never;
   })) | undefined;
   enumValues?: string[] | undefined;
+  /** Field name surfaced in error messages when custom variants are mixed. */
+  name?: string;
 }
 /**
- * Resolve value completion from field metadata
+ * Resolve value completion from field metadata.
  *
- * Priority:
- * 1. Explicit custom completion (choices or shellCommand)
- * 2. Explicit completion type (file, directory, none)
- * 3. Auto-detected enum values from schema
+ * Priority (within `custom`): `expand` > `resolve` > `choices` > `shellCommand`.
+ * Specifying more than one of these on the same field throws so the
+ * misconfiguration surfaces at command-definition time rather than at
+ * completion time. The `expand` variant returns a sentinel — the extractor
+ * resolves it against sibling fields and replaces the sentinel with a
+ * `{ type: "expand", table, dependsOn }` entry.
+ *
+ * Outside `custom`: explicit `type` (file/directory/none) > auto-detected
+ * enum values from the schema.
  */
-declare function resolveValueCompletion(field: ValueCompletionField): ValueCompletion | undefined;
+declare function resolveValueCompletion(field: ValueCompletionField): ValueCompletion | PendingExpandValueCompletion | undefined;
 //#endregion
 //#region src/completion/index.d.ts
 /**
@@ -322,8 +462,18 @@ declare const completionArgsSchema: z.ZodObject<{
     fish: "fish";
   }>>;
   instructions: z.ZodDefault<z.ZodBoolean>;
+  loader: z.ZodDefault<z.ZodBoolean>;
+  install: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 type CompletionArgs = z.infer<typeof completionArgsSchema>;
+declare const refreshArgsSchema: z.ZodObject<{
+  shell: z.ZodEnum<{
+    bash: "bash";
+    zsh: "zsh";
+    fish: "fish";
+  }>;
+}, z.core.$strip>;
+type RefreshArgs = z.infer<typeof refreshArgsSchema>;
 /**
  * Create a completion subcommand for your CLI
  *
@@ -339,7 +489,20 @@ type CompletionArgs = z.infer<typeof completionArgsSchema>;
  * });
  * ```
  */
-declare function createCompletionCommand(rootCommand: AnyCommand, programName?: string, globalArgsSchema?: ArgsSchema): Command<typeof completionArgsSchema, CompletionArgs, any>;
+declare function createCompletionCommand(rootCommand: AnyCommand, programName?: string, globalArgsSchema?: ArgsSchema, extra?: {
+  cacheDir?: string;
+  programVersion?: string;
+}): Command<typeof completionArgsSchema, CompletionArgs, any>;
+/**
+ * Hidden subcommand that the runMain background hook spawns. It does
+ * the same stat-compare + atomic rewrite as the rc loader, but in a
+ * detached child process so it's invisible to the user.
+ */
+declare function createRefreshCompletionCommand(rootCommand: AnyCommand, programName: string, extra?: {
+  cacheDir?: string;
+  programVersion?: string;
+  globalArgsSchema?: ArgsSchema;
+}): Command<typeof refreshArgsSchema, RefreshArgs, any>;
 /**
  * Options for withCompletionCommand
  */
@@ -348,6 +511,15 @@ interface WithCompletionOptions {
   programName?: string;
   /** Global args schema for deriving global options in completion */
   globalArgsSchema?: ArgsSchema;
+  /**
+   * Hardcode the cache directory used by the rc loader and the
+   * background refresh. When omitted, the loader derives
+   * `${XDG_CACHE_HOME:-$HOME/.cache}/<programName>` at runtime, which
+   * is the right answer for almost every CLI.
+   */
+  cacheDir?: string;
+  /** Program version embedded in the script header. */
+  programVersion?: string;
 }
 /**
  * Wrap a command with a completion subcommand
@@ -371,5 +543,5 @@ interface WithCompletionOptions {
  */
 declare function withCompletionCommand<T extends AnyCommand>(command: T, options?: string | WithCompletionOptions): T;
 //#endregion
-export { CompletableSubcommand as C, CompletionResult as D, CompletionOptions as E, ShellType as O, CompletableOption as S, CompletionGenerator as T, CompletionDirective as _, getSupportedShells as a, CompletionType as b, resolveValueCompletion as c, ShellFormatOptions as d, formatForShell as f, CompletionCandidate as g, CandidateResult as h, generateCompletion as i, extractCompletionData as l, hasCompleteCommand as m, createCompletionCommand as n, withCompletionCommand as o, createDynamicCompleteCommand as p, detectShell as r, ValueCompletionField as s, WithCompletionOptions as t, extractPositionals as u, generateCandidates as v, CompletionData as w, parseCompletionContext as x, CompletionContext as y };
-//# sourceMappingURL=index-C1gGgUeB.d.cts.map
+export { CompletableOption as C, CompletionOptions as D, CompletionGenerator as E, CompletionResult as O, parseCompletionContext as S, CompletionData as T, CompletionCandidate as _, generateCompletion as a, CompletionContext as b, ValueCompletionField as c, extractPositionals as d, ShellFormatOptions as f, CandidateResult as g, hasCompleteCommand as h, detectShell as i, ShellType as k, resolveValueCompletion as l, createDynamicCompleteCommand as m, createCompletionCommand as n, getSupportedShells as o, formatForShell as p, createRefreshCompletionCommand as r, withCompletionCommand as s, WithCompletionOptions as t, extractCompletionData as u, CompletionDirective as v, CompletableSubcommand as w, CompletionType as x, generateCandidates as y };
+//# sourceMappingURL=index-DBMfKZ34.d.ts.map

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

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

package/dist/{index-Dg9Fpz0R.d.ts → index-DJp8k5Bq.d.cts}

@@ -1,7 +1,19 @@
-import { l as AnyCommand, p as Command, u as ArgsSchema, z as ResolvedFieldMeta } from "./arg-registry-Dw0f11Zc.js";
+import { _ as AnyCommand, d as ResolvedExpandCandidate, h as DynamicCompletionResolver, q as ResolvedFieldMeta, u as ExpandCompletion, v as ArgsSchema, x as Command } from "./arg-registry--NRaNFJM.cjs";
 import { z } from "zod";
 
 //#region src/completion/types.d.ts
+/**
+ * A single resolved entry in an "expand" lookup table.
+ *
+ * `key` is the tuple of `dependsOn` values that triggers this entry, in the
+ * same order as the originating `dependsOn` array. `candidates` is the
+ * (already deduplicated) list returned by the user's `enumerate` callback
+ * for that combination.
+ */
+interface ExpandTableEntry {
+  readonly key: readonly string[];
+  readonly candidates: readonly ResolvedExpandCandidate[];
+}
 /**
  * Supported shell types for completion
  */
@@ -20,21 +32,68 @@ interface CompletionOptions {
   includeDescriptions?: boolean;
   /** Global args schema for deriving global options in completion */
   globalArgsSchema?: ArgsSchema;
+  /**
+   * Path to the binary whose mtime is the freshness signature.
+   * Defaults to `process.argv[1]`.
+   */
+  binPath?: string;
+  /** Program version to embed in the script header. */
+  programVersion?: string;
+  /**
+   * Cache directory for the loader to write the regenerated script into.
+   * Defaults to `${XDG_CACHE_HOME:-$HOME/.cache}/<programName>` at runtime.
+   * Setting this hardcodes the location into the generated loader.
+   */
+  cacheDir?: string;
 }
 /**
- * Value completion specification for shell scripts
+ * Value completion specification for shell scripts.
+ *
+ * Discriminated by `type`. The `dynamic` variant carries a JS resolver that
+ * the static shell scripts delegate to via `<program> __complete`. All
+ * variants share the same optional metadata fields (left undefined where
+ * inapplicable) so consumers can read `vc.choices`/`vc.extensions`/etc.
+ * without narrowing first.
  */
-type ValueCompletion = {
+type ValueCompletion = ({
   /** Completion type */type: "choices" | "file" | "directory" | "command" | "none"; /** List of valid choices (for "choices" type) */
   choices?: string[]; /** Shell command for dynamic completion (for "command" type) */
   shellCommand?: string;
+  resolve?: never;
+  dependsOn?: never;
+  table?: never;
 } & ({
   extensions?: string[];
   matcher?: never;
 } | {
   /** Glob patterns for file matching (for "file" type) */matcher?: string[];
   extensions?: never;
-});
+})) | {
+  /** In-process dynamic completion via JS callback. */type: "dynamic";
+  resolve: DynamicCompletionResolver;
+  choices?: never;
+  shellCommand?: never;
+  extensions?: never;
+  matcher?: never;
+  dependsOn?: never;
+  table?: never;
+} | {
+  /**
+   * Pre-enumerated completion baked into the generated shell script.
+   * The `table` is the cartesian product of the `dependsOn` arg values
+   * (each having a static `choices` or enum schema). At completion time
+   * the shell dispatches on the runtime values of those args — no Node
+   * is spawned.
+   */
+  type: "expand";
+  dependsOn: readonly string[];
+  table: readonly ExpandTableEntry[];
+  choices?: never;
+  shellCommand?: never;
+  resolve?: never;
+  extensions?: never;
+  matcher?: never;
+};
 /**
  * Information about a completable option
  */
@@ -48,8 +107,31 @@ interface CompletableOption {
    * 1-char entries are short (`-v`); multi-char entries are long (`--to-be`).
    */
   alias?: string[] | undefined;
+  /**
+   * Negation name to advertise in shell completions (no `--` prefix),
+   * or `undefined` to hide the negation. Mirrors `ResolvedFieldMeta.negationDisplay`.
+   */
+  negation?: string | undefined;
+  /** Description for the negation option (when distinct from the main description) */
+  negationDescription?: string | undefined;
+  /**
+   * Whether the runtime parser accepts the implicit `--no-<cliName>` (and
+   * camelCase) form for this boolean option. False when the user set
+   * `negation: false` (suppressed) or `negation: <custom name>` (only the
+   * custom name is accepted). Used by the completion context parser so
+   * dynamic resolvers see the same `parsedArgs` state the runtime would
+   * compute.
+   */
+  defaultNegationAccepted?: boolean;
   /** Description for completion */
   description?: string | undefined;
+  /**
+   * True when this option originates from a `globalArgsSchema` and was
+   * propagated into every subcommand frame. The runtime parser keeps
+   * global values visible across subcommand descent, so shell generators
+   * must keep their tracker buckets separate from per-frame state.
+   */
+  isGlobal?: boolean;
   /** Whether this option takes a value */
   takesValue: boolean;
   /** Type of value expected */
@@ -155,15 +237,31 @@ interface CompletionContext {
   usedOptions: Set<string>;
   /** Number of positional arguments already provided */
   providedPositionalCount: number;
+  /**
+   * Best-effort parsed values for the CURRENT command, keyed by camelCase
+   * field name. Includes positionals (single value or string[] for variadic
+   * positionals) and options (string for scalars, string[] for array
+   * options). Zod validation is NOT applied — values are raw strings.
+   */
+  parsedArgs: Record<string, unknown>;
+  /**
+   * Values already supplied for the option/positional currently being
+   * completed (for de-duplicating array options and oneof exclusivity in
+   * dynamic resolvers).
+   */
+  previousValues: string[];
 }
 /**
  * Parse completion context from command line arguments
  *
  * @param argv - Arguments after the program name (e.g., ["build", "--fo"])
  * @param rootCommand - The root command
+ * @param globalArgsSchema - Optional global args. When provided, options
+ *   derived from this schema are merged into every command level so dynamic
+ *   resolvers attached to global options can be reached from any subcommand.
  * @returns Completion context
  */
-declare function parseCompletionContext(argv: string[], rootCommand: AnyCommand): CompletionContext;
+declare function parseCompletionContext(argv: string[], rootCommand: AnyCommand, globalArgsSchema?: ArgsSchema): CompletionContext;
 //#endregion
 //#region src/completion/dynamic/candidate-generator.d.ts
 /**
@@ -204,9 +302,27 @@ interface CandidateResult {
   fileMatchers?: string[] | undefined;
 }
 /**
- * Generate completion candidates based on context
+ * Options for candidate generation.
+ */
+interface GenerateCandidatesOptions {
+  /**
+   * Target shell. Forwarded to dynamic resolvers so they can vary output
+   * (e.g. include descriptions only for shells that render them).
+   */
+  shell: ShellType;
+}
+/**
+ * Generate completion candidates based on context.
+ *
+ * Async because dynamic resolvers may return promises. Sync completion
+ * sources (choices/file/directory/command/none, subcommand, option name)
+ * still resolve synchronously and the await is a no-op for them.
+ *
+ * Inline option-value prefixes (`--field=foo`) on the option-value path
+ * are stripped here so resolvers and post-processing always see the
+ * value portion regardless of whether the caller pre-normalized.
  */
-declare function generateCandidates(context: CompletionContext): CandidateResult;
+declare function generateCandidates(context: CompletionContext, options: GenerateCandidatesOptions): Promise<CandidateResult>;
 //#endregion
 //#region src/completion/dynamic/complete-command.d.ts
 /**
@@ -226,9 +342,12 @@ type CompleteArgs = z.infer<typeof completeArgsSchema>;
  *
  * @param rootCommand - The root command to generate completions for
  * @param programName - The program name (optional, defaults to rootCommand.name)
+ * @param globalArgsSchema - Global args schema. Forwarded to
+ *   `parseCompletionContext` so resolvers attached to global options remain
+ *   reachable at every subcommand level.
  * @returns A command that outputs completion candidates
  */
-declare function createDynamicCompleteCommand(rootCommand: AnyCommand, _programName?: string): Command<typeof completeArgsSchema, CompleteArgs, any>;
+declare function createDynamicCompleteCommand(rootCommand: AnyCommand, _programName?: string, globalArgsSchema?: ArgsSchema): Command<typeof completeArgsSchema, CompleteArgs, any>;
 /**
  * Check if a command tree contains the __complete command
  */
@@ -269,6 +388,18 @@ declare function extractPositionals(command: AnyCommand): ResolvedFieldMeta[];
 declare function extractCompletionData(command: AnyCommand, programName: string, globalArgsSchema?: ArgsSchema): CompletionData;
 //#endregion
 //#region src/completion/value-completion-resolver.d.ts
+/**
+ * Sentinel returned when a field uses `completion.custom.expand`. The static
+ * extractor recognises this and replaces it with a fully resolved
+ * `{ type: "expand", ... }` ValueCompletion after sibling args' static
+ * values are known. Internal: never assigned onto `CompletableOption` /
+ * `CompletablePositional` directly; callers stash it in a side map keyed by
+ * field name and patch the resolved spec in afterwards.
+ */
+interface PendingExpandValueCompletion {
+  type: "pending-expand";
+  spec: ExpandCompletion;
+}
 /**
  * Minimal field interface needed for resolving value completion.
  * Both ResolvedFieldMeta and inline context-parser types satisfy this.
@@ -279,6 +410,8 @@ interface ValueCompletionField {
     custom?: {
       choices?: string[];
       shellCommand?: string;
+      resolve?: DynamicCompletionResolver;
+      expand?: ExpandCompletion;
     };
   } & ({
     extensions?: string[];
@@ -288,16 +421,23 @@ interface ValueCompletionField {
     extensions?: never;
   })) | undefined;
   enumValues?: string[] | undefined;
+  /** Field name surfaced in error messages when custom variants are mixed. */
+  name?: string;
 }
 /**
- * Resolve value completion from field metadata
+ * Resolve value completion from field metadata.
  *
- * Priority:
- * 1. Explicit custom completion (choices or shellCommand)
- * 2. Explicit completion type (file, directory, none)
- * 3. Auto-detected enum values from schema
+ * Priority (within `custom`): `expand` > `resolve` > `choices` > `shellCommand`.
+ * Specifying more than one of these on the same field throws so the
+ * misconfiguration surfaces at command-definition time rather than at
+ * completion time. The `expand` variant returns a sentinel — the extractor
+ * resolves it against sibling fields and replaces the sentinel with a
+ * `{ type: "expand", table, dependsOn }` entry.
+ *
+ * Outside `custom`: explicit `type` (file/directory/none) > auto-detected
+ * enum values from the schema.
  */
-declare function resolveValueCompletion(field: ValueCompletionField): ValueCompletion | undefined;
+declare function resolveValueCompletion(field: ValueCompletionField): ValueCompletion | PendingExpandValueCompletion | undefined;
 //#endregion
 //#region src/completion/index.d.ts
 /**
@@ -322,8 +462,18 @@ declare const completionArgsSchema: z.ZodObject<{
     fish: "fish";
   }>>;
   instructions: z.ZodDefault<z.ZodBoolean>;
+  loader: z.ZodDefault<z.ZodBoolean>;
+  install: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 type CompletionArgs = z.infer<typeof completionArgsSchema>;
+declare const refreshArgsSchema: z.ZodObject<{
+  shell: z.ZodEnum<{
+    bash: "bash";
+    zsh: "zsh";
+    fish: "fish";
+  }>;
+}, z.core.$strip>;
+type RefreshArgs = z.infer<typeof refreshArgsSchema>;
 /**
  * Create a completion subcommand for your CLI
  *
@@ -339,7 +489,20 @@ type CompletionArgs = z.infer<typeof completionArgsSchema>;
  * });
  * ```
  */
-declare function createCompletionCommand(rootCommand: AnyCommand, programName?: string, globalArgsSchema?: ArgsSchema): Command<typeof completionArgsSchema, CompletionArgs, any>;
+declare function createCompletionCommand(rootCommand: AnyCommand, programName?: string, globalArgsSchema?: ArgsSchema, extra?: {
+  cacheDir?: string;
+  programVersion?: string;
+}): Command<typeof completionArgsSchema, CompletionArgs, any>;
+/**
+ * Hidden subcommand that the runMain background hook spawns. It does
+ * the same stat-compare + atomic rewrite as the rc loader, but in a
+ * detached child process so it's invisible to the user.
+ */
+declare function createRefreshCompletionCommand(rootCommand: AnyCommand, programName: string, extra?: {
+  cacheDir?: string;
+  programVersion?: string;
+  globalArgsSchema?: ArgsSchema;
+}): Command<typeof refreshArgsSchema, RefreshArgs, any>;
 /**
  * Options for withCompletionCommand
  */
@@ -348,6 +511,15 @@ interface WithCompletionOptions {
   programName?: string;
   /** Global args schema for deriving global options in completion */
   globalArgsSchema?: ArgsSchema;
+  /**
+   * Hardcode the cache directory used by the rc loader and the
+   * background refresh. When omitted, the loader derives
+   * `${XDG_CACHE_HOME:-$HOME/.cache}/<programName>` at runtime, which
+   * is the right answer for almost every CLI.
+   */
+  cacheDir?: string;
+  /** Program version embedded in the script header. */
+  programVersion?: string;
 }
 /**
  * Wrap a command with a completion subcommand
@@ -371,5 +543,5 @@ interface WithCompletionOptions {
  */
 declare function withCompletionCommand<T extends AnyCommand>(command: T, options?: string | WithCompletionOptions): T;
 //#endregion
-export { CompletableSubcommand as C, CompletionResult as D, CompletionOptions as E, ShellType as O, CompletableOption as S, CompletionGenerator as T, CompletionDirective as _, getSupportedShells as a, CompletionType as b, resolveValueCompletion as c, ShellFormatOptions as d, formatForShell as f, CompletionCandidate as g, CandidateResult as h, generateCompletion as i, extractCompletionData as l, hasCompleteCommand as m, createCompletionCommand as n, withCompletionCommand as o, createDynamicCompleteCommand as p, detectShell as r, ValueCompletionField as s, WithCompletionOptions as t, extractPositionals as u, generateCandidates as v, CompletionData as w, parseCompletionContext as x, CompletionContext as y };
-//# sourceMappingURL=index-Dg9Fpz0R.d.ts.map
+export { CompletableOption as C, CompletionOptions as D, CompletionGenerator as E, CompletionResult as O, parseCompletionContext as S, CompletionData as T, CompletionCandidate as _, generateCompletion as a, CompletionContext as b, ValueCompletionField as c, extractPositionals as d, ShellFormatOptions as f, CandidateResult as g, hasCompleteCommand as h, detectShell as i, ShellType as k, resolveValueCompletion as l, createDynamicCompleteCommand as m, createCompletionCommand as n, getSupportedShells as o, formatForShell as p, createRefreshCompletionCommand as r, withCompletionCommand as s, WithCompletionOptions as t, extractCompletionData as u, CompletionDirective as v, CompletableSubcommand as w, CompletionType as x, generateCandidates as y };
+//# sourceMappingURL=index-DJp8k5Bq.d.cts.map

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

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