@sberbusiness/triplex-next 1.41.0 → 1.42.0

package/index.d.ts

@@ -64,13 +64,22 @@ export declare const ALERT_TYPE_TO_CLASS_NAME_MAP: {
  */
 export declare const AlertContext: default_2.ForwardRefExoticComponent<IAlertContextProps & default_2.RefAttributes<HTMLSpanElement>>;
 
-/** Компонент процессного предупреждения. */
+/**
+ * Компонент процессного предупреждения.
+ * Блочное уведомление с фоном и скруглением: иконка по `type`, произвольный контент,
+ * опциональная кнопка закрытия и раскрывающийся блок `AlertProcess.Spoiler`.
+ * Закрытие не управляется извне — компонент скрывает себя сам и затем вызывает `onClose`.
+ */
 export declare const AlertProcess: default_2.ForwardRefExoticComponent<IAlertProcessProps & default_2.RefAttributes<HTMLDivElement>> & {
-    Spoiler: default_2.FC<IAlertProcessSpoilerProps>;
+    Spoiler: default_2.ForwardRefExoticComponent<IAlertProcessSpoilerProps & default_2.RefAttributes<HTMLDivElement>>;
 };
 
-/** Компонент отображения суммы. */
-export declare const Amount: default_2.FC<IAmountProps>;
+/**
+ * Компонент отображения суммы.
+ * Форматирует значение (разделители групп разрядов, дробная часть) и при необходимости выводит рядом
+ * обозначение валюты. Размер и цвет шрифта наследуются от родителя — как правило, от Text.
+ */
+export declare const Amount: default_2.ForwardRefExoticComponent<IAmountProps & default_2.RefAttributes<HTMLSpanElement>>;
 
 /**
  * Утилита для сравнения сумм.
@@ -93,16 +102,18 @@ export declare const Avatar: default_2.ForwardRefExoticComponent<IAvatarProps &
 
 /**
  * Индикатор статуса или уведомления.
- * Может содержать префикс, контент и постфикс.
- * Для отображения точки используется компонент BadgeDot.
+ * Рендерит inline-элемент из трёх необязательных частей в порядке prefix → children → postfix;
+ * части с falsy-значением не рендерятся. Собственного состояния нет, цвет фона задаётся токеном.
+ * Для отображения индикатора-точки используется компонент BadgeDot, доступный как Badge.Dot.
  * */
 export declare const Badge: default_2.ForwardRefExoticComponent<IBadgeProps & default_2.RefAttributes<HTMLSpanElement>> & {
     Dot: default_2.ForwardRefExoticComponent<IBadgeDotProps & default_2.RefAttributes<HTMLSpanElement>>;
 };
 
 /**
- * Компонент Body, используется как один из детей(Header, Body и Footer) компонента Page.
- * Используется как контейнер для контента страницы. Имеет дефолтные отступы со всех сторон.
+ * Контейнер основного контента. Корневой элемент — flex-контейнер, внутренняя обёртка растягивает
+ * контент на всю доступную ширину. Собственных отступов не задаёт — их добавляет потребитель
+ * (например, `BodyPage`, доступный как `Page.Body`).
  */
 declare const Body_2: default_2.ForwardRefExoticComponent<IBodyProps & default_2.RefAttributes<HTMLDivElement>>;
 export { Body_2 as Body }
@@ -823,7 +834,11 @@ export declare const CardStatic: default_2.FC<ICardProps> & ICardStaticCompositi
 
 /* Excluded from this release type: Carousel */
 
-/** Карусель. */
+/**
+ * Карусель — горизонтально прокручиваемая лента произвольного контента.
+ * Разметку кнопок прокрутки рендерит потребитель, компонент передаёт им состояние и обработчик клика.
+ * Ref указывает на прокручиваемый контейнер, а не на корневой элемент.
+ */
 export declare const CarouselExtended: default_2.ForwardRefExoticComponent<ICarouselExtendedProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Чекбокс с описанием. */
@@ -1028,7 +1043,11 @@ export declare const ColumnSettings: default_2.ForwardRefExoticComponent<IColumn
 /** Элемент компонента ColumnSettingsSortableList. */
 export declare const ColumnSettingsSortableListItem: default_2.ForwardRefExoticComponent<IColumnSettingsSortableListItemProps & default_2.RefAttributes<HTMLLIElement>>;
 
-/** Композитор слушателей нажатия клавиш. Оборачивает children в KeyDownListener на каждый элемент keyDownListeners. */
+/**
+ * Композитор слушателей нажатия клавиш. Рендерит по одному KeyDownListener на элемент
+ * keyDownListeners соседями к children: каждый слушатель подписывается на window независимо,
+ * а children не зависят от длины и порядка массива и не перемонтируются при его изменении.
+ */
 export declare const ComposedKeyDownListener: default_2.FC<IComposedKeyDownListenerProps>;
 
 /** Компонент предупреждения, о закрытии лайтбокса / боковой панели лайтбокса. */
@@ -1596,14 +1615,22 @@ export declare enum ELineType {
 
 export declare const Ellipsis: default_2.ForwardRefExoticComponent<IEllipsisProps & default_2.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Размер компонента LoaderSmall.
+ * Самим компонентом не используется — размер задаётся общим для библиотеки `EComponentSize`.
+ * Сохраняется как часть публичного API для обратной совместимости.
+ */
 export declare enum ELoaderSmallSize {
     SM = "sm",
     MD = "md",
     LG = "lg"
 }
 
+/** Тема компонента LoaderSmall. */
 export declare enum ELoaderSmallTheme {
+    /** Для светлых поверхностей. */
     BRAND = "brand",
+    /** Для тёмных и цветных поверхностей. */
     NEUTRAL = "neutral"
 }
 
@@ -2262,24 +2289,28 @@ export declare interface IAlertContextProps extends default_2.HTMLAttributes<HTM
 
 /** Свойства компонента AlertProcess. */
 export declare interface IAlertProcessProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Тип предупреждения. */
+    /** Тип предупреждения. Определяет фон блока и иконку по умолчанию. */
     type: EAlertType;
-    /** Модификатор возможности закрытия предупреждения. */
+    /** Модификатор возможности закрытия предупреждения. По умолчанию false. */
     closable?: boolean;
-    /** Функция обработки закрытия. */
+    /** Функция обработки закрытия. Вызывается после того, как компонент скрыл себя. */
     onClose?: () => void;
-    /** Отображаемая иконка. */
+    /** Отображаемая иконка. Заменяет иконку по умолчанию, выбранную по type. */
     renderIcon?: default_2.ReactNode;
-    /** Вариант скругления визуальной формы. */
+    /** Вариант скругления визуальной формы. По умолчанию EAlertProcessBorderRadius.MD. */
     borderRadius?: EAlertProcessBorderRadius;
+    /** Содержимое предупреждения. Размеры и цвет текста задаются компонентами Typography. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента AlertProcessSpoiler. */
 declare interface IAlertProcessSpoilerProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Контролируемое состояние открытия спойлера. */
+    /** Контролируемое состояние открытия спойлера. По умолчанию спойлер закрыт. */
     open?: boolean;
-    /** Обработчик изменения состояния открытия спойлера. */
+    /** Обработчик изменения состояния открытия спойлера. Получает следующее значение open. */
     onOpen?: (open: boolean) => void;
+    /** Раскрываемое содержимое спойлера. */
+    children?: default_2.ReactNode;
 }
 
 /** Интерфейс форматов поля Amount (сумма). */
@@ -2314,17 +2345,17 @@ export declare interface IAmountFieldProps extends Omit<ITextFieldBaseProps, "ch
 
 /** Свойства компонента Amount. */
 export declare interface IAmountProps extends default_2.HTMLAttributes<HTMLSpanElement> {
-    /** Значение суммы. */
+    /** Значение суммы. Строка с разделителем дробной части "." или ","; пробелы и ведущий знак "+"/"-" допустимы. */
     value: string;
-    /** Количество знаков после запятой. */
+    /** Количество знаков после запятой. По умолчанию 2. */
     fractionLength?: 0 | 1 | 2 | 3 | 4;
-    /** Сокращённое обозначение валюты. */
+    /** Сокращённое обозначение валюты. Выводится после суммы через неразрывный пробел. */
     currency?: string;
-    /** Сообщение подсказки названия валюты. */
+    /** Сообщение подсказки названия валюты. Попадает в атрибут title элемента с обозначением валюты. */
     currencyTitle?: string;
-    /** При большом количестве цифр уменьшает размер шрифта. */
+    /** При длине форматированной суммы от 14 символов (ADAPTIVE_AMOUNT_LENGTH) уменьшает размер шрифта. По умолчанию false. */
     adaptive?: boolean;
-    /** Тестовый атрибут. */
+    /** Тестовый атрибут. Используется как префикс: `${dataTestId}__amount` и `${dataTestId}__currencyName`. */
     dataTestId?: string;
 }
 
@@ -2336,25 +2367,33 @@ export declare interface IAvatarProps extends default_2.HTMLAttributes<HTMLDivEl
     borderRadius: TAvatarBorderRadius;
 }
 
