@ai-matrx/kit 0.7.4 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,190 @@
 # Changelog
 
+## 0.9.0 — 2026-09-07
+
+**THE CONFIRM DIALOG LEAVES THIS PACKAGE.** `@ai-matrx/kit/confirm` is removed.
+The dialog body — `ConfirmDialog` and `ConfirmDialogHost` — now lives in
+**`@ai-matrx/design-system` 0.11.0**. What stays here is
+`@ai-matrx/kit/confirm-opener`: the pure imperative `confirm()`, the host
+registry, and the request queue, unchanged.
+
+**Why.** kit's confirm shipped its own inlined AlertDialog wearing
+`data-[state=open]:animate-in … zoom-in-95 … slide-in-from-top-[48%]` — utilities
+the `tailwindcss-animate` / `tw-animate-css` HOST plugin supplies, which a
+node_modules package can neither ship nor require — plus a hardcoded
+`bg-black/80` scrim. kit ships no stylesheet at all, so in three of the four
+consumers the most consequential surface in the product (the one standing between
+a user and a destroyed thing) appeared with no animation, no error, and a scrim
+that ignored the theme. Its unclamped content could also push Cancel and Continue
+below the fold of a short viewport — and an AlertDialog does not dismiss on a
+backdrop click, so a long confirmation was a genuine dead end.
+
+kit could not import design-system's 0.10.0 fix: **design-system depends on kit**,
+so importing back is a cycle. Giving kit its own `styles.css` would invent a
+second required-CSS contract no consumer performs — the same silent host contract
+one layer down (C26). So the surface moved to the package that owns the surface,
+exactly as the Tooltip did in tap-target 0.2.0 (census rows 19i / 20a).
+
+**No shim.** There is no `./confirm` re-export. One surface, one owner — and the
+packed-tarball canary now asserts the ABSENCE of `./confirm` and of both dropped
+dependencies, so the twin cannot grow back.
+
+### Removed
+
+- `@ai-matrx/kit/confirm` (subpath, entry, and every export: `ConfirmDialog`,
+  `ConfirmDialogProps`, `ConfirmDialogHost`, and the `confirm` re-export).
+- `confirm` / `ConfirmOptions` from the ROOT barrel (`@ai-matrx/kit`) — the
+  opener is not re-exported there, because the root barrel is `"use client"`
+  stamped and the opener must stay importable from Server Components, API routes
+  and Node scripts.
+- Runtime dependencies `@radix-ui/react-alert-dialog` and `tailwind-merge`. Both
+  existed only for the dialog; kit's install is that much smaller.
+
+### Unchanged
+
+- `@ai-matrx/kit/confirm-opener` — `confirm`, `ConfirmOptions`, and the
+  `Symbol.for("ai-matrx.kit.confirm-opener-state")` globalThis slot the host
+  registry lives on. Every behavior is identical: pre-mount calls queue,
+  concurrent calls present one at a time, and with no host mounted a `confirm()`
+  promise stays pending forever rather than inventing a silent default.
+
+### Consumer action (C28)
+
+**Every consumer that mounted the kit confirm host or rendered the kit dialog
+must repoint. Two mechanical edits, no behavior change.**
+
+1. **Take `@ai-matrx/design-system` >= 0.11.0** alongside kit >= 0.9.0 (specs stay
+   `"latest"` / `workspace:*` per C15 — this is an install, not a spec change).
+
+2. **The host** — wherever you mounted it:
+
+   ```diff
+   - import { ConfirmDialogHost } from "@ai-matrx/kit/confirm";
+   + import { ConfirmDialogHost } from "@ai-matrx/design-system";
+   ```
+
+   Next.js hosts that lazy-loaded it for the fragmentation law change only the
+   module specifier:
+
+   ```diff
+   - dynamic(() => import("@ai-matrx/kit/confirm").then((m) => m.ConfirmDialogHost), { ssr: false })
+   + dynamic(() => import("@ai-matrx/design-system").then((m) => m.ConfirmDialogHost), { ssr: false })
+   ```
+
+3. **The declarative dialog:**
+
+   ```diff
+   - import { ConfirmDialog, type ConfirmDialogProps } from "@ai-matrx/kit/confirm";
+   + import { ConfirmDialog, type ConfirmDialogProps } from "@ai-matrx/design-system";
+   ```
+
+   Props are identical. `portalContainer` still wins; with it omitted the dialog
+   now also honours design-system's `PortalContainerProvider`, so a host that
+   already provides that container can drop its own wrapper.
+
+4. **The imperative `confirm()`** — if you imported it from `@ai-matrx/kit/confirm`
+   or from the kit ROOT, repoint to the opener (this is the light-twin entry every
+   call site should have been using anyway):
+
+   ```diff
+   - import { confirm } from "@ai-matrx/kit/confirm";
+   + import { confirm } from "@ai-matrx/kit/confirm-opener";
+   ```
+
+5. **Load design-system's stylesheet** if you do not already — `@ai-matrx/design-system/styles.css`
+   plus `tokens.css`. This is what the move buys you: the confirm surface finally
+   animates and scrims from your theme in EVERY consumer, not only in the one whose
+   CSS entry happened to load an animation plugin.
+
+## 0.8.0 — 2026-09-07
+
+**THE HOME FOR THE FLEET'S SHARED FORMATTERS.** Three new pure subpaths —
+`./format`, `./html-escape`, `./uuid` — closing the census's headline finding
+H1: *the packages were duplicating each other*, which is why ~65 host twins had
+nowhere correct to point.
+
+**Why kit is the home.** `node scripts/check_ts_sibling_graph.mjs --order`
+reports `@ai-matrx/kit` with ZERO sibling dependencies — it is at the bottom of
+the sibling DAG, so `meet`, `messaging`, `associations`, `diff`, `media` and
+`print` can all depend on it without creating a cycle, and so can every host
+app in every repo. It is also, by charter, the "little primitives every Matrx
+app speaks" package. No new package was created (new packages need Arman's
+approval), and nothing here re-exports from a sibling: these bodies now live in
+exactly one place.
+
+### `./format` — durations, relative time, byte sizes, initials
+
+Absorbed from `@ai-matrx/meet` (`formatDuration`, `getInitials`,
+`avatarPaletteIndex`), `@ai-matrx/messaging` (`getInitials`,
+`avatarPaletteIndex`), `@ai-matrx/associations/react` (`formatRelativeTime`),
+`@ai-matrx/diff` (`formatRelativeTime`, `parseTimestamp`, `formatAbsoluteDate`)
+and `@ai-matrx/media/react` (`formatFileSize`). Every behaviour those five
+asserted is re-asserted in `src/format.test.ts` (60 tests across the three new
+modules).
+
+**THE UNIT LAW.** There is deliberately no `formatDuration`. The fleet's twins
+variously took milliseconds, seconds and minutes behind an identical signature.
+The unit is now in the name: `formatDurationMs`, `formatDurationSeconds`,
+`formatDurationMinutes` — plus `durationMsBetween(from, to, now)` for the
+"start, maybe-end, else now" pattern six surfaces had rebuilt.
+
+**The display decisions, made once and deliberately:**
+
+- **Three duration voices**, chosen by `style`, because the fleet genuinely
+  speaks three and pretending otherwise would have been the wrong unification:
+  `"clock"` (default) `0:00` / `9:04` / `1:02:33` for anything a human watches
+  tick; `"compact"` `250ms` / `5.2s` / `5m 30s` / `1h 02m` for elapsed work;
+  `"coarse"` `45 min` / `1h 30m` for lengths read at a glance. `compact` keeps
+  one decimal below ten seconds and whole seconds above it; `coarse` prints
+  `< 1 min` rather than a false `0 min`.
+- **A negative duration clamps to zero** unless `signed: true`. A negative
+  elapsed time is nearly always a clock bug.
+- **Unknown is never zero.** `null` / `undefined` / `NaN` / `Infinity` take an
+  explicit `fallback` (`"0:00"` for clock, `"—"` otherwise). A confident
+  `"0 B"` or `"0:00"` for "we do not know" is a screen telling a lie.
+- **`formatFileSize`**: binary units with short labels (`B`/`KB`/…/`PB`, never
+  `"Bytes"`), one decimal below ten in a unit and whole numbers above
+  (`2.0 KB`, `15 KB`), whole bytes below 1 KB, em-dash for unknown/negative.
+- **`formatRelativeTime`** unifies the two packages that disagreed about who
+  owned it, via `style`: `"short"` (`2m ago`, the dense default),
+  `"long"` (`2 minutes ago`), `"intl"` (`Intl.RelativeTimeFormat` with
+  `numeric: "auto"`, which is what the comments face wanted). `fallbackToInput`
+  echoes an unparseable string instead of an em-dash — degraded, never broken.
+  It runs over `parseTimestamp`, which carries diff's real correction: a
+  zone-less Postgres `timestamp without time zone` is read as UTC, not local,
+  killing the classic "times are off by N hours" report for every consumer.
+- **`getInitials`** takes FIRST + LAST, not first + second: `"Ana Maria
+  Rivera"` is `AR`. Both package copies did this and both were tested; six
+  matrx-frontend twins printed `AM`.
+
+### `./html-escape` — ONE escaper, with a decided character set
+
+Nine copies of `escapeHtml` were live across the fleet and **they did not
+escape the same characters** — three did `& < >` only, two added `"`, four
+added `'`. A string safe through one was an attribute break-out through
+another. The decided set is all five: `& < > " '` →
+`&amp; &lt; &gt; &quot; &#39;`, always, so the result is safe as element text
+*and* inside a quoted attribute. It lives here rather than in
+`@ai-matrx/print/core` because an HTML escaper must not drag in `jspdf` +
+`html2canvas`.
+
+### `./uuid` — two predicates, named so you cannot pick the wrong one
+
+The fleet had two different predicates both called `isUuid`, and the difference
+was invisible at the call site. Now: `isUuidShape` (lax 8-4-4-4-12, the right
+question for "id or slug?", accepts v7 and the nil UUID) and `isRfc4122Uuid`
+(version 1–5 + variant 8/9/a/b, the right question for a validation door on a
+public route, and it REJECTS the nil UUID and v6/v7/v8). A bare `isUuid` is
+deliberately not exported — a caller must choose.
+
+### Notes
+
+- All three subpaths are pure and **unstamped** (no `"use client"`): they are
+  imported by API routes, Server Components and Node scripts as often as by
+  client code. For the same reason they are **not** re-exported from the root
+  barrel, which carries the banner — import them by subpath.
+- No dependency was added. No existing export changed.
+
 ## 0.7.3 — 2026-08-30
 
 - Peer-dependency retrofit (register row X3 / law C23): the advisory-only

