@astral/ui 4.99.2 → 4.101.0

package/node/components/InfiniteTreeList/TreeItem/useLogic/useLogic.js

@@ -1,28 +1,70 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useLogic = void 0;
+// cspell:ignore виртуализирует
 const react_1 = require("react");
-const constants_1 = require("../../constants");
-const useLogic = ({ item, renderItem, recentlyExpandedIds, }) => {
-    const deleteRecentlyExpandedId = () => {
-        item.meta.parentId &&
-            recentlyExpandedIds.current?.delete(item.meta.parentId);
-    };
+const InfiniteTreeListContext_1 = require("../../InfiniteTreeListContext");
+/**
+ * Логика строки виртуализации: регистрирует хвост ветки в реестре, один раз
+ * на mount читает метку enter-анимации и считает css-переменные строки.
+ *
+ * Про хвост: `Virtuoso` виртуализирует плоский список, и его `endReached` —
+ * это конец всего списка, то есть корневая пагинация. У вложенной пагинации
+ * свой признак конца: последний загруженный дочерний элемент раскрытой
+ * ветки. Такая строка пишет себя в `tailRegistry`, а `useListScroll` на смене
+ * видимого диапазона зовёт `checkRange` — попал хвост в кадр, ветка просит
+ * `onLoadMore(parentId)`. Отдельного элемента-sentinel в разметке для
+ * этого нет
+ */
+const useLogic = ({ item, context, ...itemProps }) => {
+    const { renderItem, onToggle, nodePaginationMap, onLoadMore, enterAnimation, tailRegistry, } = (0, react_1.useContext)(InfiniteTreeListContext_1.InfiniteTreeListContext);
+    const memoizedItemProps = (0, react_1.useMemo)(() => itemProps, [itemProps.style]);
+    const { parentId, siblingIndex, level } = item.meta;
+    const parentPagination = parentId ? nodePaginationMap[parentId] : undefined;
+    const isLastChild = parentPagination?.lastChildId === item.id;
+    const shouldRegister = Boolean(isLastChild &&
+        parentId &&
+        !parentPagination?.isEndReached &&
+        !parentPagination?.isChildrenLoading &&
+        !parentPagination?.isChildrenError);
+    // Решение об анимации принимается один раз, на mount строки. Чтение метки
+    // не меняет состояние, поэтому отброшенный рендер ничего не ломает
+    const enterState = (0, react_1.useRef)(null);
+    if (!enterState.current) {
+        enterState.current = enterAnimation.read(item.id);
+    }
+    const { shouldAnimate, delayIndex } = enterState.current;
+    // Метка забирается после коммита: повторный mount строки при скролле
+    // виртуализации анимации уже не получит
+    (0, react_1.useEffect)(() => {
+        enterAnimation.claim(item.id);
+    }, []);
     (0, react_1.useEffect)(() => {
+        if (!shouldRegister || !parentId) {
+            return;
+        }
+        const registeredParentId = parentId;
+        const registeredItemId = item.id;
+        tailRegistry.register(registeredParentId, registeredItemId, () => onLoadMore(registeredParentId));
         return () => {
-            deleteRecentlyExpandedId();
+            tailRegistry.unregister(registeredParentId, registeredItemId);
         };
-    }, []);
-    const onAnimationEnd = () => {
-        deleteRecentlyExpandedId();
+    }, [shouldRegister, parentId, item.id, tailRegistry, onLoadMore]);
+    const isSpinner = item.placeholderKind === 'spinner';
+    // Уровень вложенности и индекс каскада — динамические значения, поэтому
+    // передаются в стили через css vars, а не через styled props
+    const cssVars = {
+        '--level': level,
+        '--sibling-index': delayIndex ?? siblingIndex,
+    };
+    return {
+        item,
+        renderItem,
+        onToggle,
+        memoizedItemProps,
+        cssVars,
+        isSpinner,
+        hasAddAnimation: !isSpinner && shouldAnimate,
     };
-    const classname = (0, react_1.useMemo)(() => {
-        if (item?.meta.parentId &&
-            recentlyExpandedIds.current?.has(item?.meta.parentId)) {
-            return constants_1.infiniteTreeListClassnames.addAnimation;
-        }
-        return '';
-    }, [item.id]);
-    return { item, renderItem, classname, onAnimationEnd };
 };
 exports.useLogic = useLogic;

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

