@sberbusiness/triplex-next 0.49.0 → 0.51.0

package/index.d.ts

@@ -3,12 +3,14 @@ import { default as default_2 } from 'react';
 import { default as default_3 } from 'moment';
 import { default as default_4 } from 'focus-trap-react';
 import { default as default_5 } from 'big.js';
+import { ForwardRefExoticComponent } from 'react';
 import { ISingleColorIconProps } from '@sberbusiness/icons-next';
 import { MaskedInputProps } from 'react-text-mask';
 import { Moment } from 'moment';
 import { MouseSensor } from '@dnd-kit/core';
 import { MouseSensorOptions } from '@dnd-kit/core';
 import { ReactNode } from 'react';
+import { RefAttributes } from 'react';
 import { SyntheticListenerMap } from '@dnd-kit/core/dist/hooks/utilities';
 import { TouchSensor } from '@dnd-kit/core';
 import { TouchSensorOptions } from '@dnd-kit/core';
@@ -638,7 +640,7 @@ declare const designTokensComponentsCalendarKeys: readonly ["Background", "View_
 
 declare const designTokensComponentsCardKeys: readonly ["Static_General_Background", "Static_Secondary_Background", "Action_General_Background", "Action_General_Background_Hover", "Action_General_Background_Selected", "Action_General_Background_Selected_Hover", "Action_Secondary_Background", "Action_Secondary_Background_Hover", "Action_Secondary_Background_Selected", "Action_Secondary_Background_Selected_Hover", "Shadow_Default", "Shadow_Focus", "Shadow_Hover", "Shadow_Selected", "Shadow_Selected_Hover"];
 
-declare const designTokensComponentsCarouselKeys: readonly ["Button_BackgroundColor_Default", "Button_BackgroundColor_Hover", "Button_BackgroundColor_Active", "Button_BackgroundColor_Disabled", "Button_BorderColor", "Indicator_Inactive_BackgroundColor_Default", "Indicator_Inactive_BackgroundColor_Hover", "Indicator_Inactive_BackgroundColor_Pressed", "Indicator_Inactive_BackgroundColor_Disabled", "Indicator_Active_BackgroundColor_Default", "Indicator_Active_BackgroundColor_Hover", "Indicator_Active_BackgroundColor_Pressed", "Indicator_Active_BackgroundColor_Disabled", "Indicator_OutlineColor"];
+declare const designTokensComponentsCarouselKeys: readonly ["Button_BackgroundColor_Default", "Button_BackgroundColor_Hover", "Button_BackgroundColor_Active", "Button_BackgroundColor_Disabled", "Button_BorderColor"];
 
 declare const designTokensComponentsCheckboxKeys: readonly ["Background_Default", "Background_Checked_Default", "Background_Checked_Disabled", "Background_Checked_Hover", "Background_Disabled", "Background_Hover", "BorderColor_Default", "BorderColor_Disabled", "BorderColor_Focus", "BorderColor_Hover", "BorderColor_Checked_Default", "BorderColor_Checked_Disabled", "Checkmark_Fill_Default", "Checkmark_Fill_Disabled"];
 
@@ -662,7 +664,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_BorderColor_Default", "Arrow_BorderColor_Hover", "Arrow_BorderColor_Active", "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", "Thumb_Mask_Background", "Accent_Color"];
 
 declare const designTokensComponentsIslandAccordionKeys: readonly ["Type1_Header_Background_Hover", "Type2_Header_Background_Hover", "Type3_Header_Background_Hover", "Shadow_Focus"];
 
@@ -696,6 +698,8 @@ declare const designTokensComponentsNotificationKeys: readonly ["Background", "C
 
 declare const designTokensComponentsOverlayKeys: readonly ["Background", "Panel_Background"];
 
+declare const designTokensComponentsPageIndicatorsKeys: readonly ["Indicator_Inactive_BackgroundColor_Default", "Indicator_Inactive_BackgroundColor_Hover", "Indicator_Inactive_BackgroundColor_Pressed", "Indicator_Inactive_BackgroundColor_Disabled", "Indicator_Active_BackgroundColor_Default", "Indicator_Active_BackgroundColor_Hover", "Indicator_Active_BackgroundColor_Pressed", "Indicator_Active_BackgroundColor_Disabled", "Indicator_OutlineColor"];
+
 declare const designTokensComponentsPaginationKeys: readonly ["PageButton_Background_Active", "PageButton_Background_Hover", "PageButton_Background_Selected", "PageButton_BorderColor_Focus"];
 
 declare const designTokensComponentsRadioKeys: readonly ["Background_Checked_Default", "Background_Checked_Disabled", "Background_Checked_Hover", "Background_Default", "Background_Disabled", "Background_Hover", "BorderColor_Default", "BorderColor_Disabled", "BorderColor_Focused", "BorderColor_Checked_Default", "BorderColor_Checked_Disabled", "Dot_Default", "Dot_Disabled"];
@@ -947,11 +951,6 @@ export declare enum ECardTheme {
     SECONDARY = "secondary"
 }
 
-export declare enum ECarouselOrientation {
-    HORIZONTAL = "horizontal",
-    VERTICAL = "vertical"
-}
-
 export declare enum ECarouselScrollMode {
     ITEM = "item",
     PAGE = "page"
@@ -1194,6 +1193,14 @@ export declare enum EOrderDirection {
     DESC = "desc"
 }
 
+/** Ориентация (направление) компонента. */
+export declare enum EOrientation {
+    /** Горизонтальная. */
+    HORIZONTAL = "horizontal",
+    /** Вертикальная. */
+    VERTICAL = "vertical"
+}
+
 export declare enum EOverlayDirection {
     BOTTOM = "bottom",
     LEFT = "left",
@@ -2390,10 +2397,8 @@ export declare interface ICarouselExtendedProps extends default_2.HTMLAttributes
     stepNext: number;
 }
 
-/** Свойства компонента CarouselIndicators. */
-export declare interface ICarouselIndicatorsProps extends React.HTMLAttributes<HTMLDivElement> {
-    /** Свойства для кнопок-индикаторов. */
-    indicatorProps?: TCarouselIndicatorProps | TCarouselIndicatorPropsFactory;
+/** Свойства компонента CarouselIndicators. Количество страниц, активная страница и ориентация берутся из Carousel. */
+export declare interface ICarouselIndicatorsProps extends Omit<IPageIndicatorsProps, "count" | "activeIndex" | "onChange" | "orientation"> {
 }
 
 /** Свойства компонента CarouselItem. */
@@ -2407,8 +2412,8 @@ export declare interface ICarouselProps extends React.HTMLAttributes<HTMLDivElem
     gap?: number;
     /** Режим прокрутки карусели: поочередно по одному элементу или постранично. По умолчанию ECarouselScrollMode.ITEM. */
     scrollMode?: ECarouselScrollMode;
-    /** Направление движения карусели (горизонтальное или вертикальное). По умолчанию ECarouselOrientation.HORIZONTAL. */
-    orientation?: ECarouselOrientation;
+    /** Направление движения карусели (горизонтальное или вертикальное). По умолчанию EOrientation.HORIZONTAL. */
+    orientation?: EOrientation;
     /** Внутренние отступы области видимости слайдов (Viewport), задающие зазоры по краям рабочей области скролла. По умолчанию 0. */
     viewportPadding?: TCarouselViewportPadding;
 }
@@ -3226,17 +3231,17 @@ export declare interface IEllipsisProps extends default_2.HTMLAttributes<HTMLDiv
 
 /** Свойства компонента EmptyView. */
 export declare interface IEmptyViewProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "title"> {
-    /** Размер компонента. */
+    /** Размер компонента: SM — текст B3, MD — текст B2. */
     size: EEmptyViewSize;
-    /** Иконка. */
+    /** Иконка пустого состояния. Размер иконки задаёт потребитель. */
     icon?: default_2.ReactNode;
-    /** Заголовок. */
+    /** Заголовок H3 с начертанием MEDIUM для обоих размеров. */
     title?: default_2.ReactNode;
-    /** Описание. */
+    /** Описание. Вторичный цвет при наличии заголовка, иначе основной. */
     description?: default_2.ReactNode;
-    /** Подпись. */
+    /** Дополнительная подпись вторичным цветом. */
     caption?: default_2.ReactNode;
-    /** Кнопки. */
+    /** Кнопки действий с отступом 16px для SM и 24px для MD. */
     buttons?: default_2.ReactNode;
 }
 
@@ -3541,10 +3546,10 @@ declare interface IImageGalleryExtendedComposition {
     Arrow: typeof ImageGalleryExtendedArrow;
     Thumbnails: typeof ImageGalleryExtendedThumbnails;
     Thumb: typeof ImageGalleryExtendedThumb;
-    Dots: typeof ImageGalleryExtendedDots;
+    PageIndicators: typeof ImageGalleryExtendedPageIndicators;
 }
 
-/** Контекст ImageGalleryExtended. Связывает контейнер с составными частями (`Main`/`Thumbnails`/`Dots`). */
+/** Контекст ImageGalleryExtended. Связывает контейнер с составными частями (`Main`/`Thumbnails`/`PageIndicators`). */
 export declare interface IImageGalleryExtendedContext {
     /** Список изображений галереи (из пропа `items` контейнера). */
     items: ReadonlyArray<IImageGalleryItemProps>;
@@ -3558,10 +3563,6 @@ export declare interface IImageGalleryExtendedContext {
     onNext: () => void;
 }
 
-/** Свойства ImageGalleryExtendedDots. */
-export declare interface IImageGalleryExtendedDotsProps extends default_2.HTMLAttributes<HTMLDivElement> {
-}
-
 /** Свойства ImageGalleryExtendedMain. */
 export declare interface IImageGalleryExtendedMainProps extends default_2.HTMLAttributes<HTMLDivElement> {
     /** Высота крупной картинки. `'auto'` — фиксированные значения по breakpoint. */
@@ -3583,11 +3584,15 @@ export declare interface IImageGalleryExtendedNavProps {
     children: (state: IImageGalleryNavState) => default_2.ReactNode;
 }
 
+/** Свойства ImageGalleryExtendedPageIndicators. */
+export declare interface IImageGalleryExtendedPageIndicatorsProps extends Omit<IPageIndicatorsProps, "count" | "activeIndex" | "onChange" | "orientation"> {
+}
+
 /** Свойства компонента ImageGalleryExtended. */
 export declare interface IImageGalleryExtendedProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "onChange"> {
     /** Изображения галереи. Раздаются составным частям через контекст. */
     items: ReadonlyArray<IImageGalleryItemProps>;
-    /** Составные части: `ImageGalleryExtended.Main/.Thumbnails/.Dots`. */
+    /** Составные части: `ImageGalleryExtended.Main/.Thumbnails/.PageIndicators`. */
     children: default_2.ReactNode;
     /** Идентификатор активного изображения (controlled). */
     selectedId: string;
@@ -3658,16 +3663,16 @@ export declare interface IImageGalleryProps extends Omit<default_2.HTMLAttribute
     withBlur?: boolean;
     /** Показывать ли ленту миниатюр (десктоп). */
     showThumbnails?: boolean;
-    /** Показывать ли ряд тиков-индикаторов (мобильный). */
-    showDots?: boolean;
+    /** Показывать ли индикаторы страниц (мобильный). */
+    showPageIndicators?: boolean;
     /** Свойства кнопки перехода к предыдущему изображению. */
     prevArrowProps: TImageGalleryArrowProps;
     /** Свойства кнопки перехода к следующему изображению. */
     nextArrowProps: TImageGalleryArrowProps;
     /** Свойства ленты миниатюр (десктоп). */
     thumbnailsProps?: TImageGalleryThumbnailsProps;
-    /** Свойства ряда тиков-индикаторов (мобильный). */
-    dotsProps?: TImageGalleryDotsProps;
+    /** Свойства индикаторов страниц (мобильный). */
+    pageIndicatorsProps?: TImageGalleryPageIndicatorsProps;
 }
 
 /** Состояние одной миниатюры, передаваемое в render-функцию `ImageGalleryExtended.Thumbnails`. */
@@ -4128,10 +4133,10 @@ export declare interface ILoaderSmallProps extends default_2.HTMLAttributes<HTML
 }
 
 /**
- * Галерея изображений с лентой миниатюр (десктоп) и тиками-индикаторами (мобильный).
+ * Галерея изображений с лентой миниатюр (десктоп) и индикаторами страниц (мобильный).
  *
  * Тонкая обёртка над `ImageGalleryExtended`: задаёт пресет раскладки
- * (`Main` + миниатюры/тики через `MobileView`) и добавляет uncontrolled-режим
+ * (`Main` + миниатюры/индикаторы страниц через `MobileView`) и добавляет uncontrolled-режим
  * (`defaultId`). Изображения задаются массивом `items`.
  * Поддерживает controlled (`selectedId` + `onChange`) и uncontrolled режимы.
  */
@@ -4150,15 +4155,6 @@ export declare const ImageGalleryExtendedArrow: default_2.ForwardRefExoticCompon
 
 export declare const ImageGalleryExtendedContext: default_2.Context<IImageGalleryExtendedContext>;
 
-/**
- * Ряд кликабельных тиков-индикаторов (мобильный preset). Данные берёт из
- * контекста `ImageGalleryExtended`.
- *
- * Картинки распределяются по тикам бакетами равного размера; остаток уходит
- * в последний бакет. При количестве элементов `<= 1` ничего не рендерится.
- */
-export declare const ImageGalleryExtendedDots: default_2.ForwardRefExoticComponent<IImageGalleryExtendedDotsProps & default_2.RefAttributes<HTMLDivElement>>;
-
 /**
  * Крупное изображение галереи: вьюпорт с изображением и накладываемым поверх
  * содержимым (`children` — например стрелки через `ImageGalleryExtended.Nav`).
@@ -4175,6 +4171,15 @@ export declare const ImageGalleryExtendedMain: default_2.ForwardRefExoticCompone
  */
 export declare const ImageGalleryExtendedNav: default_2.FC<IImageGalleryExtendedNavProps>;
 
+/**
+ * Индикаторы страниц галереи (мобильный preset): по индикатору на каждое
+ * изображение. Данные берёт из контекста `ImageGalleryExtended`.
+ *
+ * Доступное имя индикатора по умолчанию — `item.alt`; переопределяется через
+ * `indicatorProps`. При количестве элементов `<= 1` ничего не рендерится.
+ */
+export declare const ImageGalleryExtendedPageIndicators: default_2.ForwardRefExoticComponent<IImageGalleryExtendedPageIndicatorsProps & default_2.RefAttributes<HTMLDivElement>>;
+
 /**
  * Базовый (controlled) компонент галереи изображений. Изображения задаются
  * массивом `items`, управляет активным индексом и стрелочной навигацией,
@@ -4402,37 +4407,43 @@ export declare interface IMonthYearFieldTargetProps extends ITextFieldProps, Pic
 
 /** Свойства функции рендеринга кнопки сдвига диапазона месяцев. */
 export declare interface IMonthYearRangeButtonProvideProps {
+    /** Содержимое кнопки — иконка направления сдвига. */
     children: default_2.ReactNode;
+    /** CSS-класс, который следует передать кнопке. */
     className: string;
+    /** Обработчик сдвига; не вызывает onChange при пустой или невалидной границе. */
     onClick: () => void;
+    /** Кнопка отключена, если хотя бы одна граница диапазона пуста. */
     disabled: boolean;
 }
 
 /** Свойства функции рендеринга поля выбора месяца. */
 export declare interface IMonthYearRangePickerProvideProps {
+    /** Дата в формате YYYYMMDD или пустая строка, если граница не выбрана. */
     value: string;
+    /** Обработчик изменения границы; при пересечении очищает противоположную границу. */
     onChange: (value: string) => void;
 }
 
 /** Свойства компонента MonthYearRange. */
 export declare interface IMonthYearRangeProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
-    /** Диапазон месяцев. */
+    /** Границы диапазона [от, до] в формате YYYYMMDD; пустая строка означает отсутствие границы. */
     value: TMonthYearRangeValue;
-    /** Функция, вызывающаяся при изменении диапазона месяцев. */
+    /** Обработчик изменения диапазона; передаёт новые границы для обновления value. */
     onChange: (value: TMonthYearRangeValue) => void;
-    /** Численная величина сдвига диапазона месяцев. */
+    /** Величина сдвига диапазона в единицах shiftUnit. По умолчанию 1. */
     shiftAmount?: number;
-    /** Единица измерения сдвига диапазона месяцев. */
+    /** Единица измерения сдвига. По умолчанию EMonthYearRangeShiftUnit.MONTH. */
     shiftUnit?: EMonthYearRangeShiftUnit;
-    /** Управление отображением/скрытием кнопок сдвига диапазона месяцев. */
+    /** Скрывает кнопки сдвига диапазона. По умолчанию кнопки отображаются. */
     hideNavigation?: boolean;
-    /** Функция рендеринга поля выбора месяца "от". */
+    /** Рендерит поле выбора месяца "от", используя переданные value и onChange. */
     renderPickerFrom: (props: IMonthYearRangePickerProvideProps) => default_2.ReactNode;
-    /** Функция рендеринга поля выбора месяца "до". */
+    /** Рендерит поле выбора месяца "до", используя переданные value и onChange. */
     renderPickerTo: (props: IMonthYearRangePickerProvideProps) => default_2.ReactNode;
-    /** Функция рендеринга кнопки сдвига диапазона месяцев "назад". */
+    /** Рендерит кнопку сдвига назад, используя переданные children, className, onClick и disabled. */
     renderButtonBack: (props: IMonthYearRangeButtonProvideProps) => default_2.ReactNode;
-    /** Функция рендеринга кнопки сдвига диапазона месяцев "вперёд". */
+    /** Рендерит кнопку сдвига вперёд, используя переданные children, className, onClick и disabled. */
     renderButtonForward: (props: IMonthYearRangeButtonProvideProps) => default_2.ReactNode;
 }
 
@@ -4500,7 +4511,7 @@ declare interface INotificationFooterProps {
 
 /** Свойства NotificationGrouped. */
 export declare interface INotificationGroupedProps {
-    /** Нотификация. */
+    /** Содержимое группы; обычно один Notification, под которым отображаются декоративные слои. */
     children: default_2.ReactNode;
 }
 
@@ -4534,7 +4545,10 @@ declare interface INotificationTimeProps {
     time: default_2.ReactNode;
 }
 
-/** Свойства компонента NumberField. */
+/**
+ * Свойства компонента NumberField, унаследованные от TextField.
+ * inputProps.onChange получает событие с отфильтрованным значением; inputProps.ref указывает на input.
+ */
 export declare interface INumberFieldProps extends ITextFieldProps {
 }
 
@@ -4542,8 +4556,13 @@ export declare interface INumberFieldProps extends ITextFieldProps {
 export declare interface IOrderedListItemProps extends default_2.LiHTMLAttributes<HTMLLIElement> {
 }
 
-/** Свойства компонента OrderedList. */
+/**
+ * Свойства компонента OrderedList.
+ * Кроме start принимает стандартные атрибуты <ol>.
+ */
 export declare interface IOrderedListProps extends default_2.OlHTMLAttributes<HTMLOListElement> {
+    /** Начальный номер списка. По умолчанию 1. */
+    start?: number;
 }
 
 export declare interface IOverlayBaseProps {
@@ -4621,6 +4640,20 @@ export declare interface IOverlayProps extends IOverlayBaseProps, Omit<default_2
     fixed?: boolean;
 }
 
+/** Свойства компонента PageIndicators. */
+export declare interface IPageIndicatorsProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** Количество страниц. */
+    count: number;
+    /** Индекс активной страницы (с 0). Значение вне диапазона приводится к ближайшей странице. */
+    activeIndex: number;
+    /** Обработчик выбора страницы. Получает индекс выбранной страницы. */
+    onChange: (index: number) => void;
+    /** Ориентация ряда индикаторов. По умолчанию EOrientation.HORIZONTAL. */
+    orientation?: EOrientation;
+    /** Свойства кнопок-индикаторов: объект или функция от состояния индикатора. */
+    indicatorProps?: TPageIndicatorProps | TPageIndicatorPropsFactory;
+}
+
 /** Свойства компонента Page. Расширяют стандартные HTML-атрибуты `<div>`. */
 export declare interface IPageProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
@@ -4641,7 +4674,10 @@ export declare interface IPaginationNavigationButtonProps extends Omit<IButtonIc
 declare interface IPaginationNavigationExtendedItemProps extends default_2.HTMLAttributes<HTMLLIElement> {
 }
 
-/** Свойства компонента PaginationNavigationExtended. */
+/**
+ * Свойства компонента PaginationNavigationExtended: стандартные HTML-атрибуты списка.
+ * children задаёт элементы списка, className добавляется к классу корневого ul.
+ */
 export declare interface IPaginationNavigationExtendedProps extends default_2.HTMLAttributes<HTMLUListElement> {
 }
 
@@ -4705,20 +4741,26 @@ export declare interface IPortalProps {
 
 /** Свойства компонента Radio. */
 export declare interface IRadioProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
-    /** Объект label-атрибутов. */
+    /** Атрибуты корневого label. Его className объединяется с внутренними классами label. */
     labelAttributes?: default_2.LabelHTMLAttributes<HTMLLabelElement>;
-    /** Размер радио-кнопки. */
+    /** Размер радио-кнопки. По умолчанию EComponentSize.MD. */
     size?: EComponentSize;
+    /** Контент лейбла радио-кнопки. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента RadioXGroup. */
 export declare interface IRadioXGroupProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Размер отступа. */
+    /** Радио-кнопки группы. */
+    children?: default_2.ReactNode;
+    /** Размер горизонтального отступа между радио-кнопками. По умолчанию 12. */
     indent?: TIndentSize;
 }
 
 /** Свойства компонента RadioYGroup. */
 export declare interface IRadioYGroupProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое группы, обычно набор Radio с одинаковым name. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента Row. */
@@ -5137,19 +5179,11 @@ declare interface ISliderRangeState {
 export declare interface ISmallInputProps extends default_2.InputHTMLAttributes<HTMLInputElement> {
 }
 
-/** Внутренние составляющие SMSField. */
-declare interface ISMSFieldComposition {
-    Tooltip: typeof SMSFieldTooltip;
-    Refresh: typeof SMSFieldRefresh;
-    Input: typeof SMSFieldInput;
-    Submit: typeof SMSFieldSubmit;
-}
-
 /** Свойства SMSField.Input. */
 export declare interface ISMSFieldInputProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement>, "disabled"> {
-    /** Счётчик символов */
+    /** Счётчик символов. */
     counter?: default_2.ReactNode;
-    /** Описание поля ввода */
+    /** Описание поля ввода. */
     description?: default_2.ReactNode;
     /** Текст ошибки. Отображается вместо placeholder в статусе EFormFieldStatus.ERROR, пока поле не в фокусе. */
     errorText?: string;
@@ -5157,15 +5191,17 @@ export declare interface ISMSFieldInputProps extends Omit<default_2.InputHTMLAtt
 
 /** Свойства компонента SMSField. */
 export declare interface ISMSFieldProps extends default_2.HTMLAttributes<HTMLDivElement>, TestProps {
-    /** Значение кода. */
+    /** Состав поля: SMSField.Input, SMSField.Refresh, SMSField.Submit и SMSField.Tooltip. */
+    children?: default_2.ReactNode;
+    /** Текущее значение кода. Компонент управляемый: обновляйте code в onChangeCode. */
     code: string;
-    /** Обработчик изменения кода. */
+    /** Обработчик изменения кода через SMSField.Input. Получает строку, содержащую только цифры, или пустую строку. */
     onChangeCode: (code: string) => void;
-    /** Обработчик отправки кода. */
+    /** Обработчик отправки текущего кода кнопкой SMSField.Submit или клавишей Enter в SMSField.Input. */
     onSubmitCode: (code: string) => void;
-    /** Размер поля. */
+    /** Размер поля и вложенных компонентов SMSField.Input, SMSField.Refresh и SMSField.Submit. */
     size: EComponentSize;
-    /** Визуальное состояние компонента. По умолчанию EFormFieldStatus.DEFAULT. */
+    /** Состояние вложенных элементов. DISABLED блокирует ввод и кнопки; WARNING не поддерживается. По умолчанию EFormFieldStatus.DEFAULT. */
     status?: Exclude<EFormFieldStatus, EFormFieldStatus.WARNING>;
 }
 
@@ -5185,6 +5221,7 @@ export declare interface ISMSFieldSubmitProps extends default_2.ButtonHTMLAttrib
 
 /** Свойства SMSField.Tooltip. */
 export declare interface ISMSFieldTooltipProps extends Partial<Omit<ITooltipProps, "children" | "targetRef">>, Pick<ITooltipProps, "targetRef">, TestProps {
+    /** Целевой элемент подсказки, обычно SMSField.Refresh. */
     children: default_2.ReactElement;
     /** Текст подсказки. */
     message: string;
@@ -6651,7 +6688,10 @@ export declare const MONTHS_SET: number[];
 /** Поле для выбора месяца. */
 export declare const MonthYearField: default_2.ForwardRefExoticComponent<IMonthYearFieldProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Выбор диапазона месяцев. */
+/**
+ * Выбор диапазона месяцев: поля «от» и «до» и кнопки сдвига диапазона назад и вперёд.
+ * Поля и кнопки рендерит потребитель через render-props.
+ */
 export declare const MonthYearRange: default_2.ForwardRefExoticComponent<IMonthYearRangeProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -6690,13 +6730,14 @@ declare const Notification_2: default_2.ForwardRefExoticComponent<INotificationP
 };
 export { Notification_2 as Notification }
 
-/**
- * Компонент NotificationGrouped.
- */
+/** Обёртка, обозначающая группу уведомлений двумя декоративными слоями под содержимым. */
 export declare const NotificationGrouped: default_2.ForwardRefExoticComponent<INotificationGroupedProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Текстовое поле для ввода числовых значений. */
-export declare const NumberField: default_2.FC<INumberFieldProps>;
+/**
+ * Текстовое поле для ввода числовых значений: фильтрует ввод, сохраняя цифры, ведущий минус и десятичную запятую.
+ * Передаёт ref на контейнер FormField, а inputProps.ref — на вложенный input.
+ */
+export declare const NumberField: default_2.ForwardRefExoticComponent<INumberFieldProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Нумерованный список. */
 export declare const OrderedList: default_2.ForwardRefExoticComponent<IOrderedListProps & default_2.RefAttributes<HTMLOListElement>> & {
@@ -6758,6 +6799,13 @@ export declare const Page: default_2.ForwardRefExoticComponent<IPageProps & defa
     };
 };
 
+/**
+ * Ряд индикаторов страниц (controlled). Показывает окно из 5 индикаторов,
+ * крайние индикаторы окна уменьшаются, если за ними есть ещё страницы.
+ * Реализует паттерн WAI-ARIA Tabs: стрелки, Home и End переключают страницу.
+ */
+export declare const PageIndicators: default_2.ForwardRefExoticComponent<IPageIndicatorsProps & default_2.RefAttributes<HTMLDivElement>>;
+
 /** Пагинация: выбор количества элементов на странице (PaginationSelect) и навигация по страницам (PaginationNavigation). */
 export declare const Pagination: default_2.ForwardRefExoticComponent<IPaginationProps & default_2.RefAttributes<HTMLSpanElement>>;
 
@@ -6803,14 +6851,22 @@ export declare const Portal: default_2.FC<IPortalProps>;
 
 export declare type PropsOf<T extends React.ElementType> = React.ComponentPropsWithoutRef<T>;
 
-/** Радио-кнопка с описанием. */
+/**
+ * Радио-кнопка с описанием.
+ * Корневой элемент — label, внутри него нативный input[type="radio"], на который указывает ref.
+ * className и остальные input-атрибуты применяются к input, labelAttributes — к label.
+ */
 export declare const Radio: default_2.ForwardRefExoticComponent<IRadioProps & default_2.RefAttributes<HTMLInputElement>>;
 
 /** Группа радио-кнопок с направлением по оси X. */
-export declare const RadioXGroup: default_2.FC<IRadioXGroupProps>;
+export declare const RadioXGroup: default_2.ForwardRefExoticComponent<IRadioXGroupProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Группа радио-кнопок с направлением по оси Y. */
-export declare const RadioYGroup: default_2.FC<IRadioYGroupProps>;
+/**
+ * Группа радио-кнопок с направлением по оси Y.
+ * Корневой div получает ref, className и остальные HTML-атрибуты.
+ * По умолчанию имеет роль radiogroup, которую можно переопределить через role.
+ */
+export declare const RadioYGroup: default_2.ForwardRefExoticComponent<IRadioYGroupProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
  * Строка сетки с нижним отступом, предназначенная для использования с колонками Col в children.
@@ -6923,15 +6979,24 @@ export declare class SliderRange extends default_2.Component<ISliderRangeProps,
  */
 export declare const SmallInput: default_2.ForwardRefExoticComponent<ISmallInputProps & default_2.RefAttributes<HTMLInputElement>>;
 
-/** Компонент для ввода СМС. */
-export declare const SMSField: default_2.FC<ISMSFieldProps> & ISMSFieldComposition;
+/** Компонент для ввода СМС. Ref указывает на корневой div. */
+export declare const SMSField: default_2.ForwardRefExoticComponent<ISMSFieldProps & default_2.RefAttributes<HTMLDivElement>> & {
+    Tooltip: default_2.FC<ISMSFieldTooltipProps>;
+    Refresh: default_2.ForwardRefExoticComponent<ISMSFieldRefreshProps & default_2.RefAttributes<HTMLButtonElement>>;
+    Input: default_2.ForwardRefExoticComponent<ISMSFieldInputProps & default_2.RefAttributes<HTMLInputElement>>;
+    Submit: default_2.ForwardRefExoticComponent<ISMSFieldSubmitProps & default_2.RefAttributes<HTMLButtonElement>>;
+};
 
+/** Поле ввода кода: принимает только цифры, значение берёт из code корневого SMSField. Ref указывает на input. */
 export declare const SMSFieldInput: default_2.ForwardRefExoticComponent<ISMSFieldInputProps & default_2.RefAttributes<HTMLInputElement>>;
 
+/** Кнопка повторного запроса кода с индикатором обратного отсчёта. Ref указывает на button. */
 export declare const SMSFieldRefresh: default_2.ForwardRefExoticComponent<ISMSFieldRefreshProps & default_2.RefAttributes<HTMLButtonElement>>;
 
-export declare const SMSFieldSubmit: default_2.FC<ISMSFieldSubmitProps>;
+/** Кнопка отправки кода. Недоступна при пустом коде или статусе DISABLED. Ref указывает на button. */
+export declare const SMSFieldSubmit: default_2.ForwardRefExoticComponent<ISMSFieldSubmitProps & default_2.RefAttributes<HTMLButtonElement>>;
 
+/** Подсказка к кнопке SMSField.Refresh. Передаёт свой id в контекст SMSField для aria-describedby кнопки. */
 export declare const SMSFieldTooltip: default_2.FC<ISMSFieldTooltipProps>;
 
 /**
@@ -7055,7 +7120,7 @@ export declare const SuggestContext: default_2.Context<ISuggestContext<any>>;
 
 /** Выпадающий список с возможностью поиска по введённому значению. */
 export declare const SuggestField: (<T extends ISuggestFieldOption = ISuggestFieldOption>(props: ISuggestFieldProps<T>) => JSX.Element) & {
-    Input: default_2.ForwardRefExoticComponent<IFormFieldInputProps & default_2.RefAttributes<HTMLInputElement>>;
+    Input: ForwardRefExoticComponent<IFormFieldInputProps & RefAttributes<HTMLInputElement>>;
 };
 
 /**
@@ -7256,14 +7321,10 @@ export declare type TCalendarMarkedDays = string[] | Record<string, ECalendarDat
 export declare type TCaptionProps<T extends default_2.ElementType> = PolymorphicComponentPropsWithRef<T, ICaptionProps>;
 
 /** Свойства кнопки-индикатора. */
-export declare type TCarouselIndicatorProps = React.ButtonHTMLAttributes<HTMLButtonElement>;
+export declare type TCarouselIndicatorProps = TPageIndicatorProps;
 
 /** Функция для динамического формирования пропсов индикатора. */
-export declare type TCarouselIndicatorPropsFactory = (args: {
-    index: number;
-    page: number;
-    selected: boolean;
-}) => TCarouselIndicatorProps;
+export declare type TCarouselIndicatorPropsFactory = TPageIndicatorPropsFactory;
 
 /** Внутренний отступ компонента CarouselViewport. */
 declare type TCarouselViewportPadding = number | readonly [vertical: number, horizontal: number] | readonly [top: number, horizontal: number, bottom: number] | readonly [top: number, right: number, bottom: number, left: number];
@@ -7307,7 +7368,7 @@ export declare type TDayHtmlAttributesFunction = (params: IDayHtmlAttributesFunc
 
 declare type TDesignTokens = TDesignTokensCore & TDesignTokensComponents;
 
-declare type TDesignTokensComponents = TDesignTokensComponentsAlertContext | TDesignTokensComponentsAlertProcess | TDesignTokensComponentsAvatar | TDesignTokensComponentsBadge | TDesignTokensComponentsButton | TDesignTokensComponentsCalendar | TDesignTokensComponentsCard | TDesignTokensComponentsCarousel | TDesignTokensComponentsCheckbox | TDesignTokensComponentsChip | TDesignTokensComponentsCollapsibleTree | TDesignTokensComponentsDivider | TDesignTokensComponentsDropdown | TDesignTokensComponentsDropdownList | TDesignTokensComponentsDropdownMobile | TDesignTokensComponentsDropdownMobileList | TDesignTokensComponentsFooterPage | TDesignTokensComponentsFormField | TDesignTokensComponentsHeaderPage | TDesignTokensComponentsIsland | TDesignTokensComponentsIslandAccordion | TDesignTokensComponentsIslandWidget | TDesignTokensComponentsImageGallery | TDesignTokensComponentsLightBox | TDesignTokensComponentsLink | TDesignTokensComponentsListItem | TDesignTokensComponentsListItemControlsButton | TDesignTokensComponentsListMaster | TDesignTokensComponentsLoader | TDesignTokensComponentsLoaderScreen | TDesignTokensComponentsMarker | TDesignTokensComponentsMarkerStatus | TDesignTokensComponentsModalWindow | TDesignTokensComponentsMultiselectField | TDesignTokensComponentsNotification | TDesignTokensComponentsOverlay | TDesignTokensComponentsPagination | TDesignTokensComponentsRadio | TDesignTokensComponentsSegmentedControl | TDesignTokensComponentsSegmentedControlSegment | TDesignTokensComponentsSkeleton | TDesignTokensComponentsSmallInput | TDesignTokensComponentsSMSField | TDesignTokensComponentsSlider | TDesignTokensComponentsStep | TDesignTokensComponentsStepper | TDesignTokensComponentsTableBasic | TDesignTokensComponentsTabs | TDesignTokensComponentsTag | TDesignTokensComponentsTagColor | TDesignTokensComponentsTabsLine | TDesignTokensComponentsTooltip | TDesignTokensComponentsTopOverlay | TDesignTokensComponentsTypography | TDesignTokensComponentsStatusTracker | TDesignTokensComponentsUploadZone;
+declare type TDesignTokensComponents = TDesignTokensComponentsAlertContext | TDesignTokensComponentsAlertProcess | TDesignTokensComponentsAvatar | TDesignTokensComponentsBadge | TDesignTokensComponentsButton | TDesignTokensComponentsCalendar | TDesignTokensComponentsCard | TDesignTokensComponentsCarousel | TDesignTokensComponentsCheckbox | TDesignTokensComponentsChip | TDesignTokensComponentsCollapsibleTree | TDesignTokensComponentsDivider | TDesignTokensComponentsDropdown | TDesignTokensComponentsDropdownList | TDesignTokensComponentsDropdownMobile | TDesignTokensComponentsDropdownMobileList | TDesignTokensComponentsFooterPage | TDesignTokensComponentsFormField | TDesignTokensComponentsHeaderPage | TDesignTokensComponentsIsland | TDesignTokensComponentsIslandAccordion | TDesignTokensComponentsIslandWidget | TDesignTokensComponentsImageGallery | TDesignTokensComponentsLightBox | TDesignTokensComponentsLink | TDesignTokensComponentsListItem | TDesignTokensComponentsListItemControlsButton | TDesignTokensComponentsListMaster | TDesignTokensComponentsLoader | TDesignTokensComponentsLoaderScreen | TDesignTokensComponentsMarker | TDesignTokensComponentsMarkerStatus | TDesignTokensComponentsModalWindow | TDesignTokensComponentsMultiselectField | TDesignTokensComponentsNotification | TDesignTokensComponentsOverlay | TDesignTokensComponentsPageIndicators | TDesignTokensComponentsPagination | TDesignTokensComponentsRadio | TDesignTokensComponentsSegmentedControl | TDesignTokensComponentsSegmentedControlSegment | TDesignTokensComponentsSkeleton | TDesignTokensComponentsSmallInput | TDesignTokensComponentsSMSField | TDesignTokensComponentsSlider | TDesignTokensComponentsStep | TDesignTokensComponentsStepper | TDesignTokensComponentsTableBasic | TDesignTokensComponentsTabs | TDesignTokensComponentsTag | TDesignTokensComponentsTagColor | TDesignTokensComponentsTabsLine | TDesignTokensComponentsTooltip | TDesignTokensComponentsTopOverlay | TDesignTokensComponentsTypography | TDesignTokensComponentsStatusTracker | TDesignTokensComponentsUploadZone;
 
 declare type TDesignTokensComponentsAlertContext = {
     AlertContext: TDesignTokensComponentsAlertContextValue;
@@ -7597,6 +7658,14 @@ declare type TDesignTokensComponentsOverlayKeys = (typeof designTokensComponents
 
 declare type TDesignTokensComponentsOverlayValue = Record<TDesignTokensComponentsOverlayKeys, TDesignTokenValue>;
 
+declare type TDesignTokensComponentsPageIndicators = {
+    PageIndicators: TDesignTokensComponentsPageIndicatorsValue;
+};
+
+declare type TDesignTokensComponentsPageIndicatorsKeys = (typeof designTokensComponentsPageIndicatorsKeys)[number];
+
+declare type TDesignTokensComponentsPageIndicatorsValue = Record<TDesignTokensComponentsPageIndicatorsKeys, TDesignTokenValue>;
+
 declare type TDesignTokensComponentsPagination = {
     Pagination: TDesignTokensComponentsPaginationValue;
 };
@@ -7967,8 +8036,8 @@ export declare const ThemeProviderContext: default_2.Context<IThemeProviderConte
 /** Свойства стрелки, которые ImageGallery пробрасывает в ImageGalleryExtended.Arrow. Допускают `data-*`. */
 export declare type TImageGalleryArrowProps = Omit<IImageGalleryExtendedArrowProps, "direction" | "onClick" | "disabled" | "hidden" | "type"> & DataAttributes;
 
-/** Свойства тиков, которые ImageGallery пробрасывает в ImageGalleryExtended.Dots. Допускают `data-*`. */
-export declare type TImageGalleryDotsProps = Omit<IImageGalleryExtendedDotsProps, "children"> & DataAttributes;
+/** Свойства индикаторов страниц, которые ImageGallery пробрасывает в ImageGalleryExtended.PageIndicators. Допускают `data-*`. */
+export declare type TImageGalleryPageIndicatorsProps = Omit<IImageGalleryExtendedPageIndicatorsProps, "children"> & DataAttributes;
 
 /** Свойства ленты миниатюр, которые ImageGallery пробрасывает в ImageGalleryExtended.Thumbnails. Допускают `data-*`. */
 export declare type TImageGalleryThumbnailsProps = Omit<IImageGalleryExtendedThumbnailsProps, "children"> & DataAttributes;
@@ -8007,7 +8076,7 @@ declare type TitleComponent_2 = (<T extends default_2.ElementType = "span">(prop
  */
 declare type TKeyCode = (typeof EVENT_KEY_CODES)[keyof typeof EVENT_KEY_CODES];
 
-/** Значение компонента MonthYearRange. */
+/** Границы диапазона [от, до] в формате YYYYMMDD; пустая строка означает отсутствие границы. */
 export declare type TMonthYearRangeValue = [string, string];
 
 /** Отступ колонки слева в долях 12-колоночной сетки. */
@@ -8044,6 +8113,19 @@ declare const TooltipXButton: default_2.FC<ITooltipXButtonProps>;
  */
 export declare const TopOverlay: default_2.ForwardRefExoticComponent<ITopOverlayProps & default_2.RefAttributes<HTMLDivElement>>;
 
+/** Свойства кнопки-индикатора. */
+export declare type TPageIndicatorProps = default_2.ButtonHTMLAttributes<HTMLButtonElement>;
+
+/** Функция для динамического формирования свойств индикатора. */
+export declare type TPageIndicatorPropsFactory = (args: {
+    /** Индекс страницы (с 0). */
+    index: number;
+    /** Номер страницы (с 1). */
+    page: number;
+    /** Активна ли страница. */
+    selected: boolean;
+}) => TPageIndicatorProps;
+
 /** Приведенный к Moment тип даты, используемый для внутренних вычислений. */
 export declare type TPickedDate = Moment | null;