@dxos/util 0.10.0 → 0.11.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/util",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "Temporary bucket for misc functions, which should graduate into separate packages.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -16,11 +16,7 @@
     ".": {
       "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
-      "browser": "./dist/lib/browser/index.mjs",
-      "node": {
-        "require": "./dist/lib/node/index.cjs",
-        "default": "./dist/lib/node-esm/index.mjs"
-      }
+      "import": "./dist/lib/index.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -30,13 +26,13 @@
   ],
   "dependencies": {
     "@hazae41/symbol-dispose-polyfill": "^1.0.2",
-    "@dxos/debug": "0.10.0",
-    "@dxos/keys": "0.10.0",
-    "@dxos/invariant": "0.10.0",
-    "@dxos/node-std": "0.10.0"
+    "@dxos/invariant": "0.11.1",
+    "@dxos/keys": "0.11.1",
+    "@dxos/debug": "0.11.1",
+    "@dxos/node-std": "0.11.1"
   },
   "devDependencies": {
-    "@dxos/crypto": "0.10.0"
+    "@dxos/crypto": "0.11.1"
   },
   "publishConfig": {
     "access": "public"

package/src/to-fallback.ts

@@ -60,6 +60,37 @@ export const idHue = [
   'rose' as const,
 ];
 
+/** FNV-1a hash of an arbitrary string, as an unsigned 32-bit integer. */
+const fnv1a = (id: string): number => {
+  let hash = 0x811c9dc5;
+  for (let index = 0; index < id.length; index++) {
+    hash ^= id.charCodeAt(index);
+    hash = Math.imul(hash, 0x01000193);
+  }
+  return Math.abs(hash);
+};
+
+/**
+ * Deterministic palette hue for an arbitrary id string that isn't hex-parseable (e.g. an identity
+ * DID). Seeds the shared {@link idHue} palette via FNV-1a so the same id always maps to the same hue,
+ * matching the colouring used for avatars/tags elsewhere. Prefer {@link hexToHue} when a hex
+ * identity key is available (it aligns with the awareness-cursor palette).
+ */
+export const stringToHue = (id: string): (typeof idHue)[number] => idHue[fnv1a(id) % idHue.length];
+
+/**
+ * Deterministic avatar fallback (emoji + hue) for an arbitrary id string (e.g. an identity DID).
+ * Shares {@link stringToHue}'s FNV-1a seed, so `stringToFallback(id).hue === stringToHue(id)` — an
+ * avatar seeded from an id and a tag coloured by {@link stringToHue} for the same id agree.
+ */
+export const stringToFallback = (id: string): FallbackValue => {
+  const hash = fnv1a(id);
+  return {
+    emoji: idEmoji[Math.floor(hash / idHue.length) % idEmoji.length],
+    hue: idHue[hash % idHue.length],
+  };
+};
+
 export const keyToEmoji = (key: PublicKey) => keyToFallback(key).emoji;
 export const hexToEmoji = (hex: string) => hexToFallback(hex).emoji;
 export const toEmoji = (hash: number) => toFallback(hash).emoji;

package/src/unit.test.ts

@@ -2,12 +2,17 @@
 // Copyright 2025 DXOS.org
 //
 
-import { describe, it } from 'vitest';
+import { describe, test } from 'vitest';
 
 import { Unit } from './unit';
 
 describe('url', () => {
-  it('duration', ({ expect }) => {
+  test('magnitudes', ({ expect }) => {
+    expect(Unit.Thousand(42_154, 1).toString()).toBe('42.2k');
+    expect(Unit.Million(36_200_000, 1).toString()).toBe('36.2M');
+  });
+
+  test('duration', ({ expect }) => {
     const tests: [number, string][] = [
       [0, '0ms'],
       [1, '1ms'],

package/src/unit.ts

@@ -39,13 +39,14 @@ const MS_HOURS = 60 * MS_MINUTES;
 
 export const Unit: Record<string, UnitFormat> = {
   // General.
-  Percent: createFormat({ symbol: '%', quotient: 1 / 100, precision: 2 }),
-  Thousand: createFormat({ symbol: 'k', quotient: 1_000, precision: 2 }),
+  Percent: createFormat({ symbol: '%', quotient: 1 / 100, precision: 1 }),
+  Thousand: createFormat({ symbol: 'k', quotient: 1_000, precision: 1 }),
+  Million: createFormat({ symbol: 'M', quotient: 1_000_000, precision: 1 }),
 
   // Bytes (note KB vs KiB).
-  Gigabyte: createFormat({ symbol: 'GB', quotient: 1_000 * 1_000 * 1_000, precision: 2 }),
-  Megabyte: createFormat({ symbol: 'MB', quotient: 1_000 * 1_000, precision: 2 }),
-  Kilobyte: createFormat({ symbol: 'KB', quotient: 1_000, precision: 2 }),
+  Gigabyte: createFormat({ symbol: 'GB', quotient: 1_000 * 1_000 * 1_000, precision: 1 }),
+  Megabyte: createFormat({ symbol: 'MB', quotient: 1_000 * 1_000, precision: 1 }),
+  Kilobyte: createFormat({ symbol: 'KB', quotient: 1_000, precision: 1 }),
   Byte: createFormat({ symbol: 'B', quotient: 1 }),
 
   // Time.