import { Ref, ShallowRef } from 'vue';
import { TTSProvider, SpeakOptions, VoiceInfo, SpeechError } from '../providers/types.js';
export interface UseSpeechSynthesisOptions {
    /** Override the injected provider for this composable instance only */
    provider?: TTSProvider;
    /** Initial speech rate (0.1–10, default 1) */
    rate?: number;
    /** Initial pitch (0–2, default 1) */
    pitch?: number;
    /** Initial volume (0–1, default 1) */
    volume?: number;
}
export interface UseSpeechSynthesisReturn {
    /** Whether the provider is available in this environment */
    readonly isSupported: Readonly<ShallowRef<boolean>>;
    /** Whether speech is currently playing */
    readonly isSpeaking: Readonly<ShallowRef<boolean>>;
    /** Whether speech is paused */
    readonly isPaused: Readonly<ShallowRef<boolean>>;
    /** Voices available from the provider (loads async for AI providers) */
    readonly voices: Readonly<Ref<readonly VoiceInfo[]>>;
    /** True while voices are being fetched */
    readonly isLoadingVoices: Readonly<ShallowRef<boolean>>;
    /** Currently selected voice */
    readonly selectedVoice: Ref<VoiceInfo | undefined>;
    /**
     * Speech rate — changes apply to the **next** `speak()` call.
     * (I-4.4: rate/pitch changes do NOT affect the current utterance)
     */
    readonly rate: Ref<number>;
    /** Pitch — changes apply to the **next** `speak()` call (I-4.4) */
    readonly pitch: Ref<number>;
    /** Volume — changes apply to the **next** `speak()` call */
    readonly volume: Ref<number>;
    /** Most recent error, cleared on next `speak()` */
    readonly error: Readonly<ShallowRef<SpeechError | null>>;
    /** Speak text. Uses current `selectedVoice`, `rate`, `pitch`, `volume` */
    speak(text: string, overrides?: Partial<SpeakOptions>): Promise<void>;
    /** Stop the current utterance immediately */
    stop(): void;
    /** Pause (Web Speech only; no-op for AI providers) */
    pause(): void;
    /** Resume (Web Speech only; no-op for AI providers) */
    resume(): void;
    /** Reload the voice list */
    loadVoices(): Promise<void>;
}
export declare function useSpeechSynthesis(options?: UseSpeechSynthesisOptions): UseSpeechSynthesisReturn;