@ztimson/utils 0.28.11 → 0.28.12

package/dist/index.mjs

@@ -2533,6 +2533,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();
@@ -2568,8 +2569,8 @@ class TTS {
     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;
@@ -2578,7 +2579,13 @@ class TTS {
       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();
@@ -2595,11 +2602,6 @@ class TTS {
       }
     });
   }
-  /**
-   * 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) {
@@ -2608,11 +2610,9 @@ class TTS {
     }
     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);
@@ -2623,7 +2623,6 @@ class TTS {
     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;
@@ -2642,24 +2641,11 @@ class TTS {
       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();