@astral/ui 4.100.0 → 4.101.0

package/components/InfiniteTreeList/InfiniteTreeList.d.ts

@@ -1,2 +1,20 @@
 import type { InfiniteTreeListData, InfiniteTreeListProps } from './types';
+/**
+ * Виртуализированное дерево с бесконечной подгрузкой
+ *
+ * @example
+ * <InfiniteTreeList
+ *   items={items}
+ *   scrollRef={scrollRef}
+ *   onRetry={refetch}
+ *   renderItem={(item) => (
+ *     <InfiniteTreeListItem>{item.name}</InfiniteTreeListItem>
+ *   )}
+ *   renderParent={(item) => (
+ *     <InfiniteTreeListItem childItems={childrenState[item.id]?.data}>
+ *       {item.name}
+ *     </InfiniteTreeListItem>
+ *   )}
+ * />
+ */
 export declare const InfiniteTreeList: <TData extends InfiniteTreeListData<TData>>(props: InfiniteTreeListProps<TData>) => import("react/jsx-runtime").JSX.Element;

package/components/InfiniteTreeList/InfiniteTreeList.js

@@ -1,27 +1,34 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+// cspell:ignore Виртуализированное
 import { Virtuoso } from 'react-virtuoso';
 import { ContentState } from '../ContentState';
-import { Loader } from '../Loader';
-import { OVERSCAN } from './constants';
-import { EndData } from './EndData';
-import { ErrorMessage } from './ErrorMessage';
-import { InfiniteTreeListContextProvider } from './InfiniteTreeListContext';
-import { TreeListItemContextProvider } from './InfiniteTreeListItem';
+import { InfiniteTreeListContextProvider, } from './InfiniteTreeListContext';
+import { ListFooter } from './ListFooter';
 import { NoDataPlaceholder } from './NoDataPlaceholder';
 import { OnTopButton } from './OnTopButton';
-import { Footer, FooterDummy } from './styles';
+import { ParentItems } from './ParentItems';
 import { TreeItem } from './TreeItem';
 import { useLogic } from './useLogic';
