@sv443-network/userutils 10.2.0 → 10.3.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @sv443-network/userutils
 
+## 10.3.0
+
+### Minor Changes
+
+- ffca33d: Updated CoreUtils to v3.5.0, which includes the following changes:
+  - Added function `createTable()` to create a very flexible ASCII table, including ANSI color and `%c` styling support.
+  - Fixed type variance issue in `DataStoreSerializer` where `DataStore` instances with specific data types (e.g. `DataStore<MyType>`) couldn't be passed to the constructor without being asserted `as DataStore<DataStoreData, boolean>`.
+
 ## 10.2.0
 
 ### Minor Changes

package/README.md

@@ -157,6 +157,8 @@ View the documentation of previous major versions:
     - 🟣 [`function pureObj()`](https://github.com/Sv443-Network/CoreUtils/blob/main/docs.md#function-pureobj) - Applies an object's props to a null object (object without prototype chain) or just returns a new null object
     - 🟣 [`function setImmediateInterval()`](https://github.com/Sv443-Network/CoreUtils/blob/main/docs.md#function-setimmediateinterval) - Like `setInterval()`, but instantly calls the callback and supports passing an [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal)
     - 🟣 [`function setImmediateTimeoutLoop()`](https://github.com/Sv443-Network/CoreUtils/blob/main/docs.md#function-setimmediatetimeoutloop) - Like a recursive `setTimeout()` loop, but instantly calls the callback and supports passing an [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal)
+    - 🟣 [`function createRecurringTask()`](https://github.com/Sv443-Network/CoreUtils/blob/main/docs.md#function-createrecurringtask) - Similar to `setImmediateTimeoutLoop()`, but with many more ways of controlling execution.
+      - 🔷 [`type RecurringTaskOptions`](https://github.com/Sv443-Network/CoreUtils/blob/main/docs.md#type-recurringtaskoptions) - Options for the `createRecurringTask()` function.
     - 🟣 [`function scheduleExit()`](https://github.com/Sv443-Network/CoreUtils/blob/main/docs.md#function-scheduleexit) - Schedules a process exit after the next event loop tick, to allow operations like IO writes to finish.
     - 🟣 [`function getCallStack()`](https://github.com/Sv443-Network/CoreUtils/blob/main/docs.md#function-getcallstack) - Returns the current call stack, starting at the caller of this function.
   - [**NanoEmitter:**](https://github.com/Sv443-Network/CoreUtils/blob/main/docs.md#nanoemitter)

package/dist/UserUtils.cjs

@@ -65,6 +65,7 @@ __export(lib_exports, {
   consumeStringGen: () => consumeStringGen,
   createProgressBar: () => createProgressBar,
   createRecurringTask: () => createRecurringTask,
+  createTable: () => createTable,
   currentDialogId: () => currentDialogId,
   darkenColor: () => darkenColor,
   debounce: () => debounce,
@@ -72,6 +73,7 @@ __export(lib_exports, {
   defaultDialogCss: () => defaultDialogCss,
   defaultPbChars: () => defaultPbChars,
   defaultStrings: () => defaultStrings,
+  defaultTableLineCharset: () => defaultTableLineCharset,
   digitCount: () => digitCount,
   fetchAdvanced: () => fetchAdvanced,
   formatNumber: () => formatNumber,
@@ -118,7 +120,7 @@ __export(lib_exports, {
 });
 module.exports = __toCommonJS(lib_exports);
 
-// node_modules/.pnpm/@sv443-network+coreutils@3.4.0/node_modules/@sv443-network/coreutils/dist/CoreUtils.mjs
+// node_modules/.pnpm/@sv443-network+coreutils@3.5.0/node_modules/@sv443-network/coreutils/dist/CoreUtils.mjs
 function bitSetHas(bitSet, checkVal) {
   return (bitSet & checkVal) === checkVal;
 }
@@ -609,6 +611,179 @@ function truncStr(input, length, endStr = "...") {
   const finalStr = str.length > length ? str.substring(0, length - endStr.length) + endStr : str;
   return finalStr.length > length ? finalStr.substring(0, length) : finalStr;
 }
+var defaultTableLineCharset = {
+  single: {
+    horizontal: "\u2500",
+    vertical: "\u2502",
+    topLeft: "\u250C",
+    topRight: "\u2510",
+    bottomLeft: "\u2514",
+    bottomRight: "\u2518",
+    leftT: "\u251C",
+    rightT: "\u2524",
+    topT: "\u252C",
+    bottomT: "\u2534",
+    cross: "\u253C"
+  },
+  double: {
+    horizontal: "\u2550",
+    vertical: "\u2551",
+    topLeft: "\u2554",
+    topRight: "\u2557",
+    bottomLeft: "\u255A",
+    bottomRight: "\u255D",
+    leftT: "\u2560",
+    rightT: "\u2563",
+    topT: "\u2566",
+    bottomT: "\u2569",
+    cross: "\u256C"
+  },
+  none: {
+    horizontal: " ",
+    vertical: " ",
+    topLeft: " ",
+    topRight: " ",
+    bottomLeft: " ",
+    bottomRight: " ",
+    leftT: " ",
+    rightT: " ",
+    topT: " ",
+    bottomT: " ",
+    cross: " "
+  }
+};
+function createTable(rows, options) {
+  var _a2, _b, _c, _d, _e, _f, _g, _h;
+  var _a;
+  const opts = {
+    columnAlign: "left",
+    truncateAbove: Infinity,
+    truncEndStr: "\u2026",
+    minPadding: 1,
+    lineStyle: "single",
+    applyCellStyle: () => void 0,
+    applyLineStyle: () => void 0,
+    lineCharset: defaultTableLineCharset,
+    ...options != null ? options : {}
+  };
+  const defRange = (val, min, max) => clamp(typeof val !== "number" || isNaN(Number(val)) ? min : val, min, max);
+  opts.truncateAbove = defRange(opts.truncateAbove, 0, Infinity);
+  opts.minPadding = defRange(opts.minPadding, 0, Infinity);
+  const lnCh = opts.lineCharset[opts.lineStyle];
+  const stripAnsi = (str) => str.replace(/\u001b\[[0-9;]*m/g, "");
+  const stringRows = rows.map((row) => row.map((cell) => String(cell)));
+  const colCount = (_a2 = (_a = rows[0]) == null ? void 0 : _a.length) != null ? _a2 : 0;
+  if (colCount === 0 || stringRows.length === 0)
+    return "";
+  if (isFinite(opts.truncateAbove)) {
+    const truncAnsi = (str, maxVisible, endStr) => {
+      const limit = maxVisible - endStr.length;
+      if (limit <= 0)
+        return endStr.slice(0, maxVisible);
+      let visible = 0;
+      let result = "";
+      let i = 0;
+      let hasAnsi = false;
+      while (i < str.length) {
+        if (str[i] === "\x1B" && str[i + 1] === "[") {
+          const seqEnd = str.indexOf("m", i + 2);
+          if (seqEnd !== -1) {
+            result += str.slice(i, seqEnd + 1);
+            hasAnsi = true;
+            i = seqEnd + 1;
+            continue;
+          }
+        }
+        if (visible === limit) {
+          result += endStr;
+          if (hasAnsi)
+            result += "\x1B[0m";
+          return result;
+        }
+        result += str[i];
+        visible++;
+        i++;
+      }
+      return result;
+    };
+    for (const row of stringRows)
+      for (let j = 0; j < row.length; j++)
+        if (stripAnsi((_b = row[j]) != null ? _b : "").length > opts.truncateAbove)
+          row[j] = truncAnsi((_c = row[j]) != null ? _c : "", opts.truncateAbove, opts.truncEndStr);
+  }
+  const colWidths = Array.from(
+    { length: colCount },
+    (_, j) => Math.max(0, ...stringRows.map((row) => {
+      var _a3;
+      return stripAnsi((_a3 = row[j]) != null ? _a3 : "").length;
+    }))
+  );
+  const applyLn = (i, j, ch) => {
+    var _a3;
+    const [before = "", after = ""] = (_a3 = opts.applyLineStyle(i, j)) != null ? _a3 : [];
+    return `${before}${ch}${after}`;
+  };
+  const buildBorderRow = (lineIdx, leftCh, midCh, rightCh) => {
+    var _a3;
+    let result = "";
+    let j = 0;
+    result += applyLn(lineIdx, j++, leftCh);
+    for (let col = 0; col < colCount; col++) {
+      const cellWidth = ((_a3 = colWidths[col]) != null ? _a3 : 0) + opts.minPadding * 2;
+      for (let ci = 0; ci < cellWidth; ci++)
+        result += applyLn(lineIdx, j++, lnCh.horizontal);
+      if (col < colCount - 1)
+        result += applyLn(lineIdx, j++, midCh);
+    }
+    result += applyLn(lineIdx, j++, rightCh);
+    return result;
+  };
+  const lines = [];
+  for (let rowIdx = 0; rowIdx < stringRows.length; rowIdx++) {
+    const row = (_d = stringRows[rowIdx]) != null ? _d : [];
+    const lineIdxBase = rowIdx * 3;
+    if (opts.lineStyle !== "none") {
+      lines.push(
+        rowIdx === 0 ? buildBorderRow(lineIdxBase, lnCh.topLeft, lnCh.topT, lnCh.topRight) : buildBorderRow(lineIdxBase, lnCh.leftT, lnCh.cross, lnCh.rightT)
+      );
+    }
+    let contentLine = "";
+    let j = 0;
+    contentLine += applyLn(lineIdxBase + 1, j++, lnCh.vertical);
+    for (let colIdx = 0; colIdx < colCount; colIdx++) {
+      const cell = (_e = row[colIdx]) != null ? _e : "";
+      const visLen = stripAnsi(cell).length;
+      const extra = ((_f = colWidths[colIdx]) != null ? _f : 0) - visLen;
+      const align = (_g = Array.isArray(opts.columnAlign) ? opts.columnAlign[colIdx] : opts.columnAlign) != null ? _g : "left";
+      let leftPad;
+      let rightPad;
+      switch (align) {
+        case "right":
+          leftPad = opts.minPadding + extra;
+          rightPad = opts.minPadding;
+          break;
+        case "centerLeft":
+          leftPad = opts.minPadding + Math.floor(extra / 2);
+          rightPad = opts.minPadding + Math.ceil(extra / 2);
+          break;
+        case "centerRight":
+          leftPad = opts.minPadding + Math.ceil(extra / 2);
+          rightPad = opts.minPadding + Math.floor(extra / 2);
+          break;
+        default:
+          leftPad = opts.minPadding;
+          rightPad = opts.minPadding + extra;
+      }
+      const [cellBefore = "", cellAfter = ""] = (_h = opts.applyCellStyle(rowIdx, colIdx)) != null ? _h : [];
+      contentLine += " ".repeat(leftPad) + cellBefore + cell + cellAfter + " ".repeat(rightPad);
+      contentLine += applyLn(lineIdxBase + 1, j++, lnCh.vertical);
+    }
+    lines.push(contentLine);
+    if (opts.lineStyle !== "none" && rowIdx === stringRows.length - 1)
+      lines.push(buildBorderRow(lineIdxBase + 2, lnCh.bottomLeft, lnCh.bottomT, lnCh.bottomRight));
+  }
+  return lines.join("\n");
+}
 var createNanoEvents = () => ({
   emit(event, ...args) {
     for (let callbacks = this.events[event] || [], i = 0, length = callbacks.length; i < length; i++) {
@@ -1315,6 +1490,7 @@ var FileStorageEngine = class extends DataStoreEngine {
 var DataStoreSerializer = class _DataStoreSerializer {
   constructor(stores, options = {}) {
     __publicField(this, "stores");
+    // eslint-disable-line @typescript-eslint/no-explicit-any
     __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!");
@@ -1558,8 +1734,8 @@ function debounce(fn, timeout = 200, type = "immediate", nanoEmitterOptions) {
 
 // lib/consts.ts
 var rawConsts = {
-  coreUtilsVersion: "3.4.0",
-  userUtilsVersion: "10.2.0"
+  coreUtilsVersion: "3.5.0",
+  userUtilsVersion: "10.3.0"
 };
 function getConst(constKey, defaultVal) {
   const val = rawConsts[constKey];

package/dist/UserUtils.mjs

@@ -2,7 +2,7 @@ var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
-// node_modules/.pnpm/@sv443-network+coreutils@3.4.0/node_modules/@sv443-network/coreutils/dist/CoreUtils.mjs
+// node_modules/.pnpm/@sv443-network+coreutils@3.5.0/node_modules/@sv443-network/coreutils/dist/CoreUtils.mjs
 function bitSetHas(bitSet, checkVal) {
   return (bitSet & checkVal) === checkVal;
 }
@@ -493,6 +493,179 @@ function truncStr(input, length, endStr = "...") {
   const finalStr = str.length > length ? str.substring(0, length - endStr.length) + endStr : str;
   return finalStr.length > length ? finalStr.substring(0, length) : finalStr;
 }
+var defaultTableLineCharset = {
+  single: {
+    horizontal: "\u2500",
+    vertical: "\u2502",
+    topLeft: "\u250C",
+    topRight: "\u2510",
+    bottomLeft: "\u2514",
+    bottomRight: "\u2518",
+    leftT: "\u251C",
+    rightT: "\u2524",
+    topT: "\u252C",
+    bottomT: "\u2534",
+    cross: "\u253C"
+  },
+  double: {
+    horizontal: "\u2550",
+    vertical: "\u2551",
+    topLeft: "\u2554",
+    topRight: "\u2557",
+    bottomLeft: "\u255A",
+    bottomRight: "\u255D",
+    leftT: "\u2560",
+    rightT: "\u2563",
+    topT: "\u2566",
+    bottomT: "\u2569",
+    cross: "\u256C"
+  },
+  none: {
+    horizontal: " ",
+    vertical: " ",
+    topLeft: " ",
+    topRight: " ",
+    bottomLeft: " ",
+    bottomRight: " ",
+    leftT: " ",
+    rightT: " ",
+    topT: " ",
+    bottomT: " ",
+    cross: " "
+  }
+};
+function createTable(rows, options) {
+  var _a2, _b, _c, _d, _e, _f, _g, _h;
+  var _a;
+  const opts = {
+    columnAlign: "left",
+    truncateAbove: Infinity,
+    truncEndStr: "\u2026",
+    minPadding: 1,
+    lineStyle: "single",
+    applyCellStyle: () => void 0,
+    applyLineStyle: () => void 0,
+    lineCharset: defaultTableLineCharset,
+    ...options != null ? options : {}
+  };
+  const defRange = (val, min, max) => clamp(typeof val !== "number" || isNaN(Number(val)) ? min : val, min, max);
+  opts.truncateAbove = defRange(opts.truncateAbove, 0, Infinity);
+  opts.minPadding = defRange(opts.minPadding, 0, Infinity);
+  const lnCh = opts.lineCharset[opts.lineStyle];
+  const stripAnsi = (str) => str.replace(/\u001b\[[0-9;]*m/g, "");
+  const stringRows = rows.map((row) => row.map((cell) => String(cell)));
+  const colCount = (_a2 = (_a = rows[0]) == null ? void 0 : _a.length) != null ? _a2 : 0;
+  if (colCount === 0 || stringRows.length === 0)
+    return "";
+  if (isFinite(opts.truncateAbove)) {
+    const truncAnsi = (str, maxVisible, endStr) => {
+      const limit = maxVisible - endStr.length;
+      if (limit <= 0)
+        return endStr.slice(0, maxVisible);
+      let visible = 0;
+      let result = "";
+      let i = 0;
+      let hasAnsi = false;
+      while (i < str.length) {
+        if (str[i] === "\x1B" && str[i + 1] === "[") {
+          const seqEnd = str.indexOf("m", i + 2);
+          if (seqEnd !== -1) {
+            result += str.slice(i, seqEnd + 1);
+            hasAnsi = true;
+            i = seqEnd + 1;
+            continue;
+          }
+        }
+        if (visible === limit) {
+          result += endStr;
+          if (hasAnsi)
+            result += "\x1B[0m";
+          return result;
+        }
+        result += str[i];
+        visible++;
+        i++;
+      }
+      return result;
+    };
+    for (const row of stringRows)
+      for (let j = 0; j < row.length; j++)
+        if (stripAnsi((_b = row[j]) != null ? _b : "").length > opts.truncateAbove)
+          row[j] = truncAnsi((_c = row[j]) != null ? _c : "", opts.truncateAbove, opts.truncEndStr);
+  }
+  const colWidths = Array.from(
+    { length: colCount },
+    (_, j) => Math.max(0, ...stringRows.map((row) => {
+      var _a3;
+      return stripAnsi((_a3 = row[j]) != null ? _a3 : "").length;
+    }))
+  );
+  const applyLn = (i, j, ch) => {
+    var _a3;
+    const [before = "", after = ""] = (_a3 = opts.applyLineStyle(i, j)) != null ? _a3 : [];
+    return `${before}${ch}${after}`;
+  };
+  const buildBorderRow = (lineIdx, leftCh, midCh, rightCh) => {
+    var _a3;
+    let result = "";
+    let j = 0;
+    result += applyLn(lineIdx, j++, leftCh);
+    for (let col = 0; col < colCount; col++) {
+      const cellWidth = ((_a3 = colWidths[col]) != null ? _a3 : 0) + opts.minPadding * 2;
+      for (let ci = 0; ci < cellWidth; ci++)
+        result += applyLn(lineIdx, j++, lnCh.horizontal);
+      if (col < colCount - 1)
+        result += applyLn(lineIdx, j++, midCh);
+    }
+    result += applyLn(lineIdx, j++, rightCh);
+    return result;
+  };
+  const lines = [];
+  for (let rowIdx = 0; rowIdx < stringRows.length; rowIdx++) {
+    const row = (_d = stringRows[rowIdx]) != null ? _d : [];
+    const lineIdxBase = rowIdx * 3;
+    if (opts.lineStyle !== "none") {
+      lines.push(
+        rowIdx === 0 ? buildBorderRow(lineIdxBase, lnCh.topLeft, lnCh.topT, lnCh.topRight) : buildBorderRow(lineIdxBase, lnCh.leftT, lnCh.cross, lnCh.rightT)
+      );
+    }
+    let contentLine = "";
+    let j = 0;
+    contentLine += applyLn(lineIdxBase + 1, j++, lnCh.vertical);
+    for (let colIdx = 0; colIdx < colCount; colIdx++) {
+      const cell = (_e = row[colIdx]) != null ? _e : "";
+      const visLen = stripAnsi(cell).length;
+      const extra = ((_f = colWidths[colIdx]) != null ? _f : 0) - visLen;
+      const align = (_g = Array.isArray(opts.columnAlign) ? opts.columnAlign[colIdx] : opts.columnAlign) != null ? _g : "left";
+      let leftPad;
+      let rightPad;
+      switch (align) {
+        case "right":
+          leftPad = opts.minPadding + extra;
+          rightPad = opts.minPadding;
+          break;
+        case "centerLeft":
+          leftPad = opts.minPadding + Math.floor(extra / 2);
+          rightPad = opts.minPadding + Math.ceil(extra / 2);
+          break;
+        case "centerRight":
+          leftPad = opts.minPadding + Math.ceil(extra / 2);
+          rightPad = opts.minPadding + Math.floor(extra / 2);
+          break;
+        default:
+          leftPad = opts.minPadding;
+          rightPad = opts.minPadding + extra;
+      }
+      const [cellBefore = "", cellAfter = ""] = (_h = opts.applyCellStyle(rowIdx, colIdx)) != null ? _h : [];
+      contentLine += " ".repeat(leftPad) + cellBefore + cell + cellAfter + " ".repeat(rightPad);
+      contentLine += applyLn(lineIdxBase + 1, j++, lnCh.vertical);
+    }
+    lines.push(contentLine);
+    if (opts.lineStyle !== "none" && rowIdx === stringRows.length - 1)
+      lines.push(buildBorderRow(lineIdxBase + 2, lnCh.bottomLeft, lnCh.bottomT, lnCh.bottomRight));
+  }
+  return lines.join("\n");
+}
 var createNanoEvents = () => ({
   emit(event, ...args) {
     for (let callbacks = this.events[event] || [], i = 0, length = callbacks.length; i < length; i++) {
@@ -1199,6 +1372,7 @@ var FileStorageEngine = class extends DataStoreEngine {
 var DataStoreSerializer = class _DataStoreSerializer {
   constructor(stores, options = {}) {
     __publicField(this, "stores");
+    // eslint-disable-line @typescript-eslint/no-explicit-any
     __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!");
@@ -1442,8 +1616,8 @@ function debounce(fn, timeout = 200, type = "immediate", nanoEmitterOptions) {
 
 // lib/consts.ts
 var rawConsts = {
-  coreUtilsVersion: "3.4.0",
-  userUtilsVersion: "10.2.0"
+  coreUtilsVersion: "3.5.0",
+  userUtilsVersion: "10.3.0"
 };
 function getConst(constKey, defaultVal) {
   const val = rawConsts[constKey];
@@ -2678,6 +2852,7 @@ export {
   consumeStringGen,
   createProgressBar,
   createRecurringTask,
+  createTable,
   currentDialogId,
   darkenColor,
   debounce,
@@ -2685,6 +2860,7 @@ export {
   defaultDialogCss,
   defaultPbChars,
   defaultStrings,
+  defaultTableLineCharset,
   digitCount,
   fetchAdvanced,
   formatNumber,

package/dist/UserUtils.umd.js

@@ -132,6 +132,7 @@ __export(lib_exports, {
   consumeStringGen: () => consumeStringGen,
   createProgressBar: () => createProgressBar,
   createRecurringTask: () => createRecurringTask,
+  createTable: () => createTable,
   currentDialogId: () => currentDialogId,
   darkenColor: () => darkenColor,
   debounce: () => debounce,
@@ -139,6 +140,7 @@ __export(lib_exports, {
   defaultDialogCss: () => defaultDialogCss,
   defaultPbChars: () => defaultPbChars,
   defaultStrings: () => defaultStrings,
+  defaultTableLineCharset: () => defaultTableLineCharset,
   digitCount: () => digitCount,
   fetchAdvanced: () => fetchAdvanced,
   formatNumber: () => formatNumber,
@@ -185,7 +187,7 @@ __export(lib_exports, {
 });
 module.exports = __toCommonJS(lib_exports);
 
-// node_modules/.pnpm/@sv443-network+coreutils@3.4.0/node_modules/@sv443-network/coreutils/dist/CoreUtils.mjs
+// node_modules/.pnpm/@sv443-network+coreutils@3.5.0/node_modules/@sv443-network/coreutils/dist/CoreUtils.mjs
 function bitSetHas(bitSet, checkVal) {
   return (bitSet & checkVal) === checkVal;
 }
@@ -685,6 +687,178 @@ function truncStr(input, length, endStr = "...") {
   const finalStr = str.length > length ? str.substring(0, length - endStr.length) + endStr : str;
   return finalStr.length > length ? finalStr.substring(0, length) : finalStr;
 }
+var defaultTableLineCharset = {
+  single: {
+    horizontal: "\u2500",
+    vertical: "\u2502",
+    topLeft: "\u250C",
+    topRight: "\u2510",
+    bottomLeft: "\u2514",
+    bottomRight: "\u2518",
+    leftT: "\u251C",
+    rightT: "\u2524",
+    topT: "\u252C",
+    bottomT: "\u2534",
+    cross: "\u253C"
+  },
+  double: {
+    horizontal: "\u2550",
+    vertical: "\u2551",
+    topLeft: "\u2554",
+    topRight: "\u2557",
+    bottomLeft: "\u255A",
+    bottomRight: "\u255D",
+    leftT: "\u2560",
+    rightT: "\u2563",
+    topT: "\u2566",
+    bottomT: "\u2569",
+    cross: "\u256C"
+  },
+  none: {
+    horizontal: " ",
+    vertical: " ",
+    topLeft: " ",
+    topRight: " ",
+    bottomLeft: " ",
+    bottomRight: " ",
+    leftT: " ",
+    rightT: " ",
+    topT: " ",
+    bottomT: " ",
+    cross: " "
+  }
+};
+function createTable(rows, options) {
+  var _a2, _b, _c, _d, _e, _f, _g, _h;
+  var _a;
+  const opts = __spreadValues({
+    columnAlign: "left",
+    truncateAbove: Infinity,
+    truncEndStr: "\u2026",
+    minPadding: 1,
+    lineStyle: "single",
+    applyCellStyle: () => void 0,
+    applyLineStyle: () => void 0,
+    lineCharset: defaultTableLineCharset
+  }, options != null ? options : {});
+  const defRange = (val, min, max) => clamp(typeof val !== "number" || isNaN(Number(val)) ? min : val, min, max);
+  opts.truncateAbove = defRange(opts.truncateAbove, 0, Infinity);
+  opts.minPadding = defRange(opts.minPadding, 0, Infinity);
+  const lnCh = opts.lineCharset[opts.lineStyle];
+  const stripAnsi = (str) => str.replace(/\u001b\[[0-9;]*m/g, "");
+  const stringRows = rows.map((row) => row.map((cell) => String(cell)));
+  const colCount = (_a2 = (_a = rows[0]) == null ? void 0 : _a.length) != null ? _a2 : 0;
+  if (colCount === 0 || stringRows.length === 0)
+    return "";
+  if (isFinite(opts.truncateAbove)) {
+    const truncAnsi = (str, maxVisible, endStr) => {
+      const limit = maxVisible - endStr.length;
+      if (limit <= 0)
+        return endStr.slice(0, maxVisible);
+      let visible = 0;
+      let result = "";
+      let i = 0;
+      let hasAnsi = false;
+      while (i < str.length) {
+        if (str[i] === "\x1B" && str[i + 1] === "[") {
+          const seqEnd = str.indexOf("m", i + 2);
+          if (seqEnd !== -1) {
+            result += str.slice(i, seqEnd + 1);
+            hasAnsi = true;
+            i = seqEnd + 1;
+            continue;
+          }
+        }
+        if (visible === limit) {
+          result += endStr;
+          if (hasAnsi)
+            result += "\x1B[0m";
+          return result;
+        }
+        result += str[i];
+        visible++;
+        i++;
+      }
+      return result;
+    };
+    for (const row of stringRows)
+      for (let j = 0; j < row.length; j++)
+        if (stripAnsi((_b = row[j]) != null ? _b : "").length > opts.truncateAbove)
+          row[j] = truncAnsi((_c = row[j]) != null ? _c : "", opts.truncateAbove, opts.truncEndStr);
+  }
+  const colWidths = Array.from(
+    { length: colCount },
+    (_, j) => Math.max(0, ...stringRows.map((row) => {
+      var _a3;
+      return stripAnsi((_a3 = row[j]) != null ? _a3 : "").length;
+    }))
+  );
+  const applyLn = (i, j, ch) => {
+    var _a3;
+    const [before = "", after = ""] = (_a3 = opts.applyLineStyle(i, j)) != null ? _a3 : [];
+    return `${before}${ch}${after}`;
+  };
+  const buildBorderRow = (lineIdx, leftCh, midCh, rightCh) => {
+    var _a3;
+    let result = "";
+    let j = 0;
+    result += applyLn(lineIdx, j++, leftCh);
+    for (let col = 0; col < colCount; col++) {
+      const cellWidth = ((_a3 = colWidths[col]) != null ? _a3 : 0) + opts.minPadding * 2;
+      for (let ci = 0; ci < cellWidth; ci++)
+        result += applyLn(lineIdx, j++, lnCh.horizontal);
+      if (col < colCount - 1)
+        result += applyLn(lineIdx, j++, midCh);
+    }
+    result += applyLn(lineIdx, j++, rightCh);
+    return result;
+  };
+  const lines = [];
+  for (let rowIdx = 0; rowIdx < stringRows.length; rowIdx++) {
+    const row = (_d = stringRows[rowIdx]) != null ? _d : [];
+    const lineIdxBase = rowIdx * 3;
+    if (opts.lineStyle !== "none") {
+      lines.push(
+        rowIdx === 0 ? buildBorderRow(lineIdxBase, lnCh.topLeft, lnCh.topT, lnCh.topRight) : buildBorderRow(lineIdxBase, lnCh.leftT, lnCh.cross, lnCh.rightT)
+      );
+    }
+    let contentLine = "";
+    let j = 0;
+    contentLine += applyLn(lineIdxBase + 1, j++, lnCh.vertical);
+    for (let colIdx = 0; colIdx < colCount; colIdx++) {
+      const cell = (_e = row[colIdx]) != null ? _e : "";
+      const visLen = stripAnsi(cell).length;
+      const extra = ((_f = colWidths[colIdx]) != null ? _f : 0) - visLen;
+      const align = (_g = Array.isArray(opts.columnAlign) ? opts.columnAlign[colIdx] : opts.columnAlign) != null ? _g : "left";
+      let leftPad;
+      let rightPad;
+      switch (align) {
+        case "right":
+          leftPad = opts.minPadding + extra;
+          rightPad = opts.minPadding;
+          break;
+        case "centerLeft":
+          leftPad = opts.minPadding + Math.floor(extra / 2);
+          rightPad = opts.minPadding + Math.ceil(extra / 2);
+          break;
+        case "centerRight":
+          leftPad = opts.minPadding + Math.ceil(extra / 2);
+          rightPad = opts.minPadding + Math.floor(extra / 2);
+          break;
+        default:
+          leftPad = opts.minPadding;
+          rightPad = opts.minPadding + extra;
+      }
+      const [cellBefore = "", cellAfter = ""] = (_h = opts.applyCellStyle(rowIdx, colIdx)) != null ? _h : [];
+      contentLine += " ".repeat(leftPad) + cellBefore + cell + cellAfter + " ".repeat(rightPad);
+      contentLine += applyLn(lineIdxBase + 1, j++, lnCh.vertical);
+    }
+    lines.push(contentLine);
+    if (opts.lineStyle !== "none" && rowIdx === stringRows.length - 1)
+      lines.push(buildBorderRow(lineIdxBase + 2, lnCh.bottomLeft, lnCh.bottomT, lnCh.bottomRight));
+  }
+  return lines.join("\n");
+}
 var createNanoEvents = () => ({
   emit(event, ...args) {
     for (let callbacks = this.events[event] || [], i = 0, length = callbacks.length; i < length; i++) {
@@ -1423,6 +1597,7 @@ var FileStorageEngine = class extends DataStoreEngine {
 var DataStoreSerializer = class _DataStoreSerializer {
   constructor(stores, options = {}) {
     __publicField(this, "stores");
+    // eslint-disable-line @typescript-eslint/no-explicit-any
     __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!");
@@ -1683,8 +1858,8 @@ function debounce(fn, timeout = 200, type = "immediate", nanoEmitterOptions) {
 
 // lib/consts.ts
 var rawConsts = {
-  coreUtilsVersion: "3.4.0",
-  userUtilsVersion: "10.2.0"
+  coreUtilsVersion: "3.5.0",
+  userUtilsVersion: "10.3.0"
 };
 function getConst(constKey, defaultVal) {
   const val = rawConsts[constKey];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sv443-network/userutils",
   "libName": "UserUtils",
-  "version": "10.2.0",
+  "version": "10.3.0",
   "description": "General purpose DOM/GreaseMonkey library that allows you to register listeners for when CSS selectors exist, intercept events, create persistent & synchronous data stores, modify the DOM more easily and much more",
   "main": "dist/UserUtils.mjs",
   "module": "dist/UserUtils.mjs",
@@ -33,7 +33,7 @@
   },
   "homepage": "https://github.com/Sv443-Network/UserUtils",
   "dependencies": {
-    "@sv443-network/coreutils": "3.4.0",
+    "@sv443-network/coreutils": "3.5.0",
     "nanoevents": "9.1.0"
   },
   "devDependencies": {