politty 0.4.0 → 0.4.2

package/dist/{extractor-DsJ6hYqQ.d.cts → value-completion-resolver-BQgHsX7b.d.cts}

@@ -1,4 +1,4 @@
-import { d as Command, n as ResolvedFieldMeta, s as AnyCommand } from "./schema-extractor-DyfK21m_.cjs";
+import { d as Command, n as ResolvedFieldMeta, s as AnyCommand } from "./schema-extractor-DFaAZzaY.cjs";
 import { z } from "zod";
 
 //#region src/completion/types.d.ts
@@ -22,16 +22,17 @@ interface CompletionOptions {
 /**
  * Value completion specification for shell scripts
  */
-interface 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) */
+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;
-  /** File extension filters (for "file" type) */
+} & ({
   extensions?: string[];
-}
+  matcher?: never;
+} | {
+  /** Glob patterns for file matching (for "file" type) */matcher?: string[];
+  extensions?: never;
+});
 /**
  * Information about a completable option
  */
@@ -67,6 +68,8 @@ interface CompletablePositional {
   description?: string | undefined;
   /** Whether required */
   required: boolean;
+  /** Whether this positional accepts multiple values (array type) */
+  variadic?: boolean | undefined;
   /** Value completion specification */
   valueCompletion?: ValueCompletion | undefined;
 }
@@ -188,26 +191,26 @@ interface CandidateResult {
   candidates: CompletionCandidate[];
   /** Directive flags for shell behavior */
   directive: number;
+  /** File extensions for shell-native filtering (e.g., ["json", "yaml"]) */
+  fileExtensions?: string[] | undefined;
+  /** Glob patterns for shell-native file matching (e.g., [".env.*"]) */
+  fileMatchers?: string[] | undefined;
 }
 /**
  * Generate completion candidates based on context
  */
 declare function generateCandidates(context: CompletionContext): CandidateResult;
