@sberbusiness/triplex-next 0.38.0 → 0.40.0

package/index.d.ts

@@ -56,7 +56,11 @@ export declare const ALERT_TYPE_TO_CLASS_NAME_MAP: {
     feature: (styles: Record<string, string>) => string;
 };
 
-/** Компонент контекстного предупреждения. */
+/**
+ * Компонент контекстного предупреждения.
+ * Рендерит live-region (`role="alert"`) с иконкой и текстом. Иконка выбирается по `type`,
+ * её можно переопределить через `renderIcon`.
+ */
 export declare const AlertContext: default_2.ForwardRefExoticComponent<IAlertContextProps & default_2.RefAttributes<HTMLSpanElement>>;
 
 /** Компонент процессного предупреждения. */
@@ -107,17 +111,30 @@ export declare const BodyPage: default_2.ForwardRefExoticComponent<(IBodyPageTyp
 
 declare type BuiltIn = Function | Date | RegExp | Map<any, any> | Set<any> | Promise<any> | symbol;
 
-/** Кнопка. */
+/**
+ * Кнопка — основной интерактивный элемент для запуска действий.
+ * Поддерживает пять тем (EButtonTheme), три размера, состояние загрузки, иконку и блочный режим.
+ */
 export declare const Button: default_2.ForwardRefExoticComponent<TButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
 
-export declare const ButtonBase: default_2.ForwardRefExoticComponent<IButtonBaseProps & default_2.RefAttributes<HTMLButtonElement>>;
-
-/** Кнопка с выпадающим списком действий. */
+/**
+ * Кнопка с выпадающим списком действий.
+ * Триггер отображается либо как обычная кнопка с текстом и кареткой, либо как кнопка-dots (тема EButtonDotsTheme).
+ */
 export declare const ButtonDropdown: default_2.ForwardRefExoticComponent<(IButtonDropdownBaseProps | IButtonDotsProps) & default_2.RefAttributes<HTMLButtonElement>>;
 
+/**
+ * Компонент "Кнопка с выпадающим блоком".
+ * Позволяет кастомизировать кнопку открытия Dropdown и сам Dropdown через render-функции.
+ * Пока блок открыт, слушает документ и закрывает его по Escape, по Tab (при closeOnTab)
+ * и по клику вне кнопки и вне выпадающего блока.
+ */
 export declare const ButtonDropdownExtended: IButtonDropdownExtendedComponent;
 
-/** Кнопка-иконка. */
+/**
+ * Кнопка-иконка — компактный интерактивный элемент без текстового контента.
+ * Размер задаётся размером переданной иконки. Требует aria-label от потребителя.
+ */
 export declare const ButtonIcon: default_2.ForwardRefExoticComponent<IButtonIconProps & default_2.RefAttributes<HTMLButtonElement>>;
 
 /** Вычисление позиции шага, относительно других. */
@@ -193,6 +210,8 @@ declare const CardMedia: default_2.FC<ICardMediaProps>;
 /** Компонент "Статичная карточка". */
 export declare const CardStatic: default_2.FC<ICardProps> & ICardStaticComposition;
 
+/* Excluded from this release type: Carousel */
+
 /** Карусель. */
 export declare const CarouselExtended: default_2.ForwardRefExoticComponent<ICarouselExtendedProps & default_2.RefAttributes<HTMLDivElement>>;
 
@@ -309,7 +328,11 @@ declare type CodeTextComponent = (<T extends default_2.ElementType = "span">(pro
     displayName?: string;
 };
 
-export declare const Col: default_2.FC<IColProps>;
+/**
+ * Колонка 12-колоночной сетки. Используется внутри компонента Row,
+ * горизонтальный отступ между колонками получает из RowContext.
+ */
+export declare const Col: default_2.ForwardRefExoticComponent<IColProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
  * Готовое дерево с раскрывающимися ветками. Принимает данные узлов (`nodes`) и рендерит дерево с типовым UI:
@@ -383,7 +406,7 @@ export declare const CollapsibleTreeNodeHeader: default_2.ForwardRefExoticCompon
  * Используй как `label` в {@link ICollapsibleTreeNodeBranch} или внутри `CollapsibleTreeNodeHeader`,
  * когда нужно переопределить размер/толщину шрифта (например, в кастомном `renderHeader` у `CollapsibleTreeExtended`).
  */
-export declare const CollapsibleTreeNodeLabel: default_2.ForwardRefExoticComponent<Pick<TCollapsibleTreeNodeLabelProps, "line" | "type" | "key" | "size" | keyof default_2.HTMLAttributes<HTMLSpanElement> | "weight" | "underline" | "strikethrough"> & default_2.RefAttributes<HTMLSpanElement>>;
+export declare const CollapsibleTreeNodeLabel: default_2.ForwardRefExoticComponent<Pick<TCollapsibleTreeNodeLabelProps, "underline" | "strikethrough" | "line" | "type" | "key" | "size" | keyof default_2.HTMLAttributes<HTMLSpanElement> | "weight"> & default_2.RefAttributes<HTMLSpanElement>>;
 
 /** Компонент, для настройки видимости колонок. */
 export declare const ColumnSettings: default_2.ForwardRefExoticComponent<IColumnSettingsProps & default_2.RefAttributes<HTMLDivElement>> & {
@@ -473,6 +496,8 @@ 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 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"];
 
 declare const designTokensComponentsChipKeys: readonly ["Background_Active", "Background_Disabled", "Background_Type1_Default", "Background_Type1_Hover", "Background_Type2_Default", "Background_Type2_Hover", "Background_Selected_Active", "Background_Selected_Default", "Background_Selected_Disabled", "Background_Selected_Hover", "Color_Active", "Color_Default", "Color_Disabled", "Color_Hover", "Color_Selected_Active", "Color_Selected_Default", "Color_Selected_Disabled", "Color_Selected_Hover", "Shadow_Focus"];
@@ -603,22 +628,36 @@ export declare const Divider: default_2.FC<IDividerProps>;
 /** Поле редактирования номера документа. */
 export declare const DocumentNumberEdit: default_2.FC<IDocumentNumberEditProps>;
 
-/** Выпадающее меню. */
+/**
+ * Выпадающее меню.
+ * Рендерится через Portal в document.body и позиционируется относительно targetRef.
+ * Если передан mobileViewProps, на мобильной ширине экрана вместо десктопного меню рендерится
+ * полноэкранная мобильная версия (DropdownMobile).
+ */
 export declare const Dropdown: default_2.ForwardRefExoticComponent<IDropdownProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Выпадающее меню. */
+/**
+ * Десктопная версия выпадающего меню.
+ * Позиционируется фиксированно относительно targetRef, пересчитывает положение при скролле,
+ * ресайзе окна и изменении размеров меню или управляющего элемента. Пока меню открыто,
+ * скролл страницы вне меню заблокирован. В закрытом состоянии ничего не рендерит.
+ */
 export declare const DropdownDesktop: default_2.ForwardRefExoticComponent<IDropdownDesktopProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
  * Компонент DropdownList.
- * Используется для обрамления вложенного списка и добавляет спику возможность навигации с клавиатуры.
- * В качестве children принимает только DropdownDesktopList.Item.
+ * Используется для обрамления вложенного списка и добавляет списку возможность навигации с клавиатуры.
+ * В качестве children принимает только DropdownList.Item.
  */
 export declare const DropdownList: IDropdownListComponent;
 
 export declare const DropdownListContext: Context<IDropdownListContext>;
 
-/** Элемент выпадающего списка. */
+/**
+ * Элемент выпадающего списка.
+ * Пока элемент активен (active), слушает клавиатуру документа и вызывает onSelect
+ * при нажатии клавиш из keyCodesForSelection.
+ */
 export declare const DropdownListItem: default_2.ForwardRefExoticComponent<IDropdownListItemProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Мобильная версия Dropdown. */
@@ -733,8 +772,11 @@ export declare enum ECalendarViewMode {
 
 /** Возможные размеры компонента Caption. */
 export declare enum ECaptionSize {
-    C1 = "C1",// В дизайне C1
-    C2 = "C2",// В дизайне C2
+    /** В дизайне C1. */
+    C1 = "C1",
+    /** В дизайне C2. */
+    C2 = "C2",
+    /** В дизайне D1. */
     D1 = "D1"
 }
 
@@ -756,6 +798,16 @@ export declare enum ECardTheme {
     SECONDARY = "secondary"
 }
 
+export declare enum ECarouselOrientation {
+    HORIZONTAL = "horizontal",
+    VERTICAL = "vertical"
+}
+
+export declare enum ECarouselScrollMode {
+    ITEM = "item",
+    PAGE = "page"
+}
+
 /** Перечисление типов ячейки (для внутренних отступов и т.д.). */
 export declare enum ECellType {
     TEXT = "text",
@@ -912,6 +964,7 @@ export declare enum EIslandType {
     TYPE_3 = "type_3"
 }
 
+/** Размер контента LightBox. */
 export declare enum ELightBoxSize {
     SM = "sm",
     MD = "md",
@@ -1081,16 +1134,23 @@ export declare enum ETagColorStatus {
 
 /** Возможные размеры компонента Text. */
 export declare enum ETextSize {
-    B1 = "B1",// В дизайне S1, B1
-    B2 = "B2",// В дизайне S2, B2
-    B3 = "B3",// В дизайне S3, B3
+    /** В дизайне S1, B1. */
+    B1 = "B1",
+    /** В дизайне S2, B2. */
+    B2 = "B2",
+    /** В дизайне S3, B3. */
+    B3 = "B3",
+    /** В дизайне S4, B4. */
     B4 = "B4"
 }
 
 /** Возможные размеры компонента Title. */
 export declare enum ETitleSize {
-    H1 = "h1",// В дизайне H1
-    H2 = "h2",// В дизайне H2
+    /** В дизайне H1. */
+    H1 = "h1",
+    /** В дизайне H2. */
+    H2 = "h2",
+    /** В дизайне H3. */
     H3 = "h3"
 }
 
@@ -1533,6 +1593,8 @@ export declare interface IAlertContextProps extends default_2.HTMLAttributes<HTM
     type: Exclude<EAlertType, EAlertType.FEATURE>;
     /** Отображаемая иконка. */
     renderIcon?: default_2.ReactNode;
+    /** Текст предупреждения. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента AlertProcess. */
@@ -1665,15 +1727,15 @@ export declare interface IBodyPageTypeSecondProps extends IBodyProps {
 export declare interface IBodyProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
-export declare interface IButtonBaseProps extends default_2.ButtonHTMLAttributes<HTMLButtonElement> {
+declare interface IButtonBaseProps extends default_2.ButtonHTMLAttributes<HTMLButtonElement> {
 }
 
 /** Свойства кнопки типа Danger. */
 export declare interface IButtonDangerProps extends IButtonBaseProps {
     /** Тема кнопки. */
     theme: EButtonTheme.DANGER;
-    /** Размер кнопки. */
-    size: EComponentSize;
+    /** Размер кнопки. По умолчанию EComponentSize.MD. */
+    size?: EComponentSize;
     /** Блочный режим. */
     block?: boolean;
     /** Режим загрузки. */
@@ -1685,7 +1747,7 @@ export declare interface IButtonDangerProps extends IButtonBaseProps {
 }
 
 /** Свойства контекстной кнопки с выпадающим списком действий. */
-declare interface IButtonDotsProps extends IButtonDropdownProps {
+export declare interface IButtonDotsProps extends IButtonDropdownProps {
     /** Тема кнопки. */
     theme: EButtonDotsTheme;
     /** Блочное состояние кнопки. */
@@ -1693,9 +1755,9 @@ declare interface IButtonDotsProps extends IButtonDropdownProps {
 }
 
 /** Свойства основной/вспомогательной кнопки с выпадающим списком действий. */
-declare interface IButtonDropdownBaseProps extends IButtonDropdownProps {
+export declare interface IButtonDropdownBaseProps extends IButtonDropdownProps {
     /** Тема кнопки. */
-    theme: EButtonTheme.GENERAL | EButtonTheme.SECONDARY | EButtonTheme.SECONDARY_LIGHT | EButtonTheme.DANGER;
+    theme: TButtonDropdownButtonTheme;
     /** Блочное состояние кнопки. */
     block?: boolean;
 }
@@ -1708,12 +1770,11 @@ export declare interface IButtonDropdownExtendedButtonProvideProps {
     setOpened: (opened: boolean) => void;
 }
 
-/**
- * Компонент "Кнопка с выпадающим блоком".
- * Позволяет кастомизировать кнопку открытия Dropdown и сам Dropdown.
- */
+/** Тип компонента "Кнопка с выпадающим блоком" со статическими субкомпонентами. */
 export declare interface IButtonDropdownExtendedComponent extends default_2.FC<IButtonDropdownExtendedProps> {
+    /** Выпадающий блок. */
     Dropdown: typeof Dropdown;
+    /** Список опций для выпадающего блока. */
     DropdownList: typeof DropdownList;
 }
 
@@ -1729,15 +1790,15 @@ export declare interface IButtonDropdownExtendedDropdownProvideProps {
 
 /** Свойства кнопки с выпадающим блоком. */
 export declare interface IButtonDropdownExtendedProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Контролируемое состояние открытости. */
+    /** Контролируемое состояние открытости. Если передан на первом рендере, компонент работает в контролируемом режиме. */
     opened?: boolean;
-    /** Функция, контролирующая состояние открытости. */
+    /** Функция, контролирующая состояние открытости. Вызывается только в контролируемом режиме. */
     setOpened?: (opened: boolean) => void;
     /** Функция, отрисовывающая кнопку. */
     renderButton: (props: IButtonDropdownExtendedButtonProvideProps) => default_2.ReactNode;
     /** Функция, отрисовывающая выпадающий блок. */
     renderDropdown: (props: IButtonDropdownExtendedDropdownProvideProps) => default_2.ReactNode;
-    /** Ссылка на выпадающий блок. */
+    /** Ссылка на выпадающий блок. Нужна, чтобы клик внутри блока не считался кликом снаружи. */
     dropdownRef: default_2.RefObject<HTMLElement>;
     /** Закрытие выпадающего блока при нажатии клавиши Tab. */
     closeOnTab?: boolean;
@@ -1767,14 +1828,18 @@ export declare interface IButtonDropdownProps extends default_2.HTMLAttributes<H
     selected?: IButtonDropdownOption;
     /** Отключенное состояние кнопки. */
     disabled?: boolean;
+    /** Управляемое состояние открытости dropdown (controlled-режим). Задаётся в паре с setOpened; без setOpened состояние зафиксировано (например, для visual-тестов). */
+    opened?: boolean;
+    /** Обработчик изменения состояния открытости dropdown (пара к opened). */
+    setOpened?: (opened: boolean) => void;
 }
 
 /** Свойства кнопки типа General. */
 export declare interface IButtonGeneralProps extends IButtonBaseProps {
     /** Тема кнопки. */
     theme: EButtonTheme.GENERAL;
-    /** Размер кнопки. */
-    size: EComponentSize;
+    /** Размер кнопки. По умолчанию EComponentSize.MD. */
+    size?: EComponentSize;
     /** Блочный режим. */
     block?: boolean;
     /** Режим загрузки. */
@@ -1787,18 +1852,23 @@ export declare interface IButtonGeneralProps extends IButtonBaseProps {
 
 /** Свойства компонента ButtonIcon. */
 export declare interface IButtonIconProps extends default_2.ButtonHTMLAttributes<HTMLButtonElement>, DataAttributes {
-    /** Форма границы кнопки. */
+    /** Форма границы кнопки. По умолчанию EButtonIconShape.SQUIRCLE. */
     shape?: EButtonIconShape;
-    /** Активное состояние. */
+    /** Активное состояние. По умолчанию false. */
     active?: boolean;
+    /**
+     * Содержимое кнопки, обычно иконка из @sberbusiness/icons-next.
+     * Не деструктурируется отдельно — уходит на корневой button внутри ...rest.
+     */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства кнопки типа Link. */
 export declare interface IButtonLinkProps extends IButtonBaseProps {
     /** Тема кнопки. */
     theme: EButtonTheme.LINK;
-    /** Размер кнопки. */
-    size: EComponentSize;
+    /** Размер кнопки. По умолчанию EComponentSize.MD. */
+    size?: EComponentSize;
     /** Блочный режим. */
     block?: never;
     /** Режим загрузки. */
@@ -1813,8 +1883,8 @@ export declare interface IButtonLinkProps extends IButtonBaseProps {
 export declare interface IButtonSecondaryLightProps extends IButtonBaseProps {
     /** Тема кнопки. */
     theme: EButtonTheme.SECONDARY_LIGHT;
-    /** Размер кнопки. */
-    size: EComponentSize;
+    /** Размер кнопки. По умолчанию EComponentSize.MD. */
+    size?: EComponentSize;
     /** Блочный режим. */
     block?: boolean;
     /** Режим загрузки. */
@@ -1829,8 +1899,8 @@ export declare interface IButtonSecondaryLightProps extends IButtonBaseProps {
 export declare interface IButtonSecondaryProps extends IButtonBaseProps {
     /** Тема кнопки. */
     theme: EButtonTheme.SECONDARY;
-    /** Размер кнопки. */
-    size: EComponentSize;
+    /** Размер кнопки. По умолчанию EComponentSize.MD. */
+    size?: EComponentSize;
     /** Блочный режим. */
     block?: boolean;
     /** Режим загрузки. */
@@ -2012,6 +2082,62 @@ export declare interface ICarouselExtendedProps extends default_2.HTMLAttributes
     stepNext: number;
 }
 
+/** Свойства компонента CarouselIndicators. */
+export declare interface ICarouselIndicatorsProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Свойства для кнопок-индикаторов. */
+    indicatorProps?: TCarouselIndicatorProps | TCarouselIndicatorPropsFactory;
+    /**
+     * Кастомный рендер индикатора.
+     * `props` содержат вычисленные role/tabIndex/aria-selected, className и onClick;
+     * `ref` необходимо прокинуть на интерактивный элемент для корректного управления фокусом.
+     */
+    renderIndicator?: (args: {
+        index: number;
+        page: number;
+        selected: boolean;
+        props: TCarouselIndicatorProps;
+        ref: React.RefCallback<HTMLButtonElement>;
+    }) => React.ReactNode;
+}
+
+/** Свойства компонента CarouselItem. */
+export declare interface ICarouselItemProps extends React.HTMLAttributes<HTMLDivElement> {
+    index: number;
+}
+
+/** Свойства компонента Carousel. */
+export declare interface ICarouselProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Расстояние (зазор) между слайдами в пикселях.
+     * @default 16
+     */
+    gap?: number;
+    /**
+     * Режим прокрутки карусели: поочередно по одному элементу или постранично.
+     * @default ECarouselScrollMode.ITEM
+     */
+    scrollMode?: ECarouselScrollMode;
+    /**
+     * Направление движения карусели (горизонтальное или вертикальное).
+     * @default ECarouselOrientation.HORIZONTAL
+     */
+    orientation?: ECarouselOrientation;
+    /**
+     * Внутренние отступы области видимости слайдов (Viewport).
+     * Задают зазоры по краям рабочей области скролла.
+     * @default 0
+     */
+    viewportPadding?: TCarouselViewportPadding;
+}
+
+/** Свойства компонента CarouselTrack. */
+export declare interface ICarouselTrackProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+
+/** Свойства компонента CarouselViewport. */
+export declare interface ICarouselViewportProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+
 /** Свойства компонента Checkbox. */
 export declare interface ICheckboxProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
     /** Объект label-атрибутов. */
@@ -2276,28 +2402,49 @@ export declare interface ICollapsibleTreeProps extends Omit<ICollapsibleTreeExte
     nodes: ICollapsibleTreeNodeBranch[];
 }
 
-/** Свойства Col. */
+/** Свойства компонента Col. */
 export declare interface IColProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое колонки. */
     children?: default_2.ReactNode;
+    /** Ширина колонки на всех экранах. По умолчанию 12 (вся ширина). */
     size?: TColumnSize;
+    /** Ширина колонки на экранах от sm и шире. */
     sizeSm?: TColumnSize;
+    /** Ширина колонки на экранах от md и шире. */
     sizeMd?: TColumnSize;
+    /** Ширина колонки на экранах от lg и шире. */
     sizeLg?: TColumnSize;
+    /** Ширина колонки на экранах от xl и шире. */
     sizeXl?: TColumnSize;
+    /** Отступ слева на всех экранах. */
     offset?: TOffsetSize;
+    /** Отступ слева на экранах от sm и шире. */
     offsetSm?: TOffsetSize;
+    /** Отступ слева на экранах от md и шире. */
     offsetMd?: TOffsetSize;
+    /** Отступ слева на экранах от lg и шире. */
     offsetLg?: TOffsetSize;
+    /** Отступ слева на экранах от xl и шире. */
     offsetXl?: TOffsetSize;
+    /** Скрытие колонки на всех экранах (CSS display: none; переопределяет нативный HTML-атрибут hidden). */
     hidden?: boolean;
+    /** Скрытие колонки на экранах от sm и шире. */
     hiddenSm?: boolean;
+    /** Скрытие колонки на экранах от md и шире. */
     hiddenMd?: boolean;
+    /** Скрытие колонки на экранах от lg и шире. */
     hiddenLg?: boolean;
+    /** Скрытие колонки на экранах от xl и шире. */
     hiddenXl?: boolean;
+    /** Отображение колонки (display: block) на всех экранах. */
     block?: boolean;
+    /** Отображение колонки (display: block) на экранах от sm и шире. */
     blockSm?: boolean;
+    /** Отображение колонки (display: block) на экранах от md и шире. */
     blockMd?: boolean;
+    /** Отображение колонки (display: block) на экранах от lg и шире. */
     blockLg?: boolean;
+    /** Отображение колонки (display: block) на экранах от xl и шире. */
     blockXl?: boolean;
 }
 
@@ -2527,6 +2674,7 @@ export declare interface IDropdownDesktopProps extends default_2.HTMLAttributes<
 
 /** Композиция компонента DropdownList. */
 export declare interface IDropdownListComponent extends default_2.FC<IDropdownListProps> {
+    /** Элемент выпадающего списка. */
     Item: typeof DropdownListItem;
 }
 
@@ -2558,13 +2706,13 @@ export declare interface IDropdownListItemProps extends default_2.HTMLAttributes
 
 /** Свойства компонента DropdownList. */
 export declare interface IDropdownListProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Dropdown открыт. */
+    /** Dropdown открыт. При открытии список подписывается на клавиатурную навигацию. */
     dropdownOpened: boolean;
     /** Объект для создания ссылки на html-элемент "список". */
     listRef?: default_2.RefObject<HTMLDivElement>;
-    /** Состояние загрузки. */
+    /** Состояние загрузки. Дополняет список элементом с лоадером. */
     loading?: boolean;
-    /** Размер списка. */
+    /** Размер списка. Пробрасывается в элементы списка. */
     size?: EComponentSize;
 }
 
@@ -2597,8 +2745,11 @@ export declare interface IDropdownMobileInputProps extends default_2.InputHTMLAt
 
 /** Свойства компонента DropdownMobileListItem. */
 export declare interface IDropdownMobileListItemProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Идентификатор элемента. */
     id: string;
+    /** Обработчик выбора текущего элемента. Вызывается по клику, до onClick. */
     onSelect?: () => void;
+    /** Флаг - текущий элемент выбран. */
     selected?: boolean;
     /** Флаг отображения значка новых уведомлений. */
     showNotificationIcon?: boolean;
@@ -3189,8 +3340,11 @@ declare interface ILightBoxCloseProps extends default_2.HTMLAttributes<HTMLDivEl
     onClick: () => void;
 }
 
+/** Свойства компонента LightBoxContent. */
 declare interface ILightBoxContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое контентной области лайтбокса. */
     children: default_2.ReactNode;
+    /** Флаг состояния загрузки. */
     isLoading?: boolean;
     /** Свойства компонента LoaderScreen. */
     loaderScreenProps?: ILoaderScreenMiddleProps;
@@ -3206,6 +3360,7 @@ declare interface ILightBoxControlsFC extends default_2.FC<ILightBoxControlsProp
 declare interface ILightBoxControlsProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
+/** Свойства компонента LightBoxLeftSidebar. */
 declare interface ILightBoxLeftSidebarProps extends default_2.HTMLAttributes<HTMLDivElement> {
     /** Фиксация боковой панели. */
     fixed?: boolean;
@@ -3239,6 +3394,7 @@ declare interface ILightBoxPrevProps extends default_2.HTMLAttributes<HTMLDivEle
 
 /** Свойства компонента LightBox. */
 export declare interface ILightBoxProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое лайтбокса. */
     children: default_2.ReactElement[];
     /** Свойства компонента FocusTrapExtended. */
     focusTrapProps?: IFocusTrapExtendedProps;
@@ -3258,6 +3414,7 @@ export declare interface ILightBoxProps extends default_2.HTMLAttributes<HTMLDiv
     size?: ELightBoxSize;
 }
 
+/** Свойства компонента LightBoxRightSidebar. */
 declare interface ILightBoxRightSidebarProps extends default_2.HTMLAttributes<HTMLDivElement> {
     /** Фиксация боковой панели. */
     fixed?: boolean;
@@ -4010,7 +4167,9 @@ export declare interface IPaginationSelectProps extends Omit<ISelectFieldProps,
 
 /** Свойства компонента Portal. */
 export declare interface IPortalProps {
+    /** Содержимое, рендерящееся в container. */
     children: default_2.ReactNode;
+    /** DOM-узел, в который рендерится содержимое. */
     container: Element;
 }
 
@@ -4034,9 +4193,11 @@ export declare interface IRadioYGroupProps extends default_2.HTMLAttributes<HTML
 
 /** Свойства компонента Row. */
 export declare interface IRowProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Вертикальный нижний отступ. */
+    /** Колонки Col. */
+    children?: default_2.ReactNode;
+    /** Вертикальный нижний отступ. По умолчанию true. */
     paddingBottom?: boolean;
-    /** Размер отступа между колонками. */
+    /** Размер отступа между колонками. По умолчанию EComponentSize.SM. */
     gridHorizontalGap?: EComponentSize.SM | EComponentSize.MD;
 }
 
@@ -5108,6 +5269,7 @@ export declare interface ITextProps extends ITypographyProps {
     size: ETextSize;
     /** Высота блока строки. */
     line?: ELineType;
+    /** Толщина шрифта. */
     weight?: EFontWeightText;
 }
 
@@ -5383,7 +5545,9 @@ declare interface ITriggerClickOnKeyDownEventProps extends Pick<IKeyDownListener
 
 /** Свойства компонента типографики. */
 export declare interface ITypographyProps {
-    /** Тип (цвет шрифта) */
+    /** Название тэга. */
+    tag?: string;
+    /** Тип (цвет шрифта). */
     type?: EFontType;
     /** Наличие подчёркивания. */
     underline?: boolean;
@@ -5446,6 +5610,7 @@ export declare class KeyDownListener extends default_2.Component<IKeyDownListene
     render(): default_2.ReactNode;
 }
 
+/** Лайтбокс — полноэкранный диалог поверх страницы с контентом, кнопками управления и боковыми панелями. */
 export declare const LightBox: default_2.FC<ILightBoxProps> & {
     Content: default_2.FC<ILightBoxContentProps>;
     SideOverlay: default_2.ForwardRefExoticComponent<ILightBoxSideOverlayProps & default_2.RefAttributes<HTMLDivElement>> & {
@@ -5461,6 +5626,7 @@ export declare const LightBox: default_2.FC<ILightBoxProps> & {
 /** Кнопка закрытия лайтбокса. */
 declare const LightBoxClose: default_2.FC<ILightBoxCloseProps>;
 
+/** Идентификатор DOM-элемента, в который рендерится лайтбокс. При отсутствии элемента в DOM – создается в body. */
 export declare const lightBoxMountNodeIdDefault = "LightBox-next-mount-node";
 
 /** Стрелка лайтбокса "Вперёд". */
@@ -5475,6 +5641,7 @@ export declare const LightBoxSideOverlay: default_2.ForwardRefExoticComponent<IL
     CloseMobile: default_2.FC<ILightBoxSideOverlayCloseMobileProps>;
 };
 
+/** Идентификатор DOM-элемента, в визуальных границах (левая и правая координата) которого рендерится лайтбокс. */
 export declare const lightBoxViewManagerNodeIdDefault = "LightBox-next-view-manager-node";
 
 /** Гиперссылка. */
@@ -5827,7 +5994,7 @@ export declare type PolymorphicComponentPropsWithRef<T extends React.ElementType
 
 export declare type PolymorphicRef<T extends React.ElementType> = React.ComponentPropsWithRef<T>["ref"];
 
-/** Компонент портал, для рендера элемента во внешний DOM узел. */
+/** Портал для рендера содержимого во внешний DOM-узел (обёртка над ReactDOM.createPortal). */
 export declare const Portal: default_2.FC<IPortalProps>;
 
 export declare type PropsOf<T extends React.ElementType> = React.ComponentPropsWithoutRef<T>;
@@ -5842,9 +6009,10 @@ export declare const RadioXGroup: default_2.FC<IRadioXGroupProps>;
 export declare const RadioYGroup: default_2.FC<IRadioYGroupProps>;
 
 /**
- * Строка с нижним отступом, принимающая в children только колонки Col.
+ * Строка сетки с нижним отступом, предназначенная для использования с колонками Col в children.
+ * Передаёт размер отступа между колонками в Col через RowContext.
  */
-export declare const Row: default_2.FC<IRowProps>;
+export declare const Row: default_2.ForwardRefExoticComponent<IRowProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /**
  * Плавная прокрутка элемента по горизонтали.
@@ -6187,6 +6355,12 @@ export declare type TAriaHTMLAttributes = Record<string, string>;
 
 export declare type TAvatarBorderRadius = 6 | 8 | 10 | 12 | 16;
 
+/** Темы триггера, отображаемого как обычная кнопка (без dots-вариантов). */
+export declare type TButtonDropdownButtonTheme = EButtonTheme.GENERAL | EButtonTheme.SECONDARY | EButtonTheme.SECONDARY_LIGHT | EButtonTheme.DANGER;
+
+/** Тема триггера: обычная кнопка либо кнопка-dots. */
+export declare type TButtonDropdownTheme = TButtonDropdownButtonTheme | EButtonDotsTheme;
+
 export declare type TButtonHTMLAttributesWithData = default_2.ButtonHTMLAttributes<HTMLButtonElement> & TWithDataAttributes;
 
 /** Свойства компонента Button. */
@@ -6198,6 +6372,19 @@ export declare type TCalendarMarkedDays = string[] | Record<string, ECalendarDat
 /** Свойства компонента Caption. */
 export declare type TCaptionProps<T extends default_2.ElementType> = PolymorphicComponentPropsWithRef<T, ICaptionProps>;
 
+/** Свойства кнопки-индикатора. */
+export declare type TCarouselIndicatorProps = React.ButtonHTMLAttributes<HTMLButtonElement>;
+
+/** Функция для динамического формирования пропсов индикатора. */
+export declare type TCarouselIndicatorPropsFactory = (args: {
+    index: number;
+    page: number;
+    selected: boolean;
+}) => TCarouselIndicatorProps;
+
+/** Внутренний отступ компонента 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];
+
 /** Свойства компонента CodeText. */
 export declare type TCodeTextProps<T extends default_2.ElementType> = PolymorphicComponentPropsWithRef<T, ITypographyProps>;
 
@@ -6210,6 +6397,7 @@ export declare type TCollapsibleTreeNodeLabelProps = Omit<TTextProps<"span">, "t
     size?: ETextSize;
 };
 
+/** Ширина колонки в долях 12-колоночной сетки. */
 export declare type TColumnSize = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
 
 declare type TCreatePartialTokens<Type> = {
@@ -6236,7 +6424,7 @@ export declare type TDayHtmlAttributesFunction = (params: IDayHtmlAttributesFunc
 
 declare type TDesignTokens = TDesignTokensCore & TDesignTokensComponents;
 
-declare type TDesignTokensComponents = TDesignTokensComponentsAlertContext | TDesignTokensComponentsAlertProcess | TDesignTokensComponentsAvatar | TDesignTokensComponentsBadge | TDesignTokensComponentsButton | TDesignTokensComponentsCalendar | TDesignTokensComponentsCard | 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 | 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;
@@ -6294,6 +6482,14 @@ declare type TDesignTokensComponentsCardKeys = (typeof designTokensComponentsCar
 
 declare type TDesignTokensComponentsCardValue = Record<TDesignTokensComponentsCardKeys, TDesignTokenValue>;
 
+declare type TDesignTokensComponentsCarousel = {
+    Carousel: TDesignTokensComponentsCarouselValue;
+};
+
+declare type TDesignTokensComponentsCarouselKeys = (typeof designTokensComponentsCarouselKeys)[number];
+
+declare type TDesignTokensComponentsCarouselValue = Record<TDesignTokensComponentsCarouselKeys, TDesignTokenValue>;
+
 declare type TDesignTokensComponentsCheckbox = {
     Checkbox: TDesignTokensComponentsCheckboxValue;
 };
@@ -6898,6 +7094,7 @@ declare type TitleComponent_2 = (<T extends default_2.ElementType = "span">(prop
 /** Значение компонента MonthYearRange. */
 export declare type TMonthYearRangeValue = [string, string];
 
+/** Отступ колонки слева в долях 12-колоночной сетки. */
 export declare type TOffsetSize = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11;
 
 /** Всплывающая подсказка. */