@ztimson/utils 0.28.15 → 0.28.17

package/dist/index.cjs

@@ -2,6 +2,193 @@
   typeof exports === "object" && typeof module !== "undefined" ? factory(exports) : typeof define === "function" && define.amd ? define(["exports"], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global.utils = {}));
 })(this, (function(exports2) {
   "use strict";
+  var dist = {};
+  var persist = {};
+  var hasRequiredPersist;
+  function requirePersist() {
+    if (hasRequiredPersist) return persist;
+    hasRequiredPersist = 1;
+    Object.defineProperty(persist, "__esModule", { value: true });
+    persist.persist = persist.Persist = void 0;
+    class Persist {
+      key;
+      options;
+      /** Backend service to store data, must implement `Storage` interface */
+      storage;
+      /** Listeners which should be notified on changes */
+      watches = {};
+      /** Private value field */
+      _value;
+      /** Current value or default if undefined */
+      get value() {
+        return this._value !== void 0 ? this._value : this.options?.default;
+      }
+      /** Set value with proxy object wrapper to sync future changes */
+      set value(v) {
+        if (v == null || typeof v != "object")
+          this._value = v;
+        else
+          this._value = new Proxy(v, {
+            get: (target, p) => {
+              const f = typeof target[p] == "function";
+              if (!f)
+                return target[p];
+              return (...args) => {
+                const value = target[p](...args);
+                this.save();
+                return value;
+              };
+            },
+            set: (target, p, newValue) => {
+              target[p] = newValue;
+              this.save();
+              return true;
+            }
+          });
+        this.save();
+      }
+      /**
+       * @param {string} key Primary key value will be stored under
+       * @param {PersistOptions<T>} options Configure using {@link PersistOptions}
+       */
+      constructor(key, options = {}) {
+        this.key = key;
+        this.options = options;
+        this.storage = options.storage || localStorage;
+        this.load();
+      }
+      /** Notify listeners of change */
+      notify(value) {
+        Object.values(this.watches).forEach((watch) => watch(value));
+      }
+      /** Delete value from storage */
+      clear() {
+        this.storage.removeItem(this.key);
+      }
+      /** Save current value to storage */
+      save() {
+        if (this._value === void 0)
+          this.clear();
+        else
+          this.storage.setItem(this.key, JSON.stringify(this._value));
+        this.notify(this.value);
+      }
+      /** Load value from storage */
+      load() {
+        if (this.storage[this.key] != void 0) {
+          let value = JSON.parse(this.storage.getItem(this.key));
+          if (value != null && typeof value == "object" && this.options.type)
+            value.__proto__ = this.options.type.prototype;
+          this.value = value;
+        } else
+          this.value = this.options.default || void 0;
+      }
+      /**
+       * Callback function which is run when there are changes
+       *
+       * @param {(value: T) => any} fn Callback will run on each change; it's passed the next value & it's return is ignored
+       * @returns {() => void} Function which will unsubscribe the watch/callback when called
+       */
+      watch(fn2) {
+        const index = Object.keys(this.watches).length;
+        this.watches[index] = fn2;
+        return () => {
+          delete this.watches[index];
+        };
+      }
+      /**
+       * Return value as JSON string
+       *
+       * @returns {string} Stringified object as JSON
+       */
+      toString() {
+        return JSON.stringify(this.value);
+      }
+      /**
+       * Return current value
+       *
+       * @returns {T} Current value
+       */
+      valueOf() {
+        return this.value;
+      }
+    }
+    persist.Persist = Persist;
+    function persist$1(options) {
+      return (target, prop) => {
+        const key = options?.key || `${target.constructor.name}.${prop.toString()}`;
+        const wrapper = new Persist(key, options);
+        Object.defineProperty(target, prop, {
+          get: function() {
+            return wrapper.value;
+          },
+          set: function(v) {
+            wrapper.value = v;
+          }
+        });
+      };
+    }
+    persist.persist = persist$1;
+    return persist;
+  }
+  var memoryStorage = {};
+  var hasRequiredMemoryStorage;
+  function requireMemoryStorage() {
+    if (hasRequiredMemoryStorage) return memoryStorage;
+    hasRequiredMemoryStorage = 1;
+    Object.defineProperty(memoryStorage, "__esModule", { value: true });
+    memoryStorage.MemoryStorage = void 0;
+    class MemoryStorage {
+      get length() {
+        return Object.keys(this).length;
+      }
+      clear() {
+        Object.keys(this).forEach((k) => this.removeItem(k));
+      }
+      getItem(key) {
+        return this[key];
+      }
+      key(index) {
+        return Object.keys(this)[index];
+      }
+      removeItem(key) {
+        delete this[key];
+      }
+      setItem(key, value) {
+        this[key] = value;
+      }
+    }
+    memoryStorage.MemoryStorage = MemoryStorage;
+    return memoryStorage;
+  }
+  var hasRequiredDist;
+  function requireDist() {
+    if (hasRequiredDist) return dist;
+    hasRequiredDist = 1;
+    (function(exports$1) {
+      var __createBinding = dist && dist.__createBinding || (Object.create ? (function(o, m, k, k2) {
+        if (k2 === void 0) k2 = k;
+        var desc = Object.getOwnPropertyDescriptor(m, k);
+        if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+          desc = { enumerable: true, get: function() {
+            return m[k];
+          } };
+        }
+        Object.defineProperty(o, k2, desc);
+      }) : (function(o, m, k, k2) {
+        if (k2 === void 0) k2 = k;
+        o[k2] = m[k];
+      }));
+      var __exportStar = dist && dist.__exportStar || function(m, exports$12) {
+        for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports$12, p)) __createBinding(exports$12, m, p);
+      };
+      Object.defineProperty(exports$1, "__esModule", { value: true });
+      __exportStar(requirePersist(), exports$1);
+      __exportStar(requireMemoryStorage(), exports$1);
+    })(dist);
+    return dist;
+  }
+  requireDist();
   class ArgParser {
     /**
      * Create a unix-like argument parser to extract flags from the argument list. Can also create help messages.
@@ -30,6 +217,10 @@
         `--help ${this.commands.length ? "[COMMAND]" : ""}`
       ].filter((e) => !!e);
     }
+    name;
+    desc;
+    argList;
+    examples;
     commands = [];
     args = [];
     flags = [];
@@ -493,6 +684,8 @@ ${opts.message || this.desc}`;
         }
       });
     }
+    key;
+    options;
     _loading;
     store = /* @__PURE__ */ new Map();
     timers = /* @__PURE__ */ new Map();
@@ -773,6 +966,9 @@ ${opts.message || this.desc}`;
     const pascal = pascalCase(str);
     return pascal.charAt(0).toLowerCase() + pascal.slice(1);
   }
+  function decodeHtml(html) {
+    return html.replace(/&nbsp;/g, " ").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&cent;/g, "¢").replace(/&pound;/g, "£").replace(/&yen;/g, "¥").replace(/&euro;/g, "€").replace(/&copy;/g, "©").replace(/&reg;/g, "®").replace(/&trade;/g, "™").replace(/&times;/g, "×").replace(/&divide;/g, "÷").replace(/&#(\d+);/g, (match, dec) => String.fromCharCode(dec)).replace(/&#x([0-9a-fA-F]+);/g, (match, hex) => String.fromCharCode(parseInt(hex, 16))).replace(/&amp;/g, "&");
+  }
   function formatBytes(bytes, decimals = 2) {
     if (bytes === 0) return "0 Bytes";
     const k = 1024;
@@ -1275,6 +1471,8 @@ ${opts.message || this.desc}`;
         };
       });
     }
