@ztimson/utils 0.28.8 → 0.28.10

package/dist/index.d.ts

@@ -21,5 +21,6 @@ export * from './search';
 export * from './string';
 export * from './template';
 export * from './time';
+export * from './tts';
 export * from './types';
 export * from 'var-persist';

package/dist/index.mjs

@@ -719,6 +719,10 @@ function pascalCase(str) {
   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("");
 }
@@ -2527,6 +2531,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;
@@ -2750,6 +2908,7 @@ export {
   PromiseProgress,
   SYMBOL_LIST,
   ServiceUnavailableError,
+  TTS,
   Table,
   TemplateError,
   TooManyRequestsError,
@@ -2816,6 +2975,7 @@ export {
   randomHex,
   randomString,
   randomStringBuilder,
+  removeEmojis,
   renderTemplate,
   reservedIp,
   search,