export declare function pathExists(filePath: string): Promise<boolean>;
export declare function ensureDir(dirPath: string): Promise<void>;
export declare function readJson<T>(filePath: string): Promise<T>;
export declare function writeJsonAtomic(filePath: string, value: unknown): Promise<void>;
/** Atomically write JSON with private target permissions (`0o600`). */
export declare function writePrivateJsonAtomic(filePath: string, value: unknown): Promise<void>;
/** Atomically replace a text file, optionally setting the replacement file mode. */
export declare function writeTextAtomic(filePath: string, content: string, mode?: number): Promise<void>;
/** Atomically write text with private target permissions (`0o600`). */
export declare function writePrivateTextAtomic(filePath: string, content: string): Promise<void>;
export declare function removeIfExists(filePath: string): Promise<void>;
export declare function isDirectory(dirPath: string): Promise<boolean>;
export declare function isSymlink(filePath: string): Promise<boolean>;
export declare function readTextOrEmpty(filePath: string): Promise<string>;
export declare function listDirNames(dirPath: string): Promise<string[]>;
/** Recursively copy a directory, optionally dereferencing symbolic links. */
export declare function copyDir(fromDir: string, toDir: string, options?: {
    dereference?: boolean;
}): Promise<void>;
/** Resolve a directory to its real path, falling back to an absolute path when resolution fails. */
export declare function resolveDirectoryPath(directoryPath: string): Promise<string>;
/** Copy a file, creating the destination directory when it does not exist. */
export declare function copyFile(fromPath: string, toPath: string): Promise<void>;