@astral/ui 4.100.0 → 4.101.0

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

@@ -3,52 +3,54 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.useLogic = void 0;
 const react_1 = require("react");
 const ConfigProvider_1 = require("../../ConfigProvider");
-const useTheme_1 = require("../../theme/hooks/useTheme");
-const useScrollManagement_1 = require("../../useScrollManagement");
-const useSet_1 = require("../../useSet");
-const useStickyButton_1 = require("../../useStickyButton");
 const constants_1 = require("../constants");
-const utils_1 = require("./utils");
-const useLogic = ({ initialExpandedLevel, items, onRetry, errorMsg, isError, isLoading, scrollRef, isEndReached, onLoadMore, renderItem, itemSkeleton, endOfScrollMsg, noDataImgSrc, errorImgSrc, }) => {
+const hooks_1 = require("../hooks");
+const utils_1 = require("../utils");
+/**
+ * Логика списка: сводит плоский список, данные дочерних элементов, скролл
+ * и анимацию появления строк в props для `Virtuoso` и дочерних компонентов
+ */
+const useLogic = ({ initialExpandedLevel, items, onRetry, errorMsg, isError, isLoading, scrollRef, isEndReached, onLoadMore, renderItem, renderParent, itemSkeleton, endOfScrollMsg, noDataImgSrc, errorImgSrc, }) => {
     const { imagesMap } = (0, react_1.useContext)(ConfigProvider_1.ConfigContext);
-    const theme = (0, useTheme_1.useTheme)();
-    const [internalExpanded, internalExpandedActions] = (0, useSet_1.useSet)(new Set());
-    // Set из ParentId открытых недавно нод. Используется для контролирования анимации открытия.
-    // ParentId удаляется из Set после завершения анимации на всех Children
-    const recentlyExpandedIds = (0, react_1.useRef)(new Set());
-    // Добавляет classname для анимации закрытия элемента
-    const startRemoveAnimation = (nodeId) => {
-        const treeItem = document.getElementById(nodeId);
-        treeItem?.classList.add(constants_1.infiniteTreeListClassnames.removeAnimation);
-    };
-    (0, react_1.useEffect)(() => {
-        const next = (0, utils_1.getInitialExpandedIds)(internalExpanded, items, initialExpandedLevel);
-        next.forEach((item) => internalExpandedActions.add(item));
-    }, [items]);
-    /**
-     * Дерево, преобразованное в плоский список. Такая структура необходима для полноценной виртуализации
-     */
-    const flatList = (0, react_1.useMemo)(() => (0, utils_1.flattenTree)(items, internalExpanded), [items, internalExpanded]);
-    const onToggle = ({ id: itemId }) => {
-        const isExpanded = internalExpanded.has(itemId);
-        if (!isExpanded) {
-            recentlyExpandedIds.current.add(itemId);
-            internalExpandedActions.add(itemId);
-        }
-        else {
-            const children = (0, utils_1.sortCollapsed)((0, utils_1.getDescendants)(flatList, itemId));
-            children.forEach(({ meta }) => startRemoveAnimation(meta.nodeId));
-            const collapseDurationMs = theme.transitions.duration.shorter;
-            setTimeout(() => {
-                internalExpandedActions.remove(itemId);
-                children.forEach(({ id }) => internalExpandedActions.remove(id));
-            }, collapseDurationMs);
-        }
-    };
+    const enterAnimation = (0, hooks_1.useEnterAnimation)();
+    const parentSlotsRef = (0, react_1.useRef)(null);
+    if (!parentSlotsRef.current) {
+        parentSlotsRef.current = (0, utils_1.createParentSlots)();
+    }
+    const acquireParentSlot = (0, react_1.useCallback)((itemId) => parentSlotsRef.current?.acquire(itemId) ?? null, []);
+    const releaseParentSlot = (0, react_1.useCallback)((itemId) => {
+        parentSlotsRef.current?.release(itemId);
+    }, []);
+    const { notifyExpand, resetExpandNotification } = (0, hooks_1.useExpandNotifier)();
+    const { flatList, flatListRef, expandedIds, expandedIdsRef, insertChildren, syncChildrenPlaceholders, onToggle, } = (0, hooks_1.useFlatTree)({
+        items,
+        initialExpandedLevel,
+        enterAnimation,
+        onCollapse: resetExpandNotification,
+    });
+    const { registerChildren, nodePaginationMap, parentItems } = (0, hooks_1.useChildrenState)({
+        items,
+        flatList,
+        flatListRef,
+        expandedIds,
+        expandedIdsRef,
+        enterAnimation,
+        insertChildren,
+        syncChildrenPlaceholders,
+        skeletonCount: itemSkeleton ? constants_1.CHILDREN_SKELETON_COUNT : 1,
+        releaseParentSlot,
+    });
+    const { scrollParent, tailRegistry, isEndReachedWithScroll, virtuosoProps, onTopButtonProps, } = (0, hooks_1.useListScroll)({
+        scrollRef,
+        isEndReached,
+        onLoadMore,
+        flatListRef,
+        enterAnimation,
+    });
     const contentStateProps = (0, react_1.useMemo)(() => {
         const isNoData = !items?.length;
         return {
-            // Проверка на текущие элементы списка необходима для рендера loading состояния при подгрузки данных
+            // Проверка на текущие элементы списка необходима для рендера loading состояния при подгрузке данных
             // вместо общего LoadingPlaceholder на всю страницу
             isLoading: isNoData && isLoading,
             isError: isNoData && isError,
@@ -60,44 +62,37 @@ const useLogic = ({ initialExpandedLevel, items, onRetry, errorMsg, isError, isL
                 onRetry,
             },
         };
-    }, [items, isLoading, isError, errorMsg, onRetry, imagesMap]);
-    const { scrollParent, recalculateVerticalScroll, handleEndReach, isEndReachedWithScroll, } = (0, useScrollManagement_1.useScrollManagement)({
-        scrollRef,
-        isEndReached,
-        onLoadMore,
-        virtuosoId: constants_1.VIRTUOSO_CONTAINER_ID,
-    });
-    const { virtuoso, isStickyButtonActive, handleRangeChanged, handleScrollToTop, } = (0, useStickyButton_1.useStickyButton)(scrollRef);
+    }, [items, isLoading, isError, errorMsg, errorImgSrc, onRetry, imagesMap]);
+    const footerContext = (0, react_1.useMemo)(() => ({
+        isLoading,
+        isError,
+        isEndReached: isEndReachedWithScroll,
+        endOfScrollMsg,
+        onRetry,
+    }), [isLoading, isError, isEndReachedWithScroll, endOfScrollMsg, onRetry]);
     return {
         flatList,
         onToggle,
+        nodePaginationMap,
+        registerChildren,
+        notifyExpand,
+        parentItems,
+        acquireParentSlot,
         contentStateProps,
         scrollParent,
-        virtuosoProps: {
-            id: constants_1.VIRTUOSO_CONTAINER_ID,
-            ref: virtuoso,
-            rangeChanged: handleRangeChanged,
-            endReached: handleEndReach,
-            totalListHeightChanged: recalculateVerticalScroll,
-        },
-        footerProps: {
-            isError,
-            isLoading,
-            isEndReached: isEndReachedWithScroll,
-        },
-        onTopButtonProps: {
-            isActive: isStickyButtonActive,
-            handleScrollToTop,
-            scrollRef,
-        },
-        endOfScrollMsg,
+        virtuosoProps,
+        footerContext,
+        onTopButtonProps,
         itemSkeleton,
         renderItem,
+        // Fallback подставляется один раз: ниже по дереву строка выбирает функцию по
+        // типу узла, не проверяя, передал ли потребитель renderParent
+        renderParent: renderParent ?? renderItem,
         items,
-        onLoadMore,
         onRetry,
         noDataImgSrc,
-        recentlyExpandedIds,
+        enterAnimation,
+        tailRegistry,
     };
 };
 exports.useLogic = useLogic;

