politty 0.4.16 → 0.5.1

package/dist/docs/index.d.cts

@@ -1,4 +1,4 @@
-import { N as SubCommandValue, R as ExtractedFields, h as Example, l as AnyCommand, u as ArgsSchema, z as ResolvedFieldMeta } from "../arg-registry-MVWOAcvw.cjs";
+import { C as Example, K as ExtractedFields, V as SubCommandValue, _ as AnyCommand, q as ResolvedFieldMeta, v as ArgsSchema } from "../arg-registry--NRaNFJM.cjs";
 import { z } from "zod";
 import * as fs from "node:fs";
 

package/dist/docs/index.d.ts

@@ -1,4 +1,4 @@
-import { N as SubCommandValue, R as ExtractedFields, h as Example, l as AnyCommand, u as ArgsSchema, z as ResolvedFieldMeta } from "../arg-registry-Cd6xnjHa.js";
+import { C as Example, K as ExtractedFields, V as SubCommandValue, _ as AnyCommand, q as ResolvedFieldMeta, v as ArgsSchema } from "../arg-registry-6E0WHOh_.js";
 import { z } from "zod";
 import * as fs from "node:fs";
 

package/dist/docs/index.js

@@ -1,4 +1,4 @@
-import { d as getExtractedFields, l as extractFields, r as resolveLazyCommand } from "../subcommand-router-XZBWe8HN.js";
+import { l as resolveLazyCommand, r as getExtractedFields, t as extractFields } from "../schema-extractor-C50R-1re.js";
 import { t as createLogCollector } from "../log-collector-Cu6MCtAx.js";
 import { z } from "zod";
 import * as fs from "node:fs";
