@splicetree/plugin-lazy-load 3.0.2 → 3.1.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @splicetree/plugin-lazy-load
 
+## 3.1.1
+
+### Patch Changes
+
+- Core/Adapter/Lazy-Load/DnD：稳定性修复与小幅改进
+  - DnD：为 `draggable/sortable/nestable` 增加函数/异步判定；在悬停与释放阶段严格校验并在不允许时隐藏 ghost；增加去抖与离开清理以消除偶发 ghost 闪烁
+  - Adapter-Vue：抽取数据同步工具；字段变更走 `updateOriginal` 合并，结构变更再 `syncData`
+  - Core：节点扩展应用于追加节点；补充若干示例与文档更新
+  - Lazy-Load：覆盖 `syncData`，在重建后恢复已加载子树与覆盖
+
+## 3.1.0
+
+### Minor Changes
+
+- Lazy-Load 插件：
+  - 覆盖 `syncData`，在重建后恢复此前已懒加载的子树并重新应用覆盖方法与事件派发（`lazyload`）
+  - 追加子节点后，新节点的覆盖方法与实例能力保持一致（与核心的 `extendNode` 自动应用配合）
+
 ## 3.0.2
 
 ## 3.0.1

package/dist/index.js

@@ -5,6 +5,7 @@ const lazyLoad = {
 		const { loadChildren } = ctx.options?.configuration?.lazyLoad ?? {};
 		const loadedKeys = /* @__PURE__ */ new Set();
 		const loadingKeys = /* @__PURE__ */ new Set();
+		const loadedChildrenData = /* @__PURE__ */ new Map();
 		const isLoaded = (id) => loadedKeys.has(id);
 		const isLoading = (id) => loadingKeys.has(id);
 		/**
@@ -41,6 +42,7 @@ const lazyLoad = {
 			const children = await loadChildren(node);
 			if (children?.length) {
 				ctx.tree.appendChildren(id, children);
+				loadedChildrenData.set(id, children);
 				for (const c of children) {
 					const childId = String(Reflect.get(c, ctx.tree.options?.configuration?.keyField ?? "id"));
 					const childNode = ctx.tree.getNode(childId);
@@ -60,6 +62,7 @@ const lazyLoad = {
 		};
 		const origExpand = ctx.tree.expand.bind(ctx.tree);
 		const origToggle = ctx.tree.toggleExpand.bind(ctx.tree);
+		const origSync = ctx.tree.syncData.bind(ctx.tree);
 		/**
 		* 覆盖 expand：在展开前确保子节点已加载
 		* @param ids 要展开的节点 id 或 id 数组
@@ -82,6 +85,31 @@ const lazyLoad = {
 			}
 			origToggle(ids);
 		};
+		/**
+		* 覆盖 syncData：在重建后重新附加已加载的子节点数据并恢复覆盖
+		*/
+		const syncData = (next) => {
+			origSync(next);
+			if (loadedChildrenData.size) {
+				for (const [parentId, children] of loadedChildrenData.entries()) {
+					if (!ctx.tree.getNode(parentId)) continue;
+					ctx.tree.appendChildren(parentId, children);
+					for (const c of children) {
+						const childId = String(Reflect.get(c, ctx.tree.options?.configuration?.keyField ?? "id"));
+						const childNode = ctx.tree.getNode(childId);
+						if (childNode) applyLazyOverrides(childNode);
+					}
+				}
+				ctx.events.emit({
+					name: "visibility",
+					keys: ctx.tree.expandedKeys()
+				});
+				ctx.events.emit({
+					name: "lazyload",
+					keys: Array.from(loadedKeys)
+				});
+			}
+		};
 		return {
 			loadedKeys,
 			loadingKeys,
@@ -89,7 +117,8 @@ const lazyLoad = {
 			isLoading,
 			load,
 			expand,
-			toggleExpand
+			toggleExpand,
+			syncData
 		};
 	},
 	extendNode(node, ctx) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@splicetree/plugin-lazy-load",
   "type": "module",
-  "version": "3.0.2",
+  "version": "3.1.1",
   "author": {
     "email": "michael.cocova@gmail.com",
     "name": "Michael Cocova"
@@ -23,7 +23,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "@splicetree/core": "3.0.2"
+    "@splicetree/core": "3.1.1"
   },
   "scripts": {
     "dev": "tsdown --watch",

package/src/index.ts

@@ -73,6 +73,7 @@ export const lazyLoad: SpliceTreePlugin = {
     const { loadChildren } = cfg
     const loadedKeys = new Set<string>()
     const loadingKeys = new Set<string>()
+    const loadedChildrenData = new Map<string, any[]>()
     const isLoaded = (id: string) => loadedKeys.has(id)
     const isLoading = (id: string) => loadingKeys.has(id)
 
@@ -119,6 +120,7 @@ export const lazyLoad: SpliceTreePlugin = {
       const children = await loadChildren(node)
       if (children?.length) {
         ctx.tree.appendChildren(id, children)
+        loadedChildrenData.set(id, children)
         for (const c of children) {
           const childId = String(Reflect.get(c, ctx.tree.options?.configuration?.keyField ?? 'id'))
           const childNode = ctx.tree.getNode(childId)
@@ -135,6 +137,7 @@ export const lazyLoad: SpliceTreePlugin = {
 
     const origExpand = ctx.tree.expand.bind(ctx.tree)
     const origToggle = ctx.tree.toggleExpand.bind(ctx.tree)
+    const origSync = ctx.tree.syncData.bind(ctx.tree)
 
     /**
      * 覆盖 expand：在展开前确保子节点已加载
@@ -166,6 +169,29 @@ export const lazyLoad: SpliceTreePlugin = {
       }
       origToggle(ids)
     }
+    /**
+     * 覆盖 syncData：在重建后重新附加已加载的子节点数据并恢复覆盖
+     */
+    const syncData = (next: any[]) => {
+      origSync(next)
+      if (loadedChildrenData.size) {
+        for (const [parentId, children] of loadedChildrenData.entries()) {
+          if (!ctx.tree.getNode(parentId)) {
+            continue
+          }
+          ctx.tree.appendChildren(parentId, children)
+          for (const c of children) {
+            const childId = String(Reflect.get(c, ctx.tree.options?.configuration?.keyField ?? 'id'))
+            const childNode = ctx.tree.getNode(childId)
+            if (childNode) {
+              applyLazyOverrides(childNode)
+            }
+          }
+        }
+        ctx.events.emit({ name: 'visibility', keys: ctx.tree.expandedKeys() })
+        ctx.events.emit({ name: 'lazyload', keys: Array.from(loadedKeys) })
+      }
+    }
 
     return {
       loadedKeys,
@@ -175,6 +201,7 @@ export const lazyLoad: SpliceTreePlugin = {
       load,
       expand,
       toggleExpand,
+      syncData,
     }
   },
   /**