@sberbusiness/triplex-next 1.26.0 → 1.28.0

package/index.d.ts

@@ -2791,10 +2791,16 @@ export declare interface IDateFieldProps extends Omit<IDatePickerExtendedProps,
     invalidDateHint: React.ReactNode;
     /** Функция, вызывающаяся при изменении значения. */
     onChange: (value: string) => void;
+    /** Обработчик очищения значения. */
+    onClear?: React.MouseEventHandler<HTMLButtonElement>;
     /** Свойства MaskedField. */
     targetProps?: DeepPartial<IMaskedFieldProps>;
 }
 
+/** Свойства компонента DateFieldTarget. */
+export declare interface IDateFieldTargetProps extends IMaskedFieldProps, Pick<IDateFieldProps, "onClear"> {
+}
+
 /**
  * Интерфейс на диапазон выбираемых дат.
  * @prop {Moment} [dateFrom] Дата начала периода.
@@ -3381,6 +3387,8 @@ export declare interface IIslandWidgetHeaderProps extends default_2.HTMLAttribut
 }
 
 export declare interface IIslandWidgetProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Размер компонента. */
+    size?: EComponentSize;
     /** Рендер-функция Body. */
     renderBody: (props: IIslandWidgetBodyProps) => default_2.ReactNode;
     /** Рендер-функция Footer. */
@@ -3534,6 +3542,10 @@ export declare interface ILinkCommonProps extends default_2.AnchorHTMLAttributes
     contentAfter?: () => default_2.ReactElement;
 }
 
+/** Свойства компонента ListEmptyState. */
+export declare interface IListEmptyStateProps extends default_2.HTMLAttributes<HTMLDivElement> {
+}
+
 declare interface IListItemContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
@@ -3541,16 +3553,13 @@ declare interface IListItemControlsButtonDropdownProps extends Omit<IButtonDropd
 }
 
 export declare interface IListItemControlsButtonProps extends default_2.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Иконка кнопки. Отображается над текстом, если переданы и иконка, и children. */
     icon?: default_2.ReactNode;
 }
 
 declare interface IListItemControlsProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
-/** Свойства компонента ListItemEmpty. */
-export declare interface IListItemEmptyProps extends default_2.HTMLAttributes<HTMLDivElement> {
-}
-
 /** Свойства компонента ListItemLoading. */
 export declare interface IListItemLoadingProps extends default_2.HTMLAttributes<HTMLDivElement> {
     children?: never;
@@ -3561,7 +3570,9 @@ export declare interface IListItemProps extends default_2.LiHTMLAttributes<HTMLL
 }
 
 export declare interface IListItemSelectableProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "onSelect"> {
+    /** Вызывается при изменении состояния чекбокса. */
     onSelect: (selected: boolean) => void;
+    /** Флаг состояния «выбран». Управляется снаружи. */
     selected: boolean;
 }
 
@@ -3597,14 +3608,8 @@ declare interface IListItemTailRightProps extends default_2.HTMLAttributes<HTMLD
 export declare interface IListMasterBodyProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
-export declare interface IListMasterFC extends default_2.FC<IListMasterProps> {
-    Body: typeof ListMasterBody;
-    ChipGroup: typeof ListMasterChipGroup;
-    Footer: typeof ListMasterFooter;
-    FooterControls: typeof ListMasterFooterControls;
-    FooterDescription: typeof ListMasterFooterDescription;
-    Header: typeof ListMasterHeader;
-    SelectionControls: typeof SelectionControls;
+/** Свойства компонента ListMasterChipGroup. */
+export declare interface IListMasterChipGroupProps extends default_2.HTMLAttributes<HTMLDivElement> {
 }
 
 /** Свойства компонента ListMasterFooterControls. */
@@ -3617,13 +3622,13 @@ export declare interface IListMasterFooterDescriptionProps extends default_2.HTM
 
 /** Свойства компонента ListMasterFooter. */
 export declare interface IListMasterFooterProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Элемент позиционируется как sticky. */
+    /** Sticky-позиционирование (`bottom: 0`). По умолчанию `true`. */
     sticky?: boolean;
 }
 
 /** Свойства компонента ListMasterHeader. */
 export declare interface IListMasterHeaderProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Элемент позиционируется как sticky. */