package/README.md

@@ -2,12 +2,19 @@
 
 The always-include AI Matrx kit: the little primitives every Matrx application speaks,
 one capability per subpath, tree-shaken to what you use. React is the only required
-peer; only four subpaths carry runtime dependencies, each because the dependency IS
-the capability: `/confirm` (`@radix-ui/react-alert-dialog` + `tailwind-merge` — its
-product is the dialog), `/json-format` (`json5` — tolerant parsing is the feature),
+peer; only three subpaths carry runtime dependencies, each because the dependency IS
+the capability: `/json-format` (`json5` — tolerant parsing is the feature),
 `/idb-store` (`idb` — the typed IndexedDB wrapper is the engine), and `/qr` (`jsqr`,
 loaded lazily only when the browser has no native `BarcodeDetector`).
 
+**The confirm DIALOG is not here — the opener is.** Since 0.9.0 the body
+(`ConfirmDialog`, `ConfirmDialogHost`) lives in
+[`@ai-matrx/design-system`](../design-system/README.md), which owns the AlertDialog,
+the shipped motion layer and the overlay scrim token. Mount
+`<ConfirmDialogHost />` from there once at your app root, then call `confirm()`
+from `@ai-matrx/kit/confirm-opener` anywhere. One surface, one owner: kit
+re-exports none of the dialog.
+
 ```bash
 npm install @ai-matrx/kit
 ```
@@ -22,7 +29,7 @@ npm install @ai-matrx/kit
 | `@ai-matrx/kit/concurrency` | `runWithConcurrency` | Bounded worker pool over an array with per-item failure isolation and a cooperative `shouldStart()` cancel hook. |
 | `@ai-matrx/kit/text-case` | `formatText`, `createFormatter` | Acronym-aware normalization of messy DB/API strings into title/sentence case with word-replacement overrides. |
 | `@ai-matrx/kit/drafts` | `useDurableDraft` + the local-drafts store | User-authored text that survives anything: write-through localStorage drafts, restore on mount, key-change adoption, cleared only after content durably landed. |
-| `@ai-matrx/kit/confirm` | `confirm`, `ConfirmDialogHost`, `ConfirmDialog` | The `window.confirm` replacement, both shapes: mount `<ConfirmDialogHost/>` once at app root, then `await confirm({ title, variant: "destructive" })` from anywhere (pre-mount calls queue; concurrent calls present one at a time) — or the declarative `<ConfirmDialog/>` when in-dialog busy state matters. Bundles `@radix-ui/react-alert-dialog`; Tailwind semantic-token styling, overridable via `className`/`contentClassName`. |
+| `@ai-matrx/kit/confirm-opener` | `confirm`, `ConfirmOptions` | The `window.confirm` replacement's imperative half — pure TS, zero React, zero radix, no `"use client"`, so a Redux thunk, a util or a sync handler can import it at near-zero bundle cost. `await confirm({ title, description, variant: "destructive" })` resolves `true`/`false`; pre-mount calls queue and concurrent calls present one at a time; with no host mounted it stays pending forever rather than inventing a silent default. Needs `<ConfirmDialogHost />` from `@ai-matrx/design-system` mounted once — the two share one registry through a `globalThis` slot. |
 | `@ai-matrx/kit/toast` | `createMatrxToast` | The captured sonner wrapper as a factory: pass your sonner `toast` in, get a drop-in `toast` back whose `.error`/`.warning` also feed your injected error-capture sink, plus `toastErrorAlreadyCaptured` for notices whose failure was already captured upstream. No sonner import — and sonner is not declared as a dependency or peer at all. |
 | `@ai-matrx/kit/invalidation` | `registerInvalidationCallback`, `fireInvalidation` | Zero-import, name-keyed callback registry that breaks import edges into heavy chunk clusters: the heavy cluster registers at its own module init, the ubiquitous module fires by name. Unregistered names are a deliberate no-op; a throwing callback screams and never breaks the caller. Keep your key constants in ONE host module. |
 | `@ai-matrx/kit/delimiter-guard` | `guardMarkdownDelimiters` (+ `guardMathDelimiters`, `guardRunawayLinks`, `reportDelimiterViolations`) | Keeps one stray streamed delimiter from swallowing a whole section: a `$$` that would turn prose into a red KaTeX error span, or an unclosed `[` that would turn a section into one giant link, gets invisibly neutralized while real math and links keep rendering. Pure; report violations loudly via the optional injected capture sink. |

