@astral/ui 4.99.2 → 4.101.0

package/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/components/InfiniteTreeList/hooks/useEnterAnimation/types.js

@@ -0,0 +1 @@
+export {};

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

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

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

@@ -0,0 +1,35 @@
+import { useCallback, useEffect, useMemo, useRef } from 'react';
+import { ENTER_ANIMATION_MOUNT_WINDOW_MS } from '../../constants';
+const NO_ANIMATION = { shouldAnimate: false };
+/**
+ * Управляет enter-анимацией строк дерева: метка живёт до первого mount строки
+ * и потребляется им
+ */
+export const useEnterAnimation = () => {
+    const delayIndexes = useRef(new Map());
+    const resetTimer = useRef(undefined);
+    const reset = useCallback(() => {
+        clearTimeout(resetTimer.current);
+        delayIndexes.current.clear();
+    }, []);
+    const schedule = 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, ENTER_ANIMATION_MOUNT_WINDOW_MS);
+    }, [reset]);
+    const read = useCallback((itemId) => {
+        const delayIndex = delayIndexes.current.get(itemId);
+        if (delayIndex === undefined) {
+            return NO_ANIMATION;
+        }
+        return { shouldAnimate: true, delayIndex };
+    }, []);
+    const claim = useCallback((itemId) => {
+        delayIndexes.current.delete(itemId);
+    }, []);
+    useEffect(() => () => clearTimeout(resetTimer.current), []);
+    return useMemo(() => ({ schedule, read, claim, reset }), [schedule, read, claim, reset]);
+};

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

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

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

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

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

@@ -0,0 +1,19 @@
+import { useCallback, useRef } from 'react';
+/**
+ * Блокирует повторные вызовы `onOpen`: узел сообщает о раскрытии один
+ * раз, пока ветка не свёрнута
+ */
+export const useExpandNotifier = () => {
+    const notifiedIdsRef = useRef(new Set());
+    const notifyExpand = useCallback((itemId, onOpen) => {
+        if (notifiedIdsRef.current.has(itemId)) {
+            return;
+        }
+        notifiedIdsRef.current.add(itemId);
+        onOpen?.();
+    }, []);
+    const resetExpandNotification = useCallback((itemIds) => {
+        itemIds.forEach((itemId) => notifiedIdsRef.current.delete(itemId));
+    }, []);
+    return { notifyExpand, resetExpandNotification };
+};

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

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

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

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

package/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/components/InfiniteTreeList/hooks/useFlatTree/types.js

@@ -0,0 +1 @@
+export {};

package/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;
+};

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

