@sberbusiness/triplex-next 1.45.0 → 1.47.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>>;
 
 /**
@@ -793,30 +802,44 @@ export declare const Caption: default_2.ForwardRefExoticComponent<(Omit<{
     weight?: EFontWeightCaption;
 } & ITypographyProps & default_2.SVGProps<SVGViewElement>, "ref">) & default_2.RefAttributes<HTMLElement>>;
 
-/** Компонент "Интерактивная карточка". */
+/**
+ * Компонент "Интерактивная карточка".
+ * Работает в двух режимах: неконтролируемом — состояние выбора хранится внутри компонента, и
+ * контролируемом (передан prop selected) — состояние задаётся снаружи, а компонент сообщает о
+ * запросе на его смену через prop toggle.
+ */
 export declare class CardAction extends default_2.Component<ICardActionProps, ICardActionState> {
     static displayName: string;
+    /** Контент карточки. */
     static Content: default_2.FC<ICardContentProps> & ICardContentComposition;
+    /** Медийный элемент карточки. */
     static Media: default_2.FC<ICardMediaProps>;
     state: {
         focusSource: EFocusSource;
         isControlled: boolean;
         isSelected: boolean;
     };
-    componentDidUpdate(prevProps: Readonly<ICardActionProps>): void;
+    /** Ссылка на корневой элемент карточки. */
     private ref;
+    componentDidUpdate(prevProps: Readonly<ICardActionProps>): void;
     render(): JSX.Element;
+    /** Обработчик клика по карточке. Переключает состояние выбора. */
     handleClick: (event: default_2.MouseEvent<HTMLDivElement>) => void;
+    /** Обработчик нажатия мышью. Запоминает источник фокуса, чтобы не показывать обводку фокуса. */
     handleMouseDown: (event: default_2.MouseEvent<HTMLDivElement>) => void;
+    /** Обработчик нажатия клавиши. Space и Enter переключают состояние выбора, Space гасит прокрутку страницы. */
     handleKeyDown: (event: default_2.KeyboardEvent<HTMLDivElement>) => void;
+    /** Обработчик получения фокуса. Фокус на самой карточке без предшествующего клика считается клавиатурным. */
     handleFocus: (event: default_2.FocusEvent<HTMLDivElement>) => void;
+    /** Обработчик потери фокуса. Сбрасывает источник фокуса, когда карточка перестала быть активным элементом. */
     handleBlur: (event: default_2.FocusEvent<HTMLDivElement>) => void;
+    /**
+     * Переключает состояние выбора. В контролируемом режиме только вызывает toggle со следующим значением,
+     * в неконтролируемом — меняет внутреннее состояние и вызывает onToggle.
+     */
     handleToggle: () => void;
 }
 
-/** Контент карточки. */
-declare const CardContent: default_2.FC<ICardContentProps> & ICardContentComposition;
-
 /** Тело контента карточки. */
 declare const CardContentBody: default_2.FC<ICardContentBodyProps>;
 
