@sberbusiness/triplex-next 1.39.0 → 1.40.0

package/components/index.js

@@ -30,7 +30,7 @@ import { checkChildrenCheckboxes, checkParentCheckboxes, traverseCheckboxes } fr
 import { CheckboxTreeExtended } from "./CheckboxTreeExtended/CheckboxTreeExtended.js";
 import { CheckboxTreeExtendedNode } from "./CheckboxTreeExtended/components/CheckboxTreeExtendedNode.js";
 import { EChipType } from "./Chip/enums.js";
-import { C } from "../chunks/Chip-C-q9erC6.js";
+import { C } from "../chunks/Chip-CI8ALCUS.js";
 import { ChipDatePicker } from "./Chip/ChipDatePicker/ChipDatePicker.js";
 import { ChipDatePickerTarget } from "./Chip/ChipDatePicker/ChipDatePickerTarget.js";
 import { ChipClearButton } from "./Chip/ChipClearButton.js";
@@ -66,7 +66,7 @@ import { DocumentNumberEdit } from "./DocumentNumberEdit/DocumentNumberEdit.js";
 import { DropdownListContext } from "./Dropdown/DropdownListContext.js";
 import { DropdownDesktop } from "./Dropdown/desktop/DropdownDesktop.js";
 import { DropdownList } from "./Dropdown/desktop/DropdownList.js";
-import { D } from "../chunks/DropdownListItem-CCY0qbiT.js";
+import { D } from "../chunks/DropdownListItem-BqOoPFSx.js";
 import { EDropdownAlignment, EDropdownDirection, EDropdownWidth } from "./Dropdown/desktop/enums.js";
 import { DropdownMobile } from "./Dropdown/mobile/DropdownMobile.js";
 import { DropdownMobileBody } from "./Dropdown/mobile/DropdownMobileBody.js";
@@ -121,7 +121,7 @@ import { ImageGalleryExtendedMain } from "./ImageGalleryExtended/components/Imag
 import { ImageGalleryExtendedNav } from "./ImageGalleryExtended/components/ImageGalleryExtendedNav.js";
 import { ImageGalleryExtendedArrow } from "./ImageGalleryExtended/components/ImageGalleryExtendedArrow.js";
 import { ImageGalleryExtendedThumbnails } from "./ImageGalleryExtended/components/ImageGalleryExtendedThumbnails.js";
-import { I } from "../chunks/ImageGalleryExtendedThumb-CWGYUoLd.js";
+import { I } from "../chunks/ImageGalleryExtendedThumb-D6RAJpt8.js";
 import { ImageGalleryExtendedDots } from "./ImageGalleryExtended/components/ImageGalleryExtendedDots.js";
 import { EImageGalleryArrowDirection } from "./ImageGalleryExtended/enums.js";
 import { Island } from "./Island/Island.js";
@@ -152,7 +152,7 @@ import { ListItem } from "./List/components/ListItem.js";
 import { ListItemControls } from "./List/components/ListItemControls.js";
 import { ListItemContent } from "./List/components/ListItemContent.js";
 import { ListActionItem } from "./List/components/ListActionItem.js";
-import { L } from "../chunks/ListItemControlsButton-DWsZ9wcF.js";
+import { L } from "../chunks/ListItemControlsButton-D2ONoqII.js";
 import { ListItemControlsButtonDropdown } from "./List/components/ListItemControlsButtonDropdown.js";
 import { ListEmptyState } from "./List/components/ListEmptyState.js";
 import { ListItemLoading } from "./List/components/ListItemLoading.js";
@@ -266,7 +266,7 @@ import { SuggestFieldDesktopDropdown } from "./SuggestField/desktop/SuggestField
 import { SuggestFieldDesktop } from "./SuggestField/desktop/SuggestFieldDesktop.js";
 import { SuggestFieldMobile } from "./SuggestField/mobile/SuggestFieldMobile.js";
 import { SuggestFieldMobileDropdown } from "./SuggestField/mobile/SuggestFieldMobileDropdown.js";
