@dedesfr/prompter 0.9.0 → 1.0.0

package/src/core/completions/generators/bash-generator.ts

@@ -1,191 +0,0 @@
-import { CompletionGenerator, CommandDefinition, FlagDefinition } from '../types.js';
-import { BASH_DYNAMIC_HELPERS } from '../templates/bash-templates.js';
-
-/**
- * Generates Bash completion scripts for the Prompter CLI.
- * Follows Bash completion conventions using complete builtin and COMPREPLY array.
- */
-export class BashGenerator implements CompletionGenerator {
-  readonly shell = 'bash' as const;
-
-  /**
-   * Generate a Bash completion script
-   *
-   * @param commands - Command definitions to generate completions for
-   * @returns Bash completion script as a string
-   */
-  generate(commands: CommandDefinition[]): string {
-    // Build command list for top-level completions
-    const commandList = commands.map(c => this.escapeCommandName(c.name)).join(' ');
-
-    // Build command cases using push() for loop clarity
-    const caseLines: string[] = [];
-    for (const cmd of commands) {
-      caseLines.push(`    ${cmd.name})`);
-      caseLines.push(...this.generateCommandCase(cmd, '      '));
-      caseLines.push('      ;;');
-    }
-    const commandCases = caseLines.join('\n');
-
-    // Dynamic completion helpers from template
-    const helpers = BASH_DYNAMIC_HELPERS;
-
-    // Assemble final script with template literal
-    return `# Bash completion script for Prompter CLI
-# Auto-generated - do not edit manually
-
-_prompter_completion() {
-  local cur prev words cword
-
-  # Use _init_completion if available (from bash-completion package)
-  # The -n : option prevents colons from being treated as word separators
-  # (important for spec/change IDs that may contain colons)
-  # Otherwise, fall back to manual initialization
-  if declare -F _init_completion >/dev/null 2>&1; then
-    _init_completion -n : || return
-  else
-    # Manual fallback when bash-completion is not installed
-    COMPREPLY=()
-    cur="\${COMP_WORDS[COMP_CWORD]}"
-    prev="\${COMP_WORDS[COMP_CWORD-1]}"
-    words=("\${COMP_WORDS[@]}")
-    cword=$COMP_CWORD
-  fi
-
-  local cmd="\${words[1]}"
-  local subcmd="\${words[2]}"
-
-  # Top-level commands
-  if [[ $cword -eq 1 ]]; then
-    local commands="${commandList}"
-    COMPREPLY=($(compgen -W "$commands" -- "$cur"))
-    return 0
-  fi
-
-  # Command-specific completion
-  case "$cmd" in
-${commandCases}
-  esac
-
-  return 0
-}
-
-${helpers}
-complete -F _prompter_completion prompter
-`;
-  }
-
-  /**
-   * Generate completion case logic for a command
-   */
-  private generateCommandCase(cmd: CommandDefinition, indent: string): string[] {
-    const lines: string[] = [];
-
-    // Handle subcommands
-    if (cmd.subcommands && cmd.subcommands.length > 0) {
-      // First, check if user is typing a flag for the parent command
-      if (cmd.flags.length > 0) {
-        lines.push(`${indent}if [[ "$cur" == -* ]]; then`);
-        const flags = cmd.flags.map(f => {
-          const parts: string[] = [];
-          if (f.short) parts.push(`-${f.short}`);
-          parts.push(`--${f.name}`);
-          return parts.join(' ');
-        }).join(' ');
-        lines.push(`${indent}  local flags="${flags}"`);
-        lines.push(`${indent}  COMPREPLY=($(compgen -W "$flags" -- "$cur"))`);
-        lines.push(`${indent}  return 0`);
-        lines.push(`${indent}fi`);
-        lines.push('');
-      }
-
-      lines.push(`${indent}if [[ $cword -eq 2 ]]; then`);
-      lines.push(`${indent}  local subcommands="` + cmd.subcommands.map(s => this.escapeCommandName(s.name)).join(' ') + '"');
-      lines.push(`${indent}  COMPREPLY=($(compgen -W "$subcommands" -- "$cur"))`);
-      lines.push(`${indent}  return 0`);
-      lines.push(`${indent}fi`);
-      lines.push('');
-      lines.push(`${indent}case "$subcmd" in`);
-
-      for (const subcmd of cmd.subcommands) {
-        lines.push(`${indent}  ${subcmd.name})`);
-        lines.push(...this.generateArgumentCompletion(subcmd, indent + '    '));
-        lines.push(`${indent}    ;;`);
-      }
-
-      lines.push(`${indent}esac`);
-    } else {
-      // No subcommands, just complete arguments
-      lines.push(...this.generateArgumentCompletion(cmd, indent));
-    }
-
-    return lines;
-  }
-
-  /**
-   * Generate argument completion (flags and positional arguments)
-   */
-  private generateArgumentCompletion(cmd: CommandDefinition, indent: string): string[] {
-    const lines: string[] = [];
-
-    // Check for flag completion
-    if (cmd.flags.length > 0) {
-      lines.push(`${indent}if [[ "$cur" == -* ]]; then`);
-      const flags = cmd.flags.map(f => {
-        const parts: string[] = [];
-        if (f.short) parts.push(`-${f.short}`);
-        parts.push(`--${f.name}`);
-        return parts.join(' ');
-      }).join(' ');
-      lines.push(`${indent}  local flags="${flags}"`);
-      lines.push(`${indent}  COMPREPLY=($(compgen -W "$flags" -- "$cur"))`);
-      lines.push(`${indent}  return 0`);
-      lines.push(`${indent}fi`);
-      lines.push('');
-    }
-
-    // Handle positional completions
-    if (cmd.acceptsPositional) {
-      lines.push(...this.generatePositionalCompletion(cmd.positionalType, indent));
-    }
-
-    return lines;
-  }
-
-  /**
-   * Generate positional argument completion based on type
-   */
-  private generatePositionalCompletion(positionalType: string | undefined, indent: string): string[] {
-    const lines: string[] = [];
-
-    switch (positionalType) {
-      case 'change-id':
-        lines.push(`${indent}_prompter_complete_changes`);
-        break;
-      case 'spec-id':
-        lines.push(`${indent}_prompter_complete_specs`);
-        break;
-      case 'change-or-spec-id':
-        lines.push(`${indent}_prompter_complete_items`);
-        break;
-      case 'shell':
-        lines.push(`${indent}local shells="zsh bash fish powershell"`);
-        lines.push(`${indent}COMPREPLY=($(compgen -W "$shells" -- "$cur"))`);
-        break;
-      case 'path':
-        lines.push(`${indent}COMPREPLY=($(compgen -f -- "$cur"))`);
-        break;
-    }
-
-    return lines;
-  }
-
-
-  /**
-   * Escape command/subcommand names for safe use in Bash scripts
-   */
-  private escapeCommandName(name: string): string {
-    // Escape shell metacharacters to prevent command injection
-    return name.replace(/["\$`\\]/g, '\\$&');
-  }
-}

package/src/core/completions/generators/fish-generator.ts

@@ -1,188 +0,0 @@
-import { CompletionGenerator, CommandDefinition, FlagDefinition } from '../types.js';
-import { FISH_STATIC_HELPERS, FISH_DYNAMIC_HELPERS } from '../templates/fish-templates.js';
-
-/**
- * Generates Fish completion scripts for the Prompter CLI.
- * Follows Fish completion conventions using the complete command.
- */
-export class FishGenerator implements CompletionGenerator {
-  readonly shell = 'fish' as const;
-
-  /**
-   * Generate a Fish completion script
-   *
-   * @param commands - Command definitions to generate completions for
-   * @returns Fish completion script as a string
-   */
-  generate(commands: CommandDefinition[]): string {
-    // Build top-level commands using push() for loop clarity
-    const topLevelLines: string[] = [];
-    for (const cmd of commands) {
-      topLevelLines.push(`# ${cmd.name} command`);
-      topLevelLines.push(
-        `complete -c prompter -n '__fish_prompter_no_subcommand' -a '${cmd.name}' -d '${this.escapeDescription(cmd.description)}'`
-      );
-    }
-    const topLevelCommands = topLevelLines.join('\n');
-
-    // Build command-specific completions using push() for loop clarity
-    const commandCompletionLines: string[] = [];
-    for (const cmd of commands) {
-      commandCompletionLines.push(...this.generateCommandCompletions(cmd));
-      commandCompletionLines.push('');
-    }
-    const commandCompletions = commandCompletionLines.join('\n');
-
-    // Static helper functions from template
-    const helperFunctions = FISH_STATIC_HELPERS;
-
-    // Dynamic completion helpers from template
-    const dynamicHelpers = FISH_DYNAMIC_HELPERS;
-
-    // Assemble final script with template literal
-    return `# Fish completion script for Prompter CLI
-# Auto-generated - do not edit manually
-
-${helperFunctions}
-${dynamicHelpers}
-${topLevelCommands}
-
-${commandCompletions}`;
-  }
-
-  /**
-   * Generate completions for a specific command
-   */
-  private generateCommandCompletions(cmd: CommandDefinition): string[] {
-    const lines: string[] = [];
-
-    // If command has subcommands
-    if (cmd.subcommands && cmd.subcommands.length > 0) {
-      // Add subcommand completions
-      for (const subcmd of cmd.subcommands) {
-        lines.push(
-          `complete -c prompter -n '__fish_prompter_using_subcommand ${cmd.name}; and not __fish_prompter_using_subcommand ${subcmd.name}' -a '${subcmd.name}' -d '${this.escapeDescription(subcmd.description)}'`
-        );
-      }
-      lines.push('');
-
-      // Add flags for parent command
-      for (const flag of cmd.flags) {
-        lines.push(...this.generateFlagCompletion(flag, `__fish_prompter_using_subcommand ${cmd.name}`));
-      }
-
-      // Add completions for each subcommand
-      for (const subcmd of cmd.subcommands) {
-        lines.push(`# ${cmd.name} ${subcmd.name} flags`);
-        for (const flag of subcmd.flags) {
-          lines.push(...this.generateFlagCompletion(flag, `__fish_prompter_using_subcommand ${cmd.name}; and __fish_prompter_using_subcommand ${subcmd.name}`));
-        }
-
-        // Add positional completions for subcommand
-        if (subcmd.acceptsPositional) {
-          lines.push(...this.generatePositionalCompletion(subcmd.positionalType, `__fish_prompter_using_subcommand ${cmd.name}; and __fish_prompter_using_subcommand ${subcmd.name}`));
-        }
-      }
-    } else {
-      // Command without subcommands
-      lines.push(`# ${cmd.name} flags`);
-      for (const flag of cmd.flags) {
-        lines.push(...this.generateFlagCompletion(flag, `__fish_prompter_using_subcommand ${cmd.name}`));
-      }
-
-      // Add positional completions
-      if (cmd.acceptsPositional) {
-        lines.push(...this.generatePositionalCompletion(cmd.positionalType, `__fish_prompter_using_subcommand ${cmd.name}`));
-      }
-    }
-
-    return lines;
-  }
-
-  /**
-   * Generate flag completion
-   */
-  private generateFlagCompletion(flag: FlagDefinition, condition: string): string[] {
-    const lines: string[] = [];
-    const longFlag = `--${flag.name}`;
-    const shortFlag = flag.short ? `-${flag.short}` : undefined;
-
-    if (flag.takesValue && flag.values) {
-      // Flag with enum values
-      for (const value of flag.values) {
-        if (shortFlag) {
-          lines.push(
-            `complete -c prompter -n '${condition}' -s ${flag.short} -l ${flag.name} -a '${value}' -d '${this.escapeDescription(flag.description)}'`
-          );
-        } else {
-          lines.push(
-            `complete -c prompter -n '${condition}' -l ${flag.name} -a '${value}' -d '${this.escapeDescription(flag.description)}'`
-          );
-        }
-      }
-    } else if (flag.takesValue) {
-      // Flag that takes a value but no specific values defined
-      if (shortFlag) {
-        lines.push(
-          `complete -c prompter -n '${condition}' -s ${flag.short} -l ${flag.name} -r -d '${this.escapeDescription(flag.description)}'`
-        );
-      } else {
-        lines.push(
-          `complete -c prompter -n '${condition}' -l ${flag.name} -r -d '${this.escapeDescription(flag.description)}'`
-        );
-      }
-    } else {
-      // Boolean flag
-      if (shortFlag) {
-        lines.push(
-          `complete -c prompter -n '${condition}' -s ${flag.short} -l ${flag.name} -d '${this.escapeDescription(flag.description)}'`
-        );
-      } else {
-        lines.push(
-          `complete -c prompter -n '${condition}' -l ${flag.name} -d '${this.escapeDescription(flag.description)}'`
-        );
-      }
-    }
-
-    return lines;
-  }
-
-  /**
-   * Generate positional argument completion
-   */
-  private generatePositionalCompletion(positionalType: string | undefined, condition: string): string[] {
-    const lines: string[] = [];
-
-    switch (positionalType) {
-      case 'change-id':
-        lines.push(`complete -c prompter -n '${condition}' -a '(__fish_prompter_changes)' -f`);
-        break;
-      case 'spec-id':
-        lines.push(`complete -c prompter -n '${condition}' -a '(__fish_prompter_specs)' -f`);
-        break;
-      case 'change-or-spec-id':
-        lines.push(`complete -c prompter -n '${condition}' -a '(__fish_prompter_items)' -f`);
-        break;
-      case 'shell':
-        lines.push(`complete -c prompter -n '${condition}' -a 'zsh bash fish powershell' -f`);
-        break;
-      case 'path':
-        // Fish automatically completes files, no need to specify
-        break;
-    }
-
-    return lines;
-  }
-
-
-  /**
-   * Escape description text for Fish
-   */
-  private escapeDescription(description: string): string {
-    return description
-      .replace(/\\/g, '\\\\')  // Backslashes first
-      .replace(/'/g, "\\'")    // Single quotes
-      .replace(/\$/g, '\\$')   // Dollar signs (prevents $())
-      .replace(/`/g, '\\`');   // Backticks
-  }
-}

package/src/core/completions/generators/powershell-generator.ts

@@ -1,223 +0,0 @@
-import { CompletionGenerator, CommandDefinition, FlagDefinition } from '../types.js';
-import { POWERSHELL_DYNAMIC_HELPERS } from '../templates/powershell-templates.js';
-
-/**
- * Generates PowerShell completion scripts for the Prompter CLI.
- * Uses Register-ArgumentCompleter for command completion.
- */
-export class PowerShellGenerator implements CompletionGenerator {
-  readonly shell = 'powershell' as const;
-
-  private stripTrailingCommaFromLastLine(lines: string[]): void {
-    if (lines.length === 0) return;
-    lines[lines.length - 1] = lines[lines.length - 1].replace(/,\s*$/, '');
-  }
-
-  /**
-   * Generate a PowerShell completion script
-   *
-   * @param commands - Command definitions to generate completions for
-   * @returns PowerShell completion script as a string
-   */
-  generate(commands: CommandDefinition[]): string {
-    // Build top-level commands using push() for loop clarity
-    const commandLines: string[] = [];
-    for (const cmd of commands) {
-      commandLines.push(`            @{Name="${cmd.name}"; Description="${this.escapeDescription(cmd.description)}"},`);
-    }
-    this.stripTrailingCommaFromLastLine(commandLines);
-    const topLevelCommands = commandLines.join('\n');
-
-    // Build command cases using push() for loop clarity
-    const commandCaseLines: string[] = [];
-    for (const cmd of commands) {
-      commandCaseLines.push(`        "${cmd.name}" {`);
-      commandCaseLines.push(...this.generateCommandCase(cmd, '            '));
-      commandCaseLines.push('        }');
-    }
-    const commandCases = commandCaseLines.join('\n');
-
-    // Dynamic completion helpers from template
-    const helpers = POWERSHELL_DYNAMIC_HELPERS;
-
-    // Assemble final script with template literal
-    return `# PowerShell completion script for Prompter CLI
-# Auto-generated - do not edit manually
-
-${helpers}
-$prompterCompleter = {
-    param($wordToComplete, $commandAst, $cursorPosition)
-
-    $tokens = $commandAst.ToString() -split "\\s+"
-    $commandCount = ($tokens | Measure-Object).Count
-
-    # Top-level commands
-    if ($commandCount -eq 1 -or ($commandCount -eq 2 -and $wordToComplete)) {
-        $commands = @(
-${topLevelCommands}
-        )
-        $commands | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object {
-            [System.Management.Automation.CompletionResult]::new($_.Name, $_.Name, "ParameterValue", $_.Description)
-        }
-        return
-    }
-
-    $command = $tokens[1]
-
-    switch ($command) {
-${commandCases}
-    }
-}
-
-Register-ArgumentCompleter -CommandName prompter -ScriptBlock $prompterCompleter
-`;
-  }
-
-  /**
-   * Generate completion case for a command
-   */
-  private generateCommandCase(cmd: CommandDefinition, indent: string): string[] {
-    const lines: string[] = [];
-
-    if (cmd.subcommands && cmd.subcommands.length > 0) {
-      // First, check if user is typing a flag for the parent command
-      if (cmd.flags.length > 0) {
-        lines.push(`${indent}if ($wordToComplete -like "-*") {`);
-        lines.push(`${indent}    $flags = @(`);
-        for (const flag of cmd.flags) {
-          const longFlag = `--${flag.name}`;
-          const shortFlag = flag.short ? `-${flag.short}` : undefined;
-          if (shortFlag) {
-            lines.push(`${indent}        @{Name="${longFlag}"; Description="${this.escapeDescription(flag.description)}"},`);
-            lines.push(`${indent}        @{Name="${shortFlag}"; Description="${this.escapeDescription(flag.description)}"},`);
-          } else {
-            lines.push(`${indent}        @{Name="${longFlag}"; Description="${this.escapeDescription(flag.description)}"},`);
-          }
-        }
-        this.stripTrailingCommaFromLastLine(lines);
-        lines.push(`${indent}    )`);
-        lines.push(`${indent}    $flags | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object {`);
-        lines.push(`${indent}        [System.Management.Automation.CompletionResult]::new($_.Name, $_.Name, "ParameterName", $_.Description)`);
-        lines.push(`${indent}    }`);
-        lines.push(`${indent}    return`);
-        lines.push(`${indent}}`);
-        lines.push('');
-      }
-
-      // Handle subcommands
-      lines.push(`${indent}if ($commandCount -eq 2 -or ($commandCount -eq 3 -and $wordToComplete)) {`);
-      lines.push(`${indent}    $subcommands = @(`);
-      for (const subcmd of cmd.subcommands) {
-        lines.push(`${indent}        @{Name="${subcmd.name}"; Description="${this.escapeDescription(subcmd.description)}"},`);
-      }
-      this.stripTrailingCommaFromLastLine(lines);
-      lines.push(`${indent}    )`);
-      lines.push(`${indent}    $subcommands | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object {`);
-      lines.push(`${indent}        [System.Management.Automation.CompletionResult]::new($_.Name, $_.Name, "ParameterValue", $_.Description)`);
-      lines.push(`${indent}    }`);
-      lines.push(`${indent}    return`);
-      lines.push(`${indent}}`);
-      lines.push('');
-      lines.push(`${indent}$subcommand = if ($commandCount -gt 2) { $tokens[2] } else { "" }`);
-      lines.push(`${indent}switch ($subcommand) {`);
-
-      for (const subcmd of cmd.subcommands) {
-        lines.push(`${indent}    "${subcmd.name}" {`);
-        lines.push(...this.generateArgumentCompletion(subcmd, indent + '        '));
-        lines.push(`${indent}    }`);
-      }
-
-      lines.push(`${indent}}`);
-    } else {
-      // No subcommands
-      lines.push(...this.generateArgumentCompletion(cmd, indent));
-    }
-
-    return lines;
-  }
-
-  /**
-   * Generate argument completion (flags and positional)
-   */
-  private generateArgumentCompletion(cmd: CommandDefinition, indent: string): string[] {
-    const lines: string[] = [];
-
-    // Flag completion
-    if (cmd.flags.length > 0) {
-      lines.push(`${indent}if ($wordToComplete -like "-*") {`);
-      lines.push(`${indent}    $flags = @(`);
-      for (const flag of cmd.flags) {
-        const longFlag = `--${flag.name}`;
-        const shortFlag = flag.short ? `-${flag.short}` : undefined;
-        if (shortFlag) {
-          lines.push(`${indent}        @{Name="${longFlag}"; Description="${this.escapeDescription(flag.description)}"},`);
-          lines.push(`${indent}        @{Name="${shortFlag}"; Description="${this.escapeDescription(flag.description)}"},`);
-        } else {
-          lines.push(`${indent}        @{Name="${longFlag}"; Description="${this.escapeDescription(flag.description)}"},`);
-        }
-      }
-      this.stripTrailingCommaFromLastLine(lines);
-      lines.push(`${indent}    )`);
-      lines.push(`${indent}    $flags | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object {`);
-      lines.push(`${indent}        [System.Management.Automation.CompletionResult]::new($_.Name, $_.Name, "ParameterName", $_.Description)`);
-      lines.push(`${indent}    }`);
-      lines.push(`${indent}    return`);
-      lines.push(`${indent}}`);
-      lines.push('');
-    }
-
-    // Positional completion
-    if (cmd.acceptsPositional) {
-      lines.push(...this.generatePositionalCompletion(cmd.positionalType, indent));
-    }
-
-    return lines;
-  }
-
-  /**
-   * Generate positional argument completion
-   */
-  private generatePositionalCompletion(positionalType: string | undefined, indent: string): string[] {
-    const lines: string[] = [];
-
-    switch (positionalType) {
-      case 'change-id':
-        lines.push(`${indent}Get-PrompterChanges | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {`);
-        lines.push(`${indent}    [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", "Change: $_")`);
-        lines.push(`${indent}}`);
-        break;
-      case 'spec-id':
-        lines.push(`${indent}Get-PrompterSpecs | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {`);
-        lines.push(`${indent}    [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", "Spec: $_")`);
-        lines.push(`${indent}}`);
-        break;
-      case 'change-or-spec-id':
-        lines.push(`${indent}$items = @(Get-PrompterChanges) + @(Get-PrompterSpecs)`);
-        lines.push(`${indent}$items | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {`);
-        lines.push(`${indent}    [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_)`);
-        lines.push(`${indent}}`);
-        break;
-      case 'shell':
-        lines.push(`${indent}$shells = @("zsh", "bash", "fish", "powershell")`);
-        lines.push(`${indent}$shells | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {`);
-        lines.push(`${indent}    [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", "Shell: $_")`);
-        lines.push(`${indent}}`);
-        break;
-      case 'path':
-        // PowerShell handles file path completion automatically
-        break;
-    }
-
-    return lines;
-  }
-
-  /**
-   * Escape description text for PowerShell
-   */
-  private escapeDescription(description: string): string {
-    return description
-      .replace(/`/g, '``')     // Backticks (escape sequences)
-      .replace(/\$/g, '`$')    // Dollar signs (prevents $())
-      .replace(/"/g, '""');    // Double quotes
-  }
-}