/**
 * Plugin logger.
 *
 * A small level-based logger independent of Vite's own logger. Used so the
 * plugin can stay quiet by default but emit DEBUG-level diagnostics for
 * generate-mode skipped sites and cache misses without polluting Vite's
 * normal output.
 */
export type LogLevel = 'silent' | 'warn' | 'info' | 'debug';
export interface Logger {
    warn(message: string): void;
    info(message: string): void;
    debug(message: string): void;
    /**
     * Buffer a generate-mode skip diagnostic for end-of-build summary output.
     * Diagnostics are flushed via `flushGenerateSummary()`.
     */
    bufferGenerateSkip(file: string, line: number, column: number, reason: string): void;
    /**
     * Emit the buffered generate-mode skip summary at INFO level (or higher),
     * matching the format documented in `contracts/generate-mode.md`. Returns
     * the number of skips that were summarized.
     */
    flushGenerateSummary(processed: number, rewritten: number): number;
}
export declare function createLogger(level?: LogLevel): Logger;
//# sourceMappingURL=logger.d.ts.map