@@ -0,0 +1,88 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { useTheme } from '../../../theme/hooks';
+import { useSet } from '../../../useSet';
+import { flattenTree, getInitialExpandedIds, getNestedItems, insertChildren as insertChildrenIntoFlatList, removeChildren as removeChildrenFromFlatList, sortCollapsed, startRemoveAnimation, syncChildrenPlaceholders as syncPlaceholdersInFlatList, } from '../../utils';
+/**
+ * Управляет плоским списком строк и набором раскрытых узлов
+ */
+export const useFlatTree = ({ items, initialExpandedLevel, enterAnimation, onCollapse, }) => {
+    const theme = useTheme();
+    const [expandedIds, { add: addExpandedId, remove: removeExpandedId }] = useSet(new Set());
+    const [flatList, setFlatList] = useState(() => flattenTree(items, new Set()));
+    const expandedIdsRef = useRef(expandedIds);
+    const flatListRef = useRef(flatList);
+    // Синхронизация после коммита: запись в ref во время рендера — side effect,
+    // отброшенный рендер оставил бы в ref значение из дерева, которое
+    // не попало в коммит.
+    // Эффект объявлен первым, поэтому эффекты ниже по списку хуков читают из ref
+    // актуальные значения
+    useEffect(() => {
+        expandedIdsRef.current = expandedIds;
+        flatListRef.current = flatList;
+    });
+    const collapseTimersRef = useRef([]);
+    useEffect(() => () => {
+        collapseTimersRef.current.forEach(clearTimeout);
+    }, []);
+    useEffect(() => {
+        const next = getInitialExpandedIds(expandedIdsRef.current, items, initialExpandedLevel);
+        next.forEach(addExpandedId);
+        expandedIdsRef.current = next;
+        setFlatList(flattenTree(items, next));
+    }, [items]);
+    const insertChildren = useCallback((parentId, childrenData) => {
+        setFlatList((prev) => insertChildrenIntoFlatList(prev, parentId, childrenData, expandedIdsRef.current));
+    }, []);
+    const syncChildrenPlaceholders = useCallback((parentId, isChildrenLoading, skeletonCount, isChildrenError, isChildrenNoData) => {
+        setFlatList((prev) => syncPlaceholdersInFlatList(prev, parentId, isChildrenLoading, skeletonCount, isChildrenError, isChildrenNoData));
+    }, []);
+    const expandNode = useCallback((itemId) => {
+        const staticChildren = flatListRef.current.find((item) => item.id === itemId)?.children;
+        enterAnimation.schedule(staticChildren?.map((child) => child.id) ?? []);
+        addExpandedId(itemId);
+        expandedIdsRef.current = new Set(expandedIdsRef.current).add(itemId);
+        setFlatList((prev) => {
+            const withExpanded = prev.map((item) => item.id === itemId
+                ? { ...item, meta: { ...item.meta, isExpanded: true } }
+                : item);
+            if (!staticChildren?.length) {
+                return withExpanded;
+            }
+            return insertChildrenIntoFlatList(withExpanded, itemId, staticChildren, expandedIdsRef.current);
+        });
+    }, [addExpandedId, enterAnimation]);
+    const collapseNode = useCallback((itemId) => {
+        const nestedItems = sortCollapsed(getNestedItems(flatListRef.current, itemId));
+        nestedItems.forEach(({ meta }) => startRemoveAnimation(meta.nodeId));
+        // Ветка уходит из данных только после анимации закрытия
+        const timerId = setTimeout(() => {
+            collapseTimersRef.current = collapseTimersRef.current.filter((id) => id !== timerId);
+            const collapsedIds = [itemId, ...nestedItems.map(({ id }) => id)];
+            const nextExpanded = new Set(expandedIdsRef.current);
+            collapsedIds.forEach((collapsedId) => {
+                removeExpandedId(collapsedId);
+                nextExpanded.delete(collapsedId);
+            });
+            expandedIdsRef.current = nextExpanded;
+            onCollapse(collapsedIds);
+            setFlatList((prev) => removeChildrenFromFlatList(prev, itemId));
+        }, theme.transitions.duration.shorter);
+        collapseTimersRef.current.push(timerId);
+    }, [onCollapse, removeExpandedId, theme]);
+    const onToggle = useCallback(({ id: itemId }) => {
+        if (expandedIdsRef.current.has(itemId)) {
+            collapseNode(itemId);
+            return;
+        }
+        expandNode(itemId);
+    }, [collapseNode, expandNode]);
+    return {
+        flatList,
+        flatListRef,
+        expandedIds,
+        expandedIdsRef,
+        insertChildren,
+        syncChildrenPlaceholders,
+        onToggle,
+    };
+};

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

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

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

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

package/components/InfiniteTreeList/hooks/useListScroll/types.d.ts

@@ -0,0 +1,25 @@
+import type { RefObject } from 'react';
+import type { FlattenTree, InfiniteTreeListData } from '../../types';
+import type { EnterAnimationResult } from '../useEnterAnimation';
+export type UseListScrollParams<TData extends InfiniteTreeListData<TData>> = {
+    /**
+     * Ref на контейнер, в котором должен быть скролл
+     */
+    scrollRef: RefObject<HTMLElement | null>;
+    /**
+     * Флаг достижения конца списка
+     */
+    isEndReached?: boolean;
+    /**
+     * Обработчик подгрузки данных
+     */
+    onLoadMore?: () => void;
+    /**
+     * Плоский список: реестр хвостов ищет в нём позицию строки
+     */
+    flatListRef: RefObject<FlattenTree<TData>[]>;
+    /**
+     * Контроллер enter-анимации: скролл снимает метки со строк
+     */
+    enterAnimation: EnterAnimationResult;
+};

