/// <reference types="react" />
import { AudioFormat } from '../AudioInput/audioHelper';
/**
 * 录音状态类型
 */
export type RecordingState = 'idle' | 'recording' | 'willCancel' | 'willSpeechToText';
/**
 * useRecording Hook 配置项
 */
export interface UseRecordingOptions {
    /**
     * 音频格式
     */
    audioFormat?: AudioFormat;
    /**
     * 录音数据回调（停止录音时触发）
     */
    onDataAvailable?: (blob: Blob) => void;
    /**
     * 震动回调
     */
    onVibrate?: (type?: 'countdown' | 'timeout' | 'cancel') => void;
    /**
     * 录音状态变化回调
     */
    onRecordingStateChange?: (state: RecordingState) => void;
    /**
     * 是否正在录音变化回调
     */
    onRecordingChange?: (isRecording: boolean) => void;
    /**
     * 音频流变化回调
     */
    onStreamChange?: (stream: MediaStream | null) => void;
}
/**
 * useRecording Hook 返回值
 */
export interface UseRecordingReturn {
    recordingState: RecordingState;
    setRecordingState: React.Dispatch<React.SetStateAction<RecordingState>>;
    remainingTime: number;
    isSpeaking: boolean;
    startRecording: () => Promise<void>;
    stopRecording: () => void;
    stopAndSend: () => void;
    cancelRecording: () => void;
    cleanup: () => void;
    triggerVibrate: (type?: 'countdown' | 'timeout' | 'cancel') => void;
    recordingStateRef: React.MutableRefObject<RecordingState>;
    mediaRecorderRef: React.MutableRefObject<MediaRecorder | null>;
    streamRef: React.MutableRefObject<MediaStream | null>;
    chunksRef: React.MutableRefObject<Blob[]>;
    isCancelledRef: React.MutableRefObject<boolean>;
    hasCountdownVibratedRef: React.MutableRefObject<boolean>;
}
/**
 * 录音核心逻辑 Hook
 * 提供录音的状态管理、开始/停止/取消等操作
 */
export declare function useRecording(options?: UseRecordingOptions): UseRecordingReturn;
export default useRecording;