@ai-matrx/kit 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # Changelog
 
+## 0.11.0 — 2026-09-11
+
+**`format` LEARNS THE TWO VOICES THE FLEET WAS MISSING**, plus the countdown
+rounding rule. No new exports and no new layer — four new options and one new
+tier on `formatDurationMs` / `formatRelativeTime`.
+
+**Why.** THREE independent collapse lanes, which never spoke to each other, hit
+the same wall in a single day while retiring hand-rolled formatters onto this
+package. Six matrx-frontend files could not be collapsed at all and three live
+screens regressed when they were. Every one of them broke on one of two holes.
+
+- **`style: "long"` — THE PROSE VOICE.** `45 minutes`, `3 hours`, `1 day`,
+  `3 days`, `less than a second`. The voice that goes INSIDE a sentence a
+  person reads: "Nothing has been delivered for 3 days."; "8 save attempts have
+  failed over the last 5 minutes."; "Expires in 3 days." `coarse` renders those
+  as `72h` and `5 min`, which is wrong in prose — a collapse that degrades a
+  screen is not a win. Always floors, correctly singularises ("1 minute", never
+  "1 minutes"), one tier only, and stops at days (a duration has no calendar
+  anchor, so it cannot honestly speak weeks or months). The name is the same
+  word `RelativeTimeStyle` already uses for the same meaning.
+- **`suffix: false` on `formatRelativeTime`** — the bare stamp (`2m`, `3d`,
+  `2 minutes`) for a dense cell whose column header already says "Age". An
+  option rather than a `"bare"` style because suffixed-vs-bare is a different
+  axis from short/long/intl; folding it into the enum would force
+  `"bare-short"` / `"bare-long"`. It also carries the dense-context long-ago
+  fallback: past a year the bare form prints the short numeric date
+  (`8/7/2025`) instead of `formatAbsoluteDate`'s `Aug 7, 2025, 11:14 PM`, which
+  is right in prose and ruinous in a narrow column. `"intl"` documents that it
+  ignores the option — there is no correct locale-independent way to amputate
+  an `Intl.RelativeTimeFormat` suffix.
+- **`round: "nearest" | "down"`** — `"down"` is mandatory for a COUNTDOWN. The
+  sandbox time-remaining display had regressed to rounding: with 5 minutes
+  30 seconds left it said "6 min", handing the user half a minute they did not
+  have. `clock` and `long` already floor by construction and are unaffected.
+
+**Behaviour changes (all of them fixes to sites that already read badly):**
+
+- `coarse` **gains a day tier**: `3d`, `3d 4h`, `1d 5h`. It used to print `77h`
+  for a three-day container uptime. Only durations past 24 hours change, and
+  every one of those was already unreadable.
+- `compact` **strips a trailing `.0`**: `5.0s` → `5s`, `1.0s` → `1s`. The
+  one-decimal-under-10s rule exists to show tenths WHEN THERE ARE TENTHS; `.0`
+  spends a character saying there are none, and a game countdown ticking
+  "9.0s, 8.0s, 7.0s" reads worse than "9s, 8s, 7s". The usual column-jitter
+  objection does not apply: `compact` already swings between `250ms`, `5.2s`,
+  `44s` and `1m 30s`, so it was never a fixed-width format. `clock` is.
+
+**Refused on purpose: a third, abbreviated-spelled-out register**
+(`45 sec` / `12 min` / `3 hr` / `2 days`), proposed for countdown copy. It is
+`"long"` with three words truncated, gives the reader nothing `"long"` does
+not, and its only distinguishing feature ("hr", "sec") is jargon in exactly the
+sentences that wanted prose. Two registers — dense (`coarse`) and prose
+(`"long"`) — cover every call site the fleet has.
+
 ## 0.10.0 — 2026-09-11
 
 **THE OPENER PATTERN IS NOW A PRIMITIVE.** `@ai-matrx/kit/opener` +

package/README.md

@@ -44,6 +44,7 @@ npm install @ai-matrx/kit
 | `@ai-matrx/kit/color-util` | `findNearestTailwindColor`, `getColorFromTailwind`, `formatTailwindColor`, `format*` normalizers, `createColorNormalizer`, `tailwindColors` | The bidirectional Tailwind-token color mapping with zero dependencies: token → hex lookups (including fuzzy input like `"skyblue598"`), and hex/`rgb()` → nearest token by perceptual CIEDE2000 distance (bit-identical to the colord lab plugin; a colord instance also plugs straight into the structural `{ delta(hex) }` seam). Plus the pure paste-anything input normalizers and the injected-validity `normalizeColorInput` waterfall. |
 | `@ai-matrx/kit/react-tree` | `treeContainsComponent` | Safe React children-tree scan for optional a11y children (is a `DialogDescription` anywhere under these children?): walks elements, arrays, fragments, iterables, and portals by hand, and SKIPS a non-renderable child with a loud dev scream instead of crashing at the probe like `React.Children.toArray` would. |
 | `@ai-matrx/kit/qr` | `decodeQrFromImageFile`, `decodeQrFromElement`, `decodeQrFromImageData`, `hasNativeQrDetector` | THE QR decoder, in memory and never uploaded: a pasted screenshot, a dropped file, or a live `<video>`/`<canvas>` frame in; the encoded text (or `null`) out. Native `BarcodeDetector` first; the pure-JS `jsqr` fallback is lazily imported only in browsers that lack it. |
