/**
 * 从 MP4 文件解析视频元数据（宽高、时长、编码）
 *
 * 算法来源：scripts/api-explorer/shipinhao-video-upload/mp4-parse-poc.mjs
 * 已通过合成样本 8/8 + 真实 Chrome 编码视频交叉验证（见该 PoC）。
 *
 * 只读 ISO BMFF 的 box 头做定位，元数据 box（moov / moof）才单独读进内存，
 * 媒体数据（mdat）直接跳过 —— 实测 78MB 视频只读 14.64KB（占全文 0.018%）。
 * 因此内存占用与文件大小无关，也不受 fs.readFileSync 的 2GiB 上限约束
 * （早先的实现整文件载入，2GB 以上必然抛 RangeError 并被误报成「格式不支持」）。
 * 支持 MP4（ISO base media file format），不支持 AVI/MKV/FLV。
 *
 * 时长按四级回退取值：mvhd → 视频轨 mdhd → stts 累加 → moof/trun 累加。
 * 分片 MP4（fMP4，moov 里带 mvex/trex）的 mvhd/mdhd/stts 全为 0，
 * 真实时长只存在于各 moof 分片中，必须走最后一级才能拿到。
 */
export interface VideoMeta {
    width: number;
    height: number;
    /** 时长（秒，浮点数） */
    duration: number;
    /**
     * 旋转角度（0/90/180/270），手机竖屏视频常为 90
     *
     * 仅用于把 tkhd 里的横屏尺寸换算成显示尺寸，不写进发布体。
     * 由 buildVideoMetaFromParams 组装时恒为 0：浏览器给出的 videoWidth/videoHeight
     * 已经是应用过旋转的显示尺寸，再换算一次会把宽高交换错。
     */
    rotation: number;
    fileSize: number;
    /**
     * 视频轨编码格式（stsd 里的 sample entry fourcc，小写）
     * H.264 为 avc1/avc3，H.265 为 hvc1/hev1，解析不到时为 null
     */
    codec: string | null;
}
export declare function parseVideoMeta(filePath: string): VideoMeta | null;
/** 调用方传入的视频元数据（浏览器 <video> + File 侧采集） */
export interface VideoMetadataInput {
    duration: number;
    width: number;
    height: number;
    fileSize: number;
}
/**
 * 只读视频轨编码格式，不解析其余字段
 *
 * 供「宽高时长由调用方给出，仅编码需要本地确认」的场景使用。
 * 浏览器没有暴露编码格式的 API（canPlayType/MediaCapabilities 只能回答
 * 「给定 MIME 能否播放」，无法反查文件实际编码），所以这一项只能读文件。
 * 走的是同一套分段读，成本是几 KB。
 *
 * @returns fourcc（小写，如 avc1/hvc1），读不到时 null
 */
export declare function parseVideoCodec(filePath: string): string | null;
/**
 * 用调用方传入的元数据组装 VideoMeta，编码格式仍从文件读取
 *
 * 宽高时长直接采用传入值：浏览器的 videoWidth/videoHeight 是**已应用旋转**的显示尺寸，
 * 正是发布体需要的值，所以 rotation 固定为 0，不再做二次换算（换算会把竖屏宽高交换错）。
 *
 * codec 读取失败不影响发布 —— validateShipinhaoVideo 对 codec=null 会跳过编码校验，
 * 退化为由服务端判断，与文件解析不出编码时的既有行为一致。
 */
export declare function buildVideoMetaFromParams(filePath: string, metadata: VideoMetadataInput): VideoMeta;