@esengine/ecs-framework 2.0.3

package/bin/Core.js

@@ -0,0 +1,249 @@
+import { Emitter } from './Utils/Emitter';
+import { CoreEvents } from './ECS/CoreEvents';
+import { TimerManager } from './Utils/Timers/TimerManager';
+import { Time } from './Utils/Time';
+import { PerformanceMonitor } from './Utils/PerformanceMonitor';
+import { PoolManager } from './Utils/Pool';
+import { createECSAPI } from './ECS/Core/FluentAPI';
+/**
+ * 游戏引擎核心类
+ *
+ * 负责管理游戏的生命周期、场景切换、全局管理器和定时器系统。
+ * 提供统一的游戏循环和事件分发机制。
+ *
+ * @example
+ * ```typescript
+ * // 创建核心实例
+ * const core = Core.create(true);
+ *
+ * // 设置场景
+ * Core.scene = new MyScene();
+ *
+ * // 调度定时器
+ * Core.schedule(1.0, false, null, (timer) => {
+ *     console.log("1秒后执行");
+ * });
+ * ```
+ */
+export class Core {
+    /**
+     * 创建核心实例
+     *
+     * @param debug - 是否启用调试模式，默认为true
+     * @param enableEntitySystems - 是否启用实体系统，默认为true
+     */
+    constructor(debug = true, enableEntitySystems = true) {
+        /**
+         * 待切换的场景
+         *
+         * 存储下一帧要切换到的场景实例。
+         */
+        this._nextScene = null;
+        /**
+         * 全局管理器集合
+         *
+         * 存储所有注册的全局管理器实例。
+         */
+        this._globalManagers = [];
+        Core._instance = this;
+        Core.emitter = new Emitter();
+        Core.emitter.addObserver(CoreEvents.frameUpdated, this.update, this);
+        // 初始化管理器
+        this._timerManager = new TimerManager();
+        Core.registerGlobalManager(this._timerManager);
+        // 初始化性能监控器
+        this._performanceMonitor = PerformanceMonitor.instance;
+        // 初始化对象池管理器
+        this._poolManager = PoolManager.getInstance();
+        Core.entitySystemsEnabled = enableEntitySystems;
+        this.debug = debug;
+        this.initialize();
+    }
+    /**
+     * 获取核心实例
+     *
+     * @returns 全局核心实例
+     */
+    static get Instance() {
+        return this._instance;
+    }
+    /**
+     * 获取当前活动的场景
+     *
+     * @returns 当前场景实例，如果没有则返回null
+     */
+    static get scene() {
+        if (!this._instance)
+            return null;
+        return this._instance._scene || null;
+    }
+    /**
+     * 设置当前活动的场景
+     *
+     * 如果当前没有场景，会立即切换；否则会在下一帧切换。
+     *
+     * @param value - 要设置的场景实例
+     * @throws {Error} 当场景为空时抛出错误
+     */
+    static set scene(value) {
+        if (!value)
+            return;
+        if (!value) {
+            throw new Error("场景不能为空");
+        }
+        if (this._instance._scene == null) {
+            this._instance._scene = value;
+            this._instance.onSceneChanged();
+            this._instance._scene.begin();
+        }
+        else {
+            this._instance._nextScene = value;
+        }
+    }
+    /**
+     * 创建Core实例
+     *
+     * 如果实例已存在，则返回现有实例。
+     *
+     * @param debug - 是否为调试模式，默认为true
+     * @returns Core实例
+     */
+    static create(debug = true) {
+        if (this._instance == null) {
+            this._instance = new Core(debug);
+        }
+        return this._instance;
+    }
+    /**
+     * 注册全局管理器
+     *
+     * 将管理器添加到全局管理器列表中，并启用它。
+     *
+     * @param manager - 要注册的全局管理器
+     */
+    static registerGlobalManager(manager) {
+        this._instance._globalManagers.push(manager);
+        manager.enabled = true;
+    }
+    /**
+     * 注销全局管理器
+     *
+     * 从全局管理器列表中移除管理器，并禁用它。
+     *
+     * @param manager - 要注销的全局管理器
+     */
+    static unregisterGlobalManager(manager) {
+        this._instance._globalManagers.splice(this._instance._globalManagers.indexOf(manager), 1);
+        manager.enabled = false;
+    }
+    /**
+     * 获取指定类型的全局管理器
+     *
+     * @param type - 管理器类型构造函数
+     * @returns 管理器实例，如果未找到则返回null
+     */
+    static getGlobalManager(type) {
+        for (const manager of this._instance._globalManagers) {
+            if (manager instanceof type)
+                return manager;
+        }
+        return null;
+    }
+    /**
+     * 调度定时器
+     *
+     * 创建一个定时器，在指定时间后执行回调函数。
+     *
+     * @param timeInSeconds - 延迟时间（秒）
+     * @param repeats - 是否重复执行，默认为false
+     * @param context - 回调函数的上下文，默认为null
+     * @param onTime - 定时器触发时的回调函数
+     * @returns 创建的定时器实例
+     */
+    static schedule(timeInSeconds, repeats = false, context = null, onTime) {
+        return this._instance._timerManager.schedule(timeInSeconds, repeats, context, onTime);
+    }
+    /**
+     * 获取ECS流式API
+     *
+     * @returns ECS API实例，如果未初始化则返回null
+     */
+    static get ecsAPI() {
+        var _a;
+        return ((_a = this._instance) === null || _a === void 0 ? void 0 : _a._ecsAPI) || null;
+    }
+    /**
+     * 场景切换回调
+     *
+     * 在场景切换时调用，用于重置时间系统等。
+     */
+    onSceneChanged() {
+        Time.sceneChanged();
+        // 初始化ECS API（如果场景支持）
+        if (this._scene && typeof this._scene.querySystem !== 'undefined') {
+            const scene = this._scene;
+            this._ecsAPI = createECSAPI(scene, scene.querySystem, scene.eventSystem);
+        }
+    }
+    /**
+     * 初始化核心系统
+     *
+     * 执行核心系统的初始化逻辑。
+     */
+    initialize() {
+        // 核心系统初始化
+    }
+    /**
+     * 游戏主循环更新
+     *
+     * 每帧调用，负责更新时间系统、全局管理器和当前场景。
+     *
+     * @param currentTime - 当前时间戳，默认为-1（使用系统时间）
+     */
+    update(currentTime = -1) {
+        var _a;
+        if (Core.paused)
+            return;
+        // 开始性能监控
+        const frameStartTime = this._performanceMonitor.startMonitoring('Core.update');
+        Time.update(currentTime);
+        // 更新FPS监控（如果性能监控器支持）
+        if (typeof this._performanceMonitor.updateFPS === 'function') {
+            this._performanceMonitor.updateFPS(Time.deltaTime);
+        }
+        // 更新全局管理器
+        const managersStartTime = this._performanceMonitor.startMonitoring('GlobalManagers.update');
+        for (const globalManager of this._globalManagers) {
+            if (globalManager.enabled)
+                globalManager.update();
+        }
+        this._performanceMonitor.endMonitoring('GlobalManagers.update', managersStartTime, this._globalManagers.length);
+        // 更新对象池管理器
+        this._poolManager.update();
+        // 处理场景切换
+        if (this._nextScene != null) {
+            if (this._scene != null)
+                this._scene.end();
+            this._scene = this._nextScene;
+            this._nextScene = null;
+            this.onSceneChanged();
+            this._scene.begin();
+        }
+        // 更新当前场景
+        if (this._scene != null && this._scene.update) {
+            const sceneStartTime = this._performanceMonitor.startMonitoring('Scene.update');
+            this._scene.update();
+            const entityCount = ((_a = this._scene.entities) === null || _a === void 0 ? void 0 : _a.count) || 0;
+            this._performanceMonitor.endMonitoring('Scene.update', sceneStartTime, entityCount);
+        }
+        // 结束性能监控
+        this._performanceMonitor.endMonitoring('Core.update', frameStartTime);
+    }
+}
+/**
+ * 游戏暂停状态
+ *
+ * 当设置为true时，游戏循环将暂停执行。
+ */
+Core.paused = false;
+//# sourceMappingURL=Core.js.map