@@ -826,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>> & {
@@ -858,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;
 
 /**
  * Обертка над базовым компонентом чекбокс.
@@ -893,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;
 
 /**
@@ -928,14 +965,25 @@ export declare const ChipGroup: default_2.ForwardRefExoticComponent<IChipGroupPr
  */
 export declare const ChipIcon: default_2.ForwardRefExoticComponent<IChipIconProps & default_2.RefAttributes<HTMLSpanElement>>;
 
+/** MonthYearPicker с видом компонента Chip. */
+export declare const ChipMonthYearPicker: default_2.ForwardRefExoticComponent<IChipMonthYearPickerProps & default_2.RefAttributes<HTMLDivElement>>;
+
+/** Целевой элемент компонента ChipMonthYearPicker. */
+export declare const ChipMonthYearPickerTarget: default_2.ForwardRefExoticComponent<IChipMonthYearPickerTargetProps & default_2.RefAttributes<HTMLSpanElement>>;
+
 /**
  * Компонент выбора нескольких значений из списка.
  * Количество выбранных значений отображается компонентом Chip.
+ *
+ * Надстройка над MultiselectField: состоянием открытости и выпадающим блоком владеет
+ * MultiselectField, а полем выбора выступает Chip. Внешний ref уходит на этот Chip,
+ * а не на корневой элемент MultiselectField.
  */
 export declare const ChipMultiselect: default_2.ForwardRefExoticComponent<IChipMultiselectProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
  * Chip с иконкой выбора опций.
+ * В выбранном состоянии в postfix отображается кнопка сброса выбора.
  */
 export declare const ChipOptions: default_2.ForwardRefExoticComponent<IChipOptionsProps & default_2.RefAttributes<HTMLSpanElement>>;
 
@@ -955,6 +1003,10 @@ export declare const ChipSelectTarget: default_2.ForwardRefExoticComponent<IChip
 
 /**
  * ChipSelect с иконкой выбора сортировки.
+ *
+ * Выбранное значение не отображается текстом: target — это ChipIcon с иконкой сортировки,
+ * которая подсвечивается, только когда текущее значение отличается от defaultValue.
+ * Открывается по клику и по Enter/Space, target связан со списком через aria-controls.
  */
 export declare const ChipSort: default_2.ForwardRefExoticComponent<IChipSortProps & default_2.RefAttributes<HTMLDivElement>>;
 
@@ -964,6 +1016,10 @@ export declare const ChipSort: default_2.ForwardRefExoticComponent<IChipSortProp
  */
 export declare const ChipSuggest: <T extends ISuggestOption = ISuggestOption>(props: IChipSuggestProps<T> & default_2.RefAttributes<HTMLDivElement>) => JSX.Element;
 
+/**
+ * Target-элемент ChipSuggest: Chip, который открывает и закрывает выпадающий список.
+ * Выбранное значение и видимость списка берёт из SuggestContext, поэтому рендерится только внутри Suggest.
+ */
 export declare const ChipSuggestTarget: <T extends ISuggestOption>(props: IChipSuggestTargetProps<T> & default_2.RefAttributes<HTMLSpanElement>) => JSX.Element;
 
 /** Моноширинный текст (типографика). */
@@ -1002,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.
@@ -1069,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>;
 
@@ -1115,7 +1198,7 @@ export declare const DateField: default_2.ForwardRefExoticComponent<IDateFieldPr
 export declare const dateFormatYYYYMMDD = "YYYYMMDD";
 
 /**
- * База для компонентов выбора даты (DateField, MonthYearField, ChipDatePicker).
+ * База для компонентов выбора даты (DateField, MonthYearField, ChipDatePicker, ChipMonthYearPicker).
  * Рендерит переданный целевым элемент и выпадающий Calendar, хранит состояние открытости
  * дропдауна и отдаёт его целевому элементу через DatePickerExtendedContext.
  */
@@ -1127,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 ? {
@@ -1489,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"
 }
 
@@ -2116,10 +2207,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>>;
 
 /**
  * Компонент маскированного ввода.
@@ -2391,21 +2483,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. */
@@ -2426,9 +2525,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;
 }
 
@@ -2781,21 +2880,21 @@ export declare interface ICalendarViewProps extends Pick<ICalendarProps, "dayHtm
 
 /** Свойства интерактивной карточки. */
 export declare interface ICardActionProps extends ICardProps {
-    /** Обработчик переключения выбора карточки. */
+    /** Обработчик изменения состояния выбора. Вызывается с новым значением selected. */
     onToggle?: (selected: boolean) => void;
-    /** Контролируемое состояние выбрана/не выбрана. */
+    /** Состояние выбора в контролируемом режиме. Режим определяется при монтировании по условию selected !== undefined: при selected === undefined (в том числе явном) карточка работает в неконтролируемом режиме. */
     selected?: boolean;
-    /** Контролирующая функция состояние выбрана/не выбрана. */
+    /** Запрос на смену состояния выбора в контролируемом режиме. Вызывается со следующим значением selected. */
     toggle?: (selected: boolean) => void;
 }
 
