@danxbot/ui 20.23.3 → 21.1.0

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

@@ -70,7 +70,7 @@ interface InlineEditFieldProps {
      * What the control shows in place of a blank value, and its
      * `aria-placeholder`.
      *
-     * @default "Empty"
+     * Omit for the built-in empty text.
      */
     placeholder?: string;
     /** Box ramp. Matches `Input`'s names. */
@@ -122,9 +122,9 @@ interface InlineEditFieldProps {
      * What is shown when the commit REJECTS (a thrown error or a rejected
      * promise — never a `{ refusal }`, which renders its own text).
      *
-     * @default "Could not save. Your text is still here — press <key> to try again.",
-     * where <key> is the key that commits in this configuration: Enter, or
-     * Ctrl+Enter for a `multiline` field without `autosaveMs`.
+     * Omit for the built-in sentence, which names the key that commits in this
+     * configuration: Enter, or Ctrl+Enter for a `multiline` field without
+     * `autosaveMs` (blur never re-attempts a failed value, DX-3372 review L1).
      */
     failureMessage?: string;
     /** The rejected error, handed on so it can be logged or reported. */

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

@@ -25,7 +25,7 @@ export interface InlineMarkdownEditProps extends EditActivation {
     editing: boolean;
     /** The accessible name of the field and of its editor. */
     label: string;
-    /** Shown at rest and in the editor when the value is empty. @default "Empty" */
+    /** Shown at rest and in the editor when the value is empty. Omit for the built-in text. */
     placeholder?: string;
     /** Collapse the rendered view to this many lines behind a `ReadMore`. */
     collapsedLines?: number;
@@ -55,7 +55,7 @@ export interface InlineMarkdownEditProps extends EditActivation {
      * What is shown when the commit REJECTS (never a `{ refusal }`, which
      * renders its own text).
      *
-     * @default "Could not save. Your text is still here — press Ctrl+Enter to try again."
+     * Omit for the built-in sentence, which names Ctrl+Enter as the retry key.
      */
     failureMessage?: string;
     /** The rejected error, handed on so it can be logged or reported. */

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

@@ -1,11 +1,5 @@
 import { type ReactNode } from "react";
 import type { PagedWindow } from "../lib/paged-window";
-export interface PagedWindowStrings {
-    /** Shown in a page whose request failed. */
-    error: string;
-    /** The retry button's label. */
-    retry: string;
-}
 export interface PagedWindowItemPosition {
     /** Position among the items currently shown, across every shown page. */
     local: number;
@@ -24,8 +18,6 @@ export interface PagedWindowListProps<T> {
      * arrive, so it only has to be close.
      */
     estimatedItemHeight: number;
-    /** Words in the failed-page row. */
-    strings?: Partial<PagedWindowStrings>;
     className?: string;
 }
-export declare function PagedWindowList<T>({ source, getKey, renderItem, estimatedItemHeight, strings, className, }: PagedWindowListProps<T>): import("react").JSX.Element;
+export declare function PagedWindowList<T>({ source, getKey, renderItem, estimatedItemHeight, className, }: PagedWindowListProps<T>): import("react").JSX.Element;

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

@@ -230,7 +230,7 @@ export interface ProgressProps extends VariantProps<typeof bar> {
     className?: string;
     ref?: Ref<HTMLDivElement>;
 }
-export declare function Progress({ value, label, format, showValue, size, tone, className, ref, }: ProgressProps): import("react").JSX.Element;
+export declare function Progress({ value, label, format: formatProp, showValue, size, tone, className, ref, }: ProgressProps): import("react").JSX.Element;
 export interface MeterProps extends VariantProps<typeof bar> {
     value: number;
     min?: number;
@@ -273,7 +273,7 @@ declare const ring: import("tailwind-variants").TVReturnType<{
          * Extracted-tab EXTRACTED/AUDITS/HUMAN VERIFIED/answer-key row) needs more
          * room than `lg` for a "count/total" fraction than a bare percentage ever
          * did — `lg` was sized for two digits, and a real fraction runs to eight
-         * or nine characters even compacted ("1.1k/1.5k"). `xl` is that room.
+         * or nine characters even compacted ("1.1K/1.5K"). `xl` is that room.
          */
         xl: "size-32";
     };
@@ -307,7 +307,7 @@ declare const ring: import("tailwind-variants").TVReturnType<{
          * Extracted-tab EXTRACTED/AUDITS/HUMAN VERIFIED/answer-key row) needs more
          * room than `lg` for a "count/total" fraction than a bare percentage ever
          * did — `lg` was sized for two digits, and a real fraction runs to eight
-         * or nine characters even compacted ("1.1k/1.5k"). `xl` is that room.
+         * or nine characters even compacted ("1.1K/1.5K"). `xl` is that room.
          */
         xl: "size-32";
     };
@@ -341,7 +341,7 @@ declare const ring: import("tailwind-variants").TVReturnType<{
          * Extracted-tab EXTRACTED/AUDITS/HUMAN VERIFIED/answer-key row) needs more
          * room than `lg` for a "count/total" fraction than a bare percentage ever
          * did — `lg` was sized for two digits, and a real fraction runs to eight
-         * or nine characters even compacted ("1.1k/1.5k"). `xl` is that room.
+         * or nine characters even compacted ("1.1K/1.5K"). `xl` is that room.
          */
         xl: "size-32";
     };

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

@@ -10,9 +10,9 @@ export interface ReadMoreProps {
     defaultExpanded?: boolean;
     /** Fires on every toggle, controlled or not. */
     onExpandedChange?: (expanded: boolean) => void;
-    /** @default "Read more" */
+    /** Absent, the built-in "Read more" word of the active `UiLocaleProvider`. */
     moreLabel?: string;
-    /** @default "Show less" */
+    /** Absent, the built-in "Show less" word of the active `UiLocaleProvider`. */
     lessLabel?: string;
     className?: string;
     ref?: Ref<HTMLDivElement>;

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

@@ -41,7 +41,7 @@ export interface SecretFieldProps extends Pick<FieldProps, "label" | "descriptio
      * never rendered while there is no typed text to reveal.
      */
     revealable?: boolean;
-    /** Label on the destructive confirm button. Default "Clear". */
+    /** Label on the destructive confirm button. Absent, the built-in "Clear" word of the active `UiLocaleProvider`. */
     clearConfirmLabel?: string;
     ref?: Ref<HTMLInputElement>;
 }

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

@@ -227,5 +227,5 @@ export interface SliderProps extends Omit<VariantProps<typeof slider>, "disabled
     className?: string;
     ref?: Ref<HTMLDivElement>;
 }
-export declare function Slider({ value, defaultValue, onValueChange, onValueCommitted, min, max, step, minStepsBetweenValues, thumbCollision, meetingThumbs, thumbLabels, thumbMarkers, label, format, showValue, marks, tooltip, size, tone, disabled, className, ref, }: SliderProps): import("react").JSX.Element;
+export declare function Slider({ value, defaultValue, onValueChange, onValueCommitted, min, max, step, minStepsBetweenValues, thumbCollision, meetingThumbs, thumbLabels, thumbMarkers, label, format: formatProp, showValue, marks, tooltip, size, tone, disabled, className, ref, }: SliderProps): import("react").JSX.Element;
 export {};

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

@@ -8,7 +8,7 @@ export interface SortOption<Field extends string = string> {
     /**
      * What each direction means for THIS field, in the words that fit it
      * ("A to Z" / "Z to A", "Oldest first" / "Newest first"). Absent, the
-     * directions read "Ascending" / "Descending". It names the arrows to
+     * directions read the built-in "Ascending" / "Descending" words of the active `UiLocaleProvider`. It names the arrows to
      * assistive technology and appears in their tooltips, so a person is never
      * left decoding which way an arrow sorts a date.
      */

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

@@ -91,7 +91,7 @@ export interface StatProps extends VariantProps<typeof stat> {
     value: ReactNode;
     /** Rendered smaller, beside the value — "ms", "/min", "GB". */
     unit?: ReactNode;
-    /** The change itself — "12%", "+1.2k". */
+    /** The change itself — "12%", "+1.2K". */
     delta?: ReactNode;
     trend?: StatTrend;
     /** Whether that movement is good. Independent of direction, on purpose. */

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

@@ -58,7 +58,7 @@ export interface StatusSelectProps<Value extends string = string> {
      * always a mistake somewhere, so this is the wording of the report rather
      * than a label anyone should be seeing.
      *
-     * Defaults to "Unknown". It is NOT the raw value: see the component body.
+     * Absent, the built-in "Unknown" word of the active `UiLocaleProvider`. It is NOT the raw value: see the component body.
      */
     placeholder?: ReactNode;
     className?: string;

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

@@ -52,12 +52,6 @@ export interface TriStateSwitchProps {
     onValueChange: (value: boolean | null) => void;
     /** The question being answered — the group's accessible name. Required. */
     "aria-label": string;
-    /** The words for each stop, read aloud and shown in the caption. */
-    labels?: {
-        yes?: string;
-        no?: string;
-        unset?: string;
-    };
     /** Shows the current state's word beside the track. @default true */
     showCaption?: boolean;
     disabled?: boolean;
@@ -65,5 +59,5 @@ export interface TriStateSwitchProps {
     size?: TriStateSwitchSize;
     className?: string;
 }
-export declare function TriStateSwitch({ value, onValueChange, "aria-label": ariaLabel, labels, showCaption, disabled, size, className, }: TriStateSwitchProps): import("react").JSX.Element;
+export declare function TriStateSwitch({ value, onValueChange, "aria-label": ariaLabel, showCaption, disabled, size, className, }: TriStateSwitchProps): import("react").JSX.Element;
 export {};

package/dist/types/components/board/context.d.ts

@@ -1,4 +1,4 @@
-import type { BoardColumnId, BoardColumnModel, BoardItemId, BoardMoveRequest, BoardMoveVerdict, BoardReorderLabels } from "../../lib/board";
+import type { BoardColumnId, BoardColumnModel, BoardItemId, BoardMoveRequest, BoardMoveOutcome, BoardReorderLabels } from "../../lib/board";
 import type { CrossDrop } from "../../lib/dnd";
 export declare const BoardCardSurfaceContext: import("react").Context<boolean>;
 /** `true` when an ancestor `BoardCardSurface` makes this whole card draggable. */
@@ -21,14 +21,12 @@ export interface BoardContextValue<T> {
      * never fails silently" true of every source by construction, not by
      * convention.
      */
-    requestMove: (request: BoardMoveRequest) => BoardMoveVerdict;
+    requestMove: (request: BoardMoveRequest) => BoardMoveOutcome;
     /** The words for the card menu's within-column items (`Board`'s `reorderLabels`). */
     reorderLabels: BoardReorderLabels;
     /** What a card dropped on another lane means — `Board`'s `crossLaneDrop`. */
     crossLaneDrop: CrossDrop;
 }
-/** What the menu says when `Board` is given no `reorderLabels`. */
-export declare const DEFAULT_REORDER_LABELS: BoardReorderLabels;
 export interface BoardColumnContextValue {
     columnId: BoardColumnId;
     label: string;

package/dist/types/components/calendar/CalendarMonth.d.ts

@@ -21,13 +21,12 @@ export interface CalendarMonthProps {
      * See `packBand`; the affordance is counted so it cannot be drawn over an event.
      */
     maxEventRows?: number;
-    locale?: string;
     /** Replace a chip's contents. The chip itself — button, label, colour — stays ours. */
     renderEvent?: (event: CalendarEvent) => ReactNode;
     className?: string;
-    /** Accessible name for the grid. */
+    /** Accessible name for the grid. Omit for the built-in one. */
     label?: string;
 }
-export declare function CalendarMonth({ month: monthProp, zone, events, weekStartsOn, today, selectedDate, onSelectDate, onSelectEvent, onMonthChange, maxEventRows, locale, renderEvent, className, label, }: CalendarMonthProps): import("react").JSX.Element;
+export declare function CalendarMonth({ month: monthProp, zone, events, weekStartsOn, today, selectedDate, onSelectDate, onSelectEvent, onMonthChange, maxEventRows, renderEvent, className, label, }: CalendarMonthProps): import("react").JSX.Element;
 /** The first day of the month `date` falls in — re-exported for consumers paging. */
 export { startOfMonth, addDays };

package/dist/types/components/calendar/CalendarTimeGrid.d.ts

@@ -67,9 +67,8 @@ export interface CalendarTimeGridProps {
      * same three outcomes: a new day, a new start, a new length.
      */
     eventActions?: boolean;
-    locale?: string;
     renderEvent?: (event: CalendarEvent) => ReactNode;
     className?: string;
     label?: string;
 }
-export declare function CalendarTimeGrid({ days, zone, events, today, onSelectEvent, slotMinutes, slotHeightPx, scrollToHour, maxAllDayRows, maxLanes, overlapMode, nowInstant, snapMinutes, onEventChange, onCreate, onAnnounce, eventActions, locale, renderEvent, className, label, }: CalendarTimeGridProps): import("react").JSX.Element;
+export declare function CalendarTimeGrid({ days, zone, events, today, onSelectEvent, slotMinutes, slotHeightPx, scrollToHour, maxAllDayRows, maxLanes, overlapMode, nowInstant, snapMinutes, onEventChange, onCreate, onAnnounce, eventActions, renderEvent, className, label, }: CalendarTimeGridProps): import("react").JSX.Element;

package/dist/types/components/calendar/EventActions.d.ts

@@ -11,7 +11,6 @@ export interface EventActionsProps {
     maxDurationMinutes?: number;
     onApply: (next: TimedEvent) => void;
     onClose?: () => void;
-    locale?: string;
     className?: string;
 }
-export declare function EventActions({ event, zone, days, snapMinutes, maxDurationMinutes, onApply, onClose, locale, className, }: EventActionsProps): import("react").JSX.Element;
+export declare function EventActions({ event, zone, days, snapMinutes, maxDurationMinutes, onApply, onClose, className, }: EventActionsProps): import("react").JSX.Element;

package/dist/types/components/calendar/format.d.ts

@@ -1,17 +1,18 @@
 import { type Instant, type PlainDate, type TimeZone } from "@/lib/time";
 import type { CalendarEvent } from "@/lib/calendar/types";
+import type { CalendarStrings } from "@/lib/i18n/areas/dates";
 /** `Monday` / `Mon` / `M`, in the viewer's locale. */
-export declare function weekdayName(date: PlainDate, width: "long" | "short" | "narrow", locale?: string): string;
+export declare function weekdayName(date: PlainDate, width: "long" | "short" | "narrow", locale: string): string;
 /** `15` — the number in the cell. */
-export declare function dayNumber(date: PlainDate, locale?: string): string;
+export declare function dayNumber(date: PlainDate, locale: string): string;
 /** `June 2026` — the view's title. */
-export declare function monthTitle(date: PlainDate, locale?: string): string;
+export declare function monthTitle(date: PlainDate, locale: string): string;
 /** `Monday, 15 June 2026` — a cell's accessible name starts with this. */
-export declare function longDate(date: PlainDate, locale?: string): string;
+export declare function longDate(date: PlainDate, locale: string): string;
 /** `9:30 AM` in the calendar's zone — never the host's. */
-export declare function timeOfDay(instant: Instant, zone: TimeZone, locale?: string, withMinutes?: boolean): string;
+export declare function timeOfDay(instant: Instant, zone: TimeZone, locale: string, withMinutes?: boolean): string;
 /** `GMT−6` — the label above the hour gutter. */
-export declare function zoneLabel(zone: TimeZone, at: Instant, locale?: string): string;
+export declare function zoneLabel(zone: TimeZone, at: Instant, locale: string): string;
 /**
  * The human range of an event: `15–17 June`, `9:30 – 10:30 AM`, `All day`.
  *
@@ -21,7 +22,7 @@ export declare function zoneLabel(zone: TimeZone, at: Instant, locale?: string):
  * most-reported bug in calendar interoperability, so it happens once, here,
  * where a test can point at it.
  */
-export declare function formatDateRange(event: CalendarEvent, zone: TimeZone, locale?: string): string;
+export declare function formatDateRange(event: CalendarEvent, zone: TimeZone, locale: string, strings: CalendarStrings): string;
 /**
  * A cell's accessible name: `Monday, 15 June 2026, 3 events`.
  *
@@ -30,7 +31,7 @@ export declare function formatDateRange(event: CalendarEvent, zone: TimeZone, lo
  * is empty. Arrowing across a month hearing "14. 15. 16." tells them nothing
  * about where the work is.
  */
-export declare function cellLabel(date: PlainDate, eventCount: number, locale?: string): string;
+export declare function cellLabel(date: PlainDate, eventCount: number, locale: string, strings: CalendarStrings): string;
 /**
  * An event chip's accessible name.
  *
@@ -38,4 +39,4 @@ export declare function cellLabel(date: PlainDate, eventCount: number, locale?:
  * two identically-titled events on different calendars are distinguishable
  * without seeing the colour.
  */
-export declare function eventLabel(event: CalendarEvent, zone: TimeZone, paletteLabel: string | undefined, locale?: string): string;
+export declare function eventLabel(event: CalendarEvent, zone: TimeZone, paletteLabel: string | undefined, locale: string, strings: CalendarStrings): string;

package/dist/types/components/calendar/use-calendar-drag.d.ts

@@ -17,7 +17,6 @@ export interface CalendarDragOptions {
     }) => void;
     /** Fired on every committed slot change, for the live region. */
     readonly onAnnounce?: (message: string) => void;
-    readonly locale?: string;
     readonly disabled?: boolean;
 }
 export interface CalendarDragState {

package/dist/types/components/calendar/use-event-keyboard.d.ts

@@ -9,7 +9,6 @@ export interface EventKeyboardOptions {
     readonly days: readonly PlainDate[];
     readonly onCommit: (event: TimedEvent, next: TimedEvent) => void;
     readonly onAnnounce?: (message: string) => void;
-    readonly locale?: string;
 }
 export interface EventKeyboardState {
     /** The event currently held, or null. */

package/dist/types/components/chart/BarList.d.ts

@@ -24,4 +24,4 @@ export interface BarListProps {
     className?: string;
     ref?: Ref<HTMLUListElement>;
 }
-export declare function BarList({ items, label, maxItems, formatValue, className, ref }: BarListProps): import("react").JSX.Element;
+export declare function BarList({ items, label, maxItems, formatValue: formatCaller, className, ref }: BarListProps): import("react").JSX.Element;

package/dist/types/components/chart/ShareBar.d.ts

@@ -17,4 +17,4 @@ export interface ShareBarProps {
     className?: string;
     ref?: Ref<HTMLDivElement>;
 }
-export declare function ShareBar({ segments, label, formatValue, className, ref }: ShareBarProps): import("react").JSX.Element;
+export declare function ShareBar({ segments, label, formatValue: formatCaller, className, ref }: ShareBarProps): import("react").JSX.Element;

package/dist/types/components/chart/TimeSeriesChart.d.ts

@@ -44,17 +44,15 @@ export interface TimeSeriesChartProps {
     formatValue?: (value: number) => string;
     /** How a value reads on the y axis; use a compact form here. @default `formatValue` */
     formatAxis?: (value: number) => string;
-    /** Locale of the time labels. @default the viewer's */
-    locale?: string;
     /** IANA zone the buckets are labelled in, e.g. "UTC". @default the viewer's */
     timeZone?: string;
     /** Called with a member series' key when its band or its legend name is clicked. */
     onSelectSeries?: (key: string) => void;
     /** Plot height in px. @default 240 */
     height?: number;
-    /** Said when there is nothing to draw. @default "No data" */
+    /** Said when there is nothing to draw. @default the built-in "No data" */
     emptyLabel?: string;
-    /** Said over the axis when every value is zero. @default "All values are zero" */
+    /** Said over the axis when every value is zero. @default the built-in "All values are zero" */
     zeroLabel?: string;
     className?: string;
     ref?: Ref<HTMLDivElement>;

package/dist/types/components/chart/shared.d.ts

@@ -18,9 +18,9 @@ export declare function assertChartData(component: string, data: readonly ChartD
  * (`4.5%`), and `<1%` for a real but tiny share so a nonzero segment is never
  * printed as `0%`. A zero total reads `0%`, never `NaN%`.
  */
-export declare function formatShare(fraction: number): string;
+export declare function formatShare(fraction: number, locale: string): string;
 /** The default way a raw value reads. Callers pass `formatValue` for units. */
-export declare function defaultFormatValue(value: number): string;
+export declare function defaultFormatValue(value: number, locale: string): string;
 /**
  * A tooltip a keyboard and a finger can reach. Base UI opens its tooltip on
  * hover and on KEYBOARD focus only — a tap or a programmatic focus never

package/dist/types/components/chart/time-series-scale.d.ts

@@ -24,6 +24,6 @@ export interface TimeFormatters {
  * its date; a month or wider by month and year. `timeZone` is passed straight
  * to `Intl` (an unknown zone throws, loudly); undefined is the viewer's own.
  */
-export declare function timeFormatters(bucketMs: number, locale: string | undefined, timeZone: string | undefined): TimeFormatters;
+export declare function timeFormatters(bucketMs: number, locale: string, timeZone: string | undefined): TimeFormatters;
 /** The index of the bucket whose span `[start, start + bucketMs)` holds `at`, or -1. */
 export declare function bucketIndexAt(buckets: readonly number[], bucketMs: number, at: number): number;

package/dist/types/components/chat/EffortControl.d.ts

@@ -6,8 +6,8 @@ export interface EffortLevel {
     /** One line explaining the trade at this stop. */
     description?: ReactNode;
 }
-export declare const DEFAULT_EFFORT_LEVELS: EffortLevel[];
 export interface EffortControlProps {
+    /** The scale, lowest first. @default the built-in five-step scale */
     levels?: EffortLevel[];
     value: string;
     onValueChange: (id: string) => void;
@@ -20,4 +20,4 @@ export interface EffortControlProps {
     disabled?: boolean;
     className?: string;
 }
-export declare function EffortControl({ levels, value, onValueChange, help, inline, side, align, disabled, className, }: EffortControlProps): import("react").JSX.Element;
+export declare function EffortControl({ levels: levelsProp, value, onValueChange, help, inline, side, align, disabled, className, }: EffortControlProps): import("react").JSX.Element;

package/dist/types/components/chat/MessageScroller.d.ts

@@ -3,7 +3,7 @@ export interface MessageScrollerProps {
     children: ReactNode;
     /** Distance from the bottom, in px, still counted as "at the bottom". */
     threshold?: number;
-    /** Label for the return-to-newest button. */
+    /** Label for the return-to-newest button. @default the built-in "Jump to latest" */
     jumpLabel?: string;
     /** Fades content at the top edge so it reads as continuing past the frame. */
     fade?: boolean;

package/dist/types/components/checklist/StatusChecklist.d.ts

@@ -27,7 +27,7 @@ export interface StatusChecklistProps<Key extends string = string> {
      * information the consumer put in deliberately.
      */
     order?: "state" | "given";
-    /** Shown when `items` is empty. `EmptyState` supplies the shape. */
+    /** Shown when `items` is empty (absent means the provider's own words). `EmptyState` supplies the shape. */
     emptyTitle?: ReactNode;
     emptyDescription?: ReactNode;
     emptyAction?: ReactNode;

package/dist/types/components/edit/outcome.d.ts

@@ -10,18 +10,6 @@ export type EditOutcome = void | EditRefusal;
 export type EditCommit = (value: string, base: string) => EditOutcome | Promise<EditOutcome>;
 export declare function isRefusal(outcome: EditOutcome): outcome is EditRefusal;
 export declare function isPromise(outcome: EditOutcome | Promise<EditOutcome>): outcome is Promise<EditOutcome>;
-/**
- * The key that retries a failed save in a given field: Enter where Enter
- * commits, Ctrl+Enter where Enter inserts a newline. (Both fields accept
- * Cmd+Enter as well as Ctrl+Enter, so "Ctrl+Enter" is true on every platform.)
- */
-export type RetryKey = "Enter" | "Ctrl+Enter";
-/**
- * The default failure message. It names the retry key because blur never
- * re-attempts a failed value — DX-3372 review L1: the single shared sentence
- * said "press Enter" in fields where Enter inserts a newline.
- */
-export declare function defaultFailureMessage(retryKey: RetryKey): string;
 /**
  * A refusal nobody can read leaves the field open with nothing beside it — the
  * exact silent failure the outcome contract exists to rule out — so an empty

package/dist/types/components/file-viewer/frames.d.ts

@@ -1,3 +1,4 @@
+import type { UiStrings } from "../../lib/i18n";
 import type { ViewerFile, ViewerFrame } from "./types";
 /** Where the reader is. The ids are the truth; `index` only says where to land
     when both have vanished (the nearest position). */
@@ -24,4 +25,4 @@ export interface Start {
  */
 export declare function startFrame(frames: readonly ViewerFrame[], start: Start): ViewerFrame | null;
 /** The frame's name, for a screen reader and for an alt attribute. */
-export declare function frameLabel(frame: ViewerFrame): string;
+export declare function frameLabel(frame: ViewerFrame, strings: UiStrings["fileViewer"], fmt: (n: number) => string): string;

package/dist/types/components/kanban/KanbanBoard.d.ts

@@ -1,6 +1,5 @@
 import { type ReactNode } from "react";
 import type { DragSessionCallbacks } from "../../lib/dnd";
-import { type DragDropProps } from "../DragDrop";
 import type { KanbanLane, KanbanMove, KanbanRefusal } from "./types";
 export type { KanbanLane, KanbanMove, KanbanRefusal };
 export interface KanbanBoardProps<T> extends Omit<DragSessionCallbacks, "onDragEnd"> {
@@ -39,26 +38,8 @@ export interface KanbanBoardProps<T> extends Omit<DragSessionCallbacks, "onDragE
     onMove: (move: KanbanMove) => void;
     /** Called INSTEAD of `onMove` when the destination lane carries a `refusal`. */
     onRefuse?: (refusal: KanbanRefusal) => void;
-    /** Shown in a lane with no cards. */
+    /** Shown in a lane with no cards. Omitted, the provider's `kanban.empty`. */
     emptyLane?: ReactNode;
-    /**
-     * Override any part of the announcement grammar — `DragDrop.strings`, reached
-     * through the board.
-     *
-     * IT WAS UNREACHABLE, and the omission had a symptom. The default sentence is
-     * `… Position 1 of 4 in ${containerLabel}`, which reads correctly right up
-     * until a lane is called "In review" and a screen reader says "in In review".
-     * That is a property of the lane's NAME rather than of the template, so there
-     * is no template this component could ship that is right for every board —
-     * which is precisely why the engine exposes the grammar, and precisely why a
-     * board that swallowed the prop left its consumer with no way out of a
-     * sentence they could hear was wrong. Rename the lane, or write the sentence:
-     *
-     * ```tsx
-     * strings={{ picked: (c) => `Picked up ${c.label}, ${c.containerLabel} column.` }}
-     * ```
-     */
-    strings?: DragDropProps["strings"];
     /**
      * Fill the space between the board's own top and the bottom of whatever
      * scrolls it, so the lanes are the only thing that scrolls down.
@@ -88,4 +69,4 @@ export interface KanbanBoardProps<T> extends Omit<DragSessionCallbacks, "onDragE
     fill?: boolean;
     className?: string;
 }
-export declare function KanbanBoard<T>({ label, lanes, getItemId, itemLabel, renderItem, renderDragging, onMove, onRefuse, emptyLane, strings, fill, className, ...callbacks }: KanbanBoardProps<T>): import("react").JSX.Element;
+export declare function KanbanBoard<T>({ label, lanes, getItemId, itemLabel, renderItem, renderDragging, onMove, onRefuse, emptyLane, fill, className, ...callbacks }: KanbanBoardProps<T>): import("react").JSX.Element;

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

@@ -50,6 +50,6 @@ export interface KanbanMove {
 export interface KanbanRefusal {
     id: string;
     lane: string;
-    /** Verbatim from the lane's `refusal`. */
+    /** The sentence shown: the lane's `refusal` verbatim, or the provider's `moveRejected` wording of the core's refusal. */
     reason: string;
 }

package/dist/types/components/markdown/Affordances.d.ts

@@ -1,3 +1,4 @@
+import { type UiStrings } from "../../lib/i18n";
 import { type BlockInfo, type BlockKind, type ConstructInfo, type InlineMark } from "../../lib/markdown/convert";
 import { type Command } from "../../lib/markdown/commands";
 import type { MarkdownSurface } from "../../lib/markdown/surface";
@@ -30,7 +31,8 @@ export declare function useEditorState(surface: MarkdownSurface | null, version:
 interface TypeChoice {
     kind: BlockKind;
     level?: number;
-    label: string;
+    /** Which of the active provider's `markdownAffordances.blockTypes` words names this choice. */
+    name: keyof UiStrings["markdownAffordances"]["blockTypes"];
     icon: string;
 }
 export interface LineHandleProps {

package/dist/types/components/openapi/resolve.d.ts

@@ -33,15 +33,19 @@ export declare function resolveSchema(doc: Pick<OpenApiDocument, "components">,
  * more specifically, never withdrawing it.
  */
 export declare function mergedParameters(pathParameters: readonly OpenApiParameter[], operationParameters: readonly OpenApiParameter[] | undefined): OpenApiParameter[];
+/** The one word `groupOperations` needs; the viewer passes `useUiStrings().openApiViewer`. */
+export interface GroupOperationsStrings {
+    untaggedGroup: string;
+}
 /**
  * Groups every operation by tag, falling back to the first path segment ONLY
  * when the document declares no tag on any operation at all — a document
  * that tags SOME operations and not others puts the untagged remainder in
- * "Other" rather than silently switching the whole document to path-based
+ * `strings.untaggedGroup` rather than silently switching the whole document to path-based
  * grouping, so a partially-tagged spec still reads as "the author meant to
- * group by tag".
+ * group by tag". Groups are ordered the way `locale` sorts their names (DX-4740).
  */
-export declare function groupOperations(doc: OpenApiDocument): OperationGroup[];
+export declare function groupOperations(doc: OpenApiDocument, strings: GroupOperationsStrings, locale: string): OperationGroup[];
 /**
  * Every operation of the document's top-level `webhooks` (DX-4178), in
  * document order, each carrying its webhook NAME as `path` and `webhook:

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

@@ -120,7 +120,8 @@ export interface OperationGroup {
     /** The tag name, or — when the document declares no tags at all on the
      * operations it carries — the first non-empty path segment (`resolve.ts`).
      * Never both in the same document: a document that tags ANY operation is
-     * grouped by tag, with untagged operations falling into `"Other"`. */
+     * grouped by tag, with untagged operations falling into the group the
+     * provider names (`openApiViewer.untaggedGroup`). */
     readonly name: string;
     readonly description?: string;
     readonly operations: readonly ResolvedOperation[];

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

@@ -107,7 +107,7 @@ export interface ConfidenceBarProps {
      * What the rating is OF, used verbatim at the head of the accessible name and
      * the tooltip: `"<label> 3 of 5"`.
      *
-     * @default "Confidence"
+     * Absent means the provider's own word for it.
      */
     label?: string;
     /** @default "sm" */

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

@@ -2,13 +2,13 @@ import type { ProvenanceConfidence } from "./types";
 export interface ConfidenceReadoutProps {
     confidence: ProvenanceConfidence | null;
     /**
-     * What to say when nothing scored it.
+     * What to say when nothing scored it. Absent means the provider's own words.
      *
      * Text rather than an empty bar, because a bar at zero and a bar with nothing
      * to show look identical and mean opposite things.
      */
     unscoredLabel?: string;
-    /** What a RATING is of, at the head of its accessible name. @default "Confidence" */
+    /** What a RATING is of, at the head of its accessible name. Absent means the provider's own word. */
     ratingLabel?: string;
     /** Hides the band name on a SCORE, for dense rows where the bar is enough. */
     compact?: boolean;

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

@@ -1,3 +1,4 @@
+import { type UiStrings } from "../../lib/i18n";
 import type { ProvenanceState } from "./types";
 /** How much of the state the badge draws. The accessible name is the same either way. */
 export type ProvenanceBadgeAppearance = "word" | "icon";
@@ -17,6 +18,6 @@ export interface ProvenanceBadgeProps {
     className?: string;
 }
 export declare function ProvenanceBadge({ state, alwaysShow, appearance, size, className, }: ProvenanceBadgeProps): import("react").JSX.Element | null;
-/** The words this library uses for each state. Exported so a consumer's own
-    filters and legends read the same as its badges. */
-export declare function provenanceStateLabel(state: ProvenanceState): string;
+/** The words this library uses for each state, from the provider's strings. Exported so a
+    consumer's own filters and legends read the same as its badges. */
+export declare function provenanceStateLabel(state: ProvenanceState, strings: UiStrings["provenanceBadge"]): string;

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

@@ -14,9 +14,9 @@ export interface ProvenanceDetailProps {
      * audit trail — none of which this library can name.
      */
     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. */
+    /** Shown in place of the value when the viewer may not see it. Absent means the provider's own words. */
     redactedLabel?: string;
     /**
      * YOUR word for what a discrete rating is a rating OF — "Self-rated
@@ -24,12 +24,10 @@ export interface ProvenanceDetailProps {
      * tooltip.
      *
      * A rating is drawn as a coloured bar with no words on its face, so this is
-     * the only place its meaning is stated to a reader who stops on it. The
-     * library's own default is the blandest true word, because a default naming
+     * the only place its meaning is stated to a reader who stops on it. Absent
+     * means the provider's own word, the blandest true one, because a default naming
      * anybody's domain would be a lie in everybody else's. Ignored for a
      * continuous score, which says its own band aloud.
-     *
-     * @default "Confidence"
      */
     ratingLabel?: string;
     /**