@sv443-network/userutils 10.0.0 → 10.0.2

package/dist/UserUtils.cjs

@@ -30,755 +30,1432 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // lib/index.ts
 var lib_exports = {};
 __export(lib_exports, {
+  BrowserStorageEngine: () => BrowserStorageEngine,
+  ChecksumMismatchError: () => ChecksumMismatchError,
+  CustomError: () => CustomError,
+  DataStore: () => DataStore,
+  DataStoreEngine: () => DataStoreEngine,
+  DataStoreSerializer: () => DataStoreSerializer,
+  DatedError: () => DatedError,
+  Debouncer: () => Debouncer,
   Dialog: () => Dialog,
+  FileStorageEngine: () => FileStorageEngine,
   GMStorageEngine: () => GMStorageEngine,
+  MigrationError: () => MigrationError,
   Mixins: () => Mixins,
+  NanoEmitter: () => NanoEmitter,
+  NetworkError: () => NetworkError,
   PlatformError: () => PlatformError,
+  ScriptContextError: () => ScriptContextError,
   SelectorObserver: () => SelectorObserver,
+  ValidationError: () => ValidationError,
+  abtoa: () => abtoa,
   addGlobalStyle: () => addGlobalStyle,
   addParent: () => addParent,
+  atoab: () => atoab,
+  autoPlural: () => autoPlural,
+  bitSetHas: () => bitSetHas,
+  capitalize: () => capitalize,
+  clamp: () => clamp,
+  compress: () => compress,
+  computeHash: () => computeHash,
+  consumeGen: () => consumeGen,
+  consumeStringGen: () => consumeStringGen,
+  createProgressBar: () => createProgressBar,
   currentDialogId: () => currentDialogId,
+  darkenColor: () => darkenColor,
+  debounce: () => debounce,
+  decompress: () => decompress,
   defaultDialogCss: () => defaultDialogCss,
+  defaultPbChars: () => defaultPbChars,
   defaultStrings: () => defaultStrings,
+  digitCount: () => digitCount,
+  fetchAdvanced: () => fetchAdvanced,
+  formatNumber: () => formatNumber,
+  getCallStack: () => getCallStack,
+  getListLength: () => getListLength,
   getSiblingsFrame: () => getSiblingsFrame,
   getUnsafeWindow: () => getUnsafeWindow,
+  hexToRgb: () => hexToRgb,
+  insertValues: () => insertValues,
   interceptEvent: () => interceptEvent,
   interceptWindowEvent: () => interceptWindowEvent,
   isDomLoaded: () => isDomLoaded,
   isScrollable: () => isScrollable,
+  joinArrayReadable: () => joinArrayReadable,
+  lightenColor: () => lightenColor,
+  mapRange: () => mapRange,
   observeElementProp: () => observeElementProp,
   onDomLoad: () => onDomLoad,
   openDialogs: () => openDialogs,
   openInNewTab: () => openInNewTab,
+  overflowVal: () => overflowVal,
+  pauseFor: () => pauseFor,
   preloadImages: () => preloadImages,
   probeElementStyle: () => probeElementStyle,
+  pureObj: () => pureObj,
+  randRange: () => randRange,
+  randomId: () => randomId,
+  randomItem: () => randomItem,
+  randomItemIndex: () => randomItemIndex,
+  randomizeArray: () => randomizeArray,
+  rgbToHex: () => rgbToHex,
+  roundFixed: () => roundFixed,
+  scheduleExit: () => scheduleExit,
+  secsToTimeStr: () => secsToTimeStr,
+  setImmediateInterval: () => setImmediateInterval,
+  setImmediateTimeoutLoop: () => setImmediateTimeoutLoop,
   setInnerHtmlUnsafe: () => setInnerHtmlUnsafe,
-  tr: () => tr
+  takeRandomItem: () => takeRandomItem,
+  takeRandomItemIndex: () => takeRandomItemIndex,
+  tr: () => tr,
+  truncStr: () => truncStr,
+  valsWithin: () => valsWithin
 });
 module.exports = __toCommonJS(lib_exports);
 
