@splicetree/plugin-lazy-load 0.0.1 → 0.2.0

package/CHANGELOG.md

@@ -1,25 +1,17 @@
 # @splicetree/plugin-lazy-load
 
+## 0.2.0
+
+## 0.1.1
+
+### Patch Changes
+
+- fix: republish plugin-lazy-load after partial release failure
+
+## 0.1.0
+
 ## 0.0.1
 
 ### Patch Changes
 
 - chore: 搭建 SpliceTree 框架基础架构与工程体系
-
-  框架架构：
-  - 建立无头树（Headless Tree）核心模型与数据结构
-  - 定义节点操作 API、事件系统和状态管理机制
-  - 设计并实现插件体系（生命周期、注册机制、能力扩展）
-  - 引入模块化架构，明确 core / plugins / adapters 的边界
-  - 预留扩展点与内部协议，构建可插拔式架构基础
-
-  适配层与生态：
-  - 添加 Vue 3 适配层（渲染无关、纯接口绑定）
-  - 设计独立的 UI 层解耦策略，确保跨框架可迁移
-  - 预留未来 React/Svelte/WebComponents 的适配接口
-
-  工程化与工具链：
-  - 初始化 monorepo 工程结构（packages + docs）
-  - 配置构建工具链 tsdown（多包构建、类型输出）
-  - 构建文档系统（VitePress）与基础导航结构
-  - 设置开发环境、代码规范（ESLint）、格式化流程

package/README.md

@@ -1,13 +1,13 @@
 # @splicetree/plugin-lazy-load
 
