@ztimson/utils 0.28.11 → 0.28.13

package/dist/index.cjs

@@ -2326,7 +2326,68 @@ ${opts.message || this.desc}`;
   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);
@@ -2537,6 +2598,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();
@@ -2572,8 +2634,8 @@ ${err.message || err.toString()}`);
       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;
@@ -2582,7 +2644,13 @@ ${err.message || err.toString()}`);
         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();
@@ -2599,11 +2667,6 @@ ${err.message || err.toString()}`);
         }
       });
     }
-    /**
-     * 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) {
@@ -2612,11 +2675,9 @@ ${err.message || err.toString()}`);
       }
       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);
@@ -2627,7 +2688,6 @@ ${err.message || err.toString()}`);
       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;
@@ -2646,24 +2706,11 @@ ${err.message || err.toString()}`);
         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();