+| `@ai-matrx/kit/format` | `formatDurationMs` / `Seconds` / `Minutes`, `formatRelativeTime`, `formatAbsoluteDate`, `parseTimestamp`, `durationMsBetween`, `formatFileSize`, `getInitials`, `avatarPaletteIndex` | THE one home for the tiny display formatters nothing else owns, with the display decision made ONCE per voice. Durations speak `clock` (`9:04`), `compact` (`5.2s`, `1m 30s`), `coarse` (`45 min`, `3d 4h`) or `long` (`45 minutes`, `3 days` — the voice that goes inside a sentence), and `round: "down"` makes any of them safe for a countdown. Relative stamps speak `short`, `long` or locale-aware `intl`, with `suffix: false` for a dense column whose header already says "Age". The unit is always in the name — there is deliberately no `formatDuration`. |
 
 More subpaths are on the roadmap: copy-for-ai.
 

package/dist/format.cjs

@@ -90,6 +90,7 @@ var INTL_UNITS = [
 ];
 function formatRelativeTime(value, options = {}) {
   const style = options.style ?? "short";
+  const bare = options.suffix === false;
   const now = options.now ?? Date.now();
   const parsed = parseTimestamp(value);
   if (!parsed) {
@@ -108,13 +109,14 @@ function formatRelativeTime(value, options = {}) {
   }
   const elapsed = now - parsed.getTime();
   if (elapsed < 0) return "just now";
+  const ago = bare ? "" : " ago";
   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 style === "long" ? `${count} ${unit.long}${count === 1 ? "" : "s"}${ago}` : `${count}${unit.short}${ago}`;
     }
   }
