@sberbusiness/triplex-next 0.25.0 → 0.27.0

package/index.d.ts

@@ -436,7 +436,7 @@ declare const designTokensComponentsStatusTrackerKeys: readonly ["Draft_Backgrou
 
 declare const designTokensComponentsStepKeys: readonly ["Color_Active", "Color_Default", "Color_Disabled", "Color_Done", "Color_Error", "Color_Warning", "Background_Active", "Background_Default", "Background_Disabled", "Background_Done", "Background_Error", "Background_Warning"];
 
-declare const designTokensComponentsStepperKeys: readonly ["Step_Background_Default", "Step_Background_Disabled", "Step_Background_Hover", "Step_Background_Error", "Step_Background_Error_Hover", "Step_Background_Warning", "Step_Background_Warning_Hover", "Step_BorderColor_Focus", "Step_BorderColor_Error", "Step_BorderColor_Warning", "Step_BorderColor_Success", "Step_Color_Default", "Step_Color_Hover", "Step_Color_Disabled", "Background", "ButtonNext_Background", "ButtonPrev_Background", "Wrapper_Background", "Wrapper_BoxShadow"];
+declare const designTokensComponentsStepperKeys: readonly ["Step_Background_Default", "Step_Background_Disabled", "Step_Background_Hover", "Step_Background_Error", "Step_Background_Error_Hover", "Step_Background_Warning", "Step_Background_Warning_Hover", "Step_BorderColor_Focus", "Step_BorderColor_Error", "Step_BorderColor_Warning", "Step_BorderColor_Success", "Step_Color_Default", "Step_Color_Hover", "Step_Color_Disabled", "ButtonWrapper_Background_Prev", "ButtonWrapper_Background_Next"];
 
 declare const designTokensComponentsTableBasicKeys: readonly ["Background_Hover", "Background_Selected", "Color", "Header_Background", "TableFooter_Background", "TableFooter_Highlight", "TableBasicSettings_Footer_BorderColor", "TableBasicSettings_ListItem_Background_Default", "TableBasicSettings_ListItem_Background_Hover", "TableBasicSettings_ListItem_Background_Dragging"];
 
@@ -818,6 +818,13 @@ export declare enum EMarkerStatus {
     WAITING = "waiting"
 }
 
+/** Единица измерения сдвига диапазона месяцев. */
+export declare enum EMonthYearRangeShiftUnit {
+    MONTH = "month",
+    QUARTER = "quarter",
+    YEAR = "year"
+}
+
 /** Заглушка для пустых состояний. */
 export declare const EmptyView: default_2.ForwardRefExoticComponent<IEmptyViewProps & default_2.RefAttributes<HTMLDivElement>>;
 
@@ -893,13 +900,6 @@ export declare enum EStatusTrackerVerticalAlign {
     BOTTOM = "bottom"
 }
 
-/** Возможные размеры шагов Step. */
-export declare enum EStepperSize {
-    SM = "sm",
-    MD = "md",
-    LG = "lg"
-}
-
 /** Возможные типы Иконок для шагов Step. */
 export declare enum EStepperStepIconType {
     FILLED = "filled",
@@ -941,7 +941,7 @@ export declare enum ETabsExtendedType {
     TYPE_2 = "type2"
 }
 
-declare enum ETagColorStatus {
+export declare enum ETagColorStatus {
     DEFAULT = "default",
     SUCCESS = "success",
     INFO = "info",
@@ -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,10 +3261,48 @@ declare interface IMonthYearFieldProps extends Omit<IDatePickerExtendedProps, "p
     placeholder?: string;
     /** Функция, вызывающаяся при изменении значения. */
     onChange: (value: string) => void;
+    /** Обработчик очищения значения. */
+    onClear?: React.MouseEventHandler<HTMLButtonElement>;
     /** Свойства TextField. */
     targetProps?: ITextFieldProps;
 }
 
+/** Свойства функции рендеринга кнопки сдвига диапазона месяцев. */
+export declare interface IMonthYearRangeButtonProvideProps {
+    children: default_2.ReactNode;
+    className: string;
+    onClick: () => void;
+    disabled: boolean;
+}
+
+/** Свойства функции рендеринга поля выбора месяца. */
+export declare interface IMonthYearRangePickerProvideProps {
+    value: string;
+    onChange: (value: string) => void;
+}
+
+/** Свойства компонента MonthYearRange. */
+export declare interface IMonthYearRangeProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
+    /** Диапазон месяцев. */
+    value: TMonthYearRangeValue;
+    /** Функция, вызывающаяся при изменении диапазона месяцев. */
+    onChange: (value: TMonthYearRangeValue) => void;
+    /** Численная величина сдвига диапазона месяцев. */
+    shiftAmount?: number;
+    /** Единица измерения сдвига диапазона месяцев. */
+    shiftUnit?: EMonthYearRangeShiftUnit;
+    /** Управление отображением/скрытием кнопок сдвига диапазона месяцев. */
+    hideNavigation?: boolean;
+    /** Функция рендеринга поля выбора месяца "от". */
+    renderPickerFrom: (props: IMonthYearRangePickerProvideProps) => default_2.ReactNode;
+    /** Функция рендеринга поля выбора месяца "до". */
+    renderPickerTo: (props: IMonthYearRangePickerProvideProps) => default_2.ReactNode;
+    /** Функция рендеринга кнопки сдвига диапазона месяцев "назад". */
+    renderButtonBack: (props: IMonthYearRangeButtonProvideProps) => default_2.ReactNode;
+    /** Функция рендеринга кнопки сдвига диапазона месяцев "вперёд". */
+    renderButtonForward: (props: IMonthYearRangeButtonProvideProps) => default_2.ReactNode;
+}
+
 /** Свойства компонента MultiselectFieldDropdownContent. */
 declare interface IMultiselectFieldDropdownContentProps extends default_2.HTMLAttributes<HTMLDivElement> {
     loading?: boolean;
@@ -3975,19 +4021,17 @@ declare interface IStatusTrackerTitleProps extends default_2.HTMLAttributes<HTML
 /** Внутренние составляющие Stepper. */
 declare interface IStepperComposition {
     Step: typeof StepperStep;
-    Wrapper: typeof StepperWrapper;
 }
 
 /** Внутренние составляющие StepperExtended. */
 declare interface IStepperExtendedComposition {
     Step: typeof StepperStep;
-    Wrapper: typeof StepperWrapper;
 }
 
 /** Свойства компонента StepperExtended. */
 export declare interface IStepperExtendedProps extends default_2.HTMLAttributes<HTMLOListElement> {
-    /** Размер Stepper. */
-    size?: EStepperSize;
+    /** Размер. */
+    size?: EComponentSize;
     /** Уникальный идентификатор выбранного шага. */
     selectedStepId?: string;
     /** Обработчик выбора шага. */
@@ -3996,13 +4040,10 @@ export declare interface IStepperExtendedProps extends default_2.HTMLAttributes<
     forwardedRef?: default_2.Ref<HTMLOListElement>;
 }
 
-/** Свойства Stepper. */
-export declare interface IStepperProps extends IStepperExtendedProps {
-    children?: never;
+/** Свойства компонента Stepper. */
+export declare interface IStepperProps extends Omit<IStepperExtendedProps, "children"> {
     /** Шаги. */
     steps: Array<IStepperStep>;
-    /** Размеры шагов Stepper*/
-    size?: EStepperSize;
 }
 
 /** Свойства шага в Stepper */
@@ -4017,7 +4058,7 @@ declare interface IStepperStepComposition {
 }
 
 /** Свойства компонента StepperStep. */
-declare interface IStepperStepProps extends default_2.LiHTMLAttributes<HTMLLIElement> {
+export declare interface IStepperStepProps extends default_2.LiHTMLAttributes<HTMLLIElement> {
     id: string;
     disabled?: boolean;
     /** Иконка, отображающая статус шага. */
@@ -4032,6 +4073,8 @@ declare interface IStepperStepProps extends default_2.LiHTMLAttributes<HTMLLIEle
 
 /** Свойства компонента Step. */
 export declare interface IStepProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Размер компонента. */
+    size?: EComponentSize;
     /** Номер шага для отображения в кружке. */
     step: number;
     /** Статус текущего шага. */
@@ -4930,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>>;
@@ -4965,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>>;
@@ -4983,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. */
@@ -5077,6 +5147,9 @@ export declare const MONTHS_SET: number[];
 /** Поле для выбора месяца. */
 export declare const MonthYearField: default_2.ForwardRefExoticComponent<IMonthYearFieldProps & default_2.RefAttributes<HTMLDivElement>>;
 
+/** Выбор диапазона месяцев. */
+export declare const MonthYearRange: default_2.ForwardRefExoticComponent<IMonthYearRangeProps & default_2.RefAttributes<HTMLDivElement>>;
+
 /** Компонент мульти-списка. */
 export declare const MultiselectField: default_2.ForwardRefExoticComponent<IMultiselectFieldProps & default_2.RefAttributes<HTMLDivElement>> & {
     Dropdown: default_2.ForwardRefExoticComponent<IMultiselectFieldDropdownProps & default_2.RefAttributes<HTMLDivElement>> & {
@@ -5402,9 +5475,6 @@ declare const StepperStep: default_2.FC<IStepperStepProps> & IStepperStepComposi
 /** Компонент StepperStepIcon, иконка в шаге. */
 declare const StepperStepIcon: default_2.FC<TStepperStepIconProps>;
 
-/** Компонент StepperWrapper, обёртка для Stepper. */
-declare const StepperWrapper: default_2.FC<default_2.HTMLAttributes<HTMLDivElement>>;
-
 /** Утилиты для работы со строками. */
 export declare const StringUtils: {
     /** Является ли символ арабской цифрой. */
@@ -6215,6 +6285,9 @@ declare type TitleComponent_2 = (<T extends default_2.ElementType = "span">(prop
     displayName?: string;
 };
 
+/** Значение компонента MonthYearRange. */
+export declare type TMonthYearRangeValue = [string, string];
+
 export declare type TOffsetSize = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11;
 
 /** Всплывающая подсказка. */