-import { S } from "../chunks/SuggestFieldMobileDropdownHint-gntyMsB0.js";
+import { S } from "../chunks/SuggestFieldMobileDropdownHint-DyfJuyUe.js";
 import { SuggestField } from "./SuggestField/SuggestField.js";
 import { SwipeableArea } from "./SwipeableArea/SwipeableArea.js";
 import { MasterTable } from "./Table/MasterTable.js";
@@ -323,7 +323,7 @@ import { Title } from "./Typography/Title.js";
 import { UnorderedList } from "./UnorderedList/UnorderedList.js";
 import { UnorderedListItem } from "./UnorderedList/UnorderedListItem.js";
 import { UploadZone } from "./UploadZone/UploadZone.js";
-import { U } from "../chunks/UploadZoneInput-D3aOVvsS.js";
+import { U } from "../chunks/UploadZoneInput-BHUONqVR.js";
 import { WindowResizeListener } from "./WindowResizeListener/WindowResizeListener.js";
 import "../enums/EComponentSize.js";
 import "../enums/EFocusSource.js";

package/index.d.ts

@@ -124,9 +124,18 @@ export declare const Button: default_2.ForwardRefExoticComponent<TButtonProps &
  */
 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>>;
 
 /** Вычисление позиции шага, относительно других. */
@@ -1226,22 +1235,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. */
@@ -2352,12 +2375,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;
 }
 
@@ -2373,15 +2395,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;
@@ -2435,10 +2457,15 @@ 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. */
@@ -3245,6 +3272,7 @@ export declare interface IDropdownDesktopProps extends default_2.HTMLAttributes<
 
 /** Композиция компонента DropdownList. */
 export declare interface IDropdownListComponent extends default_2.FC<IDropdownListProps> {
+    /** Элемент выпадающего списка. */
     Item: typeof DropdownListItem;
 }
 
@@ -3276,13 +3304,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;
 }
 
@@ -3315,8 +3343,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;
@@ -4732,7 +4763,9 @@ export declare interface IPaginationSelectProps extends Omit<ISelectFieldProps,
 
 /** Свойства компонента Portal. */
 export declare interface IPortalProps {
+    /** Содержимое, рендерящееся в container. */
     children: default_2.ReactNode;
+    /** DOM-узел, в который рендерится содержимое. */
     container: Element | DocumentFragment;
 }
 
@@ -6531,7 +6564,7 @@ export declare const PaginationPanel: default_2.FC<IPaginationPanelProps>;
 /** Выбор количества элементов на странице. */
 export declare const PaginationSelect: default_2.ForwardRefExoticComponent<IPaginationSelectProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Компонент портал, для рендера элемента во внешний DOM узел. */
+/** Портал для рендера содержимого во внешний DOM-узел (обёртка над ReactDOM.createPortal). */
 export declare const Portal: default_2.FC<IPortalProps>;
 
 /** Радио-кнопка с описанием. */

package/index.js

@@ -30,7 +30,7 @@ import { checkChildrenCheckboxes, checkParentCheckboxes, traverseCheckboxes } fr
 import { CheckboxTreeExtended } from "./components/CheckboxTreeExtended/CheckboxTreeExtended.js";
 import { CheckboxTreeExtendedNode } from "./components/CheckboxTreeExtended/components/CheckboxTreeExtendedNode.js";
 import { EChipType } from "./components/Chip/enums.js";
-import { C } from "./chunks/Chip-C-q9erC6.js";
+import { C } from "./chunks/Chip-CI8ALCUS.js";
 import { ChipDatePicker } from "./components/Chip/ChipDatePicker/ChipDatePicker.js";
 import { ChipDatePickerTarget } from "./components/Chip/ChipDatePicker/ChipDatePickerTarget.js";
 import { ChipClearButton } from "./components/Chip/ChipClearButton.js";
@@ -66,7 +66,7 @@ import { DocumentNumberEdit } from "./components/DocumentNumberEdit/DocumentNumb
 import { DropdownListContext } from "./components/Dropdown/DropdownListContext.js";
 import { DropdownDesktop } from "./components/Dropdown/desktop/DropdownDesktop.js";
 import { DropdownList } from "./components/Dropdown/desktop/DropdownList.js";