package/dist/confirm-opener.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/confirm-opener.ts","../src/confirm/opener.ts"],"sourcesContent":["/**\n * @ai-matrx/kit/confirm-opener — the imperative `confirm()` API alone.\n *\n * Same module the `./confirm` subpath exposes, WITHOUT the dialog body: zero\n * React runtime, zero radix, no \"use client\" banner — statically importable\n * from anywhere (hooks, utils, Redux thunks, sync code) at near-zero bundle\n * cost. Hosts that mount `ConfirmDialogHost` behind a lazy boundary (the\n * fragmentation-law pattern) import `confirm` from HERE so the hundreds of\n * imperative call sites never drag the dialog chunk into their static graph.\n *\n * State is shared with `./confirm` by construction: the opener's host/queue\n * live on the `Symbol.for(\"ai-matrx.kit.confirm-opener-state\")` globalThis\n * slot, so both entries observe the same registration.\n */\nexport {\n  confirm,\n  _registerHost,\n  _unregisterHost,\n  _resetConfirmOpenerState,\n  type ConfirmOptions,\n} from \"./confirm/opener\";\n","/**\n * @ai-matrx/kit/confirm — imperative opener.\n *\n * Pure-TS imperative API for the global confirm dialog. Zero React, zero\n * dialog markup — this module is statically importable from anywhere\n * (hooks, utils, Redux thunks, async handlers, sync code, anything).\n *\n * The host (`ConfirmDialogHost`) registers a controller on mount and\n * unregisters on unmount. Calls made before the host has hydrated queue\n * up and resolve as soon as the host is alive — so a destructive action\n * triggered in the first ~50ms after page load still gets a real\n * confirmation, never a silent default-yes/no. With no host ever mounted,\n * a `confirm()` promise stays pending forever (the original's behavior —\n * it never resolves to a silent default).\n *\n * One dialog at a time: concurrent calls queue and present sequentially.\n *\n * Ported verbatim from matrx-frontend\n * `components/dialogs/confirm/confirmDialogOpener.ts`, with ONE structural\n * inversion: the host/queue state lives on `globalThis` under a\n * `Symbol.for` slot instead of module-level variables. With the package\n * built `splitting: false` in dual ESM/CJS format, this module is\n * duplicated into the root bundle and the `./confirm` bundle, and CJS/ESM\n * each instantiate their own module graph — a module-level variable would\n * silently split the host registration from the callers (the same hazard\n * `@ai-matrx/tap-target` documents for its link registry). Behavior is\n * unchanged; never \"clean this up\" into a module local.\n */\n\nimport type { ReactNode } from \"react\";\n\nexport interface ConfirmOptions {\n  title: ReactNode;\n  description?: ReactNode | undefined;\n  confirmLabel?: string | undefined;\n  /** `null` hides the cancel button (acknowledge-only dialogs). */\n  cancelLabel?: string | null | undefined;\n  variant?: \"default\" | \"destructive\" | undefined;\n}\n\ntype Resolver = (confirmed: boolean) => void;\n\ninterface PendingRequest {\n  opts: ConfirmOptions;\n  resolve: Resolver;\n}\n\ninterface HostController {\n  show: (opts: ConfirmOptions, resolve: Resolver) => void;\n}\n\ninterface OpenerState {\n  host: HostController | null;\n  queue: PendingRequest[];\n}\n\nconst STATE_SLOT = Symbol.for(\"ai-matrx.kit.confirm-opener-state\");\n\nfunction getState(): OpenerState {\n  const holder = globalThis as Record<symbol, OpenerState | undefined>;\n  let state = holder[STATE_SLOT];\n  if (!state) {\n    state = { host: null, queue: [] };\n    holder[STATE_SLOT] = state;\n  }\n  return state;\n}\n\n/** @internal Called by `ConfirmDialogHost` on mount. */\nexport function _registerHost(controller: HostController): void {\n  const state = getState();\n  state.host = controller;\n  while (state.queue.length > 0) {\n    const next = state.queue.shift()!;\n    controller.show(next.opts, next.resolve);\n  }\n}\n\n/** @internal Called by `ConfirmDialogHost` on unmount. */\nexport function _unregisterHost(controller: HostController): void {\n  const state = getState();\n  if (state.host === controller) state.host = null;\n}\n\n/** @internal Test-only: drop any registered host and pending queue. */\nexport function _resetConfirmOpenerState(): void {\n  const state = getState();\n  state.host = null;\n  state.queue.length = 0;\n}\n\n/**\n * Imperative confirm. Returns a Promise that resolves `true` if the user\n * confirms, `false` if they cancel/dismiss. Replaces `window.confirm`.\n *\n * @example\n *   const ok = await confirm({\n *     title: \"Delete sandbox\",\n *     description: \"This cannot be undone.\",\n *     variant: \"destructive\",\n *     confirmLabel: \"Delete\",\n *   });\n *   if (!ok) return;\n */\nexport function confirm(opts: ConfirmOptions): Promise<boolean> {\n  return new Promise<boolean>((resolve) => {\n    const state = getState();\n    if (state.host) {\n      state.host.show(opts, resolve);\n    } else {\n      state.queue.push({ opts, resolve });\n    }\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACwDA,IAAM,aAAa,uBAAO,IAAI,mCAAmC;AAEjE,SAAS,WAAwB;AAC/B,QAAM,SAAS;AACf,MAAI,QAAQ,OAAO,UAAU;AAC7B,MAAI,CAAC,OAAO;AACV,YAAQ,EAAE,MAAM,MAAM,OAAO,CAAC,EAAE;AAChC,WAAO,UAAU,IAAI;AAAA,EACvB;AACA,SAAO;AACT;AAGO,SAAS,cAAc,YAAkC;AAC9D,QAAM,QAAQ,SAAS;AACvB,QAAM,OAAO;AACb,SAAO,MAAM,MAAM,SAAS,GAAG;AAC7B,UAAM,OAAO,MAAM,MAAM,MAAM;AAC/B,eAAW,KAAK,KAAK,MAAM,KAAK,OAAO;AAAA,EACzC;AACF;AAGO,SAAS,gBAAgB,YAAkC;AAChE,QAAM,QAAQ,SAAS;AACvB,MAAI,MAAM,SAAS,WAAY,OAAM,OAAO;AAC9C;AAGO,SAAS,2BAAiC;AAC/C,QAAM,QAAQ,SAAS;AACvB,QAAM,OAAO;AACb,QAAM,MAAM,SAAS;AACvB;AAeO,SAAS,QAAQ,MAAwC;AAC9D,SAAO,IAAI,QAAiB,CAAC,YAAY;AACvC,UAAM,QAAQ,SAAS;AACvB,QAAI,MAAM,MAAM;AACd,YAAM,KAAK,KAAK,MAAM,OAAO;AAAA,IAC/B,OAAO;AACL,YAAM,MAAM,KAAK,EAAE,MAAM,QAAQ,CAAC;AAAA,IACpC;AAAA,EACF,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../src/confirm-opener.ts","../src/confirm/opener.ts"],"sourcesContent":["/**\n * @ai-matrx/kit/confirm-opener — the imperative `confirm()` API alone.\n *\n * THE WHOLE CONFIRM SYSTEM THIS PACKAGE SHIPS (since 0.9.0, census row 19i).\n * The dialog BODY — `ConfirmDialog` and `ConfirmDialogHost` — lives in\n * `@ai-matrx/design-system`, which owns the AlertDialog, the shipped motion\n * layer and the `--matrx-overlay-scrim` token this surface needs and kit could\n * neither ship nor import (design-system depends on kit; importing back is a\n * cycle). kit re-exports none of it: one surface, one owner.\n *\n * What is here is the pure half: zero React runtime, zero radix, no\n * \"use client\" banner — statically importable from anywhere (hooks, utils,\n * Redux thunks, sync code) at near-zero bundle cost, which is what lets a host\n * keep hundreds of imperative call sites out of the dialog's chunk.\n *\n * Wiring, end to end:\n *   1. mount `<ConfirmDialogHost />` from `@ai-matrx/design-system` once, near\n *      the root of every provider tree;\n *   2. `await confirm({ ... })` from anywhere, importing from HERE.\n * The two find each other through the\n * `Symbol.for(\"ai-matrx.kit.confirm-opener-state\")` globalThis slot, so they\n * observe one registration across every module graph and both packages.\n */\nexport {\n  confirm,\n  _registerHost,\n  _unregisterHost,\n  _resetConfirmOpenerState,\n  type ConfirmOptions,\n} from \"./confirm/opener\";\n","/**\n * @ai-matrx/kit/confirm-opener — the imperative opener, and since 0.9.0 the\n * ONLY half of the confirm system this package ships.\n *\n * Pure-TS imperative API for the global confirm dialog. Zero React, zero\n * dialog markup — this module is statically importable from anywhere\n * (hooks, utils, Redux thunks, async handlers, sync code, anything).\n *\n * The host (`ConfirmDialogHost`, in `@ai-matrx/design-system`) registers a\n * controller on mount and\n * unregisters on unmount. Calls made before the host has hydrated queue\n * up and resolve as soon as the host is alive — so a destructive action\n * triggered in the first ~50ms after page load still gets a real\n * confirmation, never a silent default-yes/no. With no host ever mounted,\n * a `confirm()` promise stays pending forever (the original's behavior —\n * it never resolves to a silent default).\n *\n * One dialog at a time: concurrent calls queue and present sequentially.\n *\n * Ported verbatim from matrx-frontend\n * `components/dialogs/confirm/confirmDialogOpener.ts`, with ONE structural\n * inversion: the host/queue state lives on `globalThis` under a\n * `Symbol.for` slot instead of module-level variables. With the package\n * built `splitting: false` in dual ESM/CJS format, and the host now living in\n * a DIFFERENT PACKAGE, CJS/ESM each instantiate their own module graph — a module-level variable would\n * silently split the host registration from the callers (the same hazard\n * `@ai-matrx/tap-target` documents for its link registry). Behavior is\n * unchanged; never \"clean this up\" into a module local.\n */\n\nimport type { ReactNode } from \"react\";\n\nexport interface ConfirmOptions {\n  title: ReactNode;\n  description?: ReactNode | undefined;\n  confirmLabel?: string | undefined;\n  /** `null` hides the cancel button (acknowledge-only dialogs). */\n  cancelLabel?: string | null | undefined;\n  variant?: \"default\" | \"destructive\" | undefined;\n}\n\ntype Resolver = (confirmed: boolean) => void;\n\ninterface PendingRequest {\n  opts: ConfirmOptions;\n  resolve: Resolver;\n}\n\ninterface HostController {\n  show: (opts: ConfirmOptions, resolve: Resolver) => void;\n}\n\ninterface OpenerState {\n  host: HostController | null;\n  queue: PendingRequest[];\n}\n\nconst STATE_SLOT = Symbol.for(\"ai-matrx.kit.confirm-opener-state\");\n\nfunction getState(): OpenerState {\n  const holder = globalThis as Record<symbol, OpenerState | undefined>;\n  let state = holder[STATE_SLOT];\n  if (!state) {\n    state = { host: null, queue: [] };\n    holder[STATE_SLOT] = state;\n  }\n  return state;\n}\n\n/** @internal Called by `ConfirmDialogHost` on mount. */\nexport function _registerHost(controller: HostController): void {\n  const state = getState();\n  state.host = controller;\n  while (state.queue.length > 0) {\n    const next = state.queue.shift()!;\n    controller.show(next.opts, next.resolve);\n  }\n}\n\n/** @internal Called by `ConfirmDialogHost` on unmount. */\nexport function _unregisterHost(controller: HostController): void {\n  const state = getState();\n  if (state.host === controller) state.host = null;\n}\n\n/** @internal Test-only: drop any registered host and pending queue. */\nexport function _resetConfirmOpenerState(): void {\n  const state = getState();\n  state.host = null;\n  state.queue.length = 0;\n}\n\n/**\n * Imperative confirm. Returns a Promise that resolves `true` if the user\n * confirms, `false` if they cancel/dismiss. Replaces `window.confirm`.\n *\n * @example\n *   const ok = await confirm({\n *     title: \"Delete sandbox\",\n *     description: \"This cannot be undone.\",\n *     variant: \"destructive\",\n *     confirmLabel: \"Delete\",\n *   });\n *   if (!ok) return;\n */\nexport function confirm(opts: ConfirmOptions): Promise<boolean> {\n  return new Promise<boolean>((resolve) => {\n    const state = getState();\n    if (state.host) {\n      state.host.show(opts, resolve);\n    } else {\n      state.queue.push({ opts, resolve });\n    }\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACyDA,IAAM,aAAa,uBAAO,IAAI,mCAAmC;AAEjE,SAAS,WAAwB;AAC/B,QAAM,SAAS;AACf,MAAI,QAAQ,OAAO,UAAU;AAC7B,MAAI,CAAC,OAAO;AACV,YAAQ,EAAE,MAAM,MAAM,OAAO,CAAC,EAAE;AAChC,WAAO,UAAU,IAAI;AAAA,EACvB;AACA,SAAO;AACT;AAGO,SAAS,cAAc,YAAkC;AAC9D,QAAM,QAAQ,SAAS;AACvB,QAAM,OAAO;AACb,SAAO,MAAM,MAAM,SAAS,GAAG;AAC7B,UAAM,OAAO,MAAM,MAAM,MAAM;AAC/B,eAAW,KAAK,KAAK,MAAM,KAAK,OAAO;AAAA,EACzC;AACF;AAGO,SAAS,gBAAgB,YAAkC;AAChE,QAAM,QAAQ,SAAS;AACvB,MAAI,MAAM,SAAS,WAAY,OAAM,OAAO;AAC9C;AAGO,SAAS,2BAAiC;AAC/C,QAAM,QAAQ,SAAS;AACvB,QAAM,OAAO;AACb,QAAM,MAAM,SAAS;AACvB;AAeO,SAAS,QAAQ,MAAwC;AAC9D,SAAO,IAAI,QAAiB,CAAC,YAAY;AACvC,UAAM,QAAQ,SAAS;AACvB,QAAI,MAAM,MAAM;AACd,YAAM,KAAK,KAAK,MAAM,OAAO;AAAA,IAC/B,OAAO;AACL,YAAM,MAAM,KAAK,EAAE,MAAM,QAAQ,CAAC;AAAA,IACpC;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/confirm-opener.d.cts

@@ -1,13 +1,15 @@
 import { ReactNode } from 'react';
 
 /**
- * @ai-matrx/kit/confirm — imperative opener.
+ * @ai-matrx/kit/confirm-opener — the imperative opener, and since 0.9.0 the
+ * ONLY half of the confirm system this package ships.
  *
  * Pure-TS imperative API for the global confirm dialog. Zero React, zero
  * dialog markup — this module is statically importable from anywhere
  * (hooks, utils, Redux thunks, async handlers, sync code, anything).
  *
- * The host (`ConfirmDialogHost`) registers a controller on mount and
+ * The host (`ConfirmDialogHost`, in `@ai-matrx/design-system`) registers a
+ * controller on mount and
  * unregisters on unmount. Calls made before the host has hydrated queue
  * up and resolve as soon as the host is alive — so a destructive action
  * triggered in the first ~50ms after page load still gets a real
@@ -21,9 +23,8 @@ import { ReactNode } from 'react';
  * `components/dialogs/confirm/confirmDialogOpener.ts`, with ONE structural
  * inversion: the host/queue state lives on `globalThis` under a
  * `Symbol.for` slot instead of module-level variables. With the package
- * built `splitting: false` in dual ESM/CJS format, this module is
- * duplicated into the root bundle and the `./confirm` bundle, and CJS/ESM
- * each instantiate their own module graph — a module-level variable would
+ * built `splitting: false` in dual ESM/CJS format, and the host now living in
+ * a DIFFERENT PACKAGE, CJS/ESM each instantiate their own module graph — a module-level variable would
  * silently split the host registration from the callers (the same hazard
  * `@ai-matrx/tap-target` documents for its link registry). Behavior is
  * unchanged; never "clean this up" into a module local.

package/dist/confirm-opener.d.ts

@@ -1,13 +1,15 @@
 import { ReactNode } from 'react';
 
 /**
- * @ai-matrx/kit/confirm — imperative opener.
+ * @ai-matrx/kit/confirm-opener — the imperative opener, and since 0.9.0 the
+ * ONLY half of the confirm system this package ships.
  *
  * Pure-TS imperative API for the global confirm dialog. Zero React, zero
  * dialog markup — this module is statically importable from anywhere
  * (hooks, utils, Redux thunks, async handlers, sync code, anything).
  *
- * The host (`ConfirmDialogHost`) registers a controller on mount and
+ * The host (`ConfirmDialogHost`, in `@ai-matrx/design-system`) registers a
+ * controller on mount and
  * unregisters on unmount. Calls made before the host has hydrated queue
  * up and resolve as soon as the host is alive — so a destructive action
  * triggered in the first ~50ms after page load still gets a real
@@ -21,9 +23,8 @@ import { ReactNode } from 'react';
  * `components/dialogs/confirm/confirmDialogOpener.ts`, with ONE structural
  * inversion: the host/queue state lives on `globalThis` under a
  * `Symbol.for` slot instead of module-level variables. With the package
- * built `splitting: false` in dual ESM/CJS format, this module is
- * duplicated into the root bundle and the `./confirm` bundle, and CJS/ESM
- * each instantiate their own module graph — a module-level variable would
+ * built `splitting: false` in dual ESM/CJS format, and the host now living in
+ * a DIFFERENT PACKAGE, CJS/ESM each instantiate their own module graph — a module-level variable would
  * silently split the host registration from the callers (the same hazard
  * `@ai-matrx/tap-target` documents for its link registry). Behavior is
  * unchanged; never "clean this up" into a module local.

package/dist/confirm-opener.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/confirm/opener.ts"],"sourcesContent":["/**\n * @ai-matrx/kit/confirm — imperative opener.\n *\n * Pure-TS imperative API for the global confirm dialog. Zero React, zero\n * dialog markup — this module is statically importable from anywhere\n * (hooks, utils, Redux thunks, async handlers, sync code, anything).\n *\n * The host (`ConfirmDialogHost`) registers a controller on mount and\n * unregisters on unmount. Calls made before the host has hydrated queue\n * up and resolve as soon as the host is alive — so a destructive action\n * triggered in the first ~50ms after page load still gets a real\n * confirmation, never a silent default-yes/no. With no host ever mounted,\n * a `confirm()` promise stays pending forever (the original's behavior —\n * it never resolves to a silent default).\n *\n * One dialog at a time: concurrent calls queue and present sequentially.\n *\n * Ported verbatim from matrx-frontend\n * `components/dialogs/confirm/confirmDialogOpener.ts`, with ONE structural\n * inversion: the host/queue state lives on `globalThis` under a\n * `Symbol.for` slot instead of module-level variables. With the package\n * built `splitting: false` in dual ESM/CJS format, this module is\n * duplicated into the root bundle and the `./confirm` bundle, and CJS/ESM\n * each instantiate their own module graph — a module-level variable would\n * silently split the host registration from the callers (the same hazard\n * `@ai-matrx/tap-target` documents for its link registry). Behavior is\n * unchanged; never \"clean this up\" into a module local.\n */\n\nimport type { ReactNode } from \"react\";\n\nexport interface ConfirmOptions {\n  title: ReactNode;\n  description?: ReactNode | undefined;\n  confirmLabel?: string | undefined;\n  /** `null` hides the cancel button (acknowledge-only dialogs). */\n  cancelLabel?: string | null | undefined;\n  variant?: \"default\" | \"destructive\" | undefined;\n}\n\ntype Resolver = (confirmed: boolean) => void;\n\ninterface PendingRequest {\n  opts: ConfirmOptions;\n  resolve: Resolver;\n}\n\ninterface HostController {\n  show: (opts: ConfirmOptions, resolve: Resolver) => void;\n}\n\ninterface OpenerState {\n  host: HostController | null;\n  queue: PendingRequest[];\n}\n\nconst STATE_SLOT = Symbol.for(\"ai-matrx.kit.confirm-opener-state\");\n\nfunction getState(): OpenerState {\n  const holder = globalThis as Record<symbol, OpenerState | undefined>;\n  let state = holder[STATE_SLOT];\n  if (!state) {\n    state = { host: null, queue: [] };\n    holder[STATE_SLOT] = state;\n  }\n  return state;\n}\n\n/** @internal Called by `ConfirmDialogHost` on mount. */\nexport function _registerHost(controller: HostController): void {\n  const state = getState();\n  state.host = controller;\n  while (state.queue.length > 0) {\n    const next = state.queue.shift()!;\n    controller.show(next.opts, next.resolve);\n  }\n}\n\n/** @internal Called by `ConfirmDialogHost` on unmount. */\nexport function _unregisterHost(controller: HostController): void {\n  const state = getState();\n  if (state.host === controller) state.host = null;\n}\n\n/** @internal Test-only: drop any registered host and pending queue. */\nexport function _resetConfirmOpenerState(): void {\n  const state = getState();\n  state.host = null;\n  state.queue.length = 0;\n}\n\n/**\n * Imperative confirm. Returns a Promise that resolves `true` if the user\n * confirms, `false` if they cancel/dismiss. Replaces `window.confirm`.\n *\n * @example\n *   const ok = await confirm({\n *     title: \"Delete sandbox\",\n *     description: \"This cannot be undone.\",\n *     variant: \"destructive\",\n *     confirmLabel: \"Delete\",\n *   });\n *   if (!ok) return;\n */\nexport function confirm(opts: ConfirmOptions): Promise<boolean> {\n  return new Promise<boolean>((resolve) => {\n    const state = getState();\n    if (state.host) {\n      state.host.show(opts, resolve);\n    } else {\n      state.queue.push({ opts, resolve });\n    }\n  });\n}\n"],"mappings":";AAwDA,IAAM,aAAa,uBAAO,IAAI,mCAAmC;AAEjE,SAAS,WAAwB;AAC/B,QAAM,SAAS;AACf,MAAI,QAAQ,OAAO,UAAU;AAC7B,MAAI,CAAC,OAAO;AACV,YAAQ,EAAE,MAAM,MAAM,OAAO,CAAC,EAAE;AAChC,WAAO,UAAU,IAAI;AAAA,EACvB;AACA,SAAO;AACT;AAGO,SAAS,cAAc,YAAkC;AAC9D,QAAM,QAAQ,SAAS;AACvB,QAAM,OAAO;AACb,SAAO,MAAM,MAAM,SAAS,GAAG;AAC7B,UAAM,OAAO,MAAM,MAAM,MAAM;AAC/B,eAAW,KAAK,KAAK,MAAM,KAAK,OAAO;AAAA,EACzC;AACF;AAGO,SAAS,gBAAgB,YAAkC;AAChE,QAAM,QAAQ,SAAS;AACvB,MAAI,MAAM,SAAS,WAAY,OAAM,OAAO;AAC9C;AAGO,SAAS,2BAAiC;AAC/C,QAAM,QAAQ,SAAS;AACvB,QAAM,OAAO;AACb,QAAM,MAAM,SAAS;AACvB;AAeO,SAAS,QAAQ,MAAwC;AAC9D,SAAO,IAAI,QAAiB,CAAC,YAAY;AACvC,UAAM,QAAQ,SAAS;AACvB,QAAI,MAAM,MAAM;AACd,YAAM,KAAK,KAAK,MAAM,OAAO;AAAA,IAC/B,OAAO;AACL,YAAM,MAAM,KAAK,EAAE,MAAM,QAAQ,CAAC;AAAA,IACpC;AAAA,EACF,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../src/confirm/opener.ts"],"sourcesContent":["/**\n * @ai-matrx/kit/confirm-opener — the imperative opener, and since 0.9.0 the\n * ONLY half of the confirm system this package ships.\n *\n * Pure-TS imperative API for the global confirm dialog. Zero React, zero\n * dialog markup — this module is statically importable from anywhere\n * (hooks, utils, Redux thunks, async handlers, sync code, anything).\n *\n * The host (`ConfirmDialogHost`, in `@ai-matrx/design-system`) registers a\n * controller on mount and\n * unregisters on unmount. Calls made before the host has hydrated queue\n * up and resolve as soon as the host is alive — so a destructive action\n * triggered in the first ~50ms after page load still gets a real\n * confirmation, never a silent default-yes/no. With no host ever mounted,\n * a `confirm()` promise stays pending forever (the original's behavior —\n * it never resolves to a silent default).\n *\n * One dialog at a time: concurrent calls queue and present sequentially.\n *\n * Ported verbatim from matrx-frontend\n * `components/dialogs/confirm/confirmDialogOpener.ts`, with ONE structural\n * inversion: the host/queue state lives on `globalThis` under a\n * `Symbol.for` slot instead of module-level variables. With the package\n * built `splitting: false` in dual ESM/CJS format, and the host now living in\n * a DIFFERENT PACKAGE, CJS/ESM each instantiate their own module graph — a module-level variable would\n * silently split the host registration from the callers (the same hazard\n * `@ai-matrx/tap-target` documents for its link registry). Behavior is\n * unchanged; never \"clean this up\" into a module local.\n */\n\nimport type { ReactNode } from \"react\";\n\nexport interface ConfirmOptions {\n  title: ReactNode;\n  description?: ReactNode | undefined;\n  confirmLabel?: string | undefined;\n  /** `null` hides the cancel button (acknowledge-only dialogs). */\n  cancelLabel?: string | null | undefined;\n  variant?: \"default\" | \"destructive\" | undefined;\n}\n\ntype Resolver = (confirmed: boolean) => void;\n\ninterface PendingRequest {\n  opts: ConfirmOptions;\n  resolve: Resolver;\n}\n\ninterface HostController {\n  show: (opts: ConfirmOptions, resolve: Resolver) => void;\n}\n\ninterface OpenerState {\n  host: HostController | null;\n  queue: PendingRequest[];\n}\n\nconst STATE_SLOT = Symbol.for(\"ai-matrx.kit.confirm-opener-state\");\n\nfunction getState(): OpenerState {\n  const holder = globalThis as Record<symbol, OpenerState | undefined>;\n  let state = holder[STATE_SLOT];\n  if (!state) {\n    state = { host: null, queue: [] };\n    holder[STATE_SLOT] = state;\n  }\n  return state;\n}\n\n/** @internal Called by `ConfirmDialogHost` on mount. */\nexport function _registerHost(controller: HostController): void {\n  const state = getState();\n  state.host = controller;\n  while (state.queue.length > 0) {\n    const next = state.queue.shift()!;\n    controller.show(next.opts, next.resolve);\n  }\n}\n\n/** @internal Called by `ConfirmDialogHost` on unmount. */\nexport function _unregisterHost(controller: HostController): void {\n  const state = getState();\n  if (state.host === controller) state.host = null;\n}\n\n/** @internal Test-only: drop any registered host and pending queue. */\nexport function _resetConfirmOpenerState(): void {\n  const state = getState();\n  state.host = null;\n  state.queue.length = 0;\n}\n\n/**\n * Imperative confirm. Returns a Promise that resolves `true` if the user\n * confirms, `false` if they cancel/dismiss. Replaces `window.confirm`.\n *\n * @example\n *   const ok = await confirm({\n *     title: \"Delete sandbox\",\n *     description: \"This cannot be undone.\",\n *     variant: \"destructive\",\n *     confirmLabel: \"Delete\",\n *   });\n *   if (!ok) return;\n */\nexport function confirm(opts: ConfirmOptions): Promise<boolean> {\n  return new Promise<boolean>((resolve) => {\n    const state = getState();\n    if (state.host) {\n      state.host.show(opts, resolve);\n    } else {\n      state.queue.push({ opts, resolve });\n    }\n  });\n}\n"],"mappings":";AAyDA,IAAM,aAAa,uBAAO,IAAI,mCAAmC;AAEjE,SAAS,WAAwB;AAC/B,QAAM,SAAS;AACf,MAAI,QAAQ,OAAO,UAAU;AAC7B,MAAI,CAAC,OAAO;AACV,YAAQ,EAAE,MAAM,MAAM,OAAO,CAAC,EAAE;AAChC,WAAO,UAAU,IAAI;AAAA,EACvB;AACA,SAAO;AACT;AAGO,SAAS,cAAc,YAAkC;AAC9D,QAAM,QAAQ,SAAS;AACvB,QAAM,OAAO;AACb,SAAO,MAAM,MAAM,SAAS,GAAG;AAC7B,UAAM,OAAO,MAAM,MAAM,MAAM;AAC/B,eAAW,KAAK,KAAK,MAAM,KAAK,OAAO;AAAA,EACzC;AACF;AAGO,SAAS,gBAAgB,YAAkC;AAChE,QAAM,QAAQ,SAAS;AACvB,MAAI,MAAM,SAAS,WAAY,OAAM,OAAO;AAC9C;AAGO,SAAS,2BAAiC;AAC/C,QAAM,QAAQ,SAAS;AACvB,QAAM,OAAO;AACb,QAAM,MAAM,SAAS;AACvB;AAeO,SAAS,QAAQ,MAAwC;AAC9D,SAAO,IAAI,QAAiB,CAAC,YAAY;AACvC,UAAM,QAAQ,SAAS;AACvB,QAAI,MAAM,MAAM;AACd,YAAM,KAAK,KAAK,MAAM,OAAO;AAAA,IAC/B,OAAO;AACL,YAAM,MAAM,KAAK,EAAE,MAAM,QAAQ,CAAC;AAAA,IACpC;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/format.cjs