package/components/InfiniteTreeList/hooks/useListScroll/types.js

@@ -0,0 +1 @@
+export {};

package/components/InfiniteTreeList/hooks/useListScroll/useListScroll.d.ts

@@ -0,0 +1,29 @@
+/// <reference types="react" />
+import type { ListRange, VirtuosoHandle } from 'react-virtuoso';
+import type { InfiniteTreeListData } from '../../types';
+import { type TailRegistry } from '../../utils';
+import type { UseListScrollParams } from './types';
+/**
+ * Скролл-обвязка списка: props для `Virtuoso`, кнопка «наверх» и реестр хвостов
+ * вложенных веток. Хвосты регистрируют сами строки, хук создаёт реестр и на
+ * смене видимого диапазона проверяет, попал ли хвост в кадр
+ */
+export declare const useListScroll: <TData extends InfiniteTreeListData<TData>>({ scrollRef, isEndReached, onLoadMore, flatListRef, enterAnimation, }: UseListScrollParams<TData>) => {
+    scrollParent: HTMLElement | null;
+    tailRegistry: TailRegistry;
+    isEndReachedWithScroll: boolean | undefined;
+    virtuosoProps: {
+        id: string;
+        ref: import("react").RefObject<VirtuosoHandle | null>;
+        overscan: number;
+        rangeChanged: (range: ListRange) => void;
+        endReached: () => void;
+        totalListHeightChanged: () => void;
+        isScrolling: (isScrolling: boolean) => void;
+    };
+    onTopButtonProps: {
+        buttonRef: import("react").RefObject<HTMLButtonElement | null>;
+        handleScrollToTop: () => void;
+        scrollRef: import("react").RefObject<HTMLElement | null>;
+    };
+};

package/components/InfiniteTreeList/hooks/useListScroll/useListScroll.js

@@ -0,0 +1,59 @@
+import { useCallback, useRef } from 'react';
+import { useScrollManagement } from '../../../useScrollManagement';
+import { infiniteTreeListClassnames, OVERSCAN, VIRTUOSO_CONTAINER_ID, } from '../../constants';
+import { createTailRegistry } from '../../utils';
+/**
+ * Скролл-обвязка списка: props для `Virtuoso`, кнопка «наверх» и реестр хвостов
+ * вложенных веток. Хвосты регистрируют сами строки, хук создаёт реестр и на
+ * смене видимого диапазона проверяет, попал ли хвост в кадр
+ */
+export const useListScroll = ({ scrollRef, isEndReached, onLoadMore, flatListRef, enterAnimation, }) => {
+    const virtuosoRef = useRef(null);
+    const scrollToTopButtonRef = useRef(null);
+    const tailRegistryRef = useRef(null);
+    if (!tailRegistryRef.current) {
+        tailRegistryRef.current = createTailRegistry();
+    }
+    const tailRegistry = tailRegistryRef.current;
+    const { scrollParent, recalculateVerticalScroll, handleEndReach, isEndReachedWithScroll, } = useScrollManagement({
+        scrollRef,
+        isEndReached,
+        onLoadMore,
+        virtuosoId: VIRTUOSO_CONTAINER_ID,
+    });
+    // Скролл виртуализации монтирует строки, которые появлением не считаются
+    const handleScrollingChange = useCallback((isScrolling) => {
+        if (isScrolling) {
+            enterAnimation.reset();
+        }
+    }, [enterAnimation]);
+    const handleRangeChanged = useCallback((range) => {
+        scrollToTopButtonRef.current?.classList.toggle(infiniteTreeListClassnames.visibleScrollToTopButton, range.startIndex > 2);
+        tailRegistry.checkRange(range.endIndex, (itemId) => flatListRef.current.findIndex((item) => item.id === itemId));
+    }, [flatListRef, tailRegistry]);
+    const handleScrollToTop = useCallback(() => {
+        if (scrollRef.current) {
+            scrollRef.current.style.scrollBehavior = 'auto';
+        }
+        virtuosoRef.current?.scrollToIndex(0);
+    }, [scrollRef]);
+    return {
+        scrollParent,
+        tailRegistry,
+        isEndReachedWithScroll,
+        virtuosoProps: {
+            id: VIRTUOSO_CONTAINER_ID,
+            ref: virtuosoRef,
+            overscan: OVERSCAN,
+            rangeChanged: handleRangeChanged,
+            endReached: handleEndReach,
+            totalListHeightChanged: recalculateVerticalScroll,
+            isScrolling: handleScrollingChange,
+        },
+        onTopButtonProps: {
+            buttonRef: scrollToTopButtonRef,
+            handleScrollToTop,
+            scrollRef,
+        },
+    };
+};