package/node/components/InfiniteTreeList/utils/checkHasSkeletonPlaceholders/checkHasSkeletonPlaceholders.d.ts

@@ -0,0 +1,5 @@
+import type { FlattenTree, InfiniteTreeListData } from '../../types';
+/**
+ * Есть ли у родителя строки-заглушки skeleton
+ */
+export declare const checkHasSkeletonPlaceholders: <TData extends InfiniteTreeListData<TData>>(flatList: FlattenTree<TData>[], parentId: string) => boolean;

package/node/components/InfiniteTreeList/utils/checkHasSkeletonPlaceholders/checkHasSkeletonPlaceholders.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkHasSkeletonPlaceholders = void 0;
+const checkIsChildrenPlaceholderOf_1 = require("../checkIsChildrenPlaceholderOf");
+/**
+ * Есть ли у родителя строки-заглушки skeleton
+ */
+const checkHasSkeletonPlaceholders = (flatList, parentId) => flatList.some((item) => (0, checkIsChildrenPlaceholderOf_1.checkIsChildrenPlaceholderOf)(item, parentId) &&
+    item.placeholderKind === 'skeleton');
+exports.checkHasSkeletonPlaceholders = checkHasSkeletonPlaceholders;

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

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

package/node/components/InfiniteTreeList/utils/checkHasSkeletonPlaceholders/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("./checkHasSkeletonPlaceholders"), exports);

