earthsdk3 3.0.6 → 3.0.7-beta.11

package/dist/types/ESObjects/base/ESSceneObject/ESObjectsContext.d.ts

@@ -1,85 +1,213 @@
-import { Destroyable, JsonValue, Listener, ReactParamsType } from "xbsj-base";
-import { ESSceneObject } from "./index";
-import { RefsManager } from "./RefsManager";
-/**
- * ESObjectsContext
- * ESObjects的上下文，用于管理ESObjects的注册/创建/销毁
- */
-export declare class ESObjectsContext extends Destroyable {
-    private _esObjConstructors;
-    get typeNames(): IterableIterator<string>;
-    private _sceneObjs;
-    get sceneObjs(): IterableIterator<ESSceneObject>;
-    private _sceneObjCreatedEvent;
-    get sceneObjCreatedEvent(): Listener<[ESSceneObject]>;
-    private _sceneObjToDestroyEvent;
-    get sceneObjToDestroyEvent(): Listener<[ESSceneObject]>;
-    private _refsManager;
-    get refsManager(): RefsManager;
-    get $refs(): {
-        [k: string]: ESSceneObject | undefined;
-    };
-    constructor();
-    register<T extends ESSceneObject>(sceneObjectType: string, sceneObjConstructor: new () => T, extraInfo?: {
-        [k: string]: any;
-    }): string;
-    private _addSceneObject;
-    private _deleteSceneObject;
-    createSceneObjectFromClass<T extends ESSceneObject>(sceneObjConstructor: new (id?: string) => T, id?: string): T;
-    createSceneObject<T extends ESSceneObject>(sceneObjectType: string | (new (id?: string) => T), id?: string): T | undefined;
-    createSceneObjectFromJson<T extends ESSceneObject>(sceneObjectJson: JsonValue & {
-        type: string;
-        [k: string]: any;
-    }): T | undefined;
-    destroySceneObject(sceneObject: ESSceneObject): boolean;
-    getSceneObjectById(id: string): ESSceneObject | undefined;
-    getSceneObject(option?: string): ESSceneObject | ESSceneObject[] | undefined;
-    private _getSceneObjConstructor;
-    getProps(typeName: string): {
-        [k: string]: any;
-    } | undefined;
-    setProps(typeName: string, props: {
-        [k: string]: any;
-    }): void;
-    getProp<T>(typeName: string, propName: string): T | undefined;
-    setProp<T = any>(typeName: string, propName: string, value: T): void;
-    private _environmentVariables;
-    get environmentVariables(): {
-        [k: string]: string | undefined;
-    };
-    set environmentVariables(value: {
-        [k: string]: string | undefined;
-    });
-    private _environmentVariablesChanged;
-    get environmentVariablesChanged(): Listener<[varName: string, value: string | undefined, oldValue: string | undefined]>;
-    /**
-     * 设置环境变量
-     * @param varName 环境变量名
-     * @param value 环境变量值
-     */
-    setEnv(varName: string, value: string | undefined): void;
-    /**
-     * 获取环境变量
-     * @param varName 环境变量名
-     * @returns  环境变量值
-     */
-    getEnv(varName: string): string | undefined;
-    /**
-     * 根据含有环境变量的url获取真实路径
-     * @param str 字符串 内部必须包含`${xxx-xxx}/xxx/abc.png` 环境变量名
-     * @returns  转换为真实路径后的字符串
-     */
-    getStrFromEnv(str: string): string;
-    /**
-     * 创建一个经过env替换后的响应式变量
-     * @param reactVar
-     * @example
-     * const reactUrl = this.dv(ESSceneObject.context.createEnvStrReact([sceneObject, 'uri']));
-     * this.d(reactUrl.changed.don(update));
-     */
-    createEnvStrReact(reactVar: ReactParamsType<string | undefined>, defaultValue?: string): import("xbsj-base").ReactiveVariable<string | undefined>;
-    /**
-     * @deprecated 请使用createEnvStrReact
-     */
-    createEvnStrReact(reactVar: ReactParamsType<string | undefined>, defaultValue?: string): import("xbsj-base").ReactiveVariable<string | undefined>;
-}
+import { Destroyable, JsonValue, Listener, ReactParamsType } from "xbsj-base";
+import { ESSceneObject } from "./index";
+import { RefsManager } from "./RefsManager";
+/**
+ * ESObjectsContext
+ * ESObjects的上下文，用于管理ESObjects的注册/创建/销毁
+ */
+export declare class ESObjectsContext extends Destroyable {
+    /**
+     * 存储场景对象构造函数的映射，键为场景对象类型名，值为对应的构造函数
+     */
+    private _esObjConstructors;
+    /**
+     * 获取所有已注册的场景对象类型名的迭代器
+     */
+    get typeNames(): MapIterator<string>;
+    /**
+     * 存储已创建的场景对象的映射，键为场景对象的ID，值为对应的场景对象实例
+     */
+    private _sceneObjs;
+    /**
+     * 获取所有已创建的场景对象实例的迭代器
+     */
+    get sceneObjs(): MapIterator<ESSceneObject>;
+    /**
+     * 场景对象创建事件，当有新的场景对象创建时触发
+     */
+    private _sceneObjCreatedEvent;
+    /**
+     * 获取场景对象创建事件的监听器
+     */
+    get sceneObjCreatedEvent(): Listener<[ESSceneObject]>;
+    /**
+     * 场景对象即将销毁事件，当场景对象即将被销毁时触发
+     */
+    private _sceneObjToDestroyEvent;
+    /**
+     * 获取场景对象即将销毁事件的监听器
+     */
+    get sceneObjToDestroyEvent(): Listener<[ESSceneObject]>;
+    /**
+     * 引用管理器实例，用于管理场景对象的引用
+     */
+    private _refsManager;
+    /**
+     * 获取引用管理器实例
+     */
+    get refsManager(): RefsManager;
+    /**
+     * 获取引用管理器中的所有引用
+     */
+    get $refs(): {
+        [k: string]: ESSceneObject | undefined;
+    };
+    /**
+     * 构造函数，初始化 ESObjectsContext 实例
+     */
+    constructor();
+    /**
+     * 注册场景对象类型及其构造函数
+     * @param sceneObjectType 场景对象类型名
+     * @param sceneObjConstructor 场景对象的构造函数
+     * @param extraInfo 可选的额外信息，将存储在构造函数的扩展属性中
+     * @returns 注册的场景对象类型名
+     */
+    register<T extends ESSceneObject>(sceneObjectType: string, sceneObjConstructor: new () => T, extraInfo?: {
+        [k: string]: any;
+    }): string;
+    /**
+     * 向场景对象映射中添加场景对象，并触发场景对象创建事件
+     * @param sceneObject 要添加的场景对象实例
+     */
+    private _addSceneObject;
+    /**
+     * 从场景对象映射中删除场景对象，并触发场景对象即将销毁事件
+     * @param sceneObject 要删除的场景对象实例
+     */
+    private _deleteSceneObject;
+    /**
+     * 根据场景对象的构造函数创建场景对象实例
+     * @param sceneObjConstructor 场景对象的构造函数
+     * @param id 可选的场景对象ID，如果未提供或已存在相同ID的对象，将自动生成新的ID
+     * @returns 创建的场景对象实例
+     */
+    createSceneObjectFromClass<T extends ESSceneObject>(sceneObjConstructor: new (id?: string) => T, id?: string): T;
+    /**
+     * 根据场景对象类型名或构造函数创建场景对象实例
+     * @param sceneObjectType 场景对象类型名或构造函数
+     * @param id 可选的场景对象ID
+     * @returns 创建的场景对象实例，如果未找到对应的构造函数则返回 undefined
+     */
+    createSceneObject<T extends ESSceneObject>(sceneObjectType: string | (new (id?: string) => T), id?: string): T | undefined;
+    /**
+     * 根据 JSON 对象创建场景对象实例，并将 JSON 数据赋值给场景对象
+     * @param sceneObjectJson 包含场景对象类型和其他属性的 JSON 对象
+     * @returns 创建的场景对象实例，如果未找到对应的构造函数则返回 undefined
+     */
+    createSceneObjectFromJson<T extends ESSceneObject>(sceneObjectJson: JsonValue & {
+        type: string;
+        [k: string]: any;
+    }): T | undefined;
+    /**
+     * 销毁指定的场景对象实例
+     * @param sceneObject 要销毁的场景对象实例
+     * @returns 场景对象是否已被销毁
+     */
+    destroySceneObject(sceneObject: ESSceneObject): boolean;
+    /**
+     * 根据场景对象的ID获取场景对象实例
+     * @param id 场景对象的ID
+     * @returns 对应的场景对象实例，如果未找到则返回 undefined
+     */
+    getSceneObjectById(id: string): ESSceneObject | undefined;
+    /**
+     * 根据不同的条件获取场景对象实例
+     * @param option 可选的条件，如果未提供则返回所有场景对象；如果以 'ES' 开头，则返回指定类型的所有场景对象；否则返回指定ID的场景对象
+     * @returns 符合条件的场景对象实例数组或单个实例，如果未找到则返回 undefined
+     */
+    getSceneObject(option?: string): ESSceneObject | ESSceneObject[] | undefined;
+    /**
+     * 根据场景对象类型名获取对应的构造函数
+     * @param sceneObjectType 场景对象类型名
+     * @returns 对应的构造函数，如果未找到则返回 undefined
+     */
+    private _getSceneObjConstructor;
+    /**
+     * 根据场景对象类型名获取存储在构造函数扩展属性中的额外信息
+     * @param typeName 场景对象类型名
+     * @returns 额外信息对象，如果未找到对应的构造函数则返回 undefined
+     */
+    getProps(typeName: string): {
+        [k: string]: any;
+    } | undefined;
+    /**
+     * 根据场景对象类型名设置存储在构造函数扩展属性中的额外信息
+     * @param typeName 场景对象类型名
+     * @param props 要设置的额外信息对象
+     */
+    setProps(typeName: string, props: {
+        [k: string]: any;
+    }): void;
+    /**
+     * 根据场景对象类型名和属性名获取存储在构造函数扩展属性中的特定属性值
+     * @param typeName 场景对象类型名
+     * @param propName 属性名
+     * @returns 特定属性值，如果未找到对应的构造函数或属性则返回 undefined
+     */
+    getProp<T>(typeName: string, propName: string): T | undefined;
+    /**
+     * 根据场景对象类型名和属性名设置存储在构造函数扩展属性中的特定属性值
+     * @param typeName 场景对象类型名
+     * @param propName 属性名
+     * @param value 要设置的属性值
+     */
+    setProp<T = any>(typeName: string, propName: string, value: T): void;
+    /**
+     * 存储环境变量的对象，默认从 window.ESSDK_ENV 获取
+     */
+    private _environmentVariables;
+    /**
+     * 获取所有环境变量
+     */
+    get environmentVariables(): {
+        [k: string]: string | undefined;
+    };
+    /**
+     * 设置环境变量，将新的环境变量对象中的键值对逐个设置到当前环境变量中
+     * @param value 新的环境变量对象
+     */
+    set environmentVariables(value: {
+        [k: string]: string | undefined;
+    });
+    /**
+     * 环境变量变更事件，当环境变量发生变化时触发
+     */
+    private _environmentVariablesChanged;
+    /**
+     * 获取环境变量变更事件的监听器
+     */
+    get environmentVariablesChanged(): Listener<[varName: string, value: string | undefined, oldValue: string | undefined]>;
+    /**
+     * 设置环境变量
+     * @param varName 环境变量名
+     * @param value 环境变量值
+     */
+    setEnv(varName: string, value: string | undefined): void;
+    /**
+     * 获取环境变量
+     * @param varName 环境变量名
+     * @returns 环境变量值
+     */
+    getEnv(varName: string): string | undefined;
+    /**
+     * 根据含有环境变量的字符串获取真实路径
+     * @param str 包含环境变量的字符串，环境变量格式为 `${xxx-xxx}`
+     * @returns 替换环境变量后的真实路径字符串
+     */
+    getStrFromEnv(str: string): string;
+    /**
+     * 创建一个经过环境变量替换后的响应式变量
+     * @param reactVar 响应式变量参数
+     * @param defaultValue 可选的默认值
+     * @example
+     * const reactUrl = this.dv(ESSceneObject.context.createEnvStrReact([sceneObject, 'uri']));
+     * this.d(reactUrl.changed.don(update));
+     */
+    createEnvStrReact(reactVar: ReactParamsType<string | undefined>, defaultValue?: string): import("xbsj-base").ReactiveVariable<string | undefined>;
+    /**
+     * @deprecated 请使用createEnvStrReact
+     */
+    createEvnStrReact(reactVar: ReactParamsType<string | undefined>, defaultValue?: string): import("xbsj-base").ReactiveVariable<string | undefined>;
+}
+//# sourceMappingURL=ESObjectsContext.d.ts.map

