interface CommandSpec {
    name: string;
    description: string;
}
interface OptionSpec {
    flag: string;
    description: string;
    default?: string;
}
interface ExampleSpec {
    description: string;
    command: string;
}
interface HelpSpec {
    name: string;
    description: string;
    usage: string;
    commandGroups?: {
        heading: string;
        commands: CommandSpec[];
    }[];
    commands?: CommandSpec[];
    options?: OptionSpec[];
    examples?: ExampleSpec[];
}
declare function formatHelp(spec: HelpSpec): string;
declare function formatError(message: string, opts?: {
    validValues?: string[];
    hint?: string;
}): string;
declare function readStdinSync(): string;
/** Create an Error with a cliMessage property for structured CLI error handling */
declare function cliError(message: string): Error & {
    cliMessage?: string;
};
export { formatHelp, formatError, readStdinSync, cliError, };
export type { HelpSpec, CommandSpec, OptionSpec, ExampleSpec };