@sberbusiness/triplex-next 0.46.0 → 0.47.0

package/index.d.ts

@@ -94,9 +94,18 @@ export declare function amountComparator(a: string, b: string): -1 | 0 | 1;
 /** Константы форматов поля Amount (сумма). */
 export declare const AmountConst: IAmountConst;
 
+/**
+ * Поле ввода денежной суммы.
+ *
+ * Форматирует значение во время ввода (разряды через пробел, запятая в роли десятичного разделителя)
+ * и удерживает каретку в осмысленной позиции, а наружу отдаёт нормализованное значение вида "1234.56".
+ */
 export declare const AmountField: default_2.ForwardRefExoticComponent<IAmountFieldProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Аватар, предназначен для отображения изображений профиля пользователя, инициалов или иконок. */
+/**
+ * Аватар, предназначен для отображения изображений профиля пользователя, инициалов или иконок.
+ * Содержимое передаётся через children, фоновое изображение — через className или style.
+ */
 export declare const Avatar: default_2.ForwardRefExoticComponent<IAvatarProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -220,9 +229,6 @@ export declare class CardAction extends default_2.Component<ICardActionProps, IC
     handleToggle: () => void;
 }
 
-/** Контент карточки. */
-declare const CardContent: default_2.FC<ICardContentProps> & ICardContentComposition;
-
 /** Тело контента карточки. */
 declare const CardContentBody: default_2.FC<ICardContentBodyProps>;
 
@@ -232,11 +238,15 @@ declare const CardContentFooter: default_2.FC<ICardContentFooterProps>;
 /** Заголовок контента карточки. */
 declare const CardContentHeader: default_2.FC<ICardHeaderProps>;
 