-// node_modules/.pnpm/@sv443-network+coreutils@3.0.1/node_modules/@sv443-network/coreutils/dist/CoreUtils.min.umd.js
-(function(g, f) {
-  if ("object" == typeof exports && "object" == typeof module) {
-    module.exports = f();
-  } else if ("function" == typeof define && define.amd) {
-    define("CoreUtils", [], f);
-  } else if ("object" == typeof exports) {
-    exports["CoreUtils"] = f();
-  } else {
-    g["CoreUtils"] = f();
-  }
-})(void 0, () => {
-  var exports2 = {};
-  var module2 = { exports: exports2 };
-  "use strict";
-  var X = Object.create;
-  var F = Object.defineProperty;
-  var Y = Object.getOwnPropertyDescriptor;
-  var ee = Object.getOwnPropertyNames;
-  var te = Object.getPrototypeOf, re = Object.prototype.hasOwnProperty;
-  var ie = (r, e) => {
-    for (var t in e) F(r, t, { get: e[t], enumerable: true });
-  }, B = (r, e, t, i) => {
-    if (e && typeof e == "object" || typeof e == "function") for (let n of ee(e)) !re.call(r, n) && n !== t && F(r, n, { get: () => e[n], enumerable: !(i = Y(e, n)) || i.enumerable });
-    return r;
-  };
-  var I = (r, e, t) => (t = r != null ? X(te(r)) : {}, B(e || !r || !r.__esModule ? F(t, "default", { value: r, enumerable: true }) : t, r)), ne = (r) => B(F({}, "__esModule", { value: true }), r);
-  var _e = {};
-  ie(_e, { BrowserStorageEngine: () => U, ChecksumMismatchError: () => S, CustomError: () => v, DataStore: () => z, DataStoreEngine: () => E, DataStoreSerializer: () => j, DatedError: () => d, Debouncer: () => A, FileStorageEngine: () => R, MigrationError: () => w, NanoEmitter: () => P, NetworkError: () => x, ScriptContextError: () => g, ValidationError: () => $, abtoa: () => H, atoab: () => W, autoPlural: () => Pe, bitSetHas: () => ae, capitalize: () => Oe, clamp: () => D, compress: () => N, computeHash: () => k, consumeGen: () => ge, consumeStringGen: () => be, createProgressBar: () => Fe, darkenColor: () => L, debounce: () => Ie, decompress: () => fe, defaultPbChars: () => Q, digitCount: () => oe, fetchAdvanced: () => ye, formatNumber: () => se, getCallStack: () => Ee, getListLength: () => De, hexToRgb: () => q, insertValues: () => Ve, joinArrayReadable: () => Ne, lightenColor: () => pe, mapRange: () => V, overflowVal: () => ue, pauseFor: () => Te, pureObj: () => Se, randRange: () => T, randomId: () => he, randomItem: () => le, randomItemIndex: () => C, randomizeArray: () => de, rgbToHex: () => J, roundFixed: () => _, scheduleExit: () => xe, secsToTimeStr: () => Ae, setImmediateInterval: () => ve, setImmediateTimeoutLoop: () => we, takeRandomItem: () => me, takeRandomItemIndex: () => K, truncStr: () => Me, valsWithin: () => ce });
-  module2.exports = ne(_e);
-  function ae(r, e) {
-    return (r & e) === e;
-  }
-  function D(r, e, t) {
-    return typeof t != "number" && (t = e, e = 0), Math.max(Math.min(r, t), e);
-  }
-  function oe(r, e = true) {
-    if (r = Number(["string", "number"].includes(typeof r) ? r : String(r)), typeof r == "number" && isNaN(r)) return NaN;
-    let [t, i] = r.toString().split("."), n = t === "0" ? 1 : Math.floor(Math.log10(Math.abs(Number(t))) + 1), o = e && i ? i.length : 0;
-    return n + o;
-  }
-  function se(r, e, t) {
-    return r.toLocaleString(e, t === "short" ? { notation: "compact", compactDisplay: "short", maximumFractionDigits: 1 } : { style: "decimal", maximumFractionDigits: 0 });
-  }
-  function V(r, e, t, i, n) {
-    return (typeof i > "u" || typeof n > "u") && (n = t, t = e, i = e = 0), Number(e) === 0 && Number(i) === 0 ? r * (n / t) : (r - e) * ((n - i) / (t - e)) + i;
-  }
-  function ue(r, e, t) {
-    let i = typeof t == "number" ? e : 0;
-    if (t = typeof t == "number" ? t : e, i > t) throw new RangeError(`Parameter "min" can't be bigger than "max"`);
-    if (isNaN(r) || isNaN(i) || isNaN(t) || !isFinite(r) || !isFinite(i) || !isFinite(t)) return NaN;
-    if (r >= i && r <= t) return r;
-    let n = t - i + 1;
-    return ((r - i) % n + n) % n + i;
-  }
-  function T(...r) {
-    let e, t, i = false;
-    if (typeof r[0] == "number" && typeof r[1] == "number") [e, t] = r;
-    else if (typeof r[0] == "number" && typeof r[1] != "number") e = 0, [t] = r;
-    else throw new TypeError(`Wrong parameter(s) provided - expected (number, boolean|undefined) or (number, number, boolean|undefined) but got (${r.map((n) => typeof n).join(", ")}) instead`);
-    if (typeof r[2] == "boolean" ? i = r[2] : typeof r[1] == "boolean" && (i = r[1]), e = Number(e), t = Number(t), isNaN(e) || isNaN(t)) return NaN;
-    if (e > t) throw new TypeError(`Parameter "min" can't be bigger than "max"`);
-    if (i) {
-      let n = new Uint8Array(1);
-      return crypto.getRandomValues(n), Number(Array.from(n, (o) => Math.round(V(o, 0, 255, e, t)).toString(10)).join(""));
-    } else return Math.floor(Math.random() * (t - e + 1)) + e;
-  }
-  function _(r, e) {
-    let t = 10 ** e;
-    return Math.round(r * t) / t;
-  }
-  function ce(r, e, t = 1, i = 0.5) {
-    return Math.abs(_(r, t) - _(e, t)) <= i;
-  }
-  function le(r) {
-    return C(r)[0];
-  }
-  function C(r) {
-    if (r.length === 0) return [void 0, void 0];
-    let e = T(r.length - 1);
-    return [r[e], e];
-  }
-  function de(r) {
-    let e = [...r];
-    if (r.length === 0) return e;
-    for (let t = e.length - 1; t > 0; t--) {
-      let i = Math.floor(Math.random() * (t + 1));
-      [e[t], e[i]] = [e[i], e[t]];
-    }
-    return e;
-  }
-  function me(r) {
-    var e;
-    return (e = K(r)) == null ? void 0 : e[0];
-  }
-  function K(r) {
-    let [e, t] = C(r);
-    return t === void 0 ? [void 0, void 0] : (r.splice(t, 1), [e, t]);
-  }
-  function L(r, e, t = false) {
-    var l;
-    r = r.trim();
-    let i = (c, p, m, b) => (c = Math.max(0, Math.min(255, c - c * b / 100)), p = Math.max(0, Math.min(255, p - p * b / 100)), m = Math.max(0, Math.min(255, m - m * b / 100)), [c, p, m]), n, o, a, s, u = r.match(/^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{4}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$/);
-    if (u) [n, o, a, s] = q(r);
-    else if (r.startsWith("rgb")) {
-      let c = (l = r.match(/\d+(\.\d+)?/g)) == null ? void 0 : l.map(Number);
-      if (!c) throw new TypeError("Invalid RGB/RGBA color format");
-      [n, o, a, s] = c;
-    } else throw new TypeError("Unsupported color format");
-    return [n, o, a] = i(n, o, a, e), u ? J(n, o, a, s, r.startsWith("#"), t) : r.startsWith("rgba") ? `rgba(${n}, ${o}, ${a}, ${s ?? NaN})` : `rgb(${n}, ${o}, ${a})`;
-  }
-  function q(r) {
-    r = (r.startsWith("#") ? r.slice(1) : r).trim();
-    let e = r.length === 8 || r.length === 4 ? parseInt(r.slice(-(r.length / 4)), 16) / (r.length === 8 ? 255 : 15) : void 0;
-    isNaN(Number(e)) || (r = r.slice(0, -(r.length / 4))), (r.length === 3 || r.length === 4) && (r = r.split("").map((a) => a + a).join(""));
-    let t = parseInt(r, 16), i = t >> 16 & 255, n = t >> 8 & 255, o = t & 255;
-    return [D(i, 0, 255), D(n, 0, 255), D(o, 0, 255), typeof e == "number" ? D(e, 0, 1) : void 0];
-  }
-  function pe(r, e, t = false) {
-    return L(r, e * -1, t);
-  }
-  function J(r, e, t, i, n = true, o = false) {
-    let a = (s) => D(Math.round(s), 0, 255).toString(16).padStart(2, "0")[o ? "toUpperCase" : "toLowerCase"]();
-    return `${n ? "#" : ""}${a(r)}${a(e)}${a(t)}${i ? a(i * 255) : ""}`;
-  }
-  function H(r) {
-    return btoa(new Uint8Array(r).reduce((e, t) => e + String.fromCharCode(t), ""));
-  }
-  function W(r) {
-    return Uint8Array.from(atob(r), (e) => e.charCodeAt(0));
-  }
-  async function N(r, e, t = "string") {
-    let i = r instanceof Uint8Array ? r : new TextEncoder().encode((r == null ? void 0 : r.toString()) ?? String(r)), n = new CompressionStream(e), o = n.writable.getWriter();
-    o.write(i), o.close();
-    let a = new Uint8Array(await new Response(n.readable).arrayBuffer());
-    return t === "arrayBuffer" ? a : H(a);
-  }
-  async function fe(r, e, t = "string") {
-    let i = r instanceof Uint8Array ? r : W((r == null ? void 0 : r.toString()) ?? String(r)), n = new DecompressionStream(e), o = n.writable.getWriter();
-    o.write(i), o.close();
-    let a = new Uint8Array(await new Response(n.readable).arrayBuffer());
-    return t === "arrayBuffer" ? a : new TextDecoder().decode(a);
-  }
-  async function k(r, e = "SHA-256") {
-    let t;
-    typeof r == "string" ? t = new TextEncoder().encode(r) : t = r;
-    let i = await crypto.subtle.digest(e, t);
-    return Array.from(new Uint8Array(i)).map((a) => a.toString(16).padStart(2, "0")).join("");
-  }
-  function he(r = 16, e = 16, t = false, i = true) {
-    if (r < 1) throw new RangeError("The length argument must be at least 1");
-    if (e < 2 || e > 36) throw new RangeError("The radix argument must be between 2 and 36");
-    let n = [], o = i ? [0, 1] : [0];
-    if (t) {
-      let a = new Uint8Array(r);
-      crypto.getRandomValues(a), n = Array.from(a, (s) => V(s, 0, 255, 0, e).toString(e).substring(0, 1));
-    } else n = Array.from({ length: r }, () => Math.floor(Math.random() * e).toString(e));
-    return n.some((a) => /[a-zA-Z]/.test(a)) ? n.map((a) => o[T(0, o.length - 1, t)] === 1 ? a.toUpperCase() : a).join("") : n.join("");
-  }
-  var d = class extends Error {
-    date;
-    constructor(e, t) {
-      super(e, t), this.name = this.constructor.name, this.date = /* @__PURE__ */ new Date();
-    }
-  }, S = class extends d {
-    constructor(e, t) {
-      super(e, t), this.name = "ChecksumMismatchError";
-    }
-  }, v = class extends d {
-    constructor(e, t, i) {
-      super(t, i), this.name = e;
-    }
-  }, w = class extends d {
-    constructor(e, t) {
-      super(e, t), this.name = "MigrationError";
-    }
-  }, $ = class extends d {
-    constructor(e, t) {
-      super(e, t), this.name = "ValidationError";
-    }
-  }, g = class extends d {
-    constructor(e, t) {
-      super(e, t), this.name = "ScriptContextError";
-    }
-  }, x = class extends d {
-    constructor(e, t) {
-      super(e, t), this.name = "NetworkError";
+// node_modules/.pnpm/@sv443-network+coreutils@3.0.2/node_modules/@sv443-network/coreutils/dist/CoreUtils.mjs
+function bitSetHas(bitSet, checkVal) {
+  return (bitSet & checkVal) === checkVal;
+}
+function clamp(value, min, max) {
+  if (typeof max !== "number") {
+    max = min;
+    min = 0;
+  }
+  return Math.max(Math.min(value, max), min);
+}
+function digitCount(num, withDecimals = true) {
+  num = Number(!["string", "number"].includes(typeof num) ? String(num) : num);
+  if (typeof num === "number" && isNaN(num))
+    return NaN;
+  const [intPart, decPart] = num.toString().split(".");
+  const intDigits = intPart === "0" ? 1 : Math.floor(Math.log10(Math.abs(Number(intPart))) + 1);
+  const decDigits = withDecimals && decPart ? decPart.length : 0;
+  return intDigits + decDigits;
+}
+function formatNumber(number, locale, format) {
+  return number.toLocaleString(
+    locale,
+    format === "short" ? {
+      notation: "compact",
+      compactDisplay: "short",
+      maximumFractionDigits: 1
+    } : {
+      style: "decimal",
+      maximumFractionDigits: 0
     }
+  );
+}
+function mapRange(value, range1min, range1max, range2min, range2max) {
+  if (typeof range2min === "undefined" || typeof range2max === "undefined") {
+    range2max = range1max;
+    range1max = range1min;
+    range2min = range1min = 0;
+  }
+  if (Number(range1min) === 0 && Number(range2min) === 0)
+    return value * (range2max / range1max);
+  return (value - range1min) * ((range2max - range2min) / (range1max - range1min)) + range2min;
+}
+function overflowVal(value, minOrMax, max) {
+  const min = typeof max === "number" ? minOrMax : 0;
+  max = typeof max === "number" ? max : minOrMax;
+  if (min > max)
+    throw new RangeError(`Parameter "min" can't be bigger than "max"`);
+  if (isNaN(value) || isNaN(min) || isNaN(max) || !isFinite(value) || !isFinite(min) || !isFinite(max))
+    return NaN;
+  if (value >= min && value <= max)
+    return value;
+  const range = max - min + 1;
+  const wrappedValue = ((value - min) % range + range) % range + min;
+  return wrappedValue;
+}
+function randRange(...args) {
+  let min, max, enhancedEntropy = false;
+  if (typeof args[0] === "number" && typeof args[1] === "number")
+    [min, max] = args;
+  else if (typeof args[0] === "number" && typeof args[1] !== "number") {
+    min = 0;
+    [max] = args;
+  } else
+    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")
+    enhancedEntropy = args[1];
+  min = Number(min);
+  max = Number(max);
+  if (isNaN(min) || isNaN(max))
+    return NaN;
+  if (min > max)
+    throw new TypeError(`Parameter "min" can't be bigger than "max"`);
+  if (enhancedEntropy) {
+    const uintArr = new Uint8Array(1);
+    crypto.getRandomValues(uintArr);
+    return Number(Array.from(
+      uintArr,
+      (v) => Math.round(mapRange(v, 0, 255, min, max)).toString(10)
+    ).join(""));
+  } else
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+function roundFixed(num, fractionDigits) {
+  const scale = 10 ** fractionDigits;
+  return Math.round(num * scale) / scale;
+}
+function valsWithin(a, b, dec = 1, withinRange = 0.5) {
+  return Math.abs(roundFixed(a, dec) - roundFixed(b, dec)) <= withinRange;
+}
+function randomItem(array) {
+  return randomItemIndex(array)[0];
+}
+function randomItemIndex(array) {
+  if (array.length === 0)
+    return [void 0, void 0];
+  const idx = randRange(array.length - 1);
+  return [array[idx], idx];
+}
+function randomizeArray(array) {
+  const retArray = [...array];
+  if (array.length === 0)
+    return retArray;
+  for (let i = retArray.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [retArray[i], retArray[j]] = [retArray[j], retArray[i]];
+  }
+  return retArray;
+}
+function takeRandomItem(arr) {
+  var _a;
+  return (_a = takeRandomItemIndex(arr)) == null ? void 0 : _a[0];
+}
+function takeRandomItemIndex(arr) {
+  const [itm, idx] = randomItemIndex(arr);
+  if (idx === void 0)
+    return [void 0, void 0];
+  arr.splice(idx, 1);
+  return [itm, idx];
+}
+function darkenColor(color, percent, upperCase = false) {
+  var _a;
+  color = color.trim();
+  const darkenRgb = (r2, g2, b2, percent2) => {
+    r2 = Math.max(0, Math.min(255, r2 - r2 * percent2 / 100));
+    g2 = Math.max(0, Math.min(255, g2 - g2 * percent2 / 100));
+    b2 = Math.max(0, Math.min(255, b2 - b2 * percent2 / 100));
+    return [r2, g2, b2];
   };
-  async function ge(r) {
-    return await (typeof r == "function" ? r() : r);
+  let r, g, b, a;
+  const isHexCol = color.match(/^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{4}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$/);
+  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);
+    if (!rgbValues)
+      throw new TypeError("Invalid RGB/RGBA color format");
+    [r, g, b, a] = rgbValues;
+  } else
+    throw new TypeError("Unsupported color format");
+  [r, g, b] = darkenRgb(r, g, b, percent);
+  if (isHexCol)
+    return rgbToHex(r, g, b, a, color.startsWith("#"), upperCase);
+  else if (color.startsWith("rgba"))
+    return `rgba(${r}, ${g}, ${b}, ${a ?? NaN})`;
+  else
+    return `rgb(${r}, ${g}, ${b})`;
+}
+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;
+  if (!isNaN(Number(a)))
+    hex = hex.slice(0, -(hex.length / 4));
+  if (hex.length === 3 || hex.length === 4)
+    hex = hex.split("").map((c) => c + c).join("");
+  const hexInt = parseInt(hex, 16);
+  const r = hexInt >> 16 & 255;
+  const g = hexInt >> 8 & 255;
+  const b = hexInt & 255;
+  return [clamp(r, 0, 255), clamp(g, 0, 255), clamp(b, 0, 255), typeof a === "number" ? clamp(a, 0, 1) : void 0];
+}
+function lightenColor(color, percent, upperCase = false) {
+  return darkenColor(color, percent * -1, upperCase);
+}
+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"]();
+  return `${withHash ? "#" : ""}${toHexVal(red)}${toHexVal(green)}${toHexVal(blue)}${alpha ? toHexVal(alpha * 255) : ""}`;
+}
+function abtoa(buf) {
+  return btoa(
+    new Uint8Array(buf).reduce((data, byte) => data + String.fromCharCode(byte), "")
+  );
+}
+function atoab(str) {
+  return Uint8Array.from(atob(str), (c) => c.charCodeAt(0));
+}
+async function compress(input, compressionFormat, outputType = "string") {
+  const byteArray = input instanceof Uint8Array ? input : new TextEncoder().encode((input == null ? void 0 : input.toString()) ?? String(input));
+  const comp = new CompressionStream(compressionFormat);
+  const writer = comp.writable.getWriter();
+  writer.write(byteArray);
+  writer.close();
+  const uintArr = new Uint8Array(await new Response(comp.readable).arrayBuffer());
+  return outputType === "arrayBuffer" ? uintArr : abtoa(uintArr);
+}
+async function decompress(input, compressionFormat, outputType = "string") {
+  const byteArray = input instanceof Uint8Array ? input : atoab((input == null ? void 0 : input.toString()) ?? String(input));
+  const decomp = new DecompressionStream(compressionFormat);
+  const writer = decomp.writable.getWriter();
+  writer.write(byteArray);
+  writer.close();
+  const uintArr = new Uint8Array(await new Response(decomp.readable).arrayBuffer());
+  return outputType === "arrayBuffer" ? uintArr : new TextDecoder().decode(uintArr);
+}
+async function computeHash(input, algorithm = "SHA-256") {
+  let data;
+  if (typeof input === "string") {
+    const encoder = new TextEncoder();
+    data = encoder.encode(input);
+  } else
+    data = input;
+  const hashBuffer = await crypto.subtle.digest(algorithm, data);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  const hashHex = hashArray.map((byte) => byte.toString(16).padStart(2, "0")).join("");
+  return hashHex;
+}
+function randomId(length = 16, radix = 16, enhancedEntropy = false, randomCase = true) {
+  if (length < 1)
+    throw new RangeError("The length argument must be at least 1");
+  if (radix < 2 || radix > 36)
+    throw new RangeError("The radix argument must be between 2 and 36");
+  let arr = [];
+  const caseArr = randomCase ? [0, 1] : [0];
+  if (enhancedEntropy) {
+    const uintArr = new Uint8Array(length);
+    crypto.getRandomValues(uintArr);
+    arr = Array.from(
+      uintArr,
+      (v) => mapRange(v, 0, 255, 0, radix).toString(radix).substring(0, 1)
+    );
+  } else {
+    arr = Array.from(
+      { length },
+      () => Math.floor(Math.random() * radix).toString(radix)
+    );
+  }
+  if (!arr.some((v) => /[a-zA-Z]/.test(v)))
+    return arr.join("");
+  return arr.map((v) => caseArr[randRange(0, caseArr.length - 1, enhancedEntropy)] === 1 ? v.toUpperCase() : v).join("");
+}
+var DatedError = class extends Error {
+  date;
+  constructor(message, options) {
+    super(message, options);
+    this.name = this.constructor.name;
+    this.date = /* @__PURE__ */ new Date();
   }
-  async function be(r) {
-    return typeof r == "string" ? r : String(typeof r == "function" ? await r() : r);
+};
+var ChecksumMismatchError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "ChecksumMismatchError";
   }
-  async function ye(r, e = {}) {
-    let { timeout: t = 1e4, signal: i, ...n } = e, o = new AbortController();
-    i == null || i.addEventListener("abort", () => o.abort());
-    let a = {}, s;
-    t >= 0 && (s = setTimeout(() => o.abort(), t), a = { signal: o.signal });
-    try {
-      let u = await fetch(r, { ...n, ...a });
-      return typeof s < "u" && clearTimeout(s), u;
-    } catch (u) {
-      throw typeof s < "u" && clearTimeout(s), new x("Error while calling fetch", { cause: u });
-    }
+};
+var CustomError = class extends DatedError {
+  constructor(name, message, options) {
+    super(message, options);
+    this.name = name;
   }
-  function De(r, e = true) {
-    return "length" in r ? r.length : "size" in r ? r.size : "count" in r ? r.count : e ? 0 : NaN;
+};
+var MigrationError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "MigrationError";
   }
-  function Te(r, e, t = false) {
-    return new Promise((i, n) => {
-      let o = setTimeout(() => i(), r);
-      e == null || e.addEventListener("abort", () => {
-        clearTimeout(o), t ? n(new v("AbortError", "The pause was aborted")) : i();
-      });
-    });
+};
+var ValidationError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "ValidationError";
   }
-  function Se(r) {
-    return Object.assign(/* @__PURE__ */ Object.create(null), r ?? {});
+};
+var ScriptContextError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "ScriptContextError";
   }
