@sberbusiness/triplex-next 0.50.0 → 0.52.0

package/index.d.ts

@@ -257,7 +257,7 @@ export declare const CardStatic: default_2.ForwardRefExoticComponent<ICardProps
     Media: default_2.FC<ICardMediaProps>;
 };
 
-/** Карусель. */
+/** Составная карусель с прокруткой по элементам или страницам в горизонтальной или вертикальной ориентации. */
 export declare const Carousel: default_2.ForwardRefExoticComponent<ICarouselProps & default_2.RefAttributes<HTMLDivElement>> & {
     Viewport: default_2.ForwardRefExoticComponent<ICarouselViewportProps & default_2.RefAttributes<HTMLDivElement>>;
     Track: default_2.ForwardRefExoticComponent<ICarouselTrackProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -346,6 +346,7 @@ export declare const ChipClearButton: default_2.ForwardRefExoticComponent<IChipC
 /** DatePicker с видом компонента Chip. */
 export declare const ChipDatePicker: default_2.ForwardRefExoticComponent<IChipDatePickerProps & default_2.RefAttributes<HTMLDivElement>>;
 
+/** Чипс-таргет DatePickerExtended: переключает календарь через контекст и отображает очистку при selected. */
 export declare const ChipDatePickerTarget: default_2.ForwardRefExoticComponent<IChipDatePickerTargetProps & default_2.RefAttributes<HTMLSpanElement>>;
 
 /** Стрелка выпадающего меню Chip. */
@@ -640,7 +641,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"];
 
@@ -664,7 +665,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"];
 
@@ -698,6 +699,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"];
@@ -949,11 +952,6 @@ export declare enum ECardTheme {
     SECONDARY = "secondary"
 }
 
-export declare enum ECarouselOrientation {
-    HORIZONTAL = "horizontal",
-    VERTICAL = "vertical"
-}
-
 export declare enum ECarouselScrollMode {
     ITEM = "item",
     PAGE = "page"
@@ -1196,6 +1194,14 @@ export declare enum EOrderDirection {
     DESC = "desc"
 }
 
+/** Ориентация (направление) компонента. */
+export declare enum EOrientation {
+    /** Горизонтальная. */
+    HORIZONTAL = "horizontal",
+    /** Вертикальная. */
+    VERTICAL = "vertical"
+}
+
 export declare enum EOverlayDirection {
     BOTTOM = "bottom",
     LEFT = "left",
@@ -2392,25 +2398,26 @@ 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. */
 export declare interface ICarouselItemProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Позиция слайда с нуля; индексы должны идти подряд в порядке элементов ленты. */
     index: number;
 }
 
 /** Свойства компонента Carousel. */
 export declare interface ICarouselProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое карусели: область просмотра с лентой слайдов и необязательная навигация. */
+    children?: React.ReactNode;
     /** Расстояние (зазор) между слайдами в пикселях. По умолчанию 16. */
     gap?: number;
     /** Режим прокрутки карусели: поочередно по одному элементу или постранично. По умолчанию ECarouselScrollMode.ITEM. */
     scrollMode?: ECarouselScrollMode;
-    /** Направление движения карусели (горизонтальное или вертикальное). По умолчанию ECarouselOrientation.HORIZONTAL. */
-    orientation?: ECarouselOrientation;
+    /** Направление движения карусели (горизонтальное или вертикальное). По умолчанию EOrientation.HORIZONTAL. */
+    orientation?: EOrientation;
     /** Внутренние отступы области видимости слайдов (Viewport), задающие зазоры по краям рабочей области скролла. По умолчанию 0. */
     viewportPadding?: TCarouselViewportPadding;
 }
@@ -2540,11 +2547,13 @@ export declare interface IChipClearButtonProps extends Omit<IButtonIconProps, "c
 export declare interface IChipDatePickerProps extends Omit<IDateFieldProps, "status" | "invalidDateHint">, Pick<IChipProps, "type" | "disabled"> {
     /** Название поля, когда не выбрано значение. */
     label: default_2.ReactNode;
-    /** Лейбл, отображаемый вместо выбранного значения. */
+    /** Контент вместо выбранной даты; при пустом или недоступном value отображается label. */
     displayedValue?: default_2.ReactNode;
 }
 
+/** Свойства компонента ChipDatePickerTarget. */
 export declare interface IChipDatePickerTargetProps extends IChipProps {
+    /** Вызывается без аргументов при нажатии кнопки очистки; выбранное значение сбрасывает потребитель. */
     onClear: () => void;
 }
 
@@ -2652,9 +2661,13 @@ export declare interface IChipProps extends Omit<default_2.HTMLAttributes<HTMLSp
     type?: EChipType;
 }
 