package/dist/types/ESObjects/base/ESSceneObject/ESObjectsContext.d.ts.map

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

package/dist/types/ESObjects/base/ESSceneObject/RefsManager.d.ts

@@ -1,16 +1,53 @@
-import { Destroyable, Listener } from "xbsj-base";
-import { ESSceneObject } from "./index";
-import { ESObjectsContext } from "./ESObjectsContext";
-export declare class RefsManager extends Destroyable {
-    private _sceneObjRefs;
-    get sceneObjRefs(): Map<string, ESSceneObject[]>;
-    private _refs;
-    get refs(): {
-        [k: string]: ESSceneObject | undefined;
-    };
-    private _refsChanged;
-    get refsChanged(): Listener<[ESSceneObject | undefined, ESSceneObject | undefined]>;
-    getLastSceneObject(ref: string): ESSceneObject | undefined;
-    getSceneObjects(ref: string): ESSceneObject[] | undefined;
-    constructor(context: ESObjectsContext);
-}
+import { Destroyable, Listener } from "xbsj-base";
+import { ESObjectsContext } from "./ESObjectsContext";
+import { ESSceneObject } from "./index";
+/**
+ * RefsManager 类用于管理场景对象的引用。
+ * 它跟踪场景对象的引用关系，并在引用发生变化时触发事件。
+ */
+export declare class RefsManager extends Destroyable {
+    /**
+     * 存储场景对象引用的映射，键为引用名称，值为场景对象数组。
+     */
+    private _sceneObjRefs;
+    /**
+     * 获取场景对象引用的映射。
+     */
+    get sceneObjRefs(): Map<string, ESSceneObject[]>;
+    /**
+     * 存储引用和对应的最后一个场景对象的映射。
+     */
+    private _refs;
+    /**
+     * 获取引用和对应的最后一个场景对象的映射。
+     */
+    get refs(): {
+        [k: string]: ESSceneObject | undefined;
+    };
+    /**
+     * 当引用发生变化时触发的事件，事件参数为新的场景对象和旧的场景对象。
+     */
+    private _refsChanged;
+    /**
+     * 获取引用变化事件的监听器。
+     */
+    get refsChanged(): Listener<[ESSceneObject | undefined, ESSceneObject | undefined]>;
+    /**
+     * 获取指定引用的最后一个场景对象。
+     * @param ref - 引用名称。
+     * @returns 如果存在对应的场景对象数组，则返回数组中的最后一个场景对象；否则返回 undefined。
+     */
+    getLastSceneObject(ref: string): ESSceneObject | undefined;
+    /**
+     * 获取指定引用的场景对象数组。
+     * @param ref - 引用名称。
+     * @returns 如果存在对应的场景对象数组且数组不为空，则返回该数组；否则返回 undefined。
+     */
+    getSceneObjects(ref: string): ESSceneObject[] | undefined;
+    /**
+     * 构造函数，初始化 RefsManager 实例。
+     * @param context - ESObjectsContext 实例，用于监听场景对象的创建和销毁事件。
+     */
+    constructor(context: ESObjectsContext);
+}
+//# sourceMappingURL=RefsManager.d.ts.map

