export interface CliUserErrorInit {
    code: string;
    message: string;
    hint?: string;
    usage?: string;
    examples?: string[];
    command?: string;
    details?: Record<string, unknown>;
    exitCode?: number;
}
export interface CliErrorEnvelope {
    ok: false;
    error: {
        code: string;
        message: string;
        hint?: string;
        usage?: string;
        examples?: string[];
        command?: string;
        details?: Record<string, unknown>;
    };
}
export declare class CliUserError extends Error {
    readonly _tag: "CliUserError";
    readonly code: string;
    readonly hint?: string;
    readonly usage?: string;
    readonly examples?: string[];
    readonly command?: string;
    readonly details?: Record<string, unknown>;
    readonly exitCode: number;
    constructor(init: CliUserErrorInit);
}
export declare function usageError(init: Omit<CliUserErrorInit, "code"> & {
    code?: string;
}): CliUserError;
export declare function validationError(init: Omit<CliUserErrorInit, "code"> & {
    code?: string;
}): CliUserError;
export declare function unknownSubcommandError(params: {
    command: string;
    subcommand: string;
    usage: string;
    examples?: string[];
}): CliUserError;
export declare function unknownCommandError(params: {
    command: string;
    suggestions?: string[];
}): CliUserError;
export declare function movedCommandError(params: {
    command: string;
    message: string;
    hint: string;
}): CliUserError;
export declare function renderCliError(error: CliUserError, jsonMode: boolean): string;
export declare function emitCliError(error: CliUserError, jsonMode: boolean): void;
//# sourceMappingURL=cli-errors.d.ts.map