package/components/InfiniteTreeList/index.d.ts

@@ -1,4 +1,4 @@
 export { InfiniteTreeList } from './InfiniteTreeList';
-export type { InfiniteTreeListProps } from './types';
+export type { InfiniteTreeChildrenPagination, InfiniteTreeItemMeta, InfiniteTreeListProps, } from './types';
 export { InfiniteTreeListItem, type InfiniteTreeListItemProps, } from './InfiniteTreeListItem';
 export { type InfiniteTreeListActionProps, InfiniteTreeListActions, } from './InfiniteTreeListActions';

package/components/InfiniteTreeList/public.d.ts

@@ -1,4 +1,4 @@
 export { InfiniteTreeList } from './InfiniteTreeList';
 export { type InfiniteTreeListActionProps, InfiniteTreeListActions, } from './InfiniteTreeListActions';
 export { InfiniteTreeListItem, type InfiniteTreeListItemProps, } from './InfiniteTreeListItem';
-export type { InfiniteTreeListProps } from './types';
+export type { InfiniteTreeChildrenPagination, InfiniteTreeItemMeta, InfiniteTreeListProps, } from './types';

package/components/InfiniteTreeList/types.d.ts

@@ -1,34 +1,56 @@
 import type { ReactNode, RefObject } from 'react';
-/**
- * Базовый тип элемента дерева для InfiniteTreeList
- */
 export type InfiniteTreeListDataBase = {
     /**
      * Уникальный идентификатор элемента
      */
     id: string;
     /**
-     * Дополнительные  поля
+     * Дочерние элементы узла подгружаются отдельно: список раскрывает такой узел,
+     * показывает skeleton-строки и ждёт их из props строки (`childItems`).
+     *
+     * Статическое дерево описывается полем `children` и флага не требует
+     */
+    hasChildren?: boolean;
+    /**
+     * Дополнительные поля
      */
     [key: string]: unknown;
 };
-/**
- * Тип элемента дерева с возможными дочерними элементами
- */
 export type InfiniteTreeListData<TData extends InfiniteTreeListData<TData> = InfiniteTreeListDataBase> = InfiniteTreeListDataBase & {
     children?: TData[];
 };
