import { type JsonConfigTier } from './json-tier-paths.js';
import { type ProvenanceCache } from './provenance-cache.js';
export declare const CONFIG_ENV_SHADOWS: Readonly<Record<string, readonly string[]>>;
export type ConfigSource = {
    readonly kind: 'env';
    readonly via: string;
} | {
    readonly kind: JsonConfigTier;
    readonly path: string;
} | {
    readonly kind: 'default';
};
export interface ConfigProvenance {
    readonly path: string;
    readonly effective: unknown;
    readonly source: ConfigSource;
    readonly shadowedBy?: ConfigSource;
    readonly userValue: unknown;
}
export declare function describeSource(src: ConfigSource): string;
export declare function sourceSuffix(prov: ConfigProvenance): string | undefined;
export declare function shadowNote(prov: ConfigProvenance): string | undefined;
export declare function activeEnvShadow(path: string): string | undefined;
export declare function resolveConfigProvenance(path: string, cache?: ProvenanceCache): ConfigProvenance;