package/bin/Core.js.map

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

package/bin/ECS/Component.d.ts

@@ -0,0 +1,119 @@
+/**
+ * 游戏组件基类
+ *
+ * ECS架构中的组件（Component），用于实现具体的游戏功能。
+ * 组件包含数据和行为，可以被添加到实体上以扩展实体的功能。
+ *
+ * @example
+ * ```typescript
+ * class HealthComponent extends Component {
+ *     public health: number = 100;
+ *
+ *     public takeDamage(damage: number): void {
+ *         this.health -= damage;
+ *         if (this.health <= 0) {
+ *             this.entity.destroy();
+ *         }
+ *     }
+ * }
+ * ```
+ */
+export declare abstract class Component {
+    /**
+     * 组件ID生成器
+     *
+     * 用于为每个组件分配唯一的ID。
+     */
+    static _idGenerator: number;
+    /**
+     * 组件唯一标识符
+     *
+     * 在整个游戏生命周期中唯一的数字ID。
+     */
+    readonly id: number;
+    /**
+     * 组件所属的实体
+     *
+     * 指向拥有此组件的实体实例。
+     */
+    entity: Entity;
+    /**
+     * 组件启用状态
+     *
+     * 控制组件是否参与更新循环。
+     */
+    private _enabled;
+    /**
+     * 更新顺序
+     *
+     * 决定组件在更新循环中的执行顺序。
+     */
+    private _updateOrder;
+    /**
+     * 创建组件实例
+     *
+     * 自动分配唯一ID给组件。
+     */
+    constructor();
+    /**
+     * 获取组件启用状态
+     *
+     * 组件的实际启用状态取决于自身状态和所属实体的状态。
+     *
+     * @returns 如果组件和所属实体都启用则返回true
+     */
+    get enabled(): boolean;
+    /**
+     * 设置组件启用状态
+     *
+     * 当状态改变时会触发相应的生命周期回调。
+     *
+     * @param value - 新的启用状态
+     */
+    set enabled(value: boolean);
+    /**
+     * 获取更新顺序
+     *
+     * @returns 组件的更新顺序值
+     */
+    get updateOrder(): number;
+    /**
+     * 设置更新顺序
+     *
+     * @param value - 新的更新顺序值
+     */
+    set updateOrder(value: number);
+    /**
+     * 组件添加到实体时的回调
+     *
+     * 当组件被添加到实体时调用，可以在此方法中进行初始化操作。
+     */
+    onAddedToEntity(): void;
+    /**
+     * 组件从实体移除时的回调
+     *
+     * 当组件从实体中移除时调用，可以在此方法中进行清理操作。
+     */
+    onRemovedFromEntity(): void;
+    /**
+     * 组件启用时的回调
+     *
+     * 当组件被启用时调用。
+     */
+    onEnabled(): void;
+    /**
+     * 组件禁用时的回调
+     *
+     * 当组件被禁用时调用。
+     */
+    onDisabled(): void;
+    /**
+     * 更新组件
+     *
+     * 每帧调用，用于更新组件的逻辑。
+     * 子类应该重写此方法来实现具体的更新逻辑。
+     */
+    update(): void;
+}
+import type { Entity } from './Entity';
+//# sourceMappingURL=Component.d.ts.map

