/**
 * Describes dot env load result data exchanged by the lifecycle pipeline.
 */
export interface DotEnvLoadResult {
    path: string;
    loaded: boolean;
    appliedKeys: string[];
}
/**
 * Loads a `.env` file from `directory` into the provided environment object.
 * Existing environment variables win over file values so shell/process-manager
 * configuration can override local defaults safely.
 */
export declare function loadDotEnvFile(directory: string, env?: NodeJS.ProcessEnv): Promise<DotEnvLoadResult>;
/**
 * Splits physical file content into dotenv logical lines by tracking quote
 * state, escape characters, and line continuations.
 */
declare function collectDotEnvLogicalLines(content: string): string[];
/**
 * Parses one dotenv logical line, ignoring comments, blanks, malformed keys,
 * and optional `export` prefixes.
 */
declare function parseDotEnvLine(rawLine: string): [string, string] | null;
/**
 * Normalizes a dotenv value by applying quoted-value handling or stripping
 * inline comments from unquoted values.
 */
declare function parseDotEnvValue(rawValue: string): string;
/**
 * Reads a quoted dotenv value and decodes double-quoted escape sequences while
 * preserving single-quoted content literally.
 */
declare function parseQuotedDotEnvValue(rawValue: string, quote: '"' | "'"): string;
/**
 * Converts supported dotenv double-quoted escape characters to their runtime
 * value, leaving unknown escapes visibly escaped.
 */
declare function decodeDoubleQuotedEscape(character: string | undefined): string;
/**
 * Exposes narrow dotenv parsing internals for focused behavioral coverage.
 */
export declare const envFileInternals: {
    collectDotEnvLogicalLines: typeof collectDotEnvLogicalLines;
    parseDotEnvLine: typeof parseDotEnvLine;
    parseDotEnvValue: typeof parseDotEnvValue;
    parseQuotedDotEnvValue: typeof parseQuotedDotEnvValue;
    decodeDoubleQuotedEscape: typeof decodeDoubleQuotedEscape;
};
export {};