@codehz/ecs 0.3.0 → 0.3.2

package/README.md

@@ -60,18 +60,22 @@ ECS 支持在组件添加或移除时执行回调函数：
 
 ```typescript
 // 注册组件生命周期钩子
-world.registerLifecycleHook(PositionId, {
-  onAdded: (entityId, componentType, component) => {
+world.hook(PositionId, {
+  on_init: (entityId, componentType, component) => {
+    // 当钩子注册时，为现有实体上的组件调用
+    console.log(`现有组件 ${componentType} 在实体 ${entityId}`);
+  },
+  on_set: (entityId, componentType, component) => {
     console.log(`组件 ${componentType} 被添加到实体 ${entityId}`);
   },
-  onRemoved: (entityId, componentType) => {
+  on_remove: (entityId, componentType, component) => {
     console.log(`组件 ${componentType} 被从实体 ${entityId} 移除`);
   },
 });
 
 // 你也可以只注册其中一个钩子
-world.registerLifecycleHook(VelocityId, {
-  onRemoved: (entityId, componentType) => {
+world.hook(VelocityId, {
+  on_remove: (entityId, componentType, component) => {
     console.log(`组件 ${componentType} 被从实体 ${entityId} 移除`);
   },
 });
@@ -104,11 +108,11 @@ const entity = world.new();
 const wildcardPositionRelation = relation(PositionId, "*");
 
 // 注册通配符关系钩子
-world.registerLifecycleHook(wildcardPositionRelation, {
-  onAdded: (entityId, componentType, component) => {
+world.hook(wildcardPositionRelation, {
+  on_set: (entityId, componentType, component) => {
     console.log(`关系组件 ${componentType} 被添加到实体 ${entityId}`);
   },
-  onRemoved: (entityId, componentType) => {
+  on_remove: (entityId, componentType, component) => {
     console.log(`关系组件 ${componentType} 被从实体 ${entityId} 移除`);
   },
 });
@@ -177,8 +181,8 @@ bun run examples/simple/demo.ts
 - `setExclusive(componentId)`: 将组件标记为独占关系
 - `createQuery(componentIds)`: 创建查询
 - `registerSystem(system, dependencies?)`: 注册系统
-- `registerLifecycleHook(componentId, hook)`: 注册组件或通配符关系生命周期钩子
-- `unregisterLifecycleHook(componentId, hook)`: 注销组件或通配符关系生命周期钩子
+- `hook(componentId, hook)`: 注册组件或通配符关系生命周期钩子
+- `unhook(componentId, hook)`: 注销组件或通配符关系生命周期钩子
 - `update(...params)`: 更新世界（参数取决于泛型配置）
 - `sync()`: 应用命令缓冲区
 

package/command-buffer.d.ts

@@ -26,11 +26,11 @@ export declare class CommandBuffer {
     /**
      * Remove a component from an entity (deferred)
      */
-    delete<T>(entityId: EntityId, componentType: EntityId<T>): void;
+    remove<T>(entityId: EntityId, componentType: EntityId<T>): void;
     /**
      * Destroy an entity (deferred)
      */
-    destroy(entityId: EntityId): void;
+    delete(entityId: EntityId): void;
     /**
      * Execute all commands and clear the buffer
      */

package/index.js

@@ -558,10 +558,10 @@ class CommandBuffer {
   set(entityId, componentType, component2) {
     this.commands.push({ type: "set", entityId, componentType, component: component2 });
   }
-  delete(entityId, componentType) {
+  remove(entityId, componentType) {
     this.commands.push({ type: "delete", entityId, componentType });
   }
-  destroy(entityId) {
+  delete(entityId) {
     this.commands.push({ type: "destroy", entityId });
   }
   execute() {
@@ -698,6 +698,14 @@ class Query {
       this.cachedArchetypes.push(archetype);
     }
   }
+  removeArchetype(archetype) {
+    if (this.isDisposed)
+      return;
+    const index = this.cachedArchetypes.indexOf(archetype);
+    if (index !== -1) {
+      this.cachedArchetypes.splice(index, 1);
+    }
+  }
   dispose() {
     this.world.releaseQuery(this);
   }
@@ -929,10 +937,10 @@ class World {
     if (detailedType.type === "invalid") {
       throw new Error(`Invalid component type: ${componentType}`);
     }
-    this.commandBuffer.delete(entityId, componentType);
+    this.commandBuffer.remove(entityId, componentType);
   }
   delete(entityId) {
-    this.commandBuffer.destroy(entityId);
+    this.commandBuffer.delete(entityId);
   }
   has(entityId, componentType) {
     const archetype = this.entityToArchetype.get(entityId);
@@ -1242,6 +1250,9 @@ class World {
         }
       }
     }
+    for (const query of this.queries) {
+      query.removeArchetype(archetype);
+    }
   }
   triggerLifecycleHooks(entityId, addedComponents, removedComponents) {
     for (const [componentType, component2] of addedComponents) {

package/package.json

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

package/query.d.ts

@@ -47,6 +47,10 @@ export declare class Query {
      * Check if a new archetype matches this query and add to cache if it does
      */
     checkNewArchetype(archetype: Archetype): void;
+    /**
+     * Remove an archetype from the cached archetypes
+     */
+    removeArchetype(archetype: Archetype): void;
     /**
      * Dispose the query and disconnect from world
      */