@astral/ui 4.106.0 → 4.108.0

package/components/TagsList/TagsList.js

@@ -1,5 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { CounterTag, Wrapper } from './styles';
+import { CrossOutlineMd } from '../../icons/CrossOutlineMd';
+import { IconButton } from '../IconButton';
+import { NewPopover } from '../NewPopover';
+import { Typography } from '../Typography';
+import { POPOVER_CLOSE_TEXT, POPOVER_TITLE_TEXT } from './constants';
+import { PopoverTags } from './PopoverTags';
+import { CounterTag, PopoverContentWrapper, PopoverHeader, Wrapper, } from './styles';
 import { Tag } from './Tag';
 import { useLogic } from './useLogic';
 import { getKey } from './utils';
@@ -8,10 +14,10 @@ import { getKey } from './utils';
  * Не предназначен для использования в продуктах, не экспортируется из пакета
  */
 export const TagsList = (props) => {
-    const { hiddenCount, tagsContainerRef, visibleOptions, getTagProps, showCounter, } = useLogic(props);
-    const { className, keyId, isDisabled, onClick, getOptionLabel } = props;
+    const { hiddenCount, tagsContainerRef, counterRef, visibleOptions, getTagProps, showCounter, isPopoverOpen, isPopoverEnabled, setPopoverContentRef, popoverContentCssVars, stopPopoverEventPropagation, popoverAnchorEl, closePopover, startPopoverDelay, cancelPopoverDelay, handleTagClick, handleCounterClick, } = useLogic(props);
+    const { className, data = [], keyId, isDisabled, getOptionLabel } = props;
     return (_jsxs(Wrapper, { className: className, ref: tagsContainerRef, children: [visibleOptions?.map((option) => {
                 const tagProps = getTagProps(option);
-                return (_jsx(Tag, { isDisabled: isDisabled, onClick: onClick, ...tagProps }, getKey(option, keyId, getOptionLabel)));
-            }), showCounter && (_jsx(CounterTag, { isDisabled: isDisabled, label: `+${hiddenCount}`, onClick: onClick }, "more"))] }));
+                return (_jsx(Tag, { isDisabled: isDisabled, onClick: handleTagClick, ...tagProps }, getKey(option, keyId, getOptionLabel)));
+            }), showCounter && (_jsx(CounterTag, { ref: counterRef, isDisabled: isDisabled, label: `+${hiddenCount}`, onClick: handleCounterClick, onMouseEnter: isPopoverEnabled ? startPopoverDelay : undefined, onMouseLeave: isPopoverEnabled ? cancelPopoverDelay : undefined }, "more")), _jsx(NewPopover, { isOpen: isPopoverOpen, anchorEl: popoverAnchorEl, disableAutoFocus: true, onClose: closePopover, children: _jsxs(PopoverContentWrapper, { ref: setPopoverContentRef, style: popoverContentCssVars, onClick: stopPopoverEventPropagation, onMouseDown: stopPopoverEventPropagation, children: [_jsxs(PopoverHeader, { children: [_jsx(Typography, { variant: "h5", children: POPOVER_TITLE_TEXT }), _jsx(IconButton, { variant: "text", title: POPOVER_CLOSE_TEXT, "aria-label": POPOVER_CLOSE_TEXT, onClick: closePopover, children: _jsx(CrossOutlineMd, {}) })] }), _jsx(PopoverTags, { data: data, keyId: keyId, isDisabled: isDisabled, getOptionLabel: getOptionLabel, getTagProps: getTagProps })] }) })] }));
 };

package/components/TagsList/constants.d.ts

@@ -1,2 +1,37 @@
 export declare const MIN_AVAILABLE_WIDTH = 50;
 export declare const GAP_BETWEEN_TAGS = 4;
+/**
+ * Задержка появления всплывающего окна при наведении на счётчик (мс)
+ */
+export declare const POPOVER_HOVER_DELAY = 500;
+/**
+ * Максимальная ширина всплывающего окна (px)
+ */
+export declare const POPOVER_MAX_WIDTH = 480;
+/**
+ * Максимальная высота всплывающего окна (px)
+ */
+export declare const POPOVER_MAX_HEIGHT = 370;
+/**
+ * Количество тэгов, которые всплывающее окно вмещает в строку в любом случае:
+ * задаёт его минимальную ширину
+ */
+export declare const POPOVER_MIN_TAGS_IN_ROW = 2;
+/**
+ * Отступ между тэгами во всплывающем окне в единицах theme.spacing.
+ * Используется и в стилях, и в расчёте минимальной ширины окна
+ */
+export declare const POPOVER_TAGS_GAP_SPACING = 2;
+/**
+ * Горизонтальный отступ контейнера тэгов во всплывающем окне в единицах
+ * theme.spacing. Используется и в стилях, и в расчёте минимальной ширины окна
+ */
+export declare const POPOVER_TAGS_PADDING_SPACING = 4;
+/**
+ * Заголовок всплывающего окна со списком выбранных элементов
+ */
+export declare const POPOVER_TITLE_TEXT = "\u0412\u044B\u0431\u0440\u0430\u043D\u043D\u044B\u0435 \u044D\u043B\u0435\u043C\u0435\u043D\u0442\u044B";
+/**
+ * Доступное имя кнопки, закрывающей всплывающее окно
+ */
+export declare const POPOVER_CLOSE_TEXT = "\u0417\u0430\u043A\u0440\u044B\u0442\u044C";

