earthsdk3 3.0.6 → 3.0.7-beta.10

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/types/utils/PropTrees/PropTree.d.ts

@@ -1,6 +1,21 @@
-import { Tree, UiTree } from "xbsj-base";
-import { GroupPropTreeItem, LeafPropTreeItem } from "./PropTreeItem";
-export declare class PropTree extends Tree<LeafPropTreeItem | GroupPropTreeItem> {
-    constructor(itemDivHeight: number);
-    get propUiTree(): UiTree<GroupPropTreeItem | LeafPropTreeItem, PropTree>;
-}
+import { Tree, UiTree } from "xbsj-base";
+import { GroupPropTreeItem, LeafPropTreeItem } from "./PropTreeItem";
+/**
+ * 表示属性树的类，继承自 `Tree` 类。
+ * 属性树用于管理 `LeafPropTreeItem` 或 `GroupPropTreeItem` 类型的树节点。
+ */
+export declare class PropTree extends Tree<LeafPropTreeItem | GroupPropTreeItem> {
+    /**
+     * 构造函数，创建一个新的 `PropTree` 实例。
+     *
+     * @param itemDivHeight - 树中每个节点的高度。
+     */
+    constructor(itemDivHeight: number);
+    /**
+     * 获取属性树对应的 UI 树。
+     *
+     * @returns 返回一个 `UiTree` 实例，其节点类型为 `LeafPropTreeItem` 或 `GroupPropTreeItem`，树类型为 `PropTree`。
+     */
+    get propUiTree(): UiTree<LeafPropTreeItem | GroupPropTreeItem, PropTree>;
+}
+//# sourceMappingURL=PropTree.d.ts.map

package/dist/types/utils/PropTrees/PropTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropTree.d.ts","sourceRoot":"","sources":["../../../../src/utils/PropTrees/PropTree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAErE;;;GAGG;AACH,qBAAa,QAAS,SAAQ,IAAI,CAAC,gBAAgB,GAAG,iBAAiB,CAAC;IACpE;;;;OAIG;gBACS,aAAa,EAAE,MAAM;IAIjC;;;;OAIG;IACH,IAAI,UAAU,IACuB,MAAM,CAAC,gBAAgB,GAAG,iBAAiB,EAAE,QAAQ,CAAC,CAC1F;CACJ"}

package/dist/types/utils/PropTrees/PropTreeItem.d.ts

@@ -1,15 +1,49 @@
-import { GroupProperty, Property } from "../../ESJTypes";
-import { ObservableArray, TreeItem } from "xbsj-base";
-import { PropTree } from "./PropTree";
-export declare class BasePropTreeItem extends TreeItem {
-    private _property;
-    constructor(tree: PropTree, hasChildren: boolean, _property: Property);
-    get property(): Property;
-}
-export declare class LeafPropTreeItem extends BasePropTreeItem {
-    constructor(tree: PropTree, property: Property);
-}
-export declare class GroupPropTreeItem extends BasePropTreeItem {
-    constructor(tree: PropTree, groupProperty: GroupProperty);
-    get groupChildren(): ObservableArray<TreeItem>;
-}
+import { ObservableArray, TreeItem } from "xbsj-base";
+import { GroupProperty, Property } from "../../ESJTypes";
+import { PropTree } from "./PropTree";
+/**
+ * 表示属性树项的基类，继承自 TreeItem。
+ */
+export declare class BasePropTreeItem extends TreeItem {
+    private _property;
+    /**
+     * 构造函数，创建 BasePropTreeItem 的实例。
+     * @param tree - 所属的属性树实例。
+     * @param hasChildren - 指示该树项是否有子项。
+     * @param _property - 关联的属性对象。
+     */
+    constructor(tree: PropTree, hasChildren: boolean, _property: Property);
+    /**
+     * 获取关联的属性对象。
+     * @returns 关联的属性对象。
+     */
+    get property(): Property;
+}
+/**
+ * 表示属性树中的叶子节点，继承自 BasePropTreeItem。
+ */
+export declare class LeafPropTreeItem extends BasePropTreeItem {
+    /**
+     * 构造函数，创建 LeafPropTreeItem 的实例。
+     * @param tree - 所属的属性树实例。
+     * @param property - 关联的属性对象。
+     */
+    constructor(tree: PropTree, property: Property);
+}
+/**
+ * 表示属性树中的组节点，继承自 BasePropTreeItem。
+ */
+export declare class GroupPropTreeItem extends BasePropTreeItem {
+    /**
+     * 构造函数，创建 GroupPropTreeItem 的实例。
+     * @param tree - 所属的属性树实例。
+     * @param groupProperty - 关联的组属性对象。
+     */
+    constructor(tree: PropTree, groupProperty: GroupProperty);
+    /**
+     * 获取组节点的子项，作为可观察数组。
+     * @returns 组节点的子项的可观察数组。
+     */
+    get groupChildren(): ObservableArray<TreeItem>;
+}
+//# sourceMappingURL=PropTreeItem.d.ts.map

