@esengine/ecs-framework 2.3.0 → 2.3.1

package/bin/ECS/World.js

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

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

package/bin/ECS/WorldManager.d.ts

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

@@ -1 +0,0 @@
-{"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"}