@sberbusiness/triplex-next 0.43.0 → 0.44.0

package/index.d.ts

@@ -499,9 +499,19 @@ export declare const DateField: default_2.ForwardRefExoticComponent<IDateFieldPr
 /** Транспортный (backend) формат даты. */
 export declare const dateFormatYYYYMMDD = "YYYYMMDD";
 
-/** База для компонента DatePicker. */
+/**
+ * База для компонентов выбора даты (DateField, MonthYearField, ChipDatePicker).
+ * Рендерит переданный целевым элемент и выпадающий Calendar, хранит состояние открытости
+ * дропдауна и отдаёт его целевому элементу через DatePickerExtendedContext.
+ */
 export declare const DatePickerExtended: default_2.ForwardRefExoticComponent<IDatePickerExtendedProps & default_2.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Контекст компонента DatePickerExtended.
+ * Через него целевой элемент (renderTarget) управляет открытостью выпадающего календаря.
+ */
+export declare const DatePickerExtendedContext: default_2.Context<IDatePickerExtendedContext>;
+
 /** Выбор диапазона дат. */
 export declare const DateRange: default_2.FC<IDateRangeProps>;
 
@@ -592,7 +602,7 @@ declare const designTokensComponentsSegmentedControlKeys: readonly ["General_1_B
 
 declare const designTokensComponentsSegmentedControlSegmentKeys: readonly ["General_1_Color_Default", "General_1_Color_Hover", "General_1_Color_Disabled", "General_1_Color_Selected_Default", "General_1_Color_Selected_Hover", "General_1_Color_Selected_Disabled", "General_1_Background_Default", "General_1_Background_Hover", "General_1_Background_Disabled", "General_1_Background_Selected_Default", "General_1_Background_Selected_Hover", "General_1_Background_Selected_Disabled", "General_2_Color_Default", "General_2_Color_Hover", "General_2_Color_Disabled", "General_2_Color_Selected_Default", "General_2_Color_Selected_Hover", "General_2_Color_Selected_Disabled", "General_2_Background_Default", "General_2_Background_Hover", "General_2_Background_Disabled", "General_2_Background_Selected_Default", "General_2_Background_Selected_Hover", "General_2_Background_Selected_Disabled", "Secondary_1_Color_Default", "Secondary_1_Color_Hover", "Secondary_1_Color_Disabled", "Secondary_1_Color_Selected_Default", "Secondary_1_Color_Selected_Hover", "Secondary_1_Color_Selected_Disabled", "Secondary_1_Background_Default", "Secondary_1_Background_Hover", "Secondary_1_Background_Disabled", "Secondary_1_Background_Selected_Default", "Secondary_1_Background_Selected_Hover", "Secondary_1_Background_Selected_Disabled", "Secondary_2_Color_Default", "Secondary_2_Color_Hover", "Secondary_2_Color_Disabled", "Secondary_2_Color_Selected_Default", "Secondary_2_Color_Selected_Hover", "Secondary_2_Color_Selected_Disabled", "Secondary_2_Background_Default", "Secondary_2_Background_Hover", "Secondary_2_Background_Disabled", "Secondary_2_Background_Selected_Default", "Secondary_2_Background_Selected_Hover", "Secondary_2_Background_Selected_Disabled", "BorderColor_Default", "BorderColor_Focus"];
 
-declare const designTokensComponentsSkeletonKeys: readonly ["BackgroundColor_Light_Start", "BackgroundColor_Light_End", "BackgroundColor_Dark_Start", "BackgroundColor_Dark_End"];
+declare const designTokensComponentsSkeletonKeys: readonly ["BackgroundColor_Type1_Start", "BackgroundColor_Type1_End", "BackgroundColor_Type2_Start", "BackgroundColor_Type2_End", "BackgroundColor_Type3_Start", "BackgroundColor_Type3_End"];
 
 declare const designTokensComponentsSliderKeys: readonly ["Dot_Background_Default", "Dot_Background_Disabled", "Dot_Background_Hover", "Dot_Background_Select", "Dot_Focus", "Dot_Inner_Background", "Dot_Inner_Background_Disabled", "Mark_Dot_Background_Default", "Mark_Dot_Background_Selected", "Mark_Dot_Background_Selected_Disabled", "Rail_Background", "Rail_Background_Disabled", "Tooltip_Background", "Tooltip_Color", "Track_Background_Default", "Track_Background_Disabled", "Track_Background_Hover"];
 
@@ -755,7 +765,9 @@ export declare enum EBodyPageVerticalMargin {
     /** Большие вертикальные отступы: 24px (16px на узких экранах). Значение по умолчанию. */
     LARGE = "large",
     /** Маленькие вертикальные отступы: 16px (8px на узких экранах). Используется в LightBox. */
-    SMALL = "small"
+    SMALL = "small",
+    /** Без вертикальных отступов: 0. */
+    NONE = "none"
 }
 
 /** Темы кнопки dots. */
@@ -1109,9 +1121,11 @@ export declare enum ESegmentedControlType {
     MULTIPLE = "multiple"
 }
 
+/** Типы компонента Skeleton. */
 export declare enum ESkeletonType {
-    DARK = "dark",
-    LIGHT = "light"
+    TYPE_1 = "type_1",
+    TYPE_2 = "type_2",
+    TYPE_3 = "type_3"
 }
 
 /** Тип компонента статус-трекера. */
@@ -1402,7 +1416,7 @@ export declare const FilterPanel: default_2.FC<IFilterPanelProps>;
 
 export declare const FocusTrapUtils: IFocusTrapUtils;
 
-/** Футер. */
+/** Футер. Контейнер нижнего блока с контентом и управляющими элементами. */
 export declare const Footer: default_2.ForwardRefExoticComponent<IFooterProps & default_2.RefAttributes<HTMLDivElement>> & {
     Description: default_2.ForwardRefExoticComponent<IFooterDescriptionProps & default_2.RefAttributes<HTMLDivElement>> & {
         Content: default_2.ForwardRefExoticComponent<IFooterDescriptionContentProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -1410,7 +1424,7 @@ export declare const Footer: default_2.ForwardRefExoticComponent<IFooterProps &
     };
 };
 
-/** Футер, основная часть. */
+/** Футер, основная часть. Раскладывает контент и кнопки действий в строку. */
 export declare const FooterDescription: default_2.ForwardRefExoticComponent<IFooterDescriptionProps & default_2.RefAttributes<HTMLDivElement>> & {
     Content: default_2.ForwardRefExoticComponent<IFooterDescriptionContentProps & default_2.RefAttributes<HTMLDivElement>>;
     Controls: default_2.ForwardRefExoticComponent<IFooterDescriptionControlsProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -1815,9 +1829,10 @@ export declare interface IBodyPageTypeFirstProps extends IBodyProps {
     size?: EComponentSize;
     /**
      * Вертикальные отступы (сверху и снизу).
-     * По умолчанию LARGE (24px); в LightBox следует использовать SMALL (16px).
+     * Одно значение задаёт обе стороны, объект `{top, bottom}` — каждую отдельно.
+     * LARGE — 24px, SMALL — 16px, NONE — 0; в LightBox следует использовать SMALL.
      */
-    verticalMargin?: EBodyPageVerticalMargin;
+    verticalMargin?: TBodyPageVerticalMargin;
 }
 
 export declare interface IBodyPageTypeSecondProps extends IBodyProps {
@@ -1829,9 +1844,18 @@ export declare interface IBodyPageTypeSecondProps extends IBodyProps {
     size?: never;
     /**
      * Вертикальные отступы (сверху и снизу).
-     * По умолчанию LARGE (24px); в LightBox следует использовать SMALL (16px).
+     * Одно значение задаёт обе стороны, объект `{top, bottom}` — каждую отдельно.
+     * LARGE — 24px, SMALL — 16px, NONE — 0; в LightBox следует использовать SMALL.
      */
-    verticalMargin?: EBodyPageVerticalMargin;
+    verticalMargin?: TBodyPageVerticalMargin;
+}
+
+/** Вертикальные отступы BodyPage, заданные раздельно сверху и снизу. Обе стороны указываются явно. */
+export declare interface IBodyPageVerticalMarginSides {
+    /** Отступ сверху. */
+    top: EBodyPageVerticalMargin;
+    /** Отступ снизу. */
+    bottom: EBodyPageVerticalMargin;
 }
 
 /** Свойства компонента Body. */
@@ -2698,9 +2722,22 @@ export declare interface IDateLimitRange {
     dateTo?: Moment;
 }
 
-/** Свойства компонента DatePickerExtended. */
-export declare interface IDatePickerExtendedProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "onChange">, Pick<IDropdownProps, "alignment">, ICalendarProps {
-    /** Ссылка на целевой элемент для Dropdown. */
+/** Свойства контекста компонента DatePickerExtended. */
+export declare interface IDatePickerExtendedContext {
+    /** Выпадающий календарь открыт. */
+    dropdownOpen: boolean;
+    /** Флаг взаимодействия пользователя мышью. Управляет поведением FocusTrap выпадающего календаря. */
+    mouseUsedRef: default_2.MutableRefObject<boolean>;
+    /** Открывает и закрывает выпадающий календарь. */
+    setDropdownOpen: (open: boolean) => void;
+}
+
+/**
+ * Свойства компонента DatePickerExtended.
+ * adaptiveMode исключён из props календаря: адаптивный режим компонент определяет сам по версии дропдауна.
+ */
+export declare interface IDatePickerExtendedProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "onChange">, Pick<IDropdownProps, "alignment">, Omit<ICalendarProps, "adaptiveMode"> {
+    /** Ссылка на целевой элемент для Dropdown. По умолчанию — корневой элемент компонента. */
     dropdownTargetRef?: default_2.RefObject<HTMLElement>;
     /** Рендер-функция целевого элемента. */
     renderTarget: () => default_2.ReactNode;
@@ -2949,13 +2986,13 @@ export declare interface IEmptyViewProps extends Omit<default_2.HTMLAttributes<H
 
 /** Свойства компонента ExpandAnimation. */
 export declare interface IExpandAnimationProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Время анимации (мс). */
+    /** Время анимации (мс). По умолчанию 300. */
     animationTime?: number;
     /** Развёрнут ли компонент. */
     expanded: boolean;
-    /** Коллбэк на начало анимации. */
+    /** Коллбэк на начало анимации. Вызывается и при разворачивании, и при сворачивании. */
     onStart?: () => void;
-    /** Коллбэк на окончание анимации. */
+    /** Коллбэк на окончание анимации. Вызывается и при разворачивании, и при сворачивании. */
     onEnd?: () => void;
     /** Свойства компонента Transition (react-transition-group). */
     transitionProps?: default_2.ComponentProps<typeof Transition<HTMLDivElement>>;
@@ -2978,6 +3015,8 @@ declare interface IFocusTrapUtils {
 
 /** Свойства компонента FooterDescriptionContent. */
 export declare interface IFooterDescriptionContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Контент основной части футера — текст, ссылки, произвольная разметка. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента FooterDescriptionControls. */
@@ -2986,6 +3025,8 @@ export declare interface IFooterDescriptionControlsProps extends default_2.HTMLA
 
 /** Свойства компонента FooterDescription. */
 export declare interface IFooterDescriptionProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Контент основной части футера: Footer.Description.Content и Footer.Description.Controls. */
+    children?: default_2.ReactNode;
 }
 
 export declare interface IFooterPageTypeFirstProps extends IFooterProps {
@@ -3012,6 +3053,8 @@ export declare interface IFooterPageTypeSecondProps extends IFooterProps {
 
 /** Свойства компонента Footer. */
 export declare interface IFooterProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Контент футера. Обычно составной Footer.Description. */
+    children?: default_2.ReactNode;
 }
 
 /** Свойства компонента FormFieldClear. */
@@ -3418,6 +3461,8 @@ export declare interface IIslandProps extends default_2.HTMLAttributes<HTMLDivEl
     loading?: boolean;
     /** Свойства компонента LoaderScreen. */
     loaderScreenProps?: ILoaderScreenMiddleProps;
+    /** Свойство, отключающее внутренние отступы. */
+    withoutPaddings?: boolean;
 }
 
 /** Свойства компонента IslandWidgetBody. */
@@ -4547,7 +4592,7 @@ export declare interface ISelectionControlsProps extends default_2.HTMLAttribute
 
 export declare interface ISkeletonProps extends default_2.HTMLAttributes<HTMLDivElement> {
     /**
-     * Тип скелетона - темный или светлый.
+     * Тип скелетона. По умолчанию ESkeletonType.TYPE_2.
      */
     type?: ESkeletonType;
 }
@@ -5134,25 +5179,25 @@ export declare interface ISwipeableAreaRef {
 
 /** Интерфейс колонки. */
 export declare interface ITableBasicColumn {
-    /** По какому столбцу производить сортировку. */
+    /** Ключ поля в rowData, значение которого выводится в ячейках этого столбца. */
     fieldKey: string;
     /** Контент заголовка столбца. */
     label?: string | default_2.ReactNode;
     /** Заголовок столбца при наведении указателя. */
     title?: string;
-    /** Порядок сортировки. */
+    /** Текущее направление сортировки. Наличие значения включает кнопку сортировки, если передан onOrderBy. */
     orderDirection?: EOrderDirection;
-    /** Горизонтальное выравнивание. */
+    /** Горизонтальное выравнивание. По умолчанию EHorizontalAlign.LEFT. */
     horizontalAlign?: EHorizontalAlign;
-    /** Вертикальное выравнивание. */
+    /** Вертикальное выравнивание. По умолчанию BASELINE для ECellType.TEXT и TOP для остальных типов. */
     verticalAlign?: EVerticalAlign;
-    /** Тип ячейки. */
+    /** Тип ячейки, задаёт внутренние отступы и обёртку контента. По умолчанию ECellType.TEXT. */
     cellType?: ECellType;
     /** Ширина колонки (включая боковые внутренние отступы), пример значений 10|'10%'. */
     width?: string | number;
     /** Столбец скрыт. */
     hidden?: boolean;
-    /** Функция рендера ячейки. */
+    /** Функция рендера ячейки. Получает значение поля fieldKey из rowData текущей строки. */
     renderCell?: (param: any) => default_2.ReactNode;
     /** Data-атрибуты. */
     dataAttributes?: TDataHTMLAttributes;
@@ -5166,6 +5211,7 @@ export declare interface ITableBasicExtendedColumn extends ITableBasicColumn {
     id: string;
 }
 
+/** Свойства компонента TableBasic. Остальные HTML-атрибуты попадают на элемент table. */
 export declare interface ITableBasicProps extends default_2.HTMLAttributes<HTMLTableElement> {
     /** Структура заголовков таблицы. */
     columns: ITableBasicColumn[];
@@ -5175,32 +5221,32 @@ export declare interface ITableBasicProps extends default_2.HTMLAttributes<HTMLT
     renderNoData: () => default_2.ReactNode;
     /**
      * Функция рендера при скрытии пользователем всех колонок в таблице.
-     * Вызывается, когда каждый элемент columns имеет свойство hidden.
+     * Вызывается вместо таблицы, когда каждый элемент columns имеет свойство hidden.
      * */
     renderNoColumns?: () => default_2.ReactNode;
-    /** Подсветка строк при наведении мышки. */
+    /** Подсветка строк при наведении мышки. По умолчанию false; при заданном onClickRow подсветка включена всегда. */
     highlightRowOnHover?: boolean;
-    /** Обработчик сортировки. */
+    /** Обработчик сортировки. Вызывается со следующим направлением сортировки по циклу none → asc → desc → none. */
     onOrderBy?: (order: ISortOrder) => void;
-    /** Функция обработки клика по строке таблицы. */
+    /** Функция обработки клика по строке таблицы. Получает rowKey строки. */
     onClickRow?: (rowKey: string) => void;
-    /** Скрытие шапки. */
+    /** Скрытие шапки таблицы. По умолчанию false. */
     headless?: boolean;
 }
 
 /** Интерфейс данных для строки. */
 export declare interface ITableBasicRow {
-    /** Идентификатор сортировки. */
+    /** Уникальный ключ строки. Передаётся в onClickRow и используется как React-key. */
     rowKey: string;
-    /** Данные строки в виде объекта. */
+    /** Данные строки в виде объекта: ключ — fieldKey колонки, значение — содержимое ячейки. */
     rowData: any;
-    /** Информация об объединенных ячейках в виде объекта. */
+    /** Информация об объединенных ячейках в виде объекта. Ключ — fieldKey колонки. */
     rowLayout?: Record<string, ITableRowCellSpanProps>;
     /** Выбрана ли строка для массового действия. */
     selected?: boolean;
-    /** Aria-атрибуты. */
+    /** Data-атрибуты строки. */
     dataAttributes?: TDataHTMLAttributes;
-    /** Data-атрибуты. */
+    /** Aria-атрибуты строки. */
     ariaAttributes?: TAriaHTMLAttributes;
 }
 
@@ -5446,19 +5492,28 @@ export declare interface ITagGroupProps extends React.HTMLAttributes<HTMLDivElem
 
 /** Свойства компонента Tag. */
 export declare interface ITagProps extends React.HTMLAttributes<HTMLSpanElement> {
-    /** Уникальный идентификатор. */
+    /** Содержимое тега — выбранное значение параметра. Длинный текст обрезается многоточием. */
+    children?: React.ReactNode;
+    /**
+     * Уникальный идентификатор тега. Рендерится атрибутом id на корневом элементе и передаётся
+     * аргументом в onEdit и onRemove, чтобы потребитель понял, какой тег группы изменили.
+     * Значение должно быть уникальным в пределах документа — как у любого DOM-идентификатора.
+     */
     id: string;
-    /** Размер. */
+    /** Размер. Влияет на высоту тега, размер текста и размер иконок в кнопках. */
     size: EComponentSize;
-    /** Отключенное состояние. */
+    /**
+     * Отключенное состояние: текст приглушается, обе кнопки блокируются. По умолчанию false.
+     * Собственный disabled в editButtonProps или removeButtonProps перекрывает это значение.
+     */
     disabled?: boolean;
-    /** Колбэк-функция при редактировании. */
+    /** Колбэк-функция при редактировании. Получает id тега. Кнопка редактирования рендерится, только если колбэк передан. */
     onEdit?: (id: string) => void;
-    /** Колбэк-функция при удалении. */
+    /** Колбэк-функция при удалении. Получает id тега. Кнопка удаления рендерится всегда. */
     onRemove?: (id: string) => void;
-    /** Дополнительные свойства для кнопки редактирования. */
+    /** Дополнительные свойства для кнопки редактирования. Здесь потребитель задаёт aria-label. */
     editButtonProps?: IButtonIconProps;
-    /** Дополнительные свойства для кнопки удаления. */
+    /** Дополнительные свойства для кнопки удаления. Здесь потребитель задаёт aria-label. */
     removeButtonProps?: IButtonIconProps;
 }
 
@@ -5694,31 +5749,33 @@ export declare interface ITooltipYCoordinates {
 }
 
 /** Свойства компонента TopOverlay. */
-export declare interface ITopOverlayProps extends Pick<IOverlayProps, "opened" | "onOpen" | "onClose"> {
+export declare interface ITopOverlayProps extends Pick<IOverlayProps, "opened" | "onOpen" | "onClose">, Omit<default_2.HTMLAttributes<HTMLDivElement>, "children" | "onClose"> {
+    /** Содержимое верхней панели. */
     children?: default_2.ReactNode;
     /** Свойства компонента FocusTrapExtended. */
     focusTrapProps?: IFocusTrapExtendedProps;
 }
 
-/**
- * Контекст TreeView.
- *
- * @param {number} updateCount - Число обновлений абстрактного дерева. Используется для индикации изменения дерева т.к. изменение мутируемого объекта rootNode не вызывает триггер изменения контекста.
- * @param {TTreeViewContextGetNode} getNode - Возвращает TreeViewAbstractNode по id.
- * @param {TreeViewAbstractNode} parentNode - Родительская TreeViewAbstractNode.
- * @param {TreeViewAbstractNode | null} rootNode - Рутовая нода абстрактного дерева.
- * @param {TTreeViewContextRegisterNode} registerNode - Добавляет TreeViewAbstractNode в AbstractTree. AbstractTree также является AbstractNode.
- * @param {TTreeViewContextSetActiveNode} setActiveNode - Устанавливает флаг активности AbstractNode.
- * @param {TTreeViewContextSetOpenedNode} setOpenedNode - Устанавливает флаг раскрытости AbstractNode.
- */
+/** Контекст TreeView. */
 declare interface ITreeViewContext {
+    /**
+     * Число обновлений абстрактного дерева.
+     * Используется для индикации изменения дерева т.к. изменение мутируемого объекта rootNode не вызывает триггер изменения контекста.
+     */
     updateCount: number;
+    /** Возвращает TreeViewAbstractNode по id. */
     getNode: TTreeViewContextGetNode;
+    /** Родительская TreeViewAbstractNode. Каждая нода переопределяет ее для своих детей. */
     parentNode: TreeViewAbstractNode;
+    /** Рутовая нода абстрактного дерева. */
     rootNode: TreeViewAbstractNode | null;
+    /** Добавляет TreeViewAbstractNode в AbstractTree. AbstractTree также является AbstractNode. */
     registerNode: TTreeViewContextRegisterNode;
+    /** Удаляет TreeViewAbstractNode из AbstractTree. */
     removeNode: TTreeViewContextRemoveNode;
+    /** Устанавливает флаг активности AbstractNode. */
     setActiveNode: TTreeViewContextSetActiveNode;
+    /** Устанавливает флаг раскрытости AbstractNode. */
     setOpenedNode: TTreeViewContextSetOpenedNode;
 }
 
@@ -5730,19 +5787,19 @@ export declare interface ITreeViewGroupProps extends default_2.HTMLAttributes<HT
 export declare interface ITreeViewNodeProps extends Omit<default_2.HTMLAttributes<HTMLElement>, "children"> {
     /** Render-функция дочерних элементов. */
     children: (props: ITreeViewNodeProvideProps) => JSX.Element;
-    /** Идентификатор ноды.   */
+    /** Идентификатор ноды. Должен быть уникальным в пределах дерева. */
     id: string;
-    /** Состояние ноды - свернута/раскрыта. */
+    /** Состояние ноды - свернута/раскрыта. По умолчанию false. */
     opened?: boolean;
-    /** Идентификатор следующей ноды. */
+    /** Идентификатор следующей ноды. Задает позицию ноды в дереве при вставке между уже зарегистрированными нодами. */
     nextNodeId?: string;
-    /** Идентификатор предыдущей ноды. */
+    /** Идентификатор предыдущей ноды. Задает позицию ноды в дереве при вставке между уже зарегистрированными нодами. */
     prevNodeId?: string;
 }
 
 /**
  * Свойства TreeViewNodeWithContext.
- * iTreeViewNodeProps - передаются родительским компонентам.
+ * ITreeViewNodeProps - передаются родительским компонентам.
  * IWithTreeViewContextProps - добавляются из withTreeViewContext.
  */
 export declare interface ITreeViewNodePropsWithContext extends ITreeViewNodeProps, IWithTreeViewContextProps {
@@ -5764,6 +5821,7 @@ export declare interface ITreeViewNodeProvideProps {
 
 /** Свойства TreeView. */
 export declare interface ITreeViewProps extends default_2.HTMLAttributes<HTMLUListElement> {
+    /** Ноды дерева — TreeView.Node (напрямую или через компоненты-обёртки над ним). */
     children: default_2.ReactNode;
 }
 
@@ -5771,7 +5829,7 @@ export declare interface ITreeViewProps extends default_2.HTMLAttributes<HTMLULi
 declare interface ITreeViewState {
     /**
      * Число обновлений абстрактного дерева.
-     * Используется для индикации изменения дереве т.к. изменение мутируемого объекта rootNode не вызывает триггер изменения контекста.
+     * Используется для индикации изменения дерева т.к. изменение мутируемого объекта rootNode не вызывает триггер изменения контекста.
      */
     updateCount: number;
 }
@@ -5865,10 +5923,9 @@ export declare interface IWindowResizeListenerProps {
     throttleDelay?: number;
 }
 
-/**
- * Свойства контекста, добавляемые WithTreeViewContext.
- */
+/** Свойства контекста, добавляемые withTreeViewContext. */
 declare interface IWithTreeViewContextProps {
+    /** Контекст TreeView. Подставляется HOC-ом withTreeViewContext, снаружи передавать не нужно. */
     treeViewContext: ITreeViewContext;
 }
 
@@ -5891,7 +5948,7 @@ export declare const LightBox: default_2.FC<ILightBoxProps> & {
         CloseDesktop: default_2.FC<ILightBoxSideOverlayCloseDesktopProps>;
         CloseMobile: default_2.FC<ILightBoxSideOverlayCloseMobileProps>;
     };
-    TopOverlay: default_2.FC<ITopOverlayProps>;
+    TopOverlay: default_2.ForwardRefExoticComponent<ITopOverlayProps & default_2.RefAttributes<HTMLDivElement>>;
     Controls: ILightBoxControlsFC;
     LeftSidebar: default_2.ForwardRefExoticComponent<ILightBoxLeftSidebarProps & default_2.RefAttributes<HTMLDivElement>>;
     RightSidebar: default_2.ForwardRefExoticComponent<ILightBoxRightSidebarProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -6530,11 +6587,14 @@ export declare const SuggestFieldMobileDropdownHint: default_2.FC<ISuggestFieldM
  */
 export declare const SwipeableArea: default_2.ForwardRefExoticComponent<ISwipeableAreaProps & default_2.RefAttributes<ISwipeableAreaRef>>;
 
-/** Компонент обычной таблицы. */
-export declare const TableBasic: {
-    ({ columns, data, highlightRowOnHover, onOrderBy, onClickRow, renderNoColumns, renderNoData, headless, ...htmlTableAttributes }: ITableBasicProps): JSX.Element;
-    displayName: string;
-};
+/**
+ * Компонент обычной таблицы.
+ * Состояние загрузки и общий для таблицы набор колонок берутся из контекста MasterTable.
+ * Ref пробрасывается на элемент table — туда же, куда попадают остальные HTML-атрибуты.
+ * Если все колонки скрыты и задан renderNoColumns, вместо таблицы рендерится заглушка,
+ * и ref остаётся пустым — элемента table в этот момент нет.
+ */
+export declare const TableBasic: default_2.ForwardRefExoticComponent<ITableBasicProps & default_2.RefAttributes<HTMLTableElement>>;
 
 /** Компонент панели под элементы фильтрации данных для таблицы. */
 export declare const TableBasicSettings: ITableBasicSettingsFC;
@@ -6622,7 +6682,13 @@ export declare const TabsLineItem: default_2.ForwardRefExoticComponent<ITabsLine
 /** Компонент TabsLineMobile. */
 export declare const TabsLineMobile: default_2.FC<ITabsLineMobileProps>;
 
-/** Компонент, который демонстрирует выбранное значение того или иного параметра. */
+/**
+ * Компонент, который демонстрирует выбранное значение того или иного параметра.
+ *
+ * Кнопка удаления рендерится всегда, кнопка редактирования — только когда передан `onEdit`.
+ * Обе кнопки — `ButtonIcon` без текста, поэтому `aria-label` задаёт потребитель
+ * через `removeButtonProps` и `editButtonProps`.
+ */
 export declare const Tag: default_2.ForwardRefExoticComponent<ITagProps & default_2.RefAttributes<HTMLSpanElement>>;
 
 /** Компонент, который используется для маркировки и классификации. */
@@ -6639,6 +6705,9 @@ export declare type TAriaHTMLAttributes = Record<string, string>;
 
 export declare type TAvatarBorderRadius = 6 | 8 | 10 | 12 | 16;
 
+/** Вертикальные отступы BodyPage: одно значение на обе стороны либо раздельные значения для верха и низа. */
+export declare type TBodyPageVerticalMargin = EBodyPageVerticalMargin | IBodyPageVerticalMarginSides;
+
 /** Темы триггера, отображаемого как обычная кнопка (без dots-вариантов). */
 export declare type TButtonDropdownButtonTheme = EButtonTheme.GENERAL | EButtonTheme.SECONDARY | EButtonTheme.SECONDARY_LIGHT | EButtonTheme.DANGER;
 
@@ -7421,7 +7490,11 @@ declare const TooltipTarget: default_2.FC<ITooltipTargetProps>;
 /** Кнопка закрытия Tooltip. */
 declare const TooltipXButton: default_2.FC<ITooltipXButtonProps>;
 
-export declare const TopOverlay: default_2.FC<ITopOverlayProps>;
+/**
+ * Верхняя панель поверх контента LightBox: затемняющая маска на всю ширину экрана и выезжающая сверху панель.
+ * Открытием управляет свойство `opened`, на время открытия фокус удерживается внутри панели.
+ */
+export declare const TopOverlay: default_2.ForwardRefExoticComponent<ITopOverlayProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Приведенный к Moment тип даты, используемый для внутренних вычислений. */
 export declare type TPickedDate = Moment | null;
@@ -7445,13 +7518,18 @@ export declare const traverseCheckboxes: (checkboxes: ICheckboxTreeCheckboxData[
 export declare class TreeView extends default_2.Component<ITreeViewProps, ITreeViewState> {
     static displayName: string;
     static Node: default_2.ComponentType<Omit<ITreeViewNodePropsWithContext, "treeViewContext">>;
-    static Group: default_2.FC<ITreeViewGroupProps>;
+    static Group: default_2.ForwardRefExoticComponent<ITreeViewGroupProps & default_2.RefAttributes<HTMLUListElement>>;
     private readonly abstractRootNode;
-    private treeNode;
+    /** Глобальный слушатель keydown подписан. Он нужен только пока в дереве есть активная нода. */
+    private keyDownListenerAttached;
     constructor(props: ITreeViewProps);
-    componentDidMount(): void;
     componentWillUnmount(): void;
     render(): JSX.Element;
+    /**
+     * Увеличивает счетчик обновлений абстрактного дерева.
+     * Значение попадает в контекст и сигнализирует дочерним нодам, что мутируемое дерево изменилось.
+     */
+    private incrementUpdateCount;
     /**
      * Обработка изменения контекста.
      * Установка tabIndex={0} для первой ноды, и tabIndex={-1} для остальных.
@@ -7463,11 +7541,17 @@ export declare class TreeView extends default_2.Component<ITreeViewProps, ITreeV
     private removeNode;
     /** Установка флага активности ноды. */
     private setActiveNode;
+    /**
+     * Подписывает и отписывает глобальный слушатель keydown по наличию активной ноды.
+     * Пока активной ноды нет, дерево не обрабатывает стрелки и не отменяет скролл страницы.
+     */
+    private syncKeyDownListener;
+    /** Отписывает глобальный слушатель keydown. */
+    private detachKeyDownListener;
     /** Установка флага opened ноды. */
     private setOpenedNode;
     /** Возвращает AbstractNode по id. */
     private getNode;
-    private setTreeDOMNode;
     /** Обработка нажатия на клавиш для навигации с клавиатуры. */
     private handleKeyDown;
 }
@@ -7501,8 +7585,8 @@ declare class TreeViewAbstractNode extends AbstractTreeNode<TreeViewAbstractNode
     setOpened: (opened: boolean) => void;
 }
 
-/** Обертка для вложенных TreeNode. */
-export declare const TreeViewGroup: default_2.FC<ITreeViewGroupProps>;
+/** Обертка для вложенных TreeViewNode. Задает семантику группы дочерних нод (role="group"). */
+export declare const TreeViewGroup: default_2.ForwardRefExoticComponent<ITreeViewGroupProps & default_2.RefAttributes<HTMLUListElement>>;
 
 export declare const TreeViewNode: default_2.ComponentType<Omit<ITreeViewNodePropsWithContext, "treeViewContext">>;
 
@@ -7513,7 +7597,8 @@ export declare const TreeViewNode: default_2.ComponentType<Omit<ITreeViewNodePro
  * Обрабатывает события focus/blur для дальнейшего перемещения с клавиатуры по дереву.
  */
 export declare class TreeViewNodeWithContext extends default_2.Component<ITreeViewNodePropsWithContext> {
-    private containerDOMNode?;
+    static displayName: string;
+    /** Абстрактная нода текущей ViewNode. */
     private readonly abstractNode;
     constructor(props: ITreeViewNodePropsWithContext);
     componentDidUpdate(prevProps: ITreeViewNodePropsWithContext): void;
@@ -7529,8 +7614,7 @@ export declare class TreeViewNodeWithContext extends default_2.Component<ITreeVi
      * При всплытии фокуса до контейнера ноды - ноды становится активной.
      */
     private handleFocus;
-    private setContainerDOMNode;
-    /** Устанавливает флаг opened ноды. */
+    /** Устанавливает флаг opened ноды. Передается в render-функцию children. */
     private setOpenedNode;
 }
 
@@ -7575,29 +7659,19 @@ export declare type TTooltipAxesCoordinates = ITooltipXCoordinates | ITooltipYCo
 /** Тип взаимодействия с тултипом. */
 export declare type TTooltipToggleType = "click" | "hover";
 
-/**
- * Возвращаем AbstractNode по id.
- */
+/** Возвращает AbstractNode по id. */
 declare type TTreeViewContextGetNode = (nodeId: string) => TreeViewAbstractNode | undefined;
 
-/**
- * Добавляем AbstractNode в AbstractTree. AbstractTree является AbstractNode.
- */
+/** Добавляет AbstractNode в AbstractTree. AbstractTree является AbstractNode. */
 declare type TTreeViewContextRegisterNode = (node: TreeViewAbstractNode, parentNode: TreeViewAbstractNode, prevNode?: TreeViewAbstractNode, nextNode?: TreeViewAbstractNode) => void;
 
-/**
- * Удаляет AbstractNode из AbstractTree.
- */
+/** Удаляет AbstractNode из AbstractTree. */
 declare type TTreeViewContextRemoveNode = (node: TreeViewAbstractNode) => void;
 
-/**
- * Устанавливает флаг активности AbstractNode.
- */
+/** Устанавливает флаг активности AbstractNode. */
 declare type TTreeViewContextSetActiveNode = (node: TreeViewAbstractNode, active: boolean) => void;
 
-/**
- * Устанавливает флаг opened AbstractNode.
- */
+/** Устанавливает флаг opened AbstractNode. */
 declare type TTreeViewContextSetOpenedNode = (node: TreeViewAbstractNode, opened: boolean) => void;
 
 /** Произвольные data-атрибуты. */