+/** Свойства компонента ChipSelect. */
 export declare interface IChipSelectProps extends Pick<IChipProps, "className" | "disabled" | "type">, Omit<ISelectFieldProps, "children" | "targetProps" | "dropdownListItemClassName" | "mobileTitle" | "loading" | "status" | "placeholder"> {
+    /** Обработчик сброса выбора. Потребитель самостоятельно очищает value. */
     clearSelected: () => void;
+    /** Название чипса без выбранного значения и заголовок мобильного списка. */
     label?: default_2.ReactNode;
+    /** Контент вместо label выбранной опции. Без value не отображается. */
     displayedValue?: default_2.ReactNode;
 }
 
@@ -3006,17 +3019,19 @@ export declare interface IDateRangeButtonProvideProps {
     children: default_2.ReactNode;
     /** Класс кнопки сдвига. */
     className: string;
-    /** Обработчик клика, сдвигающий диапазон дат. */
-    onClick: () => void;
     /** Кнопка недоступна — диапазон дат заполнен не полностью. */
     disabled: boolean;
+    /** Обработчик клика, сдвигающий диапазон дат. Не вызывает onChange при пустой или невалидной границе. */
+    onClick: () => void;
 }
 
 /** Свойства функции рендеринга поля выбора даты. */
 export declare interface IDateRangePickerProvideProps {
-    /** Дата в формате YYYYMMDD, пустая строка — дата не выбрана. */
+    /** Дата в формате format компонента DateRange, пустая строка — дата не выбрана. */
     value: string;
-    /** Обработчик изменения даты. Принимает дату в формате YYYYMMDD. */
+    /** Формат дат в value и onChange, заданный в DateRange. */
+    format: string;
+    /** Обработчик изменения даты. Принимает дату в формате format компонента DateRange. */
     onChange: (value: string) => void;
 }
 
@@ -3024,14 +3039,19 @@ export declare interface IDateRangePickerProvideProps {
 export declare interface IDateRangeProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
     /** Диапазон дат. */
     value: TDateRangeValue;
-    /** Функция, вызывающаяся при изменении диапазона дат. */
-    onChange: (value: TDateRangeValue) => void;
+    /**
+     * Формат дат в value и в onChange полей выбора даты. Передаётся полям в renderPickerFrom /
+     * renderPickerTo вместе с value и onChange. По умолчанию YYYYMMDD.
+     */
+    format?: string;
     /** Численная величина сдвига диапазона дат. По умолчанию 1. */
     shiftAmount?: number;
     /** Единица измерения сдвига диапазона дат. По умолчанию EDateRangeShiftUnit.MONTH. */
     shiftUnit?: EDateRangeShiftUnit;
     /** Управление отображением/скрытием кнопок сдвига диапазона дат. По умолчанию false. */
     hideNavigation?: boolean;
+    /** Функция, вызывающаяся при изменении диапазона дат. */
+    onChange: (value: TDateRangeValue) => void;
     /** Функция рендеринга поля выбора даты "от". */
     renderPickerFrom: (props: IDateRangePickerProvideProps) => default_2.ReactNode;
     /** Функция рендеринга поля выбора даты "до". */
@@ -3228,17 +3248,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;
 }
 