-/**
- * Format candidates as shell completion output
- *
- * Format: value\tdescription (tab-separated)
- * Last line: :directive_code
- */
-declare function formatOutput(result: CandidateResult): string;
 //#endregion
 //#region src/completion/dynamic/complete-command.d.ts
 /**
  * Schema for the __complete command
- *
- * Arguments after -- are collected as the completion arguments
  */
 declare const completeArgsSchema: z.ZodObject<{
+  shell: z.ZodEnum<{
+    bash: "bash";
+    zsh: "zsh";
+    fish: "fish";
+  }>;
   args: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 type CompleteArgs = z.infer<typeof completeArgsSchema>;
@@ -224,6 +227,25 @@ declare function createDynamicCompleteCommand(rootCommand: AnyCommand, _programN
  */
 declare function hasCompleteCommand(command: AnyCommand): boolean;
 //#endregion
+//#region src/completion/dynamic/shell-formatter.d.ts
+/**
+ * Options for shell-specific formatting
+ */
+interface ShellFormatOptions {
+  /** Target shell type */
+  shell: ShellType;
+  /** Current word being completed (used for prefix filtering) */
+  currentWord: string;
+  /** For bash: the prefix before '=' in --opt=value completions */
+  inlinePrefix?: string | undefined;
+}
+/**
+ * Format completion candidates for the specified shell
+ *
+ * @returns Shell-ready output string (lines separated by newline, last line is :directive)
+ */
+declare function formatForShell(result: CandidateResult, options: ShellFormatOptions): string;
+//#endregion
 //#region src/completion/extractor.d.ts
 /**
  * Extract positional arguments from a command
@@ -234,5 +256,36 @@ declare function extractPositionals(command: AnyCommand): ResolvedFieldMeta[];
  */
 declare function extractCompletionData(command: AnyCommand, programName: string): CompletionData;
 //#endregion
-export { CompletionOptions as _, CandidateResult as a, formatOutput as c, CompletionType as d, parseCompletionContext as f, CompletionGenerator as g, CompletionData as h, hasCompleteCommand as i, generateCandidates as l, CompletableSubcommand as m, extractPositionals as n, CompletionCandidate as o, CompletableOption as p, createDynamicCompleteCommand as r, CompletionDirective as s, extractCompletionData as t, CompletionContext as u, CompletionResult as v, ShellType as y };
-//# sourceMappingURL=extractor-DsJ6hYqQ.d.cts.map
+//#region src/completion/value-completion-resolver.d.ts
+/**
+ * Minimal field interface needed for resolving value completion.
+ * Both ResolvedFieldMeta and inline context-parser types satisfy this.
+ */
+interface ValueCompletionField {
+  completion?: ({
+    type?: string;
+    custom?: {
+      choices?: string[];
+      shellCommand?: string;
+    };
+  } & ({
+    extensions?: string[];
+    matcher?: never;
+  } | {
+    matcher?: string[];
+    extensions?: never;
+  })) | undefined;
+  enumValues?: string[] | undefined;
+}
+/**
+ * Resolve value completion from field metadata
+ *
+ * Priority:
+ * 1. Explicit custom completion (choices or shellCommand)
+ * 2. Explicit completion type (file, directory, none)
+ * 3. Auto-detected enum values from schema
+ */
+declare function resolveValueCompletion(field: ValueCompletionField): ValueCompletion | undefined;
+//#endregion
+export { ShellType as S, CompletableSubcommand as _, ShellFormatOptions as a, CompletionOptions as b, hasCompleteCommand as c, CompletionDirective as d, generateCandidates as f, CompletableOption as g, parseCompletionContext as h, extractPositionals as i, CandidateResult as l, CompletionType as m, resolveValueCompletion as n, formatForShell as o, CompletionContext as p, extractCompletionData as r, createDynamicCompleteCommand as s, ValueCompletionField as t, CompletionCandidate as u, CompletionData as v, CompletionResult as x, CompletionGenerator as y };
+//# sourceMappingURL=value-completion-resolver-BQgHsX7b.d.cts.map

package/dist/value-completion-resolver-BQgHsX7b.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-completion-resolver-BQgHsX7b.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"],"mappings":"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"}

package/dist/{extractor-CCi4rjSI.d.ts → value-completion-resolver-C9LTGr0O.d.ts}

@@ -1,4 +1,4 @@
-import { d as Command, n as ResolvedFieldMeta, s as AnyCommand } from "./schema-extractor-CHiBRT39.js";
+import { d as Command, n as ResolvedFieldMeta, s as AnyCommand } from "./schema-extractor-n9288WJ6.js";
 import { z } from "zod";
 
 //#region src/completion/types.d.ts
@@ -22,16 +22,17 @@ interface CompletionOptions {
 /**
  * Value completion specification for shell scripts
  */
-interface 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) */
+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;
-  /** File extension filters (for "file" type) */
+} & ({
   extensions?: string[];
-}
+  matcher?: never;
+} | {
+  /** Glob patterns for file matching (for "file" type) */matcher?: string[];
+  extensions?: never;
+});
 /**
  * Information about a completable option
  */
@@ -67,6 +68,8 @@ interface CompletablePositional {
   description?: string | undefined;
   /** Whether required */
   required: boolean;
+  /** Whether this positional accepts multiple values (array type) */
+  variadic?: boolean | undefined;
   /** Value completion specification */
   valueCompletion?: ValueCompletion | undefined;
 }
@@ -188,26 +191,26 @@ interface CandidateResult {
   candidates: CompletionCandidate[];
   /** Directive flags for shell behavior */
   directive: number;
+  /** File extensions for shell-native filtering (e.g., ["json", "yaml"]) */
+  fileExtensions?: string[] | undefined;
+  /** Glob patterns for shell-native file matching (e.g., [".env.*"]) */
+  fileMatchers?: string[] | undefined;
 }
 /**
  * Generate completion candidates based on context
  */
 declare function generateCandidates(context: CompletionContext): CandidateResult;