+const computeItemKey = (_, item) => item.id;
+/**
+ * Виртуализированное дерево с бесконечной подгрузкой
+ *
+ * @example
+ * <InfiniteTreeList
+ *   items={items}
+ *   scrollRef={scrollRef}
+ *   onRetry={refetch}
+ *   renderItem={(item) => (
+ *     <InfiniteTreeListItem>{item.name}</InfiniteTreeListItem>
+ *   )}
+ *   renderParent={(item) => (
+ *     <InfiniteTreeListItem childItems={childrenState[item.id]?.data}>
+ *       {item.name}
+ *     </InfiniteTreeListItem>
+ *   )}
+ * />
+ */
 export const InfiniteTreeList = (props) => {
-    const { flatList, onToggle, contentStateProps, scrollParent, virtuosoProps, footerProps, onTopButtonProps, endOfScrollMsg, renderItem, items, itemSkeleton, onRetry, onLoadMore, noDataImgSrc, recentlyExpandedIds, } = useLogic(props);
-    const renderItemContent = (_index, item) => (_jsx(TreeListItemContextProvider, { item: item, onToggle: onToggle, children: _jsx(TreeItem, { item: item, renderItem: renderItem, recentlyExpandedIds: recentlyExpandedIds }) }));
-    return (_jsx(InfiniteTreeListContextProvider, { itemSkeleton: itemSkeleton, children: _jsx(ContentState, { ...contentStateProps, children: items.length && scrollParent ? (_jsxs(_Fragment, { children: [_jsx(Virtuoso, { ...virtuosoProps, data: flatList, customScrollParent: scrollParent, endReached: onLoadMore, itemContent: renderItemContent, computeItemKey: (_, item) => item.id, components: {
-                            Footer: () => {
-                                const { isLoading, isError, isEndReached } = footerProps;
-                                if (!isLoading && !isError && !isEndReached) {
-                                    return _jsx(FooterDummy, {});
-                                }
-                                return (_jsxs(Footer, { children: [isLoading && _jsx(Loader, {}), isError && _jsx(ErrorMessage, { onRetry: onRetry }), isEndReached && (_jsx(EndData, { endOfScrollMsg: endOfScrollMsg }))] }));
-                            },
-                        }, overscan: OVERSCAN }), _jsx(OnTopButton, { ...onTopButtonProps })] })) : (_jsx(NoDataPlaceholder, { noDataImgSrc: noDataImgSrc })) }) }));
+    const { flatList, onToggle, contentStateProps, scrollParent, virtuosoProps, footerContext, onTopButtonProps, renderItem, renderParent, items, itemSkeleton, onRetry, noDataImgSrc, enterAnimation, tailRegistry, nodePaginationMap, registerChildren, notifyExpand, parentItems, acquireParentSlot, } = useLogic(props);
+    return (_jsxs(InfiniteTreeListContextProvider, { itemSkeleton: itemSkeleton, nodePaginationMap: nodePaginationMap, registerChildren: registerChildren, notifyExpand: notifyExpand, onListRetry: onRetry, enterAnimation: enterAnimation, tailRegistry: tailRegistry, renderItem: renderItem, renderParent: renderParent, onToggle: onToggle, acquireParentSlot: acquireParentSlot, children: [_jsx(ParentItems, { parents: parentItems }), _jsx(ContentState, { ...contentStateProps, children: items.length > 0 && scrollParent ? (_jsxs(_Fragment, { children: [_jsx(Virtuoso, { ...virtuosoProps, data: flatList, customScrollParent: scrollParent, computeItemKey: computeItemKey, context: footerContext, components: { Item: TreeItem, Footer: ListFooter } }), _jsx(OnTopButton, { ...onTopButtonProps })] })) : (_jsx(NoDataPlaceholder, { noDataImgSrc: noDataImgSrc })) })] }));
 };

package/components/InfiniteTreeList/InfiniteTreeListActions/InfiniteTreeListActions.d.ts

@@ -1,2 +1,11 @@
 import type { InfiniteTreeListActionProps } from './types';
+/**
+ * Действия строки дерева. Блокирующее действие в состоянии загрузки блокирует
+ * строку вместе со всей её веткой
+ *
+ * @example
+ * <InfiniteTreeListActions
+ *   actions={{ main: [{ name: 'Изменить', onClick: handleEdit }] }}
+ * />
+ */
 export declare const InfiniteTreeListActions: <TItem>({ actions, }: InfiniteTreeListActionProps<TItem>) => import("react/jsx-runtime").JSX.Element;

package/components/InfiniteTreeList/InfiniteTreeListActions/InfiniteTreeListActions.js

@@ -1,6 +1,15 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { ActionCellBase } from '../../ActionCellBase';
 import { useLogic } from './useLogic';
