politty 0.3.0 → 0.3.2

package/dist/completion/index.d.cts

@@ -1,93 +1,8 @@
-import { d as Command, n as ResolvedFieldMeta, s as AnyCommand } from "../schema-extractor-CXeUTW_Z.cjs";
+import "../arg-registry-B4a4Fj7f.cjs";
+import { d as Command, s as AnyCommand } from "../schema-extractor-DyfK21m_.cjs";
+import { _ as CompletionOptions, a as CandidateResult, c as formatOutput, d as CompletionType, f as parseCompletionContext, g as CompletionGenerator, h as CompletionData, i as hasCompleteCommand, l as generateCandidates, m as CompletableSubcommand, n as extractPositionals, o as CompletionCandidate, p as CompletableOption, r as createDynamicCompleteCommand, s as CompletionDirective, t as extractCompletionData, u as CompletionContext, v as CompletionResult, y as ShellType } from "../extractor-DsJ6hYqQ.cjs";
 import { z } from "zod";
 
-//#region src/completion/types.d.ts
-/**
- * Supported shell types for completion
- */
-type ShellType = "bash" | "zsh" | "fish";
-/**
- * Options for completion generation
- */
-interface CompletionOptions {
-  /** The shell type to generate completion for */
-  shell: ShellType;
-  /** The command name as it will be invoked */
-  programName: string;
-  /** Include subcommand completions (default: true) */
-  includeSubcommands?: boolean;
-  /** Include description in completions where supported (default: true) */
-  includeDescriptions?: boolean;
-}
-/**
- * Information about a completable option
- */
-interface CompletableOption {
-  /** Long option name (e.g., "verbose") */
-  name: string;
-  /** CLI name (kebab-case, e.g., "dry-run") */
-  cliName: string;
-  /** Short alias (e.g., "v") */
-  alias?: string | undefined;
-  /** Description for completion */
-  description?: string | undefined;
-  /** Whether this option takes a value */
-  takesValue: boolean;
-  /** Type of value expected */
-  valueType: "string" | "number" | "boolean" | "array" | "unknown";
-  /** Whether the option is required */
-  required: boolean;
-}
-/**
- * Information about a subcommand for completion
- */
-interface CompletableSubcommand {
-  /** Subcommand name */
-  name: string;
-  /** Subcommand description */
-  description?: string | undefined;
-  /** Nested subcommands */
-  subcommands: CompletableSubcommand[];
-  /** Options for this subcommand */
-  options: CompletableOption[];
-}
-/**
- * Extracted completion data from a command
- */
-interface CompletionData {
-  /** The root command */
-  command: CompletableSubcommand;
-  /** Program name */
-  programName: string;
-  /** Global options (available to all subcommands) */
-  globalOptions: CompletableOption[];
-}
-/**
- * Result of completion generation
- */
-interface CompletionResult {
-  /** The generated completion script */
-  script: string;
-  /** The shell type this script is for */
-  shell: ShellType;
-  /** Instructions for installing the completion */
-  installInstructions: string;
-}
-/**
- * Generator function type for shell completions
- */
-type CompletionGenerator = (command: AnyCommand, options: CompletionOptions) => CompletionResult;
-//#endregion
-//#region src/completion/extractor.d.ts
-/**
- * Extract positional arguments from a command
- */
-declare function extractPositionals(command: AnyCommand): ResolvedFieldMeta[];
-/**
- * Extract completion data from a command tree
- */
-declare function extractCompletionData(command: AnyCommand, programName: string): CompletionData;
-//#endregion
 //#region src/completion/index.d.ts
 /**
  * Generate completion script for the specified shell
@@ -129,6 +44,13 @@ type CompletionArgs = z.infer<typeof completionArgsSchema>;
  * ```
  */
 declare function createCompletionCommand(rootCommand: AnyCommand, programName?: string): Command<typeof completionArgsSchema, CompletionArgs, any>;