package/bin/ECS/Component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Component.d.ts","sourceRoot":"","sources":["../../src/ECS/Component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,8BAAsB,SAAS;IAC3B;;;;OAIG;IACH,OAAc,YAAY,EAAE,MAAM,CAAK;IAEvC;;;;OAIG;IACH,SAAgB,EAAE,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACI,MAAM,EAAG,MAAM,CAAC;IAEvB;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAiB;IAEjC;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAa;IAEjC;;;;OAIG;;IAKH;;;;;;OAMG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;;;;OAMG;IACH,IAAW,OAAO,CAAC,KAAK,EAAE,OAAO,EAShC;IAED;;;;OAIG;IACH,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED;;;;OAIG;IACH,IAAW,WAAW,CAAC,KAAK,EAAE,MAAM,EAEnC;IAED;;;;OAIG;IACI,eAAe,IAAI,IAAI;IAG9B;;;;OAIG;IACI,mBAAmB,IAAI,IAAI;IAGlC;;;;OAIG;IACI,SAAS,IAAI,IAAI;IAGxB;;;;OAIG;IACI,UAAU,IAAI,IAAI;IAGzB;;;;;OAKG;IACI,MAAM,IAAI,IAAI;CAExB;AAGD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/bin/ECS/Component.js

@@ -0,0 +1,129 @@
+/**
+ * 游戏组件基类
+ *
+ * ECS架构中的组件（Component），用于实现具体的游戏功能。
+ * 组件包含数据和行为，可以被添加到实体上以扩展实体的功能。
+ *
+ * @example
+ * ```typescript
+ * class HealthComponent extends Component {
+ *     public health: number = 100;
+ *
+ *     public takeDamage(damage: number): void {
+ *         this.health -= damage;
+ *         if (this.health <= 0) {
+ *             this.entity.destroy();
+ *         }
+ *     }
+ * }
+ * ```
+ */
+export class Component {
+    /**
+     * 创建组件实例
+     *
+     * 自动分配唯一ID给组件。
+     */
+    constructor() {
+        /**
+         * 组件启用状态
+         *
+         * 控制组件是否参与更新循环。
+         */
+        this._enabled = true;
+        /**
+         * 更新顺序
+         *
+         * 决定组件在更新循环中的执行顺序。
+         */
+        this._updateOrder = 0;
+        this.id = Component._idGenerator++;
+    }
+    /**
+     * 获取组件启用状态
+     *
+     * 组件的实际启用状态取决于自身状态和所属实体的状态。
+     *
+     * @returns 如果组件和所属实体都启用则返回true
+     */
+    get enabled() {
+        return this.entity ? this.entity.enabled && this._enabled : this._enabled;
+    }
+    /**
+     * 设置组件启用状态
+     *
+     * 当状态改变时会触发相应的生命周期回调。
+     *
+     * @param value - 新的启用状态
+     */
+    set enabled(value) {
+        if (this._enabled !== value) {
+            this._enabled = value;
+            if (this._enabled) {
+                this.onEnabled();
+            }
+            else {
+                this.onDisabled();
+            }
+        }
+    }
+    /**
+     * 获取更新顺序
+     *
+     * @returns 组件的更新顺序值
+     */
+    get updateOrder() {
+        return this._updateOrder;
+    }
+    /**
+     * 设置更新顺序
+     *
+     * @param value - 新的更新顺序值
+     */
+    set updateOrder(value) {
+        this._updateOrder = value;
+    }
+    /**
+     * 组件添加到实体时的回调
+     *
+     * 当组件被添加到实体时调用，可以在此方法中进行初始化操作。
+     */
+    onAddedToEntity() {
+    }
+    /**
+     * 组件从实体移除时的回调
+     *
+     * 当组件从实体中移除时调用，可以在此方法中进行清理操作。
+     */
+    onRemovedFromEntity() {
+    }
+    /**
+     * 组件启用时的回调
+     *
+     * 当组件被启用时调用。
+     */
+    onEnabled() {
+    }
+    /**
+     * 组件禁用时的回调
+     *
+     * 当组件被禁用时调用。
+     */
+    onDisabled() {
+    }
+    /**
+     * 更新组件
+     *
+     * 每帧调用，用于更新组件的逻辑。
+     * 子类应该重写此方法来实现具体的更新逻辑。
+     */
+    update() {
+    }
+}
+/**
+ * 组件ID生成器
+ *
+ * 用于为每个组件分配唯一的ID。
+ */
+Component._idGenerator = 0;
+//# sourceMappingURL=Component.js.map

