重构 Component基类违反ECS纯粹性问题

packages/core/src/ECS/Component.ts

@@ -1,21 +1,30 @@
 import type { IComponent } from '../Types';
-import type { Entity } from './Entity'; 
 
 /**
  * 游戏组件基类
- * 
- * ECS架构中的组件（Component），用于实现具体的游戏功能。
- * 组件包含数据和行为，可以被添加到实体上以扩展实体的功能。
- * 
+ *
+ * ECS架构中的组件（Component）应该是纯数据容器。
+ * 所有游戏逻辑应该在 EntitySystem 中实现，而不是在组件内部。
+ *
  * @example
+ * 推荐做法：纯数据组件
  * ```typescript
  * class HealthComponent extends Component {
  *     public health: number = 100;
- *     
- *     public takeDamage(damage: number): void {
- *         this.health -= damage;
- *         if (this.health <= 0) {
- *             this.entity.destroy();
+ *     public maxHealth: number = 100;
+ * }
+ * ```
+ *
+ * @example
+ * 推荐做法：在 System 中处理逻辑
+ * ```typescript
+ * class HealthSystem extends EntitySystem {
+ *     process(entities: Entity[]): void {
+ *         for (const entity of entities) {
+ *             const health = entity.getComponent(HealthComponent);
+ *             if (health && health.health <= 0) {
+ *                 entity.destroy();
+ *             }
  *         }
  *     }
  * }
@@ -24,141 +33,49 @@ import type { Entity } from './Entity';
 export abstract class Component implements IComponent {
     /**
      * 组件ID生成器
-     * 
+     *
      * 用于为每个组件分配唯一的ID。
      */
     public static _idGenerator: number = 0;
-    
+
     /**
      * 组件唯一标识符
-     * 
+     *
      * 在整个游戏生命周期中唯一的数字ID。
      */
     public readonly id: number;
-    
-    /**
-     * 组件所属的实体
-     * 
-     * 指向拥有此组件的实体实例。
-     */
-    public entity!: Entity;
-    
-    /**
-     * 组件启用状态
-     *
-     * 控制组件是否参与更新循环。
-     */
-    private _enabled: boolean = true;
-    
-    /**
-     * 更新顺序
-     *
-     * 决定组件在更新循环中的执行顺序。
-     *
-     * @see EntitySystem
-     */
-    private _updateOrder: number = 0;
 
     /**
      * 创建组件实例
-     * 
+     *
      * 自动分配唯一ID给组件。
      */
     constructor() {
         this.id = Component._idGenerator++;
     }
 
-    /**
-     * 获取组件启用状态
-     *
-     * 组件的实际启用状态取决于自身状态和所属实体的状态。
-     *
-     * @deprecated 不符合ECS架构规范，建议自己实现DisabledComponent标记组件替代
-     * @returns 如果组件和所属实体都启用则返回true
-     */
-    public get enabled(): boolean {
-        return this.entity ? this.entity.enabled && this._enabled : this._enabled;
-    }
-
-    /**
-     * 设置组件启用状态
-     *
-     * 当状态改变时会触发相应的生命周期回调。
-     *
-     * @deprecated 不符合ECS架构规范，建议自己实现DisabledComponent标记组件替代
-     * @param value - 新的启用状态
-     */
-    public set enabled(value: boolean) {
-        if (this._enabled !== value) {
-            this._enabled = value;
-            if (this._enabled) {
-                this.onEnabled();
-            } else {
-                this.onDisabled();
-            }
-        }
-    }
-
-    /**
-     * 获取更新顺序
-     *
-     * @deprecated 不符合ECS架构规范，更新顺序应该由EntitySystem管理
-     * @see EntitySystem
-     * @returns 组件的更新顺序值
-     */
-    public get updateOrder(): number {
-        return this._updateOrder;
-    }
-
-    /**
-     * 设置更新顺序
-     *
-     * @deprecated 不符合ECS架构规范，更新顺序应该由EntitySystem管理
-     * @see EntitySystem
-     * @param value - 新的更新顺序值
-     */
-    public set updateOrder(value: number) {
-        this._updateOrder = value;
-    }
-
     /**
      * 组件添加到实体时的回调
-     * 
+     *
      * 当组件被添加到实体时调用，可以在此方法中进行初始化操作。
+     *
+     * @remarks
+     * 这是一个生命周期钩子，用于组件的初始化逻辑。
+     * 虽然保留此方法，但建议将复杂的初始化逻辑放在 System 中处理。
      */
     public onAddedToEntity(): void {
     }
 
     /**
      * 组件从实体移除时的回调
-     * 
+     *
      * 当组件从实体中移除时调用，可以在此方法中进行清理操作。
+     *
+     * @remarks
+     * 这是一个生命周期钩子，用于组件的清理逻辑。
+     * 虽然保留此方法，但建议将复杂的清理逻辑放在 System 中处理。
      */
     public onRemovedFromEntity(): void {
     }
 
-    /**
-     * 组件启用时的回调
-     * 
-     * 当组件被启用时调用。
-     */
-    public onEnabled(): void {
-    }
-
-    /**
-     * 组件禁用时的回调
-     * 
-     * 当组件被禁用时调用。
-     */
-    public onDisabled(): void {
-    }
-
-    /**
-     * 更新组件
-     *
-     * @deprecated 不符合ECS架构规范，建议使用EntitySystem来处理更新逻辑
-     */
-    public update(): void {
-    }
-    
 }