@ztimson/utils 0.28.15 → 0.28.17

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from 'var-persist';
 export * from './arg-parser';
 export * from './array';
 export * from './aset';
@@ -23,4 +24,4 @@ export * from './template';
 export * from './time';
 export * from './tts';
 export * from './types';
-export * from 'var-persist';
+export * from './xml';

package/dist/index.mjs

@@ -1,3 +1,190 @@
+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.
@@ -26,6 +213,10 @@ class ArgParser {
       `--help ${this.commands.length ? "[COMMAND]" : ""}`
     ].filter((e) => !!e);
   }
+  name;
+  desc;
+  argList;
+  examples;
   commands = [];
   args = [];
   flags = [];
@@ -489,6 +680,8 @@ class Cache {
       }
     });
   }
+  key;
+  options;
   _loading;
   store = /* @__PURE__ */ new Map();
   timers = /* @__PURE__ */ new Map();
@@ -769,6 +962,9 @@ function camelCase(str) {
   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;
@@ -1271,6 +1467,8 @@ class Database {
       };
     });
   }
+  database;
+  version;
   schemaLock = new AsyncLock();
   upgrading = false;
   connection;
@@ -1322,6 +1520,9 @@ class Table {
       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;
@@ -1864,6 +2065,7 @@ class Logger extends TypedEmitter {
     super();
     this.namespace = namespace;
   }
+  namespace;
   static LOG_LEVEL = 4;
   format(...text) {
     const now = /* @__PURE__ */ new Date();
@@ -2294,6 +2496,7 @@ class PathEventEmitter {
   constructor(prefix = "") {
     this.prefix = prefix;
   }
+  prefix;
   listeners = [];
   emit(event, ...args) {
     const parsed = event instanceof PathEvent ? event : new PathEvent(`${this.prefix}/${event}`);
@@ -2806,193 +3009,114 @@ class TTS {
     };
   }
 }
-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();
 export {
   ASet,
   ArgParser,
@@ -3051,6 +3175,7 @@ export {
   dayOfYear,
   dec2Frac,
   dec2Hex,
+  decodeHtml,
   decodeJwt,
   deepCopy,
   deepMerge,
@@ -3060,6 +3185,7 @@ export {
   encodeQuery,
   errorFromCode,
   escapeRegex,
+  escapeXml,
   fileBrowser,
   fileText,
   findByProp,
@@ -3074,6 +3200,7 @@ export {
   formatPhoneNumber,
   frac2Dec,
   fromCsv,
+  fromXml,
   gravatar,
   hex2Int,
   hue2rgb,
@@ -3114,6 +3241,7 @@ export {
   timestampFilename,
   timezoneOffset,
   toCsv,
+  toXml,
   uploadWithProgress,
   validateEmail,
   wordSegments