@danxbot/ui 21.2.0 → 22.0.0

package/dist/types/index.d.ts

@@ -171,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/package.json

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