@readium/speech 0.3.0 → 0.4.0

package/build/WebSpeech/TmpNavigator.d.ts

@@ -14,6 +14,8 @@ export declare class WebSpeechReadAloudNavigator implements ReadiumSpeechNavigat
     getVoices(): Promise<ReadiumSpeechVoice[]>;
     setVoice(voice: ReadiumSpeechVoice | string): void;
     getCurrentVoice(): ReadiumSpeechVoice | null;
+    setSpeakInContentLanguage(enabled: boolean): void;
+    getSpeakInContentLanguage(): boolean;
     loadContent(content: ReadiumSpeechUtterance | ReadiumSpeechUtterance[]): void;
     getCurrentContent(): ReadiumSpeechUtterance | null;
     getContentQueue(): ReadiumSpeechUtterance[];

package/build/WebSpeech/WebSpeechVoiceManager.d.ts

@@ -41,13 +41,19 @@ export declare class WebSpeechVoiceManager {
     private voices;
     private browserVoices;
     private isInitialized;
+    private scopedLanguages;
+    private broadenPromises;
     private constructor();
     /**
-     * Initialize voice manager
+     * Initialize voice manager, or broaden an already-initialized singleton to
+     * also cover new languages. `languages` scope voice parsing to reduce
+     * per-language JSON loading; omitting it on the first call loads everything,
+     * but omitting it on a later call to an already-scoped instance is a no-op,
+     * not a retroactive broaden-to-everything.
      * @param options Configuration options for voice loading
-     * @param options.languages Optional array of preferred language codes to filter voices during initialization
-     * @param options.maxTimeout Maximum time in milliseconds to wait for voices to load (passed to getBrowserVoices)
-     * @param options.interval Interval in milliseconds between voice loading checks (passed to getBrowserVoices)
+     * @param options.languages Optional array of preferred language codes to filter (or broaden to) voices
+     * @param options.maxTimeout Maximum time in milliseconds to wait for voices to load (passed to getBrowserVoices, first call only)
+     * @param options.interval Interval in milliseconds between voice loading checks (passed to getBrowserVoices, first call only)
      * @returns Promise that resolves with the WebSpeechVoiceManager instance
      */
     static initialize(options?: {
@@ -60,6 +66,18 @@ export declare class WebSpeechVoiceManager {
      * @private
      */
     private filterBrowserVoicesByLanguages;
+    /**
+     * Extract base language codes (e.g. "en", "fr") from a list of BCP47 tags
+     * @private
+     */
+    private static toBaseLangSet;
+    /**
+     * Broaden an already-initialized instance to also cover the given languages,
+     * reusing the already-fetched `browserVoices` (no new speechSynthesis fetch).
+     * No-op if the instance is already unscoped or already covers these languages.
+     * @private
+     */
+    private broadenLanguages;
     /**
      * Extract language and region from BCP47 language tag
      * @param lang - The BCP47 language tag (e.g., "en-US", "zh-CN")

package/build/WebSpeech/webSpeechEngine.d.ts

@@ -13,6 +13,10 @@ export declare class WebSpeechEngine implements ReadiumSpeechPlaybackEngine {
     private voiceManager;
     private voices;
     private defaultVoice;
+    private speakInContentLanguage;
+    private languageVoiceCache;
+    private warmingLanguages;
+    private speakGeneration;
     private resumeInfinityTimer?;
     private isSpeakingInternal;
     private isPausedInternal;
@@ -37,7 +41,13 @@ export declare class WebSpeechEngine implements ReadiumSpeechPlaybackEngine {
     }): Promise<boolean>;
     private validateText;
     private getCurrentVoiceForUtterance;
+    private voiceMatchesLanguage;
+    private voiceForUtteranceSync;
+    private voiceForUtterance;
+    private warmLanguageVoiceCache;
     getCurrentVoice(): ReadiumSpeechVoice | null;
+    setSpeakInContentLanguage(enabled: boolean): void;
+    getSpeakInContentLanguage(): boolean;
     private toPlainText;
     loadUtterances(contents: ReadiumSpeechUtterance[]): void;
     setVoice(voice: ReadiumSpeechVoice | string): Promise<void>;

package/build/engine.d.ts

@@ -6,6 +6,8 @@ export interface ReadiumSpeechPlaybackEngine {
     setVoice(voice: ReadiumSpeechVoice | string): void;
     getCurrentVoice(): ReadiumSpeechVoice | null;
     getAvailableVoices(): Promise<ReadiumSpeechVoice[]>;
+    setSpeakInContentLanguage(enabled: boolean): void;
+    getSpeakInContentLanguage(): boolean;
     speak(utteranceIndex?: number): void;
     pause(): void;
     resume(): void;