@ztimson/utils 0.28.9 → 0.28.11

package/dist/index.cjs

@@ -2538,6 +2538,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;
@@ -2572,6 +2574,7 @@ ${err.message || err.toString()}`);
     }
     /** 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;
@@ -2579,6 +2582,23 @@ ${err.message || err.toString()}`);
         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
@@ -2608,23 +2628,27 @@ ${err.message || err.toString()}`);
       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;
     }
@@ -2642,21 +2666,23 @@ ${err.message || err.toString()}`);
      */
     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;
         }
       };
     }