package/dist/types/utils/PropTrees/PropTreeItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropTreeItem.d.ts","sourceRoot":"","sources":["../../../../src/utils/PropTrees/PropTreeItem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAQ,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAOQ,OAAO,CAAC,SAAS;IANnE;;;;;OAKG;gBACS,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAU,SAAS,EAAE,QAAQ;IAI7E;;;OAGG;IACH,IAAI,QAAQ,aAA6B;CAC5C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IAClD;;;;OAIG;gBACS,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ;CAGjD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;IACnD;;;;OAIG;gBACS,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa;IAIxD;;;OAGG;IACH,IAAI,aAAa,IACW,eAAe,CAAC,QAAQ,CAAC,CACpD;CACJ"}

package/dist/types/utils/PropTrees/PropUiTreeManager.d.ts

@@ -1,17 +1,54 @@
-import { ESSceneObject } from "../../ESObjects";
-import { Destroyable, UniteChanged } from "xbsj-base";
-import { PropTree } from "./PropTree";
-export declare function createPropTreeFromSceneObject(sceneObject: ESSceneObject, itemDivHeight: number): PropTree;
-export declare class PropUiTreeManager extends Destroyable {
-    private _propTreeReact;
-    get propTree(): PropTree | undefined;
-    get propTreeChanged(): import("xbsj-base").Listener<[PropTree | undefined, PropTree | undefined]>;
-    constructor(itemDivHeight: number);
-}
-export declare namespace PropUiTreeManager {
-    const createDefaultProps: () => {
-        sceneObject: ESSceneObject | undefined;
-    };
-}
-export interface PropUiTreeManager extends UniteChanged<ReturnType<typeof PropUiTreeManager.createDefaultProps>> {
-}
+import { Destroyable, UniteChanged } from "xbsj-base";
+import { ESSceneObject } from "../../ESObjects";
+import { PropTree } from "./PropTree";
+/**
+ * 从场景对象创建属性树。
+ *
+ * @param sceneObject - 要从中创建属性树的场景对象。
+ * @param itemDivHeight - 属性项的高度。
+ * @returns 新创建的属性树。
+ */
+export declare function createPropTreeFromSceneObject(sceneObject: ESSceneObject, itemDivHeight: number): PropTree;
+/**
+ * 管理属性 UI 树的类。
+ * 该类负责根据场景对象创建和更新属性树。
+ */
+export declare class PropUiTreeManager extends Destroyable {
+    /**
+     * 用于跟踪属性树的响应式变量。
+     */
+    private _propTreeReact;
+    /**
+     * 获取当前的属性树。
+     */
+    get propTree(): PropTree | undefined;
+    /**
+     * 获取属性树更改的事件。
+     */
+    get propTreeChanged(): import("xbsj-base").Listener<[PropTree | undefined, PropTree | undefined]>;
+    /**
+     * 构造函数。
+     *
+     * @param itemDivHeight - 属性项的高度。
+     */
+    constructor(itemDivHeight: number);
+}
+/**
+ * PropUiTreeManager 的命名空间，包含创建默认属性的方法。
+ */
+export declare namespace PropUiTreeManager {
+    /**
+     * 创建 PropUiTreeManager 的默认属性。
+     *
+     * @returns 包含默认属性的对象。
+     */
+    const createDefaultProps: () => {
+        sceneObject: ESSceneObject | undefined;
+    };
+}
+/**
+ * 扩展 PropUiTreeManager 接口，使其包含 UniteChanged 类型的属性。
+ */
+export interface PropUiTreeManager extends UniteChanged<ReturnType<typeof PropUiTreeManager.createDefaultProps>> {
+}
+//# sourceMappingURL=PropUiTreeManager.d.ts.map

