politty 0.4.16 → 0.5.0

package/dist/{arg-registry-MVWOAcvw.d.cts → arg-registry--NRaNFJM.d.cts}

@@ -455,19 +455,139 @@ interface RunResultFailure {
  */
 type RunResult<T = unknown> = RunResultSuccess<T> | RunResultFailure;
 //#endregion
+//#region src/core/dynamic-completion-types.d.ts
+/**
+ * Types for in-process dynamic value completion.
+ *
+ * A `resolve` callback registered on `arg(...)` receives parsed context
+ * (other arg values typed so far, previous values supplied to the same
+ * option, the current word being completed, target shell) and returns
+ * candidates. The callback runs inside the `__complete` command, so static
+ * shell scripts delegate to `<program> __complete` for any spec that uses
+ * `resolve`.
+ *
+ * Defined under `core/` (not `completion/`) so `arg-registry.ts` can
+ * reference the resolver type without crossing the lint-enforced
+ * `completion → core` boundary.
+ */
+/** Bitmask combining `CompletionDirective` values. */
+type CompletionDirectiveMask = number;
+interface DynamicCompletionContext {
+  /** Word being completed. `--field=` inline prefix is stripped before this is set. */
+  currentWord: string;
+  /** Target shell formatting requested by the caller. */
+  shell: "bash" | "zsh" | "fish";
+  /**
+   * Best-effort parsed values of OTHER args on the same command, keyed by
+   * camelCase name. Includes positionals and other options. Zod validation
+   * is NOT applied; values are raw strings (or arrays of raw strings for
+   * array-typed options/variadic positionals).
+   */
+  parsedArgs: Readonly<Record<string, unknown>>;
+  /**
+   * Values already supplied for the SAME option/positional being completed.
+   * Useful for de-duplicating repeated array options.
+   */
+  previousValues: readonly string[];
+  /**
+   * Subcommand path from root (e.g. ["api"]). Reflects what the user
+   * actually typed — aliases are NOT resolved to their canonical names, so
+   * resolvers that branch on the path should accept every alias they care
+   * about.
+   */
+  subcommandPath: readonly string[];
+}
+interface DynamicCompletionCandidate {
+  value: string;
+  description?: string;
+}
+interface DynamicCompletionResult {
+  /** Candidates to surface. Strings or `{value, description}` objects. */
+  candidates: Array<string | DynamicCompletionCandidate>;
+  /**
+   * Optional directive override. When omitted, defaults to
+   * `FilterPrefix | NoFileCompletion` (matches `choices` behaviour).
+   */
+  directive?: CompletionDirectiveMask;
+}
+type DynamicCompletionResolver = (ctx: DynamicCompletionContext) => DynamicCompletionResult | Promise<DynamicCompletionResult>;
+//#endregion
+//#region src/core/expand-completion-types.d.ts
+/**
+ * Types for "expand" completion — candidates that are pre-enumerated at
+ * script-generation time and inlined into the static shell script.
+ *
+ * The user provides `dependsOn` (sibling arg names that must have static
+ * `choices` or an enum schema) and `enumerate(deps)`. politty walks the
+ * cartesian product of the dependsOn values, calls `enumerate` for each
+ * combination, and emits a case lookup keyed on the runtime values of those
+ * args. No Node process is spawned on TAB.
+ *
+ * Defined under `core/` (not `completion/`) so `arg-registry.ts` can
+ * reference these types without crossing the lint-enforced
+ * `completion → core` boundary.
+ */
+/** Candidate returned by an `enumerate` callback. */
+interface ExpandCandidate {
+  value: string;
+  description?: string;
+}
+/** Resolved candidate stored on a {@link ValueCompletion} after enumeration. */
+interface ResolvedExpandCandidate {
+  value: string;
+  description?: string;
+}
+/**
+ * User-facing spec attached to `completion.custom.expand`.
+ *
+ * `dependsOn` lists sibling args (camelCase names) whose values determine
+ * which candidates apply. Each named arg must have a static set of values —
+ * either an explicit `completion.custom.choices` or an enum schema. The
+ * order of `dependsOn` is the order in which `deps` keys are exposed to
+ * `enumerate`.
+ *
+ * `enumerate` runs once per cartesian-product combination at the time the
+ * shell script is generated (e.g. when the user runs `<program> completion
+ * zsh`). It must be a pure function of `deps`; politty does not retain it
+ * for runtime use.
+ */
+interface ExpandCompletion {
+  dependsOn: readonly string[];
+  enumerate: (deps: Readonly<Record<string, string>>) => ReadonlyArray<string | ExpandCandidate>;
+}
+//#endregion
 //#region src/core/arg-registry.d.ts
 /**
  * Built-in completion types
  */
 type CompletionType = "file" | "directory" | "none";
 /**
- * Custom completion specification
+ * Custom completion specification.
+ *
+ * `choices`, `shellCommand`, `resolve`, and `expand` are mutually exclusive —
+ * specifying more than one throws when the field metadata is resolved.
  */
 interface CustomCompletion {
   /** Static list of choices for completion */
   choices?: string[];
   /** Shell command to execute for dynamic completion */
   shellCommand?: string;
+  /**
+   * In-process JS callback for dynamic completion. Receives parsed context
+   * (other arg values typed so far, previously supplied values for this same
+   * option) and returns candidates. Static shell scripts delegate to
+   * `<program> __complete` whenever this is set.
+   */
+  resolve?: DynamicCompletionResolver;
+  /**
+   * Pre-enumerated completion baked into the generated shell script. The
+   * candidate list is computed at script-generation time by calling
+   * `enumerate` for every combination of the sibling arg values listed in
+   * `dependsOn` (each must have a static `choices` or enum schema). The
+   * shell then dispatches via a case lookup keyed by the runtime values of
+   * those args — no Node process is spawned on TAB.
+   */
+  expand?: ExpandCompletion;
 }
 /**
  * Completion metadata for an argument
@@ -794,5 +914,5 @@ type ValidateArgMeta<M, TValue = unknown> = M extends {
 declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M, z.output<T>>): T;
 //#endregion
-export { RunResultSuccess as A, UnknownKeysMode as B, Logger as C, RunCommandOptions as D, PromptResolver as E, LazyCommand as F, getUnknownKeysMode as H, isLazyCommand as I, lazy as L, SetupContext as M, SubCommandValue as N, RunResult as O, SubCommandsRecord as P, ExtractedFields as R, LogStream as S, NonRunnableCommand as T, toCamelCase as U, extractFields as V, toKebabCase as W, GlobalCleanupContext as _, EffectContext as a, LogEntry as b, arg as c, CleanupContext as d, CollectedLogs as f, GlobalArgs as g, Example as h, CustomCompletion as i, RunnableCommand as j, RunResultFailure as k, AnyCommand as l, CommandBase as m, CompletionMeta as n, PromptMeta as o, Command as p, CompletionType as r, PromptType as s, ArgMeta as t, ArgsSchema as u, GlobalSetupContext as v, MainOptions as w, LogLevel as x, IsEmpty as y, ResolvedFieldMeta as z };
-//# sourceMappingURL=arg-registry-MVWOAcvw.d.cts.map
+export { LogStream as A, SetupContext as B, Example as C, IsEmpty as D, GlobalSetupContext as E, RunCommandOptions as F, lazy as G, SubCommandsRecord as H, RunResult as I, UnknownKeysMode as J, ExtractedFields as K, RunResultFailure as L, MainOptions as M, NonRunnableCommand as N, LogEntry as O, PromptResolver as P, toKebabCase as Q, RunResultSuccess as R, CommandBase as S, GlobalCleanupContext as T, LazyCommand as U, SubCommandValue as V, isLazyCommand as W, getUnknownKeysMode as X, extractFields as Y, toCamelCase as Z, AnyCommand as _, EffectContext as a, CollectedLogs as b, arg as c, ResolvedExpandCandidate as d, CompletionDirectiveMask as f, DynamicCompletionResult as g, DynamicCompletionResolver as h, CustomCompletion as i, Logger as j, LogLevel as k, ExpandCandidate as l, DynamicCompletionContext as m, CompletionMeta as n, PromptMeta as o, DynamicCompletionCandidate as p, ResolvedFieldMeta as q, CompletionType as r, PromptType as s, ArgMeta as t, ExpandCompletion as u, ArgsSchema as v, GlobalArgs as w, Command as x, CleanupContext as y, RunnableCommand as z };
+//# sourceMappingURL=arg-registry--NRaNFJM.d.cts.map

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

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

package/dist/{arg-registry-Cd6xnjHa.d.ts → arg-registry-6E0WHOh_.d.ts}

@@ -455,19 +455,139 @@ interface RunResultFailure {
  */
 type RunResult<T = unknown> = RunResultSuccess<T> | RunResultFailure;
 //#endregion
+//#region src/core/dynamic-completion-types.d.ts
+/**
+ * Types for in-process dynamic value completion.
+ *
+ * A `resolve` callback registered on `arg(...)` receives parsed context
+ * (other arg values typed so far, previous values supplied to the same
+ * option, the current word being completed, target shell) and returns
+ * candidates. The callback runs inside the `__complete` command, so static
+ * shell scripts delegate to `<program> __complete` for any spec that uses
+ * `resolve`.
+ *
+ * Defined under `core/` (not `completion/`) so `arg-registry.ts` can
+ * reference the resolver type without crossing the lint-enforced
+ * `completion → core` boundary.
+ */
+/** Bitmask combining `CompletionDirective` values. */
+type CompletionDirectiveMask = number;
+interface DynamicCompletionContext {
+  /** Word being completed. `--field=` inline prefix is stripped before this is set. */
+  currentWord: string;
+  /** Target shell formatting requested by the caller. */
+  shell: "bash" | "zsh" | "fish";
+  /**
+   * Best-effort parsed values of OTHER args on the same command, keyed by
+   * camelCase name. Includes positionals and other options. Zod validation
+   * is NOT applied; values are raw strings (or arrays of raw strings for
+   * array-typed options/variadic positionals).
+   */
+  parsedArgs: Readonly<Record<string, unknown>>;
+  /**
+   * Values already supplied for the SAME option/positional being completed.
+   * Useful for de-duplicating repeated array options.
+   */
+  previousValues: readonly string[];
+  /**
+   * Subcommand path from root (e.g. ["api"]). Reflects what the user
+   * actually typed — aliases are NOT resolved to their canonical names, so
+   * resolvers that branch on the path should accept every alias they care
+   * about.
+   */
+  subcommandPath: readonly string[];
+}
+interface DynamicCompletionCandidate {
+  value: string;
+  description?: string;
+}
+interface DynamicCompletionResult {
+  /** Candidates to surface. Strings or `{value, description}` objects. */
+  candidates: Array<string | DynamicCompletionCandidate>;
+  /**
+   * Optional directive override. When omitted, defaults to
+   * `FilterPrefix | NoFileCompletion` (matches `choices` behaviour).
+   */
+  directive?: CompletionDirectiveMask;
+}
+type DynamicCompletionResolver = (ctx: DynamicCompletionContext) => DynamicCompletionResult | Promise<DynamicCompletionResult>;
+//#endregion
+//#region src/core/expand-completion-types.d.ts
+/**
+ * Types for "expand" completion — candidates that are pre-enumerated at
+ * script-generation time and inlined into the static shell script.
+ *
+ * The user provides `dependsOn` (sibling arg names that must have static
+ * `choices` or an enum schema) and `enumerate(deps)`. politty walks the
+ * cartesian product of the dependsOn values, calls `enumerate` for each
+ * combination, and emits a case lookup keyed on the runtime values of those
+ * args. No Node process is spawned on TAB.
+ *
+ * Defined under `core/` (not `completion/`) so `arg-registry.ts` can
+ * reference these types without crossing the lint-enforced
+ * `completion → core` boundary.
+ */
+/** Candidate returned by an `enumerate` callback. */
+interface ExpandCandidate {
+  value: string;
+  description?: string;
+}
+/** Resolved candidate stored on a {@link ValueCompletion} after enumeration. */
+interface ResolvedExpandCandidate {
+  value: string;
+  description?: string;
+}
+/**
+ * User-facing spec attached to `completion.custom.expand`.
+ *
+ * `dependsOn` lists sibling args (camelCase names) whose values determine
+ * which candidates apply. Each named arg must have a static set of values —
+ * either an explicit `completion.custom.choices` or an enum schema. The
+ * order of `dependsOn` is the order in which `deps` keys are exposed to
+ * `enumerate`.
+ *
+ * `enumerate` runs once per cartesian-product combination at the time the
+ * shell script is generated (e.g. when the user runs `<program> completion
+ * zsh`). It must be a pure function of `deps`; politty does not retain it
+ * for runtime use.
+ */
+interface ExpandCompletion {
+  dependsOn: readonly string[];
+  enumerate: (deps: Readonly<Record<string, string>>) => ReadonlyArray<string | ExpandCandidate>;
+}
+//#endregion
 //#region src/core/arg-registry.d.ts
 /**
  * Built-in completion types
  */
 type CompletionType = "file" | "directory" | "none";
 /**
- * Custom completion specification
+ * Custom completion specification.
+ *
+ * `choices`, `shellCommand`, `resolve`, and `expand` are mutually exclusive —
+ * specifying more than one throws when the field metadata is resolved.
  */
 interface CustomCompletion {
   /** Static list of choices for completion */
   choices?: string[];
   /** Shell command to execute for dynamic completion */
   shellCommand?: string;
+  /**
+   * In-process JS callback for dynamic completion. Receives parsed context
+   * (other arg values typed so far, previously supplied values for this same
+   * option) and returns candidates. Static shell scripts delegate to
+   * `<program> __complete` whenever this is set.
+   */
+  resolve?: DynamicCompletionResolver;
+  /**
+   * Pre-enumerated completion baked into the generated shell script. The
+   * candidate list is computed at script-generation time by calling
+   * `enumerate` for every combination of the sibling arg values listed in
+   * `dependsOn` (each must have a static `choices` or enum schema). The
+   * shell then dispatches via a case lookup keyed by the runtime values of
+   * those args — no Node process is spawned on TAB.
+   */
+  expand?: ExpandCompletion;
 }
 /**
  * Completion metadata for an argument
@@ -794,5 +914,5 @@ type ValidateArgMeta<M, TValue = unknown> = M extends {
 declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M, z.output<T>>): T;
 //#endregion
-export { RunResultSuccess as A, UnknownKeysMode as B, Logger as C, RunCommandOptions as D, PromptResolver as E, LazyCommand as F, getUnknownKeysMode as H, isLazyCommand as I, lazy as L, SetupContext as M, SubCommandValue as N, RunResult as O, SubCommandsRecord as P, ExtractedFields as R, LogStream as S, NonRunnableCommand as T, toCamelCase as U, extractFields as V, toKebabCase as W, GlobalCleanupContext as _, EffectContext as a, LogEntry as b, arg as c, CleanupContext as d, CollectedLogs as f, GlobalArgs as g, Example as h, CustomCompletion as i, RunnableCommand as j, RunResultFailure as k, AnyCommand as l, CommandBase as m, CompletionMeta as n, PromptMeta as o, Command as p, CompletionType as r, PromptType as s, ArgMeta as t, ArgsSchema as u, GlobalSetupContext as v, MainOptions as w, LogLevel as x, IsEmpty as y, ResolvedFieldMeta as z };
-//# sourceMappingURL=arg-registry-Cd6xnjHa.d.ts.map
+export { LogStream as A, SetupContext as B, Example as C, IsEmpty as D, GlobalSetupContext as E, RunCommandOptions as F, lazy as G, SubCommandsRecord as H, RunResult as I, UnknownKeysMode as J, ExtractedFields as K, RunResultFailure as L, MainOptions as M, NonRunnableCommand as N, LogEntry as O, PromptResolver as P, toKebabCase as Q, RunResultSuccess as R, CommandBase as S, GlobalCleanupContext as T, LazyCommand as U, SubCommandValue as V, isLazyCommand as W, getUnknownKeysMode as X, extractFields as Y, toCamelCase as Z, AnyCommand as _, EffectContext as a, CollectedLogs as b, arg as c, ResolvedExpandCandidate as d, CompletionDirectiveMask as f, DynamicCompletionResult as g, DynamicCompletionResolver as h, CustomCompletion as i, Logger as j, LogLevel as k, ExpandCandidate as l, DynamicCompletionContext as m, CompletionMeta as n, PromptMeta as o, DynamicCompletionCandidate as p, ResolvedFieldMeta as q, CompletionType as r, PromptType as s, ArgMeta as t, ExpandCompletion as u, ArgsSchema as v, GlobalArgs as w, Command as x, CleanupContext as y, RunnableCommand as z };
+//# sourceMappingURL=arg-registry-6E0WHOh_.d.ts.map

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

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

package/dist/augment.d.cts

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

package/dist/augment.d.ts

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

package/dist/completion/index.cjs

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

package/dist/completion/index.d.cts

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

package/dist/completion/index.d.ts

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

package/dist/completion/index.js

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