@astral/ui 4.100.0 → 4.102.0

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

package/node/components/InfiniteTreeList/TreeItem/CustomItemWrapper/CustomItemWrapper.d.ts

@@ -0,0 +1,20 @@
+import { type ReactNode } from 'react';
+import type { FlattenTree, InfiniteTreeListData } from '../../types';
+type CustomItemWrapperProps = {
+    /**
+     * Строка плоского списка
+     */
+    item: FlattenTree<InfiniteTreeListData>;
+    /**
+     * Рендер-функция строки из props списка
+     */
+    renderItem: (item: FlattenTree<InfiniteTreeListData>) => ReactNode;
+};
+/**
+ * Изолирует `renderItem` потребителя от ре-рендеров строки: без `memo` каждый
+ * ре-рендер `Item` пересобирал бы разметку строки заново.
+ *
+ * Узлы с подгружаемыми дочерними элементами рисует `CustomParentWrapper`
+ */
+export declare const CustomItemWrapper: import("react").MemoExoticComponent<({ item, renderItem }: CustomItemWrapperProps) => import("react/jsx-runtime").JSX.Element>;
+export {};

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

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomItemWrapper = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+// cspell:ignore пересобирал
+const react_1 = require("react");
+/**
+ * Изолирует `renderItem` потребителя от ре-рендеров строки: без `memo` каждый
+ * ре-рендер `Item` пересобирал бы разметку строки заново.
+ *
+ * Узлы с подгружаемыми дочерними элементами рисует `CustomParentWrapper`
+ */
+exports.CustomItemWrapper = (0, react_1.memo)(({ item, renderItem }) => (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: renderItem(item) }));

package/node/components/InfiniteTreeList/TreeItem/CustomItemWrapper/index.d.ts

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

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

package/node/components/InfiniteTreeList/TreeItem/ParentSlot/ParentSlot.d.ts

@@ -0,0 +1,5 @@
+import type { ParentSlotProps } from './types';
+/**
+ * Слот строки родительского узла списка
+ */
+export declare const ParentSlot: ({ itemId }: ParentSlotProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParentSlot = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const constants_1 = require("../../constants");
+const InfiniteTreeListContext_1 = require("../../InfiniteTreeListContext");
+const styles_1 = require("./styles");
+/**
+ * Слот строки родительского узла списка
+ */
+const ParentSlot = ({ itemId }) => {
+    const { acquireParentSlot, enterAnimation } = (0, react_1.useContext)(InfiniteTreeListContext_1.InfiniteTreeListContext);
+    const hostRef = (0, react_1.useRef)(null);
+    (0, react_1.useLayoutEffect)(() => {
+        const host = hostRef.current;
+        const slot = acquireParentSlot(itemId);
+        if (!host || !slot) {
+            return;
+        }
+        host.appendChild(slot);
+        const row = slot.firstElementChild;
+        if (row instanceof HTMLElement) {
+            // Без снятия узел вернулся бы в список с анимацией исчезновения от
+            // прошлого сворачивания ветки
+            row.classList.remove(constants_1.infiniteTreeListClassnames.rowRemoveAnimation);
+            const { shouldAnimate, delayIndex } = enterAnimation.read(itemId);
+            row.classList.toggle(constants_1.infiniteTreeListClassnames.rowAddAnimation, shouldAnimate);
+            if (shouldAnimate && delayIndex !== undefined) {
+                row.style.setProperty('--sibling-index', String(delayIndex));
+            }
+        }
+        enterAnimation.claim(itemId);
+        // Контейнер не удаляется, а открепляется: строка остаётся смонтированной и
+        // ждёт следующего появления узла на экране
+        return () => {
+            slot.remove();
+        };
+    }, [itemId, acquireParentSlot, enterAnimation]);
+    return (0, jsx_runtime_1.jsx)(styles_1.Host, { ref: hostRef });
+};
+exports.ParentSlot = ParentSlot;

package/node/components/InfiniteTreeList/TreeItem/ParentSlot/index.d.ts

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

package/node/components/InfiniteTreeList/TreeItem/ParentSlot/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("./ParentSlot"), exports);
+__exportStar(require("./types"), exports);

