@boneskull/bargs 4.0.1 → 4.1.0

package/dist/completion.cjs

@@ -0,0 +1,565 @@
+"use strict";
+/**
+ * Shell completion script generation for bargs CLIs.
+ *
+ * Provides dynamic shell completion support for bash, zsh, and fish shells. The
+ * generated scripts call back to the CLI to get completion candidates.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateShell = exports.getCompletionCandidates = exports.generateCompletionScript = void 0;
+/**
+ * Sanitize a CLI name for use as a shell function name.
+ *
+ * Ensures the result is a valid POSIX identifier: starts with a letter or
+ * underscore, contains only alphanumeric characters and underscores.
+ *
+ * @function
+ * @param name - The CLI name to sanitize
+ * @returns A valid shell function name
+ */
+const sanitizeFunctionName = (name) => {
+    // Replace any non-alphanumeric character with underscore
+    let sanitized = name.replace(/[^a-zA-Z0-9]/g, '_');
+    // Collapse multiple consecutive underscores
+    sanitized = sanitized.replace(/_+/g, '_');
+    // Remove leading/trailing underscores
+    sanitized = sanitized.replace(/^_+|_+$/g, '');
+    // Ensure it starts with a letter or underscore (not a digit)
+    if (/^[0-9]/.test(sanitized)) {
+        sanitized = `_${sanitized}`;
+    }
+    // Fallback for empty result
+    if (!sanitized) {
+        sanitized = 'cli';
+    }
+    return sanitized;
+};
+/**
+ * Generate bash completion script.
+ *
+ * @function
+ */
+const generateBashScript = (cliName) => {
+    const funcName = `_${sanitizeFunctionName(cliName)}_completions`;
+    return `# bash completion for ${cliName}
+# Add to ~/.bashrc or ~/.bash_profile:
+#   source <(${cliName} --completion-script bash)
+# Or:
+#   ${cliName} --completion-script bash >> ~/.bashrc
+
+${funcName}() {
+    local IFS=$'\\n'
+    local cur="\${COMP_WORDS[COMP_CWORD]}"
+    
+    # Call CLI to get completions
+    local completions
+    completions=($("${cliName}" --get-bargs-completions bash "\${COMP_WORDS[@]}"))
+    
+    # Filter by current word prefix
+    COMPREPLY=($(compgen -W "\${completions[*]}" -- "\${cur}"))
+    
+    # Fall back to file completion if no matches and not completing an option
+    if [[ \${#COMPREPLY[@]} -eq 0 && "\${cur}" != -* ]]; then
+        compopt -o default
+    fi
+}
+
+complete -o default -F ${funcName} ${cliName}
+`;
+};
+/**
+ * Generate zsh completion script.
+ *
+ * @function
+ */
+const generateZshScript = (cliName) => {
+    const funcName = `_${sanitizeFunctionName(cliName)}`;
+    return `#compdef ${cliName}
+# zsh completion for ${cliName}
+# Add to ~/.zshrc:
+#   source <(${cliName} --completion-script zsh)
+# Or save to a file in your $fpath:
+#   ${cliName} --completion-script zsh > ~/.zsh/completions/_${cliName}
+
+${funcName}() {
+    local completions
+    
+    # Call CLI to get completions with descriptions
+    completions=("\${(@f)$("${cliName}" --get-bargs-completions zsh "\${words[@]}")}")
+    
+    if [[ \${#completions[@]} -gt 0 && -n "\${completions[1]}" ]]; then
+        # Check if completions have descriptions (format: "value:description")
+        if [[ "\${completions[1]}" == *":"* ]]; then
+            _describe 'completions' completions
+        else
+            compadd -a completions
+        fi
+    fi
+}
+
+compdef ${funcName} ${cliName}
+`;
+};
+/**
+ * Generate fish completion script.
+ *
+ * @function
+ */
+const generateFishScript = (cliName) => {
+    const funcName = `__fish_${sanitizeFunctionName(cliName)}_complete`;
+    return `# fish completion for ${cliName}
+# Save to ~/.config/fish/completions/${cliName}.fish:
+#   ${cliName} --completion-script fish > ~/.config/fish/completions/${cliName}.fish
+
+function ${funcName}
+    set -l tokens (commandline -opc)
+    ${cliName} --get-bargs-completions fish $tokens
+end
+
+# Disable file completions by default, let the CLI decide
+complete -c ${cliName} -f -a '(${funcName})'
+`;
+};
+/**
+ * Generate a shell completion script for the given CLI.
+ *
+ * The generated script calls back to the CLI with `--get-bargs-completions` to
+ * get completion candidates dynamically.
+ *
+ * @example
+ *
+ * ```typescript
+ * // Output script for bash
+ * console.log(generateCompletionScript('mytool', 'bash'));
+ * // Redirect to shell config: mytool --completion-script bash >> ~/.bashrc
+ * ```
+ *
+ * @function
+ * @param cliName - The name of the CLI executable
+ * @param shell - The target shell ('bash', 'zsh', or 'fish')
+ * @returns The completion script as a string
+ * @group Completion
+ */
+const generateCompletionScript = (cliName, shell) => {
+    switch (shell) {
+        case 'bash':
+            return generateBashScript(cliName);
+        case 'fish':
+            return generateFishScript(cliName);
+        case 'zsh':
+            return generateZshScript(cliName);
+        default:
+            throw new Error(`Unsupported shell: ${shell}`);
+    }
+};
+exports.generateCompletionScript = generateCompletionScript;
+/**
+ * Extract completion metadata from internal CLI state.
+ *
+ * @function
+ */
+const extractCompletionMetadata = (state) => {
+    const globalOptions = extractOptionsInfo(state.globalParser?.__optionsSchema ?? {});
+    const commands = new Map();
+    for (const [name, entry] of state.commands) {
+        // Skip the internal default command marker
+        if (name === '__default__') {
+            continue;
+        }
+        if (entry.type === 'command') {
+            commands.set(name, {
+                aliases: entry.aliases ?? [],
+                description: entry.description,
+                name,
+                options: extractOptionsInfo(entry.cmd.__optionsSchema),
+                positionals: extractPositionalsInfo(entry.cmd.__positionalsSchema),
+            });
+        }
+        else if (entry.type === 'nested') {
+            commands.set(name, {
+                aliases: entry.aliases ?? [],
+                description: entry.description,
+                name,
+                nestedBuilder: entry.builder,
+                options: [],
+                positionals: [],
+            });
+        }
+    }
+    return {
+        commands,
+        globalOptions,
+        name: state.name,
+    };
+};
+/**
+ * Check if a value is an internal builder with __getState method.
+ *
+ * @function
+ */
+const isInternalBuilder = (value) => {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '__getState' in value &&
+        typeof value.__getState === 'function');
+};
+/**
+ * Extract metadata from a nested builder.
+ *
+ * @function
+ */
+const extractNestedMetadata = (nestedBuilder) => {
+    if (!isInternalBuilder(nestedBuilder)) {
+        return undefined;
+    }
+    return extractCompletionMetadata(nestedBuilder.__getState());
+};
+/**
+ * Extract option info from options schema.
+ *
+ * @function
+ */
+const extractOptionsInfo = (schema) => {
+    const options = [];
+    for (const [name, def] of Object.entries(schema)) {
+        // Skip hidden options
+        if (def.hidden) {
+            continue;
+        }
+        const aliases = [];
+        if ('aliases' in def && Array.isArray(def.aliases)) {
+            for (const alias of def.aliases) {
+                if (alias.length === 1) {
+                    aliases.push(`-${alias}`);
+                }
+                else {
+                    aliases.push(`--${alias}`);
+                }
+            }
+        }
+        options.push({
+            aliases,
+            choices: getChoices(def),
+            description: def.description,
+            name: `--${name}`,
+            takesValue: def.type !== 'boolean' && def.type !== 'count',
+            type: def.type,
+        });
+        // Add --no-<name> for boolean options
+        if (def.type === 'boolean') {
+            options.push({
+                aliases: [],
+                description: def.description ? `Disable ${def.description}` : undefined,
+                name: `--no-${name}`,
+                takesValue: false,
+                type: 'boolean',
+            });
+        }
+    }
+    return options;
+};
+/**
+ * Extract positional info from positionals schema.
+ *
+ * @function
+ */
+const extractPositionalsInfo = (schema) => schema.map((pos) => ({
+    choices: getChoices(pos),
+    description: pos.description,
+    name: pos.name ?? 'arg',
+    type: pos.type,
+}));
+/**
+ * Get choices from an option or positional definition.
+ *
+ * @function
+ */
+const getChoices = (def) => {
+    if ('choices' in def && Array.isArray(def.choices)) {
+        return def.choices;
+    }
+    return undefined;
+};
+/**
+ * Find a command by name or alias in the metadata.
+ *
+ * @function
+ */
+const findCommand = (metadata, name) => {
+    // Try direct match
+    const direct = metadata.commands.get(name);
+    if (direct) {
+        return direct;
+    }
+    // Try alias match
+    for (const [, cmd] of metadata.commands) {
+        if (cmd.aliases.includes(name)) {
+            return cmd;
+        }
+    }
+    return undefined;
+};
+/**
+ * Analyze command context from args, recursively handling nested commands.
+ *
+ * @function
+ */
+const getCommandContext = (metadata, args, accumulatedOptions = []) => {
+    // Accumulate global options from this level
+    const options = [...accumulatedOptions, ...metadata.globalOptions];
+    if (metadata.commands.size === 0) {
+        return {
+            accumulatedOptions: options,
+            availableCommands: [],
+            needsCommand: false,
+            positionalIndex: 0,
+        };
+    }
+    // Find the first non-option argument (potential command)
+    // Note: The last arg is the current word being completed, so we don't count it
+    // as a completed positional
+    let commandName;
+    let commandArgIndex = -1;
+    // Process all args except the last one (which is being completed)
+    const completedArgs = args.slice(0, -1);
+    for (let i = 0; i < completedArgs.length; i++) {
+        const arg = completedArgs[i];
+        if (!arg.startsWith('-')) {
+            // First non-option is the command at this level
+            commandName = arg;
+            commandArgIndex = i;
+            break;
+        }
+    }
+    // Check if the command name matches a known command or alias
+    if (commandName) {
+        const cmd = findCommand(metadata, commandName);
+        if (cmd) {
+            // Check if this is a nested command - if so, recurse
+            if (cmd.nestedBuilder) {
+                const nestedMetadata = extractNestedMetadata(cmd.nestedBuilder);
+                if (nestedMetadata) {
+                    // Get remaining args after this command
+                    const remainingArgs = completedArgs.slice(commandArgIndex + 1);
+                    // Add the current word being completed
+                    if (args.length > 0) {
+                        remainingArgs.push(args[args.length - 1]);
+                    }
+                    return getCommandContext(nestedMetadata, remainingArgs, options);
+                }
+            }
+            // It's a leaf command - calculate positional index
+            let positionalIndex = 0;
+            for (let i = commandArgIndex + 1; i < completedArgs.length; i++) {
+                const arg = completedArgs[i];
+                if (!arg.startsWith('-')) {
+                    positionalIndex++;
+                }
+            }
+            return {
+                accumulatedOptions: options,
+                availableCommands: [],
+                currentCommand: cmd,
+                needsCommand: false,
+                positionalIndex,
+            };
+        }
+    }
+    // No valid command yet at this level - need to show available commands
+    return {
+        accumulatedOptions: options,
+        availableCommands: Array.from(metadata.commands.values()),
+        needsCommand: true,
+        positionalIndex: 0,
+    };
+};
+/**
+ * Get all options available in the current context.
+ *
+ * @function
+ */
+const getAllOptionsForContext = (metadata, args) => {
+    // getCommandContext now accumulates global options from all parent levels
+    const commandContext = getCommandContext(metadata, args);
+    // Start with accumulated options (includes all global options from parent levels)
+    const options = [...commandContext.accumulatedOptions];
+    // Add command-specific options if we're in a leaf command
+    if (commandContext.currentCommand) {
+        options.push(...commandContext.currentCommand.options);
+    }
+    return options;
+};
+/**
+ * Format candidates for shell output.
+ *
+ * @function
+ */
+const formatCandidates = (candidates, shell) => {
+    switch (shell) {
+        case 'fish':
+            // fish supports descriptions with tab separator
+            return candidates.map((c) => c.description ? `${c.value}\t${c.description}` : c.value);
+        case 'zsh':
+            // zsh supports descriptions in format "value:description"
+            return candidates.map((c) => c.description ? `${c.value}:${c.description}` : c.value);
+        case 'bash':
+        default:
+            // bash doesn't support descriptions in basic completion
+            return candidates.map((c) => c.value);
+    }
+};
+/**
+ * Get command candidates.
+ *
+ * @function
+ */
+const getCommandCandidates = (commands, _currentWord, shell) => {
+    const candidates = [];
+    for (const cmd of commands) {
+        candidates.push({ description: cmd.description, value: cmd.name });
+        for (const alias of cmd.aliases) {
+            candidates.push({
+                description: cmd.description ? `(alias) ${cmd.description}` : '(alias)',
+                value: alias,
+            });
+        }
+    }
+    return formatCandidates(candidates, shell);
+};
+/**
+ * Get option candidates.
+ *
+ * @function
+ */
+const getOptionCandidates = (metadata, args, shell) => {
+    const allOptions = getAllOptionsForContext(metadata, args);
+    const candidates = [];
+    for (const opt of allOptions) {
+        candidates.push({ description: opt.description, value: opt.name });
+        for (const alias of opt.aliases) {
+            candidates.push({ description: opt.description, value: alias });
+        }
+    }
+    return formatCandidates(candidates, shell);
+};
+/**
+ * Get candidates for option values (enum choices).
+ *
+ * @function
+ */
+const getOptionValueCandidates = (metadata, prevWord, args, shell) => {
+    // Find the option definition
+    const allOptions = getAllOptionsForContext(metadata, args);
+    for (const opt of allOptions) {
+        if (opt.name === prevWord || opt.aliases.includes(prevWord)) {
+            if (opt.choices && opt.choices.length > 0) {
+                return {
+                    candidates: formatCandidates(opt.choices.map((c) => ({ description: undefined, value: c })), shell),
+                    found: true,
+                };
+            }
+            // Option takes a value but no specific choices - let shell do file completion
+            if (opt.takesValue) {
+                return { candidates: [], found: true };
+            }
+            // Boolean/count option - doesn't take a value, so prev word isn't an option expecting a value
+            return { candidates: [], found: false };
+        }
+    }
+    // Option not found
+    return { candidates: [], found: false };
+};
+/**
+ * Get positional candidates (for enum positionals).
+ *
+ * @function
+ */
+const getPositionalCandidates = (command, positionalIndex, shell) => {
+    if (positionalIndex >= command.positionals.length) {
+        // Check for variadic last positional
+        const lastPos = command.positionals[command.positionals.length - 1];
+        if (lastPos?.type !== 'variadic') {
+            return [];
+        }
+        // Use the variadic positional's choices if any
+        if (lastPos.choices && lastPos.choices.length > 0) {
+            return formatCandidates(lastPos.choices.map((c) => ({ description: undefined, value: c })), shell);
+        }
+        return [];
+    }
+    const pos = command.positionals[positionalIndex];
+    if (!pos || !pos.choices || pos.choices.length === 0) {
+        return [];
+    }
+    return formatCandidates(pos.choices.map((c) => ({ description: undefined, value: c })), shell);
+};
+/**
+ * Get completion candidates for the current command line state.
+ *
+ * Analyzes the provided words to determine context and returns appropriate
+ * completion suggestions.
+ *
+ * @function
+ * @param state - Internal CLI state containing commands and options
+ * @param shell - The shell requesting completions (affects output format)
+ * @param words - The command line words (COMP_WORDS in bash)
+ * @returns Array of completion candidates (one per line when output)
+ * @group Completion
+ */
+const getCompletionCandidates = (state, shell, words) => {
+    const metadata = extractCompletionMetadata(state);
+    // Remove the CLI name from words if present
+    const args = words.length > 1 ? words.slice(1) : [];
+    const currentWord = args.length > 0 ? (args[args.length - 1] ?? '') : '';
+    const prevWord = args.length > 1 ? args[args.length - 2] : undefined;
+    // Check if we're completing an option value
+    if (prevWord?.startsWith('-')) {
+        const result = getOptionValueCandidates(metadata, prevWord, args, shell);
+        // If we found the option and it takes a value, return the result
+        // (which may be empty to allow file completion)
+        if (result.found) {
+            return result.candidates;
+        }
+    }
+    // Check if current word is an option
+    if (currentWord.startsWith('-')) {
+        return getOptionCandidates(metadata, args, shell);
+    }
+    // Check if we need to complete a command
+    const commandContext = getCommandContext(metadata, args);
+    if (commandContext.needsCommand) {
+        return getCommandCandidates(commandContext.availableCommands, currentWord, shell);
+    }
+    // Check if we're in a command and need positional completion
+    if (commandContext.currentCommand) {
+        const positionalCandidates = getPositionalCandidates(commandContext.currentCommand, commandContext.positionalIndex, shell);
+        if (positionalCandidates.length > 0) {
+            return positionalCandidates;
+        }
+    }
+    // Default: offer commands if we have them, or options
+    if (metadata.commands.size > 0) {
+        return getCommandCandidates(Array.from(metadata.commands.values()), currentWord, shell);
+    }
+    return getOptionCandidates(metadata, args, shell);
+};
+exports.getCompletionCandidates = getCompletionCandidates;
+/**
+ * Validate that a shell name is supported.
+ *
+ * @function
+ * @param shell - The shell name to validate
+ * @returns The validated shell type
+ * @throws Error if the shell is not supported
+ * @group Completion
+ */
+const validateShell = (shell) => {
+    if (shell === 'bash' || shell === 'zsh' || shell === 'fish') {
+        return shell;
+    }
+    throw new Error(`Unsupported shell: "${shell}". Supported shells: bash, zsh, fish`);
+};
+exports.validateShell = validateShell;
+//# sourceMappingURL=completion.js.map