package/components/TagsList/constants.js

@@ -1,2 +1,37 @@
 export const MIN_AVAILABLE_WIDTH = 50;
 export const GAP_BETWEEN_TAGS = 4; // 4px
+/**
+ * Задержка появления всплывающего окна при наведении на счётчик (мс)
+ */
+export const POPOVER_HOVER_DELAY = 500;
+/**
+ * Максимальная ширина всплывающего окна (px)
+ */
+export const POPOVER_MAX_WIDTH = 480;
+/**
+ * Максимальная высота всплывающего окна (px)
+ */
+export const POPOVER_MAX_HEIGHT = 370;
+/**
+ * Количество тэгов, которые всплывающее окно вмещает в строку в любом случае:
+ * задаёт его минимальную ширину
+ */
+export const POPOVER_MIN_TAGS_IN_ROW = 2;
+/**
+ * Отступ между тэгами во всплывающем окне в единицах theme.spacing.
+ * Используется и в стилях, и в расчёте минимальной ширины окна
+ */
+export const POPOVER_TAGS_GAP_SPACING = 2;
+/**
+ * Горизонтальный отступ контейнера тэгов во всплывающем окне в единицах
+ * theme.spacing. Используется и в стилях, и в расчёте минимальной ширины окна
+ */
+export const POPOVER_TAGS_PADDING_SPACING = 4;
+/**
+ * Заголовок всплывающего окна со списком выбранных элементов
+ */
+export const POPOVER_TITLE_TEXT = 'Выбранные элементы';
+/**
+ * Доступное имя кнопки, закрывающей всплывающее окно
+ */
+export const POPOVER_CLOSE_TEXT = 'Закрыть';

package/components/TagsList/styles.d.ts

@@ -3,6 +3,14 @@ export declare const Wrapper: import("../styled").StyledComponent<{
     theme?: import("@emotion/react").Theme | undefined;
     as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;
 }, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