+    /** Sticky-позиционирование (`top: 0`, `z-index: 1`). По умолчанию `true`. */
     sticky?: boolean;
 }
 
@@ -3670,7 +3675,9 @@ export declare interface IListSortableItemTargetProps extends default_2.HTMLAttr
 export declare interface IListSortableProps<T extends {
     id: string;
 }> extends IListProps {
+    /** Текущий упорядоченный список элементов. У каждого элемента должен быть уникальный `id`. */
     items: T[];
+    /** Вызывается с новым порядком после успешного drag-and-drop. */
     onItemsChange: (items: T[]) => void;
 }
 
@@ -3705,6 +3712,7 @@ export declare interface IMarkerStatusProps extends default_2.HTMLAttributes<HTM
     size?: EComponentSize.MD | EComponentSize.LG;
 }
 
+/** Свойства компонента MaskedField. */
 export declare interface IMaskedFieldProps extends Omit<ITextFieldBaseProps, "children"> {
     /** Свойства поля ввода. */
     maskedInputProps: IFormFieldMaskedInputProps & {
@@ -3801,25 +3809,30 @@ declare interface IModalWindowCloseProps extends Omit<IButtonSecondaryProps, "si
 
 /** Свойства компонента ModalWindowContent. */
 declare interface IModalWindowContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Содержимое — `ModalWindowHeader`, `ModalWindowBody`, `ModalWindowFooter`. */
     children?: default_2.ReactNode;
-    /** Состояние загрузки.*/
+    /** Если `true`, поверх контента показывается `LoaderScreen`. */
     isLoading?: boolean;
-    /** Текст под спиннером.*/
+    /** Текст под спиннером в режиме загрузки. */
     loadingTitle?: default_2.ReactNode;
 }
 
 declare interface IModalWindowFooterProps extends Omit<IFooterPageTypeFirstProps, "children" | "type"> {
+    /** Содержимое футера. Обычно — `ModalWindowFooter.Description` с группой кнопок. */
     children?: default_2.ReactNode;
 }
 
+/** Тип компонента футера со статическим субкомпонентом `Description`. */
 declare interface IModalWindowFooterPropsFC extends default_2.FC<IModalWindowFooterProps> {
     Description: typeof FooterPage.Description;
 }
 
 declare interface IModalWindowHeaderProps extends Omit<IHeaderPageTypeFirstProps, "children" | "type"> {
+    /** Содержимое заголовка. Обычно — `ModalWindowHeader.Title` с заголовком и опциональной подсказкой. */
     children?: default_2.ReactNode;
 }
 
+/** Тип компонента заголовка со статическим субкомпонентом `Title`. */
 declare interface IModalWindowHeaderPropsFC extends default_2.FC<IModalWindowHeaderProps> {
     Title: typeof HeaderPage.Title;
 }
@@ -3828,6 +3841,7 @@ declare interface IModalWindowHeaderPropsFC extends default_2.FC<IModalWindowHea
 declare interface IModalWindowProps extends default_2.HTMLAttributes<HTMLDivElement> {
     /** Открыто ли модальное окно. */
     isOpen: boolean;
+    /** Содержимое модального окна. Обычно — `ModalWindowContent` с вложенными `ModalWindowHeader`, `ModalWindowBody`, `ModalWindowFooter`. */
     children: default_2.ReactElement;
     /** ClassName контейнера модального окна. */
     containerClassName?: string;
@@ -3835,11 +3849,11 @@ declare interface IModalWindowProps extends default_2.HTMLAttributes<HTMLDivElem
     focusTrapProps?: FocusTrapProps;
     /** Callback после анимации закрытия модального окна. */
     onExited?: () => void;
-    /** Кнопка закрыть. */
+    /** Кнопка закрыть. Обычно — `ModalWindowClose`. Рендерится внутри корневого dialog-элемента поверх контента. */
     closeButton: default_2.ReactNode;
-    /** Размер модального окна. */
+    /** Размер модального окна. По умолчанию `EComponentSize.MD`. */
     size?: EComponentSize;
-    /** Отступ сверху модального окна. */
+    /** Отступ сверху модального окна, px. По умолчанию `100`. */
     topPosition?: number;
 }
 
@@ -3851,6 +3865,8 @@ declare interface IMonthYearFieldProps extends Omit<IDatePickerExtendedProps, "p
     placeholder?: string;
     /** Функция, вызывающаяся при изменении значения. */
     onChange: (value: string) => void;
+    /** Обработчик очищения значения. */
+    onClear?: React.MouseEventHandler<HTMLButtonElement>;
     /** Свойства TextField. */
     targetProps?: ITextFieldProps;
 }
