/** 提取音频进度信息，用于 onProgress 回调 */
export interface ExtractAudioProgress {
    /** 当前阶段 */
    phase: "preparing" | "encoding" | "done";
    /** 总进度 0–100 */
    percent: number;
    /** 可读描述 */
    message?: string;
    /** 当前已处理时长（秒） */
    currentTime?: number;
    /** 视频总时长（秒） */
    duration?: number;
}
export interface ExtractAudioOptions {
    /** 输出文件名 */
    outputFileName?: string;
    /** 输出格式，默认 mp3 */
    outputFormat?: "mp3" | "m4a" | "wav";
    /** 是否覆盖已存在文件 */
    overwrite?: boolean;
    /** 自定义临时目录 */
    tempDir?: string;
    /** 是否尽量流复制不重编码（仅当格式兼容时有效，如 m4a 保留 aac） */
    copyStream?: boolean;
    /** 进度回调 */
    onProgress?: (progress: ExtractAudioProgress) => void;
}
export interface ExtractAudioResult {
    outputPath: string;
    metadata: {
        duration: number;
        fileSize: number;
        processingTime: number;
    };
}
export declare function extractAudio(videoPath: string, options?: ExtractAudioOptions): Promise<ExtractAudioResult>;