@@ -0,0 +1,210 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/format.ts
+var format_exports = {};
+__export(format_exports, {
+  avatarPaletteIndex: () => avatarPaletteIndex,
+  durationMsBetween: () => durationMsBetween,
+  formatAbsoluteDate: () => formatAbsoluteDate,
+  formatDurationMinutes: () => formatDurationMinutes,
+  formatDurationMs: () => formatDurationMs,
+  formatDurationSeconds: () => formatDurationSeconds,
+  formatFileSize: () => formatFileSize,
+  formatRelativeTime: () => formatRelativeTime,
+  getInitials: () => getInitials,
+  parseTimestamp: () => parseTimestamp
+});
+module.exports = __toCommonJS(format_exports);
+function hasTimezoneDesignator(value) {
+  if (/[zZ]$/.test(value)) return true;
+  if (/[+-]\d{2}(:?\d{2})?$/.test(value)) return true;
+  if (/\b(GMT|UTC)\b/i.test(value)) return true;
+  return false;
+}
+function normalizeTimestampString(raw) {
+  const value = raw.trim();
+  if (!value) return value;
+  if (!/\d{1,2}:\d{2}/.test(value)) return value;
+  if (hasTimezoneDesignator(value)) return value;
+  return `${value.replace(" ", "T")}Z`;
+}
+function parseTimestamp(value) {
+  if (value === null || value === void 0) return null;
+  if (value instanceof Date) {
+    return Number.isNaN(value.getTime()) ? null : value;
+  }
+  if (typeof value === "number") {
+    const fromNumber = new Date(value);
+    return Number.isNaN(fromNumber.getTime()) ? null : fromNumber;
+  }
+  if (typeof value !== "string") return null;
+  const normalized = normalizeTimestampString(value);
+  if (!normalized) return null;
+  const parsed = new Date(normalized);
+  return Number.isNaN(parsed.getTime()) ? null : parsed;
+}
+var DEFAULT_ABSOLUTE_OPTIONS = {
+  year: "numeric",
+  month: "short",
+  day: "numeric",
+  hour: "numeric",
+  minute: "2-digit"
+};
+function formatAbsoluteDate(value, options = DEFAULT_ABSOLUTE_OPTIONS, fallback = "\u2014") {
+  const parsed = parseTimestamp(value);
+  if (!parsed) return fallback;
+  return parsed.toLocaleString(void 0, options);
+}
+var RELATIVE_UNITS = [
+  { limit: 6e4, divisor: 1e3, short: "s", long: "second" },
+  { limit: 36e5, divisor: 6e4, short: "m", long: "minute" },
+  { limit: 864e5, divisor: 36e5, short: "h", long: "hour" },
+  { limit: 6048e5, divisor: 864e5, short: "d", long: "day" },
+  { limit: 2592e6, divisor: 6048e5, short: "w", long: "week" },
+  { limit: 31536e6, divisor: 2592e6, short: "mo", long: "month" }
+];
+var INTL_UNITS = [
+  { unit: "year", ms: 365 * 24 * 60 * 60 * 1e3 },
+  { unit: "month", ms: 30 * 24 * 60 * 60 * 1e3 },
+  { unit: "week", ms: 7 * 24 * 60 * 60 * 1e3 },
+  { unit: "day", ms: 24 * 60 * 60 * 1e3 },
+  { unit: "hour", ms: 60 * 60 * 1e3 },
+  { unit: "minute", ms: 60 * 1e3 }
+];
+function formatRelativeTime(value, options = {}) {
+  const style = options.style ?? "short";
+  const now = options.now ?? Date.now();
+  const parsed = parseTimestamp(value);
+  if (!parsed) {
+    if (options.fallbackToInput === true && typeof value === "string") return value;
+    return options.fallback ?? "\u2014";
+  }
+  if (style === "intl") {
+    const delta = parsed.getTime() - now;
+    const magnitude = Math.abs(delta);
+    if (magnitude < 6e4) return "just now";
+    const rtf = new Intl.RelativeTimeFormat(void 0, { numeric: "auto" });
+    for (const { unit, ms } of INTL_UNITS) {
+      if (magnitude >= ms) return rtf.format(Math.trunc(delta / ms), unit);
+    }
+    return "just now";
+  }
+  const elapsed = now - parsed.getTime();
+  if (elapsed < 0) return "just now";
+  for (const unit of RELATIVE_UNITS) {
+    if (elapsed < unit.limit) {
+      const count = Math.max(1, Math.floor(elapsed / unit.divisor));
+      return style === "long" ? `${count} ${unit.long}${count === 1 ? "" : "s"} ago` : `${count}${unit.short} ago`;
+    }
+  }
+  return formatAbsoluteDate(parsed);
+}
+var pad2 = (value) => value.toString().padStart(2, "0");
+function clockBody(totalSeconds) {
+  const seconds = totalSeconds % 60;
+  const minutes = Math.floor(totalSeconds / 60) % 60;
+  const hours = Math.floor(totalSeconds / 3600);
+  return hours > 0 ? `${hours}:${pad2(minutes)}:${pad2(seconds)}` : `${minutes}:${pad2(seconds)}`;
+}
+function compactBody(ms) {
+  if (ms < 1e3) return `${Math.round(ms)}ms`;
+  const totalSeconds = ms / 1e3;
+  if (totalSeconds < 60) {
+    return totalSeconds < 10 ? `${totalSeconds.toFixed(1)}s` : `${Math.round(totalSeconds)}s`;
+  }
+  const whole = Math.round(totalSeconds);
+  const minutes = Math.floor(whole / 60);
+  if (minutes < 60) return `${minutes}m ${pad2(whole % 60)}s`;
+  const hours = Math.floor(minutes / 60);
+  return `${hours}h ${pad2(minutes % 60)}m`;
+}
+function coarseBody(ms) {
+  const minutes = Math.round(ms / 6e4);
+  if (minutes < 1) return "< 1 min";
+  if (minutes < 60) return `${minutes} min`;
+  const hours = Math.floor(minutes / 60);
+  const rest = minutes % 60;
+  return rest > 0 ? `${hours}h ${rest}m` : `${hours}h`;
+}
+function formatDurationMs(ms, options = {}) {
+  const style = options.style ?? "clock";
+  const fallback = options.fallback ?? (style === "clock" ? "0:00" : "\u2014");
+  if (ms === null || ms === void 0 || !Number.isFinite(ms)) return fallback;
+  const negative = ms < 0;
+  if (negative && options.signed !== true) {
+    return style === "clock" ? clockBody(0) : fallback;
+  }
+  const magnitude = Math.abs(ms);
+  const body = style === "clock" ? clockBody(Math.floor(magnitude / 1e3)) : style === "compact" ? compactBody(magnitude) : coarseBody(magnitude);
+  return negative ? `-${body}` : body;
+}
+function formatDurationSeconds(seconds, options = {}) {
+  if (seconds === null || seconds === void 0 || !Number.isFinite(seconds)) {
+    return formatDurationMs(seconds, options);
+  }
+  return formatDurationMs(seconds * 1e3, options);
+}
+function formatDurationMinutes(minutes, options = {}) {
+  if (minutes === null || minutes === void 0 || !Number.isFinite(minutes)) {
+    return formatDurationMs(minutes, options);
+  }
+  return formatDurationMs(minutes * 6e4, options);
+}
+function durationMsBetween(from, to, now = Date.now()) {
+  const start = parseTimestamp(from);
+  if (!start) return null;
+  if (to === null || to === void 0) return Math.max(0, now - start.getTime());
+  const end = parseTimestamp(to);
+  if (!end) return null;
+  return Math.max(0, end.getTime() - start.getTime());
+}
+var SIZE_UNITS = ["B", "KB", "MB", "GB", "TB", "PB"];
+function formatFileSize(bytes, options = {}) {
+  const fallback = options.fallback ?? "\u2014";
+  if (bytes === null || bytes === void 0 || !Number.isFinite(bytes) || bytes < 0) {
+    return fallback;
+  }
+  if (bytes < 1024) return `${Math.round(bytes)} B`;
+  let value = bytes;
+  let unit = 0;
+  while (value >= 1024 && unit < SIZE_UNITS.length - 1) {
+    value /= 1024;
+    unit += 1;
+  }
+  const rendered = value >= 10 ? String(Math.round(value)) : value.toFixed(1);
+  return `${rendered} ${SIZE_UNITS[unit]}`;
+}
+function getInitials(value, options = {}) {
+  const fallback = options.fallback ?? "?";
+  if (typeof value !== "string") return fallback;
+  const parts = value.trim().split(/\s+/).filter((part) => part.length > 0);
+  if (parts.length === 0) return fallback;
+  const first = parts[0]?.charAt(0) ?? "";
+  const last = parts.length > 1 ? parts[parts.length - 1]?.charAt(0) ?? "" : "";
+  return `${first}${last}`.toUpperCase() || fallback;
+}
+function avatarPaletteIndex(seed, buckets = 8) {
+  let hash = 0;
+  for (let index = 0; index < seed.length; index += 1) {
+    hash = hash * 31 + seed.charCodeAt(index) | 0;
+  }
+  return Math.abs(hash) % buckets;
+}
+//# sourceMappingURL=format.cjs.map