package/bin/ECS/Component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Component.js","sourceRoot":"","sources":["../../src/ECS/Component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAgB,SAAS;IAoC3B;;;;OAIG;IACH;QAnBA;;;;WAIG;QACK,aAAQ,GAAY,IAAI,CAAC;QAEjC;;;;WAIG;QACK,iBAAY,GAAW,CAAC,CAAC;QAQ7B,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC9E,CAAC;IAED;;;;;;OAMG;IACH,IAAW,OAAO,CAAC,KAAc;QAC7B,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,IAAI,CAAC,SAAS,EAAE,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,UAAU,EAAE,CAAC;YACtB,CAAC;QACL,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,IAAW,WAAW,CAAC,KAAa;QAChC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACI,eAAe;IACtB,CAAC;IAED;;;;OAIG;IACI,mBAAmB;IAC1B,CAAC;IAED;;;;OAIG;IACI,SAAS;IAChB,CAAC;IAED;;;;OAIG;IACI,UAAU;IACjB,CAAC;IAED;;;;;OAKG;IACI,MAAM;IACb,CAAC;;AAlID;;;;GAIG;AACW,sBAAY,GAAW,CAAC,AAAZ,CAAa"}

package/bin/ECS/Components/IUpdatable.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 可更新接口
+ * 当添加到组件时，只要组件和实体被启用，就会在每帧调用update方法
+ */
+export interface IUpdatable {
+    enabled: boolean;
+    updateOrder: number;
+    update(): void;
+}
+/**
+ * 用于比较组件更新排序的比较器
+ */
+export declare class IUpdatableComparer {
+    compare(a: IUpdatable, b: IUpdatable): number;
+}
+/**
+ * 检查对象是否实现了IUpdatable接口
+ * @param props 要检查的对象
+ * @returns 如果实现了IUpdatable接口返回true，否则返回false
+ */
+export declare function isIUpdatable(props: any): props is IUpdatable;
+//# sourceMappingURL=IUpdatable.d.ts.map

