@danxbot/ui 21.1.0 → 22.0.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";
@@ -168,5 +171,5 @@ export { OpenApiViewer, type OpenApiViewerProps, OperationCard, type OperationCa
 export { defineRecordType, resetRecordTypes, useRecord, useRecords, useStaleness, write, writeAll, peekRecord, readState, readStaleness, subscribeToKey, subscribeToStaleness, retainKeys, sweepRecords, setRecordStoreTenant, getRecordStoreTenant, flushRecordNotifications, resetRecordStore, recordStoreStats, UNKNOWN_STATE, normalizeTypeName, normalizeTimestamp, recordKey, isRecordRef, type RecordRef, type ReadOptions, type RecordPayload, type RecordState, type RecordTypeOptions, type RecordTypeToken, type StalenessEntry, type WriteAllResult, type WriteOptions, type WriteResult, type WriteSource, type WriteVerdict, } from "./lib/records";
 export { RealtimeProvider, useRealtime, useRealtimeEpoch, useRealtimeHealth, useRealtimeRegistry, SubscriptionRegistry, normalizeScope, scopeKey, subscriptionKey, readRealtimeEpoch, subscribeToRealtimeEpoch, subscribeToRealtimeEvents, resetRealtimeSignals, type RealtimeChannel, type RealtimeConnectionState, type RealtimeDiagnostic, type RealtimeEvent, type RealtimeHealth, type RealtimeProviderProps, type RealtimeScope, type RealtimeScopeInput, type RealtimeStatus, type RealtimeTransport, type RegistryOptions, type SubscriptionHealth, type SubscriptionLease, type SubscriptionRequest, } from "./lib/realtime";
 export { useRecordRead, useRecordListRead, useRecordStoreSweep, applyMutationResult, optimisticWrite, beginOptimisticWrite, resetOptimisticWrites, type OptimisticHandle, type OptimisticWriteOptions, type OptimisticWriteSpec, type SlotDescriptor, acquireSlot, appendCreated, emptySlotSnapshot, readSlot, resetSlots, slotKeys, subscribeToSlot, writeSlot, RefetchRunner, registerActiveRead, resetActiveReads, type ActiveRead, type ListFetch, type ListFetchResult, type ListReadOptions, type ListReadResult, type ReadError, type RecordFetch, type RecordReadOptions, type RecordReadResult, type RunnerOptions, type SlotSnapshot, } from "./lib/reads";
-export { ENGLISH_UI_STRINGS, UiLocaleProvider, useUiLocale, useUiStrings, type UiLocaleProviderProps, type UiLocaleValue, type UiStrings, } from "./lib/i18n";
+export { chordLabel, ENGLISH_UI_STRINGS, UiLocaleProvider, useUiLocale, useUiStrings, type KeyId, type UiLocaleProviderProps, type UiLocaleValue, type UiStrings, } from "./lib/i18n";
 export type { BooleanStrings, FormatsStrings, ReadErrorStrings, RelativeAgeStrings } from "./lib/i18n/areas/formats";

package/dist/types/lib/i18n/areas/feedback.d.ts

@@ -63,6 +63,8 @@ export interface FeedbackStrings {
     toast: {
         /** Accessible name of a toast's close button. */
         dismiss: string;
+        /** Accessible name of the region that holds the toasts. */
+        viewport: string;
     };
     legalDocument: {
         /** Default accessible name of the table of contents. */

package/dist/types/lib/i18n/areas/forms.d.ts

@@ -17,6 +17,8 @@ export interface FormsStrings {
         open: string;
         /** Name of a selected chip's remove button. */
         remove: string;
+        /** Name of the screen-reader buttons that close the open list. */
+        dismiss: string;
     };
     select: {
         /** Trigger text while nothing is selected and the caller gave no `placeholder`. */
@@ -99,8 +101,8 @@ export interface FormsStrings {
         empty: string;
         /** Screen-reader announcement while an autosave is in flight. */
         saving: string;
-        /** Message under a field whose save failed, naming the key that retries it. */
-        failure: (retryKey: "Enter" | "Ctrl+Enter") => string;
+        /** Message under a field whose save failed; `retryChord` is the chord that retries it, in the catalog's key names ("Ctrl+Enter"). */
+        failure: (retryChord: string) => string;
     };
     inlineMarkdownEdit: {
         /** Resting text of an empty InlineMarkdownEdit. */

package/dist/types/lib/i18n/areas/keys.d.ts

@@ -0,0 +1,14 @@
+/** The keys the library prints the name of: modifiers and the named keys a chord can contain. */
+export declare const KEY_IDS: readonly ["ctrl", "alt", "shift", "tab", "enter", "backspace"];
+export type KeyId = (typeof KEY_IDS)[number];
+export interface KeysStrings {
+    /** The name printed on the key cap, by key id ("Shift", or "Mayús" on a Spanish keyboard). */
+    keyNames: Record<KeyId, string>;
+}
+export declare const keysStrings: KeysStrings;
+/**
+ * A chord as a person reads it: `ctrl+shift+bracketleft` -> `Ctrl+Shift+[`, each named key in
+ * the catalog's words. A part that is neither a named key, a symbol nor a single character is a
+ * chord the table never declared, so it throws rather than print a made-up name.
+ */
+export declare function chordLabel(chord: string, keyNames: KeysStrings["keyNames"]): string;

package/dist/types/lib/i18n/index.d.ts

@@ -6,3 +6,5 @@ export type { UiStrings } from "./strings";
 export { useNumberFormat } from "./number-format";
 export { plural } from "./plural";
 export type { PluralForms } from "./plural";
+export { chordLabel } from "./areas/keys";
+export type { KeyId } from "./areas/keys";

package/dist/types/lib/i18n/strings.d.ts

@@ -7,9 +7,10 @@ import { type DocsViewsStrings } from "./areas/docs-views";
 import { type FeedbackStrings } from "./areas/feedback";
 import { type FormsStrings } from "./areas/forms";
 import { type FormatsStrings } from "./areas/formats";
+import { type KeysStrings } from "./areas/keys";
 import { type MarkdownStrings } from "./areas/markdown";
 import { type MoveRejectedStrings } from "./areas/move-rejected";
 import { type NavigationStrings } from "./areas/navigation";
 import { type RbacStrings } from "./areas/rbac";
-export type UiStrings = AuthProvenanceFlowsStrings & BoardStrings & ChatChartStrings & CodeEditorStrings & DatesStrings & DocsViewsStrings & FeedbackStrings & FormsStrings & FormatsStrings & MarkdownStrings & MoveRejectedStrings & NavigationStrings & RbacStrings;
+export type UiStrings = AuthProvenanceFlowsStrings & BoardStrings & ChatChartStrings & CodeEditorStrings & DatesStrings & DocsViewsStrings & FeedbackStrings & FormsStrings & FormatsStrings & KeysStrings & MarkdownStrings & MoveRejectedStrings & NavigationStrings & RbacStrings;
 export declare const ENGLISH_UI_STRINGS: UiStrings;

package/dist/types/lib/markdown/hotkeys.d.ts

@@ -30,8 +30,6 @@ interface HotkeyBase {
      * which character the modifier produced.
      */
     key: string;
-    /** What the help surface shows, which is the chord as a person types it ("Ctrl+Shift+["), derived from `key`. */
-    label: string;
     group: HotkeyGroup;
 }
 /** A chord, and EITHER the pure edit it makes OR the editor request it raises. */

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": "22.0.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",