package/dist/types/ESObjects/base/ESSceneObject/RefsManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RefsManager.d.ts","sourceRoot":"","sources":["../../../../../src/ESObjects/base/ESSceneObject/RefsManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,QAAQ,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC;;;GAGG;AACH,qBAAa,WAAY,SAAQ,WAAW;IACxC;;OAEG;IACH,OAAO,CAAC,aAAa,CAA2C;IAChE;;OAEG;IACH,IAAI,YAAY,iCAAiC;IACjD;;OAEG;IACH,OAAO,CAAC,KAAK,CAAkD;IAC/D;;OAEG;IACH,IAAI,IAAI;;MAAyB;IACjC;;OAEG;IACH,OAAO,CAAC,YAAY,CAAgF;IACpG;;OAEG;IACH,IAAI,WAAW,IAAiC,QAAQ,CAAC,CAAC,aAAa,GAAG,SAAS,EAAE,aAAa,GAAG,SAAS,CAAC,CAAC,CAAG;IAEnH;;;;OAIG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM;IAQ9B;;;;OAIG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM;IAQ3B;;;OAGG;gBACS,OAAO,EAAE,gBAAgB;CAgExC"}

package/dist/types/ESObjects/base/ESSceneObject/funcs/createEnvEvalStrReact.d.ts

