/**
 * CLI output formatter for consistent help displays across Poltergeist tools
 */
export interface CommandInfo {
    name: string;
    aliases?: string[];
    description: string;
    args?: string;
}
export interface CommandGroup {
    title: string;
    commands: CommandInfo[];
}
export interface OptionInfo {
    flags: string;
    description: string;
}
export interface ExampleInfo {
    command: string;
    description?: string;
}
/**
 * Format the main header with ghost emoji and colored title
 */
export declare function header(title: string, tagline: string): string;
/**
 * Format a section title (e.g., USAGE, COMMANDS, OPTIONS)
 */
export declare function sectionTitle(title: string): string;
/**
 * Format the usage section
 */
export declare function usage(programName: string, usageText: string): string;
/**
 * Format a single command with optional aliases
 */
export declare function formatCommand(cmd: CommandInfo, padTo?: number): string;
/**
 * Format grouped commands
 */
export declare function commandGroups(groups: CommandGroup[]): string;
/**
 * Format simple command list (no groups)
 */
export declare function commands(commandList: CommandInfo[]): string;
/**
 * Format options section
 */
export declare function options(optionList: OptionInfo[]): string;
/**
 * Format examples section
 */
export declare function examples(programName: string, exampleList: ExampleInfo[]): string;
/**
 * Format a complete help display
 */
export declare function formatHelp(config: {
    title: string;
    tagline: string;
    programName: string;
    usage: string;
    commands?: CommandInfo[];
    commandGroups?: CommandGroup[];
    options: OptionInfo[];
    examples?: ExampleInfo[];
    additionalSections?: {
        title: string;
        content: string;
    }[];
}): string;
/**
 * Format a target item with status for polter
 */
export declare function formatTarget(name: string, status: 'success' | 'building' | 'failed' | 'not-running' | 'unknown', outputPath?: string): string;
/**
 * Format footer note
 */
export declare function footer(message: string): string;
export declare const CLIFormatter: {
    header: typeof header;
    sectionTitle: typeof sectionTitle;
    usage: typeof usage;
    formatCommand: typeof formatCommand;
    commandGroups: typeof commandGroups;
    commands: typeof commands;
    options: typeof options;
    examples: typeof examples;
    formatHelp: typeof formatHelp;
    formatTarget: typeof formatTarget;
    footer: typeof footer;
};
//# sourceMappingURL=cli-formatter.d.ts.map