新增cocos-debug-profiler

extensions/cocos/cocos-ecs/assets/scripts/ecs/components/PositionComponent.ts

@@ -0,0 +1,62 @@
+import { Component } from '@esengine/ecs-framework';
+import { Vec3 } from 'cc';
+
+/**
+ * 位置组件 - 存储实体的空间位置信息
+ * 
+ * 这是最基础的组件示例，展示了ECS组件的设计原则：
+ * 1. 主要存储数据，少量辅助方法
+ * 2. 单一职责：只负责位置相关的数据
+ * 3. 可复用：任何需要位置信息的实体都可以使用
+ */
+export class PositionComponent extends Component {
+    /** 3D位置坐标 */
+    public position: Vec3 = new Vec3();
+    /** 上一帧的位置（用于计算移动距离） */
+    public lastPosition: Vec3 = new Vec3();
+    
+    constructor(x: number = 0, y: number = 0, z: number = 0) {
+        super();
+        this.position.set(x, y, z);
+        this.lastPosition.set(x, y, z);
+    }
+    
+    /**
+     * 设置位置
+     */
+    setPosition(x: number, y: number, z: number = 0) {
+        this.lastPosition.set(this.position);
+        this.position.set(x, y, z);
+    }
+    
+    /**
+     * 移动位置
+     */
+    move(deltaX: number, deltaY: number, deltaZ: number = 0) {
+        this.lastPosition.set(this.position);
+        this.position.x += deltaX;
+        this.position.y += deltaY;
+        this.position.z += deltaZ;
+    }
+    
+    /**
+     * 计算到另一个位置的距离
+     */
+    distanceTo(other: PositionComponent): number {
+        return Vec3.distance(this.position, other.position);
+    }
+    
+    /**
+     * 获取本帧移动的距离
+     */
+    getMovementDistance(): number {
+        return Vec3.distance(this.position, this.lastPosition);
+    }
+    
+    /**
+     * 检查是否在指定范围内
+     */
+    isWithinRange(target: PositionComponent, range: number): boolean {
+        return this.distanceTo(target) <= range;
+    }
+}