package/bin/ECS/Components/IUpdatable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUpdatable.d.ts","sourceRoot":"","sources":["../../../src/ECS/Components/IUpdatable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,IAAI,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IACpB,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM;CAGvD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,UAAU,CAE5D"}

package/bin/ECS/Components/IUpdatable.js

@@ -0,0 +1,17 @@
+/**
+ * 用于比较组件更新排序的比较器
+ */
+export class IUpdatableComparer {
+    compare(a, b) {
+        return a.updateOrder - b.updateOrder;
+    }
+}
+/**
+ * 检查对象是否实现了IUpdatable接口
+ * @param props 要检查的对象
+ * @returns 如果实现了IUpdatable接口返回true，否则返回false
+ */
+export function isIUpdatable(props) {
+    return typeof props['update'] !== 'undefined';
+}
+//# sourceMappingURL=IUpdatable.js.map

package/bin/ECS/Components/IUpdatable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUpdatable.js","sourceRoot":"","sources":["../../../src/ECS/Components/IUpdatable.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACpB,OAAO,CAAC,CAAa,EAAE,CAAa;QACvC,OAAO,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;IACzC,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAU;IACnC,OAAO,OAAQ,KAAoB,CAAC,QAAQ,CAAC,KAAK,WAAW,CAAC;AAClE,CAAC"}

package/bin/ECS/Components/SceneComponent.d.ts

@@ -0,0 +1,40 @@
+import type { Scene } from '../Scene';
+/**
+ * 场景组件基类
+ * 附加到场景的组件，用于实现场景级别的功能
+ */
+export declare class SceneComponent {
+    /** 组件所属的场景 */
+    scene: Scene;
+    /** 更新顺序 */
+    updateOrder: number;
+    /** 是否启用 */
+    private _enabled;
+    /** 获取是否启用 */
+    get enabled(): boolean;
+    /** 设置是否启用 */
+    set enabled(value: boolean);
+    /**
+     * 当组件启用时调用
+     */
+    onEnabled(): void;
+    /**
+     * 当组件禁用时调用
+     */
+    onDisabled(): void;
+    /**
+     * 当组件从场景中移除时调用
+     */
+    onRemovedFromScene(): void;
+    /**
+     * 每帧更新
+     */
+    update(): void;
+    /**
+     * 比较组件的更新顺序
+     * @param other 其他组件
+     * @returns 比较结果
+     */
+    compare(other: SceneComponent): number;
+}
+//# sourceMappingURL=SceneComponent.d.ts.map

