@dedesfr/prompter 0.6.15 → 0.7.1

package/dist/core/completions/generators/zsh-generator.d.ts

@@ -0,0 +1,44 @@
+import { CompletionGenerator, CommandDefinition } from '../types.js';
+/**
+ * Generates Zsh completion scripts for the Prompter CLI.
+ * Follows Zsh completion system conventions using the _prompter function.
+ */
+export declare class ZshGenerator implements CompletionGenerator {
+    readonly shell: "zsh";
+    /**
+     * Generate a Zsh completion script
+     *
+     * @param commands - Command definitions to generate completions for
+     * @returns Zsh completion script as a string
+     */
+    generate(commands: CommandDefinition[]): string;
+    /**
+     * Generate completion function for a specific command
+     */
+    private generateCommandFunction;
+    /**
+     * Generate completion function for a subcommand
+     */
+    private generateSubcommandFunction;
+    /**
+     * Generate flag specification for _arguments
+     */
+    private generateFlagSpec;
+    /**
+     * Generate positional argument specification
+     */
+    private generatePositionalSpec;
+    /**
+     * Escape special characters in descriptions
+     */
+    private escapeDescription;
+    /**
+     * Escape special characters in values
+     */
+    private escapeValue;
+    /**
+     * Sanitize command names for use in function names
+     */
+    private sanitizeFunctionName;
+}
+//# sourceMappingURL=zsh-generator.d.ts.map

package/dist/core/completions/generators/zsh-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zsh-generator.d.ts","sourceRoot":"","sources":["../../../../src/core/completions/generators/zsh-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAkB,MAAM,aAAa,CAAC;AAGrF;;;GAGG;AACH,qBAAa,YAAa,YAAW,mBAAmB;IACtD,QAAQ,CAAC,KAAK,EAAG,KAAK,CAAU;IAEhC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM;IAkE/C;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiF/B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA4BlC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgCxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAG7B"}

package/dist/core/completions/generators/zsh-generator.js