+/**
+ * Состояние пагинации дочерних элементов узла
+ */
+export type InfiniteTreeChildrenPagination<TData extends InfiniteTreeListData<TData> = InfiniteTreeListDataBase> = {
+    /**
+     * Загруженные дочерние элементы узла
+     */
+    data: TData[];
+    /**
+     * Дочерние элементы загружаются
+     */
+    isLoading?: boolean;
+    /**
+     * Загрузка дочерних элементов завершилась ошибкой
+     */
+    isError?: boolean;
+    /**
+     * Все дочерние элементы узла загружены
+     */
+    isEndReached?: boolean;
+};
 export type InfiniteTreeListProps<TData extends InfiniteTreeListData<TData> = InfiniteTreeListDataBase> = {
     /**
      * Список элементов дерева
      */
     items: TData[];
     /**
-     * Если true, будет отображаться лоадер
+     * Список в состоянии загрузки
      */
     isLoading?: boolean;
     /**
-     * Если `true`, компонент будет отображаться в состоянии ошибки
+     * Список в состоянии ошибки
      */
     isError?: boolean;
     /**
@@ -48,11 +70,11 @@ export type InfiniteTreeListProps<TData extends InfiniteTreeListData<TData> = In
      */
     onLoadMore?: () => void;
     /**
-     * Реф на контейнер, в котором должен быть скролл
+     * Ref на контейнер, в котором должен быть скролл
      */
     scrollRef: RefObject<HTMLElement | null>;
     /**
-     * Рендер-функция элемента списка
+     * Рендер-функция строки без пагинации дочерних элементов.
      *
      * @example
      * renderItem={(item) => (
@@ -66,7 +88,29 @@ export type InfiniteTreeListProps<TData extends InfiniteTreeListData<TData> = In
         meta: InfiniteTreeItemMeta;
     }) => ReactNode;
     /**
-     * Уровень раскрытия дерева по умолчанию
+     * Рендер-функция строки узла с подгружаемыми дочерними элементами (`hasChildren`).
+     * Без `renderParent` такие узлы рендерит `renderItem`.
+     *
+     * @example
+     * renderParent={(item) => (
+     *                 <InfiniteTreeListItem
+     *                   isLoading={childrenState?.isLoading}
+     *                   isError={childrenState?.isError}
+     *                   isEndReached={childrenState?.isEndReached}
+     *                   childItems={childrenState?.data}
+     *                   onOpen={() => loadChildren(item.id)}
+     *                   onLoadMore={() => loadChildren(item.id)}
+     *                 >
+     *                   <Avatar>{item.avatarName}</Avatar>
+     *                   <Typography>{item.organization}</Typography>
+     *                 </InfiniteTreeListItem>
+     *               )}
+     */
+    renderParent?: (item: TData & {
+        meta: InfiniteTreeItemMeta;
+    }) => ReactNode;
+    /**
+     * Уровень раскрытия дерева по умолчанию.
      */
     initialExpandedLevel?: number;
     /**
@@ -74,7 +118,7 @@ export type InfiniteTreeListProps<TData extends InfiniteTreeListData<TData> = In
      */
     endOfScrollMsg?: string;
     /**
-     * Скелетон для элемента в состоянии загрузки
+     * Строка в состоянии загрузки.
      */
     itemSkeleton?: ReactNode;
     /**
@@ -93,7 +137,7 @@ export type InfiniteTreeItemMeta = {
      */
     level: number;
     /**
-     * Путь до элемента (массив id родителей)
+     * Путь до элемента: id всех родителей от корня и id самого элемента
      */
     path: string[];
     /**
@@ -101,22 +145,44 @@ export type InfiniteTreeItemMeta = {
      */
     parentId?: string;
     /**
-     * Индекс элемента среди siblings (для каскадной анимации)
+     * Индекс элемента среди соседей (siblings) для каскадной анимации
      */
     siblingIndex: number;
     /**
-     * Флаг имеет ли элемент вложенных потомков
+     * У элемента есть вложенные элементы: строка получает Chevron
      */
     hasNested: boolean;
+    /**
+     * Дочерние элементы узла подгружаются, а не лежат в `children`
+     */
+    isChildrenAsync: boolean;
     /**
      * Флаг раскрытия узла
      */
     isExpanded: boolean;
     /**
-     * Id Node элемента. Используется для анимации закрытия
+     * Id DOM-узла строки. Используется для анимации закрытия
      */
     nodeId: string;
 };
+/**
+ * Вид строки-заглушки, которой список замещает дочерние элементы раскрытого
+ * родителя:
+ * - `skeleton` — первая загрузка ветки, дочерних элементов ещё нет;
+ * - `spinner` — догрузка следующей порции под уже показанными дочерними
+ *   элементами;
+ * - `no-data` — ветка загрузилась пустой;
+ * - `error` — загрузка ветки упала
+ */
+export type ChildrenPlaceholderKind = 'skeleton' | 'spinner' | 'no-data' | 'error';
 export type FlattenTree<TData extends InfiniteTreeListData<TData>> = TData & {
     meta: InfiniteTreeItemMeta;
+    /**
+     * Вид строки-заглушки. У строк с данными потребителя поля нет
+     */
+    placeholderKind?: ChildrenPlaceholderKind;
+};
+export type FlattenTreeParent = {
+    id: string;
+    meta: Pick<InfiniteTreeItemMeta, 'path' | 'level'>;
 };

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

