politty 0.3.0 → 0.3.2

package/dist/completion/index.cjs

@@ -1,460 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_schema_extractor = require('../schema-extractor-B9D3Rf22.cjs');
-const require_command = require('../command-Bgd-yIwv.cjs');
+const require_schema_extractor = require('../schema-extractor-BU705qpC.cjs');
+const require_extractor = require('../extractor-B7bOwpvP.cjs');
 const require_docs_index = require('../docs/index.cjs');
 let zod = require("zod");
 
-//#region src/completion/extractor.ts
-/**
-* Extract completion data from commands
-*/
-/**
-* Convert a resolved field to a completable option
-*/
-function fieldToOption(field) {
-	return {
-		name: field.name,
-		cliName: field.cliName,
-		alias: field.alias,
-		description: field.description,
-		takesValue: field.type !== "boolean",
-		valueType: field.type,
-		required: field.required
-	};
-}
-/**
-* Extract options from a command's args schema
-*/
-function extractOptions(command) {
-	if (!command.args) return [];
-	return require_schema_extractor.extractFields(command.args).fields.filter((field) => !field.positional).map(fieldToOption);
-}
-/**
-* Extract positional arguments from a command
-*/
-function extractPositionals(command) {
-	if (!command.args) return [];
-	return require_schema_extractor.extractFields(command.args).fields.filter((field) => field.positional);
-}
-/**
-* Extract a completable subcommand from a command
-*/
-function extractSubcommand(name, command) {
-	const subcommands = [];
-	if (command.subCommands) for (const [subName, subCommand] of Object.entries(command.subCommands)) if (typeof subCommand === "function") subcommands.push({
-		name: subName,
-		description: "(lazy loaded)",
-		subcommands: [],
-		options: []
-	});
-	else subcommands.push(extractSubcommand(subName, subCommand));
-	return {
-		name,
-		description: command.description,
-		subcommands,
-		options: extractOptions(command)
-	};
-}
-/**
-* Extract completion data from a command tree
-*/
-function extractCompletionData(command, programName) {
-	const rootSubcommand = extractSubcommand(programName, command);
-	return {
-		command: rootSubcommand,
-		programName,
-		globalOptions: rootSubcommand.options
-	};
-}
-
-//#endregion
-//#region src/completion/bash.ts
-/**
-* Generate option completions for bash
-*/
-function generateOptionCompletions$1(options) {
-	const completions = [];
-	for (const opt of options) {
-		completions.push(`--${opt.cliName}`);
-		if (opt.alias) completions.push(`-${opt.alias}`);
-	}
-	return completions;
-}
-/**
-* Generate subcommand completions for bash
-*/
-function generateSubcommandCompletions$1(subcommands) {
-	return subcommands.map((sub) => sub.name);
-}
-/**
-* Generate the bash completion script
-*/
-function generateBashScript(command, programName, includeDescriptions) {
-	const allOptions = collectAllOptions(command);
-	const optionList = generateOptionCompletions$1(allOptions).join(" ");
-	const subcommandList = generateSubcommandCompletions$1(command.subcommands).join(" ");
-	const subcommandCases = buildSubcommandCases(command.subcommands, includeDescriptions);
-	return `# Bash completion for ${programName}
-# Generated by politty
-
-_${programName}_completions() {
-    local cur prev words cword
-    _init_completion || return
-
-    local commands="${subcommandList}"
-    local global_opts="${optionList}"
-
-    # Handle subcommand-specific completions
-    local cmd_index=1
-    local cmd=""
-
-    # Find the subcommand
-    for ((i=1; i < cword; i++)); do
-        case "\${words[i]}" in
-            -*)
-                # Skip options and their values
-                if [[ "\${words[i]}" == *=* ]]; then
-                    continue
-                fi
-                # Check if next word is the option's value
-                local opt="\${words[i]}"
-                case "$opt" in
-                    ${allOptions.filter((o) => o.takesValue).map((o) => `--${o.cliName}|-${o.alias || ""}`).join("|") || "--*"}
-                        ((i++))
-                        ;;
-                esac
-                ;;
-            *)
-                # Found a subcommand
-                cmd="\${words[i]}"
-                cmd_index=$i
-                break
-                ;;
-        esac
-    done
-
-    # Subcommand-specific completions
-    case "$cmd" in
-${subcommandCases}
-        *)
-            # Root level completions
-            if [[ "$cur" == -* ]]; then
-                COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
-            else
-                COMPREPLY=($(compgen -W "$commands" -- "$cur"))
-            fi
-            ;;
-    esac
-
-    return 0
-}
-
-# Register the completion function
-complete -F _${programName}_completions ${programName}
-`;
-}
-/**
-* Build case statements for subcommand-specific completions
-*/
-function buildSubcommandCases(subcommands, includeDescriptions) {
-	if (subcommands.length === 0) return "";
-	let cases = "";
-	for (const sub of subcommands) {
-		const completions = [generateOptionCompletions$1(sub.options).join(" "), generateSubcommandCompletions$1(sub.subcommands).join(" ")].filter(Boolean).join(" ");
-		cases += `        ${sub.name})\n`;
-		cases += `            COMPREPLY=($(compgen -W "${completions}" -- "$cur"))\n`;
-		cases += `            ;;\n`;
-		if (sub.subcommands.length > 0) {
-			const nestedCases = buildSubcommandCases(sub.subcommands, includeDescriptions);
-			if (nestedCases) cases += nestedCases;
-		}
-	}
-	return cases;
-}
-/**
-* Collect all options from a command tree
-*/
-function collectAllOptions(command) {
-	const options = [...command.options];
-	for (const sub of command.subcommands) options.push(...collectAllOptions(sub));
-	const seen = /* @__PURE__ */ new Set();
-	return options.filter((opt) => {
-		if (seen.has(opt.name)) return false;
-		seen.add(opt.name);
-		return true;
-	});
-}
-/**
-* Generate bash completion script for a command
-*/
-function generateBashCompletion(command, options) {
-	const data = extractCompletionData(command, options.programName);
-	const includeDescriptions = options.includeDescriptions ?? true;
-	return {
-		script: generateBashScript(data.command, options.programName, includeDescriptions),
-		shell: "bash",
-		installInstructions: `# To enable completions, add the following to your ~/.bashrc:
-
-# Option 1: Source directly
-eval "$(${options.programName} completion bash)"
-
-# Option 2: Save to a file
-${options.programName} completion bash > ~/.local/share/bash-completion/completions/${options.programName}
-
-# Then reload your shell or run:
-source ~/.bashrc`
-	};
-}
-
-//#endregion
-//#region src/completion/fish.ts
-/**
-* Escape a string for use in fish completion descriptions
-*/
-function escapeForFish(str) {
-	return str.replace(/'/g, "\\'").replace(/"/g, "\\\"");
-}
-/**
-* Generate completion entries for options
-*/
-function generateOptionCompletions(options, programName, condition, includeDescriptions) {
-	const completions = [];
-	for (const opt of options) {
-		let cmd = `complete -c ${programName}`;
-		if (condition) cmd += ` -n '${condition}'`;
-		cmd += ` -l ${opt.cliName}`;
-		if (opt.alias) cmd += ` -s ${opt.alias}`;
-		if (opt.takesValue) cmd += " -r";
-		else cmd += " -f";
-		if (includeDescriptions && opt.description) cmd += ` -d '${escapeForFish(opt.description)}'`;
-		completions.push(cmd);
-	}
-	return completions;
-}
-/**
-* Generate completion entries for subcommands
-*/
-function generateSubcommandCompletions(subcommands, programName, condition, includeDescriptions) {
-	const completions = [];
-	for (const sub of subcommands) {
-		let cmd = `complete -c ${programName}`;
-		if (condition) cmd += ` -n '${condition}'`;
-		cmd += ` -f -a ${sub.name}`;
-		if (includeDescriptions && sub.description) cmd += ` -d '${escapeForFish(sub.description)}'`;
-		completions.push(cmd);
-	}
-	return completions;
-}
-/**
-* Generate helper functions for fish
-*/
-function generateHelperFunctions(programName) {
-	return `# Helper function to check if using subcommand
-function __fish_use_subcommand_${programName}
-    set -l cmd (commandline -opc)
-    if test (count $cmd) -eq 1
-        return 0
-    end
-    return 1
-end
-
-# Helper function to check current subcommand
-function __fish_${programName}_using_command
-    set -l cmd (commandline -opc)
-    if contains -- $argv[1] $cmd
-        return 0
-    end
-    return 1
-end
-`;
-}
-/**
-* Recursively generate completions for a command and its subcommands
-*/
-function generateCommandCompletions(command, programName, includeDescriptions, parentCommands = []) {
-	const completions = [];
-	const optionCondition = parentCommands.length === 0 ? "" : `__fish_${programName}_using_command ${parentCommands[parentCommands.length - 1]}`;
-	const subcommandCondition = parentCommands.length === 0 ? `__fish_use_subcommand_${programName}` : `__fish_${programName}_using_command ${parentCommands[parentCommands.length - 1]}`;
-	completions.push(...generateOptionCompletions(command.options, programName, optionCondition, includeDescriptions));
-	if (command.subcommands.length > 0) {
-		completions.push(...generateSubcommandCompletions(command.subcommands, programName, subcommandCondition, includeDescriptions));
-		for (const sub of command.subcommands) completions.push(...generateCommandCompletions(sub, programName, includeDescriptions, [...parentCommands, sub.name]));
-	}
-	return completions;
-}
-/**
-* Generate the fish completion script
-*/
-function generateFishScript(command, programName, includeDescriptions) {
-	const helpers = generateHelperFunctions(programName);
-	const completions = generateCommandCompletions(command, programName, includeDescriptions);
-	return `# Fish completion for ${programName}
-# Generated by politty
-
-${helpers}
-
-# Clear existing completions
-complete -e -c ${programName}
-
-# Built-in options
-${[`complete -c ${programName} -l help -s h -d 'Show help information'`, `complete -c ${programName} -l version -d 'Show version information'`].join("\n")}
-
-# Command-specific completions
-${completions.join("\n")}
-`;
-}
-/**
-* Generate fish completion script for a command
-*/
-function generateFishCompletion(command, options) {
-	const data = extractCompletionData(command, options.programName);
-	const includeDescriptions = options.includeDescriptions ?? true;
-	return {
-		script: generateFishScript(data.command, options.programName, includeDescriptions),
-		shell: "fish",
-		installInstructions: `# To enable completions, run one of the following:
-
-# Option 1: Source directly
-${options.programName} completion fish | source
-
-# Option 2: Save to the fish completions directory
-${options.programName} completion fish > ~/.config/fish/completions/${options.programName}.fish
-
-# The completion will be available immediately in new shell sessions.
-# To use in the current session, run:
-source ~/.config/fish/completions/${options.programName}.fish`
-	};
-}
-
-//#endregion
-//#region src/completion/zsh.ts
-/**
-* Escape a string for use in zsh completion descriptions
-*/
-function escapeForZsh(str) {
-	return str.replace(/'/g, "''").replace(/\[/g, "\\[").replace(/\]/g, "\\]");
-}
-/**
-* Generate option specs for zsh _arguments
-*/
-function generateOptionSpecs(options, includeDescriptions) {
-	const specs = [];
-	for (const opt of options) {
-		const desc = includeDescriptions && opt.description ? escapeForZsh(opt.description) : "";
-		const valueSpec = opt.takesValue ? ":" : "";
-		if (desc) specs.push(`'--${opt.cliName}[${desc}]${valueSpec}'`);
-		else specs.push(`'--${opt.cliName}${valueSpec}'`);
-		if (opt.alias) if (desc) specs.push(`'-${opt.alias}[${desc}]${valueSpec}'`);
-		else specs.push(`'-${opt.alias}${valueSpec}'`);
-	}
-	return specs;
-}
-/**
-* Generate subcommand descriptions for zsh
-*/
-function generateSubcommandDescriptions(subcommands, includeDescriptions) {
-	if (subcommands.length === 0) return "";
-	return subcommands.map((sub) => {
-		const desc = includeDescriptions && sub.description ? escapeForZsh(sub.description) : sub.name;
-		return `'${sub.name}:${desc}'`;
-	}).join("\n            ");
-}
-/**
-* Generate a zsh function for a subcommand
-*/
-function generateSubcommandFunction(command, programName, includeDescriptions, parentPath = []) {
-	const currentPath = [...parentPath, command.name];
-	const funcName = parentPath.length === 0 ? `_${programName}` : `_${programName}_${currentPath.slice(1).join("_")}`;
-	const optionSpecs = generateOptionSpecs(command.options, includeDescriptions);
-	const hasSubcommands = command.subcommands.length > 0;
-	let func = `${funcName}() {\n`;
-	func += `    local -a args\n`;
-	if (hasSubcommands) {
-		const subcommandDesc = generateSubcommandDescriptions(command.subcommands, includeDescriptions);
-		func += `    local -a subcommands\n`;
-		func += `    subcommands=(\n`;
-		func += `            ${subcommandDesc}\n`;
-		func += `    )\n\n`;
-	}
-	func += `    args=(\n`;
-	if (hasSubcommands) {
-		func += `        '1:command:->command'\n`;
-		func += `        '*::arg:->args'\n`;
-	}
-	for (const spec of optionSpecs) func += `        ${spec}\n`;
-	func += `    )\n\n`;
-	func += `    _arguments -s -S $args\n\n`;
-	if (hasSubcommands) {
-		func += `    case "$state" in\n`;
-		func += `        command)\n`;
-		func += `            _describe -t commands 'command' subcommands\n`;
-		func += `            ;;\n`;
-		func += `        args)\n`;
-		func += `            case $words[1] in\n`;
-		for (const sub of command.subcommands) {
-			const subFuncName = `_${programName}_${[...currentPath.slice(1), sub.name].join("_")}`;
-			func += `                ${sub.name})\n`;
-			func += `                    ${subFuncName}\n`;
-			func += `                    ;;\n`;
-		}
-		func += `            esac\n`;
-		func += `            ;;\n`;
-		func += `    esac\n`;
-	}
-	func += `}\n`;
-	return func;
-}
-/**
-* Collect all subcommand functions recursively
-*/
-function collectSubcommandFunctions(command, programName, includeDescriptions, parentPath = []) {
-	const functions = [];
-	functions.push(generateSubcommandFunction(command, programName, includeDescriptions, parentPath));
-	const currentPath = parentPath.length === 0 ? [command.name] : [...parentPath, command.name];
-	for (const sub of command.subcommands) functions.push(...collectSubcommandFunctions(sub, programName, includeDescriptions, currentPath));
-	return functions;
-}
-/**
-* Generate the zsh completion script
-*/
-function generateZshScript(command, programName, includeDescriptions) {
-	return `#compdef ${programName}
-
-# Zsh completion for ${programName}
-# Generated by politty
-
-${collectSubcommandFunctions(command, programName, includeDescriptions).join("\n")}
-
-compdef _${programName} ${programName}
-`;
-}
-/**
-* Generate zsh completion script for a command
-*/
-function generateZshCompletion(command, options) {
-	const data = extractCompletionData(command, options.programName);
-	const includeDescriptions = options.includeDescriptions ?? true;
-	return {
-		script: generateZshScript(data.command, options.programName, includeDescriptions),
-		shell: "zsh",
-		installInstructions: `# To enable completions, add the following to your ~/.zshrc:
-
-# Option 1: Source directly (add before compinit)
-eval "$(${options.programName} completion zsh)"
-
-# Option 2: Save to a file in your fpath
-${options.programName} completion zsh > ~/.zsh/completions/_${options.programName}
-
-# Make sure your fpath includes the completions directory:
-# fpath=(~/.zsh/completions $fpath)
-# autoload -Uz compinit && compinit
-
-# Then reload your shell or run:
-source ~/.zshrc`
-	};
-}
-
-//#endregion
 //#region src/completion/index.ts
 /**
 * Shell completion generation module
@@ -486,9 +35,9 @@ source ~/.zshrc`
 */
 function generateCompletion(command, options) {
 	switch (options.shell) {
-		case "bash": return generateBashCompletion(command, options);
-		case "zsh": return generateZshCompletion(command, options);
-		case "fish": return generateFishCompletion(command, options);
+		case "bash": return require_extractor.generateBashCompletion(command, options);
+		case "zsh": return require_extractor.generateZshCompletion(command, options);
+		case "fish": return require_extractor.generateFishCompletion(command, options);
 		default: throw new Error(`Unsupported shell: ${options.shell}`);
 	}
 }
@@ -547,7 +96,11 @@ const completionArgsSchema = zod.z.object({
 */
 function createCompletionCommand(rootCommand, programName) {
 	const resolvedProgramName = programName ?? rootCommand.name;
-	return require_command.defineCommand({
+	if (!rootCommand.subCommands?.__complete) rootCommand.subCommands = {
+		...rootCommand.subCommands,
+		__complete: require_extractor.createDynamicCompleteCommand(rootCommand, resolvedProgramName)
+	};
+	return require_extractor.defineCommand({
 		name: "completion",
 		description: "Generate shell completion script",
 		args: completionArgsSchema,
@@ -575,7 +128,7 @@ function createCompletionCommand(rootCommand, 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
@@ -588,21 +141,29 @@ function createCompletionCommand(rootCommand, programName) {
 * );
 * ```
 */
-function withCompletionCommand(command, programName) {
+function withCompletionCommand(command, options) {
+	const { programName } = typeof options === "string" ? { programName: options } : options ?? {};
 	const wrappedCommand = { ...command };
 	wrappedCommand.subCommands = {
 		...command.subCommands,
-		completion: createCompletionCommand(wrappedCommand, programName)
+		completion: createCompletionCommand(wrappedCommand, programName),
+		__complete: require_extractor.createDynamicCompleteCommand(wrappedCommand, programName)
 	};
 	return wrappedCommand;
 }
 
 //#endregion
+exports.CompletionDirective = require_extractor.CompletionDirective;
 exports.createCompletionCommand = createCompletionCommand;
+exports.createDynamicCompleteCommand = require_extractor.createDynamicCompleteCommand;
 exports.detectShell = detectShell;
-exports.extractCompletionData = extractCompletionData;
-exports.extractPositionals = extractPositionals;
+exports.extractCompletionData = require_extractor.extractCompletionData;
+exports.extractPositionals = require_extractor.extractPositionals;
+exports.formatOutput = require_extractor.formatOutput;
+exports.generateCandidates = require_extractor.generateCandidates;
 exports.generateCompletion = generateCompletion;
 exports.getSupportedShells = getSupportedShells;
+exports.hasCompleteCommand = require_extractor.hasCompleteCommand;
+exports.parseCompletionContext = require_extractor.parseCompletionContext;
 exports.withCompletionCommand = withCompletionCommand;
 //# sourceMappingURL=index.cjs.map

package/dist/completion/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["extractFields","generateOptionCompletions","generateSubcommandCompletions","z","arg","defineCommand"],"sources":["../../src/completion/extractor.ts","../../src/completion/bash.ts","../../src/completion/fish.ts","../../src/completion/zsh.ts","../../src/completion/index.ts"],"sourcesContent":["/**\n * Extract completion data from commands\n */\n\nimport { extractFields, type ResolvedFieldMeta } from \"../core/schema-extractor.js\";\nimport type { AnyCommand } from \"../types.js\";\nimport type { CompletableOption, CompletableSubcommand, CompletionData } from \"./types.js\";\n\n/**\n * Convert a resolved field to a completable option\n */\nfunction fieldToOption(field: ResolvedFieldMeta): CompletableOption {\n  return {\n    name: field.name,\n    cliName: field.cliName,\n    alias: field.alias,\n    description: field.description,\n    // Booleans are flags that don't require a value\n    takesValue: field.type !== \"boolean\",\n    valueType: field.type,\n    required: field.required,\n  };\n}\n\n/**\n * Extract options from a command's args schema\n */\nfunction extractOptions(command: AnyCommand): CompletableOption[] {\n  if (!command.args) {\n    return [];\n  }\n\n  const extracted = extractFields(command.args);\n  return extracted.fields\n    .filter((field) => !field.positional) // Only include flags/options, not positionals\n    .map(fieldToOption);\n}\n\n/**\n * Extract positional arguments from a command\n */\nexport function extractPositionals(command: AnyCommand): ResolvedFieldMeta[] {\n  if (!command.args) {\n    return [];\n  }\n\n  const extracted = extractFields(command.args);\n  return extracted.fields.filter((field) => field.positional);\n}\n\n/**\n * Extract a completable subcommand from a command\n */\nfunction extractSubcommand(name: string, command: AnyCommand): CompletableSubcommand {\n  const subcommands: CompletableSubcommand[] = [];\n\n  // Extract subcommands recursively (only sync subcommands for now)\n  if (command.subCommands) {\n    for (const [subName, subCommand] of Object.entries(command.subCommands)) {\n      // Skip async subcommands as we can't inspect them statically\n      if (typeof subCommand === \"function\") {\n        // For async subcommands, add a placeholder\n        subcommands.push({\n          name: subName,\n          description: \"(lazy loaded)\",\n          subcommands: [],\n          options: [],\n        });\n      } else {\n        subcommands.push(extractSubcommand(subName, subCommand));\n      }\n    }\n  }\n\n  return {\n    name,\n    description: command.description,\n    subcommands,\n    options: extractOptions(command),\n  };\n}\n\n/**\n * Extract completion data from a command tree\n */\nexport function extractCompletionData(command: AnyCommand, programName: string): CompletionData {\n  const rootSubcommand = extractSubcommand(programName, command);\n\n  return {\n    command: rootSubcommand,\n    programName,\n    // Global options are the options defined on the root command\n    globalOptions: rootSubcommand.options,\n  };\n}\n","/**\n * Bash completion script generator\n */\n\nimport type { AnyCommand } from \"../types.js\";\nimport { extractCompletionData } from \"./extractor.js\";\nimport type {\n  CompletableOption,\n  CompletableSubcommand,\n  CompletionOptions,\n  CompletionResult,\n} from \"./types.js\";\n\n/**\n * Generate option completions for bash\n */\nfunction generateOptionCompletions(options: CompletableOption[]): string[] {\n  const completions: string[] = [];\n\n  for (const opt of options) {\n    completions.push(`--${opt.cliName}`);\n    if (opt.alias) {\n      completions.push(`-${opt.alias}`);\n    }\n  }\n\n  return completions;\n}\n\n/**\n * Generate subcommand completions for bash\n */\nfunction generateSubcommandCompletions(subcommands: CompletableSubcommand[]): string[] {\n  return subcommands.map((sub) => sub.name);\n}\n\n/**\n * Generate the bash completion script\n */\nfunction generateBashScript(\n  command: CompletableSubcommand,\n  programName: string,\n  includeDescriptions: boolean,\n): string {\n  const allOptions = collectAllOptions(command);\n\n  const optionList = generateOptionCompletions(allOptions).join(\" \");\n  const subcommandList = generateSubcommandCompletions(command.subcommands).join(\" \");\n\n  // Build subcommand-specific completions\n  const subcommandCases = buildSubcommandCases(command.subcommands, includeDescriptions);\n\n  return `# Bash completion for ${programName}\n# Generated by politty\n\n_${programName}_completions() {\n    local cur prev words cword\n    _init_completion || return\n\n    local commands=\"${subcommandList}\"\n    local global_opts=\"${optionList}\"\n\n    # Handle subcommand-specific completions\n    local cmd_index=1\n    local cmd=\"\"\n\n    # Find the subcommand\n    for ((i=1; i < cword; i++)); do\n        case \"\\${words[i]}\" in\n            -*)\n                # Skip options and their values\n                if [[ \"\\${words[i]}\" == *=* ]]; then\n                    continue\n                fi\n                # Check if next word is the option's value\n                local opt=\"\\${words[i]}\"\n                case \"$opt\" in\n                    ${\n                      allOptions\n                        .filter((o) => o.takesValue)\n                        .map((o) => `--${o.cliName}|-${o.alias || \"\"}`)\n                        .join(\"|\") || \"--*\"\n                    }\n                        ((i++))\n                        ;;\n                esac\n                ;;\n            *)\n                # Found a subcommand\n                cmd=\"\\${words[i]}\"\n                cmd_index=$i\n                break\n                ;;\n        esac\n    done\n\n    # Subcommand-specific completions\n    case \"$cmd\" in\n${subcommandCases}\n        *)\n            # Root level completions\n            if [[ \"$cur\" == -* ]]; then\n                COMPREPLY=($(compgen -W \"$global_opts\" -- \"$cur\"))\n            else\n                COMPREPLY=($(compgen -W \"$commands\" -- \"$cur\"))\n            fi\n            ;;\n    esac\n\n    return 0\n}\n\n# Register the completion function\ncomplete -F _${programName}_completions ${programName}\n`;\n}\n\n/**\n * Build case statements for subcommand-specific completions\n */\nfunction buildSubcommandCases(\n  subcommands: CompletableSubcommand[],\n  includeDescriptions: boolean,\n): string {\n  if (subcommands.length === 0) {\n    return \"\";\n  }\n\n  let cases = \"\";\n\n  for (const sub of subcommands) {\n    const options = generateOptionCompletions(sub.options).join(\" \");\n    const nestedSubcommands = generateSubcommandCompletions(sub.subcommands).join(\" \");\n    const completions = [options, nestedSubcommands].filter(Boolean).join(\" \");\n\n    cases += `        ${sub.name})\\n`;\n    cases += `            COMPREPLY=($(compgen -W \"${completions}\" -- \"$cur\"))\\n`;\n    cases += `            ;;\\n`;\n\n    // Add nested subcommand cases if any\n    if (sub.subcommands.length > 0) {\n      const nestedCases = buildSubcommandCases(sub.subcommands, includeDescriptions);\n      if (nestedCases) {\n        cases += nestedCases;\n      }\n    }\n  }\n\n  return cases;\n}\n\n/**\n * Collect all options from a command tree\n */\nfunction collectAllOptions(command: CompletableSubcommand): CompletableOption[] {\n  const options = [...command.options];\n\n  for (const sub of command.subcommands) {\n    options.push(...collectAllOptions(sub));\n  }\n\n  // Deduplicate by name\n  const seen = new Set<string>();\n  return options.filter((opt) => {\n    if (seen.has(opt.name)) {\n      return false;\n    }\n    seen.add(opt.name);\n    return true;\n  });\n}\n\n/**\n * Generate bash completion script for a command\n */\nexport function generateBashCompletion(\n  command: AnyCommand,\n  options: CompletionOptions,\n): CompletionResult {\n  const data = extractCompletionData(command, options.programName);\n  const includeDescriptions = options.includeDescriptions ?? true;\n\n  const script = generateBashScript(data.command, options.programName, includeDescriptions);\n\n  return {\n    script,\n    shell: \"bash\",\n    installInstructions: `# To enable completions, add the following to your ~/.bashrc:\n\n# Option 1: Source directly\neval \"$(${options.programName} completion bash)\"\n\n# Option 2: Save to a file\n${options.programName} completion bash > ~/.local/share/bash-completion/completions/${options.programName}\n\n# Then reload your shell or run:\nsource ~/.bashrc`,\n  };\n}\n","/**\n * Fish completion script generator\n */\n\nimport type { AnyCommand } from \"../types.js\";\nimport { extractCompletionData } from \"./extractor.js\";\nimport type {\n  CompletableOption,\n  CompletableSubcommand,\n  CompletionOptions,\n  CompletionResult,\n} from \"./types.js\";\n\n/**\n * Escape a string for use in fish completion descriptions\n */\nfunction escapeForFish(str: string): string {\n  return str.replace(/'/g, \"\\\\'\").replace(/\"/g, '\\\\\"');\n}\n\n/**\n * Generate completion entries for options\n */\nfunction generateOptionCompletions(\n  options: CompletableOption[],\n  programName: string,\n  condition: string,\n  includeDescriptions: boolean,\n): string[] {\n  const completions: string[] = [];\n\n  for (const opt of options) {\n    let cmd = `complete -c ${programName}`;\n\n    // Add condition if specified\n    if (condition) {\n      cmd += ` -n '${condition}'`;\n    }\n\n    // Add long option\n    cmd += ` -l ${opt.cliName}`;\n\n    // Add short option if exists\n    if (opt.alias) {\n      cmd += ` -s ${opt.alias}`;\n    }\n\n    // Add flag for options that take values\n    if (opt.takesValue) {\n      cmd += \" -r\"; // Require argument\n    } else {\n      cmd += \" -f\"; // No argument (flag)\n    }\n\n    // Add description\n    if (includeDescriptions && opt.description) {\n      cmd += ` -d '${escapeForFish(opt.description)}'`;\n    }\n\n    completions.push(cmd);\n  }\n\n  return completions;\n}\n\n/**\n * Generate completion entries for subcommands\n */\nfunction generateSubcommandCompletions(\n  subcommands: CompletableSubcommand[],\n  programName: string,\n  condition: string,\n  includeDescriptions: boolean,\n): string[] {\n  const completions: string[] = [];\n\n  for (const sub of subcommands) {\n    let cmd = `complete -c ${programName}`;\n\n    // Add condition\n    if (condition) {\n      cmd += ` -n '${condition}'`;\n    }\n\n    // Subcommands are exclusive (no prefix)\n    cmd += ` -f -a ${sub.name}`;\n\n    // Add description\n    if (includeDescriptions && sub.description) {\n      cmd += ` -d '${escapeForFish(sub.description)}'`;\n    }\n\n    completions.push(cmd);\n  }\n\n  return completions;\n}\n\n/**\n * Generate helper functions for fish\n */\nfunction generateHelperFunctions(programName: string): string {\n  return `# Helper function to check if using subcommand\nfunction __fish_use_subcommand_${programName}\n    set -l cmd (commandline -opc)\n    if test (count $cmd) -eq 1\n        return 0\n    end\n    return 1\nend\n\n# Helper function to check current subcommand\nfunction __fish_${programName}_using_command\n    set -l cmd (commandline -opc)\n    if contains -- $argv[1] $cmd\n        return 0\n    end\n    return 1\nend\n`;\n}\n\n/**\n * Recursively generate completions for a command and its subcommands\n */\nfunction generateCommandCompletions(\n  command: CompletableSubcommand,\n  programName: string,\n  includeDescriptions: boolean,\n  parentCommands: string[] = [],\n): string[] {\n  const completions: string[] = [];\n\n  // Build condition for this level\n  const optionCondition =\n    parentCommands.length === 0\n      ? \"\"\n      : `__fish_${programName}_using_command ${parentCommands[parentCommands.length - 1]}`;\n\n  const subcommandCondition =\n    parentCommands.length === 0\n      ? `__fish_use_subcommand_${programName}`\n      : `__fish_${programName}_using_command ${parentCommands[parentCommands.length - 1]}`;\n\n  // Add option completions\n  completions.push(\n    ...generateOptionCompletions(\n      command.options,\n      programName,\n      optionCondition,\n      includeDescriptions,\n    ),\n  );\n\n  // Add subcommand completions\n  if (command.subcommands.length > 0) {\n    completions.push(\n      ...generateSubcommandCompletions(\n        command.subcommands,\n        programName,\n        subcommandCondition,\n        includeDescriptions,\n      ),\n    );\n\n    // Recursively add completions for subcommands\n    for (const sub of command.subcommands) {\n      completions.push(\n        ...generateCommandCompletions(sub, programName, includeDescriptions, [\n          ...parentCommands,\n          sub.name,\n        ]),\n      );\n    }\n  }\n\n  return completions;\n}\n\n/**\n * Generate the fish completion script\n */\nfunction generateFishScript(\n  command: CompletableSubcommand,\n  programName: string,\n  includeDescriptions: boolean,\n): string {\n  const helpers = generateHelperFunctions(programName);\n  const completions = generateCommandCompletions(command, programName, includeDescriptions);\n\n  // Add built-in options (help and version)\n  const builtinCompletions = [\n    `complete -c ${programName} -l help -s h -d 'Show help information'`,\n    `complete -c ${programName} -l version -d 'Show version information'`,\n  ];\n\n  return `# Fish completion for ${programName}\n# Generated by politty\n\n${helpers}\n\n# Clear existing completions\ncomplete -e -c ${programName}\n\n# Built-in options\n${builtinCompletions.join(\"\\n\")}\n\n# Command-specific completions\n${completions.join(\"\\n\")}\n`;\n}\n\n/**\n * Generate fish completion script for a command\n */\nexport function generateFishCompletion(\n  command: AnyCommand,\n  options: CompletionOptions,\n): CompletionResult {\n  const data = extractCompletionData(command, options.programName);\n  const includeDescriptions = options.includeDescriptions ?? true;\n\n  const script = generateFishScript(data.command, options.programName, includeDescriptions);\n\n  return {\n    script,\n    shell: \"fish\",\n    installInstructions: `# To enable completions, run one of the following:\n\n# Option 1: Source directly\n${options.programName} completion fish | source\n\n# Option 2: Save to the fish completions directory\n${options.programName} completion fish > ~/.config/fish/completions/${options.programName}.fish\n\n# The completion will be available immediately in new shell sessions.\n# To use in the current session, run:\nsource ~/.config/fish/completions/${options.programName}.fish`,\n  };\n}\n","/**\n * Zsh completion script generator\n */\n\nimport type { AnyCommand } from \"../types.js\";\nimport { extractCompletionData } from \"./extractor.js\";\nimport type {\n  CompletableOption,\n  CompletableSubcommand,\n  CompletionOptions,\n  CompletionResult,\n} from \"./types.js\";\n\n/**\n * Escape a string for use in zsh completion descriptions\n */\nfunction escapeForZsh(str: string): string {\n  return str.replace(/'/g, \"''\").replace(/\\[/g, \"\\\\[\").replace(/\\]/g, \"\\\\]\");\n}\n\n/**\n * Generate option specs for zsh _arguments\n */\nfunction generateOptionSpecs(options: CompletableOption[], includeDescriptions: boolean): string[] {\n  const specs: string[] = [];\n\n  for (const opt of options) {\n    const desc = includeDescriptions && opt.description ? escapeForZsh(opt.description) : \"\";\n    const valueSpec = opt.takesValue ? \":\" : \"\";\n\n    // Long option\n    if (desc) {\n      specs.push(`'--${opt.cliName}[${desc}]${valueSpec}'`);\n    } else {\n      specs.push(`'--${opt.cliName}${valueSpec}'`);\n    }\n\n    // Short option (alias)\n    if (opt.alias) {\n      if (desc) {\n        specs.push(`'-${opt.alias}[${desc}]${valueSpec}'`);\n      } else {\n        specs.push(`'-${opt.alias}${valueSpec}'`);\n      }\n    }\n  }\n\n  return specs;\n}\n\n/**\n * Generate subcommand descriptions for zsh\n */\nfunction generateSubcommandDescriptions(\n  subcommands: CompletableSubcommand[],\n  includeDescriptions: boolean,\n): string {\n  if (subcommands.length === 0) {\n    return \"\";\n  }\n\n  const lines = subcommands.map((sub) => {\n    const desc = includeDescriptions && sub.description ? escapeForZsh(sub.description) : sub.name;\n    return `'${sub.name}:${desc}'`;\n  });\n\n  return lines.join(\"\\n            \");\n}\n\n/**\n * Generate a zsh function for a subcommand\n */\nfunction generateSubcommandFunction(\n  command: CompletableSubcommand,\n  programName: string,\n  includeDescriptions: boolean,\n  parentPath: string[] = [],\n): string {\n  const currentPath = [...parentPath, command.name];\n  const funcName =\n    parentPath.length === 0\n      ? `_${programName}`\n      : `_${programName}_${currentPath.slice(1).join(\"_\")}`;\n\n  const optionSpecs = generateOptionSpecs(command.options, includeDescriptions);\n  const hasSubcommands = command.subcommands.length > 0;\n\n  let func = `${funcName}() {\\n`;\n  func += `    local -a args\\n`;\n\n  if (hasSubcommands) {\n    const subcommandDesc = generateSubcommandDescriptions(command.subcommands, includeDescriptions);\n    func += `    local -a subcommands\\n`;\n    func += `    subcommands=(\\n`;\n    func += `            ${subcommandDesc}\\n`;\n    func += `    )\\n\\n`;\n  }\n\n  func += `    args=(\\n`;\n\n  if (hasSubcommands) {\n    func += `        '1:command:->command'\\n`;\n    func += `        '*::arg:->args'\\n`;\n  }\n\n  for (const spec of optionSpecs) {\n    func += `        ${spec}\\n`;\n  }\n\n  func += `    )\\n\\n`;\n\n  func += `    _arguments -s -S $args\\n\\n`;\n\n  if (hasSubcommands) {\n    func += `    case \"$state\" in\\n`;\n    func += `        command)\\n`;\n    func += `            _describe -t commands 'command' subcommands\\n`;\n    func += `            ;;\\n`;\n    func += `        args)\\n`;\n    func += `            case $words[1] in\\n`;\n\n    for (const sub of command.subcommands) {\n      const subFuncName = `_${programName}_${[...currentPath.slice(1), sub.name].join(\"_\")}`;\n      func += `                ${sub.name})\\n`;\n      func += `                    ${subFuncName}\\n`;\n      func += `                    ;;\\n`;\n    }\n\n    func += `            esac\\n`;\n    func += `            ;;\\n`;\n    func += `    esac\\n`;\n  }\n\n  func += `}\\n`;\n\n  return func;\n}\n\n/**\n * Collect all subcommand functions recursively\n */\nfunction collectSubcommandFunctions(\n  command: CompletableSubcommand,\n  programName: string,\n  includeDescriptions: boolean,\n  parentPath: string[] = [],\n): string[] {\n  const functions: string[] = [];\n\n  // Generate function for this command\n  functions.push(generateSubcommandFunction(command, programName, includeDescriptions, parentPath));\n\n  // Generate functions for subcommands\n  const currentPath = parentPath.length === 0 ? [command.name] : [...parentPath, command.name];\n\n  for (const sub of command.subcommands) {\n    functions.push(\n      ...collectSubcommandFunctions(sub, programName, includeDescriptions, currentPath),\n    );\n  }\n\n  return functions;\n}\n\n/**\n * Generate the zsh completion script\n */\nfunction generateZshScript(\n  command: CompletableSubcommand,\n  programName: string,\n  includeDescriptions: boolean,\n): string {\n  const functions = collectSubcommandFunctions(command, programName, includeDescriptions);\n\n  return `#compdef ${programName}\n\n# Zsh completion for ${programName}\n# Generated by politty\n\n${functions.join(\"\\n\")}\n\ncompdef _${programName} ${programName}\n`;\n}\n\n/**\n * Generate zsh completion script for a command\n */\nexport function generateZshCompletion(\n  command: AnyCommand,\n  options: CompletionOptions,\n): CompletionResult {\n  const data = extractCompletionData(command, options.programName);\n  const includeDescriptions = options.includeDescriptions ?? true;\n\n  const script = generateZshScript(data.command, options.programName, includeDescriptions);\n\n  return {\n    script,\n    shell: \"zsh\",\n    installInstructions: `# To enable completions, add the following to your ~/.zshrc:\n\n# Option 1: Source directly (add before compinit)\neval \"$(${options.programName} completion zsh)\"\n\n# Option 2: Save to a file in your fpath\n${options.programName} completion zsh > ~/.zsh/completions/_${options.programName}\n\n# Make sure your fpath includes the completions directory:\n# fpath=(~/.zsh/completions $fpath)\n# autoload -Uz compinit && compinit\n\n# Then reload your shell or run:\nsource ~/.zshrc`,\n  };\n}\n","/**\n * Shell completion generation module\n *\n * Provides utilities to generate shell completion scripts for bash, zsh, and fish.\n *\n * @example\n * ```typescript\n * import { generateCompletion, createCompletionCommand } from \"politty/completion\";\n *\n * // Generate completion script directly\n * const result = generateCompletion(myCommand, {\n *   shell: \"bash\",\n *   programName: \"mycli\"\n * });\n * console.log(result.script);\n *\n * // Or add a completion subcommand to your CLI\n * const mainCommand = withCompletionCommand(\n *   defineCommand({\n *     name: \"mycli\",\n *     subCommands: { ... },\n *   }),\n * );\n * ```\n */\n\nimport { z } from \"zod\";\nimport { arg } from \"../core/arg-registry.js\";\nimport { defineCommand } from \"../core/command.js\";\nimport type { AnyCommand, Command } from \"../types.js\";\nimport { generateBashCompletion } from \"./bash.js\";\nimport { generateFishCompletion } from \"./fish.js\";\nimport type { CompletionOptions, CompletionResult, ShellType } from \"./types.js\";\nimport { generateZshCompletion } from \"./zsh.js\";\n\n// Re-export types\n// Re-export extractor\nexport { extractCompletionData, extractPositionals } from \"./extractor.js\";\nexport type {\n  CompletableOption,\n  CompletableSubcommand,\n  CompletionData,\n  CompletionGenerator,\n  CompletionOptions,\n  CompletionResult,\n  ShellType,\n} from \"./types.js\";\n\n/**\n * Generate completion script for the specified shell\n */\nexport function generateCompletion(\n  command: AnyCommand,\n  options: CompletionOptions,\n): CompletionResult {\n  switch (options.shell) {\n    case \"bash\":\n      return generateBashCompletion(command, options);\n    case \"zsh\":\n      return generateZshCompletion(command, options);\n    case \"fish\":\n      return generateFishCompletion(command, options);\n    default:\n      throw new Error(`Unsupported shell: ${options.shell}`);\n  }\n}\n\n/**\n * Get the list of supported shells\n */\nexport function getSupportedShells(): ShellType[] {\n  return [\"bash\", \"zsh\", \"fish\"];\n}\n\n/**\n * Detect the current shell from environment\n */\nexport function detectShell(): ShellType | null {\n  const shell = process.env.SHELL || \"\";\n  const shellName = shell.split(\"/\").pop()?.toLowerCase() || \"\";\n\n  if (shellName.includes(\"bash\")) {\n    return \"bash\";\n  }\n  if (shellName.includes(\"zsh\")) {\n    return \"zsh\";\n  }\n  if (shellName.includes(\"fish\")) {\n    return \"fish\";\n  }\n\n  return null;\n}\n\n/**\n * Schema for the completion command arguments\n */\nconst completionArgsSchema = z.object({\n  shell: arg(\n    z\n      .enum([\"bash\", \"zsh\", \"fish\"])\n      .optional()\n      .describe(\"Shell type (auto-detected if not specified)\"),\n    {\n      positional: true,\n      description: \"Shell type (bash, zsh, or fish)\",\n      placeholder: \"SHELL\",\n    },\n  ),\n  instructions: arg(z.boolean().default(false), {\n    alias: \"i\",\n    description: \"Show installation instructions\",\n  }),\n});\n\ntype CompletionArgs = z.infer<typeof completionArgsSchema>;\n\n/**\n * Create a completion subcommand for your CLI\n *\n * This creates a ready-to-use subcommand that generates completion scripts.\n *\n * @example\n * ```typescript\n * const mainCommand = defineCommand({\n *   name: \"mycli\",\n *   subCommands: {\n *     completion: createCompletionCommand(mainCommand)\n *   }\n * });\n * ```\n */\nexport function createCompletionCommand(\n  rootCommand: AnyCommand,\n  programName?: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Command<typeof completionArgsSchema, CompletionArgs, any> {\n  const resolvedProgramName = programName ?? rootCommand.name;\n  return defineCommand({\n    name: \"completion\",\n    description: \"Generate shell completion script\",\n    args: completionArgsSchema,\n    run(args) {\n      // Detect shell if not specified\n      const shellType = args.shell || detectShell();\n\n      if (!shellType) {\n        console.error(\"Could not detect shell type. Please specify one of: bash, zsh, fish\");\n        process.exitCode = 1;\n        return;\n      }\n\n      const result = generateCompletion(rootCommand, {\n        shell: shellType,\n        programName: resolvedProgramName,\n        includeDescriptions: true,\n      });\n\n      if (args.instructions) {\n        console.log(result.installInstructions);\n      } else {\n        console.log(result.script);\n      }\n    },\n  });\n}\n\n/**\n * Wrap a command with a completion subcommand\n *\n * This avoids circular references that occur when a command references itself\n * in its subCommands (e.g., for completion generation).\n *\n * @param command - The command to wrap\n * @param programName - Override the program name (defaults to command.name)\n * @returns A new command with the completion subcommand added\n *\n * @example\n * ```typescript\n * const mainCommand = withCompletionCommand(\n *   defineCommand({\n *     name: \"mycli\",\n *     subCommands: { ... },\n *   }),\n * );\n * ```\n */\nexport function withCompletionCommand<T extends AnyCommand>(command: T, programName?: string): T {\n  const wrappedCommand = {\n    ...command,\n  } as T;\n\n  wrappedCommand.subCommands = {\n    ...command.subCommands,\n    completion: createCompletionCommand(wrappedCommand, programName),\n  };\n\n  return wrappedCommand;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["generateBashCompletion","generateZshCompletion","generateFishCompletion","z","arg","createDynamicCompleteCommand","defineCommand"],"sources":["../../src/completion/index.ts"],"sourcesContent":["/**\n * Shell completion generation module\n *\n * Provides utilities to generate shell completion scripts for bash, zsh, and fish.\n *\n * @example\n * ```typescript\n * import { generateCompletion, createCompletionCommand } from \"politty/completion\";\n *\n * // Generate completion script directly\n * const result = generateCompletion(myCommand, {\n *   shell: \"bash\",\n *   programName: \"mycli\"\n * });\n * console.log(result.script);\n *\n * // Or add a completion subcommand to your CLI\n * const mainCommand = withCompletionCommand(\n *   defineCommand({\n *     name: \"mycli\",\n *     subCommands: { ... },\n *   }),\n * );\n * ```\n */\n\nimport { z } from \"zod\";\nimport { arg } from \"../core/arg-registry.js\";\nimport { defineCommand } from \"../core/command.js\";\nimport type { AnyCommand, Command } from \"../types.js\";\nimport { generateBashCompletion } from \"./bash.js\";\nimport { createDynamicCompleteCommand } from \"./dynamic/index.js\";\nimport { generateFishCompletion } from \"./fish.js\";\nimport type { CompletionOptions, CompletionResult, ShellType } from \"./types.js\";\nimport { generateZshCompletion } from \"./zsh.js\";\n\n// Re-export types\n// Re-export extractor\n// Re-export dynamic completion\nexport {\n  CompletionDirective,\n  createDynamicCompleteCommand,\n  formatOutput,\n  generateCandidates,\n  hasCompleteCommand,\n  parseCompletionContext,\n  type CandidateResult,\n  type CompletionCandidate,\n  type CompletionContext,\n  type CompletionType,\n} from \"./dynamic/index.js\";\nexport { extractCompletionData, extractPositionals } from \"./extractor.js\";\nexport type {\n  CompletableOption,\n  CompletableSubcommand,\n  CompletionData,\n  CompletionGenerator,\n  CompletionOptions,\n  CompletionResult,\n  ShellType,\n} from \"./types.js\";\n\n/**\n * Generate completion script for the specified shell\n */\nexport function generateCompletion(\n  command: AnyCommand,\n  options: CompletionOptions,\n): CompletionResult {\n  switch (options.shell) {\n    case \"bash\":\n      return generateBashCompletion(command, options);\n    case \"zsh\":\n      return generateZshCompletion(command, options);\n    case \"fish\":\n      return generateFishCompletion(command, options);\n    default:\n      throw new Error(`Unsupported shell: ${options.shell}`);\n  }\n}\n\n/**\n * Get the list of supported shells\n */\nexport function getSupportedShells(): ShellType[] {\n  return [\"bash\", \"zsh\", \"fish\"];\n}\n\n/**\n * Detect the current shell from environment\n */\nexport function detectShell(): ShellType | null {\n  const shell = process.env.SHELL || \"\";\n  const shellName = shell.split(\"/\").pop()?.toLowerCase() || \"\";\n\n  if (shellName.includes(\"bash\")) {\n    return \"bash\";\n  }\n  if (shellName.includes(\"zsh\")) {\n    return \"zsh\";\n  }\n  if (shellName.includes(\"fish\")) {\n    return \"fish\";\n  }\n\n  return null;\n}\n\n/**\n * Schema for the completion command arguments\n */\nconst completionArgsSchema = z.object({\n  shell: arg(\n    z\n      .enum([\"bash\", \"zsh\", \"fish\"])\n      .optional()\n      .describe(\"Shell type (auto-detected if not specified)\"),\n    {\n      positional: true,\n      description: \"Shell type (bash, zsh, or fish)\",\n      placeholder: \"SHELL\",\n    },\n  ),\n  instructions: arg(z.boolean().default(false), {\n    alias: \"i\",\n    description: \"Show installation instructions\",\n  }),\n});\n\ntype CompletionArgs = z.infer<typeof completionArgsSchema>;\n\n/**\n * Create a completion subcommand for your CLI\n *\n * This creates a ready-to-use subcommand that generates completion scripts.\n *\n * @example\n * ```typescript\n * const mainCommand = defineCommand({\n *   name: \"mycli\",\n *   subCommands: {\n *     completion: createCompletionCommand(mainCommand)\n *   }\n * });\n * ```\n */\nexport function createCompletionCommand(\n  rootCommand: AnyCommand,\n  programName?: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Command<typeof completionArgsSchema, CompletionArgs, any> {\n  const resolvedProgramName = programName ?? rootCommand.name;\n\n  if (!rootCommand.subCommands?.__complete) {\n    rootCommand.subCommands = {\n      ...rootCommand.subCommands,\n      __complete: createDynamicCompleteCommand(rootCommand, resolvedProgramName),\n    };\n  }\n\n  return defineCommand({\n    name: \"completion\",\n    description: \"Generate shell completion script\",\n    args: completionArgsSchema,\n    run(args) {\n      // Detect shell if not specified\n      const shellType = args.shell || detectShell();\n\n      if (!shellType) {\n        console.error(\"Could not detect shell type. Please specify one of: bash, zsh, fish\");\n        process.exitCode = 1;\n        return;\n      }\n\n      const result = generateCompletion(rootCommand, {\n        shell: shellType,\n        programName: resolvedProgramName,\n        includeDescriptions: true,\n      });\n\n      if (args.instructions) {\n        console.log(result.installInstructions);\n      } else {\n        console.log(result.script);\n      }\n    },\n  });\n}\n\n/**\n * Options for withCompletionCommand\n */\nexport interface WithCompletionOptions {\n  /** Override the program name (defaults to command.name) */\n  programName?: string;\n}\n\n/**\n * Wrap a command with a completion subcommand\n *\n * This avoids circular references that occur when a command references itself\n * in its subCommands (e.g., for completion generation).\n *\n * @param command - The command to wrap\n * @param options - Options including programName\n * @returns A new command with the completion subcommand added\n *\n * @example\n * ```typescript\n * const mainCommand = withCompletionCommand(\n *   defineCommand({\n *     name: \"mycli\",\n *     subCommands: { ... },\n *   }),\n * );\n * ```\n */\nexport function withCompletionCommand<T extends AnyCommand>(\n  command: T,\n  options?: string | WithCompletionOptions,\n): T {\n  // Support both string (programName) and options object for backwards compatibility\n  const opts: WithCompletionOptions =\n    typeof options === \"string\" ? { programName: options } : (options ?? {});\n\n  const { programName } = opts;\n\n  const wrappedCommand = {\n    ...command,\n  } as T;\n\n  wrappedCommand.subCommands = {\n    ...command.subCommands,\n    completion: createCompletionCommand(wrappedCommand, programName),\n    __complete: createDynamicCompleteCommand(wrappedCommand, programName),\n  };\n\n  return wrappedCommand;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiEA,SAAgB,mBACd,SACA,SACkB;AAClB,SAAQ,QAAQ,OAAhB;EACE,KAAK,OACH,QAAOA,yCAAuB,SAAS,QAAQ;EACjD,KAAK,MACH,QAAOC,wCAAsB,SAAS,QAAQ;EAChD,KAAK,OACH,QAAOC,yCAAuB,SAAS,QAAQ;EACjD,QACE,OAAM,IAAI,MAAM,sBAAsB,QAAQ,QAAQ;;;;;;AAO5D,SAAgB,qBAAkC;AAChD,QAAO;EAAC;EAAQ;EAAO;EAAO;;;;;AAMhC,SAAgB,cAAgC;CAE9C,MAAM,aADQ,QAAQ,IAAI,SAAS,IACX,MAAM,IAAI,CAAC,KAAK,EAAE,aAAa,IAAI;AAE3D,KAAI,UAAU,SAAS,OAAO,CAC5B,QAAO;AAET,KAAI,UAAU,SAAS,MAAM,CAC3B,QAAO;AAET,KAAI,UAAU,SAAS,OAAO,CAC5B,QAAO;AAGT,QAAO;;;;;AAMT,MAAM,uBAAuBC,MAAE,OAAO;CACpC,OAAOC,6BACLD,MACG,KAAK;EAAC;EAAQ;EAAO;EAAO,CAAC,CAC7B,UAAU,CACV,SAAS,8CAA8C,EAC1D;EACE,YAAY;EACZ,aAAa;EACb,aAAa;EACd,CACF;CACD,cAAcC,6BAAID,MAAE,SAAS,CAAC,QAAQ,MAAM,EAAE;EAC5C,OAAO;EACP,aAAa;EACd,CAAC;CACH,CAAC;;;;;;;;;;;;;;;;AAmBF,SAAgB,wBACd,aACA,aAE2D;CAC3D,MAAM,sBAAsB,eAAe,YAAY;AAEvD,KAAI,CAAC,YAAY,aAAa,WAC5B,aAAY,cAAc;EACxB,GAAG,YAAY;EACf,YAAYE,+CAA6B,aAAa,oBAAoB;EAC3E;AAGH,QAAOC,gCAAc;EACnB,MAAM;EACN,aAAa;EACb,MAAM;EACN,IAAI,MAAM;GAER,MAAM,YAAY,KAAK,SAAS,aAAa;AAE7C,OAAI,CAAC,WAAW;AACd,YAAQ,MAAM,sEAAsE;AACpF,YAAQ,WAAW;AACnB;;GAGF,MAAM,SAAS,mBAAmB,aAAa;IAC7C,OAAO;IACP,aAAa;IACb,qBAAqB;IACtB,CAAC;AAEF,OAAI,KAAK,aACP,SAAQ,IAAI,OAAO,oBAAoB;OAEvC,SAAQ,IAAI,OAAO,OAAO;;EAG/B,CAAC;;;;;;;;;;;;;;;;;;;;;;AA+BJ,SAAgB,sBACd,SACA,SACG;CAKH,MAAM,EAAE,gBAFN,OAAO,YAAY,WAAW,EAAE,aAAa,SAAS,GAAI,WAAW,EAAE;CAIzE,MAAM,iBAAiB,EACrB,GAAG,SACJ;AAED,gBAAe,cAAc;EAC3B,GAAG,QAAQ;EACX,YAAY,wBAAwB,gBAAgB,YAAY;EAChE,YAAYD,+CAA6B,gBAAgB,YAAY;EACtE;AAED,QAAO"}