earthsdk3 3.3.0-beta.10 → 3.3.0-beta.12

package/dist/types/ESObjects/base/ESObjectWithLocation.d.ts

@@ -0,0 +1,307 @@
+import { Event, JsonValue, Listener, UniteChanged } from "xbsj-base";
+import { ESJColor, ESJPointStyle, ESJRenderType, ESJVector3D } from "../../ESJTypes";
+import { ESVisualObject } from "./ESVisualObject";
+/**
+ * ESObjectWithLocation 类继承自 ESVisualObject，用于表示具有位置信息的三维对象。
+ * 该类提供了多种平滑移动和编辑模式的功能，支持单点编辑、双点编辑、平滑移动到指定位置、
+ * 平滑偏移到指定位置和姿态、贴地平滑移动等操作。同时，还提供了自动落地和获取对象属性的功能。
+ *
+ * 核心功能包括：
+ * - 更新编辑模式（updateEditing）
+ * - 平滑移动（smoothMove、smoothMoveKeepPitch、smoothMoveWithRotation）
+ * - 贴地平滑移动（smoothMoveOnGround、smoothMoveWithRotationOnGround）
+ * - 自动落地（automaticLanding）
+ * - 获取对象的 ES 属性（getESProperties）
+ * - 获取对象的属性列表（getProperties）
+ *
+ * 使用示例：
+ *
+ * 构造函数参数：
+ * 无特殊构造函数参数，继承自 ESVisualObject。
+ *
+ * 特殊使用限制或潜在的副作用：
+ * - 平滑移动管理器目前还不能处理某些特定的平滑移动事件。
+ */
+export declare abstract class ESObjectWithLocation extends ESVisualObject {
+    /**
+     * 更新对象的编辑模式。
+     * 根据 editingBindMode 的值，设置不同的编辑模式，并启动编辑。
+     */
+    updateEditing(): void;
+    /**
+     * 表示对象是否禁用的响应式值。
+     */
+    private _statusDis;
+    /**
+     * 获取对象是否禁用的状态。
+     */
+    get statusDis(): boolean;
+    /**
+     * 获取对象禁用状态改变的事件监听器。
+     */
+    get statusDisChanged(): Listener<[boolean, boolean]>;
+    /**
+     * 平滑移动事件，当对象需要平滑移动到指定位置时触发。
+     */
+    private _smoothMoveEvent;
+    /**
+     * 获取平滑移动事件。
+     */
+    get smoothMoveEvent(): Event<[ESJVector3D, number]>;
+    /**
+     * 平滑移动到指定位置。
+     * @param Destination - 目标位置，格式为[经度, 纬度, 高度]
+     * @param Time - 平滑移动所需的时间，单位为秒
+     */
+    smoothMove(Destination: ESJVector3D, Time: number): void;
+    /**
+     * 平滑偏移到指定位置和姿态的事件。
+     */
+    private _smoothMoveWithRotationEvent;
+    /**
+     * 获取平滑偏移到指定位置和姿态的事件。
+     */
+    get smoothMoveWithRotationEvent(): Event<[ESJVector3D, ESJVector3D, number]>;
+    /**
+     * 平滑偏移到指定位置和姿态。
+     * @param Destination - 目标位置，格式为[经度, 纬度, 高度]
+     * @param NewRotation - 目标姿态，格式为[偏航角, 俯仰角, 翻转角]
+     * @param Time - 平滑移动所需的时间，单位为秒
+     */
+    smoothMoveWithRotation(Destination: ESJVector3D, NewRotation: ESJVector3D, Time: number): void;
+    /**
+     * 贴地平滑移动事件。
+     */
+    private _smoothMoveOnGroundEvent;
+    /**
+     * 获取贴地平滑移动事件。
+     */
+    get smoothMoveOnGroundEvent(): Event<[number, number, number, string]>;
+    /**
+     * 贴地平滑移动。
+     * @param Lon - 目标位置的经度
+     * @param Lat - 目标位置的纬度
+     * @param Time - 平滑移动所需的时间，单位为秒
+     * @param Ground - 地面类型，UE特有属性
+     */
+    smoothMoveOnGround(Lon: number, Lat: number, Time: number, Ground: string): void;
+    /**
+     * 贴地平滑偏移到指定位置和姿态的事件。
+     */
+    private _smoothMoveWithRotationOnGroundEvent;
+    /**
+     * 获取贴地平滑偏移到指定位置和姿态的事件。
+     */
+    get smoothMoveWithRotationOnGroundEvent(): Event<[ESJVector3D, number, number, number, string]>;
+    /**
+     * 贴地平滑偏移到指定位置和姿态。
+     * @param NewRotation - 目标姿态，格式为[偏航角, 俯仰角, 翻转角]
+     * @param Lon - 目标位置的经度
+     * @param Lat - 目标位置的纬度
+     * @param Time - 平滑移动所需的时间，单位为秒
+     * @param Ground - 地面类型，ue特有属性
+     */
+    smoothMoveWithRotationOnGround(NewRotation: ESJVector3D, Lon: number, Lat: number, Time: number, Ground: string): void;
+    /**
+     * 自动落地事件。
+     */
+    private _automaticLandingEvent;
+    /**
+     * 获取自动落地事件的监听器。
+     */
+    get automaticLandingEvent(): Listener<[flag: boolean]>;
+    /**
+     * 自动落地。
+     * 先禁用碰撞检测，一段时间后触发自动落地事件并恢复碰撞检测状态。
+     */
+    automaticLanding(): void;
+    /**
+     * 保持俯仰角平滑移动事件。
+     */
+    private _smoothMoveKeepPitchEvent;
+    /**
+     * 获取保持俯仰角平滑移动事件。
+     */
+    get smoothMoveKeepPitchEvent(): Event<[ESJVector3D, number]>;
+    /**
+     * 保持俯仰角平滑移动到指定位置。
+     * @param Destination - 目标位置，格式为[经度, 纬度, 高度]
+     * @param Time - 平滑移动所需的时间，单位为秒
+     */
+    smoothMoveKeepPitch(Destination: ESJVector3D, Time: number): void;
+    /**
+     * 相对平滑移动事件。
+     */
+    private _smoothMoveRelativelyEvent;
+    /**
+     * 获取相对平滑移动事件。
+     */
+    get smoothMoveRelativelyEvent(): Event<[ESJVector3D, number]>;
+    /**
+     * 相对平滑移动。
+     * @param RelativePosition - 相对位置，格式为[经度, 纬度, 高度]
+     * @param Time - 平滑移动所需的时间，单位为秒
+     */
+    smoothMoveRelatively(RelativePosition: ESJVector3D, Time: number): void;
+    /**
+     * 相对平滑偏移到指定位置和姿态的事件。
+     */
+    private _smoothMoveRelativelyWithRotationEvent;
+    /**
+     * 获取相对平滑偏移到指定位置和姿态的事件。
+     */
+    get smoothMoveRelativelyWithRotationEvent(): Event<[ESJVector3D, ESJVector3D, number]>;
+    /**
+     * 相对平滑偏移到指定位置和姿态。
+     * @param RelativePosition - 相对位置，格式为[经度, 纬度, 高度]
+     * @param NewRotation - 目标姿态，格式为[偏航角, 俯仰角, 翻转角]
+     * @param Time - 平滑移动所需的时间，单位为秒
+     */
+    smoothMoveRelativelyWithRotation(RelativePosition: ESJVector3D, NewRotation: ESJVector3D, Time: number): void;
+    /**
+     * 该类支持的编辑模式列表。
+     */
+    static supportEditingModes: string[];
+    /**
+     * 该类的默认属性。
+     */
+    static defaults: {
+        pointStyle: ESJPointStyle;
+        pointed: boolean;
+        show: boolean;
+        collision: boolean;
+        allowPicking: boolean;
+        flyToParam: import("../../ESJTypes").ESJFlyToParam;
+        flyInParam: import("../../ESJTypes").ESJFlyInParam;
+    };
+    /**
+     * 是否使用 ESObjectWithLocation 类中的 calcFlyToParam。
+     */
+    useCalcFlyToParamInESObjectWithLocation: boolean;
+    /**
+     * 获取对象的 ES 属性。
+     * 包含基本属性和位置相关属性。
+     * @returns 对象的 ES 属性对象。
+     */
+    getESProperties(): {
+        defaultMenu: string;
+        location: import("../../ESJTypes").Property[];
+        general: import("../../ESJTypes").Property[];
+        basic: import("../../ESJTypes").Property[];
+        dataSource: import("../../ESJTypes").Property[];
+        coordinate: import("../../ESJTypes").Property[];
+        style: import("../../ESJTypes").Property[];
+    };
+    /**
+     * 获取对象的属性列表。
+     * 包含基本属性和位置姿态相关的操作方法及属性。
+     * @param language - 语言标识，可选参数。
+     * @returns 对象的属性列表。
+     */
+    getProperties(language?: string): import("../../ESJTypes").Property[];
+    /**
+         * 获取点的大小
+         */
+    get pointSize(): number;
+    /**
+     * 设置点的大小
+     * @param value - 点的大小值
+     */
+    set pointSize(value: number);
+    /**
+     * 获取点大小变化的事件
+     */
+    get pointSizeChanged(): Listener<[ESJPointStyle, ESJPointStyle]>;
+    /**
+     * 获取点的大小类型
+     */
+    get pointSizeType(): ESJRenderType;
+    /**
+     * 设置点的大小类型
+     * @param value - 点的大小类型值
+     */
+    set pointSizeType(value: ESJRenderType);
+    /**
+     * 获取点大小类型变化的事件
+     */
+    get pointSizeTypeChanged(): Listener<[ESJPointStyle, ESJPointStyle]>;
+    /**
+     * 获取点的颜色
+     */
+    get pointColor(): ESJColor;
+    /**
+     * 设置点的颜色
+     * @param value - 点的颜色值
+     */
+    set pointColor(value: ESJColor);
+    /**
+     * 获取点颜色变化的事件
+     */
+    get pointColorChanged(): Listener<[ESJPointStyle, ESJPointStyle]>;
+    /**
+     * 获取点的材质
+     */
+    get pointMaterial(): string;
+    /**
+     * 设置点的材质
+     * @param value - 点的材质值
+     */
+    set pointMaterial(value: string);
+    /**
+     * 获取点材质变化的事件
+     */
+    get pointMaterialChanged(): Listener<[ESJPointStyle, ESJPointStyle]>;
+    /**
+     * 获取点的材质参数
+     */
+    get pointMaterialParams(): JsonValue;
+    /**
+     * 设置点的材质参数
+     * @param value - 点的材质参数值
+     */
+    set pointMaterialParams(value: JsonValue);
+    /**
+     * 获取点材质参数变化的事件
+     */
+    get pointMaterialParamsChanged(): Listener<[ESJPointStyle, ESJPointStyle]>;
+}
+export declare namespace ESObjectWithLocation {
+    /**
+     * 创建 ESObjectWithLocation 类的默认属性。
+     * @returns 默认属性对象。
+     */
+    const createDefaultProps: () => {
+        /**点样式是否启用，默认false */
+        pointed: boolean;
+        /**点样式 */
+        pointStyle: import("xbsj-base").ReactiveVariable<ESJPointStyle>;
+        /**位置点 [经,纬,高] */
+        position: import("xbsj-base").ReactiveVariable<ESJVector3D>;
+        /**姿态 [h,p,r] */
+        rotation: import("xbsj-base").ReactiveVariable<ESJVector3D>;
+        /**缩放 [x,y,z] */
+        scale: import("xbsj-base").ReactiveVariable<ESJVector3D>;
+        /**最小可视距离 */
+        minVisibleDistance: import("xbsj-base").ReactiveVariable<number>;
+        /**最大可视距离 */
+        maxVisibleDistance: import("xbsj-base").ReactiveVariable<number>;
+        show: boolean;
+        collision: boolean;
+        allowPicking: boolean;
+        flyToParam: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJFlyToParam | undefined>;
+        flyInParam: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJFlyInParam | undefined>;
+        name: string;
+        ref: string | undefined;
+        extras: import("xbsj-base").ReactiveVariable<JsonValue>;
+        devTags: import("xbsj-base").ReactiveVariable<string[] | undefined>;
+        execOnceFuncStr: string | undefined;
+        updateFuncStr: string | undefined;
+        toDestroyFuncStr: string | undefined;
+    };
+}
+/**
+ * 扩展后的 ESObjectWithLocation 接口，包含默认属性的变更通知。
+ */
+export interface ESObjectWithLocation extends UniteChanged<ReturnType<typeof ESObjectWithLocation.createDefaultProps>> {
+}
+//# sourceMappingURL=ESObjectWithLocation.d.ts.map

package/dist/types/ESObjects/base/ESObjectWithLocation.d.ts.map

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

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

@@ -0,0 +1,215 @@
+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;
+    addSceneObject(sceneObject: ESSceneObject): void;
+    /**
+     * 从场景对象映射中删除场景对象，并触发场景对象即将销毁事件
+     * @param sceneObject 要删除的场景对象实例
+     */
+    private _deleteSceneObject;
+    deleteSceneObject(sceneObject: ESSceneObject): void;
+    /**
+     * 根据场景对象的构造函数创建场景对象实例
+     * @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

@@ -0,0 +1,53 @@
+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

@@ -0,0 +1,13 @@
+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

@@ -0,0 +1,12 @@
+/**
+ * 将字符串中的环境变量占位符替换为实际的环境变量值。
+ *
+ * 该函数会查找字符串中所有形如 ${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"}