+/**
+ * Действия строки дерева. Блокирующее действие в состоянии загрузки блокирует
+ * строку вместе со всей её веткой
+ *
+ * @example
+ * <InfiniteTreeListActions
+ *   actions={{ main: [{ name: 'Изменить', onClick: handleEdit }] }}
+ * />
+ */
 export const InfiniteTreeListActions = ({ actions, }) => {
     const { isDisabledAction, handleWrapperClick, handleActionClick } = useLogic({
         actions,

package/components/InfiniteTreeList/InfiniteTreeListActions/types.d.ts

@@ -1,4 +1,9 @@
 import type { Actions } from '../../ActionCellBase';
 export type InfiniteTreeListActionProps<TItem> = {
+    /**
+     * Конфигурация действий строки
+     *
+     * @example actions={{ main: [{ name: 'Изменить', onClick: handleEdit }] }}
+     */
     actions: Actions<TItem>;
 };

package/components/InfiniteTreeList/InfiniteTreeListActions/useLogic/useLogic.js

@@ -7,17 +7,16 @@ export const useLogic = ({ actions }) => {
     const { setDisabled } = useContext(InfiniteTreeListContext);
     const blockingAction = useMemo(() => [...main, ...secondary].find((action) => action.isBlockingOperation && action.loading), [main, secondary]);
     const isDisabledAction = Boolean(blockingAction);
+    const loadingNote = blockingAction?.loadingNote;
     useEffect(() => {
-        if (blockingAction) {
-            // Добавляем id элемента в Set disabled элементов
+        if (isDisabledAction) {
             setDisabled(item.id, true);
-            setDisabledReason(blockingAction?.loadingNote);
+            setDisabledReason(loadingNote);
             return;
         }
-        // Удаляем id элемента из Set disabled элементов
         setDisabled(item.id, false);
-        setDisabledReason('');
-    }, [blockingAction, item.id]);
+        setDisabledReason(undefined);
+    }, [isDisabledAction, loadingNote, item.id]);
     const handleActionClick = useCallback((onClick) => () => {
         onClick?.(item);
     }, [item]);

package/components/InfiniteTreeList/InfiniteTreeListContext/InfiniteTreeListContext.d.ts

@@ -1,7 +1,88 @@
 import { type ReactNode } from 'react';
+import type { EnterAnimationResult } from '../hooks';
+import type { FlattenTree, InfiniteTreeChildrenPagination, InfiniteTreeListData } from '../types';
+import type { TailRegistry } from '../utils';
+export type NodePagination = {
+    /**
+     * ID последнего загруженного дочернего элемента узла
+     */
+    lastChildId?: string;
+    /**
+     * Все дочерние данные узла загружены
+     */
+    isEndReached?: boolean;
+    /**
+     * Дочерние элементы узла загружаются
+     */
+    isChildrenLoading?: boolean;
+    /**
+     * Загрузка дочерних элементов завершилась ошибкой
+     */
+    isChildrenError?: boolean;
+};
+export type NodeChildrenCallbacks = {
+    /**
+     * Обработчик подгрузки данных
+     */
+    onLoadMore?: () => void;
+    /**
+     * Функция обработки нажатия на кнопку "Повторить запрос"
+     */
+    onRetry?: () => void;
+};
 export type InfiniteTreeListContextProps = {
+    /**
+     * Рендер-функция строки
+     */
+    renderItem: (item: FlattenTree<InfiniteTreeListData>) => ReactNode;
+    /**
+     * Рендер-функция строки узла с подгружаемыми дочерними элементами
+     */
+    renderParent: (item: FlattenTree<InfiniteTreeListData>) => ReactNode;
+    /**
+     * Переключает раскрытие узла
+     */
+    onToggle: (item: InfiniteTreeListData) => void;
+    /**
+     * Строка в состоянии загрузки
+     */
     itemSkeleton: ReactNode;
+    /**
+     * Id заблокированных узлов
+     */
     disabledIdList: Set<string>;
+    /**
+     * Отмечает узел заблокированным или снимает отметку
+     */
     setDisabled: (itemId: string, disabled: boolean) => void;
+    /**
+     * Данные пагинации узлов по parentId
+     */
+    nodePaginationMap: Record<string, NodePagination>;
+    /**
+     * Регистрирует callback-функции загрузки дочерних элементов узла
+     */
+    registerChildrenCallbacks: (itemId: string, callbacks: NodeChildrenCallbacks) => void;
+    /**
+     * Передаёт состояние загрузки дочерних элементов в список. Список
+     * синхронизирует плоский список
+     */
+    registerChildren: (itemId: string, childrenState: InfiniteTreeChildrenPagination) => void;
+    /**
+     * Оповещает список о раскрытии узла
+     */
+    notifyExpand: (itemId: string, onOpen?: () => void) => void;
+    onLoadMore: (parentId: string) => void;
+    onRetry: (parentId: string) => void;
+    enterAnimation: EnterAnimationResult;
+    /**
+     * Реестр хвостов вложенных веток. Переживает размонтирование строки
+     */
+    tailRegistry: TailRegistry;
+    /**
+     * Отдаёт постоянный DOM-контейнер строки узла: строка монтируется вне
+     * виртуализации, а её контейнер переносится в строку скролла
+     */
+    acquireParentSlot: (itemId: string) => HTMLDivElement | null;
 };
 export declare const InfiniteTreeListContext: import("react").Context<InfiniteTreeListContextProps>;

package/components/InfiniteTreeList/InfiniteTreeListContext/InfiniteTreeListContext.js

@@ -1,6 +1,27 @@
 import { createContext } from 'react';
 export const InfiniteTreeListContext = createContext({
+    renderItem: () => null,
+    renderParent: () => null,
+    onToggle: () => undefined,
     itemSkeleton: '',
     disabledIdList: new Set(),
     setDisabled: () => undefined,
+    nodePaginationMap: {},
+    registerChildrenCallbacks: () => undefined,
+    registerChildren: () => undefined,
+    notifyExpand: () => undefined,
+    onLoadMore: () => undefined,
+    onRetry: () => undefined,
+    enterAnimation: {
+        schedule: () => undefined,
+        read: () => ({ shouldAnimate: false }),
+        claim: () => undefined,
+        reset: () => undefined,
+    },
+    tailRegistry: {
+        register: () => undefined,
+        unregister: () => undefined,
+        checkRange: () => undefined,
+    },
+    acquireParentSlot: () => null,
 });

package/components/InfiniteTreeList/InfiniteTreeListContext/InfiniteTreeListContextProvider/InfiniteTreeListContextProvider.d.ts

@@ -1,7 +1,8 @@
 import { type ReactNode } from 'react';
 import { type InfiniteTreeListContextProps } from '../InfiniteTreeListContext';
-type Props = Pick<InfiniteTreeListContextProps, 'itemSkeleton'> & {
+type Props = Pick<InfiniteTreeListContextProps, 'itemSkeleton' | 'nodePaginationMap' | 'enterAnimation' | 'tailRegistry' | 'registerChildren' | 'notifyExpand' | 'renderItem' | 'renderParent' | 'onToggle' | 'acquireParentSlot'> & {
     children: ReactNode;
+    onListRetry: () => void;
 };
-export declare const InfiniteTreeListContextProvider: ({ children, itemSkeleton, }: Props) => import("react/jsx-runtime").JSX.Element;
+export declare const InfiniteTreeListContextProvider: ({ children, itemSkeleton, nodePaginationMap, onListRetry, registerChildren, notifyExpand, enterAnimation, tailRegistry, renderItem, renderParent, onToggle, acquireParentSlot, }: Props) => import("react/jsx-runtime").JSX.Element;
 export {};

package/components/InfiniteTreeList/InfiniteTreeListContext/InfiniteTreeListContextProvider/InfiniteTreeListContextProvider.js

@@ -1,16 +1,72 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useSet } from '../../../useSet';
+import { useCallback, useMemo, useRef, useState } from 'react';
 import { InfiniteTreeListContext, } from '../InfiniteTreeListContext';
-export const InfiniteTreeListContextProvider = ({ children, itemSkeleton, }) => {
-    const [disabledIdList, disabledIdListActions] = useSet(new Set());
-    const setDisabled = (itemId, disabled) => {
-        disabled
-            ? disabledIdListActions.add(itemId)
-            : disabledIdListActions.remove(itemId);
-    };
-    return (_jsx(InfiniteTreeListContext.Provider, { value: {
-            itemSkeleton,
-            disabledIdList,
-            setDisabled,
-        }, children: children }));
+export const InfiniteTreeListContextProvider = ({ children, itemSkeleton, nodePaginationMap, onListRetry, registerChildren, notifyExpand, enterAnimation, tailRegistry, renderItem, renderParent, onToggle, acquireParentSlot, }) => {
+    const [disabledIdList, setDisabledIdList] = useState(new Set());
+    const childrenCallbacksRef = useRef({});
+    const setDisabled = useCallback((itemId, disabled) => {
+        setDisabledIdList((prev) => {
+            // Сохранение ссылки на Set при отсутствии изменений предотвращает
+            // бесконечный ре-рендер потребителей контекста
+            if (prev.has(itemId) === disabled) {
+                return prev;
+            }
+            const next = new Set(prev);
+            if (disabled) {
+                next.add(itemId);
+            }
+            else {
+                next.delete(itemId);
+            }
+            return next;
+        });
+    }, []);
+    const registerChildrenCallbacks = useCallback((itemId, callbacks) => {
+        childrenCallbacksRef.current[itemId] = callbacks;
+    }, []);
+    const onLoadMore = useCallback((parentId) => {
+        childrenCallbacksRef.current[parentId]?.onLoadMore?.();
+    }, []);
+    const onRetry = useCallback((parentId) => {
+        const retryChildren = childrenCallbacksRef.current[parentId]?.onRetry;
+        if (retryChildren) {
+            retryChildren();
+            return;
+        }
+        onListRetry();
+    }, [onListRetry]);
+    const value = useMemo(() => ({
+        renderItem,
+        renderParent,
+        onToggle,
+        itemSkeleton,
+        disabledIdList,
+        setDisabled,
+        nodePaginationMap,
+        registerChildrenCallbacks,
+        registerChildren,
+        notifyExpand,
+        onLoadMore,
+        onRetry,
+        enterAnimation,
+        tailRegistry,
+        acquireParentSlot,
+    }), [
+        renderItem,
+        renderParent,
+        onToggle,
+        itemSkeleton,
+        disabledIdList,
+        setDisabled,
+        nodePaginationMap,
+        registerChildrenCallbacks,
+        registerChildren,
+        notifyExpand,
+        onLoadMore,
+        onRetry,
+        enterAnimation,
+        tailRegistry,
+        acquireParentSlot,
+    ]);
+    return (_jsx(InfiniteTreeListContext.Provider, { value: value, children: children }));
 };

package/components/InfiniteTreeList/InfiniteTreeListItem/ErrorPlaceholder/ErrorPlaceholder.d.ts

@@ -0,0 +1,6 @@
+type ErrorPlaceholderProps = {
+    onRetry: () => void;
+    errorMsg?: string;
+};
+export declare const ErrorPlaceholder: ({ onRetry, errorMsg, }: ErrorPlaceholderProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/components/InfiniteTreeList/InfiniteTreeListItem/ErrorPlaceholder/ErrorPlaceholder.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from '../../../Button';
+import { Typography } from '../../../Typography';
+import { DEFAULT_ERROR_MESSAGE } from './constants';
+import { Wrapper } from './styles';
+export const ErrorPlaceholder = ({ onRetry, errorMsg = DEFAULT_ERROR_MESSAGE, }) => {
+    return (_jsxs(Wrapper, { children: [_jsx(Typography, { color: "grey", colorIntensity: "600", children: errorMsg }), _jsx(Button, { onClick: onRetry, variant: "link", children: "\u041F\u043E\u043F\u0440\u043E\u0431\u043E\u0432\u0430\u0442\u044C \u0441\u043D\u043E\u0432\u0430" })] }));
+};

package/components/InfiniteTreeList/InfiniteTreeListItem/ErrorPlaceholder/constants.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_ERROR_MESSAGE = "\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u0437\u0430\u0433\u0440\u0443\u0437\u0438\u0442\u044C \u0434\u0430\u043D\u043D\u044B\u0435";

package/components/InfiniteTreeList/InfiniteTreeListItem/ErrorPlaceholder/constants.js

@@ -0,0 +1 @@
+export const DEFAULT_ERROR_MESSAGE = 'Не удалось загрузить данные';

package/components/InfiniteTreeList/InfiniteTreeListItem/ErrorPlaceholder/index.d.ts

@@ -0,0 +1 @@
+export { ErrorPlaceholder } from './ErrorPlaceholder';

package/components/InfiniteTreeList/InfiniteTreeListItem/ErrorPlaceholder/index.js

@@ -0,0 +1 @@
+export { ErrorPlaceholder } from './ErrorPlaceholder';

package/components/InfiniteTreeList/{ErrorMessage → InfiniteTreeListItem/ErrorPlaceholder}/styles.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="react" />
-export declare const Wrapper: import("../../styled").StyledComponent<{
+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>, {}>;

package/components/InfiniteTreeList/InfiniteTreeListItem/ErrorPlaceholder/styles.js

@@ -0,0 +1,8 @@
+import { styled } from '../../../styled';
+export const Wrapper = styled.div `
+  display: flex;
+  gap: ${({ theme }) => theme.spacing(5)};
+  align-items: center;
+
+  padding: ${({ theme }) => theme.spacing(0, 4)};
+`;

package/components/InfiniteTreeList/InfiniteTreeListItem/InfiniteTreeListItem.js

@@ -1,15 +1,37 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Chevron } from '../../Chevron';
 import { ContentState } from '../../ContentState';
+import { Loader } from '../../Loader';
 import { Tooltip } from '../../Tooltip';
+import { cn } from '../../utils/cn';
+import { cva } from '../../utils/cva';
 import { getInertProps } from '../../utils/getInertProps';
-import { ActionsWrapper, Wrapper } from './styles';
+import { infiniteTreeListItemClassnames } from './constants';
+import { ErrorPlaceholder } from './ErrorPlaceholder';
+import { ActionsWrapper, LoaderWrapper, Wrapper } from './styles';
 import { useLogic } from './useLogic';
+const infiniteTreeListItemCva = cva(infiniteTreeListItemClassnames.root, {
+    variants: {
+        isDisabled: {
+            true: infiniteTreeListItemClassnames.disabled,
+        },
+        isLoading: {
+            true: infiniteTreeListItemClassnames.loading,
+        },
+        hasNested: {
+            true: infiniteTreeListItemClassnames.hasNested,
+        },
+    },
+});
 export const InfiniteTreeListItem = (props) => {
-    const { itemSkeleton, item, handleClick, isDisabledByActions, tooltipProps, isChevronActive, } = useLogic(props);
-    const { isDisabled, className, onRetry = () => undefined, actions, errorMsg, isError, isLoading, children, } = props;
-    return (_jsx(ContentState, { isLoading: isLoading, loadingContent: _jsx(Wrapper, { "$isLoading": true, children: itemSkeleton }), isError: isError, errorState: {
-            onRetry,
-            errorList: [errorMsg || ''],
-        }, children: _jsx(Tooltip, { ...tooltipProps, children: _jsxs(Wrapper, { onClick: handleClick, className: className, "$isDisabled": isDisabled || isDisabledByActions, "$isLoading": isLoading, "$hasNested": item.meta.hasNested, ...getInertProps(isDisabled || isDisabledByActions), children: [item.meta.hasNested && _jsx(Chevron, { isActive: isChevronActive }), children, actions && _jsx(ActionsWrapper, { children: actions })] }, `infinite-tree-list-item-${item.id}`) }) }));
+    const { itemSkeleton, item, handleClick, isDisabledByActions, tooltipProps, isChevronActive, isRowLoading, isRowError, } = useLogic(props);
+    const { isDisabled, className, onRetry = () => undefined, actions, errorMsg, children, } = props;
+    if (isRowError) {
+        return _jsx(ErrorPlaceholder, { onRetry: onRetry, errorMsg: errorMsg });
+    }
+    return (_jsx(ContentState, { isLoading: isRowLoading, isSmoothLoading: false, loadingContent: _jsx(Wrapper, { className: infiniteTreeListItemCva({ isLoading: true }), children: itemSkeleton || (_jsx(LoaderWrapper, { children: _jsx(Loader, {}) })) }), children: _jsx(Tooltip, { ...tooltipProps, children: _jsxs(Wrapper, { onClick: handleClick, className: cn(infiniteTreeListItemCva({
+                    isDisabled: Boolean(isDisabled || isDisabledByActions),
+                    isLoading: isRowLoading,
+                    hasNested: item.meta.hasNested,
+                }), className), ...getInertProps(isDisabled || isDisabledByActions), children: [item.meta.hasNested && _jsx(Chevron, { isActive: isChevronActive }), children, actions && _jsx(ActionsWrapper, { children: actions })] }, `infinite-tree-list-item-${item.id}`) }) }));
 };

package/components/InfiniteTreeList/InfiniteTreeListItem/TreeListItemContext/TreeListItemContext.d.ts

@@ -1,10 +1,29 @@
 /// <reference types="react" />
 import type { FlattenTree, InfiniteTreeListData } from '../../types';
 export type TreeListItemContextProps = {
+    /**
+     * Строка плоского списка, для которой рендерится содержимое
+     */
     item: FlattenTree<InfiniteTreeListData>;
+    /**
+     * Переключает раскрытие узла строки
+     */
     onToggle: (item: InfiniteTreeListData) => void;
+    /**
+     * Строка заблокирована: своим действием или действием родителя
+     */
     isDisabled: boolean;
+    /**
+     * Причина блокировки. Показывается в tooltip строки
+     */
     disabledReason?: string;
+    /**
+     * Записывает причину блокировки
+     */
     setDisabledReason: (disabledReason?: string) => void;
 };
+/**
+ * Контекст одной строки дерева: сама строка и её состояние блокировки.
+ * Отделён от контекста списка — значение у каждой строки своё
+ */
 export declare const TreeListItemContext: import("react").Context<TreeListItemContextProps>;

package/components/InfiniteTreeList/InfiniteTreeListItem/TreeListItemContext/TreeListItemContext.js

@@ -1,4 +1,8 @@
 import { createContext } from 'react';
+/**
+ * Контекст одной строки дерева: сама строка и её состояние блокировки.
+ * Отделён от контекста списка — значение у каждой строки своё
+ */
 export const TreeListItemContext = createContext({
     item: {},
     onToggle: () => undefined,

package/components/InfiniteTreeList/InfiniteTreeListItem/TreeListItemContext/TreeListItemContextProvider/TreeListItemContextProvider.d.ts

@@ -3,5 +3,9 @@ import { type TreeListItemContextProps } from '../TreeListItemContext';
 type Props = Pick<TreeListItemContextProps, 'item' | 'onToggle'> & {
     children: ReactNode;
 };
+/**
+ * Ставит контекст строки: считает блокировку по пути узла и отдаёт вниз
+ * саму строку с её причиной блокировки
+ */
 export declare const TreeListItemContextProvider: ({ item, children, onToggle, }: Props) => import("react/jsx-runtime").JSX.Element;
 export {};

package/components/InfiniteTreeList/InfiniteTreeListItem/TreeListItemContext/TreeListItemContextProvider/TreeListItemContextProvider.js

@@ -2,17 +2,22 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useContext, useMemo, useState } from 'react';
 import { InfiniteTreeListContext } from '../../../InfiniteTreeListContext';
 import { TreeListItemContext, } from '../TreeListItemContext';
+/**
+ * Ставит контекст строки: считает блокировку по пути узла и отдаёт вниз
+ * саму строку с её причиной блокировки
+ */
 export const TreeListItemContextProvider = ({ item, children, onToggle, }) => {
     const [disabledReason, setDisabledReason] = useState();
     const { disabledIdList } = useContext(InfiniteTreeListContext);
     const isDisabled = useMemo(() => {
         return item.meta.path.some((id) => disabledIdList.has(id));
-    }, [item.path, disabledIdList]);
-    return (_jsx(TreeListItemContext.Provider, { value: {
-            item,
-            onToggle,
-            isDisabled,
-            disabledReason,
-            setDisabledReason,
-        }, children: children }));
+    }, [item.meta.path, disabledIdList]);
+    const value = useMemo(() => ({
+        item,
+        onToggle,
+        isDisabled,
+        disabledReason,
+        setDisabledReason,
+    }), [item, onToggle, isDisabled, disabledReason]);
+    return (_jsx(TreeListItemContext.Provider, { value: value, children: children }));
 };

package/components/InfiniteTreeList/InfiniteTreeListItem/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const infiniteTreeListItemClassnames: {
+    root: string;
+    disabled: string;
+    loading: string;
+    hasNested: string;
+};

package/components/InfiniteTreeList/InfiniteTreeListItem/constants.js

@@ -0,0 +1,7 @@
+import { createUIKitClassname } from '../../utils/createUIKitClassname';
+export const infiniteTreeListItemClassnames = {
+    root: createUIKitClassname('infinite-tree-list__item'),
+    disabled: createUIKitClassname('infinite-tree-list__item_disabled'),
+    loading: createUIKitClassname('infinite-tree-list__item_loading'),
+    hasNested: createUIKitClassname('infinite-tree-list__item_has-nested'),
+};

package/components/InfiniteTreeList/InfiniteTreeListItem/styles.d.ts

@@ -2,12 +2,12 @@
 export declare const Wrapper: import("../../styled").StyledComponent<{
     theme?: import("@emotion/react").Theme | undefined;
     as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;
-} & {
-    $isDisabled?: boolean | undefined;
-    $isLoading?: boolean | undefined;
-    $hasNested?: boolean | undefined;
 }, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 export declare const ActionsWrapper: 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 LoaderWrapper: 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/InfiniteTreeList/InfiniteTreeListItem/styles.js

@@ -1,6 +1,7 @@
 import { styled } from '../../styled';
+import { infiniteTreeListItemClassnames } from './constants';
 export const Wrapper = styled.div `
-  cursor: ${({ $isDisabled, $isLoading, $hasNested }) => $hasNested && !$isLoading && !$isDisabled ? 'pointer' : 'default'};
+  cursor: default;
 
   display: flex;
   gap: ${({ theme }) => theme.spacing(3)};
@@ -10,7 +11,6 @@ export const Wrapper = styled.div `
   min-height: 60px;
   padding: ${({ theme }) => theme.spacing(3, 4)};
 
-  opacity: ${({ $isDisabled }) => ($isDisabled ? 0.5 : 1)};
   background: ${({ theme }) => theme.palette.background.default};
 
   transition: ${({ theme }) => theme.transitions.create('background-color', {
@@ -19,9 +19,26 @@ export const Wrapper = styled.div `
 })};
 
   &:hover {
-    background-color: ${({ theme, $isDisabled, $isLoading }) => $isDisabled || $isLoading
-    ? theme.palette.background.default
-    : theme.palette.background.elementHover};
+    background-color: ${({ theme }) => theme.palette.background.elementHover};
+  }
+
+  &.${infiniteTreeListItemClassnames.hasNested} {
+    cursor: pointer;
+  }
+
+  &.${infiniteTreeListItemClassnames.loading} {
+    cursor: default;
+  }
+
+  &.${infiniteTreeListItemClassnames.disabled} {
+    cursor: default;
+
+    opacity: 0.5;
+  }
+
+  &.${infiniteTreeListItemClassnames.loading}:hover,
+  &.${infiniteTreeListItemClassnames.disabled}:hover {
+    background-color: ${({ theme }) => theme.palette.background.default};
   }
 `;
 export const ActionsWrapper = styled.div `
@@ -29,3 +46,9 @@ export const ActionsWrapper = styled.div `
 
   margin-left: auto;
 `;
+export const LoaderWrapper = styled.div `
+  display: flex;
+  justify-content: center;
+
+  width: 100%;
+`;