@esengine/ecs-framework 2.1.28 → 2.1.30

package/bin/Core.d.ts

@@ -0,0 +1,279 @@
+import { GlobalManager } from './Utils/GlobalManager';
+import { TimerManager } from './Utils/Timers/TimerManager';
+import { ITimer } from './Utils/Timers/ITimer';
+import { Timer } from './Utils/Timers/Timer';
+import { PerformanceMonitor } from './Utils/PerformanceMonitor';
+import { PoolManager } from './Utils/Pool/PoolManager';
+import { ECSFluentAPI } from './ECS/Core/FluentAPI';
+import { Scene } from './ECS/Scene';
+import { DebugManager } from './Utils/Debug';
+import { ICoreConfig, IECSDebugConfig } from './Types';
+import { EnvironmentInfo } from './ECS/Utils/BigIntCompatibility';
+/**
+ * 游戏引擎核心类
+ *
+ * 负责管理游戏的生命周期、场景切换、全局管理器和定时器系统。
+ * 提供统一的游戏循环管理。
+ *
+ * @example
+ * ```typescript
+ * // 创建核心实例
+ * const core = Core.create(true);
+ *
+ * // 设置场景
+ * Core.scene = new MyScene();
+ *
+ * // 在游戏循环中更新（Laya引擎示例）
+ * Laya.timer.frameLoop(1, this, () => {
+ *     const deltaTime = Laya.timer.delta / 1000;
+ *     Core.update(deltaTime);
+ * });
+ *
+ * // 调度定时器
+ * Core.schedule(1.0, false, null, (timer) => {
+ *     Core._logger.info("1秒后执行");
+ * });
+ * ```
+ */
+export declare class Core {
+    /**
+     * 游戏暂停状态
+     *
+     * 当设置为true时，游戏循环将暂停执行。
+     */
+    static paused: boolean;
+    /**
+     * 全局核心实例
+     */
+    private static _instance;
+    /**
+     * Core专用日志器
+     */
+    private static _logger;
+    /**
+     * 实体系统启用状态
+     *
+     * 控制是否启用ECS实体系统功能。
+     */
+    static entitySystemsEnabled: boolean;
+    /**
+     * 调试模式标志
+     *
+     * 在调试模式下会启用额外的性能监控和错误检查。
+     */
+    readonly debug: boolean;
+    /**
+     * 待切换的场景
+     *
+     * 存储下一帧要切换到的场景实例。
+     */
+    _nextScene: Scene | null;
+    /**
+     * 全局管理器集合
+     *
+     * 存储所有注册的全局管理器实例。
+     */
+    _globalManagers: GlobalManager[];
+    /**
+     * 定时器管理器
+     *
+     * 负责管理所有的游戏定时器。
+     */
+    _timerManager: TimerManager;
+    /**
+     * 性能监控器
+     *
+     * 监控游戏性能并提供优化建议。
+     */
+    _performanceMonitor: PerformanceMonitor;
+    /**
+     * 对象池管理器
+     *
+     * 管理所有对象池的生命周期。
+     */
+    _poolManager: PoolManager;
+    /**
+     * ECS流式API
+     *
+     * 提供便捷的ECS操作接口。
+     */
+    _ecsAPI?: ECSFluentAPI;
+    /**
+     * 当前活动场景
+     */
+    _scene?: Scene;
+    /**
+     * 调试管理器
+     *
+     * 负责收集和发送调试数据。
+     */
+    _debugManager?: DebugManager;
+    /**
+     * Core配置
+     */
+    private _config;
+    /**
+     * 兼容性信息
+     */
+    private _environmentInfo;
+    /**
+     * 创建核心实例
+     *
+     * @param config - Core配置对象
+     */
+    private constructor();
+    /**
+     * 获取核心实例
+     *
+     * @returns 全局核心实例
+     */
+    static get Instance(): Core;
+    /**
+     * 获取当前活动的场景
+     *
+     * @returns 当前场景实例，如果没有则返回null
+     */
+    static get scene(): Scene | null;
+    /**
+     * 设置当前活动的场景
+     *
+     * 如果当前没有场景，会立即切换；否则会在下一帧切换。
+     *
+     * @param value - 要设置的场景实例
+     * @throws {Error} 当场景为空时抛出错误
+     */
+    static set scene(value: Scene | null);
+    /**
+     * 创建Core实例
+     *
+     * 如果实例已存在，则返回现有实例。
+     *
+     * @param config - Core配置，也可以直接传入boolean表示debug模式（向后兼容）
+     * @returns Core实例
+     */
+    static create(config?: ICoreConfig | boolean): Core;
+    /**
+     * 更新游戏逻辑
+     *
+     * 此方法应该在游戏引擎的更新循环中调用。
+     *
+     * @param deltaTime - 外部引擎提供的帧时间间隔（秒）
+     *
+     * @example
+     * ```typescript
+     * // Laya引擎
+     * Laya.timer.frameLoop(1, this, () => {
+     *     const deltaTime = Laya.timer.delta / 1000;
+     *     Core.update(deltaTime);
+     * });
+     *
+     * // Cocos Creator
+     * update(deltaTime: number) {
+     *     Core.update(deltaTime);
+     * }
+     *
+
+     * ```
+     */
+    static update(deltaTime: number): void;
+    /**
+     * 注册全局管理器
+     *
+     * 将管理器添加到全局管理器列表中，并启用它。
+     *
+     * @param manager - 要注册的全局管理器
+     */
+    static registerGlobalManager(manager: GlobalManager): void;
+    /**
+     * 注销全局管理器
+     *
+     * 从全局管理器列表中移除管理器，并禁用它。
+     *
+     * @param manager - 要注销的全局管理器
+     */
+    static unregisterGlobalManager(manager: GlobalManager): void;
+    /**
+     * 获取指定类型的全局管理器
+     *
+     * @param type - 管理器类型构造函数
+     * @returns 管理器实例，如果未找到则返回null
+     */
+    static getGlobalManager<T extends GlobalManager>(type: new (...args: unknown[]) => T): T | null;
+    /**
+     * 调度定时器
+     *
+     * 创建一个定时器，在指定时间后执行回调函数。
+     *
+     * @param timeInSeconds - 延迟时间（秒）
+     * @param repeats - 是否重复执行，默认为false
+     * @param context - 回调函数的上下文，默认为null
+     * @param onTime - 定时器触发时的回调函数
+     * @returns 创建的定时器实例
+     */
+    static schedule<TContext = unknown>(timeInSeconds: number, repeats: boolean | undefined, context: TContext | undefined, onTime: (timer: ITimer<TContext>) => void): Timer<TContext>;
+    /**
+     * 获取ECS流式API
+     *
+     * @returns ECS API实例，如果未初始化则返回null
+     */
+    static get ecsAPI(): ECSFluentAPI | null;
+    /**
+     * 启用调试功能
+     *
+     * @param config 调试配置
+     */
+    static enableDebug(config: IECSDebugConfig): void;
+    /**
+     * 禁用调试功能
+     */
+    static disableDebug(): void;
+    /**
+     * 获取调试数据
+     *
+     * @returns 当前调试数据，如果调试未启用则返回null
+     */
+    static getDebugData(): any;
+    /**
+     * 检查调试是否启用
+     *
+     * @returns 调试状态
+     */
+    static get isDebugEnabled(): boolean;
+    /**
+     * 获取环境兼容性信息
+     *
+     * @returns 环境兼容性信息
+     */
+    static getEnvironmentInfo(): EnvironmentInfo | null;
+    /**
+     * 检查BigInt是否支持
+     *
+     * @returns 是否支持BigInt
+     */
+    static get supportsBigInt(): boolean;
+    /**
+     * 场景切换回调
+     *
+     * 在场景切换时调用，用于重置时间系统等。
+     */
+    onSceneChanged(): void;
+    /**
+     * 初始化核心系统
+     *
+     * 执行核心系统的初始化逻辑。
+     */
+    protected initialize(): void;
+    /**
+     * 记录兼容性信息
+     *
+     * 在控制台输出当前环境的兼容性信息和建议。
+     */
+    private logCompatibilityInfo;
+    /**
+     * 内部更新方法
+     *
+     * @param deltaTime - 帧时间间隔（秒）
+     */
+    private updateInternal;
+}
+//# sourceMappingURL=Core.d.ts.map