+/**
+ * Options for withCompletionCommand
+ */
+interface WithCompletionOptions {
+  /** Override the program name (defaults to command.name) */
+  programName?: string;
+}
 /**
  * Wrap a command with a completion subcommand
  *
@@ -136,7 +58,7 @@ declare function createCompletionCommand(rootCommand: AnyCommand, programName?:
  * in its subCommands (e.g., for completion generation).
  *
  * @param command - The command to wrap
- * @param programName - Override the program name (defaults to command.name)
+ * @param options - Options including programName
  * @returns A new command with the completion subcommand added
  *
  * @example
@@ -149,7 +71,7 @@ declare function createCompletionCommand(rootCommand: AnyCommand, programName?:
  * );
  * ```
  */
-declare function withCompletionCommand<T extends AnyCommand>(command: T, programName?: string): T;
+declare function withCompletionCommand<T extends AnyCommand>(command: T, options?: string | WithCompletionOptions): T;
 //#endregion
-export { type CompletableOption, type CompletableSubcommand, type CompletionData, type CompletionGenerator, type CompletionOptions, type CompletionResult, type ShellType, createCompletionCommand, detectShell, extractCompletionData, extractPositionals, generateCompletion, getSupportedShells, withCompletionCommand };
+export { type CandidateResult, type CompletableOption, type CompletableSubcommand, type CompletionCandidate, type CompletionContext, type CompletionData, CompletionDirective, type CompletionGenerator, type CompletionOptions, type CompletionResult, type CompletionType, type ShellType, WithCompletionOptions, createCompletionCommand, createDynamicCompleteCommand, detectShell, extractCompletionData, extractPositionals, formatOutput, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, withCompletionCommand };
 //# sourceMappingURL=index.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/completion/types.ts","../../src/completion/extractor.ts","../../src/completion/index.ts"],"mappings":";;;;AASA;;;AAAA,KAAY,SAAA;;AAKZ;;UAAiB,iBAAA;EAEC;EAAhB,KAAA,EAAO,SAAA;EAAA;EAEP,WAAA;EAEA;EAAA,kBAAA;EAEmB;EAAnB,mBAAA;AAAA;;;;UAMe,iBAAA;EAIf;EAFA,IAAA;EAMA;EAJA,OAAA;EAQA;EANA,KAAA;EAQQ;EANR,WAAA;EAYe;EAVf,UAAA;;EAEA,SAAA;EAUA;EARA,QAAA;AAAA;;;;UAMe,qBAAA;EAQW;EAN1B,IAAA;EAY6B;EAV7B,WAAA;EAgBgC;EAdhC,WAAA,EAAa,qBAAA;EAUJ;EART,OAAA,EAAS,iBAAA;AAAA;;;;UAMM,cAAA;EAYgB;EAV/B,OAAA,EAAS,qBAAA;EAcO;EAZhB,WAAA;EAYA;EAVA,aAAA,EAAe,iBAAA;AAAA;;;AAkBjB;UAZiB,gBAAA;;EAEf,MAAA;EAYS;EAVT,KAAA,EAAO,SAAA;EAWY;EATnB,mBAAA;AAAA;;;;KAMU,mBAAA,IACV,OAAA,EAAS,UAAA,EACT,OAAA,EAAS,iBAAA,KACN,gBAAA;;;;;;iBChDW,kBAAA,CAAmB,OAAA,EAAS,UAAA,GAAa,iBAAA;;;;iBA4CzC,qBAAA,CAAsB,OAAA,EAAS,UAAA,EAAY,WAAA,WAAsB,cAAA;;;;;;iBClCjE,kBAAA,CACd,OAAA,EAAS,UAAA,EACT,OAAA,EAAS,iBAAA,GACR,gBAAA;;;;iBAgBa,kBAAA,CAAA,GAAsB,SAAA;;;;iBAOtB,WAAA,CAAA,GAAe,SAAA;;;;cAoBzB,oBAAA,EAAoB,CAAA,CAAA,SAAA;;;;;;;;KAkBrB,cAAA,GAAiB,CAAA,CAAE,KAAA,QAAa,oBAAA;;;AFzCrC;;;;;;;;;;AAYA;;;iBE8CgB,uBAAA,CACd,WAAA,EAAa,UAAA,EACb,WAAA,YAEC,OAAA,QAAe,oBAAA,EAAsB,cAAA;;;;;;;;;;;;;;;AD/FxC;;;;;;iBCkJgB,qBAAA,WAAgC,UAAA,CAAA,CAAY,OAAA,EAAS,CAAA,EAAG,WAAA,YAAuB,CAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/completion/index.ts"],"mappings":";;;;;;AA0GC;;;AAAA,iBAzCe,kBAAA,CACd,OAAA,EAAS,UAAA,EACT,OAAA,EAAS,iBAAA,GACR,gBAAA;;;;iBAgBa,kBAAA,CAAA,GAAsB,SAAA;;;;iBAOtB,WAAA,CAAA,GAAe,SAAA;;;;cAoBzB,oBAAA,EAAoB,CAAA,CAAA,SAAA;;;;;;;;KAkBrB,cAAA,GAAiB,CAAA,CAAE,KAAA,QAAa,oBAAA;;;;;;;;;;;;;;;;iBAiBrB,uBAAA,CACd,WAAA,EAAa,UAAA,EACb,WAAA,YAEC,OAAA,QAAe,oBAAA,EAAsB,cAAA;AAJxC;;;AAAA,UA8CiB,qBAAA;EA1CC;EA4ChB,WAAA;AAAA;;;;;;;;;;;AAFF;;;;;AAyBA;;;;;iBAAgB,qBAAA,WAAgC,UAAA,CAAA,CAC9C,OAAA,EAAS,CAAA,EACT,OAAA,YAAmB,qBAAA,GAClB,CAAA"}

