@sberbusiness/triplex-next 1.39.0 → 1.41.0

package/index.d.ts

@@ -124,9 +124,18 @@ export declare const Button: default_2.ForwardRefExoticComponent<TButtonProps &
  */
 export declare const ButtonDropdown: default_2.ForwardRefExoticComponent<(IButtonDropdownBaseProps | IButtonDotsProps) & default_2.RefAttributes<HTMLButtonElement>>;
 
+/**
+ * Компонент "Кнопка с выпадающим блоком".
+ * Позволяет кастомизировать кнопку открытия Dropdown и сам Dropdown через render-функции.
+ * Пока блок открыт, слушает документ и закрывает его по Escape, по Tab (при closeOnTab)
+ * и по клику вне кнопки и вне выпадающего блока.
+ */
 export declare const ButtonDropdownExtended: IButtonDropdownExtendedComponent;
 
-/** Кнопка-иконка. */
+/**
+ * Кнопка-иконка — компактный интерактивный элемент без текстового контента.
+ * Размер задаётся размером переданной иконки. Требует aria-label от потребителя.
+ */
 export declare const ButtonIcon: default_2.ForwardRefExoticComponent<IButtonIconProps & default_2.RefAttributes<HTMLButtonElement>>;
 
 /** Вычисление позиции шага, относительно других. */
