export type DotenvOptions = {
    /** Explicit path to the env file. Takes precedence over `cwd`/`file`. */
    path?: string;
    /** Directory to resolve `file` in. Default: `process.cwd()`. */
    cwd?: string;
    /** File name resolved under `cwd`. Default: `.env`. */
    file?: string;
    /** Base environment the file is merged into. Default: `process.env`. */
    environment?: Record<string, string | undefined>;
    /** When true, file values win over the base environment. Default: false. */
    override?: boolean;
};
/** Parse dotenv-format source text into a plain record (no interpolation). */
export declare const parseDotenv: (source: string) => Record<string, string>;
/**
 * Read an env file and merge it with an environment record. A missing file is
 * not an error — the base environment is returned unchanged, so the same code
 * path works in a container (no file) and in local dev (file present).
 */
export declare const dotenv: (options?: DotenvOptions) => Record<string, string | undefined>;