@@ -3543,10 +3563,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>;
@@ -3560,10 +3580,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. */
@@ -3585,11 +3601,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;
@@ -3660,16 +3680,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`. */
@@ -4130,10 +4150,10 @@ export declare interface ILoaderSmallProps extends default_2.HTMLAttributes<HTML
 }
 
 /**
- * Галерея изображений с лентой миниатюр (десктоп) и тиками-индикаторами (мобильный).
+ * Галерея изображений с лентой миниатюр (десктоп) и индикаторами страниц (мобильный).
  *
  * Тонкая обёртка над `ImageGalleryExtended`: задаёт пресет раскладки
- * (`Main` + миниатюры/тики через `MobileView`) и добавляет uncontrolled-режим
+ * (`Main` + миниатюры/индикаторы страниц через `MobileView`) и добавляет uncontrolled-режим
  * (`defaultId`). Изображения задаются массивом `items`.
  * Поддерживает controlled (`selectedId` + `onChange`) и uncontrolled режимы.
  */
@@ -4152,15 +4172,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`).
@@ -4177,6 +4188,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`, управляет активным индексом и стрелочной навигацией,
@@ -4404,37 +4424,50 @@ export declare interface IMonthYearFieldTargetProps extends ITextFieldProps, Pic
 
 /** Свойства функции рендеринга кнопки сдвига диапазона месяцев. */
 export declare interface IMonthYearRangeButtonProvideProps {
+    /** Содержимое кнопки — иконка направления сдвига. */
     children: default_2.ReactNode;
+    /** CSS-класс, который следует передать кнопке. */
     className: string;
-    onClick: () => void;
+    /** Кнопка отключена, если хотя бы одна граница диапазона пуста. */
     disabled: boolean;
+    /** Обработчик сдвига; не вызывает onChange при пустой или невалидной границе. */
+    onClick: () => void;
 }
 
 /** Свойства функции рендеринга поля выбора месяца. */
 export declare interface IMonthYearRangePickerProvideProps {
+    /** Дата в формате format компонента MonthYearRange или пустая строка, если граница не выбрана. */
     value: string;
+    /** Формат дат в value и onChange, заданный в MonthYearRange. */
+    format: string;
+    /** Обработчик изменения границы; при пересечении очищает противоположную границу. */
     onChange: (value: string) => void;
 }
 
 /** Свойства компонента MonthYearRange. */
 export declare interface IMonthYearRangeProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
-    /** Диапазон месяцев. */
+    /** Границы диапазона [от, до] в формате format; пустая строка означает отсутствие границы. */
     value: TMonthYearRangeValue;
-    /** Функция, вызывающаяся при изменении диапазона месяцев. */
-    onChange: (value: TMonthYearRangeValue) => void;
-    /** Численная величина сдвига диапазона месяцев. */
+    /**
+     * Формат дат в value и в onChange полей выбора месяца. Передаётся полям в renderPickerFrom /
+     * renderPickerTo вместе с value и onChange. По умолчанию YYYYMMDD.
+     */
+    format?: string;
+    /** Величина сдвига диапазона в единицах shiftUnit. По умолчанию 1. */
     shiftAmount?: number;
-    /** Единица измерения сдвига диапазона месяцев. */
+    /** Единица измерения сдвига. По умолчанию EMonthYearRangeShiftUnit.MONTH. */
     shiftUnit?: EMonthYearRangeShiftUnit;
-    /** Управление отображением/скрытием кнопок сдвига диапазона месяцев. */
+    /** Скрывает кнопки сдвига диапазона. По умолчанию кнопки отображаются. */
     hideNavigation?: boolean;
-    /** Функция рендеринга поля выбора месяца "от". */
+    /** Обработчик изменения диапазона; передаёт новые границы для обновления value. */
+    onChange: (value: TMonthYearRangeValue) => void;
+    /** Рендерит поле выбора месяца "от", используя переданные value, format и onChange. */
     renderPickerFrom: (props: IMonthYearRangePickerProvideProps) => default_2.ReactNode;
-    /** Функция рендеринга поля выбора месяца "до". */
+    /** Рендерит поле выбора месяца "до", используя переданные value, format и 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;
 }
 
@@ -4502,7 +4535,7 @@ declare interface INotificationFooterProps {
 
 /** Свойства NotificationGrouped. */
 export declare interface INotificationGroupedProps {
-    /** Нотификация. */
+    /** Содержимое группы; обычно один Notification, под которым отображаются декоративные слои. */
     children: default_2.ReactNode;
 }
 
@@ -4536,7 +4569,10 @@ declare interface INotificationTimeProps {
     time: default_2.ReactNode;
 }
 
-/** Свойства компонента NumberField. */
+/**
+ * Свойства компонента NumberField, унаследованные от TextField.
+ * inputProps.onChange получает событие с отфильтрованным значением; inputProps.ref указывает на input.
+ */
 export declare interface INumberFieldProps extends ITextFieldProps {
 }
 
@@ -4544,8 +4580,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 {
@@ -4623,6 +4664,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> {
 }
@@ -4643,7 +4698,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> {
 }
 
@@ -5145,19 +5203,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;
@@ -5165,15 +5215,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>;
 }
 
@@ -5193,6 +5245,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;
@@ -6659,7 +6712,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>>;
 
 /**
@@ -6698,13 +6754,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>> & {
@@ -6766,6 +6823,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>>;
 
@@ -6939,15 +7003,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>;
 
 /**
@@ -7272,14 +7345,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];
@@ -7312,7 +7381,7 @@ declare type TDataAttributeAlias = `data-${string}`;
  */
 export declare type TDataHTMLAttributes = Record<string, string>;
 
-/** Значение компонента DateRange — даты "от" и "до" в формате YYYYMMDD. */
+/** Значение компонента DateRange — даты "от" и "до" в формате format (по умолчанию YYYYMMDD). */
 export declare type TDateRangeValue = [string, string];
 
 /** Тип HTML атрибутов компонента дня. */
@@ -7323,7 +7392,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;
@@ -7613,6 +7682,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;
 };
@@ -7983,8 +8060,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;
@@ -8023,7 +8100,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. */
+/** Границы диапазона [от, до] в формате format (по умолчанию YYYYMMDD); пустая строка означает отсутствие границы. */
 export declare type TMonthYearRangeValue = [string, string];
 
 /** Отступ колонки слева в долях 12-колоночной сетки. */
@@ -8060,6 +8137,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;