package/bin/Core.d.ts.map

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

package/bin/Core.js

@@ -0,0 +1,400 @@
+import { TimerManager } from './Utils/Timers/TimerManager';
+import { Time } from './Utils/Time';
+import { PerformanceMonitor } from './Utils/PerformanceMonitor';
+import { PoolManager } from './Utils/Pool/PoolManager';
+import { createECSAPI } from './ECS/Core/FluentAPI';
+import { DebugManager } from './Utils/Debug';
+import { BigIntFactory } from './ECS/Utils/BigIntCompatibility';
+import { createLogger } from './Utils/Logger';
+/**
+ * 游戏引擎核心类
+ *
+ * 负责管理游戏的生命周期、场景切换、全局管理器和定时器系统。
+ * 提供统一的游戏循环管理。
+ *
+ * @example
+ * ```typescript
+ * // 创建核心实例
+ * const core = Core.create(true);
+ *
+ * // 设置场景
+ * Core.scene = new MyScene();
+ *
+ * // 在游戏循环中更新（Laya引擎示例）
+ * Laya.timer.frameLoop(1, this, () => {
+ *     const deltaTime = Laya.timer.delta / 1000;
+ *     Core.update(deltaTime);
+ * });
+ *
+ * // 调度定时器
+ * Core.schedule(1.0, false, null, (timer) => {
+ *     Core._logger.info("1秒后执行");
+ * });
+ * ```
+ */
+export class Core {
+    /**
+     * 创建核心实例
+     *
+     * @param config - Core配置对象
+     */
+    constructor(config = {}) {
+        /**
+         * 待切换的场景
+         *
+         * 存储下一帧要切换到的场景实例。
+         */
+        this._nextScene = null;
+        /**
+         * 全局管理器集合
+         *
+         * 存储所有注册的全局管理器实例。
+         */
+        this._globalManagers = [];
+        Core._instance = this;
+        // 保存配置
+        this._config = {
+            debug: true,
+            enableEntitySystems: true,
+            ...config
+        };
+        // 检测环境兼容性
+        this._environmentInfo = BigIntFactory.getEnvironmentInfo();
+        // 初始化管理器
+        this._timerManager = new TimerManager();
+        Core.registerGlobalManager(this._timerManager);
+        // 初始化性能监控器
+        this._performanceMonitor = PerformanceMonitor.instance;
+        // 在调试模式下启用性能监控
+        if (this._config.debug) {
+            this._performanceMonitor.enable();
+        }
+        // 初始化对象池管理器
+        this._poolManager = PoolManager.getInstance();
+        Core.entitySystemsEnabled = this._config.enableEntitySystems ?? true;
+        this.debug = this._config.debug ?? true;
+        // 初始化调试管理器
+        if (this._config.debugConfig?.enabled) {
+            this._debugManager = new DebugManager(this, this._config.debugConfig);
+        }
+        // 在调试模式下显示兼容性信息
+        if (this._config.debug) {
+            this.logCompatibilityInfo();
+        }
+        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 config - Core配置，也可以直接传入boolean表示debug模式（向后兼容）
+     * @returns Core实例
+     */
+    static create(config = true) {
+        if (this._instance == null) {
+            // 向后兼容：如果传入boolean，转换为配置对象
+            const coreConfig = typeof config === 'boolean'
+                ? { debug: config, enableEntitySystems: true }
+                : config;
+            this._instance = new Core(coreConfig);
+        }
+        return this._instance;
+    }
+    /**
+     * 更新游戏逻辑
+     *
+     * 此方法应该在游戏引擎的更新循环中调用。
+     *
+     * @param deltaTime - 外部引擎提供的帧时间间隔（秒）
+     *
+     * @example
+     * ```typescript
+     * // Laya引擎
+     * Laya.timer.frameLoop(1, this, () => {
+     *     const deltaTime = Laya.timer.delta / 1000;
+     *     Core.update(deltaTime);
+     * });
+     *
+     * // Cocos Creator
+     * update(deltaTime: number) {
+     *     Core.update(deltaTime);
+     * }
+     *
+
+     * ```
+     */
+    static update(deltaTime) {
+        if (!this._instance) {
+            Core._logger.warn("Core实例未创建，请先调用Core.create()");
+            return;
+        }
+        this._instance.updateInternal(deltaTime);
+    }
+    /**
+     * 注册全局管理器
+     *
+     * 将管理器添加到全局管理器列表中，并启用它。
+     *
+     * @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() {
+        return this._instance?._ecsAPI || null;
+    }
+    /**
+     * 启用调试功能
+     *
+     * @param config 调试配置
+     */
+    static enableDebug(config) {
+        if (!this._instance) {
+            Core._logger.warn("Core实例未创建，请先调用Core.create()");
+            return;
+        }
+        if (this._instance._debugManager) {
+            this._instance._debugManager.updateConfig(config);
+        }
+        else {
+            this._instance._debugManager = new DebugManager(this._instance, config);
+        }
+        // 更新Core配置
+        this._instance._config.debugConfig = config;
+    }
+    /**
+     * 禁用调试功能
+     */
+    static disableDebug() {
+        if (!this._instance)
+            return;
+        if (this._instance._debugManager) {
+            this._instance._debugManager.stop();
+            this._instance._debugManager = undefined;
+        }
+        // 更新Core配置
+        if (this._instance._config.debugConfig) {
+            this._instance._config.debugConfig.enabled = false;
+        }
+    }
+    /**
+     * 获取调试数据
+     *
+     * @returns 当前调试数据，如果调试未启用则返回null
+     */
+    static getDebugData() {
+        if (!this._instance?._debugManager) {
+            return null;
+        }
+        return this._instance._debugManager.getDebugData();
+    }
+    /**
+     * 检查调试是否启用
+     *
+     * @returns 调试状态
+     */
+    static get isDebugEnabled() {
+        return this._instance?._config.debugConfig?.enabled || false;
+    }
+    /**
+     * 获取环境兼容性信息
+     *
+     * @returns 环境兼容性信息
+     */
+    static getEnvironmentInfo() {
+        return this._instance?._environmentInfo || null;
+    }
+    /**
+     * 检查BigInt是否支持
+     *
+     * @returns 是否支持BigInt
+     */
+    static get supportsBigInt() {
+        return this._instance?._environmentInfo.supportsBigInt || false;
+    }
+    /**
+     * 场景切换回调
+     *
+     * 在场景切换时调用，用于重置时间系统等。
+     */
+    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);
+        }
+        // 通知调试管理器场景已变更
+        if (this._debugManager) {
+            this._debugManager.onSceneChanged();
+        }
+    }
+    /**
+     * 初始化核心系统
+     *
+     * 执行核心系统的初始化逻辑。
+     */
+    initialize() {
+        // 核心系统初始化
+    }
+    /**
+     * 记录兼容性信息
+     *
+     * 在控制台输出当前环境的兼容性信息和建议。
+     */
+    logCompatibilityInfo() {
+        const info = this._environmentInfo;
+        Core._logger.info('ECS Framework 兼容性检测结果:');
+        Core._logger.info(`   环境: ${info.environment}`);
+        Core._logger.info(`   JavaScript引擎: ${info.jsEngine}`);
+        Core._logger.info(`   BigInt支持: ${info.supportsBigInt ? '支持' : '不支持'}`);
+        if (!info.supportsBigInt) {
+            Core._logger.warn('BigInt兼容模式已启用');
+        }
+    }
+    /**
+     * 内部更新方法
+     *
+     * @param deltaTime - 帧时间间隔（秒）
+     */
+    updateInternal(deltaTime) {
+        if (Core.paused)
+            return;
+        // 开始性能监控
+        const frameStartTime = this._performanceMonitor.startMonitoring('Core.update');
+        // 更新时间系统
+        Time.update(deltaTime);
+        // 更新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 = this._scene.entities?.count || 0;
+            this._performanceMonitor.endMonitoring('Scene.update', sceneStartTime, entityCount);
+        }
+        // 更新调试管理器（基于FPS的数据发送）
+        if (this._debugManager) {
+            this._debugManager.onFrameUpdate(deltaTime);
+        }
+        // 结束性能监控
+        this._performanceMonitor.endMonitoring('Core.update', frameStartTime);
+    }
+}
+/**
+ * 游戏暂停状态
+ *
+ * 当设置为true时，游戏循环将暂停执行。
+ */
+Core.paused = false;
+/**
+ * Core专用日志器
+ */
+Core._logger = createLogger('Core');
+//# 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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"}