@@ -1,38 +1,48 @@
 /// <reference types="react" />
 import { type ContentStateProps } from '../../ContentState';
-import type { FlattenTree, InfiniteTreeListData, InfiniteTreeListProps } from '../types';
+import type { ListFooterContext } from '../ListFooter';
+import type { InfiniteTreeListData, InfiniteTreeListProps } from '../types';
 type UseLogicParams<TData extends InfiniteTreeListData<TData>> = InfiniteTreeListProps<TData>;
-export declare const useLogic: <TData extends InfiniteTreeListData<TData>>({ initialExpandedLevel, items, onRetry, errorMsg, isError, isLoading, scrollRef, isEndReached, onLoadMore, renderItem, itemSkeleton, endOfScrollMsg, noDataImgSrc, errorImgSrc, }: UseLogicParams<TData>) => {
-    flatList: FlattenTree<TData>[];
+/**
+ * Логика списка: сводит плоский список, данные дочерних элементов, скролл
+ * и анимацию появления строк в props для `Virtuoso` и дочерних компонентов
+ */
+export declare const useLogic: <TData extends InfiniteTreeListData<TData>>({ initialExpandedLevel, items, onRetry, errorMsg, isError, isLoading, scrollRef, isEndReached, onLoadMore, renderItem, renderParent, itemSkeleton, endOfScrollMsg, noDataImgSrc, errorImgSrc, }: UseLogicParams<TData>) => {
+    flatList: import("../types").FlattenTree<TData>[];
     onToggle: ({ id: itemId }: InfiniteTreeListData) => void;
+    nodePaginationMap: Record<string, import("../InfiniteTreeListContext").NodePagination>;
+    registerChildren: (itemId: string, childrenState: import("../types").InfiniteTreeChildrenPagination) => void;
+    notifyExpand: (itemId: string, onOpen?: (() => void) | undefined) => void;
+    parentItems: import("../types").FlattenTree<TData>[];
+    acquireParentSlot: (itemId: string) => HTMLDivElement | null;
     contentStateProps: Omit<ContentStateProps, "children">;
     scrollParent: HTMLElement | null;
     virtuosoProps: {
         id: string;
         ref: import("react").RefObject<import("react-virtuoso").VirtuosoHandle | null>;
+        overscan: number;
         rangeChanged: (range: import("react-virtuoso").ListRange) => void;
         endReached: () => void;
         totalListHeightChanged: () => void;
+        isScrolling: (isScrolling: boolean) => void;
     };
-    footerProps: {
-        isError: boolean | undefined;
-        isLoading: boolean | undefined;
-        isEndReached: boolean | undefined;
-    };
+    footerContext: ListFooterContext;
     onTopButtonProps: {
-        isActive: boolean;
+        buttonRef: import("react").RefObject<HTMLButtonElement | null>;
         handleScrollToTop: () => void;
         scrollRef: import("react").RefObject<HTMLElement | null>;
     };
-    endOfScrollMsg: string | undefined;
     itemSkeleton: import("react").ReactNode;
     renderItem: (item: TData & {
         meta: import("../types").InfiniteTreeItemMeta;
     }) => import("react").ReactNode;
+    renderParent: (item: TData & {
+        meta: import("../types").InfiniteTreeItemMeta;
+    }) => import("react").ReactNode;
     items: TData[];
-    onLoadMore: (() => void) | undefined;
     onRetry: () => void;
     noDataImgSrc: string | undefined;
-    recentlyExpandedIds: import("react").RefObject<Set<string>>;
+    enterAnimation: import("../hooks").EnterAnimationResult;
+    tailRegistry: import("../utils").TailRegistry;
 };
 export {};