/**
 * 文件事务原语 — 为本地多进程提供互斥锁与原子 JSON 写入。
 *
 * 职责边界：
 * - 负责：同一锁路径的进程内串行、跨进程排他锁、崩溃残留锁回收、唯一临时文件原子替换
 * - 不负责：业务事务拆分、状态迁移合法性、分布式文件系统一致性
 *
 * 数据流：lock path + callback → 排他执行；file path + data → unique tmp → rename
 * 持久化：调用方指定的锁文件与目标 JSON 文件
 */
/** 同一路径先在进程内排队，再通过文件锁跨进程排他执行。 */
export declare function withFileTransaction<T>(lockPath: string, operation: () => Promise<T>, timeoutMs?: number): Promise<T>;
/** 使用 pid + UUID 唯一临时文件写入，再原子替换目标文件。 */
export declare function atomicWriteJson(filePath: string, data: unknown): Promise<void>;