@esengine/ecs-framework 2.3.0 → 2.3.1

package/dist/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@esengine/ecs-framework",
+  "version": "2.3.1",
+  "description": "用于Laya、Cocos Creator等JavaScript游戏引擎的高性能ECS框架",
+  "main": "index.cjs",
+  "module": "index.mjs",
+  "unpkg": "index.umd.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./index.mjs",
+      "require": "./index.cjs",
+      "types": "./index.d.ts"
+    }
+  },
+  "files": [
+    "index.mjs",
+    "index.mjs.map",
+    "index.cjs",
+    "index.cjs.map",
+    "index.umd.js",
+    "index.umd.js.map",
+    "index.es5.js",
+    "index.es5.js.map",
+    "index.d.ts"
+  ],
+  "keywords": [
+    "ecs",
+    "entity-component-system",
+    "game-engine",
+    "typescript",
+    "cocos-creator",
+    "laya",
+    "rollup"
+  ],
+  "author": "yhh",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/esengine/ecs-framework.git",
+    "directory": "packages/core"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "sideEffects": false
+}

package/package.json

@@ -1,84 +1,87 @@
-{
-  "name": "@esengine/ecs-framework",
-  "version": "2.3.0",
-  "description": "用于Laya、Cocos Creator等JavaScript游戏引擎的高性能ECS框架",
-  "main": "bin/index.js",
-  "types": "bin/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./bin/index.d.ts",
-      "import": "./bin/index.js",
-      "development": {
-        "types": "./src/index.ts",
-        "import": "./src/index.ts"
-      }
-    }
-  },
-  "files": [
-    "bin/**/*"
-  ],
-  "keywords": [
-    "ecs",
-    "entity-component-system",
-    "game-engine",
-    "typescript",
-    "laya",
-    "cocos",
-    "egret"
-  ],
-  "scripts": {
-    "clean": "rimraf bin dist tsconfig.tsbuildinfo",
-    "build:ts": "tsc",
-    "prebuild": "npm run clean",
-    "build": "npm run build:ts && node build-rollup.cjs",
-    "build:watch": "tsc --watch",
-    "rebuild": "npm run clean && npm run build",
-    "build:npm": "npm run build",
-    "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",
-    "type-check": "npx tsc --noEmit",
-    "lint": "eslint \"src/**/*.{ts,tsx}\"",
-    "lint:fix": "eslint \"src/**/*.{ts,tsx}\" --fix"
-  },
-  "author": "yhh",
-  "license": "MIT",
-  "devDependencies": {
-    "@babel/core": "^7.28.3",
-    "@babel/plugin-transform-nullish-coalescing-operator": "^7.27.1",
-    "@babel/plugin-transform-optional-chaining": "^7.27.1",
-    "@babel/preset-env": "^7.28.3",
-    "@rollup/plugin-babel": "^6.0.4",
-    "@rollup/plugin-commonjs": "^28.0.3",
-    "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rollup/plugin-terser": "^0.4.4",
-    "@jest/globals": "^29.7.0",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^20.19.17",
-    "@eslint/js": "^9.37.0",
-    "eslint": "^9.37.0",
-    "typescript-eslint": "^8.46.1",
-    "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"
-  },
-  "dependencies": {
-    "tslib": "^2.8.1"
-  }
-}
+{
+  "name": "@esengine/ecs-framework",
+  "version": "2.3.1",
+  "description": "用于Laya、Cocos Creator等JavaScript游戏引擎的高性能ECS框架",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "unpkg": "dist/index.umd.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "development": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts"
+      }
+    }
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "keywords": [
+    "ecs",
+    "entity-component-system",
+    "game-engine",
+    "typescript",
+    "laya",
+    "cocos",
+    "egret"
+  ],
+  "scripts": {
+    "clean": "rimraf bin dist tsconfig.tsbuildinfo",
+    "build:ts": "tsc",
+    "prebuild": "npm run clean",
+    "build": "npm run build:ts && node build-rollup.cjs",
+    "build:watch": "tsc --watch",
+    "rebuild": "npm run clean && npm run build",
+    "build:npm": "npm run build",
+    "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",
+    "type-check": "npx tsc --noEmit",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "lint:fix": "eslint \"src/**/*.{ts,tsx}\" --fix"
+  },
+  "author": "yhh",
+  "license": "MIT",
+  "devDependencies": {
+    "@babel/core": "^7.28.3",
+    "@babel/plugin-transform-nullish-coalescing-operator": "^7.27.1",
+    "@babel/plugin-transform-optional-chaining": "^7.27.1",
+    "@babel/preset-env": "^7.28.3",
+    "@rollup/plugin-babel": "^6.0.4",
+    "@rollup/plugin-commonjs": "^28.0.3",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@jest/globals": "^29.7.0",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.19.17",
+    "@eslint/js": "^9.37.0",
+    "eslint": "^9.37.0",
+    "typescript-eslint": "^8.46.1",
+    "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"
+  },
+  "dependencies": {
+    "tslib": "^2.8.1"
+  }
+}