-/** Свойства компонента BadgeContent. */
+/** Свойства компонента BadgeContent — внутренней обёртки содержимого Badge. */
 export declare interface IBadgeContentProps extends default_2.HTMLAttributes<HTMLSpanElement> {
+    /** Размер, определяющий горизонтальные отступы содержимого. Приходит из Badge. */
     size: EComponentSize;
-    /** Флаг, определяющий, нужно ли удалить левый отступ. */
+    /** Флаг, определяющий, нужно ли удалить левый отступ. Выставляется, когда у Badge есть prefix. */
     noPaddingLeft?: boolean;
-    /** Флаг, определяющий, нужно ли удалить правый отступ. */
+    /** Флаг, определяющий, нужно ли удалить правый отступ. Выставляется, когда у Badge есть postfix. */
     noPaddingRight?: boolean;
 }
 
 /** Свойства компонента BadgeDot. */
 export declare interface IBadgeDotProps extends Omit<default_2.HTMLAttributes<HTMLSpanElement>, "children"> {
+    /** Размер точки: SM (6px) / MD (8px) / LG (10px). Обязательный, значения по умолчанию нет. */
     size: EComponentSize;
+    /** Точка не имеет содержимого. */
     children?: never;
 }
 
 /** Свойства компонента Badge. */
 export declare interface IBadgeProps extends Omit<default_2.HTMLAttributes<HTMLSpanElement>, "prefix" | "postfix"> {
+    /** Размер бейджа: SM (высота 16px) / MD (20px) / LG (24px). Обязательный, значения по умолчанию нет. */
     size: EComponentSize;
+    /** Содержимое бейджа. Оборачивается во внутренний элемент с горизонтальными отступами по размеру. */
+    children?: default_2.ReactNode;
+    /** Контент перед основным содержимым, обычно иконка. Не рендерится, если значение falsy. */
     prefix?: default_2.ReactNode;
+    /** Контент после основного содержимого, обычно иконка. Не рендерится, если значение falsy. */
     postfix?: default_2.ReactNode;
 }
 