@@ -136,7 +145,7 @@ export declare const calcPosition: (stepCount: number, i: number) => EStepPositi
 export declare class Calendar extends default_2.PureComponent<ICalendarProps, ICalendarState> {
     static defaultProps: {
         format: string;
-        limitRange: IDateLimitRange;
+        limitRange: Required<IDateLimitRange>;
         pickType: ECalendarPickType;
     };
     static contextType: default_2.Context<ICalendarContext>;
@@ -1019,8 +1028,8 @@ export declare const ColumnSettings: default_2.ForwardRefExoticComponent<IColumn
 /** Элемент компонента ColumnSettingsSortableList. */
 export declare const ColumnSettingsSortableListItem: default_2.ForwardRefExoticComponent<IColumnSettingsSortableListItemProps & default_2.RefAttributes<HTMLLIElement>>;
 
-/** Композитор слушателей нажатия клавиш. */
-export declare const ComposedKeyDownListener: default_2.FC<IKeyDownListenerManagerProps>;
+/** Композитор слушателей нажатия клавиш. Оборачивает children в KeyDownListener на каждый элемент keyDownListeners. */
+export declare const ComposedKeyDownListener: default_2.FC<IComposedKeyDownListenerProps>;
 
 /** Компонент предупреждения, о закрытии лайтбокса / боковой панели лайтбокса. */
 export declare const Confirm: IConfirmFC;
@@ -1168,7 +1177,7 @@ declare const designTokensComponentsSmallInputKeys: readonly ["Background", "Col
 
 declare const designTokensComponentsSMSFieldKeys: readonly ["Refresh_Fill_Empty", "Refresh_Fill_Full", "Refresh_Disabled", "Submit_Background_Default", "Submit_Background_Hover", "Submit_Background_Active"];
 
-declare const designTokensComponentsStatusTrackerKeys: readonly ["Draft_Background", "Warning_Background", "Waiting_Background", "Rejected_Background", "Approved_Background", "Waiting_Color", "Rejected_Color", "Approved_Color", "Border_Color"];
+declare const designTokensComponentsStatusTrackerKeys: readonly ["Background", "Draft_Background", "Warning_Background", "Waiting_Background", "Rejected_Background", "Approved_Background", "Draft_Color", "Waiting_Color", "Rejected_Color", "Approved_Color", "Border_Color"];
 
 declare const designTokensComponentsStepKeys: readonly ["Color_Active", "Color_Default", "Color_Disabled", "Color_Done", "Color_Error", "Color_Warning", "Background_Active", "Background_Default", "Background_Disabled", "Background_Done", "Background_Error", "Background_Warning"];
 
@@ -1226,22 +1235,36 @@ export declare const Divider: default_2.FC<IDividerProps>;
 /** Поле редактирования номера документа. */
 export declare const DocumentNumberEdit: default_2.FC<IDocumentNumberEditProps>;
 
-/** Выпадающее меню. */
+/**
+ * Выпадающее меню.
+ * Рендерится через Portal в document.body и позиционируется относительно targetRef.
+ * Если передан mobileViewProps, на мобильной ширине экрана вместо десктопного меню рендерится
+ * полноэкранная мобильная версия (DropdownMobile).
+ */
 export declare const Dropdown: default_2.ForwardRefExoticComponent<IDropdownProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Выпадающее меню. */
+/**
+ * Десктопная версия выпадающего меню.
+ * Позиционируется фиксированно относительно targetRef, пересчитывает положение при скролле,
+ * ресайзе окна и изменении размеров меню или управляющего элемента. Пока меню открыто,
+ * скролл страницы вне меню заблокирован. В закрытом состоянии ничего не рендерит.
+ */
 export declare const DropdownDesktop: default_2.ForwardRefExoticComponent<IDropdownDesktopProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
  * Компонент DropdownList.
- * Используется для обрамления вложенного списка и добавляет спику возможность навигации с клавиатуры.
- * В качестве children принимает только DropdownDesktopList.Item.
+ * Используется для обрамления вложенного списка и добавляет списку возможность навигации с клавиатуры.
+ * В качестве children принимает только DropdownList.Item.
  */
 export declare const DropdownList: IDropdownListComponent;
 
 export declare const DropdownListContext: Context<IDropdownListContext>;
 
-/** Элемент выпадающего списка. */
+/**
+ * Элемент выпадающего списка.
+ * Пока элемент активен (active), слушает клавиатуру документа и вызывает onSelect
+ * при нажатии клавиш из keyCodesForSelection.
+ */
 export declare const DropdownListItem: default_2.ForwardRefExoticComponent<IDropdownListItemProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Мобильная версия Dropdown. */
@@ -1372,6 +1395,7 @@ export declare enum ECardContentPaddingSize {
 
 /** Возможные размеры скругления карточки. */
 export declare enum ECardRoundingSize {
+    LG = "lg",
     MD = "md",
     SM = "sm"
 }
@@ -1516,10 +1540,15 @@ export declare enum EFooterPageType {
     SECOND = "second"
 }
 
+/** Визуальное состояние поля ввода. */
 export declare enum EFormFieldStatus {
+    /** Обычное состояние. */
     DEFAULT = "default",
+    /** Поле заблокировано: вложенные элементы ввода недоступны для взаимодействия. */
     DISABLED = "disabled",
+    /** Состояние ошибки. */
     ERROR = "error",
+    /** Состояние предупреждения. */
     WARNING = "warning"
 }
 
@@ -1543,8 +1572,11 @@ export declare enum EImageGalleryArrowDirection {
 
 /** Типы компонента Island. Отличаются цвет и тень. */
 export declare enum EIslandType {
+    /** Основной тип: непрозрачный фон, без тени. */
     TYPE_1 = "type_1",
+    /** Полупрозрачный фон с внутренней рамкой. */
     TYPE_2 = "type_2",
+    /** Приглушённый фон, без тени. */
     TYPE_3 = "type_3"
 }
 
@@ -1739,10 +1771,10 @@ export declare enum ETitleSize {
 }
 
 /**
- * Выравнивание для позиционирования (вроде как для треугольничка).
+ * Выравнивание указателя (стрелочки) подсказки относительно целевого элемента.
  *
  * END В конце.
- * CENTER По центру
+ * CENTER По центру.
  * START В начале.
  */
 export declare enum ETooltipAlign {
@@ -1814,6 +1846,12 @@ export declare enum ETooltipPreferPlace {
     LEFT = "left"
 }
 
+/**
+ * Размер подсказки (ширина тела в десктопной версии).
+ *
+ * SM Узкая подсказка, 192px.
+ * LG Широкая подсказка, 384px.
+ */
 export declare enum ETooltipSize {
     SM = "sm",
     LG = "lg"
@@ -1844,9 +1882,9 @@ export declare enum ETooltipStartCoordinates {
 /**
  * Enum типов настроек позиционирования.
  *
- * SIDE Сторона ддля типа.
- * STANDING Положение поповера относительно элемента (но это не точно).
- * FLOW Расположение элементов.
+ * SIDE Выравнивание подсказки вдоль основной оси зоны.
+ * STANDING Положение подсказки относительно целевого элемента.
+ * FLOW Расположение элементов (направление flex).
  */
 export declare enum ETooltipTypeName {
     SIDE = "side",
@@ -1854,8 +1892,11 @@ export declare enum ETooltipTypeName {
     FLOW = "flow"
 }
 
+/** Темы Triplex Next. Тема определяет значения дизайн-токенов. */
 export declare enum ETriplexNextTheme {
+    /** Светлая тема. Используется по умолчанию. */
     LIGHT = "light",
+    /** Тёмная тема. */
     DARK = "dark"
 }
 
@@ -1964,22 +2005,52 @@ export declare const FooterPage: default_2.ForwardRefExoticComponent<(IFooterPag
  */
 export declare function formatAmount(amount: string | default_4, fractionLength?: number | null, separateGroups?: boolean, fillFraction?: boolean): string;
 
-/** Элемент, отображающий input/select/textarea + label. */
+/**
+ * Элемент, отображающий input/select/textarea + label.
+ *
+ * Является провайдером FormFieldContext: размер, статус и состояния поля (фокус, заполненность,
+ * идентификаторы элемента ввода и лейбла, ширины префикса и постфикса) распространяются
+ * на вложенные FormFieldLabel / FormFieldInput / FormFieldTarget и другие субкомпоненты.
+ */
 export declare const FormField: default_2.ForwardRefExoticComponent<IFormFieldProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Кнопка очищения введенного значения. */
+/**
+ * Кнопка очистки введённого значения.
+ *
+ * Гасит установку фокуса на mousedown, чтобы поле ввода не теряло фокус при клике по кнопке.
+ */
 export declare const FormFieldClear: default_2.ForwardRefExoticComponent<IFormFieldClearProps & default_2.RefAttributes<HTMLButtonElement>>;
 
-/** Отображает дополнительную информацию под полем ввода справа, счетчик символов. */
+/**
+ * Счётчик символов. Отображает дополнительную информацию под полем ввода справа.
+ *
+ * Сообщает родительскому FormFieldDescription о своём присутствии через FormFieldDescriptionContext.
+ */
 export declare const FormFieldCounter: default_2.FC<IFormFieldCounterProps>;
 
-/** Отображает дополнительную информацию под полем ввода. */
+/**
+ * Отображает дополнительную информацию под полем ввода.
+ *
+ * Является провайдером FormFieldDescriptionContext: вложенный FormFieldCounter сообщает
+ * о своём присутствии, и описание перестраивает раскладку под счётчик.
+ */
 export declare const FormFieldDescription: default_2.FC<IFormFieldDescriptionProps>;
 
-/** Компонент, отображающий input. */
+/**
+ * Компонент, отображающий input.
+ *
+ * Синхронизирует с FormFieldContext идентификатор элемента ввода, состояния фокуса и заполненности,
+ * а также блокируется, когда поле имеет статус EFormFieldStatus.DISABLED.
+ */
 export declare const FormFieldInput: default_2.ForwardRefExoticComponent<IFormFieldInputProps & default_2.RefAttributes<HTMLInputElement>>;
 
-/** Лейбл поля ввода/селекта. Отображается по-середине поля ввода, когда инпут/селект имеет значение или фокус, перемещается в верхний левый угол. */
+/**
+ * Лейбл поля ввода/селекта.
+ *
+ * Отображается по середине поля ввода; когда инпут/селект имеет значение или фокус,
+ * перемещается в верхний левый угол. Атрибут htmlFor берётся из FormFieldContext (targetId),
+ * собственный идентификатор публикуется в контекст как labelId.
+ */
 export declare const FormFieldLabel: default_2.ForwardRefExoticComponent<IFormFieldLabelProps & default_2.RefAttributes<HTMLLabelElement>>;
 
 /**
@@ -1990,10 +2061,20 @@ export declare const FormFieldMaskedInput: default_2.ForwardRefExoticComponent<I
     presets: TFormFieldMaskedInputPresets;
 };
 
-/** Контейнер элементов, отображающихся в правой части FormField. */
+/**
+ * Контейнер элементов, отображающихся в правой части FormField.
+ *
+ * Измеряет собственную ширину и передаёт её в FormFieldContext — поле использует это
+ * значение как правый внутренний отступ, чтобы содержимое не перекрывалось постфиксом.
+ */
 export declare const FormFieldPostfix: default_2.ForwardRefExoticComponent<IFormFieldPostfixProps & default_2.RefAttributes<HTMLSpanElement>>;
 
-/** Контейнер элементов, отображающихся в левой части FormField. */
+/**
+ * Контейнер элементов, отображающихся в левой части FormField.
+ *
+ * Измеряет собственную ширину и передаёт её в FormFieldContext — поле использует это
+ * значение как левый внутренний отступ, чтобы содержимое не перекрывалось префиксом.
+ */
 export declare const FormFieldPrefix: default_2.ForwardRefExoticComponent<IFormFieldPrefixProps & default_2.RefAttributes<HTMLSpanElement>>;
 
 /** Компонент, отображающий нередактируемое значение. */
@@ -2055,8 +2136,8 @@ export declare const getSafeRel: (target: default_2.AnchorHTMLAttributes<HTMLAnc
  */
 export declare const getScrollbarWidth: () => number;
 
-/** Глобальный ограничитель для выбора дат. */
-export declare const globalLimitRange: IDateLimitRange;
+/** Глобальный ограничитель для выбора дат. Обе границы заданы всегда — служит fallback'ом для частично заданного `IDateLimitRange`. */
+export declare const globalLimitRange: Required<IDateLimitRange>;
 
 /** Заголовок. */
 export declare const Header: default_2.ForwardRefExoticComponent<IHeaderProps & default_2.RefAttributes<HTMLDivElement>> & {
@@ -2352,12 +2433,11 @@ export declare interface IButtonDropdownExtendedButtonProvideProps {
     setOpened: (opened: boolean) => void;
 }
 
-/**
- * Компонент "Кнопка с выпадающим блоком".
- * Позволяет кастомизировать кнопку открытия Dropdown и сам Dropdown.
- */
+/** Тип компонента "Кнопка с выпадающим блоком" со статическими субкомпонентами. */
 export declare interface IButtonDropdownExtendedComponent extends default_2.FC<IButtonDropdownExtendedProps> {
+    /** Выпадающий блок. */
     Dropdown: typeof Dropdown;
+    /** Список опций для выпадающего блока. */
     DropdownList: typeof DropdownList;
 }
 
@@ -2373,15 +2453,15 @@ export declare interface IButtonDropdownExtendedDropdownProvideProps {
 
 /** Свойства кнопки с выпадающим блоком. */
 export declare interface IButtonDropdownExtendedProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Контролируемое состояние открытости. */
+    /** Контролируемое состояние открытости. Если передан на первом рендере, компонент работает в контролируемом режиме. */
     opened?: boolean;
-    /** Функция, контролирующая состояние открытости. */
+    /** Функция, контролирующая состояние открытости. Вызывается только в контролируемом режиме. */
     setOpened?: (opened: boolean) => void;
     /** Функция, отрисовывающая кнопку. */
     renderButton: (props: IButtonDropdownExtendedButtonProvideProps) => default_2.ReactNode;
     /** Функция, отрисовывающая выпадающий блок. */
     renderDropdown: (props: IButtonDropdownExtendedDropdownProvideProps) => default_2.ReactNode;
-    /** Ссылка на выпадающий блок. */
+    /** Ссылка на выпадающий блок. Нужна, чтобы клик внутри блока не считался кликом снаружи. */
     dropdownRef: default_2.RefObject<HTMLElement>;
     /** Закрытие выпадающего блока при нажатии клавиши Tab. */
     closeOnTab?: boolean;
@@ -2435,10 +2515,15 @@ export declare interface IButtonGeneralProps extends IButtonBaseProps {
 
 /** Свойства компонента ButtonIcon. */
 export declare interface IButtonIconProps extends default_2.ButtonHTMLAttributes<HTMLButtonElement>, DataAttributes {
-    /** Форма границы кнопки. */
+    /** Форма границы кнопки. По умолчанию EButtonIconShape.SQUIRCLE. */
     shape?: EButtonIconShape;
-    /** Активное состояние. */
+    /** Активное состояние. По умолчанию false. */
     active?: boolean;
+    /**
+     * Содержимое кнопки, обычно иконка из @sberbusiness/icons-next.
+     * Не деструктурируется отдельно — уходит на корневой button внутри ...rest.
+     */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства кнопки типа Link. */
@@ -2489,7 +2574,7 @@ export declare interface IButtonSecondaryProps extends IButtonBaseProps {
     children?: default_2.ReactNode;
 }
 
-/** Свойства контекста CalendarView. */
+/** Свойства контекста Calendar. */
 declare interface ICalendarContext extends Pick<ICalendarProps, "format" | "markedDays" | "disabledDays">, Required<Pick<ICalendarProps, "pickType" | "limitRange" | "onPageChange" | "onViewChange">> {
     /** Дата, являющая курсором для навигации по интерфейсу. */
     viewDate: default_3.Moment;
@@ -2501,6 +2586,7 @@ declare interface ICalendarContext extends Pick<ICalendarProps, "format" | "mark
     onDateSelect: (date: default_3.Moment) => void;
 }
 
+/** Свойства календаря, управляющие его вложенными элементами: ячейками таблицы и кнопками. */
 export declare interface ICalendarNestedProps {
     /** HTML атрибуты компонента дня. */
     dayHtmlAttributes?: TDayHtmlAttributes;
@@ -2678,26 +2764,13 @@ export declare interface ICarouselItemProps extends React.HTMLAttributes<HTMLDiv
 
 /** Свойства компонента Carousel. */
 export declare interface ICarouselProps extends React.HTMLAttributes<HTMLDivElement> {
-    /**
-     * Расстояние (зазор) между слайдами в пикселях.
-     * @default 16
-     */
+    /** Расстояние (зазор) между слайдами в пикселях. По умолчанию 16. */
     gap?: number;
-    /**
-     * Режим прокрутки карусели: поочередно по одному элементу или постранично.
-     * @default ECarouselScrollMode.ITEM
-     */
+    /** Режим прокрутки карусели: поочередно по одному элементу или постранично. По умолчанию ECarouselScrollMode.ITEM. */
     scrollMode?: ECarouselScrollMode;
-    /**
-     * Направление движения карусели (горизонтальное или вертикальное).
-     * @default ECarouselOrientation.HORIZONTAL
-     */
+    /** Направление движения карусели (горизонтальное или вертикальное). По умолчанию ECarouselOrientation.HORIZONTAL. */
     orientation?: ECarouselOrientation;
-    /**
-     * Внутренние отступы области видимости слайдов (Viewport).
-     * Задают зазоры по краям рабочей области скролла.
-     * @default 0
-     */
+    /** Внутренние отступы области видимости слайдов (Viewport), задающие зазоры по краям рабочей области скролла. По умолчанию 0. */
     viewportPadding?: TCarouselViewportPadding;
 }
 
@@ -2850,6 +2923,8 @@ export declare interface IChipPanelProps extends default_2.HTMLAttributes<HTMLDi
 
 /** Свойства компонента Chip. */
 export declare interface IChipProps extends Omit<default_2.HTMLAttributes<HTMLSpanElement>, "prefix">, DataAttributes {
+    /** Основной контент. */
+    children?: default_2.ReactNode;
     /** Состояние disabled. */
     disabled?: boolean;
     /** Выбранное состояние. */
@@ -2860,9 +2935,9 @@ export declare interface IChipProps extends Omit<default_2.HTMLAttributes<HTMLSp
     postfix?: default_2.ReactNode;
     /** Флаг отображения значка новых уведомлений. */
     showNotificationIcon?: boolean;
-    /** Размер. */
+    /** Размер. По умолчанию EComponentSize.MD. */
     size?: EComponentSize;
-    /** Тип. */
+    /** Тип. По умолчанию EChipType.TYPE_1. */
     type?: EChipType;
 }
 
@@ -3049,6 +3124,14 @@ export declare interface IColumnSettingsStaticListProps extends IListProps {
     depth?: number;
 }
 
+/** Свойства компонента ComposedKeyDownListener. */
+export declare interface IComposedKeyDownListenerProps {
+    /** Содержимое. Рендерится как есть, без обёртки и без собственной разметки. */
+    children?: default_2.ReactNode;
+    /** Массив-конфигуратор keydown слушателей. Поле children каждого элемента не используется. */
+    keyDownListeners: IKeyDownListenerProps[];
+}
+
 declare interface IConfirmCloseButtonProps extends Omit<TButtonProps, "theme" | "size" | "icon"> {
 }
 
@@ -3120,14 +3203,12 @@ export declare interface IDateFieldProps extends Omit<IDatePickerExtendedProps,
 export declare interface IDateFieldTargetProps extends IMaskedFieldProps, Pick<IDateFieldProps, "onClear"> {
 }
 
-/**
- * Интерфейс на диапазон выбираемых дат.
- * @prop {Moment} [dateFrom] Дата начала периода.
- * @prop {Moment} [dateTo] Дата конца периода.
- */
+/** Диапазон выбираемых дат. Обе границы опциональны — незаданная сторона периода не ограничивает выбор. */
 export declare interface IDateLimitRange {
-    dateFrom: Moment;
-    dateTo: Moment;
+    /** Дата начала периода. Если не задана, используется глобальная нижняя граница (`globalLimitRange.dateFrom`). */
+    dateFrom?: Moment;
+    /** Дата конца периода. Если не задана, используется глобальная верхняя граница (`globalLimitRange.dateTo`). */
+    dateTo?: Moment;
 }
 
 /** Свойства компонента DatePickerExtended. */
@@ -3191,14 +3272,18 @@ export declare interface IDayHtmlAttributesFunctionParams {
     marked: boolean;
 }
 
+/** Значение токена ссылается на другой токен. */
 declare interface IDesignTokenValueRef {
-    value?: undefined;
+    /** Ссылка на другой токен. */
     ref: (typeof designTokensRefs)[number];
+    value?: never;
 }
 
+/** Строковое значение токена. */
 declare interface IDesignTokenValueString {
-    ref?: undefined;
+    /** Строковое значение токена, например "#000000", или "16px". */
     value: string;
+    ref?: never;
 }
 
 /** Свойства компонента Divider. */
@@ -3245,6 +3330,7 @@ export declare interface IDropdownDesktopProps extends default_2.HTMLAttributes<
 
 /** Композиция компонента DropdownList. */
 export declare interface IDropdownListComponent extends default_2.FC<IDropdownListProps> {
+    /** Элемент выпадающего списка. */
     Item: typeof DropdownListItem;
 }
 
@@ -3276,13 +3362,13 @@ export declare interface IDropdownListItemProps extends default_2.HTMLAttributes
 
 /** Свойства компонента DropdownList. */
 export declare interface IDropdownListProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Dropdown открыт. */
+    /** Dropdown открыт. При открытии список подписывается на клавиатурную навигацию. */
     dropdownOpened: boolean;
     /** Объект для создания ссылки на html-элемент "список". */
     listRef?: default_2.RefObject<HTMLDivElement>;
-    /** Состояние загрузки. */
+    /** Состояние загрузки. Дополняет список элементом с лоадером. */
     loading?: boolean;
-    /** Размер списка. */
+    /** Размер списка. Пробрасывается в элементы списка. */
     size?: EComponentSize;
 }
 
@@ -3315,8 +3401,11 @@ export declare interface IDropdownMobileInputProps extends default_2.InputHTMLAt
 
 /** Свойства компонента DropdownMobileListItem. */
 export declare interface IDropdownMobileListItemProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Идентификатор элемента. */
     id: string;
+    /** Обработчик выбора текущего элемента. Вызывается по клику, до onClick. */
     onSelect?: () => void;
+    /** Флаг - текущий элемент выбран. */
     selected?: boolean;
     /** Флаг отображения значка новых уведомлений. */
     showNotificationIcon?: boolean;
@@ -3438,7 +3527,7 @@ export declare interface IFooterPageTypeSecondProps extends IFooterProps {
 export declare interface IFooterProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
-/** Свойства компонета FormFieldClear. */
+/** Свойства компонента FormFieldClear. */
 export declare interface IFormFieldClearProps extends Omit<default_2.ButtonHTMLAttributes<HTMLButtonElement>, "children"> {
 }
 
@@ -3452,20 +3541,22 @@ export declare interface IFormFieldDescriptionProps extends default_2.HTMLAttrib
 
 /** Свойства компонента FormFieldInput. */
 export declare interface IFormFieldInputProps extends default_2.InputHTMLAttributes<HTMLInputElement>, DataAttributes {
-    /** Рендер-функция, в которую можно передать любой инпут с нужным функционалом (валидация ввода, маска).
-     *  Через аргументы props инпуту передастся нужная стилизация.
-     * */
+    /**
+     * Рендер-функция, в которую можно передать любой инпут с нужным функционалом (валидация ввода, маска).
+     * Через аргумент props инпуту передаётся нужная стилизация, идентификатор и обработчики событий.
+     */
     render?: (props: IFormFieldInputProvideProps, ref?: default_2.Ref<HTMLInputElement>) => default_2.ReactNode;
 }
 
-/** Свойства, передаваемые в рендер-функцию IFormFieldInputProps. */
+/** Свойства, передаваемые в рендер-функцию props.render компонента FormFieldInput. */
 export declare interface IFormFieldInputProvideProps extends Omit<IFormFieldInputProps, "render" | "size"> {
+    /** Размер поля из FormFieldContext. */
     size: EComponentSize;
 }
 
 /** Свойства компонента FormFieldLabel. */
 export declare interface IFormFieldLabelProps extends Omit<default_2.LabelHTMLAttributes<HTMLLabelElement>, "htmlFor"> {
-    /** Label отображается в уменьшенном виде над полем ввода/селектом. */
+    /** Label отображается в уменьшенном виде над полем ввода/селектом. Если значение не задано, вычисляется как filled || active из FormFieldContext. */
     floating?: boolean;
 }
 
@@ -3493,11 +3584,11 @@ export declare interface IFormFieldPrefixProps extends default_2.HTMLAttributes<
 
 /** Свойства компонента FormField. */
 export declare interface IFormFieldProps extends default_2.HTMLAttributes<HTMLDivElement>, DataAttributes {
-    /** Визуальное состояние. */
+    /** Визуальное состояние поля. Значение DISABLED блокирует вложенные элементы ввода. По умолчанию EFormFieldStatus.DEFAULT. */
     status?: EFormFieldStatus;
-    /** Размер. */
+    /** Размер поля. Прокидывается вложенным элементам через контекст. По умолчанию EComponentSize.LG. */
     size?: EComponentSize;
-    /** Активное состояние. */
+    /** Принудительно активное состояние. Поле также становится активным, когда вложенный элемент ввода в фокусе. По умолчанию false. */
     active?: boolean;
 }
 
@@ -3609,6 +3700,7 @@ export declare interface IHelpBoxProps extends default_2.HTMLAttributes<HTMLButt
 
 /** Свойства компонента IconWrapper. */
 export declare interface IIconWrapperProps extends default_2.HTMLAttributes<HTMLSpanElement> {
+    /** Иконка (или произвольный контент), которую оборачивает компонент. */
     children: default_2.ReactNode;
     /** Активное состояние иконки. */
     active?: boolean;
@@ -3816,19 +3908,23 @@ export declare interface IIslandAccordionProps extends default_2.HTMLAttributes<
     size?: EComponentSize;
 }
 
+/** Свойства компонента IslandBody. */
 export declare interface IIslandBodyProps extends default_2.HTMLProps<HTMLDivElement> {
 }
 
+/** Свойства компонента IslandFooter. */
 export declare interface IIslandFooterProps extends default_2.HTMLProps<HTMLDivElement> {
 }
 
+/** Свойства компонента IslandHeader. */
 export declare interface IIslandHeaderProps extends default_2.HTMLProps<HTMLDivElement> {
 }
 
+/** Свойства компонента Island. */
 export declare interface IIslandProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Тип компонента Island. Отличаются цвет и тень. */
+    /** Тип. Отличаются цвет фона и тень. По умолчанию EIslandType.TYPE_1. */
     type?: EIslandType;
-    /** Возможные размеры острова. */
+    /** Размер. Задаёт скругление, внутренние отступы и отступы между Header, Body и Footer. По умолчанию EComponentSize.MD. */
     size?: EComponentSize;
 }
 
@@ -3887,16 +3983,12 @@ export declare interface IIslandWidgetProps extends default_2.HTMLAttributes<HTM
 export declare interface IIslandWidgetWrapperProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
-/** Свойства компонента ComposedKeyDownListener. */
-declare interface IKeyDownListenerManagerProps {
-    children?: default_2.ReactNode;
-    /** Массив-конфигуратор keydown слушателей. */
-    keyDownListeners: IKeyDownListenerProps[];
-}
-
+/** Свойства компонента KeyDownListener. */
 export declare interface IKeyDownListenerProps {
+    /** Содержимое. Рендерится как есть, без обёртки и без собственной разметки. */
     children?: default_2.ReactNode;
-    eventKeyCode: keyCode | keyCode[];
+    /** Код клавиши из EVENT_KEY_CODES или массив кодов, на которые реагирует слушатель. */
+    eventKeyCode: TKeyCode | TKeyCode[];
     /** Обработчик совпадения нужной клавиши. */
     onMatch: (event: KeyboardEvent) => void;
 }
@@ -4178,14 +4270,19 @@ export declare interface IListTableItemSelectableProps extends Omit<IListTableIt
     selected: boolean;
 }
 
+/**
+ * Свойства LoaderScreen с предустановленным типом `middle`.
+ * Используется компонентами библиотеки, которые встраивают LoaderScreen и сами задают тип
+ * (ModalWindowContent, LightBoxContent, LightBoxSideOverlay).
+ */
 export declare interface ILoaderScreenMiddleProps extends Omit<ILoaderScreenProps, "type" | "size"> {
 }
 
 /** Свойства компонента LoaderScreen. */
 export declare interface ILoaderScreenProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Тип лоадера. */
+    /** Тип лоадера: `small` — компактный LoaderSmall, `middle` — крупный LoaderMiddle. */
     type: "small" | "middle";
-    /** Размер лоадера для типа small. */
+    /** Размер лоадера. Учитывается только при `type="small"`. По умолчанию EComponentSize.MD. */
     size?: EComponentSize;
     /** Текст, который будет отображаться под спиннером. */
     description?: default_2.ReactNode;
@@ -4732,7 +4829,9 @@ export declare interface IPaginationSelectProps extends Omit<ISelectFieldProps,
 
 /** Свойства компонента Portal. */
 export declare interface IPortalProps {
+    /** Содержимое, рендерящееся в container. */
     children: default_2.ReactNode;
+    /** DOM-узел, в который рендерится содержимое. */
     container: Element | DocumentFragment;
 }
 
@@ -4916,6 +5015,7 @@ export declare interface ISkeletonProps extends default_2.HTMLAttributes<HTMLDiv
  */
 export declare function isKey(key: string | number, target: keyof typeof EVENT_KEY_CODES): boolean;
 
+/** Контейнер-карточка. Составные части — Island.Header, Island.Body, Island.Footer. */
 export declare const Island: default_2.ForwardRefExoticComponent<IIslandProps & default_2.RefAttributes<HTMLDivElement>> & {
     Body: default_2.ForwardRefExoticComponent<Omit<IIslandBodyProps, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
     Header: default_2.ForwardRefExoticComponent<Omit<IIslandHeaderProps, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
@@ -4940,10 +5040,13 @@ export declare const IslandAccordionItem: default_2.ForwardRefExoticComponent<II
     Footer: default_2.FC<IIslandAccordionFooterProps>;
 };
 
+/** Основное содержимое острова. Отступы до соседних блоков задаются размером родительского Island. */
 export declare const IslandBody: default_2.ForwardRefExoticComponent<Omit<IIslandBodyProps, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
 
+/** Подвал острова. Отступ от предыдущего блока задаётся размером родительского Island. */
 export declare const IslandFooter: default_2.ForwardRefExoticComponent<Omit<IIslandFooterProps, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
 
+/** Шапка острова. Отступ до следующего блока задаётся размером родительского Island. */
 export declare const IslandHeader: default_2.ForwardRefExoticComponent<Omit<IIslandHeaderProps, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
 
 export declare const IslandWidget: default_2.ForwardRefExoticComponent<IIslandWidgetProps & default_2.RefAttributes<HTMLDivElement>> & {
@@ -5828,18 +5931,22 @@ export declare interface ITextFieldProps extends Omit<ITextFieldBaseProps, "chil
 }
 
 export declare interface IThemeProviderContext {
+    /** Classname, задающий область видимости css-переменных темы. Пустая строка вне ThemeProvider. */
     scopeClassName: string;
+    /** Текущая дизайн-тема Triplex Next. */
     theme: ETriplexNextTheme;
+    /** Итоговые токены: переопределения потребителя поверх токенов темы. */
     tokens: TDesignTokens;
 }
 
 export declare interface IThemeProviderProps {
+    /** Контент, внутри которого действуют тема и токены. */
     children: default_2.ReactNode;
     /** Classname, который добавлен к элементу из scopeRef для создания области видимости css-переменных. */
     scopeClassName?: string;
     /** Ref на HTML элемент, внутри которого будет действовать текущий конфиг. */
     scopeRef: default_2.RefObject<HTMLElement>;
-    /** Дизайн-тема Triplex Next. */
+    /** Дизайн-тема Triplex Next. @default ETriplexNextTheme.LIGHT */
     theme?: ETriplexNextTheme;
     /** Переопределяемые токены. */
     tokens?: TDesignTokensPartial;
@@ -5873,10 +5980,15 @@ export declare interface ITooltipColumn extends ITooltipRow {
 
 /** Внутренние составляющие компонента Tooltip. */
 declare interface ITooltipComposition {
+    /** Целевой элемент, к которому привязана подсказка. */
     Target: typeof TooltipTarget;
+    /** Содержимое подсказки. */
     Body: typeof TooltipBody;
+    /** Гиперссылка внутри подсказки. */
     Link: typeof TooltipLink;
+    /** Кнопка закрытия подсказки. */
     XButton: typeof TooltipXButton;
+    /** Заголовок мобильной (адаптивной) версии подсказки. */
     MobileHeader: typeof TooltipMobileHeader;
 }
 
@@ -5907,12 +6019,17 @@ export declare interface ITooltipDomainSize extends ITooltipSize {
     order: number;
 }
 
-/** React-элементы Tooltip. */
+/** React-элементы Tooltip, разобранные из children по типу субкомпонента. */
 export declare interface ITooltipElements {
+    /** Целевой элемент (TooltipTarget), к которому привязана подсказка. */
     target: default_2.ReactElement<ITooltipTargetProps> | null;
+    /** Содержимое подсказки (TooltipBody). */
     body: default_2.ReactElement<ITooltipBodyProps> | null;
+    /** Гиперссылка в подсказке (TooltipLink). */
     link: default_2.ReactElement<ITooltipLinkProps> | null;
+    /** Кнопка закрытия (TooltipXButton). */
     closeButton: default_2.ReactElement<ITooltipXButtonProps> | null;
+    /** Заголовок мобильной версии (TooltipMobileHeader). */
     mobileHeader: default_2.ReactElement<ITooltipMobileHeaderProps> | null;
 }
 
@@ -5920,8 +6037,8 @@ export declare interface ITooltipElements {
 export declare interface ITooltipLinkProps extends default_2.AnchorHTMLAttributes<HTMLAnchorElement> {
 }
 
-/** Свойства компонента TooltipMobileHeader. */
-export declare interface ITooltipMobileHeaderProps extends Omit<IDropdownMobileHeaderProps, "closeButton"> {
+/** Свойства компонента TooltipMobileHeader. Кнопку закрытия шапка подставляет сама, из TooltipXButton. */
+export declare interface ITooltipMobileHeaderProps extends IDropdownMobileHeaderProps {
 }
 
 /** Свойства компонента Tooltip. */
@@ -6146,13 +6263,14 @@ declare interface IWithTreeViewContextProps {
     treeViewContext: ITreeViewContext;
 }
 
-declare type keyCode = (typeof EVENT_KEY_CODES)[keyof typeof EVENT_KEY_CODES];
-
-/** Слушатель нажатия клавиш. При совпадении нужной клавиши вызывает onMatch. */
+/**
+ * Слушатель нажатия клавиш. Пока компонент смонтирован, слушает keydown на window
+ * и при совпадении кода нажатой клавиши с eventKeyCode вызывает onMatch.
+ */
 export declare class KeyDownListener extends default_2.Component<IKeyDownListenerProps> {
     componentDidMount(): void;
     componentWillUnmount(): void;
-    /** Обработчик для нажатия клавиш. */
+    /** Обработчик для нажатия клавиш. Вызывает onMatch, если код нажатой клавиши указан в eventKeyCode. */
     handleKeyDown: (event: KeyboardEvent) => void;
     render(): default_2.ReactNode;
 }
@@ -6309,8 +6427,16 @@ export declare const ListSortableItemTarget: default_2.ForwardRefExoticComponent
 /** Элемент списка, для отображения табличных данных. */
 export declare const ListTableItem: default_2.ForwardRefExoticComponent<(IListTableItemSelectableProps | IListTableItemProps) & default_2.RefAttributes<HTMLLIElement>>;
 
+/**
+ * Квадратный загрузчик с анимированными точками и обегающей их линией.
+ * Не имеет настраиваемых props, используется как индикатор загрузки области или страницы.
+ */
 export declare const LoaderMiddle: default_2.FC;
 
+/**
+ * Виджет-загрузчик. Перекрывает область ближайшего позиционированного родителя полупрозрачной
+ * подложкой и показывает по центру лоадер, опциональное описание и кнопки.
+ */
 export declare const LoaderScreen: default_2.ForwardRefExoticComponent<ILoaderScreenProps & default_2.RefAttributes<HTMLDivElement>>;
 
 export declare const LoaderSmall: default_2.FC<ILoaderSmallProps>;
@@ -6531,7 +6657,7 @@ export declare const PaginationPanel: default_2.FC<IPaginationPanelProps>;
 /** Выбор количества элементов на странице. */
 export declare const PaginationSelect: default_2.ForwardRefExoticComponent<IPaginationSelectProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Компонент портал, для рендера элемента во внешний DOM узел. */
+/** Портал для рендера содержимого во внешний DOM-узел (обёртка над ReactDOM.createPortal). */
 export declare const Portal: default_2.FC<IPortalProps>;
 
 /** Радио-кнопка с описанием. */
@@ -6665,13 +6791,6 @@ export declare const SMSFieldTooltip: default_2.FC<ISMSFieldTooltipProps>;
 /** Компонент "Спойлер", используется для раскрытия внутреннего содержимого. */
 export declare const Spoiler: default_2.ForwardRefExoticComponent<TSpoilerProps & default_2.RefAttributes<HTMLDivElement>>;
 
-export declare const statusToClassNameMap: {
-    default: string;
-    disabled: string;
-    error: string;
-    warning: string;
-};
-
 /**
  * Компонент предназначен для визуального отображения статуса документа.
  */
@@ -6896,6 +7015,7 @@ export declare type TButtonDropdownButtonTheme = EButtonTheme.GENERAL | EButtonT
 /** Тема триггера: обычная кнопка либо кнопка-dots. */
 export declare type TButtonDropdownTheme = TButtonDropdownButtonTheme | EButtonDotsTheme;
 
+/** HTML атрибуты кнопки календаря, дополненные data-атрибутами. */
 export declare type TButtonHTMLAttributesWithData = default_2.ButtonHTMLAttributes<HTMLButtonElement> & TWithDataAttributes;
 
 /** Свойства компонента Button. */
@@ -6959,8 +7079,8 @@ export declare type TDateRangeValue = [string, string];
 /** Тип HTML атрибутов компонента дня. */
 export declare type TDayHtmlAttributes = TTdHTMLAttributesWithData | TDayHtmlAttributesFunction;
 
-/** Функция для получения HTML атрибутов компонента дня. */
-export declare type TDayHtmlAttributesFunction = (params: IDayHtmlAttributesFunctionParams) => default_2.TdHTMLAttributes<HTMLTableCellElement>;
+/** Функция для получения HTML атрибутов компонента дня. Как и объектный вариант, допускает data-атрибуты. */
+export declare type TDayHtmlAttributesFunction = (params: IDayHtmlAttributesFunctionParams) => TTdHTMLAttributesWithData;
 
 declare type TDesignTokens = TDesignTokensCore & TDesignTokensComponents;
 
@@ -7498,6 +7618,7 @@ declare type TDesignTokensCoreGroupColorWarningValue = Record<TDesignTokensCoreG
 
 declare type TDesignTokensPartial = TCreatePartialTokens<TDesignTokens>;
 
+/** Значение токена. */
 declare type TDesignTokenValue = IDesignTokenValueString | IDesignTokenValueRef;
 
 /** Возможные размеры отступов. */
@@ -8383,9 +8504,10 @@ export declare const TextareaField: default_2.FC<ITextareaFieldProps>;
  */
 export declare const TextField: default_2.ForwardRefExoticComponent<ITextFieldProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Маска. Каждый элемент массива должен быть либо строкой, либо регулярным выражением. Каждая строка — это фиксированный символ в маске, а каждое регулярное выражение — это заполнитель, который принимает пользовательский ввод.
+/**
+ * Маска. Каждый элемент массива должен быть либо строкой, либо регулярным выражением. Каждая строка — это фиксированный символ в маске, а каждое регулярное выражение — это заполнитель, который принимает пользовательский ввод.
  * Подробнее можно ознакомиться https://github.com/text-mask/text-mask/blob/master/componentDocumentation.md#mask.
- * */
+ */
 export declare type TFormFieldMaskedInputMask = Array<string | RegExp>;
 
 declare interface TFormFieldMaskedInputPresets {
@@ -8440,8 +8562,14 @@ export declare type TFractionLength = 0 | 2 | 4 | 5;
 /** Возможные размеры вертикального отступа Gap, в пикселях. */
 export declare type TGapSize = 4 | 8 | 12 | 16 | 24 | 32 | 64 | 128;
 
+/**
+ * Провайдер темы. Рендерит css-переменные дизайн-токенов выбранной темы в тег style,
+ * ограничивает их областью видимости элемента из scopeRef и передаёт тему и токены
+ * дочерним компонентам через контекст (см. useToken).
+ */
 export declare const ThemeProvider: default_2.FC<IThemeProviderProps>;
 
+/** Контекст темы. Значение читается хуком useToken. */
 export declare const ThemeProviderContext: default_2.Context<IThemeProviderContext>;
 
 /** Свойства стрелки, которые ImageGallery пробрасывает в ImageGalleryExtended.Arrow. Допускают `data-*`. */
@@ -9083,6 +9211,12 @@ export declare const Title: default_2.ForwardRefExoticComponent<(Omit<{
     weight?: EFontWeightTitle;
 } & ITypographyProps & default_2.SVGProps<SVGViewElement>, "ref">) & default_2.RefAttributes<HTMLElement>>;
 
+/**
+ * Числовой код клавиши. Используй константы из EVENT_KEY_CODES: тип схлопывается
+ * в number (EVENT_KEY_CODES объявлен без as const), поэтому набор значений типами не ограничен.
+ */
+declare type TKeyCode = (typeof EVENT_KEY_CODES)[keyof typeof EVENT_KEY_CODES];
+
 /** Значение компонента MonthYearRange. */
 export declare type TMonthYearRangeValue = [string, string];
 
@@ -9098,10 +9232,17 @@ declare const TooltipBody: default_2.ForwardRefExoticComponent<ITooltipBodyProps
 /** Гиперссылка в Tooltip. */
 declare const TooltipLink: default_2.ForwardRefExoticComponent<ITooltipLinkProps & default_2.RefAttributes<HTMLAnchorElement>>;
 
-/** Заголовок компонента TooltipMobile. */
+/**
+ * Заголовок компонента TooltipMobile.
+ * Кнопку закрытия подставляет сам, наследуя props переданного в Tooltip TooltipXButton.
+ */
 declare const TooltipMobileHeader: default_2.FC<ITooltipMobileHeaderProps>;
 
-/** Целевой элемент компонента Tooltip. */
+/**
+ * Целевой элемент компонента Tooltip.
+ * Не рендерит собственную разметку: клонирует единственный дочерний элемент,
+ * добавляя ему обработчики открытия подсказки. Собственные onClick/onKeyDown ребёнка сохраняются.
+ */
 declare const TooltipTarget: default_2.FC<ITooltipTargetProps>;
 
 /** Кнопка закрытия Tooltip. */
@@ -9257,6 +9398,7 @@ export declare type TStepperStepIconProps = {
 
 export declare type TTabsExtendedOnSelectTab = (id: string) => void;
 
+/** HTML атрибуты ячейки таблицы календаря, дополненные data-атрибутами. */
 export declare type TTdHTMLAttributesWithData = default_2.TdHTMLAttributes<HTMLTableCellElement> & TWithDataAttributes;
 
 /** Свойства компонента Text. */
@@ -9308,6 +9450,7 @@ declare type TTreeViewContextSetActiveNode = (node: TreeViewAbstractNode, active
  */
 declare type TTreeViewContextSetOpenedNode = (node: TreeViewAbstractNode, opened: boolean) => void;
 
+/** Произвольные data-атрибуты. */
 declare type TWithDataAttributes = {
     [dataAttribute in TDataAttributeAlias]: string;
 };
@@ -9347,7 +9490,8 @@ export declare const useMobileView: () => boolean;
 export declare const useSuggestContext: <T extends ISuggestOption>() => ISuggestContext<T>;
 
 /**
- * Хук, возвращающий текущую тему и токены.
+ * Хук, возвращающий текущую тему и токены ближайшего ThemeProvider.
+ * Вне ThemeProvider возвращает светлую тему, токены по умолчанию и пустой scopeClassName.
  */
 export declare const useToken: () => {
     scopeClassName: string;