@@ -1,2 +1,13 @@
-import { ReactParamsType } from "xbsj-base";
-export declare function createEnvEvalStrReact(reactVar: ReactParamsType<string | undefined>, defaultValue?: string): import("xbsj-base").ReactiveVariable<string | undefined>;
+import { ReactParamsType } from "xbsj-base";
+/**
+ * 创建一个用于评估环境字符串的响应式对象。
+ *
+ * 该函数接收一个响应式变量 `reactVar` 和一个可选的默认值 `defaultValue`。
+ * 它会监听 `reactVar` 的变化以及环境变量的变化，并根据这些变化更新最终的环境字符串。
+ *
+ * @param reactVar - 一个响应式变量，其类型为 `string | undefined`。
+ * @param defaultValue - 可选的默认值，当 `reactVar` 的值为 `undefined` 时使用。
+ * @returns 返回一个响应式对象 `envStrReact`，其值为评估后的环境字符串或 `undefined`。
+ */
+export declare function createEnvEvalStrReact(reactVar: ReactParamsType<string | undefined>, defaultValue?: string): import("xbsj-base").ReactiveVariable<string | undefined>;
+//# sourceMappingURL=createEnvEvalStrReact.d.ts.map

package/dist/types/ESObjects/base/ESSceneObject/funcs/createEnvEvalStrReact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createEnvEvalStrReact.d.ts","sourceRoot":"","sources":["../../../../../../src/ESObjects/base/ESSceneObject/funcs/createEnvEvalStrReact.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,eAAe,EAAE,MAAM,WAAW,CAAC;AAElE;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,4DA8BzG"}

package/dist/types/ESObjects/base/ESSceneObject/funcs/replaceStrWithEnv.d.ts

@@ -1 +1,12 @@
-export declare function replaceStrWithEnv(str: string): string;
+/**
+ * 将字符串中的环境变量占位符替换为实际的环境变量值。
+ *
+ * 该函数会查找字符串中所有形如 ${envName} 的占位符，
+ * 并尝试从 ESSceneObject 的上下文中获取对应的环境变量值进行替换。
+ * 如果某个环境变量不存在，会在控制台输出警告信息，并将该占位符替换为 '{env-error}'。
+ *
+ * @param str - 包含环境变量占位符的字符串。
+ * @returns 替换后的字符串。
+ */
+export declare function replaceStrWithEnv(str: string): string;
+//# sourceMappingURL=replaceStrWithEnv.d.ts.map

package/dist/types/ESObjects/base/ESSceneObject/funcs/replaceStrWithEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replaceStrWithEnv.d.ts","sourceRoot":"","sources":["../../../../../../src/ESObjects/base/ESSceneObject/funcs/replaceStrWithEnv.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,UAwB5C"}