@@ -871,7 +871,7 @@ async function executeSingleExample(example, rootCommand, commandPath) {
 	collector.start();
 	let success = true;
 	try {
-		const { runCommand } = await import("../runner-BHeCMEa5.js").then((n) => n.r);
+		const { runCommand } = await import("../runner-BmSEiD9A.js").then((n) => n.r);
 		const result = await runCommand(rootCommand, argv);
 		success = result.success;
 		if (!result.success && result.error) console.error(result.error.message);

package/dist/{index-DR9HLxIP.d.ts → index-Cg8qstsT.d.cts}

@@ -1,7 +1,19 @@
-import { l as AnyCommand, p as Command, u as ArgsSchema, z as ResolvedFieldMeta } from "./arg-registry-Cd6xnjHa.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
  */
@@ -35,19 +47,53 @@ interface CompletionOptions {
   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
  */
@@ -68,8 +114,24 @@ interface CompletableOption {
   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 */
@@ -175,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
 /**
@@ -224,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
 /**
@@ -246,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
  */
@@ -289,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.
@@ -299,6 +410,8 @@ interface ValueCompletionField {
     custom?: {
       choices?: string[];
       shellCommand?: string;
+      resolve?: DynamicCompletionResolver;
+      expand?: ExpandCompletion;
     };
   } & ({
     extensions?: string[];
@@ -308,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 (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.
  *
- * Priority:
- * 1. Explicit custom completion (choices or shellCommand)
- * 2. Explicit completion type (file, directory, none)
- * 3. Auto-detected enum values from schema
+ * 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
 /**
@@ -352,6 +472,7 @@ declare const refreshArgsSchema: z.ZodObject<{
     zsh: "zsh";
     fish: "fish";
   }>;
+  target: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type RefreshArgs = z.infer<typeof refreshArgsSchema>;
 /**
@@ -424,4 +545,4 @@ interface WithCompletionOptions {
 declare function withCompletionCommand<T extends AnyCommand>(command: T, options?: string | WithCompletionOptions): T;
 //#endregion
 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-DR9HLxIP.d.ts.map
+//# sourceMappingURL=index-Cg8qstsT.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-Cg8qstsT.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":";;;;;;;;;;AAkBuD;AAMvD;UARiB,gBAAA;EAAA,SACN,GAAA;EAAA,SACA,UAAA,WAAqB,uBAAuB;AAAA;AAWvD;;;AAAA,KALY,SAAA;;;;UAKK,iBAAA;EAQf;EANA,KAAA,EAAO,SAAA;EAQY;EANnB,WAAA;EAaA;EAXA,kBAAA;EAiBQ;EAfR,mBAAA;EA2BU;EAzBV,gBAAA,GAAmB,UAAU;;;;;EAK7B,OAAA;EA4BI;EA1BJ,cAAA;EA4BI;;;;;EAtBJ,QAAA;AAAA;;;;;;;;;;KAYU,eAAA;EAuCU,sBApChB,IAAA,yDAsCA;EApCA,OAAA,aAsCA;EApCA,YAAA;EACA,OAAA;EACA,SAAA;EACA,KAAA;AAAA;EAEoD,UAAA;EAAuB,OAAA;AAAA;EA0C/E,wDAxCiE,OAAA;EACzD,UAAA;AAAA;EAmDR,qDA9CI,IAAA;EACA,OAAA,EAAS,yBAAA;EACT,OAAA;EACA,YAAA;EACA,UAAA;EACA,OAAA;EACA,SAAA;EACA,KAAA;AAAA;EAiE6B;AAMnC;;;;;;EA7DM,IAAA;EACA,SAAA;EACA,KAAA,WAAgB,gBAAgB;EAChC,OAAA;EACA,YAAA;EACA,OAAA;EACA,UAAA;EACA,OAAA;AAAA;;;;UAMW,iBAAA;EAgFF;EA9Eb,IAAA;EA8EkC;EA5ElC,OAAA;EAoEA;;;;EA/DA,KAAA;EAqES;;;;EAhET,QAAA;EAwEe;EAtEf,mBAAA;;;;;;;;;EASA,uBAAA;EAyEe;EAvEf,WAAA;;;;;;;EAOA,QAAA;EAsEmB;EApEnB,UAAA;EA0E6B;EAxE7B,SAAA;EAyES;EAvET,QAAA;EAyEG;EAvEH,eAAA,GAAkB,eAAe;AAAA;;;;UAMlB,qBAAA;EAiEZ;EA/DH,IAAA;EA+DmB;EA7DnB,OAAA;;EAEA,QAAA;EC1IU;ED4IV,WAAA;;EAEA,QAAA;EC9IwB;EDgJxB,QAAA;ECvIgC;EDyIhC,eAAA,GAAkB,eAAe;AAAA;;;;UAMlB,qBAAA;ECzHF;ED2Hb,IAAA;EClHkB;EDoHlB,WAAA;ECjJA;EDmJA,OAAA;ECjJgB;EDmJhB,WAAA,EAAa,qBAAA;EC/Ib;EDiJA,OAAA,EAAS,iBAAA;EC/IO;EDiJhB,WAAA,EAAa,qBAAA;AAAA;;;;UAME,cAAA;EC7If;ED+IA,OAAA,EAAS,qBAAA;EC7IT;ED+IA,WAAA;EC7IA;ED+IA,aAAA,EAAe,iBAAiB;AAAA;;;AClIlB;UDwIC,gBAAA;ECkTqB;EDhTpC,MAAA;ECkTa;EDhTb,KAAA,EAAO,SAAS;ECkTf;EDhTD,mBAAA;AAAA;;;;KAMU,mBAAA,IACV,OAAA,EAAS,UAAA,EACT,OAAA,EAAS,iBAAA,KACN,gBAAA;;;;;;KCrMO,cAAA;;;;UASK,iBAAA;EDfL;ECiBV,cAAA;;EAEA,cAAA,EAAgB,UAAA;EDnBG;ECqBnB,WAAA;EDhBgC;ECkBhC,YAAA;EDR6B;ECU7B,cAAA,EAAgB,cAAA;EDlBT;ECoBP,YAAA,GAAe,iBAAA;EDhBf;ECkBA,eAAA;EDdA;ECgBA,OAAA,EAAS,iBAAA;EDXT;ECaA,WAAA;EDLA;ECOA,WAAA,EAAa,qBAAA;EDPL;ECSR,WAAA,EAAa,GAAA;EDGY;ECDzB,uBAAA;EDwCoC;;;;;;ECjCpC,UAAA,EAAY,MAAA;EDM4C;;;;;ECAxD,cAAA;AAAA;;;;;;;;;;ADgCW;iBC0ZG,sBAAA,CACd,IAAA,YACA,WAAA,EAAa,UAAA,EACb,gBAAA,GAAmB,UAAA,GAClB,iBAAA;;;;;;cC5fU,mBAAA;EFIF,uDAA4C;EAAA,qBAM3C;EAAA;4BAAS;EAAA,uBAKa;EAAA,6BAUH;EAAA,kCARtB;EAAA;;;;;UEKQ,mBAAA;EFUf;EERA,KAAA;EFcQ;EEZR,WAAA;EFwBU;EEtBV,IAAA;AAAA;;;;UAMe,eAAA;EFwBX;EEtBJ,UAAA,EAAY,mBAAmB;EFwB3B;EEtBJ,SAAA;EFwB+E;EEtB/E,cAAA;EFyBQ;EEvBR,YAAA;AAAA;;;;UAMe,yBAAA;EF2BX;;;;EEtBJ,KAAA,EAAO,SAAS;AAAA;AF+ClB;;;;;;;;;;;AAAA,iBEnBsB,kBAAA,CACpB,OAAA,EAAS,iBAAA,EACT,OAAA,EAAS,yBAAA,GACR,OAAA,CAAQ,eAAA;;;;AF1EU;AAKrB;cGHM,kBAAA,EAAkB,CAAA,CAAA,SAAA;;;;;;;;KAYnB,YAAA,GAAe,CAAA,CAAE,KAAK,QAAQ,kBAAA;;;;;;AHczB;AAYV;;;;iBGdgB,4BAAA,CACd,WAAA,EAAa,UAAA,EACb,YAAA,WACA,gBAAA,GAAmB,UAAA,GAElB,OAAA,QAAe,kBAAA,EAAoB,YAAA;;;;iBAqCtB,kBAAA,CAAmB,OAAmB,EAAV,UAAU;;;;;;UC/ErC,kBAAA;EJKsC;EIHrD,KAAA,EAAO,SAAS;EJSG;EIPnB,WAAA;EJOmB;EILnB,YAAA;AAAA;;;;;;iBAQc,cAAA,CAAe,MAAA,EAAQ,eAAA,EAAiB,OAAA,EAAS,kBAAkB;;;;;;iBC+HnE,kBAAA,CAAmB,OAAA,EAAS,UAAA,GAAa,iBAAiB;;AFxIJ;;;;;;;iBEm5BtD,qBAAA,CACd,OAAA,EAAS,UAAA,EACT,WAAA,UACA,gBAAA,GAAmB,UAAA,GAClB,cAAA;;;;;;ALv5BoD;AAMvD;;;;UMLiB,4BAAA;EACf,IAAA;EACA,IAAA,EAAM,gBAAgB;AAAA;;;;;UAOP,oBAAA;EACf,UAAA;IAEM,IAAA;IACA,MAAA;MACE,OAAA;MACA,YAAA;MACA,OAAA,GAAU,yBAAA;MACV,MAAA,GAAS,gBAAgB;IAAA;EAAA;IAEtB,UAAA;IAAuB,OAAA;EAAA;IAAsB,OAAA;IAAoB,UAAA;EAAA;EAE5E,UAAA;ENiCI;EM/BJ,IAAA;AAAA;;;;;;;;;;;;;;iBAgBc,sBAAA,CACd,KAAA,EAAO,oBAAA,GACN,eAAA,GAAkB,4BAAA;;;ANRX;AAYV;;AAZU,iBO8BM,kBAAA,CACd,OAAA,EAAS,UAAA,EACT,OAAA,EAAS,iBAAA,GACR,gBAAA;;;;iBAgBa,kBAAA,CAAA,GAAsB,SAAS;;;;iBAwB/B,WAAA,CAAA,GAAe,SAAS;;;;cAoBlC,oBAAA,EAAoB,CAAA,CAAA,SAAA;;;;;;;;;;KA0BrB,cAAA,GAAiB,CAAA,CAAE,KAAK,QAAQ,oBAAA;AAAA,cAE/B,iBAAA,EAAiB,CAAA,CAAA,SAAA;;;;;;;;KAalB,WAAA,GAAc,CAAA,CAAE,KAAK,QAAQ,iBAAA;APxElC;;;;;;;;;;;;;;;AAAA,iBOyFgB,uBAAA,CACd,WAAA,EAAa,UAAA,EACb,WAAA,WACA,gBAAA,GAAmB,UAAA,EACnB,KAAA;EAAS,QAAA;EAAmB,cAAA;AAAA,IAE3B,OAAA,QAAe,oBAAA,EAAsB,cAAA;AP/CxC;;;;;AAAA,iBOqKgB,8BAAA,CACd,WAAA,EAAa,UAAA,EACb,WAAA,UACA,KAAA;EAAS,QAAA;EAAmB,cAAA;EAAyB,gBAAA,GAAmB,UAAA;AAAA,IAEvE,OAAA,QAAe,iBAAA,EAAmB,WAAA;;;;UAsBpB,qBAAA;EP5KA;EO8Kf,WAAA;;EAEA,gBAAA,GAAmB,UAAU;EPtKpB;;;;;;EO6KT,QAAA;EP/KA;EOiLA,cAAA;AAAA;;;;;AP7KkC;AAMpC;;;;;;;;;;AAMkC;AAMlC;;;;iBOkLgB,qBAAA,WAAgC,UAAA,CAAA,CAC9C,OAAA,EAAS,CAAA,EACT,OAAA,YAAmB,qBAAA,GAClB,CAAA"}

package/dist/{index-CPebddth.d.cts → index-O3yn97Ed.d.ts}

@@ -1,7 +1,19 @@
-import { l as AnyCommand, p as Command, u as ArgsSchema, z as ResolvedFieldMeta } from "./arg-registry-MVWOAcvw.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
  */
@@ -35,19 +47,53 @@ interface CompletionOptions {
   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
  */
@@ -68,8 +114,24 @@ interface CompletableOption {
   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 */
@@ -175,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
 /**
@@ -224,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
 /**
@@ -246,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
  */
@@ -289,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.
@@ -299,6 +410,8 @@ interface ValueCompletionField {
     custom?: {
       choices?: string[];
       shellCommand?: string;
+      resolve?: DynamicCompletionResolver;
+      expand?: ExpandCompletion;
     };
   } & ({
     extensions?: string[];
@@ -308,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 (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.
  *
- * Priority:
- * 1. Explicit custom completion (choices or shellCommand)
- * 2. Explicit completion type (file, directory, none)
- * 3. Auto-detected enum values from schema
+ * 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
 /**
@@ -352,6 +472,7 @@ declare const refreshArgsSchema: z.ZodObject<{
     zsh: "zsh";
     fish: "fish";
   }>;
+  target: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type RefreshArgs = z.infer<typeof refreshArgsSchema>;
 /**
@@ -424,4 +545,4 @@ interface WithCompletionOptions {
 declare function withCompletionCommand<T extends AnyCommand>(command: T, options?: string | WithCompletionOptions): T;
 //#endregion
 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-CPebddth.d.cts.map
+//# sourceMappingURL=index-O3yn97Ed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-O3yn97Ed.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.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_subcommand_router = require('./subcommand-router-DQy0KZU-.cjs');
-const require_completion = require('./completion-BlZxMSeU.cjs');
-const require_runner = require('./runner-BcyR6Z8r.cjs');
+const require_schema_extractor = require('./schema-extractor-SLPgBNgZ.cjs');
+const require_completion = require('./completion-BFOAOg95.cjs');
+const require_runner = require('./runner-CRZ_7Y9i.cjs');
 
 exports.CaseVariantCollisionError = require_runner.CaseVariantCollisionError;
 exports.DuplicateAliasError = require_runner.DuplicateAliasError;
@@ -9,19 +9,19 @@ exports.DuplicateFieldError = require_runner.DuplicateFieldError;
 exports.DuplicateNegationError = require_runner.DuplicateNegationError;
 exports.PositionalConfigError = require_runner.PositionalConfigError;
 exports.ReservedAliasError = require_runner.ReservedAliasError;
-exports.arg = require_subcommand_router.arg;
+exports.arg = require_schema_extractor.arg;
 exports.createDefineCommand = require_completion.createDefineCommand;
 exports.createDualCaseProxy = require_runner.createDualCaseProxy;
 exports.defineCommand = require_completion.defineCommand;
-exports.extractFields = require_subcommand_router.extractFields;
+exports.extractFields = require_schema_extractor.extractFields;
 exports.formatCommandValidationErrors = require_runner.formatCommandValidationErrors;
 exports.formatValidationErrors = require_runner.formatValidationErrors;
 exports.generateCompletion = require_completion.generateCompletion;
 exports.generateHelp = require_runner.generateHelp;
-exports.getUnknownKeysMode = require_subcommand_router.getUnknownKeysMode;
+exports.getUnknownKeysMode = require_schema_extractor.getUnknownKeysMode;
 exports.isColorEnabled = require_runner.isColorEnabled;
-exports.isLazyCommand = require_subcommand_router.isLazyCommand;
-exports.lazy = require_subcommand_router.lazy;
+exports.isLazyCommand = require_schema_extractor.isLazyCommand;
+exports.lazy = require_schema_extractor.lazy;
 exports.logger = require_runner.logger;
 exports.parseArgv = require_runner.parseArgv;
 exports.renderInline = require_runner.renderInline;
@@ -31,8 +31,8 @@ exports.runMain = require_runner.runMain;
 exports.setColorEnabled = require_runner.setColorEnabled;
 exports.styles = require_runner.styles;
 exports.symbols = require_runner.symbols;
-exports.toCamelCase = require_subcommand_router.toCamelCase;
-exports.toKebabCase = require_subcommand_router.toKebabCase;
+exports.toCamelCase = require_schema_extractor.toCamelCase;
+exports.toKebabCase = require_schema_extractor.toKebabCase;
 exports.validateCaseVariantCollisions = require_runner.validateCaseVariantCollisions;
 exports.validateCommand = require_runner.validateCommand;
 exports.validateCrossSchemaCollisions = require_runner.validateCrossSchemaCollisions;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as RunResultSuccess, B as UnknownKeysMode, C as Logger, D as RunCommandOptions, E as PromptResolver, F as LazyCommand, H as getUnknownKeysMode, I as isLazyCommand, L as lazy, M as SetupContext, N as SubCommandValue, O as RunResult, P as SubCommandsRecord, R as ExtractedFields, S as LogStream, T as NonRunnableCommand, U as toCamelCase, V as extractFields, W as toKebabCase, _ as GlobalCleanupContext, a as EffectContext, b as LogEntry, c as arg, d as CleanupContext, f as CollectedLogs, g as GlobalArgs, h as Example, i as CustomCompletion, j as RunnableCommand, k as RunResultFailure, l as AnyCommand, m as CommandBase, n as CompletionMeta, o as PromptMeta, p as Command, r as CompletionType, s as PromptType, t as ArgMeta, u as ArgsSchema, v as GlobalSetupContext, w as MainOptions, x as LogLevel, y as IsEmpty, z as ResolvedFieldMeta } from "./arg-registry-MVWOAcvw.cjs";
-import { D as CompletionOptions, O as CompletionResult, a as generateCompletion, s as withCompletionCommand, t as WithCompletionOptions } from "./index-CPebddth.cjs";
+import { A as LogStream, B as SetupContext, C as Example, D as IsEmpty, E as GlobalSetupContext, F as RunCommandOptions, G as lazy, H as SubCommandsRecord, I as RunResult, J as UnknownKeysMode, K as ExtractedFields, L as RunResultFailure, M as MainOptions, N as NonRunnableCommand, O as LogEntry, P as PromptResolver, Q as toKebabCase, R as RunResultSuccess, S as CommandBase, T as GlobalCleanupContext, U as LazyCommand, V as SubCommandValue, W as isLazyCommand, X as getUnknownKeysMode, Y as extractFields, Z as toCamelCase, _ as AnyCommand, a as EffectContext, b as CollectedLogs, c as arg, d as ResolvedExpandCandidate, f as CompletionDirectiveMask, g as DynamicCompletionResult, h as DynamicCompletionResolver, i as CustomCompletion, j as Logger, k as LogLevel, l as ExpandCandidate, m as DynamicCompletionContext, n as CompletionMeta, o as PromptMeta, p as DynamicCompletionCandidate, q as ResolvedFieldMeta, r as CompletionType, s as PromptType, t as ArgMeta, u as ExpandCompletion, v as ArgsSchema, w as GlobalArgs, x as Command, y as CleanupContext, z as RunnableCommand } from "./arg-registry--NRaNFJM.cjs";
+import { D as CompletionOptions, O as CompletionResult, a as generateCompletion, s as withCompletionCommand, t as WithCompletionOptions } from "./index-Cg8qstsT.cjs";
 import { z } from "zod";
 
 //#region src/core/case-types.d.ts
@@ -681,5 +681,5 @@ type ValidationResult<T> = {
  */
 declare function formatValidationErrors(errors: ValidationError[]): string;
 //#endregion
-export { type AnyCommand, type ArgMeta, type ArgsSchema, type BuiltinOptionDescriptions, type CamelCase, CaseVariantCollisionError, type CleanupContext, type CollectedLogs, type Command, type CommandBase, type CommandContext, type CommandValidationError, type CommandValidationResult, type CompletionMeta, type CompletionOptions, type CompletionResult, type CompletionType, type CustomCompletion, DuplicateAliasError, DuplicateFieldError, DuplicateNegationError, type EffectContext, type Example, type ExtractedFields, type GlobalArgs, type GlobalCleanupContext, type GlobalSetupContext, type HelpOptions, type KebabCase, type LazyCommand, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, type MergedArgs, type NonRunnableCommand, type ParsedArgv, type ParserOptions, PositionalConfigError, type PromptMeta, type PromptResolver, type PromptType, ReservedAliasError, type ResolvedFieldMeta, type RunCommandOptions, type RunResult, type RunResultFailure, type RunResultSuccess, type RunnableCommand, type SetupContext, type SubCommandValue, type SubCommandsRecord, type UnknownKeysMode, type ValidationError, type ValidationResult, type WithCaseVariants, type WithCompletionOptions, arg, createDefineCommand, createDualCaseProxy, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateCompletion, generateHelp, getUnknownKeysMode, isColorEnabled, isLazyCommand, lazy, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, toCamelCase, toKebabCase, validateCaseVariantCollisions, validateCommand, validateCrossSchemaCollisions, validateDuplicateAliases, validateDuplicateFields, validateDuplicateNegations, validatePositionalConfig, validateReservedAliases, withCompletionCommand };
+export { type AnyCommand, type ArgMeta, type ArgsSchema, type BuiltinOptionDescriptions, type CamelCase, CaseVariantCollisionError, type CleanupContext, type CollectedLogs, type Command, type CommandBase, type CommandContext, type CommandValidationError, type CommandValidationResult, type CompletionDirectiveMask, type CompletionMeta, type CompletionOptions, type CompletionResult, type CompletionType, type CustomCompletion, DuplicateAliasError, DuplicateFieldError, DuplicateNegationError, type DynamicCompletionCandidate, type DynamicCompletionContext, type DynamicCompletionResolver, type DynamicCompletionResult, type EffectContext, type Example, type ExpandCandidate, type ExpandCompletion, type ExtractedFields, type GlobalArgs, type GlobalCleanupContext, type GlobalSetupContext, type HelpOptions, type KebabCase, type LazyCommand, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, type MergedArgs, type NonRunnableCommand, type ParsedArgv, type ParserOptions, PositionalConfigError, type PromptMeta, type PromptResolver, type PromptType, ReservedAliasError, type ResolvedExpandCandidate, type ResolvedFieldMeta, type RunCommandOptions, type RunResult, type RunResultFailure, type RunResultSuccess, type RunnableCommand, type SetupContext, type SubCommandValue, type SubCommandsRecord, type UnknownKeysMode, type ValidationError, type ValidationResult, type WithCaseVariants, type WithCompletionOptions, arg, createDefineCommand, createDualCaseProxy, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateCompletion, generateHelp, getUnknownKeysMode, isColorEnabled, isLazyCommand, lazy, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, toCamelCase, toKebabCase, validateCaseVariantCollisions, validateCommand, validateCrossSchemaCollisions, validateDuplicateAliases, validateDuplicateFields, validateDuplicateNegations, validatePositionalConfig, validateReservedAliases, withCompletionCommand };
 //# sourceMappingURL=index.d.cts.map