@sv443-network/userutils 8.4.0 → 9.0.0

package/dist/index.global.js

@@ -7,8 +7,8 @@
 
 // ==UserLibrary==
 // @name         UserUtils
-// @description  Library with various utilities for userscripts - register listeners for when CSS selectors exist, intercept events, create persistent & synchronous data stores, modify the DOM more easily and more
-// @version      8.4.0
+// @description  Lightweight library with various utilities for userscripts - register listeners for when CSS selectors exist, intercept events, create persistent & synchronous data stores, modify the DOM more easily and much more
+// @version      9.0.0
 // @license      MIT
 // @copyright    Sv443 (https://github.com/Sv443)
 
@@ -112,7 +112,7 @@ var UserUtils = (function (exports) {
       crypto.getRandomValues(uintArr);
       return Number(Array.from(
         uintArr,
-        (v) => Math.round(mapRange(v, 0, 255, min, max)).toString(10).substring(0, 1)
+        (v) => Math.round(mapRange(v, 0, 255, min, max)).toString(10)
       ).join(""));
     } else
       return Math.floor(Math.random() * (max - min + 1)) + min;
@@ -132,14 +132,14 @@ var UserUtils = (function (exports) {
   }
   function randomItemIndex(array) {
     if (array.length === 0)
-      return [void 0, void 0];
+      return [undefined, undefined];
     const idx = randRange(array.length - 1);
     return [array[idx], idx];
   }
   function takeRandomItem(arr) {
     const [itm, idx] = randomItemIndex(arr);
-    if (idx === void 0)
-      return void 0;
+    if (idx === undefined)
+      return undefined;
     arr.splice(idx, 1);
     return itm;
   }
@@ -157,7 +157,7 @@ var UserUtils = (function (exports) {
   // lib/colors.ts
   function hexToRgb(hex) {
     hex = (hex.startsWith("#") ? hex.slice(1) : hex).trim();
-    const a = hex.length === 8 || hex.length === 4 ? parseInt(hex.slice(-(hex.length / 4)), 16) / (hex.length === 8 ? 255 : 15) : void 0;
+    const a = hex.length === 8 || hex.length === 4 ? parseInt(hex.slice(-(hex.length / 4)), 16) / (hex.length === 8 ? 255 : 15) : undefined;
     if (!isNaN(Number(a)))
       hex = hex.slice(0, -(hex.length / 4));
     if (hex.length === 3 || hex.length === 4)
@@ -166,7 +166,7 @@ var UserUtils = (function (exports) {
     const r = bigint >> 16 & 255;
     const g = bigint >> 8 & 255;
     const b = bigint & 255;
-    return [clamp(r, 0, 255), clamp(g, 0, 255), clamp(b, 0, 255), typeof a === "number" ? clamp(a, 0, 1) : void 0];
+    return [clamp(r, 0, 255), clamp(g, 0, 255), clamp(b, 0, 255), typeof a === "number" ? clamp(a, 0, 1) : undefined];
   }
   function rgbToHex(red, green, blue, alpha, withHash = true, upperCase = false) {
     const toHexVal = (n) => clamp(Math.round(n), 0, 255).toString(16).padStart(2, "0")[upperCase ? "toUpperCase" : "toLowerCase"]();
@@ -189,7 +189,7 @@ var UserUtils = (function (exports) {
     if (isHexCol)
       [r, g, b, a] = hexToRgb(color);
     else if (color.startsWith("rgb")) {
-      const rgbValues = (_a = color.match(/\d+(\.\d+)?/g)) == null ? void 0 : _a.map(Number);
+      const rgbValues = (_a = color.match(/\d+(\.\d+)?/g)) == null ? undefined : _a.map(Number);
       if (!rgbValues)
         throw new Error("Invalid RGB/RGBA color format");
       [r, g, b, a] = rgbValues;
@@ -237,26 +237,32 @@ var UserUtils = (function (exports) {
     }));
     return Promise.allSettled(promises);
   }
-  function openInNewTab(href, background) {
+  function openInNewTab(href, background, additionalProps) {
+    var _a;
     try {
-      GM.openInTab(href, background);
+      (_a = GM.openInTab) == null ? void 0 : _a.call(GM, href, background);
     } catch (e) {
       const openElem = document.createElement("a");
-      Object.assign(openElem, {
+      Object.assign(openElem, __spreadValues({
         className: "userutils-open-in-new-tab",
         target: "_blank",
         rel: "noopener noreferrer",
+        tabIndex: -1,
+        ariaHidden: "true",
         href
+      }, additionalProps));
+      Object.assign(openElem.style, {
+        display: "none",
+        pointerEvents: "none"
       });
-      openElem.style.display = "none";
       document.body.appendChild(openElem);
       openElem.click();
-      setTimeout(openElem.remove, 50);
+      setTimeout(openElem.remove, 0);
     }
   }
   function interceptEvent(eventObject, eventName, predicate = () => true) {
     var _a;
-    if ((eventObject === window || eventObject === getUnsafeWindow()) && ((_a = GM == null ? void 0 : GM.info) == null ? void 0 : _a.scriptHandler) && GM.info.scriptHandler === "FireMonkey")
+    if ((eventObject === window || eventObject === getUnsafeWindow()) && ((_a = GM == null ? undefined : GM.info) == null ? undefined : _a.scriptHandler) && GM.info.scriptHandler === "FireMonkey")
       throw new Error("Intercepting window events is not supported on FireMonkey due to the isolated context the userscript runs in.");
     Error.stackTraceLimit = Math.max(Error.stackTraceLimit, 100);
     if (isNaN(Error.stackTraceLimit))
@@ -264,7 +270,7 @@ var UserUtils = (function (exports) {
     (function(original) {
       eventObject.__proto__.addEventListener = function(...args) {
         var _a2, _b;
-        const origListener = typeof args[1] === "function" ? args[1] : (_b = (_a2 = args[1]) == null ? void 0 : _a2.handleEvent) != null ? _b : () => void 0;
+        const origListener = typeof args[1] === "function" ? args[1] : (_b = (_a2 = args[1]) == null ? undefined : _a2.handleEvent) != null ? _b : () => undefined;
         args[1] = function(...a) {
           if (args[0] === eventName && predicate(Array.isArray(a) ? a[0] : a))
             return;
@@ -292,12 +298,12 @@ var UserUtils = (function (exports) {
       Object.defineProperty(element, property, {
         get: function() {
           var _a;
-          return (_a = descriptor == null ? void 0 : descriptor.get) == null ? void 0 : _a.apply(this, arguments);
+          return (_a = descriptor == null ? undefined : descriptor.get) == null ? undefined : _a.apply(this, arguments);
         },
         set: function() {
           var _a;
           const oldValue = this[property];
-          (_a = descriptor == null ? void 0 : descriptor.set) == null ? void 0 : _a.apply(this, arguments);
+          (_a = descriptor == null ? undefined : descriptor.set) == null ? undefined : _a.apply(this, arguments);
           const newValue = this[property];
           if (typeof callback === "function") {
             callback.bind(this, oldValue, newValue);
@@ -309,7 +315,7 @@ var UserUtils = (function (exports) {
   }
   function getSiblingsFrame(refElement, siblingAmount, refElementAlignment = "center-top", includeRef = true) {
     var _a, _b;
-    const siblings = [...(_b = (_a = refElement.parentNode) == null ? void 0 : _a.childNodes) != null ? _b : []];
+    const siblings = [...(_b = (_a = refElement.parentNode) == null ? undefined : _a.childNodes) != null ? _b : []];
     const elemSiblIdx = siblings.indexOf(refElement);
     if (elemSiblIdx === -1)
       throw new Error("Element doesn't have a parent node");
@@ -331,12 +337,12 @@ var UserUtils = (function (exports) {
   var ttPolicy;
   function setInnerHtmlUnsafe(element, html) {
     var _a, _b, _c;
-    if (!ttPolicy && typeof ((_a = window == null ? void 0 : window.trustedTypes) == null ? void 0 : _a.createPolicy) === "function") {
+    if (!ttPolicy && typeof ((_a = window == null ? undefined : window.trustedTypes) == null ? undefined : _a.createPolicy) === "function") {
       ttPolicy = window.trustedTypes.createPolicy("_uu_set_innerhtml_unsafe", {
         createHTML: (unsafeHtml) => unsafeHtml
       });
     }
-    element.innerHTML = (_c = (_b = ttPolicy == null ? void 0 : ttPolicy.createHTML) == null ? void 0 : _b.call(ttPolicy, html)) != null ? _c : html;
+    element.innerHTML = (_c = (_b = ttPolicy == null ? undefined : ttPolicy.createHTML) == null ? undefined : _b.call(ttPolicy, html)) != null ? _c : html;
     return element;
   }
 
@@ -412,8 +418,8 @@ var UserUtils = (function (exports) {
      * Creates an instance of DataStore to manage a sync & async database that is cached in memory and persistently saved across sessions.  
      * Supports migrating data from older versions to newer ones and populating the cache with default data if no persistent data is found.  
      *   
-     * ⚠️ Requires the directives `@grant GM.getValue` and `@grant GM.setValue` if the storageMethod is left as the default of `"GM"`  
-     * ⚠️ Make sure to call {@linkcode loadData()} at least once after creating an instance, or the returned data will be the same as `options.defaultData`
+     * - ⚠️ Requires the directives `@grant GM.getValue` and `@grant GM.setValue` if the storageMethod is left as the default of `"GM"`  
+     * - ⚠️ Make sure to call {@linkcode loadData()} at least once after creating an instance, or the returned data will be the same as `options.defaultData`
      * 
      * @template TData The type of the data that is saved in persistent storage for the currently set format version (will be automatically inferred from `defaultData` if not provided) - **This has to be a JSON-compatible object!** (no undefined, circular references, etc.)
      * @param options The options for this DataStore instance
@@ -520,7 +526,7 @@ var UserUtils = (function (exports) {
      * The in-memory cache will be left untouched, so you may still access the data with {@linkcode getData()}  
      * Calling {@linkcode loadData()} or {@linkcode setData()} after this method was called will recreate persistent storage with the cached or default data.  
      *   
-     * ⚠️ This requires the additional directive `@grant GM.deleteValue` if the storageMethod is left as the default of `"GM"`
+     * - ⚠️ This requires the additional directive `@grant GM.deleteValue` if the storageMethod is left as the default of `"GM"`
      */
     deleteData() {
       return __async(this, null, function* () {
@@ -585,7 +591,7 @@ var UserUtils = (function (exports) {
           const data = yield this.getValue(`_uucfg-${id}`, JSON.stringify(this.defaultData));
           const fmtVer = Number(yield this.getValue(`_uucfgver-${id}`, NaN));
           const isEncoded = Boolean(yield this.getValue(`_uucfgenc-${id}`, false));
-          if (data === void 0 || isNaN(fmtVer))
+          if (data === undefined || isNaN(fmtVer))
             return;
           const parsed = yield this.deserializeData(data, isEncoded);
           yield Promise.allSettled([
@@ -615,7 +621,7 @@ var UserUtils = (function (exports) {
     /** Deserializes the data using the optional this.decodeData() and returns it as a JSON object */
     deserializeData(data, useEncoding = true) {
       return __async(this, null, function* () {
-        let decRes = this.encodingEnabled() && useEncoding ? this.decodeData(data) : void 0;
+        let decRes = this.encodingEnabled() && useEncoding ? this.decodeData(data) : undefined;
         if (decRes instanceof Promise)
           decRes = yield decRes;
         return JSON.parse(decRes != null ? decRes : data);
@@ -627,7 +633,7 @@ var UserUtils = (function (exports) {
       return JSON.parse(JSON.stringify(obj));
     }
     //#region storage
-    /** Gets a value from persistent storage - can be overwritten in a subclass if you want to use something other than GM storage */
+    /** Gets a value from persistent storage - can be overwritten in a subclass if you want to use something other than the default storage methods */
     getValue(name, defaultValue) {
       return __async(this, null, function* () {
         var _a, _b;
@@ -642,7 +648,7 @@ var UserUtils = (function (exports) {
       });
     }
     /**
-     * Sets a value in persistent storage - can be overwritten in a subclass if you want to use something other than GM storage.  
+     * Sets a value in persistent storage - can be overwritten in a subclass if you want to use something other than the default storage methods.  
      * The default storage engines will stringify all passed values like numbers or booleans, so be aware of that.
      */
     setValue(name, value) {
@@ -657,7 +663,7 @@ var UserUtils = (function (exports) {
         }
       });
     }
-    /** Deletes a value from persistent storage - can be overwritten in a subclass if you want to use something other than GM storage */
+    /** Deletes a value from persistent storage - can be overwritten in a subclass if you want to use something other than the default storage methods */
     deleteValue(name) {
       return __async(this, null, function* () {
         switch (this.storageMethod) {
@@ -695,7 +701,7 @@ var UserUtils = (function (exports) {
     serializeStore(storeInst) {
       return __async(this, null, function* () {
         const data = storeInst.encodingEnabled() ? yield storeInst.encodeData(JSON.stringify(storeInst.getData())) : JSON.stringify(storeInst.getData());
-        const checksum = this.options.addChecksum ? yield this.calcChecksum(data) : void 0;
+        const checksum = this.options.addChecksum ? yield this.calcChecksum(data) : undefined;
         return {
           id: storeInst.id,
           data,
@@ -787,7 +793,7 @@ Has: ${checksum}`);
       ((_a = this.events)[event] || (_a[event] = [])).push(cb);
       return () => {
         var _a2;
-        this.events[event] = (_a2 = this.events[event]) == null ? void 0 : _a2.filter((i) => cb !== i);
+        this.events[event] = (_a2 = this.events[event]) == null ? undefined : _a2.filter((i) => cb !== i);
       };
     }
   });
@@ -821,7 +827,7 @@ Has: ${checksum}`);
         let unsub;
         const onceProxy = (...args) => {
           unsub();
-          cb == null ? void 0 : cb(...args);
+          cb == null ? undefined : cb(...args);
           resolve(args);
         };
         unsub = this.on(event, onceProxy);
@@ -843,6 +849,106 @@ Has: ${checksum}`);
     }
   };
 
+  // lib/Debouncer.ts
+  var Debouncer = class extends NanoEmitter {
+    /**
+     * Creates a new debouncer with the specified timeout and edge type.
+     * @param timeout Timeout in milliseconds between letting through calls - defaults to 200
+     * @param type The edge type to use for the debouncer - see {@linkcode DebouncerType} for details or [the documentation for an explanation and diagram](https://github.com/Sv443-Network/UserUtils/blob/main/docs.md#debouncer) - defaults to "immediate"
+     */
+    constructor(timeout = 200, type = "immediate") {
+      super();
+      this.timeout = timeout;
+      this.type = type;
+      /** All registered listener functions and the time they were attached */
+      __publicField(this, "listeners", []);
+      /** The currently active timeout */
+      __publicField(this, "activeTimeout");
+      /** The latest queued call */
+      __publicField(this, "queuedCall");
+    }
+    //#region listeners
+    /** Adds a listener function that will be called on timeout */
+    addListener(fn) {
+      this.listeners.push(fn);
+    }
+    /** Removes the listener with the specified function reference */
+    removeListener(fn) {
+      const idx = this.listeners.findIndex((l) => l === fn);
+      idx !== -1 && this.listeners.splice(idx, 1);
+    }
+    /** Removes all listeners */
+    removeAllListeners() {
+      this.listeners = [];
+    }
+    //#region timeout
+    /** Sets the timeout for the debouncer */
+    setTimeout(timeout) {
+      this.emit("change", this.timeout = timeout, this.type);
+    }
+    /** Returns the current timeout */
+    getTimeout() {
+      return this.timeout;
+    }
+    /** Whether the timeout is currently active, meaning any latest call to the {@linkcode call()} method will be queued */
+    isTimeoutActive() {
+      return typeof this.activeTimeout !== "undefined";
+    }
+    //#region type
+    /** Sets the edge type for the debouncer */
+    setType(type) {
+      this.emit("change", this.timeout, this.type = type);
+    }
+    /** Returns the current edge type */
+    getType() {
+      return this.type;
+    }
+    //#region call
+    /** Use this to call the debouncer with the specified arguments that will be passed to all listener functions registered with {@linkcode addListener()} */
+    call(...args) {
+      const cl = (...a) => {
+        this.queuedCall = undefined;
+        this.emit("call", ...a);
+        this.listeners.forEach((l) => l.apply(this, a));
+      };
+      const setRepeatTimeout = () => {
+        this.activeTimeout = setTimeout(() => {
+          if (this.queuedCall) {
+            this.queuedCall();
+            setRepeatTimeout();
+          } else
+            this.activeTimeout = undefined;
+        }, this.timeout);
+      };
+      switch (this.type) {
+        case "immediate":
+          if (typeof this.activeTimeout === "undefined") {
+            cl(...args);
+            setRepeatTimeout();
+          } else
+            this.queuedCall = () => cl(...args);
+          break;
+        case "idle":
+          if (this.activeTimeout)
+            clearTimeout(this.activeTimeout);
+          this.activeTimeout = setTimeout(() => {
+            cl(...args);
+            this.activeTimeout = undefined;
+          }, this.timeout);
+          break;
+        default:
+          throw new Error(`Invalid debouncer type: ${this.type}`);
+      }
+    }
+  };
+  function debounce(fn, timeout = 200, type = "immediate") {
+    const debouncer = new Debouncer(timeout, type);
+    debouncer.addListener(fn);
+    const func = (...args) => debouncer.call(...args);
+    func.debouncer = debouncer;
+    return func;
+  }
+
   // lib/Dialog.ts
   var defaultDialogCss = `.uu-no-select {
   user-select: none;
@@ -1060,7 +1166,7 @@ Has: ${checksum}`);
         `#uu-style-dialog-${this.id}`
       ];
       for (const sel of clearSelectors)
-        (_a = document.querySelector(sel)) == null ? void 0 : _a.remove();
+        (_a = document.querySelector(sel)) == null ? undefined : _a.remove();
       this.events.emit("clear");
     }
     /** Clears the DOM of the dialog and then renders it again */
@@ -1077,8 +1183,8 @@ Has: ${checksum}`);
     open(e) {
       return __async(this, null, function* () {
         var _a;
-        e == null ? void 0 : e.preventDefault();
-        e == null ? void 0 : e.stopImmediatePropagation();
+        e == null ? undefined : e.preventDefault();
+        e == null ? undefined : e.stopImmediatePropagation();
         if (this.isOpen())
           return;
         this.dialogOpen = true;
@@ -1096,7 +1202,7 @@ Has: ${checksum}`);
         openDialogs.unshift(this.id);
         for (const dialogId of openDialogs)
           if (dialogId !== this.id)
-            (_a = document.querySelector(`#uu-${dialogId}-dialog-bg`)) == null ? void 0 : _a.setAttribute("inert", "true");
+            (_a = document.querySelector(`#uu-${dialogId}-dialog-bg`)) == null ? undefined : _a.setAttribute("inert", "true");
         document.body.classList.remove("uu-no-select");
         document.body.setAttribute("inert", "true");
         this.events.emit("open");
@@ -1106,8 +1212,8 @@ Has: ${checksum}`);
     /** Closes the dialog - prevents default action and immediate propagation of the passed event */
     close(e) {
       var _a, _b;
-      e == null ? void 0 : e.preventDefault();
-      e == null ? void 0 : e.stopImmediatePropagation();
+      e == null ? undefined : e.preventDefault();
+      e == null ? undefined : e.stopImmediatePropagation();
       if (!this.isOpen())
         return;
       this.dialogOpen = false;
@@ -1120,7 +1226,7 @@ Has: ${checksum}`);
       openDialogs.splice(openDialogs.indexOf(this.id), 1);
       exports.currentDialogId = (_a = openDialogs[0]) != null ? _a : null;
       if (exports.currentDialogId)
-        (_b = document.querySelector(`#uu-${exports.currentDialogId}-dialog-bg`)) == null ? void 0 : _b.removeAttribute("inert");
+        (_b = document.querySelector(`#uu-${exports.currentDialogId}-dialog-bg`)) == null ? undefined : _b.removeAttribute("inert");
       if (openDialogs.length === 0) {
         document.body.classList.add("uu-no-select");
         document.body.removeAttribute("inert");
@@ -1164,7 +1270,7 @@ Has: ${checksum}`);
       if (this.options.closeOnBgClick) {
         bgElem.addEventListener("click", (e) => {
           var _a;
-          if (this.isOpen() && ((_a = e.target) == null ? void 0 : _a.id) === `uu-${this.id}-dialog-bg`)
+          if (this.isOpen() && ((_a = e.target) == null ? undefined : _a.id) === `uu-${this.id}-dialog-bg`)
             this.close(e);
         });
       }
@@ -1194,8 +1300,8 @@ Has: ${checksum}`);
           preventDefault && e.preventDefault();
           stopPropagation && e.stopPropagation();
         }
-        (listenerOpts == null ? void 0 : listenerOpts.once) && e.type === "keydown" && elem.removeEventListener("click", proxListener, listenerOpts);
-        (listenerOpts == null ? void 0 : listenerOpts.once) && e.type === "click" && elem.removeEventListener("keydown", proxListener, listenerOpts);
+        (listenerOpts == null ? undefined : listenerOpts.once) && e.type === "keydown" && elem.removeEventListener("click", proxListener, listenerOpts);
+        (listenerOpts == null ? undefined : listenerOpts.once) && e.type === "click" && elem.removeEventListener("keydown", proxListener, listenerOpts);
         listener(e);
       };
       elem.addEventListener("click", proxListener, listenerOpts);
@@ -1205,8 +1311,8 @@ Has: ${checksum}`);
     getDialogContent() {
       return __async(this, null, function* () {
         var _a, _b, _c, _d;
-        const header = (_b = (_a = this.options).renderHeader) == null ? void 0 : _b.call(_a);
-        const footer = (_d = (_c = this.options).renderFooter) == null ? void 0 : _d.call(_c);
+        const header = (_b = (_a = this.options).renderHeader) == null ? undefined : _b.call(_a);
+        const footer = (_d = (_c = this.options).renderFooter) == null ? undefined : _d.call(_c);
         const dialogWrapperEl = document.createElement("div");
         dialogWrapperEl.id = `uu-${this.id}-dialog`;
         dialogWrapperEl.classList.add("uu-dialog");
@@ -1272,7 +1378,7 @@ Has: ${checksum}`);
     return input.replace(/%\d/gm, (match) => {
       var _a, _b;
       const argIndex = Number(match.substring(1)) - 1;
-      return (_b = (_a = values[argIndex]) != null ? _a : match) == null ? void 0 : _b.toString();
+      return (_b = (_a = values[argIndex]) != null ? _a : match) == null ? undefined : _b.toString();
     });
   }
   function pauseFor(time) {
@@ -1280,27 +1386,13 @@ Has: ${checksum}`);
       setTimeout(() => res(), time);
     });
   }
-  function debounce(func, timeout = 300, edge = "falling") {
-    let id;
-    return function(...args) {
-      if (edge === "rising") {
-        if (!id) {
-          func.apply(this, args);
-          id = setTimeout(() => id = void 0, timeout);
-        }
-      } else {
-        clearTimeout(id);
-        id = setTimeout(() => func.apply(this, args), timeout);
-      }
-    };
-  }
   function fetchAdvanced(_0) {
     return __async(this, arguments, function* (input, options = {}) {
       var _a;
       const { timeout = 1e4 } = options;
       const { signal, abort } = new AbortController();
-      (_a = options.signal) == null ? void 0 : _a.addEventListener("abort", abort);
-      let signalOpts = {}, id = void 0;
+      (_a = options.signal) == null ? undefined : _a.addEventListener("abort", abort);
+      let signalOpts = {}, id = undefined;
       if (timeout >= 0) {
         id = setTimeout(() => abort(), timeout);
         signalOpts = { signal };
@@ -1343,12 +1435,12 @@ Has: ${checksum}`);
       this.listenerMap = /* @__PURE__ */ new Map();
       const _a = options, {
         defaultDebounce,
-        defaultDebounceEdge,
+        defaultDebounceType,
         disableOnNoListeners,
         enableOnAddListener
       } = _a, observerOptions = __objRest(_a, [
         "defaultDebounce",
-        "defaultDebounceEdge",
+        "defaultDebounceType",
         "disableOnNoListeners",
         "enableOnAddListener"
       ]);
@@ -1358,7 +1450,7 @@ Has: ${checksum}`);
       }, observerOptions);
       this.customOptions = {
         defaultDebounce: defaultDebounce != null ? defaultDebounce : 0,
-        defaultDebounceEdge: defaultDebounceEdge != null ? defaultDebounceEdge : "rising",
+        defaultDebounceType: defaultDebounceType != null ? defaultDebounceType : "immediate",
         disableOnNoListeners: disableOnNoListeners != null ? disableOnNoListeners : false,
         enableOnAddListener: enableOnAddListener != null ? enableOnAddListener : true
       };
@@ -1402,7 +1494,7 @@ Has: ${checksum}`);
               this.removeListener(selector, options);
           }
         }
-        if (((_a = this.listenerMap.get(selector)) == null ? void 0 : _a.length) === 0)
+        if (((_a = this.listenerMap.get(selector)) == null ? undefined : _a.length) === 0)
           this.listenerMap.delete(selector);
         if (this.listenerMap.size === 0 && this.customOptions.disableOnNoListeners)
           this.disable();
@@ -1428,7 +1520,7 @@ Has: ${checksum}`);
         options.listener = debounce(
           options.listener,
           options.debounce || this.customOptions.defaultDebounce,
-          options.debounceEdge || this.customOptions.defaultDebounceEdge
+          options.debounceType || this.customOptions.defaultDebounceType
         );
       }
       if (this.listenerMap.has(selector))
@@ -1446,7 +1538,7 @@ Has: ${checksum}`);
       if (!this.enabled)
         return;
       this.enabled = false;
-      (_a = this.observer) == null ? void 0 : _a.disconnect();
+      (_a = this.observer) == null ? undefined : _a.disconnect();
     }
     /**
      * Enables or reenables the observation of the child elements.
@@ -1459,7 +1551,7 @@ Has: ${checksum}`);
       if (this.enabled || !baseElement)
         return false;
       this.enabled = true;
-      (_a = this.observer) == null ? void 0 : _a.observe(baseElement, this.observerOptions);
+      (_a = this.observer) == null ? undefined : _a.observe(baseElement, this.observerOptions);
       if (immediatelyCheckSelectors)
         this.checkAllSelectors();
       return true;
@@ -1506,43 +1598,169 @@ Has: ${checksum}`);
 
   // lib/translation.ts
   var trans = {};
-  var curLang = "";
-  function translate(language, key, ...args) {
-    var _a;
-    const trObj = (_a = trans[language]) == null ? void 0 : _a.data;
-    if (typeof language !== "string" || typeof trObj !== "object" || trObj === null)
-      return key;
+  var valTransforms = [];
+  var fallbackLang;
+  function translate(language, key, ...trArgs) {
+    if (typeof language !== "string")
+      language = fallbackLang != null ? fallbackLang : "";
+    const trObj = trans[language];
+    if (typeof language !== "string" || language.length === 0 || typeof trObj !== "object" || trObj === null)
+      return fallbackLang ? translate(fallbackLang, key, ...trArgs) : key;
+    const transformTrVal = (trKey, trValue) => {
+      const tfs = valTransforms.filter(({ regex }) => new RegExp(regex).test(trValue));
+      if (tfs.length === 0)
+        return trValue;
+      let retStr = String(trValue);
+      for (const tf of tfs) {
+        const re = new RegExp(tf.regex);
+        const matches = [];
+        let execRes;
+        while ((execRes = re.exec(trValue)) !== null) {
+          if (matches.some((m) => m[0] === (execRes == null ? undefined : execRes[0])))
+            break;
+          matches.push(execRes);
+        }
+        retStr = String(tf.fn({
+          language,
+          trValue,
+          currentValue: retStr,
+          matches,
+          trKey,
+          trArgs
+        }));
+      }
+      return retStr;
+    };
     const keyParts = key.split(".");
     let value = trObj;
     for (const part of keyParts) {
-      if (typeof value !== "object" || value === null)
+      if (typeof value !== "object" || value === null) {
+        value = undefined;
         break;
-      value = value == null ? void 0 : value[part];
+      }
+      value = value == null ? undefined : value[part];
     }
     if (typeof value === "string")
-      return insertValues(value, args);
-    value = trObj == null ? void 0 : trObj[key];
+      return transformTrVal(key, value);
+    value = trObj == null ? undefined : trObj[key];
     if (typeof value === "string")
-      return insertValues(value, args);
-    return key;
+      return transformTrVal(key, value);
+    return fallbackLang ? translate(fallbackLang, key, ...trArgs) : key;
   }
-  var tr = (key, ...args) => translate(curLang, key, ...args);
-  tr.forLang = translate;
-  tr.addLanguage = (language, translations) => {
-    trans[language] = translations;
-  };
-  tr.setLanguage = (language) => {
-    curLang = language;
-  };
-  tr.getLanguage = () => {
-    return curLang;
+  function trFor(language, key, ...args) {
+    const txt = translate(language, key, ...args);
+    if (txt === key)
+      return fallbackLang ? translate(fallbackLang, key, ...args) : key;
+    return txt;
+  }
+  function useTr(language) {
+    return (key, ...args) => translate(language, key, ...args);
+  }
+  function hasKey(language = fallbackLang != null ? fallbackLang : "", key) {
+    return tr.for(language, key) !== key;
+  }
+  function addTranslations(language, translations) {
+    trans[language] = JSON.parse(JSON.stringify(translations));
+  }
+  function getTranslations(language = fallbackLang != null ? fallbackLang : "") {
+    return trans[language];
+  }
+  var deleteTranslations = (language) => {
+    if (language in trans) {
+      delete trans[language];
+      return true;
+    }
+    return false;
   };
-  tr.getTranslations = (language) => {
-    return trans[language != null ? language : curLang];
+  function setFallbackLanguage(fallbackLanguage) {
+    fallbackLang = fallbackLanguage;
+  }
+  function getFallbackLanguage() {
+    return fallbackLang;
+  }
+  function addTransform(transform) {
+    const [pattern, fn] = transform;
+    valTransforms.push({
+      fn,
+      regex: typeof pattern === "string" ? new RegExp(pattern, "gm") : pattern
+    });
+  }
+  function deleteTransform(patternOrFn) {
+    const idx = valTransforms.findIndex(
+      (t) => typeof patternOrFn === "function" ? t.fn === patternOrFn : typeof patternOrFn === "string" ? t.regex.source === patternOrFn : t.regex === patternOrFn
+    );
+    if (idx !== -1) {
+      valTransforms.splice(idx, 1);
+      return true;
+    }
+    return false;
+  }
+  var templateLiteralTransform = [
+    /\$\{([a-zA-Z0-9$_-]+)\}/gm,
+    ({ matches, trArgs, trValue }) => {
+      const patternStart = "${", patternEnd = "}", patternRegex = /\$\{.+\}/m;
+      let str = String(trValue);
+      const eachKeyInTrString = (keys) => keys.every((key) => trValue.includes(`${patternStart}${key}${patternEnd}`));
+      const namedMapping = () => {
+        var _a;
+        if (!str.includes(patternStart) || typeof trArgs[0] === "undefined" || typeof trArgs[0] !== "object" || !eachKeyInTrString(Object.keys((_a = trArgs[0]) != null ? _a : {})))
+          return;
+        for (const match of matches) {
+          const repl = match[1] !== undefined ? trArgs[0][match[1]] : undefined;
+          if (typeof repl !== "undefined")
+            str = str.replace(match[0], String(repl));
+        }
+      };
+      const positionalMapping = () => {
+        if (!patternRegex.test(str) || !trArgs[0])
+          return;
+        let matchNum = -1;
+        for (const match of matches) {
+          matchNum++;
+          if (typeof trArgs[matchNum] !== "undefined")
+            str = str.replace(match[0], String(trArgs[matchNum]));
+        }
+      };
+      const isArgsObject = trArgs[0] && typeof trArgs[0] === "object" && trArgs[0] !== null && String(trArgs[0]).startsWith("[object");
+      if (isArgsObject && eachKeyInTrString(Object.keys(trArgs[0])))
+        namedMapping();
+      else
+        positionalMapping();
+      return str;
+    }
+  ];
+  var percentTransform = [
+    /\$\{([a-zA-Z0-9$_-]+)\}/gm,
+    ({ matches, trArgs, trValue }) => {
+      let str = String(trValue);
+      for (const match of matches) {
+        const repl = match[1] !== undefined ? trArgs[0][match[1]] : undefined;
+        if (typeof repl !== "undefined")
+          str = str.replace(match[0], String(repl));
+      }
+      return str;
+    }
+  ];
+  var tr = {
+    for: (...params) => trFor(...params),
+    use: (...params) => useTr(...params),
+    hasKey: (language = fallbackLang != null ? fallbackLang : "", key) => hasKey(language, key),
+    addTranslations,
+    getTranslations,
+    deleteTranslations,
+    setFallbackLanguage,
+    getFallbackLanguage,
+    addTransform,
+    deleteTransform,
+    transforms: {
+      templateLiteral: templateLiteralTransform,
+      percent: percentTransform
+    }
   };
 
   exports.DataStore = DataStore;
   exports.DataStoreSerializer = DataStoreSerializer;
+  exports.Debouncer = Debouncer;
   exports.Dialog = Dialog;
   exports.NanoEmitter = NanoEmitter;
   exports.SelectorObserver = SelectorObserver;