package/node/components/InfiniteTreeList/utils/checkIsChildrenPlaceholder/checkIsChildrenPlaceholder.d.ts

@@ -0,0 +1,5 @@
+import type { FlattenTree, InfiniteTreeListData } from '../../types';
+/**
+ * Проверяет, является ли элемент строкой-заглушкой ветки
+ */
+export declare const checkIsChildrenPlaceholder: <TData extends InfiniteTreeListData<TData>>(item: FlattenTree<TData>) => boolean;

package/node/components/InfiniteTreeList/utils/checkIsChildrenPlaceholder/checkIsChildrenPlaceholder.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkIsChildrenPlaceholder = void 0;
+/**
+ * Проверяет, является ли элемент строкой-заглушкой ветки
+ */
+const checkIsChildrenPlaceholder = (item) => Boolean(item.placeholderKind);
+exports.checkIsChildrenPlaceholder = checkIsChildrenPlaceholder;

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

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

package/node/components/InfiniteTreeList/utils/checkIsChildrenPlaceholder/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("./checkIsChildrenPlaceholder"), exports);

package/node/components/InfiniteTreeList/utils/checkIsChildrenPlaceholderOf/checkIsChildrenPlaceholderOf.d.ts

@@ -0,0 +1,5 @@
+import type { FlattenTree, InfiniteTreeListData } from '../../types';
+/**
+ * Проверяет, является ли элемент строкой-заглушкой ветки конкретного родителя
+ */
+export declare const checkIsChildrenPlaceholderOf: <TData extends InfiniteTreeListData<TData>>(item: FlattenTree<TData>, parentId: string) => boolean;

package/node/components/InfiniteTreeList/utils/checkIsChildrenPlaceholderOf/checkIsChildrenPlaceholderOf.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkIsChildrenPlaceholderOf = void 0;
+const checkIsChildrenPlaceholder_1 = require("../checkIsChildrenPlaceholder");
+/**
+ * Проверяет, является ли элемент строкой-заглушкой ветки конкретного родителя
+ */
+const checkIsChildrenPlaceholderOf = (item, parentId) => item.meta.parentId === parentId && (0, checkIsChildrenPlaceholder_1.checkIsChildrenPlaceholder)(item);
+exports.checkIsChildrenPlaceholderOf = checkIsChildrenPlaceholderOf;

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

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

package/node/components/InfiniteTreeList/utils/checkIsChildrenPlaceholderOf/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("./checkIsChildrenPlaceholderOf"), exports);

package/node/components/InfiniteTreeList/utils/checkIsDirectChild/checkIsDirectChild.d.ts

@@ -0,0 +1,6 @@
+import type { FlattenTree, InfiniteTreeListData } from '../../types';
+/**
+ * Проверяет, является ли элемент прямым дочерним элементом родителя.
+ * Строки-заглушки ветки прямыми дочерними элементами не считаются
+ */
+export declare const checkIsDirectChild: <TData extends InfiniteTreeListData<TData>>(item: FlattenTree<TData>, parentId: string) => boolean;

package/node/components/InfiniteTreeList/utils/checkIsDirectChild/checkIsDirectChild.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkIsDirectChild = void 0;
+const checkIsChildrenPlaceholder_1 = require("../checkIsChildrenPlaceholder");
+/**
+ * Проверяет, является ли элемент прямым дочерним элементом родителя.
+ * Строки-заглушки ветки прямыми дочерними элементами не считаются
+ */
+const checkIsDirectChild = (item, parentId) => item.meta.parentId === parentId && !(0, checkIsChildrenPlaceholder_1.checkIsChildrenPlaceholder)(item);
+exports.checkIsDirectChild = checkIsDirectChild;

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

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

package/node/components/InfiniteTreeList/utils/checkIsDirectChild/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("./checkIsDirectChild"), exports);

package/node/components/InfiniteTreeList/utils/checkIsNoDataChildren/checkIsNoDataChildren.d.ts