@@ -1,6 +1,18 @@
 export declare const VIRTUOSO_CONTAINER_ID = "virtuoso-container";
 export declare const OVERSCAN = 30;
+/**
+ * Окно ожидания mount строки, помеченной для enter-анимации.
+ * Virtuoso монтирует видимые дочерние строки в следующем кадре после смены
+ * data, поэтому `useLayoutEffect` снимает метку слишком рано
+ */
+export declare const ENTER_ANIMATION_MOUNT_WINDOW_MS = 100;
+export declare const CHILDREN_SKELETON_COUNT = 3;
+export declare const CHILDREN_NO_DATA_MSG = "\u041D\u0435\u0442 \u0434\u0430\u043D\u043D\u044B\u0445";
 export declare const infiniteTreeListClassnames: {
-    addAnimation: string;
-    removeAnimation: string;
+    row: string;
+    rowAddAnimation: string;
+    rowRemoveAnimation: string;
+    rowSpinner: string;
+    scrollToTopButton: string;
+    visibleScrollToTopButton: string;
 };

package/node/components/InfiniteTreeList/constants.js

@@ -1,10 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.infiniteTreeListClassnames = exports.OVERSCAN = exports.VIRTUOSO_CONTAINER_ID = void 0;
+exports.infiniteTreeListClassnames = exports.CHILDREN_NO_DATA_MSG = exports.CHILDREN_SKELETON_COUNT = exports.ENTER_ANIMATION_MOUNT_WINDOW_MS = exports.OVERSCAN = exports.VIRTUOSO_CONTAINER_ID = void 0;
 const createUIKitClassname_1 = require("../utils/createUIKitClassname");
 exports.VIRTUOSO_CONTAINER_ID = 'virtuoso-container';
 exports.OVERSCAN = 30;
+/**
+ * Окно ожидания mount строки, помеченной для enter-анимации.
+ * Virtuoso монтирует видимые дочерние строки в следующем кадре после смены
+ * data, поэтому `useLayoutEffect` снимает метку слишком рано
+ */
+exports.ENTER_ANIMATION_MOUNT_WINDOW_MS = 100;
+exports.CHILDREN_SKELETON_COUNT = 3;
+exports.CHILDREN_NO_DATA_MSG = 'Нет данных';
 exports.infiniteTreeListClassnames = {
-    addAnimation: (0, createUIKitClassname_1.createUIKitClassname)('infinite-tree-list_add-animation'),
-    removeAnimation: (0, createUIKitClassname_1.createUIKitClassname)('infinite-tree-list_remove-animation'),
+    row: (0, createUIKitClassname_1.createUIKitClassname)('infinite-tree-list__row'),
+    rowAddAnimation: (0, createUIKitClassname_1.createUIKitClassname)('infinite-tree-list__row_add-animation'),
+    rowRemoveAnimation: (0, createUIKitClassname_1.createUIKitClassname)('infinite-tree-list__row_remove-animation'),
+    rowSpinner: (0, createUIKitClassname_1.createUIKitClassname)('infinite-tree-list__row_spinner'),
+    scrollToTopButton: (0, createUIKitClassname_1.createUIKitClassname)('infinite-tree-list__scroll-to-top-button'),
+    visibleScrollToTopButton: (0, createUIKitClassname_1.createUIKitClassname)('infinite-tree-list__scroll-to-top-button_visible'),
 };

package/node/components/InfiniteTreeList/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export * from './useChildrenState';
+export * from './useEnterAnimation';
+export * from './useExpandNotifier';
+export * from './useFlatTree';
+export * from './useListScroll';

package/node/components/InfiniteTreeList/hooks/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./useChildrenState"), exports);
+__exportStar(require("./useEnterAnimation"), exports);
+__exportStar(require("./useExpandNotifier"), exports);
+__exportStar(require("./useFlatTree"), exports);
+__exportStar(require("./useListScroll"), exports);

package/node/components/InfiniteTreeList/hooks/useChildrenState/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './useChildrenState';

package/node/components/InfiniteTreeList/hooks/useChildrenState/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./useChildrenState"), exports);