@@ -2388,6 +2427,8 @@ export declare interface IBodyPageTypeSecondProps extends IBodyProps {
 
 /** Свойства компонента Body. */
 export declare interface IBodyProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Контент тела. */
+    children?: default_2.ReactNode;
 }
 
 declare interface IButtonBaseProps extends default_2.ButtonHTMLAttributes<HTMLButtonElement> {
@@ -2724,18 +2765,28 @@ declare interface ICardStaticComposition {
     Media: typeof CardMedia;
 }
 
+/**
+ * Свойства, которые CarouselExtended передаёт в рендер-функции кнопок прокрутки:
+ * `disabled` (край ленты достигнут), `hidden` (прокрутка не нужна) и `onClick`.
+ */
 export declare interface ICarouselExtendedButtonProvideProps extends default_2.ButtonHTMLAttributes<HTMLButtonElement> {
 }
 
 /** Свойства компонента CarouselExtended. */
 export declare interface ICarouselExtendedProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Рендер-функция кнопки "Назад". */
+    /**
+     * Рендер-функция кнопки "Назад". Получает `disabled`, `hidden` и `onClick`.
+     * Позиционирование кнопки — на стороне потребителя; при `hidden` обычно возвращается null.
+     */
     buttonPrev: (props: ICarouselExtendedButtonProvideProps) => default_2.ReactNode;
-    /** Рендер-функция кнопки "Вперёд". */
+    /**
+     * Рендер-функция кнопки "Вперёд". Получает `disabled`, `hidden` и `onClick`.
+     * Позиционирование кнопки — на стороне потребителя; при `hidden` обычно возвращается null.
+     */
     buttonNext: (props: ICarouselExtendedButtonProvideProps) => default_2.ReactNode;
-    /** Величина (px) прокрутки при клике на кнопку "Назад". */
+    /** Величина (px) прокрутки при клике на кнопку "Назад". Дробное значение округляется вверх по модулю. */
     stepPrev: number;
-    /** Величина (px) прокрутки при клике на кнопку "Вперёд". */
+    /** Величина (px) прокрутки при клике на кнопку "Вперёд". Дробное значение округляется вверх по модулю. */
     stepNext: number;
 }
 
@@ -3506,7 +3557,7 @@ export declare interface IFooterPageTypeFirstProps extends IFooterProps {
     children: default_2.ReactNode;
     /** Тип компонента FooterPage. FIRST оборачивает футер в Island (карточку). */
     type: EFooterPageType.FIRST;
-    /** Footer прилипает к нижней границе экрана при скролле. Только для типа FIRST внутри LightBox. */
+    /** Footer прилипает к нижней границе при скролле. Только для типа FIRST. */
     sticky?: boolean;
     /** Размер острова (Island). Доступен только для типа FIRST. */
     size?: EComponentSize;
@@ -3561,7 +3612,8 @@ export declare interface IFormFieldLabelProps extends Omit<default_2.LabelHTMLAt
 }
 
 /** Свойства компонента FormFieldMaskedInput. */
