export declare const PIX_LOG_MAX_LINES = 1000;
export type PixLogLevel = "debug" | "info" | "warn" | "error";
export type PixLogDetails = Record<string, unknown>;
export type PixFileLoggerOptions = {
    logPath?: string;
    maxLines?: number;
};
export declare function getPixLogPath(homeDir?: string): string;
export declare class PixFileLogger {
    readonly logPath: string;
    private readonly maxLines;
    private pending;
    constructor(options?: PixFileLoggerOptions);
    log(level: PixLogLevel, event: string, details?: PixLogDetails): Promise<void>;
    debug(event: string, details?: PixLogDetails): Promise<void>;
    info(event: string, details?: PixLogDetails): Promise<void>;
    warn(event: string, details?: PixLogDetails): Promise<void>;
    error(event: string, details?: PixLogDetails): Promise<void>;
    flush(): Promise<void>;
    private formatLine;
    private writeLine;
}
export declare const pixLogger: PixFileLogger;
export declare function logPixEvent(level: PixLogLevel, event: string, details?: PixLogDetails): void;
export declare function trimLogFile(logPath: string, maxLines?: number): Promise<void>;