@sberbusiness/triplex-next 1.44.0 → 1.46.0

package/index.d.ts

@@ -95,7 +95,7 @@ export declare function amountComparator(a: string, b: string): -1 | 0 | 1;
 /** Константы форматов поля Amount (сумма). */
 export declare const AmountConst: IAmountConst;
 
-export declare const AmountField: default_2.ForwardRefExoticComponent<IAmountFieldProps & default_2.RefAttributes<HTMLInputElement>>;
+export declare const AmountField: default_2.ForwardRefExoticComponent<IAmountFieldProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Аватар, предназначен для отображения изображений профиля пользователя, инициалов или иконок. */
 export declare const Avatar: default_2.ForwardRefExoticComponent<IAvatarProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -793,24 +793,41 @@ 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;
 }
 
@@ -832,7 +849,15 @@ declare const CardMedia: default_2.FC<ICardMediaProps>;
 /** Компонент "Статичная карточка". */
 export declare const CardStatic: default_2.FC<ICardProps> & ICardStaticComposition;
 
-/* Excluded from this release type: Carousel */
+/** Карусель. */
+export declare const Carousel: default_2.ForwardRefExoticComponent<ICarouselProps & default_2.RefAttributes<HTMLDivElement>> & {
+    Viewport: default_2.ForwardRefExoticComponent<ICarouselViewportProps & default_2.RefAttributes<HTMLDivElement>>;
+    Track: default_2.ForwardRefExoticComponent<ICarouselTrackProps & default_2.RefAttributes<HTMLDivElement>>;
+    Item: default_2.ForwardRefExoticComponent<ICarouselItemProps & default_2.RefAttributes<HTMLDivElement>>;
+    PrevButton: default_2.ForwardRefExoticComponent<IButtonIconProps & default_2.RefAttributes<HTMLButtonElement>>;
+    NextButton: default_2.ForwardRefExoticComponent<IButtonIconProps & default_2.RefAttributes<HTMLButtonElement>>;
+    Indicators: default_2.ForwardRefExoticComponent<ICarouselIndicatorsProps & default_2.RefAttributes<HTMLDivElement>>;
+};
 
 /**
  * Карусель — горизонтально прокручиваемая лента произвольного контента.
@@ -920,14 +945,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>>;
 
@@ -935,7 +971,7 @@ export declare const ChipOptions: default_2.ForwardRefExoticComponent<IChipOptio
 export declare const ChipPanel: IChipPanelComposition;
 
 /** Компонент ChipPanelLinks. */
-declare const ChipPanelLinks: default_2.FC<IChipPanelLinksProps>;
+declare const ChipPanelLinks: default_2.ForwardRefExoticComponent<IChipPanelLinksProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
  * Компонент выбора одного значения из списка.
@@ -947,6 +983,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>>;
 
@@ -956,6 +996,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;
 
 /** Моноширинный текст (типографика). */
@@ -1107,7 +1151,7 @@ export declare const DateField: default_2.ForwardRefExoticComponent<IDateFieldPr
 export declare const dateFormatYYYYMMDD = "YYYYMMDD";
 
 /**
- * База для компонентов выбора даты (DateField, MonthYearField, ChipDatePicker).
+ * База для компонентов выбора даты (DateField, MonthYearField, ChipDatePicker, ChipMonthYearPicker).
  * Рендерит переданный целевым элемент и выпадающий Calendar, хранит состояние открытости
  * дропдауна и отдаёт его целевому элементу через DatePickerExtendedContext.
  */