+    database;
+    version;
     schemaLock = new AsyncLock();
     upgrading = false;
     connection;
@@ -1326,6 +1524,9 @@ ${opts.message || this.desc}`;
         if (!exists) this.database.createTable(this.name);
       });
     }
+    database;
+    name;
+    key;
     async tx(table, fn2, readonly = false) {
       await this.database.waitForUpgrade();
       const db = await this.database.connection;
@@ -1868,6 +2069,7 @@ ${opts.message || this.desc}`;
       super();
       this.namespace = namespace;
     }
+    namespace;
     static LOG_LEVEL = 4;
     format(...text) {
       const now = /* @__PURE__ */ new Date();
@@ -2298,6 +2500,7 @@ ${opts.message || this.desc}`;
     constructor(prefix = "") {
       this.prefix = prefix;
     }
+    prefix;
     listeners = [];
     emit(event, ...args) {
       const parsed = event instanceof PathEvent ? event : new PathEvent(`${this.prefix}/${event}`);
@@ -2810,193 +3013,114 @@ ${err.message || err.toString()}`);
       };
     }
   }
-  var dist = {};
-  var persist = {};
-  var hasRequiredPersist;
-  function requirePersist() {
-    if (hasRequiredPersist) return persist;
-    hasRequiredPersist = 1;
-    Object.defineProperty(persist, "__esModule", { value: true });
-    persist.persist = persist.Persist = void 0;
-    class Persist {
-      key;
-      options;
-      /** Backend service to store data, must implement `Storage` interface */
-      storage;
-      /** Listeners which should be notified on changes */
-      watches = {};
-      /** Private value field */
-      _value;
-      /** Current value or default if undefined */
-      get value() {
-        return this._value !== void 0 ? this._value : this.options?.default;
-      }
-      /** Set value with proxy object wrapper to sync future changes */
-      set value(v) {
-        if (v == null || typeof v != "object")
-          this._value = v;
-        else
-          this._value = new Proxy(v, {
-            get: (target, p) => {
-              const f = typeof target[p] == "function";
-              if (!f)
-                return target[p];
-              return (...args) => {
-                const value = target[p](...args);
-                this.save();
-                return value;
-              };
-            },
-            set: (target, p, newValue) => {
-              target[p] = newValue;
-              this.save();
-              return true;
-            }
-          });
-        this.save();
-      }
-      /**
-       * @param {string} key Primary key value will be stored under
-       * @param {PersistOptions<T>} options Configure using {@link PersistOptions}
-       */
-      constructor(key, options = {}) {
-        this.key = key;
-        this.options = options;
-        this.storage = options.storage || localStorage;
-        this.load();
-      }
-      /** Notify listeners of change */
-      notify(value) {
-        Object.values(this.watches).forEach((watch) => watch(value));
-      }
-      /** Delete value from storage */
-      clear() {
-        this.storage.removeItem(this.key);
-      }
-      /** Save current value to storage */
-      save() {
-        if (this._value === void 0)
-          this.clear();
-        else
-          this.storage.setItem(this.key, JSON.stringify(this._value));
-        this.notify(this.value);
-      }
-      /** Load value from storage */
-      load() {
-        if (this.storage[this.key] != void 0) {
-          let value = JSON.parse(this.storage.getItem(this.key));
-          if (value != null && typeof value == "object" && this.options.type)
-            value.__proto__ = this.options.type.prototype;
-          this.value = value;
-        } else
-          this.value = this.options.default || void 0;
-      }
-      /**
-       * Callback function which is run when there are changes
-       *
-       * @param {(value: T) => any} fn Callback will run on each change; it's passed the next value & it's return is ignored
-       * @returns {() => void} Function which will unsubscribe the watch/callback when called
-       */
-      watch(fn2) {
-        const index = Object.keys(this.watches).length;
-        this.watches[index] = fn2;
-        return () => {
-          delete this.watches[index];
-        };
-      }
-      /**
-       * Return value as JSON string
-       *
-       * @returns {string} Stringified object as JSON
-       */
-      toString() {
-        return JSON.stringify(this.value);
-      }
-      /**
-       * Return current value
-       *
-       * @returns {T} Current value
-       */
-      valueOf() {
-        return this.value;
+  function fromXml(xml) {
+    xml = xml.trim();
+    let pos = 0;
+    function parseNode() {
+      skipWhitespace();
+      if (xml[pos] !== "<") return parseText();
+      pos++;
+      if (xml[pos] === "?") {
+        parseDeclaration();
+        return parseNode();
+      }
+      if (xml[pos] === "!") {
+        parseComment();
+        return parseNode();
+      }
+      const tagName = parseTagName();
+      const attributes = parseAttributes();
+      skipWhitespace();
+      if (xml[pos] === "/" && xml[pos + 1] === ">") {
+        pos += 2;
+        return { tag: tagName, attributes, children: [] };
+      }
+      pos++;
+      const children = [];
+      while (pos < xml.length) {
+        skipWhitespace();
+        if (xml[pos] === "<" && xml[pos + 1] === "/") {
+          pos += 2;
+          parseTagName();
+          skipWhitespace();
+          pos++;
+          break;
+        }
+        const child = parseNode();
+        if (child) children.push(child);
+      }
+      return { tag: tagName, attributes, children };
+    }
+    function parseTagName() {
+      let name = "";
+      while (pos < xml.length && /[a-zA-Z0-9_:-]/.test(xml[pos])) name += xml[pos++];
+      return name;
+    }
+    function parseAttributes() {
+      const attrs = {};
+      while (pos < xml.length) {
+        skipWhitespace();
+        if (xml[pos] === ">" || xml[pos] === "/") break;
+        const name = parseTagName();
+        skipWhitespace();
+        if (xml[pos] === "=") {
+          pos++;
+          skipWhitespace();
+          const quote = xml[pos++];
+          let value = "";
+          while (xml[pos] !== quote) value += xml[pos++];
+          pos++;
+          attrs[name] = escapeXml(value, true);
+        }
       }
+      return attrs;
     }
-    persist.Persist = Persist;
-    function persist$1(options) {
-      return (target, prop) => {
-        const key = options?.key || `${target.constructor.name}.${prop.toString()}`;
-        const wrapper = new Persist(key, options);
-        Object.defineProperty(target, prop, {
-          get: function() {
-            return wrapper.value;
-          },
-          set: function(v) {
-            wrapper.value = v;
-          }
-        });
-      };
+    function parseText() {
+      let text = "";
+      while (pos < xml.length && xml[pos] !== "<") text += xml[pos++];
+      text = text.trim();
+      return text ? escapeXml(text, true) : null;
     }
-    persist.persist = persist$1;
-    return persist;
+    function parseDeclaration() {
+      while (xml[pos] !== ">") pos++;
+      pos++;
+    }
+    function parseComment() {
+      while (!(xml[pos] === "-" && xml[pos + 1] === "-" && xml[pos + 2] === ">")) pos++;
+      pos += 3;
+    }
+    function skipWhitespace() {
+      while (pos < xml.length && /\s/.test(xml[pos])) pos++;
+    }
+    return parseNode();
   }
-  var memoryStorage = {};
-  var hasRequiredMemoryStorage;
-  function requireMemoryStorage() {
-    if (hasRequiredMemoryStorage) return memoryStorage;
-    hasRequiredMemoryStorage = 1;
-    Object.defineProperty(memoryStorage, "__esModule", { value: true });
-    memoryStorage.MemoryStorage = void 0;
-    class MemoryStorage {
-      get length() {
-        return Object.keys(this).length;
-      }
-      clear() {
-        Object.keys(this).forEach((k) => this.removeItem(k));
-      }
-      getItem(key) {
-        return this[key];
-      }
-      key(index) {
-        return Object.keys(this)[index];
-      }
-      removeItem(key) {
-        delete this[key];
-      }
-      setItem(key, value) {
-        this[key] = value;
-      }
+  function toXml(obj, indent = "") {
+    if (typeof obj === "string") return escapeXml(obj);
+    const { tag, attributes = {}, children = [] } = obj;
+    let xml = `${indent}<${tag}`;
+    for (const [key, value] of Object.entries(attributes))
+      xml += ` ${key}="${escapeXml(value)}"`;
+    if (children.length === 0) {
+      xml += " />";
+      return xml;
     }
-    memoryStorage.MemoryStorage = MemoryStorage;
-    return memoryStorage;
+    xml += ">";
+    const hasComplexChildren = children.some((c) => typeof c === "object");
+    for (const child of children) {
+      if (hasComplexChildren) xml += "\n";
+      xml += toXml(child, hasComplexChildren ? indent + "  " : "");
+    }
+    if (hasComplexChildren) xml += `
+${indent}`;
+    xml += `</${tag}>`;
+    return xml;
   }
-  var hasRequiredDist;
-  function requireDist() {
-    if (hasRequiredDist) return dist;
-    hasRequiredDist = 1;
-    (function(exports$1) {
-      var __createBinding = dist && dist.__createBinding || (Object.create ? (function(o, m, k, k2) {
-        if (k2 === void 0) k2 = k;
-        var desc = Object.getOwnPropertyDescriptor(m, k);
-        if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-          desc = { enumerable: true, get: function() {
-            return m[k];
-          } };
-        }
-        Object.defineProperty(o, k2, desc);
-      }) : (function(o, m, k, k2) {
-        if (k2 === void 0) k2 = k;
-        o[k2] = m[k];
-      }));
-      var __exportStar = dist && dist.__exportStar || function(m, exports$12) {
-        for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports$12, p)) __createBinding(exports$12, m, p);
-      };
-      Object.defineProperty(exports$1, "__esModule", { value: true });
-      __exportStar(requirePersist(), exports$1);
-      __exportStar(requireMemoryStorage(), exports$1);
-    })(dist);
-    return dist;
+  function escapeXml(str, decode = false) {
+    if (decode) {
+      return str.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&amp;/g, "&");
+    }
+    return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
   }
-  requireDist();
   exports2.ASet = ASet;
   exports2.ArgParser = ArgParser;
   exports2.BadGatewayError = BadGatewayError;
@@ -3054,6 +3178,7 @@ ${err.message || err.toString()}`);
   exports2.dayOfYear = dayOfYear;
   exports2.dec2Frac = dec2Frac;
   exports2.dec2Hex = dec2Hex;
+  exports2.decodeHtml = decodeHtml;
   exports2.decodeJwt = decodeJwt;
   exports2.deepCopy = deepCopy;
   exports2.deepMerge = deepMerge;
@@ -3063,6 +3188,7 @@ ${err.message || err.toString()}`);
   exports2.encodeQuery = encodeQuery;
   exports2.errorFromCode = errorFromCode;
   exports2.escapeRegex = escapeRegex;
+  exports2.escapeXml = escapeXml;
   exports2.fileBrowser = fileBrowser;
   exports2.fileText = fileText;
   exports2.findByProp = findByProp;
@@ -3077,6 +3203,7 @@ ${err.message || err.toString()}`);
   exports2.formatPhoneNumber = formatPhoneNumber;
   exports2.frac2Dec = frac2Dec;
   exports2.fromCsv = fromCsv;
+  exports2.fromXml = fromXml;
   exports2.gravatar = gravatar;
   exports2.hex2Int = hex2Int;
   exports2.hue2rgb = hue2rgb;
@@ -3117,6 +3244,7 @@ ${err.message || err.toString()}`);
   exports2.timestampFilename = timestampFilename;
   exports2.timezoneOffset = timezoneOffset;
   exports2.toCsv = toCsv;
+  exports2.toXml = toXml;
   exports2.uploadWithProgress = uploadWithProgress;
   exports2.validateEmail = validateEmail;
   exports2.wordSegments = wordSegments;