-export declare interface IFormFieldMaskedInputProps extends Omit<MaskedInputProps, "guide" | "mask" | "render">, DataAttributes {
+export declare interface IFormFieldMaskedInputProps extends Omit<MaskedInputProps, "guide" | "mask" | "render" | "defaultValue">, DataAttributes {
+    /** Значение поля. Поле контролируемое, поэтому начальное значение задаётся через него, а не через defaultValue. */
     value: string;
     /** Ссылка на поле ввода. */
     forwardedRef?: default_2.Ref<HTMLInputElement>;
@@ -3629,7 +3681,7 @@ export declare interface IHeaderPageTypeFirstProps extends IHeaderProps {
     children: default_2.ReactNode;
     /** Тип компонента HeaderPage. FIRST оборачивает заголовок в Island (карточку). */
     type: EHeaderPageType.FIRST;
-    /** Header прилипает к верхней границе экрана при скролле. Только для типа FIRST внутри LightBox. */
+    /** Header прилипает к верхней границе при скролле. Только для типа FIRST. */
     sticky?: boolean;
     /** Размер острова (Island). Доступен только для типа FIRST. */
     size?: EComponentSize;
@@ -3926,6 +3978,10 @@ export declare interface IIslandProps extends default_2.HTMLAttributes<HTMLDivEl
     type?: EIslandType;
     /** Размер. Задаёт скругление, внутренние отступы и отступы между Header, Body и Footer. По умолчанию EComponentSize.MD. */
     size?: EComponentSize;
+    /** Флаг состояния загрузки. */
+    loading?: boolean;
+    /** Свойства компонента LoaderScreen. */
+    loaderScreenProps?: ILoaderScreenMiddleProps;
 }
 
 /** Свойства компонента IslandWidgetBody. */
@@ -4292,9 +4348,9 @@ export declare interface ILoaderScreenProps extends default_2.HTMLAttributes<HTM
 
 /** Свойства компонента LoaderSmall. */
 export declare interface ILoaderSmallProps extends default_2.HTMLAttributes<HTMLSpanElement> {
-    /** Тема. */
+    /** Тема: BRAND — для светлых поверхностей, NEUTRAL — для тёмных и цветных. */
     theme: ELoaderSmallTheme;
-    /** Размер. */
+    /** Размер: SM (16×16) / MD (24×24) / LG (32×32). */
     size: EComponentSize;
 }
 
@@ -4393,9 +4449,16 @@ export declare interface IMarkerStatusProps extends default_2.HTMLAttributes<HTM
 
 /** Свойства компонента MaskedField. */
 export declare interface IMaskedFieldProps extends Omit<ITextFieldBaseProps, "children"> {
-    /** Свойства поля ввода. */
+    /**
+     * Свойства поля ввода с маской: обязательные `mask` и `value`, опциональный `placeholderMask`
+     * и остальные атрибуты input. Ссылка на элемент input передаётся через `forwardedRef`.
+     */
     maskedInputProps: IFormFieldMaskedInputProps & {
-        ref?: default_2.RefObject<HTMLInputElement>;
+        /**
+         * Ссылка на корневой div-обёртку FormFieldMaskedInput.
+         * Для ссылки на элемент input используйте `forwardedRef`.
+         */
+        ref?: default_2.RefObject<HTMLDivElement>;
     };
 }
 
@@ -4451,9 +4514,9 @@ export declare interface IMediaMinWidthProps {
 export declare interface IMediaProps {
     /** Элементы, которые рендерятся, когда ширина окна браузера попадает в диапазон minWidth и/или maxWidth. */
     children: default_2.ReactElement | null;
-    /** Минимальная ширина экран, при которой будут отрендерены children. */
+    /** Минимальная ширина экрана, при которой будут отрендерены children. */
     minWidth?: EScreenWidth;
-    /** Максимальная ширина экран, при которой будут отрендерены children. */
+    /** Максимальная ширина экрана, при которой будут отрендерены children. */
     maxWidth?: EScreenWidth;
     /** Элементы, которые рендерятся, когда ширина окна браузера не попадает в диапазон minWidth и/или maxWidth. */
     fallback: default_2.ReactElement | null;
@@ -4467,7 +4530,13 @@ export declare interface IMobileViewProps {
     fallback: default_2.ReactElement | null;
 }
 
-export declare interface IModalWindowBodyProps extends IIslandProps {
+/**
+ * Свойства компонента ModalWindowBody.
+ * `loading` и `loaderScreenProps` от `Island` исключены: тело скроллируется, а `LoaderScreen`
+ * позиционируется абсолютно и уезжает вместе с контентом. Состояние загрузки модального окна
+ * задаётся через props `isLoading` и `loaderScreenProps` компонента `ModalWindowContent`.
+ */
+export declare interface IModalWindowBodyProps extends Omit<IIslandProps, "loading" | "loaderScreenProps"> {
 }
 
 /**
@@ -4805,6 +4874,16 @@ export declare interface IPaginationNavigationProps extends default_2.HTMLAttrib
     siblingCount?: number;
 }
 
+/** Свойства компонента PaginationPageButton. */
+export declare interface IPaginationPageButtonProps extends Omit<default_2.ButtonHTMLAttributes<HTMLButtonElement>, "onClick"> {
+    /** Является ли страница текущей (активной). */
+    isCurrent?: boolean;
+    /** Номер страницы. */
+    children: default_2.ReactNode;
+    /** Обработчик клика по странице. */
+    onClick: () => void;
+}
+
 /** Свойства компонента PaginationPageEllipsis. */
 declare interface IPaginationPageEllipsisProps extends default_2.HTMLAttributes<HTMLSpanElement> {
 }
@@ -4901,76 +4980,105 @@ export declare interface ISegmentedControlSingleProps extends ISegmentedControlC
     onSelect: (value: string) => void;
 }
 
+/** Свойства опции списка. */
 export declare interface ISelectExtendedFieldDefaultOption extends Omit<IDropdownListItemProps, "active" | "onSelect" | "selected" | "keyCodesForSelection" | "className" | "key"> {
+    /** Значение опции. */
     value: string;
+    /** Название опции. */
     label: default_2.ReactNode;
 }
 
+/** Свойства компонента SelectExtendedFieldDropdownDefault. */
 declare interface ISelectExtendedFieldDropdownDefaultProps extends ISelectExtendedFieldDropdownProvideProps, Pick<IDropdownProps, "size" | "width"> {
+    /** ClassName для модификации SelectExtendedField.Dropdown.List.Item. */
     dropdownListItemClassName?: string;
+    /** Свойства, передающиеся в Dropdown. */
     dropdownProps?: Omit<IDropdownProps, "children" | "opened" | "setOpened" | "targetRef" | "size" | "mobileViewProps">;
+    /** Состояние загрузки. В этот момент Dropdown закрыт, Target отображает лоадер. По умолчанию false. */
     loading?: boolean;
+    /** Id SelectExtendedField.Dropdown.List. Нужен для связи с Target. */
     listId?: string;
+    /** Название Select, отображающееся в мобильном режиме. */
     mobileTitle?: default_2.ReactNode;
+    /** Список опций. */
     options: ISelectExtendedFieldDefaultOption[];
+    /** Обработчик изменения значения. Вызывается с выбранной опцией. */
     onChange: (option: ISelectExtendedFieldDefaultOption) => void;
+    /** Текущее выбранное значение. Опция сопоставляется по полю id. */
     value?: ISelectExtendedFieldDefaultOption;
 }
 
+/** Тип компонента SelectExtendedFieldDropdown со статическим свойством List. */
 export declare interface ISelectExtendedFieldDropdownFC extends default_2.FC<ISelectExtendedFieldDropdownProps> {
+    /** Список опций выпадающего блока. */
     List: typeof DropdownList;
 }
 
+/** Свойства компонента SelectExtendedFieldDropdown. */
 export declare interface ISelectExtendedFieldDropdownProps extends Omit<IDropdownProps, "forwardedRef"> {
+    /** Ссылка на контейнер выпадающего блока. Компонент не forwardRef — ссылка передаётся этим свойством. */
     forwardedRef: default_2.RefObject<HTMLDivElement>;
+    /** Содержимое выпадающего блока. */
     children?: default_2.ReactNode;
+    /** Состояние открытости выпадающего блока. */
     opened: boolean;
+    /** Ссылка на поле выбора. По ней выпадающий блок считает своё положение. */
     targetRef: default_2.RefObject<HTMLElement>;
 }
 
+/** Свойства, передаваемые из SelectExtendedField в функцию рендера dropdown - children. */
 export declare interface ISelectExtendedFieldDropdownProvideProps {
+    /** Флаг открытости выпадающего блока. */
     opened: boolean;
+    /** Функция открытия/закрытия выпадающего блока. */
     setOpened: (opened: boolean) => void;
+    /** Ссылка на поле выбора. По ней выпадающий блок считает своё положение. */
     targetRef: default_2.RefObject<HTMLDivElement>;
+    /** Ссылка на выпадающий блок. Нужна, чтобы клик внутри него не закрывал список. */
     dropdownRef: default_2.RefObject<HTMLDivElement>;
 }
 
+/** Свойства компонента SelectExtendedField. */
 export declare interface ISelectExtendedFieldProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "children"> {
     /** Рендер-функция поля выбора. */
     renderTarget: (props: ISelectExtendedFieldTargetProvideProps) => default_2.ReactNode;
     /** Рендер-функция выпадающего блока. */
     children: (props: ISelectExtendedFieldDropdownProvideProps) => default_2.ReactNode;
-    /** Функция, срабатывающая при закрытии выпадающего блока. */
+    /** Функция, срабатывающая при закрытии выпадающего блока. На первом рендере не вызывается. */
     onClose?: () => void;
-    /** Функция, срабатывающая при открытии выпадающего блока. */
+    /** Функция, срабатывающая при открытии выпадающего блока. На первом рендере не вызывается. */
     onOpen?: () => void;
-    /** Закрытие выпадающего блока при нажатии клавиши Tab. */
+    /** Закрытие выпадающего блока при нажатии клавиши Tab. По умолчанию false. */
     closeOnTab?: boolean;
 }
 
+/** Свойства компонента SelectExtendedFieldTarget. */
 export declare interface ISelectExtendedFieldTargetProps extends Omit<IFormFieldProps, "prefix" | "postfix"> {
-    /**  Текст или компонент, отображающий выбранное значение. */
+    /** Текст или компонент, отображающий выбранное значение. */
     label?: default_2.ReactNode;
-    /** Текст или компонент, отображающий выбранное значение для Target. */
+    /** Текст или компонент заголовка поля. */
     fieldLabel: default_2.ReactNode;
-    /** Состояние загрузки. */
+    /** Состояние загрузки. Вместо каретки отображается лоадер, поле не реагирует на клик и клавиатуру. По умолчанию false. */
     loading?: boolean;
-    /** Состояние открытости выпадающего списка. */
+    /** Состояние открытости выпадающего блока. */
     opened: boolean;
-    /** Текст или компонент, отображающий выбранное placeholder. */
+    /** Текст или компонент, отображаемый вместо значения, пока значение не выбрано. */
     placeholder?: default_2.ReactNode;
-    /** Префикс поля ввода. */
+    /** Префикс поля. */
     prefix?: default_2.ReactNode;
-    /** Постфикс поля ввода. */
+    /** Постфикс поля. Отображается после каретки. */
     postfix?: default_2.ReactNode;
-    /** Функция открытия/закрытия выпадающего списка. */
+    /** Функция открытия/закрытия выпадающего блока. */
     setOpened: (opened: boolean) => void;
-    /** Функция очистки значения. */
+    /** Функция очистки значения. Если передана, в поле отображается кнопка очистки. */
     onClear?: () => void;
 }
 
+/** Свойства, передаваемые из SelectExtendedField в функцию рендера target - renderTarget. */
 export declare interface ISelectExtendedFieldTargetProvideProps {
+    /** Флаг открытости выпадающего блока. */
     opened: boolean;
+    /** Функция открытия/закрытия выпадающего блока. */
     setOpened: (opened: boolean) => void;
 }
 
@@ -6439,13 +6547,20 @@ 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>;
 
 export declare const Marker: default_2.FC<IMarkerProps>;
 
 export declare const MarkerStatus: default_2.ForwardRefExoticComponent<IMarkerStatusProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Компонент ввода с маской. */
+/**
+ * Компонент ввода с маской.
+ * Отличается от TextField элементом ввода — вместо обычного input используется FormFieldMaskedInput.
+ */
 export declare const MaskedField: default_2.ForwardRefExoticComponent<IMaskedFieldProps & default_2.RefAttributes<HTMLDivElement>>;
 
 export declare const MasterTable: IMasterTableFC;
@@ -6468,12 +6583,18 @@ export declare const MediaMaxWidth: default_2.FC<IMediaMaxWidthProps>;
  */
 export declare const MediaMinWidth: default_2.FC<IMediaMinWidthProps>;
 
-/** Компонент, который рендерит элементы в зависимости от ширины окна браузера. */
+/**
+ * Компонент, который рендерит элементы в зависимости от ширины окна браузера.
+ * Собственной разметки не добавляет: в зависимости от переданных minWidth и maxWidth делегирует рендер
+ * в MediaBetweenWidth, MediaMinWidth или MediaMaxWidth. Если не передан ни minWidth, ни maxWidth,
+ * медиа-запрос не строится и всегда рендерится fallback.
+ */
 export declare const MediaWidth: default_2.FC<IMediaProps>;
 
 /**
  * Компонент, который рендерит children в случае просмотра на мобильном устройстве.
  * В противном случае рендерится fallback.
+ * Сокращение над MediaWidth с maxWidth равным EScreenWidth.SM_MAX — собственной разметки не добавляет.
  */
 export declare const MobileView: default_2.FC<IMobileViewProps>;
 
@@ -6646,7 +6767,7 @@ export declare const PaginationNavigationExtended: default_2.ForwardRefExoticCom
 export declare const PaginationNavigationExtendedItem: default_2.ForwardRefExoticComponent<IPaginationNavigationExtendedItemProps & default_2.RefAttributes<HTMLLIElement>>;
 
 /** Кнопка-страница пагинации. */
-export declare const PaginationPageButton: default_2.ForwardRefExoticComponent<TPaginationPageButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
+export declare const PaginationPageButton: default_2.ForwardRefExoticComponent<IPaginationPageButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
 
 /** Многоточие, заменяющее группу последовательных скрытых страниц в навигации. */
 export declare const PaginationPageEllipsis: default_2.ForwardRefExoticComponent<IPaginationPageEllipsisProps & default_2.RefAttributes<HTMLSpanElement>>;
@@ -6692,16 +6813,24 @@ export declare const SegmentedControl: default_2.ForwardRefExoticComponent<TSegm
 /** Элемент SegmentedControl, представляет собой опцию для выбора. */
 export declare const SegmentedControlSegment: default_2.FC<ISegmentedControlSegmentProps>;
 
+/**
+ * Базовый компонент Select. На его основе строятся Select'ы с любыми value, options и target.
+ *
+ * Владеет только состоянием открытости: разметку поля выбора отдаёт в renderTarget,
+ * разметку выпадающего блока — в children. Закрывает список по Escape, по клику вне
+ * поля и выпадающего блока, а при closeOnTab — ещё и по Tab.
+ */
 export declare const SelectExtendedField: default_2.ForwardRefExoticComponent<ISelectExtendedFieldProps & default_2.RefAttributes<HTMLDivElement>> & {
     Target: default_2.ForwardRefExoticComponent<ISelectExtendedFieldTargetProps & default_2.RefAttributes<HTMLDivElement>>;
     Dropdown: ISelectExtendedFieldDropdownFC;
 };
 
+/** Выпадающий блок SelectExtendedField. Обёртка над Dropdown, принимающая ссылку через forwardedRef. */
 export declare const SelectExtendedFieldDropdown: ISelectExtendedFieldDropdownFC;
 
 /**
- * Компонент SelectTarget.
- * Видимая часть Select, при нажатии на которую открывается выпадающий список.
+ * Поле выбора SelectExtendedField.
+ * Видимая часть Select, при нажатии на которую открывается выпадающий блок.
  */
 export declare const SelectExtendedFieldTarget: default_2.ForwardRefExoticComponent<ISelectExtendedFieldTargetProps & default_2.RefAttributes<HTMLDivElement>>;
 
@@ -9250,18 +9379,6 @@ declare const TooltipXButton: default_2.FC<ITooltipXButtonProps>;
 
 export declare const TopOverlay: default_2.FC<ITopOverlayProps>;
 
-/** Свойства компонента PaginationPageButton. */
-declare type TPaginationPageButtonProps = {
-    /** Является ли страница текущей (активной). */
-    isCurrent?: boolean;
-    /** Дополнительный CSS-класс. */
-    className?: string;
-    /** Номер страницы. */
-    children: default_2.ReactNode;
-    /** Обработчик клика по странице. */
-    onClick: () => void;
-};
-
 /** Приведенный к Moment тип даты, используемый для внутренних вычислений. */
 export declare type TPickedDate = Moment | null;
 
@@ -9482,6 +9599,7 @@ export declare function useMatchMedia(query: string): boolean;
 
 /**
  * Хук для проверки, является ли устройство мобильным (экран <= SM_MAX).
+ * Условие совпадает с условием компонента MobileView.
  * @returns true, если ширина экрана соответствует мобильному устройству
  */
 export declare const useMobileView: () => boolean;

package/index.js

@@ -30,7 +30,7 @@ import { checkChildrenCheckboxes, checkParentCheckboxes, traverseCheckboxes } fr
 import { CheckboxTreeExtended } from "./components/CheckboxTreeExtended/CheckboxTreeExtended.js";
 import { CheckboxTreeExtendedNode } from "./components/CheckboxTreeExtended/components/CheckboxTreeExtendedNode.js";
 import { EChipType } from "./components/Chip/enums.js";
-import { C } from "./chunks/Chip-BpQdbkKh.js";
+import { C } from "./chunks/Chip-BOgrCJUD.js";
 import { ChipDatePicker } from "./components/Chip/ChipDatePicker/ChipDatePicker.js";
 import { ChipDatePickerTarget } from "./components/Chip/ChipDatePicker/ChipDatePickerTarget.js";
 import { ChipClearButton } from "./components/Chip/ChipClearButton.js";
@@ -66,7 +66,7 @@ import { DocumentNumberEdit } from "./components/DocumentNumberEdit/DocumentNumb
 import { DropdownListContext } from "./components/Dropdown/DropdownListContext.js";
 import { DropdownDesktop } from "./components/Dropdown/desktop/DropdownDesktop.js";
 import { DropdownList } from "./components/Dropdown/desktop/DropdownList.js";
-import { D } from "./chunks/DropdownListItem-C2A5QJs2.js";
+import { D } from "./chunks/DropdownListItem-DHdXJ6f2.js";
 import { EDropdownAlignment, EDropdownDirection, EDropdownWidth } from "./components/Dropdown/desktop/enums.js";
 import { DropdownMobile } from "./components/Dropdown/mobile/DropdownMobile.js";
 import { DropdownMobileBody } from "./components/Dropdown/mobile/DropdownMobileBody.js";
@@ -121,7 +121,7 @@ import { ImageGalleryExtendedMain } from "./components/ImageGalleryExtended/comp
 import { ImageGalleryExtendedNav } from "./components/ImageGalleryExtended/components/ImageGalleryExtendedNav.js";
 import { ImageGalleryExtendedArrow } from "./components/ImageGalleryExtended/components/ImageGalleryExtendedArrow.js";
 import { ImageGalleryExtendedThumbnails } from "./components/ImageGalleryExtended/components/ImageGalleryExtendedThumbnails.js";
-import { I } from "./chunks/ImageGalleryExtendedThumb-DkJtr4Hx.js";
+import { I } from "./chunks/ImageGalleryExtendedThumb-hTnBPgAl.js";
 import { ImageGalleryExtendedDots } from "./components/ImageGalleryExtended/components/ImageGalleryExtendedDots.js";
 import { EImageGalleryArrowDirection } from "./components/ImageGalleryExtended/enums.js";
 import { Island } from "./components/Island/Island.js";
@@ -152,7 +152,7 @@ import { ListItem } from "./components/List/components/ListItem.js";
 import { ListItemControls } from "./components/List/components/ListItemControls.js";
 import { ListItemContent } from "./components/List/components/ListItemContent.js";
 import { ListActionItem } from "./components/List/components/ListActionItem.js";
-import { L } from "./chunks/ListItemControlsButton-mh3tmBtz.js";
+import { L } from "./chunks/ListItemControlsButton-CRuluo8R.js";
 import { ListItemControlsButtonDropdown } from "./components/List/components/ListItemControlsButtonDropdown.js";
 import { ListEmptyState } from "./components/List/components/ListEmptyState.js";
 import { ListItemLoading } from "./components/List/components/ListItemLoading.js";
@@ -266,7 +266,7 @@ import { SuggestFieldDesktopDropdown } from "./components/SuggestField/desktop/S
 import { SuggestFieldDesktop } from "./components/SuggestField/desktop/SuggestFieldDesktop.js";
 import { SuggestFieldMobile } from "./components/SuggestField/mobile/SuggestFieldMobile.js";
 import { SuggestFieldMobileDropdown } from "./components/SuggestField/mobile/SuggestFieldMobileDropdown.js";
-import { S } from "./chunks/SuggestFieldMobileDropdownHint-CD9CQkCW.js";
+import { S } from "./chunks/SuggestFieldMobileDropdownHint-ssZcfnsc.js";
 import { SuggestField } from "./components/SuggestField/SuggestField.js";
 import { SwipeableArea } from "./components/SwipeableArea/SwipeableArea.js";
 import { MasterTable } from "./components/Table/MasterTable.js";
@@ -323,7 +323,7 @@ import { Title } from "./components/Typography/Title.js";
 import { UnorderedList } from "./components/UnorderedList/UnorderedList.js";
 import { UnorderedListItem } from "./components/UnorderedList/UnorderedListItem.js";
 import { UploadZone } from "./components/UploadZone/UploadZone.js";
-import { U } from "./chunks/UploadZoneInput-CipHc_ua.js";
+import { U } from "./chunks/UploadZoneInput-0kLbusfr.js";
 import { WindowResizeListener } from "./components/WindowResizeListener/WindowResizeListener.js";
 import { EComponentSize } from "./enums/EComponentSize.js";
 import { EFocusSource } from "./enums/EFocusSource.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sberbusiness/triplex-next",
-  "version": "1.41.0",
+  "version": "1.42.0",
   "description": "Библиотека компонентов дизайн-системы Triplex.",
   "license": "Sber Public License at-nc-sa v.2",
   "repository": {