@@ -1167,7 +1211,7 @@ declare const designTokensComponentsFormFieldKeys: readonly ["Background_Active"
 
 declare const designTokensComponentsHeaderPageKeys: readonly ["StickyShadow"];
 
-declare const designTokensComponentsImageGalleryKeys: readonly ["Arrow_Background_Default", "Arrow_Background_Hover", "Arrow_Background_Active", "Arrow_Background_Disabled", "Arrow_BorderColor_Default", "Arrow_BorderColor_Hover", "Arrow_BorderColor_Active", "Arrow_BorderColor_Disabled", "Dot_Background_Default", "Dot_Background_Hover", "Dot_Background_Active", "Thumb_Mask_Background", "Accent_Color"];
+declare const designTokensComponentsImageGalleryKeys: readonly ["Arrow_Background_Default", "Arrow_Background_Hover", "Arrow_Background_Active", "Arrow_BorderColor_Default", "Arrow_BorderColor_Hover", "Arrow_BorderColor_Active", "Dot_Background_Default", "Dot_Background_Hover", "Dot_Background_Active", "Thumb_Mask_Background", "Accent_Color"];
 
 declare const designTokensComponentsIslandAccordionKeys: readonly ["Type1_Header_Background_Hover", "Type2_Header_Background_Hover", "Type3_Header_Background_Hover", "Shadow_Focus"];
 
@@ -1657,10 +1701,15 @@ export declare enum ELoaderSmallTheme {
     NEUTRAL = "neutral"
 }
 
+/** Статус Marker. Задаёт цвет точки. */
 export declare enum EMarkerStatus {
+    /** Успешное завершение. */
     SUCCESS = "success",
+    /** Ошибка. */
     ERROR = "error",
+    /** Предупреждение. */
     WARNING = "warning",
+    /** Ожидание, процесс в работе. */
     WAITING = "waiting"
 }
 
@@ -2017,7 +2066,7 @@ export declare enum EVerticalAlign {
 export declare const ExpandAnimation: default_2.ForwardRefExoticComponent<IExpandAnimationProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Компонент панели под элементы фильтрации данных для таблицы. */
-export declare const FilterPanel: default_2.FC<IFilterPanelProps>;
+export declare const FilterPanel: default_2.ForwardRefExoticComponent<IFilterPanelProps & default_2.RefAttributes<HTMLDivElement>>;
 
 export declare const FocusTrapUtils: IFocusTrapUtils;
 
@@ -2095,7 +2144,7 @@ export declare const FormFieldDescription: default_2.FC<IFormFieldDescriptionPro
  * Компонент, отображающий input.
  *
  * Синхронизирует с FormFieldContext идентификатор элемента ввода, состояния фокуса и заполненности,
- * а также блокируется, когда поле имеет статус EFormFieldStatus.DISABLED.
+ * а также блокируется, когда поле имеет статус `EFormFieldStatus.DISABLED`.
  */
 export declare const FormFieldInput: default_2.ForwardRefExoticComponent<IFormFieldInputProps & default_2.RefAttributes<HTMLInputElement>>;
 
@@ -2139,8 +2188,10 @@ export declare const FormFieldTarget: default_2.ForwardRefExoticComponent<IFormF
 export declare const FormFieldTextarea: default_2.ForwardRefExoticComponent<IFormFieldTextareaProps & default_2.RefAttributes<HTMLTextAreaElement>>;
 
 /**
- * Элемент, объединяющий FormField, HelpBox, Alert, Description.
- * Дочерние элементы, передаются декларативно, это позволяет их кастомизировать и передавать data-атрибуты.
+ * Контейнер формы, объединяющий поле ввода с относящимися к нему элементами — `FormField`,
+ * `FormFieldDescription`, `HelpBox`, `AlertContext`. Части передаются декларативно через `children`,
+ * поэтому каждой можно задать свои props и data-атрибуты. Собственной разметки и стилей не
+ * добавляет: рендерит один `div` с переданными атрибутами.
  */
 export declare const FormGroup: default_2.ForwardRefExoticComponent<IFormGroupProps & default_2.RefAttributes<HTMLDivElement>>;
 
@@ -2194,7 +2245,12 @@ export declare const getScrollbarWidth: () => number;
 /** Глобальный ограничитель для выбора дат. Обе границы заданы всегда — служит fallback'ом для частично заданного `IDateLimitRange`. */
 export declare const globalLimitRange: Required<IDateLimitRange>;
 
-/** Заголовок. */
+/**
+ * Заголовок. Контейнер верхнего блока, собирающий уровни заголовка:
+ * `Header.Title` (заголовок и кнопки действий), `Header.Tabs` (табы и кнопки действий)
+ * и `Header.Subhead` (произвольный контент). Собственной визуальной оболочки не имеет —
+ * фон, рамку и отступы задаёт контейнер-родитель.
+ */
 export declare const Header: default_2.ForwardRefExoticComponent<IHeaderProps & default_2.RefAttributes<HTMLDivElement>> & {
     LayoutSidebar: default_2.ForwardRefExoticComponent<IHeaderLayoutSidebarProps & default_2.RefAttributes<HTMLDivElement>> & {
         Content: default_2.ForwardRefExoticComponent<IHeaderLayoutSidebarContentProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -2214,16 +2270,19 @@ export declare const Header: default_2.ForwardRefExoticComponent<IHeaderProps &
 /** Формат даты, отображаемый в заголовке. */
 export declare const headerDateFormat = "MMMM YYYY";
 
-/** Layout для Header с sidebar. */
+/**
+ * Layout для Header с sidebar. Раскладывает `HeaderLayoutSidebar.Content`
+ * и `HeaderLayoutSidebar.Sidebar` в строку; на ширине экрана до 767px sidebar скрывается.
+ */
 export declare const HeaderLayoutSidebar: default_2.ForwardRefExoticComponent<IHeaderLayoutSidebarProps & default_2.RefAttributes<HTMLDivElement>> & {
     Content: default_2.ForwardRefExoticComponent<IHeaderLayoutSidebarContentProps & default_2.RefAttributes<HTMLDivElement>>;
     Sidebar: default_2.ForwardRefExoticComponent<IHeaderLayoutSidebarSidebarProps & default_2.RefAttributes<HTMLDivElement>>;
 };
 
-/** Блок контента для Header с sidebar. */
+/** Блок контента для Header с sidebar. Занимает свободное место в строке. */
 export declare const HeaderLayoutSidebarContent: default_2.ForwardRefExoticComponent<IHeaderLayoutSidebarContentProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Header sidebar. */
+/** Header sidebar. Скрывается на ширине экрана до 767px. */
 export declare const HeaderLayoutSidebarSidebar: default_2.ForwardRefExoticComponent<IHeaderLayoutSidebarSidebarProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Заголовок страницы Page. Доступен как `Page.Header`. Верхний блок страницы с заголовком, табами и подзаголовком. */
@@ -2243,31 +2302,42 @@ export declare const HeaderPage: default_2.ForwardRefExoticComponent<(IHeaderPag
     };
 };
 
-/** Третий уровень Header. Содержит в себе произвольный контент. */
+/**
+ * Третий уровень Header. Содержит в себе произвольный контент.
+ * По умолчанию имеет вертикальные отступы 24px, которые снимаются свойством `withoutPaddings`.
+ */
 export declare const HeaderSubheader: default_2.ForwardRefExoticComponent<IHeaderSubheaderProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Второй уровень Header. Содержит в себе табы и кнопки действий. */
+/**
+ * Второй уровень Header. Содержит в себе табы и кнопки действий.
+ * Раскладывает `HeaderTabs.Content` и `HeaderTabs.Controls` в строку,
+ * на ширине экрана до 767px кнопки переносятся под табы.
+ */
 export declare const HeaderTabs: default_2.ForwardRefExoticComponent<IHeaderTabsProps & default_2.RefAttributes<HTMLDivElement>> & {
     Content: default_2.ForwardRefExoticComponent<IHeaderTabsContentProps & default_2.RefAttributes<HTMLDivElement>>;
     Controls: default_2.ForwardRefExoticComponent<IHeaderTabsControlsProps & default_2.RefAttributes<HTMLDivElement>>;
 };
 
-/** Контейнер табов. */
+/** Контейнер табов. Занимает свободное место в строке HeaderTabs. */
 export declare const HeaderTabsContent: default_2.ForwardRefExoticComponent<IHeaderTabsContentProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Блок с кнопками действий HeaderTabs. */
+/** Блок с кнопками действий HeaderTabs. Прижат вправо, не сжимается. */
 export declare const HeaderTabsControls: default_2.ForwardRefExoticComponent<IHeaderTabsControlsProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Первый уровень Header. Содержит заголовок, подзаголовок и кнопки действий. */
+/**
+ * Первый уровень Header. Содержит заголовок, подзаголовок и кнопки действий.
+ * Раскладывает `HeaderTitle.Content` и `HeaderTitle.Controls` в строку,
+ * на ширине экрана до 767px кнопки переносятся под контент.
+ */
 export declare const HeaderTitle: default_2.ForwardRefExoticComponent<IHeaderTitleProps & default_2.RefAttributes<HTMLDivElement>> & {
     Content: default_2.ForwardRefExoticComponent<IHeaderTitleContentProps & default_2.RefAttributes<HTMLDivElement>>;
     Controls: default_2.ForwardRefExoticComponent<IHeaderTitleControlsProps & default_2.RefAttributes<HTMLDivElement>>;
 };
 
-/** Часть HeaderTitle с заголовком и подзаголовком. */
+/** Часть HeaderTitle с заголовком и подзаголовком. Занимает свободное место в строке. */
 export declare const HeaderTitleContent: default_2.ForwardRefExoticComponent<IHeaderTitleContentProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Блок с кнопками действий HeaderTitle. */
+/** Блок с кнопками действий HeaderTitle. Прижат вправо, не сжимается. */
 export declare const HeaderTitleControls: default_2.ForwardRefExoticComponent<IHeaderTitleControlsProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Иконка "?" со всплывающей подсказкой выбранного размера. */
@@ -2353,6 +2423,7 @@ declare interface IAmountConst {
     GroupSeparator: string;
 }
 
+/** Свойства компонента AmountField. */
 export declare interface IAmountFieldProps extends Omit<ITextFieldBaseProps, "children"> {
     /** Свойства поля ввода. */
     inputProps: Omit<IFormFieldInputProps, "type" | "maxLength" | "onChange" | "inputMode" | "autoComplete"> & {
@@ -2360,6 +2431,8 @@ export declare interface IAmountFieldProps extends Omit<ITextFieldBaseProps, "ch
         value: string;
         /** Обработчик изменения значения. */
         onChange: (value: string) => void;
+        /** Ссылка на HTML-элемент поля ввода. */
+        ref?: default_2.Ref<HTMLInputElement>;
     };
     /** Наименование валюты. */
     currency?: string;
@@ -2512,8 +2585,14 @@ export declare interface IButtonDropdownExtendedButtonProvideProps {
     setOpened: (opened: boolean) => void;
 }
 
-/** Тип компонента "Кнопка с выпадающим блоком" со статическими субкомпонентами. */
-export declare interface IButtonDropdownExtendedComponent extends default_2.FC<IButtonDropdownExtendedProps> {
+/**
+ * Тип компонента "Кнопка с выпадающим блоком" со статическими субкомпонентами.
+ *
+ * Явная аннотация снимает проверку лишних свойств у Object.assign, поэтому при добавлении
+ * или удалении статики этот интерфейс нужно править синхронно: иначе новая статика окажется
+ * в рантайме, но не попадёт в публичный тип, и TypeScript промолчит.
+ */
+export declare interface IButtonDropdownExtendedComponent extends default_2.ForwardRefExoticComponent<IButtonDropdownExtendedProps & default_2.RefAttributes<HTMLDivElement>> {
     /** Выпадающий блок. */
     Dropdown: typeof Dropdown;
     /** Список опций для выпадающего блока. */
@@ -2738,21 +2817,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;
 }
 
@@ -2776,7 +2855,7 @@ declare interface ICardContentFooterProps extends default_2.HTMLAttributes<HTMLD
 
 /** Свойства компонента CardContent. */
 declare interface ICardContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Размер внутреннего отступа контента карточки. */
+    /** Размер внутреннего отступа контента карточки. По умолчанию ECardContentPaddingSize.MD. */
     paddingSize?: ECardContentPaddingSize;
 }
 
@@ -2788,10 +2867,11 @@ 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;
 }
 
@@ -2998,8 +3078,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;
@@ -3007,17 +3106,31 @@ 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">;
 }
 
-/** Внутренние составляющие панели табличных фильтров. */
-declare interface IChipPanelComposition extends default_2.FC<IChipPanelProps> {
+/**
+ * Внутренние составляющие панели табличных фильтров.
+ *
+ * Явная аннотация снимает проверку лишних свойств у Object.assign, поэтому при добавлении
+ * или удалении статики этот интерфейс нужно править синхронно: иначе новая статика окажется
+ * в рантайме, но не попадёт в публичный тип, и TypeScript промолчит.
+ */
+declare interface IChipPanelComposition extends default_2.ForwardRefExoticComponent<IChipPanelProps & default_2.RefAttributes<HTMLDivElement>> {
+    /** Блок со ссылками-действиями панели. */
     Links: typeof ChipPanelLinks;
 }
 
@@ -3062,6 +3175,7 @@ export declare interface IChipSelectTargetProps extends IChipProps {
     setOpened: (opened: boolean) => void;
 }
 
+/** Свойства компонента ChipSort. */
 export declare interface IChipSortProps extends Omit<IChipSelectProps, "targetProps" | "clearSelected" | "defaultValue"> {
     /** Дефолтное значение, если текущее значение равно дефолтному, элемент не будет подсвечен как измененный. */
     defaultValue?: ISelectExtendedFieldDefaultOption;
@@ -3074,20 +3188,20 @@ 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;
 }
 
@@ -3294,17 +3408,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>;
 }
 
@@ -3668,7 +3782,7 @@ export declare interface IFormFieldDescriptionProps extends default_2.HTMLAttrib
 }
 
 /** Свойства компонента FormFieldInput. */
-export declare interface IFormFieldInputProps extends default_2.InputHTMLAttributes<HTMLInputElement>, DataAttributes {
+export declare interface IFormFieldInputProps extends Omit<IFormFieldInputProvideProps, "disabled"> {
     /**
      * Рендер-функция, в которую можно передать любой инпут с нужным функционалом (валидация ввода, маска).
      * Через аргумент props инпуту передаётся нужная стилизация, идентификатор и обработчики событий.
@@ -3676,10 +3790,8 @@ export declare interface IFormFieldInputProps extends default_2.InputHTMLAttribu
     render?: (props: IFormFieldInputProvideProps, ref?: default_2.Ref<HTMLInputElement>) => default_2.ReactNode;
 }
 
-/** Свойства, передаваемые в рендер-функцию props.render компонента FormFieldInput. */
-export declare interface IFormFieldInputProvideProps extends Omit<IFormFieldInputProps, "render" | "size"> {
-    /** Размер поля из FormFieldContext. */
-    size: EComponentSize;
+/** Свойства, передаваемые в рендер-функцию компонента FormFieldInput. */
+export declare interface IFormFieldInputProvideProps extends default_2.InputHTMLAttributes<HTMLInputElement>, DataAttributes {
 }
 
 /** Свойства компонента FormFieldLabel. */
@@ -3689,7 +3801,7 @@ export declare interface IFormFieldLabelProps extends Omit<default_2.LabelHTMLAt
 }
 
 /** Свойства компонента FormFieldMaskedInput. */
-export declare interface IFormFieldMaskedInputProps extends Omit<MaskedInputProps, "guide" | "mask" | "render" | "defaultValue">, DataAttributes {
+export declare interface IFormFieldMaskedInputProps extends Omit<MaskedInputProps, "disabled" | "guide" | "mask" | "render" | "defaultValue">, DataAttributes {
     /** Значение поля. Поле контролируемое, поэтому начальное значение задаётся через него, а не через defaultValue. */
     value: string;
     /** Ссылка на поле ввода. */
@@ -3732,7 +3844,9 @@ export declare interface IFormFieldTextareaProps extends default_2.TextareaHTMLA
 }
 
 /** Свойства компонента FormGroup. */
-declare interface IFormGroupProps extends default_2.HTMLAttributes<HTMLDivElement> {
+export declare interface IFormGroupProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Части группы: поле ввода и относящиеся к нему подсказки и сообщения. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента Gap. */
@@ -3743,14 +3857,20 @@ export declare interface IGapProps extends Omit<default_2.HTMLAttributes<HTMLDiv
 
 /** Свойства компонента HeaderLayoutSidebarContent. */
 export declare interface IHeaderLayoutSidebarContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Основной контент заголовка. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента HeaderLayoutSidebar. */
 export declare interface IHeaderLayoutSidebarProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое раскладки. Обычно составные HeaderLayoutSidebar.Content и HeaderLayoutSidebar.Sidebar. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента HeaderLayoutSidebarSidebar. */
 export declare interface IHeaderLayoutSidebarSidebarProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое сайдбара. */
+    children?: default_2.ReactNode;
 }
 
 export declare interface IHeaderPageTypeFirstProps extends IHeaderProps {
@@ -3777,36 +3897,52 @@ export declare interface IHeaderPageTypeSecondProps extends IHeaderProps {
 
 /** Свойства компонента Header. */
 export declare interface IHeaderProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое заголовка. Обычно составные Header.Title, Header.Tabs и Header.Subhead. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента HeaderSubheader. */
 export declare interface IHeaderSubheaderProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Свойство отключающее padding. */
+    /** Произвольный контент третьего уровня заголовка. */
+    children?: default_2.ReactNode;
+    /** Свойство отключающее padding. По умолчанию false. */
     withoutPaddings?: boolean;
 }
 
 /** Свойства компонента HeaderTabsContent. */
 export declare interface IHeaderTabsContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Табы. Обычно компонент Tabs. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента HeaderTabsControls. */
 export declare interface IHeaderTabsControlsProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Кнопки действий. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента HeaderTabs. */
 export declare interface IHeaderTabsProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое уровня. Обычно составные HeaderTabs.Content и HeaderTabs.Controls. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента HeaderTitleContent. */
 export declare interface IHeaderTitleContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Заголовок и подзаголовок. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента HeaderTitleControls. */
 export declare interface IHeaderTitleControlsProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Кнопки действий. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента HeaderTitle. */
 export declare interface IHeaderTitleProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое уровня. Обычно составные HeaderTitle.Content и HeaderTitle.Controls. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента HelpBox. */
@@ -3819,9 +3955,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;
@@ -4003,6 +4139,7 @@ export declare interface IImageGalleryThumbRenderState {
 
 /** Свойства компонента IslandAccordionContent. */
 export declare interface IIslandAccordionContentProps {
+    /** Содержимое раскрывающейся части элемента аккордеона. */
     children?: default_2.ReactNode;
 }
 
@@ -4010,30 +4147,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;
 }
 
@@ -4069,13 +4209,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> {
 }
 
@@ -4084,7 +4226,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. */
@@ -4092,18 +4234,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;
@@ -4111,10 +4255,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> {
 }
 
@@ -4250,9 +4395,9 @@ export declare interface ILightBoxSideOverlayProps extends default_2.HTMLAttribu
 export declare interface ILinkCommonProps extends default_2.AnchorHTMLAttributes<HTMLAnchorElement> {
     /** Тело гиперссылки. */
     children: default_2.ReactNode;
-    /** Рендер функция предшествующего контента. */
+    /** Рендер-функция контента перед телом гиперссылки. Для строкового children приклеивается к первому слову. */
     contentBefore?: () => default_2.ReactElement;
-    /** Рендер функция последующего контента. */
+    /** Рендер-функция контента после тела гиперссылки. Для строкового children приклеивается к последнему слову. */
     contentAfter?: () => default_2.ReactElement;
 }
 
@@ -4513,16 +4658,21 @@ export declare const ImageGalleryExtendedThumb: default_2.ForwardRefExoticCompon
  */
 export declare const ImageGalleryExtendedThumbnails: default_2.ForwardRefExoticComponent<IImageGalleryExtendedThumbnailsProps & default_2.RefAttributes<HTMLDivElement>>;
 
+/** Свойства компонента Marker. */
 export declare interface IMarkerProps extends IBadgeDotProps {
+    /** Статус, задающий цвет точки. Обязательный, значения по умолчанию нет. */
     status: EMarkerStatus;
 }
 
+/** Свойства компонента MarkerStatus. */
 export declare interface IMarkerStatusProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Статус. */
+    /** Статус. Задаёт цвет маркера. */
     status: EMarkerStatus;
+    /** Наименование статуса. */
+    children?: default_2.ReactNode;
     /** Дополнительное описание под наименованием статуса. */
     description?: default_2.ReactNode;
-    /** Размер. */
+    /** Размер. По умолчанию EComponentSize.MD. */
     size?: EComponentSize.MD | EComponentSize.LG;
 }
 
@@ -4541,7 +4691,22 @@ export declare interface IMaskedFieldProps extends Omit<ITextFieldBaseProps, "ch
     };
 }
 
-declare interface IMasterTableFC extends default_2.FC<IMasterTableProps> {
+/** Свойства компонента MasterTable. */
+export declare interface IMasterTableProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Состояние загрузки. */
+    loading?: boolean;
+}
+
+/**
+ * Статические субкомпоненты MasterTable. Тип задан через typeof-запросы, а не выведен:
+ * TableBasicSettings и TableFooter типизированы неэкспортируемыми интерфейсами, и выведенный
+ * тип Object.assign невозможно сгенерировать в d.ts (TS4023) — declaration emit падает.
+ *
+ * Явная аннотация снимает проверку лишних свойств у Object.assign, поэтому при добавлении
+ * или удалении статики этот интерфейс нужно править синхронно: иначе новая статика окажется
+ * в рантайме, но не попадёт в публичный тип, и TypeScript промолчит.
+ */
+declare interface IMasterTableStatics {
     NoColumns: typeof NoColumns;
     FilterPanel: typeof FilterPanel;
     ChipPanel: typeof ChipPanel;
@@ -4551,12 +4716,6 @@ declare interface IMasterTableFC extends default_2.FC<IMasterTableProps> {
     PaginationPanel: typeof PaginationPanel;
 }
 
-/** Свойства компонента MasterTable. */
-export declare interface IMasterTableProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Состояние загрузки. */
-    loading?: boolean;
-}
-
 /** Свойства компонента MediaBetweenWidth. */
 export declare interface IMediaBetweenWidthProps {
     /** Элементы, которые рендерятся, когда ширина окна браузера попадает в диапазон minWidth и/или maxWidth. */
@@ -4730,6 +4889,7 @@ export declare interface IMonthYearRangeProps extends Omit<default_2.HTMLAttribu
 
 /** Свойства компонента MultiselectFieldDropdownContent. */
 declare interface IMultiselectFieldDropdownContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Показать лоадер поверх содержимого. По умолчанию false. */
     loading?: boolean;
 }
 
@@ -4747,8 +4907,9 @@ declare interface IMultiselectFieldDropdownProps extends IDropdownProps {
     focusTrapProps?: FocusTrapProps;
 }
 
+/** Свойства компонента MultiselectField. */
 export declare interface IMultiselectFieldProps extends ISelectExtendedFieldProps {
-    /** Размер компонента. */
+    /** Размер компонента. По умолчанию EComponentSize.MD. */
     size?: EComponentSize;
 }
 
@@ -5159,18 +5320,21 @@ export declare interface ISelectExtendedFieldTargetProvideProps {
     setOpened: (opened: boolean) => void;
 }
 
+/** Свойства опции списка. */
 export declare interface ISelectFieldOption extends ISelectExtendedFieldDefaultOption {
 }
 
+/** Свойства компонента SelectField. */
 export declare interface ISelectFieldProps extends Omit<ISelectExtendedFieldProps, "children" | "onChange" | "renderTarget">, Pick<ISelectExtendedFieldTargetProps, "loading" | "status" | "placeholder"> {
     /** Размер компонента. */
     size: EComponentSize;
+    /** Выпадающий блок компонент рендерит сам, поэтому children не принимаются. */
     children?: never;
-    /** Текущее выбранное значение. */
+    /** Текущее выбранное значение. С опцией списка сопоставляется по полю id. */
     value?: ISelectFieldOption;
     /** Список опций. */
     options: ISelectFieldOption[];
-    /** Обработчик изменения значения. */
+    /** Обработчик изменения значения. Вызывается с выбранной опцией, список при этом закрывается. */
     onChange: (option: ISelectFieldOption) => void;
     /** Свойства, передающиеся в SelectExtendedField.Target. */
     targetProps?: Omit<ISelectExtendedFieldTargetProps, "opened" | "setOpened" | "size">;
@@ -5207,6 +5371,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>;
@@ -5214,12 +5382,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>;
@@ -5234,6 +5403,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>;
@@ -5241,24 +5414,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. */
@@ -5382,27 +5580,27 @@ declare interface ISMSFieldComposition {
 }
 
 /** Свойства SMSField.Input. */
-export declare interface ISMSFieldInputProps extends default_2.InputHTMLAttributes<HTMLInputElement> {
+export declare interface ISMSFieldInputProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement>, "disabled"> {
     /** Счётчик символов */
     counter?: default_2.ReactNode;
     /** Описание поля ввода */
     description?: default_2.ReactNode;
+    /** Текст ошибки. Отображается вместо placeholder в статусе EFormFieldStatus.ERROR, пока поле не в фокусе. */
+    errorText?: string;
 }
 
 /** Свойства компонента SMSField. */
 export declare interface ISMSFieldProps extends default_2.HTMLAttributes<HTMLDivElement>, TestProps {
     /** Значение кода. */
     code: string;
-    /** Признак блокировки компонента. */
-    disabled?: boolean;
-    /** Признак наличия ошибки. */
-    error?: boolean;
     /** Обработчик изменения кода. */
     onChangeCode: (code: string) => void;
     /** Обработчик отправки кода. */
     onSubmitCode: (code: string) => void;
     /** Размер поля. */
     size: EComponentSize;
+    /** Визуальное состояние компонента. По умолчанию EFormFieldStatus.DEFAULT. */
+    status?: Exclude<EFormFieldStatus, EFormFieldStatus.WARNING>;
 }
 
 /** Свойства SMSField.Refresh. */
@@ -5569,16 +5767,25 @@ export declare interface IStepProps extends default_2.HTMLAttributes<HTMLDivElem
     position?: EStepPosition;
 }
 
-/** Свойства контекста Suggest. */
+/** Значение контекста Suggest. Доступно любому потомку через useSuggestContext. */
 declare interface ISuggestContext<T extends ISuggestOption> extends Pick<ISuggestProps<T>, "value" | "options" | "placeholder" | "noOptionsText" | "loading" | "dropdownListLoading" | "tooltipOpen" | "clearInputOnFocus" | "onSelect" | "onFilter" | "onScrollEnd"> {
+    /** Текущее значение поля ввода. Не совпадает с value.label, пока идёт фильтрация. */
     inputValue: string;
+    /** Сеттер значения поля ввода. Не вызывает onFilter — для фильтрации используй onFilter. */
     setInputValue: default_2.Dispatch<default_2.SetStateAction<string>>;
+    /** Идентификатор элемента списка, выделенного клавиатурой. Для aria-activedescendant. */
     activeDescendant: string | undefined;
+    /** Выпадающий список открыт. */
     dropdownOpen: boolean;
+    /** Сеттер видимости выпадающего списка. Не сбрасывает поле ввода — для закрытия используй closeDropdown. */
     setDropdownOpen: default_2.Dispatch<default_2.SetStateAction<boolean>>;
+    /** Закрывает выпадающий список и возвращает в поле ввода newInputValue либо label выбранного значения. */
     closeDropdown: (newInputValue?: string) => void;
+    /** Идентификатор выпадающего списка. Для aria-controls на управляющем элементе. */
     dropdownListId: string;
+    /** Ссылка на корневой элемент Suggest. Заполняется компонентом Suggest. */
     suggestRef: default_2.MutableRefObject<HTMLDivElement | null>;
+    /** Ссылка на элемент выпадающего списка. Заполняет потребитель, чтобы клик по списку не считался внешним. */
     dropdownRef: default_2.MutableRefObject<HTMLDivElement | null>;
 }
 
@@ -5705,7 +5912,7 @@ export declare interface ISuggestProps<T extends ISuggestOption = ISuggestOption
     value: T | undefined;
     /** Список значений. */
     options: T[];
-    /** Размер. */
+    /** Размер. Suggest его не отображает — свойство раздаётся управляющему элементу и выпадающему списку. */
     size: EComponentSize;
     /** Текст подсказки. */
     placeholder?: string;
@@ -5715,7 +5922,7 @@ export declare interface ISuggestProps<T extends ISuggestOption = ISuggestOption
     loading?: boolean;
     /** Флаг управления видимостью Tooltip. */
     tooltipOpen?: boolean;
-    /** Флаг состояния загрукзи DropdownList. */
+    /** Флаг состояния загрузки DropdownList. */
     dropdownListLoading?: boolean;
     /** Определяет, нужно ли очищать поле ввода при получении фокуса. */
     clearInputOnFocus?: boolean;
@@ -5765,11 +5972,11 @@ export declare interface ISwipeableAreaProps extends default_2.HTMLAttributes<HT
 }
 
 export declare interface ISwipeableAreaRef {
-    /** Закрывает leftSwipeableAreaRef или rightSwipeableArea. */
+    /** Закрывает leftSwipeableArea или rightSwipeableArea. */
     closeSwipe: () => void;
     /** Открывает rightSwipeableArea. */
     swipeLeft: () => void;
-    /** Открывает leftSwipeableAreaRef. */
+    /** Открывает leftSwipeableArea. */
     swipeRight: () => void;
 }
 
@@ -5850,10 +6057,21 @@ export declare interface ITableBasicRow {
 export declare interface ITableBasicSettingsBodyProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
-declare interface ITableBasicSettingsFC extends default_2.FC<ITableBasicSettingsProps> {
+/**
+ * Статические субкомпоненты TableBasicSettings.
+ *
+ * Явная аннотация снимает проверку лишних свойств у Object.assign, поэтому при добавлении
+ * или удалении статики этот интерфейс нужно править синхронно: иначе новая статика окажется
+ * в рантайме, но не попадёт в публичный тип, и TypeScript промолчит.
+ */
+declare interface ITableBasicSettingsComposition extends default_2.ForwardRefExoticComponent<ITableBasicSettingsProps & default_2.RefAttributes<HTMLDivElement>> {
+    /** Тело выпадающего блока настроек. */
     Body: typeof TableBasicSettingsBody;
+    /** Список колонок с управлением видимостью и порядком. */
     ColumnSettings: typeof ColumnSettings;
+    /** Подвал выпадающего блока настроек. */
     Footer: typeof TableBasicSettingsFooter;
+    /** Шапка выпадающего блока настроек. */
     Header: typeof TableBasicSettingsHeader;
 }
 
@@ -5872,8 +6090,17 @@ export declare interface ITableBasicSettingsProps extends Omit<IButtonDropdownEx
     children?: default_2.ReactNode;
 }
 
-declare interface ITableFooterFC extends default_2.FC<ITableFooterProps> {
+/**
+ * Статические субкомпоненты TableFooter.
+ *
+ * Явная аннотация снимает проверку лишних свойств у Object.assign, поэтому при добавлении
+ * или удалении статики этот интерфейс нужно править синхронно: иначе новая статика окажется
+ * в рантайме, но не попадёт в публичный тип, и TypeScript промолчит.
+ */
+declare interface ITableFooterComposition extends default_2.ForwardRefExoticComponent<ITableFooterProps & default_2.RefAttributes<HTMLDivElement>> {
+    /** Блок с итоговыми значениями по таблице. */
     Summary: typeof TableFooterSummary;
+    /** Блок с кнопками действий над выбранными строками. */
     Controls: typeof FooterDescriptionControls;
 }
 
@@ -6139,7 +6366,7 @@ declare interface ITextFieldBaseProps extends Omit<IFormFieldProps, "prefix" | "
 export declare interface ITextFieldProps extends Omit<ITextFieldBaseProps, "children"> {
     /** Свойства поля ввода. */
     inputProps: IFormFieldInputProps & {
-        ref?: default_2.RefObject<HTMLInputElement>;
+        ref?: default_2.Ref<HTMLInputElement>;
     };
 }
 
@@ -6691,8 +6918,13 @@ export declare const LoaderScreen: default_2.ForwardRefExoticComponent<ILoaderSc
  */
 export declare const LoaderSmall: default_2.FC<ILoaderSmallProps>;
 
-export declare const Marker: default_2.FC<IMarkerProps>;
+/**
+ * Точка-индикатор статуса.
+ * Обёртка над Badge.Dot: добавляет цвет по статусу, всё остальное (размер, разметка, ref) — от Badge.Dot.
+ * */
+export declare const Marker: default_2.ForwardRefExoticComponent<IMarkerProps & default_2.RefAttributes<HTMLSpanElement>>;
 
+/** Статус: цветной маркер, наименование статуса и необязательное описание под ним. */
 export declare const MarkerStatus: default_2.ForwardRefExoticComponent<IMarkerStatusProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -6701,7 +6933,11 @@ export declare const MarkerStatus: default_2.ForwardRefExoticComponent<IMarkerSt
  */
 export declare const MaskedField: default_2.ForwardRefExoticComponent<IMaskedFieldProps & default_2.RefAttributes<HTMLDivElement>>;
 
-export declare const MasterTable: IMasterTableFC;
+/**
+ * Контейнер таблицы. Объединяет панели фильтров, саму таблицу, подвал и пагинацию,
+ * раздавая им общее состояние (колонки и признак загрузки) через MasterTableContext.
+ */
+export declare const MasterTable: default_2.ForwardRefExoticComponent<IMasterTableProps & default_2.RefAttributes<HTMLDivElement>> & IMasterTableStatics;
 
 /**
  * Компонент, который рендерит children в случае, если ширина окна браузера попадает в диапазон между minWidth и maxWidth.
@@ -6789,7 +7025,14 @@ export declare const MonthYearField: default_2.ForwardRefExoticComponent<IMonthY
 /** Выбор диапазона месяцев. */
 export declare const MonthYearRange: default_2.ForwardRefExoticComponent<IMonthYearRangeProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Компонент мульти-списка. */
+/**
+ * Компонент мульти-списка.
+ *
+ * Надстройка над SelectExtendedField: раздаёт размер и признак «блок открыт мышью»
+ * своим частям через MultiselectFieldContext. Состоянием открытости и разметкой
+ * владеет SelectExtendedField — поле выбора приходит в renderTarget, выпадающий
+ * блок в children.
+ */
 export declare const MultiselectField: default_2.ForwardRefExoticComponent<IMultiselectFieldProps & default_2.RefAttributes<HTMLDivElement>> & {
     Dropdown: default_2.ForwardRefExoticComponent<IMultiselectFieldDropdownProps & default_2.RefAttributes<HTMLDivElement>> & {
         Header: default_2.FC<IMultiselectFieldDropdownHeaderProps>;
@@ -6800,7 +7043,7 @@ export declare const MultiselectField: default_2.ForwardRefExoticComponent<IMult
 };
 
 /** Компонент отображающий информацию, когда скрыты все колонки таблицы. */
-export declare const NoColumns: default_2.FC<INoColumnsProps>;
+export declare const NoColumns: default_2.ForwardRefExoticComponent<INoColumnsProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
  * Notification. Может содержать только Icon, Body, Close, Time.
@@ -6911,7 +7154,7 @@ export declare const PaginationPageButton: default_2.ForwardRefExoticComponent<I
 export declare const PaginationPageEllipsis: default_2.ForwardRefExoticComponent<IPaginationPageEllipsisProps & default_2.RefAttributes<HTMLSpanElement>>;
 
 /** Компонент панели под элементы пагинации таблицы. */
-export declare const PaginationPanel: default_2.FC<IPaginationPanelProps>;
+export declare const PaginationPanel: default_2.ForwardRefExoticComponent<IPaginationPanelProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Выбор количества элементов на странице. */
 export declare const PaginationSelect: default_2.ForwardRefExoticComponent<IPaginationSelectProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -6972,6 +7215,12 @@ export declare const SelectExtendedFieldDropdown: ISelectExtendedFieldDropdownFC
  */
 export declare const SelectExtendedFieldTarget: default_2.ForwardRefExoticComponent<ISelectExtendedFieldTargetProps & default_2.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Базовый компонент SelectField.
+ * Готовый Select со списком опций: поле выбора и выпадающий блок собраны заранее, состоянием
+ * открытости владеет SelectExtendedField. Сам компонент отвечает только за связку поля со списком
+ * (aria-controls, aria-activedescendant) и за прокидывание опций в выпадающий блок.
+ */
 export declare const SelectField: default_2.ForwardRefExoticComponent<ISelectFieldProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Контент SelectionControls. */
@@ -7016,7 +7265,11 @@ export declare class SliderRange extends default_2.Component<ISliderRangeProps,
     private handleChange;
 }
 
-/** Уменьшенное поле ввода, используется в HeaderPage. */
+/**
+ * Компактное однострочное поле ввода высотой 20px без лейбла, статусов и обвязки FormField.
+ * Рассчитано на инлайн-редактирование в плотной вёрстке — например, номера документа в DocumentNumberEdit.
+ * Всегда рендерит `type="text"`: переданный извне `type` не применяется.
+ */
 export declare const SmallInput: default_2.ForwardRefExoticComponent<ISmallInputProps & default_2.RefAttributes<HTMLInputElement>>;
 
 /** Компонент для ввода СМС. */
@@ -7117,9 +7370,15 @@ export declare const StringUtils: {
     isUnaryMinus: (char: string) => boolean;
 };
 
+/**
+ * Headless-основа выпадающего списка с фильтрацией по введённому значению.
+ * Собственной разметки не добавляет: рендерит div-обёртку и раздаёт потомкам через SuggestContext
+ * состояние поля ввода, видимость выпадающего списка и обработчики выбора и фильтрации.
+ * Управляющий элемент и выпадающий список пишет потребитель — как это делает ChipSuggest.
+ */
 export declare const Suggest: <T extends ISuggestOption = ISuggestOption>(props: ISuggestProps<T> & default_2.RefAttributes<HTMLDivElement>) => JSX.Element;
 
-/** Контекст компонента SuggestContext. */
+/** Контекст компонента Suggest. */
 export declare const SuggestContext: default_2.Context<ISuggestContext<any>>;
 
 /** Выпадающий список с возможностью поиска по введённому значению. */
@@ -7164,8 +7423,8 @@ export declare const SwipeableArea: default_2.ForwardRefExoticComponent<ISwipeab
  */
 export declare const TableBasic: default_2.ForwardRefExoticComponent<ITableBasicProps & default_2.RefAttributes<HTMLTableElement>>;
 
-/** Компонент панели под элементы фильтрации данных для таблицы. */
-export declare const TableBasicSettings: ITableBasicSettingsFC;
+/** Ссылка-триггер, открывающая выпадающий блок с настройками колонок таблицы. */
+export declare const TableBasicSettings: ITableBasicSettingsComposition;
 
 declare const TableBasicSettingsBody: default_2.ForwardRefExoticComponent<ITableBasicSettingsBodyProps & default_2.RefAttributes<HTMLDivElement>>;
 
@@ -7174,7 +7433,7 @@ declare const TableBasicSettingsFooter: default_2.ForwardRefExoticComponent<ITab
 declare const TableBasicSettingsHeader: default_2.FC<ITableBasicSettingsHeaderProps>;
 
 /** Компонент подвала таблицы. */
-export declare const TableFooter: ITableFooterFC;
+export declare const TableFooter: ITableFooterComposition;
 
 /** Компонент суммарной информации в подвале таблицы. */
 declare const TableFooterSummary: (({ children, ...htmlDivAttributes }: ITableFooterSummaryProps) => JSX_2.Element) & {