-import { D } from "./chunks/DropdownListItem-CCY0qbiT.js";
+import { D } from "./chunks/DropdownListItem-BqOoPFSx.js";
 import { EDropdownAlignment, EDropdownDirection, EDropdownWidth } from "./components/Dropdown/desktop/enums.js";
 import { DropdownMobile } from "./components/Dropdown/mobile/DropdownMobile.js";
 import { DropdownMobileBody } from "./components/Dropdown/mobile/DropdownMobileBody.js";
@@ -121,7 +121,7 @@ import { ImageGalleryExtendedMain } from "./components/ImageGalleryExtended/comp
 import { ImageGalleryExtendedNav } from "./components/ImageGalleryExtended/components/ImageGalleryExtendedNav.js";
 import { ImageGalleryExtendedArrow } from "./components/ImageGalleryExtended/components/ImageGalleryExtendedArrow.js";
 import { ImageGalleryExtendedThumbnails } from "./components/ImageGalleryExtended/components/ImageGalleryExtendedThumbnails.js";
-import { I } from "./chunks/ImageGalleryExtendedThumb-CWGYUoLd.js";
+import { I } from "./chunks/ImageGalleryExtendedThumb-D6RAJpt8.js";
 import { ImageGalleryExtendedDots } from "./components/ImageGalleryExtended/components/ImageGalleryExtendedDots.js";
 import { EImageGalleryArrowDirection } from "./components/ImageGalleryExtended/enums.js";
 import { Island } from "./components/Island/Island.js";
@@ -152,7 +152,7 @@ import { ListItem } from "./components/List/components/ListItem.js";
 import { ListItemControls } from "./components/List/components/ListItemControls.js";
 import { ListItemContent } from "./components/List/components/ListItemContent.js";
 import { ListActionItem } from "./components/List/components/ListActionItem.js";
-import { L } from "./chunks/ListItemControlsButton-DWsZ9wcF.js";
+import { L } from "./chunks/ListItemControlsButton-D2ONoqII.js";
 import { ListItemControlsButtonDropdown } from "./components/List/components/ListItemControlsButtonDropdown.js";
 import { ListEmptyState } from "./components/List/components/ListEmptyState.js";
 import { ListItemLoading } from "./components/List/components/ListItemLoading.js";
@@ -266,7 +266,7 @@ import { SuggestFieldDesktopDropdown } from "./components/SuggestField/desktop/S
 import { SuggestFieldDesktop } from "./components/SuggestField/desktop/SuggestFieldDesktop.js";
 import { SuggestFieldMobile } from "./components/SuggestField/mobile/SuggestFieldMobile.js";
 import { SuggestFieldMobileDropdown } from "./components/SuggestField/mobile/SuggestFieldMobileDropdown.js";
-import { S } from "./chunks/SuggestFieldMobileDropdownHint-gntyMsB0.js";
+import { S } from "./chunks/SuggestFieldMobileDropdownHint-DyfJuyUe.js";
 import { SuggestField } from "./components/SuggestField/SuggestField.js";
 import { SwipeableArea } from "./components/SwipeableArea/SwipeableArea.js";
 import { MasterTable } from "./components/Table/MasterTable.js";
@@ -323,7 +323,7 @@ import { Title } from "./components/Typography/Title.js";
 import { UnorderedList } from "./components/UnorderedList/UnorderedList.js";
 import { UnorderedListItem } from "./components/UnorderedList/UnorderedListItem.js";
 import { UploadZone } from "./components/UploadZone/UploadZone.js";
-import { U } from "./chunks/UploadZoneInput-D3aOVvsS.js";
+import { U } from "./chunks/UploadZoneInput-BHUONqVR.js";
 import { WindowResizeListener } from "./components/WindowResizeListener/WindowResizeListener.js";
 import { EComponentSize } from "./enums/EComponentSize.js";
 import { EFocusSource } from "./enums/EFocusSource.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sberbusiness/triplex-next",
-  "version": "1.39.0",
+  "version": "1.40.0",
   "description": "Библиотека компонентов дизайн-системы Triplex.",
   "license": "Sber Public License at-nc-sa v.2",
   "repository": {