-/** Медийный элемент карточки. */
-declare const CardMedia: default_2.FC<ICardMediaProps>;
-
-/** Компонент "Статичная карточка". */
-export declare const CardStatic: default_2.FC<ICardProps> & ICardStaticComposition;
+/**
+ * Компонент "Статичная карточка".
+ * Информационный контейнер без состояния выбора и клавиатурной активации.
+ * Содержимое собирается из составных частей CardStatic.Media и CardStatic.Content.
+ */
+export declare const CardStatic: default_2.ForwardRefExoticComponent<ICardProps & default_2.RefAttributes<HTMLDivElement>> & {
+    Content: default_2.FC<ICardContentProps> & ICardContentComposition;
+    Media: default_2.FC<ICardMediaProps>;
+};
 
 /** Карусель. */
 export declare const Carousel: default_2.ForwardRefExoticComponent<ICarouselProps & default_2.RefAttributes<HTMLDivElement>> & {
@@ -264,15 +274,20 @@ export declare const Checkbox: default_2.ForwardRefExoticComponent<ICheckboxProp
 
 /**
  * Дерево чекбоксов.
- * Является оберткой над CheckboxTreeExtended.
+ * Является оберткой над CheckboxTreeExtended: принимает плоское описание дерева и сам связывает состояние
+ * родителей и потомков — выбор родителя выбирает всех потомков, выбор части потомков делает родителя частичным.
+ *
+ * ref указывает на корневой <ul role="tree">.
  */
-export declare const CheckboxTree: default_2.FC<ICheckboxTreeProps>;
+export declare const CheckboxTree: default_2.ForwardRefExoticComponent<ICheckboxTreeProps & default_2.RefAttributes<HTMLUListElement>>;
 
 /**
  * Декларативное дерево чекбоксов.
  * Является оберткой над CollapsibleTreeExtended.
+ *
+ * ref указывает на корневой <ul role="tree">.
  */
-export declare const CheckboxTreeExtended: ICheckboxTreeExtendedSFC;
+export declare const CheckboxTreeExtended: ICheckboxTreeExtendedFC;
 
 /**
  * Обертка над базовым компонентом чекбокс.
@@ -299,10 +314,15 @@ export declare const CheckboxXGroup: default_2.ForwardRefExoticComponent<ICheckb
  */
 export declare const CheckboxYGroup: default_2.ForwardRefExoticComponent<ICheckboxYGroupProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Обновление флага checked дочерних чекбоксов, при изменении родителя. */
+/** Проставление флага checked родителя всем его потомкам вниз по дереву, при изменении родителя. */
 export declare const checkChildrenCheckboxes: (checkbox: ICheckboxTreeCheckboxData) => void;
 
-/** Обновление флага checked и bulk родителя, при изменении дочернего чекбокса. */
+/**
+ * Пересчёт флагов checked и bulk узла по состоянию его прямых потомков.
+ * Узел без потомков не трогается: bulk у листа не имеет смысла и остаётся таким, каким его задал потребитель.
+ * Пустой массив children — тоже лист: иначе условие «все потомки выбраны» выполнялось бы вырожденно (0 === 0)
+ * и узел становился выбранным сам по себе.
+ */
 export declare const checkParentCheckboxes: (checkbox: ICheckboxTreeCheckboxData) => void;
 
 /**
@@ -431,9 +451,11 @@ export declare const CollapsibleTree: default_2.FC<ICollapsibleTreeProps>;
  * Используй этот компонент, когда нужен нестандартный UI узла: своя иконка раскрытия, кастомный header, нестандартное
  * поведение клика. Для типового UI (готовый шеврон, hover, focus-visible) используй обёртку {@link CollapsibleTree}.
  *
+ * ref указывает на корневой <ul role="tree">.
+ *
  * @see CollapsibleTree — готовая обёртка с типовым UI узла.
  */
-export declare const CollapsibleTreeExtended: ICollapsibleTreeExtendedSFC;
+export declare const CollapsibleTreeExtended: ICollapsibleTreeExtendedFC;
 
 /**
  * Нода дерева CollapsibleTreeExtended.
@@ -498,21 +520,46 @@ export declare const ColumnSettingsSortableListItem: default_2.ForwardRefExoticC
  */
 export declare const ComposedKeyDownListener: default_2.FC<IComposedKeyDownListenerProps>;
 
-/** Компонент предупреждения, о закрытии лайтбокса / боковой панели лайтбокса. */
+/**
+ * Компонент предупреждения, о закрытии лайтбокса / боковой панели лайтбокса.
+ * Рендерится как Island типа TYPE_1 с ролью dialog; содержимое собирается из
+ * Confirm.Content, Confirm.Controls и Confirm.Close.
+ */
 export declare const Confirm: IConfirmFC;
 
 /**
  * Компонент закрытия.
+ * При clickByEsc нажатие Esc в любом месте страницы вызывает click по кнопке закрытия.
  */
-declare const ConfirmClose: default_2.FC<IConfirmCloseProps>;
+declare const ConfirmClose: default_2.ForwardRefExoticComponent<IConfirmCloseProps & default_2.RefAttributes<HTMLButtonElement>>;
 
+/**
+ * Содержимое предупреждения — обёртка заголовка и подзаголовка.
+ * Задаёт отступ до блока кнопок и место под кнопку закрытия справа.
+ */
 declare const ConfirmContent: IConfirmContentFC;
 
-declare const ConfirmContentSubTitle: default_2.FC<IConfirmContentSubTitleProps>;
+/**
+ * Подзаголовок предупреждения — поясняющий текст под заголовком.
+ * Обёртка над {@link Text} с дефолтами `size=B2` и `tag="div"` — тег можно переопределить.
+ *
+ * Ref типизирован как `HTMLElement`, а не `HTMLDivElement`: переопределённый
+ * `tag` меняет тип реального DOM-узла, и обещать `div` было бы неправдой.
+ */
+declare const ConfirmContentSubTitle: default_2.ForwardRefExoticComponent<IConfirmContentSubTitleProps & default_2.RefAttributes<HTMLElement>>;
 
-declare const ConfirmContentTitle: default_2.FC<IConfirmContentTitleProps>;
+/**
+ * Заголовок предупреждения.
+ * Обёртка над {@link Title} с дефолтом `size=H3` и отступом до подзаголовка.
+ *
+ * Ref типизирован как `HTMLElement`, а не `HTMLHeadingElement`: тег
+ * переопределяется через `tag` (см. Confirm-ai.md), и тогда в DOM окажется
+ * не заголовок.
+ */
+declare const ConfirmContentTitle: default_2.ForwardRefExoticComponent<IConfirmContentTitleProps & default_2.RefAttributes<HTMLElement>>;
 
-declare const ConfirmControls: default_2.FC<IConfirmControlsProps>;
+/** Контейнер кнопок действий предупреждения. Запрещает перенос кнопок на новую строку. */
+declare const ConfirmControls: default_2.ForwardRefExoticComponent<IConfirmControlsProps & default_2.RefAttributes<HTMLDivElement>>;
 
 export declare const createSizeToClassNameMap: (styles: Record<string, string>) => Record<EComponentSize, string>;
 
@@ -556,8 +603,12 @@ export declare const DatePickerExtended: default_2.ForwardRefExoticComponent<IDa
  */
 export declare const DatePickerExtendedContext: default_2.Context<IDatePickerExtendedContext>;
 
-/** Выбор диапазона дат. */
-export declare const DateRange: default_2.FC<IDateRangeProps>;
+/**
+ * Выбор диапазона дат. Рендерит два поля выбора даты и кнопки сдвига диапазона,
+ * которые передаются через render-props. Следит за тем, чтобы дата "от" не была
+ * больше даты "до", и сдвигает обе границы диапазона сразу.
+ */
+export declare const DateRange: default_2.ForwardRefExoticComponent<IDateRangeProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Утилита типов, которая делает все свойства объекта (и его вложенные свойства) необязательными. */
 export declare type DeepPartial<T> = T extends BuiltIn ? T : T extends object ? {
@@ -918,9 +969,13 @@ export declare enum EComponentSize {
  *  От этого зависит максимальная ширина Confirm.
  */
 export declare enum EConfirmParentComponent {
+    /** LightBox — ширина контента лайтбокса. */
     LIGHTBOX = "lightBox",
+    /** LightBoxSideOverlay размера SM. */
     SIDE_OVERLAY_SM = "sideOverlaySM",
+    /** LightBoxSideOverlay размера MD. */
     SIDE_OVERLAY_MD = "sideOverlayMD",
+    /** LightBoxSideOverlay размера LG. */
     SIDE_OVERLAY_LG = "sideOverlayLG"
 }
 
@@ -1547,10 +1602,11 @@ export declare const FormFieldInput: default_2.ForwardRefExoticComponent<IFormFi
  * Лейбл поля ввода/селекта.
  *
  * Отображается по середине поля ввода; когда инпут/селект имеет значение или фокус,
- * перемещается в верхний левый угол. Атрибут htmlFor берётся из FormFieldContext (targetId),
- * собственный идентификатор публикуется в контекст как labelId.
+ * перемещается в верхний левый угол. Собственный идентификатор публикуется в контекст как labelId.
+ *
+ * Тег зависит от того, есть ли в поле labelable-элемент (input, textarea, select).
  */
-export declare const FormFieldLabel: default_2.ForwardRefExoticComponent<IFormFieldLabelProps & default_2.RefAttributes<HTMLLabelElement>>;
+export declare const FormFieldLabel: default_2.ForwardRefExoticComponent<IFormFieldLabelProps & default_2.RefAttributes<HTMLElement>>;
 
 /**
  * Компонент маскированного ввода.
@@ -1822,21 +1878,28 @@ declare interface IAmountConst {
 export declare interface IAmountFieldProps extends Omit<ITextFieldBaseProps, "children"> {
     /** Свойства поля ввода. */
     inputProps: Omit<IFormFieldInputProps, "type" | "maxLength" | "onChange" | "inputMode" | "autoComplete"> & {
-        /** Значение. */
+        /** Значение. Хранится без разделителей разрядов, с точкой в роли десятичного разделителя ("1234.56"). */
         value: string;
-        /** Обработчик изменения значения. */
+        /** Обработчик изменения значения. Получает нормализованное значение, а не то, что видно в поле. */
         onChange: (value: string) => void;
         /** Ссылка на HTML-элемент поля ввода. */
         ref?: default_2.Ref<HTMLInputElement>;
     };
-    /** Наименование валюты. */
+    /** Наименование валюты. Отображается справа от значения, пока значение не пустое. */
     currency?: string;
-    /** Максимальное количество знаков перед запятой. */
+    /** Максимальное количество знаков перед запятой. По умолчанию 16. */
     maxIntegerDigits?: number;
-    /** Количество знаков после запятой. */
+    /** Количество знаков после запятой. По умолчанию 2. */
     fractionDigits?: number;
-    /** Обработчик очищения значения. */
+    /** Обработчик очищения значения. Если передан, в постфиксе поля отображается кнопка очистки. */
     onClear?: () => void;
+    /**
+     * Свойства кнопки очистки. Имеют смысл только вместе с onClear.
+     *
+     * Кнопка содержит лишь иконку, поэтому доступное имя задаётся здесь: передайте aria-label
+     * на языке интерфейса. Обработчик клика задаётся через onClear и здесь не переопределяется.
+     */
+    clearProps?: Omit<IFormFieldClearProps, "onClick">;
 }
 
 /** Свойства компонента Amount. */
@@ -1857,9 +1920,9 @@ export declare interface IAmountProps extends default_2.HTMLAttributes<HTMLSpanE
 
 /** Свойства компонента Avatar. */
 export declare interface IAvatarProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Размер. */
+    /** Размер. Задаёт ширину и высоту квадратной области аватара. */
     size: EAvatarSize;
-    /** Радиус скругления. */
+    /** Радиус скругления, px. */
     borderRadius: TAvatarBorderRadius;
 }
 
@@ -2277,14 +2340,6 @@ export declare interface ICardProps extends default_2.HTMLAttributes<HTMLDivElem
     theme?: ECardTheme;
 }
 
