@ztimson/utils 0.28.11 → 0.28.13

package/dist/index.mjs

@@ -2322,7 +2322,68 @@ class TemplateError extends BadRequestError {
 function findTemplateVars(html) {
   const variables = /* @__PURE__ */ new Set();
   const arrays = /* @__PURE__ */ new Set();
-  const excluded = /* @__PURE__ */ new Set(["true", "false", "null", "undefined"]);
+  const excluded = /* @__PURE__ */ new Set([
+    "let",
+    "const",
+    "var",
+    "function",
+    "if",
+    "while",
+    "do",
+    "this",
+    "typeof",
+    "new",
+    "instanceof",
+    "in",
+    "for",
+    "else",
+    "case",
+    "break",
+    "continue",
+    "switch",
+    "default",
+    "with",
+    "eval",
+    "arguments",
+    "void",
+    "delete",
+    "null",
+    "undefined",
+    "true",
+    "false",
+    "async",
+    "await",
+    "try",
+    "catch",
+    "finally",
+    "throw",
+    "return",
+    "yield",
+    "debugger",
+    "extends",
+    "import",
+    "export",
+    "class",
+    "super",
+    "static",
+    "get",
+    "set",
+    "constructor",
+    "enum",
+    "implements",
+    "interface",
+    "package",
+    "private",
+    "protected",
+    "public",
+    "abstract",
+    "final",
+    "native",
+    "synchronized",
+    "throws",
+    "transient",
+    "volatile"
+  ]);
   for (const loop of matchAll(html, /\{\{\s*?\*\s*?(.+?)\s+in\s+(.+?)\s*?}}/g)) {
     const [element, index = "index"] = loop[1].replaceAll(/[()\s]/g, "").split(",");
     excluded.add(element);
@@ -2533,6 +2594,7 @@ ${err.message || err.toString()}`);
 }
 class TTS {
   static QUALITY_PATTERNS = ["Google", "Microsoft", "Samantha", "Premium", "Natural", "Neural"];
+  static _errorHandlerInstalled = false;
   _currentUtterance = null;
   _voicesLoaded;
   _stoppedUtterances = /* @__PURE__ */ new WeakSet();
@@ -2568,8 +2630,8 @@ class TTS {
     this._voice = value;
     if (this._currentUtterance && value) this._currentUtterance.voice = value;
   }
-  /** Create a TTS instance with optional configuration */
   constructor(config) {
+    TTS.installErrorHandler();
     this._voicesLoaded = this.initializeVoices();
     if (config) {
       if (config.rate !== void 0) this._rate = config.rate;
@@ -2578,7 +2640,13 @@ class TTS {
       this._voice = config.voice === null ? void 0 : config.voice || void 0;
     }
   }
-  /** Initializes voice loading and sets default voice if needed */
+  static installErrorHandler() {
+    if (this._errorHandlerInstalled) return;
+    window.addEventListener("unhandledrejection", (event) => {
+      if (event.reason?.error === "interrupted" && event.reason instanceof SpeechSynthesisErrorEvent) event.preventDefault();
+    });
+    this._errorHandlerInstalled = true;
+  }
   initializeVoices() {
     return new Promise((resolve) => {
       const voices = window.speechSynthesis.getVoices();
@@ -2595,11 +2663,6 @@ class TTS {
       }
     });
   }
-  /**
-   * 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) {
@@ -2608,11 +2671,9 @@ class TTS {
     }
     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);
@@ -2623,7 +2684,6 @@ class TTS {
     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;
@@ -2642,24 +2702,11 @@ class TTS {
       window.speechSynthesis.speak(utterance);
     });
   }
-  /** Stops all TTS */
   stop() {
     if (this._currentUtterance) this._stoppedUtterances.add(this._currentUtterance);
     window.speechSynthesis.cancel();
     this._currentUtterance = null;
   }
-  /**
-   * 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();