package/bin/ECS/Components/SceneComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneComponent.d.ts","sourceRoot":"","sources":["../../../src/ECS/Components/SceneComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC;;;GAGG;AACH,qBAAa,cAAc;IACvB,cAAc;IACP,KAAK,EAAG,KAAK,CAAC;IACrB,WAAW;IACJ,WAAW,EAAE,MAAM,CAAK;IAC/B,WAAW;IACX,OAAO,CAAC,QAAQ,CAAiB;IAEjC,aAAa;IACb,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,aAAa;IACb,IAAW,OAAO,CAAC,KAAK,EAAE,OAAO,EAShC;IAED;;OAEG;IACI,SAAS,IAAI,IAAI;IAGxB;;OAEG;IACI,UAAU,IAAI,IAAI;IAGzB;;OAEG;IACI,kBAAkB,IAAI,IAAI;IAGjC;;OAEG;IACI,MAAM,IAAI,IAAI;IAGrB;;;;OAIG;IACI,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;CAGhD"}

package/bin/ECS/Components/SceneComponent.js

@@ -0,0 +1,57 @@
+/**
+ * 场景组件基类
+ * 附加到场景的组件，用于实现场景级别的功能
+ */
+export class SceneComponent {
+    constructor() {
+        /** 更新顺序 */
+        this.updateOrder = 0;
+        /** 是否启用 */
+        this._enabled = true;
+    }
+    /** 获取是否启用 */
+    get enabled() {
+        return this._enabled;
+    }
+    /** 设置是否启用 */
+    set enabled(value) {
+        if (this._enabled !== value) {
+            this._enabled = value;
+            if (this._enabled) {
+                this.onEnabled();
+            }
+            else {
+                this.onDisabled();
+            }
+        }
+    }
+    /**
+     * 当组件启用时调用
+     */
+    onEnabled() {
+    }
+    /**
+     * 当组件禁用时调用
+     */
+    onDisabled() {
+    }
+    /**
+     * 当组件从场景中移除时调用
+     */
+    onRemovedFromScene() {
+    }
+    /**
+     * 每帧更新
+     */
+    update() {
+    }
+    /**
+     * 比较组件的更新顺序
+     * @param other 其他组件
+     * @returns 比较结果
+     */
+    compare(other) {
+        return this.updateOrder - other.updateOrder;
+    }
+}
+//# sourceMappingURL=SceneComponent.js.map

package/bin/ECS/Components/SceneComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneComponent.js","sourceRoot":"","sources":["../../../src/ECS/Components/SceneComponent.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,cAAc;IAA3B;QAGI,WAAW;QACJ,gBAAW,GAAW,CAAC,CAAC;QAC/B,WAAW;QACH,aAAQ,GAAY,IAAI,CAAC;IAmDrC,CAAC;IAjDG,aAAa;IACb,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,aAAa;IACb,IAAW,OAAO,CAAC,KAAc;QAC7B,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,IAAI,CAAC,SAAS,EAAE,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,UAAU,EAAE,CAAC;YACtB,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACI,SAAS;IAChB,CAAC;IAED;;OAEG;IACI,UAAU;IACjB,CAAC;IAED;;OAEG;IACI,kBAAkB;IACzB,CAAC;IAED;;OAEG;IACI,MAAM;IACb,CAAC;IAED;;;;OAIG;IACI,OAAO,CAAC,KAAqB;QAChC,OAAO,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAChD,CAAC;CACJ"}