-/** Внутренние составляющие статичной карточки. */
-declare interface ICardStaticComposition {
-    /** Контент карточки. */
-    Content: typeof CardContent;
-    /** Медийный элемент карточки. */
-    Media: typeof CardMedia;
-}
-
 /**
  * Свойства, которые CarouselExtended передаёт в рендер-функции кнопок прокрутки:
  * `disabled` (край ленты достигнут), `hidden` (прокрутка не нужна) и `onClick`.
@@ -2314,18 +2369,6 @@ export declare interface ICarouselExtendedProps extends default_2.HTMLAttributes
 export declare interface ICarouselIndicatorsProps extends React.HTMLAttributes<HTMLDivElement> {
     /** Свойства для кнопок-индикаторов. */
     indicatorProps?: TCarouselIndicatorProps | TCarouselIndicatorPropsFactory;
-    /**
-     * Кастомный рендер индикатора.
-     * `props` содержат вычисленные role/tabIndex/aria-selected, className и onClick;
-     * `ref` необходимо прокинуть на интерактивный элемент для корректного управления фокусом.
-     */
-    renderIndicator?: (args: {
-        index: number;
-        page: number;
-        selected: boolean;
-        props: TCarouselIndicatorProps;
-        ref: React.RefCallback<HTMLButtonElement>;
-    }) => React.ReactNode;
 }
 
 /** Свойства компонента CarouselItem. */
@@ -2367,10 +2410,15 @@ export declare interface ICheckboxProps extends Omit<default_2.InputHTMLAttribut
 
 /** Описание чекбокса компонента CheckboxTree. */
 export declare interface ICheckboxTreeCheckboxData {
+    /** Идентификатор узла. Должен быть уникальным в пределах дерева — по нему строится клавиатурная навигация. */
     id: string;
+    /** Подпись чекбокса. */
     label: default_2.ReactNode;
+    /** Признак выбора. Для узла с потомками пересчитывается компонентом. */
     checked: boolean;
+    /** Признак частичного выбора: вместо галочки рисуется bulk-иконка. Для узла с потомками пересчитывается компонентом. */
     bulk?: boolean;
+    /** Вложенные чекбоксы. Их состояние связано с родительским каскадно — вверх и вниз по дереву. */
     children?: ICheckboxTreeCheckboxData[];
 }
 
@@ -2390,6 +2438,20 @@ export declare interface ICheckboxTreeExtendedCheckboxProvideProps {
     opened?: boolean;
 }
 
+/**
+ * CheckboxTreeExtended вместе с составными частями.
+ *
+ * Явная аннотация снимает проверку лишних свойств у Object.assign, поэтому при добавлении
+ * или удалении статики этот интерфейс нужно править синхронно: иначе новая статика окажется
+ * в рантайме, но не попадёт в публичный тип, и TypeScript промолчит.
+ */
+export declare interface ICheckboxTreeExtendedFC extends default_2.ForwardRefExoticComponent<ICheckboxTreeExtendedProps & default_2.RefAttributes<HTMLUListElement>> {
+    /** Чекбокс ноды дерева. */
+    Checkbox: typeof CheckboxTreeExtendedCheckbox;
+    /** Нода дерева. */
+    Node: typeof CheckboxTreeExtendedNode;
+}
+
 /** Свойства CheckboxTreeExtendedNode. */
 export declare interface ICheckboxTreeExtendedNodeProps extends Omit<ICollapsibleTreeExtendedNodeProps, "children" | "renderBody" | "renderHeader"> {
     /** Render-функция компонента чекбокс. */
@@ -2406,20 +2468,18 @@ export declare interface ICheckboxTreeExtendedProps extends ICollapsibleTreeExte
     size?: EComponentSize;
 }
 
-/** CheckboxTreeExtended вместе с составными частями. */
-export declare interface ICheckboxTreeExtendedSFC extends default_2.FC<ICheckboxTreeExtendedProps> {
-    /** Чекбокс ноды дерева. */
-    Checkbox: typeof CheckboxTreeExtendedCheckbox;
-    /** Нода дерева. */
-    Node: typeof CheckboxTreeExtendedNode;
-}
+/**
+ * @deprecated Используйте ICheckboxTreeExtendedFC. Алиас сохранён, чтобы не ломать существующие импорты.
+ */
+export declare type ICheckboxTreeExtendedSFC = ICheckboxTreeExtendedFC;
 
 /** Свойства CheckboxTree. */
 export declare interface ICheckboxTreeProps extends Omit<ICheckboxTreeExtendedProps, "children" | "onChange"> {
+    /** Дерево строится из checkboxes — собственную разметку узлов передать нельзя. Для неё есть CheckboxTreeExtended. */
     children?: never;
-    /** Набор чекбоксов. */
+    /** Набор чекбоксов. Дерево задаётся вложенностью children у элементов набора. */
     checkboxes: ICheckboxTreeCheckboxData[];
-    /** Обработчик изменения чекбоксов. */
+    /** Обработчик изменения чекбоксов. Получает новый массив с пересчитанными флагами checked и bulk. */
     onChange: (options: ICheckboxTreeCheckboxData[]) => void;
 }
 
