@sberbusiness/triplex-next 1.26.0 → 1.27.0

package/components/index.js

@@ -27,7 +27,7 @@ import { CheckboxYGroup as bo } from "./Checkbox/CheckboxYGroup.js";
 import { CheckboxTree as Mo } from "./CheckboxTree/CheckboxTree.js";
 import { checkChildrenCheckboxes as ho, checkParentCheckboxes as Io, traverseCheckboxes as wo } from "./CheckboxTree/utils.js";
 import { CheckboxTreeExtended as Po } from "./CheckboxTreeExtended/CheckboxTreeExtended.js";
-import { C as Bo } from "../chunks/Chip-Di8g8Z6j.js";
+import { C as Bo } from "../chunks/Chip-BOBB8hDQ.js";
 import { ChipDatePicker as Wo } from "./Chip/ChipDatePicker/ChipDatePicker.js";
 import { ChipDatePickerTarget as vo } from "./Chip/ChipDatePicker/ChipDatePickerTarget.js";
 import { ChipClearButton as zo } from "./Chip/ChipClearButton.js";
@@ -56,7 +56,7 @@ import { DocumentNumberEdit as we } from "./DocumentNumberEdit/DocumentNumberEdi
 import { DropdownListContext as Pe } from "./Dropdown/DropdownListContext.js";
 import { DropdownDesktop as Be } from "./Dropdown/desktop/DropdownDesktop.js";
 import { DropdownList as We } from "./Dropdown/desktop/DropdownList.js";
-import { D as ve } from "../chunks/DropdownListItem-CjZLy9zZ.js";
+import { D as ve } from "../chunks/DropdownListItem-kVq_Shxy.js";
 import { EDropdownAlignment as ze, EDropdownDirection as Re, EDropdownWidth as Oe } from "./Dropdown/desktop/enums.js";
 import { DropdownMobile as Ve } from "./Dropdown/mobile/DropdownMobile.js";
 import { DropdownMobileBody as Ue } from "./Dropdown/mobile/DropdownMobileBody.js";
@@ -81,7 +81,7 @@ import { EFormFieldStatus as hr } from "./FormField/enums.js";
 import { FormFieldClear as wr } from "./FormField/components/FormFieldClear.js";
 import { FormFieldCounter as Pr } from "./FormField/components/FormFieldCounter.js";
 import { FormFieldDescription as Br } from "./FormField/components/FormFieldDescription.js";
-import { F as Wr } from "../chunks/FormFieldInput-C2TczHnQ.js";
+import { F as Wr } from "../chunks/FormFieldInput-DB9UpgIs.js";
 import { FormFieldLabel as vr } from "./FormField/components/FormFieldLabel.js";
 import { FormFieldMaskedInput as zr } from "./FormField/components/FormFieldMaskedInput.js";
 import { FormFieldPostfix as Or } from "./FormField/components/FormFieldPostfix.js";
@@ -131,7 +131,7 @@ import { AdvancedMouseSensor as Fp, AdvancedTouchSensor as bp, ListSortable as D
 import { ListItem as Lp } from "./List/components/ListItem.js";
 import { ListItemControls as Ip } from "./List/components/ListItemControls.js";
 import { ListItemContent as yp } from "./List/components/ListItemContent.js";
-import { L as kp } from "../chunks/ListItemControlsButton-DjUxcey4.js";
+import { L as kp } from "../chunks/ListItemControlsButton-27xRORri.js";
 import { ListItemControlsButtonDropdown as Ap } from "./List/components/ListItemControlsButtonDropdown.js";
 import { ListEmptyState as Hp } from "./List/components/ListEmptyState.js";
 import { ListItemLoading as Np } from "./List/components/ListItemLoading.js";
@@ -228,7 +228,7 @@ import { SuggestFieldDesktopDropdown as sa } from "./SuggestField/desktop/Sugges
 import { SuggestFieldDesktop as ga } from "./SuggestField/desktop/SuggestFieldDesktop.js";
 import { SuggestFieldMobile as Sa } from "./SuggestField/mobile/SuggestFieldMobile.js";
 import { SuggestFieldMobileDropdown as ca } from "./SuggestField/mobile/SuggestFieldMobileDropdown.js";
-import { S as Fa } from "../chunks/SuggestFieldMobileDropdownHint-BpAuE0ir.js";
+import { S as Fa } from "../chunks/SuggestFieldMobileDropdownHint-CSrNs8VF.js";
 import { SuggestField as Da } from "./SuggestField/SuggestField.js";
 import { SwipeableArea as La } from "./SwipeableArea/SwipeableArea.js";
 import { MasterTable as Ia } from "./Table/MasterTable.js";

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 & {
@@ -3851,6 +3859,8 @@ declare interface IMonthYearFieldProps extends Omit<IDatePickerExtendedProps, "p
     placeholder?: string;
     /** Функция, вызывающаяся при изменении значения. */
     onChange: (value: string) => void;
+    /** Обработчик очищения значения. */
+    onClear?: React.MouseEventHandler<HTMLButtonElement>;
     /** Свойства TextField. */
     targetProps?: ITextFieldProps;
 }
@@ -4659,6 +4669,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 +5556,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 +5591,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 +5632,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. */

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-BOBB8hDQ.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-kVq_Shxy.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-DB9UpgIs.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-27xRORri.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-CSrNs8VF.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.27.0",
   "description": "Библиотека компонентов дизайн-системы Triplex.",
   "license": "Sber Public License at-nc-sa v.2",
   "repository": {