@ztimson/utils 0.28.9 → 0.28.10

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;
+  _isStopping = false;
   _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,8 +2624,9 @@ 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 = () => {
@@ -2614,15 +2635,20 @@ class TTS {
       };
       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.
@@ -2638,21 +2664,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;
       }
     };
   }