@ztimson/utils 0.28.9 → 0.28.11

package/dist/index.mjs

@@ -2534,6 +2534,8 @@ ${err.message || err.toString()}`);
 class TTS {
   static QUALITY_PATTERNS = ["Google", "Microsoft", "Samantha", "Premium", "Natural", "Neural"];
   _currentUtterance = null;
+  _voicesLoaded;
+  _stoppedUtterances = /* @__PURE__ */ new WeakSet();
   _rate = 1;
   get rate() {
     return this._rate;
@@ -2568,6 +2570,7 @@ class TTS {
   }
   /** Create a TTS instance with optional configuration */
   constructor(config) {
+    this._voicesLoaded = this.initializeVoices();
     if (config) {
       if (config.rate !== void 0) this._rate = config.rate;
       if (config.pitch !== void 0) this._pitch = config.pitch;
@@ -2575,6 +2578,23 @@ class TTS {
       this._voice = config.voice === null ? void 0 : config.voice || void 0;
     }
   }
+  /** Initializes voice loading and sets default voice if needed */
+  initializeVoices() {
+    return new Promise((resolve) => {
+      const voices = window.speechSynthesis.getVoices();
+      if (voices.length > 0) {
+        if (!this._voice) this._voice = TTS.bestVoice();
+        resolve();
+      } else {
+        const handler = () => {
+          window.speechSynthesis.removeEventListener("voiceschanged", handler);
+          if (!this._voice) this._voice = TTS.bestVoice();
+          resolve();
+        };
+        window.speechSynthesis.addEventListener("voiceschanged", handler);
+      }
+    });
+  }
   /**
    * Selects the best available TTS voice, prioritizing high-quality options
    * @param lang Speaking language
@@ -2604,23 +2624,27 @@ class TTS {
     return utterance;
   }
   /** Speaks text and returns a Promise which resolves once complete */
-  speak(text) {
+  async speak(text) {
     if (!text.trim()) return Promise.resolve();
+    await this._voicesLoaded;
     return new Promise((resolve, reject) => {
       this._currentUtterance = this.createUtterance(text);
-      this._currentUtterance.onend = () => {
+      const utterance = this._currentUtterance;
+      utterance.onend = () => {
         this._currentUtterance = null;
         resolve();
       };
-      this._currentUtterance.onerror = (error) => {
+      utterance.onerror = (error) => {
         this._currentUtterance = null;
-        reject(error);
+        if (this._stoppedUtterances.has(utterance) && error.error === "interrupted") resolve();
+        else reject(error);
       };
-      window.speechSynthesis.speak(this._currentUtterance);
+      window.speechSynthesis.speak(utterance);
     });
   }
   /** Stops all TTS */
   stop() {
+    if (this._currentUtterance) this._stoppedUtterances.add(this._currentUtterance);
     window.speechSynthesis.cancel();
     this._currentUtterance = null;
   }
@@ -2638,21 +2662,23 @@ class TTS {
    */
   speakStream() {
     let buffer = "";
+    let streamPromise = Promise.resolve();
     const sentenceRegex = /[^.!?\n]+[.!?\n]+/g;
     return {
       next: (text) => {
         buffer += text;
         const sentences = buffer.match(sentenceRegex);
         if (sentences) {
-          sentences.forEach((sentence) => this.speak(sentence.trim()));
+          sentences.forEach((sentence) => streamPromise = this.speak(sentence.trim()));
           buffer = buffer.replace(sentenceRegex, "");
         }
       },
       done: async () => {
         if (buffer.trim()) {
-          await this.speak(buffer.trim());
+          streamPromise = this.speak(buffer.trim());
           buffer = "";
         }
+        await streamPromise;
       }
     };
   }