@sv443-network/userutils 10.0.0 → 10.0.2

package/dist/UserUtils.umd.js

@@ -99,835 +99,1501 @@ var __async = (__this, __arguments, generator) => {
 // 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;
+// 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 = __pow(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];
   };
-  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 = __pow(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]];
+  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 != null ? 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));
+}
+function compress(input, compressionFormat, outputType = "string") {
+  return __async(this, null, function* () {
+    var _a;
+    const byteArray = input instanceof Uint8Array ? input : new TextEncoder().encode((_a = input == null ? void 0 : input.toString()) != null ? _a : String(input));
+    const comp = new CompressionStream(compressionFormat);
+    const writer = comp.writable.getWriter();
+    writer.write(byteArray);
+    writer.close();
+    const uintArr = new Uint8Array(yield new Response(comp.readable).arrayBuffer());
+    return outputType === "arrayBuffer" ? uintArr : abtoa(uintArr);
+  });
+}
+function decompress(input, compressionFormat, outputType = "string") {
+  return __async(this, null, function* () {
+    var _a;
+    const byteArray = input instanceof Uint8Array ? input : atoab((_a = input == null ? void 0 : input.toString()) != null ? _a : String(input));
+    const decomp = new DecompressionStream(compressionFormat);
+    const writer = decomp.writable.getWriter();
+    writer.write(byteArray);
+    writer.close();
+    const uintArr = new Uint8Array(yield new Response(decomp.readable).arrayBuffer());
+    return outputType === "arrayBuffer" ? uintArr : new TextDecoder().decode(uintArr);
+  });
+}
+function computeHash(input, algorithm = "SHA-256") {
+  return __async(this, null, function* () {
+    let data;
+    if (typeof input === "string") {
+      const encoder = new TextEncoder();
+      data = encoder.encode(input);
+    } else
+      data = input;
+    const hashBuffer = yield 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 {
+  constructor(message, options) {
+    super(message, options);
+    __publicField(this, "date");
+    this.name = this.constructor.name;
+    this.date = /* @__PURE__ */ new Date();
+  }
+};
+var ChecksumMismatchError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "ChecksumMismatchError";
+  }
+};
+var CustomError = class extends DatedError {
+  constructor(name, message, options) {
+    super(message, options);
+    this.name = name;
+  }
+};
+var MigrationError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "MigrationError";
+  }
+};
+var ValidationError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "ValidationError";
+  }
+};
+var ScriptContextError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "ScriptContextError";
+  }
+};
+var NetworkError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "NetworkError";
+  }
+};
+function consumeGen(valGen) {
+  return __async(this, null, function* () {
+    return yield typeof valGen === "function" ? valGen() : valGen;
+  });
+}
+function consumeStringGen(strGen) {
+  return __async(this, null, function* () {
+    return typeof strGen === "string" ? strGen : String(
+      typeof strGen === "function" ? yield strGen() : strGen
+    );
+  });
+}
+function fetchAdvanced(_0) {
+  return __async(this, arguments, function* (input, options = {}) {
+    const _a = options, { timeout = 1e4, signal } = _a, restOpts = __objRest(_a, ["timeout", "signal"]);
+    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 };
     }
-    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 != null ? 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));
-  }
-  function N(r, e, t = "string") {
-    return __async(this, null, function* () {
-      var _a;
-      let i = r instanceof Uint8Array ? r : new TextEncoder().encode((_a = r == null ? void 0 : r.toString()) != null ? _a : String(r)), n = new CompressionStream(e), o = n.writable.getWriter();
-      o.write(i), o.close();
-      let a = new Uint8Array(yield new Response(n.readable).arrayBuffer());
-      return t === "arrayBuffer" ? a : H(a);
+    try {
+      const res = yield fetch(input, __spreadValues(__spreadValues({}, 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 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 != 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(null, null, function* () {
+    if (signal == null ? void 0 : signal.aborted)
+      return cleanup();
+    yield 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) {
+  var _a;
+  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 = ((_a = err.stack) != null ? _a : "").split("\n").map((line) => line.trim()).slice(2, lines + 2);
+    return asArray !== false ? stack : stack.join("\n");
+  }
+}
+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 _a2;
+    var _a;
+    const argIndex = Number(match.substring(1)) - 1;
+    return (_a = (_a2 = values[argIndex]) != null ? _a2 : 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 = "...") {
+  var _a;
+  const str = (_a = input == null ? void 0 : input.toString()) != null ? _a : 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 {
+  //#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) {
+    __publicField(this, "id");
+    __publicField(this, "formatVersion");
+    __publicField(this, "defaultData");
+    __publicField(this, "encodeData");
+    __publicField(this, "decodeData");
+    __publicField(this, "compressionFormat", "deflate-raw");
+    __publicField(this, "memoryCache", true);
+    __publicField(this, "engine");
+    __publicField(this, "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.
+     */
+    __publicField(this, "firstInit", true);
+    /** In-memory cached copy of the data that is saved in persistent storage used for synchronous read access. */
+    __publicField(this, "cachedData");
+    __publicField(this, "migrations");
+    __publicField(this, "migrateIds", []);
+    var _a2, _b, _c;
+    var _a;
+    this.id = opts.id;
+    this.formatVersion = opts.formatVersion;
+    this.defaultData = opts.defaultData;
+    this.memoryCache = Boolean((_a2 = opts.memoryCache) != null ? _a2 : 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 = (_b = (_a = opts.encodeData) == null ? void 0 : _a[0]) != null ? _b : "deflate-raw";
+    if (typeof opts.compressionFormat === "string") {
+      this.encodeData = [opts.compressionFormat, (data) => __async(this, null, function* () {
+        return yield compress(data, opts.compressionFormat, "string");
+      })];
+      this.decodeData = [opts.compressionFormat, (data) => __async(this, null, function* () {
+        return yield 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 = (_c = opts.encodeData[0]) != null ? _c : 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);
   }
-  function fe(r, e, t = "string") {
+  //#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.
+   */
+  loadData() {
     return __async(this, null, function* () {
       var _a;
-      let i = r instanceof Uint8Array ? r : W((_a = r == null ? void 0 : r.toString()) != null ? _a : String(r)), n = new DecompressionStream(e), o = n.writable.getWriter();
-      o.write(i), o.close();
-      let a = new Uint8Array(yield new Response(n.readable).arrayBuffer());
-      return t === "arrayBuffer" ? a : new TextDecoder().decode(a);
+      try {
+        if (this.firstInit) {
+          this.firstInit = false;
+          const dsVer = Number(yield this.engine.getValue("__ds_fmt_ver", 0));
+          const oldData = yield this.engine.getValue(`_uucfg-${this.id}`, null);
+          if (oldData) {
+            const oldVer = Number(yield this.engine.getValue(`_uucfgver-${this.id}`, NaN));
+            const oldEnc = yield 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 ? (_a = this.compressionFormat) != null ? _a : null : null);
+            else {
+              promises.push(this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat));
+              promises.push(this.engine.deleteValue(`_uucfgenc-${this.id}`));
+            }
+            yield Promise.allSettled(promises);
+          }
+          if (isNaN(dsVer) || dsVer < dsFmtVer)
+            yield this.engine.setValue("__ds_fmt_ver", dsFmtVer);
+        }
+        if (this.migrateIds.length > 0) {
+          yield this.migrateId(this.migrateIds);
+          this.migrateIds = [];
+        }
+        const storedDataRaw = yield this.engine.getValue(`__ds-${this.id}-dat`, null);
+        let storedFmtVer = Number(yield this.engine.getValue(`__ds-${this.id}-ver`, NaN));
+        if (typeof storedDataRaw !== "string") {
+          yield this.saveDefaultData();
+          return this.engine.deepCopy(this.defaultData);
+        }
+        const storedData = storedDataRaw != null ? storedDataRaw : JSON.stringify(this.defaultData);
+        const encodingFmt = String(yield this.engine.getValue(`__ds-${this.id}-enf`, null));
+        const isEncoded = encodingFmt !== "null" && encodingFmt !== "false";
+        let saveData = false;
+        if (isNaN(storedFmtVer)) {
+          yield this.engine.setValue(`__ds-${this.id}-ver`, storedFmtVer = this.formatVersion);
+          saveData = true;
+        }
+        let parsed = yield this.engine.deserializeData(storedData, isEncoded);
+        if (storedFmtVer < this.formatVersion && this.migrations)
+          parsed = yield this.runMigrations(parsed, storedFmtVer);
+        if (saveData)
+          yield 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);
+        yield this.saveDefaultData();
+        return this.defaultData;
+      }
     });
   }
-  function k(r, e = "SHA-256") {
+  //#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((resolve) => __async(this, null, function* () {
+      yield Promise.allSettled([
+        this.engine.setValue(`__ds-${this.id}-dat`, yield 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 */
+  saveDefaultData() {
     return __async(this, null, function* () {
-      let t;
-      typeof r == "string" ? t = new TextEncoder().encode(r) : t = r;
-      let i = yield crypto.subtle.digest(e, t);
-      return Array.from(new Uint8Array(i)).map((a) => a.toString(16).padStart(2, "0")).join("");
+      if (this.memoryCache)
+        this.cachedData = this.defaultData;
+      yield Promise.allSettled([
+        this.engine.setValue(`__ds-${this.id}-dat`, yield 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)
+      ]);
     });
   }
-  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 {
-    constructor(e, t) {
-      super(e, t);
-      __publicField(this, "date");
-      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";
-    }
-  };
-  function ge(r) {
+  //#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.
+   */
+  deleteData() {
     return __async(this, null, function* () {
-      return yield typeof r == "function" ? r() : r;
+      var _a, _b;
+      yield Promise.allSettled([
+        this.engine.deleteValue(`__ds-${this.id}-dat`),
+        this.engine.deleteValue(`__ds-${this.id}-ver`),
+        this.engine.deleteValue(`__ds-${this.id}-enf`)
+      ]);
+      yield (_b = (_a = this.engine).deleteStorage) == null ? void 0 : _b.call(_a);
     });
   }
-  function be(r) {
-    return __async(this, null, function* () {
-      return typeof r == "string" ? r : String(typeof r == "function" ? yield r() : r);
-    });
+  //#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);
   }
-  function ye(_0) {
-    return __async(this, arguments, function* (r, e = {}) {
-      let _a = e, { timeout: t = 1e4, signal: i } = _a, n = __objRest(_a, ["timeout", "signal"]), 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 = yield fetch(r, __spreadValues(__spreadValues({}, 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 });
+  //#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.
+   */
+  runMigrations(oldData, oldFmtVer, resetOnError = true) {
+    return __async(this, null, function* () {
+      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 ? yield migRes : migRes;
+            lastFmtVer = oldFmtVer = ver;
+          } catch (err) {
+            if (!resetOnError)
+              throw new MigrationError(`Error while running migration function for format version '${fmtVer}'`, { cause: err });
+            yield this.saveDefaultData();
+            return this.getData();
+          }
+        }
       }
+      yield Promise.allSettled([
+        this.engine.setValue(`__ds-${this.id}-dat`, yield 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);
     });
   }
-  function De(r, e = true) {
-    return "length" in r ? r.length : "size" in r ? r.size : "count" in r ? r.count : e ? 0 : NaN;
-  }
-  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();
-      });
+  //#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.
+   */
+  migrateId(oldIds) {
+    return __async(this, null, function* () {
+      const ids = Array.isArray(oldIds) ? oldIds : [oldIds];
+      yield Promise.all(ids.map((id) => __async(this, null, function* () {
+        const [data, fmtVer, isEncoded] = yield (() => __async(this, null, function* () {
+          const [d, f, e] = yield 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 = yield this.engine.deserializeData(data, isEncoded);
+        yield Promise.allSettled([
+          this.engine.setValue(`__ds-${this.id}-dat`, yield 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`)
+        ]);
+      })));
     });
   }
-  function Se(r) {
-    return Object.assign(/* @__PURE__ */ Object.create(null), r != null ? r : {});
+};
+var DataStoreEngine = class {
+  // setDataStoreOptions() is called from inside the DataStore constructor to set this value
+  constructor(options) {
+    __publicField(this, "dataStoreOptions");
+    if (options)
+      this.dataStoreOptions = options;
   }
-  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);
+  /** Called by DataStore on creation, to pass its options. Only call this if you are using this instance standalone! */
+  setDataStoreOptions(dataStoreOptions) {
+    this.dataStoreOptions = dataStoreOptions;
   }
-  function we(r, e, t) {
-    let i, n = () => clearTimeout(i), o = () => __async(null, null, function* () {
-      if (t != null && t.aborted) return n();
-      yield r(), i = setTimeout(o, e);
+  //#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 */
+  serializeData(data, useEncoding) {
+    return __async(this, null, function* () {
+      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 yield encRes;
+      return encRes;
     });
-    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);
+  /** Deserializes the given string to a JSON object, optionally decoded with `options.decodeData` if {@linkcode useEncoding} is set to true */
+  deserializeData(data, useEncoding) {
+    return __async(this, null, function* () {
+      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 = yield decRes;
+      return JSON.parse(decRes != null ? decRes : data);
+    });
   }
-  function Ee(r, e = 1 / 0) {
-    var _a;
-    if (typeof e != "number" || isNaN(e) || e < 0) throw new TypeError("lines parameter must be a non-negative number");
+  //#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 {
-      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 = ((_a = t.stack) != null ? _a : "").split(`
-`).map((n) => n.trim()).slice(2, e + 2);
-      return r !== false ? i : i.join(`
-`);
+      if ("structuredClone" in globalThis)
+        return structuredClone(obj);
+    } catch (e) {
     }
+    return JSON.parse(JSON.stringify(obj));
   }
-  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"}`;
-    }
+};
+var BrowserStorageEngine = class extends DataStoreEngine {
+  /**
+   * 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);
+    __publicField(this, "options");
+    this.options = __spreadValues({
+      type: "localStorage"
+    }, options);
   }
-  function Oe(r) {
-    return r.charAt(0).toUpperCase() + r.slice(1);
+  //#region storage api
+  /** Fetches a value from persistent storage */
+  getValue(name, defaultValue) {
+    return __async(this, null, function* () {
+      const val = this.options.type === "localStorage" ? globalThis.localStorage.getItem(name) : globalThis.sessionStorage.getItem(name);
+      return typeof val === "undefined" ? defaultValue : val;
+    });
   }
-  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}`;
+  /** Sets a value in persistent storage */
+  setValue(name, value) {
+    return __async(this, null, function* () {
+      if (this.options.type === "localStorage")
+        globalThis.localStorage.setItem(name, String(value));
+      else
+        globalThis.sessionStorage.setItem(name, String(value));
+    });
   }
-  function Ve(r, ...e) {
-    return r.replace(/%\d/gm, (t) => {
-      var _a;
-      var n;
-      let i = Number(t.substring(1)) - 1;
-      return (n = (_a = e[i]) != null ? _a : t) == null ? void 0 : n.toString();
+  /** Deletes a value from persistent storage */
+  deleteValue(name) {
+    return __async(this, null, function* () {
+      if (this.options.type === "localStorage")
+        globalThis.localStorage.removeItem(name);
+      else
+        globalThis.sessionStorage.removeItem(name);
     });
   }
-  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 = "...") {
-    var _a;
-    let i = (_a = r == null ? void 0 : r.toString()) != null ? _a : 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 {
-    constructor(e) {
-      __publicField(this, "id");
-      __publicField(this, "formatVersion");
-      __publicField(this, "defaultData");
-      __publicField(this, "encodeData");
-      __publicField(this, "decodeData");
-      __publicField(this, "compressionFormat", "deflate-raw");
-      __publicField(this, "memoryCache", true);
-      __publicField(this, "engine");
-      __publicField(this, "options");
-      __publicField(this, "firstInit", true);
-      __publicField(this, "cachedData");
-      __publicField(this, "migrations");
-      __publicField(this, "migrateIds", []);
-      var _a, _b, _c;
-      var t;
-      if (this.id = e.id, this.formatVersion = e.formatVersion, this.defaultData = e.defaultData, this.memoryCache = !!((_a = e.memoryCache) != null ? _a : 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 = (_b = (t = e.encodeData) == null ? void 0 : t[0]) != null ? _b : "deflate-raw"), typeof e.compressionFormat == "string") this.encodeData = [e.compressionFormat, (i) => __async(this, null, function* () {
-        return yield N(i, e.compressionFormat, "string");
-      })], this.decodeData = [e.compressionFormat, (i) => __async(this, null, function* () {
-        return yield 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 = (_c = e.encodeData[0]) != null ? _c : 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);
-    }
-    loadData() {
-      return __async(this, null, function* () {
-        var _a;
-        try {
-          if (this.firstInit) {
-            this.firstInit = false;
-            let u = Number(yield this.engine.getValue("__ds_fmt_ver", 0)), l = yield this.engine.getValue(`_uucfg-${this.id}`, null);
-            if (l) {
-              let c = Number(yield this.engine.getValue(`_uucfgver-${this.id}`, NaN)), p = yield 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 ? (_a = this.compressionFormat) != null ? _a : null : null) : (m.push(this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat)), m.push(this.engine.deleteValue(`_uucfgenc-${this.id}`))), yield Promise.allSettled(m);
-            }
-            (isNaN(u) || u < G) && (yield this.engine.setValue("__ds_fmt_ver", G));
-          }
-          this.migrateIds.length > 0 && (yield this.migrateId(this.migrateIds), this.migrateIds = []);
-          let e = yield this.engine.getValue(`__ds-${this.id}-dat`, null), t = Number(yield this.engine.getValue(`__ds-${this.id}-ver`, NaN));
-          if (typeof e != "string") return yield this.saveDefaultData(), this.engine.deepCopy(this.defaultData);
-          let i = e != null ? e : JSON.stringify(this.defaultData), n = String(yield this.engine.getValue(`__ds-${this.id}-enf`, null)), o = n !== "null" && n !== "false", a = false;
-          isNaN(t) && (yield this.engine.setValue(`__ds-${this.id}-ver`, t = this.formatVersion), a = true);
-          let s = yield this.engine.deserializeData(i, o);
-          return t < this.formatVersion && this.migrations && (s = yield this.runMigrations(s, t)), a && (yield 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), yield 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((t) => __async(this, null, function* () {
-        yield Promise.allSettled([this.engine.setValue(`__ds-${this.id}-dat`, yield 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();
-      }));
-    }
-    saveDefaultData() {
-      return __async(this, null, function* () {
-        this.memoryCache && (this.cachedData = this.defaultData), yield Promise.allSettled([this.engine.setValue(`__ds-${this.id}-dat`, yield 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)]);
-      });
-    }
-    deleteData() {
-      return __async(this, null, function* () {
-        var e, t;
-        yield Promise.allSettled([this.engine.deleteValue(`__ds-${this.id}-dat`), this.engine.deleteValue(`__ds-${this.id}-ver`), this.engine.deleteValue(`__ds-${this.id}-enf`)]), yield (t = (e = this.engine).deleteStorage) == null ? void 0 : t.call(e);
-      });
-    }
-    encodingEnabled() {
-      return !!(this.encodeData && this.decodeData) && this.compressionFormat !== null || !!this.compressionFormat;
-    }
-    runMigrations(e, t, i = true) {
-      return __async(this, null, function* () {
-        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 ? yield c : c, a = t = l;
-          } catch (c) {
-            if (!i) throw new w(`Error while running migration function for format version '${s}'`, { cause: c });
-            return yield this.saveDefaultData(), this.getData();
-          }
-        }
-        return yield Promise.allSettled([this.engine.setValue(`__ds-${this.id}-dat`, yield 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);
-      });
-    }
-    migrateId(e) {
-      return __async(this, null, function* () {
-        let t = Array.isArray(e) ? e : [e];
-        yield Promise.all(t.map((i) => __async(this, null, function* () {
-          let [n, o, a] = yield (() => __async(this, null, function* () {
-            let [u, l, c] = yield 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 = yield this.engine.deserializeData(n, a);
-          yield Promise.allSettled([this.engine.setValue(`__ds-${this.id}-dat`, yield 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 {
-    constructor(e) {
-      __publicField(this, "dataStoreOptions");
-      e && (this.dataStoreOptions = e);
-    }
-    setDataStoreOptions(e) {
-      this.dataStoreOptions = e;
-    }
-    serializeData(e, t) {
-      return __async(this, null, function* () {
-        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 ? yield n : n;
-      });
-    }
-    deserializeData(e, t) {
-      return __async(this, null, function* () {
-        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 = yield i), JSON.parse(i != null ? 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) {
+};
+var fs;
+var FileStorageEngine = class extends DataStoreEngine {
+  /**
+   * 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);
+    __publicField(this, "options");
+    __publicField(this, "fileAccessQueue", Promise.resolve());
+    this.options = __spreadValues({
+      filePath: (id) => `.ds-${id}`
+    }, options);
+  }
+  //#region json file
+  /** Reads the file contents */
+  readFile() {
+    return __async(this, null, function* () {
+      var _a2;
+      var _a, _b, _c, _d;
+      this.ensureDataStoreOptions();
       try {
-        if ("structuredClone" in globalThis) return structuredClone(e);
-      } catch (e2) {
+        if (!fs)
+          fs = (_a = yield 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 = yield fs.readFile(path, "utf-8");
+        return data ? JSON.parse((_a2 = yield (_d = (_c = (_b = this.dataStoreOptions) == null ? void 0 : _b.decodeData) == null ? void 0 : _c[1]) == null ? void 0 : _d.call(_c, data)) != null ? _a2 : data) : void 0;
+      } catch (e) {
+        return void 0;
       }
-      return JSON.parse(JSON.stringify(e));
-    }
-  }, U = class extends E {
-    constructor(e) {
-      super(e == null ? void 0 : e.dataStoreOptions);
-      __publicField(this, "options");
-      this.options = __spreadValues({ type: "localStorage" }, e);
-    }
-    getValue(e, t) {
-      return __async(this, null, function* () {
-        let i = this.options.type === "localStorage" ? globalThis.localStorage.getItem(e) : globalThis.sessionStorage.getItem(e);
-        return typeof i > "u" ? t : i;
-      });
-    }
-    setValue(e, t) {
-      return __async(this, null, function* () {
-        this.options.type === "localStorage" ? globalThis.localStorage.setItem(e, String(t)) : globalThis.sessionStorage.setItem(e, String(t));
+    });
+  }
+  /** Overwrites the file contents */
+  writeFile(data) {
+    return __async(this, null, function* () {
+      var _a2;
+      var _a, _b, _c, _d;
+      this.ensureDataStoreOptions();
+      try {
+        if (!fs)
+          fs = (_a = yield 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);
+        yield fs.mkdir(path.slice(0, path.lastIndexOf(path.includes("/") ? "/" : "\\")), { recursive: true });
+        yield fs.writeFile(path, (_a2 = yield (_d = (_c = (_b = this.dataStoreOptions) == null ? void 0 : _b.encodeData) == null ? void 0 : _c[1]) == null ? void 0 : _d.call(_c, JSON.stringify(data))) != null ? _a2 : JSON.stringify(data, void 0, 2), "utf-8");
+      } catch (err) {
+        console.error("Error writing file:", err);
+      }
+    });
+  }
+  //#region storage api
+  /** Fetches a value from persistent storage */
+  getValue(name, defaultValue) {
+    return __async(this, null, function* () {
+      const data = yield 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 */
+  setValue(name, value) {
+    return __async(this, null, function* () {
+      this.fileAccessQueue = this.fileAccessQueue.then(() => __async(this, null, function* () {
+        let data = yield this.readFile();
+        if (!data)
+          data = {};
+        data[name] = value;
+        yield this.writeFile(data);
+      })).catch((err) => {
+        console.error("Error in setValue:", err);
+        throw err;
       });
-    }
-    deleteValue(e) {
-      return __async(this, null, function* () {
-        this.options.type === "localStorage" ? globalThis.localStorage.removeItem(e) : globalThis.sessionStorage.removeItem(e);
+      yield this.fileAccessQueue.catch(() => {
       });
-    }
-  }, f, R = class extends E {
-    constructor(e) {
-      super(e == null ? void 0 : e.dataStoreOptions);
-      __publicField(this, "options");
-      __publicField(this, "fileAccessQueue", Promise.resolve());
-      this.options = __spreadValues({ filePath: (t) => `.ds-${t}` }, e);
-    }
-    readFile() {
-      return __async(this, null, function* () {
-        var _a;
-        var e, t, i, n;
-        this.ensureDataStoreOptions();
-        try {
-          if (f || (f = (e = yield 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 = yield f.readFile(o, "utf-8");
-          return a ? JSON.parse((_a = yield (n = (i = (t = this.dataStoreOptions) == null ? void 0 : t.decodeData) == null ? void 0 : i[1]) == null ? void 0 : n.call(i, a)) != null ? _a : a) : void 0;
-        } catch (e2) {
+    });
+  }
+  /** Deletes a value from persistent storage */
+  deleteValue(name) {
+    return __async(this, null, function* () {
+      this.fileAccessQueue = this.fileAccessQueue.then(() => __async(this, null, function* () {
+        const data = yield this.readFile();
+        if (!data)
           return;
-        }
-      });
-    }
-    writeFile(e) {
-      return __async(this, null, function* () {
-        var _a;
-        var t, i, n, o;
-        this.ensureDataStoreOptions();
-        try {
-          if (f || (f = (t = yield 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);
-          yield f.mkdir(a.slice(0, a.lastIndexOf(a.includes("/") ? "/" : "\\")), { recursive: true }), yield f.writeFile(a, (_a = yield (o = (n = (i = this.dataStoreOptions) == null ? void 0 : i.encodeData) == null ? void 0 : n[1]) == null ? void 0 : o.call(n, JSON.stringify(e))) != null ? _a : JSON.stringify(e, void 0, 2), "utf-8");
-        } catch (a) {
-          console.error("Error writing file:", a);
-        }
+        delete data[name];
+        yield this.writeFile(data);
+      })).catch((err) => {
+        console.error("Error in deleteValue:", err);
+        throw err;
       });
-    }
-    getValue(e, t) {
-      return __async(this, null, function* () {
-        let i = yield this.readFile();
-        if (!i) return t;
-        let n = i == null ? void 0 : i[e];
-        return typeof n > "u" ? t : n;
+      yield this.fileAccessQueue.catch(() => {
       });
-    }
-    setValue(e, t) {
-      return __async(this, null, function* () {
-        this.fileAccessQueue = this.fileAccessQueue.then(() => __async(this, null, function* () {
-          let i = yield this.readFile();
-          i || (i = {}), i[e] = t, yield this.writeFile(i);
-        })).catch((i) => {
-          throw console.error("Error in setValue:", i), i;
-        }), yield this.fileAccessQueue.catch(() => {
-        });
-      });
-    }
-    deleteValue(e) {
-      return __async(this, null, function* () {
-        this.fileAccessQueue = this.fileAccessQueue.then(() => __async(this, null, function* () {
-          let t = yield this.readFile();
-          t && (delete t[e], yield this.writeFile(t));
-        })).catch((t) => {
-          throw console.error("Error in deleteValue:", t), t;
-        }), yield this.fileAccessQueue.catch(() => {
+    });
+  }
+  /** Deletes the file that contains the data of this DataStore. */
+  deleteStorage() {
+    return __async(this, null, function* () {
+      var _a;
+      this.ensureDataStoreOptions();
+      try {
+        if (!fs)
+          fs = (_a = yield 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 yield fs.unlink(path);
+      } catch (err) {
+        console.error("Error deleting file:", err);
+      }
+    });
+  }
+};
+var DataStoreSerializer = class _DataStoreSerializer {
+  constructor(stores, options = {}) {
+    __publicField(this, "stores");
+    __publicField(this, "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 = __spreadValues({
+      addChecksum: true,
+      ensureIntegrity: true,
+      remapIds: {}
+    }, options);
+  }
+  /** Calculates the checksum of a string */
+  calcChecksum(input) {
+    return __async(this, null, function* () {
+      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
+   */
+  serializePartial(stores, useEncoding = true, stringified = true) {
+    return __async(this, null, function* () {
+      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() : yield storeInst.loadData();
+        const data = encoded ? yield storeInst.encodeData[1](JSON.stringify(rawData)) : JSON.stringify(rawData);
+        serData.push({
+          id: storeInst.id,
+          data,
+          formatVersion: storeInst.formatVersion,
+          encoded,
+          checksum: this.options.addChecksum ? yield this.calcChecksum(data) : void 0
         });
-      });
-    }
-    deleteStorage() {
-      return __async(this, null, function* () {
-        var e;
-        this.ensureDataStoreOptions();
-        try {
-          if (f || (f = (e = yield 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 yield f.unlink(t);
-        } catch (t) {
-          console.error("Error deleting file:", t);
-        }
-      });
-    }
-  };
-  var j = class r {
-    constructor(e, t = {}) {
-      __publicField(this, "stores");
-      __publicField(this, "options");
-      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 = __spreadValues({ addChecksum: true, ensureIntegrity: true, remapIds: {} }, t);
-    }
-    calcChecksum(e) {
-      return __async(this, null, function* () {
-        return k(e, "SHA-256");
-      });
-    }
-    serializePartial(e, t = true, i = true) {
-      return __async(this, null, function* () {
-        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() : yield s.loadData(), c = u ? yield 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 ? yield this.calcChecksum(c) : void 0 });
-        }
-        return i ? JSON.stringify(n) : n;
-      });
-    }
-    serialize(e = true, t = true) {
-      return __async(this, null, function* () {
-        return this.serializePartial(this.stores.map((i) => i.id), e, t);
-      });
-    }
-    deserializePartial(e, t) {
-      return __async(this, null, function* () {
-        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 _a;
-          var s;
-          return (_a = (s = Object.entries(this.options.remapIds).find(([, u]) => u.includes(a))) == null ? void 0 : s[0]) != null ? _a : 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 = yield this.calcChecksum(a.data);
-            if (c !== a.checksum) throw new S(`Checksum mismatch for DataStore with ID "${a.id}"!
-Expected: ${a.checksum}
-Has: ${c}`);
-          }
-          let l = a.encoded && u.encodingEnabled() ? yield u.decodeData[1](a.data) : a.data;
-          a.formatVersion && !isNaN(Number(a.formatVersion)) && Number(a.formatVersion) < u.formatVersion ? yield u.runMigrations(JSON.parse(l), Number(a.formatVersion), false) : yield u.setData(JSON.parse(l));
+      }
+      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
+   */
+  serialize(useEncoding = true, stringified = true) {
+    return __async(this, null, function* () {
+      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.
+   */
+  deserializePartial(stores, data) {
+    return __async(this, null, function* () {
+      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 _a2;
+        var _a;
+        return (_a2 = (_a = Object.entries(this.options.remapIds).find(([, v]) => v.includes(id))) == null ? void 0 : _a[0]) != null ? _a2 : 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 = yield this.calcChecksum(storeData.data);
+          if (checksum !== storeData.checksum)
+            throw new ChecksumMismatchError(`Checksum mismatch for DataStore with ID "${storeData.id}"!
+Expected: ${storeData.checksum}
+Has: ${checksum}`);
         }
-      });
-    }
-    deserialize(e) {
-      return __async(this, null, function* () {
-        return this.deserializePartial(this.stores.map((t) => t.id), e);
-      });
-    }
-    loadStoresData(e) {
-      return __async(this, null, function* () {
-        return Promise.allSettled(this.getStoresFiltered(e).map((t) => __async(this, null, function* () {
-          return { id: t.id, data: yield t.loadData() };
-        })));
-      });
-    }
-    resetStoresData(e) {
-      return __async(this, null, function* () {
-        return Promise.allSettled(this.getStoresFiltered(e).map((t) => t.saveDefaultData()));
-      });
-    }
-    deleteStoresData(e) {
-      return __async(this, null, function* () {
-        return Promise.allSettled(this.getStoresFiltered(e).map((t) => t.deleteData()));
-      });
-    }
-    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);
-    }
-    static isSerializedDataStoreObj(e) {
-      return typeof e == "object" && e !== null && "id" in e && "data" in e && "formatVersion" in e && "encoded" in e;
-    }
-    getStoresFiltered(e) {
-      return this.stores.filter((t) => typeof e > "u" ? true : Array.isArray(e) ? e.includes(t.id) : e(t.id));
-    }
-  };
-  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) {
+        const decodedData = storeData.encoded && storeInst.encodingEnabled() ? yield storeInst.decodeData[1](storeData.data) : storeData.data;
+        if (storeData.formatVersion && !isNaN(Number(storeData.formatVersion)) && Number(storeData.formatVersion) < storeInst.formatVersion)
+          yield storeInst.runMigrations(JSON.parse(decodedData), Number(storeData.formatVersion), false);
+        else
+          yield storeInst.setData(JSON.parse(decodedData));
+      }
+    });
+  }
+  /**
+   * 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.
+   */
+  deserialize(data) {
+    return __async(this, null, function* () {
+      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 }`
+   */
+  loadStoresData(stores) {
+    return __async(this, null, function* () {
+      return Promise.allSettled(
+        this.getStoresFiltered(stores).map((store) => __async(this, null, function* () {
+          return {
+            id: store.id,
+            data: yield 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
+   */
+  resetStoresData(stores) {
+    return __async(this, null, function* () {
+      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
+   */
+  deleteStoresData(stores) {
+    return __async(this, null, function* () {
+      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) {
     var _a;
-    return ((_a = this.events)[r] || (_a[r] = [])).push(e), () => {
-      var t;
-      this.events[r] = (t = this.events[r]) == null ? void 0 : t.filter((i) => e !== i);
+    ;
+    ((_a = this.events)[event] || (_a[event] = [])).push(cb);
+    return () => {
+      var _a2;
+      this.events[event] = (_a2 = this.events[event]) == null ? void 0 : _a2.filter((i) => cb !== i);
     };
-  } });
-  var P = class {
-    constructor(e = {}) {
-      __publicField(this, "events", Z());
-      __publicField(this, "eventUnsubscribes", []);
-      __publicField(this, "emitterOptions");
-      this.emitterOptions = __spreadValues({ publicEmit: false }, e);
-    }
-    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;
-    }
-    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);
+  }
+});
+var NanoEmitter = class {
+  /** Creates a new instance of NanoEmitter - a lightweight event emitter with helper methods and a strongly typed event map */
+  constructor(options = {}) {
+    __publicField(this, "events", createNanoEvents());
+    __publicField(this, "eventUnsubscribes", []);
+    __publicField(this, "emitterOptions");
+    this.emitterOptions = __spreadValues({
+      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 = __spreadValues({
+        allOf: [],
+        oneOf: [],
+        once: false
+      }, opts);
+      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));
       };
-      for (let n of Array.isArray(e) ? e : [e]) {
-        let o = __spreadValues({ 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 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();
-      __publicField(this, "listeners", []);
-      __publicField(this, "activeTimeout");
-      __publicField(this, "queuedCall");
-      this.timeout = t;
-      this.type = i;
-    }
-    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();
+    /** All registered listener functions and the time they were attached */
+    __publicField(this, "listeners", []);
+    /** The currently active timeout */
+    __publicField(this, "activeTimeout");
+    /** The latest queued call */
+    __publicField(this, "queuedCall");
+    this.timeout = timeout;
+    this.type = type;
+  }
+  //#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";
@@ -998,8 +1664,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) {
@@ -1268,7 +1934,7 @@ var openDialogs = [];
 var defaultStrings = {
   closeDialogTooltip: "Click to close the dialog"
 };
-var Dialog = class _Dialog extends (void 0) {
+var Dialog = class _Dialog extends NanoEmitter {
   constructor(options) {
     super();
     /** Options passed to the dialog in the constructor */
@@ -1532,7 +2198,7 @@ var Dialog = class _Dialog extends (void 0) {
 };
 
 // lib/GMStorageEngine.ts
-var GMStorageEngine = class extends (void 0) {
+var GMStorageEngine = class extends DataStoreEngine {
   /**
    * Creates an instance of `GMStorageEngine`.  
    *   
@@ -1617,7 +2283,7 @@ var Mixins = class {
     /** The current auto-increment priority counter */
     __publicField(this, "autoIncPrioCounter", /* @__PURE__ */ new Map());
     var _a, _b, _c;
-    this.defaultMixinCfg = (void 0)({
+    this.defaultMixinCfg = pureObj({
       priority: (_a = config.defaultPriority) != null ? _a : 0,
       stopPropagation: (_b = config.defaultStopPropagation) != null ? _b : false,
       signal: config.defaultSignal
@@ -1633,9 +2299,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)(__spreadValues(__spreadValues(__spreadProps(__spreadValues({}, this.defaultMixinCfg), {
+    const mixin = pureObj(__spreadValues(__spreadValues(__spreadProps(__spreadValues({}, this.defaultMixinCfg), {
       key: mixinKey,
       fn: mixinFn
     }), typeof config === "object" ? config : {}), typeof calcPrio === "number" && !isNaN(calcPrio) ? { priority: calcPrio } : {}));
@@ -1805,7 +2471,7 @@ var SelectorObserver = class {
       debounce: 0
     }, 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