@@ -0,0 +1,12 @@
+import type { InfiniteTreeChildrenPagination, InfiniteTreeListData } from '../../types';
+/**
+ * Пришли ли раскрытому узлу пустые дочерние элементы, для которых нужно
+ * показать заглушку «Нет данных».
+ *
+ * Пустые дочерние элементы без ошибки — ещё не признак отсутствия данных:
+ * до первого запроса узел отдаёт такое же пустое состояние, и заглушка мигала
+ * бы перед skeleton-строками. Поэтому дочерние элементы считаются
+ * загруженными, только если узел уже побывал в состоянии загрузки либо сам
+ * сообщил `isEndReached`
+ */
+export declare const checkIsNoDataChildren: <TData extends InfiniteTreeListData<TData>>(childrenState: InfiniteTreeChildrenPagination<TData>, hasLoadedOnce: boolean) => boolean;

package/node/components/InfiniteTreeList/utils/checkIsNoDataChildren/checkIsNoDataChildren.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkIsNoDataChildren = void 0;
+/**
+ * Пришли ли раскрытому узлу пустые дочерние элементы, для которых нужно
+ * показать заглушку «Нет данных».
+ *
+ * Пустые дочерние элементы без ошибки — ещё не признак отсутствия данных:
+ * до первого запроса узел отдаёт такое же пустое состояние, и заглушка мигала
+ * бы перед skeleton-строками. Поэтому дочерние элементы считаются
+ * загруженными, только если узел уже побывал в состоянии загрузки либо сам
+ * сообщил `isEndReached`
+ */
+const checkIsNoDataChildren = (childrenState, hasLoadedOnce) => !childrenState.isLoading &&
+    !childrenState.isError &&
+    childrenState.data.length === 0 &&
+    (Boolean(childrenState.isEndReached) || hasLoadedOnce);
+exports.checkIsNoDataChildren = checkIsNoDataChildren;

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

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

package/node/components/InfiniteTreeList/utils/checkIsNoDataChildren/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("./checkIsNoDataChildren"), exports);

package/node/components/InfiniteTreeList/utils/checkIsSameChildren/checkIsSameChildren.d.ts

@@ -0,0 +1,5 @@
+import type { InfiniteTreeChildrenPagination, InfiniteTreeListData } from '../../types';
+/**
+ * Сравнивает данные дочерних элементов узла по содержимому
+ */
+export declare const checkIsSameChildren: <TData extends InfiniteTreeListData<TData>>(current?: InfiniteTreeChildrenPagination<TData> | undefined, next?: InfiniteTreeChildrenPagination<TData> | undefined) => boolean;

package/node/components/InfiniteTreeList/utils/checkIsSameChildren/checkIsSameChildren.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkIsSameChildren = void 0;
+/**
+ * Сравнивает данные дочерних элементов узла по содержимому
+ */
+const checkIsSameChildren = (current, next) => {
+    if (current === next) {
+        return true;
+    }
+    if (!current || !next) {
+        return false;
+    }
+    return (current.isLoading === next.isLoading &&
+        current.isError === next.isError &&
+        current.isEndReached === next.isEndReached &&
+        current.data.length === next.data.length &&
+        current.data.every((item, index) => item.id === next.data[index]?.id));
+};
+exports.checkIsSameChildren = checkIsSameChildren;

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

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

package/node/components/InfiniteTreeList/utils/checkIsSameChildren/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("./checkIsSameChildren"), exports);

package/node/components/InfiniteTreeList/utils/countDirectChildren/countDirectChildren.d.ts

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

package/node/components/InfiniteTreeList/utils/countDirectChildren/countDirectChildren.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countDirectChildren = void 0;
+const checkIsDirectChild_1 = require("../checkIsDirectChild");
+/**
+ * Количество прямых дочерних элементов родителя без строк-заглушек
+ */
+const countDirectChildren = (flatList, parentId) => flatList.filter((item) => (0, checkIsDirectChild_1.checkIsDirectChild)(item, parentId)).length;
+exports.countDirectChildren = countDirectChildren;

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

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

package/node/components/InfiniteTreeList/utils/countDirectChildren/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("./countDirectChildren"), exports);

package/node/components/InfiniteTreeList/utils/createParentSlots/createParentSlots.d.ts

@@ -0,0 +1,24 @@
+export type ParentSlots = {
+    /**
+     * Отдаёт контейнер строки узла, создавая его при первом обращении
+     */
+    acquire: (itemId: string) => HTMLDivElement | null;
+    /**
+     * Выбрасывает контейнер узла вместе с его поддеревом
+     */
+    release: (itemId: string) => void;
+};
+/**
+ * Реестр постоянных контейнеров строк узлов с подгружаемыми дочерними
+ * элементами.
+ *
+ * Такая строка монтируется один раз, вне виртуализации, и живёт, пока жив
+ * список: виртуализация переносит её готовый DOM-узел в строку скролла и
+ * обратно, а React-поддерево при этом не размонтируется. Иначе состояние
+ * строки — store, query, локальный state — умирало бы на каждом скролле.
+ *
+ * Контейнер обязан быть стабильным: смена контейнера в `createPortal` — для
+ * React другой узел, он размонтирует поддерево и состояние потеряется. Поэтому
+ * переносится сам контейнер, а не содержимое портала
+ */
+export declare const createParentSlots: () => ParentSlots;