package/bin/Core/DI/Decorators.d.ts

@@ -1,206 +0,0 @@
-/**
- * 依赖注入装饰器
- *
- * 提供 @Injectable、@InjectProperty 和 @Updatable 装饰器，用于标记可注入的类和依赖注入点
- */
-import type { ServiceContainer } from '../ServiceContainer';
-import type { IService, ServiceType } from '../ServiceContainer';
-/**
- * 依赖注入元数据存储
- */
-type Constructor = abstract new (...args: unknown[]) => unknown;
-/**
- * 可注入元数据接口
- */
-export interface InjectableMetadata {
-    /**
-     * 是否可注入
-     */
-    injectable: boolean;
-    /**
-     * 依赖列表
-     */
-    dependencies: Array<ServiceType<IService> | string | symbol>;
-    /**
-     * 属性注入映射
-     * key: 属性名, value: 服务类型
-     */
-    properties?: Map<string | symbol, ServiceType<IService>>;
-}
-/**
- * 可更新元数据接口
- */
-export interface UpdatableMetadata {
-    /**
-     * 是否可更新
-     */
-    updatable: boolean;
-    /**
-     * 更新优先级（数值越小越先执行，默认0）
-     */
-    priority: number;
-}
-/**
- * @Injectable() 装饰器
- *
- * 标记类为可注入的服务，使其可以通过ServiceContainer进行依赖注入
- *
- * @example
- * ```typescript
- * @Injectable()
- * class TimeService implements IService {
- *     constructor() {}
- *     dispose() {}
- * }
- *
- * @Injectable()
- * class PhysicsSystem extends EntitySystem {
- *     @InjectProperty(TimeService)
- *     private timeService!: TimeService;
- *
- *     constructor() {
- *         super(Matcher.empty());
- *     }
- * }
- * ```
- */
-export declare function Injectable(): ClassDecorator;
-/**
- * @Updatable() 装饰器
- *
- * 标记服务类为可更新的，使其在每帧自动被ServiceContainer调用update方法。
- * 使用此装饰器的类必须实现IUpdatable接口（包含update方法）。
- *
- * @param priority - 更新优先级（数值越小越先执行，默认0）
- * @throws 如果类没有实现update方法，将在运行时抛出错误
- *
- * @example
- * ```typescript
- * @Injectable()
- * @Updatable()
- * class TimerManager implements IService, IUpdatable {
- *     update(deltaTime?: number) {
- *         // 每帧更新逻辑
- *     }
- *     dispose() {}
- * }
- *
- * // 指定优先级
- * @Injectable()
- * @Updatable(10)
- * class PhysicsManager implements IService, IUpdatable {
- *     update() { }
- *     dispose() {}
- * }
- * ```
- */
-export declare function Updatable(priority?: number): ClassDecorator;
-/**
- * @InjectProperty() 装饰器
- *
- * 通过属性装饰器注入依赖
- *
- * 注入时机：在构造函数执行后、onInitialize() 调用前完成
- *
- * @param serviceType 服务类型
- *
- * @example
- * ```typescript
- * @Injectable()
- * class PhysicsSystem extends EntitySystem {
- *     @InjectProperty(TimeService)
- *     private timeService!: TimeService;
- *
- *     @InjectProperty(CollisionService)
- *     private collision!: CollisionService;
- *
- *     constructor() {
- *         super(Matcher.empty());
- *     }
- *
- *     public onInitialize(): void {
- *         // 此时属性已注入完成，可以安全使用
- *         console.log(this.timeService.getDeltaTime());
- *     }
- * }
- * ```
- */
-export declare function InjectProperty(serviceType: ServiceType<IService>): PropertyDecorator;
-/**
- * 检查类是否标记为可注入
- *
- * @param target 目标类
- * @returns 是否可注入
- */
-export declare function isInjectable(target: Constructor): boolean;
-/**
- * 获取类的依赖注入元数据
- *
- * @param target 目标类
- * @returns 依赖注入元数据
- */
-export declare function getInjectableMetadata(target: Constructor): InjectableMetadata | undefined;
-/**
- * 获取属性注入元数据
- *
- * @param target 目标类
- * @returns 属性名到服务类型的映射
- */
-export declare function getPropertyInjectMetadata(target: Constructor): Map<string | symbol, ServiceType<IService>>;
-/**
- * 创建实例并自动注入依赖
- *
- * @param constructor 构造函数
- * @param container 服务容器
- * @returns 创建的实例
- *
- * @example
- * ```typescript
- * const instance = createInstance(MySystem, container);
- * ```
- */
-export declare function createInstance<T>(constructor: new (...args: any[]) => T, container: ServiceContainer): T;
-/**
- * 为实例注入属性依赖
- *
- * @param instance 目标实例
- * @param container 服务容器
- */
-export declare function injectProperties<T extends object>(instance: T, container: ServiceContainer): void;
-/**
- * 检查类是否标记为可更新
- *
- * @param target 目标类
- * @returns 是否可更新
- */
-export declare function isUpdatable(target: Constructor): boolean;
-/**
- * 获取类的可更新元数据
- *
- * @param target 目标类
- * @returns 可更新元数据
- */
-export declare function getUpdatableMetadata(target: Constructor): UpdatableMetadata | undefined;
-/**
- * 注册可注入的服务到容器
- *
- * 自动检测@Injectable装饰器并注册服务
- *
- * @param container 服务容器
- * @param serviceType 服务类型
- * @param singleton 是否注册为单例（默认true）
- *
- * @example
- * ```typescript
- * @Injectable()
- * class MyService implements IService {
- *     dispose() {}
- * }
- *
- * // 自动注册
- * registerInjectable(Core.services, MyService);
- * ```
- */
-export declare function registerInjectable<T extends IService>(container: ServiceContainer, serviceType: ServiceType<T>, singleton?: boolean): void;
-export {};
-//# sourceMappingURL=Decorators.d.ts.map

