/**
 * Enumerates the severity levels supported by the logger.
 */
export declare enum LogLevel {
    DEBUG = 0,
    INFO = 1,
    WARN = 2,
    ERROR = 3
}
/**
 * Lightweight console logger that caches instances per project name and
 * shares global visual configuration.
 */
export declare class Logger {
    readonly project: string | null;
    level: LogLevel;
    private static readonly nullProjectKey;
    private static readonly registry;
    private static readonly emojiConfig;
    private static readonly styleConfig;
    static global: {
        _level: LogLevel;
        level: (level: LogLevel) => void;
    };
    constructor(project: string | null, level?: LogLevel);
    /**
     * Retrieves a logger for the specified project, creating and caching it on first access.
     * @param project Project label used in log headers. `null` represents anonymous output.
     * @param options Optional overrides such as the initial {@link LogLevel}.
     * @returns Cached or newly created {@link Logger} instance for the project.
     */
    static get(project: string | null, options?: {
        level?: LogLevel;
    }): Logger;
    /**
     * Updates the log level of all registered loggers at once.
     * @param level Desired {@link LogLevel} threshold.
     * @returns void
     */
    static setLevel(level: LogLevel): void;
    /**
     * Applies global emoji settings that affect every logger instance.
     * @param dict Emoji dictionary to enable and customize emojis. Pass `false` to disable, `true` to enable with defaults, or pass a partial dictionary to customize.
     * @returns void
     */
    static setEmoji(enabled: boolean): void;
    static setEmoji(dict: Partial<Record<LogLevel, string>>): void;
    /**
     * Applies global CSS styles used by console formatting.
     * @param dict Style dictionary to enable and customize styles. Pass `false` to disable, `true` to enable with defaults, or pass a partial dictionary to customize.
     * @returns void
     */
    static setStyle(enabled: boolean): void;
    static setStyle(dict: Partial<Record<LogLevel, string>>): void;
    /**
     * Updates the threshold for this specific logger instance.
     * @param level Desired {@link LogLevel}.
     * @returns The current {@link Logger} for chaining.
     */
    setLevel(level: LogLevel): this;
    /**
     * Emits a message at DEBUG level.
     * @param args Arbitrary arguments forwarded to `console.debug`.
     * @returns void
     */
    debug(...args: unknown[]): void;
    /**
     * Emits a message at INFO level.
     * @param args Arbitrary arguments forwarded to `console.info`.
     * @returns void
     */
    info(...args: unknown[]): void;
    /**
     * Emits a message at WARN level.
     * @param args Arbitrary arguments forwarded to `console.warn`.
     * @returns void
     */
    warn(...args: unknown[]): void;
    /**
     * Emits a message at ERROR level.
     * @param args Arbitrary arguments forwarded to `console.error`.
     * @returns void
     */
    error(...args: unknown[]): void;
    /**
     * Builds the console arguments array with headers and styling metadata.
     * @param level Log level the message is associated with.
     * @param args Original arguments supplied to the logger API.
     * @returns Array passed directly to the corresponding `console` method.
     */
    private format;
}