/**
 * Structured Logger
 *
 * Leveled, structured logging with child logger support.
 * Output: [ISO timestamp] [LEVEL] [name] message { data }
 */
export declare enum LogLevel {
    DEBUG = 0,
    INFO = 1,
    WARN = 2,
    ERROR = 3
}
export declare class Logger {
    private readonly name;
    /**
     * Mutable level holder shared between a logger and all of its descendants.
     * Because children share the parent's holder, calling `setLevel()` on the
     * root logger (e.g. after config resolution in cli.ts) propagates to every
     * child logger — even ones created at module-import time before the level
     * was configured.
     */
    private readonly levelRef;
    constructor(name: string, level?: LogLevel | {
        value: LogLevel;
    });
    setLevel(level: LogLevel): void;
    get level(): LogLevel;
    static parseLevel(str: string): LogLevel;
    child(childName: string): Logger;
    debug(msg: string, data?: Record<string, unknown>): void;
    info(msg: string, data?: Record<string, unknown>): void;
    warn(msg: string, data?: Record<string, unknown>): void;
    error(msg: string, data?: Record<string, unknown>): void;
    private write;
}
/** Root logger singleton. */
export declare const logger: Logger;
//# sourceMappingURL=logger.d.ts.map