package/node/components/InfiniteTreeList/utils/createParentSlots/createParentSlots.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createParentSlots = void 0;
+/**
+ * Реестр постоянных контейнеров строк узлов с подгружаемыми дочерними
+ * элементами.
+ *
+ * Такая строка монтируется один раз, вне виртуализации, и живёт, пока жив
+ * список: виртуализация переносит её готовый DOM-узел в строку скролла и
+ * обратно, а React-поддерево при этом не размонтируется. Иначе состояние
+ * строки — store, query, локальный state — умирало бы на каждом скролле.
+ *
+ * Контейнер обязан быть стабильным: смена контейнера в `createPortal` — для
+ * React другой узел, он размонтирует поддерево и состояние потеряется. Поэтому
+ * переносится сам контейнер, а не содержимое портала
+ */
+const createParentSlots = () => {
+    const slots = new Map();
+    return {
+        acquire: (itemId) => {
+            if (typeof document === 'undefined') {
+                return null;
+            }
+            const slot = slots.get(itemId);
+            if (slot) {
+                return slot;
+            }
+            const created = document.createElement('div');
+            created.style.display = 'contents';
+            slots.set(itemId, created);
+            return created;
+        },
+        release: (itemId) => {
+            slots.get(itemId)?.remove();
+            slots.delete(itemId);
+        },
+    };
+};
+exports.createParentSlots = createParentSlots;

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

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

package/node/components/InfiniteTreeList/utils/createParentSlots/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("./createParentSlots"), exports);

package/node/components/InfiniteTreeList/utils/createTailRegistry/createTailRegistry.d.ts

@@ -0,0 +1,21 @@
+export type TailRegistry = {
+    /**
+     * Регистрирует хвост ветки. Тот же `parentId` и `itemId` — обновляет callback.
+     * Новый `itemId` сбрасывает `isLoadMoreRequested`
+     */
+    register: (parentId: string, itemId: string, endReached: () => void) => void;
+    /**
+     * Удаляет запись. Без `itemId` — всегда. С `itemId` — только если совпал хвост
+     */
+    unregister: (parentId: string, itemId?: string) => void;
+    /**
+     * Вызывает `endReached` для хвостов, чей индекс попадает в видимый диапазон.
+     * `getIndex === -1` пропускает запись
+     */
+    checkRange: (endIndex: number, getIndex: (itemId: string) => number) => void;
+};
+/**
+ * Реестр хвостов вложенных веток. Живёт на экземпляре списка и переживает
+ * размонтирование строки виртуализацией
+ */
+export declare const createTailRegistry: () => TailRegistry;

package/node/components/InfiniteTreeList/utils/createTailRegistry/createTailRegistry.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTailRegistry = void 0;
+/**
+ * Реестр хвостов вложенных веток. Живёт на экземпляре списка и переживает
+ * размонтирование строки виртуализацией
+ */
+const createTailRegistry = () => {
+    const entries = new Map();
+    return {
+        register(parentId, itemId, endReached) {
+            const existing = entries.get(parentId);
+            if (existing && existing.itemId === itemId) {
+                existing.endReached = endReached;
+                return;
+            }
+            entries.set(parentId, { itemId, endReached, isLoadMoreRequested: false });
+        },
+        unregister(parentId, itemId) {
+            if (itemId === undefined) {
+                entries.delete(parentId);
+                return;
+            }
+            const existing = entries.get(parentId);
+            if (existing?.itemId === itemId) {
+                entries.delete(parentId);
+            }
+        },
+        checkRange(endIndex, getIndex) {
+            entries.forEach((entry) => {
+                if (entry.isLoadMoreRequested) {
+                    return;
+                }
+                const index = getIndex(entry.itemId);
+                if (index === -1 || endIndex < index) {
+                    return;
+                }
+                entry.isLoadMoreRequested = true;
+                entry.endReached();
+            });
+        },
+    };
+};
+exports.createTailRegistry = createTailRegistry;

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

@@ -0,0 +1 @@
+export { createTailRegistry, type TailRegistry } from './createTailRegistry';