@dxos/util 0.8.4-main.ead640a → 0.8.4-main.effb148878

package/dist/lib/node-esm/index.mjs

@@ -97,21 +97,28 @@ 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 "node:util";
+import { promisify } from "node: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
 import { invariant } from "@dxos/invariant";
-var __dxlog_file = "/__w/dxos/dxos/packages/common/util/src/bitfield.ts";
 var BitField = class _BitField {
   static get(data, idx) {
     const bit = data[idx >> 3] >> 7 - idx % 8 & 1;
@@ -143,15 +150,7 @@ var BitField = class _BitField {
     return result;
   }
   static and(first, second) {
-    invariant(first.length === second.length, "Bitfields must be of the same length", {
-      F: __dxlog_file,
-      L: 52,
-      S: this,
-      A: [
-        "first.length === second.length",
-        "'Bitfields must be of the same length'"
-      ]
-    });
+    invariant(first.length === second.length, "Bitfields must be of the same length");
     const result = new Uint8Array(first.length);
     for (let i = 0; i < first.length; i++) {
       result[i] = first[i] & second[i];
@@ -179,126 +178,91 @@ var BitField = class _BitField {
   }
 };
 
-// src/callback-collection.ts
-function _check_private_redeclaration(obj, privateCollection) {
-  if (privateCollection.has(obj)) {
-    throw new TypeError("Cannot initialize the same private elements twice on an object");
+// src/browser-storage.ts
+var clearIndexedDB = async () => {
+  const dbs = await indexedDB.databases();
+  const results = await Promise.allSettled(dbs.filter((db) => db.name != null).map((db) => new Promise((resolve, reject) => {
+    const request = indexedDB.deleteDatabase(db.name);
+    request.onsuccess = () => resolve();
+    request.onerror = () => reject(request.error);
+    request.onblocked = () => reject(new Error(`IndexedDB deletion blocked: ${db.name}`));
+  })));
+  const failures = results.filter((r) => r.status === "rejected");
+  if (failures.length > 0) {
+    throw new AggregateError(failures.map((r) => r.reason), "Failed to delete some IndexedDB databases");
+  }
+};
+var clearOPFS = async () => {
+  const root = await navigator.storage.getDirectory();
+  const errors = [];
+  for await (const [name] of root.entries()) {
+    try {
+      await root.removeEntry(name, {
+        recursive: true
+      });
+    } catch (err) {
+      errors.push(err);
+    }
   }
-}
-function _class_apply_descriptor_get(receiver, descriptor) {
-  if (descriptor.get) {
-    return descriptor.get.call(receiver);
+  if (errors.length > 0) {
+    throw new AggregateError(errors, "Failed to remove some OPFS entries");
   }
-  return descriptor.value;
-}
-function _class_apply_descriptor_set(receiver, descriptor, value) {
-  if (descriptor.set) {
-    descriptor.set.call(receiver, value);
-  } else {
-    if (!descriptor.writable) {
-      throw new TypeError("attempted to set read only private field");
-    }
-    descriptor.value = value;
+};
+var clearServiceWorkers = async () => {
+  const regs = await navigator.serviceWorker.getRegistrations();
+  for (const reg of regs) {
+    await reg.unregister();
   }
-}
-function _class_extract_field_descriptor(receiver, privateMap, action) {
-  if (!privateMap.has(receiver)) {
-    throw new TypeError("attempted to " + action + " private field on non-instance");
+};
+var clearCaches = async () => {
+  const keys2 = await caches.keys();
+  for (const key of keys2) {
+    await caches.delete(key);
   }
-  return privateMap.get(receiver);
-}
-function _class_private_field_get(receiver, privateMap) {
-  var descriptor = _class_extract_field_descriptor(receiver, privateMap, "get");
-  return _class_apply_descriptor_get(receiver, descriptor);
-}
-function _class_private_field_init(obj, privateMap, value) {
-  _check_private_redeclaration(obj, privateMap);
-  privateMap.set(obj, value);
-}
-function _class_private_field_set(receiver, privateMap, value) {
-  var descriptor = _class_extract_field_descriptor(receiver, privateMap, "set");
-  _class_apply_descriptor_set(receiver, descriptor, value);
-  return value;
-}
-var _callbacks = /* @__PURE__ */ new WeakMap();
+};
+
+// src/callback-collection.ts
 var CallbackCollection = class {
+  #callbacks = [];
   append(callback) {
-    _class_private_field_get(this, _callbacks).push(callback);
+    this.#callbacks.push(callback);
   }
   prepend(callback) {
-    _class_private_field_get(this, _callbacks).unshift(callback);
+    this.#callbacks.unshift(callback);
   }
   remove(callback) {
-    _class_private_field_set(this, _callbacks, _class_private_field_get(this, _callbacks).filter((c) => c !== callback));
+    this.#callbacks = this.#callbacks.filter((c) => c !== callback);
   }
   callParallel(...args) {
-    return Promise.all(_class_private_field_get(this, _callbacks).map((callback) => callback(...args)));
+    return Promise.all(this.#callbacks.map((callback) => callback(...args)));
   }
   async callSerial(...args) {
     const results = [];
-    for (const callback of _class_private_field_get(this, _callbacks)) {
+    for (const callback of this.#callbacks) {
       results.push(await callback(...args));
     }
     return results;
   }
-  constructor() {
-    _class_private_field_init(this, _callbacks, {
-      writable: true,
-      value: []
-    });
-  }
 };
 
 // src/callback.ts
 import { invariant as invariant2 } from "@dxos/invariant";
-function _define_property(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
-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,
-      L: 20,
-      S: this,
-      A: [
-        "this._callback",
-        "'Callback not set'"
-      ]
-    });
+    invariant2(this._callback, "Callback not set");
     return this._callback(...args);
   }
   callIfSet(...args) {
     return this._callback?.(...args);
   }
   set(callback) {
-    invariant2(!this._callback, "Callback already set", {
-      F: __dxlog_file2,
-      L: 29,
-      S: this,
-      A: [
-        "!this._callback",
-        "'Callback already set'"
-      ]
-    });
+    invariant2(!this._callback, "Callback already set");
     this._callback = callback;
   }
   isSet() {
     return !!this._callback;
   }
-  constructor() {
-    _define_property(this, "_callback", void 0);
-  }
 };
 var createSetDispatch = ({ handlers }) => {
   return new Proxy({
@@ -361,21 +325,14 @@ var chunkArray = (array, size) => {
 
 // src/circular-buffer.ts
 import { invariant as invariant3 } from "@dxos/invariant";
-function _define_property2(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
-var __dxlog_file3 = "/__w/dxos/dxos/packages/common/util/src/circular-buffer.ts";
 var CircularBuffer = class {
+  _buffer;
+  _nextIndex = 0;
+  _elementCount = 0;
+  constructor(size) {
+    invariant3(size >= 1);
+    this._buffer = new Array(size);
+  }
   push(element) {
     const evicted = this._elementCount === this._buffer.length ? this._buffer[this._nextIndex] : void 0;
     this._buffer[this._nextIndex] = element;
@@ -386,6 +343,10 @@ var CircularBuffer = class {
   get elementCount() {
     return this._elementCount;
   }
+  clear() {
+    this._nextIndex = 0;
+    this._elementCount = 0;
+  }
   getLast() {
     if (this._elementCount === 0) {
       return void 0;
@@ -415,21 +376,6 @@ var CircularBuffer = class {
       yield this._buffer[i];
     }
   }
-  constructor(size) {
-    _define_property2(this, "_buffer", void 0);
-    _define_property2(this, "_nextIndex", 0);
-    _define_property2(this, "_elementCount", 0);
-    invariant3(size >= 1, void 0, {
-      F: __dxlog_file3,
-      L: 13,
-      S: this,
-      A: [
-        "size >= 1",
-        ""
-      ]
-    });
-    this._buffer = new Array(size);
-  }
 };
 
 // src/clear-undefined.ts
@@ -448,22 +394,19 @@ var clearUndefined = (obj) => {
 // src/complex.ts
 import { inspect } from "node:util";
 import { inspectObject, raise } from "@dxos/debug";
-function _define_property3(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
 var MAX_SERIALIZATION_LENGTH = 10;
-var _inspect_custom = inspect.custom;
 var ComplexSet = class {
+  _projection;
+  _values = /* @__PURE__ */ new Map();
+  // prettier-ignore
+  constructor(_projection, values) {
+    this._projection = _projection;
+    if (values) {
+      for (const value of values) {
+        this.add(value);
+      }
+    }
+  }
   toString() {
     return inspectObject(this);
   }
@@ -472,7 +415,7 @@ var ComplexSet = class {
       size: this._values.size
     } : Array.from(this._values.values());
   }
-  [_inspect_custom]() {
+  [inspect.custom]() {
     return inspectObject(this);
   }
   add(value) {
@@ -538,18 +481,6 @@ var ComplexSet = class {
   isDisjointFrom(other) {
     throw new Error("Method not implemented.");
   }
-  // prettier-ignore
-  constructor(_projection, values) {
-    _define_property3(this, "_projection", void 0);
-    _define_property3(this, "_values", void 0);
-    this._projection = _projection;
-    this._values = /* @__PURE__ */ new Map();
-    if (values) {
-      for (const value of values) {
-        this.add(value);
-      }
-    }
-  }
 };
 var makeSet = (projection) => {
   return class BoundComplexSet extends ComplexSet {
@@ -558,8 +489,19 @@ var makeSet = (projection) => {
     }
   };
 };
-var _inspect_custom1 = inspect.custom;
 var ComplexMap = class _ComplexMap {
+  _keyProjection;
+  _keys = /* @__PURE__ */ new Map();
+  _values = /* @__PURE__ */ new Map();
+  // prettier-ignore
+  constructor(_keyProjection, entries2) {
+    this._keyProjection = _keyProjection;
+    if (entries2) {
+      for (const [key, value] of entries2) {
+        this.set(key, value);
+      }
+    }
+  }
   toString() {
     return inspectObject(this);
   }
@@ -568,7 +510,7 @@ var ComplexMap = class _ComplexMap {
       size: this._values.size
     } : Array.from(this._values.values());
   }
-  [_inspect_custom1]() {
+  [inspect.custom]() {
     return inspectObject(this);
   }
   clear() {
@@ -598,6 +540,36 @@ var ComplexMap = class _ComplexMap {
     this._values.set(primitive, value);
     return this;
   }
+  /**
+  * Returns the value for the given key if present, otherwise inserts and returns the default value.
+  * @param key - The key to look up or insert.
+  * @param defaultValue - The value to insert if the key is not present.
+  * @returns The existing or newly inserted value.
+  */
+  getOrInsert(key, defaultValue) {
+    const primitive = this._keyProjection(key);
+    if (this._values.has(primitive)) {
+      return this._values.get(primitive);
+    }
+    this.set(key, defaultValue);
+    return defaultValue;
+  }
+  /**
+  * Returns the value for the given key if present, otherwise computes, inserts, and returns a new value.
+  * The callback is only invoked when the key is missing.
+  * @param key - The key to look up or insert.
+  * @param callbackfn - Function to compute the value if the key is not present.
+  * @returns The existing or newly computed value.
+  */
+  getOrInsertComputed(key, callbackfn) {
+    const primitive = this._keyProjection(key);
+    if (this._values.has(primitive)) {
+      return this._values.get(primitive);
+    }
+    const value = callbackfn(key);
+    this.set(key, value);
+    return value;
+  }
   get size() {
     return this._keys.size;
   }
@@ -630,45 +602,22 @@ var ComplexMap = class _ComplexMap {
   get [Symbol.toStringTag]() {
     return "ComplexMap";
   }
-  // prettier-ignore
-  constructor(_keyProjection, entries2) {
-    _define_property3(this, "_keyProjection", void 0);
-    _define_property3(this, "_keys", void 0);
-    _define_property3(this, "_values", void 0);
-    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);
-      }
-    }
-  }
 };
-var makeMap = (keyProjection) => {
-  class BoundComplexMap extends ComplexMap {
-    constructor(entries2) {
-      super(keyProjection, entries2);
-    }
+var makeMap = (keyProjection) => class BoundComplexMap extends ComplexMap {
+  constructor(entries2) {
+    super(keyProjection, entries2);
   }
-  return BoundComplexMap;
 };
 
+// src/composite-key.ts
+var SEPARATOR = ":";
+var compositeKey = (...parts) => parts.join(SEPARATOR);
+var splitCompositeKey = (key) => key.split(SEPARATOR);
+
 // src/deep.ts
-import get from "lodash.get";
-import set from "lodash.set";
 import { invariant as invariant4 } from "@dxos/invariant";
-var __dxlog_file4 = "/__w/dxos/dxos/packages/common/util/src/deep.ts";
 var setDeep = (obj, path, value) => {
-  invariant4(path.length > 0, void 0, {
-    F: __dxlog_file4,
-    L: 18,
-    S: void 0,
-    A: [
-      "path.length > 0",
-      ""
-    ]
-  });
+  invariant4(path.length > 0);
   let parent = obj;
   for (const key of path.slice(0, -1)) {
     if (parent[key] === void 0) {
@@ -691,72 +640,51 @@ var getDeep = (obj, path) => {
 // src/defer-function.ts
 var deferFunction = (fnProvider) => (...args) => fnProvider()(...args);
 
-// src/explicit-resource-management-polyfill.ts
-var _Symbol;
-var _Symbol1;
-(_Symbol = Symbol).dispose ?? (_Symbol.dispose = Symbol("Symbol.dispose"));
-(_Symbol1 = Symbol).asyncDispose ?? (_Symbol1.asyncDispose = Symbol("Symbol.asyncDispose"));
-
 // src/defer.ts
-function _define_property4(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
+import "@hazae41/symbol-dispose-polyfill";
 var defer = (fn) => new DeferGuard(fn);
 var DeferGuard = class {
-  [Symbol.dispose]() {
-    const result = this._fn();
-    if (result instanceof Promise) {
-      throw new Error("Async functions in defer are not supported. Use deferAsync instead.");
-    }
-  }
+  _fn;
   /**
   * @internal
   */
   constructor(_fn) {
-    _define_property4(this, "_fn", void 0);
     this._fn = _fn;
   }
+  [Symbol.dispose]() {
+    const result = this._fn();
+    if (result instanceof Promise) {
+      throw new Error("Async functions in defer are not supported. Use deferAsync instead.");
+    }
+  }
 };
 var deferAsync = (fn) => new DeferAsyncGuard(fn);
 var DeferAsyncGuard = class {
-  async [Symbol.asyncDispose]() {
-    await this._fn();
-  }
+  _fn;
   /**
   * @internal
   */
   constructor(_fn) {
-    _define_property4(this, "_fn", void 0);
     this._fn = _fn;
   }
+  async [Symbol.asyncDispose]() {
+    await this._fn();
+  }
 };
 
 // src/entry.ts
-function _define_property5(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
 var entry = (map, key) => new MapEntry(map, key);
 var MapEntry = class {
+  _map;
+  _key;
+  /**
+  * @internal
+  */
+  // prettier-ignore
+  constructor(_map, _key) {
+    this._map = _map;
+    this._key = _key;
+  }
   get key() {
     return this._key;
   }
@@ -772,36 +700,36 @@ var MapEntry = class {
   deep(key) {
     return entry(this.value, key);
   }
-  /**
-  * @internal
-  */
-  // prettier-ignore
-  constructor(_map, _key) {
-    _define_property5(this, "_map", void 0);
-    _define_property5(this, "_key", void 0);
-    this._map = _map;
-    this._key = _key;
-  }
 };
 
+// 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");
+};
+
+// 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));
 
 // src/human-hash.ts
 import { PublicKey } from "@dxos/keys";
-function _define_property6(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
 var DEFAULT_WORDLIST = [
   "ack",
   "alabama",
@@ -1061,6 +989,27 @@ var DEFAULT_WORDLIST = [
   "zulu"
 ];
 var HumanHasher = class {
+  wordlist;
+  /**
+  * Transforms hex digests to human-readable strings.
+  *
+  * The format of these strings will look something like:
+  * `victor-bacon-zulu-lima`. The output is obtained by compressing the input
+  * digest to a fixed number of bytes, then mapping those bytes to one of 256
+  * words. A default wordlist is provided, but you can override this if you
+  * prefer.
+  * As long as you use the same wordlist, the output will be consistent (i.e.
+  * the same digest will always render the same representation).
+  *
+  * @param wordlist A list of exactly 256 words to choose from
+  */
+  constructor(wordlist = DEFAULT_WORDLIST) {
+    this.wordlist = wordlist;
+    if (wordlist.length !== 256) {
+      throw new Error("Wordlist must have exactly 256 items");
+    }
+    this.wordlist = wordlist;
+  }
   /**
   * Humanize a given hexadecimal digest.
   *
@@ -1100,27 +1049,6 @@ var HumanHasher = class {
     const checksums = segments.map((x) => x.reduce((acc, curr) => acc ^ curr));
     return checksums;
   }
-  /**
-  * Transforms hex digests to human-readable strings.
-  *
-  * The format of these strings will look something like:
-  * `victor-bacon-zulu-lima`. The output is obtained by compressing the input
-  * digest to a fixed number of bytes, then mapping those bytes to one of 256
-  * words. A default wordlist is provided, but you can override this if you
-  * prefer.
-  * As long as you use the same wordlist, the output will be consistent (i.e.
-  * the same digest will always render the same representation).
-  *
-  * @param wordlist A list of exactly 256 words to choose from
-  */
-  constructor(wordlist = DEFAULT_WORDLIST) {
-    _define_property6(this, "wordlist", void 0);
-    this.wordlist = wordlist;
-    if (wordlist.length !== 256) {
-      throw new Error("Wordlist must have exactly 256 items");
-    }
-    this.wordlist = wordlist;
-  }
 };
 var hasher = new HumanHasher();
 var humanize = (value) => {
@@ -1132,6 +1060,19 @@ var humanize = (value) => {
   return hasher.humanize(value);
 };
 
+// src/id.ts
+var PART = /^[a-zA-Z][a-zA-Z0-9]{0,62}$/;
+var ID = /^[a-zA-Z]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+(\.[a-zA-Z]([a-zA-Z0-9]{0,62})?)$/;
+function id(strings, ...values) {
+  const raw = strings.reduce((out, str, i) => out + str + (i < values.length ? String(values[i]) : ""), "");
+  if (!ID.test(raw)) {
+    throw new Error(`Invalid id (expected AT Protocol NSID): ${JSON.stringify(raw)}`);
+  }
+  return raw;
+}
+var isWellFormedId = (value) => ID.test(value);
+var isWellFormedIdPart = (value) => PART.test(value);
+
 // src/map.ts
 var defaultMap = (map, key, def) => {
   let value = map.get(key);
@@ -1143,22 +1084,20 @@ var defaultMap = (map, key, def) => {
 };
 
 // src/instance-id.ts
-var _globalThis;
-var _symbol;
-var symbol = Symbol.for("dxos.instance-contexts");
-var instanceContexts = (_globalThis = globalThis)[_symbol = symbol] ?? (_globalThis[_symbol] = /* @__PURE__ */ new WeakMap());
+var symbol = /* @__PURE__ */ Symbol.for("dxos.instance-contexts");
+var instanceContexts = globalThis[symbol] ??= /* @__PURE__ */ new WeakMap();
 var getPrototypeSpecificInstanceId = (instance) => {
   const prototype = Object.getPrototypeOf(instance);
   const instanceCtx = defaultMap(instanceContexts, prototype, () => ({
     nextId: 0,
     instanceIds: /* @__PURE__ */ new WeakMap()
   }));
-  let id = instanceCtx.instanceIds.get(instance);
-  if (id === void 0) {
-    id = instanceCtx.nextId++;
-    instanceCtx.instanceIds.set(instance, id);
+  let id2 = instanceCtx.instanceIds.get(instance);
+  if (id2 === void 0) {
+    id2 = instanceCtx.nextId++;
+    instanceCtx.instanceIds.set(instance, id2);
   }
-  return id;
+  return id2;
 };
 var getDebugName = (instance) => {
   if (instance == null) {
@@ -1225,6 +1164,26 @@ var bufferToArray = (buffer) => {
 };
 var stringToArray = (string) => bufferToArray(Buffer.from(string, "hex"));
 var arrayToString = (array) => arrayToBuffer(array).toString("hex");
+var toUnpaddedBase64 = (bytes) => arrayToBuffer(bytes).toString("base64").replace(/=+$/, "");
+var encodeUint8ArrayToJson = (bytes) => ({
+  "/": {
+    bytes: toUnpaddedBase64(bytes)
+  }
+});
+var isEncodedUint8Array = (value) => {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  if (Object.keys(value).length !== 1) {
+    return false;
+  }
+  const inner = value["/"];
+  if (typeof inner !== "object" || inner === null || Array.isArray(inner)) {
+    return false;
+  }
+  return Object.keys(inner).length === 1 && typeof inner.bytes === "string";
+};
+var decodeUint8ArrayFromJson = (encoded) => bufferToArray(Buffer.from(encoded["/"].bytes, "base64"));
 
 // src/json.ts
 var MAX_DEPTH = 5;
@@ -1318,19 +1277,6 @@ var jsonKeyReplacer = (options = {}) => (key, value) => {
 };
 
 // src/map-values.ts
-function _define_property7(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
 var mapValues = (obj, fn) => {
   const result = {};
   Object.keys(obj).forEach((key) => {
@@ -1342,6 +1288,11 @@ var deepMapValues = (value, fn) => {
   return new DeepMapper(fn).map(value);
 };
 var DeepMapper = class {
+  _fn;
+  _cyclic = /* @__PURE__ */ new Map();
+  constructor(_fn) {
+    this._fn = _fn;
+  }
   map(value) {
     return this._map(value, void 0);
   }
@@ -1351,40 +1302,40 @@ var DeepMapper = class {
     }
     return this._fn(value, this._recurse, key);
   }
-  constructor(_fn) {
-    _define_property7(this, "_fn", void 0);
-    _define_property7(this, "_cyclic", void 0);
-    _define_property7(this, "_recurse", void 0);
-    this._fn = _fn;
-    this._cyclic = /* @__PURE__ */ new Map();
-    this._recurse = (value) => {
-      if (this._cyclic.has(value)) {
-        return this._cyclic.get(value);
+  _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);
       }
-      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;
+      return res;
+    } else if (ArrayBuffer.isView(value)) {
+      return value;
+    } 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;
+  }
   map(value) {
     return this._map(value, void 0);
   }
@@ -1394,35 +1345,30 @@ var DeepMapperAsync = class {
     }
     return this._fn(value, this._recurse, key);
   }
-  constructor(_fn) {
-    _define_property7(this, "_fn", void 0);
-    _define_property7(this, "_cyclic", void 0);
-    _define_property7(this, "_recurse", void 0);
-    this._fn = _fn;
-    this._cyclic = /* @__PURE__ */ new Map();
-    this._recurse = async (value) => {
-      if (this._cyclic.has(value)) {
-        return this._cyclic.get(value);
+  _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);
       }
-      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;
+      return res;
+    } else if (ArrayBuffer.isView(value)) {
+      return value;
+    } 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)) {
@@ -1456,27 +1402,27 @@ var orderKeys = (obj, order) => {
 
 // src/order.ts
 var inferObjectOrder = (objectMap, order = []) => {
-  const orderedObjects = order.reduce((acc, id) => {
-    if (id in objectMap) {
-      acc.objects.push(objectMap[id]);
-      acc.ids.add(id);
+  const orderedObjects = order.reduce((acc, id2) => {
+    if (id2 in objectMap) {
+      acc.objects.push(objectMap[id2]);
+      acc.ids.add(id2);
     }
     return acc;
   }, {
     objects: [],
     ids: /* @__PURE__ */ new Set()
   });
-  const { objects } = Object.keys(objectMap).reduce((acc, id) => {
-    if (!acc.ids.has(id)) {
-      acc.objects.push(objectMap[id]);
+  const { objects } = Object.keys(objectMap).reduce((acc, id2) => {
+    if (!acc.ids.has(id2)) {
+      acc.objects.push(objectMap[id2]);
     }
     return acc;
   }, orderedObjects);
   return objects;
 };
 var inferRecordOrder = (objectMap, order = []) => {
-  return Object.assign(order.filter((id) => id in objectMap).reduce((acc, id) => {
-    acc[id] = null;
+  return Object.assign(order.filter((id2) => id2 in objectMap).reduce((acc, id2) => {
+    acc[id2] = null;
     return acc;
   }, {}), objectMap);
 };
@@ -1511,7 +1457,18 @@ var omit = (obj, keys2) => {
 
 // src/platform.ts
 var isNode = () => typeof process !== "undefined" && process.versions != null && process.versions.node != null;
-var mobileAndTabletCheck = () => {
+var isBun = () => globalThis.Bun !== void 0;
+var isTauri = () => !!globalThis.__TAURI__;
+var isMobile = () => {
+  let check = false;
+  (function(a) {
+    if (/(android|bb\d+|meego).+mobile|avantgo|bada\/|blackberry|blazer|compal|elaine|fennec|hiptop|iemobile|ip(hone|od)|iris|kindle|lge |maemo|midp|mmp|mobile.+firefox|netfront|opera m(ob|in)i|palm( os)?|phone|p(ixi|re)\/|plucker|pocket|psp|series(4|6)0|symbian|treo|up\.(browser|link)|vodafone|wap|windows ce|xda|xiino/i.test(a) || /1207|6310|6590|3gso|4thp|50[1-6]i|770s|802s|a wa|abac|ac(er|oo|s\-)|ai(ko|rn)|al(av|ca|co)|amoi|an(ex|ny|yw)|aptu|ar(ch|go)|as(te|us)|attw|au(di|\-m|r |s )|avan|be(ck|ll|nq)|bi(lb|rd)|bl(ac|az)|br(e|v)w|bumb|bw\-(n|u)|c55\/|capi|ccwa|cdm\-|cell|chtm|cldc|cmd\-|co(mp|nd)|craw|da(it|ll|ng)|dbte|dc\-s|devi|dica|dmob|do(c|p)o|ds(12|\-d)|el(49|ai)|em(l2|ul)|er(ic|k0)|esl8|ez([4-7]0|os|wa|ze)|fetc|fly(\-|_)|g1 u|g560|gene|gf\-5|g\-mo|go(\.w|od)|gr(ad|un)|haie|hcit|hd\-(m|p|t)|hei\-|hi(pt|ta)|hp( i|ip)|hs\-c|ht(c(\-| |_|a|g|p|s|t)|tp)|hu(aw|tc)|i\-(20|go|ma)|i230|iac( |\-|\/)|ibro|idea|ig01|ikom|im1k|inno|ipaq|iris|ja(t|v)a|jbro|jemu|jigs|kddi|keji|kgt( |\/)|klon|kpt |kwc\-|kyo(c|k)|le(no|xi)|lg( g|\/(k|l|u)|50|54|\-[a-w])|libw|lynx|m1\-w|m3ga|m50\/|ma(te|ui|xo)|mc(01|21|ca)|m\-cr|me(rc|ri)|mi(o8|oa|ts)|mmef|mo(01|02|bi|de|do|t(\-| |o|v)|zz)|mt(50|p1|v )|mwbp|mywa|n10[0-2]|n20[2-3]|n30(0|2)|n50(0|2|5)|n7(0(0|1)|10)|ne((c|m)\-|on|tf|wf|wg|wt)|nok(6|i)|nzph|o2im|op(ti|wv)|oran|owg1|p800|pan(a|d|t)|pdxg|pg(13|\-([1-8]|c))|phil|pire|pl(ay|uc)|pn\-2|po(ck|rt|se)|prox|psio|pt\-g|qa\-a|qc(07|12|21|32|60|\-[2-7]|i\-)|qtek|r380|r600|raks|rim9|ro(ve|zo)|s55\/|sa(ge|ma|mm|ms|ny|va)|sc(01|h\-|oo|p\-)|sdk\/|se(c(\-|0|1)|47|mc|nd|ri)|sgh\-|shar|sie(\-|m)|sk\-0|sl(45|id)|sm(al|ar|b3|it|t5)|so(ft|ny)|sp(01|h\-|v\-|v )|sy(01|mb)|t2(18|50)|t6(00|10|18)|ta(gt|lk)|tcl\-|tdg\-|tel(i|m)|tim\-|t\-mo|to(pl|sh)|ts(70|m\-|m3|m5)|tx\-9|up(\.b|g1|si)|utst|v400|v750|veri|vi(rg|te)|vk(40|5[0-3]|\-v)|vm40|voda|vulc|vx(52|53|60|61|70|80|81|83|85|98)|w3c(\-| )|webc|whit|wi(g |nc|nw)|wmlb|wonu|x700|yas\-|your|zeto|zte\-/i.test(a.substr(0, 4))) {
+      check = true;
+    }
+  })(navigator.userAgent || navigator.vendor || window.opera);
+  return check;
+};
+var isMobileOrTablet = () => {
   let check = false;
   ((a) => {
     if (/(android|bb\d+|meego).+mobile|avantgo|bada\/|blackberry|blazer|compal|elaine|fennec|hiptop|iemobile|ip(hone|od)|iris|kindle|lge |maemo|midp|mmp|mobile.+firefox|netfront|opera m(ob|in)i|palm( os)?|phone|p(ixi|re)\/|plucker|pocket|psp|series(4|6)0|symbian|treo|up\.(browser|link)|vodafone|wap|windows ce|xda|xiino|android|ipad|playbook|silk/i.test(a) || /1207|6310|6590|3gso|4thp|50[1-6]i|770s|802s|a wa|abac|ac(er|oo|s\-)|ai(ko|rn)|al(av|ca|co)|amoi|an(ex|ny|yw)|aptu|ar(ch|go)|as(te|us)|attw|au(di|\-m|r |s )|avan|be(ck|ll|nq)|bi(lb|rd)|bl(ac|az)|br(e|v)w|bumb|bw\-(n|u)|c55\/|capi|ccwa|cdm\-|cell|chtm|cldc|cmd\-|co(mp|nd)|craw|da(it|ll|ng)|dbte|dc\-s|devi|dica|dmob|do(c|p)o|ds(12|\-d)|el(49|ai)|em(l2|ul)|er(ic|k0)|esl8|ez([4-7]0|os|wa|ze)|fetc|fly(\-|_)|g1 u|g560|gene|gf\-5|g\-mo|go(\.w|od)|gr(ad|un)|haie|hcit|hd\-(m|p|t)|hei\-|hi(pt|ta)|hp( i|ip)|hs\-c|ht(c(\-| |_|a|g|p|s|t)|tp)|hu(aw|tc)|i\-(20|go|ma)|i230|iac( |\-|\/)|ibro|idea|ig01|ikom|im1k|inno|ipaq|iris|ja(t|v)a|jbro|jemu|jigs|kddi|keji|kgt( |\/)|klon|kpt |kwc\-|kyo(c|k)|le(no|xi)|lg( g|\/(k|l|u)|50|54|\-[a-w])|libw|lynx|m1\-w|m3ga|m50\/|ma(te|ui|xo)|mc(01|21|ca)|m\-cr|me(rc|ri)|mi(o8|oa|ts)|mmef|mo(01|02|bi|de|do|t(\-| |o|v)|zz)|mt(50|p1|v )|mwbp|mywa|n10[0-2]|n20[2-3]|n30(0|2)|n50(0|2|5)|n7(0(0|1)|10)|ne((c|m)\-|on|tf|wf|wg|wt)|nok(6|i)|nzph|o2im|op(ti|wv)|oran|owg1|p800|pan(a|d|t)|pdxg|pg(13|\-([1-8]|c))|phil|pire|pl(ay|uc)|pn\-2|po(ck|rt|se)|prox|psio|pt\-g|qa\-a|qc(07|12|21|32|60|\-[2-7]|i\-)|qtek|r380|r600|raks|rim9|ro(ve|zo)|s55\/|sa(ge|ma|mm|ms|ny|va)|sc(01|h\-|oo|p\-)|sdk\/|se(c(\-|0|1)|47|mc|nd|ri)|sgh\-|shar|sie(\-|m)|sk\-0|sl(45|id)|sm(al|ar|b3|it|t5)|so(ft|ny)|sp(01|h\-|v\-|v )|sy(01|mb)|t2(18|50)|t6(00|10|18)|ta(gt|lk)|tcl\-|tdg\-|tel(i|m)|tim\-|t\-mo|to(pl|sh)|ts(70|m\-|m3|m5)|tx\-9|up(\.b|g1|si)|utst|v400|v750|veri|vi(rg|te)|vk(40|5[0-3]|\-v)|vm40|voda|vulc|vx(52|53|60|61|70|80|81|83|85|98)|w3c(\-| )|webc|whit|wi(g |nc|nw)|wmlb|wonu|x700|yas\-|your|zeto|zte\-/i.test(a.substr(0, 4))) {
@@ -1533,7 +1490,7 @@ var iosCheck = () => {
 };
 var safariCheck = () => typeof navigator !== "undefined" && /^((?!chrome|android).)*safari/i.test(navigator.userAgent);
 var getHostPlatform = () => {
-  if (!("navigator" in window)) {
+  if (!("navigator" in globalThis)) {
     return "unknown";
   }
   const platform = (navigator.userAgentData?.platform || navigator.platform)?.toLowerCase();
@@ -1551,12 +1508,12 @@ var getHostPlatform = () => {
 };
 
 // src/position.ts
-var byPosition = ({ position: a = "static" }, { position: b = "static" }) => {
+var byPosition = ({ position: a }, { position: b }) => {
   if (a === b) {
     return 0;
-  } else if (a === "hoist" || b === "fallback") {
+  } else if (a === "first" || b === "last") {
     return -1;
-  } else if (b === "hoist" || a === "fallback") {
+  } else if (b === "first" || a === "last") {
     return 1;
   } else {
     return 0;
@@ -1709,6 +1666,43 @@ var removeProperties = (root, condition) => {
   return result;
 };
 
+// src/retry.ts
+var DEFAULT_RETRY_OPTIONS = {
+  count: 3,
+  delayMs: 100,
+  exponent: 2,
+  retryOnError: async () => true,
+  retryOnValue: async () => false
+};
+var retry = async (options, cb) => {
+  const fullOptions = {
+    ...DEFAULT_RETRY_OPTIONS,
+    ...options
+  };
+  let numRetries = 0, currentDelay = fullOptions.delayMs;
+  while (true) {
+    let result;
+    try {
+      result = await cb();
+    } catch (err) {
+      if (numRetries > fullOptions.count || !await fullOptions.retryOnError(err)) {
+        throw err;
+      }
+      await new Promise((resolve) => setTimeout(resolve, currentDelay));
+      currentDelay *= fullOptions.exponent;
+      numRetries++;
+      continue;
+    }
+    if (!await fullOptions.retryOnValue(result)) {
+      return result;
+    }
+    await new Promise((resolve) => setTimeout(resolve, currentDelay));
+    currentDelay *= fullOptions.exponent;
+    numRetries++;
+    continue;
+  }
+};
+
 // src/safe-await.ts
 var safeAwaitAll = async (source, taskFactory, onError) => {
   const failedItems = [];
@@ -1728,7 +1722,7 @@ var safeAwaitAll = async (source, taskFactory, onError) => {
 };
 
 // src/safe-instanceof.ts
-var instanceTag = Symbol("instanceTag");
+var instanceTag = /* @__PURE__ */ Symbol("instanceTag");
 var safeInstanceof = (tag) => (target) => {
   target.prototype[instanceTag] = tag;
   Object.defineProperty(target.prototype, Symbol.hasInstance, {
@@ -1740,48 +1734,142 @@ 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;
+    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);
+      return JSON.parse(str);
     } catch {
     }
   }
   return defaultValue;
 };
+var safeUrl = (str) => {
+  try {
+    return new URL(str ?? "");
+  } catch {
+    return void 0;
+  }
+};
 
-// src/sliding-window-summary.ts
-import { invariant as invariant5 } from "@dxos/invariant";
-function _define_property8(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
+// src/safe-stringify.ts
+var SKIP = Object.freeze({});
+function safeStringify(obj, filter = defaultFilter, indent = 2) {
+  const seen = /* @__PURE__ */ new WeakMap();
+  function replacer(key, value) {
+    try {
+      let path = key;
+      if (!key) {
+        path = "$";
+        if (value != null && typeof value === "object") {
+          seen.set(value, path);
+        }
+        return value;
+      } else if (this) {
+        const parentPath = seen.get(this);
+        path = parentPath ? `${parentPath}.${key}` : key;
+      }
+      if (value == null) {
+        return value;
+      }
+      if (typeof value === "function") {
+        return void 0;
+      }
+      if (typeof value === "object" && Object.getPrototypeOf(value) !== Object.prototype && !Array.isArray(value)) {
+        return void 0;
+      }
+      if (typeof value === "object" && value !== null) {
+        const exists = seen.get(value);
+        if (exists) {
+          return `[${path} => ${exists}]`;
+        }
+        seen.set(value, path);
+      }
+      if (filter) {
+        const filteredValue = filter?.(key, value);
+        if (filteredValue !== void 0) {
+          return filteredValue === SKIP ? void 0 : filteredValue;
+        }
+      }
+      return value;
+    } catch (error) {
+      return `ERROR: ${error.message}`;
+    }
+  }
+  try {
+    return JSON.stringify(obj, replacer, indent);
+  } catch (error) {
+    return `ERROR: ${error.message}`;
   }
-  return obj;
 }
-var __dxlog_file5 = "/__w/dxos/dxos/packages/common/util/src/sliding-window-summary.ts";
+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 SKIP;
+    }
+    if (maxArrayLen != null && Array.isArray(value) && value.length > maxArrayLen) {
+      return `[length: ${value.length}]`;
+    }
+    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 SKIP;
+    }
+    if (parse?.includes(key) && typeof value === "string") {
+      try {
+        return JSON.parse(value);
+      } catch {
+        return value;
+      }
+    }
+    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 SlidingWindowSummary = class {
+  _buffer;
+  _sum = 0;
+  _precision;
+  constructor(options) {
+    this._buffer = new CircularBuffer(options.dataPoints);
+    if (options.precision != null) {
+      invariant5(options.precision >= 0);
+      this._precision = Math.pow(10, options.precision);
+    }
+  }
   record(value) {
     const evicted = this._buffer.push(value);
     this._sum += value - (evicted ?? 0);
@@ -1816,24 +1904,6 @@ var SlidingWindowSummary = class {
     }
     return Math.round(value * this._precision) / this._precision;
   }
-  constructor(options) {
-    _define_property8(this, "_buffer", void 0);
-    _define_property8(this, "_sum", 0);
-    _define_property8(this, "_precision", void 0);
-    this._buffer = new CircularBuffer(options.dataPoints);
-    if (options.precision != null) {
-      invariant5(options.precision >= 0, void 0, {
-        F: __dxlog_file5,
-        L: 26,
-        S: this,
-        A: [
-          "options.precision >= 0",
-          ""
-        ]
-      });
-      this._precision = Math.pow(10, options.precision);
-    }
-  }
 };
 
 // src/sort.ts
@@ -1865,6 +1935,10 @@ var capitalize = (str) => {
   }
   return str.charAt(0).toUpperCase() + str.slice(1);
 };
+function inline(strings, ...values) {
+  const raw = strings.reduce((out, str, i) => out + str + (i < values.length ? String(values[i]) : ""), "");
+  return raw.replace(/\s+/g, " ").trim();
+}
 function trim(strings, ...values) {
   const raw = strings.reduce((out, str, i) => {
     out += str;
@@ -1877,8 +1951,12 @@ function trim(strings, ...values) {
     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();
+  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");
 }
@@ -1896,18 +1974,6 @@ var throwUnhandledError = (error) => {
 
 // src/to-fallback.ts
 var idEmoji = [
-  // When changing this set, please check the result in a console or e.g. RunKit (https://runkit.com/thure/642214441dd6ae000855a8de)
-  // Emoji sometimes use a combination of code points, and some code points aren't visible on their own, so by adding or deleting you may unintentionally create non-visible items.
-  // This set was chosen from the characters in Unicode Emoji v15.0 based on the following criteria:
-  // – not people or isolated anthropomorphic faces
-  // – not flags
-  // – more concrete than abstract
-  // – less culturally specific
-  // – less easily confused with another emoji in the set
-  // – requires less special knowledge to identify
-  // – less likely to evoke negative feelings (no meat, no drugs, no weapons, etc)
-  // – less common as a signifier in UX
-  // NOTE that this is intentionally an array of strings because of the way emoji graphemes work.
   "\u{1F47B}",
   "\u{1F479}",
   "\u{1F47D}",
@@ -2043,17 +2109,18 @@ var idEmoji = [
 ];
 var idHue = [
   "red",
-  // 'orange' as const, /* More shades in these palettes are considered “ugly” */
+  "orange",
   "amber",
-  // 'yellow' as const, /* More shades in these palettes are considered “ugly” */
+  "yellow",
   "lime",
   "green",
   "emerald",
   "teal",
   "cyan",
-  // 'sky' as const, /* Omitted since it is quite similar to the primary accent palette */
-  // 'blue' as const, /* Omitted since it is quite similar to the primary accent palette */
-  // 'indigo' as const, /* Omitted since it is quite similar to the primary accent palette */
+  // Omit colors similar to primary accent.
+  // 'sky' as const,
+  // 'blue' as const,
+  // 'indigo' as const,
   "violet",
   "purple",
   "fuchsia",
@@ -2080,20 +2147,9 @@ var toFallback = (hash) => {
 };
 
 // src/tracer.ts
-function _define_property9(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
 var Tracer = class {
+  _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?
@@ -2103,8 +2159,8 @@ var Tracer = class {
   keys() {
     return Array.from(this._events.keys());
   }
-  get(id, filter) {
-    const events = this._events.get(id);
+  get(id2, filter) {
+    const events = this._events.get(id2);
     if (filter) {
       return events?.filter((event) => Object.entries(filter).every(([key, value]) => event?.value[key] === value));
     }
@@ -2121,11 +2177,11 @@ var Tracer = class {
     this._recording = false;
     return this;
   }
-  emit(id, value) {
-    this._post(this._createEvent(id, value));
+  emit(id2, value) {
+    this._post(this._createEvent(id2, value));
   }
-  mark(id, value) {
-    const event = this._createEvent(id, value);
+  mark(id2, value) {
+    const event = this._createEvent(id2, value);
     const start = performance.now();
     return {
       start,
@@ -2135,9 +2191,9 @@ var Tracer = class {
       }
     };
   }
-  _createEvent(id, value) {
+  _createEvent(id2, value) {
     const event = {
-      id,
+      id: id2,
       timestamp: Date.now()
     };
     if (value !== void 0) {
@@ -2150,10 +2206,6 @@ var Tracer = class {
       defaultMap(this._events, event.id, []).push(event);
     }
   }
-  constructor() {
-    _define_property9(this, "_events", /* @__PURE__ */ new Map());
-    _define_property9(this, "_recording", false);
-  }
 };
 var tracer = new Tracer();
 
@@ -2228,69 +2280,116 @@ var arrayMove = (array, from, to) => {
   array.splice(to < 0 ? array.length + to : to, 0, array.splice(from, 1)[0]);
   return array;
 };
+function arraySwap(array, from, to) {
+  const current = array[from];
+  array[from] = array[to];
+  array[to] = current;
+  return array;
+}
 
 // src/unit.ts
-var Formatter = (unit) => {
-  return (n, precision = 2) => {
+var createFormat = (unit) => {
+  return (n, precision = unit.precision ?? 0) => {
     const value = n / unit.quotient;
-    return `${value.toFixed(precision)}${unit.symbol}`;
+    const formattedValue = value.toLocaleString("en-US", {
+      minimumFractionDigits: precision,
+      maximumFractionDigits: precision
+    });
+    return {
+      unit,
+      value,
+      formattedValue,
+      toString: () => `${formattedValue}${unit.symbol}`
+    };
   };
 };
+var MS_SECONDS = 1e3;
+var MS_MINUTES = 60 * MS_SECONDS;
+var MS_HOURS = 60 * MS_MINUTES;
 var Unit = {
-  // ms.
-  Hour: Formatter({
+  // 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: 60 * 60 * 1e3
+    quotient: MS_HOURS
   }),
-  Minute: Formatter({
+  Minute: createFormat({
     symbol: "m",
-    quotient: 60 * 1e3
+    quotient: MS_MINUTES
   }),
-  Second: Formatter({
+  Second: createFormat({
     symbol: "s",
-    quotient: 1e3
+    quotient: MS_SECONDS,
+    precision: 1
   }),
-  Millisecond: Formatter({
+  Millisecond: createFormat({
     symbol: "ms",
     quotient: 1
   }),
   Duration: (n) => {
-    const hours = Math.floor(n / (60 * 60 * 1e3));
-    const minutes = Math.floor(n % (60 * 60 * 1e3) / (60 * 1e3));
+    const hours = Math.floor(n / MS_HOURS);
+    const minutes = Math.floor(n % MS_HOURS / MS_MINUTES);
     if (hours) {
-      return minutes ? `${hours}h ${minutes}m` : `${hours}h`;
+      const formattedValue = minutes ? `${hours}h ${minutes}m` : `${hours}h`;
+      return {
+        unit: {
+          symbol: "h",
+          quotient: MS_HOURS
+        },
+        value: hours,
+        formattedValue,
+        toString: () => formattedValue
+      };
     }
-    const seconds = Math.floor(n % (60 * 1e3) / 1e3);
     if (minutes) {
-      return seconds ? `${minutes}m ${seconds}s` : `${minutes}m`;
+      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 `${(n / 1e3).toFixed(1)}s`;
+      return Unit.Second(n);
     }
-    return `${n}ms`;
-  },
-  // bytes (note KB via KiB).
-  Gigabyte: Formatter({
-    symbol: "GB",
-    quotient: 1e3 * 1e3 * 1e3
-  }),
-  Megabyte: Formatter({
-    symbol: "MB",
-    quotient: 1e3 * 1e3
-  }),
-  Kilobyte: Formatter({
-    symbol: "KB",
-    quotient: 1e3
-  }),
-  // general.
-  Thousand: Formatter({
-    symbol: "k",
-    quotient: 1e3
-  }),
-  Percent: Formatter({
-    symbol: "%",
-    quotient: 1 / 100
-  })
+    return Unit.Millisecond(n);
+  }
 };
 
 // src/url.ts
@@ -2303,20 +2402,22 @@ var createUrl = (url, search) => {
 };
 
 // src/weak.ts
-function _define_property10(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
 var WeakDictionary = class {
+  _internal = /* @__PURE__ */ new Map();
+  _finalization = new FinalizationRegistry(({ key, ref }) => {
+    if (this._internal.get(key) === ref) {
+      this._internal.delete(key);
+    }
+  });
+  constructor(entries2) {
+    if (entries2) {
+      for (const [key, value] of entries2) {
+        const ref = new WeakRef(value);
+        this._internal.set(key, ref);
+        this._register(key, value, ref);
+      }
+    }
+  }
   *entries() {
     for (const [key, value] of this._internal) {
       yield [
@@ -2355,10 +2456,45 @@ var WeakDictionary = class {
     return this._internal.get(key)?.deref();
   }
   set(key, value) {
-    this._internal.set(key, new WeakRef(value));
-    this._register(key, value);
+    const previous = this._internal.get(key)?.deref();
+    if (previous) {
+      this._unregister(previous);
+    }
+    const ref = new WeakRef(value);
+    this._internal.set(key, ref);
+    this._register(key, value, ref);
     return this;
   }
+  /**
+  * Returns the value for the given key if present, otherwise inserts and returns the default value.
+  * @param key - The key to look up or insert.
+  * @param defaultValue - The value to insert if the key is not present.
+  * @returns The existing or newly inserted value.
+  */
+  getOrInsert(key, defaultValue) {
+    const existing = this.get(key);
+    if (existing !== void 0) {
+      return existing;
+    }
+    this.set(key, defaultValue);
+    return defaultValue;
+  }
+  /**
+  * Returns the value for the given key if present, otherwise computes, inserts, and returns a new value.
+  * The callback is only invoked when the key is missing.
+  * @param key - The key to look up or insert.
+  * @param callbackfn - Function to compute the value if the key is not present.
+  * @returns The existing or newly computed value.
+  */
+  getOrInsertComputed(key, callbackfn) {
+    const existing = this.get(key);
+    if (existing !== void 0) {
+      return existing;
+    }
+    const value = callbackfn(key);
+    this.set(key, value);
+    return value;
+  }
   has(key) {
     return this._internal.has(key) && this._internal.get(key).deref() !== void 0;
   }
@@ -2389,25 +2525,15 @@ var WeakDictionary = class {
       }
     });
   }
-  _register(key, value) {
-    this._finalization.register(value, () => {
-      this._internal.delete(key);
+  _register(key, value, ref) {
+    this._finalization.register(value, {
+      key,
+      ref
     }, value);
   }
   _unregister(value) {
     this._finalization.unregister(value);
   }
-  constructor(entries2) {
-    _define_property10(this, "_internal", /* @__PURE__ */ new Map());
-    _define_property10(this, "_finalization", new FinalizationRegistry((cleanUpCallback) => {
-      cleanUpCallback();
-    }));
-    this._internal = new Map(entries2?.map(([key, value]) => [
-      key,
-      new WeakRef(value)
-    ]));
-    entries2?.forEach(([key, value]) => this._register(key, value));
-  }
 };
 export {
   BitField,
@@ -2418,12 +2544,14 @@ export {
   ComplexSet,
   HumanHasher,
   MapEntry,
+  SKIP,
   SlidingWindowSummary,
   Tracer,
   Unit,
   WeakDictionary,
   accessBy,
   arrayMove,
+  arraySwap,
   arrayToBuffer,
   arrayToHex,
   arrayToString,
@@ -2434,19 +2562,29 @@ export {
   capitalize,
   chunkArray,
   clamp,
+  clearCaches,
+  clearIndexedDB,
+  clearOPFS,
+  clearServiceWorkers,
   clearUndefined,
+  coerceArray,
   compareMulti,
   compareObject,
   compareScalar,
   compareString,
+  compositeKey,
   createBinder,
   createBucketReducer,
+  createFilename,
   createGroupReducer,
+  createReplacer,
   createSetDispatch,
   createUrl,
   decamelize,
+  decodeUint8ArrayFromJson,
   deepMapValues,
   deepMapValuesAsync,
+  defaultFilter,
   defaultMap,
   defer,
   deferAsync,
@@ -2454,11 +2592,12 @@ export {
   diff,
   distinctBy,
   doAsync,
+  encodeUint8ArrayToJson,
   entries,
   entry,
   exponentialBackoffInterval,
   forEachAsync,
-  get,
+  formatErrorWithCauses,
   getAsyncProviderValue,
   getDate,
   getDebugName,
@@ -2471,16 +2610,25 @@ export {
   hexToHue,
   humanize,
   hyphenize,
+  id,
   idEmoji,
   idHue,
   inferObjectOrder,
   inferRecordOrder,
+  inline,
   intersectBy,
   intersection,
   iosCheck,
+  isBun,
+  isEncodedUint8Array,
+  isMobile,
+  isMobileOrTablet,
   isNode,
   isNonNullable,
+  isTauri,
   isTruthy,
+  isWellFormedId,
+  isWellFormedIdPart,
   joinTables,
   jsonKeyReplacer,
   jsonReplacer,
@@ -2495,7 +2643,6 @@ export {
   makeSet,
   mapValues,
   median,
-  mobileAndTabletCheck,
   numericalValues,
   omit,
   orderKeys,
@@ -2511,15 +2658,18 @@ export {
   removeBy,
   removeProperties,
   removeUndefinedProperties,
+  retry,
   safariCheck,
   safeAwaitAll,
   safeInstanceof,
   safeParseFloat,
   safeParseInt,
   safeParseJson,
-  set,
+  safeStringify,
+  safeUrl,
   setDeep,
   sortKeys,
+  splitCompositeKey,
   stringToArray,
   stringifyTree,
   stripUndefined,