@esengine/ecs-framework 2.2.21 → 2.3.0

package/bin/ECS/World.js

@@ -0,0 +1,416 @@
+import { Scene } from './Scene';
+import { createLogger } from '../Utils/Logger';
+import { PerformanceMonitor } from '../Utils/PerformanceMonitor';
+import { ServiceContainer } from '../Core/ServiceContainer';
+const logger = createLogger('World');
+/**
+ * World类 - ECS世界管理器
+ *
+ * World是Scene的容器，每个World可以管理多个Scene。
+ * World拥有独立的服务容器，用于管理World级别的全局服务。
+ *
+ * 服务容器层级：
+ * - Core.services: 应用程序全局服务
+ * - World.services: World级别服务（每个World独立）
+ * - Scene.services: Scene级别服务（每个Scene独立）
+ *
+ * 这种设计允许创建独立的游戏世界，如：
+ * - 游戏房间（每个房间一个World）
+ * - 不同的游戏模式
+ * - 独立的模拟环境
+ *
+ * @example
+ * ```typescript
+ * // 创建游戏房间的World
+ * const roomWorld = new World({ name: 'Room_001' });
+ *
+ * // 注册World级别的服务
+ * roomWorld.services.registerSingleton(RoomManager);
+ *
+ * // 在World中创建Scene
+ * const gameScene = roomWorld.createScene('game', new Scene());
+ * const uiScene = roomWorld.createScene('ui', new Scene());
+ *
+ * // 在Scene中使用World级别的服务
+ * const roomManager = roomWorld.services.resolve(RoomManager);
+ *
+ * // 更新整个World
+ * roomWorld.update(deltaTime);
+ * ```
+ */
+export class World {
+    constructor(config = {}) {
+        this._scenes = new Map();
+        this._activeScenes = new Set();
+        this._globalSystems = [];
+        this._isActive = false;
+        this._config = {
+            name: 'World',
+            debug: false,
+            maxScenes: 10,
+            autoCleanup: true,
+            ...config
+        };
+        this.name = this._config.name;
+        this._createdAt = Date.now();
+        this._services = new ServiceContainer();
+    }
+    /**
+     * World级别的服务容器
+     * 用于管理World范围内的全局服务
+     */
+    get services() {
+        return this._services;
+    }
+    /**
+     * 创建并添加Scene到World
+     */
+    createScene(sceneName, sceneInstance) {
+        if (!sceneName || typeof sceneName !== 'string' || sceneName.trim() === '') {
+            throw new Error('Scene name不能为空');
+        }
+        if (this._scenes.has(sceneName)) {
+            throw new Error(`Scene name '${sceneName}' 已存在于World '${this.name}' 中`);
+        }
+        if (this._scenes.size >= this._config.maxScenes) {
+            throw new Error(`World '${this.name}' 已达到最大Scene数量限制: ${this._config.maxScenes}`);
+        }
+        // 如果没有提供Scene实例，创建默认Scene
+        const scene = sceneInstance || new Scene();
+        // 如果配置了 debug，为 Scene 注册并启用 PerformanceMonitor
+        if (this._config.debug) {
+            const performanceMonitor = new PerformanceMonitor();
+            performanceMonitor.enable();
+            scene.services.registerInstance(PerformanceMonitor, performanceMonitor);
+        }
+        // 设置Scene的标识
+        if ('id' in scene) {
+            scene.id = sceneName;
+        }
+        if ('name' in scene && !scene.name) {
+            scene.name = sceneName;
+        }
+        this._scenes.set(sceneName, scene);
+        // 初始化Scene
+        scene.initialize();
+        return scene;
+    }
+    /**
+     * 移除Scene
+     */
+    removeScene(sceneName) {
+        const scene = this._scenes.get(sceneName);
+        if (!scene) {
+            return false;
+        }
+        // 如果Scene正在运行，先停止它
+        if (this._activeScenes.has(sceneName)) {
+            this.setSceneActive(sceneName, false);
+        }
+        // 清理Scene资源
+        scene.end();
+        this._scenes.delete(sceneName);
+        logger.info(`从World '${this.name}' 中移除Scene: ${sceneName}`);
+        return true;
+    }
+    /**
+     * 获取Scene
+     */
+    getScene(sceneName) {
+        return this._scenes.get(sceneName) || null;
+    }
+    /**
+     * 获取所有Scene ID
+     */
+    getSceneIds() {
+        return Array.from(this._scenes.keys());
+    }
+    /**
+     * 获取所有Scene
+     */
+    getAllScenes() {
+        return Array.from(this._scenes.values());
+    }
+    /**
+     * 移除所有Scene
+     */
+    removeAllScenes() {
+        const sceneNames = Array.from(this._scenes.keys());
+        for (const sceneName of sceneNames) {
+            this.removeScene(sceneName);
+        }
+        logger.info(`从World '${this.name}' 中移除所有Scene`);
+    }
+    /**
+     * 设置Scene激活状态
+     */
+    setSceneActive(sceneName, active) {
+        const scene = this._scenes.get(sceneName);
+        if (!scene) {
+            logger.warn(`Scene '${sceneName}' 不存在于World '${this.name}' 中`);
+            return;
+        }
+        if (active) {
+            this._activeScenes.add(sceneName);
+            // 启动Scene
+            if (scene.begin) {
+                scene.begin();
+            }
+            logger.debug(`在World '${this.name}' 中激活Scene: ${sceneName}`);
+        }
+        else {
+            this._activeScenes.delete(sceneName);
+            // 可选择性地停止Scene，或者让它继续运行但不更新
+            logger.debug(`在World '${this.name}' 中停用Scene: ${sceneName}`);
+        }
+    }
+    /**
+     * 检查Scene是否激活
+     */
+    isSceneActive(sceneName) {
+        return this._activeScenes.has(sceneName);
+    }
+    /**
+     * 获取活跃Scene数量
+     */
+    getActiveSceneCount() {
+        return this._activeScenes.size;
+    }
+    /**
+     * 添加全局System
+     * 全局System会在所有激活Scene之前更新
+     */
+    addGlobalSystem(system) {
+        if (this._globalSystems.includes(system)) {
+            return system;
+        }
+        this._globalSystems.push(system);
+        if (system.initialize) {
+            system.initialize();
+        }
+        logger.debug(`在World '${this.name}' 中添加全局System: ${system.name}`);
+        return system;
+    }
+    /**
+     * 移除全局System
+     */
+    removeGlobalSystem(system) {
+        const index = this._globalSystems.indexOf(system);
+        if (index === -1) {
+            return false;
+        }
+        this._globalSystems.splice(index, 1);
+        if (system.reset) {
+            system.reset();
+        }
+        logger.debug(`从World '${this.name}' 中移除全局System: ${system.name}`);
+        return true;
+    }
+    /**
+     * 获取全局System
+     */
+    getGlobalSystem(type) {
+        for (const system of this._globalSystems) {
+            if (system instanceof type) {
+                return system;
+            }
+        }
+        return null;
+    }
+    /**
+     * 启动World
+     */
+    start() {
+        if (this._isActive) {
+            return;
+        }
+        this._isActive = true;
+        // 启动所有全局System
+        for (const system of this._globalSystems) {
+            if (system.initialize) {
+                system.initialize();
+            }
+        }
+        logger.info(`启动World: ${this.name}`);
+    }
+    /**
+     * 停止World
+     */
+    stop() {
+        if (!this._isActive) {
+            return;
+        }
+        // 停止所有Scene
+        for (const sceneName of this._activeScenes) {
+            this.setSceneActive(sceneName, false);
+        }
+        // 重置所有全局System
+        for (const system of this._globalSystems) {
+            if (system.reset) {
+                system.reset();
+            }
+        }
+        this._isActive = false;
+        logger.info(`停止World: ${this.name}`);
+    }
+    /**
+     * 更新World中的全局System
+     * 注意：此方法由Core.update()调用，不应直接调用
+     */
+    updateGlobalSystems() {
+        if (!this._isActive) {
+            return;
+        }
+        // 更新全局System
+        for (const system of this._globalSystems) {
+            if (system.update) {
+                system.update();
+            }
+        }
+    }
+    /**
+     * 更新World中的所有激活Scene
+     * 注意：此方法由Core.update()调用，不应直接调用
+     */
+    updateScenes() {
+        if (!this._isActive) {
+            return;
+        }
+        // 更新所有激活的Scene
+        for (const sceneName of this._activeScenes) {
+            const scene = this._scenes.get(sceneName);
+            if (scene && scene.update) {
+                scene.update();
+            }
+        }
+        // 自动清理（如果启用）
+        if (this._config.autoCleanup && this.shouldAutoCleanup()) {
+            this.cleanup();
+        }
+    }
+    /**
+     * 销毁World
+     */
+    destroy() {
+        logger.info(`销毁World: ${this.name}`);
+        // 停止World
+        this.stop();
+        // 销毁所有Scene
+        const sceneNames = Array.from(this._scenes.keys());
+        for (const sceneName of sceneNames) {
+            this.removeScene(sceneName);
+        }
+        // 清理全局System
+        for (const system of this._globalSystems) {
+            if (system.destroy) {
+                system.destroy();
+            }
+            else if (system.reset) {
+                system.reset();
+            }
+        }
+        this._globalSystems.length = 0;
+        // 清空服务容器
+        this._services.clear();
+        this._scenes.clear();
+        this._activeScenes.clear();
+    }
+    /**
+     * 获取World状态
+     */
+    getStatus() {
+        return {
+            name: this.name,
+            isActive: this._isActive,
+            sceneCount: this._scenes.size,
+            activeSceneCount: this._activeScenes.size,
+            globalSystemCount: this._globalSystems.length,
+            createdAt: this._createdAt,
+            config: { ...this._config },
+            scenes: Array.from(this._scenes.keys()).map((sceneName) => ({
+                id: sceneName,
+                isActive: this._activeScenes.has(sceneName),
+                name: this._scenes.get(sceneName)?.name || sceneName
+            }))
+        };
+    }
+    /**
+     * 获取World统计信息
+     */
+    getStats() {
+        const stats = {
+            totalEntities: 0,
+            totalSystems: this._globalSystems.length,
+            memoryUsage: 0,
+            performance: {
+                averageUpdateTime: 0,
+                maxUpdateTime: 0
+            }
+        };
+        // 统计所有Scene的实体数量
+        for (const scene of this._scenes.values()) {
+            if (scene.entities) {
+                stats.totalEntities += scene.entities.count;
+            }
+            if (scene.systems) {
+                stats.totalSystems += scene.systems.length;
+            }
+        }
+        return stats;
+    }
+    /**
+     * 检查是否应该执行自动清理
+     */
+    shouldAutoCleanup() {
+        // 简单的清理策略：如果有空Scene且超过5分钟没有实体
+        const currentTime = Date.now();
+        const cleanupThreshold = 5 * 60 * 1000; // 5分钟
+        for (const [sceneName, scene] of this._scenes) {
+            if (!this._activeScenes.has(sceneName) &&
+                scene.entities &&
+                scene.entities.count === 0 &&
+                (currentTime - this._createdAt) > cleanupThreshold) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * 执行清理操作
+     */
+    cleanup() {
+        const sceneNames = Array.from(this._scenes.keys());
+        const currentTime = Date.now();
+        const cleanupThreshold = 5 * 60 * 1000; // 5分钟
+        for (const sceneName of sceneNames) {
+            const scene = this._scenes.get(sceneName);
+            if (scene &&
+                !this._activeScenes.has(sceneName) &&
+                scene.entities &&
+                scene.entities.count === 0 &&
+                (currentTime - this._createdAt) > cleanupThreshold) {
+                this.removeScene(sceneName);
+                logger.debug(`自动清理空Scene: ${sceneName} from World ${this.name}`);
+            }
+        }
+    }
+    /**
+     * 检查World是否激活
+     */
+    get isActive() {
+        return this._isActive;
+    }
+    /**
+     * 获取Scene数量
+     */
+    get sceneCount() {
+        return this._scenes.size;
+    }
+    /**
+     * 获取创建时间
+     */
+    get createdAt() {
+        return this._createdAt;
+    }
+}
+//# sourceMappingURL=World.js.map

package/bin/ECS/World.js.map

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

package/bin/ECS/WorldManager.d.ts

@@ -0,0 +1,224 @@
+import { World, IWorldConfig } from './World';
+import type { IService } from '../Core/ServiceContainer';
+/**
+ * WorldManager配置接口
+ */
+export interface IWorldManagerConfig {
+    /**
+     * 最大World数量
+     */
+    maxWorlds?: number;
+    /**
+     * 是否自动清理空World
+     */
+    autoCleanup?: boolean;
+    /**
+     * 清理间隔（帧数）
+     */
+    cleanupFrameInterval?: number;
+    /**
+     * 是否启用调试模式
+     */
+    debug?: boolean;
+}
+/**
+ * World管理器 - 管理所有World实例
+ *
+ * WorldManager负责管理多个独立的World实例。
+ * 每个World都是独立的ECS环境，可以包含多个Scene。
+ *
+ * 适用场景：
+ * - MMO游戏的多房间管理
+ * - 服务器端的多游戏实例
+ * - 需要完全隔离的多个游戏环境
+ *
+ * @example
+ * ```typescript
+ * // 创建WorldManager实例
+ * const worldManager = new WorldManager({
+ *     maxWorlds: 100,
+ *     autoCleanup: true
+ * });
+ *
+ * // 创建游戏房间World
+ * const room1 = worldManager.createWorld('room_001', {
+ *     name: 'GameRoom_001',
+ *     maxScenes: 5
+ * });
+ * room1.setActive(true);
+ *
+ * // 游戏循环
+ * function gameLoop(deltaTime: number) {
+ *     Core.update(deltaTime);
+ *     worldManager.updateAll();  // 更新所有活跃World
+ * }
+ * ```
+ */
+export declare class WorldManager implements IService {
+    private readonly _config;
+    private readonly _worlds;
+    private _isRunning;
+    private _framesSinceCleanup;
+    constructor(config?: IWorldManagerConfig);
+    /**
+     * 创建新World
+     */
+    createWorld(worldName: string, config?: IWorldConfig): World;
+    /**
+     * 移除World
+     */
+    removeWorld(worldName: string): boolean;
+    /**
+     * 获取World
+     */
+    getWorld(worldName: string): World | null;
+    /**
+     * 获取所有World ID
+     */
+    getWorldIds(): string[];
+    /**
+     * 获取所有World
+     */
+    getAllWorlds(): World[];
+    /**
+     * 设置World激活状态
+     */
+    setWorldActive(worldName: string, active: boolean): void;
+    /**
+     * 检查World是否激活
+     */
+    isWorldActive(worldName: string): boolean;
+    /**
+     * 更新所有活跃的World
+     *
+     * 应该在每帧的游戏循环中调用。
+     * 会自动更新所有活跃World的全局系统和场景。
+     *
+     * @example
+     * ```typescript
+     * function gameLoop(deltaTime: number) {
+     *     Core.update(deltaTime);      // 更新全局服务
+     *     worldManager.updateAll();    // 更新所有World
+     * }
+     * ```
+     */
+    updateAll(): void;
+    /**
+     * 获取所有激活的World
+     */
+    getActiveWorlds(): World[];
+    /**
+     * 启动所有World
+     */
+    startAll(): void;
+    /**
+     * 停止所有World
+     */
+    stopAll(): void;
+    /**
+     * 查找满足条件的World
+     */
+    findWorlds(predicate: (world: World) => boolean): World[];
+    /**
+     * 根据名称查找World
+     */
+    findWorldByName(name: string): World | null;
+    /**
+     * 获取WorldManager统计信息
+     */
+    getStats(): {
+        totalWorlds: number;
+        activeWorlds: number;
+        totalScenes: number;
+        totalEntities: number;
+        totalSystems: number;
+        memoryUsage: number;
+        isRunning: boolean;
+        config: {
+            maxWorlds: number;
+            autoCleanup: boolean;
+            cleanupFrameInterval: number;
+            debug: boolean;
+        };
+        worlds: any[];
+    };
+    /**
+     * 获取详细状态信息
+     */
+    getDetailedStatus(): {
+        worlds: {
+            id: string;
+            isActive: boolean;
+            status: {
+                name: string;
+                isActive: boolean;
+                sceneCount: number;
+                activeSceneCount: number;
+                globalSystemCount: number;
+                createdAt: number;
+                config: {
+                    name?: string;
+                    debug?: boolean;
+                    maxScenes?: number;
+                    autoCleanup?: boolean;
+                };
+                scenes: {
+                    id: string;
+                    isActive: boolean;
+                    name: string;
+                }[];
+            };
+        }[];
+        totalWorlds: number;
+        activeWorlds: number;
+        totalScenes: number;
+        totalEntities: number;
+        totalSystems: number;
+        memoryUsage: number;
+        isRunning: boolean;
+        config: {
+            maxWorlds: number;
+            autoCleanup: boolean;
+            cleanupFrameInterval: number;
+            debug: boolean;
+        };
+    };
+    /**
+     * 清理空World
+     */
+    cleanup(): number;
+    /**
+     * 销毁WorldManager
+     */
+    destroy(): void;
+    /**
+     * 实现 IService 接口的 dispose 方法
+     * 调用 destroy 方法进行清理
+     */
+    dispose(): void;
+    /**
+     * 判断World是否应该被清理
+     * 清理策略：
+     * 1. World未激活
+     * 2. 没有Scene或所有Scene都是空的
+     * 3. 创建时间超过10分钟
+     */
+    private shouldCleanupWorld;
+    /**
+     * 获取World总数
+     */
+    get worldCount(): number;
+    /**
+     * 获取激活World数量
+     */
+    get activeWorldCount(): number;
+    /**
+     * 检查是否正在运行
+     */
+    get isRunning(): boolean;
+    /**
+     * 获取配置
+     */
+    get config(): IWorldManagerConfig;
+}
+//# sourceMappingURL=WorldManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorldManager.d.ts","sourceRoot":"","sources":["../../src/ECS/WorldManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIzD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,YAAa,YAAW,QAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,mBAAmB,CAAa;gBAErB,MAAM,GAAE,mBAAwB;IAmBnD;;OAEG;IACI,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,KAAK;IA2BnE;;OAEG;IACI,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAc9C;;OAEG;IACI,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAIhD;;OAEG;IACI,WAAW,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACI,YAAY,IAAI,KAAK,EAAE;IAI9B;;OAEG;IACI,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAgB/D;;OAEG;IACI,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAKhD;;;;;;;;;;;;;OAaG;IACI,SAAS,IAAI,IAAI;IA4BxB;;OAEG;IACI,eAAe,IAAI,KAAK,EAAE;IAUjC;;OAEG;IACI,QAAQ,IAAI,IAAI;IAUvB;;OAEG;IACI,OAAO,IAAI,IAAI;IAUtB;;OAEG;IACI,UAAU,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,GAAG,KAAK,EAAE;IAUhE;;OAEG;IACI,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IASlD;;OAEG;IACI,QAAQ;;;;;;;;;uBAxRH,MAAM;yBAKJ,OAAO;kCAKE,MAAM;mBAKrB,OAAO;;gBAmRO,GAAG,EAAE;;IAqB3B;;OAEG;IACI,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA1TZ,MAAM;yBAKJ,OAAO;kCAKE,MAAM;mBAKrB,OAAO;;;IAsTf;;OAEG;IACI,OAAO,IAAI,MAAM;IAoBxB;;OAEG;IACI,OAAO,IAAI,IAAI;IAkBtB;;;OAGG;IACI,OAAO,IAAI,IAAI;IAItB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,MAAM,CAMpC;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,mBAAmB,CAEvC;CACJ"}