package/dist/types/utils/PropTrees/PropUiTreeManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropUiTreeManager.d.ts","sourceRoot":"","sources":["../../../../src/utils/PropTrees/PropUiTreeManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkD,YAAY,EAAE,MAAM,WAAW,CAAC;AAEtG,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YA2D9F;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAC9C;;OAEG;IACH,OAAO,CAAC,cAAc,CAAmD;IAEzE;;OAEG;IACH,IAAI,QAAQ,yBAAwC;IAEpD;;OAEG;IACH,IAAI,eAAe,+EAA0C;IAE7D;;;;OAIG;gBACS,aAAa,EAAE,MAAM;CAoBpC;AAED;;GAEG;AACH,yBAAiB,iBAAiB,CAAC;IAC/B;;;;OAIG;IACI,MAAM,kBAAkB;qBACD,aAAa,GAAG,SAAS;KACrD,CAAC;CACN;AAGD;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;CAAI"}

package/dist/types/utils/PropTrees/index.d.ts

@@ -1,3 +1,4 @@
-export * from './PropTree';
-export * from './PropTreeItem';
-export * from './PropUiTreeManager';
+export * from './PropTree';
+export * from './PropTreeItem';
+export * from './PropUiTreeManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/PropTrees/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/PropTrees/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC"}

package/dist/types/utils/SceneTrees/SceneTree.d.ts