-export declare const CounterTag: import("../styled").StyledComponent<import("./Tag").TagProps & {
+export declare const CounterTag: import("../styled").StyledComponent<import("./Tag").TagProps & import("react").RefAttributes<HTMLDivElement> & {
     theme?: import("@emotion/react").Theme | undefined;
 }, {}, {}>;
+export declare const PopoverContentWrapper: import("../styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const PopoverHeader: import("../styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;

package/components/TagsList/styles.js

@@ -1,6 +1,6 @@
 import { styled } from '../styled';
 import { tagClassnames } from '../Tag';
-import { GAP_BETWEEN_TAGS } from './constants';
+import { GAP_BETWEEN_TAGS, POPOVER_MAX_WIDTH } from './constants';
 import { Tag } from './Tag';
 export const Wrapper = styled.div `
   overflow: hidden;
@@ -8,9 +8,28 @@ export const Wrapper = styled.div `
   column-gap: ${GAP_BETWEEN_TAGS}px;
 `;
 export const CounterTag = styled(Tag) `
+  cursor: pointer;
+
   overflow: unset;
 
   .${tagClassnames.label} {
     min-width: unset;
   }
 `;
+export const PopoverContentWrapper = styled.div `
+  --tags-list-popover-width: ${POPOVER_MAX_WIDTH}px;
+  display: flex;
+  flex-direction: column;
+  gap: ${({ theme }) => theme.spacing(2)};
+
+  width: var(--tags-list-popover-width);
+  max-width: ${POPOVER_MAX_WIDTH}px;
+  padding-block: ${({ theme }) => theme.spacing(4)};
+`;
+export const PopoverHeader = styled.div `
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+
+  padding-inline: ${({ theme }) => theme.spacing(4)};
+`;

package/components/TagsList/types.d.ts

@@ -31,6 +31,10 @@ export type TagsListProps<TData extends TagValue = TagValue> = {
      * Ref на внешний контейнер, чья ширина используется как база для расчёта доступного пространства..
      */
     inputContainerRef?: RefObject<HTMLElement | null>;
+    /**
+     * Ref на поле инпута
+     */
+    fieldRef: RefObject<HTMLElement | null>;
     /**
      * Зарезервированная ширина, которая будет вычтена из доступной ширины при расчете количества отображаемых тегов
      */

package/components/TagsList/useLogic/hooks/index.d.ts

@@ -0,0 +1 @@
+export * from './useHoverDelay';

package/components/TagsList/useLogic/hooks/index.js

@@ -0,0 +1 @@
+export * from './useHoverDelay';

package/components/TagsList/useLogic/hooks/useHoverDelay/index.d.ts

@@ -0,0 +1 @@
+export * from './useHoverDelay';

package/components/TagsList/useLogic/hooks/useHoverDelay/index.js

@@ -0,0 +1 @@
+export * from './useHoverDelay';

package/components/TagsList/useLogic/hooks/useHoverDelay/types.d.ts

@@ -0,0 +1,20 @@
+export type UseHoverDelayResult = {
+    /**
+     * Запускает отсчёт задержки. Повторный вызов перезапускает отсчёт
+     */
+    start: () => void;
+    /**
+     * Отменяет отсчёт, если он не завершился
+     */
+    cancel: () => void;
+};
+export type UseHoverDelayParams = {
+    /**
+     * Функция, вызывающаяся при hover-эффекте после задержки
+     */
+    onHover: () => void;
+    /**
+     * Задержка вызова функции в мс
+     */
+    delay: number;
+};

package/components/TagsList/useLogic/hooks/useHoverDelay/types.js

@@ -0,0 +1 @@
+export {};

package/components/TagsList/useLogic/hooks/useHoverDelay/useHoverDelay.d.ts

@@ -0,0 +1,5 @@
+import { type UseHoverDelayParams, type UseHoverDelayResult } from './types';
+/**
+ * Откладывает вызов на время удержания указателя над элементом.
+ */
+export declare const useHoverDelay: ({ delay, onHover, }: UseHoverDelayParams) => UseHoverDelayResult;

package/components/TagsList/useLogic/hooks/useHoverDelay/useHoverDelay.js

@@ -0,0 +1,27 @@
+import { useEffect, useRef } from 'react';
+/**
+ * Откладывает вызов на время удержания указателя над элементом.
+ */
+export const useHoverDelay = ({ delay, onHover, }) => {
+    const timeoutRef = useRef(undefined);
+    const savedOnHoverRef = useRef(onHover);
+    useEffect(() => {
+        savedOnHoverRef.current = onHover;
+    });
+    const cancel = () => {
+        if (timeoutRef.current === undefined) {
+            return;
+        }
+        clearTimeout(timeoutRef.current);
+        timeoutRef.current = undefined;
+    };
+    const start = () => {
+        cancel();
+        timeoutRef.current = setTimeout(() => {
+            timeoutRef.current = undefined;
+            savedOnHoverRef.current();
+        }, delay);
+    };
+    useEffect(() => cancel, []);
+    return { start, cancel };
+};

package/components/TagsList/useLogic/useLogic.d.ts

@@ -1,15 +1,27 @@
-/// <reference types="react" />
+import { type CSSProperties, type MouseEvent, type SyntheticEvent } from 'react';
 import type { TagsListProps, TagValue } from '../types';
 type UseLogicParams<TData extends TagValue> = TagsListProps<TData>;
-export declare const useLogic: <TData extends TagValue>({ data, keyId, getOptionLabel, onChange, inputContainerRef, reservedWidth, }: UseLogicParams<TData>) => {
+export declare const useLogic: <TData extends TagValue>({ data, keyId, isDisabled, getOptionLabel, onChange, onClick, inputContainerRef, fieldRef, reservedWidth, }: UseLogicParams<TData>) => {
     visibleOptions: TData[];
     hiddenCount: number;
     showCounter: boolean;
     tagsContainerRef: import("react").RefObject<HTMLDivElement | null>;
+    counterRef: import("react").RefObject<HTMLDivElement | null>;
     getTagProps: (option: TData) => {
         label: string | number;
         shrinks: boolean;
         onDelete: () => void;
     };
+    isPopoverOpen: boolean;
+    isPopoverEnabled: boolean;
+    setPopoverContentRef: (node: HTMLDivElement | null) => void;
+    popoverContentCssVars: CSSProperties;
+    stopPopoverEventPropagation: (event: SyntheticEvent) => void;
+    popoverAnchorEl: HTMLElement | null;
+    closePopover: () => void;
+    startPopoverDelay: () => void;
+    cancelPopoverDelay: () => void;
+    handleTagClick: (event: MouseEvent<HTMLDivElement>) => void;
+    handleCounterClick: (event: MouseEvent<HTMLDivElement>) => void;
 };
 export {};

package/components/TagsList/useLogic/useLogic.js

@@ -1,13 +1,38 @@
-import { useEffect, useLayoutEffect, useRef, useState } from 'react';
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, } from 'react';
 import { useTheme } from '../../theme/hooks/useTheme';
-import { MIN_AVAILABLE_WIDTH } from '../constants';
-import { calculateVisibleTagsCount, getAvailableWidth } from '../utils';
-export const useLogic = ({ data = [], keyId, getOptionLabel, onChange, inputContainerRef, reservedWidth = 0, }) => {
+import { useClickAwayEffect } from '../../useClickAwayEffect';
+import { useNewToggle } from '../../useNewToggle';
+import { useViewportType } from '../../useViewportType';
+import { MIN_AVAILABLE_WIDTH, POPOVER_HOVER_DELAY } from '../constants';
+import { calculatePopoverWidth, calculateVisibleTagsCount, getAvailableWidth, } from '../utils';
+import { useHoverDelay } from './hooks/useHoverDelay';
+export const useLogic = ({ data = [], keyId, isDisabled, getOptionLabel, onChange, onClick, inputContainerRef, fieldRef, reservedWidth = 0, }) => {
     const [visibleOptions, setVisibleOptions] = useState([]);
     const [hiddenCount, setHiddenCount] = useState(0);
+    const [isPopoverOpen, togglePopover] = useNewToggle(false);
+    const [isPopoverContentMounted, togglePopoverContentMounted] = useNewToggle(false);
+    /**
+     * Ширина окна и якорь позиционирования фиксируются на момент открытия
+     * и дальше не пересчитываются
+     */
+    const [popoverWidth, setPopoverWidth] = useState(0);
+    const [popoverAnchorEl, setPopoverAnchorEl] = useState(null);
     const tagsContainerRef = useRef(null);
     const availableWidthRef = useRef(0);
+    const popoverContentRef = useRef(null);
+    const counterRef = useRef(null);
     const theme = useTheme();
+    const { isMobile } = useViewportType();
+    const openPopover = () => {
+        const field = fieldRef.current;
+        if (isPopoverOpen || !field) {
+            return;
+        }
+        setPopoverWidth(calculatePopoverWidth(field.getBoundingClientRect().width, data.map((item) => getOptionLabel(item).toString()), theme));
+        setPopoverAnchorEl(field);
+        togglePopover(true);
+    };
+    const closePopover = () => togglePopover(false);
     /**
      * Обновляет доступную ширину для расчета количества отображаемых тегов
      */
@@ -64,6 +89,7 @@ export const useLogic = ({ data = [], keyId, getOptionLabel, onChange, inputCont
         if (!data.length) {
             setVisibleOptions([]);
             setHiddenCount(0);
+            closePopover();
             return;
         }
         const resizeObserver = new ResizeObserver(() => {
@@ -102,11 +128,65 @@ export const useLogic = ({ data = [], keyId, getOptionLabel, onChange, inputCont
         return { label, shrinks: false, onDelete };
     };
     const showCounter = hiddenCount > 0;
+    const { start: startPopoverDelay, cancel: cancelPopoverDelay } = useHoverDelay({ onHover: openPopover, delay: POPOVER_HOVER_DELAY });
+    const setPopoverContentRef = useCallback((node) => {
+        popoverContentRef.current = node;
+        togglePopoverContentMounted(Boolean(node));
+    }, []);
+    const popoverExcludedNodes = useMemo(() => [counterRef], []);
+    useClickAwayEffect({
+        ref: popoverContentRef,
+        onClickAway: closePopover,
+        isActive: isPopoverOpen && isPopoverContentMounted,
+        excludeNodes: popoverExcludedNodes,
+    });
+    const isPopoverEnabled = !isMobile && !isDisabled;
+    const handleTagClick = (event) => {
+        event.stopPropagation();
+        onClick?.(event);
+    };
+    const handleCounterClick = (event) => {
+        event.stopPropagation();
+        cancelPopoverDelay();
+        // На мобильной ширине и в заблокированном поле у счётчика прежнее поведение — список опций
+        if (!isPopoverEnabled) {
+            onClick?.(event);
+            return;
+        }
+        if (isPopoverOpen) {
+            closePopover();
+            return;
+        }
+        openPopover();
+    };
+    /**
+     * Окно живёт в портале, но синтетические события React всплывают по дереву
+     * компонентов и доходят до обработчиков поля: у MUI Select это `handleMouseDown`,
+     * который переводит фокус на поле и открывает список, у TreeLike* — `onClick` поля
+     */
+    const stopPopoverEventPropagation = (event) => {
+        event.stopPropagation();
+    };
+    const popoverContentCssVars = {
+        '--tags-list-popover-width': `${popoverWidth}px`,
+    };
     return {
         visibleOptions,
         hiddenCount,
         showCounter,
         tagsContainerRef,
+        counterRef,
         getTagProps,
+        isPopoverOpen,
+        isPopoverEnabled,
+        setPopoverContentRef,
+        popoverContentCssVars,
+        stopPopoverEventPropagation,
+        popoverAnchorEl,
+        closePopover,
+        startPopoverDelay,
+        cancelPopoverDelay,
+        handleTagClick,
+        handleCounterClick,
     };
 };

package/components/TagsList/utils/calculatePopoverWidth/calculatePopoverWidth.d.ts

@@ -0,0 +1,5 @@
+import type { Theme } from '../../../theme/types';
+/**
+ * Вычисляет ширину всплывающего окна
+ */
+export declare const calculatePopoverWidth: (fieldWidth: number, tagLabels: string[], theme: Theme) => number;

package/components/TagsList/utils/calculatePopoverWidth/calculatePopoverWidth.js

@@ -0,0 +1,22 @@
+import { POPOVER_MAX_WIDTH, POPOVER_MIN_TAGS_IN_ROW, POPOVER_TAGS_GAP_SPACING, POPOVER_TAGS_PADDING_SPACING, } from '../../constants';
+import { getTagWidth } from '../getTagWidth';
+const getSpacingValue = (theme, spacing) => parseInt(theme.spacing(spacing), 10);
+/**
+ * Минимальная ширина popover: вмещает в строку POPOVER_MIN_TAGS_IN_ROW самых
+ * широких тэгов вместе с отступом между ними и отступами контейнера
+ */
+const getMinWidth = (tagLabels, theme) => {
+    const widestTagWidths = tagLabels
+        .map((label) => getTagWidth(label, theme))
+        .sort((current, next) => next - current)
+        .slice(0, POPOVER_MIN_TAGS_IN_ROW);
+    const tagsWidth = widestTagWidths.reduce((width, tagWidth) => width + tagWidth, 0);
+    const gapsWidth = Math.max(widestTagWidths.length - 1, 0) *
+        getSpacingValue(theme, POPOVER_TAGS_GAP_SPACING);
+    const paddingsWidth = getSpacingValue(theme, POPOVER_TAGS_PADDING_SPACING) * 2;
+    return tagsWidth + gapsWidth + paddingsWidth;
+};
+/**
+ * Вычисляет ширину всплывающего окна
+ */
+export const calculatePopoverWidth = (fieldWidth, tagLabels, theme) => Math.min(Math.max(fieldWidth, getMinWidth(tagLabels, theme)), POPOVER_MAX_WIDTH);

package/components/TagsList/utils/calculatePopoverWidth/index.d.ts

@@ -0,0 +1 @@
+export * from './calculatePopoverWidth';

package/components/TagsList/utils/calculatePopoverWidth/index.js

@@ -0,0 +1 @@
+export * from './calculatePopoverWidth';

package/components/TagsList/utils/index.d.ts

@@ -3,3 +3,4 @@ export { getKey } from './getKey';
 export { getTagWidth } from './getTagWidth';
 export { getAvailableWidth } from './getAvailableWidth';
 export { calculateVisibleTagsCount } from './calculateVisibleTagsCount';
+export { calculatePopoverWidth } from './calculatePopoverWidth';

package/components/TagsList/utils/index.js

@@ -3,3 +3,4 @@ export { getKey } from './getKey';
 export { getTagWidth } from './getTagWidth';
 export { getAvailableWidth } from './getAvailableWidth';
 export { calculateVisibleTagsCount } from './calculateVisibleTagsCount';
+export { calculatePopoverWidth } from './calculatePopoverWidth';

package/components/TreeLikeAsyncAutocomplete/Input/Input.js

@@ -9,13 +9,14 @@ import { IconWrapper, StyledTagsList, StyledTextField } from './styles';
 import { useLogic } from './useLogic';
 const ClearButton = ({ disabled, onClick }) => (_jsx(IconButton, { variant: "text", color: "grey", disabled: disabled, onClick: onClick, title: CLEAR_TEXT, "aria-label": CLEAR_TEXT, children: _jsx(CrossOutlineMd, {}) }));
 export const Input = forwardRef(({ disabled, onChange: propsOnChange, value, inputRef, hideHelperText = false, onClick, isLoading, ...restProps }, forwardedRef) => {
-    const { isVisibleClearButton, isVisibleTagsList, onChange, textFieldProps, onClearAll, } = useLogic({
+    const { isVisibleClearButton, isVisibleTagsList, onChange, textFieldProps, onClearAll, fieldRef, } = useLogic({
         inputRef,
+        InputProps: restProps.InputProps,
         value,
         onChange: propsOnChange,
         disabled,
         onClick,
         isLoading,
     });
-    return (_jsx(StyledTextField, { ...restProps, hideHelperText: hideHelperText, ref: forwardedRef, disabled: disabled, inputProps: { readOnly: true }, ...textFieldProps, startAdornment: isVisibleTagsList && (_jsx(StyledTagsList, { data: value, keyId: "id", isDisabled: disabled, getOptionLabel: (option) => option.label, onClick: onClick, onChange: onChange })), endAdornment: _jsxs(IconWrapper, { children: [isVisibleClearButton && (_jsx(ClearButton, { disabled: disabled, onClick: onClearAll })), isLoading ? (_jsx(Loader, { size: "small" })) : (_jsx(IconButton, { variant: "text", color: "grey", disabled: disabled, children: _jsx(DownOutlineMd, {}) }))] }) }));
+    return (_jsx(StyledTextField, { ...restProps, hideHelperText: hideHelperText, ref: forwardedRef, disabled: disabled, inputProps: { readOnly: true }, ...textFieldProps, InputProps: { ...restProps.InputProps, ref: fieldRef }, startAdornment: isVisibleTagsList && (_jsx(StyledTagsList, { data: value, keyId: "id", isDisabled: disabled, fieldRef: fieldRef, getOptionLabel: (option) => option.label, onClick: onClick, onChange: onChange })), endAdornment: _jsxs(IconWrapper, { children: [isVisibleClearButton && (_jsx(ClearButton, { disabled: disabled, onClick: onClearAll })), isLoading ? (_jsx(Loader, { size: "small" })) : (_jsx(IconButton, { variant: "text", color: "grey", disabled: disabled, children: _jsx(DownOutlineMd, {}) }))] }) }));
 });

package/components/TreeLikeAsyncAutocomplete/Input/useLogic/useLogic.d.ts

@@ -1,13 +1,14 @@
 import { type MouseEvent, type SyntheticEvent } from 'react';
 import { type TreeLikeAsyncAutocompleteValue } from '../../types';
 import type { InputProps } from '../types';
-type UseLogicParams = Pick<InputProps, 'value' | 'disabled' | 'inputRef' | 'onChange' | 'isLoading' | 'onClick'>;
-export declare const useLogic: ({ value, disabled, isLoading, inputRef: externalInputRef, onChange: propsOnChange, onClick: propsOnClick, }: UseLogicParams) => {
+type UseLogicParams = Pick<InputProps, 'value' | 'disabled' | 'inputRef' | 'InputProps' | 'onChange' | 'isLoading' | 'onClick'>;
+export declare const useLogic: ({ value, disabled, isLoading, inputRef: externalInputRef, InputProps: externalInputProps, onChange: propsOnChange, onClick: propsOnClick, }: UseLogicParams) => {
     isVisibleClearButton: boolean;
     onClearAll: (event: SyntheticEvent<HTMLButtonElement>) => void;
     onChange: (newValue: TreeLikeAsyncAutocompleteValue | undefined) => void;
     onClick: (event: MouseEvent<HTMLDivElement>) => void;
     isVisibleTagsList: boolean;
+    fieldRef: import("react").RefObject<HTMLElement | null>;
     textFieldProps: {
         value: string;
         $isHidden: boolean;

package/components/TreeLikeAsyncAutocomplete/Input/useLogic/useLogic.js

@@ -1,7 +1,8 @@
 import { useEffect, useRef, } from 'react';
 import { useForwardedRef } from '../../../useForwardedRef';
-export const useLogic = ({ value, disabled, isLoading, inputRef: externalInputRef, onChange: propsOnChange, onClick: propsOnClick, }) => {
+export const useLogic = ({ value, disabled, isLoading, inputRef: externalInputRef, InputProps: externalInputProps, onChange: propsOnChange, onClick: propsOnClick, }) => {
     const inputRef = useForwardedRef(externalInputRef);
+    const fieldRef = useForwardedRef(externalInputProps?.ref);
     const prevValue = useRef(undefined);
     useEffect(() => {
         if (value && !prevValue.current) {
@@ -40,6 +41,7 @@ export const useLogic = ({ value, disabled, isLoading, inputRef: externalInputRe
         onChange,
         onClick,
         isVisibleTagsList: hasValue,
+        fieldRef,
         textFieldProps: {
             value: preparedValue,
             $isHidden: hasValue,

package/components/TreeLikeAutocomplete/Input/Input.js

@@ -8,7 +8,7 @@ import { EndAdornmentWrapper, StyledLoader, StyledTagsList, StyledTextField, } f
 import { useLogic } from './useLogic';
 const ClearButton = ({ disabled, onClick }) => (_jsx(IconButton, { variant: "text", color: "grey", disabled: disabled, title: CLEAR_TEXT, "aria-label": CLEAR_TEXT, onClick: onClick, children: _jsx(CrossOutlineMd, {}) }));
 export const Input = forwardRef((props, forwardedRef) => {
-    const { textFieldProps, isVisibleTagsList, isVisibleClearButton, handleChange, handleClearAll, } = useLogic(props);
+    const { textFieldProps, isVisibleTagsList, isVisibleClearButton, handleChange, handleClearAll, fieldRef, } = useLogic(props);
     const { value, valueToRender, disabled, isLoading, onChange, onClick, ...restProps } = props;
-    return (_jsx(StyledTextField, { ...restProps, ref: forwardedRef, disabled: disabled, inputProps: { readOnly: true }, startAdornment: isVisibleTagsList && (_jsx(StyledTagsList, { data: valueToRender, keyId: "id", isDisabled: disabled, getOptionLabel: (option) => option.label, onClick: onClick, onChange: handleChange })), endAdornment: _jsxs(EndAdornmentWrapper, { children: [isLoading && _jsx(StyledLoader, {}), isVisibleClearButton && (_jsx(ClearButton, { disabled: disabled, onClick: handleClearAll })), _jsx(IconButton, { variant: "text", color: "grey", disabled: disabled, children: _jsx(DownOutlineMd, {}) })] }), onClick: onClick, ...textFieldProps }));
+    return (_jsx(StyledTextField, { ...restProps, ref: forwardedRef, disabled: disabled, inputProps: { readOnly: true }, InputProps: { ...restProps.InputProps, ref: fieldRef }, startAdornment: isVisibleTagsList && (_jsx(StyledTagsList, { data: valueToRender, keyId: "id", isDisabled: disabled, fieldRef: fieldRef, getOptionLabel: (option) => option.label, onClick: onClick, onChange: handleChange })), endAdornment: _jsxs(EndAdornmentWrapper, { children: [isLoading && _jsx(StyledLoader, {}), isVisibleClearButton && (_jsx(ClearButton, { disabled: disabled, onClick: handleClearAll })), _jsx(IconButton, { variant: "text", color: "grey", disabled: disabled, children: _jsx(DownOutlineMd, {}) })] }), onClick: onClick, ...textFieldProps }));
 });

package/components/TreeLikeAutocomplete/Input/useLogic/useLogic.d.ts

@@ -2,12 +2,13 @@ import { type SyntheticEvent } from 'react';
 import { type TreeListData } from '../../../Tree';
 import type { TreeLikeAutocompleteValue } from '../../types';
 import { type InputProps } from '../types';
-export declare const useLogic: ({ value, disabled, isLoading, inputRef: externalInputRef, onChange, }: InputProps) => {
+export declare const useLogic: ({ value, disabled, isLoading, inputRef: externalInputRef, InputProps: externalInputProps, onChange, }: InputProps) => {
     textFieldProps: {
         $isHidden: boolean;
         inputRef: import("react").RefObject<HTMLInputElement | null>;
         value: string | TreeLikeAutocompleteValue;
     };
+    fieldRef: import("react").RefObject<HTMLElement | null>;
     isVisibleTagsList: boolean;
     isVisibleClearButton: boolean;
     handleChange: (newValue: TreeListData[] | undefined) => void;

package/components/TreeLikeAutocomplete/Input/useLogic/useLogic.js

@@ -1,7 +1,8 @@
 import { useEffect, useRef, } from 'react';
 import { useForwardedRef } from '../../../useForwardedRef';
-export const useLogic = ({ value, disabled, isLoading, inputRef: externalInputRef, onChange, }) => {
+export const useLogic = ({ value, disabled, isLoading, inputRef: externalInputRef, InputProps: externalInputProps, onChange, }) => {
     const inputRef = useForwardedRef(externalInputRef);
+    const fieldRef = useForwardedRef(externalInputProps?.ref);
     const prevValue = useRef(undefined);
     useEffect(() => {
         if (value && !prevValue.current) {
@@ -38,6 +39,7 @@ export const useLogic = ({ value, disabled, isLoading, inputRef: externalInputRe
             inputRef,
             value: preparedValue,
         },
+        fieldRef,
         isVisibleTagsList: hasValue,
         isVisibleClearButton,
         handleChange,

package/node/components/AsyncAutocomplete/useLogic/useLogic.d.ts

@@ -366,6 +366,7 @@ export declare const useLogic: <TOptions, TMultiple extends boolean, TDisableCle
         openOnFocus?: boolean | undefined;
         selectOnFocus?: boolean | undefined;
         loadedDataError?: string | undefined;
+        focusedHelperText?: string | undefined;
         overflowOption?: import("../..").OverflowedElementProps | undefined;
         options: TOptions[];
         disabled: boolean | undefined;

package/node/components/Autocomplete/Autocomplete.d.ts

@@ -18,4 +18,5 @@ export declare const Autocomplete: <TAutocompleteValueProps, TMultiple extends b
     openText?: string | undefined;
     clearText?: string | undefined;
     hideHelperText?: boolean | undefined;
+    focusedHelperText?: string | undefined;
 } & import("react").RefAttributes<unknown>) => import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | null;

package/node/components/Autocomplete/Autocomplete.js

@@ -16,21 +16,23 @@ const Loader_1 = require("../Loader");
 const OverflowTypography_1 = require("../OverflowTypography");
 const TagsList_1 = require("../TagsList");
 const TextField_1 = require("../TextField");
+const Typography_1 = require("../Typography");
 const cn_1 = require("../utils/cn");
 const constants_1 = require("./constants");
 const styles_1 = require("./styles");
 const useLogic_1 = require("./useLogic");
+const utils_1 = require("./utils");
 const AutocompleteInner = (props, ref) => {
     const { isValueEmpty, isPopperVisible, autocompleteProps } = (0, useLogic_1.useLogic)(props);
     const inputBaseRef = (0, react_1.useRef)(null);
-    const { required, success, error, label, getOptionLabel, helperText, inputRef, multiple, size = 'medium', placeholder = constants_1.DEFAULT_PLACEHOLDER, overflowOption, closeText = 'Закрыть', openText = 'Открыть', clearText = 'Очистить', loadingText = (0, jsx_runtime_1.jsx)(Loader_1.Loader, {}), isLoadedDataError, loadedDataError, noOptionsText, autoHighlight, renderInput: externalRenderInput, renderTags: externalRenderTags, renderOption: externalRenderOption, inputProps, hideHelperText = false, loading, value, onChange, ...restProps } = props;
+    const { required, success, error, label, getOptionLabel, helperText, inputRef, multiple, size = 'medium', placeholder = constants_1.DEFAULT_PLACEHOLDER, overflowOption, closeText = 'Закрыть', openText = 'Открыть', clearText = 'Очистить', loadingText = (0, jsx_runtime_1.jsx)(Loader_1.Loader, {}), isLoadedDataError, loadedDataError, noOptionsText, autoHighlight, renderInput: externalRenderInput, renderTags: externalRenderTags, renderOption: externalRenderOption, inputProps, hideHelperText = false, focusedHelperText, loading, value, onChange, ...restProps } = props;
     const renderInput = (0, react_1.useCallback)((inputParams) => {
         const createStartAdornment = () => {
             if (!multiple || !Array.isArray(value)) {
                 return null;
             }
-            const tagsListElement = ((0, jsx_runtime_1.jsx)(TagsList_1.TagsList, { data: value, getOptionLabel: (option) => getOptionLabel?.(option) ??
-                    option.toString(), inputContainerRef: inputBaseRef, reservedWidth: constants_1.INPUT_MIN_WIDTH, onChange: (tagValues) => {
+            return ((0, jsx_runtime_1.jsx)(TagsList_1.TagsList, { data: value, getOptionLabel: (option) => getOptionLabel?.(option) ??
+                    option.toString(), inputContainerRef: inputBaseRef, fieldRef: inputBaseRef, reservedWidth: constants_1.INPUT_MIN_WIDTH, onChange: (tagValues) => {
                     if (!onChange) {
                         return;
                     }
@@ -42,7 +44,6 @@ const AutocompleteInner = (props, ref) => {
                     const reason = 'removeOption';
                     onChange(syntheticEvent, tagValues, reason);
                 } }));
-            return tagsListElement;
         };
         const generalInputParams = {
             ...inputParams,
@@ -100,13 +101,16 @@ const AutocompleteInner = (props, ref) => {
         onChange,
     ]);
     const renderOption = (0, react_1.useCallback)((optionProps, option, optionState, ownerState) => {
+        const { key, ...restOptionProps } = optionProps;
+        if ((0, utils_1.checkIsFocusedHelperOption)(option)) {
+            return ((0, jsx_runtime_1.jsx)(styles_1.StyledFocusedHelperOption, { role: "presentation", ...restOptionProps, children: (0, jsx_runtime_1.jsx)(Typography_1.Typography, { variant: "body1", color: "grey", colorIntensity: "600", children: focusedHelperText }) }, key));
+        }
         if (externalRenderOption) {
             return externalRenderOption(optionProps, option, optionState, ownerState);
         }
         const isSelected = Boolean(optionProps['aria-selected']);
-        const { key, ...restOptionProps } = optionProps;
         return ((0, jsx_runtime_1.jsxs)(styles_1.StyledMenuItem, { selected: isSelected, ...restOptionProps, children: [multiple && ((0, jsx_runtime_1.jsx)(ListItemIcon_1.default, { children: (0, jsx_runtime_1.jsx)(Checkbox_1.Checkbox, { role: "menuitemcheckbox", checked: isSelected }) })), (0, jsx_runtime_1.jsx)(OverflowTypography_1.OverflowTypography, { rowsCount: constants_1.DEFAULT_AUTOCOMPLETE_ELEMENT_ROWS_COUNT, ...overflowOption, children: optionProps.key })] }, key));
-    }, [multiple, overflowOption, externalRenderOption]);
+    }, [focusedHelperText, multiple, overflowOption, externalRenderOption]);
     const renderPopper = (0, react_1.useCallback)((popperProps) => {
         if (!isPopperVisible) {
             return null;
@@ -123,6 +127,6 @@ const AutocompleteInner = (props, ref) => {
             popper: {
                 component: renderPopper,
             },
-        }, getOptionLabel: getOptionLabel, renderInput: renderInput, renderTags: renderTags, renderOption: renderOption, value: value, onChange: onChange, ...autocompleteProps }));
+        }, renderInput: renderInput, renderTags: renderTags, renderOption: renderOption, value: value, ...autocompleteProps }));
 };
 exports.Autocomplete = (0, forwardRefWithGeneric_1.forwardRefWithGeneric)(AutocompleteInner);