politty 0.4.14 → 0.4.16

package/README.md

@@ -9,7 +9,7 @@ From simple scripts to complex CLI tools with subcommands, validation, and auto-
 - **Zod Native**: Use Zod schemas directly for argument definition and validation
 - **Type Safety**: Full TypeScript support with automatic type inference for parsed arguments
 - **Flexible Argument Definition**: Support for positional arguments, flags, aliases, arrays, and environment variable fallbacks
-- **Subcommands**: Build Git-style nested subcommands (with lazy loading support)
+- **Subcommands**: Build Git-style nested subcommands (with lazy loading and alias support)
 - **Lifecycle Management**: Guaranteed `setup` → `run` → `cleanup` execution order
 - **Signal Handling**: Proper SIGINT/SIGTERM handling with guaranteed cleanup execution
 - **Auto Help Generation**: Automatically generate help text from definitions
@@ -149,6 +149,7 @@ import { arg, defineCommand, runMain } from "politty";
 const initCommand = defineCommand({
   name: "init",
   description: "Initialize a project",
+  aliases: ["i"],
   args: z.object({
     template: arg(z.string().default("default"), {
       alias: "t",
@@ -163,6 +164,7 @@ const initCommand = defineCommand({
 const buildCommand = defineCommand({
   name: "build",
   description: "Build the project",
+  aliases: ["b"],
   args: z.object({
     output: arg(z.string().default("dist"), {
       alias: "o",
@@ -194,7 +196,9 @@ Example usage:
 
 ```bash
 $ my-cli init -t react
+$ my-cli i -t react        # alias for init
 $ my-cli build -o out -m
+$ my-cli b -o out -m        # alias for build
 $ my-cli --help
 ```
 
@@ -246,6 +250,7 @@ Define a command.
 | `name`        | `string`                      | Command name        |
 | `description` | `string?`                     | Command description |
 | `args`        | `ZodSchema`                   | Argument schema     |
+| `aliases`     | `string[]?`                   | Command aliases     |
 | `subCommands` | `Record<string, Command>?`    | Subcommands         |
 | `setup`       | `(context) => Promise<void>?` | Setup hook          |
 | `run`         | `(args) => T?`                | Run function        |
@@ -393,6 +398,7 @@ The `playground/` directory contains many examples:
 - `10-subcommands` - Subcommands
 - `12-discriminated-union` - Discriminated Union
 - `21-lazy-subcommands` - Lazy loading
+- `26-command-alias` - Command aliases
 
 ## License
 

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

@@ -47,6 +47,30 @@ interface ResolvedFieldMeta {
   completion?: CompletionMeta | undefined;
   /** Prompt metadata from arg() for interactive input */
   prompt?: PromptMeta | undefined;
+  /**
+   * Negation configuration for this boolean field.
+   *
+   * - String (e.g. `"disable-cache"`): the default `--no-<cliName>` form is
+   *   suppressed and only `--<negation>` (plus its camelCase variant) is
+   *   accepted as the negation flag.
+   * - `true`: the default `--no-<cliName>` form is accepted **and** shown in
+   *   help, generated docs, and shell completions.
+   * - `false`: neither the default `--no-<cliName>` nor any custom name is
+   *   accepted; the field only responds to the positive flag.
+   * - `undefined`: the default `--no-<cliName>` is accepted by the parser
+   *   but hidden from help/docs/completions.
+   *
+   * Only applies to boolean fields; populated as `undefined` otherwise.
+   */
+  negation?: string | boolean | undefined;
+  /**
+   * Derived display name (no `--` prefix) for the negation flag in help,
+   * generated docs, and shell completions. `undefined` means the negation
+   * is hidden from those surfaces. Computed from `negation` + `cliName`.
+   */
+  negationDisplay?: string | undefined;
+  /** Description shown for the negation option in help/docs. */
+  negationDescription?: string | undefined;
   /** Side-effect callback from arg() metadata */
   effect?: ((value: unknown, context: EffectContext) => void | PromiseLike<void>) | undefined;
 }
@@ -246,6 +270,8 @@ interface CommandBase<TArgsSchema extends ArgsSchema | undefined = undefined, TA
   name: string;
   /** Command description */
   description?: string | undefined;
+  /** Alternative names for this command (used as subcommand aliases) */
+  aliases?: string[] | undefined;
   /** Argument schema (preserves the original Zod schema type) */
   args: TArgsSchema;
   /** Subcommands */
@@ -258,6 +284,13 @@ interface CommandBase<TArgsSchema extends ArgsSchema | undefined = undefined, TA
   notes?: string | undefined;
   /** Example usages for this command */
   examples?: Example[] | undefined;
+  /**
+   * @internal
+   * Hook invoked once at the top of `runMain`, before any parsing. Used
+   * by `withCompletionCommand` to fire its detached background-refresh
+   * spawn. Best-effort; never throws.
+   */
+  runMainHook?: ((argv: readonly string[]) => void) | undefined;
 }
 /**
  * A command with a run function
@@ -576,6 +609,58 @@ interface BaseArgMeta<TValue = unknown> {
    * ```
    */
   prompt?: PromptMeta;
+  /**
+   * Control the boolean negation option.
+   *
+   * Boolean fields automatically accept `--no-<cliName>` (and the camelCase
+   * `--no<Name>` form) to set the value to `false`. By default this form is
+   * accepted by the parser but hidden from help, generated docs, and shell
+   * completions. This option lets you customize or expose that behavior:
+   *
+   * - `string` — replaces the auto-generated `--no-*` form with a custom
+   *   name. The default `--no-*` is no longer recognized.
+   * - `true`  — opt-in to advertising the default `--no-<cliName>` form in
+   *   help, generated docs, and shell completions. Parser behavior is
+   *   unchanged.
+   * - `false` — disables negation entirely; neither the default `--no-*`
+   *   nor any custom name is accepted.
+   *
+   * String values follow the same naming conventions as `cliName`
+   * (kebab-case is recommended). Only valid on boolean fields; setting
+   * `negation` on a non-boolean field is a type error and raises a
+   * runtime error during command parsing.
+   *
+   * @example
+   * ```ts
+   * // Custom negation name
+   * cache: arg(z.boolean().default(true), {
+   *   description: "Enable caching",
+   *   negation: "disable-cache",
+   * })
+   * // Accepts: --cache (true), --disable-cache (false)
+   * // No longer accepts: --no-cache
+   *
+   * // Expose default `--no-X` in help/docs/completion
+   * verbose: arg(z.boolean().default(false), {
+   *   negation: true,
+   * })
+   * // Help shows `--verbose / --no-verbose`
+   *
+   * // Disable negation entirely
+   * dryRun: arg(z.boolean().default(false), {
+   *   negation: false,
+   * })
+   * // Accepts: --dry-run (true)
+   * // No longer accepts: --no-dry-run
+   * ```
+   */
+  negation?: string | boolean;
+  /**
+   * Description shown for the negation option in help and generated docs.
+   * Only meaningful when `negation` is set to a custom name string or `true`.
+   * Disallowed when `negation` is `false`.
+   */
+  negationDescription?: string;
   /**
    * Side-effect callback executed after argument parsing and validation.
    * Runs before the command lifecycle (setup/run/cleanup).
@@ -662,23 +747,52 @@ type ContainsReservedAlias<A> = [A] extends [never] ? false : A extends "h" | "H
 type ReservedAliasTypeError<M> = { [K in keyof M]: M[K] } & {
   __typeError: "Alias 'h' or 'H' requires overrideBuiltinAlias: true";
 };
+type NegationTypeError<M> = { [K in keyof M]: M[K] } & {
+  __typeError: "negation/negationDescription can only be used on boolean fields";
+};
 type AliasFieldOf<M> = M extends {
   alias: infer A;
 } ? A : never;
 type HiddenAliasFieldOf<M> = M extends {
   hiddenAlias: infer H;
 } ? H : never;
+/**
+ * Check whether a Zod output type is a (possibly optional) boolean.
+ * Strips `undefined` to allow `z.boolean().optional()`. Requires both
+ * `boolean extends NonNullable<T>` (so `z.literal(true)` is rejected — the full
+ * `boolean` domain is needed) and `NonNullable<T> extends boolean` (so unions
+ * such as `z.union([z.boolean(), z.string()])` are rejected at the type level
+ * to match the runtime check).
+ */
+type IsBooleanField<T> = boolean extends NonNullable<T> ? ([NonNullable<T>] extends [boolean] ? true : false) : false;
+/**
+ * Detect whether `M` has `K` set to a non-undefined value.
+ *
+ * When `M` is inferred from a literal such as `{ negation: "off" }`,
+ * `M["negation"]` is `"off"` (without `undefined`), so this returns `true`.
+ * When `M` is the wider `ArgMeta` type, `M["negation"]` is
+ * `string | boolean | undefined`, so this returns `false` and avoids
+ * false-positive type errors on broadly-typed meta values.
+ */
+type HasExplicit<M, K extends string> = K extends keyof M ? undefined extends M[K] ? false : true : false;
+/**
+ * Reject `negation` / `negationDescription` on non-boolean fields.
+ * Uses {@link HasExplicit} so the error only fires when the user explicitly
+ * sets the field on a narrowly-inferred meta literal.
+ */
+type ValidateNegation<M, TValue> = HasExplicit<M, "negation"> extends true ? IsBooleanField<TValue> extends true ? M : NegationTypeError<M> : HasExplicit<M, "negationDescription"> extends true ? IsBooleanField<TValue> extends true ? M : NegationTypeError<M> : M;
 /**
  * Type helper to validate ArgMeta.
  * Forces a type error when a reserved alias ("h" / "H") is used without
  * `overrideBuiltinAlias: true`, whether the alias is provided as a string
  * or as part of an array, and whether it appears in `alias` or `hiddenAlias`.
+ * Also rejects `negation` / `negationDescription` on non-boolean fields.
  */
-type ValidateArgMeta<M> = M extends {
+type ValidateArgMeta<M, TValue = unknown> = M extends {
   overrideBuiltinAlias: true;
-} ? M : ContainsReservedAlias<AliasFieldOf<M>> extends true ? ReservedAliasTypeError<M> : ContainsReservedAlias<HiddenAliasFieldOf<M>> extends true ? ReservedAliasTypeError<M> : M;
+} ? ValidateNegation<M, TValue> : ContainsReservedAlias<AliasFieldOf<M>> extends true ? ReservedAliasTypeError<M> : ContainsReservedAlias<HiddenAliasFieldOf<M>> extends true ? ReservedAliasTypeError<M> : ValidateNegation<M, TValue>;
 declare function arg<T extends z.ZodType>(schema: T): T;
-declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M>): T;
+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-CkPDokIu.d.ts.map
+//# sourceMappingURL=arg-registry-Cd6xnjHa.d.ts.map

package/dist/arg-registry-Cd6xnjHa.d.ts.map

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

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

@@ -47,6 +47,30 @@ interface ResolvedFieldMeta {
   completion?: CompletionMeta | undefined;
   /** Prompt metadata from arg() for interactive input */
   prompt?: PromptMeta | undefined;
+  /**
+   * Negation configuration for this boolean field.
+   *
+   * - String (e.g. `"disable-cache"`): the default `--no-<cliName>` form is
+   *   suppressed and only `--<negation>` (plus its camelCase variant) is
+   *   accepted as the negation flag.
+   * - `true`: the default `--no-<cliName>` form is accepted **and** shown in
+   *   help, generated docs, and shell completions.
+   * - `false`: neither the default `--no-<cliName>` nor any custom name is
+   *   accepted; the field only responds to the positive flag.
+   * - `undefined`: the default `--no-<cliName>` is accepted by the parser
+   *   but hidden from help/docs/completions.
+   *
+   * Only applies to boolean fields; populated as `undefined` otherwise.
+   */
+  negation?: string | boolean | undefined;
+  /**
+   * Derived display name (no `--` prefix) for the negation flag in help,
+   * generated docs, and shell completions. `undefined` means the negation
+   * is hidden from those surfaces. Computed from `negation` + `cliName`.
+   */
+  negationDisplay?: string | undefined;
+  /** Description shown for the negation option in help/docs. */
+  negationDescription?: string | undefined;
   /** Side-effect callback from arg() metadata */
   effect?: ((value: unknown, context: EffectContext) => void | PromiseLike<void>) | undefined;
 }
@@ -246,6 +270,8 @@ interface CommandBase<TArgsSchema extends ArgsSchema | undefined = undefined, TA
   name: string;
   /** Command description */
   description?: string | undefined;
+  /** Alternative names for this command (used as subcommand aliases) */
+  aliases?: string[] | undefined;
   /** Argument schema (preserves the original Zod schema type) */
   args: TArgsSchema;
   /** Subcommands */
@@ -258,6 +284,13 @@ interface CommandBase<TArgsSchema extends ArgsSchema | undefined = undefined, TA
   notes?: string | undefined;
   /** Example usages for this command */
   examples?: Example[] | undefined;
+  /**
+   * @internal
+   * Hook invoked once at the top of `runMain`, before any parsing. Used
+   * by `withCompletionCommand` to fire its detached background-refresh
+   * spawn. Best-effort; never throws.
+   */
+  runMainHook?: ((argv: readonly string[]) => void) | undefined;
 }
 /**
  * A command with a run function
@@ -576,6 +609,58 @@ interface BaseArgMeta<TValue = unknown> {
    * ```
    */
   prompt?: PromptMeta;
+  /**
+   * Control the boolean negation option.
+   *
+   * Boolean fields automatically accept `--no-<cliName>` (and the camelCase
+   * `--no<Name>` form) to set the value to `false`. By default this form is
+   * accepted by the parser but hidden from help, generated docs, and shell
+   * completions. This option lets you customize or expose that behavior:
+   *
+   * - `string` — replaces the auto-generated `--no-*` form with a custom
+   *   name. The default `--no-*` is no longer recognized.
+   * - `true`  — opt-in to advertising the default `--no-<cliName>` form in
+   *   help, generated docs, and shell completions. Parser behavior is
+   *   unchanged.
+   * - `false` — disables negation entirely; neither the default `--no-*`
+   *   nor any custom name is accepted.
+   *
+   * String values follow the same naming conventions as `cliName`
+   * (kebab-case is recommended). Only valid on boolean fields; setting
+   * `negation` on a non-boolean field is a type error and raises a
+   * runtime error during command parsing.
+   *
+   * @example
+   * ```ts
+   * // Custom negation name
+   * cache: arg(z.boolean().default(true), {
+   *   description: "Enable caching",
+   *   negation: "disable-cache",
+   * })
+   * // Accepts: --cache (true), --disable-cache (false)
+   * // No longer accepts: --no-cache
+   *
+   * // Expose default `--no-X` in help/docs/completion
+   * verbose: arg(z.boolean().default(false), {
+   *   negation: true,
+   * })
+   * // Help shows `--verbose / --no-verbose`
+   *
+   * // Disable negation entirely
+   * dryRun: arg(z.boolean().default(false), {
+   *   negation: false,
+   * })
+   * // Accepts: --dry-run (true)
+   * // No longer accepts: --no-dry-run
+   * ```
+   */
+  negation?: string | boolean;
+  /**
+   * Description shown for the negation option in help and generated docs.
+   * Only meaningful when `negation` is set to a custom name string or `true`.
+   * Disallowed when `negation` is `false`.
+   */
+  negationDescription?: string;
   /**
    * Side-effect callback executed after argument parsing and validation.
    * Runs before the command lifecycle (setup/run/cleanup).
@@ -662,23 +747,52 @@ type ContainsReservedAlias<A> = [A] extends [never] ? false : A extends "h" | "H
 type ReservedAliasTypeError<M> = { [K in keyof M]: M[K] } & {
   __typeError: "Alias 'h' or 'H' requires overrideBuiltinAlias: true";
 };
+type NegationTypeError<M> = { [K in keyof M]: M[K] } & {
+  __typeError: "negation/negationDescription can only be used on boolean fields";
+};
 type AliasFieldOf<M> = M extends {
   alias: infer A;
 } ? A : never;
 type HiddenAliasFieldOf<M> = M extends {
   hiddenAlias: infer H;
 } ? H : never;
+/**
+ * Check whether a Zod output type is a (possibly optional) boolean.
+ * Strips `undefined` to allow `z.boolean().optional()`. Requires both
+ * `boolean extends NonNullable<T>` (so `z.literal(true)` is rejected — the full
+ * `boolean` domain is needed) and `NonNullable<T> extends boolean` (so unions
+ * such as `z.union([z.boolean(), z.string()])` are rejected at the type level
+ * to match the runtime check).
+ */
+type IsBooleanField<T> = boolean extends NonNullable<T> ? ([NonNullable<T>] extends [boolean] ? true : false) : false;
+/**
+ * Detect whether `M` has `K` set to a non-undefined value.
+ *
+ * When `M` is inferred from a literal such as `{ negation: "off" }`,
+ * `M["negation"]` is `"off"` (without `undefined`), so this returns `true`.
+ * When `M` is the wider `ArgMeta` type, `M["negation"]` is
+ * `string | boolean | undefined`, so this returns `false` and avoids
+ * false-positive type errors on broadly-typed meta values.
+ */
+type HasExplicit<M, K extends string> = K extends keyof M ? undefined extends M[K] ? false : true : false;
+/**
+ * Reject `negation` / `negationDescription` on non-boolean fields.
+ * Uses {@link HasExplicit} so the error only fires when the user explicitly
+ * sets the field on a narrowly-inferred meta literal.
+ */
+type ValidateNegation<M, TValue> = HasExplicit<M, "negation"> extends true ? IsBooleanField<TValue> extends true ? M : NegationTypeError<M> : HasExplicit<M, "negationDescription"> extends true ? IsBooleanField<TValue> extends true ? M : NegationTypeError<M> : M;
 /**
  * Type helper to validate ArgMeta.
  * Forces a type error when a reserved alias ("h" / "H") is used without
  * `overrideBuiltinAlias: true`, whether the alias is provided as a string
  * or as part of an array, and whether it appears in `alias` or `hiddenAlias`.
+ * Also rejects `negation` / `negationDescription` on non-boolean fields.
  */
-type ValidateArgMeta<M> = M extends {
+type ValidateArgMeta<M, TValue = unknown> = M extends {
   overrideBuiltinAlias: true;
-} ? M : ContainsReservedAlias<AliasFieldOf<M>> extends true ? ReservedAliasTypeError<M> : ContainsReservedAlias<HiddenAliasFieldOf<M>> extends true ? ReservedAliasTypeError<M> : M;
+} ? ValidateNegation<M, TValue> : ContainsReservedAlias<AliasFieldOf<M>> extends true ? ReservedAliasTypeError<M> : ContainsReservedAlias<HiddenAliasFieldOf<M>> extends true ? ReservedAliasTypeError<M> : ValidateNegation<M, TValue>;
 declare function arg<T extends z.ZodType>(schema: T): T;
-declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M>): T;
+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-r5wYN6qd.d.cts.map
+//# sourceMappingURL=arg-registry-MVWOAcvw.d.cts.map

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

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

package/dist/augment.d.cts

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

package/dist/augment.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"augment.d.cts","names":[],"sources":["../src/augment.ts"],"mappings":";;;;YAiBY,UAAA;IACR,OAAA,GAAU,OAAA;EAAA;EAAA,UAGF,UAAA;IACR,WAAA;IACA,UAAA;IACA,WAAA;IACA,KAAA;IACA,WAAA;IACA,oBAAA;EAAA;AAAA"}
+{"version":3,"file":"augment.d.cts","names":[],"sources":["../src/augment.ts"],"mappings":";;;;YAiBY,UAAA;IACR,OAAA,GAAU,OAAO;EAAA;EAAA,UAGT,UAAA;IACR,WAAA;IACA,UAAA;IACA,WAAA;IACA,KAAA;IACA,WAAA;IACA,oBAAA;EAAA;AAAA"}

package/dist/augment.d.ts

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

package/dist/augment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"augment.d.ts","names":[],"sources":["../src/augment.ts"],"mappings":";;;;YAiBY,UAAA;IACR,OAAA,GAAU,OAAA;EAAA;EAAA,UAGF,UAAA;IACR,WAAA;IACA,UAAA;IACA,WAAA;IACA,KAAA;IACA,WAAA;IACA,oBAAA;EAAA;AAAA"}
+{"version":3,"file":"augment.d.ts","names":[],"sources":["../src/augment.ts"],"mappings":";;;;YAiBY,UAAA;IACR,OAAA,GAAU,OAAO;EAAA;EAAA,UAGT,UAAA;IACR,WAAA;IACA,UAAA;IACA,WAAA;IACA,KAAA;IACA,WAAA;IACA,oBAAA;EAAA;AAAA"}

package/dist/completion/index.cjs

@@ -1,9 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_completion = require('../completion-CAekGYS4.cjs');
+const require_completion = require('../completion-BlZxMSeU.cjs');
 
 exports.CompletionDirective = require_completion.CompletionDirective;
 exports.createCompletionCommand = require_completion.createCompletionCommand;
 exports.createDynamicCompleteCommand = require_completion.createDynamicCompleteCommand;
+exports.createRefreshCompletionCommand = require_completion.createRefreshCompletionCommand;
 exports.detectShell = require_completion.detectShell;
 exports.extractCompletionData = require_completion.extractCompletionData;
 exports.extractPositionals = require_completion.extractPositionals;

package/dist/completion/index.d.cts

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

package/dist/completion/index.d.ts

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

package/dist/completion/index.js

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