@sberbusiness/triplex-next 1.46.0 → 1.48.0

package/index.d.ts

@@ -95,9 +95,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>>;
 
 /**
@@ -831,9 +840,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>;
 
@@ -843,11 +849,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>> & {
@@ -875,15 +885,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;
 
 /**
  * Обертка над базовым компонентом чекбокс.
@@ -910,10 +925,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;
 
 /**
@@ -1038,9 +1058,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.
@@ -1105,21 +1127,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<Omit<IConfirmContentSubTitleProps, "ref"> & 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<Omit<IConfirmContentTitleProps, "ref"> & 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>;
 
@@ -1163,8 +1210,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 ? {
@@ -1525,9 +1576,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"
 }
 
@@ -1844,11 +1899,17 @@ export declare enum ETabsExtendedType {
     TYPE_2 = "type2"
 }
 
+/** Статус тега, определяющий цвет фона. */
 export declare enum ETagColorStatus {
+    /** Нейтральный — статус по умолчанию. */
     DEFAULT = "default",
+    /** Успешное завершение. */
     SUCCESS = "success",
+    /** Информационное сообщение. */
     INFO = "info",
+    /** Предупреждение. */
     WARNING = "warning",
+    /** Ошибка. */
     ERROR = "error"
 }
 
@@ -2152,10 +2213,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>>;
 
 /**
  * Компонент маскированного ввода.
@@ -2427,21 +2489,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. */
@@ -2462,9 +2531,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;
 }
 