@@ -0,0 +1,250 @@
+import { ZSH_DYNAMIC_HELPERS } from '../templates/zsh-templates.js';
+/**
+ * Generates Zsh completion scripts for the Prompter CLI.
+ * Follows Zsh completion system conventions using the _prompter function.
+ */
+export class ZshGenerator {
+    shell = 'zsh';
+    /**
+     * Generate a Zsh completion script
+     *
+     * @param commands - Command definitions to generate completions for
+     * @returns Zsh completion script as a string
+     */
+    generate(commands) {
+        // Build command list using push() for loop clarity
+        const commandLines = [];
+        for (const cmd of commands) {
+            const escapedDesc = this.escapeDescription(cmd.description);
+            commandLines.push(`    '${cmd.name}:${escapedDesc}'`);
+        }
+        const commandList = commandLines.join('\n');
+        // Build command cases using push() for loop clarity
+        const commandCaseLines = [];
+        for (const cmd of commands) {
+            commandCaseLines.push(`        ${cmd.name})`);
+            commandCaseLines.push(`          _prompter_${this.sanitizeFunctionName(cmd.name)}`);
+            commandCaseLines.push('          ;;');
+        }
+        const commandCases = commandCaseLines.join('\n');
+        // Build command functions using push() for loop clarity
+        const commandFunctionLines = [];
+        for (const cmd of commands) {
+            commandFunctionLines.push(...this.generateCommandFunction(cmd));
+            commandFunctionLines.push('');
+        }
+        const commandFunctions = commandFunctionLines.join('\n');
+        // Dynamic completion helpers from template
+        const helpers = ZSH_DYNAMIC_HELPERS;
+        // Assemble final script with template literal
+        return `#compdef prompter
+
+# Zsh completion script for Prompter CLI
+# Auto-generated - do not edit manually
+
+_prompter() {
+  local context state line
+  typeset -A opt_args
+
+  local -a commands
+  commands=(
+${commandList}
+  )
+
+  _arguments -C \\
+    "1: :->command" \\
+    "*::arg:->args"
+
+  case $state in
+    command)
+      _describe "prompter command" commands
+      ;;
+    args)
+      case $words[1] in
+${commandCases}
+      esac
+      ;;
+  esac
+}
+
+${commandFunctions}
+${helpers}
+compdef _prompter prompter
+`;
+    }
+    /**
+     * Generate completion function for a specific command
+     */
+    generateCommandFunction(cmd) {
+        const funcName = `_prompter_${this.sanitizeFunctionName(cmd.name)}`;
+        const lines = [];
+        lines.push(`${funcName}() {`);
+        // If command has subcommands, handle them
+        if (cmd.subcommands && cmd.subcommands.length > 0) {
+            lines.push('  local context state line');
+            lines.push('  typeset -A opt_args');
+            lines.push('');
+            lines.push('  local -a subcommands');
+            lines.push('  subcommands=(');
+            for (const subcmd of cmd.subcommands) {
+                const escapedDesc = this.escapeDescription(subcmd.description);
+                lines.push(`    '${subcmd.name}:${escapedDesc}'`);
+            }
+            lines.push('  )');
+            lines.push('');
+            lines.push('  _arguments -C \\');
+            // Add command flags
+            for (const flag of cmd.flags) {
+                lines.push('    ' + this.generateFlagSpec(flag) + ' \\');
+            }
+            lines.push('    "1: :->subcommand" \\');
+            lines.push('    "*::arg:->args"');
+            lines.push('');
+            lines.push('  case $state in');
+            lines.push('    subcommand)');
+            lines.push('      _describe "subcommand" subcommands');
+            lines.push('      ;;');
+            lines.push('    args)');
+            lines.push('      case $words[1] in');
+            for (const subcmd of cmd.subcommands) {
+                lines.push(`        ${subcmd.name})`);
+                lines.push(`          _prompter_${this.sanitizeFunctionName(cmd.name)}_${this.sanitizeFunctionName(subcmd.name)}`);
+                lines.push('          ;;');
+            }
+            lines.push('      esac');
+            lines.push('      ;;');
+            lines.push('  esac');
+        }
+        else {
+            // Command without subcommands
+            lines.push('  _arguments \\');
+            // Add flags
+            for (const flag of cmd.flags) {
+                lines.push('    ' + this.generateFlagSpec(flag) + ' \\');
+            }
+            // Add positional argument completion
+            if (cmd.acceptsPositional) {
+                const positionalSpec = this.generatePositionalSpec(cmd.positionalType);
+                lines.push('    ' + positionalSpec);
+            }
+            else {
+                // Remove trailing backslash from last flag
+                if (lines[lines.length - 1].endsWith(' \\')) {
+                    lines[lines.length - 1] = lines[lines.length - 1].slice(0, -2);
+                }
+            }
+        }
+        lines.push('}');
+        // Generate subcommand functions if they exist
+        if (cmd.subcommands) {
+            for (const subcmd of cmd.subcommands) {
+                lines.push('');
+                lines.push(...this.generateSubcommandFunction(cmd.name, subcmd));
+            }
+        }
+        return lines;
+    }
+    /**
+     * Generate completion function for a subcommand
+     */
+    generateSubcommandFunction(parentName, subcmd) {
+        const funcName = `_prompter_${this.sanitizeFunctionName(parentName)}_${this.sanitizeFunctionName(subcmd.name)}`;
+        const lines = [];
+        lines.push(`${funcName}() {`);
+        lines.push('  _arguments \\');
+        // Add flags
+        for (const flag of subcmd.flags) {
+            lines.push('    ' + this.generateFlagSpec(flag) + ' \\');
+        }
+        // Add positional argument completion
+        if (subcmd.acceptsPositional) {
+            const positionalSpec = this.generatePositionalSpec(subcmd.positionalType);
+            lines.push('    ' + positionalSpec);
+        }
+        else {
+            // Remove trailing backslash from last flag
+            if (lines[lines.length - 1].endsWith(' \\')) {
+                lines[lines.length - 1] = lines[lines.length - 1].slice(0, -2);
+            }
+        }
+        lines.push('}');
+        return lines;
+    }
+    /**
+     * Generate flag specification for _arguments
+     */
+    generateFlagSpec(flag) {
+        const parts = [];
+        // Handle mutually exclusive short and long forms
+        if (flag.short) {
+            parts.push(`'(-${flag.short} --${flag.name})'{-${flag.short},--${flag.name}}'`);
+        }
+        else {
+            parts.push(`'--${flag.name}`);
+        }
+        // Add description
+        const escapedDesc = this.escapeDescription(flag.description);
+        parts.push(`[${escapedDesc}]`);
+        // Add value completion if flag takes a value
+        if (flag.takesValue) {
+            if (flag.values && flag.values.length > 0) {
+                // Provide specific value completions
+                const valueList = flag.values.map(v => this.escapeValue(v)).join(' ');
+                parts.push(`:value:(${valueList})`);
+            }
+            else {
+                // Generic value placeholder
+                parts.push(':value:');
+            }
+        }
+        // Close the quote (needed for both short and long forms)
+        parts.push("'");
+        return parts.join('');
+    }
+    /**
+     * Generate positional argument specification
+     */
+    generatePositionalSpec(positionalType) {
+        switch (positionalType) {
+            case 'change-id':
+                return "'*: :_prompter_complete_changes'";
+            case 'spec-id':
+                return "'*: :_prompter_complete_specs'";
+            case 'change-or-spec-id':
+                return "'*: :_prompter_complete_items'";
+            case 'path':
+                return "'*:path:_files'";
+            case 'shell':
+                return "'*:shell:(zsh bash fish powershell)'";
+            default:
+                return "'*: :_default'";
+        }
+    }
+    /**
+     * Escape special characters in descriptions
+     */
+    escapeDescription(desc) {
+        return desc
+            .replace(/\\/g, '\\\\')
+            .replace(/'/g, "\\'")
+            .replace(/\[/g, '\\[')
+            .replace(/]/g, '\\]')
+            .replace(/:/g, '\\:');
+    }
+    /**
+     * Escape special characters in values
+     */
+    escapeValue(value) {
+        return value
+            .replace(/\\/g, '\\\\')
+            .replace(/'/g, "\\'")
+            .replace(/ /g, '\\ ');
+    }
+    /**
+     * Sanitize command names for use in function names
+     */
+    sanitizeFunctionName(name) {
+        return name.replace(/-/g, '_');
+    }
+}
+//# sourceMappingURL=zsh-generator.js.map

package/dist/core/completions/generators/zsh-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zsh-generator.js","sourceRoot":"","sources":["../../../../src/core/completions/generators/zsh-generator.ts"],"names":[],"mappings":"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"}

package/dist/core/completions/templates/bash-templates.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Static template strings for Bash completion scripts.
+ * These are Bash-specific helper functions that never change.
+ */
+export declare const BASH_DYNAMIC_HELPERS = "# Dynamic completion helpers\n\n_prompter_complete_changes() {\n  local changes\n  changes=$(prompter __complete changes 2>/dev/null | cut -f1)\n  COMPREPLY=($(compgen -W \"$changes\" -- \"$cur\"))\n}\n\n_prompter_complete_specs() {\n  local specs\n  specs=$(prompter __complete specs 2>/dev/null | cut -f1)\n  COMPREPLY=($(compgen -W \"$specs\" -- \"$cur\"))\n}\n\n_prompter_complete_items() {\n  local items\n  items=$(prompter __complete changes 2>/dev/null | cut -f1; prompter __complete specs 2>/dev/null | cut -f1)\n  COMPREPLY=($(compgen -W \"$items\" -- \"$cur\"))\n}";
+//# sourceMappingURL=bash-templates.d.ts.map

package/dist/core/completions/templates/bash-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-templates.d.ts","sourceRoot":"","sources":["../../../../src/core/completions/templates/bash-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,oBAAoB,okBAkB/B,CAAC"}

package/dist/core/completions/templates/bash-templates.js

@@ -0,0 +1,24 @@
+/**
+ * Static template strings for Bash completion scripts.
+ * These are Bash-specific helper functions that never change.
+ */
+export const BASH_DYNAMIC_HELPERS = `# Dynamic completion helpers
+
+_prompter_complete_changes() {
+  local changes
+  changes=$(prompter __complete changes 2>/dev/null | cut -f1)
+  COMPREPLY=($(compgen -W "$changes" -- "$cur"))
+}
+
+_prompter_complete_specs() {
+  local specs
+  specs=$(prompter __complete specs 2>/dev/null | cut -f1)
+  COMPREPLY=($(compgen -W "$specs" -- "$cur"))
+}
+
+_prompter_complete_items() {
+  local items
+  items=$(prompter __complete changes 2>/dev/null | cut -f1; prompter __complete specs 2>/dev/null | cut -f1)
+  COMPREPLY=($(compgen -W "$items" -- "$cur"))
+}`;
+//# sourceMappingURL=bash-templates.js.map

package/dist/core/completions/templates/bash-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-templates.js","sourceRoot":"","sources":["../../../../src/core/completions/templates/bash-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;EAkBlC,CAAC"}

package/dist/core/completions/templates/fish-templates.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Static template strings for Fish completion scripts.
+ * These are Fish-specific helper functions that never change.
+ */
+export declare const FISH_STATIC_HELPERS = "# Helper function to check if a subcommand is present\nfunction __fish_prompter_using_subcommand\n    set -l cmd (commandline -opc)\n    set -e cmd[1]\n    for i in $argv\n        if contains -- $i $cmd\n            return 0\n        end\n    end\n    return 1\nend\n\nfunction __fish_prompter_no_subcommand\n    set -l cmd (commandline -opc)\n    test (count $cmd) -eq 1\nend";
+export declare const FISH_DYNAMIC_HELPERS = "# Dynamic completion helpers\n\nfunction __fish_prompter_changes\n    prompter __complete changes 2>/dev/null | while read -l id desc\n        printf '%s\\t%s\\n' \"$id\" \"$desc\"\n    end\nend\n\nfunction __fish_prompter_specs\n    prompter __complete specs 2>/dev/null | while read -l id desc\n        printf '%s\\t%s\\n' \"$id\" \"$desc\"\n    end\nend\n\nfunction __fish_prompter_items\n    __fish_prompter_changes\n    __fish_prompter_specs\nend";
+//# sourceMappingURL=fish-templates.d.ts.map

package/dist/core/completions/templates/fish-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fish-templates.d.ts","sourceRoot":"","sources":["../../../../src/core/completions/templates/fish-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,mBAAmB,6XAe5B,CAAC;AAEL,eAAO,MAAM,oBAAoB,wcAiB7B,CAAC"}

package/dist/core/completions/templates/fish-templates.js

@@ -0,0 +1,39 @@
+/**
+ * Static template strings for Fish completion scripts.
+ * These are Fish-specific helper functions that never change.
+ */
+export const FISH_STATIC_HELPERS = `# Helper function to check if a subcommand is present
+function __fish_prompter_using_subcommand
+    set -l cmd (commandline -opc)
+    set -e cmd[1]
+    for i in $argv
+        if contains -- $i $cmd
+            return 0
+        end
+    end
+    return 1
+end
+
+function __fish_prompter_no_subcommand
+    set -l cmd (commandline -opc)
+    test (count $cmd) -eq 1
+end`;
+export const FISH_DYNAMIC_HELPERS = `# Dynamic completion helpers
+
+function __fish_prompter_changes
+    prompter __complete changes 2>/dev/null | while read -l id desc
+        printf '%s\\t%s\\n' "$id" "$desc"
+    end
+end
+
+function __fish_prompter_specs
+    prompter __complete specs 2>/dev/null | while read -l id desc
+        printf '%s\\t%s\\n' "$id" "$desc"
+    end
+end
+
+function __fish_prompter_items
+    __fish_prompter_changes
+    __fish_prompter_specs
+end`;
+//# sourceMappingURL=fish-templates.js.map

package/dist/core/completions/templates/fish-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fish-templates.js","sourceRoot":"","sources":["../../../../src/core/completions/templates/fish-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;IAe/B,CAAC;AAEL,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;IAiBhC,CAAC"}

package/dist/core/completions/templates/powershell-templates.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Static template strings for PowerShell completion scripts.
+ * These are PowerShell-specific helper functions that never change.
+ */
+export declare const POWERSHELL_DYNAMIC_HELPERS = "# Dynamic completion helpers\n\nfunction Get-PrompterChanges {\n    $output = prompter __complete changes 2>$null\n    if ($output) {\n        $output | ForEach-Object {\n            ($_ -split \"\\t\")[0]\n        }\n    }\n}\n\nfunction Get-PrompterSpecs {\n    $output = prompter __complete specs 2>$null\n    if ($output) {\n        $output | ForEach-Object {\n            ($_ -split \"\\t\")[0]\n        }\n    }\n}\n";
+//# sourceMappingURL=powershell-templates.d.ts.map

package/dist/core/completions/templates/powershell-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"powershell-templates.d.ts","sourceRoot":"","sources":["../../../../src/core/completions/templates/powershell-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,0BAA0B,2aAmBtC,CAAC"}

package/dist/core/completions/templates/powershell-templates.js

@@ -0,0 +1,25 @@
+/**
+ * Static template strings for PowerShell completion scripts.
+ * These are PowerShell-specific helper functions that never change.
+ */
+export const POWERSHELL_DYNAMIC_HELPERS = `# Dynamic completion helpers
+
+function Get-PrompterChanges {
+    $output = prompter __complete changes 2>$null
+    if ($output) {
+        $output | ForEach-Object {
+            ($_ -split "\\t")[0]
+        }
+    }
+}
+
+function Get-PrompterSpecs {
+    $output = prompter __complete specs 2>$null
+    if ($output) {
+        $output | ForEach-Object {
+            ($_ -split "\\t")[0]
+        }
+    }
+}
+`;
+//# sourceMappingURL=powershell-templates.js.map

package/dist/core/completions/templates/powershell-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"powershell-templates.js","sourceRoot":"","sources":["../../../../src/core/completions/templates/powershell-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;CAmBzC,CAAC"}

package/dist/core/completions/templates/zsh-templates.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Static template strings for Zsh completion scripts.
+ * These are Zsh-specific helper functions that never change.
+ */
+export declare const ZSH_DYNAMIC_HELPERS = "# Dynamic completion helpers\n\n# Use prompter __complete to get available changes\n_prompter_complete_changes() {\n  local -a changes\n  while IFS=$'\\t' read -r id desc; do\n    changes+=(\"$id:$desc\")\n  done < <(prompter __complete changes 2>/dev/null)\n  _describe \"change\" changes\n}\n\n# Use prompter __complete to get available specs\n_prompter_complete_specs() {\n  local -a specs\n  while IFS=$'\\t' read -r id desc; do\n    specs+=(\"$id:$desc\")\n  done < <(prompter __complete specs 2>/dev/null)\n  _describe \"spec\" specs\n}\n\n# Get both changes and specs\n_prompter_complete_items() {\n  local -a items\n  while IFS=$'\\t' read -r id desc; do\n    items+=(\"$id:$desc\")\n  done < <(prompter __complete changes 2>/dev/null)\n  while IFS=$'\\t' read -r id desc; do\n    items+=(\"$id:$desc\")\n  done < <(prompter __complete specs 2>/dev/null)\n  _describe \"item\" items\n}";
+//# sourceMappingURL=zsh-templates.d.ts.map

package/dist/core/completions/templates/zsh-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zsh-templates.d.ts","sourceRoot":"","sources":["../../../../src/core/completions/templates/zsh-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,mBAAmB,k4BA8B9B,CAAC"}

package/dist/core/completions/templates/zsh-templates.js

@@ -0,0 +1,36 @@
+/**
+ * Static template strings for Zsh completion scripts.
+ * These are Zsh-specific helper functions that never change.
+ */
+export const ZSH_DYNAMIC_HELPERS = `# Dynamic completion helpers
+
+# Use prompter __complete to get available changes
+_prompter_complete_changes() {
+  local -a changes
+  while IFS=$'\\t' read -r id desc; do
+    changes+=("$id:$desc")
+  done < <(prompter __complete changes 2>/dev/null)
+  _describe "change" changes
+}
+
+# Use prompter __complete to get available specs
+_prompter_complete_specs() {
+  local -a specs
+  while IFS=$'\\t' read -r id desc; do
+    specs+=("$id:$desc")
+  done < <(prompter __complete specs 2>/dev/null)
+  _describe "spec" specs
+}
+
+# Get both changes and specs
+_prompter_complete_items() {
+  local -a items
+  while IFS=$'\\t' read -r id desc; do
+    items+=("$id:$desc")
+  done < <(prompter __complete changes 2>/dev/null)
+  while IFS=$'\\t' read -r id desc; do
+    items+=("$id:$desc")
+  done < <(prompter __complete specs 2>/dev/null)
+  _describe "item" items
+}`;
+//# sourceMappingURL=zsh-templates.js.map

package/dist/core/completions/templates/zsh-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zsh-templates.js","sourceRoot":"","sources":["../../../../src/core/completions/templates/zsh-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BjC,CAAC"}

package/dist/core/completions/types.d.ts

@@ -0,0 +1,78 @@
+import { SupportedShell } from '../../utils/shell-detection.js';
+/**
+ * Definition of a command-line flag/option
+ */
+export interface FlagDefinition {
+    /**
+     * Flag name without dashes (e.g., "json", "strict", "no-interactive")
+     */
+    name: string;
+    /**
+     * Short flag name without dash (e.g., "y" for "-y")
+     */
+    short?: string;
+    /**
+     * Human-readable description of what the flag does
+     */
+    description: string;
+    /**
+     * Whether the flag takes an argument value
+     */
+    takesValue?: boolean;
+    /**
+     * Possible values for the flag (for completion suggestions)
+     */
+    values?: string[];
+}
+/**
+ * Definition of a CLI command
+ */
+export interface CommandDefinition {
+    /**
+     * Command name (e.g., "init", "validate", "show")
+     */
+    name: string;
+    /**
+     * Human-readable description of the command
+     */
+    description: string;
+    /**
+     * Flags/options supported by this command
+     */
+    flags: FlagDefinition[];
+    /**
+     * Subcommands (e.g., "change show", "spec validate")
+     */
+    subcommands?: CommandDefinition[];
+    /**
+     * Whether this command accepts a positional argument (e.g., item name, path)
+     */
+    acceptsPositional?: boolean;
+    /**
+     * Type of positional argument for dynamic completion
+     * - 'change-id': Complete with active change IDs
+     * - 'spec-id': Complete with spec IDs
+     * - 'change-or-spec-id': Complete with both changes and specs
+     * - 'path': Complete with file paths
+     * - 'shell': Complete with supported shell names
+     * - undefined: No specific completion
+     */
+    positionalType?: 'change-id' | 'spec-id' | 'change-or-spec-id' | 'path' | 'shell';
+}
+/**
+ * Interface for shell-specific completion script generators
+ */
+export interface CompletionGenerator {
+    /**
+     * The shell type this generator targets
+     */
+    readonly shell: SupportedShell;
+    /**
+     * Generate the completion script content
+     *
+     * @param commands - Command definitions to generate completions for
+     * @returns The shell-specific completion script as a string
+     */
+    generate(commands: CommandDefinition[]): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/completions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/completions/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,cAAc,EAAE,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAElC;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,mBAAmB,GAAG,MAAM,GAAG,OAAO,CAAC;CACnF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAE/B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC;CACjD"}

package/dist/core/completions/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/completions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/completions/types.ts"],"names":[],"mappings":""}