@codehz/ecs 0.0.7 → 0.0.10

package/README.md

@@ -177,7 +177,7 @@ bun run examples/simple/demo.ts
 - `registerSystem(system)`: 注册系统
 - `registerLifecycleHook(componentId, hook)`: 注册组件或通配符关系生命周期钩子
 - `unregisterLifecycleHook(componentId, hook)`: 注销组件或通配符关系生命周期钩子
-- `update(deltaTime)`: 更新世界
+- `update(...params)`: 更新世界（参数取决于泛型配置）
 - `flushCommands()`: 应用命令缓冲区
 
 ### Entity
@@ -196,19 +196,48 @@ bun run examples/simple/demo.ts
 
 ```typescript
 class MySystem implements System {
-  update(world: World, deltaTime: number): void {
+  update(): void {
     // 系统逻辑
   }
 }
 ```
 
-系统支持依赖关系排序，确保正确的执行顺序：
+如果需要接收额外参数（如时间增量），可以指定泛型参数：
 
 ```typescript
-// 注册系统时指定依赖
+class MovementSystem implements System<[deltaTime: number]> {
+  update(deltaTime: number): void {
+    // 使用 deltaTime 更新位置
+  }
+}
+```
+
+系统支持依赖关系排序，确保正确的执行顺序。依赖关系通过系统的 `dependencies` 属性指定：
+
+```typescript
+class InputSystem implements System<[deltaTime: number]> {
+  readonly dependencies: readonly System<[deltaTime: number]>[] = [];
+  update(deltaTime: number): void {
+    // 处理输入
+  }
+}
+
+class MovementSystem implements System<[deltaTime: number]> {
+  readonly dependencies: readonly System<[deltaTime: number]>[];
+
+  constructor(inputSystem: InputSystem) {
+    this.dependencies = [inputSystem]; // 指定依赖
+  }
+
+  update(deltaTime: number): void {
+    // 更新位置
+  }
+}
+
+// 注册系统
+const inputSystem = new InputSystem();
 world.registerSystem(inputSystem);
-world.registerSystem(movementSystem, [inputSystem]); // movementSystem 依赖 inputSystem
-world.registerSystem(renderSystem, [movementSystem]); // renderSystem 依赖 movementSystem
+world.registerSystem(new MovementSystem(inputSystem));
 ```
 
 系统将按照拓扑排序执行，依赖系统始终在被依赖系统之前运行。

package/entity.d.ts

@@ -47,7 +47,7 @@ export declare function createEntityId(id: number): EntityId;
 /**
  * Type for relation ID based on component and target types
  */
-type RelationIdType<T, R> = R extends ComponentId<infer U> ? U extends void ? ComponentRelationId<T> : ComponentRelationId<T & U> : R extends EntityId<any> ? EntityRelationId<T> : never;
+type RelationIdType<T, R> = R extends ComponentId<infer U> ? U extends void ? ComponentRelationId<T> : ComponentRelationId<T extends void ? U : T & U> : R extends EntityId<any> ? EntityRelationId<T> : never;
 /**
  * Create a relation ID by associating a component with another ID (entity or component)
  * @param componentId The component ID (0-1023)

package/index.js

@@ -773,7 +773,7 @@ class World {
   update(...params) {
     const systems = this.systemScheduler.getExecutionOrder();
     for (const system of systems) {
-      system.update(this, ...params);
+      system.update(...params);
     }
     this.commandBuffer.execute();
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codehz/ecs",
-  "version": "0.0.7",
+  "version": "0.0.10",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",

package/system-scheduler.d.ts

@@ -2,19 +2,19 @@ import type { System } from "./system";
 /**
  * System Scheduler for managing system dependencies and execution order
  */
-export declare class SystemScheduler<ExtraParams extends any[] = [deltaTime: number]> {
+export declare class SystemScheduler<UpdateParams extends any[] = [deltaTime: number]> {
     private systems;
     private cachedExecutionOrder;
     /**
      * Add a system with optional dependencies
      * @param system The system to add
      */
-    addSystem(system: System<ExtraParams>): void;
+    addSystem(system: System<UpdateParams>): void;
     /**
      * Get the execution order of systems based on dependencies
      * Uses topological sort
      */
-    getExecutionOrder(): System<ExtraParams>[];
+    getExecutionOrder(): System<UpdateParams>[];
     /**
      * Clear all systems and dependencies
      */

package/system.d.ts

@@ -1,14 +1,13 @@
-import type { World } from "./world";
 /**
  * Base System interface
  */
-export interface System<ExtraParams extends any[] = [deltaTime: number]> {
+export interface System<UpdateParams extends any[] = []> {
     /**
      * Update the system
      */
-    update(world: World<ExtraParams>, ...params: ExtraParams): void;
+    update(...params: UpdateParams): void;
     /**
      * Dependencies of this system (systems that must run before this one)
      */
-    readonly dependencies?: readonly System<ExtraParams>[];
+    readonly dependencies?: readonly System<UpdateParams>[];
 }

package/world.d.ts

@@ -10,7 +10,7 @@ import type { ComponentTuple, LifecycleHook } from "./types";
  * World class for ECS architecture
  * Manages entities, components, and systems
  */
-export declare class World<ExtraParams extends any[] = [deltaTime: number]> {
+export declare class World<UpdateParams extends any[] = []> {
     private entityIdManager;
     private archetypes;
     private archetypeMap;
@@ -85,7 +85,7 @@ export declare class World<ExtraParams extends any[] = [deltaTime: number]> {
     /**
      * Register a system with optional dependencies
      */
-    registerSystem(system: System<ExtraParams>): void;
+    registerSystem(system: System<UpdateParams>): void;
     /**
      * Register a lifecycle hook for component or wildcard relation events
      */
@@ -102,7 +102,7 @@ export declare class World<ExtraParams extends any[] = [deltaTime: number]> {
     /**
      * Update the world (run all systems in dependency order)
      */
-    update(...params: ExtraParams): void;
+    update(...params: UpdateParams): void;
     /**
      * Execute all deferred commands immediately without running systems
      */