@@ -2875,14 +2944,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`.
@@ -2912,18 +2973,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. */
@@ -2965,10 +3014,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[];
 }
 
@@ -2988,6 +3042,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-функция компонента чекбокс. */
@@ -3004,20 +3072,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;
 }
 
@@ -3205,6 +3271,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"> {
     /** Текущая нода раскрыта. */
@@ -3234,9 +3312,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 {
@@ -3355,9 +3434,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.
@@ -3365,8 +3449,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;
 }
 
@@ -3386,9 +3479,19 @@ declare interface IConfirmContentTitleProps extends Partial<TTitleProps<"h1">> {
 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;
 }
 
@@ -3396,6 +3499,7 @@ export declare interface IConfirmFC extends default_2.FC<IConfirmProps> {
 export declare interface IConfirmProps extends IIslandProps {
     /** Компонент, в котором используется Confirm.
      *  От этого зависит максимальная ширина контента Confirm.
+     *  По умолчанию EConfirmParentComponent.LIGHTBOX.
      */
     parentComponent?: EConfirmParentComponent;
 }
@@ -3465,15 +3569,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;
 }
 
@@ -3483,11 +3593,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;
@@ -3795,7 +3905,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;
 }
@@ -3839,8 +3949,13 @@ export declare interface IFormFieldTargetProps extends default_2.HTMLAttributes<
     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. */
@@ -5520,16 +5635,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[];
     /** Содержимое тултипа, отображаемого при наведении на точку и перемещении. */
@@ -5540,20 +5659,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. */
@@ -5667,39 +5790,57 @@ export declare interface ISpoilerUncontrolledProps extends ISpoilerBaseProps {
 
 /** Свойства компонента StatusTrackerBody. */
 export declare interface IStatusTrackerBodyProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое блока: StatusTracker.Body.Status, .StatusGroup, .Alert. */
+    children?: default_2.ReactNode;
 }
 
+/** Свойства компонента StatusTrackerButton. Тема LINK недоступна: блочный режим для неё не поддерживается. */
 export declare type IStatusTrackerButtonProps = Exclude<TButtonProps, IButtonLinkProps>;
 
 /** Свойства компонента StatusTrackerDescription. */
 export declare interface IStatusTrackerDescriptionProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Текст пояснения. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента StatusTrackerFooter. */
 export declare interface IStatusTrackerFooterProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое блока: StatusTracker.Footer.Button, .Description. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента StatusTrackerHeader. */
 export declare interface IStatusTrackerHeaderProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое блока: StatusTracker.Header.Title, .Sum, .Description. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента StatusTracker. */
 export declare interface IStatusTrackerProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Тип статуса документа. Задаёт цвет декоративного градиента на фоне. */
     type: EStatusTrackerType;
+    /** Вертикальное выравнивание контента внутри карточки. По умолчанию EStatusTrackerVerticalAlign.TOP. */
     verticalAlign?: EStatusTrackerVerticalAlign;
+    /** Содержимое карточки: StatusTracker.Media, .Header, .Body, .Footer в любом сочетании. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента StatusTrackerStatusGroup. */
 declare interface IStatusTrackerStatusGroup extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Список статусов: StatusTracker.Body.Status. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента StatusTrackerSum. */
 export declare interface IStatusTrackerSumProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Свойства суммы. Передаются во вложенный компонент Amount как есть. */
     amountProps: IAmountProps;
 }
 
 /** Свойства компонента StatusTrackerTitle. */
 export declare interface IStatusTrackerTitleProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Текст заголовка. */
+    children?: default_2.ReactNode;
 }
 
 /** Внутренние составляющие Stepper. */
@@ -5714,25 +5855,27 @@ declare interface IStepperExtendedComposition {
 
 /** Свойства компонента StepperExtended. */
 export declare interface IStepperExtendedProps extends default_2.HTMLAttributes<HTMLOListElement> {
-    /** Размер. */
+    /** Шаги. Ожидаются элементы StepperExtended.Step. */
+    children?: default_2.ReactNode;
+    /** Размер шагов. По умолчанию EComponentSize.MD. */
     size?: EComponentSize;
-    /** Уникальный идентификатор выбранного шага. */
+    /** Уникальный идентификатор выбранного шага. Сопоставляется с id шага. */
     selectedStepId?: string;
-    /** Обработчик выбора шага. */
+    /** Обработчик выбора шага. Вызывается с id шага по клику или по Enter/Space на шаге без disabled. */
     onSelectStep: (id: string) => void;
-    /** Ссылка на список шагов. */
+    /** Ссылка на список шагов (элемент ol). Дублирует ref, оставлен для обратной совместимости. */
     forwardedRef?: default_2.Ref<HTMLOListElement>;
 }
 
 /** Свойства компонента Stepper. */
 export declare interface IStepperProps extends Omit<IStepperExtendedProps, "children"> {
-    /** Шаги. */
+    /** Шаги. Порядок массива задаёт порядок отображения; шаги после выбранного считаются непройденными. */
     steps: Array<IStepperStep>;
 }
 
 /** Свойства шага в Stepper */
 export declare interface IStepperStep extends IStepperStepProps {
-    /** Название шага. */
+    /** Название шага. Попадает в содержимое шага, остальные поля — в его HTML-атрибуты. */
     label?: default_2.ReactNode;
 }
 
@@ -5743,7 +5886,9 @@ declare interface IStepperStepComposition {
 
 /** Свойства компонента StepperStep. */
 export declare interface IStepperStepProps extends default_2.LiHTMLAttributes<HTMLLIElement> {
+    /** Уникальный идентификатор шага. Сопоставляется с selectedStepId и приходит в onSelectStep. */
     id: string;
+    /** Шаг недоступен для выбора: не реагирует на клик, клавиатуру и выпадает из таб-порядка. */
     disabled?: boolean;
     /** Иконка, отображающая статус шага. */
     icon?: default_2.ReactNode;
@@ -5835,7 +5980,8 @@ export declare interface ISuggestFieldDesktopProps<T extends ISuggestFieldOption
 
 /** Свойства компонента SuggestFieldMobileDropdownHint. */
 export declare interface ISuggestFieldMobileDropdownHintProps {
-    children?: React.ReactNode;
+    /** Текст подсказки. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента SuggestFieldMobileDropdown. */
@@ -5884,7 +6030,7 @@ export declare interface ISuggestFieldProps<T extends ISuggestFieldOption = ISug
     onFilter: (value: string) => void;
     /** Обработчик окончания скролла списка (доступные в данный момент элементы закончились). */
     onScrollEnd?: () => void;
-    /** Обработчик отчиски поля. */
+    /** Обработчик очистки поля. Кнопка очистки отображается, только если обработчик передан. */
     onClear?: default_2.MouseEventHandler<HTMLButtonElement>;
     /** Рендер-функция поля ввода. */
     renderInput?: (props: IFormFieldInputProps) => JSX.Element;
@@ -6218,20 +6364,23 @@ export declare interface ITabsExtendedTabProps extends Omit<default_2.HTMLAttrib
 export declare interface ITabsExtendedTabsWrapperProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
+/** Описание одного таба. Неизвестные компоненту атрибуты уходят на контейнер таба. */
 export declare interface ITabsItem extends Omit<ITabsExtendedTabProps, "children" | "onSelect"> {
+    /** Содержимое таба: текст или произвольная разметка. */
     label: default_2.ReactNode;
+    /** Значок новых уведомлений на табе. */
     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;
 }
 
@@ -6239,7 +6388,7 @@ export declare interface ITabsLineBaseProps extends Omit<React.HTMLAttributes<HT
 export declare interface ITabsLineDesktopProps extends ITabsLineBaseProps {
     /** Атрибуты кнопки дропдауна. */
     dropdownTargetHtmlAttributes?: default_2.HTMLAttributes<HTMLButtonElement> & TestProps;
-    /** Максимальное число отображаемых табов. */
+    /** Максимальное число элементов строки, включая кнопку дропдауна. Без него все табы остаются в строке. */
     maxVisible?: number;
 }
 
@@ -6255,61 +6404,67 @@ 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;
 }
 
+/** Свойства компонента Tabs. */
 export declare interface ITabsProps extends ITabsExtendedProps {
     /** HTML-атрибуты dropdown-кнопки. */
     buttonDropdownAttributes?: default_2.ButtonHTMLAttributes<HTMLButtonElement>;
+    /** Содержимое задаётся массивом tabs, children не поддерживается. */
     children?: never;
-    /** Обработчик выбора таба. */
+    /** Обработчик выбора таба. Принимает id выбираемого таба. */
     onSelectTab: (selectedId: string) => void;
-    /** Размер компонента. */
+    /** Размер компонента. По умолчанию EComponentSize.MD. */
     size?: EComponentSize;
     /** Массив табов. */
     tabs: Array<ITabsItem>;
 }
 
-/** Свойства компонента Tag. */
+/** Свойства компонента TagColor. */
 export declare interface ITagColorProps extends React.HTMLAttributes<HTMLSpanElement> {
-    /** Размер. */
+    /** Содержимое метки. Рендерится во вложенном span, длинный текст обрезается многоточием. */
+    children?: React.ReactNode;
+    /** Размер. Задаёт высоту, отступы, радиус скругления и размер текста. */
     size: EComponentSize;
-    /** Статус. */
+    /** Статус. Определяет цвет фона. По умолчанию ETagColorStatus.DEFAULT. */
     status?: ETagColorStatus;
 }
 
 /** Свойства компонента TagGroup. */
-export declare interface ITagGroupProps extends React.HTMLAttributes<HTMLDivElement> {
-    /** Размер. */
+export declare interface ITagGroupProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое группы, обычно набор Tag. */
+    children?: default_2.ReactNode;
+    /** Размер. Задаёт только отступ между тегами, размер самих тегов не меняет. */
     size: EComponentSize;
 }
 
@@ -6342,8 +6497,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. */
@@ -6586,6 +6744,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> {
 }
@@ -6632,22 +6804,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>;
 }
 
 /** Свойства компонента типографики. */
@@ -6700,16 +6864,18 @@ export declare interface IUnorderedListProps extends Omit<IUnorderedListExtended
     items?: IUnorderedListItemProps[];
 }
 
+/** Свойства, которые UploadZone передаёт в children-функцию. */
 export declare interface IUploadZoneChildrenProvideProps {
     /** Открытие диалогового окна выбора файла(ов). */
     openUploadDialog: () => void;
 }
 
+/** Свойства компонента UploadZoneInput. */
 export declare interface IUploadZoneInputProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement>, "onChange"> {
 }
 
 /** Свойства компонента UploadZone. */
-declare interface IUploadZoneProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "onChange" | "children"> {
+export declare interface IUploadZoneProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "onChange" | "children"> {
     /** В качестве чилда передаётся функция. */
     children: (props: IUploadZoneChildrenProvideProps) => default_2.ReactNode;
     /** Обработчик изменения значения. */
@@ -7239,8 +7405,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>> & {
@@ -7252,7 +7421,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>;
@@ -7261,7 +7434,7 @@ export declare class SliderRange extends default_2.Component<ISliderRangeProps,
     render(): default_2.ReactNode;
     /** Проверка values, меньшее значение, должно быть перед большим. */
     private validateValues;
-    private sortValues;
+    /** Возвращает обработчик изменения значения ползунка с индексом valueIndex. */
     private handleChange;
 }
 
@@ -7287,72 +7460,81 @@ export declare const SMSFieldTooltip: default_2.FC<ISMSFieldTooltipProps>;
 export declare const Spoiler: default_2.ForwardRefExoticComponent<TSpoilerProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
- * Компонент предназначен для визуального отображения статуса документа.
+ * Карточка статуса документа: декоративный градиент по типу статуса плюс композиция
+ * из блоков Media, Header, Body и Footer.
  */
 export declare const StatusTracker: default_2.ForwardRefExoticComponent<IStatusTrackerProps & default_2.RefAttributes<HTMLDivElement>> & {
-    Media: default_2.FC<StatusTrackerMediaProps>;
+    Media: default_2.ForwardRefExoticComponent<StatusTrackerMediaProps & default_2.RefAttributes<HTMLDivElement>>;
     Header: default_2.ForwardRefExoticComponent<IStatusTrackerHeaderProps & default_2.RefAttributes<HTMLDivElement>> & {
-        Title: default_2.FC<IStatusTrackerTitleProps>;
-        Sum: default_2.FC<IStatusTrackerSumProps>;
-        Description: default_2.FC<IStatusTrackerDescriptionProps>;
+        Title: default_2.ForwardRefExoticComponent<IStatusTrackerTitleProps & default_2.RefAttributes<HTMLElement>>;
+        Sum: default_2.ForwardRefExoticComponent<IStatusTrackerSumProps & default_2.RefAttributes<HTMLElement>>;
+        Description: default_2.ForwardRefExoticComponent<IStatusTrackerDescriptionProps & default_2.RefAttributes<HTMLElement>>;
     };
     Body: default_2.ForwardRefExoticComponent<IStatusTrackerBodyProps & default_2.RefAttributes<HTMLDivElement>> & {
-        Alert: default_2.FC<IAlertProcessProps>;
-        Status: default_2.FC<IMarkerStatusProps>;
+        Alert: default_2.ForwardRefExoticComponent<IAlertProcessProps & default_2.RefAttributes<HTMLDivElement>>;
+        Status: default_2.ForwardRefExoticComponent<IMarkerStatusProps & default_2.RefAttributes<HTMLDivElement>>;
         StatusGroup: default_2.ForwardRefExoticComponent<IStatusTrackerStatusGroup & default_2.RefAttributes<HTMLDivElement>>;
     };
     Footer: default_2.ForwardRefExoticComponent<IStatusTrackerFooterProps & default_2.RefAttributes<HTMLDivElement>> & {
-        Button: default_2.FC<IStatusTrackerButtonProps>;
-        Description: default_2.FC<IStatusTrackerDescriptionProps>;
+        Button: default_2.ForwardRefExoticComponent<IStatusTrackerButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
+        Description: default_2.ForwardRefExoticComponent<IStatusTrackerDescriptionProps & default_2.RefAttributes<HTMLElement>>;
     };
 };
 
 /** Блок с основным контентом статус-трекера. */
 export declare const StatusTrackerBody: default_2.ForwardRefExoticComponent<IStatusTrackerBodyProps & default_2.RefAttributes<HTMLDivElement>> & {
-    Alert: default_2.FC<IAlertProcessProps>;
-    Status: default_2.FC<IMarkerStatusProps>;
+    Alert: default_2.ForwardRefExoticComponent<IAlertProcessProps & default_2.RefAttributes<HTMLDivElement>>;
+    Status: default_2.ForwardRefExoticComponent<IMarkerStatusProps & default_2.RefAttributes<HTMLDivElement>>;
     StatusGroup: default_2.ForwardRefExoticComponent<IStatusTrackerStatusGroup & default_2.RefAttributes<HTMLDivElement>>;
 };
 
-/** Компонент кнопки для футера статус-трекера. */
-export declare const StatusTrackerButton: default_2.FC<IStatusTrackerButtonProps>;
+/**
+ * Компонент кнопки для футера статус-трекера.
+ * Блочный режим включён по умолчанию; `block` стоит до `...rest`, поэтому потребитель может его переопределить.
+ */
+export declare const StatusTrackerButton: default_2.ForwardRefExoticComponent<IStatusTrackerButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
 
-/** Текст пояснения для блока заголовка статус-трекера. */
-export declare const StatusTrackerDescription: default_2.FC<IStatusTrackerDescriptionProps>;
+/** Текст пояснения для блока заголовка или футера статус-трекера. */
+export declare const StatusTrackerDescription: default_2.ForwardRefExoticComponent<IStatusTrackerDescriptionProps & default_2.RefAttributes<HTMLElement>>;
 
 /** Блок с набором кнопок для взаимодействия с документом в статус-трекере. */
 export declare const StatusTrackerFooter: default_2.ForwardRefExoticComponent<IStatusTrackerFooterProps & default_2.RefAttributes<HTMLDivElement>> & {
-    Button: default_2.FC<IStatusTrackerButtonProps>;
-    Description: default_2.FC<IStatusTrackerDescriptionProps>;
+    Button: default_2.ForwardRefExoticComponent<IStatusTrackerButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
+    Description: default_2.ForwardRefExoticComponent<IStatusTrackerDescriptionProps & default_2.RefAttributes<HTMLElement>>;
 };
 
 /** Блок заголовка статус-трекера. */
 export declare const StatusTrackerHeader: default_2.ForwardRefExoticComponent<IStatusTrackerHeaderProps & default_2.RefAttributes<HTMLDivElement>> & {
-    Title: default_2.FC<IStatusTrackerTitleProps>;
-    Sum: default_2.FC<IStatusTrackerSumProps>;
-    Description: default_2.FC<IStatusTrackerDescriptionProps>;
+    Title: default_2.ForwardRefExoticComponent<IStatusTrackerTitleProps & default_2.RefAttributes<HTMLElement>>;
+    Sum: default_2.ForwardRefExoticComponent<IStatusTrackerSumProps & default_2.RefAttributes<HTMLElement>>;
+    Description: default_2.ForwardRefExoticComponent<IStatusTrackerDescriptionProps & default_2.RefAttributes<HTMLElement>>;
 };
 
 /** Контейнер для иконки StatusTracker. */
-export declare const StatusTrackerMedia: default_2.FC<StatusTrackerMediaProps>;
+export declare const StatusTrackerMedia: default_2.ForwardRefExoticComponent<StatusTrackerMediaProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Свойства компонента StatusTrackerMedia. */
 export declare interface StatusTrackerMediaProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое блока: как правило, статусная иконка размера 84. */
+    children?: default_2.ReactNode;
 }
 
-/** Компонент суммы для блока заголовка статус-трекера. */
-export declare const StatusTrackerSum: default_2.FC<IStatusTrackerSumProps>;
+/** Сумма документа для блока заголовка статус-трекера. Рендерится как Title размера H1. */
+export declare const StatusTrackerSum: default_2.ForwardRefExoticComponent<IStatusTrackerSumProps & default_2.RefAttributes<HTMLElement>>;
 
-/** Текст пояснения для блока заголовка статус-трекера. */
-export declare const StatusTrackerTitle: default_2.FC<IStatusTrackerTitleProps>;
+/** Заголовок блока заголовка статус-трекера. Рендерится как Title размера H3 с жирным начертанием. */
+export declare const StatusTrackerTitle: default_2.ForwardRefExoticComponent<IStatusTrackerTitleProps & default_2.RefAttributes<HTMLElement>>;
 
 export declare const Step: default_2.FC<IStepProps>;
 
 /** Компонент Stepper, список шагов */
 export declare const Stepper: default_2.FC<IStepperProps> & IStepperComposition;
 
-/** Компонент StepperExtended, расширенная версия Stepper. */
-export declare const StepperExtended: default_2.FC<IStepperExtendedProps> & IStepperExtendedComposition;
+/**
+ * Компонент StepperExtended, базовый степпер: список шагов без карусели и кнопок прокрутки.
+ * Шаги потребитель передаёт сам через `StepperExtended.Step`. Готовый вариант с прокруткой — `Stepper`.
+ */
+export declare const StepperExtended: default_2.ForwardRefExoticComponent<IStepperExtendedProps & default_2.RefAttributes<HTMLOListElement>> & IStepperExtendedComposition;
 
 /** Компонент StepperStep, шаг в Stepper. */
 declare const StepperStep: default_2.FC<IStepperStepProps> & IStepperStepComposition;
@@ -7394,6 +7576,12 @@ export declare const SuggestField: (<T extends ISuggestFieldOption = ISuggestFie
  */
 export declare const SuggestFieldDesktop: <T extends ISuggestFieldOption = ISuggestFieldOption>({ value, options, size, status, placeholder, "data-test-id": dataTestId, tooltipHint, loading, tooltipOpen, dropdownListLoading, clearInputOnFocus, onFilter, onClear, onSelect, onScrollEnd, prefix, postfix, renderInput, renderDropdown, renderDropdownList, renderDropdownListItem, inputProps, ...restProps }: ISuggestFieldDesktopProps<T>) => JSX_2.Element;
 
+/**
+ * Выпадающий список десктопного SuggestField. Рендерится в портале, повторяет ширину поля ввода
+ * и вызывает onScrollEnd при прокрутке списка до конца.
+ *
+ * @template T - тип опции, должен расширять ISuggestFieldOption
+ */
 export declare const SuggestFieldDesktopDropdown: <T extends ISuggestFieldOption = ISuggestFieldOption>({ size, value, options, targetRef, listId, dataTestId, opened, listLoading, onMouseDown, onSelect, onScrollEnd, renderList, renderListItem, ...restProps }: ISuggestFieldDesktopDropdownProps<T>) => JSX_2.Element;
 
 /**
@@ -7452,8 +7640,12 @@ export declare const TableFooterSummarySelectAllButton: default_2.FC<ITableFoote
 /** Компонент в подвале таблицы, в котором информация о количестве выбранных позиций. */
 export declare const TableFooterSummarySelectedCount: default_2.FC<ITableFooterSummarySelectedCountProps>;
 
-/** Компонент Tabs. */
-export declare const Tabs: default_2.FC<ITabsProps>;
+/**
+ * Компонент Tabs.
+ * Готовые табы поверх TabsExtended: рендерит табы по массиву, переносит не поместившиеся в выпадающий список
+ * и добавляет навигацию стрелками.
+ */
+export declare const Tabs: default_2.ForwardRefExoticComponent<ITabsProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Базовый компонент табов. На его основе можно рендерить табы любого дизайна. */
 export declare const TabsExtended: default_2.ForwardRefExoticComponent<ITabsExtendedProps & default_2.RefAttributes<HTMLDivElement>> & {
@@ -7496,18 +7688,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>>;
 
 /**
  * Компонент, который демонстрирует выбранное значение того или иного параметра.
@@ -7518,10 +7721,18 @@ export declare const TabsLineMobile: default_2.FC<ITabsLineMobileProps>;
  */
 export declare const Tag: default_2.ForwardRefExoticComponent<ITagProps & default_2.RefAttributes<HTMLSpanElement>>;
 
-/** Компонент, который используется для маркировки и классификации. */
+/**
+ * Компонент, который используется для маркировки и классификации.
+ *
+ * Неинтерактивный: рендерит `span` без обработчиков и фокуса, цвет фона задаёт `status`.
+ */
 export declare const TagColor: default_2.ForwardRefExoticComponent<ITagColorProps & default_2.RefAttributes<HTMLSpanElement>>;
 
-/** Контейнер для группы Tag. */
+/**
+ * Контейнер для группы Tag.
+ * Теги идут в общем потоке и переносятся по строкам, отступ между ними задаёт size.
+ * Корневой элемент — div с role="group", на него указывает ref и приходят className и остальные props.
+ */
 export declare const TagGroup: default_2.ForwardRefExoticComponent<ITagGroupProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -7530,6 +7741,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: одно значение на обе стороны либо раздельные значения для верха и низа. */
@@ -7599,7 +7811,7 @@ declare type TDataAttributeAlias = `data-${string}`;
  */
 export declare type TDataHTMLAttributes = Record<string, string>;
 
-/** Значение компонента DateRange. */
+/** Значение компонента DateRange — даты "от" и "до" в формате YYYYMMDD. */
 export declare type TDateRangeValue = [string, string];
 
 /** Тип HTML атрибутов компонента дня. */
@@ -9021,8 +9233,11 @@ declare const Text_2: default_2.ForwardRefExoticComponent<(Omit<{
 } & ITypographyProps & default_2.SVGProps<SVGViewElement>, "ref">) & default_2.RefAttributes<HTMLElement>>;
 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>>;
 
 /**
  * Компонент текстового ввода.
@@ -9786,8 +10001,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;
 
 /**
  * Базовый компонент визуального дерева.
@@ -9796,49 +10014,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.
@@ -9903,7 +10084,8 @@ export declare class TreeViewNodeWithContext extends default_2.Component<ITreeVi
 }
 
 /**
- * При нажатии на клавишу вызывает onClick на дочерний элемент.
+ * При нажатии на клавишу вызывает click на кнопке из targetRef.
+ * Клавиша слушается на window (через KeyDownListener), собственной разметки компонент не рендерит.
  */
 export declare const TriggerClickOnKeyDownEvent: default_2.FC<ITriggerClickOnKeyDownEventProps>;
 
@@ -9985,12 +10167,19 @@ export declare const UnorderedListExtended: default_2.ForwardRefExoticComponent<
     };
 };
 
+/**
+ * Зона загрузки файлов. Рендерит кликабельную область поверх своего содержимого и,
+ * если передан `dropZoneContainer`, показывает поверх него дроп-зону во время перетаскивания файлов.
+ */
 export declare const UploadZone: default_2.ForwardRefExoticComponent<IUploadZoneProps & default_2.RefAttributes<HTMLDivElement>> & {
-    Input: default_2.FC<IUploadZoneInputProps>;
+    Input: default_2.ForwardRefExoticComponent<IUploadZoneInputProps & default_2.RefAttributes<HTMLInputElement>>;
 };
 
-/** Компонент поля для зоны загрузки файлов. */
-export declare const UploadZoneInput: default_2.FC<IUploadZoneInputProps>;
+/**
+ * Скрытое поле выбора файлов зоны загрузки.
+ * Обработчик изменения берётся из контекста UploadZone — prop `onChange` у поля не поддерживается.
+ */
+export declare const UploadZoneInput: default_2.ForwardRefExoticComponent<IUploadZoneInputProps & default_2.RefAttributes<HTMLInputElement>>;
 
 export declare type UploadZoneOnChangeType = (files: FileList | null, e: default_2.SyntheticEvent) => void;