@sberbusiness/triplex-next 1.29.0 → 1.30.0

package/index.d.ts

@@ -818,7 +818,7 @@ export declare const CheckboxTree: default_2.FC<ICheckboxTreeProps>;
 
 /**
  * Декларативное дерево чекбоксов.
- * Является оберткой над CollapsableTree.
+ * Является оберткой над CollapsibleTreeExtended.
  */
 export declare const CheckboxTreeExtended: ICheckboxTreeExtendedSFC;
 
@@ -830,7 +830,7 @@ declare const CheckboxTreeExtendedCheckbox: default_2.FC<ICheckboxTreeExtendedCh
 
 /**
  * Нода CheckboxTreeExtendedNode.
- * Является оберткой CollapsableTree.Node.
+ * Является оберткой CollapsibleTreeExtended.Node.
  * Добавляет стили дерева чекбоксов.
  */
 export declare const CheckboxTreeExtendedNode: default_2.FC<ICheckboxTreeExtendedNodeProps>;
@@ -913,33 +913,79 @@ export declare const CodeText: default_2.ForwardRefExoticComponent<(Omit<ITypogr
 export declare const Col: default_2.FC<IColProps>;
 
 /**
- * Дерево, ноды которого могут сворачиваться/разворачиваться.
- * Является оберткой TreeView.
+ * Готовое дерево с раскрывающимися ветками. Принимает данные узлов (`nodes`) и рендерит дерево с типовым UI:
+ * заголовок ветки с шевроном-индикатором раскрытия, hover и focus-visible на интерактивной строке.
+ *
+ * Узлы описываются двумя типами:
+ * - {@link ICollapsibleTreeNodeBranch} — ветка с `label`, может содержать дочерние узлы (ветки и листья);
+ * - {@link ICollapsibleTreeNodeLeaf} — лист с произвольным `content`, не раскрывается и не имеет шеврона.
+ *
+ * Используй этот компонент в большинстве случаев — он закрывает типовой UI дерева. Если требуется нестандартный
+ * header (своя иконка раскрытия, кастомное поведение клика, нестандартная разметка) — используй низкоуровневый
+ * {@link CollapsibleTreeExtended}.
+ *
+ * @see CollapsibleTreeExtended — декларативная база с произвольным `renderHeader`/`renderBody`.
+ */
+export declare const CollapsibleTree: default_2.FC<ICollapsibleTreeProps>;
+
+/**
+ * Низкоуровневое декларативное дерево с раскрывающимися узлами. Обёртка над TreeView, добавляющая accordion-логику
+ * (анимация раскрытия, контролируемое/неконтролируемое состояние) для каждого узла.
+ *
+ * Каждый узел рендерится через `CollapsibleTreeExtended.Node` с двумя render-функциями:
+ * - `renderHeader` — видимая часть узла (любая разметка: кнопка с шевроном, текст, иконка-toggle и т.п.);
+ * - `renderBody` — раскрываемое содержимое (обычно дочерние узлы, но может быть любым контентом).
+ *
+ * Используй этот компонент, когда нужен нестандартный UI узла: своя иконка раскрытия, кастомный header, нестандартное
+ * поведение клика. Для типового UI (готовый шеврон, hover, focus-visible) используй обёртку {@link CollapsibleTree}.
+ *
+ * @see CollapsibleTree — готовая обёртка с типовым UI узла.
  */
-export declare const CollapsableTree: ICollapsableTreeSFC;
+export declare const CollapsibleTreeExtended: ICollapsibleTreeExtendedSFC;
 
 /**
- * Нода дерева CollapsableTree.
+ * Нода дерева CollapsibleTreeExtended.
  * Является оберткой TreeView.Node.
  * Сворачиваться/разворачиваться может только если есть дочерние ноды. Они передаются в renderBody.
+ *
+ * Поддерживает controlled и uncontrolled режим:
+ * - если `opened` передан (`!== undefined`) — нода контролируемая, состояние раскрытия читается из props,
+ *   а toggle делегируется в `props.toggle`;
+ * - если `opened === undefined` — нода неконтролируемая, состояние раскрытия хранит TreeView через `setOpenedNode`.
+ *
+ * Режим вычисляется на каждом рендере, поэтому переход controlled ↔ uncontrolled во время жизни ноды поддерживается.
  */
-export declare class CollapsableTreeNode extends default_2.Component<ICollapsableTreeNodeProps, ICollapsableTreeNodeState> {
+export declare class CollapsibleTreeExtendedNode extends default_2.Component<ICollapsibleTreeExtendedNodeProps> {
     static displayName: string;
-    state: {
-        controlled: boolean;
-    };
     render(): JSX.Element;
     /**
-     * Изменяет состояние ноды - раскрыта/свернута.
+     * Изменяет состояние ноды — раскрыта/свернута.
+     * В controlled-режиме делегирует в `props.toggle`, в uncontrolled — переключает внутреннее состояние TreeView.
      * Эта функция передается дочерним компонентам и вызывается из них.
      */
     private toggle;
-    /** Render-функция для передачи дочерних нод. */
+    /** Рендер-функция для передачи дочерних нод. */
     private renderBody;
-    /** Render-функция не сворачиваемой части ноды. */
+    /** Рендер-функция не сворачиваемой части ноды. */
     private renderHeader;
 }
 
+/**
+ * Заголовок ноды CollapsibleTree.
+ * Рендерит кнопку с шевроном-индикатором раскрытия для нод с детьми
+ * и неактивную кнопку без шеврона для леаф-нод. Типографику заголовка задавай
+ * через {@link CollapsibleTreeNodeLabel} в `children`.
+ */
+export declare const CollapsibleTreeNodeHeader: default_2.ForwardRefExoticComponent<ICollapsibleTreeNodeHeaderProps & default_2.RefAttributes<HTMLButtonElement>>;
+
+/**
+ * Лейбл ноды CollapsibleTree.
+ * Обёртка над {@link Text} с дефолтами `size=B1` и `weight=SEMIBOLD`.
+ * Используй как `label` в {@link ICollapsibleTreeNodeBranch} или внутри `CollapsibleTreeNodeHeader`,
+ * когда нужно переопределить размер/толщину шрифта (например, в кастомном `renderHeader` у `CollapsibleTreeExtended`).
+ */
+export declare const CollapsibleTreeNodeLabel: default_2.ForwardRefExoticComponent<Omit<TCollapsibleTreeNodeLabelProps, "ref"> & default_2.RefAttributes<HTMLSpanElement>>;
+
 /** Компонент, для настройки видимости колонок. */
 export declare const ColumnSettings: default_2.ForwardRefExoticComponent<IColumnSettingsProps & default_2.RefAttributes<HTMLDivElement>> & {
     SortableList: default_2.ForwardRefExoticComponent<IColumnSettingsSortableListProps & default_2.RefAttributes<HTMLUListElement>> & {
@@ -1030,6 +1076,8 @@ declare const designTokensComponentsCheckboxKeys: readonly ["Background_Default"
 
 declare const designTokensComponentsChipKeys: readonly ["Background_Active", "Background_Default", "Background_Disabled", "Background_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"];
 
+declare const designTokensComponentsCollapsibleTreeKeys: readonly ["Header_Background_Hover", "Header_Shadow_Focus"];
+
 declare const designTokensComponentsDividerKeys: readonly ["Background"];
 
 declare const designTokensComponentsDropdownKeys: readonly ["Background", "Shadow"];
@@ -1058,7 +1106,7 @@ declare const designTokensComponentsLinkKeys: readonly ["BorderColor_Focus", "Te
 
 declare const designTokensComponentsListItemControlsButtonKeys: readonly ["Background_Active", "Background_Default", "Background_Hover", "Color_Active", "Color_Default", "Color_Hover"];
 
-declare const designTokensComponentsListItemKeys: readonly ["Background", "Background_Dragging", "Background_Selected", "Shadow_Dragging"];
+declare const designTokensComponentsListItemKeys: readonly ["Background", "Background_Dragging", "Background_Selected", "Background_Hover", "Shadow_Dragging"];
 
 declare const designTokensComponentsListMasterKeys: readonly ["Background", "Footer_Background", "Footer_Shadow", "Header_Background", "Header_Shadow"];
 
@@ -2009,7 +2057,7 @@ declare interface IAccordionBaseProps {
     isOpen?: boolean;
     onToggle?: (isOpen: boolean) => void;
     renderBody: (props: IAccordionBodyProvideProps) => default_2.ReactNode;
-    renderHeader: (props: IAccordionHeaderProvideProps) => JSX.Element;
+    renderHeader: (props: IAccordionHeaderProvideProps) => default_2.ReactNode;
     toggle?: (isOpen: boolean) => void;
 }
 
@@ -2542,14 +2590,14 @@ export declare interface ICheckboxTreeExtendedCheckboxProvideProps {
 }
 
 /** Свойства CheckboxTreeExtendedNode. */
-declare interface ICheckboxTreeExtendedNodeProps extends Omit<ICollapsableTreeNodeProps, "children" | "renderBody" | "renderHeader"> {
+declare interface ICheckboxTreeExtendedNodeProps extends Omit<ICollapsibleTreeExtendedNodeProps, "children" | "renderBody" | "renderHeader"> {
     checkbox: (props: ICheckboxTreeExtendedCheckboxProvideProps) => JSX.Element;
     children?: default_2.ReactNode;
     id: string;
 }
 
 /** Свойства CheckboxTreeExtended. */
-export declare interface ICheckboxTreeExtendedProps extends ICollapsableTreeProps {
+export declare interface ICheckboxTreeExtendedProps extends ICollapsibleTreeExtendedProps {
     /** Размер дерева чекбоксов. */
     size?: EComponentSize;
 }
@@ -2688,61 +2736,68 @@ export declare interface IChipSuggestTargetProps<T extends ISuggestOption> exten
     clearSelected?: () => void;
 }
 
-/**
- * Свойства, передаваемые CollapsableTreeNode в рендер-функцию renderBody.
- *
- * activeNode - Текущая нода является активной при перемещении с клавиатуры.
- * animating - В текущий момент происходит анимация открытия/закрытия.
- * hasChildNodes - Текущая нода имеет дочерние ноды.
- */
-export declare interface ICollapsableTreeNodeBodyProvideProps extends Pick<IAccordionBodyProvideProps, "animating">, Pick<ITreeViewNodeProvideProps, "activeNode" | "hasChildNodes"> {
+/** Свойства, передаваемые CollapsibleTreeExtendedNode в рендер-функцию renderBody. */
+export declare interface ICollapsibleTreeExtendedNodeBodyProvideProps extends Pick<IAccordionBodyProvideProps, "animating">, Pick<ITreeViewNodeProvideProps, "activeNode" | "hasChildNodes"> {
+    /** Текущая нода раскрыта. */
     opened: boolean;
+    /** Функция смены значения opened. */
     toggle: (opened: boolean) => void;
 }
 
-/**
- * Свойства, передаваемые CollapsableTreeNode в рендер-функцию renderHeader.
- *
- * activeNode - Текущая нода является активной при перемещении с клавиатуры.
- * animating - В текущий момент происходит анимация открытия/закрытия.
- * hasChildNodes - Текущая нода имеет дочерние ноды.
- * isLastNode - Текущая нода является последней в дереве.
- */
-export declare interface ICollapsableTreeNodeHeaderProvideProps extends Pick<IAccordionHeaderProvideProps, "animating">, Pick<ITreeViewNodeProvideProps, "activeNode" | "hasChildNodes" | "isLastNode"> {
+/** Свойства, передаваемые CollapsibleTreeExtendedNode в рендер-функцию renderHeader. */
+export declare interface ICollapsibleTreeExtendedNodeHeaderProvideProps extends Pick<IAccordionHeaderProvideProps, "animating">, Pick<ITreeViewNodeProvideProps, "activeNode" | "hasChildNodes" | "isLastNode"> {
+    /** Текущая нода раскрыта. */
     opened: boolean;
+    /** Функция смены значения opened. */
     toggle: (opened: boolean) => void;
 }
 
-/**
- * Свойства CollapsableTreeNode.
- *
- * toggle - Функция смены значения opened.
- * onToggle - Функция, вызываемая после окончания анимации открытия/закрытия.
- */
-export declare interface ICollapsableTreeNodeProps extends Omit<ITreeViewNodeProps, "children">, Pick<IAccordionBaseProps, "onToggle" | "toggle"> {
+/** Свойства CollapsibleTreeExtendedNode. */
+export declare interface ICollapsibleTreeExtendedNodeProps extends Omit<ITreeViewNodeProps, "children">, Pick<IAccordionBaseProps, "onToggle" | "toggle"> {
     children?: never;
-    renderBody: (props: ICollapsableTreeNodeBodyProvideProps) => default_2.ReactNode;
-    renderHeader: (props: ICollapsableTreeNodeHeaderProvideProps) => JSX.Element;
+    /** Рендер-функция раскрываемого содержимого ноды (обычно дочерние ноды). */
+    renderBody: (props: ICollapsibleTreeExtendedNodeBodyProvideProps) => default_2.ReactNode;
+    /** Рендер-функция видимой (не сворачиваемой) части ноды. */
+    renderHeader: (props: ICollapsibleTreeExtendedNodeHeaderProvideProps) => default_2.ReactNode;
 }
 
-/**
- * Состояние CollapsableTreeNode.
- *
- * @param {boolean} controlled - Флаг, означающий, что состояние opened передается снаружи.
- */
-declare interface ICollapsableTreeNodeState {
-    controlled: boolean;
+/** Свойства CollapsibleTreeExtended. */
+export declare interface ICollapsibleTreeExtendedProps extends ITreeViewProps {
 }
 
-/**
- * Свойства CollapsableTree.
- *
- */
-export declare interface ICollapsableTreeProps extends ITreeViewProps {
+export declare interface ICollapsibleTreeExtendedSFC extends default_2.FC<ICollapsibleTreeExtendedProps> {
+    Node: typeof CollapsibleTreeExtendedNode;
+}
+
+/** Ветка дерева CollapsibleTree — раскрывающийся узел с заголовком и дочерними узлами. */
+export declare interface ICollapsibleTreeNodeBranch {
+    /** Уникальный идентификатор узла в дереве. */
+    id: string;
+    /** Содержимое заголовка ветки. Для типовой типографики оборачивай в `CollapsibleTreeNodeLabel`. */
+    label: default_2.ReactNode;
+    /** Начальное состояние раскрытия ветки. */
+    defaultOpened?: boolean;
+    /** Дочерние узлы — другие ветки или листья. Если массив пуст или не передан — ветка отображается без шеврона и не раскрывается. */
+    children?: TCollapsibleTreeNode[];
+}
+
+/** Свойства CollapsibleTreeNodeHeader. */
+export declare interface ICollapsibleTreeNodeHeaderProps extends ICollapsibleTreeExtendedNodeHeaderProvideProps, default_2.ButtonHTMLAttributes<HTMLButtonElement> {
 }
 
-export declare interface ICollapsableTreeSFC extends default_2.FC<ICollapsableTreeProps> {
-    Node: typeof CollapsableTreeNode;
+/** Лист дерева CollapsibleTree — конечный узел с произвольным контентом, не раскрывается. */
+export declare interface ICollapsibleTreeNodeLeaf {
+    /** Уникальный идентификатор узла в дереве. */
+    id: string;
+    /** Произвольный контент листа. */
+    content: default_2.ReactNode;
+}
+
+/** Свойства CollapsibleTree. */
+export declare interface ICollapsibleTreeProps extends Omit<ICollapsibleTreeExtendedProps, "children"> {
+    children?: never;
+    /** Дерево узлов. На верхнем уровне допустимы только ветки; листья — внутри children ветки. */
+    nodes: ICollapsibleTreeNodeBranch[];
 }
 
 /** Свойства Col. */
@@ -3651,6 +3706,7 @@ export declare interface IListItemSelectableProps extends Omit<default_2.HTMLAtt
     onSelect: (selected: boolean) => void;
     /** Флаг состояния «выбран». Управляется снаружи. */
     selected: boolean;
+    disabled?: boolean;
 }
 
 declare interface IListItemTableProps extends Omit<IListItemProps, "onSelect"> {
@@ -4282,6 +4338,9 @@ export declare interface IRowProps extends default_2.HTMLAttributes<HTMLDivEleme
     paddingBottom?: boolean;
 }
 
+/** Type guard: проверяет, что узел — лист. */
+export declare const isCollapsibleTreeNodeLeaf: (node: TCollapsibleTreeNode) => node is ICollapsibleTreeNodeLeaf;
+
 /** Общие свойства компонента SegmentedControl. */
 export declare interface ISegmentedControlCommonProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onSelect"> {
     /** Визуальный стиль сегментов. */
@@ -6433,6 +6492,15 @@ export declare type TCaptionProps<T extends keyof JSX.IntrinsicElements> = {
 /** Свойства компонента CodeText. */
 export declare type TCodeTextProps<T extends keyof JSX.IntrinsicElements> = ITypographyProps & JSX.IntrinsicElements[T];
 
+/** Узел дерева CollapsibleTree — ветка или лист. */
+export declare type TCollapsibleTreeNode = ICollapsibleTreeNodeBranch | ICollapsibleTreeNodeLeaf;
+
+/** Свойства CollapsibleTreeNodeLabel. */
+export declare type TCollapsibleTreeNodeLabelProps = Omit<TTextProps<"span">, "tag" | "size"> & {
+    /** Размер текста. По умолчанию `B1`. */
+    size?: ETextSize;
+};
+
 export declare type TColumnSize = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
 
 declare type TCreatePartialTokens<Type> = {
@@ -6459,7 +6527,7 @@ export declare type TDayHtmlAttributesFunction = (params: IDayHtmlAttributesFunc
 
 declare type TDesignTokens = TDesignTokensCore & TDesignTokensComponents;
 
-declare type TDesignTokensComponents = TDesignTokensComponentsAlertContext | TDesignTokensComponentsAlertProcess | TDesignTokensComponentsAvatar | TDesignTokensComponentsBadge | TDesignTokensComponentsButton | TDesignTokensComponentsCalendar | TDesignTokensComponentsCard | TDesignTokensComponentsCheckbox | TDesignTokensComponentsChip | TDesignTokensComponentsDivider | TDesignTokensComponentsDropdown | TDesignTokensComponentsDropdownList | TDesignTokensComponentsDropdownMobile | TDesignTokensComponentsDropdownMobileList | TDesignTokensComponentsFooterPage | TDesignTokensComponentsFormField | TDesignTokensComponentsHeaderPage | TDesignTokensComponentsIsland | TDesignTokensComponentsIslandAccordion | TDesignTokensComponentsIslandWidget | 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 | TDesignTokensComponentsCheckbox | TDesignTokensComponentsChip | TDesignTokensComponentsCollapsibleTree | TDesignTokensComponentsDivider | TDesignTokensComponentsDropdown | TDesignTokensComponentsDropdownList | TDesignTokensComponentsDropdownMobile | TDesignTokensComponentsDropdownMobileList | TDesignTokensComponentsFooterPage | TDesignTokensComponentsFormField | TDesignTokensComponentsHeaderPage | TDesignTokensComponentsIsland | TDesignTokensComponentsIslandAccordion | TDesignTokensComponentsIslandWidget | 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;
@@ -6533,6 +6601,14 @@ declare type TDesignTokensComponentsChipKeys = (typeof designTokensComponentsChi
 
 declare type TDesignTokensComponentsChipValue = Record<TDesignTokensComponentsChipKeys, TDesignTokenValue>;
 
+declare type TDesignTokensComponentsCollapsibleTree = {
+    CollapsibleTree: TDesignTokensComponentsCollapsibleTreeValue;
+};
+
+declare type TDesignTokensComponentsCollapsibleTreeKeys = (typeof designTokensComponentsCollapsibleTreeKeys)[number];
+
+declare type TDesignTokensComponentsCollapsibleTreeValue = Record<TDesignTokensComponentsCollapsibleTreeKeys, TDesignTokenValue>;
+
 declare type TDesignTokensComponentsDivider = {
     Divider: TDesignTokensComponentsDividerValue;
 };