@danxbot/ui 21.1.0 → 21.2.0

package/dist/types/components/RelativeTime.d.ts

@@ -0,0 +1,17 @@
+import { type ReactNode } from "react";
+import { type RelativeFormat } from "../lib/time/relativeClock";
+export interface RelativeTimeProps {
+    /** The moment: an ISO string, epoch millis or a `Date`. */
+    at: string | number | Date;
+    /** Words for the moment as of `now`. Default: `relativeAge` in the provider's words and locale. A pure function of `(at, now)`, and a STABLE one (memoize it; a new `format` re-reads when the text next changes). */
+    format?: RelativeFormat;
+    /** The tooltip content. Default: the absolute moment, in the provider's locale. `false` for none (the caller wraps its own). */
+    tooltip?: ReactNode | false;
+    className?: string;
+}
+/**
+ * The text of a moment, re-read whenever it changes: what `RelativeTime` draws, for a caller that needs the words themselves
+ * (a sentence built around them, a layout key that must move when the shown age does). Same `format` rules as `RelativeTimeProps`.
+ */
+export declare function useRelativeText(at: string | number | Date, format?: RelativeFormat): string;
+export declare function RelativeTime({ at, format, tooltip, className }: RelativeTimeProps): import("react").JSX.Element;

package/dist/types/index.d.ts

@@ -134,6 +134,9 @@ export { ContextMeter, ChatStatus, type ContextMeterProps, type ContextSegment,
 export { cn } from "./lib/cn";
 export { formatBytes, formatTokens, formatCompactNumber } from "./lib/format";
 export { copyText } from "./lib/clipboard";
+export { RelativeTime, useRelativeText, type RelativeTimeProps } from "./components/RelativeTime";
+export type { RelativeFormat } from "./lib/time/relativeClock";
+export { toEpochMs } from "./lib/time/instant";
 export { CopyValue, type CopyValueProps } from "./components/CopyValue";
 export { formatDate, parseDate, formatDateTime, parseDateTime, type FormatDateTimeOptions, type ParseDateTimeOptions, formatCurrency, parseCurrency, formatNumber, parseNumber, type FormatNumberOptions, formatBoolean, parseBoolean, type FormatBooleanOptions, } from "./lib/values";
 export { COMPONENT_GUIDANCE, type ComponentGuidanceRule } from "./lib/component-guidance";

package/dist/types/lib/time/instant.d.ts

@@ -0,0 +1,2 @@
+/** A moment as epoch millis, from the three shapes a caller holds (ISO string, epoch millis, `Date`). `NaN` when it does not parse. The one parser the time layer shares. DX-4797. */
+export declare function toEpochMs(when: string | number | Date): number;

package/dist/types/lib/time/relativeAge.d.ts

@@ -11,5 +11,8 @@ import type { RelativeAgeStrings } from "../i18n/areas/formats";
  * every sibling formatter in this codebase — nobody needs "9d ago" instead
  * of "1w 2d ago", and nobody needs either instead of a calendar date, but a
  * chat message's hover row has no room for a calendar date, so weeks it is.
+ *
+ * `now` is the instant to measure against (default: the clock). `RelativeTime`'s shared ticker passes later instants to find
+ * when this text next changes.
  */
-export declare function relativeAge(when: string | number | Date, strings: RelativeAgeStrings, locale: string): string;
+export declare function relativeAge(when: string | number | Date, strings: RelativeAgeStrings, locale: string, now?: number): string;

package/dist/types/lib/time/relativeClock.d.ts

@@ -0,0 +1,8 @@
+/** The text of a moment as of `now` (epoch ms). `relativeAge` is one. */
+export type RelativeFormat = (at: string | number | Date, now?: number) => string;
+/** The first instant after `now` at which `format(at, instant)` differs from `format(at, now)`, within `HORIZON_MS`. */
+export declare function nextTextChangeAt(at: number, format: RelativeFormat, now: number): number;
+/** Calls `onChange` whenever `format(at)` may now read differently. Returns the unsubscribe. The last unsubscribe stops the timer. */
+export declare function subscribeRelativeClock(at: number, format: RelativeFormat, onChange: () => void): () => void;
+/** Mounted subscribers right now; the tests pin that it returns to zero. */
+export declare function relativeClockSubscriberCount(): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/ui",
-  "version": "21.1.0",
+  "version": "21.2.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",