export interface ConfigFileWriteOptions {
    /** 在替换目标前，将上一版本原子写入 `<path>.bak`。 */
    backup?: boolean;
    /** 新文件权限；已有文件默认保留原权限。 */
    mode?: number;
}
export interface ConfigFileWriteResult {
    path: string;
    backupPath?: string;
}
/**
 * 在目标目录内写入临时文件后原子替换配置，避免进程退出留下截断文件。
 * 已有目标为符号链接时写入其真实路径，保留部署侧的链接结构。
 */
export declare function writeConfigFileAtomic(filePath: string, content: string, options?: ConfigFileWriteOptions): ConfigFileWriteResult;