+提供懒加载子节点能力，在首次展开时动态加载并追加到树。
+
 [![version](https://img.shields.io/npm/v/@splicetree/plugin-lazy-load.svg?label=version)](https://www.npmjs.com/package/@splicetree/plugin-lazy-load)
 [![downloads](https://img.shields.io/npm/dm/@splicetree/plugin-lazy-load.svg)](https://npmcharts.com/compare/%40splicetree%2Fplugin-lazy-load?minimal=true)
 [![license](https://img.shields.io/npm/l/@splicetree/plugin-lazy-load.svg)](https://www.npmjs.com/package/@splicetree/plugin-lazy-load)
 [![Website](https://img.shields.io/static/v1?label=Website&message=splicetree.dev&color=blue)](https://www.splicetree.dev)
 [![GitHub](https://img.shields.io/static/v1?label=GitHub&message=splicetree%2Fsplicetree&logo=github)](https://github.com/michaelcocova/splicetree)
 
-提供懒加载子节点能力，在首次展开时动态加载并追加到树。
-
 ## 安装
 
 `pnpm add @splicetree/plugin-lazy-load`

package/dist/index.d.ts

@@ -2,17 +2,10 @@ import { SpliceTreePlugin } from "@splicetree/core";
 
 //#region src/index.d.ts
 declare module '@splicetree/core' {
-  /**
-   * 选项扩展（Lazy-Load）
-   * - loadChildren：按需加载指定节点的子节点
-   */
-  interface UseSpliceTreeOptions {
-    /**
-     * 加载指定节点的子节点
-     * 返回子节点数据数组，加载完成后将自动追加到树中
-     * @param node 要加载子节点的目标节点
-     */
-    loadChildren?: (node: SpliceTreeNode<any>) => Promise<any[]>;
+  interface SpliceTreeConfiguration {
+    lazyLoad?: {
+      loadChildren?: (node: SpliceTreeNode<any>) => Promise<any[]>;
+    };
   }
   /**
    * 事件扩展（Lazy-Load）

package/dist/index.js

@@ -2,7 +2,7 @@
 const lazyLoad = {
 	name: "lazy-load",
 	setup(ctx) {
-		const { loadChildren } = ctx.options;
+		const { loadChildren } = ctx.options?.configuration?.lazyLoad ?? {};
 		const loadedKeys = /* @__PURE__ */ new Set();
 		const isLoaded = (id) => loadedKeys.has(id);
 		/**
@@ -33,7 +33,7 @@ const lazyLoad = {
 			if (children?.length) {
 				ctx.tree.appendChildren(id, children);
 				for (const c of children) {
-					const childId = String(Reflect.get(c, ctx.tree.options?.keyField ?? "id"));
+					const childId = String(Reflect.get(c, ctx.tree.options?.configuration?.keyField ?? ctx.tree.options?.keyField ?? "id"));
 					const childNode = ctx.tree.getNode(childId);
 					if (childNode) applyLazyOverrides(childNode);
 				}

package/package.json

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

package/src/index.ts

@@ -1,18 +1,11 @@
-import type { SpliceTreePlugin, SpliceTreePluginContext } from '@splicetree/core'
+import type { SpliceTreeNode, SpliceTreePlugin, SpliceTreePluginContext } from '@splicetree/core'
 import '@splicetree/core'
 
 declare module '@splicetree/core' {
-  /**
-   * 选项扩展（Lazy-Load）
-   * - loadChildren：按需加载指定节点的子节点
-   */
-  interface UseSpliceTreeOptions {
-    /**
-     * 加载指定节点的子节点
-     * 返回子节点数据数组，加载完成后将自动追加到树中
-     * @param node 要加载子节点的目标节点
-     */
-    loadChildren?: (node: SpliceTreeNode<any>) => Promise<any[]>
+  export interface SpliceTreeConfiguration {
+    lazyLoad?: {
+      loadChildren?: (node: SpliceTreeNode<any>) => Promise<any[]>
+    }
   }
 
   /**
@@ -63,7 +56,10 @@ export const lazyLoad: SpliceTreePlugin = {
    * - 通过 loadedKeys 标记已加载节点
    */
   setup(ctx: SpliceTreePluginContext) {
-    const { loadChildren } = ctx.options
+    const cfg = (ctx.options?.configuration?.lazyLoad ?? {}) as {
+      loadChildren?: (node: SpliceTreeNode<any>) => Promise<any[]>
+    }
+    const { loadChildren } = cfg
     const loadedKeys = new Set<string>()
     const isLoaded = (id: string) => loadedKeys.has(id)
 
@@ -105,7 +101,7 @@ export const lazyLoad: SpliceTreePlugin = {
       if (children?.length) {
         ctx.tree.appendChildren(id, children)
         for (const c of children) {
-          const childId = String(Reflect.get(c as any, ctx.tree.options?.keyField ?? 'id'))
+          const childId = String(Reflect.get(c, ctx.tree.options?.configuration?.keyField ?? 'id'))
           const childNode = ctx.tree.getNode(childId)
           if (childNode) {
             applyLazyOverrides(childNode)
@@ -113,7 +109,7 @@ export const lazyLoad: SpliceTreePlugin = {
         }
       }
       loadedKeys.add(id)
-      ctx.events.emit({ name: 'lazyload', keys: Array.from(loadedKeys) } as any)
+      ctx.events.emit({ name: 'lazyload', keys: Array.from(loadedKeys) })
     }
 
     const origExpand = ctx.tree.expand.bind(ctx.tree)
@@ -127,11 +123,12 @@ export const lazyLoad: SpliceTreePlugin = {
       const list = Array.isArray(ids) ? ids : [ids]
       if (loadChildren) {
         for (const id of list) {
-          if (!isLoaded(id))
+          if (!isLoaded(id)) {
             await load(id)
+          }
         }
       }
-      origExpand(ids as any)
+      origExpand(ids)
     }
     /**
      * 覆盖 toggleExpand：在切换前确保子节点已加载
@@ -141,20 +138,20 @@ export const lazyLoad: SpliceTreePlugin = {
       const list = Array.isArray(ids) ? ids : [ids]
       if (loadChildren) {
         for (const id of list) {
-          if (!isLoaded(id))
+          if (!isLoaded(id)) {
             await load(id)
+          }
         }
       }
-      origToggle(ids as any)
+      origToggle(ids)
     }
 
     return {
       loadedKeys,
       isLoaded,
       load,
-      // 覆盖核心方法以接入懒加载
-      expand: expand as any,
-      toggleExpand: toggleExpand as any,
+      expand,
+      toggleExpand,
     }
   },
   /**
@@ -163,7 +160,7 @@ export const lazyLoad: SpliceTreePlugin = {
    * - hasChildren：未加载时返回 true，已加载后按实际子节点判断
    */
   extendNode(node, ctx) {
-    ;(node as any).isLoaded = () => ctx.tree.isLoaded?.(node.id)
+    node.isLoaded = () => ctx.tree.isLoaded?.(node.id)
     node.hasChildren = () => {
       const loaded = ctx.tree.isLoaded?.(node.id)
       if (!loaded) {