package/node/components/InfiniteTreeList/hooks/useChildrenState/types.d.ts

@@ -0,0 +1,43 @@
+import type { RefObject } from 'react';
+import type { FlattenTree, InfiniteTreeListData } from '../../types';
+import type { EnterAnimationResult } from '../useEnterAnimation';
+export type UseChildrenStateParams<TData extends InfiniteTreeListData<TData>> = {
+    /**
+     * Данные списка
+     */
+    items: TData[];
+    /**
+     * Плоский список строк
+     */
+    flatList: FlattenTree<TData>[];
+    /**
+     * Список для синхронного чтения
+     */
+    flatListRef: RefObject<FlattenTree<TData>[]>;
+    /**
+     * Набор раскрытых узлов
+     */
+    expandedIds: Set<string>;
+    /**
+     * Набор раскрытых узлов для синхронного чтения
+     */
+    expandedIdsRef: RefObject<Set<string>>;
+    /**
+     * Контроллер enter-анимации: метит новые дочерние элементы
+     * и skeleton-узлы
+     */
+    enterAnimation: EnterAnimationResult;
+    /**
+     * Вставляет дочерние элементы узла в плоский список
+     */
+    insertChildren: (parentId: string, childrenData: TData[]) => void;
+    /**
+     * Функция управления placeholder ветки родителя
+     */
+    syncChildrenPlaceholders: (parentId: string, isChildrenLoading: boolean, skeletonCount: number, isChildrenError?: boolean, isChildrenNoData?: boolean) => void;
+    skeletonCount: number;
+    /**
+     * Выбрасывает контейнер строки узла, которого больше нет в данных
+     */
+    releaseParentSlot: (itemId: string) => void;
+};

package/node/components/InfiniteTreeList/hooks/useChildrenState/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/node/components/InfiniteTreeList/hooks/useChildrenState/useChildrenState.d.ts

@@ -0,0 +1,20 @@
+import type { NodePagination } from '../../InfiniteTreeListContext';
+import type { FlattenTree, InfiniteTreeChildrenPagination, InfiniteTreeListData } from '../../types';
+import type { UseChildrenStateParams } from './types';
+/**
+ * Сводит данные дочерних элементов раскрытых узлов в плоский список:
+ * вставляет их, ставит заглушки ветки, собирает пагинацию узлов и метит новые
+ * строки для enter-анимации. Дочерние элементы отдаёт строка узла
+ * (`childItems`, `isLoading`, `isError`), не props списка.
+ *
+ * Дочерние элементы смонтированными хук не держит — их строки живут
+ * по правилам виртуализации. Строки узлов с подгружаемыми дочерними
+ * элементами, наоборот, монтируются один раз и живут, пока жив список:
+ * их состояние не должно умирать ни от ухода строки со скролла,
+ * ни от сворачивания ветки
+ */
+export declare const useChildrenState: <TData extends InfiniteTreeListData<TData>>({ items, flatList, flatListRef, expandedIds, expandedIdsRef, enterAnimation, insertChildren, syncChildrenPlaceholders, skeletonCount, releaseParentSlot, }: UseChildrenStateParams<TData>) => {
+    registerChildren: (itemId: string, childrenState: InfiniteTreeChildrenPagination) => void;
+    nodePaginationMap: Record<string, NodePagination>;
+    parentItems: FlattenTree<TData>[];
+};