-/** Состояния интерактивной карточки. */
+/** Состояние интерактивной карточки. */
 declare interface ICardActionState {
-    /** Выбрана или нет. */
+    /** Выбрана карточка или нет. Используется только в неконтролируемом режиме. */
     isSelected: boolean;
-    /** Контролируемая или нет. */
+    /** Контролируется ли состояние выбора извне. Определяется один раз при монтировании по наличию prop selected. */
     isControlled: boolean;
-    /** Источник фокуса. */
+    /** Источник фокуса. Обводка фокуса показывается только для EFocusSource.KEYBOARD. */
     focusSource: EFocusSource;
 }
 
@@ -2819,7 +2918,7 @@ declare interface ICardContentFooterProps extends default_2.HTMLAttributes<HTMLD
 
 /** Свойства компонента CardContent. */
 declare interface ICardContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Размер внутреннего отступа контента карточки. */
+    /** Размер внутреннего отступа контента карточки. По умолчанию ECardContentPaddingSize.MD. */
     paddingSize?: ECardContentPaddingSize;
 }
 
@@ -2831,21 +2930,14 @@ declare interface ICardHeaderProps extends default_2.HTMLAttributes<HTMLDivEleme
 declare interface ICardMediaProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
+/** Свойства карточки. */
 export declare interface ICardProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Возможные размеры скругления карточки. */
+    /** Размер скругления карточки. По умолчанию ECardRoundingSize.MD. */
     roundingSize?: ECardRoundingSize;
-    /** Возможные темы оформления карточки. */
+    /** Тема оформления карточки. По умолчанию ECardTheme.GENERAL. */
     theme?: ECardTheme;
 }
 
-/** Внутренние составляющие статичной карточки. */
-declare interface ICardStaticComposition {
-    /** Контент карточки. */
-    Content: typeof CardContent;
-    /** Медийный элемент карточки. */
-    Media: typeof CardMedia;
-}
-
 /**
  * Свойства, которые CarouselExtended передаёт в рендер-функции кнопок прокрутки:
  * `disabled` (край ленты достигнут), `hidden` (прокрутка не нужна) и `onClick`.
@@ -2875,18 +2967,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. */
@@ -2928,10 +3008,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[];
 }
 
@@ -2951,6 +3036,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-функция компонента чекбокс. */
@@ -2967,20 +3066,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;
 }
 
@@ -3041,8 +3138,27 @@ export declare interface IChipGroupProps extends default_2.HTMLAttributes<HTMLDi
 export declare interface IChipIconProps extends Omit<IChipProps, "prefix" | "postfix"> {
 }
 
+/** Свойства компонента ChipMonthYearPicker. */
+export declare interface IChipMonthYearPickerProps extends Omit<IMonthYearFieldProps, "status" | "label" | "onClear" | "targetProps" | "pickType">, Pick<IChipProps, "type" | "disabled"> {
+    /** Название поля, когда не выбрано значение. */
+    label: default_2.ReactNode;
+    /** Лейбл, отображаемый вместо выбранного значения. */
+    displayedValue?: default_2.ReactNode;
+    /** Свойства кнопки очищения значения, например aria-label. */
+    clearButtonProps?: IChipMonthYearPickerTargetProps["clearButtonProps"];
+}
+
+/** Свойства компонента ChipMonthYearPickerTarget. */
+export declare interface IChipMonthYearPickerTargetProps extends IChipProps {
+    /** Обработчик очищения значения. */
+    onClear: () => void;
+    /** Свойства кнопки очищения значения, например aria-label. */
+    clearButtonProps?: Omit<IChipClearButtonProps, "size" | "disabled" | "onClick" | "onKeyDown">;
+}
+
+/** Свойства компонента ChipMultiselect. */
 export declare interface IChipMultiselectProps extends Omit<IMultiselectFieldProps, "renderTarget">, Pick<IChipProps, "type"> {
-    /** Функция отмены выбора. */
+    /** Функция отмены выбора. Вызывается по нажатию на кнопку сброса. */
     clearSelected: () => void;
     /** Состояние disabled. */
     disabled?: boolean;
@@ -3050,13 +3166,20 @@ export declare interface IChipMultiselectProps extends Omit<IMultiselectFieldPro
     selected?: boolean;
     /** Название поля или число выбранных вариантов. */
     label: default_2.ReactNode;
-    /** Лейбл, отображаемый вместо выбранного значения. */
+    /** Лейбл, отображаемый вместо выбранного значения. Показывается только при selected. */
     displayedValue?: default_2.ReactNode;
 }
 
