/**
 * 文件工具原子写入器。
 *
 * 关键点（中文）
 * - 新文件使用 `wx` 保证不会覆盖并发创建的文件。
 * - 覆盖文件时在同目录写临时文件，再通过 rename 原子替换。
 * - 临时文件写入后执行 fsync，并尽力清理失败残留。
 */
/** 将字节内容安全写入目标文件。 */
export declare function write_file_atomically(params: {
    /** 已通过路径策略校验的目标绝对路径。 */
    file_path: string;
    /** 要写入的完整字节内容。 */
    content: Buffer;
    /** 是否允许替换已有文件。 */
    overwrite: boolean;
    /** 覆盖时需要保留的原文件权限位。 */
    mode?: number;
}): Promise<void>;
//# sourceMappingURL=FileAtomicWriter.d.ts.map