package/node/components/InfiniteTreeList/hooks/useChildrenState/useChildrenState.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChildrenState = void 0;
+const react_1 = require("react");
+const utils_1 = require("../../utils");
+/**
+ * Сводит данные дочерних элементов раскрытых узлов в плоский список:
+ * вставляет их, ставит заглушки ветки, собирает пагинацию узлов и метит новые
+ * строки для enter-анимации. Дочерние элементы отдаёт строка узла
+ * (`childItems`, `isLoading`, `isError`), не props списка.
+ *
+ * Дочерние элементы смонтированными хук не держит — их строки живут
+ * по правилам виртуализации. Строки узлов с подгружаемыми дочерними
+ * элементами, наоборот, монтируются один раз и живут, пока жив список:
+ * их состояние не должно умирать ни от ухода строки со скролла,
+ * ни от сворачивания ветки
+ */
+const useChildrenState = ({ items, flatList, flatListRef, expandedIds, expandedIdsRef, enterAnimation, insertChildren, syncChildrenPlaceholders, skeletonCount, releaseParentSlot, }) => {
+    const [childrenStateMap, setChildrenStateMap] = (0, react_1.useState)({});
+    const childrenStateMapRef = (0, react_1.useRef)(childrenStateMap);
+    // Синхронизация после коммита: запись в ref во время рендера — side effect,
+    // отброшенный рендер оставил бы в ref значение из дерева, которое
+    // не попало в коммит
+    (0, react_1.useEffect)(() => {
+        childrenStateMapRef.current = childrenStateMap;
+    });
+    const loadedOnceIdsRef = (0, react_1.useRef)(new Set());
+    const registerChildren = (0, react_1.useCallback)((itemId, childrenState) => {
+        const nextChildren = childrenState;
+        setChildrenStateMap((prev) => {
+            if ((0, utils_1.checkIsSameChildren)(prev[itemId], nextChildren)) {
+                return prev;
+            }
+            return { ...prev, [itemId]: nextChildren };
+        });
+    }, []);
+    const resolveNoData = (0, react_1.useCallback)((parentId, childrenState) => {
+        const hasLoadedOnce = loadedOnceIdsRef.current.has(parentId);
+        if (childrenState.isLoading) {
+            loadedOnceIdsRef.current.add(parentId);
+        }
+        return (0, utils_1.checkIsNoDataChildren)(childrenState, hasLoadedOnce);
+    }, []);
+    const syncChildren = (0, react_1.useCallback)((parentId, childrenState) => {
+        const existingDirectCount = (0, utils_1.countDirectChildren)(flatListRef.current, parentId);
+        const hasSkeletons = (0, utils_1.checkHasSkeletonPlaceholders)(flatListRef.current, parentId);
+        insertChildren(parentId, childrenState.data);
+        syncChildrenPlaceholders(parentId, Boolean(childrenState.isLoading), skeletonCount, childrenState.isError, resolveNoData(parentId, childrenState));
+        if (childrenState.isLoading) {
+            // Первая загрузка необходима для skeleton-элементов
+            const firstLoading = existingDirectCount === 0 && !hasSkeletons;
+            if (firstLoading) {
+                enterAnimation.schedule((0, utils_1.getChildrenPlaceholderIds)(parentId, skeletonCount));
+            }
+            return;
+        }
+        if (childrenState.isError ||
+            childrenState.data.length <= existingDirectCount) {
+            return;
+        }
+        const { itemIds, startDelayIndex } = (0, utils_1.getEnteringChildren)(childrenState.data.map((item) => item.id), existingDirectCount, hasSkeletons ? skeletonCount : 0);
+        enterAnimation.schedule(itemIds, startDelayIndex);
+    }, [
+        enterAnimation,
+        flatListRef,
+        insertChildren,
+        resolveNoData,
+        skeletonCount,
+        syncChildrenPlaceholders,
+    ]);
+    (0, react_1.useEffect)(() => {
+        Object.entries(childrenStateMap).forEach(([parentId, childrenState]) => {
+            if (expandedIdsRef.current.has(parentId)) {
+                syncChildren(parentId, childrenState);
+            }
+        });
+    }, [childrenStateMap, expandedIds]);
+    const nodePaginationMap = (0, react_1.useMemo)(() => Object.entries(childrenStateMap).reduce((acc, [parentId, childrenState]) => {
+        acc[parentId] = {
+            lastChildId: childrenState.data[childrenState.data.length - 1]?.id,
+            isEndReached: childrenState.isEndReached,
+            isChildrenLoading: childrenState.isLoading,
+            isChildrenError: childrenState.isError,
+        };
+        return acc;
+    }, {}), [childrenStateMap]);
+    const parentItemsRef = (0, react_1.useRef)(new Map());
+    const parentItems = (0, react_1.useMemo)(() => {
+        flatList.forEach((item) => {
+            if (item.meta.isChildrenAsync) {
+                parentItemsRef.current.set(item.id, item);
+            }
+        });
+        return [...parentItemsRef.current.values()];
+    }, [flatList]);
+    (0, react_1.useEffect)(() => {
+        const idsToKeep = (0, utils_1.getIdsToKeep)(items, childrenStateMapRef.current);
+        parentItemsRef.current.forEach((_, itemId) => {
+            if (!idsToKeep.has(itemId)) {
+                parentItemsRef.current.delete(itemId);
+                releaseParentSlot(itemId);
+            }
+        });
+        loadedOnceIdsRef.current.forEach((itemId) => {
+            if (!idsToKeep.has(itemId)) {
+                loadedOnceIdsRef.current.delete(itemId);
+            }
+        });
+        setChildrenStateMap((prev) => {
+            const entriesToKeep = Object.entries(prev).filter(([itemId]) => idsToKeep.has(itemId));
+            if (entriesToKeep.length === Object.keys(prev).length) {
+                return prev;
+            }
+            return Object.fromEntries(entriesToKeep);
+        });
+    }, [items, releaseParentSlot]);
+    return { registerChildren, nodePaginationMap, parentItems };
+};
+exports.useChildrenState = useChildrenState;