+/** Свойства компонента ChipOptions. */
 export declare interface IChipOptionsProps extends Omit<IChipProps, "prefix" | "postfix"> {
     /** Функция отмены выбора. */
     clearSelected: () => void;
+    /**
+     * Свойства кнопки сброса выбора, например aria-label для её доступного имени.
+     * Размер задаётся размером чипса. Переданные onClick и onKeyDown не заменяют
+     * собственные обработчики компонента, а вызываются после них.
+     */
+    clearButtonProps?: Omit<IChipClearButtonProps, "size">;
 }
 
 /**
@@ -3112,6 +3235,7 @@ export declare interface IChipSelectTargetProps extends IChipProps {
     setOpened: (opened: boolean) => void;
 }
 
+/** Свойства компонента ChipSort. */
 export declare interface IChipSortProps extends Omit<IChipSelectProps, "targetProps" | "clearSelected" | "defaultValue"> {
     /** Дефолтное значение, если текущее значение равно дефолтному, элемент не будет подсвечен как измененный. */
     defaultValue?: ISelectExtendedFieldDefaultOption;
@@ -3124,23 +3248,35 @@ export declare interface IChipSuggestDropdownProps<T extends ISuggestOption> ext
 }
 
 /** Свойства компонента ChipSuggest. */
-export declare interface IChipSuggestProps<T extends ISuggestOption = ISuggestOption> extends Omit<ISuggestProps<T>, "renderTarget">, Pick<IChipProps, "type"> {
+export declare interface IChipSuggestProps<T extends ISuggestOption = ISuggestOption> extends ISuggestProps<T>, Pick<IChipProps, "type"> {
     /** Название поля, когда не выбрано значение. */
     label: React.ReactNode;
-    /** Лейбл, отображаемый вместо выбранного значения. */
+    /** Лейбл, отображаемый вместо label выбранного значения. */
     displayedValue?: React.ReactNode;
-    /** Свойства компонента Chip. */
+    /** Свойства target-элемента (ChipSuggestTarget поверх Chip). Здесь же передаётся clearSelected. */
     targetProps?: IChipSuggestTargetProps<T>;
-    /** Свойства компонента Dropdown. */
+    /** Свойства выпадающего списка (ChipSuggestDropdown поверх Dropdown). targetRef проставляет ChipSuggest. */
     dropdownProps?: Omit<IChipSuggestDropdownProps<T>, "targetRef">;
 }
 
 /** Свойства компонента ChipSuggestTarget. */
 export declare interface IChipSuggestTargetProps<T extends ISuggestOption> extends Omit<IChipProps, "prefix" | "postfix"> {
-    /** Функция отмены выбора. */
+    /** Функция отмены выбора. Вызывается по клику на кнопку очистки. */
     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"> {
     /** Текущая нода раскрыта. */
@@ -3170,9 +3306,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 {
@@ -3291,9 +3428,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.
@@ -3301,8 +3443,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;
 }
 
@@ -3322,9 +3473,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;
 }
 
@@ -3332,6 +3493,7 @@ export declare interface IConfirmFC extends default_2.FC<IConfirmProps> {
 export declare interface IConfirmProps extends IIslandProps {
     /** Компонент, в котором используется Confirm.
      *  От этого зависит максимальная ширина контента Confirm.
+     *  По умолчанию EConfirmParentComponent.LIGHTBOX.
      */
     parentComponent?: EConfirmParentComponent;
 }
@@ -3344,17 +3506,17 @@ export declare const IconWrapper: default_2.ForwardRefExoticComponent<IIconWrapp
 
 /** Свойства компонента DateField. */
 export declare interface IDateFieldProps extends Omit<IDatePickerExtendedProps, "pickedDate" | "onDateChange" | "renderTarget" | "renderDropdownHeaderTarget">, Pick<IMaskedFieldProps, "size" | "status" | "label"> {
-    /** Значение даты. */
+    /** Значение даты в формате `format`. Пустая строка — значение не выбрано. */
     value: string;
     /** Символы для заполнения пустых редактируемых позиций в маске (например, строка вида "дд.мм.гггг"). */
     placeholderMask?: string;
-    /** Текст подсказки в тултипе. */
+    /** Текст подсказки в тултипе. Показывается, когда в поле введена полная, но недоступная для выбора дата. */
     invalidDateHint: React.ReactNode;
-    /** Функция, вызывающаяся при изменении значения. */
+    /** Функция, вызывающаяся при изменении значения. Аргумент — дата в формате `format` либо пустая строка при очистке. */
     onChange: (value: string) => void;
-    /** Обработчик очищения значения. */
+    /** Обработчик очищения значения. Кнопка очистки рендерится, только если обработчик передан. */
     onClear?: React.MouseEventHandler<HTMLButtonElement>;
-    /** Свойства MaskedField. */
+    /** Свойства MaskedField — управляющего элемента поля. */
     targetProps?: DeepPartial<IMaskedFieldProps>;
 }
 
@@ -3401,15 +3563,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;
 }
 
@@ -3419,11 +3587,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;
@@ -3731,7 +3899,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;
 }
