padrone 1.1.0 → 1.3.0

package/dist/completion.mjs

@@ -0,0 +1,417 @@
+import { t as __require } from "./chunk-y_GBKt04.mjs";
+import { i as extractSchemaMetadata } from "./args-DFEI7_G_.mjs";
+//#region src/shell-utils.ts
+/**
+* Detects the current shell from environment variables and process info.
+* @returns The detected shell type, or undefined if unknown
+*/
+function detectShell() {
+	if (typeof process === "undefined") return void 0;
+	const shellEnv = process.env.SHELL || "";
+	if (shellEnv.includes("zsh")) return "zsh";
+	if (shellEnv.includes("bash")) return "bash";
+	if (shellEnv.includes("fish")) return "fish";
+	if (process.env.PSModulePath || process.env.POWERSHELL_DISTRIBUTION_CHANNEL) return "powershell";
+	try {
+		const ppid = process.ppid;
+		if (ppid) {
+			const { execSync } = __require("node:child_process");
+			const processName = execSync(`ps -p ${ppid} -o comm=`, {
+				encoding: "utf-8",
+				stdio: [
+					"pipe",
+					"pipe",
+					"ignore"
+				]
+			}).trim();
+			if (processName.includes("zsh")) return "zsh";
+			if (processName.includes("bash")) return "bash";
+			if (processName.includes("fish")) return "fish";
+		}
+	} catch {}
+}
+function getRcFile(shell, home) {
+	const { homedir } = __require("node:os");
+	const { join } = __require("node:path");
+	const h = home ?? homedir();
+	switch (shell) {
+		case "bash": return join(h, ".bashrc");
+		case "zsh": return join(h, ".zshrc");
+		case "fish": return join(h, ".config", "fish", "config.fish");
+		case "powershell": return process.env.PROFILE || join(h, "Documents", "PowerShell", "Microsoft.PowerShell_profile.ps1");
+		default: return null;
+	}
+}
+function escapeRegExp(str) {
+	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+* Writes a snippet to a shell config file using begin/end markers for idempotency.
+* If a block with the same begin marker exists, it is replaced. Otherwise the snippet is appended.
+*/
+function writeToRcFile(rcFile, snippet, beginMarker, endMarker) {
+	const { existsSync, mkdirSync, readFileSync, writeFileSync } = __require("node:fs");
+	const { dirname } = __require("node:path");
+	const existing = existsSync(rcFile) ? readFileSync(rcFile, "utf-8") : "";
+	if (existing.includes(beginMarker)) {
+		const pattern = new RegExp(`${escapeRegExp(beginMarker)}[\\s\\S]*?${escapeRegExp(endMarker)}`);
+		writeFileSync(rcFile, existing.replace(pattern, snippet));
+		return {
+			file: rcFile,
+			updated: true
+		};
+	}
+	mkdirSync(dirname(rcFile), { recursive: true });
+	writeFileSync(rcFile, `${existing}${existing.length > 0 && !existing.endsWith("\n") ? "\n" : ""}\n${snippet}\n`);
+	return {
+		file: rcFile,
+		updated: false
+	};
+}
+//#endregion
+//#region src/completion.ts
+/**
+* Collects all commands from a program recursively.
+*/
+function collectAllCommands(cmd) {
+	const result = [];
+	if (cmd.commands) {
+		for (const subcmd of cmd.commands) if (!subcmd.hidden) {
+			result.push(subcmd);
+			result.push(...collectAllCommands(subcmd));
+		}
+	}
+	return result;
+}
+/**
+* Extracts all argument names from a command's schema.
+*/
+function extractArguments(cmd) {
+	const argList = [];
+	if (!cmd.argsSchema) return argList;
+	try {
+		const argsMeta = cmd.meta?.fields;
+		const { aliases } = extractSchemaMetadata(cmd.argsSchema, argsMeta, cmd.meta?.autoAlias);
+		const aliasToArgument = {};
+		for (const [arg, alias] of Object.entries(aliases)) aliasToArgument[alias] = arg;
+		const jsonSchema = cmd.argsSchema["~standard"].jsonSchema.input({ target: "draft-2020-12" });
+		if (jsonSchema.type === "object" && jsonSchema.properties) for (const [key, prop] of Object.entries(jsonSchema.properties)) {
+			const alias = Object.entries(aliases).find(([arg]) => arg === key)?.[1];
+			argList.push({
+				name: key,
+				alias,
+				isBoolean: prop?.type === "boolean"
+			});
+		}
+	} catch {}
+	return argList;
+}
+/**
+* Generates a Bash completion script for the program.
+*/
+function generateBashCompletion(program) {
+	const programName = program.name;
+	const commands = collectAllCommands(program);
+	const commandNames = commands.map((c) => c.name).join(" ");
+	const allArguments = /* @__PURE__ */ new Set();
+	allArguments.add("--help");
+	allArguments.add("--version");
+	for (const cmd of [program, ...commands]) for (const arg of extractArguments(cmd)) {
+		allArguments.add(`--${arg.name}`);
+		if (arg.alias) allArguments.add(`-${arg.alias}`);
+	}
+	const argsList = Array.from(allArguments).join(" ");
+	return `###-begin-${programName}-completion-###
+#
+# ${programName} command completion script
+#
+# Installation: ${programName} completion >> ~/.bashrc  (or ~/.zshrc)
+# Or, maybe: ${programName} completion > /usr/local/etc/bash_completion.d/${programName}
+#
+
+if type complete &>/dev/null; then
+  _${programName}_completion() {
+    local cur prev words cword
+    if type _get_comp_words_by_ref &>/dev/null; then
+      _get_comp_words_by_ref -n = -n @ -n : -w words -i cword
+    else
+      cword="$COMP_CWORD"
+      words=("\${COMP_WORDS[@]}")
+    fi
+
+    cur="\${words[cword]}"
+    prev="\${words[cword-1]}"
+
+    local commands="${commandNames}"
+    local args="${argsList}"
+
+    # Complete args when current word starts with -
+    if [[ "$cur" == -* ]]; then
+      COMPREPLY=($(compgen -W "$args" -- "$cur"))
+      return 0
+    fi
+
+    # Complete commands
+    COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+  }
+  complete -o bashdefault -o default -o nospace -F _${programName}_completion ${programName}
+elif type compdef &>/dev/null; then
+  _${programName}_completion() {
+    local si=$IFS
+    local commands="${commandNames}"
+    local args="${argsList}"
+
+    if [[ "\${words[CURRENT]}" == -* ]]; then
+      compadd -- \${=args}
+    else
+      compadd -- \${=commands}
+    fi
+    IFS=$si
+  }
+  compdef _${programName}_completion ${programName}
+elif type compctl &>/dev/null; then
+  _${programName}_completion() {
+    local commands="${commandNames}"
+    local args="${argsList}"
+
+    if [[ "\${words[CURRENT]}" == -* ]]; then
+      reply=(\${=args})
+    else
+      reply=(\${=commands})
+    fi
+  }
+  compctl -K _${programName}_completion ${programName}
+fi
+###-end-${programName}-completion-###`;
+}
+/**
+* Generates a Zsh completion script for the program.
+*/
+function generateZshCompletion(program) {
+	const programName = program.name;
+	const commands = collectAllCommands(program);
+	const commandCompletions = commands.map((cmd) => {
+		const escapedDesc = (cmd.description || cmd.title || "").replace(/'/g, "'\\''").replace(/:/g, "\\:");
+		return `      '${cmd.name}:${escapedDesc}'`;
+	}).join("\n");
+	const argumentCompletions = [];
+	argumentCompletions.push("      '--help[Show help information]'");
+	argumentCompletions.push("      '--version[Show version number]'");
+	const seenArgs = new Set(["help", "version"]);
+	for (const cmd of [program, ...commands]) for (const arg of extractArguments(cmd)) {
+		if (seenArgs.has(arg.name)) continue;
+		seenArgs.add(arg.name);
+		const escapedDesc = (cmd.meta?.fields?.[arg.name]?.description || "").replace(/'/g, "'\\''").replace(/\[/g, "\\[").replace(/\]/g, "\\]");
+		if (arg.alias) argumentCompletions.push(`      {-${arg.alias},--${arg.name}}'[${escapedDesc}]'`);
+		else argumentCompletions.push(`      '--${arg.name}[${escapedDesc}]'`);
+	}
+	return `#compdef ${programName}
+###-begin-${programName}-completion-###
+#
+# ${programName} command completion script for Zsh
+#
+# Installation: ${programName} completion >> ~/.zshrc
+# Or: ${programName} completion > ~/.zsh/completions/_${programName}
+#
+
+_${programName}() {
+  local -a commands
+  local -a args
+
+  commands=(
+${commandCompletions}
+  )
+
+  args=(
+${argumentCompletions.join("\n")}
+  )
+
+  _arguments -s \\
+    $args \\
+    '1: :->command' \\
+    '*::arg:->args'
+
+  case "$state" in
+    command)
+      _describe 'command' commands
+      ;;
+  esac
+}
+
+_${programName}
+###-end-${programName}-completion-###`;
+}
+/**
+* Generates a Fish completion script for the program.
+*/
+function generateFishCompletion(program) {
+	const programName = program.name;
+	const commands = collectAllCommands(program);
+	const lines = [
+		`###-begin-${programName}-completion-###`,
+		"#",
+		`# ${programName} command completion script for Fish`,
+		"#",
+		`# Installation: ${programName} completion > ~/.config/fish/completions/${programName}.fish`,
+		"#",
+		"",
+		`# Clear existing completions`,
+		`complete -c ${programName} -e`,
+		"",
+		"# Commands"
+	];
+	for (const cmd of commands) {
+		const escapedDesc = (cmd.description || cmd.title || "").replace(/'/g, "\\'");
+		lines.push(`complete -c ${programName} -n "__fish_use_subcommand" -a "${cmd.name}" -d '${escapedDesc}'`);
+	}
+	lines.push("");
+	lines.push("# Global arguments");
+	lines.push(`complete -c ${programName} -l help -d 'Show help information'`);
+	lines.push(`complete -c ${programName} -l version -d 'Show version number'`);
+	const seenArgs = new Set(["help", "version"]);
+	for (const cmd of [program, ...commands]) for (const arg of extractArguments(cmd)) {
+		if (seenArgs.has(arg.name)) continue;
+		seenArgs.add(arg.name);
+		const escapedDesc = (cmd.meta?.fields?.[arg.name]?.description || "").replace(/'/g, "\\'");
+		if (arg.alias) lines.push(`complete -c ${programName} -s ${arg.alias} -l ${arg.name} -d '${escapedDesc}'`);
+		else lines.push(`complete -c ${programName} -l ${arg.name} -d '${escapedDesc}'`);
+	}
+	lines.push(`###-end-${programName}-completion-###`);
+	return lines.join("\n");
+}
+/**
+* Generates a PowerShell completion script for the program.
+*/
+function generatePowerShellCompletion(program) {
+	const programName = program.name;
+	return `###-begin-${programName}-completion-###
+#
+# ${programName} command completion script for PowerShell
+#
+# Installation: ${programName} completion >> $PROFILE
+#
+
+Register-ArgumentCompleter -Native -CommandName ${programName} -ScriptBlock {
+  param($wordToComplete, $commandAst, $cursorPosition)
+
+  $commands = @(${collectAllCommands(program).map((c) => `'${c.name}'`).join(", ")})
+  $args = @('--help', '--version')
+
+  if ($wordToComplete -like '-*') {
+    $args | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+      [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+    }
+  } else {
+    $commands | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+      [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+    }
+  }
+}
+###-end-${programName}-completion-###`;
+}
+/**
+* Generates a completion script for the specified shell.
+*/
+function generateCompletion(program, shell) {
+	switch (shell) {
+		case "bash": return generateBashCompletion(program);
+		case "zsh": return generateZshCompletion(program);
+		case "fish": return generateFishCompletion(program);
+		case "powershell": return generatePowerShellCompletion(program);
+		default: throw new Error(`Unsupported shell: ${shell}`);
+	}
+}
+/**
+* Gets the installation instructions for a shell completion script.
+*/
+function getCompletionInstallInstructions(programName, shell) {
+	switch (shell) {
+		case "bash": return `# Add to ~/.bashrc:
+${programName} completion bash >> ~/.bashrc
+
+# Or install system-wide:
+${programName} completion bash > /usr/local/etc/bash_completion.d/${programName}`;
+		case "zsh": return `# Add to ~/.zshrc:
+${programName} completion zsh >> ~/.zshrc
+
+# Or add to completions directory:
+${programName} completion zsh > ~/.zsh/completions/_${programName}`;
+		case "fish": return `# Install to Fish completions:
+${programName} completion fish > ~/.config/fish/completions/${programName}.fish`;
+		case "powershell": return `# Add to PowerShell profile:
+${programName} completion powershell >> $PROFILE`;
+		default: return `# Run: ${programName} completion <shell>
+# Supported shells: bash, zsh, fish, powershell`;
+	}
+}
+/**
+* Generates the completion output with automatic shell detection.
+* If shell is not specified, detects the current shell and provides instructions.
+*/
+function generateCompletionOutput(program, shell) {
+	const programName = program.name;
+	if (shell) return generateCompletion(program, shell);
+	const detectedShell = detectShell();
+	if (detectedShell) return `# Detected shell: ${detectedShell}
+#
+${getCompletionInstallInstructions(programName, detectedShell)}
+#
+# Or evaluate directly (temporary, for current session only):
+# eval "$(${programName} completion ${detectedShell})"
+
+${generateCompletion(program, detectedShell)}`;
+	return `# Shell auto-detection failed.
+#
+# Usage: ${programName} completion <shell>
+#
+# Supported shells:
+#   bash       - Bash completion script
+#   zsh        - Zsh completion script
+#   fish       - Fish completion script
+#   powershell - PowerShell completion script
+#
+# Example:
+#   ${programName} completion bash >> ~/.bashrc
+#   ${programName} completion zsh >> ~/.zshrc
+#   ${programName} completion fish > ~/.config/fish/completions/${programName}.fish
+#   ${programName} completion powershell >> $PROFILE`;
+}
+/**
+* Sets up shell completions by writing an eval snippet to the appropriate shell config file.
+* Uses marker comments for idempotency — re-running replaces the existing block.
+*/
+function setupCompletions(programName, shell) {
+	const { existsSync, mkdirSync, writeFileSync } = __require("node:fs");
+	const { join } = __require("node:path");
+	const { homedir } = __require("node:os");
+	const beginMarker = `###-begin-${programName}-completion-###`;
+	const endMarker = `###-end-${programName}-completion-###`;
+	const snippet = buildSetupSnippet(programName, shell, beginMarker, endMarker);
+	if (shell === "fish") {
+		const completionsDir = join(homedir(), ".config", "fish", "completions");
+		const filePath = join(completionsDir, `${programName}.fish`);
+		mkdirSync(completionsDir, { recursive: true });
+		const existed = existsSync(filePath);
+		writeFileSync(filePath, `${snippet}\n`);
+		return {
+			file: filePath,
+			updated: existed
+		};
+	}
+	const rcFile = getRcFile(shell);
+	if (!rcFile) throw new Error(`Could not determine config file for ${shell}.`);
+	return writeToRcFile(rcFile, snippet, beginMarker, endMarker);
+}
+function buildSetupSnippet(programName, shell, beginMarker, endMarker) {
+	const evalCmd = `${programName} completion ${shell}`;
+	switch (shell) {
+		case "bash":
+		case "zsh": return `${beginMarker}\neval "$(${evalCmd})"\n${endMarker}`;
+		case "fish": return `${beginMarker}\n${evalCmd} | source\n${endMarker}`;
+		case "powershell": return `${beginMarker}\n${evalCmd} | Invoke-Expression\n${endMarker}`;
+	}
+}
+//#endregion
+export { detectShell, escapeRegExp, generateBashCompletion, generateCompletion, generateCompletionOutput, generateFishCompletion, generatePowerShellCompletion, generateZshCompletion, getCompletionInstallInstructions, getRcFile, setupCompletions, writeToRcFile };
+
+//# sourceMappingURL=completion.mjs.map

package/dist/completion.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.mjs","names":[],"sources":["../src/shell-utils.ts","../src/completion.ts"],"sourcesContent":["export type ShellType = 'bash' | 'zsh' | 'fish' | 'powershell';\n\n/**\n * Detects the current shell from environment variables and process info.\n * @returns The detected shell type, or undefined if unknown\n */\nexport function detectShell(): ShellType | undefined {\n  if (typeof process === 'undefined') return undefined;\n\n  // Method 1: Check SHELL environment variable (most common)\n  const shellEnv = process.env.SHELL || '';\n  if (shellEnv.includes('zsh')) return 'zsh';\n  if (shellEnv.includes('bash')) return 'bash';\n  if (shellEnv.includes('fish')) return 'fish';\n\n  // Method 2: Check Windows-specific shells\n  if (process.env.PSModulePath || process.env.POWERSHELL_DISTRIBUTION_CHANNEL) {\n    return 'powershell';\n  }\n\n  // Method 3: Check parent process on Unix-like systems\n  try {\n    const ppid = process.ppid;\n    if (ppid) {\n      const { execSync } = require('node:child_process') as typeof import('node:child_process');\n      const processName = execSync(`ps -p ${ppid} -o comm=`, {\n        encoding: 'utf-8',\n        stdio: ['pipe', 'pipe', 'ignore'],\n      }).trim();\n\n      if (processName.includes('zsh')) return 'zsh';\n      if (processName.includes('bash')) return 'bash';\n      if (processName.includes('fish')) return 'fish';\n    }\n  } catch {\n    // Ignore errors (e.g., ps not available)\n  }\n\n  return undefined;\n}\n\nexport function getRcFile(shell: ShellType, home?: string): string | null {\n  const { homedir } = require('node:os') as typeof import('node:os');\n  const { join } = require('node:path') as typeof import('node:path');\n  const h = home ?? homedir();\n  switch (shell) {\n    case 'bash':\n      return join(h, '.bashrc');\n    case 'zsh':\n      return join(h, '.zshrc');\n    case 'fish':\n      return join(h, '.config', 'fish', 'config.fish');\n    case 'powershell':\n      return process.env.PROFILE || join(h, 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1');\n    default:\n      return null;\n  }\n}\n\nexport function escapeRegExp(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Writes a snippet to a shell config file using begin/end markers for idempotency.\n * If a block with the same begin marker exists, it is replaced. Otherwise the snippet is appended.\n */\nexport function writeToRcFile(rcFile: string, snippet: string, beginMarker: string, endMarker: string): { file: string; updated: boolean } {\n  const { existsSync, mkdirSync, readFileSync, writeFileSync } = require('node:fs') as typeof import('node:fs');\n  const { dirname } = require('node:path') as typeof import('node:path');\n  const existing = existsSync(rcFile) ? readFileSync(rcFile, 'utf-8') : '';\n\n  if (existing.includes(beginMarker)) {\n    const pattern = new RegExp(`${escapeRegExp(beginMarker)}[\\\\s\\\\S]*?${escapeRegExp(endMarker)}`);\n    writeFileSync(rcFile, existing.replace(pattern, snippet));\n    return { file: rcFile, updated: true };\n  }\n\n  mkdirSync(dirname(rcFile), { recursive: true });\n  const separator = existing.length > 0 && !existing.endsWith('\\n') ? '\\n' : '';\n  writeFileSync(rcFile, `${existing}${separator}\\n${snippet}\\n`);\n  return { file: rcFile, updated: false };\n}\n","import { extractSchemaMetadata } from './args.ts';\nimport { detectShell, getRcFile, type ShellType, writeToRcFile } from './shell-utils.ts';\nimport type { AnyPadroneCommand } from './types.ts';\n\nexport { detectShell, escapeRegExp, getRcFile, type ShellType, writeToRcFile } from './shell-utils.ts';\n\n/**\n * Collects all commands from a program recursively.\n */\nfunction collectAllCommands(cmd: AnyPadroneCommand): AnyPadroneCommand[] {\n  const result: AnyPadroneCommand[] = [];\n\n  if (cmd.commands) {\n    for (const subcmd of cmd.commands) {\n      if (!subcmd.hidden) {\n        result.push(subcmd);\n        result.push(...collectAllCommands(subcmd));\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Extracts all argument names from a command's schema.\n */\nfunction extractArguments(cmd: AnyPadroneCommand): { name: string; alias?: string; isBoolean: boolean }[] {\n  const argList: { name: string; alias?: string; isBoolean: boolean }[] = [];\n\n  if (!cmd.argsSchema) return argList;\n\n  try {\n    const argsMeta = cmd.meta?.fields;\n    const { aliases } = extractSchemaMetadata(cmd.argsSchema, argsMeta, cmd.meta?.autoAlias);\n\n    // Reverse aliases map (alias -> arg name)\n    const aliasToArgument: Record<string, string> = {};\n    for (const [arg, alias] of Object.entries(aliases)) {\n      aliasToArgument[alias] = arg;\n    }\n\n    const jsonSchema = cmd.argsSchema['~standard'].jsonSchema.input({ target: 'draft-2020-12' }) as Record<string, any>;\n\n    if (jsonSchema.type === 'object' && jsonSchema.properties) {\n      for (const [key, prop] of Object.entries(jsonSchema.properties as Record<string, any>)) {\n        const alias = Object.entries(aliases).find(([arg]) => arg === key)?.[1];\n        argList.push({\n          name: key,\n          alias: alias,\n          isBoolean: prop?.type === 'boolean',\n        });\n      }\n    }\n  } catch {\n    // Ignore schema parsing errors\n  }\n\n  return argList;\n}\n\n/**\n * Generates a Bash completion script for the program.\n */\nexport function generateBashCompletion(program: AnyPadroneCommand): string {\n  const programName = program.name;\n  const commands = collectAllCommands(program);\n  const commandNames = commands.map((c) => c.name).join(' ');\n\n  // Collect all args from all commands\n  const allArguments = new Set<string>();\n  allArguments.add('--help');\n  allArguments.add('--version');\n\n  for (const cmd of [program, ...commands]) {\n    for (const arg of extractArguments(cmd)) {\n      allArguments.add(`--${arg.name}`);\n      if (arg.alias) allArguments.add(`-${arg.alias}`);\n    }\n  }\n\n  const argsList = Array.from(allArguments).join(' ');\n\n  return `###-begin-${programName}-completion-###\n#\n# ${programName} command completion script\n#\n# Installation: ${programName} completion >> ~/.bashrc  (or ~/.zshrc)\n# Or, maybe: ${programName} completion > /usr/local/etc/bash_completion.d/${programName}\n#\n\nif type complete &>/dev/null; then\n  _${programName}_completion() {\n    local cur prev words cword\n    if type _get_comp_words_by_ref &>/dev/null; then\n      _get_comp_words_by_ref -n = -n @ -n : -w words -i cword\n    else\n      cword=\"$COMP_CWORD\"\n      words=(\"\\${COMP_WORDS[@]}\")\n    fi\n\n    cur=\"\\${words[cword]}\"\n    prev=\"\\${words[cword-1]}\"\n\n    local commands=\"${commandNames}\"\n    local args=\"${argsList}\"\n\n    # Complete args when current word starts with -\n    if [[ \"$cur\" == -* ]]; then\n      COMPREPLY=($(compgen -W \"$args\" -- \"$cur\"))\n      return 0\n    fi\n\n    # Complete commands\n    COMPREPLY=($(compgen -W \"$commands\" -- \"$cur\"))\n  }\n  complete -o bashdefault -o default -o nospace -F _${programName}_completion ${programName}\nelif type compdef &>/dev/null; then\n  _${programName}_completion() {\n    local si=$IFS\n    local commands=\"${commandNames}\"\n    local args=\"${argsList}\"\n\n    if [[ \"\\${words[CURRENT]}\" == -* ]]; then\n      compadd -- \\${=args}\n    else\n      compadd -- \\${=commands}\n    fi\n    IFS=$si\n  }\n  compdef _${programName}_completion ${programName}\nelif type compctl &>/dev/null; then\n  _${programName}_completion() {\n    local commands=\"${commandNames}\"\n    local args=\"${argsList}\"\n\n    if [[ \"\\${words[CURRENT]}\" == -* ]]; then\n      reply=(\\${=args})\n    else\n      reply=(\\${=commands})\n    fi\n  }\n  compctl -K _${programName}_completion ${programName}\nfi\n###-end-${programName}-completion-###`;\n}\n\n/**\n * Generates a Zsh completion script for the program.\n */\nexport function generateZshCompletion(program: AnyPadroneCommand): string {\n  const programName = program.name;\n  const commands = collectAllCommands(program);\n\n  // Generate command completions with descriptions\n  const commandCompletions = commands\n    .map((cmd) => {\n      const desc = cmd.description || cmd.title || '';\n      const escapedDesc = desc.replace(/'/g, \"'\\\\''\").replace(/:/g, '\\\\:');\n      return `      '${cmd.name}:${escapedDesc}'`;\n    })\n    .join('\\n');\n\n  // Collect all args with descriptions\n  const argumentCompletions: string[] = [];\n  argumentCompletions.push(\"      '--help[Show help information]'\");\n  argumentCompletions.push(\"      '--version[Show version number]'\");\n\n  const seenArgs = new Set<string>(['help', 'version']);\n\n  for (const cmd of [program, ...commands]) {\n    for (const arg of extractArguments(cmd)) {\n      if (seenArgs.has(arg.name)) continue;\n      seenArgs.add(arg.name);\n\n      const desc = cmd.meta?.fields?.[arg.name]?.description || '';\n      const escapedDesc = desc.replace(/'/g, \"'\\\\''\").replace(/\\[/g, '\\\\[').replace(/\\]/g, '\\\\]');\n\n      if (arg.alias) {\n        argumentCompletions.push(`      {-${arg.alias},--${arg.name}}'[${escapedDesc}]'`);\n      } else {\n        argumentCompletions.push(`      '--${arg.name}[${escapedDesc}]'`);\n      }\n    }\n  }\n\n  return `#compdef ${programName}\n###-begin-${programName}-completion-###\n#\n# ${programName} command completion script for Zsh\n#\n# Installation: ${programName} completion >> ~/.zshrc\n# Or: ${programName} completion > ~/.zsh/completions/_${programName}\n#\n\n_${programName}() {\n  local -a commands\n  local -a args\n\n  commands=(\n${commandCompletions}\n  )\n\n  args=(\n${argumentCompletions.join('\\n')}\n  )\n\n  _arguments -s \\\\\n    $args \\\\\n    '1: :->command' \\\\\n    '*::arg:->args'\n\n  case \"$state\" in\n    command)\n      _describe 'command' commands\n      ;;\n  esac\n}\n\n_${programName}\n###-end-${programName}-completion-###`;\n}\n\n/**\n * Generates a Fish completion script for the program.\n */\nexport function generateFishCompletion(program: AnyPadroneCommand): string {\n  const programName = program.name;\n  const commands = collectAllCommands(program);\n\n  const lines: string[] = [\n    `###-begin-${programName}-completion-###`,\n    '#',\n    `# ${programName} command completion script for Fish`,\n    '#',\n    `# Installation: ${programName} completion > ~/.config/fish/completions/${programName}.fish`,\n    '#',\n    '',\n    `# Clear existing completions`,\n    `complete -c ${programName} -e`,\n    '',\n    '# Commands',\n  ];\n\n  for (const cmd of commands) {\n    const desc = cmd.description || cmd.title || '';\n    const escapedDesc = desc.replace(/'/g, \"\\\\'\");\n    lines.push(`complete -c ${programName} -n \"__fish_use_subcommand\" -a \"${cmd.name}\" -d '${escapedDesc}'`);\n  }\n\n  lines.push('');\n  lines.push('# Global arguments');\n  lines.push(`complete -c ${programName} -l help -d 'Show help information'`);\n  lines.push(`complete -c ${programName} -l version -d 'Show version number'`);\n\n  const seenArgs = new Set<string>(['help', 'version']);\n\n  for (const cmd of [program, ...commands]) {\n    for (const arg of extractArguments(cmd)) {\n      if (seenArgs.has(arg.name)) continue;\n      seenArgs.add(arg.name);\n\n      const desc = cmd.meta?.fields?.[arg.name]?.description || '';\n      const escapedDesc = desc.replace(/'/g, \"\\\\'\");\n\n      if (arg.alias) {\n        lines.push(`complete -c ${programName} -s ${arg.alias} -l ${arg.name} -d '${escapedDesc}'`);\n      } else {\n        lines.push(`complete -c ${programName} -l ${arg.name} -d '${escapedDesc}'`);\n      }\n    }\n  }\n\n  lines.push(`###-end-${programName}-completion-###`);\n\n  return lines.join('\\n');\n}\n\n/**\n * Generates a PowerShell completion script for the program.\n */\nexport function generatePowerShellCompletion(program: AnyPadroneCommand): string {\n  const programName = program.name;\n  const commands = collectAllCommands(program);\n\n  const commandNames = commands.map((c) => `'${c.name}'`).join(', ');\n\n  return `###-begin-${programName}-completion-###\n#\n# ${programName} command completion script for PowerShell\n#\n# Installation: ${programName} completion >> $PROFILE\n#\n\nRegister-ArgumentCompleter -Native -CommandName ${programName} -ScriptBlock {\n  param($wordToComplete, $commandAst, $cursorPosition)\n\n  $commands = @(${commandNames})\n  $args = @('--help', '--version')\n\n  if ($wordToComplete -like '-*') {\n    $args | Where-Object { $_ -like \"$wordToComplete*\" } | ForEach-Object {\n      [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)\n    }\n  } else {\n    $commands | Where-Object { $_ -like \"$wordToComplete*\" } | ForEach-Object {\n      [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)\n    }\n  }\n}\n###-end-${programName}-completion-###`;\n}\n\n/**\n * Generates a completion script for the specified shell.\n */\nexport function generateCompletion(program: AnyPadroneCommand, shell: ShellType): string {\n  switch (shell) {\n    case 'bash':\n      return generateBashCompletion(program);\n    case 'zsh':\n      return generateZshCompletion(program);\n    case 'fish':\n      return generateFishCompletion(program);\n    case 'powershell':\n      return generatePowerShellCompletion(program);\n    default:\n      throw new Error(`Unsupported shell: ${shell}`);\n  }\n}\n\n/**\n * Gets the installation instructions for a shell completion script.\n */\nexport function getCompletionInstallInstructions(programName: string, shell: ShellType): string {\n  switch (shell) {\n    case 'bash':\n      return `# Add to ~/.bashrc:\n${programName} completion bash >> ~/.bashrc\n\n# Or install system-wide:\n${programName} completion bash > /usr/local/etc/bash_completion.d/${programName}`;\n\n    case 'zsh':\n      return `# Add to ~/.zshrc:\n${programName} completion zsh >> ~/.zshrc\n\n# Or add to completions directory:\n${programName} completion zsh > ~/.zsh/completions/_${programName}`;\n\n    case 'fish':\n      return `# Install to Fish completions:\n${programName} completion fish > ~/.config/fish/completions/${programName}.fish`;\n\n    case 'powershell':\n      return `# Add to PowerShell profile:\n${programName} completion powershell >> $PROFILE`;\n\n    default:\n      return `# Run: ${programName} completion <shell>\n# Supported shells: bash, zsh, fish, powershell`;\n  }\n}\n\n/**\n * Generates the completion output with automatic shell detection.\n * If shell is not specified, detects the current shell and provides instructions.\n */\nexport function generateCompletionOutput(program: AnyPadroneCommand, shell?: ShellType): string {\n  const programName = program.name;\n\n  if (shell) {\n    return generateCompletion(program, shell);\n  }\n\n  // Auto-detect shell and provide instructions\n  const detectedShell = detectShell();\n\n  if (detectedShell) {\n    const instructions = getCompletionInstallInstructions(programName, detectedShell);\n    const script = generateCompletion(program, detectedShell);\n\n    return `# Detected shell: ${detectedShell}\n#\n${instructions}\n#\n# Or evaluate directly (temporary, for current session only):\n# eval \"$(${programName} completion ${detectedShell})\"\n\n${script}`;\n  }\n\n  // Could not detect shell - provide usage info\n  return `# Shell auto-detection failed.\n#\n# Usage: ${programName} completion <shell>\n#\n# Supported shells:\n#   bash       - Bash completion script\n#   zsh        - Zsh completion script\n#   fish       - Fish completion script\n#   powershell - PowerShell completion script\n#\n# Example:\n#   ${programName} completion bash >> ~/.bashrc\n#   ${programName} completion zsh >> ~/.zshrc\n#   ${programName} completion fish > ~/.config/fish/completions/${programName}.fish\n#   ${programName} completion powershell >> $PROFILE`;\n}\n\nexport interface SetupCompletionsResult {\n  /** The file that was written to. */\n  file: string;\n  /** Whether an existing completion block was replaced (true) or a new one was appended (false). */\n  updated: boolean;\n}\n\n/**\n * Sets up shell completions by writing an eval snippet to the appropriate shell config file.\n * Uses marker comments for idempotency — re-running replaces the existing block.\n */\nexport function setupCompletions(programName: string, shell: ShellType): SetupCompletionsResult {\n  const { existsSync, mkdirSync, writeFileSync } = require('node:fs') as typeof import('node:fs');\n  const { join } = require('node:path') as typeof import('node:path');\n  const { homedir } = require('node:os') as typeof import('node:os');\n\n  const beginMarker = `###-begin-${programName}-completion-###`;\n  const endMarker = `###-end-${programName}-completion-###`;\n  const snippet = buildSetupSnippet(programName, shell, beginMarker, endMarker);\n\n  if (shell === 'fish') {\n    const completionsDir = join(homedir(), '.config', 'fish', 'completions');\n    const filePath = join(completionsDir, `${programName}.fish`);\n    mkdirSync(completionsDir, { recursive: true });\n    const existed = existsSync(filePath);\n    writeFileSync(filePath, `${snippet}\\n`);\n    return { file: filePath, updated: existed };\n  }\n\n  const rcFile = getRcFile(shell);\n  if (!rcFile) {\n    throw new Error(`Could not determine config file for ${shell}.`);\n  }\n\n  return writeToRcFile(rcFile, snippet, beginMarker, endMarker);\n}\n\nfunction buildSetupSnippet(programName: string, shell: ShellType, beginMarker: string, endMarker: string): string {\n  const evalCmd = `${programName} completion ${shell}`;\n\n  switch (shell) {\n    case 'bash':\n    case 'zsh':\n      return `${beginMarker}\\neval \"$(${evalCmd})\"\\n${endMarker}`;\n    case 'fish':\n      return `${beginMarker}\\n${evalCmd} | source\\n${endMarker}`;\n    case 'powershell':\n      return `${beginMarker}\\n${evalCmd} | Invoke-Expression\\n${endMarker}`;\n  }\n}\n"],"mappings":"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"}

package/dist/docs/index.d.mts

@@ -0,0 +1,34 @@
+import { r as HelpInfo } from "../formatter-XroimS3Q.mjs";
+
+//#region src/docs/index.d.ts
+type DocsFormat = 'markdown' | 'html' | 'man' | 'json';
+type DocsOptions = {
+  /** Output format. Defaults to 'markdown'. */format?: DocsFormat; /** Output directory. If not set, docs are returned but not written. */
+  output?: string; /** Include hidden commands and options. Defaults to false. */
+  includeHidden?: boolean; /** Frontmatter generator for markdown files (VitePress, Starlight, etc.). */
+  frontmatter?: (info: HelpInfo, depth: number) => Record<string, unknown>; /** Whether to overwrite existing files. Defaults to true. */
+  overwrite?: boolean; /** Print what would be written without writing. */
+  dryRun?: boolean;
+};
+type DocsPage = {
+  /** File path relative to output directory (e.g., "deploy.md", "index.md"). */path: string; /** Generated content for this page. */
+  content: string; /** The command name this page documents. */
+  command: string;
+};
+type DocsResult = {
+  /** All generated pages. */pages: DocsPage[]; /** Files that were written (empty if no output dir). */
+  written: string[]; /** Files that were skipped (already exist, no overwrite). */
+  skipped: string[]; /** Files that failed to write. */
+  errors: {
+    file: string;
+    error: Error;
+  }[];
+};
+/**
+ * Generate documentation for a Padrone CLI program or command tree.
+ * Accepts either a PadroneProgram (from createPadrone()) or a raw AnyPadroneCommand.
+ */
+declare function generateDocs(program: object, options?: DocsOptions): DocsResult;
+//#endregion
+export { DocsFormat, DocsOptions, DocsPage, DocsResult, generateDocs };
+//# sourceMappingURL=index.d.mts.map

package/dist/docs/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/docs/index.ts"],"mappings":";;;KAWY,UAAA;AAAA,KAEA,WAAA;EAFA,6CAIV,MAAA,GAAS,UAAA;EAET,MAAA,WANoB;EAQpB,aAAA,YANqB;EAQrB,WAAA,IAAe,IAAA,EAAM,QAAA,EAAU,KAAA,aAAkB,MAAA,mBANxC;EAQT,SAAA,YAFiD;EAIjD,MAAA;AAAA;AAAA,KAGU,QAAA;EAbD,8EAeT,IAAA,UAXA;EAaA,OAAA,UAXqB;EAarB,OAAA;AAAA;AAAA,KAGU,UAAA;EAdV,2BAgBA,KAAA,EAAO,QAAA,IAdD;EAgBN,OAAA,YAbU;EAeV,OAAA;EAEA,MAAA;IAAU,IAAA;IAAc,KAAA,EAAO,KAAA;EAAA;AAAA;;AARjC;;;iBA2egB,YAAA,CAAa,OAAA,UAAiB,OAAA,GAAS,WAAA,GAAmB,UAAA"}