@@ -1,107 +1,252 @@
-import { JsonValue, Tree, UiTree } from "xbsj-base";
-import { SceneTreeItem, SceneTreeItemInsertFlag, SceneTreeItemJsonValue } from "./SceneTreeItem";
-import { defaultCreateSceneObject } from "./defaultCreateSceneObject";
-import { getSceneObjectShow as defaultGetSceneObjectShow, setSceneObjectShow as defaultSetSceneObjectShow } from "./defaultShowSceneObject";
-import { defaultCreateTreeItemDragDrop } from "./defaultCreateTreeItemDragDrop";
-import { preload } from "./preload";
-import { SceneTreeContextMenu } from "./SceneTreeContextMenu";
-import { ESObjectsManager } from "../../ESObjectManager";
-import { DragStartDataManager } from "../base";
-import { ESSceneObject } from "../../ESObjects";
-export type SceneTreeJsonValue = {
-    root: SceneTreeItemJsonValue;
-};
-declare function defaultGetSceneTreeItemCloneName(originSceneTreeItem: SceneTreeItem): string;
-export declare class SceneTree extends Tree<SceneTreeItem> {
-    private _name;
-    private _dragStartDataManager;
-    private _projectManager;
-    private _jsonLoading;
-    get json(): SceneTreeJsonValue;
-    set json(value: SceneTreeJsonValue);
-    get jsonStr(): string;
-    set jsonStr(value: string);
-    get jsonLoadingEvent(): import("xbsj-base").Event<[{
-        type: "init" | "loading" | "loaded";
-    } | {
-        type: "error";
-        error?: string | undefined;
-    }]>;
-    get name(): string;
-    static defaultCreateSceneObjectFunc: typeof defaultCreateSceneObject;
-    createSceneObjectFunc: typeof defaultCreateSceneObject;
-    static defaultCreateTreeItemDragDropFunc: typeof defaultCreateTreeItemDragDrop;
-    createTreeItemDragDropFunc: typeof defaultCreateTreeItemDragDrop;
-    static defaultPreload: typeof preload;
-    preloadFunc: typeof preload;
-    static defaultGetSceneObjectShow: typeof defaultGetSceneObjectShow;
-    getSceneObjectShowFunc: typeof defaultGetSceneObjectShow;
-    static defaultSetSceneObjectShow: typeof defaultSetSceneObjectShow;
-    setSceneObjectShowFunc: typeof defaultSetSceneObjectShow;
-    static defaultGetSceneTreeItemCloneNameFunc: typeof defaultGetSceneTreeItemCloneName;
-    getSceneTreeItemCloneNameFunc: typeof defaultGetSceneTreeItemCloneName;
-    debug: boolean;
-    get projectManager(): ESObjectsManager;
-    private _contextMenu;
-    get contextMenu(): SceneTreeContextMenu;
-    private _showPropUiOnSelecting;
-    get showPropUiOnSelecting(): boolean;
-    set showPropUiOnSelecting(value: boolean);
-    get showPropUiOnSelectingChanged(): import("xbsj-base").Listener<[boolean, boolean]>;
-    constructor(_name: string, _dragStartDataManager: DragStartDataManager, itemDivHeight: number, _projectManager: ESObjectsManager);
-    get sceneUiTree(): UiTree<SceneTreeItem, SceneTree>;
-    getTreeItemFromSceneObjId(id: string): SceneTreeItem | undefined;
-    get dragStartDataManager(): DragStartDataManager;
-    /**
-     * 获取当前树结构的Json数据
-     * @returns SceneTreeItem的isExport为true的Json数据
-     */
-    getJson(): {
-        root: {
-            children: SceneTreeItemJsonValue[];
-        };
-    };
-    setJson(value: SceneTreeJsonValue): void;
-    /**
-     * 监测addNewTreeItem是否可以添加项
-     * @deprecated 请勿使用，未来将废弃！
-     * @param currentTreeItem
-     * @param flag
-     * @returns
-     */
-    testAddNewTreeItem(currentTreeItem: SceneTreeItem | undefined, flag: SceneTreeItemInsertFlag): boolean;
-    /**
-     * @deprecated 请勿使用，未来将废弃！
-     * @param currentTreeItem
-     * @param flag
-     * @param isGroup
-     * @param sceneObject
-     * @returns
-     */
-    addNewTreeItem(currentTreeItem: SceneTreeItem | undefined, flag: SceneTreeItemInsertFlag, isGroup: boolean, sceneObject?: ESSceneObject): SceneTreeItem | undefined;
-    createSceneObjectTreeItem<T extends ESSceneObject>(sceneObjectType: string | (new (id?: string | undefined) => T), id?: string, currentTreeItem?: SceneTreeItem, flag?: SceneTreeItemInsertFlag): SceneTreeItem | undefined;
-    /**
-     * 创建一个组节点
-     * @param id
-     * @param currentTreeItem
-     * @param flag
-     * @returns
-     */
-    createGroupTreeItem(name?: string, id?: string, currentTreeItem?: SceneTreeItem, flag?: SceneTreeItemInsertFlag): SceneTreeItem | undefined;
-    createSceneObjectTreeItemFromClass<T extends ESSceneObject>(sceneObjConstructor: new (id?: string | undefined) => T, id?: string, currentTreeItem?: SceneTreeItem, flag?: SceneTreeItemInsertFlag): SceneTreeItem | undefined;
-    createSceneObjectTreeItemFromJson<T extends ESSceneObject>(sceneObjectJson: JsonValue & {
-        [k: string]: any;
-        type: string;
-    }, currentTreeItem?: SceneTreeItem, flag?: SceneTreeItemInsertFlag): SceneTreeItem | undefined;
-    /**
-     * 销毁一个场景对象节点
-     * @param sceneTreeItem
-     */
-    destroySceneObjectTreeItem(sceneTreeItem: SceneTreeItem): void;
-    /**
-     * 销毁用户添加的所有场景节点
-     * @returns
-     */
-    destroyAllSceneObjectTreeItems(): void;
-}
-export {};
+import { JsonValue, Tree, UiTree } from "xbsj-base";
+import { ESObjectsManager } from "../../ESObjectManager";
+import { ESSceneObject } from "../../ESObjects";
+import { DragStartDataManager } from "../base";
+import { defaultCreateSceneObject } from "./defaultCreateSceneObject";
+import { defaultCreateTreeItemDragDrop } from "./defaultCreateTreeItemDragDrop";
+import { getSceneObjectShow as defaultGetSceneObjectShow, setSceneObjectShow as defaultSetSceneObjectShow } from "./defaultShowSceneObject";
+import { preload } from "./preload";
+import { SceneTreeContextMenu } from "./SceneTreeContextMenu";
+import { SceneTreeItem, SceneTreeItemInsertFlag, SceneTreeItemJsonValue } from "./SceneTreeItem";
+/**
+ * 场景树的 JSON 数据类型定义
+ */
+export type SceneTreeJsonValue = {
+    /**
+     * 根节点的 JSON 数据
+     */
+    root: SceneTreeItemJsonValue;
+};
+/**
+ * 获取场景树项克隆后的默认名称
+ * @param originSceneTreeItem - 原始的场景树项
+ * @returns 克隆后的场景树项名称
+ */
+declare function defaultGetSceneTreeItemCloneName(originSceneTreeItem: SceneTreeItem): string;
+/**
+ * 场景树类，继承自 Tree<SceneTreeItem>
+ */
+export declare class SceneTree extends Tree<SceneTreeItem> {
+    private _name;
+    private _dragStartDataManager;
+    private _projectManager;
+    /**
+     * JSON 加载器实例
+     */
+    private _jsonLoading;
+    /**
+     * 获取场景树的 JSON 数据
+     */
+    get json(): SceneTreeJsonValue;
+    /**
+     * 设置场景树的 JSON 数据
+     * @param value - 要设置的 JSON 数据
+     */
+    set json(value: SceneTreeJsonValue);
+    /**
+     * 获取场景树的 JSON 字符串
+     */
+    get jsonStr(): string;
+    /**
+     * 设置场景树的 JSON 字符串
+     * @param value - 要设置的 JSON 字符串
+     */
+    set jsonStr(value: string);
+    /**
+     * 获取 JSON 加载事件
+     */
+    get jsonLoadingEvent(): import("xbsj-base").Event<[{
+        type: "init" | "loading" | "loaded";
+    } | {
+        type: "error";
+        error?: string;
+    }]>;
+    /**
+     * 获取场景树的名称
+     */
+    get name(): string;
+    /**
+     * 默认的创建场景对象的函数
+     */
+    static defaultCreateSceneObjectFunc: typeof defaultCreateSceneObject;
+    /**
+     * 创建场景对象的函数
+     */
+    createSceneObjectFunc: typeof defaultCreateSceneObject;
+    /**
+     * 默认的创建树项拖放的函数
+     */
+    static defaultCreateTreeItemDragDropFunc: typeof defaultCreateTreeItemDragDrop;
+    /**
+     * 创建树项拖放的函数
+     */
+    createTreeItemDragDropFunc: typeof defaultCreateTreeItemDragDrop;
+    /**
+     * 默认的预加载函数
+     */
+    static defaultPreload: typeof preload;
+    /**
+     * 预加载函数
+     */
+    preloadFunc: typeof preload;
+    /**
+     * 默认的获取场景对象显示状态的函数
+     */
+    static defaultGetSceneObjectShow: typeof defaultGetSceneObjectShow;
+    /**
+     * 获取场景对象显示状态的函数
+     */
+    getSceneObjectShowFunc: typeof defaultGetSceneObjectShow;
+    /**
+     * 默认的设置场景对象显示状态的函数
+     */
+    static defaultSetSceneObjectShow: typeof defaultSetSceneObjectShow;
+    /**
+     * 设置场景对象显示状态的函数
+     */
+    setSceneObjectShowFunc: typeof defaultSetSceneObjectShow;
+    /**
+     * 默认的获取场景树项克隆名称的函数
+     */
+    static defaultGetSceneTreeItemCloneNameFunc: typeof defaultGetSceneTreeItemCloneName;
+    /**
+     * 获取场景树项克隆名称的函数
+     */
+    getSceneTreeItemCloneNameFunc: typeof defaultGetSceneTreeItemCloneName;
+    /**
+     * 调试模式标志
+     */
+    debug: boolean;
+    /**
+     * 获取项目管理器
+     */
+    get projectManager(): ESObjectsManager;
+    /**
+     * 上下文菜单实例
+     */
+    private _contextMenu;
+    /**
+     * 获取上下文菜单
+     */
+    get contextMenu(): SceneTreeContextMenu;
+    /**
+     * 选择项时是否显示属性 UI 的响应式变量
+     */
+    private _showPropUiOnSelecting;
+    /**
+     * 获取选择项时是否显示属性 UI 的值
+     */
+    get showPropUiOnSelecting(): boolean;
+    /**
+     * 设置选择项时是否显示属性 UI 的值
+     * @param value - 要设置的值
+     */
+    set showPropUiOnSelecting(value: boolean);
+    /**
+     * 获取选择项时是否显示属性 UI 的值变化事件
+     */
+    get showPropUiOnSelectingChanged(): import("xbsj-base").Listener<[boolean, boolean]>;
+    /**
+     * 场景树构造函数
+     * @param _name - 场景树的名称
+     * @param _dragStartDataManager - 拖放起始数据管理器
+     * @param itemDivHeight - 树项的高度
+     * @param _projectManager - 项目管理器
+     */
+    constructor(_name: string, _dragStartDataManager: DragStartDataManager, itemDivHeight: number, _projectManager: ESObjectsManager);
+    /**
+     * 获取场景 UI 树
+     */
+    get sceneUiTree(): UiTree<SceneTreeItem, SceneTree>;
+    /**
+     * 根据场景对象的 ID 获取树项
+     * @param id - 场景对象的 ID
+     * @returns 对应的树项，如果未找到则返回 undefined
+     */
+    getTreeItemFromSceneObjId(id: string): SceneTreeItem | undefined;
+    /**
+     * 获取拖放起始数据管理器
+     */
+    get dragStartDataManager(): DragStartDataManager;
+    /**
+     * 获取当前树结构的 Json 数据
+     * @returns SceneTreeItem 的 isExport 为 true 的 Json 数据
+     */
+    getJson(): {
+        root: {
+            children: SceneTreeItemJsonValue[];
+        };
+    };
+    /**
+     * 设置场景树的 JSON 数据
+     * @param value - 要设置的 JSON 数据
+     */
+    setJson(value: SceneTreeJsonValue): void;
+    /**
+     * 监测 addNewTreeItem 是否可以添加项
+     * @deprecated 请勿使用，未来将废弃！
+     * @param currentTreeItem - 当前的树项
+     * @param flag - 插入标志
+     * @returns 是否可以添加项
+     */
+    testAddNewTreeItem(currentTreeItem: SceneTreeItem | undefined, flag: SceneTreeItemInsertFlag): boolean;
+    /**
+     * 添加新的树项
+     * @deprecated 请勿使用，未来将废弃！
+     * @param currentTreeItem - 当前的树项
+     * @param flag - 插入标志
+     * @param isGroup - 是否为组节点
+     * @param sceneObject - 可选的场景对象
+     * @returns 新添加的树项，如果添加失败则返回 undefined
+     */
+    addNewTreeItem(currentTreeItem: SceneTreeItem | undefined, flag: SceneTreeItemInsertFlag, isGroup: boolean, sceneObject?: ESSceneObject): SceneTreeItem | undefined;
+    /**
+     * 根据场景对象类型创建场景对象树项
+     * @param sceneObjectType - 场景对象的类型，可以是字符串或构造函数
+     * @param id - 可选的场景对象 ID
+     * @param currentTreeItem - 可选的当前树项
+     * @param flag - 可选的插入标志
+     * @returns 新创建的场景对象树项，如果创建失败则返回 undefined
+     */
+    createSceneObjectTreeItem<T extends ESSceneObject>(sceneObjectType: string | (new (id?: string | undefined) => T), id?: string, currentTreeItem?: SceneTreeItem, flag?: SceneTreeItemInsertFlag): SceneTreeItem | undefined;
+    /**
+     * 创建一个组节点
+     * @param name - 可选的组节点名称
+     * @param id - 可选的组节点 ID
+     * @param currentTreeItem - 可选的当前树项
+     * @param flag - 可选的插入标志
+     * @returns 新创建的组节点树项，如果创建失败则返回 undefined
+     */
+    createGroupTreeItem(name?: string, id?: string, currentTreeItem?: SceneTreeItem, flag?: SceneTreeItemInsertFlag): SceneTreeItem | undefined;
+    /**
+     * 根据场景对象构造函数创建场景对象树项
+     * @param sceneObjConstructor - 场景对象的构造函数
+     * @param id - 可选的场景对象 ID
+     * @param currentTreeItem - 可选的当前树项
+     * @param flag - 可选的插入标志
+     * @returns 新创建的场景对象树项，如果创建失败则返回 undefined
+     */
+    createSceneObjectTreeItemFromClass<T extends ESSceneObject>(sceneObjConstructor: new (id?: string | undefined) => T, id?: string, currentTreeItem?: SceneTreeItem, flag?: SceneTreeItemInsertFlag): SceneTreeItem | undefined;
+    /**
+     * 根据场景对象的 JSON 数据创建场景对象树项
+     * @param sceneObjectJson - 场景对象的 JSON 数据
+     * @param currentTreeItem - 可选的当前树项
+     * @param flag - 可选的插入标志
+     * @returns 新创建的场景对象树项，如果创建失败则返回 undefined
+     */
+    createSceneObjectTreeItemFromJson<T extends ESSceneObject>(sceneObjectJson: JsonValue & {
+        [k: string]: any;
+        type: string;
+    }, currentTreeItem?: SceneTreeItem, flag?: SceneTreeItemInsertFlag): SceneTreeItem | undefined;
+    /**
+     * 销毁一个场景对象节点
+     * @param sceneTreeItem - 要销毁的场景对象树项
+     */
+    destroySceneObjectTreeItem(sceneTreeItem: SceneTreeItem): void;
+    /**
+     * 销毁用户添加的所有场景节点
+     */
+    destroyAllSceneObjectTreeItems(): void;
+}
+export {};
+//# sourceMappingURL=SceneTree.d.ts.map

