@danxbot/ui 20.23.3 → 21.1.0

package/dist/types/components/provenance/ProvenanceDisclosure.d.ts

@@ -6,7 +6,7 @@ export interface ProvenanceDisclosureProps {
     record: ProvenanceRecord;
     /** Rendered at the foot of the panel. {@link ProvenanceDetailProps.actions} */
     actions?: ReactNode;
-    /** Shown in place of the value when there is none and it did not fail. */
+    /** Shown in place of the value when there is none and it did not fail. Absent means the provider's own words. */
     emptyLabel?: string;
     /** Shown in place of the value when the viewer may not see it. */
     redactedLabel?: string;

package/dist/types/components/provenance/absence.d.ts

@@ -1,5 +1,6 @@
 import type { ReactNode } from "react";
 import { type IconName } from "../Icon";
+import type { UiStrings } from "../../lib/i18n";
 import type { ProvenanceRecord } from "./types";
 declare const ABSENCE: Record<"redacted" | "empty" | "failed", {
     icon: IconName;
@@ -30,7 +31,7 @@ export declare function isFailed(record: ProvenanceRecord): boolean;
  * next actions.
  */
 export declare function shownValue(record: ProvenanceRecord, { emptyLabel, redactedLabel }: {
-    emptyLabel: string;
-    redactedLabel: string;
-}): ReactNode;
+    emptyLabel?: string;
+    redactedLabel?: string;
+}, absence: UiStrings["provenanceAbsence"]): ReactNode;
 export {};

package/dist/types/components/rbac/RoleKeyPicker.d.ts

@@ -16,7 +16,7 @@ export interface RoleKeyPickerProps {
     className?: string;
 }
 /** Why `role` can't be chosen, naming the missing permissions by label. `null` when it can. */
-export declare function roleUnavailableReason(role: Role, own: ReadonlySet<string>, permissions: Permission[]): string | null;
+export declare function roleUnavailableReason(role: Role, own: ReadonlySet<string>, permissions: Permission[], unavailable: (permissionLabels: string[]) => string): string | null;
 /** Whether `roleId` names a role in `roles` that the issuer may choose. */
 export declare function isRoleSelectable(roleId: string, roles: Role[], own: ReadonlySet<string>): boolean;
 /** The id of the selectable role holding the fewest permissions (the first of any tie), or `""` when none is selectable. */

package/dist/types/components/rbac/permissionSections.d.ts