package/node/components/InfiniteTreeList/TreeItem/ParentSlot/styles.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+/**
+ * Место строки узла в скролле. Своего box не создаёт: отступы и раскладка
+ * перенесённой строки считаются так же, как если бы она была здесь всегда
+ */
+export declare const Host: import("@emotion/styled/dist/declarations/src/types").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/node/components/InfiniteTreeList/TreeItem/ParentSlot/styles.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Host = void 0;
+const styled_1 = require("../../../styled");
+/**
+ * Место строки узла в скролле. Своего box не создаёт: отступы и раскладка
+ * перенесённой строки считаются так же, как если бы она была здесь всегда
+ */
+exports.Host = styled_1.styled.div `
+  display: contents;
+`;

package/node/components/InfiniteTreeList/TreeItem/ParentSlot/types.d.ts

@@ -0,0 +1,6 @@
+export type ParentSlotProps = {
+    /**
+     * Id узла, чей контейнер занимает строка
+     */
+    itemId: string;
+};

package/node/components/InfiniteTreeList/TreeItem/ParentSlot/types.js

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

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

@@ -1,3 +1,6 @@
-import type { InfiniteTreeListData } from '../types';
 import { type TreeItemProps } from './types';
-export declare const TreeItem: <TData extends InfiniteTreeListData<TData>>(props: TreeItemProps<TData>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Строка виртуализации: обёртка, которую `Virtuoso` рендерит вокруг элемента.
+ * Ставит контекст строки, css-переменные уровня и каскада, classname анимации
+ */
+export declare const TreeItem: ({ children, ...props }: TreeItemProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -2,11 +2,38 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TreeItem = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
+const cva_1 = require("../../utils/cva");
+const constants_1 = require("../constants");
+const InfiniteTreeListItem_1 = require("../InfiniteTreeListItem");
+const ChildrenPlaceholder_1 = require("./ChildrenPlaceholder");
+const CustomItemWrapper_1 = require("./CustomItemWrapper");
+const ParentSlot_1 = require("./ParentSlot");
 const styles_1 = require("./styles");
 const useLogic_1 = require("./useLogic");
-const TreeItem = (props) => {
-    const { item, renderItem, classname, onAnimationEnd } = (0, useLogic_1.useLogic)(props);
-    const { nodeId, level, siblingIndex } = item.meta;
-    return ((0, jsx_runtime_1.jsx)(styles_1.Wrapper, { id: nodeId, className: classname, "$level": level, "$siblingIndex": siblingIndex, onAnimationEnd: onAnimationEnd, children: renderItem(item) }));
+const treeItemCva = (0, cva_1.cva)(constants_1.infiniteTreeListClassnames.row, {
+    variants: {
+        isSpinner: {
+            true: constants_1.infiniteTreeListClassnames.rowSpinner,
+        },
+        hasAddAnimation: {
+            true: constants_1.infiniteTreeListClassnames.rowAddAnimation,
+        },
+    },
+});
+/**
+ * Строка виртуализации: обёртка, которую `Virtuoso` рендерит вокруг элемента.
+ * Ставит контекст строки, css-переменные уровня и каскада, classname анимации
+ */
+const TreeItem = ({ children, ...props }) => {
+    const { item, renderItem, onToggle, memoizedItemProps, cssVars, isSpinner, hasAddAnimation, } = (0, useLogic_1.useLogic)(props);
+    const { nodeId, isChildrenAsync } = item.meta;
+    // Строку узла с подгружаемыми дочерними элементами рисует не список,
+    // а постоянный слой: сюда она приезжает готовым DOM-узлом. Иначе store,
+    // заведённый потребителем внутри renderParent, умирал бы на каждом уходе
+    // строки со скролла
+    if (isChildrenAsync && !item.placeholderKind) {
+        return ((0, jsx_runtime_1.jsx)("div", { ...memoizedItemProps, children: (0, jsx_runtime_1.jsx)(ParentSlot_1.ParentSlot, { itemId: item.id }) }));
+    }
+    return ((0, jsx_runtime_1.jsx)("div", { ...memoizedItemProps, children: (0, jsx_runtime_1.jsx)(InfiniteTreeListItem_1.TreeListItemContextProvider, { item: item, onToggle: onToggle, children: (0, jsx_runtime_1.jsx)(styles_1.Wrapper, { id: nodeId, className: treeItemCva({ isSpinner, hasAddAnimation }), style: cssVars, children: item.placeholderKind ? ((0, jsx_runtime_1.jsx)(ChildrenPlaceholder_1.ChildrenPlaceholder, { item: item })) : ((0, jsx_runtime_1.jsx)(CustomItemWrapper_1.CustomItemWrapper, { item: item, renderItem: renderItem })) }) }) }));
 };
 exports.TreeItem = TreeItem;

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

@@ -1 +1,4 @@
+/**
+ * Задержка каскадной анимации между соседними строками, мс
+ */
 export declare const ANIMATION_DELAY = 30;

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

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ANIMATION_DELAY = void 0;
-// Задержка для каскадной анимации элементов в ms
+/**
+ * Задержка каскадной анимации между соседними строками, мс
+ */
 exports.ANIMATION_DELAY = 30;

package/node/components/InfiniteTreeList/TreeItem/styles.d.ts

@@ -2,7 +2,4 @@
 export declare const Wrapper: import("@emotion/styled/dist/declarations/src/types").StyledComponent<{
     theme?: import("@emotion/react").Theme | undefined;
     as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;
-} & {
-    $level: number;
-    $siblingIndex?: number | undefined;
 }, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;

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

@@ -6,6 +6,9 @@ const Tooltip_1 = require("../../Tooltip");
 const constants_1 = require("../constants");
 const constants_2 = require("./constants");
 exports.Wrapper = styled_1.styled.div `
+  --level: 0;
+  --sibling-index: 0;
+
   @keyframes slide-in-from-left {
     0% {
       transform: translateX(-16px);
@@ -42,21 +45,33 @@ exports.Wrapper = styled_1.styled.div `
 
   min-height: 60px;
   margin-top: ${({ theme }) => theme.spacing(1)};
-  margin-left: ${({ $level }) => `calc(${$level} * 20px)`};
+  margin-left: calc(var(--level) * ${({ theme }) => theme.spacing(5)});
 
   border: 1px solid ${({ theme }) => theme.palette.components.border.default};
   border-radius: ${({ theme }) => theme.shape.medium};
-  
-  &.${constants_1.infiniteTreeListClassnames.addAnimation} {
-    animation: slide-in-from-left ${({ theme }) => theme.transitions.duration.short}ms ease-out;
+
+  &.${constants_1.infiniteTreeListClassnames.rowAddAnimation} {
+    animation: slide-in-from-left
+      ${({ theme }) => theme.transitions.duration.short}ms ease-out;
     animation-fill-mode: both;
-    animation-delay: ${({ $siblingIndex = 0 }) => $siblingIndex * constants_2.ANIMATION_DELAY}ms;
+    animation-delay: calc(var(--sibling-index) * ${constants_2.ANIMATION_DELAY}ms);
   }
 
-  &.${constants_1.infiniteTreeListClassnames.removeAnimation} {
-    animation: slide-out-to-left ${({ theme }) => theme.transitions.duration.shorter}ms ease-in forwards;
+  &.${constants_1.infiniteTreeListClassnames.rowRemoveAnimation} {
+    animation: slide-out-to-left
+      ${({ theme }) => theme.transitions.duration.shorter}ms ease-in forwards;
     animation-fill-mode: both;
-    animation-delay: ${({ $siblingIndex = 0 }) => $siblingIndex * constants_2.ANIMATION_DELAY}ms;
+    animation-delay: calc(var(--sibling-index) * ${constants_2.ANIMATION_DELAY}ms);
+  }
+
+  &.${constants_1.infiniteTreeListClassnames.rowSpinner} {
+    justify-content: center;
+
+    width: 100%;
+    min-height: 64px;
+
+    background: transparent;
+    border: none;
   }
 
   & > .${Tooltip_1.tooltipClassnames.contentWrapper} {

package/node/components/InfiniteTreeList/TreeItem/types.d.ts

@@ -1,9 +1,4 @@
-import type { ReactNode, RefObject } from 'react';
-import { type FlattenTree, type InfiniteTreeItemMeta, type InfiniteTreeListData } from '../types';
-export type TreeItemProps<TData extends InfiniteTreeListData<TData>> = {
-    item: FlattenTree<TData>;
-    renderItem: (item: TData & {
-        meta: InfiniteTreeItemMeta;
-    }) => ReactNode;
-    recentlyExpandedIds: RefObject<Set<string>>;
-};
+import type { ContextProp, ItemProps as VirtuosoItemProps } from 'react-virtuoso';
+import { type ListFooterContext } from '../ListFooter';
+import type { FlattenTree, InfiniteTreeListData } from '../types';
+export type TreeItemProps = VirtuosoItemProps<FlattenTree<InfiniteTreeListData>> & ContextProp<ListFooterContext>;

package/node/components/InfiniteTreeList/TreeItem/useLogic/useLogic.d.ts

@@ -1,11 +1,31 @@
-/// <reference types="react" />
-import type { InfiniteTreeListData } from '../../types';
+import { type CSSProperties } from 'react';
 import { type TreeItemProps } from '../types';
-export declare const useLogic: <TData extends InfiniteTreeListData<TData>>({ item, renderItem, recentlyExpandedIds, }: TreeItemProps<TData>) => {
-    item: import("../../types").FlattenTree<TData>;
-    renderItem: (item: TData & {
-        meta: import("../../types").InfiniteTreeItemMeta;
-    }) => import("react").ReactNode;
-    classname: string;
-    onAnimationEnd: () => void;
+type UseLogicParams = Omit<TreeItemProps, 'children'>;
+/**
+ * Логика строки виртуализации: регистрирует хвост ветки в реестре, один раз
+ * на mount читает метку enter-анимации и считает css-переменные строки.
+ *
+ * Про хвост: `Virtuoso` виртуализирует плоский список, и его `endReached` —
+ * это конец всего списка, то есть корневая пагинация. У вложенной пагинации
+ * свой признак конца: последний загруженный дочерний элемент раскрытой
+ * ветки. Такая строка пишет себя в `tailRegistry`, а `useListScroll` на смене
+ * видимого диапазона зовёт `checkRange` — попал хвост в кадр, ветка просит
+ * `onLoadMore(parentId)`. Отдельного элемента-sentinel в разметке для
+ * этого нет
+ */
+export declare const useLogic: ({ item, context, ...itemProps }: UseLogicParams) => {
+    item: import("../../types").FlattenTree<import("../../types").InfiniteTreeListData>;
+    renderItem: (item: import("../../types").FlattenTree<import("../../types").InfiniteTreeListData>) => import("react").ReactNode;
+    onToggle: (item: import("../../types").InfiniteTreeListData) => void;
+    memoizedItemProps: {
+        style?: CSSProperties | undefined;
+        'data-index': number;
+        'data-item-group-index'?: number | undefined;
+        'data-item-index': number;
+        'data-known-size': number;
+    };
+    cssVars: CSSProperties;
+    isSpinner: boolean;
+    hasAddAnimation: boolean;
 };
+export {};

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 });