@skbkontur/react-ui 5.2.0 → 5.3.0

package/cjs/components/TokenInput/TokenInput.d.ts

@@ -1,225 +1,227 @@
-import type { AriaAttributes, FocusEventHandler, HTMLAttributes, MouseEventHandler, ReactNode } from 'react';
-import React from 'react';
-import type { TokenProps, TokenSize } from '../Token';
-import type { MenuItemState } from '../MenuItem';
-import type { CommonProps } from '../../internal/CommonWrapper';
-export declare enum TokenInputType {
-    WithReference = 0,
-    WithoutReference = 1,
-    Combined = 2
-}
-export type TokenInputMenuAlign = 'left' | 'cursor';
-export interface TokenInputProps<T> extends CommonProps, Pick<AriaAttributes, 'aria-describedby' | 'aria-label'>, Pick<HTMLAttributes<HTMLElement>, 'id'> {
-    /** Задает выбранные токены, которые будут отображаться в поле ввода. */
-    selectedItems?: T[];
-    /** Задает функцию, которая вызывается при добавлении нового токена. */
-    onValueChange?: (items: T[]) => void;
-    /** Задает HTML-событие `onmouseenter`.
-     * @ignore */
-    onMouseEnter?: MouseEventHandler<HTMLDivElement>;
-    /** Задает HTML-событие `onmouseleave`.
-     * @ignore */
-    onMouseLeave?: MouseEventHandler<HTMLDivElement>;
-    /** Задает HTML-событие `onfocus`.
-     * @ignore */
-    onFocus?: FocusEventHandler<HTMLTextAreaElement>;
-    /** Задает HTML-событие `onblur`.
-     * @ignore */
-    onBlur?: FocusEventHandler<HTMLTextAreaElement>;
-    /** Устанавливает фокус на контроле после окончания загрузки страницы. */
-    autoFocus?: boolean;
-    /** Задает размер контрола. */
-    size?: TokenSize;
-    /** Задает тип инпута.
-     * Возможные значения:
-     *   `TokenInputType.WithReference` (можно выбирать токены только из предложенных, нельзя добавить новые).
-     *   `TokenInputType.WithoutReference` (можно добавлять токены, но нельзя выбирать).
-     *   `TokenInputType.Combined` (можно и выбирать, и добавлять). */
-    type?: TokenInputType;
-    /** Задает ширину выпадающего меню. Может быть 'auto', в пикселях, процентах (от ширины инпута) и других конкретных единицах.
-     * Если menuAlign = 'cursor', то ширина выпадающего меню всегда будет равна 'auto' (по ширине текста). */
-    menuWidth?: React.CSSProperties['width'];
-    /** Задает выравнивание выпадающего меню. */
-    menuAlign?: TokenInputMenuAlign;
-    /** Задает функцию поиска элементов, должна возвращать Promise с массивом элементов. По умолчанию ожидаются строки.
-     * Элементы могут быть любого типа. В таком случае необходимо определить свойства `renderItem`, `valueToString`. */
-    getItems?: (query: string) => Promise<T[]>;
-    /** Скрывает меню при пустом вводе. */
-    hideMenuIfEmptyInputValue?: boolean;
-    /** Задает функцию, которая отображает элемент списка. */
-    renderItem?: (item: T, state: MenuItemState) => React.ReactNode | null;
-    /** Задает функцию, которая отображает выбранное значение. */
-    renderValue?: (item: T) => React.ReactNode;
-    /** Задает функцию, которая возвращает строковое представление токена.
-     * @default item => item */
-    valueToString?: (item: T) => string;
-    /** Задает функцию, которая отображает сообщение об общем количестве элементов.
-     * `found` учитывает только компонент `MenuItem`. Им "оборачиваются" элементы, возвращаемые `getItems()`. */
-    renderTotalCount?: (found: number, total: number) => React.ReactNode;
-    /** Определяет общее количество элементов. Необходим для работы `renderTotalCount`. */
-    totalCount?: number;
-    /** Задает функцию, которая отображает заданное содержимое при пустом результате поиска. Не работает, если рендерится `AddButton`. */
-    renderNotFound?: () => React.ReactNode;
-    /** Преобразует значение в элемент списка. */
-    valueToItem?: (item: string) => T;
-    /** Определяет уникальный ключ по элементу. */
-    toKey?: (item: T) => string | number | undefined;
-    /** Задает текст, который отображается если не введено никакое значение. */
-    placeholder?: string;
-    /** Задает символы, которые разделяют введённый текст на токены. */
-    delimiters?: string[];
-    /** Переводит контрол в состояние валидации "ошибка". */
-    error?: boolean;
-    /** Переводит контрол в состояние валидации "предупреждение". */
-    warning?: boolean;
-    /** Делает компонент недоступным. */
-    disabled?: boolean;
-    /** Задает ширину токен-инпута. */
-    width?: string | number;
-    /** Задает максимальную высоту выпадающего меню. */
-    maxMenuHeight?: number | string;
-    /** Задает функцию, которая отображает токен и предоставляет возможность кастомизации внешнего вида и поведения токена. */
-    renderToken?: (item: T, props: Partial<TokenProps>) => ReactNode;
-    /** Задает функцию, вызывающуюся при изменении текста в поле ввода. */
-    onInputValueChange?: (value: string) => void;
-    /** Задает функцию отрисовки кнопки добавления в выпадающем списке */
-    renderAddButton?: (query?: string, onAddItem?: () => void) => ReactNode;
-    /** Задает функцию для обработки ввода строки в инпут и последующую потерю фокуса компонентом.
-     * Функция срабатывает с аргументом инпута строки
-     *
-     * Если при потере фокуса в выпадающем списке будет только один элемент и результат `valueToString` с этим элементом будет
-     * совпадать со значением в текстовом поле, то сработает `onValueChange` со значением данного элемента
-     *
-     * Сама функция также может вернуть значение, неравное `undefined`, с которым будет вызван `onValueChange`.
-     * При возвращаемом значении `null` будет выполнена очистка текущего значения инпута, а в режиме редактирования токен будет удален. */
-    onUnexpectedInput?: (value: string) => void | null | undefined | T;
-    /** Задает типы вводимых данных. */
-    inputMode?: React.HTMLAttributes<HTMLTextAreaElement>['inputMode'];
-}
-export interface TokenInputState<T> {
-    autocompleteItems?: T[];
-    activeTokens: T[];
-    editingTokenIndex: number;
-    clickedToken?: T;
-    clickedTokenTimeout?: number;
-    inFocus?: boolean;
-    inputValue: string;
-    reservedInputValue: string | undefined;
-    inputValueWidth: number;
-    inputValueHeight: number;
-    preventBlur?: boolean;
-    loading?: boolean;
-}
-export declare const DefaultState: {
-    inputValue: string;
-    reservedInputValue: undefined;
-    autocompleteItems: undefined;
-    activeTokens: never[];
-    editingTokenIndex: number;
-    inFocus: boolean;
-    loading: boolean;
-    preventBlur: boolean;
-    inputValueWidth: number;
-    inputValueHeight: number;
-};
-export declare const TokenInputDataTids: {
-    readonly root: "TokenInput__root";
-    readonly tokenInputMenu: "TokenInputMenu__root";
-    readonly label: "TokenInput__label";
-};
-type DefaultProps<T> = Required<Pick<TokenInputProps<T>, 'selectedItems' | 'delimiters' | 'renderItem' | 'renderValue' | 'valueToString' | 'valueToItem' | 'toKey' | 'onValueChange' | 'width' | 'onBlur' | 'onFocus' | 'onMouseEnter' | 'onMouseLeave' | 'menuWidth' | 'menuAlign' | 'size'>>;
-/**
- * Поле с токенами `TokenInput` — это поле ввода со списком подсказок.
- *
- * Поле с токенами используют для выбора нескольких значений из справочника и для добавления своих значений.
- */
-export declare class TokenInput<T = string> extends React.PureComponent<TokenInputProps<T>, TokenInputState<T>> {
-    static __KONTUR_REACT_UI__: string;
-    static displayName: string;
-    static defaultProps: DefaultProps<any>;
-    private getDelimiters;
-    private getProps;
-    private get textareaId();
-    state: TokenInputState<T>;
-    private readonly _textareaId;
-    private rootId;
-    private readonly locale;
-    private theme;
-    private input;
-    private tokensInputMenu;
-    private textHelper;
-    private wrapper;
-    private setRootNode;
-    private memoizedTokens;
-    componentDidMount(): void;
-    componentDidUpdate(prevProps: TokenInputProps<T> & DefaultProps<T>, prevState: TokenInputState<T>): void;
-    componentWillUnmount(): void;
-    /**
-     * @public
-     */
-    focus(): void;
-    /**
-     * @public
-     */
-    blur(): void;
-    render(): React.JSX.Element;
-    private getLabelSizeClassName;
-    private getInputSizeClassName;
-    private renderMain;
-    /**
-     * Сбрасывает введенное пользователем значение
-     * @public
-     */
-    reset(): void;
-    private hasValueInItems;
-    private get showAddItemHint();
-    private get type();
-    private get menuRef();
-    private get isCursorVisible();
-    private get isEditingMode();
-    private isCursorVisibleForState;
-    private inputRef;
-    private tokensInputMenuRef;
-    private textHelperRef;
-    private wrapperRef;
-    private dispatch;
-    private updateInputTextWidth;
-    private handleInputFocus;
-    private handleInputBlur;
-    private handleOutsideBlur;
-    private get isInputChanged();
-    private get isInputValueChanged();
-    private get isTokenValueChanged();
-    private isBlurToMenu;
-    private handleWrapperMouseDown;
-    private handleWrapperMouseUp;
-    private handleCopy;
-    private handleInputPaste;
-    private tryGetItems;
-    private handleKeyDown;
-    private handleInputKeyDown;
-    private moveFocusToLastToken;
-    private focusInput;
-    private selectInputText;
-    private handleWrapperKeyDown;
-    private handleWrapperArrows;
-    private handleWrapperArrowsWithoutShift;
-    private handleWrapperArrowsWithShift;
-    private handleValueChange;
-    private handleAddItem;
-    private selectItem;
-    private handleRemoveToken;
-    private handleTokenClick;
-    private handleTokenEdit;
-    private finishTokenEdit;
-    private checkForUnexpectedInput;
-    private handleChangeInputValue;
-    private highlightMenuItem;
-    private renderTokensStart;
-    private renderTokensEnd;
-    private renderToken;
-    private renderAddButton;
-    private isTokenDisabled;
-    private getAvailableTokenIndex;
-}
-export {};
+import type { AriaAttributes, FocusEventHandler, HTMLAttributes, MouseEventHandler, ReactNode } from 'react';
+import React from 'react';
+import type { TokenProps, TokenSize } from '../Token';
+import type { MenuItemState } from '../MenuItem';
+import type { CommonProps } from '../../internal/CommonWrapper';
+import type { TGetRootNode } from '../../lib/rootNode';
+export declare enum TokenInputType {
+    WithReference = 0,
+    WithoutReference = 1,
+    Combined = 2
+}
+export type TokenInputMenuAlign = 'left' | 'cursor';
+export interface TokenInputProps<T> extends CommonProps, Pick<AriaAttributes, 'aria-describedby' | 'aria-label'>, Pick<HTMLAttributes<HTMLElement>, 'id'> {
+    /** Задает выбранные токены, которые будут отображаться в поле ввода. */
+    selectedItems?: T[];
+    /** Задает функцию, которая вызывается при добавлении нового токена. */
+    onValueChange?: (items: T[]) => void;
+    /** Задает HTML-событие `onmouseenter`.
+     * @ignore */
+    onMouseEnter?: MouseEventHandler<HTMLDivElement>;
+    /** Задает HTML-событие `onmouseleave`.
+     * @ignore */
+    onMouseLeave?: MouseEventHandler<HTMLDivElement>;
+    /** Задает HTML-событие `onfocus`.
+     * @ignore */
+    onFocus?: FocusEventHandler<HTMLTextAreaElement>;
+    /** Задает HTML-событие `onblur`.
+     * @ignore */
+    onBlur?: FocusEventHandler<HTMLTextAreaElement>;
+    /** Устанавливает фокус на контроле после окончания загрузки страницы. */
+    autoFocus?: boolean;
+    /** Задает размер контрола. */
+    size?: TokenSize;
+    /** Задает тип инпута.
+     * Возможные значения:
+     *   `TokenInputType.WithReference` (можно выбирать токены только из предложенных, нельзя добавить новые).
+     *   `TokenInputType.WithoutReference` (можно добавлять токены, но нельзя выбирать).
+     *   `TokenInputType.Combined` (можно и выбирать, и добавлять). */
+    type?: TokenInputType;
+    /** Задает ширину выпадающего меню. Может быть 'auto', в пикселях, процентах (от ширины инпута) и других конкретных единицах.
+     * Если menuAlign = 'cursor', то ширина выпадающего меню всегда будет равна 'auto' (по ширине текста). */
+    menuWidth?: React.CSSProperties['width'];
+    /** Задает выравнивание выпадающего меню. */
+    menuAlign?: TokenInputMenuAlign;
+    /** Задает функцию поиска элементов, должна возвращать Promise с массивом элементов. По умолчанию ожидаются строки.
+     * Элементы могут быть любого типа. В таком случае необходимо определить свойства `renderItem`, `valueToString`. */
+    getItems?: (query: string) => Promise<T[]>;
+    /** Скрывает меню при пустом вводе. */
+    hideMenuIfEmptyInputValue?: boolean;
+    /** Задает функцию, которая отображает элемент списка. */
+    renderItem?: (item: T, state: MenuItemState) => React.ReactNode | null;
+    /** Задает функцию, которая отображает выбранное значение. */
+    renderValue?: (item: T) => React.ReactNode;
+    /** Задает функцию, которая возвращает строковое представление токена.
+     * @default item => item */
+    valueToString?: (item: T) => string;
+    /** Задает функцию, которая отображает сообщение об общем количестве элементов.
+     * `found` учитывает только компонент `MenuItem`. Им "оборачиваются" элементы, возвращаемые `getItems()`. */
+    renderTotalCount?: (found: number, total: number) => React.ReactNode;
+    /** Определяет общее количество элементов. Необходим для работы `renderTotalCount`. */
+    totalCount?: number;
+    /** Задает функцию, которая отображает заданное содержимое при пустом результате поиска. Не работает, если рендерится `AddButton`. */
+    renderNotFound?: () => React.ReactNode;
+    /** Преобразует значение в элемент списка. */
+    valueToItem?: (item: string) => T;
+    /** Определяет уникальный ключ по элементу. */
+    toKey?: (item: T) => string | number | undefined;
+    /** Задает текст, который отображается если не введено никакое значение. */
+    placeholder?: string;
+    /** Задает символы, которые разделяют введённый текст на токены. */
+    delimiters?: string[];
+    /** Переводит контрол в состояние валидации "ошибка". */
+    error?: boolean;
+    /** Переводит контрол в состояние валидации "предупреждение". */
+    warning?: boolean;
+    /** Делает компонент недоступным. */
+    disabled?: boolean;
+    /** Задает ширину токен-инпута. */
+    width?: string | number;
+    /** Задает максимальную высоту выпадающего меню. */
+    maxMenuHeight?: number | string;
+    /** Задает функцию, которая отображает токен и предоставляет возможность кастомизации внешнего вида и поведения токена. */
+    renderToken?: (item: T, props: Partial<TokenProps>) => ReactNode;
+    /** Задает функцию, вызывающуюся при изменении текста в поле ввода. */
+    onInputValueChange?: (value: string) => void;
+    /** Задает функцию отрисовки кнопки добавления в выпадающем списке */
+    renderAddButton?: (query?: string, onAddItem?: () => void) => ReactNode;
+    /** Задает функцию для обработки ввода строки в инпут и последующую потерю фокуса компонентом.
+     * Функция срабатывает с аргументом инпута строки
+     *
+     * Если при потере фокуса в выпадающем списке будет только один элемент и результат `valueToString` с этим элементом будет
+     * совпадать со значением в текстовом поле, то сработает `onValueChange` со значением данного элемента
+     *
+     * Сама функция также может вернуть значение, неравное `undefined`, с которым будет вызван `onValueChange`.
+     * При возвращаемом значении `null` будет выполнена очистка текущего значения инпута, а в режиме редактирования токен будет удален. */
+    onUnexpectedInput?: (value: string) => void | null | undefined | T;
+    /** Задает типы вводимых данных. */
+    inputMode?: React.HTMLAttributes<HTMLTextAreaElement>['inputMode'];
+}
+export interface TokenInputState<T> {
+    autocompleteItems?: T[];
+    activeTokens: T[];
+    editingTokenIndex: number;
+    clickedToken?: T;
+    clickedTokenTimeout?: number;
+    inFocus?: boolean;
+    inputValue: string;
+    reservedInputValue: string | undefined;
+    inputValueWidth: number;
+    inputValueHeight: number;
+    preventBlur?: boolean;
+    loading?: boolean;
+}
+export declare const DefaultState: {
+    inputValue: string;
+    reservedInputValue: undefined;
+    autocompleteItems: undefined;
+    activeTokens: never[];
+    editingTokenIndex: number;
+    inFocus: boolean;
+    loading: boolean;
+    preventBlur: boolean;
+    inputValueWidth: number;
+    inputValueHeight: number;
+};
+export declare const TokenInputDataTids: {
+    readonly root: "TokenInput__root";
+    readonly tokenInputMenu: "TokenInputMenu__root";
+    readonly label: "TokenInput__label";
+};
+type DefaultProps<T> = Required<Pick<TokenInputProps<T>, 'selectedItems' | 'delimiters' | 'renderItem' | 'renderValue' | 'valueToString' | 'valueToItem' | 'toKey' | 'onValueChange' | 'width' | 'onBlur' | 'onFocus' | 'onMouseEnter' | 'onMouseLeave' | 'menuWidth' | 'menuAlign' | 'size'>>;
+/**
+ * Поле с токенами `TokenInput` — это поле ввода со списком подсказок.
+ *
+ * Поле с токенами используют для выбора нескольких значений из справочника и для добавления своих значений.
+ */
+export declare class TokenInput<T = string> extends React.PureComponent<TokenInputProps<T>, TokenInputState<T>> {
+    static __KONTUR_REACT_UI__: string;
+    static displayName: string;
+    static defaultProps: DefaultProps<any>;
+    private getDelimiters;
+    private getProps;
+    private get textareaId();
+    state: TokenInputState<T>;
+    private readonly _textareaId;
+    private rootId;
+    private readonly locale;
+    private theme;
+    private input;
+    private tokensInputMenu;
+    private textHelper;
+    private wrapper;
+    getRootNode: TGetRootNode;
+    private setRootNode;
+    private memoizedTokens;
+    componentDidMount(): void;
+    componentDidUpdate(prevProps: TokenInputProps<T> & DefaultProps<T>, prevState: TokenInputState<T>): void;
+    componentWillUnmount(): void;
+    /**
+     * @public
+     */
+    focus(): void;
+    /**
+     * @public
+     */
+    blur(): void;
+    render(): React.JSX.Element;
+    private getLabelSizeClassName;
+    private getInputSizeClassName;
+    private renderMain;
+    /**
+     * Сбрасывает введенное пользователем значение
+     * @public
+     */
+    reset(): void;
+    private hasValueInItems;
+    private get showAddItemHint();
+    private get type();
+    private get menuRef();
+    private get isCursorVisible();
+    private get isEditingMode();
+    private isCursorVisibleForState;
+    private inputRef;
+    private tokensInputMenuRef;
+    private textHelperRef;
+    private wrapperRef;
+    private dispatch;
+    private updateInputTextWidth;
+    private handleInputFocus;
+    private handleInputBlur;
+    private handleOutsideBlur;
+    private get isInputChanged();
+    private get isInputValueChanged();
+    private get isTokenValueChanged();
+    private isBlurToMenu;
+    private handleWrapperMouseDown;
+    private handleWrapperMouseUp;
+    private handleCopy;
+    private handleInputPaste;
+    private tryGetItems;
+    private handleKeyDown;
+    private handleInputKeyDown;
+    private moveFocusToLastToken;
+    private focusInput;
+    private selectInputText;
+    private handleWrapperKeyDown;
+    private handleWrapperArrows;
+    private handleWrapperArrowsWithoutShift;
+    private handleWrapperArrowsWithShift;
+    private handleValueChange;
+    private handleAddItem;
+    private selectItem;
+    private handleRemoveToken;
+    private handleTokenClick;
+    private handleTokenEdit;
+    private finishTokenEdit;
+    private checkForUnexpectedInput;
+    private handleChangeInputValue;
+    private highlightMenuItem;
+    private renderTokensStart;
+    private renderTokensEnd;
+    private renderToken;
+    private renderAddButton;
+    private isTokenDisabled;
+    private getAvailableTokenIndex;
+}
+export {};

package/cjs/components/TokenInput/TokenInput.js

@@ -323,6 +323,7 @@ TokenInput = exports.TokenInput = (_dec = (0, _decorators.locale)('TokenInput',
     textHelper = null;_this.
     wrapper = null;_this.
 
+
     memoizedTokens = new Map();_this.