@sv443-network/userutils 8.3.3 → 9.0.0

package/dist/index.js

@@ -28,10 +28,7 @@ var __objRest = (source, exclude) => {
     }
   return target;
 };
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 var __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
@@ -55,14 +52,17 @@ var __async = (__this, __arguments, generator) => {
 
 // lib/math.ts
 function clamp(value, min, max) {
+  if (typeof max !== "number") {
+    max = min;
+    min = 0;
+  }
   return Math.max(Math.min(value, max), min);
 }
 function mapRange(value, range1min, range1max, range2min, range2max) {
-  if (typeof range2min === "undefined" || range2max === void 0) {
+  if (typeof range2min === "undefined" || typeof range2max === "undefined") {
     range2max = range1max;
-    range2min = 0;
     range1max = range1min;
-    range1min = 0;
+    range2min = range1min = 0;
   }
   if (Number(range1min) === 0 && Number(range2min) === 0)
     return value * (range2max / range1max);
@@ -76,7 +76,7 @@ function randRange(...args) {
     min = 0;
     [max] = args;
   } else
-    throw new TypeError(`Wrong parameter(s) provided - expected: "number" and "number|undefined", got: "${typeof args[0]}" and "${typeof args[1]}"`);
+    throw new TypeError(`Wrong parameter(s) provided - expected (number, boolean|undefined) or (number, number, boolean|undefined) but got (${args.map((a) => typeof a).join(", ")}) instead`);
   if (typeof args[2] === "boolean")
     enhancedEntropy = args[2];
   else if (typeof args[1] === "boolean")
@@ -92,11 +92,19 @@ function randRange(...args) {
     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;
 }
+function digitCount(num) {
+  num = Number(!["string", "number"].includes(typeof num) ? String(num) : num);
+  if (typeof num === "number" && isNaN(num))
+    return NaN;
+  return num === 0 ? 1 : Math.floor(
+    Math.log10(Math.abs(Number(num))) + 1
+  );
+}
 
 // lib/array.ts
 function randomItem(array) {
@@ -104,14 +112,14 @@ function randomItem(array) {
 }
 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;
 }
@@ -129,7 +137,7 @@ function randomizeArray(array) {
 // 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)
@@ -138,7 +146,7 @@ function hexToRgb(hex) {
   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"]();
@@ -161,7 +169,7 @@ function darkenColor(color, percent, upperCase = false) {
   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;
@@ -209,26 +217,32 @@ function preloadImages(srcUrls, rejects = false) {
   }));
   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))
@@ -236,7 +250,7 @@ function interceptEvent(eventObject, eventName, predicate = () => true) {
   (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;
@@ -264,12 +278,12 @@ function observeElementProp(element, property, callback) {
     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);
@@ -281,7 +295,7 @@ function observeElementProp(element, property, callback) {
 }
 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");
@@ -303,12 +317,12 @@ function getSiblingsFrame(refElement, siblingAmount, refElementAlignment = "cent
 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;
 }
 
@@ -384,8 +398,8 @@ var DataStore = class {
    * 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
@@ -492,7 +506,7 @@ var DataStore = class {
    * 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* () {
@@ -557,7 +571,7 @@ var DataStore = class {
         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([
@@ -587,7 +601,7 @@ var DataStore = class {
   /** 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);
@@ -599,7 +613,7 @@ var DataStore = class {
     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;
@@ -614,7 +628,7 @@ var DataStore = class {
     });
   }
   /**
-   * 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) {
@@ -629,7 +643,7 @@ var DataStore = class {
       }
     });
   }
-  /** 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) {
@@ -667,7 +681,7 @@ var DataStoreSerializer = class {
   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,
@@ -773,7 +787,7 @@ var NanoEmitter = class {
       let unsub;
       const onceProxy = (...args) => {
         unsub();
-        cb == null ? void 0 : cb(...args);
+        cb == null ? undefined : cb(...args);
         resolve(args);
       };
       unsub = this.on(event, onceProxy);
@@ -795,6 +809,106 @@ var NanoEmitter = class {
   }
 };
 
+// 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;
@@ -1012,7 +1126,7 @@ var Dialog = class _Dialog extends NanoEmitter {
       `#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 */
@@ -1029,8 +1143,8 @@ var Dialog = class _Dialog extends NanoEmitter {
   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;
@@ -1048,7 +1162,7 @@ var Dialog = class _Dialog extends NanoEmitter {
       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");
@@ -1058,8 +1172,8 @@ var Dialog = class _Dialog extends NanoEmitter {
   /** 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;
@@ -1072,7 +1186,7 @@ var Dialog = class _Dialog extends NanoEmitter {
     openDialogs.splice(openDialogs.indexOf(this.id), 1);
     currentDialogId = (_a = openDialogs[0]) != null ? _a : null;
     if (currentDialogId)
-      (_b = document.querySelector(`#uu-${currentDialogId}-dialog-bg`)) == null ? void 0 : _b.removeAttribute("inert");
+      (_b = document.querySelector(`#uu-${currentDialogId}-dialog-bg`)) == null ? undefined : _b.removeAttribute("inert");
     if (openDialogs.length === 0) {
       document.body.classList.add("uu-no-select");
       document.body.removeAttribute("inert");
@@ -1116,7 +1230,7 @@ var Dialog = class _Dialog extends NanoEmitter {
     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);
       });
     }
@@ -1141,14 +1255,13 @@ var Dialog = class _Dialog extends NanoEmitter {
         if (interactionKeys.includes(e.key)) {
           preventDefault && e.preventDefault();
           stopPropagation && e.stopPropagation();
-        } else
-          return;
+        } else return;
       } else if (e instanceof MouseEvent) {
         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);
@@ -1158,8 +1271,8 @@ var Dialog = class _Dialog extends NanoEmitter {
   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");
@@ -1225,7 +1338,7 @@ function insertValues(input, ...values) {
   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) {
@@ -1233,27 +1346,13 @@ function pauseFor(time) {
     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 };
@@ -1268,6 +1367,18 @@ function fetchAdvanced(_0) {
     }
   });
 }
+function consumeGen(valGen) {
+  return __async(this, null, function* () {
+    return yield typeof valGen === "function" ? valGen() : valGen;
+  });
+}
+function consumeStringGen(strGen) {
+  return __async(this, null, function* () {
+    return typeof strGen === "string" ? strGen : String(
+      typeof strGen === "function" ? yield strGen() : strGen
+    );
+  });
+}
 
 // lib/SelectorObserver.ts
 var domLoaded = false;
@@ -1284,12 +1395,12 @@ var SelectorObserver = class {
     this.listenerMap = /* @__PURE__ */ new Map();
     const _a = options, {
       defaultDebounce,
-      defaultDebounceEdge,
+      defaultDebounceType,
       disableOnNoListeners,
       enableOnAddListener
     } = _a, observerOptions = __objRest(_a, [
       "defaultDebounce",
-      "defaultDebounceEdge",
+      "defaultDebounceType",
       "disableOnNoListeners",
       "enableOnAddListener"
     ]);
@@ -1299,7 +1410,7 @@ var SelectorObserver = class {
     }, 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
     };
@@ -1343,7 +1454,7 @@ var SelectorObserver = class {
             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();
@@ -1369,7 +1480,7 @@ var SelectorObserver = class {
       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))
@@ -1387,7 +1498,7 @@ var SelectorObserver = class {
     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.
@@ -1400,7 +1511,7 @@ var SelectorObserver = class {
     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;
@@ -1447,34 +1558,164 @@ var SelectorObserver = class {
 
 // lib/translation.ts
 var trans = {};
-var curLang;
-var trLang = (language, key, ...args) => {
-  var _a;
-  if (!language)
-    return key;
-  const trText = (_a = trans[language]) == null ? void 0 : _a[key];
-  if (!trText)
-    return key;
-  if (args.length > 0 && trText.match(/%\d/)) {
-    return insertValues(trText, ...args);
-  }
-  return trText;
-};
-function tr(key, ...args) {
-  return trLang(curLang, key, ...args);
+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) {
+      value = undefined;
+      break;
+    }
+    value = value == null ? undefined : value[part];
+  }
+  if (typeof value === "string")
+    return transformTrVal(key, value);
+  value = trObj == null ? undefined : trObj[key];
+  if (typeof value === "string")
+    return transformTrVal(key, value);
+  return fallbackLang ? translate(fallbackLang, key, ...trArgs) : key;
 }
-tr.forLang = trLang;
-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
+  }
 };
 
-export { DataStore, DataStoreSerializer, Dialog, NanoEmitter, SelectorObserver, addGlobalStyle, addParent, autoPlural, clamp, compress, computeHash, currentDialogId, darkenColor, debounce, decompress, defaultDialogCss, defaultStrings, fetchAdvanced, getSiblingsFrame, getUnsafeWindow, hexToRgb, insertValues, interceptEvent, interceptWindowEvent, isScrollable, lightenColor, mapRange, observeElementProp, openDialogs, openInNewTab, pauseFor, preloadImages, randRange, randomId, randomItem, randomItemIndex, randomizeArray, rgbToHex, setInnerHtmlUnsafe, takeRandomItem, tr };
+export { DataStore, DataStoreSerializer, Debouncer, Dialog, NanoEmitter, SelectorObserver, addGlobalStyle, addParent, autoPlural, clamp, compress, computeHash, consumeGen, consumeStringGen, currentDialogId, darkenColor, debounce, decompress, defaultDialogCss, defaultStrings, digitCount, fetchAdvanced, getSiblingsFrame, getUnsafeWindow, hexToRgb, insertValues, interceptEvent, interceptWindowEvent, isScrollable, lightenColor, mapRange, observeElementProp, openDialogs, openInNewTab, pauseFor, preloadImages, randRange, randomId, randomItem, randomItemIndex, randomizeArray, rgbToHex, setInnerHtmlUnsafe, takeRandomItem, tr };