package/node/components/InfiniteTreeList/hooks/useEnterAnimation/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './useEnterAnimation';

package/node/components/InfiniteTreeList/hooks/useEnterAnimation/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./useEnterAnimation"), exports);

package/node/components/InfiniteTreeList/hooks/useEnterAnimation/types.d.ts

@@ -0,0 +1,29 @@
+export type EnterAnimationState = {
+    /**
+     * Строка должна появиться с enter-анимацией
+     */
+    shouldAnimate: boolean;
+    /**
+     * Индекс каскадной задержки анимации
+     */
+    delayIndex?: number;
+};
+export type EnterAnimationResult = {
+    /**
+     * Планирует появление элементов с enter-анимацией.
+     * Порядок id задаёт каскад, `startDelayIndex` сдвигает его начало
+     */
+    schedule: (itemIds: string[], startDelayIndex?: number) => void;
+    /**
+     * Возвращает состояние анимации, не изменяя метку. Безопасно для рендера
+     */
+    read: (itemId: string) => EnterAnimationState;
+    /**
+     * Забирает метку элемента: повторный mount при скролле анимации не получит
+     */
+    claim: (itemId: string) => void;
+    /**
+     * Сбрасывает все метки
+     */
+    reset: () => void;
+};

package/node/components/InfiniteTreeList/hooks/useEnterAnimation/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/node/components/InfiniteTreeList/hooks/useEnterAnimation/useEnterAnimation.d.ts

@@ -0,0 +1,6 @@
+import type { EnterAnimationResult } from './types';
+/**
+ * Управляет enter-анимацией строк дерева: метка живёт до первого mount строки
+ * и потребляется им
+ */
+export declare const useEnterAnimation: () => EnterAnimationResult;

package/node/components/InfiniteTreeList/hooks/useEnterAnimation/useEnterAnimation.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useEnterAnimation = void 0;
+const react_1 = require("react");
+const constants_1 = require("../../constants");
+const NO_ANIMATION = { shouldAnimate: false };
+/**
+ * Управляет enter-анимацией строк дерева: метка живёт до первого mount строки
+ * и потребляется им
+ */
+const useEnterAnimation = () => {
+    const delayIndexes = (0, react_1.useRef)(new Map());
+    const resetTimer = (0, react_1.useRef)(undefined);
+    const reset = (0, react_1.useCallback)(() => {
+        clearTimeout(resetTimer.current);
+        delayIndexes.current.clear();
+    }, []);
+    const schedule = (0, react_1.useCallback)((itemIds, startDelayIndex = 0) => {
+        if (!itemIds.length) {
+            return;
+        }
+        itemIds.forEach((itemId, index) => delayIndexes.current.set(itemId, startDelayIndex + index));
+        clearTimeout(resetTimer.current);
+        resetTimer.current = setTimeout(reset, constants_1.ENTER_ANIMATION_MOUNT_WINDOW_MS);
+    }, [reset]);
+    const read = (0, react_1.useCallback)((itemId) => {
+        const delayIndex = delayIndexes.current.get(itemId);
+        if (delayIndex === undefined) {
+            return NO_ANIMATION;
+        }
+        return { shouldAnimate: true, delayIndex };
+    }, []);
+    const claim = (0, react_1.useCallback)((itemId) => {
+        delayIndexes.current.delete(itemId);
+    }, []);
+    (0, react_1.useEffect)(() => () => clearTimeout(resetTimer.current), []);
+    return (0, react_1.useMemo)(() => ({ schedule, read, claim, reset }), [schedule, read, claim, reset]);
+};
+exports.useEnterAnimation = useEnterAnimation;