-  function ve(r, e, t) {
-    let i, n = () => clearInterval(i), o = () => {
-      if (t != null && t.aborted) return n();
-      r();
-    };
-    t == null || t.addEventListener("abort", n), o(), i = setInterval(o, e);
+};
+var NetworkError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "NetworkError";
   }
-  function we(r, e, t) {
-    let i, n = () => clearTimeout(i), o = async () => {
-      if (t != null && t.aborted) return n();
-      await r(), i = setTimeout(o, e);
-    };
-    t == null || t.addEventListener("abort", n), o();
-  }
-  function xe(r = 0, e = 0) {
-    if (e < 0) throw new TypeError("Timeout must be a non-negative number");
-    let t;
-    if (typeof process < "u" && "exit" in process && typeof process.exit == "function") t = () => process.exit(r);
-    else if (typeof Deno < "u" && "exit" in Deno && typeof Deno.exit == "function") t = () => Deno.exit(r);
-    else throw new g("Cannot exit the process, no exit method available");
-    setTimeout(t, e);
-  }
-  function Ee(r, e = 1 / 0) {
-    if (typeof e != "number" || isNaN(e) || e < 0) throw new TypeError("lines parameter must be a non-negative number");
-    try {
-      throw new Error("This is to capture a stack trace with CoreUtils.getCallStack(). (If you see this somewhere, you can safely ignore it.)");
-    } catch (t) {
-      let i = (t.stack ?? "").split(`
-`).map((n) => n.trim()).slice(2, e + 2);
-      return r !== false ? i : i.join(`
-`);
-    }
+};
+async function consumeGen(valGen) {
+  return await (typeof valGen === "function" ? valGen() : valGen);
+}
+async function consumeStringGen(strGen) {
+  return typeof strGen === "string" ? strGen : String(
+    typeof strGen === "function" ? await strGen() : strGen
+  );
+}
+async function fetchAdvanced(input, options = {}) {
+  const { timeout = 1e4, signal, ...restOpts } = options;
+  const ctl = new AbortController();
+  signal == null ? void 0 : signal.addEventListener("abort", () => ctl.abort());
+  let sigOpts = {}, id = void 0;
+  if (timeout >= 0) {
+    id = setTimeout(() => ctl.abort(), timeout);
+    sigOpts = { signal: ctl.signal };
   }
-  function Pe(r, e, t = "auto") {
-    switch (typeof e != "number" && ("length" in e ? e = e.length : "size" in e ? e = e.size : "count" in e && (e = e.count)), ["-s", "-ies"].includes(t) || (t = "auto"), isNaN(e) && (e = 2), t === "auto" ? String(r).endsWith("y") ? "-ies" : "-s" : t) {
-      case "-s":
-        return `${r}${e === 1 ? "" : "s"}`;
-      case "-ies":
-        return `${String(r).slice(0, -1)}${e === 1 ? "y" : "ies"}`;
-    }
+  try {
+    const res = await fetch(input, {
+      ...restOpts,
+      ...sigOpts
+    });
+    typeof id !== "undefined" && clearTimeout(id);
+    return res;
+  } catch (err) {
+    typeof id !== "undefined" && clearTimeout(id);
+    throw new NetworkError("Error while calling fetch", { cause: err });
   }
-  function Oe(r) {
-    return r.charAt(0).toUpperCase() + r.slice(1);
-  }
-  var Q = { 100: "\u2588", 75: "\u2593", 50: "\u2592", 25: "\u2591", 0: "\u2500" };
-  function Fe(r, e, t = Q) {
-    if (r === 100) return t[100].repeat(e);
-    let i = Math.floor(r / 100 * e), n = r / 10 * e - i, o = "";
-    n >= 0.75 ? o = t[75] : n >= 0.5 ? o = t[50] : n >= 0.25 && (o = t[25]);
-    let a = t[100].repeat(i), s = t[0].repeat(e - i - (o ? 1 : 0));
-    return `${a}${o}${s}`;
-  }
-  function Ve(r, ...e) {
-    return r.replace(/%\d/gm, (t) => {
-      var n;
-      let i = Number(t.substring(1)) - 1;
-      return (n = e[i] ?? t) == null ? void 0 : n.toString();
+}
+function getListLength(listLike, zeroOnInvalid = true) {
+  return "length" in listLike ? listLike.length : "size" in listLike ? listLike.size : "count" in listLike ? listLike.count : zeroOnInvalid ? 0 : NaN;
+}
+function pauseFor(time, signal, rejectOnAbort = false) {
+  return new Promise((res, rej) => {
+    const timeout = setTimeout(() => res(), time);
+    signal == null ? void 0 : signal.addEventListener("abort", () => {
+      clearTimeout(timeout);
+      rejectOnAbort ? rej(new CustomError("AbortError", "The pause was aborted")) : res();
     });
+  });
+}
+function pureObj(obj) {
+  return Object.assign(/* @__PURE__ */ Object.create(null), obj ?? {});
+}
+function setImmediateInterval(callback, interval, signal) {
+  let intervalId;
+  const cleanup = () => clearInterval(intervalId);
+  const loop = () => {
+    if (signal == null ? void 0 : signal.aborted)
+      return cleanup();
+    callback();
+  };
+  signal == null ? void 0 : signal.addEventListener("abort", cleanup);
+  loop();
+  intervalId = setInterval(loop, interval);
+}
+function setImmediateTimeoutLoop(callback, interval, signal) {
+  let timeout;
+  const cleanup = () => clearTimeout(timeout);
+  const loop = async () => {
+    if (signal == null ? void 0 : signal.aborted)
+      return cleanup();
+    await callback();
+    timeout = setTimeout(loop, interval);
+  };
+  signal == null ? void 0 : signal.addEventListener("abort", cleanup);
+  loop();
+}
+function scheduleExit(code = 0, timeout = 0) {
+  if (timeout < 0)
+    throw new TypeError("Timeout must be a non-negative number");
+  let exit;
+  if (typeof process !== "undefined" && "exit" in process && typeof process.exit === "function")
+    exit = () => process.exit(code);
+  else if (typeof Deno !== "undefined" && "exit" in Deno && typeof Deno.exit === "function")
+    exit = () => Deno.exit(code);
+  else
+    throw new ScriptContextError("Cannot exit the process, no exit method available");
+  setTimeout(exit, timeout);
+}
+function getCallStack(asArray, lines = Infinity) {
+  if (typeof lines !== "number" || isNaN(lines) || lines < 0)
+    throw new TypeError("lines parameter must be a non-negative number");
+  try {
+    throw new Error("This is to capture a stack trace with CoreUtils.getCallStack(). (If you see this somewhere, you can safely ignore it.)");
+  } catch (err) {
+    const stack = (err.stack ?? "").split("\n").map((line) => line.trim()).slice(2, lines + 2);
+    return asArray !== false ? stack : stack.join("\n");
   }
-  function Ne(r, e = ", ", t = " and ") {
-    let i = [...r];
-    if (i.length === 0) return "";
-    if (i.length === 1) return String(i[0]);
-    if (i.length === 2) return i.join(t);
-    let n = t + i[i.length - 1];
-    return i.pop(), i.join(e) + n;
-  }
-  function Ae(r) {
-    let e = r < 0, t = Math.abs(r);
-    if (isNaN(t) || !isFinite(t)) throw new TypeError("The seconds argument must be a valid number");
-    let i = Math.floor(t / 3600), n = Math.floor(t % 3600 / 60), o = Math.floor(t % 60);
-    return (e ? "-" : "") + [i ? i + ":" : "", String(n).padStart(n > 0 || i > 0 ? 2 : 1, "0"), ":", String(o).padStart(o > 0 || n > 0 || i > 0 || r === 0 ? 2 : 1, "0")].join("");
-  }
-  function Me(r, e, t = "...") {
-    let i = (r == null ? void 0 : r.toString()) ?? String(r), n = i.length > e ? i.substring(0, e - t.length) + t : i;
-    return n.length > e ? n.substring(0, e) : n;
-  }
-  var G = 1, z = class {
-    id;
-    formatVersion;
-    defaultData;
-    encodeData;
-    decodeData;
-    compressionFormat = "deflate-raw";
-    memoryCache = true;
-    engine;
-    options;
-    firstInit = true;
-    cachedData;
-    migrations;
-    migrateIds = [];
-    constructor(e) {
-      var t;
-      if (this.id = e.id, this.formatVersion = e.formatVersion, this.defaultData = e.defaultData, this.memoryCache = !!(e.memoryCache ?? true), this.cachedData = this.memoryCache ? e.defaultData : {}, this.migrations = e.migrations, e.migrateIds && (this.migrateIds = Array.isArray(e.migrateIds) ? e.migrateIds : [e.migrateIds]), this.encodeData = e.encodeData, this.decodeData = e.decodeData, this.engine = typeof e.engine == "function" ? e.engine() : e.engine, this.options = e, typeof e.compressionFormat > "u" && (this.compressionFormat = e.compressionFormat = ((t = e.encodeData) == null ? void 0 : t[0]) ?? "deflate-raw"), typeof e.compressionFormat == "string") this.encodeData = [e.compressionFormat, async (i) => await N(i, e.compressionFormat, "string")], this.decodeData = [e.compressionFormat, async (i) => await N(i, e.compressionFormat, "string")];
-      else if ("encodeData" in e && "decodeData" in e && Array.isArray(e.encodeData) && Array.isArray(e.decodeData)) this.encodeData = [e.encodeData[0], e.encodeData[1]], this.decodeData = [e.decodeData[0], e.decodeData[1]], this.compressionFormat = e.encodeData[0] ?? null;
-      else if (e.compressionFormat === null) this.encodeData = void 0, this.decodeData = void 0, this.compressionFormat = null;
-      else throw new TypeError("Either `compressionFormat` or `encodeData` and `decodeData` have to be set and valid, but not all three at a time. Please refer to the documentation for more info.");
-      this.engine.setDataStoreOptions(e);
-    }
-    async loadData() {
-      try {
-        if (this.firstInit) {
-          this.firstInit = false;
-          let u = Number(await this.engine.getValue("__ds_fmt_ver", 0)), l = await this.engine.getValue(`_uucfg-${this.id}`, null);
-          if (l) {
-            let c = Number(await this.engine.getValue(`_uucfgver-${this.id}`, NaN)), p = await this.engine.getValue(`_uucfgenc-${this.id}`, null), m = [], b = (O, h, y) => {
-              m.push(this.engine.setValue(h, y)), m.push(this.engine.deleteValue(O));
-            };
-            b(`_uucfg-${this.id}`, `__ds-${this.id}-dat`, l), isNaN(c) || b(`_uucfgver-${this.id}`, `__ds-${this.id}-ver`, c), typeof p == "boolean" ? b(`_uucfgenc-${this.id}`, `__ds-${this.id}-enf`, p === true ? this.compressionFormat ?? null : null) : (m.push(this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat)), m.push(this.engine.deleteValue(`_uucfgenc-${this.id}`))), await Promise.allSettled(m);
+}
+function autoPlural(term, num, pluralType = "auto") {
+  if (typeof num !== "number") {
+    if ("length" in num)
+      num = num.length;
+    else if ("size" in num)
+      num = num.size;
+    else if ("count" in num)
+      num = num.count;
+  }
+  if (!["-s", "-ies"].includes(pluralType))
+    pluralType = "auto";
+  if (isNaN(num))
+    num = 2;
+  const pType = pluralType === "auto" ? String(term).endsWith("y") ? "-ies" : "-s" : pluralType;
+  switch (pType) {
+    case "-s":
+      return `${term}${num === 1 ? "" : "s"}`;
+    case "-ies":
+      return `${String(term).slice(0, -1)}${num === 1 ? "y" : "ies"}`;
+  }
+}
+function capitalize(text) {
+  return text.charAt(0).toUpperCase() + text.slice(1);
+}
+var defaultPbChars = {
+  100: "\u2588",
+  75: "\u2593",
+  50: "\u2592",
+  25: "\u2591",
+  0: "\u2500"
+};
+function createProgressBar(percentage, barLength, chars = defaultPbChars) {
+  if (percentage === 100)
+    return chars[100].repeat(barLength);
+  const filledLength = Math.floor(percentage / 100 * barLength);
+  const remainingPercentage = percentage / 10 * barLength - filledLength;
+  let lastBlock = "";
+  if (remainingPercentage >= 0.75)
+    lastBlock = chars[75];
+  else if (remainingPercentage >= 0.5)
+    lastBlock = chars[50];
+  else if (remainingPercentage >= 0.25)
+    lastBlock = chars[25];
+  const filledBar = chars[100].repeat(filledLength);
+  const emptyBar = chars[0].repeat(barLength - filledLength - (lastBlock ? 1 : 0));
+  return `${filledBar}${lastBlock}${emptyBar}`;
+}
+function insertValues(input, ...values) {
+  return input.replace(/%\d/gm, (match) => {
+    var _a;
+    const argIndex = Number(match.substring(1)) - 1;
+    return (_a = values[argIndex] ?? match) == null ? void 0 : _a.toString();
+  });
+}
+function joinArrayReadable(array, separators = ", ", lastSeparator = " and ") {
+  const arr = [...array];
+  if (arr.length === 0)
+    return "";
+  else if (arr.length === 1)
+    return String(arr[0]);
+  else if (arr.length === 2)
+    return arr.join(lastSeparator);
+  const lastItm = lastSeparator + arr[arr.length - 1];
+  arr.pop();
+  return arr.join(separators) + lastItm;
+}
+function secsToTimeStr(seconds) {
+  const isNegative = seconds < 0;
+  const s = Math.abs(seconds);
+  if (isNaN(s) || !isFinite(s))
+    throw new TypeError("The seconds argument must be a valid number");
+  const hrs = Math.floor(s / 3600);
+  const mins = Math.floor(s % 3600 / 60);
+  const secs = Math.floor(s % 60);
+  return (isNegative ? "-" : "") + [
+    hrs ? hrs + ":" : "",
+    String(mins).padStart(mins > 0 || hrs > 0 ? 2 : 1, "0"),
+    ":",
+    String(secs).padStart(secs > 0 || mins > 0 || hrs > 0 || seconds === 0 ? 2 : 1, "0")
+  ].join("");
+}
+function truncStr(input, length, endStr = "...") {
+  const str = (input == null ? void 0 : input.toString()) ?? String(input);
+  const finalStr = str.length > length ? str.substring(0, length - endStr.length) + endStr : str;
+  return finalStr.length > length ? finalStr.substring(0, length) : finalStr;
+}
+var dsFmtVer = 1;
+var DataStore = class {
+  id;
+  formatVersion;
+  defaultData;
+  encodeData;
+  decodeData;
+  compressionFormat = "deflate-raw";
+  memoryCache = true;
+  engine;
+  options;
+  /**
+   * Whether all first-init checks should be done.  
+   * This includes migrating the internal DataStore format, migrating data from the UserUtils format, and anything similar.  
+   * This is set to `true` by default. Create a subclass and set it to `false` before calling {@linkcode loadData()} if you want to explicitly skip these checks.
+   */
+  firstInit = true;
+  /** In-memory cached copy of the data that is saved in persistent storage used for synchronous read access. */
+  cachedData;
+  migrations;
+  migrateIds = [];
+  //#region constructor
+  /**
+   * 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.  
+   *   
+   * - ⚠️ 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 opts The options for this DataStore instance
+   */
+  constructor(opts) {
+    var _a;
+    this.id = opts.id;
+    this.formatVersion = opts.formatVersion;
+    this.defaultData = opts.defaultData;
+    this.memoryCache = Boolean(opts.memoryCache ?? true);
+    this.cachedData = this.memoryCache ? opts.defaultData : {};
+    this.migrations = opts.migrations;
+    if (opts.migrateIds)
+      this.migrateIds = Array.isArray(opts.migrateIds) ? opts.migrateIds : [opts.migrateIds];
+    this.encodeData = opts.encodeData;
+    this.decodeData = opts.decodeData;
+    this.engine = typeof opts.engine === "function" ? opts.engine() : opts.engine;
+    this.options = opts;
+    if (typeof opts.compressionFormat === "undefined")
+      this.compressionFormat = opts.compressionFormat = ((_a = opts.encodeData) == null ? void 0 : _a[0]) ?? "deflate-raw";
+    if (typeof opts.compressionFormat === "string") {
+      this.encodeData = [opts.compressionFormat, async (data) => await compress(data, opts.compressionFormat, "string")];
+      this.decodeData = [opts.compressionFormat, async (data) => await compress(data, opts.compressionFormat, "string")];
+    } else if ("encodeData" in opts && "decodeData" in opts && Array.isArray(opts.encodeData) && Array.isArray(opts.decodeData)) {
+      this.encodeData = [opts.encodeData[0], opts.encodeData[1]];
+      this.decodeData = [opts.decodeData[0], opts.decodeData[1]];
+      this.compressionFormat = opts.encodeData[0] ?? null;
+    } else if (opts.compressionFormat === null) {
+      this.encodeData = void 0;
+      this.decodeData = void 0;
+      this.compressionFormat = null;
+    } else
+      throw new TypeError("Either `compressionFormat` or `encodeData` and `decodeData` have to be set and valid, but not all three at a time. Please refer to the documentation for more info.");
+    this.engine.setDataStoreOptions(opts);
+  }
+  //#region loadData
+  /**
+   * Loads the data saved in persistent storage into the in-memory cache and also returns a copy of it.  
+   * Automatically populates persistent storage with default data if it doesn't contain any data yet.  
+   * Also runs all necessary migration functions if the data format has changed since the last time the data was saved.
+   */
+  async loadData() {
+    try {
+      if (this.firstInit) {
+        this.firstInit = false;
+        const dsVer = Number(await this.engine.getValue("__ds_fmt_ver", 0));
+        const oldData = await this.engine.getValue(`_uucfg-${this.id}`, null);
+        if (oldData) {
+          const oldVer = Number(await this.engine.getValue(`_uucfgver-${this.id}`, NaN));
+          const oldEnc = await this.engine.getValue(`_uucfgenc-${this.id}`, null);
+          const promises = [];
+          const migrateFmt = (oldKey, newKey, value) => {
+            promises.push(this.engine.setValue(newKey, value));
+            promises.push(this.engine.deleteValue(oldKey));
+          };
+          migrateFmt(`_uucfg-${this.id}`, `__ds-${this.id}-dat`, oldData);
+          if (!isNaN(oldVer))
+            migrateFmt(`_uucfgver-${this.id}`, `__ds-${this.id}-ver`, oldVer);
+          if (typeof oldEnc === "boolean")
+            migrateFmt(`_uucfgenc-${this.id}`, `__ds-${this.id}-enf`, oldEnc === true ? this.compressionFormat ?? null : null);
+          else {
+            promises.push(this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat));
+            promises.push(this.engine.deleteValue(`_uucfgenc-${this.id}`));
           }
-          (isNaN(u) || u < G) && await this.engine.setValue("__ds_fmt_ver", G);
-        }
-        this.migrateIds.length > 0 && (await this.migrateId(this.migrateIds), this.migrateIds = []);
-        let e = await this.engine.getValue(`__ds-${this.id}-dat`, null), t = Number(await this.engine.getValue(`__ds-${this.id}-ver`, NaN));
-        if (typeof e != "string") return await this.saveDefaultData(), this.engine.deepCopy(this.defaultData);
-        let i = e ?? JSON.stringify(this.defaultData), n = String(await this.engine.getValue(`__ds-${this.id}-enf`, null)), o = n !== "null" && n !== "false", a = false;
-        isNaN(t) && (await this.engine.setValue(`__ds-${this.id}-ver`, t = this.formatVersion), a = true);
-        let s = await this.engine.deserializeData(i, o);
-        return t < this.formatVersion && this.migrations && (s = await this.runMigrations(s, t)), a && await this.setData(s), this.memoryCache ? this.cachedData = this.engine.deepCopy(s) : this.engine.deepCopy(s);
-      } catch (e) {
-        return console.warn("Error while parsing JSON data, resetting it to the default value.", e), await this.saveDefaultData(), this.defaultData;
-      }
-    }
-    getData() {
-      if (!this.memoryCache) throw new d("In-memory cache is disabled for this DataStore instance, so getData() can't be used. Please use loadData() instead.");
-      return this.engine.deepCopy(this.cachedData);
-    }
-    setData(e) {
-      return this.memoryCache && (this.cachedData = e), new Promise(async (t) => {
-        await Promise.allSettled([this.engine.setValue(`__ds-${this.id}-dat`, await this.engine.serializeData(e, this.encodingEnabled())), this.engine.setValue(`__ds-${this.id}-ver`, this.formatVersion), this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat)]), t();
-      });
-    }
-    async saveDefaultData() {
-      this.memoryCache && (this.cachedData = this.defaultData), await Promise.allSettled([this.engine.setValue(`__ds-${this.id}-dat`, await this.engine.serializeData(this.defaultData, this.encodingEnabled())), this.engine.setValue(`__ds-${this.id}-ver`, this.formatVersion), this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat)]);
-    }
-    async deleteData() {
-      var e, t;
-      await Promise.allSettled([this.engine.deleteValue(`__ds-${this.id}-dat`), this.engine.deleteValue(`__ds-${this.id}-ver`), this.engine.deleteValue(`__ds-${this.id}-enf`)]), await ((t = (e = this.engine).deleteStorage) == null ? void 0 : t.call(e));
-    }
-    encodingEnabled() {
-      return !!(this.encodeData && this.decodeData) && this.compressionFormat !== null || !!this.compressionFormat;
-    }
-    async runMigrations(e, t, i = true) {
-      if (!this.migrations) return e;
-      let n = e, o = Object.entries(this.migrations).sort(([s], [u]) => Number(s) - Number(u)), a = t;
-      for (let [s, u] of o) {
-        let l = Number(s);
-        if (t < this.formatVersion && t < l) try {
-          let c = u(n);
-          n = c instanceof Promise ? await c : c, a = t = l;
-        } catch (c) {
-          if (!i) throw new w(`Error while running migration function for format version '${s}'`, { cause: c });
-          return await this.saveDefaultData(), this.getData();
+          await Promise.allSettled(promises);
         }
+        if (isNaN(dsVer) || dsVer < dsFmtVer)
+          await this.engine.setValue("__ds_fmt_ver", dsFmtVer);
       }
-      return await Promise.allSettled([this.engine.setValue(`__ds-${this.id}-dat`, await this.engine.serializeData(n)), this.engine.setValue(`__ds-${this.id}-ver`, a), this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat)]), this.memoryCache ? this.cachedData = this.engine.deepCopy(n) : this.engine.deepCopy(n);
-    }
-    async migrateId(e) {
-      let t = Array.isArray(e) ? e : [e];
-      await Promise.all(t.map(async (i) => {
-        let [n, o, a] = await (async () => {
-          let [u, l, c] = await Promise.all([this.engine.getValue(`__ds-${i}-dat`, JSON.stringify(this.defaultData)), this.engine.getValue(`__ds-${i}-ver`, NaN), this.engine.getValue(`__ds-${i}-enf`, null)]);
-          return [u, Number(l), !!c && String(c) !== "null"];
-        })();
-        if (n === void 0 || isNaN(o)) return;
-        let s = await this.engine.deserializeData(n, a);
-        await Promise.allSettled([this.engine.setValue(`__ds-${this.id}-dat`, await this.engine.serializeData(s)), this.engine.setValue(`__ds-${this.id}-ver`, o), this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat), this.engine.deleteValue(`__ds-${i}-dat`), this.engine.deleteValue(`__ds-${i}-ver`), this.engine.deleteValue(`__ds-${i}-enf`)]);
-      }));
-    }
-  };
-  var E = class {
-    dataStoreOptions;
-    constructor(e) {
-      e && (this.dataStoreOptions = e);
-    }
-    setDataStoreOptions(e) {
-      this.dataStoreOptions = e;
-    }
-    async serializeData(e, t) {
-      var o, a, s, u, l;
-      this.ensureDataStoreOptions();
-      let i = JSON.stringify(e);
-      if (!t || !((o = this.dataStoreOptions) != null && o.encodeData) || !((a = this.dataStoreOptions) != null && a.decodeData)) return i;
-      let n = (l = (u = (s = this.dataStoreOptions) == null ? void 0 : s.encodeData) == null ? void 0 : u[1]) == null ? void 0 : l.call(u, i);
-      return n instanceof Promise ? await n : n;
-    }
-    async deserializeData(e, t) {
-      var n, o, a;
-      this.ensureDataStoreOptions();
-      let i = (n = this.dataStoreOptions) != null && n.decodeData && t ? (a = (o = this.dataStoreOptions.decodeData) == null ? void 0 : o[1]) == null ? void 0 : a.call(o, e) : void 0;
-      return i instanceof Promise && (i = await i), JSON.parse(i ?? e);
-    }
-    ensureDataStoreOptions() {
-      if (!this.dataStoreOptions) throw new d("DataStoreEngine must be initialized with DataStore options before use. If you are using this instance standalone, set them in the constructor or call `setDataStoreOptions()` with the DataStore options.");
-      if (!this.dataStoreOptions.id) throw new d("DataStoreEngine must be initialized with a valid DataStore ID");
-    }
-    deepCopy(e) {
-      try {
-        if ("structuredClone" in globalThis) return structuredClone(e);
-      } catch {
-      }
-      return JSON.parse(JSON.stringify(e));
-    }
-  }, U = class extends E {
-    options;
-    constructor(e) {
-      super(e == null ? void 0 : e.dataStoreOptions), this.options = { type: "localStorage", ...e };
-    }
-    async getValue(e, t) {
-      let i = this.options.type === "localStorage" ? globalThis.localStorage.getItem(e) : globalThis.sessionStorage.getItem(e);
-      return typeof i > "u" ? t : i;
-    }
-    async setValue(e, t) {
-      this.options.type === "localStorage" ? globalThis.localStorage.setItem(e, String(t)) : globalThis.sessionStorage.setItem(e, String(t));
-    }
-    async deleteValue(e) {
-      this.options.type === "localStorage" ? globalThis.localStorage.removeItem(e) : globalThis.sessionStorage.removeItem(e);
-    }
-  }, f, R = class extends E {
-    options;
-    fileAccessQueue = Promise.resolve();
-    constructor(e) {
-      super(e == null ? void 0 : e.dataStoreOptions), this.options = { filePath: (t) => `.ds-${t}`, ...e };
-    }
-    async readFile() {
-      var e, t, i, n;
-      this.ensureDataStoreOptions();
-      try {
-        if (f || (f = (e = await import("fs/promises")) == null ? void 0 : e.default), !f) throw new g("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new d("'node:fs/promises' module not available") });
-        let o = typeof this.options.filePath == "string" ? this.options.filePath : this.options.filePath(this.dataStoreOptions.id), a = await f.readFile(o, "utf-8");
-        return a ? JSON.parse(await ((n = (i = (t = this.dataStoreOptions) == null ? void 0 : t.decodeData) == null ? void 0 : i[1]) == null ? void 0 : n.call(i, a)) ?? a) : void 0;
-      } catch {
-        return;
-      }
-    }
-    async writeFile(e) {
-      var t, i, n, o;
-      this.ensureDataStoreOptions();
-      try {
-        if (f || (f = (t = await import("fs/promises")) == null ? void 0 : t.default), !f) throw new g("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new d("'node:fs/promises' module not available") });
-        let a = typeof this.options.filePath == "string" ? this.options.filePath : this.options.filePath(this.dataStoreOptions.id);
-        await f.mkdir(a.slice(0, a.lastIndexOf(a.includes("/") ? "/" : "\\")), { recursive: true }), await f.writeFile(a, await ((o = (n = (i = this.dataStoreOptions) == null ? void 0 : i.encodeData) == null ? void 0 : n[1]) == null ? void 0 : o.call(n, JSON.stringify(e))) ?? JSON.stringify(e, void 0, 2), "utf-8");
-      } catch (a) {
-        console.error("Error writing file:", a);
+      if (this.migrateIds.length > 0) {
+        await this.migrateId(this.migrateIds);
+        this.migrateIds = [];
       }
-    }
-    async getValue(e, t) {
-      let i = await this.readFile();
-      if (!i) return t;
-      let n = i == null ? void 0 : i[e];
-      return typeof n > "u" ? t : n;
-    }
-    async setValue(e, t) {
-      this.fileAccessQueue = this.fileAccessQueue.then(async () => {
-        let i = await this.readFile();
-        i || (i = {}), i[e] = t, await this.writeFile(i);
-      }).catch((i) => {
-        throw console.error("Error in setValue:", i), i;
-      }), await this.fileAccessQueue.catch(() => {
-      });
-    }
-    async deleteValue(e) {
-      this.fileAccessQueue = this.fileAccessQueue.then(async () => {
-        let t = await this.readFile();
-        t && (delete t[e], await this.writeFile(t));
-      }).catch((t) => {
-        throw console.error("Error in deleteValue:", t), t;
-      }), await this.fileAccessQueue.catch(() => {
-      });
-    }
-    async deleteStorage() {
-      var e;
-      this.ensureDataStoreOptions();
-      try {
-        if (f || (f = (e = await import("fs/promises")) == null ? void 0 : e.default), !f) throw new g("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new d("'node:fs/promises' module not available") });
-        let t = typeof this.options.filePath == "string" ? this.options.filePath : this.options.filePath(this.dataStoreOptions.id);
-        return await f.unlink(t);
-      } catch (t) {
-        console.error("Error deleting file:", t);
+      const storedDataRaw = await this.engine.getValue(`__ds-${this.id}-dat`, null);
+      let storedFmtVer = Number(await this.engine.getValue(`__ds-${this.id}-ver`, NaN));
+      if (typeof storedDataRaw !== "string") {
+        await this.saveDefaultData();
+        return this.engine.deepCopy(this.defaultData);
       }
-    }
-  };
-  var j = class r {
-    stores;
-    options;
-    constructor(e, t = {}) {
-      if (!crypto || !crypto.subtle) throw new g("DataStoreSerializer has to run in a secure context (HTTPS) or in another environment that implements the subtleCrypto API!");
-      this.stores = e, this.options = { addChecksum: true, ensureIntegrity: true, remapIds: {}, ...t };
-    }
-    async calcChecksum(e) {
-      return k(e, "SHA-256");
-    }
-    async serializePartial(e, t = true, i = true) {
-      var a;
-      let n = [], o = this.stores.filter((s) => typeof e == "function" ? e(s.id) : e.includes(s.id));
-      for (let s of o) {
-        let u = !!(t && s.encodingEnabled() && ((a = s.encodeData) != null && a[1])), l = s.memoryCache ? s.getData() : await s.loadData(), c = u ? await s.encodeData[1](JSON.stringify(l)) : JSON.stringify(l);
-        n.push({ id: s.id, data: c, formatVersion: s.formatVersion, encoded: u, checksum: this.options.addChecksum ? await this.calcChecksum(c) : void 0 });
+      const storedData = storedDataRaw ?? JSON.stringify(this.defaultData);
+      const encodingFmt = String(await this.engine.getValue(`__ds-${this.id}-enf`, null));
+      const isEncoded = encodingFmt !== "null" && encodingFmt !== "false";
+      let saveData = false;
+      if (isNaN(storedFmtVer)) {
+        await this.engine.setValue(`__ds-${this.id}-ver`, storedFmtVer = this.formatVersion);
+        saveData = true;
       }
-      return i ? JSON.stringify(n) : n;
-    }
-    async serialize(e = true, t = true) {
-      return this.serializePartial(this.stores.map((i) => i.id), e, t);
+      let parsed = await this.engine.deserializeData(storedData, isEncoded);
+      if (storedFmtVer < this.formatVersion && this.migrations)
+        parsed = await this.runMigrations(parsed, storedFmtVer);
+      if (saveData)
+        await this.setData(parsed);
+      if (this.memoryCache)
+        return this.cachedData = this.engine.deepCopy(parsed);
+      else
+        return this.engine.deepCopy(parsed);
+    } catch (err) {
+      console.warn("Error while parsing JSON data, resetting it to the default value.", err);
+      await this.saveDefaultData();
+      return this.defaultData;
     }
-    async deserializePartial(e, t) {
-      let i = typeof t == "string" ? JSON.parse(t) : t;
-      if (!Array.isArray(i) || !i.every(r.isSerializedDataStoreObj)) throw new TypeError("Invalid serialized data format! Expected an array of SerializedDataStore objects.");
-      let n = (a) => {
-        var s;
-        return ((s = Object.entries(this.options.remapIds).find(([, u]) => u.includes(a))) == null ? void 0 : s[0]) ?? a;
-      }, o = (a) => typeof e == "function" ? e(a) : e.includes(a);
-      for (let a of i) {
-        let s = n(a.id);
-        if (!o(s)) continue;
-        let u = this.stores.find((c) => c.id === s);
-        if (!u) throw new d(`Can't deserialize data because no DataStore instance with the ID "${s}" was found! Make sure to provide it in the DataStoreSerializer constructor.`);
-        if (this.options.ensureIntegrity && typeof a.checksum == "string") {
-          let c = await this.calcChecksum(a.data);
-          if (c !== a.checksum) throw new S(`Checksum mismatch for DataStore with ID "${a.id}"!
-Expected: ${a.checksum}
-Has: ${c}`);
+  }
+  //#region getData
+  /**
+   * Returns a copy of the data from the in-memory cache.  
+   * Use {@linkcode loadData()} to get fresh data from persistent storage (usually not necessary since the cache should always exactly reflect persistent storage).  
+   * ⚠️ If `memoryCache` was set to `false` in the constructor options, this method will throw an error.
+   */
+  getData() {
+    if (!this.memoryCache)
+      throw new DatedError("In-memory cache is disabled for this DataStore instance, so getData() can't be used. Please use loadData() instead.");
+    return this.engine.deepCopy(this.cachedData);
+  }
+  //#region setData
+  /** Saves the data synchronously to the in-memory cache and asynchronously to the persistent storage */
+  setData(data) {
+    if (this.memoryCache)
+      this.cachedData = data;
+    return new Promise(async (resolve) => {
+      await Promise.allSettled([
+        this.engine.setValue(`__ds-${this.id}-dat`, await this.engine.serializeData(data, this.encodingEnabled())),
+        this.engine.setValue(`__ds-${this.id}-ver`, this.formatVersion),
+        this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat)
+      ]);
+      resolve();
+    });
+  }
+  //#region saveDefaultData
+  /** Saves the default data passed in the constructor synchronously to the in-memory cache and asynchronously to persistent storage */
+  async saveDefaultData() {
+    if (this.memoryCache)
+      this.cachedData = this.defaultData;
+    await Promise.allSettled([
+      this.engine.setValue(`__ds-${this.id}-dat`, await this.engine.serializeData(this.defaultData, this.encodingEnabled())),
+      this.engine.setValue(`__ds-${this.id}-ver`, this.formatVersion),
+      this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat)
+    ]);
+  }
+  //#region deleteData
+  /**
+   * Call this method to clear all persistently stored data associated with this DataStore instance, including the storage container (if supported by the DataStoreEngine).  
+   * 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.
+   */
+  async deleteData() {
+    var _a, _b;
+    await Promise.allSettled([
+      this.engine.deleteValue(`__ds-${this.id}-dat`),
+      this.engine.deleteValue(`__ds-${this.id}-ver`),
+      this.engine.deleteValue(`__ds-${this.id}-enf`)
+    ]);
+    await ((_b = (_a = this.engine).deleteStorage) == null ? void 0 : _b.call(_a));
+  }
+  //#region encodingEnabled
+  /** Returns whether encoding and decoding are enabled for this DataStore instance */
+  encodingEnabled() {
+    return Boolean(this.encodeData && this.decodeData) && this.compressionFormat !== null || Boolean(this.compressionFormat);
+  }
+  //#region runMigrations
+  /**
+   * Runs all necessary migration functions consecutively and saves the result to the in-memory cache and persistent storage and also returns it.  
+   * This method is automatically called by {@linkcode loadData()} if the data format has changed since the last time the data was saved.  
+   * Though calling this method manually is not necessary, it can be useful if you want to run migrations for special occasions like a user importing potentially outdated data that has been previously exported.  
+   *   
+   * If one of the migrations fails, the data will be reset to the default value if `resetOnError` is set to `true` (default). Otherwise, an error will be thrown and no data will be saved.
+   */
+  async runMigrations(oldData, oldFmtVer, resetOnError = true) {
+    if (!this.migrations)
+      return oldData;
+    let newData = oldData;
+    const sortedMigrations = Object.entries(this.migrations).sort(([a], [b]) => Number(a) - Number(b));
+    let lastFmtVer = oldFmtVer;
+    for (const [fmtVer, migrationFunc] of sortedMigrations) {
+      const ver = Number(fmtVer);
+      if (oldFmtVer < this.formatVersion && oldFmtVer < ver) {
+        try {
+          const migRes = migrationFunc(newData);
+          newData = migRes instanceof Promise ? await migRes : migRes;
+          lastFmtVer = oldFmtVer = ver;
+        } catch (err) {
+          if (!resetOnError)
+            throw new MigrationError(`Error while running migration function for format version '${fmtVer}'`, { cause: err });
+          await this.saveDefaultData();
+          return this.getData();
         }
-        let l = a.encoded && u.encodingEnabled() ? await u.decodeData[1](a.data) : a.data;
-        a.formatVersion && !isNaN(Number(a.formatVersion)) && Number(a.formatVersion) < u.formatVersion ? await u.runMigrations(JSON.parse(l), Number(a.formatVersion), false) : await u.setData(JSON.parse(l));
       }
     }
-    async deserialize(e) {
-      return this.deserializePartial(this.stores.map((t) => t.id), e);
-    }
-    async loadStoresData(e) {
-      return Promise.allSettled(this.getStoresFiltered(e).map(async (t) => ({ id: t.id, data: await t.loadData() })));
-    }
-    async resetStoresData(e) {
-      return Promise.allSettled(this.getStoresFiltered(e).map((t) => t.saveDefaultData()));
-    }
-    async deleteStoresData(e) {
-      return Promise.allSettled(this.getStoresFiltered(e).map((t) => t.deleteData()));
+    await Promise.allSettled([
+      this.engine.setValue(`__ds-${this.id}-dat`, await this.engine.serializeData(newData)),
+      this.engine.setValue(`__ds-${this.id}-ver`, lastFmtVer),
+      this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat)
+    ]);
+    if (this.memoryCache)
+      return this.cachedData = this.engine.deepCopy(newData);
+    else
+      return this.engine.deepCopy(newData);
+  }
+  //#region migrateId
+  /**
+   * Tries to migrate the currently saved persistent data from one or more old IDs to the ID set in the constructor.  
+   * If no data exist for the old ID(s), nothing will be done, but some time may still pass trying to fetch the non-existent data.
+   */
+  async migrateId(oldIds) {
+    const ids = Array.isArray(oldIds) ? oldIds : [oldIds];
+    await Promise.all(ids.map(async (id) => {
+      const [data, fmtVer, isEncoded] = await (async () => {
+        const [d, f, e] = await Promise.all([
+          this.engine.getValue(`__ds-${id}-dat`, JSON.stringify(this.defaultData)),
+          this.engine.getValue(`__ds-${id}-ver`, NaN),
+          this.engine.getValue(`__ds-${id}-enf`, null)
+        ]);
+        return [d, Number(f), Boolean(e) && String(e) !== "null"];
+      })();
+      if (data === void 0 || isNaN(fmtVer))
+        return;
+      const parsed = await this.engine.deserializeData(data, isEncoded);
+      await Promise.allSettled([
+        this.engine.setValue(`__ds-${this.id}-dat`, await this.engine.serializeData(parsed)),
+        this.engine.setValue(`__ds-${this.id}-ver`, fmtVer),
+        this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat),
+        this.engine.deleteValue(`__ds-${id}-dat`),
+        this.engine.deleteValue(`__ds-${id}-ver`),
+        this.engine.deleteValue(`__ds-${id}-enf`)
+      ]);
+    }));
+  }
+};
+var DataStoreEngine = class {
+  dataStoreOptions;
+  // setDataStoreOptions() is called from inside the DataStore constructor to set this value
+  constructor(options) {
+    if (options)
+      this.dataStoreOptions = options;
+  }
+  /** Called by DataStore on creation, to pass its options. Only call this if you are using this instance standalone! */
+  setDataStoreOptions(dataStoreOptions) {
+    this.dataStoreOptions = dataStoreOptions;
+  }
+  //#region serialization api
+  /** Serializes the given object to a string, optionally encoded with `options.encodeData` if {@linkcode useEncoding} is not set to false and the `encodeData` and `decodeData` options are set */
+  async serializeData(data, useEncoding) {
+    var _a, _b, _c, _d, _e;
+    this.ensureDataStoreOptions();
+    const stringData = JSON.stringify(data);
+    if (!useEncoding || !((_a = this.dataStoreOptions) == null ? void 0 : _a.encodeData) || !((_b = this.dataStoreOptions) == null ? void 0 : _b.decodeData))
+      return stringData;
+    const encRes = (_e = (_d = (_c = this.dataStoreOptions) == null ? void 0 : _c.encodeData) == null ? void 0 : _d[1]) == null ? void 0 : _e.call(_d, stringData);
+    if (encRes instanceof Promise)
+      return await encRes;
+    return encRes;
+  }
+  /** Deserializes the given string to a JSON object, optionally decoded with `options.decodeData` if {@linkcode useEncoding} is set to true */
+  async deserializeData(data, useEncoding) {
+    var _a, _b, _c;
+    this.ensureDataStoreOptions();
+    let decRes = ((_a = this.dataStoreOptions) == null ? void 0 : _a.decodeData) && useEncoding ? (_c = (_b = this.dataStoreOptions.decodeData) == null ? void 0 : _b[1]) == null ? void 0 : _c.call(_b, data) : void 0;
+    if (decRes instanceof Promise)
+      decRes = await decRes;
+    return JSON.parse(decRes ?? data);
+  }
+  //#region misc api
+  /** Throws an error if the DataStoreOptions are not set or invalid */
+  ensureDataStoreOptions() {
+    if (!this.dataStoreOptions)
+      throw new DatedError("DataStoreEngine must be initialized with DataStore options before use. If you are using this instance standalone, set them in the constructor or call `setDataStoreOptions()` with the DataStore options.");
+    if (!this.dataStoreOptions.id)
+      throw new DatedError("DataStoreEngine must be initialized with a valid DataStore ID");
+  }
+  /**
+   * Copies a JSON-compatible object and loses all its internal references in the process.  
+   * Uses [`structuredClone()`](https://developer.mozilla.org/en-US/docs/Web/API/structuredClone) if available, otherwise falls back to `JSON.parse(JSON.stringify(obj))`.
+   */
+  deepCopy(obj) {
+    try {
+      if ("structuredClone" in globalThis)
+        return structuredClone(obj);
+    } catch {
     }
-    static isSerializedDataStoreObjArray(e) {
-      return Array.isArray(e) && e.every((t) => typeof t == "object" && t !== null && "id" in t && "data" in t && "formatVersion" in t && "encoded" in t);
+    return JSON.parse(JSON.stringify(obj));
+  }
+};
+var BrowserStorageEngine = class extends DataStoreEngine {
+  options;
+  /**
+   * Creates an instance of `BrowserStorageEngine`.  
+   *   
+   * - ⚠️ Requires a DOM environment  
+   * - ⚠️ Don't reuse engine instances, always create a new one for each {@linkcode DataStore} instance
+   */
+  constructor(options) {
+    super(options == null ? void 0 : options.dataStoreOptions);
+    this.options = {
+      type: "localStorage",
+      ...options
+    };
+  }
+  //#region storage api
+  /** Fetches a value from persistent storage */
+  async getValue(name, defaultValue) {
+    const val = this.options.type === "localStorage" ? globalThis.localStorage.getItem(name) : globalThis.sessionStorage.getItem(name);
+    return typeof val === "undefined" ? defaultValue : val;
+  }
+  /** Sets a value in persistent storage */
+  async setValue(name, value) {
+    if (this.options.type === "localStorage")
+      globalThis.localStorage.setItem(name, String(value));
+    else
+      globalThis.sessionStorage.setItem(name, String(value));
+  }
+  /** Deletes a value from persistent storage */
+  async deleteValue(name) {
+    if (this.options.type === "localStorage")
+      globalThis.localStorage.removeItem(name);
+    else
+      globalThis.sessionStorage.removeItem(name);
+  }
+};
+var fs;
+var FileStorageEngine = class extends DataStoreEngine {
+  options;
+  fileAccessQueue = Promise.resolve();
+  /**
+   * Creates an instance of `FileStorageEngine`.  
+   *   
+   * - ⚠️ Requires Node.js or Deno with Node compatibility (v1.31+)  
+   * - ⚠️ Don't reuse engine instances, always create a new one for each {@linkcode DataStore} instance
+   */
+  constructor(options) {
+    super(options == null ? void 0 : options.dataStoreOptions);
+    this.options = {
+      filePath: (id) => `.ds-${id}`,
+      ...options
+    };
+  }
+  //#region json file
+  /** Reads the file contents */
+  async readFile() {
+    var _a, _b, _c, _d;
+    this.ensureDataStoreOptions();
+    try {
+      if (!fs)
+        fs = (_a = await import("fs/promises")) == null ? void 0 : _a.default;
+      if (!fs)
+        throw new ScriptContextError("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new DatedError("'node:fs/promises' module not available") });
+      const path = typeof this.options.filePath === "string" ? this.options.filePath : this.options.filePath(this.dataStoreOptions.id);
+      const data = await fs.readFile(path, "utf-8");
+      return data ? JSON.parse(await ((_d = (_c = (_b = this.dataStoreOptions) == null ? void 0 : _b.decodeData) == null ? void 0 : _c[1]) == null ? void 0 : _d.call(_c, data)) ?? data) : void 0;
+    } catch {
+      return void 0;
     }
-    static isSerializedDataStoreObj(e) {
-      return typeof e == "object" && e !== null && "id" in e && "data" in e && "formatVersion" in e && "encoded" in e;
+  }
+  /** Overwrites the file contents */
+  async writeFile(data) {
+    var _a, _b, _c, _d;
+    this.ensureDataStoreOptions();
+    try {
+      if (!fs)
+        fs = (_a = await import("fs/promises")) == null ? void 0 : _a.default;
+      if (!fs)
+        throw new ScriptContextError("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new DatedError("'node:fs/promises' module not available") });
+      const path = typeof this.options.filePath === "string" ? this.options.filePath : this.options.filePath(this.dataStoreOptions.id);
+      await fs.mkdir(path.slice(0, path.lastIndexOf(path.includes("/") ? "/" : "\\")), { recursive: true });
+      await fs.writeFile(path, await ((_d = (_c = (_b = this.dataStoreOptions) == null ? void 0 : _b.encodeData) == null ? void 0 : _c[1]) == null ? void 0 : _d.call(_c, JSON.stringify(data))) ?? JSON.stringify(data, void 0, 2), "utf-8");
+    } catch (err) {
+      console.error("Error writing file:", err);
     }
-    getStoresFiltered(e) {
-      return this.stores.filter((t) => typeof e > "u" ? true : Array.isArray(e) ? e.includes(t.id) : e(t.id));
+  }
+  //#region storage api
+  /** Fetches a value from persistent storage */
+  async getValue(name, defaultValue) {
+    const data = await this.readFile();
+    if (!data)
+      return defaultValue;
+    const value = data == null ? void 0 : data[name];
+    if (typeof value === "undefined")
+      return defaultValue;
+    if (typeof value === "string")
+      return value;
+    return value;
+  }
+  /** Sets a value in persistent storage */
+  async setValue(name, value) {
+    this.fileAccessQueue = this.fileAccessQueue.then(async () => {
+      let data = await this.readFile();
+      if (!data)
+        data = {};
+      data[name] = value;
+      await this.writeFile(data);
+    }).catch((err) => {
+      console.error("Error in setValue:", err);
+      throw err;
+    });
+    await this.fileAccessQueue.catch(() => {
+    });
+  }
+  /** Deletes a value from persistent storage */
+  async deleteValue(name) {
+    this.fileAccessQueue = this.fileAccessQueue.then(async () => {
+      const data = await this.readFile();
+      if (!data)
+        return;
+      delete data[name];
+      await this.writeFile(data);
+    }).catch((err) => {
+      console.error("Error in deleteValue:", err);
+      throw err;
+    });
+    await this.fileAccessQueue.catch(() => {
+    });
+  }
+  /** Deletes the file that contains the data of this DataStore. */
+  async deleteStorage() {
+    var _a;
+    this.ensureDataStoreOptions();
+    try {
+      if (!fs)
+        fs = (_a = await import("fs/promises")) == null ? void 0 : _a.default;
+      if (!fs)
+        throw new ScriptContextError("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new DatedError("'node:fs/promises' module not available") });
+      const path = typeof this.options.filePath === "string" ? this.options.filePath : this.options.filePath(this.dataStoreOptions.id);
+      return await fs.unlink(path);
+    } catch (err) {
+      console.error("Error deleting file:", err);
     }
-  };
-  var Z = () => ({ emit(r, ...e) {
-    for (let t = this.events[r] || [], i = 0, n = t.length; i < n; i++) t[i](...e);
-  }, events: {}, on(r, e) {
-    return (this.events[r] ||= []).push(e), () => {
-      var t;
-      this.events[r] = (t = this.events[r]) == null ? void 0 : t.filter((i) => e !== i);
+  }
+};
+var DataStoreSerializer = class _DataStoreSerializer {
+  stores;
+  options;
+  constructor(stores, options = {}) {
+    if (!crypto || !crypto.subtle)
+      throw new ScriptContextError("DataStoreSerializer has to run in a secure context (HTTPS) or in another environment that implements the subtleCrypto API!");
+    this.stores = stores;
+    this.options = {
+      addChecksum: true,
+      ensureIntegrity: true,
+      remapIds: {},
+      ...options
     };
-  } });
-  var P = class {
-    events = Z();
-    eventUnsubscribes = [];
-    emitterOptions;
-    constructor(e = {}) {
-      this.emitterOptions = { publicEmit: false, ...e };
+  }
+  /** Calculates the checksum of a string */
+  async calcChecksum(input) {
+    return computeHash(input, "SHA-256");
+  }
+  /**
+   * Serializes only a subset of the data stores into a string.  
+   * @param stores An array of store IDs or functions that take a store ID and return a boolean
+   * @param useEncoding Whether to encode the data using each DataStore's `encodeData()` method
+   * @param stringified Whether to return the result as a string or as an array of `SerializedDataStore` objects
+   */
+  async serializePartial(stores, useEncoding = true, stringified = true) {
+    var _a;
+    const serData = [];
+    const filteredStores = this.stores.filter((s) => typeof stores === "function" ? stores(s.id) : stores.includes(s.id));
+    for (const storeInst of filteredStores) {
+      const encoded = Boolean(useEncoding && storeInst.encodingEnabled() && ((_a = storeInst.encodeData) == null ? void 0 : _a[1]));
+      const rawData = storeInst.memoryCache ? storeInst.getData() : await storeInst.loadData();
+      const data = encoded ? await storeInst.encodeData[1](JSON.stringify(rawData)) : JSON.stringify(rawData);
+      serData.push({
+        id: storeInst.id,
+        data,
+        formatVersion: storeInst.formatVersion,
+        encoded,
+        checksum: this.options.addChecksum ? await this.calcChecksum(data) : void 0
+      });
     }
-    on(e, t) {
-      let i, n = () => {
-        i && (i(), this.eventUnsubscribes = this.eventUnsubscribes.filter((o) => o !== i));
-      };
-      return i = this.events.on(e, t), this.eventUnsubscribes.push(i), n;
+    return stringified ? JSON.stringify(serData) : serData;
+  }
+  /**
+   * Serializes the data stores into a string.  
+   * @param useEncoding Whether to encode the data using each DataStore's `encodeData()` method
+   * @param stringified Whether to return the result as a string or as an array of `SerializedDataStore` objects
+   */
+  async serialize(useEncoding = true, stringified = true) {
+    return this.serializePartial(this.stores.map((s) => s.id), useEncoding, stringified);
+  }
+  /**
+   * Deserializes the data exported via {@linkcode serialize()} and imports only a subset into the DataStore instances.  
+   * Also triggers the migration process if the data format has changed.
+   */
+  async deserializePartial(stores, data) {
+    const deserStores = typeof data === "string" ? JSON.parse(data) : data;
+    if (!Array.isArray(deserStores) || !deserStores.every(_DataStoreSerializer.isSerializedDataStoreObj))
+      throw new TypeError("Invalid serialized data format! Expected an array of SerializedDataStore objects.");
+    const resolveStoreId = (id) => {
+      var _a;
+      return ((_a = Object.entries(this.options.remapIds).find(([, v]) => v.includes(id))) == null ? void 0 : _a[0]) ?? id;
+    };
+    const matchesFilter = (id) => typeof stores === "function" ? stores(id) : stores.includes(id);
+    for (const storeData of deserStores) {
+      const effectiveId = resolveStoreId(storeData.id);
+      if (!matchesFilter(effectiveId))
+        continue;
+      const storeInst = this.stores.find((s) => s.id === effectiveId);
+      if (!storeInst)
+        throw new DatedError(`Can't deserialize data because no DataStore instance with the ID "${effectiveId}" was found! Make sure to provide it in the DataStoreSerializer constructor.`);
+      if (this.options.ensureIntegrity && typeof storeData.checksum === "string") {
+        const checksum = await this.calcChecksum(storeData.data);
+        if (checksum !== storeData.checksum)
+          throw new ChecksumMismatchError(`Checksum mismatch for DataStore with ID "${storeData.id}"!
+Expected: ${storeData.checksum}
+Has: ${checksum}`);
+      }
+      const decodedData = storeData.encoded && storeInst.encodingEnabled() ? await storeInst.decodeData[1](storeData.data) : storeData.data;
+      if (storeData.formatVersion && !isNaN(Number(storeData.formatVersion)) && Number(storeData.formatVersion) < storeInst.formatVersion)
+        await storeInst.runMigrations(JSON.parse(decodedData), Number(storeData.formatVersion), false);
+      else
+        await storeInst.setData(JSON.parse(decodedData));
     }
-    once(e, t) {
-      return new Promise((i) => {
-        let n, o = ((...a) => {
-          t == null || t(...a), n == null || n(), i(a);
-        });
-        n = this.events.on(e, o), this.eventUnsubscribes.push(n);
+  }
+  /**
+   * Deserializes the data exported via {@linkcode serialize()} and imports the data into all matching DataStore instances.  
+   * Also triggers the migration process if the data format has changed.
+   */
+  async deserialize(data) {
+    return this.deserializePartial(this.stores.map((s) => s.id), data);
+  }
+  /**
+   * Loads the persistent data of the DataStore instances into the in-memory cache.  
+   * Also triggers the migration process if the data format has changed.
+   * @param stores An array of store IDs or a function that takes the store IDs and returns a boolean - if omitted, all stores will be loaded
+   * @returns Returns a PromiseSettledResult array with the results of each DataStore instance in the format `{ id: string, data: object }`
+   */
+  async loadStoresData(stores) {
+    return Promise.allSettled(
+      this.getStoresFiltered(stores).map(async (store) => ({
+        id: store.id,
+        data: await store.loadData()
+      }))
+    );
+  }
+  /**
+   * Resets the persistent and in-memory data of the DataStore instances to their default values.
+   * @param stores An array of store IDs or a function that takes the store IDs and returns a boolean - if omitted, all stores will be affected
+   */
+  async resetStoresData(stores) {
+    return Promise.allSettled(
+      this.getStoresFiltered(stores).map((store) => store.saveDefaultData())
+    );
+  }
+  /**
+   * Deletes the persistent data of the DataStore instances.  
+   * Leaves the in-memory data untouched.  
+   * @param stores An array of store IDs or a function that takes the store IDs and returns a boolean - if omitted, all stores will be affected
+   */
+  async deleteStoresData(stores) {
+    return Promise.allSettled(
+      this.getStoresFiltered(stores).map((store) => store.deleteData())
+    );
+  }
+  /** Checks if a given value is an array of SerializedDataStore objects */
+  static isSerializedDataStoreObjArray(obj) {
+    return Array.isArray(obj) && obj.every((o) => typeof o === "object" && o !== null && "id" in o && "data" in o && "formatVersion" in o && "encoded" in o);
+  }
+  /** Checks if a given value is a SerializedDataStore object */
+  static isSerializedDataStoreObj(obj) {
+    return typeof obj === "object" && obj !== null && "id" in obj && "data" in obj && "formatVersion" in obj && "encoded" in obj;
+  }
+  /** Returns the DataStore instances whose IDs match the provided array or function */
+  getStoresFiltered(stores) {
+    return this.stores.filter((s) => typeof stores === "undefined" ? true : Array.isArray(stores) ? stores.includes(s.id) : stores(s.id));
+  }
+};
+var createNanoEvents = () => ({
+  emit(event, ...args) {
+    for (let callbacks = this.events[event] || [], i = 0, length = callbacks.length; i < length; i++) {
+      callbacks[i](...args);
+    }
+  },
+  events: {},
+  on(event, cb) {
+    ;
+    (this.events[event] ||= []).push(cb);
+    return () => {
+      var _a;
+      this.events[event] = (_a = this.events[event]) == null ? void 0 : _a.filter((i) => cb !== i);
+    };
+  }
+});
+var NanoEmitter = class {
+  events = createNanoEvents();
+  eventUnsubscribes = [];
+  emitterOptions;
+  /** Creates a new instance of NanoEmitter - a lightweight event emitter with helper methods and a strongly typed event map */
+  constructor(options = {}) {
+    this.emitterOptions = {
+      publicEmit: false,
+      ...options
+    };
+  }
+  //#region on
+  /**
+   * Subscribes to an event and calls the callback when it's emitted.  
+   * @param event The event to subscribe to. Use `as "_"` in case your event names aren't thoroughly typed (like when using a template literal, e.g. \`event-${val}\` as "_")
+   * @returns Returns a function that can be called to unsubscribe the event listener
+   * @example ```ts
+   * const emitter = new NanoEmitter<{
+   *   foo: (bar: string) => void;
+   * }>({
+   *   publicEmit: true,
+   * });
+   * 
+   * let i = 0;
+   * const unsub = emitter.on("foo", (bar) => {
+   *   // unsubscribe after 10 events:
+   *   if(++i === 10) unsub();
+   *   console.log(bar);
+   * });
+   * 
+   * emitter.emit("foo", "bar");
+   * ```
+   */
+  on(event, cb) {
+    let unsub;
+    const unsubProxy = () => {
+      if (!unsub)
+        return;
+      unsub();
+      this.eventUnsubscribes = this.eventUnsubscribes.filter((u) => u !== unsub);
+    };
+    unsub = this.events.on(event, cb);
+    this.eventUnsubscribes.push(unsub);
+    return unsubProxy;
+  }
+  //#region once
+  /**
+   * Subscribes to an event and calls the callback or resolves the Promise only once when it's emitted.  
+   * @param event The event to subscribe to. Use `as "_"` in case your event names aren't thoroughly typed (like when using a template literal, e.g. \`event-${val}\` as "_")
+   * @param cb The callback to call when the event is emitted - if provided or not, the returned Promise will resolve with the event arguments
+   * @returns Returns a Promise that resolves with the event arguments when the event is emitted
+   * @example ```ts
+   * const emitter = new NanoEmitter<{
+   *   foo: (bar: string) => void;
+   * }>();
+   * 
+   * // Promise syntax:
+   * const [bar] = await emitter.once("foo");
+   * console.log(bar);
+   * 
+   * // Callback syntax:
+   * emitter.once("foo", (bar) => console.log(bar));
+   * ```
+   */
+  once(event, cb) {
+    return new Promise((resolve) => {
+      let unsub;
+      const onceProxy = ((...args) => {
+        cb == null ? void 0 : cb(...args);
+        unsub == null ? void 0 : unsub();
+        resolve(args);
       });
-    }
-    onMulti(e) {
-      let t = [], i = () => {
-        for (let n of t) n();
-        t.splice(0, t.length), this.eventUnsubscribes = this.eventUnsubscribes.filter((n) => !t.includes(n));
+      unsub = this.events.on(event, onceProxy);
+      this.eventUnsubscribes.push(unsub);
+    });
+  }
+  //#region onMulti
+  /**
+   * Allows subscribing to multiple events and calling the callback only when one of, all of, or a subset of the events are emitted, either continuously or only once.  
+   * @param options An object or array of objects with the following properties:  
+   * `callback` (required) is the function that will be called when the conditions are met.  
+   *   
+   * Set `once` to true to call the callback only once for the first event (or set of events) that match the criteria, then stop listening.  
+   * If `signal` is provided, the subscription will be canceled when the given signal is aborted.  
+   *   
+   * If `oneOf` is used, the callback will be called when any of the matching events are emitted.  
+   * If `allOf` is used, the callback will be called after all of the matching events are emitted at least once, then any time any of them are emitted.  
+   * If both `oneOf` and `allOf` are used together, the callback will be called when any of the `oneOf` events are emitted AND all of the `allOf` events have been emitted at least once.  
+   * At least one of `oneOf` or `allOf` must be provided.  
+   *   
+   * @returns Returns a function that can be called to unsubscribe all listeners created by this call. Alternatively, pass an `AbortSignal` to all options objects to achieve the same effect or for finer control.
+   */
+  onMulti(options) {
+    const allUnsubs = [];
+    const unsubAll = () => {
+      for (const unsub of allUnsubs)
+        unsub();
+      allUnsubs.splice(0, allUnsubs.length);
+      this.eventUnsubscribes = this.eventUnsubscribes.filter((u) => !allUnsubs.includes(u));
+    };
+    for (const opts of Array.isArray(options) ? options : [options]) {
+      const optsWithDefaults = {
+        allOf: [],
+        oneOf: [],
+        once: false,
+        ...opts
       };
-      for (let n of Array.isArray(e) ? e : [e]) {
-        let o = { allOf: [], oneOf: [], once: false, ...n }, { oneOf: a, allOf: s, once: u, signal: l, callback: c } = o;
-        if (l != null && l.aborted) return i;
-        if (a.length === 0 && s.length === 0) throw new TypeError("NanoEmitter.onMulti(): Either `oneOf` or `allOf` or both must be provided in the options");
-        let p = [], m = (h = false) => {
-          if (!(!(l != null && l.aborted) && !h)) {
-            for (let y of p) y();
-            p.splice(0, p.length), this.eventUnsubscribes = this.eventUnsubscribes.filter((y) => !p.includes(y));
+      const {
+        oneOf,
+        allOf,
+        once,
+        signal,
+        callback
+      } = optsWithDefaults;
+      if (signal == null ? void 0 : signal.aborted)
+        return unsubAll;
+      if (oneOf.length === 0 && allOf.length === 0)
+        throw new TypeError("NanoEmitter.onMulti(): Either `oneOf` or `allOf` or both must be provided in the options");
+      const curEvtUnsubs = [];
+      const checkUnsubAllEvt = (force = false) => {
+        if (!(signal == null ? void 0 : signal.aborted) && !force)
+          return;
+        for (const unsub of curEvtUnsubs)
+          unsub();
+        curEvtUnsubs.splice(0, curEvtUnsubs.length);
+        this.eventUnsubscribes = this.eventUnsubscribes.filter((u) => !curEvtUnsubs.includes(u));
+      };
+      const allOfEmitted = /* @__PURE__ */ new Set();
+      const allOfConditionMet = () => allOf.length === 0 || allOfEmitted.size === allOf.length;
+      for (const event of oneOf) {
+        const unsub = this.events.on(event, ((...args) => {
+          checkUnsubAllEvt();
+          if (allOfConditionMet()) {
+            callback(event, ...args);
+            if (once)
+              checkUnsubAllEvt(true);
           }
-        }, b = /* @__PURE__ */ new Set(), O = () => s.length === 0 || b.size === s.length;
-        for (let h of a) {
-          let y = this.events.on(h, ((...M) => {
-            m(), O() && (c(h, ...M), u && m(true));
-          }));
-          p.push(y);
-        }
-        for (let h of s) {
-          let y = this.events.on(h, ((...M) => {
-            m(), b.add(h), O() && (a.length === 0 || a.includes(h)) && (c(h, ...M), u && m(true));
-          }));
-          p.push(y);
-        }
-        t.push(() => m(true));
+        }));
+        curEvtUnsubs.push(unsub);
       }
-      return i;
-    }
-    emit(e, ...t) {
-      return this.emitterOptions.publicEmit ? (this.events.emit(e, ...t), true) : false;
-    }
-    unsubscribeAll() {
-      for (let e of this.eventUnsubscribes) e();
-      this.eventUnsubscribes = [];
-    }
-  };
-  var A = class extends P {
-    constructor(t = 200, i = "immediate") {
-      super();
-      this.timeout = t;
-      this.type = i;
-    }
-    listeners = [];
-    activeTimeout;
-    queuedCall;
-    addListener(t) {
-      this.listeners.push(t);
-    }
-    removeListener(t) {
-      let i = this.listeners.findIndex((n) => n === t);
-      i !== -1 && this.listeners.splice(i, 1);
-    }
-    removeAllListeners() {
-      this.listeners = [];
-    }
-    getListeners() {
-      return this.listeners;
-    }
-    setTimeout(t) {
-      this.emit("change", this.timeout = t, this.type);
-    }
-    getTimeout() {
-      return this.timeout;
-    }
-    isTimeoutActive() {
-      return typeof this.activeTimeout < "u";
-    }
-    setType(t) {
-      this.emit("change", this.timeout, this.type = t);
+      for (const event of allOf) {
+        const unsub = this.events.on(event, ((...args) => {
+          checkUnsubAllEvt();
+          allOfEmitted.add(event);
+          if (allOfConditionMet() && (oneOf.length === 0 || oneOf.includes(event))) {
+            callback(event, ...args);
+            if (once)
+              checkUnsubAllEvt(true);
+          }
+        }));
+        curEvtUnsubs.push(unsub);
+      }
+      allUnsubs.push(() => checkUnsubAllEvt(true));
     }
-    getType() {
-      return this.type;
+    return unsubAll;
+  }
+  //#region emit
+  /**
+   * Emits an event on this instance.  
+   * - ⚠️ Needs `publicEmit` to be set to true in the NanoEmitter constructor or super() call!
+   * @param event The event to emit
+   * @param args The arguments to pass to the event listeners
+   * @returns Returns true if `publicEmit` is true and the event was emitted successfully
+   */
+  emit(event, ...args) {
+    if (this.emitterOptions.publicEmit) {
+      this.events.emit(event, ...args);
+      return true;
     }
-    call(...t) {
-      let i = (...o) => {
-        this.queuedCall = void 0, this.emit("call", ...o), this.listeners.forEach((a) => a.call(this, ...o));
-      }, n = () => {
+    return false;
+  }
+  //#region unsubscribeAll
+  /** Unsubscribes all event listeners from this instance */
+  unsubscribeAll() {
+    for (const unsub of this.eventUnsubscribes)
+      unsub();
+    this.eventUnsubscribes = [];
+  }
+};
+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 */
+  listeners = [];
+  /** The currently active timeout */
+  activeTimeout;
+  /** The latest queued call */
+  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 = [];
+  }
+  /** Returns all registered listeners */
+  getListeners() {
+    return 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 = void 0;
+      this.emit("call", ...a);
+      this.listeners.forEach((l) => l.call(this, ...a));
+    };
+    const setRepeatTimeout = () => {
+      this.activeTimeout = setTimeout(() => {
+        if (this.queuedCall) {
+          this.queuedCall();
+          setRepeatTimeout();
+        } else
+          this.activeTimeout = void 0;
+      }, 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(() => {
-          this.queuedCall ? (this.queuedCall(), n()) : this.activeTimeout = void 0;
+          cl(...args);
+          this.activeTimeout = void 0;
         }, this.timeout);
-      };
-      switch (this.type) {
-        case "immediate":
-          typeof this.activeTimeout > "u" ? (i(...t), n()) : this.queuedCall = () => i(...t);
-          break;
-        case "idle":
-          this.activeTimeout && clearTimeout(this.activeTimeout), this.activeTimeout = setTimeout(() => {
-            i(...t), this.activeTimeout = void 0;
-          }, this.timeout);
-          break;
-        default:
-          throw new TypeError(`Invalid debouncer type: ${this.type}`);
-      }
+        break;
+      default:
+        throw new TypeError(`Invalid debouncer type: ${this.type}`);
     }
-  };
-  function Ie(r, e = 200, t = "immediate") {
-    let i = new A(e, t);
-    i.addListener(r);
-    let n = ((...o) => i.call(...o));
-    return n.debouncer = i, n;
-  }
-  if (typeof module2.exports == "object" && typeof exports2 == "object") {
-    var __cp = (to, from, except, desc) => {
-      if (from && typeof from === "object" || typeof from === "function") {
-        for (let key of Object.getOwnPropertyNames(from)) {
-          if (!Object.prototype.hasOwnProperty.call(to, key) && key !== except)
-            Object.defineProperty(to, key, {
-              get: () => from[key],
-              enumerable: !(desc = Object.getOwnPropertyDescriptor(from, key)) || desc.enumerable
-            });
-        }
-      }
-      return to;
-    };
-    module2.exports = __cp(module2.exports, exports2);
   }
-  return module2.exports;
-});
+};
+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/Errors.ts
-var PlatformError = class extends (void 0) {
+var PlatformError = class extends DatedError {
   constructor(message, options) {
     super(message, options);
     this.name = "PlatformError";
@@ -850,8 +1527,8 @@ function interceptEvent(eventObject, eventName, predicate = () => true) {
   if (typeof window.GM === "object" && ((_a = GM == null ? void 0 : GM.info) == null ? void 0 : _a.scriptHandler) && GM.info.scriptHandler === "FireMonkey" && (eventObject === window || eventObject === getUnsafeWindow()))
     throw new PlatformError("Intercepting window events is not supported on FireMonkey due to the isolated context the userscript is forced to run in.");
   if ("stackTraceLimit" in Error) {
-    Error.stackTraceLimit = Math.max(Error.stackTraceLimit, 100);
-    if (isNaN(Error.stackTraceLimit))
+    Error.stackTraceLimit = Math.max(Number(Error.stackTraceLimit), 100);
+    if (isNaN(Number(Error.stackTraceLimit)))
       Error.stackTraceLimit = 100;
   }
   (function(original) {
@@ -1120,7 +1797,7 @@ var openDialogs = [];
 var defaultStrings = {
   closeDialogTooltip: "Click to close the dialog"
 };
-var Dialog = class _Dialog extends (void 0) {
+var Dialog = class _Dialog extends NanoEmitter {
   /** Options passed to the dialog in the constructor */
   options;
   /** ID that gets added to child element IDs - has to be unique and conform to HTML ID naming rules! */
@@ -1378,7 +2055,7 @@ var Dialog = class _Dialog extends (void 0) {
 };
 
 // lib/GMStorageEngine.ts
-var GMStorageEngine = class extends (void 0) {
+var GMStorageEngine = class extends DataStoreEngine {
   options;
   /**
    * Creates an instance of `GMStorageEngine`.  
@@ -1456,7 +2133,7 @@ var Mixins = class {
    * @param config Configuration object to customize the behavior.
    */
   constructor(config = {}) {
-    this.defaultMixinCfg = (void 0)({
+    this.defaultMixinCfg = pureObj({
       priority: config.defaultPriority ?? 0,
       stopPropagation: config.defaultStopPropagation ?? false,
       signal: config.defaultSignal
@@ -1472,9 +2149,9 @@ var Mixins = class {
    * @param config Configuration object to customize the mixin behavior, or just the priority if a number is passed.
    * @returns Returns a cleanup function, to be called when this mixin is no longer needed.
    */
-  add(mixinKey, mixinFn, config = (void 0)({})) {
+  add(mixinKey, mixinFn, config = pureObj({})) {
     const calcPrio = typeof config === "number" ? config : this.calcPriority(mixinKey, config);
-    const mixin = (void 0)({
+    const mixin = pureObj({
       ...this.defaultMixinCfg,
       key: mixinKey,
       fn: mixinFn,
@@ -1641,7 +2318,7 @@ var SelectorObserver = class {
       ...options
     };
     if (options.debounce && options.debounce > 0 || this.customOptions.defaultDebounce && this.customOptions.defaultDebounce > 0) {
-      options.listener = (void 0)(
+      options.listener = debounce(
         options.listener,
         options.debounce || this.customOptions.defaultDebounce,
         options.debounceType || this.customOptions.defaultDebounceType