@@ -4659,6 +4675,8 @@ export declare interface IStepperStepProps extends default_2.LiHTMLAttributes<HT
 
 /** Свойства компонента Step. */
 export declare interface IStepProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Размер компонента. */
+    size?: EComponentSize;
     /** Номер шага для отображения в кружке. */
     step: number;
     /** Статус текущего шага. */
@@ -5544,7 +5562,7 @@ export declare const List: default_2.ForwardRefExoticComponent<IListProps & defa
  * Элемент, отображающий пустой список.
  * Используется при применении фильтров, когда не найден ни один элемент.
  * */
-export declare const ListEmptyState: default_2.ForwardRefExoticComponent<IListItemEmptyProps & default_2.RefAttributes<HTMLDivElement>>;
+export declare const ListEmptyState: default_2.ForwardRefExoticComponent<IListEmptyStateProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Элемент списка. */
 export declare const ListItem: default_2.ForwardRefExoticComponent<IListItemProps & default_2.RefAttributes<HTMLLIElement>>;
@@ -5579,14 +5597,37 @@ export declare const ListItemTailLeft: default_2.ForwardRefExoticComponent<IList
 /** Хвост listItem, видимый при свайпе влево. Размещается внутри компонента SwipeableArea. */
 export declare const ListItemTailRight: default_2.ForwardRefExoticComponent<IListItemTailRightProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Компонент, оборачивающий список и фильтры. */
-export declare const ListMaster: IListMasterFC;
+/**
+ * Compound-компонент, оборачивающий список и фильтры. Содержит набор
+ * статических подкомпонентов:
+ *
+ * - `ListMaster.Header` — sticky-шапка (обычно используется для selection controls)
+ * - `ListMaster.Body` — основная область со списком и фильтрами
+ * - `ListMaster.ChipGroup` — горизонтальная группа `Chip`-фильтров с одной строкой
+ * - `ListMaster.Footer` — sticky-футер (агрегаты + действия по выбранным элементам)
+ * - `ListMaster.FooterDescription` — текстовая часть футера (например, сумма выбранных)
+ * - `ListMaster.FooterControls` — кнопки в футере
+ * - `ListMaster.SelectionControls` — flex-контейнер
+ */
+export declare const ListMaster: default_2.ForwardRefExoticComponent<IListMasterProps & default_2.RefAttributes<HTMLDivElement>> & {
+    Body: default_2.ForwardRefExoticComponent<IListMasterBodyProps & default_2.RefAttributes<HTMLDivElement>>;
+    ChipGroup: default_2.ForwardRefExoticComponent<IListMasterChipGroupProps & default_2.RefAttributes<HTMLDivElement>>;
+    Footer: default_2.ForwardRefExoticComponent<IListMasterFooterProps & default_2.RefAttributes<HTMLDivElement>>;
+    FooterControls: default_2.ForwardRefExoticComponent<IListMasterFooterControlsProps & default_2.RefAttributes<HTMLDivElement>>;
+    FooterDescription: default_2.ForwardRefExoticComponent<IListMasterFooterDescriptionProps & default_2.RefAttributes<HTMLDivElement>>;
+    Header: default_2.ForwardRefExoticComponent<IListMasterHeaderProps & default_2.RefAttributes<HTMLDivElement>>;
+    SelectionControls: default_2.ForwardRefExoticComponent<ISelectionControlsProps & default_2.RefAttributes<HTMLDivElement>>;
+};
 
 /** Контент ListMaster. */
 export declare const ListMasterBody: default_2.ForwardRefExoticComponent<IListMasterBodyProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Обертка над Chips, добавляющая горизонтальные отступы контейнеру. */
