@esengine/ecs-framework 2.1.30 → 2.1.31

package/package.json

@@ -1,73 +1,47 @@
 {
   "name": "@esengine/ecs-framework",
-  "version": "2.1.30",
+  "version": "2.1.31",
   "description": "用于Laya、Cocos Creator等JavaScript游戏引擎的高性能ECS框架",
-  "type": "module",
-  "main": "bin/index.js",
-  "types": "bin/index.d.ts",
+  "main": "index.cjs",
+  "module": "index.mjs",
+  "types": "index.d.ts",
   "exports": {
     ".": {
-      "types": "./bin/index.d.ts",
-      "import": "./bin/index.js",
-      "development": {
-        "types": "./src/index.ts",
-        "import": "./src/index.ts"
-      }
+      "import": "./index.mjs",
+      "require": "./index.cjs",
+      "types": "./index.d.ts"
     }
   },
   "files": [
-    "bin/**/*",
+    "index.mjs",
+    "index.mjs.map",
+    "index.cjs",
+    "index.cjs.map",
+    "index.d.ts",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "SECURITY.md",
+    "COCOS_USAGE.md",
+    ".npmignore"
   ],
   "keywords": [
     "ecs",
     "entity-component-system",
     "game-engine",
     "typescript",
+    "cocos-creator",
     "laya",
-    "cocos",
-    "egret"
+    "rollup"
   ],
-  "scripts": {
-    "clean": "rimraf bin dist",
-    "build:ts": "tsc",
-    "prebuild": "npm run clean",
-    "build": "npm run build:ts",
-    "build:watch": "tsc --watch",
-    "rebuild": "npm run clean && npm run build",
-    "build:npm": "npm run build && node build-rollup.cjs",
-    "preversion": "npm run rebuild",
-    "test": "jest --config jest.config.cjs",
-    "test:watch": "jest --watch --config jest.config.cjs",
-    "test:performance": "jest --config jest.performance.config.cjs",
-    "test:coverage": "jest --coverage --config jest.config.cjs",
-    "test:ci": "jest --ci --coverage --config jest.config.cjs",
-    "test:clear": "jest --clearCache"
-  },
   "author": "yhh",
   "license": "MIT",
-  "devDependencies": {
-    "@rollup/plugin-commonjs": "^28.0.3",
-    "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rollup/plugin-terser": "^0.4.4",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^20.19.0",
-    "jest": "^29.7.0",
-    "jest-environment-jsdom": "^29.7.0",
-    "rimraf": "^5.0.0",
-    "rollup": "^4.42.0",
-    "rollup-plugin-dts": "^6.2.1",
-    "ts-jest": "^29.4.0",
-    "typescript": "^5.8.3"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
   "repository": {
     "type": "git",
     "url": "https://github.com/esengine/ecs-framework.git",
     "directory": "packages/core"
-  }
-}
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "sideEffects": false
+}

package/bin/Core.d.ts

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

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