-/**
- * Format candidates as shell completion output
- *
- * Format: value\tdescription (tab-separated)
- * Last line: :directive_code
- */
-declare function formatOutput(result: CandidateResult): string;
 //#endregion
 //#region src/completion/dynamic/complete-command.d.ts
 /**
  * Schema for the __complete command
- *
- * Arguments after -- are collected as the completion arguments
  */
 declare const completeArgsSchema: z.ZodObject<{
+  shell: z.ZodEnum<{
+    bash: "bash";
+    zsh: "zsh";
+    fish: "fish";
+  }>;
   args: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 type CompleteArgs = z.infer<typeof completeArgsSchema>;
@@ -224,6 +227,25 @@ declare function createDynamicCompleteCommand(rootCommand: AnyCommand, _programN
  */
 declare function hasCompleteCommand(command: AnyCommand): boolean;
 //#endregion
+//#region src/completion/dynamic/shell-formatter.d.ts
+/**
+ * Options for shell-specific formatting
+ */
+interface ShellFormatOptions {
+  /** Target shell type */
+  shell: ShellType;
+  /** Current word being completed (used for prefix filtering) */
+  currentWord: string;
+  /** For bash: the prefix before '=' in --opt=value completions */
+  inlinePrefix?: string | undefined;
+}
+/**
+ * Format completion candidates for the specified shell
+ *
+ * @returns Shell-ready output string (lines separated by newline, last line is :directive)
+ */
+declare function formatForShell(result: CandidateResult, options: ShellFormatOptions): string;
+//#endregion
 //#region src/completion/extractor.d.ts
 /**
  * Extract positional arguments from a command
@@ -234,5 +256,36 @@ declare function extractPositionals(command: AnyCommand): ResolvedFieldMeta[];
  */
 declare function extractCompletionData(command: AnyCommand, programName: string): CompletionData;
 //#endregion
-export { CompletionOptions as _, CandidateResult as a, formatOutput as c, CompletionType as d, parseCompletionContext as f, CompletionGenerator as g, CompletionData as h, hasCompleteCommand as i, generateCandidates as l, CompletableSubcommand as m, extractPositionals as n, CompletionCandidate as o, CompletableOption as p, createDynamicCompleteCommand as r, CompletionDirective as s, extractCompletionData as t, CompletionContext as u, CompletionResult as v, ShellType as y };
-//# sourceMappingURL=extractor-CCi4rjSI.d.ts.map
+//#region src/completion/value-completion-resolver.d.ts
+/**
+ * Minimal field interface needed for resolving value completion.
+ * Both ResolvedFieldMeta and inline context-parser types satisfy this.
+ */
+interface ValueCompletionField {
+  completion?: ({
+    type?: string;
+    custom?: {
+      choices?: string[];
+      shellCommand?: string;
+    };
+  } & ({
+    extensions?: string[];
+    matcher?: never;
+  } | {
+    matcher?: string[];
+    extensions?: never;
+  })) | undefined;
+  enumValues?: string[] | undefined;
+}
+/**
+ * Resolve value completion from field metadata
+ *
+ * Priority:
+ * 1. Explicit custom completion (choices or shellCommand)
+ * 2. Explicit completion type (file, directory, none)
+ * 3. Auto-detected enum values from schema
+ */
+declare function resolveValueCompletion(field: ValueCompletionField): ValueCompletion | undefined;
+//#endregion
+export { ShellType as S, CompletableSubcommand as _, ShellFormatOptions as a, CompletionOptions as b, hasCompleteCommand as c, CompletionDirective as d, generateCandidates as f, CompletableOption as g, parseCompletionContext as h, extractPositionals as i, CandidateResult as l, CompletionType as m, resolveValueCompletion as n, formatForShell as o, CompletionContext as p, extractCompletionData as r, createDynamicCompleteCommand as s, ValueCompletionField as t, CompletionCandidate as u, CompletionData as v, CompletionResult as x, CompletionGenerator as y };
+//# sourceMappingURL=value-completion-resolver-C9LTGr0O.d.ts.map

package/dist/value-completion-resolver-C9LTGr0O.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-completion-resolver-C9LTGr0O.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"],"mappings":"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"}