-export declare const ListMasterChipGroup: default_2.ForwardRefExoticComponent<default_2.HTMLAttributes<HTMLDivElement> & default_2.RefAttributes<HTMLDivElement>>;
+/**
+ * Обёртка над `ChipGroup` с фиксированным `oneLine={true}` и горизонтальными
+ * отступами 16px — чтобы группа фильтров в ListMaster всегда помещалась в одну
+ * строку с горизонтальной прокруткой.
+ */
+export declare const ListMasterChipGroup: default_2.ForwardRefExoticComponent<IListMasterChipGroupProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Футер ListMaster. */
 export declare const ListMasterFooter: default_2.ForwardRefExoticComponent<IListMasterFooterProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -5597,7 +5638,11 @@ export declare const ListMasterFooterControls: default_2.ForwardRefExoticCompone
 /** Контейнер для текста в ListMasterFooter. */
 export declare const ListMasterFooterDescription: default_2.ForwardRefExoticComponent<IListMasterFooterDescriptionProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Хедер ListMaster. */
+/**
+ * Хедер ListMaster. При монтировании компенсирует свою высоту через `window.scrollTo`,
+ * чтобы появление selection-controls не сдвигало содержимое визуально вниз. При
+ * размонтировании — откатывает скролл.
+ */
 export declare const ListMasterHeader: default_2.ForwardRefExoticComponent<IListMasterHeaderProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Сортируемый список с поддержкой drag-and-drop. */
@@ -5666,8 +5711,18 @@ export declare const MediaWidth: default_2.FC<IMediaProps>;
  */
 export declare const MobileView: default_2.FC<IMobileViewProps>;
 
+/**
+ * Модальное окно. Рендерится через Portal поверх контента страницы, добавляет
+ * затемнённый backdrop, удерживает фокус внутри (FocusTrap) и блокирует скролл
+ * `body` через классы `modal-open` + `no-hash-overflow-hidden`.
+ */
 export declare const ModalWindow: default_2.ForwardRefExoticComponent<IModalWindowProps & default_2.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Тело модального окна. Обёртка над `Island` с фиксированными `type` и `size`,
+ * размечающая основной скроллируемый контент между `ModalWindowHeader` и
+ * `ModalWindowFooter`.
+ */
 export declare const ModalWindowBody: default_2.FC<IModalWindowBodyProps>;
 
 /**
@@ -5675,15 +5730,28 @@ export declare const ModalWindowBody: default_2.FC<IModalWindowBodyProps>;
  */
 export declare const ModalWindowClose: default_2.FC<IModalWindowCloseProps>;
 
-/** Компонент контента модального окна. */
-export declare const ModalWindowContent: default_2.FC<IModalWindowContentProps>;
+/**
+ * Контент модального окна. Оборачивает дочерние секции в `Page` и при
+ * `isLoading` показывает `LoaderScreen` поверх контента.
+ */
+export declare const ModalWindowContent: default_2.ForwardRefExoticComponent<IModalWindowContentProps & default_2.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Футер модального окна. Обёртка над `FooterPage` c фиксированным
+ * `type=FIRST`. Через статическое поле `Description` пробрасывает
+ * `FooterPage.Description` для размещения кнопок и подписей.
+ */
 export declare const ModalWindowFooter: IModalWindowFooterPropsFC;
 
+/**
+ * Заголовок модального окна. Обёртка над `HeaderPage` c фиксированным
+ * `type=FIRST` и доп. отступом справа под кнопку закрытия. Через статическое
+ * поле `Title` пробрасывает `HeaderPage.Title`.
+ */
 export declare const ModalWindowHeader: IModalWindowHeaderPropsFC;
 
 /** Элемент, определяющий позиционирование ModalWindow. */
-export declare const ModalWindowViewManager: default_2.FC;
+export declare const ModalWindowViewManager: default_2.ForwardRefExoticComponent<default_2.RefAttributes<HTMLDivElement>>;
 
 /** Количество месяцев года. */
 export declare const MONTHS_SET: number[];

package/index.js

@@ -27,7 +27,7 @@ import { CheckboxYGroup as po } from "./components/Checkbox/CheckboxYGroup.js";
 import { CheckboxTree as xo } from "./components/CheckboxTree/CheckboxTree.js";
 import { checkChildrenCheckboxes as ao, checkParentCheckboxes as fo, traverseCheckboxes as no } from "./components/CheckboxTree/utils.js";
 import { CheckboxTreeExtended as so } from "./components/CheckboxTreeExtended/CheckboxTreeExtended.js";
