@ztimson/utils 0.28.11 → 0.28.12

package/dist/index.cjs

@@ -2537,6 +2537,7 @@ ${err.message || err.toString()}`);
   }
   class TTS {
     static QUALITY_PATTERNS = ["Google", "Microsoft", "Samantha", "Premium", "Natural", "Neural"];
+    static _errorHandlerInstalled = false;
     _currentUtterance = null;
     _voicesLoaded;
     _stoppedUtterances = /* @__PURE__ */ new WeakSet();
@@ -2572,8 +2573,8 @@ ${err.message || err.toString()}`);
       this._voice = value;
       if (this._currentUtterance && value) this._currentUtterance.voice = value;
     }
-    /** Create a TTS instance with optional configuration */
     constructor(config) {
+      TTS.installErrorHandler();
       this._voicesLoaded = this.initializeVoices();
       if (config) {
         if (config.rate !== void 0) this._rate = config.rate;
@@ -2582,7 +2583,13 @@ ${err.message || err.toString()}`);
         this._voice = config.voice === null ? void 0 : config.voice || void 0;
       }
     }
-    /** Initializes voice loading and sets default voice if needed */
+    static installErrorHandler() {
+      if (this._errorHandlerInstalled) return;
+      window.addEventListener("unhandledrejection", (event) => {
+        if (event.reason?.error === "interrupted" && event.reason instanceof SpeechSynthesisErrorEvent) event.preventDefault();
+      });
+      this._errorHandlerInstalled = true;
+    }
     initializeVoices() {
       return new Promise((resolve) => {
         const voices = window.speechSynthesis.getVoices();
@@ -2599,11 +2606,6 @@ ${err.message || err.toString()}`);
         }
       });
     }
-    /**
-     * Selects the best available TTS voice, prioritizing high-quality options
-     * @param lang Speaking language
-     * @returns Highest quality voice
-     */
     static bestVoice(lang = "en") {
       const voices = window.speechSynthesis.getVoices();
       for (const pattern of this.QUALITY_PATTERNS) {
@@ -2612,11 +2614,9 @@ ${err.message || err.toString()}`);
       }
       return voices.find((v) => v.lang.startsWith(lang));
     }
-    /** Cleans text for TTS by removing emojis, markdown and code block */
     static cleanText(text) {
       return removeEmojis(text).replace(/```[\s\S]*?```/g, " code block ").replace(/[#*_~`]/g, "");
     }
-    /** Creates a speech utterance with current options */
     createUtterance(text) {
       const cleanedText = TTS.cleanText(text);
       const utterance = new SpeechSynthesisUtterance(cleanedText);
@@ -2627,7 +2627,6 @@ ${err.message || err.toString()}`);
       utterance.volume = this._volume;
       return utterance;
     }
-    /** Speaks text and returns a Promise which resolves once complete */
     async speak(text) {
       if (!text.trim()) return Promise.resolve();
       await this._voicesLoaded;
@@ -2646,24 +2645,11 @@ ${err.message || err.toString()}`);
         window.speechSynthesis.speak(utterance);
       });
     }
-    /** Stops all TTS */
     stop() {
       if (this._currentUtterance) this._stoppedUtterances.add(this._currentUtterance);
       window.speechSynthesis.cancel();
       this._currentUtterance = null;
     }
-    /**
-     * Initialize a stream that chunks text into sentences and speak them.
-     *
-     * @example
-     * const stream = tts.speakStream();
-     * stream.next("Hello ");
-     * stream.next("World. How");
-     * stream.next(" are you?");
-     * await stream.done();
-     *
-     * @returns Object with next function for passing chunk of streamed text and done for completing the stream
-     */
     speakStream() {
       let buffer = "";
       let streamPromise = Promise.resolve();