package/dist/completion/index.d.ts

@@ -1,93 +1,8 @@
-import { d as Command, n as ResolvedFieldMeta, s as AnyCommand } from "../schema-extractor-Cl_D04BX.js";
+import "../arg-registry-C3GP-5C9.js";
+import { d as Command, s as AnyCommand } from "../schema-extractor-CHiBRT39.js";
+import { _ as CompletionOptions, a as CandidateResult, c as formatOutput, d as CompletionType, f as parseCompletionContext, g as CompletionGenerator, h as CompletionData, i as hasCompleteCommand, l as generateCandidates, m as CompletableSubcommand, n as extractPositionals, o as CompletionCandidate, p as CompletableOption, r as createDynamicCompleteCommand, s as CompletionDirective, t as extractCompletionData, u as CompletionContext, v as CompletionResult, y as ShellType } from "../extractor-CCi4rjSI.js";
 import { z } from "zod";
 
-//#region src/completion/types.d.ts
-/**
- * Supported shell types for completion
- */
-type ShellType = "bash" | "zsh" | "fish";
-/**
- * Options for completion generation
- */
-interface CompletionOptions {
-  /** The shell type to generate completion for */
-  shell: ShellType;
-  /** The command name as it will be invoked */
-  programName: string;
-  /** Include subcommand completions (default: true) */
-  includeSubcommands?: boolean;
-  /** Include description in completions where supported (default: true) */
-  includeDescriptions?: boolean;
-}
-/**
- * Information about a completable option
- */
-interface CompletableOption {
-  /** Long option name (e.g., "verbose") */
-  name: string;
-  /** CLI name (kebab-case, e.g., "dry-run") */
-  cliName: string;
-  /** Short alias (e.g., "v") */
-  alias?: string | undefined;
-  /** Description for completion */
-  description?: string | undefined;
-  /** Whether this option takes a value */
-  takesValue: boolean;
-  /** Type of value expected */
-  valueType: "string" | "number" | "boolean" | "array" | "unknown";
-  /** Whether the option is required */
-  required: boolean;
-}
-/**
- * Information about a subcommand for completion
- */
-interface CompletableSubcommand {
-  /** Subcommand name */
-  name: string;
-  /** Subcommand description */
-  description?: string | undefined;
-  /** Nested subcommands */
-  subcommands: CompletableSubcommand[];
-  /** Options for this subcommand */
-  options: CompletableOption[];
-}
-/**
- * Extracted completion data from a command
- */
-interface CompletionData {
-  /** The root command */
-  command: CompletableSubcommand;
-  /** Program name */
-  programName: string;
-  /** Global options (available to all subcommands) */
-  globalOptions: CompletableOption[];
-}
-/**
- * Result of completion generation
- */
-interface CompletionResult {
-  /** The generated completion script */
-  script: string;
-  /** The shell type this script is for */
-  shell: ShellType;
-  /** Instructions for installing the completion */
-  installInstructions: string;
-}
-/**
- * Generator function type for shell completions
- */
-type CompletionGenerator = (command: AnyCommand, options: CompletionOptions) => CompletionResult;
-//#endregion
-//#region src/completion/extractor.d.ts
-/**
- * Extract positional arguments from a command
- */
-declare function extractPositionals(command: AnyCommand): ResolvedFieldMeta[];
-/**
- * Extract completion data from a command tree
- */
-declare function extractCompletionData(command: AnyCommand, programName: string): CompletionData;
-//#endregion
 //#region src/completion/index.d.ts
 /**
  * Generate completion script for the specified shell
@@ -129,6 +44,13 @@ type CompletionArgs = z.infer<typeof completionArgsSchema>;
  * ```
  */
 declare function createCompletionCommand(rootCommand: AnyCommand, programName?: string): Command<typeof completionArgsSchema, CompletionArgs, any>;
