@ztimson/utils 0.28.8 → 0.28.10

package/dist/index.cjs

@@ -723,6 +723,10 @@ ${opts.message || this.desc}`;
     if (!str) return "";
     return wordSegments(str).map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join("");
   }
+  function removeEmojis(str) {
+    const emojiRegex = /(?:[\u2700-\u27bf]|(?:\ud83c[\udde6-\uddff]){2}|[\ud83c[\udde6-\uddff]|[\ud83d[\ude00-\ude4f]|[\ud83d[\ude80-\udeff]|[\ud83c[\udd00-\uddff]|[\ud83d[\ude50-\ude7f]|[\u2600-\u26ff]|[\u2700-\u27bf]|[\ud83e[\udd00-\uddff]|[\ud83c[\udf00-\uffff]|[\ud83d[\ude00-\udeff]|[\ud83c[\udde6-\uddff])/g;
+    return str.replace(emojiRegex, "");
+  }
   function randomHex(length) {
     return Array(length).fill(null).map(() => Math.round(Math.random() * 15).toString(16)).join("");
   }
@@ -2531,6 +2535,160 @@ ${err.message || err.toString()}`);
     }
     return process(template);
   }
+  class TTS {
+    static QUALITY_PATTERNS = ["Google", "Microsoft", "Samantha", "Premium", "Natural", "Neural"];
+    _currentUtterance = null;
+    _voicesLoaded;
+    _isStopping = false;
+    _rate = 1;
+    get rate() {
+      return this._rate;
+    }
+    set rate(value) {
+      this._rate = value;
+      if (this._currentUtterance) this._currentUtterance.rate = value;
+    }
+    _pitch = 1;
+    get pitch() {
+      return this._pitch;
+    }
+    set pitch(value) {
+      this._pitch = value;
+      if (this._currentUtterance) this._currentUtterance.pitch = value;
+    }
+    _volume = 1;
+    get volume() {
+      return this._volume;
+    }
+    set volume(value) {
+      this._volume = value;
+      if (this._currentUtterance) this._currentUtterance.volume = value;
+    }
+    _voice;
+    get voice() {
+      return this._voice;
+    }
+    set voice(value) {
+      this._voice = value;
+      if (this._currentUtterance && value) this._currentUtterance.voice = value;
+    }
+    /** 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;
+        if (config.volume !== void 0) this._volume = config.volume;
+        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
+     * @returns Highest quality voice
+     */
+    static bestVoice(lang = "en") {
+      const voices = window.speechSynthesis.getVoices();
+      for (const pattern of this.QUALITY_PATTERNS) {
+        const voice = voices.find((v) => v.name.includes(pattern) && v.lang.startsWith(lang));
+        if (voice) return voice;
+      }
+      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);
+      const voice = this._voice || TTS.bestVoice();
+      if (voice) utterance.voice = voice;
+      utterance.rate = this._rate;
+      utterance.pitch = this._pitch;
+      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;
+      return new Promise((resolve, reject) => {
+        this._currentUtterance = this.createUtterance(text);
+        this._currentUtterance.onend = () => {
+          this._currentUtterance = null;
+          resolve();
+        };
+        this._currentUtterance.onerror = (error) => {
+          this._currentUtterance = null;
+          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.
+     *
+     * @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();
+      const sentenceRegex = /[^.!?\n]+[.!?\n]+/g;
+      return {
+        next: (text) => {
+          buffer += text;
+          const sentences = buffer.match(sentenceRegex);
+          if (sentences) {
+            sentences.forEach((sentence) => streamPromise = this.speak(sentence.trim()));
+            buffer = buffer.replace(sentenceRegex, "");
+          }
+        },
+        done: async () => {
+          if (buffer.trim()) {
+            streamPromise = this.speak(buffer.trim());
+            buffer = "";
+          }
+          await streamPromise;
+        }
+      };
+    }
+  }
   var dist = {};
   var persist = {};
   var hasRequiredPersist;
@@ -2753,6 +2911,7 @@ ${err.message || err.toString()}`);
   exports2.PromiseProgress = PromiseProgress;
   exports2.SYMBOL_LIST = SYMBOL_LIST;
   exports2.ServiceUnavailableError = ServiceUnavailableError;
+  exports2.TTS = TTS;
   exports2.Table = Table;
   exports2.TemplateError = TemplateError;
   exports2.TooManyRequestsError = TooManyRequestsError;
@@ -2819,6 +2978,7 @@ ${err.message || err.toString()}`);
   exports2.randomHex = randomHex;
   exports2.randomString = randomString;
   exports2.randomStringBuilder = randomStringBuilder;
+  exports2.removeEmojis = removeEmojis;
   exports2.renderTemplate = renderTemplate;
   exports2.reservedIp = reservedIp;
   exports2.search = search;