@@ -3775,8 +3943,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. */
@@ -3891,9 +4064,9 @@ export declare interface IHelpBoxProps extends default_2.HTMLAttributes<HTMLButt
     tooltipDataAttributes?: TDataHTMLAttributes;
     /** Размер Tooltip. */
     tooltipSize: ETooltipSize;
-    /** Контент заголовка TooltipMobile. */
+    /** Контент заголовка TooltipMobile. Отображается только в мобильной версии. */
     mobileHeaderContent?: default_2.ReactNode;
-    /** Свойства иконки. */
+    /** Свойства иконки. По умолчанию paletteIndex равен 5. */
     iconProps?: ISingleColorIconProps;
     /** Свойства кнопки закрытия Tooltip. */
     tooltipXButtonProps?: ITooltipXButtonProps;
@@ -4075,6 +4248,7 @@ export declare interface IImageGalleryThumbRenderState {
 
 /** Свойства компонента IslandAccordionContent. */
 export declare interface IIslandAccordionContentProps {
+    /** Содержимое раскрывающейся части элемента аккордеона. */
     children?: default_2.ReactNode;
 }
 
@@ -4082,30 +4256,33 @@ export declare interface IIslandAccordionContentProps {
 export declare interface IIslandAccordionFooterProps extends IIslandFooterProps {
 }
 
+/** Свойства компонента IslandAccordionItem. */
 export declare interface IIslandAccordionItemProps extends Omit<default_2.HTMLAttributes<HTMLLIElement>, "title"> {
     /** Нода с названием заголовка. */
     title: default_2.ReactNode;
-    /** Идентификатор вкладки (если не передать извне, то используется индекс. Также используется как ключ при рендере списка вкладок). */
+    /** Идентификатор элемента. Проставляется на корневой `<li>` и передаётся в onToggle и onRemove. */
     id: string;
-    /** Цифра в кружке. */
+    /** Номер шага в кружке слева от заголовка. Кружок рендерится, только если задан вместе со status и не равен 0. */
     num?: number;
-    /** Раскрыт ли элемент. */
+    /** Раскрыт ли элемент. Передан — элемент управляемый и состояние задаёт потребитель, не передан — элемент раскрывается сам. */
     opened?: boolean;
-    /** Статус шага. */
+    /** Статус шага. Без него кружок с номером не рендерится. */
     status?: EStepStatus;
-    /** Подсказка к шагу. */
+    /** Подсказка к шагу, показывается по наведению на кружок. Игнорируется при disabled. */
     stepHint?: string;
-    /** Заблокирован ли элемент. */
+    /** Заблокирован ли элемент. Блокирует раскрытие, удаление и скрывает подсказку шага. */
     disabled?: boolean;
-    /** Вызывается при клике по вкладке. */
+    /** Вызывается при клике по заголовку с новым состоянием раскрытия и id элемента. */
     onToggle?: (newOpened: boolean, id: string) => void;
-    /** Вызывается при удалении вкладки. */
+    /** Вызывается при клике по кнопке удаления с id элемента. Кнопка рендерится, только если колбэк передан. */
     onRemove?: (id: string) => void;
-    /** Свойства компонента Transition (react-transition-group). */
+    /** Свойства компонента Transition (react-transition-group), управляющего раскрытием содержимого. */
     transitionProps?: IExpandAnimationProps["transitionProps"];
 }
 
+/** Свойства компонента IslandAccordion. */
 export declare interface IIslandAccordionProps extends default_2.HTMLAttributes<HTMLUListElement>, Pick<IIslandProps, "type"> {
+    /** Размер элементов аккордеона. По умолчанию EComponentSize.MD. */
     size?: EComponentSize;
 }
 
@@ -4141,13 +4318,15 @@ export declare interface IIslandWidgetBodyProps extends default_2.HTMLAttributes
 
 /** Свойства компонента IslandWidgetExtraFooter. */
 declare interface IIslandWidgetExtraFooterProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Контролируемое состояние открытости. */
+    /** Контролируемое состояние открытости. По умолчанию false. */
     open?: boolean;
 }
 
+/** Свойства компонента IslandWidgetFooterContent. */
 declare interface IIslandWidgetFooterContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
+/** Свойства компонента IslandWidgetFooterControls. */
 declare interface IIslandWidgetFooterControlsProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
@@ -4156,7 +4335,7 @@ export declare interface IIslandWidgetFooterProps extends default_2.HTMLAttribut
 }
 
 /** Свойства компонента IslandWidgetHeaderContent. */
-declare interface IIslandWidgetHeaderContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
+export declare interface IIslandWidgetHeaderContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
 /** Свойства компонента IslandWidgetHeaderControls. */
@@ -4164,18 +4343,20 @@ declare interface IIslandWidgetHeaderControlsProps extends default_2.HTMLAttribu
 }
 
 /** Свойства компонента IslandWidgetHeaderDescription. */
-declare interface IIslandWidgetHeaderDescriptionProps extends default_2.HTMLAttributes<HTMLDivElement> {
+export declare interface IIslandWidgetHeaderDescriptionProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
 /** Свойства компонента IslandWidgetHeader. */
 export declare interface IIslandWidgetHeaderProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
+/** Свойства компонента IslandWidgetHeaderTitle. */
 declare interface IIslandWidgetHeaderTitleProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
+/** Свойства компонента IslandWidget. */
 export declare interface IIslandWidgetProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Размер компонента. */
+    /** Размер компонента. По умолчанию EComponentSize.MD. */
     size?: EComponentSize;
     /** Рендер-функция Body. */
     renderBody: (props: IIslandWidgetBodyProps) => default_2.ReactNode;
@@ -4183,10 +4364,11 @@ export declare interface IIslandWidgetProps extends default_2.HTMLAttributes<HTM
     renderFooter?: (props: IIslandWidgetFooterProps) => default_2.ReactNode;
     /** Рендер-функция Header. */
     renderHeader: (props: IIslandWidgetHeaderProps) => default_2.ReactNode;
-    /** Отключение возможности сворачивания контента в адаптиве. */
+    /** Отключение возможности сворачивания контента в адаптиве. По умолчанию false. */
     disableAdaptiveCollapsing?: boolean;
 }
 
+/** Свойства компонента IslandWidgetWrapper. */
 export declare interface IIslandWidgetWrapperProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
@@ -5298,6 +5480,10 @@ export declare const Island: default_2.ForwardRefExoticComponent<IIslandProps &
     Footer: default_2.ForwardRefExoticComponent<Omit<IIslandFooterProps, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
 };
 