package/dist/types/utils/SceneTrees/SceneTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneTree.d.ts","sourceRoot":"","sources":["../../../../src/utils/SceneTrees/SceneTree.ts"],"names":[],"mappings":"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"}

package/dist/types/utils/SceneTrees/SceneTreeContextMenu.d.ts

@@ -1,19 +1,51 @@
-import { Destroyable } from "xbsj-base";
-import { SceneTree } from "./SceneTree";
-import { SceneTreeItem } from "./SceneTreeItem";
-import { ESObjectsManager } from "../../ESObjectManager";
-export type MenuContentType = {
-    text: string;
-    keys: string;
-    func: () => void;
-} | {
-    type: "divider";
-};
-export type TreeItemContexMenuCallbackType = (contextMenuItems: MenuContentType[], item: SceneTreeItem | undefined, sceneTree: SceneTree, projectManager: ESObjectsManager) => void;
-export declare class SceneTreeContextMenu extends Destroyable {
-    private _sceneTree;
-    private _projectManager;
-    get sceneTree(): SceneTree;
-    treeItemContexMenuCallback: TreeItemContexMenuCallbackType | undefined;
-    constructor(_sceneTree: SceneTree, _projectManager: ESObjectsManager);
-}
+import { Destroyable } from "xbsj-base";
+import { SceneTree } from "./SceneTree";
+import { SceneTreeItem } from "./SceneTreeItem";
+import { ESObjectsManager } from "../../ESObjectManager";
+/**
+ * 菜单内容类型定义。
+ * 可以是包含文本、快捷键和执行函数的菜单项，也可以是分隔线。
+ */
+export type MenuContentType = {
+    /** 菜单项显示的文本 */
+    text: string;
+    /** 菜单项对应的快捷键 */
+    keys: string;
+    /** 菜单项被点击时执行的函数 */
+    func: () => void;
+} | {
+    /** 类型标识，表明该项为分隔线 */
+    type: "divider";
+};
+/**
+ * 树节点上下文菜单回调函数的类型定义。
+ * @param contextMenuItems - 上下文菜单项数组。
+ * @param item - 当前操作的场景树节点，可能为 undefined。
+ * @param sceneTree - 场景树实例。
+ * @param projectManager - 项目管理器实例。
+ */
+export type TreeItemContexMenuCallbackType = (contextMenuItems: MenuContentType[], item: SceneTreeItem | undefined, sceneTree: SceneTree, projectManager: ESObjectsManager) => void;
+/**
+ * 场景树上下文菜单类，继承自 Destroyable 类。
+ * 用于管理场景树节点的上下文菜单。
+ */
+export declare class SceneTreeContextMenu extends Destroyable {
+    private _sceneTree;
+    private _projectManager;
+    /**
+     * 获取当前关联的场景树实例。
+     * @returns 场景树实例。
+     */
+    get sceneTree(): SceneTree;
+    /**
+     * 树节点上下文菜单回调函数，当需要自定义上下文菜单时使用。
+     */
+    treeItemContexMenuCallback: TreeItemContexMenuCallbackType | undefined;
+    /**
+     * 构造函数，初始化场景树上下文菜单。
+     * @param _sceneTree - 关联的场景树实例。
+     * @param _projectManager - 关联的项目管理器实例。
+     */
+    constructor(_sceneTree: SceneTree, _projectManager: ESObjectsManager);
+}
+//# sourceMappingURL=SceneTreeContextMenu.d.ts.map

package/dist/types/utils/SceneTrees/SceneTreeContextMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneTreeContextMenu.d.ts","sourceRoot":"","sources":["../../../../src/utils/SceneTrees/SceneTreeContextMenu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,IAAI,EAAE,MAAM,IAAI,CAAC;CACpB,GAAG;IACA,oBAAoB;IACpB,IAAI,EAAE,SAAS,CAAC;CACnB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,gBAAgB,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,GAAG,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEpL;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;IAiBrC,OAAO,CAAC,UAAU;IAAa,OAAO,CAAC,eAAe;IAhBlE;;;OAGG;IACH,IAAI,SAAS,cAA8B;IAE3C;;OAEG;IACH,0BAA0B,EAAE,8BAA8B,GAAG,SAAS,CAAC;IAEvE;;;;OAIG;gBACiB,UAAU,EAAE,SAAS,EAAU,eAAe,EAAE,gBAAgB;CAGvF"}