package/bin/Core/DI/Decorators.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Decorators.d.ts","sourceRoot":"","sources":["../../../src/Core/DI/Decorators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;GAEG;AACH,KAAK,WAAW,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAKhE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAE7D;;;OAGG;IACH,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAU3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,SAAS,CAAC,QAAQ,GAAE,MAAU,GAAG,cAAc,CAiB9D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,iBAAiB,CAkBpF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAGzD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,kBAAkB,GAAG,SAAS,CAEzF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,CAG1G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC5B,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EACtC,SAAS,EAAE,gBAAgB,GAC5B,CAAC,CAQH;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAejG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAGxD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAEvF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,QAAQ,EACjD,SAAS,EAAE,gBAAgB,EAC3B,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,EAC3B,SAAS,GAAE,OAAc,GAC1B,IAAI,CAiBN"}

package/bin/Core/DI/Decorators.js

@@ -1,253 +0,0 @@
-/**
- * 依赖注入装饰器
- *
- * 提供 @Injectable、@InjectProperty 和 @Updatable 装饰器，用于标记可注入的类和依赖注入点
- */
-const injectableMetadata = new WeakMap();
-const updatableMetadata = new WeakMap();
-/**
- * @Injectable() 装饰器
- *
- * 标记类为可注入的服务，使其可以通过ServiceContainer进行依赖注入
- *
- * @example
- * ```typescript
- * @Injectable()
- * class TimeService implements IService {
- *     constructor() {}
- *     dispose() {}
- * }
- *
- * @Injectable()
- * class PhysicsSystem extends EntitySystem {
- *     @InjectProperty(TimeService)
- *     private timeService!: TimeService;
- *
- *     constructor() {
- *         super(Matcher.empty());
- *     }
- * }
- * ```
- */
-export function Injectable() {
-    return function (target) {
-        const existing = injectableMetadata.get(target);
-        injectableMetadata.set(target, {
-            injectable: true,
-            dependencies: [],
-            ...(existing?.properties && { properties: existing.properties })
-        });
-    };
-}
-/**
- * @Updatable() 装饰器
- *
- * 标记服务类为可更新的，使其在每帧自动被ServiceContainer调用update方法。
- * 使用此装饰器的类必须实现IUpdatable接口（包含update方法）。
- *
- * @param priority - 更新优先级（数值越小越先执行，默认0）
- * @throws 如果类没有实现update方法，将在运行时抛出错误
- *
- * @example
- * ```typescript
- * @Injectable()
- * @Updatable()
- * class TimerManager implements IService, IUpdatable {
- *     update(deltaTime?: number) {
- *         // 每帧更新逻辑
- *     }
- *     dispose() {}
- * }
- *
- * // 指定优先级
- * @Injectable()
- * @Updatable(10)
- * class PhysicsManager implements IService, IUpdatable {
- *     update() { }
- *     dispose() {}
- * }
- * ```
- */
-export function Updatable(priority = 0) {
-    return function (target) {
-        // 验证类原型上是否有update方法
-        const prototype = target.prototype;
-        if (!prototype || typeof prototype.update !== 'function') {
-            throw new Error(`@Updatable() decorator requires class ${target.name} to implement IUpdatable interface with update() method. ` +
-                'Please add \'implements IUpdatable\' and define update(deltaTime?: number): void method.');
-        }
-        // 标记为可更新
-        updatableMetadata.set(target, {
-            updatable: true,
-            priority
-        });
-    };
-}
-/**
- * @InjectProperty() 装饰器
- *
- * 通过属性装饰器注入依赖
- *
- * 注入时机：在构造函数执行后、onInitialize() 调用前完成
- *
- * @param serviceType 服务类型
- *
- * @example
- * ```typescript
- * @Injectable()
- * class PhysicsSystem extends EntitySystem {
- *     @InjectProperty(TimeService)
- *     private timeService!: TimeService;
- *
- *     @InjectProperty(CollisionService)
- *     private collision!: CollisionService;
- *
- *     constructor() {
- *         super(Matcher.empty());
- *     }
- *
- *     public onInitialize(): void {
- *         // 此时属性已注入完成，可以安全使用
- *         console.log(this.timeService.getDeltaTime());
- *     }
- * }
- * ```
- */
-export function InjectProperty(serviceType) {
-    return function (target, propertyKey) {
-        let metadata = injectableMetadata.get(target.constructor);
-        if (!metadata) {
-            metadata = {
-                injectable: true,
-                dependencies: []
-            };
-            injectableMetadata.set(target.constructor, metadata);
-        }
-        if (!metadata.properties) {
-            metadata.properties = new Map();
-        }
-        metadata.properties.set(propertyKey, serviceType);
-    };
-}
-/**
- * 检查类是否标记为可注入
- *
- * @param target 目标类
- * @returns 是否可注入
- */
-export function isInjectable(target) {
-    const metadata = injectableMetadata.get(target);
-    return metadata?.injectable ?? false;
-}
-/**
- * 获取类的依赖注入元数据
- *
- * @param target 目标类
- * @returns 依赖注入元数据
- */
-export function getInjectableMetadata(target) {
-    return injectableMetadata.get(target);
-}
-/**
- * 获取属性注入元数据
- *
- * @param target 目标类
- * @returns 属性名到服务类型的映射
- */
-export function getPropertyInjectMetadata(target) {
-    const metadata = injectableMetadata.get(target);
-    return metadata?.properties || new Map();
-}
-/**
- * 创建实例并自动注入依赖
- *
- * @param constructor 构造函数
- * @param container 服务容器
- * @returns 创建的实例
- *
- * @example
- * ```typescript
- * const instance = createInstance(MySystem, container);
- * ```
- */
-export function createInstance(constructor, container) {
-    // 创建实例（无参数注入）
-    const instance = new constructor();
-    // 注入属性依赖
-    injectProperties(instance, container);
-    return instance;
-}
-/**
- * 为实例注入属性依赖
- *
- * @param instance 目标实例
- * @param container 服务容器
- */
-export function injectProperties(instance, container) {
-    const constructor = instance.constructor;
-    const metadata = getInjectableMetadata(constructor);
-    if (!metadata?.properties || metadata.properties.size === 0) {
-        return;
-    }
-    for (const [propertyKey, serviceType] of metadata.properties) {
-        const service = container.resolve(serviceType);
-        if (service !== null) {
-            instance[propertyKey] = service;
-        }
-    }
-}
-/**
- * 检查类是否标记为可更新
- *
- * @param target 目标类
- * @returns 是否可更新
- */
-export function isUpdatable(target) {
-    const metadata = updatableMetadata.get(target);
-    return metadata?.updatable ?? false;
-}
-/**
- * 获取类的可更新元数据
- *
- * @param target 目标类
- * @returns 可更新元数据
- */
-export function getUpdatableMetadata(target) {
-    return updatableMetadata.get(target);
-}
-/**
- * 注册可注入的服务到容器
- *
- * 自动检测@Injectable装饰器并注册服务
- *
- * @param container 服务容器
- * @param serviceType 服务类型
- * @param singleton 是否注册为单例（默认true）
- *
- * @example
- * ```typescript
- * @Injectable()
- * class MyService implements IService {
- *     dispose() {}
- * }
- *
- * // 自动注册
- * registerInjectable(Core.services, MyService);
- * ```
- */
-export function registerInjectable(container, serviceType, singleton = true) {
-    if (!isInjectable(serviceType)) {
-        throw new Error(`${serviceType.name} is not marked as @Injectable(). ` +
-            'Please add @Injectable() decorator to the class.');
-    }
-    // 创建工厂函数，使用createInstance自动解析依赖
-    const factory = (c) => createInstance(serviceType, c);
-    // 注册到容器
-    if (singleton) {
-        container.registerSingleton(serviceType, factory);
-    }
-    else {
-        container.registerTransient(serviceType, factory);
-    }
-}
-//# sourceMappingURL=Decorators.js.map