@astral/ui 4.100.0 → 4.101.0

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astral/ui",
-  "version": "4.100.0",
+  "version": "4.101.0",
   "browser": "./index.js",
   "main": "./node/index.js",
   "dependencies": {

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

@@ -1,5 +0,0 @@
-import type { FlattenTree, InfiniteTreeListData } from '../../../types';
-/**
- * Преобразует древовидную структуру в плоский список для виртуализации
- */
-export declare const flattenTree: <TData extends InfiniteTreeListData<TData>>(items: TData[], expandedIds: Set<string>, parentPath?: string[], level?: number, parentId?: string) => FlattenTree<TData>[];

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

@@ -1,10 +0,0 @@
-import type { FlattenTree, InfiniteTreeListData } from '../../../types';
-/**
- * Собирает всех потомков узла по его id из плоского списка.
- *
- * @typeParam T - тип данных элемента дерева
- * @param flatList - плоский список элементов дерева (`FlattenTree<T>[]`)
- * @param parentId - идентификатор родительского узла
- * @returns Массив потомков в формате `FlattenTree<T>`
- */
-export declare const getDescendants: <TData extends InfiniteTreeListData<TData>>(flatList: FlattenTree<TData>[], parentId: string) => FlattenTree<TData>[];

package/components/InfiniteTreeList/useLogic/utils/getDescendants/getDescendants.js

@@ -1,22 +0,0 @@
-/**
- * Собирает всех потомков узла по его id из плоского списка.
- *
- * @typeParam T - тип данных элемента дерева
- * @param flatList - плоский список элементов дерева (`FlattenTree<T>[]`)
- * @param parentId - идентификатор родительского узла
- * @returns Массив потомков в формате `FlattenTree<T>`
- */
-export const getDescendants = (flatList, parentId) => {
-    const result = [];
-    const collectChildren = (id) => {
-        const children = flatList.filter((item) => item.meta.parentId === id);
-        children.forEach((child) => {
-            result.push(child);
-            if (child.meta.isExpanded) {
-                collectChildren(child.id);
-            }
-        });
-    };
-    collectChildren(parentId);
-    return result;
-};

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

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

package/components/InfiniteTreeList/useLogic/utils/getDescendants/index.js

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

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

@@ -1,4 +0,0 @@
-export * from './flattenTree';
-export * from './getInitialExpandedIds';
-export * from './getDescendants';
-export * from './sortCollapsed';

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

@@ -1,4 +0,0 @@
-export * from './flattenTree';
-export * from './getInitialExpandedIds';
-export * from './getDescendants';
-export * from './sortCollapsed';

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

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

package/node/components/InfiniteTreeList/useLogic/utils/flattenTree/flattenTree.d.ts

@@ -1,5 +0,0 @@
-import type { FlattenTree, InfiniteTreeListData } from '../../../types';
-/**
- * Преобразует древовидную структуру в плоский список для виртуализации
- */
-export declare const flattenTree: <TData extends InfiniteTreeListData<TData>>(items: TData[], expandedIds: Set<string>, parentPath?: string[], level?: number, parentId?: string) => FlattenTree<TData>[];

package/node/components/InfiniteTreeList/useLogic/utils/getDescendants/getDescendants.d.ts

@@ -1,10 +0,0 @@
-import type { FlattenTree, InfiniteTreeListData } from '../../../types';
-/**
- * Собирает всех потомков узла по его id из плоского списка.
- *
- * @typeParam T - тип данных элемента дерева
- * @param flatList - плоский список элементов дерева (`FlattenTree<T>[]`)
- * @param parentId - идентификатор родительского узла
- * @returns Массив потомков в формате `FlattenTree<T>`
- */
-export declare const getDescendants: <TData extends InfiniteTreeListData<TData>>(flatList: FlattenTree<TData>[], parentId: string) => FlattenTree<TData>[];

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

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDescendants = void 0;
-/**
- * Собирает всех потомков узла по его id из плоского списка.
- *
- * @typeParam T - тип данных элемента дерева
- * @param flatList - плоский список элементов дерева (`FlattenTree<T>[]`)
- * @param parentId - идентификатор родительского узла
- * @returns Массив потомков в формате `FlattenTree<T>`
- */
-const getDescendants = (flatList, parentId) => {
-    const result = [];
-    const collectChildren = (id) => {
-        const children = flatList.filter((item) => item.meta.parentId === id);
-        children.forEach((child) => {
-            result.push(child);
-            if (child.meta.isExpanded) {
-                collectChildren(child.id);
-            }
-        });
-    };
-    collectChildren(parentId);
-    return result;
-};
-exports.getDescendants = getDescendants;

package/node/components/InfiniteTreeList/useLogic/utils/getDescendants/index.d.ts

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

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

@@ -1,4 +0,0 @@
-export * from './flattenTree';
-export * from './getInitialExpandedIds';
-export * from './getDescendants';
-export * from './sortCollapsed';

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

@@ -1,20 +0,0 @@
-"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("./flattenTree"), exports);
-__exportStar(require("./getInitialExpandedIds"), exports);
-__exportStar(require("./getDescendants"), exports);
-__exportStar(require("./sortCollapsed"), exports);

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

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