/**
 * 文件操作工具
 * 文件和目录操作相关函数
 */
/**
 * 验证路径安全性，防止路径遍历攻击
 * @param filePath 文件路径
 * @param baseDir 基础目录（可选，用于限制路径范围）
 * @throws {Error} 如果路径不安全
 */
export declare function validatePath(filePath: string, baseDir?: string): void;
/**
 * 创建目录
 * @param dirPath 目录路径
 * @throws {Error} 如果目录创建失败
 */
export declare function createDir(dirPath: string): void;
/**
 * 清空并重新创建目录
 * @param dirPath 目录路径
 * @throws {Error} 如果目录操作失败
 */
export declare function emptyDir(dirPath: string): void;
/**
 * 检查路径是否存在
 * @param filePath 文件路径
 * @returns 路径是否存在
 */
export declare function pathExists(filePath: string): boolean;
/**
 * 复制文件
 * @param src 源文件路径
 * @param dest 目标文件路径
 * @throws {Error} 如果文件复制失败
 */
export declare function copyFile(src: string, dest: string): void;
/**
 * 复制目录
 * @param src 源目录路径
 * @param dest 目标目录路径
 * @throws {Error} 如果目录复制失败
 */
export declare function copyDir(src: string, dest: string): void;
/**
 * 写入文件
 * @param filePath 文件路径
 * @param content 文件内容
 * @throws {Error} 如果文件写入失败
 */
export declare function writeFile(filePath: string, content: string): void;
/**
 * 读取文件
 * @param filePath 文件路径
 * @returns 文件内容
 * @throws {Error} 如果文件不存在或读取失败
 */
export declare function readFile(filePath: string): string;
/**
 * 读取 JSON 文件
 * @param filePath 文件路径
 * @returns 解析后的 JSON 对象
 * @throws {Error} 如果文件不存在、读取失败或 JSON 解析失败
 */
export declare function readJsonFile<T = Record<string, unknown>>(filePath: string): T;
/**
 * 写入 JSON 文件
 * @param filePath 文件路径
 * @param data 数据
 * @throws {Error} 如果文件写入失败
 */
export declare function writeJsonFile(filePath: string, data: unknown): void;
/**
 * 获取目录下所有文件
 * @param dirPath 目录路径
 * @param recursive 是否递归，默认为 true
 * @returns 文件路径数组
 */
export declare function getFiles(dirPath: string, recursive?: boolean): string[];
/**
 * 获取模板目录路径
 * @returns 模板目录的绝对路径
 */
export declare function getTemplatesDir(): string;
/**
 * 获取相对路径
 * @param from 起始路径
 * @param to 目标路径
 * @returns 相对路径字符串
 */
export declare function getRelativePath(from: string, to: string): string;