import type { NormalizedLoggerConfig } from './model';
import type { LoggerConfig } from '../types';
/** 测试或嵌入式应用可注入环境变量与工作目录，以复用生产配置解析流程而不修改进程全局状态。 */
export interface ConfigLoaderOptions {
    /** 环境变量映射中 K 为变量名，V 为变量值；undefined 表示该变量未配置。 */
    readonly env?: Readonly<Record<string, string | undefined>>;
    readonly cwd?: string;
}
/** 将用户配置校验并归一化为只读快照，避免无效配置进入日志写入和传输阶段。 */
export declare class ConfigLoader {
    /** 环境变量映射中 K 为变量名，V 为变量值；undefined 表示该变量未配置。 */
    private readonly env;
    private readonly cwd;
    /**
     * 创建配置加载器，并允许测试隔离环境变量与当前目录。
     *
     * @param options 可选的环境变量和工作目录来源。
     * @returns 新的配置加载器实例。
     * @throws 不主动抛出异常。
     */
    constructor(options?: ConfigLoaderOptions);
    /**
     * 按“显式对象或路径、环境变量、默认配置”的优先级加载配置，避免部署配置被静默覆盖。
     *
     * @param source 显式配置对象或配置文件路径。
     * @returns 校验、合并并冻结后的日志配置。
     * @throws {LoggerConfigError} 当路径、YAML 内容或配置字段无效时抛出。
     */
    load(source?: string | LoggerConfig): NormalizedLoggerConfig;
    /**
     * 只选择一个配置来源，所有来源随后共用 Profile 校验和合并入口。
     * @param source 显式对象或 YAML 路径。
     * @returns 尚未校验的配置文档。
     * @throws {LoggerConfigError} 当来源无法读取或 YAML 非法时抛出。
     */
    private readSource;
}
//# sourceMappingURL=ConfigLoader.d.ts.map