/**
 * Help text generation for CLI applications.
 *
 * Generates formatted, colorized help output for both simple CLIs and
 * command-based CLIs. Supports customizable themes, automatic URL linkification
 * in terminals that support hyperlinks, option grouping, and automatic epilog
 * generation from `package.json` metadata.
 *
 * @packageDocumentation
 */
import type { OptionsSchema, PositionalsSchema } from "./types.cjs";
import { type Theme } from "./theme.cjs";
/**
 * Minimal config shape for help generation.
 *
 * @group Help
 * @knipignore
 */
export interface HelpConfig {
    commands?: Record<string, {
        /** Alternative names for this command */
        aliases?: string[];
        description: string;
        options?: OptionsSchema;
        positionals?: PositionalsSchema;
    }>;
    description?: string;
    epilog?: false | string;
    name: string;
    options?: OptionsSchema;
    positionals?: PositionalsSchema;
    version?: string;
}
/**
 * Generate help text for a bargs config.
 *
 * @function
 * @group Help
 */
export declare const generateHelp: (config: HelpConfig, theme?: Theme) => string;
/**
 * Generate help text for a specific command.
 *
 * @function
 * @group Help
 */
export declare const generateCommandHelp: (config: HelpConfig, commandName: string, theme?: Theme) => string;
//# sourceMappingURL=help.d.ts.map