prime-ui-kit 0.15.0 → 0.17.0

package/dist/components/button-group/ButtonGroup.d.ts

@@ -6,20 +6,39 @@ export type ButtonGroupLabels = {
     /** Muted marker after the label when `optional`. */
     optional: string;
 };
-export type ButtonGroupRootProps = Omit<FieldRootDomProps, "dir"> & Omit<FieldFrameProps, "focusRing"> & {
+export declare const BUTTON_GROUP_LABELS: ButtonGroupLabels;
+export type ButtonGroupRootProps = Omit<FieldRootDomProps, "dir"> & FieldFrameProps & {
+    /**
+     * Direction of the segments; `vertical` stretches them to the widest.
+     */
     orientation?: ButtonGroupOrientation;
-    /** Tier. Default: the tier of the surrounding control (a toolbar, a panel), else `m`. */
+    /**
+     * Control tier of every segment: height 28 · 32 · 36 · 40 · 48, padding, text, icon. Without it the tier of its host (a toolbar, a panel), else `m`.
+     */
     size?: ControlSize;
-    /** Stretch the group to its container; horizontal segments share the width equally. */
+    /**
+     * Stretches the group; horizontal segments tend to equal widths but never get narrower than their label (the row scrolls instead).
+     */
     fullWidth?: boolean;
-    /** Invalid state: a danger ring on every segment and `aria-invalid` on the group. */
+    /**
+     * Danger inset ring, `aria-invalid` and `data-invalid` on the `group`; the control shakes once when an error arrives.
+     */
     invalid?: boolean;
-    /** Always render the support row so an appearing error does not shift the layout. */
+    /**
+     * Always render the support row, so an appearing error does not shift the layout.
+     */
     reserveSupportRow?: boolean;
-    /** Id of the `role="group"` element; generated when omitted. */
+    /**
+     * Id of the `group` element (generated when omitted); hint id is `<id>-hint`, error id `<id>-error`.
+     */
     id?: string;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<ButtonGroupLabels>;
-    /** `ButtonGroup.Item` segments. */
+    /**
+     * `ButtonGroup.Item` segments.
+     */
     children?: React.ReactNode;
 };
 /**
@@ -31,7 +50,9 @@ declare namespace ButtonGroupRoot {
     var displayName: string;
 }
 export type ButtonGroupItemProps = React.ButtonHTMLAttributes<HTMLButtonElement> & {
-    /** Toggle state of the segment: `aria-pressed` and `data-state="active" | "inactive"`. */
+    /**
+     * Toggle state: `aria-pressed` and `data-state="active" | "inactive"`. Leave it out for a plain action segment.
+     */
     pressed?: boolean;
     ref?: React.Ref<HTMLButtonElement>;
 };
@@ -40,6 +61,9 @@ declare namespace ButtonGroupItem {
     var displayName: string;
 }
 export type ButtonGroupIconProps = Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> & {
+    /**
+     * The icon, e.g. `<Icon name="action.copy" />`.
+     */
     children: React.ReactNode;
     ref?: React.Ref<HTMLSpanElement>;
 };

package/dist/components/card/Card.d.ts

@@ -8,14 +8,16 @@ type SpanProps = React.HTMLAttributes<HTMLSpanElement> & {
 };
 export type CardVariant = "panel" | "mini" | "stat-trend" | "split" | "cta" | "list" | "cover";
 export type CardRootProps = DivProps & {
-    /** Structural template: KPI tiles, lists, CTA, split, cover and titled panels. Default `panel`. */
+    /**
+     * Structural template: titled block with zones (`panel`), KPI tiles, a call to action, a list or a cover tile.
+     */
     variant?: CardVariant;
-    /** No raised shadow: a flat tile on the page (dense grids where shadows add noise). */
+    /**
+     * No raised shadow: a flat tile for dense grids.
+     */
     flat?: boolean;
     /**
-     * The whole card is one link or button: pass that element as the only child and the card's
-     * parts inside it. It lifts on hover, presses and shows the focus ring. Nothing interactive
-     * may sit inside it.
+     * The whole card is one link or button: pass that element as the only child with the parts inside it; it gets hover, press and the focus ring. Nothing interactive may sit inside it.
      */
     asChild?: boolean;
 };
