@astral/ui 4.100.0 → 4.101.0

package/components/InfiniteTreeList/utils/getIdsToKeep/index.d.ts

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

package/components/InfiniteTreeList/utils/getIdsToKeep/index.js

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

package/components/InfiniteTreeList/{useLogic/utils → utils}/getInitialExpandedIds/getInitialExpandedIds.d.ts

@@ -1,5 +1,7 @@
-import type { InfiniteTreeListData } from '../../../types';
+import type { InfiniteTreeListData } from '../../types';
 /**
- * Получает начальный набор раскрытых узлов
+ * Получает начальный набор раскрытых узлов.
+ * Узел с подгружаемыми дочерними элементами раскрывается наравне
+ * со статической веткой
  */
 export declare const getInitialExpandedIds: <TData extends InfiniteTreeListData<TData>>(prev: Set<string>, items: TData[], initialExpandedLevel?: number, currentLevel?: number) => Set<string>;

package/components/InfiniteTreeList/{useLogic/utils → utils}/getInitialExpandedIds/getInitialExpandedIds.js

@@ -1,19 +1,20 @@
 /**
- * Получает начальный набор раскрытых узлов
+ * Получает начальный набор раскрытых узлов.
+ * Узел с подгружаемыми дочерними элементами раскрывается наравне
+ * со статической веткой
  */
 export const getInitialExpandedIds = (prev, items, initialExpandedLevel, currentLevel = 0) => {
     const expandedIds = new Set(prev);
-    // Более точная проверка
     if (initialExpandedLevel === undefined) {
         return expandedIds;
     }
     const shouldExpand = currentLevel < initialExpandedLevel;
     items.forEach((item) => {
-        if (shouldExpand && item.children) {
+        const hasNested = Boolean(item.children) || item.hasChildren === true;
+        if (shouldExpand && hasNested) {
             if (!prev?.has(item.id)) {
                 expandedIds.add(item.id);
             }
-            // Рекурсивно обрабатываем существующих детей
             if (item.children?.length) {
                 const childExpandedIds = getInitialExpandedIds(prev, item.children, initialExpandedLevel, currentLevel + 1);
                 childExpandedIds.forEach((id) => expandedIds.add(id));

package/components/InfiniteTreeList/utils/getNestedItems/getNestedItems.d.ts

@@ -0,0 +1,6 @@
+import type { FlattenTree, InfiniteTreeListData } from '../../types';
+/**
+ * Собирает вложенные строки узла из плоского списка.
+ * Свёрнутых веток в списке нет
+ */
+export declare const getNestedItems: <TData extends InfiniteTreeListData<TData>>(flatList: FlattenTree<TData>[], parentId: string) => FlattenTree<TData>[];

package/components/InfiniteTreeList/utils/getNestedItems/getNestedItems.js

@@ -0,0 +1,18 @@
+/**
+ * Собирает вложенные строки узла из плоского списка.
+ * Свёрнутых веток в списке нет
+ */
+export const getNestedItems = (flatList, parentId) => {
+    const result = [];
+    const collectChildren = (id) => {
+        const children = flatList.filter((item) => item.meta.parentId === id);
+        children.forEach((child) => {
+            result.push(child);
+            if (child.meta.isExpanded) {
+                collectChildren(child.id);
+            }
+        });
+    };
+    collectChildren(parentId);
+    return result;
+};

package/components/InfiniteTreeList/utils/getNestedItems/index.d.ts

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

package/components/InfiniteTreeList/utils/getNestedItems/index.js

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

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

@@ -0,0 +1,20 @@
+export * from './checkHasSkeletonPlaceholders';
+export * from './checkIsChildrenPlaceholder';
+export * from './checkIsChildrenPlaceholderOf';
+export * from './checkIsDirectChild';
+export * from './checkIsNoDataChildren';
+export * from './checkIsSameChildren';
+export * from './countDirectChildren';
+export * from './createParentSlots';
+export * from './createTailRegistry';
+export * from './flattenChildren';
+export * from './flattenTree';
+export * from './getEnteringChildren';
+export * from './getIdsToKeep';
+export * from './getInitialExpandedIds';
+export * from './getNestedItems';
+export * from './insertChildren';
+export * from './removeChildren';
+export * from './sortCollapsed';
+export * from './startRemoveAnimation';
+export * from './syncChildrenPlaceholders';

package/components/InfiniteTreeList/utils/index.js

@@ -0,0 +1,20 @@
+export * from './checkHasSkeletonPlaceholders';
+export * from './checkIsChildrenPlaceholder';
+export * from './checkIsChildrenPlaceholderOf';
+export * from './checkIsDirectChild';
+export * from './checkIsNoDataChildren';
+export * from './checkIsSameChildren';
+export * from './countDirectChildren';
+export * from './createParentSlots';
+export * from './createTailRegistry';
+export * from './flattenChildren';
+export * from './flattenTree';
+export * from './getEnteringChildren';
+export * from './getIdsToKeep';
+export * from './getInitialExpandedIds';
+export * from './getNestedItems';
+export * from './insertChildren';
+export * from './removeChildren';
+export * from './sortCollapsed';
+export * from './startRemoveAnimation';
+export * from './syncChildrenPlaceholders';

package/components/InfiniteTreeList/utils/insertChildren/index.d.ts

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

package/components/InfiniteTreeList/utils/insertChildren/index.js

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

package/components/InfiniteTreeList/utils/insertChildren/insertChildren.d.ts

@@ -0,0 +1,5 @@
+import type { FlattenTree, InfiniteTreeListData } from '../../types';
+/**
+ * Вставляет дочерние элементы после родителя в плоский список.
+ */
+export declare const insertChildren: <TData extends InfiniteTreeListData<TData>>(flatList: FlattenTree<TData>[], parentId: string, childrenData: TData[], expandedIds: Set<string>) => FlattenTree<TData>[];

package/components/InfiniteTreeList/utils/insertChildren/insertChildren.js

@@ -0,0 +1,41 @@
+import { checkIsDirectChild } from '../checkIsDirectChild';
+import { flattenChildren } from '../flattenChildren';
+import { getNestedItems } from '../getNestedItems';
+/**
+ * Возвращает прямых дочерних элементов родителя из плоского списка
+ */
+const getDirectChildren = (flatList, parentId) => flatList.filter((item) => checkIsDirectChild(item, parentId));
+/**
+ * Вставляет дочерние элементы после родителя в плоский список.
+ */
+export const insertChildren = (flatList, parentId, childrenData, expandedIds) => {
+    const parentIndex = flatList.findIndex((item) => item.id === parentId);
+    if (parentIndex === -1) {
+        return flatList;
+    }
+    const parent = flatList[parentIndex];
+    const nextChildren = flattenChildren(childrenData, parent, expandedIds);
+    const existingDirect = getDirectChildren(flatList, parentId);
+    const sameBranch = existingDirect.length === nextChildren.length &&
+        existingDirect.every((item, index) => item.id === nextChildren[index]?.id);
+    if (sameBranch) {
+        return flatList;
+    }
+    const nestedItems = getNestedItems(flatList, parentId);
+    const nextBranch = [];
+    nextChildren.forEach((child) => {
+        nextBranch.push(child);
+        const sourceChild = childrenData.find((item) => item.id === child.id);
+        const isNestedFlattened = Boolean(child.meta.isExpanded && sourceChild?.children?.length);
+        if (!isNestedFlattened) {
+            nextBranch.push(...getNestedItems(flatList, child.id));
+        }
+    });
+    const branchEnd = parentIndex + 1 + nestedItems.length;
+    return [
+        ...flatList.slice(0, parentIndex),
+        { ...parent, children: childrenData },
+        ...nextBranch,
+        ...flatList.slice(branchEnd),
+    ];
+};

package/components/InfiniteTreeList/utils/removeChildren/index.d.ts

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

package/components/InfiniteTreeList/utils/removeChildren/index.js

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

package/components/InfiniteTreeList/utils/removeChildren/removeChildren.d.ts

@@ -0,0 +1,5 @@
+import type { FlattenTree, InfiniteTreeListData } from '../../types';
+/**
+ * Удаляет дочерние элементы родителя из плоского списка и сворачивает родителя
+ */
+export declare const removeChildren: <TData extends InfiniteTreeListData<TData>>(flatList: FlattenTree<TData>[], parentId: string) => FlattenTree<TData>[];

package/components/InfiniteTreeList/utils/removeChildren/removeChildren.js

@@ -0,0 +1,12 @@
+import { getNestedItems } from '../getNestedItems';
+/**
+ * Удаляет дочерние элементы родителя из плоского списка и сворачивает родителя
+ */
+export const removeChildren = (flatList, parentId) => {
+    const descendantIds = new Set(getNestedItems(flatList, parentId).map((item) => item.id));
+    return flatList
+        .filter((item) => !descendantIds.has(item.id))
+        .map((item) => item.id === parentId
+        ? { ...item, meta: { ...item.meta, isExpanded: false } }
+        : item);
+};

package/components/InfiniteTreeList/utils/sortCollapsed/sortCollapsed.d.ts

@@ -0,0 +1,5 @@
+import type { FlattenTree, InfiniteTreeListData } from '../../types';
+/**
+ * Сортирует элементы для корректной последовательности анимации при сворачивании
+ */
+export declare const sortCollapsed: <TData extends InfiniteTreeListData<TData>>(items: FlattenTree<TData>[]) => FlattenTree<TData>[];

package/components/InfiniteTreeList/{useLogic/utils → utils}/sortCollapsed/sortCollapsed.js

@@ -1,10 +1,5 @@
 /**
- * Сортирует элементы для корректной последовательности анимации при сворачивании.
- * Сначала более глубокие уровни, затем по индексу среди соседей.
- *
- * @typeParam T - тип данных элемента дерева
- * @param items - элементы в формате `FlattenTree<T>`
- * @returns Отсортированный массив `FlattenTree<T>`
+ * Сортирует элементы для корректной последовательности анимации при сворачивании
  */
 export const sortCollapsed = (items) => {
     return [...items].sort((a, b) => {

package/components/InfiniteTreeList/utils/startRemoveAnimation/index.d.ts

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

package/components/InfiniteTreeList/utils/startRemoveAnimation/index.js

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

package/components/InfiniteTreeList/utils/startRemoveAnimation/startRemoveAnimation.d.ts

@@ -0,0 +1 @@
+export declare const startRemoveAnimation: (nodeId: string) => void;

package/components/InfiniteTreeList/utils/startRemoveAnimation/startRemoveAnimation.js

@@ -0,0 +1,5 @@
+import { infiniteTreeListClassnames } from '../../constants';
+export const startRemoveAnimation = (nodeId) => {
+    const treeItem = document.getElementById(nodeId);
+    treeItem?.classList.add(infiniteTreeListClassnames.rowRemoveAnimation);
+};

package/components/InfiniteTreeList/utils/syncChildrenPlaceholders/index.d.ts

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

package/components/InfiniteTreeList/utils/syncChildrenPlaceholders/index.js

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

package/components/InfiniteTreeList/utils/syncChildrenPlaceholders/syncChildrenPlaceholders.d.ts

@@ -0,0 +1,11 @@
+import type { FlattenTree, InfiniteTreeListData } from '../../types';
+/**
+ * Возвращает id строк-заглушек, которые получит родитель.
+ */
+export declare const getChildrenPlaceholderIds: (parentId: string, count: number) => string[];
+/**
+ * Приводит строки-заглушки ветки родителя к состоянию загрузки её дочерних
+ * элементов:
+ * ставит нужный вид заглушки, меняет его или убирает заглушки совсем
+ */
+export declare const syncChildrenPlaceholders: <TData extends InfiniteTreeListData<TData>>(flatList: FlattenTree<TData>[], parentId: string, isLoading: boolean, skeletonCount: number, isError?: boolean, isNoData?: boolean) => FlattenTree<TData>[];

package/components/InfiniteTreeList/utils/syncChildrenPlaceholders/syncChildrenPlaceholders.js

@@ -0,0 +1,99 @@
+import { checkIsChildrenPlaceholderOf } from '../checkIsChildrenPlaceholderOf';
+import { checkIsDirectChild } from '../checkIsDirectChild';
+import { countDirectChildren } from '../countDirectChildren';
+import { getNestedItems } from '../getNestedItems';
+/**
+ * Возвращает стабильный id строки-заглушки для родителя.
+ */
+const getPlaceholderId = (parentId, index) => `loader-${parentId}-${index}`;
+/**
+ * Возвращает стабильный id строки-заглушки «Нет данных».
+ */
+const getNoDataId = (parentId) => `no-data-${parentId}`;
+/**
+ * Возвращает id строк-заглушек, которые получит родитель.
+ */
+export const getChildrenPlaceholderIds = (parentId, count) => Array.from({ length: count }, (_, index) => getPlaceholderId(parentId, index));
+/**
+ * Какую заглушку должна показывать ветка при текущем состоянии загрузки
+ * дочерних элементов.
+ */
+const resolveChildrenPlaceholderKind = (isLoading, isError, isNoData, realChildren) => {
+    if (isLoading) {
+        return realChildren ? 'spinner' : 'skeleton';
+    }
+    if (isError) {
+        return 'error';
+    }
+    if (isNoData && !realChildren) {
+        return 'no-data';
+    }
+    return undefined;
+};
+const getPlaceholderCount = (kind, skeletonCount) => {
+    if (!kind) {
+        return 0;
+    }
+    return kind === 'skeleton' ? skeletonCount : 1;
+};
+/**
+ * Создаёт строку-заглушку ветки
+ */
+const createChildrenPlaceholder = (parent, { kind, index, siblingIndex, }) => {
+    const id = kind === 'no-data'
+        ? getNoDataId(parent.id)
+        : getPlaceholderId(parent.id, index);
+    return {
+        id,
+        placeholderKind: kind,
+        meta: {
+            hasNested: false,
+            isChildrenAsync: false,
+            level: parent.meta.level + 1,
+            path: [...parent.meta.path, id],
+            isExpanded: false,
+            parentId: parent.id,
+            siblingIndex,
+            nodeId: `infinite-tree-item-${id}`,
+        },
+    };
+};
+/**
+ * Приводит строки-заглушки ветки родителя к состоянию загрузки её дочерних
+ * элементов:
+ * ставит нужный вид заглушки, меняет его или убирает заглушки совсем
+ */
+export const syncChildrenPlaceholders = (flatList, parentId, isLoading, skeletonCount, isError, isNoData) => {
+    const parentIndex = flatList.findIndex((item) => item.id === parentId);
+    if (parentIndex === -1) {
+        return flatList;
+    }
+    const parent = flatList[parentIndex];
+    const existingPlaceholders = flatList.filter((item) => checkIsChildrenPlaceholderOf(item, parentId));
+    const realChildren = flatList.some((item) => checkIsDirectChild(item, parentId));
+    const kind = resolveChildrenPlaceholderKind(isLoading, Boolean(isError), Boolean(isNoData), realChildren);
+    const desiredCount = getPlaceholderCount(kind, skeletonCount);
+    const samePlaceholders = existingPlaceholders.length === desiredCount &&
+        existingPlaceholders.every((item) => item.placeholderKind === kind);
+    if (samePlaceholders) {
+        return flatList;
+    }
+    const withoutPlaceholders = flatList.filter((item) => !checkIsChildrenPlaceholderOf(item, parentId));
+    if (!kind) {
+        return withoutPlaceholders;
+    }
+    const nextParentIndex = withoutPlaceholders.findIndex((item) => item.id === parentId);
+    const nestedItems = getNestedItems(withoutPlaceholders, parentId);
+    const insertIndex = nextParentIndex + 1 + nestedItems.length;
+    const realDirectCount = countDirectChildren(withoutPlaceholders, parentId);
+    const placeholders = Array.from({ length: desiredCount }, (_, index) => createChildrenPlaceholder(parent, {
+        kind,
+        index,
+        siblingIndex: realDirectCount + index,
+    }));
+    return [
+        ...withoutPlaceholders.slice(0, insertIndex),
+        ...placeholders,
+        ...withoutPlaceholders.slice(insertIndex),
+    ];
+};

package/node/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/node/components/InfiniteTreeList/InfiniteTreeList.js

@@ -2,30 +2,37 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InfiniteTreeList = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
+// cspell:ignore Виртуализированное
 const react_virtuoso_1 = require("react-virtuoso");
 const ContentState_1 = require("../ContentState");
-const Loader_1 = require("../Loader");
-const constants_1 = require("./constants");
-const EndData_1 = require("./EndData");
-const ErrorMessage_1 = require("./ErrorMessage");
 const InfiniteTreeListContext_1 = require("./InfiniteTreeListContext");
-const InfiniteTreeListItem_1 = require("./InfiniteTreeListItem");
+const ListFooter_1 = require("./ListFooter");
 const NoDataPlaceholder_1 = require("./NoDataPlaceholder");
 const OnTopButton_1 = require("./OnTopButton");
-const styles_1 = require("./styles");
+const ParentItems_1 = require("./ParentItems");
 const TreeItem_1 = require("./TreeItem");
 const useLogic_1 = require("./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>
+ *   )}
+ * />
+ */
 const InfiniteTreeList = (props) => {
-    const { flatList, onToggle, contentStateProps, scrollParent, virtuosoProps, footerProps, onTopButtonProps, endOfScrollMsg, renderItem, items, itemSkeleton, onRetry, onLoadMore, noDataImgSrc, recentlyExpandedIds, } = (0, useLogic_1.useLogic)(props);
-    const renderItemContent = (_index, item) => ((0, jsx_runtime_1.jsx)(InfiniteTreeListItem_1.TreeListItemContextProvider, { item: item, onToggle: onToggle, children: (0, jsx_runtime_1.jsx)(TreeItem_1.TreeItem, { item: item, renderItem: renderItem, recentlyExpandedIds: recentlyExpandedIds }) }));
-    return ((0, jsx_runtime_1.jsx)(InfiniteTreeListContext_1.InfiniteTreeListContextProvider, { itemSkeleton: itemSkeleton, children: (0, jsx_runtime_1.jsx)(ContentState_1.ContentState, { ...contentStateProps, children: items.length && scrollParent ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(react_virtuoso_1.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 (0, jsx_runtime_1.jsx)(styles_1.FooterDummy, {});
-                                }
-                                return ((0, jsx_runtime_1.jsxs)(styles_1.Footer, { children: [isLoading && (0, jsx_runtime_1.jsx)(Loader_1.Loader, {}), isError && (0, jsx_runtime_1.jsx)(ErrorMessage_1.ErrorMessage, { onRetry: onRetry }), isEndReached && ((0, jsx_runtime_1.jsx)(EndData_1.EndData, { endOfScrollMsg: endOfScrollMsg }))] }));
-                            },
-                        }, overscan: constants_1.OVERSCAN }), (0, jsx_runtime_1.jsx)(OnTopButton_1.OnTopButton, { ...onTopButtonProps })] })) : ((0, jsx_runtime_1.jsx)(NoDataPlaceholder_1.NoDataPlaceholder, { noDataImgSrc: noDataImgSrc })) }) }));
+    const { flatList, onToggle, contentStateProps, scrollParent, virtuosoProps, footerContext, onTopButtonProps, renderItem, renderParent, items, itemSkeleton, onRetry, noDataImgSrc, enterAnimation, tailRegistry, nodePaginationMap, registerChildren, notifyExpand, parentItems, acquireParentSlot, } = (0, useLogic_1.useLogic)(props);
+    return ((0, jsx_runtime_1.jsxs)(InfiniteTreeListContext_1.InfiniteTreeListContextProvider, { itemSkeleton: itemSkeleton, nodePaginationMap: nodePaginationMap, registerChildren: registerChildren, notifyExpand: notifyExpand, onListRetry: onRetry, enterAnimation: enterAnimation, tailRegistry: tailRegistry, renderItem: renderItem, renderParent: renderParent, onToggle: onToggle, acquireParentSlot: acquireParentSlot, children: [(0, jsx_runtime_1.jsx)(ParentItems_1.ParentItems, { parents: parentItems }), (0, jsx_runtime_1.jsx)(ContentState_1.ContentState, { ...contentStateProps, children: items.length > 0 && scrollParent ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(react_virtuoso_1.Virtuoso, { ...virtuosoProps, data: flatList, customScrollParent: scrollParent, computeItemKey: computeItemKey, context: footerContext, components: { Item: TreeItem_1.TreeItem, Footer: ListFooter_1.ListFooter } }), (0, jsx_runtime_1.jsx)(OnTopButton_1.OnTopButton, { ...onTopButtonProps })] })) : ((0, jsx_runtime_1.jsx)(NoDataPlaceholder_1.NoDataPlaceholder, { noDataImgSrc: noDataImgSrc })) })] }));
 };
 exports.InfiniteTreeList = InfiniteTreeList;

package/node/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/node/components/InfiniteTreeList/InfiniteTreeListActions/InfiniteTreeListActions.js

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

package/node/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/node/components/InfiniteTreeList/InfiniteTreeListActions/useLogic/useLogic.js

@@ -10,17 +10,16 @@ const useLogic = ({ actions }) => {
     const { setDisabled } = (0, react_1.useContext)(InfiniteTreeListContext_1.InfiniteTreeListContext);
     const blockingAction = (0, react_1.useMemo)(() => [...main, ...secondary].find((action) => action.isBlockingOperation && action.loading), [main, secondary]);
     const isDisabledAction = Boolean(blockingAction);
+    const loadingNote = blockingAction?.loadingNote;
     (0, react_1.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 = (0, react_1.useCallback)((onClick) => () => {
         onClick?.(item);
     }, [item]);

package/node/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/node/components/InfiniteTreeList/InfiniteTreeListContext/InfiniteTreeListContext.js

@@ -3,7 +3,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.InfiniteTreeListContext = void 0;
 const react_1 = require("react");
 exports.InfiniteTreeListContext = (0, react_1.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/node/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 {};