package/dist/completion.cjs.map

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

package/dist/completion.d.cts

@@ -0,0 +1,107 @@
+/**
+ * Shell completion script generation for bargs CLIs.
+ *
+ * Provides dynamic shell completion support for bash, zsh, and fish shells. The
+ * generated scripts call back to the CLI to get completion candidates.
+ *
+ * @packageDocumentation
+ */
+import type { OptionsSchema, PositionalsSchema } from "./types.cjs";
+/**
+ * Supported shell types for completion script generation.
+ *
+ * @group Completion
+ */
+export type Shell = 'bash' | 'fish' | 'zsh';
+/**
+ * Command entry in internal state.
+ */
+type CommandEntry = {
+    /** Alternative names for this command */
+    aliases?: string[];
+    /** Command definition with schemas */
+    cmd: {
+        /** Options schema for this command */
+        __optionsSchema: OptionsSchema;
+        /** Positionals schema for this command */
+        __positionalsSchema: PositionalsSchema;
+    };
+    /** Command description for help text */
+    description?: string;
+    /** Discriminator for leaf commands */
+    type: 'command';
+} | {
+    /** Alternative names for this command */
+    aliases?: string[];
+    /** Nested CLI builder for subcommands */
+    builder: unknown;
+    /** Command description for help text */
+    description?: string;
+    /** Discriminator for nested command groups */
+    type: 'nested';
+};
+/**
+ * Internal CLI state structure (matches bargs.ts InternalCliState).
+ */
+interface InternalCliState {
+    /** Map of command aliases to canonical command names */
+    aliasMap: Map<string, string>;
+    /** Map of command names to their entries */
+    commands: Map<string, CommandEntry>;
+    /** Global parser with options and positionals schemas */
+    globalParser?: {
+        /** Global options schema */
+        __optionsSchema: OptionsSchema;
+        /** Global positionals schema */
+        __positionalsSchema: PositionalsSchema;
+    };
+    /** CLI executable name */
+    name: string;
+}
+/**
+ * Generate a shell completion script for the given CLI.
+ *
+ * The generated script calls back to the CLI with `--get-bargs-completions` to
+ * get completion candidates dynamically.
+ *
+ * @example
+ *
+ * ```typescript
+ * // Output script for bash
+ * console.log(generateCompletionScript('mytool', 'bash'));
+ * // Redirect to shell config: mytool --completion-script bash >> ~/.bashrc
+ * ```
+ *
+ * @function
+ * @param cliName - The name of the CLI executable
+ * @param shell - The target shell ('bash', 'zsh', or 'fish')
+ * @returns The completion script as a string
+ * @group Completion
+ */
+export declare const generateCompletionScript: (cliName: string, shell: Shell) => string;
+/**
+ * Get completion candidates for the current command line state.
+ *
+ * Analyzes the provided words to determine context and returns appropriate
+ * completion suggestions.
+ *
+ * @function
+ * @param state - Internal CLI state containing commands and options
+ * @param shell - The shell requesting completions (affects output format)
+ * @param words - The command line words (COMP_WORDS in bash)
+ * @returns Array of completion candidates (one per line when output)
+ * @group Completion
+ */
+export declare const getCompletionCandidates: (state: InternalCliState, shell: Shell, words: string[]) => string[];
+/**
+ * Validate that a shell name is supported.
+ *
+ * @function
+ * @param shell - The shell name to validate
+ * @returns The validated shell type
+ * @throws Error if the shell is not supported
+ * @group Completion
+ */
+export declare const validateShell: (shell: string) => Shell;
+export {};
+//# sourceMappingURL=completion.d.ts.map