@sberbusiness/triplex-next 0.26.0 → 0.27.0

package/index.d.ts

@@ -2193,10 +2193,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] Дата начала периода.
@@ -2783,6 +2789,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. */
@@ -2936,6 +2944,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> {
 }
 
@@ -2943,16 +2955,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;
@@ -2963,7 +2972,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;
 }
 
@@ -2999,14 +3010,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. */
@@ -3019,13 +3024,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;
 }
 
@@ -3072,7 +3077,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;
 }
 
@@ -3107,6 +3114,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 & {
@@ -3253,6 +3261,8 @@ declare interface IMonthYearFieldProps extends Omit<IDatePickerExtendedProps, "p
     placeholder?: string;
     /** Функция, вызывающаяся при изменении значения. */
     onChange: (value: string) => void;
+    /** Обработчик очищения значения. */
+    onClear?: React.MouseEventHandler<HTMLButtonElement>;
     /** Свойства TextField. */
     targetProps?: ITextFieldProps;
 }
@@ -4063,6 +4073,8 @@ export declare interface IStepperStepProps extends default_2.LiHTMLAttributes<HT
 
 /** Свойства компонента Step. */
 export declare interface IStepProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Размер компонента. */
+    size?: EComponentSize;
     /** Номер шага для отображения в кружке. */
     step: number;
     /** Статус текущего шага. */
@@ -4961,7 +4973,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>>;
@@ -4996,14 +5008,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>>;
@@ -5014,7 +5049,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-CuoqjaG4.js";
+import { C as Eo } from "./chunks/Chip-BWrXp8b3.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-CRdOVwlq.js";
+import { D as ce } from "./chunks/DropdownListItem-BflrX8i-.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-CyAOOwnJ.js";
+import { F as gr } from "./chunks/FormFieldInput-q8qt9K5c.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-PANaJdYf.js";
+import { L as Tp } from "./chunks/ListItemControlsButton-pIOQbY1R.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-dcZDUPZa.js";
+import { S as pa } from "./chunks/SuggestFieldMobileDropdownHint-DC3vUbne.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": "0.26.0",
+  "version": "0.27.0",
   "description": "Библиотека компонентов дизайн-системы Triplex.",
   "license": "Sber Public License at-nc-sa v.2",
   "repository": {