package/node/components/InfiniteTreeList/hooks/useExpandNotifier/index.d.ts

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

package/node/components/InfiniteTreeList/hooks/useExpandNotifier/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./useExpandNotifier"), exports);

package/node/components/InfiniteTreeList/hooks/useExpandNotifier/useExpandNotifier.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Блокирует повторные вызовы `onOpen`: узел сообщает о раскрытии один
+ * раз, пока ветка не свёрнута
+ */
+export declare const useExpandNotifier: () => {
+    notifyExpand: (itemId: string, onOpen?: () => void) => void;
+    resetExpandNotification: (itemIds: string[]) => void;
+};

package/node/components/InfiniteTreeList/hooks/useExpandNotifier/useExpandNotifier.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useExpandNotifier = void 0;
+const react_1 = require("react");
+/**
+ * Блокирует повторные вызовы `onOpen`: узел сообщает о раскрытии один
+ * раз, пока ветка не свёрнута
+ */
+const useExpandNotifier = () => {
+    const notifiedIdsRef = (0, react_1.useRef)(new Set());
+    const notifyExpand = (0, react_1.useCallback)((itemId, onOpen) => {
+        if (notifiedIdsRef.current.has(itemId)) {
+            return;
+        }
+        notifiedIdsRef.current.add(itemId);
+        onOpen?.();
+    }, []);
+    const resetExpandNotification = (0, react_1.useCallback)((itemIds) => {
+        itemIds.forEach((itemId) => notifiedIdsRef.current.delete(itemId));
+    }, []);
+    return { notifyExpand, resetExpandNotification };
+};
+exports.useExpandNotifier = useExpandNotifier;

package/node/components/InfiniteTreeList/hooks/useFlatTree/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './useFlatTree';

package/node/components/InfiniteTreeList/hooks/useFlatTree/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./useFlatTree"), exports);

package/node/components/InfiniteTreeList/hooks/useFlatTree/types.d.ts

@@ -0,0 +1,20 @@
+import type { InfiniteTreeListData } from '../../types';
+import type { EnterAnimationResult } from '../useEnterAnimation';
+export type UseFlatTreeParams<TData extends InfiniteTreeListData<TData>> = {
+    /**
+     * Дерево элементов из props списка
+     */
+    items: TData[];
+    /**
+     * Уровень раскрытия дерева по умолчанию
+     */
+    initialExpandedLevel?: number;
+    /**
+     * Контроллер enter-анимации: раскрытие узла помечает новые строки
+     */
+    enterAnimation: EnterAnimationResult;
+    /**
+     * Вызывается со списком свёрнутых узлов после анимации закрытия ветки
+     */
+    onCollapse: (itemIds: string[]) => void;
+};

package/node/components/InfiniteTreeList/hooks/useFlatTree/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/node/components/InfiniteTreeList/hooks/useFlatTree/useFlatTree.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+import type { FlattenTree, InfiniteTreeListData } from '../../types';
+import type { UseFlatTreeParams } from './types';
+/**
+ * Управляет плоским списком строк и набором раскрытых узлов
+ */
+export declare const useFlatTree: <TData extends InfiniteTreeListData<TData>>({ items, initialExpandedLevel, enterAnimation, onCollapse, }: UseFlatTreeParams<TData>) => {
+    flatList: FlattenTree<TData>[];
+    flatListRef: import("react").RefObject<FlattenTree<TData>[]>;
+    expandedIds: Set<string>;
+    expandedIdsRef: import("react").RefObject<Set<string>>;
+    insertChildren: (parentId: string, childrenData: TData[]) => void;
+    syncChildrenPlaceholders: (parentId: string, isChildrenLoading: boolean, skeletonCount: number, isChildrenError?: boolean, isChildrenNoData?: boolean) => void;
+    onToggle: ({ id: itemId }: InfiniteTreeListData) => void;
+};