@ztimson/utils 0.28.9 → 0.28.10

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;
+    _isStopping = false;
     _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,8 +2628,9 @@ ${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 = () => {
@@ -2618,15 +2639,20 @@ ${err.message || err.toString()}`);
         };
         this._currentUtterance.onerror = (error) => {
           this._currentUtterance = null;
-          reject(error);
+          if (this._isStopping && error.error === "interrupted") resolve();
+          else reject(error);
         };
         window.speechSynthesis.speak(this._currentUtterance);
       });
     }
     /** Stops all TTS */
     stop() {
+      this._isStopping = true;
       window.speechSynthesis.cancel();
       this._currentUtterance = null;
+      setTimeout(() => {
+        this._isStopping = false;
+      }, 0);
     }
     /**
      * Initialize a stream that chunks text into sentences and speak them.
@@ -2642,21 +2668,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;
         }
       };
     }