-  return formatAbsoluteDate(parsed);
+  return bare ? parsed.toLocaleDateString() : formatAbsoluteDate(parsed);
 }
 var pad2 = (value) => value.toString().padStart(2, "0");
 function clockBody(totalSeconds) {
@@ -123,25 +125,41 @@ function clockBody(totalSeconds) {
   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`;
+var reduce = (value, mode) => mode === "down" ? Math.floor(value) : Math.round(value);
+function compactBody(ms, round) {
+  if (ms < 1e3) return `${reduce(ms, round)}ms`;
   const totalSeconds = ms / 1e3;
   if (totalSeconds < 60) {
-    return totalSeconds < 10 ? `${totalSeconds.toFixed(1)}s` : `${Math.round(totalSeconds)}s`;
+    if (totalSeconds >= 10) return `${reduce(totalSeconds, round)}s`;
+    const tenths = round === "down" ? Math.floor(totalSeconds * 10) / 10 : Math.round(totalSeconds * 10) / 10;
+    return `${Number.isInteger(tenths) ? tenths : tenths.toFixed(1)}s`;
   }
-  const whole = Math.round(totalSeconds);
+  const whole = reduce(totalSeconds, round);
   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);
+function coarseBody(ms, round) {
+  const minutes = reduce(ms / 6e4, round);
   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`;
+  if (minutes < 1440) {
+    const hours = Math.floor(minutes / 60);
+    const rest = minutes % 60;
+    return rest > 0 ? `${hours}h ${rest}m` : `${hours}h`;
+  }
+  const days = Math.floor(minutes / 1440);
+  const restHours = Math.floor(minutes % 1440 / 60);
+  return restHours > 0 ? `${days}d ${restHours}h` : `${days}d`;
+}
+var plural = (count, unit) => `${count} ${unit}${count === 1 ? "" : "s"}`;
+function longBody(ms) {
+  if (ms < 1e3) return "less than a second";
+  if (ms < 6e4) return plural(Math.floor(ms / 1e3), "second");
+  if (ms < 36e5) return plural(Math.floor(ms / 6e4), "minute");
+  if (ms < 864e5) return plural(Math.floor(ms / 36e5), "hour");
+  return plural(Math.floor(ms / 864e5), "day");
 }
 function formatDurationMs(ms, options = {}) {
   const style = options.style ?? "clock";
@@ -152,7 +170,8 @@ function formatDurationMs(ms, options = {}) {
     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);
+  const round = options.round ?? "nearest";
+  const body = style === "clock" ? clockBody(Math.floor(magnitude / 1e3)) : style === "compact" ? compactBody(magnitude, round) : style === "coarse" ? coarseBody(magnitude, round) : longBody(magnitude);
   return negative ? `-${body}` : body;
 }
 function formatDurationSeconds(seconds, options = {}) {

package/dist/format.cjs.map

@@ -1 +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":[]}
+{"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  /**\n   * THE BARE CONTRACT. `false` drops the trailing \" ago\" — \"2m\", \"3d\",\n   * \"2 minutes\" — for a dense table cell whose COLUMN HEADER already says\n   * \"Age\" or \"Last seen\". Default `true`.\n   *\n   * WHY AN OPTION AND NOT A `\"bare\"` STYLE (decided 2026-09-11, after three\n   * surfaces — an exposure audit, a conversation sidebar and a batch Age\n   * column — each lost their deliberate bare stamp to a collapse). `short` /\n   * `long` / `intl` are three different VOICES; suffixed-vs-bare is a\n   * different axis entirely, and you can want a bare `long` (\"2 minutes\") as\n   * readily as a bare `short` (\"2m\"). Folding the axis into the style enum\n   * would force `\"bare-short\"` / `\"bare-long\"` and double the enum every time\n   * either axis grows. Orthogonal beats combinatorial.\n   *\n   * IT ALSO CARRIES THE DENSE-CONTEXT FALLBACK, on purpose. Past a year the\n   * suffixed voices fall back to `formatAbsoluteDate` — \"Aug 7, 2025,\n   * 11:14 PM\" — which is right in prose and ruinous in a narrow column. Asking\n   * for the bare form IS the statement \"this is a dense cell\", so the bare\n   * form's long-ago fallback is the short numeric date, \"8/7/2025\", which is\n   * what every hand-rolled twin printed there. One option, one context, two\n   * consistent consequences.\n   *\n   * `\"intl\"` IGNORES THIS, loudly documented rather than silently half-done:\n   * `Intl.RelativeTimeFormat` composes the whole string in the viewer's\n   * locale, and there is no correct locale-independent way to amputate its\n   * suffix. Ask for `\"short\"` or `\"long\"` when you need bare.\n   */\n  suffix?: boolean | 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 bare = options.suffix === false;\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  const ago = bare ? \"\" : \" ago\";\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  // Past a year: prose gets the full local date+time, a bare/dense cell gets\n  // the short numeric date. See `suffix` above for why one option decides both.\n  return bare ? parsed.toLocaleDateString() : formatAbsoluteDate(parsed);\n}\n\n// ───────────────────────── durations ─────────────────────────\n\n/**\n * The four 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`, `3d 4h`. For durations read at a glance\n *   in a dense cell: podcast episodes, lesson lengths, estimates, uptime,\n *   sandbox time-remaining. Never prints seconds.\n * - `\"long\"` — `45 minutes`, `3 hours`, `1 day`, `3 days`. THE PROSE VOICE:\n *   the one you put INSIDE a sentence a person reads. \"Nothing has been\n *   delivered for 3 days.\" \"8 save attempts have failed over the last\n *   5 minutes.\" \"Expires in 3 days.\"\n *\n * WHY `\"long\"` EXISTS (added 2026-09-11). THREE independent collapse lanes,\n * which never spoke to each other, hit the same wall in one day: six files\n * across matrx-frontend render a duration into English prose, and the package\n * had no voice for it. `coarse` renders three days as `72h` and \"45 minutes\"\n * as \"45 min\", both of which are wrong in a sentence — and a collapse that\n * degrades a screen is not a win. The name is deliberately the SAME WORD as\n * {@link RelativeTimeStyle}'s `\"long\"`, which already means \"spell the unit\n * out in full, correctly pluralised\" (\"2 minutes ago\"). One module, one word,\n * one meaning.\n *\n * WHY THERE IS NO FIFTH, ABBREVIATED-SPELLED-OUT VOICE. A lane proposed a\n * third register — `45 sec` / `12 min` / `3 hr` / `2 days` — for countdown\n * copy. It was refused: it is `\"long\"` with three words truncated, it gives\n * the reader nothing `\"long\"` does not, and its only distinguishing feature\n * (\"hr\", \"sec\") is jargon in exactly the sentences that wanted prose. The one\n * caller that spoke it now speaks `\"long\"`. Two registers — dense (`coarse`)\n * and prose (`\"long\"`) — cover every site the fleet has.\n *\n * WHY `\"coarse\"` GREW A DAY TIER rather than `\"long\"` absorbing those callers:\n * `coarse` stopping at hours was simply a hole. It printed `77h` for a\n * three-day container uptime, which no dense cell wants either; every site\n * that changes is a site that was already reading badly.\n */\nexport type DurationStyle = \"clock\" | \"compact\" | \"coarse\" | \"long\";\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\"` / `\"long\"`.\n   */\n  fallback?: string | undefined;\n  /**\n   * How a tier's leading number is derived from the remainder below it.\n   * `\"nearest\"` (default) is right for a MEASURED or ESTIMATED span — a\n   * 44-minute-31-second podcast reads \"45 min\". `\"down\"` is mandatory for a\n   * COUNTDOWN: with 5 minutes 30 seconds left, \"6 min\" promises the user half\n   * a minute they do not have. (Real regression, sandbox time-remaining,\n   * 2026-09-11.)\n   *\n   * `\"clock\"` and `\"long\"` are ALREADY `\"down\"` by construction and ignore\n   * this — a clock never rounds `0:59` up to `1:00`, and prose \"for 3 hours\"\n   * asserts at-least-three-hours. It changes `\"coarse\"` and `\"compact\"`.\n   */\n  round?: \"nearest\" | \"down\" | 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\ntype Rounding = \"nearest\" | \"down\";\n\nconst reduce = (value: number, mode: Rounding): number =>\n  mode === \"down\" ? Math.floor(value) : Math.round(value);\n\nfunction compactBody(ms: number, round: Rounding): string {\n  if (ms < 1000) return `${reduce(ms, round)}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    //\n    // A TRAILING `.0` IS STRIPPED (2026-09-11). The rule above exists to show\n    // TENTHS WHEN THERE ARE TENTHS; `5.0s` spends a character saying \"there\n    // are none\", and a game countdown ticking \"9.0s, 8.0s, 7.0s\" reads worse\n    // than \"9s, 8s, 7s\" for no gain. The usual objection — column jitter —\n    // does not apply to this voice: `compact` already swings between `250ms`,\n    // `5.2s`, `44s` and `1m 30s`, so it was never a fixed-width column format.\n    // `\"clock\"` is the fixed-width one.\n    if (totalSeconds >= 10) return `${reduce(totalSeconds, round)}s`;\n    const tenths = round === \"down\"\n      ? Math.floor(totalSeconds * 10) / 10\n      : Math.round(totalSeconds * 10) / 10;\n    return `${Number.isInteger(tenths) ? tenths : tenths.toFixed(1)}s`;\n  }\n  const whole = reduce(totalSeconds, round);\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, round: Rounding): string {\n  const minutes = reduce(ms / 60_000, round);\n  if (minutes < 1) return \"< 1 min\";\n  if (minutes < 60) return `${minutes} min`;\n  if (minutes < 1440) {\n    const hours = Math.floor(minutes / 60);\n    const rest = minutes % 60;\n    return rest > 0 ? `${hours}h ${rest}m` : `${hours}h`;\n  }\n  // Day tier, added 2026-09-11: this voice used to print `77h` for a\n  // three-day container uptime. It keeps `coarse`'s own shape — abbreviated\n  // units, at most two of them, largest first — so `3d 4h`, `3d`, never\n  // `3d 4h 12m`.\n  const days = Math.floor(minutes / 1440);\n  const restHours = Math.floor((minutes % 1440) / 60);\n  return restHours > 0 ? `${days}d ${restHours}h` : `${days}d`;\n}\n\nconst plural = (count: number, unit: string): string =>\n  `${count} ${unit}${count === 1 ? \"\" : \"s\"}`;\n\n/**\n * The prose voice. Always FLOORS: \"for 3 hours\" and \"expires in 3 days\" both\n * assert at-least, which is the only reading that cannot mislead in either\n * direction (an elapsed time never overstates, a countdown never over-promises).\n *\n * ONE TIER ONLY — \"3 hours\", never \"3 hours 12 minutes\". This voice goes\n * inside a sentence, and a sentence carrying two magnitudes reads like a\n * stopwatch readout. A caller that genuinely needs both wants `coarse`.\n *\n * Sub-second says so in words rather than printing a floored \"0 seconds\",\n * which reads as \"nothing happened\" — the same reasoning as `coarse`'s\n * \"< 1 min\".\n *\n * It stops at days. Weeks and months are calendar units whose length depends\n * on WHICH week and WHICH month, so a duration — a pure span with no anchor —\n * cannot honestly speak them. \"45 days\" is exact; \"1.5 months\" is a guess.\n * {@link formatRelativeTime}, which HAS an anchor, is where weeks and months\n * belong.\n */\nfunction longBody(ms: number): string {\n  if (ms < 1_000) return \"less than a second\";\n  if (ms < 60_000) return plural(Math.floor(ms / 1_000), \"second\");\n  if (ms < 3_600_000) return plural(Math.floor(ms / 60_000), \"minute\");\n  if (ms < 86_400_000) return plural(Math.floor(ms / 3_600_000), \"hour\");\n  return plural(Math.floor(ms / 86_400_000), \"day\");\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 round = options.round ?? \"nearest\";\n  const body =\n    style === \"clock\"\n      ? clockBody(Math.floor(magnitude / 1000))\n      : style === \"compact\"\n        ? compactBody(magnitude, round)\n        : style === \"coarse\"\n          ? coarseBody(magnitude, round)\n          : longBody(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":[]}

package/dist/format.d.cts

@@ -50,6 +50,34 @@ type RelativeTimeStyle = "short" | "long" | "intl";
 interface RelativeTimeOptions {
     /** Default `"short"`. */
     style?: RelativeTimeStyle | undefined;
+    /**
+     * THE BARE CONTRACT. `false` drops the trailing " ago" — "2m", "3d",
+     * "2 minutes" — for a dense table cell whose COLUMN HEADER already says
+     * "Age" or "Last seen". Default `true`.
+     *
+     * WHY AN OPTION AND NOT A `"bare"` STYLE (decided 2026-09-11, after three
+     * surfaces — an exposure audit, a conversation sidebar and a batch Age
+     * column — each lost their deliberate bare stamp to a collapse). `short` /
+     * `long` / `intl` are three different VOICES; suffixed-vs-bare is a
+     * different axis entirely, and you can want a bare `long` ("2 minutes") as
+     * readily as a bare `short` ("2m"). Folding the axis into the style enum
+     * would force `"bare-short"` / `"bare-long"` and double the enum every time
+     * either axis grows. Orthogonal beats combinatorial.
+     *
+     * IT ALSO CARRIES THE DENSE-CONTEXT FALLBACK, on purpose. Past a year the
+     * suffixed voices fall back to `formatAbsoluteDate` — "Aug 7, 2025,
+     * 11:14 PM" — which is right in prose and ruinous in a narrow column. Asking
+     * for the bare form IS the statement "this is a dense cell", so the bare
+     * form's long-ago fallback is the short numeric date, "8/7/2025", which is
+     * what every hand-rolled twin printed there. One option, one context, two
+     * consistent consequences.
+     *
+     * `"intl"` IGNORES THIS, loudly documented rather than silently half-done:
+     * `Intl.RelativeTimeFormat` composes the whole string in the viewer's
+     * locale, and there is no correct locale-independent way to amputate its
+     * suffix. Ask for `"short"` or `"long"` when you need bare.
+     */
+    suffix?: boolean | undefined;
     /** Injected clock. Default `Date.now()` — pass it in tests. */
     now?: number | undefined;
     /** Returned for null / unparseable input. Default `"—"`. */
@@ -72,7 +100,7 @@ interface RelativeTimeOptions {
  */
 declare function formatRelativeTime(value: TimestampInput, options?: RelativeTimeOptions): string;
 /**
- * The three duration voices the fleet actually speaks. Picked once here so a
+ * The four duration voices the fleet actually speaks. Picked once here so a
  * call duration reads the same in the meeting, the history list and the
  * notification.
  *
@@ -81,19 +109,59 @@ declare function formatRelativeTime(value: TimestampInput, options?: RelativeTim
  * - `"compact"` — `250ms`, `5.2s`, `5m 30s`, `1h 02m`. For elapsed work:
  *   job runs, request timings, step durations. Sub-second is honest about
  *   being sub-second rather than collapsing to `0:00`.
- * - `"coarse"` — `45 min`, `1h 30m`. For things measured in minutes and read
- *   at a glance: podcast episodes, lesson lengths, estimates. Never prints
- *   seconds.
+ * - `"coarse"` — `45 min`, `1h 30m`, `3d 4h`. For durations read at a glance
+ *   in a dense cell: podcast episodes, lesson lengths, estimates, uptime,
+ *   sandbox time-remaining. Never prints seconds.
+ * - `"long"` — `45 minutes`, `3 hours`, `1 day`, `3 days`. THE PROSE VOICE:
+ *   the one you put INSIDE a sentence a person reads. "Nothing has been
+ *   delivered for 3 days." "8 save attempts have failed over the last
+ *   5 minutes." "Expires in 3 days."
+ *
+ * WHY `"long"` EXISTS (added 2026-09-11). THREE independent collapse lanes,
+ * which never spoke to each other, hit the same wall in one day: six files
+ * across matrx-frontend render a duration into English prose, and the package
+ * had no voice for it. `coarse` renders three days as `72h` and "45 minutes"
+ * as "45 min", both of which are wrong in a sentence — and a collapse that
+ * degrades a screen is not a win. The name is deliberately the SAME WORD as
+ * {@link RelativeTimeStyle}'s `"long"`, which already means "spell the unit
+ * out in full, correctly pluralised" ("2 minutes ago"). One module, one word,
+ * one meaning.
+ *
+ * WHY THERE IS NO FIFTH, ABBREVIATED-SPELLED-OUT VOICE. A lane proposed a
+ * third register — `45 sec` / `12 min` / `3 hr` / `2 days` — for countdown
+ * copy. It was refused: it is `"long"` with three words truncated, it gives
+ * the reader nothing `"long"` does not, and its only distinguishing feature
+ * ("hr", "sec") is jargon in exactly the sentences that wanted prose. The one
+ * caller that spoke it now speaks `"long"`. Two registers — dense (`coarse`)
+ * and prose (`"long"`) — cover every site the fleet has.
+ *
+ * WHY `"coarse"` GREW A DAY TIER rather than `"long"` absorbing those callers:
+ * `coarse` stopping at hours was simply a hole. It printed `77h` for a
+ * three-day container uptime, which no dense cell wants either; every site
+ * that changes is a site that was already reading badly.
  */
-type DurationStyle = "clock" | "compact" | "coarse";
+type DurationStyle = "clock" | "compact" | "coarse" | "long";
 interface DurationOptions {
     /** Default `"clock"`. */
     style?: DurationStyle | undefined;
     /**
      * Returned for `null` / `undefined` / non-finite input. Default `"0:00"` for
-     * `"clock"` and `"—"` for `"compact"` / `"coarse"`.
+     * `"clock"` and `"—"` for `"compact"` / `"coarse"` / `"long"`.
      */
     fallback?: string | undefined;
+    /**
+     * How a tier's leading number is derived from the remainder below it.
+     * `"nearest"` (default) is right for a MEASURED or ESTIMATED span — a
+     * 44-minute-31-second podcast reads "45 min". `"down"` is mandatory for a
+     * COUNTDOWN: with 5 minutes 30 seconds left, "6 min" promises the user half
+     * a minute they do not have. (Real regression, sandbox time-remaining,
+     * 2026-09-11.)
+     *
+     * `"clock"` and `"long"` are ALREADY `"down"` by construction and ignore
+     * this — a clock never rounds `0:59` up to `1:00`, and prose "for 3 hours"
+     * asserts at-least-three-hours. It changes `"coarse"` and `"compact"`.
+     */
+    round?: "nearest" | "down" | undefined;
     /**
      * Keep the sign on a negative duration (`-1:23`) instead of clamping to
      * zero. Default `false` — a negative elapsed time is nearly always a clock

package/dist/format.d.ts

@@ -50,6 +50,34 @@ type RelativeTimeStyle = "short" | "long" | "intl";
 interface RelativeTimeOptions {
     /** Default `"short"`. */
     style?: RelativeTimeStyle | undefined;
+    /**
+     * THE BARE CONTRACT. `false` drops the trailing " ago" — "2m", "3d",
+     * "2 minutes" — for a dense table cell whose COLUMN HEADER already says
+     * "Age" or "Last seen". Default `true`.
+     *
+     * WHY AN OPTION AND NOT A `"bare"` STYLE (decided 2026-09-11, after three
+     * surfaces — an exposure audit, a conversation sidebar and a batch Age
+     * column — each lost their deliberate bare stamp to a collapse). `short` /
+     * `long` / `intl` are three different VOICES; suffixed-vs-bare is a
+     * different axis entirely, and you can want a bare `long` ("2 minutes") as
+     * readily as a bare `short` ("2m"). Folding the axis into the style enum
+     * would force `"bare-short"` / `"bare-long"` and double the enum every time
+     * either axis grows. Orthogonal beats combinatorial.
+     *
+     * IT ALSO CARRIES THE DENSE-CONTEXT FALLBACK, on purpose. Past a year the
+     * suffixed voices fall back to `formatAbsoluteDate` — "Aug 7, 2025,
+     * 11:14 PM" — which is right in prose and ruinous in a narrow column. Asking
+     * for the bare form IS the statement "this is a dense cell", so the bare
+     * form's long-ago fallback is the short numeric date, "8/7/2025", which is
+     * what every hand-rolled twin printed there. One option, one context, two
+     * consistent consequences.
+     *
+     * `"intl"` IGNORES THIS, loudly documented rather than silently half-done:
+     * `Intl.RelativeTimeFormat` composes the whole string in the viewer's
+     * locale, and there is no correct locale-independent way to amputate its
+     * suffix. Ask for `"short"` or `"long"` when you need bare.
+     */
+    suffix?: boolean | undefined;
     /** Injected clock. Default `Date.now()` — pass it in tests. */
     now?: number | undefined;
     /** Returned for null / unparseable input. Default `"—"`. */
@@ -72,7 +100,7 @@ interface RelativeTimeOptions {
  */
 declare function formatRelativeTime(value: TimestampInput, options?: RelativeTimeOptions): string;
 /**
- * The three duration voices the fleet actually speaks. Picked once here so a
+ * The four duration voices the fleet actually speaks. Picked once here so a
  * call duration reads the same in the meeting, the history list and the
  * notification.
  *
@@ -81,19 +109,59 @@ declare function formatRelativeTime(value: TimestampInput, options?: RelativeTim
  * - `"compact"` — `250ms`, `5.2s`, `5m 30s`, `1h 02m`. For elapsed work:
  *   job runs, request timings, step durations. Sub-second is honest about
  *   being sub-second rather than collapsing to `0:00`.
- * - `"coarse"` — `45 min`, `1h 30m`. For things measured in minutes and read
- *   at a glance: podcast episodes, lesson lengths, estimates. Never prints
- *   seconds.
+ * - `"coarse"` — `45 min`, `1h 30m`, `3d 4h`. For durations read at a glance
+ *   in a dense cell: podcast episodes, lesson lengths, estimates, uptime,
+ *   sandbox time-remaining. Never prints seconds.
+ * - `"long"` — `45 minutes`, `3 hours`, `1 day`, `3 days`. THE PROSE VOICE:
+ *   the one you put INSIDE a sentence a person reads. "Nothing has been
+ *   delivered for 3 days." "8 save attempts have failed over the last
+ *   5 minutes." "Expires in 3 days."
+ *
+ * WHY `"long"` EXISTS (added 2026-09-11). THREE independent collapse lanes,
+ * which never spoke to each other, hit the same wall in one day: six files
+ * across matrx-frontend render a duration into English prose, and the package
+ * had no voice for it. `coarse` renders three days as `72h` and "45 minutes"
+ * as "45 min", both of which are wrong in a sentence — and a collapse that
+ * degrades a screen is not a win. The name is deliberately the SAME WORD as
+ * {@link RelativeTimeStyle}'s `"long"`, which already means "spell the unit
+ * out in full, correctly pluralised" ("2 minutes ago"). One module, one word,
+ * one meaning.
+ *
+ * WHY THERE IS NO FIFTH, ABBREVIATED-SPELLED-OUT VOICE. A lane proposed a
+ * third register — `45 sec` / `12 min` / `3 hr` / `2 days` — for countdown
+ * copy. It was refused: it is `"long"` with three words truncated, it gives
+ * the reader nothing `"long"` does not, and its only distinguishing feature
+ * ("hr", "sec") is jargon in exactly the sentences that wanted prose. The one
+ * caller that spoke it now speaks `"long"`. Two registers — dense (`coarse`)
+ * and prose (`"long"`) — cover every site the fleet has.
+ *
+ * WHY `"coarse"` GREW A DAY TIER rather than `"long"` absorbing those callers:
+ * `coarse` stopping at hours was simply a hole. It printed `77h` for a
+ * three-day container uptime, which no dense cell wants either; every site
+ * that changes is a site that was already reading badly.
  */
-type DurationStyle = "clock" | "compact" | "coarse";
+type DurationStyle = "clock" | "compact" | "coarse" | "long";
 interface DurationOptions {
     /** Default `"clock"`. */
     style?: DurationStyle | undefined;
     /**
      * Returned for `null` / `undefined` / non-finite input. Default `"0:00"` for
-     * `"clock"` and `"—"` for `"compact"` / `"coarse"`.
+     * `"clock"` and `"—"` for `"compact"` / `"coarse"` / `"long"`.
      */
     fallback?: string | undefined;
+    /**
+     * How a tier's leading number is derived from the remainder below it.
+     * `"nearest"` (default) is right for a MEASURED or ESTIMATED span — a
+     * 44-minute-31-second podcast reads "45 min". `"down"` is mandatory for a
+     * COUNTDOWN: with 5 minutes 30 seconds left, "6 min" promises the user half
+     * a minute they do not have. (Real regression, sandbox time-remaining,
+     * 2026-09-11.)
+     *
+     * `"clock"` and `"long"` are ALREADY `"down"` by construction and ignore
+     * this — a clock never rounds `0:59` up to `1:00`, and prose "for 3 hours"
+     * asserts at-least-three-hours. It changes `"coarse"` and `"compact"`.
+     */
+    round?: "nearest" | "down" | undefined;
     /**
      * Keep the sign on a negative duration (`-1:23`) instead of clamping to
      * zero. Default `false` — a negative elapsed time is nearly always a clock

package/dist/format.js

@@ -57,6 +57,7 @@ var INTL_UNITS = [
 ];
 function formatRelativeTime(value, options = {}) {
   const style = options.style ?? "short";
+  const bare = options.suffix === false;
   const now = options.now ?? Date.now();
   const parsed = parseTimestamp(value);
   if (!parsed) {
@@ -75,13 +76,14 @@ function formatRelativeTime(value, options = {}) {
   }
   const elapsed = now - parsed.getTime();
   if (elapsed < 0) return "just now";
+  const ago = bare ? "" : " ago";
   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 style === "long" ? `${count} ${unit.long}${count === 1 ? "" : "s"}${ago}` : `${count}${unit.short}${ago}`;
     }
   }
-  return formatAbsoluteDate(parsed);
+  return bare ? parsed.toLocaleDateString() : formatAbsoluteDate(parsed);
 }
 var pad2 = (value) => value.toString().padStart(2, "0");
 function clockBody(totalSeconds) {
@@ -90,25 +92,41 @@ function clockBody(totalSeconds) {
   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`;
+var reduce = (value, mode) => mode === "down" ? Math.floor(value) : Math.round(value);
+function compactBody(ms, round) {
+  if (ms < 1e3) return `${reduce(ms, round)}ms`;
   const totalSeconds = ms / 1e3;
   if (totalSeconds < 60) {
-    return totalSeconds < 10 ? `${totalSeconds.toFixed(1)}s` : `${Math.round(totalSeconds)}s`;
+    if (totalSeconds >= 10) return `${reduce(totalSeconds, round)}s`;
+    const tenths = round === "down" ? Math.floor(totalSeconds * 10) / 10 : Math.round(totalSeconds * 10) / 10;
+    return `${Number.isInteger(tenths) ? tenths : tenths.toFixed(1)}s`;
   }
-  const whole = Math.round(totalSeconds);
+  const whole = reduce(totalSeconds, round);
   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);
+function coarseBody(ms, round) {
+  const minutes = reduce(ms / 6e4, round);
   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`;
+  if (minutes < 1440) {
+    const hours = Math.floor(minutes / 60);
+    const rest = minutes % 60;
+    return rest > 0 ? `${hours}h ${rest}m` : `${hours}h`;
+  }
+  const days = Math.floor(minutes / 1440);
+  const restHours = Math.floor(minutes % 1440 / 60);
+  return restHours > 0 ? `${days}d ${restHours}h` : `${days}d`;
+}
+var plural = (count, unit) => `${count} ${unit}${count === 1 ? "" : "s"}`;
+function longBody(ms) {
+  if (ms < 1e3) return "less than a second";
+  if (ms < 6e4) return plural(Math.floor(ms / 1e3), "second");
+  if (ms < 36e5) return plural(Math.floor(ms / 6e4), "minute");
+  if (ms < 864e5) return plural(Math.floor(ms / 36e5), "hour");
+  return plural(Math.floor(ms / 864e5), "day");
 }
 function formatDurationMs(ms, options = {}) {
   const style = options.style ?? "clock";
@@ -119,7 +137,8 @@ function formatDurationMs(ms, options = {}) {
     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);
+  const round = options.round ?? "nearest";
+  const body = style === "clock" ? clockBody(Math.floor(magnitude / 1e3)) : style === "compact" ? compactBody(magnitude, round) : style === "coarse" ? coarseBody(magnitude, round) : longBody(magnitude);
   return negative ? `-${body}` : body;
 }
 function formatDurationSeconds(seconds, options = {}) {

package/dist/format.js.map

@@ -1 +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":[]}
+{"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  /**\n   * THE BARE CONTRACT. `false` drops the trailing \" ago\" — \"2m\", \"3d\",\n   * \"2 minutes\" — for a dense table cell whose COLUMN HEADER already says\n   * \"Age\" or \"Last seen\". Default `true`.\n   *\n   * WHY AN OPTION AND NOT A `\"bare\"` STYLE (decided 2026-09-11, after three\n   * surfaces — an exposure audit, a conversation sidebar and a batch Age\n   * column — each lost their deliberate bare stamp to a collapse). `short` /\n   * `long` / `intl` are three different VOICES; suffixed-vs-bare is a\n   * different axis entirely, and you can want a bare `long` (\"2 minutes\") as\n   * readily as a bare `short` (\"2m\"). Folding the axis into the style enum\n   * would force `\"bare-short\"` / `\"bare-long\"` and double the enum every time\n   * either axis grows. Orthogonal beats combinatorial.\n   *\n   * IT ALSO CARRIES THE DENSE-CONTEXT FALLBACK, on purpose. Past a year the\n   * suffixed voices fall back to `formatAbsoluteDate` — \"Aug 7, 2025,\n   * 11:14 PM\" — which is right in prose and ruinous in a narrow column. Asking\n   * for the bare form IS the statement \"this is a dense cell\", so the bare\n   * form's long-ago fallback is the short numeric date, \"8/7/2025\", which is\n   * what every hand-rolled twin printed there. One option, one context, two\n   * consistent consequences.\n   *\n   * `\"intl\"` IGNORES THIS, loudly documented rather than silently half-done:\n   * `Intl.RelativeTimeFormat` composes the whole string in the viewer's\n   * locale, and there is no correct locale-independent way to amputate its\n   * suffix. Ask for `\"short\"` or `\"long\"` when you need bare.\n   */\n  suffix?: boolean | 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 bare = options.suffix === false;\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  const ago = bare ? \"\" : \" ago\";\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  // Past a year: prose gets the full local date+time, a bare/dense cell gets\n  // the short numeric date. See `suffix` above for why one option decides both.\n  return bare ? parsed.toLocaleDateString() : formatAbsoluteDate(parsed);\n}\n\n// ───────────────────────── durations ─────────────────────────\n\n/**\n * The four 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`, `3d 4h`. For durations read at a glance\n *   in a dense cell: podcast episodes, lesson lengths, estimates, uptime,\n *   sandbox time-remaining. Never prints seconds.\n * - `\"long\"` — `45 minutes`, `3 hours`, `1 day`, `3 days`. THE PROSE VOICE:\n *   the one you put INSIDE a sentence a person reads. \"Nothing has been\n *   delivered for 3 days.\" \"8 save attempts have failed over the last\n *   5 minutes.\" \"Expires in 3 days.\"\n *\n * WHY `\"long\"` EXISTS (added 2026-09-11). THREE independent collapse lanes,\n * which never spoke to each other, hit the same wall in one day: six files\n * across matrx-frontend render a duration into English prose, and the package\n * had no voice for it. `coarse` renders three days as `72h` and \"45 minutes\"\n * as \"45 min\", both of which are wrong in a sentence — and a collapse that\n * degrades a screen is not a win. The name is deliberately the SAME WORD as\n * {@link RelativeTimeStyle}'s `\"long\"`, which already means \"spell the unit\n * out in full, correctly pluralised\" (\"2 minutes ago\"). One module, one word,\n * one meaning.\n *\n * WHY THERE IS NO FIFTH, ABBREVIATED-SPELLED-OUT VOICE. A lane proposed a\n * third register — `45 sec` / `12 min` / `3 hr` / `2 days` — for countdown\n * copy. It was refused: it is `\"long\"` with three words truncated, it gives\n * the reader nothing `\"long\"` does not, and its only distinguishing feature\n * (\"hr\", \"sec\") is jargon in exactly the sentences that wanted prose. The one\n * caller that spoke it now speaks `\"long\"`. Two registers — dense (`coarse`)\n * and prose (`\"long\"`) — cover every site the fleet has.\n *\n * WHY `\"coarse\"` GREW A DAY TIER rather than `\"long\"` absorbing those callers:\n * `coarse` stopping at hours was simply a hole. It printed `77h` for a\n * three-day container uptime, which no dense cell wants either; every site\n * that changes is a site that was already reading badly.\n */\nexport type DurationStyle = \"clock\" | \"compact\" | \"coarse\" | \"long\";\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\"` / `\"long\"`.\n   */\n  fallback?: string | undefined;\n  /**\n   * How a tier's leading number is derived from the remainder below it.\n   * `\"nearest\"` (default) is right for a MEASURED or ESTIMATED span — a\n   * 44-minute-31-second podcast reads \"45 min\". `\"down\"` is mandatory for a\n   * COUNTDOWN: with 5 minutes 30 seconds left, \"6 min\" promises the user half\n   * a minute they do not have. (Real regression, sandbox time-remaining,\n   * 2026-09-11.)\n   *\n   * `\"clock\"` and `\"long\"` are ALREADY `\"down\"` by construction and ignore\n   * this — a clock never rounds `0:59` up to `1:00`, and prose \"for 3 hours\"\n   * asserts at-least-three-hours. It changes `\"coarse\"` and `\"compact\"`.\n   */\n  round?: \"nearest\" | \"down\" | 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\ntype Rounding = \"nearest\" | \"down\";\n\nconst reduce = (value: number, mode: Rounding): number =>\n  mode === \"down\" ? Math.floor(value) : Math.round(value);\n\nfunction compactBody(ms: number, round: Rounding): string {\n  if (ms < 1000) return `${reduce(ms, round)}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    //\n    // A TRAILING `.0` IS STRIPPED (2026-09-11). The rule above exists to show\n    // TENTHS WHEN THERE ARE TENTHS; `5.0s` spends a character saying \"there\n    // are none\", and a game countdown ticking \"9.0s, 8.0s, 7.0s\" reads worse\n    // than \"9s, 8s, 7s\" for no gain. The usual objection — column jitter —\n    // does not apply to this voice: `compact` already swings between `250ms`,\n    // `5.2s`, `44s` and `1m 30s`, so it was never a fixed-width column format.\n    // `\"clock\"` is the fixed-width one.\n    if (totalSeconds >= 10) return `${reduce(totalSeconds, round)}s`;\n    const tenths = round === \"down\"\n      ? Math.floor(totalSeconds * 10) / 10\n      : Math.round(totalSeconds * 10) / 10;\n    return `${Number.isInteger(tenths) ? tenths : tenths.toFixed(1)}s`;\n  }\n  const whole = reduce(totalSeconds, round);\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, round: Rounding): string {\n  const minutes = reduce(ms / 60_000, round);\n  if (minutes < 1) return \"< 1 min\";\n  if (minutes < 60) return `${minutes} min`;\n  if (minutes < 1440) {\n    const hours = Math.floor(minutes / 60);\n    const rest = minutes % 60;\n    return rest > 0 ? `${hours}h ${rest}m` : `${hours}h`;\n  }\n  // Day tier, added 2026-09-11: this voice used to print `77h` for a\n  // three-day container uptime. It keeps `coarse`'s own shape — abbreviated\n  // units, at most two of them, largest first — so `3d 4h`, `3d`, never\n  // `3d 4h 12m`.\n  const days = Math.floor(minutes / 1440);\n  const restHours = Math.floor((minutes % 1440) / 60);\n  return restHours > 0 ? `${days}d ${restHours}h` : `${days}d`;\n}\n\nconst plural = (count: number, unit: string): string =>\n  `${count} ${unit}${count === 1 ? \"\" : \"s\"}`;\n\n/**\n * The prose voice. Always FLOORS: \"for 3 hours\" and \"expires in 3 days\" both\n * assert at-least, which is the only reading that cannot mislead in either\n * direction (an elapsed time never overstates, a countdown never over-promises).\n *\n * ONE TIER ONLY — \"3 hours\", never \"3 hours 12 minutes\". This voice goes\n * inside a sentence, and a sentence carrying two magnitudes reads like a\n * stopwatch readout. A caller that genuinely needs both wants `coarse`.\n *\n * Sub-second says so in words rather than printing a floored \"0 seconds\",\n * which reads as \"nothing happened\" — the same reasoning as `coarse`'s\n * \"< 1 min\".\n *\n * It stops at days. Weeks and months are calendar units whose length depends\n * on WHICH week and WHICH month, so a duration — a pure span with no anchor —\n * cannot honestly speak them. \"45 days\" is exact; \"1.5 months\" is a guess.\n * {@link formatRelativeTime}, which HAS an anchor, is where weeks and months\n * belong.\n */\nfunction longBody(ms: number): string {\n  if (ms < 1_000) return \"less than a second\";\n  if (ms < 60_000) return plural(Math.floor(ms / 1_000), \"second\");\n  if (ms < 3_600_000) return plural(Math.floor(ms / 60_000), \"minute\");\n  if (ms < 86_400_000) return plural(Math.floor(ms / 3_600_000), \"hour\");\n  return plural(Math.floor(ms / 86_400_000), \"day\");\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 round = options.round ?? \"nearest\";\n  const body =\n    style === \"clock\"\n      ? clockBody(Math.floor(magnitude / 1000))\n      : style === \"compact\"\n        ? compactBody(magnitude, round)\n        : style === \"coarse\"\n          ? coarseBody(magnitude, round)\n          : longBody(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":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/kit",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "The always-include AI Matrx kit: the little primitives every Matrx app speaks — autosave that never loses a keystroke, stale-response guards, clipboard with graceful fallbacks — one per subpath, tree-shaken to what you use.",
   "type": "module",
   "main": "./dist/index.cjs",