import type { Command } from 'commander';
export interface ResolvedConfigValue<T> {
    value: T;
    source: 'cli' | 'env' | 'config' | 'default';
}
export declare class ConfigResolver {
    private command;
    private cliOptions;
    private configFileOptions;
    loadedConfigPath?: string;
    constructor(command: Command, cliOptions: Record<string, unknown>, configPathOverride?: string);
    private loadEnvFiles;
    private loadConfigFile;
    /**
     * Resolves a configuration option following precedence:
     * CLI flag > Env Var > Config File > Default
     */
    resolve<T>(cliKey: string, envKey?: string, parser?: (val: unknown) => T): T | undefined;
    private _parseNumeric;
    /**
     * Helper to resolve a required numeric value
     */
    resolveIntRequired(cliKey: string, envKey?: string, min?: number, max?: number): number;
    /**
     * Helper to resolve an optional numeric value
     */
    resolveInt(cliKey: string, envKey?: string, min?: number, max?: number): number | undefined;
    /**
     * Helper to resolve an optional numeric value (supports floats)
     */
    resolveNumber(cliKey: string, envKey?: string, min?: number, max?: number): number | undefined;
    /**
     * Helper to resolve a boolean value
     */
    resolveBool(cliKey: string, envKey?: string): boolean | undefined;
    /**
     * Helper to resolve a string array (e.g. from comma separated string or actual array)
     */
    resolveStringArray(cliKey: string, envKey?: string): string[] | undefined;
}
//# sourceMappingURL=config-resolver.d.ts.map