@@ -14,4 +14,4 @@ export interface PermissionSection {
  * explicit "Other" bucket for the rest, because at that point the absence of
  * a category on a handful of rows is itself information worth a heading.
  */
-export declare function groupByCategory(permissions: Permission[]): PermissionSection[];
+export declare function groupByCategory(permissions: Permission[], otherLabel: string): PermissionSection[];

package/dist/types/components/rbac/stagedForm.d.ts

@@ -9,8 +9,6 @@ export interface SaveFlow {
     save: (run: () => Promise<void>) => Promise<void>;
 }
 export declare function useSaveFlow(failureMessage: string): SaveFlow;
-/** The line under a staged image, naming what Save will do with it. */
-export declare function stagedImageNote(noun: string, saveLabel: string, removed: boolean): string;
 export interface StagedFormActionsProps {
     onSave: () => void;
     onDiscard: () => void;
@@ -19,7 +17,9 @@ export interface StagedFormActionsProps {
     /** The draft differs from what is saved in ANY way, including whitespace Save would trim away. */
     canDiscard: boolean;
     saving: boolean;
-    saveLabel: string;
-    discardLabel: string;
+    /** The Save button's text; omit for the built-in one. */
+    saveLabel?: string;
+    /** The Discard button's text; omit for the built-in one. */
+    discardLabel?: string;
 }
 export declare function StagedFormActions({ onSave, onDiscard, canSave, canDiscard, saving, saveLabel, discardLabel, }: StagedFormActionsProps): import("react").JSX.Element;

package/dist/types/components/roadmap/RoadmapItemCard.d.ts

@@ -2,7 +2,6 @@ import { type BadgeProps } from "../Badge";
 import type { Domain, Phase, RoadmapItem, RoadmapItemStatus, Track, UseCase, UseCaseStatus } from "./types";
 export declare const ROADMAP_ITEM_STATUS_BADGE: Record<RoadmapItemStatus, {
     tone: BadgeProps["tone"];
-    label: string;
     live?: boolean;
 }>;
 export interface RoadmapItemCardProps {

package/dist/types/index.d.ts

@@ -93,7 +93,7 @@ export { MarkdownSurface, type SurfaceOptions, type Splice } from "./lib/markdow
 export { project, projectedText, ProjectionError } from "./lib/markdown/project";
 export type { Projection, PNode, PText, PElement } from "./lib/markdown/project";
 export { attachInput, type InputOptions } from "./lib/markdown/input";
-export { HOTKEYS, hotkeyFor, chordsOf, type Hotkey, type HotkeyGroup, type EditorRequest } from "./lib/markdown/hotkeys";
+export { HOTKEYS, hotkeyFor, chordsOf, type Hotkey, type HotkeyGroup, type EditorRequest, type HotkeyId } from "./lib/markdown/hotkeys";
 export { MarkdownImageUploadProvider, type MarkdownImageUploadProviderProps, } from "./components/markdown/ImageUpload";
 export type { ImageUploader, ImageUploadState } from "./lib/markdown/image-pipeline";
 export { findUnstoredImages, isUnstoredImageSrc, type UnstoredImage } from "./lib/markdown/images";
@@ -111,11 +111,11 @@ export { tokenize, listLanguages, resolveLanguage, defineGrammar, registerGramma
 export { parseMarkdown, MarkdownNodes, sanitizeHref, type MdNode, type MdInline, type MdCodeRenderer, } from "./lib/syntax/markdown";
 export { DragDrop, DragDropContainer, DragDropItem, DragDropHandle, DragDropSurface, type DragDropProps, type DragDropContainerProps, type DragDropItemProps, type DragDropHandleProps, type DragDropSurfaceProps, } from "./components/DragDrop";
 export { KanbanBoard, type KanbanBoardProps, type KanbanLane, type KanbanMove, type KanbanRefusal, } from "./components/kanban/KanbanBoard";
-export { DEFAULT_DRAG_STRINGS, DRAG_INSTRUCTIONS_ID, DragInstructions, DragLiveRegion, DragSession, DragSessionProvider, applyMove, attachAutoScroll, attachKeyboardSensor, attachPointerSensor, attachSessionWindowListeners, isNoOp, resolveTarget, sameTarget, scrollVelocity, useCreateDragSession, useDragAnnouncements, useDragSession, useDragState, useDragLive, useDraggable, useDropContainer, type ContainerId, type CrossDrop, type DragAxis, type DragCancelEvent, type DragEndEvent, type DragId, type DragMode, type DragPhase, type DragSessionCallbacks, type DragStartEvent, type DragState, type AutoScrollOptions, type DragAnnouncementContext, type DragAnnouncementOptions, type DragAnnouncements, type DragInstructionsProps, type DragLiveRegionProps, type DragStrings, type DropTarget, type KeyboardSensorOptions, type PointerActivation, } from "./lib/dnd";
+export { DRAG_INSTRUCTIONS_ID, DragInstructions, DragLiveRegion, DragSession, DragSessionProvider, applyMove, attachAutoScroll, attachKeyboardSensor, attachPointerSensor, attachSessionWindowListeners, isNoOp, resolveTarget, sameTarget, scrollVelocity, useCreateDragSession, useDragAnnouncements, useDragSession, useDragState, useDragLive, useDraggable, useDropContainer, type ContainerId, type CrossDrop, type DragAxis, type DragCancelEvent, type DragEndEvent, type DragId, type DragMode, type DragPhase, type DragSessionCallbacks, type DragStartEvent, type DragState, type AutoScrollOptions, type DragAnnouncementContext, type DragAnnouncementOptions, type DragAnnouncements, type DragInstructionsProps, type DragLiveRegionProps, type DropTarget, type KeyboardSensorOptions, type PointerActivation, } from "./lib/dnd";
 export { Board, BoardColumn, BoardCard, BoardCardSurface, type BoardProps, type BoardColumnProps, type BoardCardProps, type BoardCardSurfaceProps, } from "./components/Board";
-export { buildBoardModel, resolveMove, applyBoardMoves, useBoard, moveAnchor, columnLength, positionInColumn, type BoardModel, type MoveAnchor, type UseBoardResult, } from "./lib/board";
-export type { BoardAccessors, BoardColumnDef, BoardEdge, BoardColumnId, BoardColumnModel, BoardItemId, BoardMove, BoardMoveTarget, BoardMoveRequest, BoardMoveSource, BoardMoveVerdict, BoardReorderLabels, UseBoardOptions, } from "./lib/board";
-export { PagedWindowList, type PagedWindowItemPosition, type PagedWindowListProps, type PagedWindowStrings, } from "./components/PagedWindowList";
+export { buildBoardModel, resolveMove, applyBoardMoves, describeMoveRejection, useBoard, moveAnchor, columnLength, positionInColumn, type BoardModel, type MoveAnchor, type UseBoardResult, } from "./lib/board";
+export type { BoardAccessors, BoardColumnDef, BoardEdge, BoardColumnId, BoardColumnModel, BoardItemId, BoardMove, BoardMoveTarget, BoardMoveRequest, BoardMoveSource, BoardMoveOutcome, BoardMoveRejection, BoardMoveVerdict, BoardReorderLabels, UseBoardOptions, } from "./lib/board";
+export { PagedWindowList, type PagedWindowItemPosition, type PagedWindowListProps, } from "./components/PagedWindowList";
 export { PAGED_WINDOW_SETTLE_MS, PagedWindowStore, usePagedWindow, windowPageNumbers, type LoadCount, type LoadPage, type LoadPageContext, type PageResponse, type PageSnapshot, type PageStatus, type PagedWindow, type PagedWindowMode, type PagedWindowOptions, type PagedWindowSnapshot, type UsePagedWindowOptions, } from "./lib/paged-window";
 export type { MessageRole, MessagePart, TextPart, CodePart, ReasoningPart, ToolPart, ToolStatus, FilePart, ComponentPart, ChatFile, ChatMessage, RenderContext, PartRenderer, PartRenderers, ChatComponentRenderer, ChatComponents, } from "./components/chat/types";
 export { Chat, ChatPopover, type ChatProps, type ChatPopoverProps, type ChatSurface, } from "./components/chat/Chat";
@@ -129,7 +129,7 @@ export { FileViewer, PageNumberJumpField, type FileViewerProps, type PageNumberJ
 export { fileIconFor, type FileIdentity } from "./components/chat/file-icon";
 export { VideoPlayer, type VideoPlayerProps, type VideoTrack } from "./components/VideoPlayer";
 export { ModelSelector, type ModelSelectorProps, type ChatModel, } from "./components/chat/ModelSelector";
-export { EffortControl, DEFAULT_EFFORT_LEVELS, type EffortControlProps, type EffortLevel, } from "./components/chat/EffortControl";
+export { EffortControl, type EffortControlProps, type EffortLevel, } from "./components/chat/EffortControl";
 export { ContextMeter, ChatStatus, type ContextMeterProps, type ContextSegment, type UsageLimit, type ChatStatusProps, } from "./components/chat/ContextMeter";
 export { cn } from "./lib/cn";
 export { formatBytes, formatTokens, formatCompactNumber } from "./lib/format";
@@ -153,7 +153,7 @@ export { EVENT_PALETTE, DEFAULT_PALETTE_KEY, isPaletteKey, paletteFor, } from ".
 export { cellLabel, eventLabel, formatDateRange, longDate, monthTitle, timeOfDay, weekdayName, zoneLabel, } from "./components/calendar/format";
 export { initialFocusDay, isInMonth, nextDayForKey, useGridNavigation, type GridNavigation, type GridNavigationOptions, } from "./components/calendar/use-grid-navigation";
 export { AmbiguousTimeError, addDays, addDuration, addMonths, atMidnight, atTime, comparePlainDate, dayFraction, dayLengthMs, dayOfWeek, daysBetween, daysInMonth, endOfMonth, hoursInDay, instantAtFraction, instantToPlainDate, instantToPlainDateTime, isSameDate, isoDateString, isoDateTimeString, monthGridDays, nextDay, offsetAt, parsePlainDate, plainDateTimeToInstant, relativeAge, startOfDay, startOfMonth, startOfWeek, weekDays, type CalendarDuration, type Disambiguation, type Instant, type PlainDate, type PlainDateTime, type TimeZone, } from "./lib/time";
-export { allDayBandSegment, dayKey, daySlots, isAllDay, packBand, packLanes, snapFractionToInstant, timeSegments, timedBandSegment, type AllDayEvent, type BandInput, type BandOptions, type BandPlacement, type BandResult, type BandSegment, type CalendarEvent, type CalendarEventId, type CalendarView, type DaySlot, type DragKind, type EventDraft, type EventPalette, type LaneInput, type LaneOptions, type LanePlacement, type PaletteEntry, type TimeSegment, type TimedEvent, type VisibleRange, } from "./lib/calendar";
+export { allDayBandSegment, dayKey, daySlots, isAllDay, packBand, packLanes, snapFractionToInstant, timeSegments, timedBandSegment, type AllDayEvent, type BandInput, type BandOptions, type BandPlacement, type BandResult, type BandSegment, type CalendarEvent, type CalendarEventId, type CalendarView, type DaySlot, type DragKind, type EventDraft, type EventPalette, type LaneInput, type LaneOptions, type LanePlacement, type PaletteEntry, type PaletteKey, type TimeSegment, type TimedEvent, type VisibleRange, } from "./lib/calendar";
 export { RBACProvider, useRBAC, Can, useHasPermission, AccountMenu, AccountMenuSection, TeamSwitcher, DevToolsPopover, RolePermissionMatrix, RoleEditorDialog, ProfileForm, ProfilePage, RolesPermissionsPage, MembersPanel, ChangePasswordForm, SessionsList, ApiKeysPanel, AgentKeysList, AccessRequestPanel, PermissionRequestPanel, RoleKeyPicker, isRoleSelectable, leastPrivilegeRoleId, InvitationsList, InviteMembersDialog, Brand, TeamSettingsForm, DangerZone, type RBACProviderProps, type RBACHookResult, type CanProps, type AccountMenuProps, type TeamSwitcherProps, type DevToolsPopoverProps, type RolePermissionMatrixProps, type RoleEditorDialogProps, type RoleEditorDialogSubmitInput, type ProfileFormProps, type ProfileFormAccount, type ProfileFormSaveInput, type ProfilePageProps, type RolesPermissionsPageProps, type MembersPanelProps, type MembersPanelMember, type ChangePasswordFormProps, type SessionsListProps, type Session, type ApiKeysPanelProps, type AgentKeysListProps, type ApiKey, type KeyGrant, type KeyRoleEditor, type AccessRequestPanelProps, type AccessRequest, type AccessRequestKind, type AccessRequestState, type ExpiredNote, type PermissionRequestPanelProps, type PermissionRequest, type RoleKeyPickerProps, type InvitationsListProps, type InvitationsListItem, type InvitationStatus, type InviteMembersDialogProps, type Permission, type Role, type User, type Team, type TeamMembership, type BrandProps, type TeamSettingsFormProps, type TeamSettingsFormTeam, type TeamSettingsFormSaveInput, type DangerZoneProps, } from "./components/rbac";
 export { AuthLayout, AcceptInvitationCard, SignupCard, TermsAcceptance, LoginForm, ForgotPasswordForm, ResetPasswordForm, type AuthLayoutProps, type AcceptInvitationCardProps, type SignupCardProps, type TermsAcceptanceProps, type LoginFormProps, type ForgotPasswordFormProps, type ResetPasswordFormProps, } from "./components/auth";
 export { UseCaseCard, RoadmapItemCard, RoadmapSwimlaneBoard, UseCaseLedgerPage, RoadmapPage, PhaseManager, TrackManager, deriveRoadmapItemStatus, isFullyBuilt, isUnbuilt, trackIds, trackProgress, toneForIndex, CATEGORY_TONES, type Domain, type Phase, type Track, type RoadmapItem, type RoadmapItemStatus, type UseCase, type UseCaseStatus, type UseCaseDecision, type UseCaseCardProps, type RoadmapItemCardProps, type RoadmapSwimlaneBoardProps, type UseCaseLedgerPageProps, type RoadmapPageProps, type PhaseManagerProps, type TrackManagerProps, } from "./components/roadmap";
@@ -168,3 +168,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 type { BooleanStrings, FormatsStrings, ReadErrorStrings, RelativeAgeStrings } from "./lib/i18n/areas/formats";

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

@@ -8,8 +8,9 @@
  * NOT wired into the package's top-level `src/index.ts` — that barrel is
  * owned by the contract's author, not this agent (see this round's brief).
  */
-export type { BoardAccessors, BoardColumnDef, BoardEdge, BoardColumnId, BoardColumnModel, BoardItemId, BoardMove, BoardMoveTarget, BoardMoveRequest, BoardMoveSource, BoardMoveVerdict, BoardReorderLabels, UseBoardOptions, } from "./types";
+export type { BoardAccessors, BoardColumnDef, BoardEdge, BoardColumnId, BoardColumnModel, BoardItemId, BoardMove, BoardMoveTarget, BoardMoveRequest, BoardMoveSource, BoardMoveOutcome, BoardMoveRejection, BoardMoveVerdict, BoardReorderLabels, UseBoardOptions, } from "./types";
 export { buildBoardModel, type BoardModel } from "./model";
+export { describeMoveRejection } from "./rejection";
 export { moveAnchor, type MoveAnchor } from "./anchor";
 export { columnLength, positionInColumn } from "./position";
 export { applyBoardMoves, resolveMove, type ResolveMoveContext, type ResolvedMove, } from "./move";

package/dist/types/lib/board/move.d.ts

@@ -113,7 +113,7 @@
  * other shape — cross-column, or any bulk request — has no single shared
  * array to splice, so it goes through the residual-and-insert pass above.
  */
-import type { BoardAccessors, BoardColumnDef, BoardMove, BoardMoveRequest, BoardMoveVerdict } from "./types";
+import type { BoardAccessors, BoardColumnDef, BoardMove, BoardMoveRequest, BoardMoveOutcome, BoardMoveVerdict } from "./types";
 /** Everything `resolveMove` reads to prove a request is structurally real. */
 export interface ResolveMoveContext<T> {
     items: readonly T[];
@@ -123,7 +123,7 @@ export interface ResolveMoveContext<T> {
     validateMove?: (request: BoardMoveRequest) => BoardMoveVerdict;
 }
 export interface ResolvedMove {
-    verdict: BoardMoveVerdict;
+    verdict: BoardMoveOutcome;
     /**
      * The subset of the request's moves worth committing, in original order.
      * Empty whenever there is nothing to write — either every move was a

package/dist/types/lib/board/rejection.d.ts

@@ -0,0 +1,8 @@
+import type { UiStrings } from "../i18n";
+import type { BoardMoveRejection } from "./types";
+/**
+ * DX-4740: the sentence a person reads for a refused move. The core answers with values
+ * (`BoardMoveRejection`); the provider's `moveRejected` strings word them. A consumer's own
+ * sentence passes through untouched.
+ */
+export declare function describeMoveRejection(strings: UiStrings["moveRejected"], locale: string, reason: BoardMoveRejection): string;

package/dist/types/lib/board/types.d.ts

@@ -196,6 +196,52 @@ export type BoardMoveVerdict = {
     ok: false;
     reason: string;
 };
+/**
+ * DX-4740: WHY THE CORE REFUSED A MOVE, AS VALUES, NEVER AS A SENTENCE. The core
+ * (`resolveMove`) has no language; the component that shows the refusal words it
+ * through the provider's `moveRejected` strings. Only the refusals a person can
+ * reach are listed: a stale request (the card was moved or removed under them) and
+ * a consumer's own sentence. A column that is no longer declared is the same kind of
+ * stale request (a live update removed it during the drag). A malformed request (a negative
+ * index, a duplicate item, a multi-move request that is not `"bulk"`) is the
+ * caller's bug and throws an English `Error` from `resolveMove` instead.
+ */
+export type BoardMoveRejection = {
+    code: "unknownItem";
+    itemId: BoardItemId;
+} | {
+    code: "unknownColumn";
+    columnId: BoardColumnId;
+} | {
+    code: "wrongColumn";
+    itemId: BoardItemId;
+    actualColumnId: BoardColumnId;
+    claimedColumnId: BoardColumnId;
+} | {
+    code: "fromIndexPastEnd";
+    itemId: BoardItemId;
+    index: number;
+    columnId: BoardColumnId;
+    count: number;
+} | {
+    code: "toIndexPastEnd";
+    itemId: BoardItemId;
+    index: number;
+    columnId: BoardColumnId;
+    max: number;
+}
+/** The consumer's own sentence (`reorderLocked`, `validateMove`), already in their language: shown as is. */
+ | {
+    code: "consumer";
+    message: string;
+};
+/** What `resolveMove` and `useBoard().requestMove` answer: `BoardMoveVerdict`, with a structured reason. */
+export type BoardMoveOutcome = {
+    ok: true;
+} | {
+    ok: false;
+    reason: BoardMoveRejection;
+};
 /** A column as the core computes it, ready to render. */
 export interface BoardColumnModel<T> {
     id: BoardColumnId;

package/dist/types/lib/board/use-board.d.ts

@@ -29,7 +29,7 @@
  * the same way, mirroring why `requestMove` exists as a single funnel for
  * moves rather than one per source.
  */
-import type { BoardColumnModel, BoardItemId, BoardMoveRequest, BoardMoveVerdict, UseBoardOptions } from "./types";
+import type { BoardColumnModel, BoardItemId, BoardMoveRequest, BoardMoveOutcome, UseBoardOptions } from "./types";
 export interface UseBoardResult<T> {
     /** One entry per declared column, in `columns` order, ready to render. */
     columns: readonly BoardColumnModel<T>[];
@@ -42,6 +42,6 @@ export interface UseBoardResult<T> {
     setSelected: (ids: readonly BoardItemId[]) => void;
     clearSelection: () => void;
     /** The single funnel every input source calls. See the file header. */
-    requestMove: (request: BoardMoveRequest) => BoardMoveVerdict;
+    requestMove: (request: BoardMoveRequest) => BoardMoveOutcome;
 }
 export declare function useBoard<T>(options: UseBoardOptions<T>): UseBoardResult<T>;

package/dist/types/lib/calendar/drag.d.ts

@@ -120,6 +120,6 @@ export declare function createdEvent(anchor: CalendarTarget, target: CalendarTar
  * "Moved to 2:30 PM, Wednesday" — the SLOT, not the fact that something moved.
  * "Moved" alone tells a screen-reader user nothing they can act on.
  */
-export declare function describeTarget(target: CalendarTarget, zone: TimeZone, locale?: string): string;
+export declare function describeTarget(target: CalendarTarget, zone: TimeZone, locale: string): string;
 /** Where in the grid a fraction sits, for the preview. Inverse of the resolve. */
 export declare function fractionOf(zone: TimeZone, day: PlainDate, instant: Instant): number;

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

@@ -1,4 +1,4 @@
-export { isAllDay, type AllDayEvent, type CalendarEvent, type CalendarEventId, type CalendarView, type DragKind, type EventDraft, type EventPalette, type PaletteEntry, type TimedEvent, type VisibleRange, } from "./types";
+export { isAllDay, type AllDayEvent, type CalendarEvent, type CalendarEventId, type CalendarView, type DragKind, type EventDraft, type EventPalette, type PaletteEntry, type PaletteKey, type TimedEvent, type VisibleRange, } from "./types";
 export { packLanes, type LaneInput, type LaneOptions, type LanePlacement } from "./lane-packer";
 export { packBand, type BandInput, type BandOptions, type BandPlacement, type BandResult } from "./band-packer";
 export { allDayBandSegment, dayKey, daySlots, snapFractionToInstant, timeSegments, timedBandSegment, type BandSegment, type DaySlot, type TimeSegment, } from "./segments";

package/dist/types/lib/calendar/types.d.ts

@@ -138,10 +138,10 @@ export interface EventDraft {
  * So the palette is curated, each pair is measured, and a consumer supplying
  * arbitrary hex gets a documented refusal rather than an unreadable chip.
  */
+/** The eight swatch keys. Each one's spoken name is a built-in string (`calendar.colors`), so colour is never the only cue. */
+export type PaletteKey = "iris" | "aqua" | "mint" | "amber" | "rose" | "azure" | "orchid" | "slate";
 export interface PaletteEntry {
-    readonly key: string;
-    /** Human name, used in the accessible label so colour is never the only cue. */
-    readonly label: string;
+    readonly key: PaletteKey;
     readonly fill: string;
     readonly text: string;
     /** Border and left-edge accent; darker than `fill`, still AA against it. */

package/dist/types/lib/confidence.d.ts

@@ -19,5 +19,10 @@ export declare function confidenceLevel(rating: number, scale: number): Confiden
  * Each level's own word, the operator's scale (SG-843): 4 is "Confident" and 5
  * is "Highly confident", so the two readings of "fine" stay distinguishable in
  * words exactly as they are in colour and length.
+ *
+ * These are the ENGLISH words for a non-React consumer that cannot read the
+ * provider (the demand letter's Vue overlay bundles them, SG-901). Components
+ * read `confidenceBar.levels` from the provider, whose English set is this very
+ * object, so there is one place the English lives.
  */
 export declare const CONFIDENCE_LEVEL_LABELS: Readonly<Record<ConfidenceLevel, string>>;

package/dist/types/lib/dnd/announce.d.ts

@@ -15,6 +15,8 @@ export interface DragAnnouncementContext {
     containerLabel: string;
     /** 1-based, as spoken, in the WHOLE container — a windowed container reports its real offset and length (DX-4540). */
     position: number;
+    /** `position` written the way the active locale writes numbers (DX-4740): what a message prints. */
+    positionText: string;
     /**
      * The list length WITH the carried item counted in it, so `position` is never
      * "4 of 3". The session's own indices exclude the carried item — see the
@@ -22,33 +24,14 @@ export interface DragAnnouncementContext {
      * user a list is one shorter than the one they are looking at.
      */
     total: number;
+    /** `total` written the way the active locale writes numbers (DX-4740): what a message prints. */
+    totalText: string;
 }
-export interface DragStrings {
-    /** Rendered by `<DragInstructions>`; referenced by each handle's `aria-describedby`. */
-    instructions: string;
-    picked: (c: DragAnnouncementContext) => string;
-    moved: (c: DragAnnouncementContext) => string;
-    dropped: (c: DragAnnouncementContext) => string;
-    /** `moved`, for a card held over another container that takes it as a whole (`crossDrop: "lane"`): no position is spoken. */
-    movedToLane: (c: DragAnnouncementContext) => string;
-    /** `dropped`, for a card released over such a container. */
-    droppedInLane: (c: DragAnnouncementContext) => string;
-    /** Describes the item's ORIGINAL position — cancel is a restore, not a move. */
-    cancelled: (c: DragAnnouncementContext) => string;
-}
-/**
- * Exported as data so a consumer can read one message, override one message, or
- * assert on the set — a grammar hidden inside the component that renders it can
- * only be checked by rendering it.
- */
-export declare const DEFAULT_DRAG_STRINGS: DragStrings;
 export interface DragAnnouncementOptions {
     /** Human name for an item. Falls back to the id. */
     labelOf?: (id: DragId) => string;
     /** Human name for a container. Falls back to the id. */
     containerLabelOf?: (id: ContainerId) => string;
-    /** Override any subset of the grammar — localisation, or a domain noun. */
-    strings?: Partial<DragStrings>;
 }
 /**
  * One id for the whole page, deliberately not `useId()`.
@@ -117,7 +100,6 @@ export type DragLiveRegionProps = {
  */
 export declare function DragLiveRegion({ session, ...options }: DragLiveRegionProps): import("react").JSX.Element;
 export interface DragInstructionsProps {
-    strings?: Partial<DragStrings>;
     /**
      * The element id each handle's `aria-describedby` points at.
      *
@@ -139,4 +121,4 @@ export interface DragInstructionsProps {
  * of the rest of this file. Visually hidden because the same information is
  * carried for sighted users by the cursor and the moving card.
  */
-export declare function DragInstructions({ strings, id }?: DragInstructionsProps): import("react").JSX.Element;
+export declare function DragInstructions({ id }?: DragInstructionsProps): import("react").JSX.Element;

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

@@ -14,4 +14,4 @@ export { attachPointerSensor, attachSessionWindowListeners, type PointerActivati
 export { attachKeyboardSensor, type KeyboardSensorOptions, } from "./sensors/keyboard";
 export { attachAutoScroll, scrollVelocity, type AutoScrollOptions, } from "./autoscroll";
 export { DragSessionProvider, useCreateDragSession, useDragSession, useDragState, useDragLive, useDraggable, useDropContainer, type UseDraggableOptions, type UseDraggableResult, type UseDropContainerOptions, type UseDropContainerResult, } from "./use-drag";
-export { DEFAULT_DRAG_STRINGS, DRAG_INSTRUCTIONS_ID, DragInstructions, DragLiveRegion, useDragAnnouncements, type DragAnnouncementContext, type DragAnnouncementOptions, type DragAnnouncements, type DragInstructionsProps, type DragLiveRegionProps, type DragStrings, } from "./announce";
+export { DRAG_INSTRUCTIONS_ID, DragInstructions, DragLiveRegion, useDragAnnouncements, type DragAnnouncementContext, type DragAnnouncementOptions, type DragAnnouncements, type DragInstructionsProps, type DragLiveRegionProps, } from "./announce";

package/dist/types/lib/format.d.ts

@@ -1,32 +1,33 @@
 /** Binary units, because these are file sizes and every OS reports them this way. */
-export declare function formatBytes(bytes: number): string;
+export declare function formatBytes(bytes: number, locale: string): string;
 /**
- * 241_600 → "241.6k". A thin, token-domain-named wrapper — see
+ * 241_600 → "241.6K". A thin, token-domain-named wrapper — see
  * `formatCompactNumber` below for the shared algorithm and its own reasoning.
  * Kept as its own function (rather than every call site switching to the
  * generic one directly) because "tokens" is a real vocabulary word in this
  * package's chat components, and renaming every call site to the generic name
  * would cost real diff for zero behavioral gain.
  */
-export declare function formatTokens(tokens: number): string;
+export declare function formatTokens(tokens: number, locale: string): string;
 /**
- * A GENERIC large count, abbreviated the way a person reads it aloud:
- * `850` → `"850"`, `1_100` → `"1.1k"`, `3_400_000` → `"3.4M"`,
+ * A GENERIC large count, abbreviated the way the locale writes it: in en-US
+ * `850` → `"850"`, `1_100` → `"1.1K"`, `3_400_000` → `"3.4M"`,
  * `4_400_000_000` → `"4.4B"`. `null` / `undefined` / non-finite → `"—"`.
  *
- * One decimal per tier (k/M/B/T), trimmed of a trailing ".0" (`1_000_000` →
- * `"1M"`, not `"1.0M"`), and exact below 1,000 — a count small enough to read
- * digit-by-digit gets no abbreviation at all, since "850" is not improved by
- * becoming "0.9k". This is the same one-decimal-per-tier shape `formatTokens`
- * already used for a token budget; the difference that justified a SEPARATE,
- * generic export rather than just widening that one is scope: `formatTokens`
- * is a token-budget's own vocabulary (a live context meter), while this
- * function is for any large count a screen needs to abbreviate — a field
- * tally, a donut's fraction, a record count — with no token-specific meaning
- * attached to its name.
+ * DX-4740: THE SUFFIXES COME FROM `Intl` (`notation: "compact"`), NOT FROM A
+ * TABLE HERE. A hand-written T/B/M/k ladder is English: "B" for 10^9 reads as
+ * "billón" (10^12) to an es-AR reader, and every other language has its own
+ * words for thousand and million. en-US now writes an uppercase "K".
  *
- * NEGATIVE VALUES keep their sign (`-1_100` → `"-1.1k"`) rather than being
+ * One decimal at most, trimmed of a trailing ".0" (`1_000_000` → `"1M"`, not
+ * `"1.0M"`), and exact below 1,000 — a count small enough to read digit-by-digit
+ * gets no abbreviation at all, since "850" is not improved by becoming "0.9K".
+ * `formatTokens` is the token-budget's name for the same thing; this one is for
+ * any large count a screen needs to abbreviate — a field tally, a donut's
+ * fraction, a record count.
+ *
+ * NEGATIVE VALUES keep their sign (`-1_100` → `"-1.1K"`) rather than being
  * treated as absent — a generic count utility cannot assume its caller's
- * domain never has one, the way `formatTokens`'s own callers do.
+ * domain never has one.
  */
-export declare function formatCompactNumber(value: number | null | undefined): string;
+export declare function formatCompactNumber(value: number | null | undefined, locale: string): string;