+/**
+ * Аккордеон: список раскрывающихся элементов IslandAccordion.Item, каждый из которых
+ * построен на Island. Размер и тип задаются на списке и раздаются элементам через контекст.
+ */
 export declare const IslandAccordion: default_2.ForwardRefExoticComponent<IIslandAccordionProps & default_2.RefAttributes<HTMLUListElement>> & {
     Item: default_2.ForwardRefExoticComponent<IIslandAccordionItemProps & default_2.RefAttributes<HTMLLIElement>> & {
         Content: default_2.FC<IIslandAccordionContentProps>;
@@ -5305,12 +5491,13 @@ export declare const IslandAccordion: default_2.ForwardRefExoticComponent<IIslan
     };
 };
 
-/** Компонент содержимого элемента аккордеона. */
+/** Компонент содержимого элемента аккордеона. Обёртка над Island.Body с отступами аккордеона. */
 export declare const IslandAccordionContent: default_2.FC<IIslandAccordionContentProps>;
 
-/** Компонент подвала элемента акоордеона. */
+/** Компонент подвала элемента аккордеона. Обёртка над Island.Footer с отступами аккордеона. */
 export declare const IslandAccordionFooter: default_2.FC<IIslandAccordionFooterProps>;
 
+/** Раскрывающийся элемент аккордеона: кнопка-заголовок и анимированно раскрываемое содержимое. */
 export declare const IslandAccordionItem: default_2.ForwardRefExoticComponent<IIslandAccordionItemProps & default_2.RefAttributes<HTMLLIElement>> & {
     Content: default_2.FC<IIslandAccordionContentProps>;
     Footer: default_2.FC<IIslandAccordionFooterProps>;
@@ -5325,6 +5512,10 @@ export declare const IslandFooter: default_2.ForwardRefExoticComponent<Omit<IIsl
 /** Шапка острова. Отступ до следующего блока задаётся размером родительского Island. */
 export declare const IslandHeader: default_2.ForwardRefExoticComponent<Omit<IIslandHeaderProps, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Виджет — карточка со сгруппированной информацией, набором связанных действий или отдельной функциональностью.
+ * В адаптиве контент сворачивается по клику на шапку, если не передан disableAdaptiveCollapsing.
+ */
 export declare const IslandWidget: default_2.ForwardRefExoticComponent<IIslandWidgetProps & default_2.RefAttributes<HTMLDivElement>> & {
     Header: TIslandWidgetHeader;
     Body: default_2.FC<IIslandWidgetBodyProps>;
@@ -5332,24 +5523,49 @@ export declare const IslandWidget: default_2.ForwardRefExoticComponent<IIslandWi
     ExtraFooter: default_2.FC<IIslandWidgetExtraFooterProps>;
 };
 
+/** Основное содержимое виджета. Горизонтальные отступы берутся из размера виджета. */
 export declare const IslandWidgetBody: default_2.FC<IIslandWidgetBodyProps>;
 
+/** Подвал виджета. Отступы берутся из размера виджета, в адаптиве части подвала выстраиваются в колонку. */
 export declare const IslandWidgetFooter: TIslandWidgetFooter;
 
+/** Содержимое подвала виджета — занимает свободное место слева от блока управления. */
 declare const IslandWidgetFooterContent: default_2.FC<IIslandWidgetFooterContentProps>;
 
+/** Блок управления подвала виджета — прижимается к правому краю, в адаптиве переносится на новую строку. */
 declare const IslandWidgetFooterControls: default_2.FC<IIslandWidgetFooterControlsProps>;
 
+/**
+ * Шапка виджета. В адаптиве, если сворачивание не отключено, дополняется индикатором раскрытия.
+ * Клик по шапке обрабатывает IslandWidget — сама шапка обработчик не вешает.
+ */
 export declare const IslandWidgetHeader: TIslandWidgetHeader;
 
+/**
+ * Обёртка содержимого шапки виджета.
+ * Собственных стилей не несёт — раскладку задаёт родительская шапка, а оформление приходит через className.
+ */
 export declare const IslandWidgetHeaderContent: default_2.FC<IIslandWidgetHeaderContentProps>;
 
+/**
+ * Блок управления в шапке виджета.
+ * Гасит всплытие клика, чтобы взаимодействие с контролами не сворачивало виджет в адаптиве.
+ */
 declare const IslandWidgetHeaderControls: default_2.FC<IIslandWidgetHeaderControlsProps>;
 
+/**
+ * Описание в шапке виджета. Прижимается к правому краю на десктопе и переносится на свою строку в адаптиве.
+ * Размер текста берётся из размера виджета: B4 на десктопе, в адаптиве — по SIZE_TO_ADAPTIVE_TEXT_SIZE_MAP.
+ */
 export declare const IslandWidgetHeaderDescription: default_2.FC<IIslandWidgetHeaderDescriptionProps>;
 
+/** Заголовок шапки виджета. Однострочный на десктопе, с переносом в адаптиве. */
 declare const IslandWidgetHeaderTitle: default_2.FC<IIslandWidgetHeaderTitleProps>;
 
+/**
+ * Общая обёртка виджета и его дополнительного подвала.
+ * Нужна только когда используется IslandWidget.ExtraFooter: через неё виджет узнаёт, что подвал раскрыт, и рисует тень.
+ */
 export declare const IslandWidgetWrapper: default_2.ForwardRefExoticComponent<IIslandWidgetWrapperProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Свойства компонента SliderExtendedDot. */
@@ -5413,16 +5629,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[];
     /** Содержимое тултипа, отображаемого при наведении на точку и перемещении. */
@@ -5433,20 +5653,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. */
@@ -6116,15 +6340,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;
 }
 