+/**
+ * Options for withCompletionCommand
+ */
+interface WithCompletionOptions {
+  /** Override the program name (defaults to command.name) */
+  programName?: string;
+}
 /**
  * Wrap a command with a completion subcommand
  *
@@ -136,7 +58,7 @@ declare function createCompletionCommand(rootCommand: AnyCommand, programName?:
  * in its subCommands (e.g., for completion generation).
  *
  * @param command - The command to wrap
- * @param programName - Override the program name (defaults to command.name)
+ * @param options - Options including programName
  * @returns A new command with the completion subcommand added
  *
  * @example
@@ -149,7 +71,7 @@ declare function createCompletionCommand(rootCommand: AnyCommand, programName?:
  * );
  * ```
  */
-declare function withCompletionCommand<T extends AnyCommand>(command: T, programName?: string): T;
+declare function withCompletionCommand<T extends AnyCommand>(command: T, options?: string | WithCompletionOptions): T;
 //#endregion
-export { type CompletableOption, type CompletableSubcommand, type CompletionData, type CompletionGenerator, type CompletionOptions, type CompletionResult, type ShellType, createCompletionCommand, detectShell, extractCompletionData, extractPositionals, generateCompletion, getSupportedShells, withCompletionCommand };
+export { type CandidateResult, type CompletableOption, type CompletableSubcommand, type CompletionCandidate, type CompletionContext, type CompletionData, CompletionDirective, type CompletionGenerator, type CompletionOptions, type CompletionResult, type CompletionType, type ShellType, WithCompletionOptions, createCompletionCommand, createDynamicCompleteCommand, detectShell, extractCompletionData, extractPositionals, formatOutput, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, withCompletionCommand };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/completion/types.ts","../../src/completion/extractor.ts","../../src/completion/index.ts"],"mappings":";;;;AASA;;;AAAA,KAAY,SAAA;;AAKZ;;UAAiB,iBAAA;EAEC;EAAhB,KAAA,EAAO,SAAA;EAAA;EAEP,WAAA;EAEA;EAAA,kBAAA;EAEmB;EAAnB,mBAAA;AAAA;;;;UAMe,iBAAA;EAIf;EAFA,IAAA;EAMA;EAJA,OAAA;EAQA;EANA,KAAA;EAQQ;EANR,WAAA;EAYe;EAVf,UAAA;;EAEA,SAAA;EAUA;EARA,QAAA;AAAA;;;;UAMe,qBAAA;EAQW;EAN1B,IAAA;EAY6B;EAV7B,WAAA;EAgBgC;EAdhC,WAAA,EAAa,qBAAA;EAUJ;EART,OAAA,EAAS,iBAAA;AAAA;;;;UAMM,cAAA;EAYgB;EAV/B,OAAA,EAAS,qBAAA;EAcO;EAZhB,WAAA;EAYA;EAVA,aAAA,EAAe,iBAAA;AAAA;;;AAkBjB;UAZiB,gBAAA;;EAEf,MAAA;EAYS;EAVT,KAAA,EAAO,SAAA;EAWY;EATnB,mBAAA;AAAA;;;;KAMU,mBAAA,IACV,OAAA,EAAS,UAAA,EACT,OAAA,EAAS,iBAAA,KACN,gBAAA;;;;;;iBChDW,kBAAA,CAAmB,OAAA,EAAS,UAAA,GAAa,iBAAA;;;;iBA4CzC,qBAAA,CAAsB,OAAA,EAAS,UAAA,EAAY,WAAA,WAAsB,cAAA;;;;;;iBClCjE,kBAAA,CACd,OAAA,EAAS,UAAA,EACT,OAAA,EAAS,iBAAA,GACR,gBAAA;;;;iBAgBa,kBAAA,CAAA,GAAsB,SAAA;;;;iBAOtB,WAAA,CAAA,GAAe,SAAA;;;;cAoBzB,oBAAA,EAAoB,CAAA,CAAA,SAAA;;;;;;;;KAkBrB,cAAA,GAAiB,CAAA,CAAE,KAAA,QAAa,oBAAA;;;AFzCrC;;;;;;;;;;AAYA;;;iBE8CgB,uBAAA,CACd,WAAA,EAAa,UAAA,EACb,WAAA,YAEC,OAAA,QAAe,oBAAA,EAAsB,cAAA;;;;;;;;;;;;;;;AD/FxC;;;;;;iBCkJgB,qBAAA,WAAgC,UAAA,CAAA,CAAY,OAAA,EAAS,CAAA,EAAG,WAAA,YAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/completion/index.ts"],"mappings":";;;;;;AA0GC;;;AAAA,iBAzCe,kBAAA,CACd,OAAA,EAAS,UAAA,EACT,OAAA,EAAS,iBAAA,GACR,gBAAA;;;;iBAgBa,kBAAA,CAAA,GAAsB,SAAA;;;;iBAOtB,WAAA,CAAA,GAAe,SAAA;;;;cAoBzB,oBAAA,EAAoB,CAAA,CAAA,SAAA;;;;;;;;KAkBrB,cAAA,GAAiB,CAAA,CAAE,KAAA,QAAa,oBAAA;;;;;;;;;;;;;;;;iBAiBrB,uBAAA,CACd,WAAA,EAAa,UAAA,EACb,WAAA,YAEC,OAAA,QAAe,oBAAA,EAAsB,cAAA;AAJxC;;;AAAA,UA8CiB,qBAAA;EA1CC;EA4ChB,WAAA;AAAA;;;;;;;;;;;AAFF;;;;;AAyBA;;;;;iBAAgB,qBAAA,WAAgC,UAAA,CAAA,CAC9C,OAAA,EAAS,CAAA,EACT,OAAA,YAAmB,qBAAA,GAClB,CAAA"}