@@ -31,7 +33,9 @@ declare namespace CardHeader {
 }
 export type CardHeadingLevel = "h2" | "h3" | "h4";
 export type CardTitleProps = React.HTMLAttributes<HTMLHeadingElement> & {
-    /** Heading level that fits the page outline (the look does not change). */
+    /**
+     * Heading level that fits the page outline; the look does not change.
+     */
     as?: CardHeadingLevel;
     ref?: React.Ref<HTMLHeadingElement>;
 };
@@ -58,13 +62,13 @@ declare namespace CardMedia {
     var displayName: string;
 }
 export type CardFooterProps = DivProps;
-/** The bottom row of buttons. */
+/** The bottom row of buttons: under a hairline in the zoned templates and in `cta`. */
 declare function CardFooter({ className, ...rest }: CardFooterProps): import("react/jsx-runtime").JSX.Element;
 declare namespace CardFooter {
     var displayName: string;
 }
 export type CardIconProps = DivProps;
-/** The 40px accent tile of a KPI; holds one icon. */
+/** The accent icon tile of a KPI; holds one icon. */
 declare function CardIcon({ className, ...rest }: CardIconProps): import("react/jsx-runtime").JSX.Element;
 declare namespace CardIcon {
     var displayName: string;
@@ -80,7 +84,9 @@ declare namespace CardValue {
     var displayName: string;
 }
 export type CardDeltaProps = SpanProps & {
-    /** Color of the change: `success` — good, `danger` — bad, `neutral` (default). Independent of the sign. */
+    /**
+     * Delta: color by meaning, not by sign (churn up is `danger`).
+     */
     tone?: Extract<Tone, "neutral" | "success" | "warning" | "danger">;
 };
 declare function CardDelta({ className, tone, ...rest }: CardDeltaProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/chart-frame/ChartFrame.d.ts

@@ -34,6 +34,13 @@ export type ChartFramePlotArea = {
     height: number;
     series: ChartFramePlotSeries[];
 };
+/** One point of the chart's data: a row of the table the root gives assistive tech. */
+export type ChartFrameRow = {
+    /** The point the row stands for («Неделя 41»): the row header. */
+    label: string;
+    /** Values by series id; a missing value reads as «—». */
+    values: Record<string, number | undefined>;
+};
 export type ChartFrameLabels = {
     /** Title of the empty state. */
     empty: string;
@@ -43,41 +50,57 @@ export type ChartFrameLabels = {
     retry: string;
     /** Accessible name of the legend. */
     legend: string;
-    /** Header of the first column of `ChartFrame.Table` (what a row is). */
+    /** Header of the first column of the data table (what a row is). */
     category: string;
 };
+export declare const CHART_FRAME_LABELS: ChartFrameLabels;
 export type ChartFrameRootProps = React.HTMLAttributes<HTMLElement> & {
     /**
-     * What the chart region shows. `loading` — Skeletons in the geometry of the value, the plot and
-     * the legend values; `empty` — the empty state in the plot's place; `error` — the load error with
-     * a retry button (`onRetry`). Every change cross-fades. Default `ready`.
+     * What the chart region shows: the plot, Skeletons while `loading`, the empty state, or the load error with a retry (`onRetry`). Changes cross-fade at the same height.
      */
     state?: ChartFrameState;
-    /** The series in drawing order: the legend, tooltip rows, table columns and plot colors. */
+    /**
+     * The series in drawing order, `{ id, label, color?, value? }`: legend entries, tooltip rows, table columns and `renderPlot` colors. `color` is a palette hue; `value` is the legend summary.
+     */
     series?: ChartFrameSeries[];
-    /** Ids of the series turned off in the legend (controlled). */
+    /**
+     * The chart's data, `{ label, values }` per point (`values` by series id, a missing one reads as «—»): a visually hidden table for screen readers in the `ready` state.
+     */
+    rows: ChartFrameRow[];
+    /**
+     * Ids of the series turned off in the legend (controlled).
+     */
     hiddenSeries?: string[];
-    /** Initially hidden series (uncontrolled). Default none. */
+    /**
+     * Initially hidden series (uncontrolled).
+     */
     defaultHiddenSeries?: string[];
-    /** The legend turned a series on or off; the new list of hidden ids. */
+    /**
+     * The legend turned a series on or off; gets the new list of hidden ids.
+     */
     onHiddenSeriesChange?: (hiddenSeries: string[]) => void;
-    /** Display of a value in the legend, the tooltip and the table. Default: Russian digit groups. */
+    /**
+     * Display of a value in the legend, the tooltip and the table («8,4 млн ₽»).
+     */
     formatValue?: (value: number) => string;
     /**
-     * Loads the data again from the error state; shows the retry button. May return a Promise: the
-     * button waits for it.
+     * Loads the data again from the `error` state and shows the retry button; a returned Promise keeps the button loading until it settles.
      */
     onRetry?: () => void | Promise<void>;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<ChartFrameLabels>;
     ref?: React.Ref<HTMLElement>;
 };
 /**
  * A dashboard panel around any chart (Recharts, ECharts, visx, Chart.js or a hand-drawn SVG): a
  * surface of the depth ladder named by its title, with a headline value, the measured plot area, a
- * series legend that turns series on and off, a tooltip body and a table for assistive tech. The
- * state (loading / empty / error / ready) lives on the root; every part shows its own side of it.
+ * series legend that turns series on and off and a tooltip body. The root renders the data
+ * (`rows`) as a visually hidden table for assistive tech. The state (loading / empty / error /
+ * ready) lives on the root; every part shows its own side of it.
  */
-declare function ChartFrameRoot({ state, series, hiddenSeries: hiddenProp, defaultHiddenSeries, onHiddenSeriesChange, formatValue, onRetry, labels: labelsProp, className, children, ...rest }: ChartFrameRootProps): import("react/jsx-runtime").JSX.Element;
+declare function ChartFrameRoot({ state, series, rows, hiddenSeries: hiddenProp, defaultHiddenSeries, onHiddenSeriesChange, formatValue, onRetry, labels: labelsProp, className, children, ...rest }: ChartFrameRootProps): import("react/jsx-runtime").JSX.Element;
 declare namespace ChartFrameRoot {
     var displayName: string;
 }
@@ -91,7 +114,9 @@ declare namespace ChartFrameHeader {
 }
 type ChartFrameTitleAs = "h2" | "h3" | "h4";
 export type ChartFrameTitleProps = React.HTMLAttributes<HTMLHeadingElement> & {
-    /** Heading level that fits the page outline; the look does not change. Default `h3`. */
+    /**
+     * Heading level that fits the page outline; the look does not change.
+     */
     as?: ChartFrameTitleAs;
     ref?: React.Ref<HTMLHeadingElement>;
 };
@@ -128,7 +153,9 @@ declare namespace ChartFrameValue {
     var displayName: string;
 }
 export type ChartFrameDeltaProps = React.HTMLAttributes<HTMLSpanElement> & {
-    /** Color of the change: `success` — good, `danger` — bad, `neutral` (default). Independent of the sign. */
+    /**
+     * Color of the change: `success` — good, `danger` — bad; independent of the sign.
+     */
     tone?: Extract<Tone, "neutral" | "success" | "warning" | "danger">;
     ref?: React.Ref<HTMLSpanElement>;
 };
@@ -139,18 +166,16 @@ declare namespace ChartFrameDelta {
 }
 export type ChartFramePlotProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
     /**
-     * Height of the plot area in px. Default 240, 160 when the panel is narrower than 30rem. `fill` —
-     * the plot takes the free height of a stretched panel (a `PageContent.Cell` with `rows`), the
-     * default height at least.
+     * Height of the plot area in px. `fill` takes the free height of a stretched panel (a `Page.Cell` with `rows`), the default height at least.
      */
     height?: number | "fill";
     /**
-     * Renders the chart at the measured size — for libraries that need explicit `width` and
-     * `height` (Recharts without `ResponsiveContainer`, Chart.js, visx). Gets every series with its
-     * resolved color and visibility. Called once the area has a size.
+     * Renders the chart at the measured `{ width, height }` with every series `{ id, label, color, hidden }` — for libraries that need explicit sizes (Chart.js, visx).
      */
     renderPlot?: (area: ChartFramePlotArea) => React.ReactNode;
-    /** A chart that sizes itself to its container (an SVG with `width="100%"`, `ResponsiveContainer`). */
+    /**
+     * A chart that sizes itself to its container (an SVG with a `viewBox`, `ResponsiveContainer`); it fills the area.
+     */
     children?: React.ReactNode;
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -164,7 +189,9 @@ declare namespace ChartFramePlot {
     var displayName: string;
 }
 export type ChartFrameLegendProps = React.HTMLAttributes<HTMLUListElement> & {
-    /** Entries only name the series; they do not turn them on and off. */
+    /**
+     * Entries only name the series and do not toggle them.
+     */
     readOnly?: boolean;
     ref?: React.Ref<HTMLUListElement>;
 };
@@ -183,15 +210,16 @@ export type ChartFrameTooltipItem = {
     value: number;
 };
 export type ChartFrameTooltipProps = React.HTMLAttributes<HTMLDivElement> & {
-    /** The point the rows belong to («Неделя 41», «8 окт»). */
+    /**
+     * The point the rows belong to («Неделя 41»).
+     */
     label?: string;
-    /** One row per series at that point; rows of hidden series are left out. */
+    /**
+     * `{ id, value }` per series at that point; name and color come from the root's series, rows of hidden series are left out, values go through `formatValue`.
+     */
     items: ChartFrameTooltipItem[];
     /**
-     * A point of the plot in the coordinates `renderPlot` draws in (the pointer, or the point the
-     * arrow keys reached): the tooltip floats beside it like every kit layer — right of it, on the
-     * left only where the right has no room; `null` hides it. Without `point` the body renders in
-     * place for a chart library's tooltip hook, which positions it.
+     * A point in `renderPlot` coordinates (the pointer, or the point the arrows reached): the tooltip floats right of it, left only without room; `null` hides it. Floating, it is `aria-hidden`.
      */
     point?: AnchorPoint | null;
     ref?: React.Ref<HTMLDivElement>;
@@ -206,26 +234,6 @@ declare function ChartFrameTooltip({ label, items, point, className, ...rest }:
 declare namespace ChartFrameTooltip {
     var displayName: string;
 }
-export type ChartFrameTableRow = {
-    /** The point the row stands for («Неделя 41»): the row header. */
-    label: string;
-    /** Values by series id; a missing value reads as «—». */
-    values: Record<string, number | undefined>;
-};
-export type ChartFrameTableProps = React.TableHTMLAttributes<HTMLTableElement> & {
-    /** The chart's data, one row per point. */
-    rows: ChartFrameTableRow[];
-    ref?: React.Ref<HTMLTableElement>;
-};
-/**
- * The chart's data as a table for screen readers (visually hidden): a row per point, a column per
- * shown series, named by the chart title. Present only while the data is ready. A visible table is
- * a `DataTable`.
- */
-declare function ChartFrameTable({ rows, className, ...rest }: ChartFrameTableProps): import("react/jsx-runtime").JSX.Element | null;
-declare namespace ChartFrameTable {
-    var displayName: string;
-}
 export declare const ChartFrame: {
     Root: typeof ChartFrameRoot;
     Header: typeof ChartFrameHeader;
@@ -237,6 +245,5 @@ export declare const ChartFrame: {
     Plot: typeof ChartFramePlot;
     Legend: typeof ChartFrameLegend;
     Tooltip: typeof ChartFrameTooltip;
-    Table: typeof ChartFrameTable;
 };
 export {};

package/dist/components/chat/Chat.d.ts

@@ -9,29 +9,43 @@ export type { ChatPinnedItem, ChatPinnedLabels, ChatPinnedProps } from "./ChatPi
 export type { ChatSeparatorProps, ChatServiceProps, ChatUnreadLabels, ChatUnreadProps, } from "./ChatRows";
 export type { ChatLabels } from "./chatContext";
 export type { ChatSelectionBarProps } from "./MessageList";
+export declare const CHAT_LABELS: ChatLabels;
 export type ChatRootProps = Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue"> & {
     /**
-     * Selection mode (controlled): the `value`s of the selected messages, `null` while not selecting.
-     * Any of the triad lets a message's menu start selection («Выбрать»).
+     * Selection mode (controlled): the `value`s of the selected messages, `null` while not selecting. Any of the triad adds «Выбрать» to every `Message.Menu`; without it the chat has no selection.
      */
     selected?: Selection;
-    /** Initial selection (uncontrolled). */
+    /**
+     * Initial selection (uncontrolled).
+     */
     defaultSelected?: Selection;
-    /** The selection changed: a message toggled, selection started (`[value]`) or ended (`null`). */
+    /**
+     * The selection changed: a message toggled, selection started from the menu (`[value]`) or ended (`null`).
+     */
     onSelectedChange?: (selected: Selection) => void;
-    /** The search query (controlled); `null` — the search bar is closed. */
+    /**
+     * The search query (controlled); `null` — the search bar is closed. Matches in the messages' text and transcripts are marked; the newest is current.
+     */
     search?: string | null;
-    /** The initial search (uncontrolled). Default `null`. */
+    /**
+     * The initial search (uncontrolled).
+     */
     defaultSearch?: string | null;
-    /** The search opened, changed its query or closed (`null`). */
+    /**
+     * The search opened (`""`), changed its query or closed (`null`).
+     */
     onSearchChange?: (search: string | null) => void;
     /**
-     * A message to bring into view and point at (a link, a notification): it
-     * blinks. A search's current match takes its place while the search is open.
+     * A message to jump to (a link, a notification): on change the chat brings it to the middle and the message itself blinks. The focus stays where it is; while the search is open its current match takes this place.
+     */
+    jumpTo?: string | null;
+    /**
+     * The other side is typing: `Chat.Description` cross-fades into «печатает…» and the list ends with the typing bubble (`Message.Typing`), which gives way at once to the reply that ends it.
      */
-    current?: string | null;
-    /** The other side is typing: the header's status turns into «печатает…» and the list ends with the typing bubble. */
     typing?: boolean;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<ChatLabels>;
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -42,7 +56,7 @@ export type ChatRootProps = Omit<React.HTMLAttributes<HTMLDivElement>, "defaultV
  * scrolling in the middle, the footer with the Composer at the bottom. Every part is optional but
  * `Chat.Messages`: a list without the rest is `Chat.Root` with `Chat.Messages` alone.
  */
-declare function ChatRoot({ selected: selectedProp, defaultSelected, onSelectedChange, search: searchProp, defaultSearch, onSearchChange, current: currentProp, typing, labels: labelsProp, className, children, ref, ...rest }: ChatRootProps): import("react/jsx-runtime").JSX.Element;
+declare function ChatRoot({ selected: selectedProp, defaultSelected, onSelectedChange, search: searchProp, defaultSearch, onSearchChange, jumpTo: jumpToProp, typing, labels: labelsProp, className, children, ref, ...rest }: ChatRootProps): import("react/jsx-runtime").JSX.Element;
 declare namespace ChatRoot {
     var displayName: string;
 }
@@ -60,7 +74,9 @@ declare namespace ChatHeader {
     var displayName: string;
 }
 export type ChatTitleProps = React.HTMLAttributes<HTMLHeadingElement> & {
-    /** Heading level that fits the page outline (the look does not change). Default `h2`. */
+    /**
+     * Heading level that fits the page outline (the look does not change).
+     */
     as?: "h2" | "h3" | "h4";
     ref?: React.Ref<HTMLHeadingElement>;
 };
@@ -110,56 +126,79 @@ declare namespace ChatSearch {
     var displayName: string;
 }
 /** Where a message of `Chat.Messages items` stands, handed to `renderMessage`. */
-export type ChatMessageEntry = {
+export type ChatMessageEntry<T = unknown> = {
     /** The place in its author's run; set on the rendered `Message.Root` for you. */
     position: MessagePosition;
     /** The first of a run: the author's header shows here in a group chat. */
     showAuthor: boolean;
     /** The last of a run: the avatar shows here in a group chat. */
     showAvatar: boolean;
+    /** Another item of the list by its key (a reply's original), as the list holds it now. */
+    find: (key: string) => T | undefined;
 };
-export type ChatMessagesProps<T = unknown> = Omit<MessageListProps, "group" | "selected" | "defaultSelected" | "onSelectedChange" | "current" | "highlight" | "onMatchesChange" | "revealRef" | "labels"> & {
+export type ChatMessagesProps<T = unknown> = Omit<MessageListProps, "selected" | "defaultSelected" | "onSelectedChange" | "jumpTo" | "highlight" | "onMatchesChange" | "revealRef" | "labels"> & {
     /**
-     * `direct` — a conversation of two; `group` — many authors: the first message of an author's run
-     * shows the author's header (`Message.Author`), the last one the avatar (`Message.Avatar`), and
-     * incoming messages keep the avatar's gutter. Default `direct`.
+     * The first load: bubble-shaped `Skeleton`s on both sides stand in the list's place (`aria-busy`, `labels.loading` announced), then cross-fade into the messages; none of them counts as new.
      */
-    type?: "direct" | "group";
+    loading?: boolean;
     /**
-     * The first load of the conversation: bubble-shaped placeholders stand in the list's place
-     * (`aria-busy`, `labels.loading` announced), then cross-fade into the messages.
+     * Older history exists: a bubble-shaped placeholder stands above the first message and `onLoadOlder` runs when the reader reaches the top.
      */
-    loading?: boolean;
-    /** Older history exists: a placeholder stands above the first message and `onLoadOlder` runs at the top. */
     hasOlder?: boolean;
-    /** The reader reached the top while `hasOlder`: load older messages and prepend them. */
+    /**
+     * Load older messages and prepend them (while `hasOlder`); the reader's place is kept.
+     */
     onLoadOlder?: () => void | Promise<void>;
-    /** Messages as application data, in time order: the list adds the dates and runs itself. */
+    /**
+     * Messages as application data, in time order: the list adds the dates, the runs and the unread band and sets each message's `value` and `position`. Without it, children are the rows.
+     */
     items?: readonly T[];
-    /** A stable key of an item (with `items`): it is also its message's `value`. */
+    /**
+     * A stable key of an item (with `items`): also its message's `value`. Keep it when the server confirms a sent message.
+     */
     getKey?: (item: T) => string;
-    /** Who wrote an item (an id, with `items`): a change of author starts a new run. */
+    /**
+     * Who wrote an item (an id, with `items`): a change of author starts a new run.
+     */
     getAuthor?: (item: T) => string;
-    /** When an item was sent (with `items`): a new day gets a date. */
+    /**
+     * When an item was sent (with `items`): a new day gets a date.
+     */
     getDate?: (item: T) => Date;
-    /** An event of the chat, not a message: it stands alone and breaks the runs around it. */
+    /**
+     * An event of the chat, not a message: it stands alone and breaks the runs around it.
+     */
     isService?: (item: T) => boolean;
     /**
-     * Renders an item (with `items`): a `Message.Root` (its `value` and `position` are set for you)
-     * or a `Chat.Service`. Called again only for items whose data or place changed, or when this
-     * function changes — keep it stable (`useCallback`) for a long history.
+     * Renders an item: a `Message.Root` or a `Chat.Service`; `entry` — `{ position, showAuthor, showAvatar, find }`, `find(key)` gives another item (a reply's original). Runs again only for an item whose data or place changed.
+     */
+    renderMessage?: (item: T, entry: ChatMessageEntry<T>) => React.ReactElement;
+    /**
+     * The key of the first unread item: the «Непрочитанные сообщения» band stands above it.
      */
-    renderMessage?: (item: T, entry: ChatMessageEntry) => React.ReactElement;
-    /** The key of the first unread item: the «Непрочитанные» band stands above it. */
     unread?: string;
-    /** Messages of one author further apart than this many minutes start a new run. Default 5. */
+    /**
+     * Messages of one author further apart than this many minutes start a new run.
+     */
     groupWindow?: number;
-    /** «Today» for the dates. Default: now. */
+    /**
+     * «Today» for the dates.
+     */
     now?: Date;
-    /** The label of a date. Default «Сегодня», «Вчера», «12 марта». */
+    /**
+     * The label of a date.
+     */
     formatDate?: (date: Date, now: Date) => string;
 };
-declare function ChatMessages<T>({ type, loading, hasOlder, onLoadOlder, items, getKey, getAuthor, getDate, isService, renderMessage, unread, groupWindow, now, formatDate, children, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ...rest }: ChatMessagesProps<T>): import("react/jsx-runtime").JSX.Element;
+/**
+ * The conversation: the one message list of the kit, in its own scroller. A `role="log"` of rows
+ * (new messages are announced politely) with one tab stop — arrows, Home and End move between
+ * messages. Rows come from `items` (dates, runs and the unread band added for you) or from
+ * children (`Message.Root`, `Chat.Separator`, `Chat.Service`, `Chat.Unread`; `Chat.SelectionBar`
+ * and `Message.Typing` close the list). Only the rows around the view render; the list opens at
+ * the end and keeps the reader's place.
+ */
+declare function ChatMessages<T>({ group, loading, hasOlder, onLoadOlder, items, getKey, getAuthor, getDate, isService, renderMessage, unread, groupWindow, now, formatDate, children, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ...rest }: ChatMessagesProps<T>): import("react/jsx-runtime").JSX.Element;
 declare namespace ChatMessages {
     var displayName: string;
 }

package/dist/components/chat/ChatPinned.d.ts

@@ -13,23 +13,35 @@ export type ChatPinnedLabels = {
     /** Name of the unpin button. */
     unpin: string;
 };
+export declare const CHAT_PINNED_LABELS: ChatPinnedLabels;
 export type ChatPinnedProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "defaultValue" | "onSelect"> & {
-    /** The pinned messages, oldest first. Without any the bar is not rendered. */
+    /**
+     * The pinned messages, oldest first: the `value` of each `Message.Root` and one line of it («Фото», «Голосовое сообщение» for media).
+     */
     items: readonly ChatPinnedItem[];
-    /** The pinned message shown (controlled). */
+    /**
+     * The pinned message shown (controlled).
+     */
     value?: string;
-    /** The one shown first (uncontrolled). Default: the newest (the last item). */
+    /**
+     * The one shown first (uncontrolled): the newest.
+     */
     defaultValue?: string;
-    /** The shown pinned message changed: a press went on to the next older one. */
+    /**
+     * The shown message changed: a press stepped to the next older one (the oldest wraps to the newest).
+     */
     onValueChange?: (value: string) => void;
     /**
-     * A press on the bar, after the chat has brought the message into view and blinked it:
-     * load it when it is not in the list yet. The bar then moves on to the next older
-     * pinned message, the oldest wraps to the newest.
+     * A press on the bar, after the chat has jumped to the message: load it when it is not in the list yet.
      */
     onSelect?: (value: string) => void;
-    /** Unpin the shown message: the close button. Without it no button. */
+    /**
+     * Unpin the shown message: a ghost close button at the end. Without it no button.
+     */
     onRemove?: (value: string) => void;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<ChatPinnedLabels>;
     ref?: React.Ref<HTMLDivElement>;
 };

package/dist/components/chat/ChatRows.d.ts

@@ -2,7 +2,11 @@ import type * as React from "react";
 export type ChatSeparatorProps = React.HTMLAttributes<HTMLDivElement> & {
     ref?: React.Ref<HTMLDivElement>;
 };
-/** A date between messages («Сегодня», «12 марта»): a small pill that sticks while its day scrolls. */
+/**
+ * A date between messages («Сегодня», «12 марта»): a small pill that sticks while its day scrolls.
+ * An incoming bubble stands one step off the list's host, the pill one step above the bubble, so the
+ * two never share a fill while the bubbles pass under it.
+ */
 export declare function ChatSeparator({ className, children, ...rest }: ChatSeparatorProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace ChatSeparator {
     var displayName: string;
@@ -20,6 +24,9 @@ export type ChatUnreadLabels = {
     unread: string;
 };
 export type ChatUnreadProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
+    /**
+     * `unread` — the text of the band.
+     */
     labels?: Partial<ChatUnreadLabels>;
     ref?: React.Ref<HTMLDivElement>;
 };

package/dist/components/chat/MessageList.d.ts

@@ -14,8 +14,7 @@ export type MessageListLabels = {
 export declare const MESSAGE_LIST_LABELS: MessageListLabels;
 export type MessageListProps = React.HTMLAttributes<HTMLDivElement> & {
     /**
-     * A group chat: incoming messages keep a gutter for the author's avatar, the first message of a
-     * run shows its author's header, the last one the avatar. Default `false`.
+     * A group chat of many authors: the first message of a run shows the author's header, the last one the avatar, and incoming messages keep the avatar's gutter. Without it a conversation of two.
      */
     group?: boolean;
     /**
@@ -27,39 +26,35 @@ export type MessageListProps = React.HTMLAttributes<HTMLDivElement> & {
     defaultSelected?: Selection;
     /** The selection changed: a message toggled, selection started (`[value]`) or ended (`null`). */
     onSelectedChange?: (selected: Selection) => void;
-    /** The emoji a double tap (or `L` on a focused message) puts or takes back. Default «👍»; `false` — off. */
+    /**
+     * The reaction of a double tap (and `L`) on a message: puts it or takes it back through `onReactionToggle`. `false` — off.
+     */
     quickReaction?: string | false;
     /**
-     * The reactions of the reaction bar (long press, a long hover, `R`): the first seven in its row,
-     * the rest behind «⌄». `label` names each for assistive tech.
+     * The reactions of the bar above a message (long press, long hover or `R`): the first seven in a row, «⌄» opens the rest. `label` names each toggle button.
      */
     reactionOptions?: readonly MessageReactionOption[];
     /**
-     * The reader (`{ id, name: "Вы", src }`): a reaction they put shows their avatar among
-     * `MessageReaction.users` at once, before the data comes back.
+     * The reader (`{ id, name: «Вы», src?, color? }`): a reaction they put shows them among the chip's avatars at once, before the data comes back; matched by `id`.
      */
     reader?: MessageUser;
     /**
-     * A message was added at the end after the list mounted — sent or received; never the first
-     * render, history loaded above or a message put back in the middle. For a sound, a counter,
-     * a title badge. The message enters on its own either way.
+     * A message was added at the end after mount, sent or received: for a sound, a counter, a title badge. Not called for the first render, history or a message put back in the middle.
      */
     onNewMessage?: (value: string, details: {
         direction: MessageDirection;
     }) => void;
     /**
-     * Incoming messages the reader has seen: at least half of each (or half the view) on screen
-     * while the page is visible. Batched per frame, each `value` once per mount. Send read receipts
-     * from here and set `status="read"` on the other side.
+     * Incoming messages the reader has seen (at least half on screen while the page is visible); batched per frame, each `value` once per mount. Send read receipts from here.
      */
     onRead?: (values: string[]) => void;
     /**
-     * The current message of a search or a jump: when it changes the list brings it into view in
-     * its scroller and points at it: the other messages step back and forth around it, or, while a
-     * search `highlight` is on, stay back while it is current. Focus stays where it is (the search
-     * field).
+     * The message to jump to — a search's current match or a jump: when it changes the list brings
+     * it into view in its scroller and points at it: the other messages step back and forth around
+     * it, or, while a search `highlight` is on, stay back while it is current. Focus stays where it
+     * is (the search field).
      */
-    current?: string | null;
+    jumpTo?: string | null;
     /** A search query: every match in `Message.Text` and transcripts is marked. */
     highlight?: string;
     /** The messages whose text holds `highlight`, in list order (oldest first), as they change. */
@@ -81,7 +76,7 @@ export type MessageListProps = React.HTMLAttributes<HTMLDivElement> & {
  * `anchor="end"`); jumps, search, selection ranges, the keyboard and playing media reach or keep
  * rows that are not rendered.
  */
-export declare function MessageList({ group, selected: selectedProp, defaultSelected, onSelectedChange, quickReaction, reactionOptions, reader, onNewMessage, onRead, current: currentProp, highlight, onMatchesChange, revealRef, labels: labelsProp, className, children, onKeyDown, onFocus, ref, ...rest }: MessageListProps): import("react/jsx-runtime").JSX.Element;
+export declare function MessageList({ group, selected: selectedProp, defaultSelected, onSelectedChange, quickReaction, reactionOptions, reader, onNewMessage, onRead, jumpTo, highlight, onMatchesChange, revealRef, labels: labelsProp, className, children, onKeyDown, onFocus, ref, ...rest }: MessageListProps): import("react/jsx-runtime").JSX.Element;
 export type ChatSelectionBarProps = React.HTMLAttributes<HTMLDivElement> & {
     ref?: React.Ref<HTMLDivElement>;
 };