-import { C as Eo } from "./chunks/Chip-Di8g8Z6j.js";
+import { C as Eo } from "./chunks/Chip-BQ_gYzxq.js";
 import { ChipDatePicker as go } from "./components/Chip/ChipDatePicker/ChipDatePicker.js";
 import { ChipDatePickerTarget as co } from "./components/Chip/ChipDatePicker/ChipDatePickerTarget.js";
 import { ChipClearButton as Do } from "./components/Chip/ChipClearButton.js";
@@ -56,7 +56,7 @@ import { DocumentNumberEdit as de } from "./components/DocumentNumberEdit/Docume
 import { DropdownListContext as se } from "./components/Dropdown/DropdownListContext.js";
 import { DropdownDesktop as Ee } from "./components/Dropdown/desktop/DropdownDesktop.js";
 import { DropdownList as ge } from "./components/Dropdown/desktop/DropdownList.js";
-import { D as ce } from "./chunks/DropdownListItem-CjZLy9zZ.js";
+import { D as ce } from "./chunks/DropdownListItem-CVJjluxY.js";
 import { EDropdownAlignment as De, EDropdownDirection as be, EDropdownWidth as Fe } from "./components/Dropdown/desktop/enums.js";
 import { DropdownMobile as he } from "./components/Dropdown/mobile/DropdownMobile.js";
 import { DropdownMobileBody as Ie } from "./components/Dropdown/mobile/DropdownMobileBody.js";
@@ -81,7 +81,7 @@ import { EFormFieldStatus as fr } from "./components/FormField/enums.js";
 import { FormFieldClear as dr } from "./components/FormField/components/FormFieldClear.js";
 import { FormFieldCounter as sr } from "./components/FormField/components/FormFieldCounter.js";
 import { FormFieldDescription as Er } from "./components/FormField/components/FormFieldDescription.js";
-import { F as gr } from "./chunks/FormFieldInput-C2TczHnQ.js";
+import { F as gr } from "./chunks/FormFieldInput-BTVRGCId.js";
 import { FormFieldLabel as cr } from "./components/FormField/components/FormFieldLabel.js";
 import { FormFieldMaskedInput as Dr } from "./components/FormField/components/FormFieldMaskedInput.js";
 import { FormFieldPostfix as Fr } from "./components/FormField/components/FormFieldPostfix.js";
@@ -131,7 +131,7 @@ import { AdvancedMouseSensor as pp, AdvancedTouchSensor as mp, ListSortable as x
 import { ListItem as ap } from "./components/List/components/ListItem.js";
 import { ListItemControls as np } from "./components/List/components/ListItemControls.js";
 import { ListItemContent as lp } from "./components/List/components/ListItemContent.js";
-import { L as Tp } from "./chunks/ListItemControlsButton-DjUxcey4.js";
+import { L as Tp } from "./chunks/ListItemControlsButton-_-tEvYQM.js";
 import { ListItemControlsButtonDropdown as Sp } from "./components/List/components/ListItemControlsButtonDropdown.js";
 import { ListEmptyState as Cp } from "./components/List/components/ListEmptyState.js";
 import { ListItemLoading as up } from "./components/List/components/ListItemLoading.js";
@@ -228,7 +228,7 @@ import { SuggestFieldDesktopDropdown as qi } from "./components/SuggestField/des
 import { SuggestFieldDesktop as Qi } from "./components/SuggestField/desktop/SuggestFieldDesktop.js";
 import { SuggestFieldMobile as oa } from "./components/SuggestField/mobile/SuggestFieldMobile.js";
 import { SuggestFieldMobileDropdown as ra } from "./components/SuggestField/mobile/SuggestFieldMobileDropdown.js";
-import { S as pa } from "./chunks/SuggestFieldMobileDropdownHint-BpAuE0ir.js";
+import { S as pa } from "./chunks/SuggestFieldMobileDropdownHint-Dj6gWOOm.js";
 import { SuggestField as xa } from "./components/SuggestField/SuggestField.js";
 import { SwipeableArea as aa } from "./components/SwipeableArea/SwipeableArea.js";
 import { MasterTable as na } from "./components/Table/MasterTable.js";

package/package.json

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