/**
 * 文件内容检测与编码辅助。
 *
 * 关键点（中文）
 * - 二进制检测只把 NUL 和低位控制字符视为高风险，避免误判 UTF-8 中文。
 * - 文本解码使用 fatal 模式，禁止静默插入替换字符。
 * - 第一版仅接受 UTF-8 和带 BOM 的 UTF-16 文本。
 */
/** 支持的文本编码。 */
export type SupportedFileEncoding = "utf-8" | "utf-16le" | "utf-16be";
/** 计算文件内容的 SHA-256。 */
export declare function create_file_sha256(content: Uint8Array | string): string;
/** 根据 BOM 判断文本编码。 */
export declare function detect_text_encoding(buffer: Buffer): SupportedFileEncoding;
/** 保守判断一个文件是否为二进制。 */
export declare function is_binary_file(buffer: Buffer): boolean;
/** 根据文件签名识别模型可直接读取的静态图片 MIME。 */
export declare function detect_image_file_mime_type(buffer: Buffer): string | undefined;
/** 严格解码文本文件。 */
export declare function decode_text_file(buffer: Buffer): {
    /** 解码后的文本。 */
    content: string;
    /** 实际采用的文本编码。 */
    encoding: SupportedFileEncoding;
};
/** 按原文本编码重新编码内容，并保留 UTF-16 BOM。 */
export declare function encode_text_file(content: string, encoding: SupportedFileEncoding): Buffer;
/** 把调用方文本统一为 LF 换行。 */
export declare function normalize_text_to_lf(content: string): string;
/** 统计可见文本行数，不把尾随换行后的空位置计为新行。 */
export declare function count_text_lines(content: string): number;
/** 根据扩展名识别常见 MIME 类型。 */
export declare function detect_file_mime_type(file_path: string): string | undefined;
//# sourceMappingURL=FileEncoding.d.ts.map