@@ -2607,6 +2667,18 @@ export declare interface IChipSuggestTargetProps<T extends ISuggestOption> exten
     clearSelected?: () => void;
 }
 
+/**
+ * Тип компонента "Низкоуровневое дерево с раскрывающимися узлами" со статическими субкомпонентами.
+ *
+ * Явная аннотация снимает проверку лишних свойств у Object.assign, поэтому при добавлении
+ * или удалении статики этот интерфейс нужно править синхронно: иначе новая статика окажется
+ * в рантайме, но не попадёт в публичный тип, и TypeScript промолчит.
+ */
+export declare interface ICollapsibleTreeExtendedFC extends default_2.ForwardRefExoticComponent<ICollapsibleTreeExtendedProps & default_2.RefAttributes<HTMLUListElement>> {
+    /** Нода дерева. */
+    Node: typeof CollapsibleTreeExtendedNode;
+}
+
 /** Свойства, передаваемые CollapsibleTreeExtendedNode в рендер-функцию renderBody. */
 export declare interface ICollapsibleTreeExtendedNodeBodyProvideProps extends Pick<IAccordionBodyProvideProps, "animating">, Pick<ITreeViewNodeProvideProps, "activeNode" | "hasChildNodes"> {
     /** Текущая нода раскрыта. */
@@ -2636,9 +2708,10 @@ export declare interface ICollapsibleTreeExtendedNodeProps extends Omit<ITreeVie
 export declare interface ICollapsibleTreeExtendedProps extends ITreeViewProps {
 }
 
-export declare interface ICollapsibleTreeExtendedSFC extends default_2.FC<ICollapsibleTreeExtendedProps> {
-    Node: typeof CollapsibleTreeExtendedNode;
-}
+/**
+ * @deprecated Используйте ICollapsibleTreeExtendedFC. Алиас сохранён, чтобы не ломать существующие импорты.
+ */
+export declare type ICollapsibleTreeExtendedSFC = ICollapsibleTreeExtendedFC;
 
 /** Ветка дерева CollapsibleTree — раскрывающийся узел с заголовком и дочерними узлами. */
 export declare interface ICollapsibleTreeNodeBranch {
@@ -2757,9 +2830,14 @@ export declare interface IComposedKeyDownListenerProps {
     keyDownListeners: IKeyDownListenerProps[];
 }
 
+/**
+ * Свойства компонента ConfirmCloseButton.
+ * Props кнопки, кроме theme, size и icon: их задаёт сам компонент.
+ */
 declare interface IConfirmCloseButtonProps extends Omit<TButtonProps, "theme" | "size" | "icon"> {
 }
 
+/** Свойства компонента ConfirmClose. */
 declare interface IConfirmCloseProps extends IConfirmCloseButtonProps {
     /**
      * Триггер click по нажатию Esc.
@@ -2767,8 +2845,17 @@ declare interface IConfirmCloseProps extends IConfirmCloseButtonProps {
     clickByEsc: boolean;
 }
 
-declare interface IConfirmContentFC extends default_2.FC<IConfirmContentProps> {
+/**
+ * Тип компонента "Содержимое предупреждения" со статическими субкомпонентами.
+ *
+ * Явная аннотация снимает проверку лишних свойств у Object.assign, поэтому при добавлении
+ * или удалении статики этот интерфейс нужно править синхронно: иначе новая статика окажется
+ * в рантайме, но не попадёт в публичный тип, и TypeScript промолчит.
+ */
+declare interface IConfirmContentFC extends default_2.ForwardRefExoticComponent<IConfirmContentProps & default_2.RefAttributes<HTMLDivElement>> {
+    /** Заголовок предупреждения. */
     Title: typeof ConfirmContentTitle;
+    /** Подзаголовок предупреждения. */
     SubTitle: typeof ConfirmContentSubTitle;
 }
 
@@ -2776,21 +2863,41 @@ declare interface IConfirmContentFC extends default_2.FC<IConfirmContentProps> {
 declare interface IConfirmContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
-/** Свойства компонента ConfirmContentSubTitle. */
-declare interface IConfirmContentSubTitleProps extends Partial<TTextProps<"div">> {
+/**
+ * Свойства компонента ConfirmContentSubTitle.
+ *
+ * `tag` берётся строкой из {@link ITypographyProps}, а не из параметра типа
+ * {@link Text}: обёртка не полиморфна, тег переопределяется любым именем.
+ */
+declare interface IConfirmContentSubTitleProps extends Omit<Partial<TTextProps<"div">>, "tag" | "ref">, Pick<ITypographyProps, "tag"> {
 }
 
-/** Свойства компонента ConfirmContentTitle. */
-declare interface IConfirmContentTitleProps extends Partial<TTitleProps<"h1">> {
+/**
+ * Свойства компонента ConfirmContentTitle.
+ *
+ * `tag` берётся строкой из {@link ITypographyProps}, а не из параметра типа
+ * {@link Title}: обёртка не полиморфна, тег переопределяется любым именем.
+ */
+declare interface IConfirmContentTitleProps extends Omit<Partial<TTitleProps<"h1">>, "tag" | "ref">, Pick<ITypographyProps, "tag"> {
 }
 
 /** Свойства компонента ConfirmControls. */
 declare interface IConfirmControlsProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
-export declare interface IConfirmFC extends default_2.FC<IConfirmProps> {
+/**
+ * Тип компонента "Предупреждение" со статическими субкомпонентами.
+ *
+ * Явная аннотация снимает проверку лишних свойств у Object.assign, поэтому при добавлении
+ * или удалении статики этот интерфейс нужно править синхронно: иначе новая статика окажется
+ * в рантайме, но не попадёт в публичный тип, и TypeScript промолчит.
+ */
+export declare interface IConfirmFC extends default_2.ForwardRefExoticComponent<IConfirmProps & default_2.RefAttributes<HTMLDivElement>> {
+    /** Кнопка закрытия предупреждения. */
     Close: typeof ConfirmClose;
+    /** Текстовое содержимое предупреждения — заголовок и подзаголовок. */
     Content: typeof ConfirmContent;
+    /** Контейнер кнопок действий. */
     Controls: typeof ConfirmControls;
 }
 
@@ -2798,6 +2905,7 @@ export declare interface IConfirmFC extends default_2.FC<IConfirmProps> {
 export declare interface IConfirmProps extends IIslandProps {
     /** Компонент, в котором используется Confirm.
      *  От этого зависит максимальная ширина контента Confirm.
+     *  По умолчанию EConfirmParentComponent.LIGHTBOX.
      */
     parentComponent?: EConfirmParentComponent;
 }
@@ -2867,15 +2975,21 @@ export declare interface IDatePickerExtendedProps extends Omit<default_2.HTMLAtt
 
 /** Свойства функции рендеринга кнопки сдвига диапазона дат. */
 export declare interface IDateRangeButtonProvideProps {
+    /** Иконка направления сдвига. */
     children: default_2.ReactNode;
+    /** Класс кнопки сдвига. */
     className: string;
+    /** Обработчик клика, сдвигающий диапазон дат. */
     onClick: () => void;
+    /** Кнопка недоступна — диапазон дат заполнен не полностью. */
     disabled: boolean;
 }
 
 /** Свойства функции рендеринга поля выбора даты. */
 export declare interface IDateRangePickerProvideProps {
+    /** Дата в формате YYYYMMDD, пустая строка — дата не выбрана. */
     value: string;
+    /** Обработчик изменения даты. Принимает дату в формате YYYYMMDD. */
     onChange: (value: string) => void;
 }
 
@@ -2885,11 +2999,11 @@ export declare interface IDateRangeProps extends Omit<default_2.HTMLAttributes<H
     value: TDateRangeValue;
     /** Функция, вызывающаяся при изменении диапазона дат. */
     onChange: (value: TDateRangeValue) => void;
-    /** Численная величина сдвига диапазона дат. */
+    /** Численная величина сдвига диапазона дат. По умолчанию 1. */
     shiftAmount?: number;
-    /** Единица измерения сдвига диапазона дат. */
+    /** Единица измерения сдвига диапазона дат. По умолчанию EDateRangeShiftUnit.MONTH. */
     shiftUnit?: EDateRangeShiftUnit;
-    /** Управление отображением/скрытием кнопок сдвига диапазона дат. */
+    /** Управление отображением/скрытием кнопок сдвига диапазона дат. По умолчанию false. */
     hideNavigation?: boolean;
     /** Функция рендеринга поля выбора даты "от". */
     renderPickerFrom: (props: IDateRangePickerProvideProps) => default_2.ReactNode;
@@ -3197,7 +3311,7 @@ export declare interface IFormFieldInputProvideProps extends default_2.InputHTML
 }
 
 /** Свойства компонента FormFieldLabel. */
-export declare interface IFormFieldLabelProps extends Omit<default_2.LabelHTMLAttributes<HTMLLabelElement>, "htmlFor"> {
+export declare interface IFormFieldLabelProps extends default_2.HTMLAttributes<HTMLElement> {
     /** Label отображается в уменьшенном виде над полем ввода/селектом. Если значение не задано, вычисляется как filled || active из FormFieldContext. */
     floating?: boolean;
 }
@@ -3241,8 +3355,13 @@ export declare interface IFormFieldTargetProps extends Omit<default_2.HTMLAttrib
     placeholder?: default_2.ReactNode;
 }
 
-/** Свойства компонента FormFieldTextarea. */
-export declare interface IFormFieldTextareaProps extends default_2.TextareaHTMLAttributes<HTMLTextAreaElement> {
+/**
+ * Свойства компонента FormFieldTextarea.
+ *
+ * Атрибут disabled исключён намеренно: блокировка задаётся статусом поля (EFormFieldStatus.DISABLED), и переданное
+ * значение всё равно было бы перетёрто. Так же устроен FormFieldInput.
+ */
+export declare interface IFormFieldTextareaProps extends Omit<default_2.TextareaHTMLAttributes<HTMLTextAreaElement>, "disabled"> {
 }
 
 /** Свойства компонента FormGroup. */
@@ -4924,16 +5043,20 @@ declare interface ISliderExtendedTrackProps extends default_2.HTMLAttributes<HTM
 export declare interface ISliderMark {
     /** Значение расположения метки, должно быть в диапазоне от min до max. */
     value: number;
+    /** Содержимое метки. */
     label: default_2.ReactNode;
 }
 
+/** Свойства компонента Slider. */
 export declare interface ISliderProps extends Omit<ISliderExtendedProps, "onChange" | "step">, Pick<ISliderExtendedDotProps, "onChange" | "value"> {
+    /** Слайдер собирается компонентом и не принимает содержимого. */
     children?: never;
     /** Массив меток под полосой слайдера. */
     marks: ISliderMark[];
     /**
      * Длина шага, например при длине шага 1, с min-0. max-100, слайдер будет разделен на 100 шагов.
      * Вместо длины шага можно передать массив шагов, например [0, 25, 50, 75, 100]. Будет 3 возможные позиции между min и max. Начальное значение должно быть равно min, последнее значение должно быть равно max.
+     * По умолчанию 1.
      */
     step?: number | number[];
     /** Содержимое тултипа, отображаемого при наведении на точку и перемещении. */
@@ -4944,20 +5067,24 @@ export declare interface ISliderProps extends Omit<ISliderExtendedProps, "onChan
 export declare interface ISliderRangeMark {
     /** Значение расположения метки, должно быть в диапазоне от min до max. */
     value: number;
+    /** Содержимое метки. */
     label: default_2.ReactNode;
 }
 
+/** Свойства компонента SliderRange. */
 export declare interface ISliderRangeProps extends Omit<ISliderExtendedProps, "onChange" | "step"> {
+    /** Состав слайдера фиксирован, содержимое не передаётся. */
     children?: never;
-    /** Трек можно передвигать. По-умолчанию true. */
+    /** Трек можно передвигать. По умолчанию true. */
     draggableTrack?: boolean;
     /** Массив меток под полосой слайдера. */
     marks: ISliderRangeMark[];
-    /** Обработчик изменения значений. */
+    /** Обработчик изменения значений. Вызывается с отсортированной парой значений. */
     onChange: (values: TSliderRangeValues) => void;
     /**
      * Длина шага, например при длине шага 1, с min-0. max-100, слайдер будет разделен на 100 шагов.
      * Вместо длины шага можно передать массив шагов, например [0, 25, 50, 75, 100]. Начальное значение должно быть равно min, последнее значение должно быть равно max.
+     * По умолчанию 1.
      */
     step?: number | number[];
     /** Значения Range - массив из двух чисел, в соответствии которому строятся ползунки. Оба числа должны быть в диапазоне от min до max. */
@@ -5627,15 +5754,15 @@ export declare interface ITabsItem extends Omit<ITabsExtendedTabProps, "children
     showNotificationIcon?: boolean;
 }
 
-/** Общие свойства TabsLineDesktop и TabsLine Mobile. */
-export declare interface ITabsLineBaseProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+/** Общие свойства TabsLineDesktop и TabsLineMobile. */
+export declare interface ITabsLineBaseProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "children"> {
     /** Коллекция табов. */
     tabs: ITabsLineItemProps[];
-    /** Коллбек смены таба. */
+    /** Коллбек смены таба. Вызывается с идентификатором таба, по которому кликнули. */
     onChangeTab: (tabId: string) => void;
     /** Идентификатор выбранного таба. */
     selectedId: string;
-    /** Размер компонента. */
+    /** Размер компонента. По умолчанию EComponentSize.MD. */
     size?: EComponentSize;
 }
 
@@ -5643,7 +5770,7 @@ export declare interface ITabsLineBaseProps extends Omit<React.HTMLAttributes<HT
 export declare interface ITabsLineDesktopProps extends ITabsLineBaseProps {
     /** Атрибуты кнопки дропдауна. */
     dropdownTargetHtmlAttributes?: default_2.HTMLAttributes<HTMLButtonElement> & TestProps;
-    /** Максимальное число отображаемых табов. */
+    /** Максимальное число элементов строки, включая кнопку дропдауна. Без него все табы остаются в строке. */
     maxVisible?: number;
 }
 
@@ -5659,35 +5786,35 @@ declare interface ITabsLineDropdownProps extends default_2.HTMLAttributes<HTMLDi
     onClickTab: (tab: ITabsLineItemProps) => void;
     /** Выбранный таб. */
     selected?: ITabsLineItemProps;
-    /** Размер таба кнопки дропдауна. */
+    /** Размер таба кнопки дропдауна. По умолчанию EComponentSize.MD. */
     size?: EComponentSize;
     /** Атрибуты кнопки дропдауна. */
     targetHtmlAttributes?: default_2.HTMLAttributes<HTMLButtonElement> & TestProps;
 }
 
-/** Свойства TabsLineItem. */
+/** Свойства компонента TabsLineItem. */
 export declare interface ITabsLineItemProps extends default_2.HTMLAttributes<HTMLButtonElement>, TestProps {
-    /** Таб выбран. */
+    /** Таб выбран. По умолчанию false. */
     selected?: boolean;
-    /** Идентификатор таба. */
+    /** Идентификатор таба. Сопоставляется с selectedId и приходит в onChangeTab. В DOM не попадает. */
     id: string;
     /** Отображаемое значение. */
     label: string;
-    /** Флаг отображения значка новых уведомлений. */
+    /** Флаг отображения значка новых уведомлений. По умолчанию false. */
     showNotificationIcon?: boolean;
-    /** Размер таба. */
+    /** Размер таба. По умолчанию EComponentSize.MD. */
     size?: EComponentSize;
 }
 
-/** Свойства компонента ITabsLineMobileProps. */
+/** Свойства компонента TabsLineMobile. */
 declare interface ITabsLineMobileProps extends ITabsLineBaseProps {
 }
 
-/** Состояние компонента TabsLine. */
+/** Свойства компонента TabsLine. */
 export declare interface ITabsLineProps extends ITabsLineDesktopProps {
     /** Горизонтальный отступ от первого таба слева и последнего таба справа. */
     paddingX?: 0 | 8 | 16 | 24;
-    /** Разделитель в виде нижнего бордера. */
+    /** Разделитель в виде нижнего бордера. По умолчанию false. */
     withSeparator?: boolean;
 }
 
@@ -5746,8 +5873,11 @@ export declare interface ITagProps extends React.HTMLAttributes<HTMLSpanElement>
 
 /** Свойства компонента TextareaField. */
 export declare interface ITextareaFieldProps extends Omit<ITextFieldBaseProps, "children"> {
-    /** Свойства компонента FormFieldTextarea. */
-    textareaProps: IFormFieldTextareaProps & DataAttributes & React.RefAttributes<HTMLTextAreaElement>;
+    /**
+     * Свойства компонента FormFieldTextarea — атрибуты textarea, data-атрибуты
+     * и `ref` на сам элемент `<textarea>`.
+     */
+    textareaProps: IFormFieldTextareaProps & DataAttributes & default_2.RefAttributes<HTMLTextAreaElement>;
 }
 
 /** Свойства компонента TextFieldBase. */
@@ -6006,6 +6136,20 @@ declare interface ITreeViewContext {
     setOpenedNode: TTreeViewContextSetOpenedNode;
 }
 
+/**
+ * Тип компонента "Базовое дерево" со статическими субкомпонентами.
+ *
+ * Явная аннотация снимает проверку лишних свойств у Object.assign, поэтому при добавлении
+ * или удалении статики этот интерфейс нужно править синхронно: иначе новая статика окажется
+ * в рантайме, но не попадёт в публичный тип, и TypeScript промолчит.
+ */
+export declare interface ITreeViewFC extends default_2.ForwardRefExoticComponent<ITreeViewProps & default_2.RefAttributes<HTMLUListElement>> {
+    /** Группа дочерних нод. */
+    Group: typeof TreeViewGroup;
+    /** Нода дерева. */
+    Node: typeof TreeViewNode;
+}
+
 /** Свойства компонента TreeViewGroup. */
 export declare interface ITreeViewGroupProps extends default_2.HTMLAttributes<HTMLUListElement> {
 }
@@ -6052,22 +6196,14 @@ export declare interface ITreeViewProps extends default_2.HTMLAttributes<HTMLULi
     children: default_2.ReactNode;
 }
 
-/** Состояние TreeView. */
-declare interface ITreeViewState {
-    /**
-     * Число обновлений абстрактного дерева.
-     * Используется для индикации изменения дерева т.к. изменение мутируемого объекта rootNode не вызывает триггер изменения контекста.
-     */
-    updateCount: number;
-}
-
 /**
- * Свойства TriggerClickOnKeyDownEvent.
+ * Свойства компонента TriggerClickOnKeyDownEvent.
  */
-declare interface ITriggerClickOnKeyDownEventProps extends Pick<IKeyDownListenerProps, "eventKeyCode"> {
-    /** Ссылка на оборачиваемую кнопку. */
-    targetRef: default_2.RefObject<HTMLButtonElement>;
+export declare interface ITriggerClickOnKeyDownEventProps extends Pick<IKeyDownListenerProps, "eventKeyCode"> {
+    /** Содержимое. Рендерится как есть, без обёртки и без собственной разметки. */
     children: default_2.ReactElement;
+    /** Ссылка на кнопку, по которой выполняется клик. Скрытая кнопка кликом не вызывается. */
+    targetRef: default_2.RefObject<HTMLButtonElement>;
 }
 
 /** Свойства компонента типографики. */
@@ -6671,8 +6807,11 @@ export declare function setCaretPosition(field: HTMLInputElement | null, positio
  */
 export declare const Skeleton: default_2.FC<ISkeletonProps>;
 
-/** Слайдер с одним ползунком. */
-export declare const Slider: default_2.FC<ISliderProps>;
+/**
+ * Слайдер с одним ползунком — готовая сборка SliderExtended: полоса, ползунок, трек и метки.
+ * Значение контролируемое: компонент сообщает новое значение через onChange и ждёт его в value.
+ */
+export declare const Slider: default_2.ForwardRefExoticComponent<ISliderProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Компонент SliderExtended. */
 export declare const SliderExtended: default_2.ForwardRefExoticComponent<ISliderExtendedProps & default_2.RefAttributes<HTMLDivElement>> & {
@@ -6684,7 +6823,11 @@ export declare const SliderExtended: default_2.ForwardRefExoticComponent<ISlider
     Tooltip: default_2.ForwardRefExoticComponent<ISliderExtendedTooltipProps & default_2.RefAttributes<HTMLDivElement>>;
 };
 
-/** Слайдер с двумя ползунками. */
+/**
+ * Слайдер с двумя ползунками — готовая сборка SliderExtended для выбора диапазона.
+ * Компонент рисует ползунки по внутренним значениям и сообщает новую пару через onChange.
+ * Внутренние значения синхронизируются с values, когда потребитель присылает новую пару.
+ */
 export declare class SliderRange extends default_2.Component<ISliderRangeProps, ISliderRangeState> {
     static displayName: string;
     static defaultProps: Partial<ISliderRangeProps>;
@@ -6693,7 +6836,7 @@ export declare class SliderRange extends default_2.Component<ISliderRangeProps,
     render(): default_2.ReactNode;
     /** Проверка values, меньшее значение, должно быть перед большим. */
     private validateValues;
-    private sortValues;
+    /** Возвращает обработчик изменения значения ползунка с индексом valueIndex. */
     private handleChange;
 }
 
@@ -6928,18 +7071,29 @@ export declare const TabsExtendedTabContext: default_2.Context<ITabsExtendedTabC
  */
 export declare const TabsExtendedTabsWrapper: default_2.ForwardRefExoticComponent<ITabsExtendedTabsWrapperProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Компонент TabsLine. */
-export declare const TabsLine: default_2.FC<ITabsLineProps>;
+/**
+ * Линейка табов-подчёркиваний. На десктопе не поместившиеся по maxVisible табы уезжают в дропдаун,
+ * на мобильном (<768px) все табы остаются в строке с горизонтальной прокруткой.
+ */
+export declare const TabsLine: default_2.ForwardRefExoticComponent<ITabsLineProps & default_2.RefAttributes<HTMLDivElement>>;
 
-export declare const TabsLineDesktop: default_2.FC<ITabsLineDesktopProps>;
+/**
+ * Десктопный вариант TabsLine: табы в строку, не поместившиеся по maxVisible — в дропдауне.
+ * Клавиатурная навигация по табам строки — стрелками влево/вправо (roving tabIndex).
+ */
+export declare const TabsLineDesktop: default_2.ForwardRefExoticComponent<ITabsLineDesktopProps & default_2.RefAttributes<HTMLDivElement>>;
 
-export declare const TabsLineDropdown: default_2.FC<ITabsLineDropdownProps>;
+/** Таб-кнопка TabsLine, раскрывающая выпадающий список с не поместившимися табами. */
+export declare const TabsLineDropdown: default_2.ForwardRefExoticComponent<ITabsLineDropdownProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Компонент TabsLineItem. */
+/** Кнопка одного таба TabsLine: текст и опциональный значок новых уведомлений. */
 export declare const TabsLineItem: default_2.ForwardRefExoticComponent<ITabsLineItemProps & default_2.RefAttributes<HTMLButtonElement>>;
 
-/** Компонент TabsLineMobile. */
-export declare const TabsLineMobile: default_2.FC<ITabsLineMobileProps>;
+/**
+ * Мобильный вариант TabsLine: табы в одну строку с горизонтальной прокруткой, без дропдауна.
+ * Размер таба здесь всегда дефолтный: prop size мобильным вариантом не поддерживается.
+ */
+export declare const TabsLineMobile: default_2.ForwardRefExoticComponent<ITabsLineMobileProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
  * Компонент, который демонстрирует выбранное значение того или иного параметра.
@@ -6962,6 +7116,7 @@ export declare const TagGroup: default_2.ForwardRefExoticComponent<ITagGroupProp
  */
 export declare type TAriaHTMLAttributes = Record<string, string>;
 
+/** Допустимые радиусы скругления компонента Avatar, px. */
 export declare type TAvatarBorderRadius = 6 | 8 | 10 | 12 | 16;
 
 /** Вертикальные отступы BodyPage: одно значение на обе стороны либо раздельные значения для верха и низа. */
@@ -7026,7 +7181,7 @@ declare type TDataAttributeAlias = `data-${string}`;
  */
 export declare type TDataHTMLAttributes = Record<string, string>;
 
-/** Значение компонента DateRange. */
+/** Значение компонента DateRange — даты "от" и "до" в формате YYYYMMDD. */
 export declare type TDateRangeValue = [string, string];
 
 /** Тип HTML атрибутов компонента дня. */
@@ -7594,8 +7749,11 @@ export declare type TEventKeysValues = (typeof EVENT_KEYS)[TEventKeys];
 declare const Text_2: TextComponent;
 export { Text_2 as Text }
 
-/** Многострочное текстовое поле для ввода большого объема текста. */
-export declare const TextareaField: default_2.FC<ITextareaFieldProps>;
+/**
+ * Многострочное текстовое поле для ввода большого объема текста.
+ * Отличается от TextField элементом ввода — вместо input используется FormFieldTextarea.
+ */
+export declare const TextareaField: default_2.ForwardRefExoticComponent<ITextareaFieldProps & default_2.RefAttributes<HTMLDivElement>>;
 
 declare type TextComponent = (<T extends default_2.ElementType = "span">(props: TTextProps<T>) => default_2.ReactElement | null) & {
     displayName?: string;
@@ -7761,8 +7919,11 @@ export declare type TPickedDate = Moment | null;
 /** Внешний тип даты, который можно передать в компонент через свойства компонента. */
 export declare type TPickedDateProp = string | Moment | null;
 
-/** Обход ICheckboxData[]. */
-export declare const traverseCheckboxes: (checkboxes: ICheckboxTreeCheckboxData[], cb: (checkbox: ICheckboxTreeCheckboxData) => void) => void;
+/**
+ * Обход дерева чекбоксов в глубину, снизу вверх: callback вызывается сначала для потомков, затем для их родителя.
+ * Такой порядок обязателен для checkParentCheckboxes — состояние родителя считается по уже пересчитанным потомкам.
+ */
+export declare const traverseCheckboxes: (checkboxes: ICheckboxTreeCheckboxData[], callback: (checkbox: ICheckboxTreeCheckboxData) => void) => void;
 
 /**
  * Базовый компонент визуального дерева.
@@ -7771,49 +7932,12 @@ export declare const traverseCheckboxes: (checkboxes: ICheckboxTreeCheckboxData[
  * Устанавливает контекст для дочерних нод.
  * Реализует навигацию по дереву.
  *
+ * ref указывает на корневой <ul role="tree">.
+ *
  * Accessibility требования:
  * https://www.w3.org/TR/wai-aria-practices-1.1/examples/treeview/treeview-2/treeview-2a.html
  */
-export declare class TreeView extends default_2.Component<ITreeViewProps, ITreeViewState> {
-    static displayName: string;
-    static Node: default_2.ComponentType<Omit<ITreeViewNodePropsWithContext, "treeViewContext">>;
-    static Group: default_2.ForwardRefExoticComponent<ITreeViewGroupProps & default_2.RefAttributes<HTMLUListElement>>;
-    private readonly abstractRootNode;
-    /** Глобальный слушатель keydown подписан. Он нужен только пока в дереве есть активная нода. */
-    private keyDownListenerAttached;
-    constructor(props: ITreeViewProps);
-    componentWillUnmount(): void;
-    render(): JSX.Element;
-    /**
-     * Увеличивает счетчик обновлений абстрактного дерева.
-     * Значение попадает в контекст и сигнализирует дочерним нодам, что мутируемое дерево изменилось.
-     */
-    private incrementUpdateCount;
-    /**
-     * Обработка изменения контекста.
-     * Установка tabIndex={0} для первой ноды, и tabIndex={-1} для остальных.
-     */
-    private updateTabIndexNodes;
-    /** Добавляет ноду в родительскую ноду. */
-    private registerNode;
-    /** Удаляет ноду из родительской ноды. */
-    private removeNode;
-    /** Установка флага активности ноды. */
-    private setActiveNode;
-    /**
-     * Подписывает и отписывает глобальный слушатель keydown по наличию активной ноды.
-     * Пока активной ноды нет, дерево не обрабатывает стрелки и не отменяет скролл страницы.
-     */
-    private syncKeyDownListener;
-    /** Отписывает глобальный слушатель keydown. */
-    private detachKeyDownListener;
-    /** Установка флага opened ноды. */
-    private setOpenedNode;
-    /** Возвращает AbstractNode по id. */
-    private getNode;
-    /** Обработка нажатия на клавиш для навигации с клавиатуры. */
-    private handleKeyDown;
-}
+export declare const TreeView: ITreeViewFC;
 
 /**
  * Абстрактная нода TreeView.
@@ -7878,7 +8002,8 @@ export declare class TreeViewNodeWithContext extends default_2.Component<ITreeVi
 }
 
 /**
- * При нажатии на клавишу вызывает onClick на дочерний элемент.
+ * При нажатии на клавишу вызывает click на кнопке из targetRef.
+ * Клавиша слушается на window (через KeyDownListener), собственной разметки компонент не рендерит.
  */
 export declare const TriggerClickOnKeyDownEvent: default_2.FC<ITriggerClickOnKeyDownEventProps>;