@dxos/util 0.8.4-main.2e9d522 → 0.8.4-main.3c1ae3b

package/dist/lib/browser/index.mjs

@@ -97,16 +97,24 @@ var intersectBy = (arrays, selector) => {
     return lookups.every((lookup) => lookup.has(key));
   });
 };
+var coerceArray = (arr) => {
+  if (arr === void 0) {
+    return [];
+  }
+  return Array.isArray(arr) ? arr : [
+    arr
+  ];
+};
 
 // src/assume.ts
 function assumeType(value) {
 }
 
 // src/binder.ts
-import util from "@dxos/node-std/util";
+import { promisify } from "@dxos/node-std/util";
 var createBinder = (obj) => ({
   fn: (fn) => fn.bind(obj),
-  async: (fn) => util.promisify(fn.bind(obj))
+  async: (fn) => promisify(fn.bind(obj))
 });
 
 // src/bitfield.ts
@@ -207,6 +215,7 @@ var CallbackCollection = class {
 import { invariant as invariant2 } from "@dxos/invariant";
 var __dxlog_file2 = "/__w/dxos/dxos/packages/common/util/src/callback.ts";
 var Callback = class {
+  _callback;
   call(...args) {
     invariant2(this._callback, "Callback not set", {
       F: __dxlog_file2,
@@ -301,9 +310,10 @@ var chunkArray = (array, size) => {
 import { invariant as invariant3 } from "@dxos/invariant";
 var __dxlog_file3 = "/__w/dxos/dxos/packages/common/util/src/circular-buffer.ts";
 var CircularBuffer = class {
+  _buffer;
+  _nextIndex = 0;
+  _elementCount = 0;
   constructor(size) {
-    this._nextIndex = 0;
-    this._elementCount = 0;
     invariant3(size >= 1, void 0, {
       F: __dxlog_file3,
       L: 13,
@@ -374,10 +384,11 @@ import { inspect } from "@dxos/node-std/util";
 import { inspectObject, raise } from "@dxos/debug";
 var MAX_SERIALIZATION_LENGTH = 10;
 var ComplexSet = class {
+  _projection;
+  _values = /* @__PURE__ */ new Map();
   // prettier-ignore
   constructor(_projection, values) {
     this._projection = _projection;
-    this._values = /* @__PURE__ */ new Map();
     if (values) {
       for (const value of values) {
         this.add(value);
@@ -467,11 +478,12 @@ var makeSet = (projection) => {
   };
 };
 var ComplexMap = class _ComplexMap {
+  _keyProjection;
+  _keys = /* @__PURE__ */ new Map();
+  _values = /* @__PURE__ */ new Map();
   // prettier-ignore
   constructor(_keyProjection, entries2) {
     this._keyProjection = _keyProjection;
-    this._keys = /* @__PURE__ */ new Map();
-    this._values = /* @__PURE__ */ new Map();
     if (entries2) {
       for (const [key, value] of entries2) {
         this.set(key, value);
@@ -592,13 +604,11 @@ var getDeep = (obj, path) => {
 // src/defer-function.ts
 var deferFunction = (fnProvider) => (...args) => fnProvider()(...args);
 
-// src/explicit-resource-management-polyfill.ts
-Symbol.dispose ??= Symbol("Symbol.dispose");
-Symbol.asyncDispose ??= Symbol("Symbol.asyncDispose");
-
 // src/defer.ts
+import "@hazae41/symbol-dispose-polyfill";
 var defer = (fn) => new DeferGuard(fn);
 var DeferGuard = class {
+  _fn;
   /**
   * @internal
   */
@@ -614,6 +624,7 @@ var DeferGuard = class {
 };
 var deferAsync = (fn) => new DeferAsyncGuard(fn);
 var DeferAsyncGuard = class {
+  _fn;
   /**
   * @internal
   */
@@ -628,6 +639,8 @@ var DeferAsyncGuard = class {
 // src/entry.ts
 var entry = (map, key) => new MapEntry(map, key);
 var MapEntry = class {
+  _map;
+  _key;
   /**
   * @internal
   */
@@ -653,32 +666,11 @@ var MapEntry = class {
   }
 };
 
-// src/first-two-chars.ts
-var renderableCharRegex = /^(?![\p{Control}\p{Mark}\p{Separator}\p{Surrogate}\p{Unassigned}\p{P}])[\p{L}\p{N}\p{S}\p{Emoji}]$/u;
-var getFirstTwoRenderableChars = (label) => {
-  const characters = Array.from(label);
-  const result = [
-    "",
-    ""
-  ];
-  let foundFirst = false;
-  for (let i = 0; i < characters.length; i++) {
-    const char = characters[i];
-    if (renderableCharRegex.test(char)) {
-      if (!foundFirst) {
-        result[0] = char;
-        foundFirst = true;
-      } else {
-        const textBetween = characters.slice(result[0].length, i).join("");
-        if (/[^\p{L}\p{N}_]/u.test(textBetween)) {
-          result[1] = char;
-          break;
-        }
-      }
-    }
-  }
-  return result;
-};
+// src/filename.ts
+var createFilename = ({ parts = [], ext, date = /* @__PURE__ */ new Date() }) => [
+  date.toISOString().replace(/[:.]/g, "-"),
+  ...parts
+].join("_") + (ext ? `.${ext}` : "");
 
 // src/for-each-async.ts
 var forEachAsync = (items, fn) => Promise.all(items.map(fn));
@@ -944,6 +936,7 @@ var DEFAULT_WORDLIST = [
   "zulu"
 ];
 var HumanHasher = class {
+  wordlist;
   /**
   * Transforms hex digests to human-readable strings.
   *
@@ -1209,31 +1202,10 @@ var deepMapValues = (value, fn) => {
   return new DeepMapper(fn).map(value);
 };
 var DeepMapper = class {
+  _fn;
+  _cyclic = /* @__PURE__ */ new Map();
   constructor(_fn) {
     this._fn = _fn;
-    this._cyclic = /* @__PURE__ */ new Map();
-    this._recurse = (value) => {
-      if (this._cyclic.has(value)) {
-        return this._cyclic.get(value);
-      }
-      if (Array.isArray(value)) {
-        const res = new Array(value.length);
-        this._cyclic.set(value, res);
-        for (let i = 0; i < value.length; i++) {
-          res[i] = this._map(value[i], i);
-        }
-        return res;
-      } else if (value !== null && typeof value === "object") {
-        const res = {};
-        this._cyclic.set(value, res);
-        for (const key in value) {
-          res[key] = this._map(value[key], key);
-        }
-        return res;
-      } else {
-        return value;
-      }
-    };
   }
   map(value) {
     return this._map(value, void 0);
@@ -1244,36 +1216,37 @@ var DeepMapper = class {
     }
     return this._fn(value, this._recurse, key);
   }
+  _recurse = (value) => {
+    if (this._cyclic.has(value)) {
+      return this._cyclic.get(value);
+    }
+    if (Array.isArray(value)) {
+      const res = new Array(value.length);
+      this._cyclic.set(value, res);
+      for (let i = 0; i < value.length; i++) {
+        res[i] = this._map(value[i], i);
+      }
+      return res;
+    } else if (value !== null && typeof value === "object") {
+      const res = {};
+      this._cyclic.set(value, res);
+      for (const key in value) {
+        res[key] = this._map(value[key], key);
+      }
+      return res;
+    } else {
+      return value;
+    }
+  };
 };
 var deepMapValuesAsync = (value, fn) => {
   return new DeepMapperAsync(fn).map(value);
 };
 var DeepMapperAsync = class {
+  _fn;
+  _cyclic = /* @__PURE__ */ new Map();
   constructor(_fn) {
     this._fn = _fn;
-    this._cyclic = /* @__PURE__ */ new Map();
-    this._recurse = async (value) => {
-      if (this._cyclic.has(value)) {
-        return this._cyclic.get(value);
-      }
-      if (Array.isArray(value)) {
-        const res = new Array(value.length);
-        this._cyclic.set(value, res);
-        for (let i = 0; i < value.length; i++) {
-          res[i] = await this._map(value[i], i);
-        }
-        return res;
-      } else if (value !== null && typeof value === "object") {
-        const res = {};
-        this._cyclic.set(value, res);
-        for (const key in value) {
-          res[key] = await this._map(value[key], key);
-        }
-        return res;
-      } else {
-        return value;
-      }
-    };
   }
   map(value) {
     return this._map(value, void 0);
@@ -1284,6 +1257,28 @@ var DeepMapperAsync = class {
     }
     return this._fn(value, this._recurse, key);
   }
+  _recurse = async (value) => {
+    if (this._cyclic.has(value)) {
+      return this._cyclic.get(value);
+    }
+    if (Array.isArray(value)) {
+      const res = new Array(value.length);
+      this._cyclic.set(value, res);
+      for (let i = 0; i < value.length; i++) {
+        res[i] = await this._map(value[i], i);
+      }
+      return res;
+    } else if (value !== null && typeof value === "object") {
+      const res = {};
+      this._cyclic.set(value, res);
+      for (const key in value) {
+        res[key] = await this._map(value[key], key);
+      }
+      return res;
+    } else {
+      return value;
+    }
+  };
 };
 var visitValues = (object, visitor) => {
   if (Array.isArray(object)) {
@@ -1601,37 +1596,107 @@ var safeInstanceof = (tag) => (target) => {
 };
 
 // src/safe-parse.ts
-var safeParseInt = (value, defaultValue) => {
+function safeParseInt(str, defaultValue) {
   try {
-    const n = parseInt(value ?? "");
-    return isNaN(n) ? defaultValue : n;
-  } catch (err) {
+    const value = parseInt(str ?? "");
+    return isNaN(value) ? defaultValue : value;
+  } catch {
     return defaultValue;
   }
-};
-var safeParseFloat = (str, defaultValue) => {
+}
+function safeParseFloat(str, defaultValue) {
   try {
-    return parseFloat(str);
+    const value = parseFloat(str ?? "");
+    return isNaN(value) ? defaultValue : value;
   } catch {
-    return defaultValue ?? 0;
+    return defaultValue;
   }
-};
-var safeParseJson = (data, defaultValue) => {
-  if (data && data.length > 0) {
+}
+var safeParseJson = (str, defaultValue) => {
+  if (str && str.length > 0) {
     try {
-      return JSON.parse(data);
-    } catch (err) {
+      return JSON.parse(str);
+    } catch {
     }
   }
   return defaultValue;
 };
 
+// src/safe-stringify.ts
+var SKIP = Object.freeze({});
+function safeStringify(obj, filter = defaultFilter, indent = 2) {
+  const seen = /* @__PURE__ */ new WeakSet();
+  function replacer(key, value) {
+    if (typeof value === "object" && value !== null) {
+      if (seen.has(value)) {
+        return "[Circular]";
+      }
+      seen.add(value);
+    }
+    if (filter) {
+      const v2 = filter?.(key, value);
+      if (v2 !== void 0) {
+        return v2 === SKIP ? void 0 : v2;
+      }
+    }
+    return value;
+  }
+  let result = "";
+  try {
+    result = JSON.stringify(obj, replacer, indent);
+  } catch (error) {
+    result = `Error: ${error.message}`;
+  }
+  return result;
+}
+var createReplacer = ({ omit: omit2, parse, maxDepth, maxArrayLen, maxStringLen } = {}) => {
+  let currentDepth = 0;
+  const depthMap = /* @__PURE__ */ new WeakMap();
+  return function(key, value) {
+    if (key === "") {
+      currentDepth = 0;
+    } else if (this && typeof this === "object") {
+      const parentDepth = depthMap.get(this) ?? 0;
+      currentDepth = parentDepth + 1;
+    }
+    if (typeof value === "function") {
+      return void 0;
+    }
+    if (value && typeof value === "object") {
+      depthMap.set(value, currentDepth);
+      if (maxDepth != null && currentDepth >= maxDepth) {
+        return Array.isArray(value) ? `[{ length: ${value.length} }]` : `{ keys: ${Object.keys(value).length} }`;
+      }
+    }
+    if (omit2?.includes(key)) {
+      return void 0;
+    }
+    if (parse?.includes(key) && typeof value === "string") {
+      try {
+        return JSON.parse(value);
+      } catch {
+        return value;
+      }
+    }
+    if (maxArrayLen != null && Array.isArray(value) && value.length > maxArrayLen) {
+      return `[length: ${value.length}]`;
+    }
+    if (maxStringLen != null && typeof value === "string" && value.length > maxStringLen) {
+      return value.slice(0, maxStringLen) + "...";
+    }
+    return value;
+  };
+};
+var defaultFilter = createReplacer();
+
 // src/sliding-window-summary.ts
 import { invariant as invariant5 } from "@dxos/invariant";
 var __dxlog_file5 = "/__w/dxos/dxos/packages/common/util/src/sliding-window-summary.ts";
 var SlidingWindowSummary = class {
+  _buffer;
+  _sum = 0;
+  _precision;
   constructor(options) {
-    this._sum = 0;
     this._buffer = new CircularBuffer(options.dataPoints);
     if (options.precision != null) {
       invariant5(options.precision >= 0, void 0, {
@@ -1711,12 +1776,24 @@ var capitalize = (str) => {
   }
   return str.charAt(0).toUpperCase() + str.slice(1);
 };
-var trim = (strings, ...values) => {
-  const full = String.raw(strings, ...values);
-  const lines = full.replace(/^\n/, "").split("\n");
-  const indent = Math.min(...lines.filter((l) => l.trim()).map((l) => l.match(/^ */)[0].length));
-  return lines.map((l) => l.slice(indent)).join("\n");
-};
+function trim(strings, ...values) {
+  const raw = strings.reduce((out, str, i) => {
+    out += str;
+    if (i < values.length) {
+      const match = str.match(/(^|\n)([ \t]*)$/);
+      const baseIndent = match ? match[2] : "";
+      const val = String(values[i]).replace(/\r?\n/g, "\n" + baseIndent);
+      out += val;
+    }
+    return out;
+  }, "");
+  const lines = raw.split("\n");
+  while (lines.length && !lines[0].trim()) lines.shift();
+  while (lines.length && !lines[lines.length - 1].trim()) lines.pop();
+  const minIndent = Math.min(...lines.filter((l) => l.trim()).map((l) => l.match(/^[ \t]*/)?.[0].length ?? 0));
+  return lines.map((l) => l.slice(minIndent)).join("\n");
+}
+var kebabize = (str) => str.replace(/[A-Z]+(?![a-z])|[A-Z]/g, ($, ofs) => (ofs ? "-" : "") + $.toLowerCase());
 
 // src/sum.ts
 var sum = (values) => values.reduce((a, b) => a + b, 0);
@@ -1915,10 +1992,8 @@ var toFallback = (hash) => {
 
 // src/tracer.ts
 var Tracer = class {
-  constructor() {
-    this._events = /* @__PURE__ */ new Map();
-    this._recording = false;
-  }
+  _events = /* @__PURE__ */ new Map();
+  _recording = false;
   // TODO(burdon): Start/stop methods for recording data? By id?
   //  Alternatively, enable subscriptions to track/compute series.
   // TODO(burdon): Hierarchical traces?
@@ -2019,7 +2094,7 @@ var stringifyTree = (node, ancestors = [], rows = []) => {
 };
 
 // src/types.ts
-var isNotFalsy = (value) => !!value;
+var isTruthy = (value) => !!value;
 var isNonNullable = (value) => value != null;
 var doAsync = async (fn) => fn();
 var getProviderValue = (provider, arg) => {
@@ -2050,6 +2125,107 @@ var arrayMove = (array, from, to) => {
   return array;
 };
 
+// src/unit.ts
+var createFormat = (unit) => {
+  return (n, precision = unit.precision ?? 0) => {
+    const value = n / unit.quotient;
+    return {
+      unit,
+      value,
+      formattedValue: value.toFixed(precision),
+      toString: () => `${value.toFixed(precision)}${unit.symbol}`
+    };
+  };
+};
+var MS_SECONDS = 1e3;
+var MS_MINUTES = 60 * MS_SECONDS;
+var MS_HOURS = 60 * MS_MINUTES;
+var Unit = {
+  // General.
+  Percent: createFormat({
+    symbol: "%",
+    quotient: 1 / 100,
+    precision: 2
+  }),
+  Thousand: createFormat({
+    symbol: "k",
+    quotient: 1e3,
+    precision: 2
+  }),
+  // Bytes (note KB vs KiB).
+  Gigabyte: createFormat({
+    symbol: "GB",
+    quotient: 1e3 * 1e3 * 1e3,
+    precision: 2
+  }),
+  Megabyte: createFormat({
+    symbol: "MB",
+    quotient: 1e3 * 1e3,
+    precision: 2
+  }),
+  Kilobyte: createFormat({
+    symbol: "KB",
+    quotient: 1e3,
+    precision: 2
+  }),
+  Byte: createFormat({
+    symbol: "B",
+    quotient: 1
+  }),
+  // Time.
+  Hour: createFormat({
+    symbol: "h",
+    quotient: MS_HOURS
+  }),
+  Minute: createFormat({
+    symbol: "m",
+    quotient: MS_MINUTES
+  }),
+  Second: createFormat({
+    symbol: "s",
+    quotient: MS_SECONDS,
+    precision: 1
+  }),
+  Millisecond: createFormat({
+    symbol: "ms",
+    quotient: 1
+  }),
+  Duration: (n) => {
+    const hours = Math.floor(n / MS_HOURS);
+    const minutes = Math.floor(n % MS_HOURS / MS_MINUTES);
+    if (hours) {
+      const formattedValue = minutes ? `${hours}h ${minutes}m` : `${hours}h`;
+      return {
+        unit: {
+          symbol: "h",
+          quotient: MS_HOURS
+        },
+        value: hours,
+        formattedValue,
+        toString: () => formattedValue
+      };
+    }
+    if (minutes) {
+      const seconds2 = (n - MS_MINUTES * minutes) / MS_SECONDS;
+      const formattedValue = seconds2 ? `${minutes}m ${seconds2}s` : `${minutes}m`;
+      return {
+        unit: {
+          symbol: "m",
+          quotient: MS_MINUTES
+        },
+        value: minutes,
+        formattedValue,
+        toString: () => formattedValue
+      };
+    }
+    const seconds = n >= MS_SECONDS;
+    if (seconds) {
+      return Unit.Second(n);
+    }
+    return Unit.Millisecond(n);
+  }
+};
+
 // src/url.ts
 var createUrl = (url, search) => {
   const base = typeof url === "string" ? new URL(url) : url;
@@ -2061,11 +2237,11 @@ var createUrl = (url, search) => {
 
 // src/weak.ts
 var WeakDictionary = class {
+  _internal = /* @__PURE__ */ new Map();
+  _finalization = new FinalizationRegistry((cleanUpCallback) => {
+    cleanUpCallback();
+  });
   constructor(entries2) {
-    this._internal = /* @__PURE__ */ new Map();
-    this._finalization = new FinalizationRegistry((cleanUpCallback) => {
-      cleanUpCallback();
-    });
     this._internal = new Map(entries2?.map(([key, value]) => [
       key,
       new WeakRef(value)
@@ -2153,6 +2329,21 @@ var WeakDictionary = class {
     this._finalization.unregister(value);
   }
 };
+
+// src/error-format.ts
+var formatErrorWithCauses = (error) => {
+  const lines = [];
+  let current = error;
+  let level = 0;
+  while (current) {
+    const prefix = level === 0 ? "" : `Caused by: `;
+    lines.push(prefix + (current.stack ?? String(current)));
+    if (!(current.cause instanceof Error)) break;
+    current = current.cause;
+    level += 1;
+  }
+  return lines.join("\n\n");
+};
 export {
   BitField,
   Callback,
@@ -2162,8 +2353,10 @@ export {
   ComplexSet,
   HumanHasher,
   MapEntry,
+  SKIP,
   SlidingWindowSummary,
   Tracer,
+  Unit,
   WeakDictionary,
   accessBy,
   arrayMove,
@@ -2178,18 +2371,22 @@ export {
   chunkArray,
   clamp,
   clearUndefined,
+  coerceArray,
   compareMulti,
   compareObject,
   compareScalar,
   compareString,
   createBinder,
   createBucketReducer,
+  createFilename,
   createGroupReducer,
+  createReplacer,
   createSetDispatch,
   createUrl,
   decamelize,
   deepMapValues,
   deepMapValuesAsync,
+  defaultFilter,
   defaultMap,
   defer,
   deferAsync,
@@ -2201,12 +2398,12 @@ export {
   entry,
   exponentialBackoffInterval,
   forEachAsync,
+  formatErrorWithCauses,
   get,
   getAsyncProviderValue,
   getDate,
   getDebugName,
   getDeep,
-  getFirstTwoRenderableChars,
   getHostPlatform,
   getPrototypeSpecificInstanceId,
   getProviderValue,
@@ -2224,12 +2421,13 @@ export {
   iosCheck,
   isNode,
   isNonNullable,
-  isNotFalsy,
+  isTruthy,
   joinTables,
   jsonKeyReplacer,
   jsonReplacer,
   jsonify,
   jsonlogify,
+  kebabize,
   keyToEmoji,
   keyToFallback,
   keyToHue,
@@ -2260,6 +2458,7 @@ export {
   safeParseFloat,
   safeParseInt,
   safeParseJson,
+  safeStringify,
   set,
   setDeep,
   sortKeys,