@@ -6132,7 +6356,7 @@ export declare interface ITabsLineBaseProps extends Omit<React.HTMLAttributes<HT
 export declare interface ITabsLineDesktopProps extends ITabsLineBaseProps {
     /** Атрибуты кнопки дропдауна. */
     dropdownTargetHtmlAttributes?: default_2.HTMLAttributes<HTMLButtonElement> & TestProps;
-    /** Максимальное число отображаемых табов. */
+    /** Максимальное число элементов строки, включая кнопку дропдауна. Без него все табы остаются в строке. */
     maxVisible?: number;
 }
 
@@ -6148,35 +6372,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;
 }
 
@@ -6235,8 +6459,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. */
@@ -6479,6 +6706,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> {
 }
@@ -6525,22 +6766,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>;
 }
 
 /** Свойства компонента типографики. */
@@ -7132,8 +7365,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>> & {
@@ -7145,7 +7381,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>;
@@ -7154,7 +7394,7 @@ export declare class SliderRange extends default_2.Component<ISliderRangeProps,
     render(): default_2.ReactNode;
     /** Проверка values, меньшее значение, должно быть перед большим. */
     private validateValues;
-    private sortValues;
+    /** Возвращает обработчик изменения значения ползунка с индексом valueIndex. */
     private handleChange;
 }
 
@@ -7389,18 +7629,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>>;
 
 /**
  * Компонент, который демонстрирует выбранное значение того или иного параметра.
@@ -7423,6 +7674,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: одно значение на обе стороны либо раздельные значения для верха и низа. */
@@ -7492,7 +7744,7 @@ declare type TDataAttributeAlias = `data-${string}`;
  */
 export declare type TDataHTMLAttributes = Record<string, string>;
 
-/** Значение компонента DateRange. */
+/** Значение компонента DateRange — даты "от" и "до" в формате YYYYMMDD. */
 export declare type TDateRangeValue = [string, string];
 
 /** Тип HTML атрибутов компонента дня. */
@@ -8914,8 +9166,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>>;
 
 /**
  * Компонент текстового ввода.
@@ -9679,8 +9934,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;
 
 /**
  * Базовый компонент визуального дерева.
@@ -9689,49 +9947,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.
@@ -9796,7 +10017,8 @@ export declare class TreeViewNodeWithContext extends default_2.Component<ITreeVi
 }
 
 /**
- * При нажатии на клавишу вызывает onClick на дочерний элемент.
+ * При нажатии на клавишу вызывает click на кнопке из targetRef.
+ * Клавиша слушается на window (через KeyDownListener), собственной разметки компонент не рендерит.
  */
 export declare const TriggerClickOnKeyDownEvent: default_2.FC<ITriggerClickOnKeyDownEventProps>;