package/dist/format.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/format.ts"],"sourcesContent":["/**\n * @ai-matrx/kit/format — THE one home for the tiny display formatters that\n * every Matrx surface, in every repo, needs and that nothing owns.\n *\n * WHY THIS FILE EXISTS (the H1 finding, 2026-09-07 duplication census). These\n * formatters were duplicated *between packages*: `@ai-matrx/meet` and\n * `@ai-matrx/messaging` each defined `formatDuration` + `getInitials`,\n * `@ai-matrx/associations` and `@ai-matrx/diff` each defined\n * `formatRelativeTime`, and `@ai-matrx/media` hid `formatFileSize` inside a\n * React upload component. Because the fleet's packages disagreed about who\n * owned them, ~65 host twins across matrx-frontend / matrx-extend /\n * matrx-local / matrx-games / aidream's two apps had *no correct package to\n * point at* — a settings page cannot take a dependency on the video-calling\n * package to print a duration.\n *\n * WHY KIT. `@ai-matrx/kit` has ZERO sibling dependencies (verified with\n * `node scripts/check_ts_sibling_graph.mjs --order`), so it sits at the very\n * bottom of the sibling DAG: meet, messaging, associations, diff, media and\n * print can all depend on it without creating a cycle, and so can every host.\n * It is also, by charter, the \"little primitives every Matrx app speaks\"\n * package. This is not a new package — new packages need Arman's approval.\n *\n * THE UNIT LAW. A duration formatter that takes a bare `number` is a bug\n * waiting to happen: the fleet's twins variously took milliseconds, seconds\n * and minutes, and two of them were wrong by 1000×-worth of confusion. There\n * is deliberately NO `formatDuration` here. The unit is in the name:\n * `formatDurationMs`, `formatDurationSeconds`, `formatDurationMinutes`.\n *\n * Everything in this module is pure, synchronous, and free of React, DOM and\n * `Intl` implicit-locale surprises except where a style explicitly asks for\n * `Intl.RelativeTimeFormat`. Every time-dependent function takes an explicit\n * `now` so tests never depend on the clock.\n */\n\n// ───────────────────────── timestamps ─────────────────────────\n\nexport type TimestampInput = string | number | Date | null | undefined;\n\n/** True when a string already carries a timezone designator (Z or ±offset). */\nfunction hasTimezoneDesignator(value: string): boolean {\n  if (/[zZ]$/.test(value)) return true;\n  if (/[+-]\\d{2}(:?\\d{2})?$/.test(value)) return true;\n  if (/\\b(GMT|UTC)\\b/i.test(value)) return true;\n  return false;\n}\n\n/**\n * Normalise a raw timestamp string so `new Date()` parses it as an absolute\n * instant.\n *\n * THE CORRECTION THIS CARRIES (from `@ai-matrx/diff`, the richest of the\n * twins). Postgres serialises `timestamp with time zone` as\n * \"2026-06-13T16:32:26+00:00\" (parses correctly) and `timestamp without time\n * zone` as \"2026-06-13T16:32:26\" — which, per the ES spec, `new Date()` parses\n * as LOCAL time. Our backend writes those columns in UTC, so a bare\n * `new Date(...)` is wrong by the viewer's offset: the classic \"times are off\n * by N hours\" report. A zone-less string that HAS a time component is treated\n * as UTC; date-only strings are left untouched (a calendar day is not a\n * timestamp).\n */\nfunction normalizeTimestampString(raw: string): string {\n  const value = raw.trim();\n  if (!value) return value;\n  if (!/\\d{1,2}:\\d{2}/.test(value)) return value;\n  if (hasTimezoneDesignator(value)) return value;\n  return `${value.replace(\" \", \"T\")}Z`;\n}\n\n/** Parse any backend timestamp into a Date, or `null` when unparseable. */\nexport function parseTimestamp(value: TimestampInput): Date | null {\n  if (value === null || value === undefined) return null;\n  if (value instanceof Date) {\n    return Number.isNaN(value.getTime()) ? null : value;\n  }\n  if (typeof value === \"number\") {\n    const fromNumber = new Date(value);\n    return Number.isNaN(fromNumber.getTime()) ? null : fromNumber;\n  }\n  if (typeof value !== \"string\") return null;\n  const normalized = normalizeTimestampString(value);\n  if (!normalized) return null;\n  const parsed = new Date(normalized);\n  return Number.isNaN(parsed.getTime()) ? null : parsed;\n}\n\nconst DEFAULT_ABSOLUTE_OPTIONS: Intl.DateTimeFormatOptions = {\n  year: \"numeric\",\n  month: \"short\",\n  day: \"numeric\",\n  hour: \"numeric\",\n  minute: \"2-digit\",\n};\n\n/** Absolute local date+time, e.g. \"Jun 13, 2026, 9:32 AM\". */\nexport function formatAbsoluteDate(\n  value: TimestampInput,\n  options: Intl.DateTimeFormatOptions = DEFAULT_ABSOLUTE_OPTIONS,\n  fallback = \"—\",\n): string {\n  const parsed = parseTimestamp(value);\n  if (!parsed) return fallback;\n  return parsed.toLocaleString(undefined, options);\n}\n\n// ───────────────────────── relative time ─────────────────────────\n\nconst RELATIVE_UNITS: readonly {\n  limit: number;\n  divisor: number;\n  short: string;\n  long: string;\n}[] = [\n  { limit: 60_000, divisor: 1000, short: \"s\", long: \"second\" },\n  { limit: 3_600_000, divisor: 60_000, short: \"m\", long: \"minute\" },\n  { limit: 86_400_000, divisor: 3_600_000, short: \"h\", long: \"hour\" },\n  { limit: 604_800_000, divisor: 86_400_000, short: \"d\", long: \"day\" },\n  { limit: 2_592_000_000, divisor: 604_800_000, short: \"w\", long: \"week\" },\n  { limit: 31_536_000_000, divisor: 2_592_000_000, short: \"mo\", long: \"month\" },\n];\n\nconst INTL_UNITS: readonly { unit: Intl.RelativeTimeFormatUnit; ms: number }[] = [\n  { unit: \"year\", ms: 365 * 24 * 60 * 60 * 1000 },\n  { unit: \"month\", ms: 30 * 24 * 60 * 60 * 1000 },\n  { unit: \"week\", ms: 7 * 24 * 60 * 60 * 1000 },\n  { unit: \"day\", ms: 24 * 60 * 60 * 1000 },\n  { unit: \"hour\", ms: 60 * 60 * 1000 },\n  { unit: \"minute\", ms: 60 * 1000 },\n];\n\n/**\n * The three relative-time voices the fleet actually speaks. They are display\n * decisions, not implementations — one body serves all three.\n *\n * - `\"short\"` — \"2m ago\", \"3d ago\". The dense default (from `@ai-matrx/diff`).\n * - `\"long\"`  — \"2 minutes ago\", \"3 days ago\".\n * - `\"intl\"`  — `Intl.RelativeTimeFormat` with `numeric: \"auto\"`, so the\n *   viewer's locale conventions apply and \"yesterday\" reads as \"yesterday\"\n *   (from `@ai-matrx/associations`). Sub-minute reads \"just now\".\n */\nexport type RelativeTimeStyle = \"short\" | \"long\" | \"intl\";\n\nexport interface RelativeTimeOptions {\n  /** Default `\"short\"`. */\n  style?: RelativeTimeStyle | undefined;\n  /** Injected clock. Default `Date.now()` — pass it in tests. */\n  now?: number | undefined;\n  /** Returned for null / unparseable input. Default `\"—\"`. */\n  fallback?: string | undefined;\n  /**\n   * Echo the raw input instead of `fallback` when it cannot be parsed —\n   * degraded, never broken. What the comments face wants: an odd server string\n   * is more useful on screen than an em-dash that hides it.\n   */\n  fallbackToInput?: boolean | undefined;\n}\n\n/**\n * \"2m ago\" / \"2 minutes ago\" / a locale-aware \"2 minutes ago\", falling back to\n * an absolute local date past a year. Timezone-agnostic by construction (a\n * pure epoch difference over `parseTimestamp`'s corrected instant).\n *\n * Future timestamps read \"just now\" in `\"short\"`/`\"long\"` (a clock skew of a\n * few seconds must not print \"in 3 seconds\"); `\"intl\"` formats them properly\n * (\"in 5 minutes\") because that is the whole point of asking for `Intl`.\n */\nexport function formatRelativeTime(\n  value: TimestampInput,\n  options: RelativeTimeOptions = {},\n): string {\n  const style = options.style ?? \"short\";\n  const now = options.now ?? Date.now();\n  const parsed = parseTimestamp(value);\n  if (!parsed) {\n    if (options.fallbackToInput === true && typeof value === \"string\") return value;\n    return options.fallback ?? \"—\";\n  }\n\n  if (style === \"intl\") {\n    const delta = parsed.getTime() - now;\n    const magnitude = Math.abs(delta);\n    if (magnitude < 60_000) return \"just now\";\n    const rtf = new Intl.RelativeTimeFormat(undefined, { numeric: \"auto\" });\n    for (const { unit, ms } of INTL_UNITS) {\n      if (magnitude >= ms) return rtf.format(Math.trunc(delta / ms), unit);\n    }\n    return \"just now\";\n  }\n\n  const elapsed = now - parsed.getTime();\n  if (elapsed < 0) return \"just now\";\n  for (const unit of RELATIVE_UNITS) {\n    if (elapsed < unit.limit) {\n      const count = Math.max(1, Math.floor(elapsed / unit.divisor));\n      return style === \"long\"\n        ? `${count} ${unit.long}${count === 1 ? \"\" : \"s\"} ago`\n        : `${count}${unit.short} ago`;\n    }\n  }\n  return formatAbsoluteDate(parsed);\n}\n\n// ───────────────────────── durations ─────────────────────────\n\n/**\n * The three duration voices the fleet actually speaks. Picked once here so a\n * call duration reads the same in the meeting, the history list and the\n * notification.\n *\n * - `\"clock\"` (default) — `0:00`, `9:04`, `1:02:33`. For anything a human\n *   watches tick: recordings, calls, media players, timers.\n * - `\"compact\"` — `250ms`, `5.2s`, `5m 30s`, `1h 02m`. For elapsed work:\n *   job runs, request timings, step durations. Sub-second is honest about\n *   being sub-second rather than collapsing to `0:00`.\n * - `\"coarse\"` — `45 min`, `1h 30m`. For things measured in minutes and read\n *   at a glance: podcast episodes, lesson lengths, estimates. Never prints\n *   seconds.\n */\nexport type DurationStyle = \"clock\" | \"compact\" | \"coarse\";\n\nexport interface DurationOptions {\n  /** Default `\"clock\"`. */\n  style?: DurationStyle | undefined;\n  /**\n   * Returned for `null` / `undefined` / non-finite input. Default `\"0:00\"` for\n   * `\"clock\"` and `\"—\"` for `\"compact\"` / `\"coarse\"`.\n   */\n  fallback?: string | undefined;\n  /**\n   * Keep the sign on a negative duration (`-1:23`) instead of clamping to\n   * zero. Default `false` — a negative elapsed time is nearly always a clock\n   * bug, and `0:00` is the honest reading. Opt in where a signed offset is the\n   * actual quantity (a field format for a stored `interval`, say).\n   */\n  signed?: boolean | undefined;\n}\n\nconst pad2 = (value: number): string => value.toString().padStart(2, \"0\");\n\nfunction clockBody(totalSeconds: number): string {\n  const seconds = totalSeconds % 60;\n  const minutes = Math.floor(totalSeconds / 60) % 60;\n  const hours = Math.floor(totalSeconds / 3600);\n  return hours > 0\n    ? `${hours}:${pad2(minutes)}:${pad2(seconds)}`\n    : `${minutes}:${pad2(seconds)}`;\n}\n\nfunction compactBody(ms: number): string {\n  if (ms < 1000) return `${Math.round(ms)}ms`;\n  const totalSeconds = ms / 1000;\n  if (totalSeconds < 60) {\n    // One decimal under 10s (0.1s is a visible difference at that scale),\n    // whole seconds above it (nobody reads \"43.7s\" as more precise than \"44s\").\n    return totalSeconds < 10\n      ? `${totalSeconds.toFixed(1)}s`\n      : `${Math.round(totalSeconds)}s`;\n  }\n  const whole = Math.round(totalSeconds);\n  const minutes = Math.floor(whole / 60);\n  if (minutes < 60) return `${minutes}m ${pad2(whole % 60)}s`;\n  const hours = Math.floor(minutes / 60);\n  return `${hours}h ${pad2(minutes % 60)}m`;\n}\n\nfunction coarseBody(ms: number): string {\n  const minutes = Math.round(ms / 60_000);\n  if (minutes < 1) return \"< 1 min\";\n  if (minutes < 60) return `${minutes} min`;\n  const hours = Math.floor(minutes / 60);\n  const rest = minutes % 60;\n  return rest > 0 ? `${hours}h ${rest}m` : `${hours}h`;\n}\n\n/**\n * THE canonical duration formatter. Milliseconds in, a chosen voice out.\n *\n * `null`, `undefined`, `NaN` and `Infinity` all take the fallback — never\n * `NaN:NaN`, which is what a null start time produces, and never a confident\n * `0:00` for \"we do not know\".\n */\nexport function formatDurationMs(\n  ms: number | null | undefined,\n  options: DurationOptions = {},\n): string {\n  const style = options.style ?? \"clock\";\n  const fallback = options.fallback ?? (style === \"clock\" ? \"0:00\" : \"—\");\n  if (ms === null || ms === undefined || !Number.isFinite(ms)) return fallback;\n\n  const negative = ms < 0;\n  if (negative && options.signed !== true) {\n    return style === \"clock\" ? clockBody(0) : fallback;\n  }\n  const magnitude = Math.abs(ms);\n  const body =\n    style === \"clock\"\n      ? clockBody(Math.floor(magnitude / 1000))\n      : style === \"compact\"\n        ? compactBody(magnitude)\n        : coarseBody(magnitude);\n  return negative ? `-${body}` : body;\n}\n\n/** Seconds in. See {@link formatDurationMs}. */\nexport function formatDurationSeconds(\n  seconds: number | null | undefined,\n  options: DurationOptions = {},\n): string {\n  if (seconds === null || seconds === undefined || !Number.isFinite(seconds)) {\n    return formatDurationMs(seconds as number | null | undefined, options);\n  }\n  return formatDurationMs(seconds * 1000, options);\n}\n\n/** Minutes in. See {@link formatDurationMs}. */\nexport function formatDurationMinutes(\n  minutes: number | null | undefined,\n  options: DurationOptions = {},\n): string {\n  if (minutes === null || minutes === undefined || !Number.isFinite(minutes)) {\n    return formatDurationMs(minutes as number | null | undefined, options);\n  }\n  return formatDurationMs(minutes * 60_000, options);\n}\n\n/**\n * Duration between two timestamps, in milliseconds — `null` when the start is\n * missing or either end is unparseable. An absent `to` means \"still running\",\n * so it measures to `now`. Pair with {@link formatDurationMs}.\n */\nexport function durationMsBetween(\n  from: TimestampInput,\n  to: TimestampInput,\n  now: number = Date.now(),\n): number | null {\n  const start = parseTimestamp(from);\n  if (!start) return null;\n  if (to === null || to === undefined) return Math.max(0, now - start.getTime());\n  const end = parseTimestamp(to);\n  if (!end) return null;\n  return Math.max(0, end.getTime() - start.getTime());\n}\n\n// ───────────────────────── byte sizes ─────────────────────────\n\nconst SIZE_UNITS = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\"] as const;\n\nexport interface FileSizeOptions {\n  /** Returned for `null` / `undefined` / non-finite / negative. Default `\"—\"`. */\n  fallback?: string | undefined;\n}\n\n/**\n * `512` → `\"512 B\"`, `2048` → `\"2.0 KB\"`, `15360` → `\"15 KB\"`.\n *\n * THE DISPLAY DECISIONS, made once (unified 2026-09-07 from six host twins and\n * `@ai-matrx/media`'s copy, which was the richest):\n *\n * 1. Binary units (1024), labelled with the short SI-ish names the whole fleet\n *    already used — `B`/`KB`/`MB`/`GB`/`TB`, never `\"Bytes\"`.\n * 2. One decimal below 10 in a unit (`2.0 KB`, `9.9 MB`), whole numbers at or\n *    above it (`15 KB`, `340 MB`) — three significant figures is the most a\n *    file size is ever worth, and `1.5 GB` versus `1536.0 MB` is the whole\n *    point of the unit.\n * 3. Whole bytes below 1 KB — `\"512 B\"`, never `\"512.0 B\"`.\n * 4. `null` / `undefined` / `NaN` / `Infinity` / negative all collapse to an\n *    em-dash, NOT to `\"0 B\"`. A corrupt or mid-upload `size` row rendering as\n *    a confident, wrong `\"0 B\"` is a screen telling a lie; \"size unknown\" is\n *    the honest reading. (`0` itself is a real size and prints `\"0 B\"`.)\n */\nexport function formatFileSize(\n  bytes: number | null | undefined,\n  options: FileSizeOptions = {},\n): string {\n  const fallback = options.fallback ?? \"—\";\n  if (bytes === null || bytes === undefined || !Number.isFinite(bytes) || bytes < 0) {\n    return fallback;\n  }\n  if (bytes < 1024) return `${Math.round(bytes)} B`;\n  let value = bytes;\n  let unit = 0;\n  while (value >= 1024 && unit < SIZE_UNITS.length - 1) {\n    value /= 1024;\n    unit += 1;\n  }\n  const rendered = value >= 10 ? String(Math.round(value)) : value.toFixed(1);\n  return `${rendered} ${SIZE_UNITS[unit]}`;\n}\n\n// ───────────────────────── people ─────────────────────────\n\nexport interface InitialsOptions {\n  /** Returned when nothing usable is left. Default `\"?\"`. */\n  fallback?: string | undefined;\n}\n\n/**\n * `\"Ana Rivera\"` → `\"AR\"`, `\"Ana\"` → `\"A\"`, `\"Ana Maria Rivera\"` → `\"AR\"`,\n * `\"ana@example.com\"` → `\"A\"`, `\"   \"` → `\"?\"`.\n *\n * THE DISPLAY DECISION, made once: a multi-part name takes FIRST + LAST, not\n * first + second. `\"Ana Maria Rivera\"` is `AR`, because the family name is the\n * half a reader recognises. (Six matrx-frontend twins took first + second and\n * printed `AM`; the two package copies both took first + last, and both were\n * tested. First + last wins.)\n *\n * Pass the email as the value when there is no name — a single token yields\n * its first character, which is exactly what the host twins did by hand.\n */\nexport function getInitials(\n  value: string | null | undefined,\n  options: InitialsOptions = {},\n): string {\n  const fallback = options.fallback ?? \"?\";\n  if (typeof value !== \"string\") return fallback;\n  const parts = value.trim().split(/\\s+/).filter((part) => part.length > 0);\n  if (parts.length === 0) return fallback;\n  const first = parts[0]?.charAt(0) ?? \"\";\n  const last = parts.length > 1 ? (parts[parts.length - 1]?.charAt(0) ?? \"\") : \"\";\n  return `${first}${last}`.toUpperCase() || fallback;\n}\n\n/**\n * A stable palette index for an avatar with no image. Deterministic on the\n * seed, so the same person is the same colour on every device and every\n * reload — a random colour per render is a surprisingly loud bug.\n */\nexport function avatarPaletteIndex(seed: string, buckets = 8): number {\n  let hash = 0;\n  for (let index = 0; index < seed.length; index += 1) {\n    hash = (hash * 31 + seed.charCodeAt(index)) | 0;\n  }\n  return Math.abs(hash) % buckets;\n}\n"],"mappings":"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","names":[]}