prime-ui-kit 0.15.0 → 0.16.0

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

@@ -20,6 +20,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>;
 };

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

@@ -37,8 +37,8 @@ export type ChatContextValue = {
     /** The current match, counted from the newest (`0` — the newest). */
     matchIndex: number;
     setMatchIndex: (index: number) => void;
-    /** The message the list brings into view: the current match while searching, else `current`. */
-    current: string | null;
+    /** The message the list jumps to: the current match while searching, else `jumpTo`. */
+    jumpTo: string | null;
     /** The other side types. */
     typing: boolean;
     /** Brings a message into view and blinks it (a pinned message's press). */
@@ -53,4 +53,4 @@ export type ChatContextValue = {
     setHasTitle: (has: boolean) => void;
     labels: ChatLabels;
 };
-export declare const ChatProvider: React.Provider<ChatContextValue | null>, useChat: () => ChatContextValue;
+export declare const ChatProvider: React.Provider<ChatContextValue | null>, useChat: (part?: string) => ChatContextValue;

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

@@ -1,5 +1,5 @@
 import type { MessageDirection } from "../message/types";
-import type { ScrollRegion } from "../scroll-container/useScrollEdges";
+import type { ScrollRegion } from "../../hooks/useScrollRegion";
 /** A message of the conversation in data order: its value and side. */
 export type FlowEntry = {
     value: string;

package/dist/components/chat-list/ChatList.d.ts

@@ -48,11 +48,12 @@ export type ChatListLabels = {
     file: string;
     location: string;
     contact: string;
-    /** `aria-label` of the point the row menu opens from. */
-    menu: string;
 };
+export declare const CHAT_LIST_LABELS: ChatListLabels;
 export type ChatListItemIconProps = Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> & {
-    /** Before the name: an `Avatar.Root` (sized by the row). After it: a small `Icon`. */
+    /**
+     * An `Avatar.Root` (with `Avatar.Status`), or after the name an `Icon` with a `label`.
+     */
     children: React.ReactNode;
     ref?: React.Ref<HTMLSpanElement>;
 };
@@ -73,11 +74,17 @@ declare namespace ChatListItemText {
     var displayName: string;
 }
 export type ChatListItemDescriptionProps = React.HTMLAttributes<HTMLSpanElement> & {
-    /** Who wrote the last message: «Вы», a member of a group. Shown as «{author}: » before it. */
+    /**
+     * Who wrote it: «Вы» for the reader, a member's name in a group.
+     */
     author?: string;
-    /** The last message is not text: its word («Фото», «Голосовое сообщение») leads the preview. */
+    /**
+     * The message is not text: its word («Фото», «Голосовое сообщение») leads the preview in the accent.
+     */
     kind?: ChatListMediaKind;
-    /** Length of a voice or video message, seconds: «Голосовое сообщение 0:42». */
+    /**
+     * Length of a voice or video message in seconds: «Голосовое сообщение 0:42».
+     */
     duration?: number;
     ref?: React.Ref<HTMLSpanElement>;
 };
@@ -100,28 +107,40 @@ declare namespace ChatListItemMenu {
     var displayName: string;
 }
 type ChatListItemOwnProps = {
-    /** When the last message was sent: a `Date` (shown with the root's `formatTime`) or the text to show. */
+    /**
+     * When the last message was sent: a `Date` shown with the root's `formatTime`, or the text to show.
+     */
     time?: Date | string;
-    /** Delivery of the reader's own last message: ✓ sent, ✓✓ read, the clock, or failed. */
+    /**
+     * Delivery of the reader's own last message: the clock, ✓, ✓✓ in the accent, or the failure mark — cross-fading.
+     */
     status?: MessageStatus;
-    /** Unread messages: the count at the end of the row. Default 0. */
+    /**
+     * Unread messages: a solid count under the time (gray while `muted`); the number rolls.
+     */
     unread?: number;
-    /** The reader is mentioned among the unread: an «@» beside the count. */
+    /**
+     * The reader is mentioned among the unread: an «@» beside the count.
+     */
     mention?: boolean;
-    /** Notifications are off: a muted glyph beside the name and a gray count. */
+    /**
+     * Notifications are off: a muted glyph beside the name and a gray count.
+     */
     muted?: boolean;
-    /** Pinned by the reader: a pin at the end of the row while nothing is unread. */
+    /**
+     * Pinned: a pin under the time while nothing is unread. Put pinned dialogs first in `items`.
+     */
     pinned?: boolean;
     /**
-     * The other side types: the preview turns into «печатает…» in the accent, and back. A name
-     * («Анна») for a group: «Анна печатает…».
+     * The other side types: the preview cross-fades into «печатает…» in the accent; a name for a group («Анна печатает…»).
      */
     typing?: boolean | string;
-    /** The reader's unsent text: the preview shows «Черновик:» and the text. */
+    /**
+     * The reader's unsent text: the preview shows «Черновик:» in danger and the text.
+     */
     draft?: string;
     /**
-     * `ChatList.ItemIcon` (the avatar; after the name — a glyph), `ChatList.ItemText`,
-     * `ChatList.ItemDescription`, `ChatList.ItemMenu`.
+     * `ChatList.ItemIcon`, `ChatList.ItemText`, `ChatList.ItemDescription`, `ChatList.ItemMenu`.
      */
     children?: React.ReactNode;
 };
@@ -136,38 +155,73 @@ declare namespace ChatListItem {
     var displayName: string;
 }
 export type ChatListRootProps<T = unknown> = Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue" | "children"> & {
-    /** Dialogs as application data, in the order to show (pinned first, then by the last message). */
+    /**
+     * Dialogs in the order to show: pinned first, then by the last message. Rows glide when it changes.
+     */
     items: readonly T[];
-    /** A stable key of a dialog: the `value` of its row. */
+    /**
+     * A stable key of a dialog: the `value` of its row.
+     */
     getKey: (item: T) => string;
-    /** Renders a dialog: a `ChatList.Item` with its parts. */
+    /**
+     * Renders a dialog as a `ChatList.Item` with its parts.
+     */
     renderItem: (item: T) => React.ReactElement;
-    /** The open dialog (controlled); `null` — none. */
+    /**
+     * The open dialog (controlled): the current fill and `aria-current`; `null` — none.
+     */
     value?: string | null;
-    /** The dialog open at first (uncontrolled). Default `null`. */
+    /**
+     * The dialog open at first (uncontrolled).
+     */
     defaultValue?: string | null;
-    /** The reader opened a dialog: a click, a tap, Enter or Space on its row. */
+    /**
+     * The reader opened a dialog: a click, a tap, Enter or Space on its row.
+     */
     onValueChange?: (value: string) => void;
-    /** The search query (controlled). Any of the triad shows the search field. */
+    /**
+     * The search query (controlled). Any of the triad shows the search field.
+     */
     search?: string;
-    /** The initial query (uncontrolled). */
+    /**
+     * The initial query (uncontrolled).
+     */
     defaultSearch?: string;
-    /** The query changed: filter `items` by it (the list marks the matches). */
+    /**
+     * The query changed: filter `items` by it; the rows mark the match in the name and the preview.
+     */
     onSearchChange?: (search: string) => void;
-    /** The first load: placeholder rows in the rows' geometry, then a cross-fade into the dialogs. */
+    /**
+     * The first load: placeholder rows in the rows' geometry (`aria-busy`), then a cross-fade into the dialogs.
+     */
     loading?: boolean;
-    /** More dialogs exist: a placeholder row ends the list and `onLoadMore` runs near the end. */
+    /**
+     * More dialogs exist: a placeholder row ends the list and `onLoadMore` runs near the end.
+     */
     hasMore?: boolean;
-    /** The reader scrolled near the end while `hasMore`: load the next dialogs and append them. */
+    /**
+     * The reader came near the end while `hasMore`: append the next dialogs. A promise is awaited before the next call.
+     */
     onLoadMore?: () => void | Promise<void>;
-    /** The empty state without a search. Default: «Нет диалогов». */
+    /**
+     * The empty state without a search (an `EmptyPage` with an action). Default: «Нет диалогов».
+     */
     empty?: React.ReactNode;
-    /** Row tier: height, text, avatar, the search field. Default `m`. */
+    /**
+     * Row tier: height, text, avatar, glyphs and the search field. Without it the tier of the host.
+     */
     size?: ControlSize;
-    /** «Now» for the times. Default: the moment of the render. */
+    /**
+     * «Now» for the times of the rows. Default: the moment of the render.
+     */
     now?: Date;
-    /** Display of a `Date` time. Default `formatChatTime`: «14:32», «пн», «12 мар». */
+    /**
+     * Display of a row's `Date` time: «14:32» today, «пн» this week, «12 мар», «12.03.2025».
+     */
     formatTime?: (date: Date, now: Date) => string;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<ChatListLabels>;
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -177,7 +231,7 @@ export type ChatListRootProps<T = unknown> = Omit<React.HTMLAttributes<HTMLDivEl
  * new places when the order changes, a long list rendered only around the view, placeholder rows
  * while loading and more dialogs loaded near the end. Draws no surface: put it in a pane.
  */
-declare function ChatListRoot<T>({ items, getKey, renderItem, value: valueProp, defaultValue, onValueChange, search: searchProp, defaultSearch, onSearchChange, loading, hasMore, onLoadMore, empty, size, now: nowProp, formatTime, labels: labelsProp, className, ref, ...rest }: ChatListRootProps<T>): import("react/jsx-runtime").JSX.Element;
+declare function ChatListRoot<T>({ items, getKey, renderItem, value: valueProp, defaultValue, onValueChange, search: searchProp, defaultSearch, onSearchChange, loading, hasMore, onLoadMore, empty, size: sizeProp, now: nowProp, formatTime, labels: labelsProp, className, ref, ...rest }: ChatListRootProps<T>): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
 declare namespace ChatListRoot {
     var displayName: string;
 }

package/dist/components/checkbox/Checkbox.d.ts

@@ -2,28 +2,64 @@ import * as React from "react";
 import { type ChoiceLabelProps } from "../../internal/ChoiceField";
 import type { ControlSize } from "../../internal/states";
 export type CheckboxShape = "square" | "circle";
+export type CheckboxLabels = {
+    /** Muted marker after the label text when `optional`. */
+    optional: string;
+};
+export declare const CHECKBOX_LABELS: CheckboxLabels;
 export type CheckboxRootProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, "type" | "size" | "checked" | "defaultChecked" | "onChange"> & {
+    /**
+     * Controlled checked state.
+     */
     checked?: boolean;
+    /**
+     * Initial state when uncontrolled.
+     */
     defaultChecked?: boolean;
+    /**
+     * Called with the new state on every toggle (not while `readOnly`).
+     */
     onCheckedChange?: (checked: boolean) => void;
-    /** Mixed state (e.g. «select all» with a partial selection); wins over `checked` visually. */
+    /**
+     * Mixed state (a partial «select all»): a bar instead of the check; wins over `checked` visually and sets the native `indeterminate`.
+     */
     indeterminate?: boolean;
-    /** Invalid state; a non-empty `error` implies it. */
+    /**
+     * Danger ring on the unchecked box and `aria-invalid`. A non-empty `error` implies it.
+     */
     invalid?: boolean;
-    /** Help text under the label text. Hidden while `error` is shown. */
+    /**
+     * Help text under the label text. Hidden while `error` is shown.
+     */
     hint?: React.ReactNode;
-    /** Error message in the hint slot; implies `invalid`. */
+    /**
+     * Error message in the hint slot; implies `invalid`.
+     */
     error?: React.ReactNode;
-    /** Tier. Default: the tier of the surrounding control (a form, a panel, a table), else `m`. */
+    /**
+     * Tier of the box, the text and the gap. Without it the tier of its host (a form, a panel, a table), else `m`.
+     */
     size?: ControlSize;
-    /** Outline of the box: rounded square or full circle (a selection mark, like in messengers). */
+    /**
+     * Outline of the box: `square` is the rounded square; `circle` is a full circle (a selection mark in lists and chats). Size, the check draw-in, the indeterminate bar and states are the same.
+     */
     shape?: CheckboxShape;
-    /** `Checkbox.Label`; without it the bare box renders (give it an `aria-label`). */
+    /**
+     * Muted `labels.optional` after the label text; the field may stay off.
+     */
+    optional?: boolean;
+    /**
+     * Built-in strings, see Labels.
+     */
+    labels?: Partial<CheckboxLabels>;
+    /**
+     * `Checkbox.Label`. Without it only the box renders — give the root an `aria-label`.
+     */
     children?: React.ReactNode;
     /** The native checkbox input. */
     ref?: React.Ref<HTMLInputElement>;
 };
-declare function CheckboxRoot({ id, checked: checkedProp, defaultChecked, onCheckedChange, indeterminate, invalid, hint, error, size: sizeProp, shape, disabled: disabledProp, readOnly, className, "aria-describedby": ariaDescribedBy, children, ref, ...inputRest }: CheckboxRootProps): import("react/jsx-runtime").JSX.Element;
+declare function CheckboxRoot({ id, checked: checkedProp, defaultChecked, onCheckedChange, indeterminate, invalid, hint, error, size: sizeProp, shape, optional, labels: labelsProp, disabled: disabledProp, readOnly, className, "aria-describedby": ariaDescribedBy, children, ref, ...inputRest }: CheckboxRootProps): import("react/jsx-runtime").JSX.Element;
 declare namespace CheckboxRoot {
     var displayName: string;
 }
@@ -33,19 +69,32 @@ declare namespace CheckboxLabel {
     var displayName: string;
 }
 export type CheckboxIndicatorProps = Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> & {
+    /**
+     * Shows the check.
+     */
     checked?: boolean;
-    /** Mixed state; wins over `checked` visually. */
+    /**
+     * Shows the bar; wins over `checked`.
+     */
     indeterminate?: boolean;
+    /**
+     * Disabled fill.
+     */
     disabled?: boolean;
-    /** Outline of the box: rounded square or full circle. */
+    /**
+     * Outline of the box: `square` is the rounded square; `circle` is a full circle (a selection mark in lists and chats). The rest is the same.
+     */
     shape?: CheckboxShape;
-    /** Box tier; without it the nearest control size (e.g. the Select or menu it sits in), else `m`. */
+    /**
+     * Box tier; without it the nearest control size (the Select or menu it sits in), else `m`.
+     */
     size?: ControlSize;
     ref?: React.Ref<HTMLSpanElement>;
 };
 /**
  * The checkbox box alone, without an input: a decorative mark for rows whose own element carries
- * the state (`role="option"` with `aria-selected`, `role="menuitemcheckbox"` with `aria-checked`).
+ * the state (`role="option"` with `aria-selected`, `role="menuitemcheckbox"` with `aria-checked`,
+ * a toggle `<button>` with `aria-pressed`).
  * Used outside `Checkbox.Root`; it is `aria-hidden` and takes no focus or clicks.
  */
 declare function CheckboxIndicator({ checked, indeterminate, disabled, size: sizeProp, shape, className, ...rest }: CheckboxIndicatorProps): import("react/jsx-runtime").JSX.Element;