@esengine/ecs-framework 2.0.3

package/bin/ECS/Systems/index.js

@@ -0,0 +1,6 @@
+// ECS系统导出
+export { EntitySystem } from './EntitySystem';
+export { ProcessingSystem } from './ProcessingSystem';
+export { PassiveSystem } from './PassiveSystem';
+export { IntervalSystem } from './IntervalSystem';
+//# sourceMappingURL=index.js.map

package/bin/ECS/Systems/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ECS/Systems/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/bin/ECS/Transform.d.ts

@@ -0,0 +1,178 @@
+import { Vector2 } from '../Math/Vector2';
+/**
+ * 变换组件类
+ *
+ * 管理游戏对象的空间变换信息，包括位置、旋转和缩放。
+ * 支持父子层级关系，可以构建复杂的变换层次结构。
+ *
+ * @example
+ * ```typescript
+ * const transform = new Transform();
+ * transform.setPosition(100, 200);
+ * transform.setRotationDegrees(45);
+ * transform.setScale(2, 2);
+ *
+ * // 设置父子关系
+ * childTransform.setParent(transform);
+ * ```
+ */
+export declare class Transform {
+    /**
+     * 本地位置坐标
+     *
+     * 相对于父变换的位置，如果没有父变换则为世界坐标。
+     */
+    position: Vector2;
+    /**
+     * 本地旋转角度
+     *
+     * 以弧度为单位的旋转角度，相对于父变换的旋转。
+     */
+    rotation: number;
+    /**
+     * 本地缩放比例
+     *
+     * 相对于父变换的缩放比例。
+     */
+    scale: Vector2;
+    /**
+     * 父变换引用
+     *
+     * 指向父级变换，如果为null则表示这是根变换。
+     */
+    parent: Transform | null;
+    /**
+     * 子变换集合
+     *
+     * 存储所有子级变换的数组。
+     */
+    private _children;
+    /**
+     * 创建变换实例
+     *
+     * @param position - 初始位置，默认为零向量
+     * @param rotation - 初始旋转角度（弧度），默认为0
+     * @param scale - 初始缩放，默认为单位向量
+     */
+    constructor(position?: Vector2, rotation?: number, scale?: Vector2);
+    /**
+     * 获取旋转角度（度数）
+     *
+     * @returns 以度数为单位的旋转角度
+     */
+    get rotationDegrees(): number;
+    /**
+     * 设置旋转角度（度数）
+     *
+     * @param value - 以度数为单位的旋转角度
+     */
+    set rotationDegrees(value: number);
+    /**
+     * 获取世界坐标位置
+     *
+     * 计算并返回在世界坐标系中的绝对位置。
+     *
+     * @returns 世界坐标位置
+     */
+    get worldPosition(): Vector2;
+    /**
+     * 获取世界旋转角度
+     *
+     * 计算并返回在世界坐标系中的绝对旋转角度。
+     *
+     * @returns 世界旋转角度（弧度）
+     */
+    get worldRotation(): number;
+    /**
+     * 获取世界缩放比例
+     *
+     * 计算并返回在世界坐标系中的绝对缩放比例。
+     *
+     * @returns 世界缩放比例
+     */
+    get worldScale(): Vector2;
+    /**
+     * 获取子变换数量
+     *
+     * @returns 子变换的数量
+     */
+    get childCount(): number;
+    /**
+     * 获取指定索引的子变换
+     *
+     * @param index - 子变换的索引
+     * @returns 子变换实例，如果索引无效则返回null
+     */
+    getChild(index: number): Transform | null;
+    /**
+     * 设置父变换
+     *
+     * 建立或断开与父变换的层级关系。
+     *
+     * @param parent - 新的父变换，传入null表示断开父子关系
+     */
+    setParent(parent: Transform | null): void;
+    /**
+     * 设置本地位置
+     *
+     * @param x - X坐标
+     * @param y - Y坐标
+     */
+    setPosition(x: number, y: number): void;
+    /**
+     * 设置本地旋转角度（弧度）
+     *
+     * @param radians - 旋转角度（弧度）
+     */
+    setRotation(radians: number): void;
+    /**
+     * 设置本地旋转角度（度数）
+     *
+     * @param degrees - 旋转角度（度数）
+     */
+    setRotationDegrees(degrees: number): void;
+    /**
+     * 设置本地缩放比例
+     *
+     * @param scale - 缩放向量
+     */
+    setScale(scale: Vector2): void;
+    /**
+     * 设置本地缩放比例
+     *
+     * @param x - X轴缩放比例
+     * @param y - Y轴缩放比例
+     */
+    setScale(x: number, y: number): void;
+    /**
+     * 朝向指定位置
+     *
+     * 调整旋转角度使变换朝向目标位置。
+     *
+     * @param target - 目标位置
+     */
+    lookAt(target: Vector2): void;
+    /**
+     * 平移变换
+     *
+     * 在当前位置基础上添加偏移量。
+     *
+     * @param offset - 位置偏移量
+     */
+    translate(offset: Vector2): void;
+    /**
+     * 旋转
+     * @param radians 旋转角度（弧度）
+     */
+    rotate(radians: number): void;
+    /**
+     * 复制另一个变换的值
+     * @param other 另一个变换
+     */
+    copyFrom(other: Transform): void;
+    /**
+     * 克隆变换
+     */
+    clone(): Transform;
+}
+//# sourceMappingURL=Transform.d.ts.map

package/bin/ECS/Transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transform.d.ts","sourceRoot":"","sources":["../../src/ECS/Transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG1C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAS;IAClB;;;;OAIG;IACI,QAAQ,EAAE,OAAO,CAAgB;IAExC;;;;OAIG;IACI,QAAQ,EAAE,MAAM,CAAK;IAE5B;;;;OAIG;IACI,KAAK,EAAE,OAAO,CAAe;IAEpC;;;;OAIG;IACI,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAEvC;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAmB;IAEpC;;;;;;OAMG;gBACS,QAAQ,CAAC,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAU,EAAE,KAAK,CAAC,EAAE,OAAO;IAMrE;;;;OAIG;IACH,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED;;;;OAIG;IACH,IAAW,eAAe,CAAC,KAAK,EAAE,MAAM,EAEvC;IAED;;;;;;OAMG;IACH,IAAW,aAAa,IAAI,OAAO,CAgBlC;IAED;;;;;;OAMG;IACH,IAAW,aAAa,IAAI,MAAM,CAKjC;IAED;;;;;;OAMG;IACH,IAAW,UAAU,IAAI,OAAO,CAK/B;IAED;;;;OAIG;IACH,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED;;;;;OAKG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAOhD;;;;;;OAMG;IACI,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAkBhD;;;;;OAKG;IACI,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAI9C;;;;OAIG;IACI,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIzC;;;;OAIG;IACI,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhD;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IACrC;;;;;OAKG;IACI,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAS3C;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAKpC;;;;;;OAMG;IACI,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIvC;;;OAGG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIpC;;;OAGG;IACI,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAMvC;;OAEG;IACI,KAAK,IAAI,SAAS;CAI5B"}

package/bin/ECS/Transform.js

@@ -0,0 +1,249 @@
+import { Vector2 } from '../Math/Vector2';
+import { MathHelper } from '../Math/MathHelper';
+/**
+ * 变换组件类
+ *
+ * 管理游戏对象的空间变换信息，包括位置、旋转和缩放。
+ * 支持父子层级关系，可以构建复杂的变换层次结构。
+ *
+ * @example
+ * ```typescript
+ * const transform = new Transform();
+ * transform.setPosition(100, 200);
+ * transform.setRotationDegrees(45);
+ * transform.setScale(2, 2);
+ *
+ * // 设置父子关系
+ * childTransform.setParent(transform);
+ * ```
+ */
+export class Transform {
+    /**
+     * 创建变换实例
+     *
+     * @param position - 初始位置，默认为零向量
+     * @param rotation - 初始旋转角度（弧度），默认为0
+     * @param scale - 初始缩放，默认为单位向量
+     */
+    constructor(position, rotation = 0, scale) {
+        /**
+         * 本地位置坐标
+         *
+         * 相对于父变换的位置，如果没有父变换则为世界坐标。
+         */
+        this.position = Vector2.zero;
+        /**
+         * 本地旋转角度
+         *
+         * 以弧度为单位的旋转角度，相对于父变换的旋转。
+         */
+        this.rotation = 0;
+        /**
+         * 本地缩放比例
+         *
+         * 相对于父变换的缩放比例。
+         */
+        this.scale = Vector2.one;
+        /**
+         * 父变换引用
+         *
+         * 指向父级变换，如果为null则表示这是根变换。
+         */
+        this.parent = null;
+        /**
+         * 子变换集合
+         *
+         * 存储所有子级变换的数组。
+         */
+        this._children = [];
+        if (position)
+            this.position = position.clone();
+        this.rotation = rotation;
+        if (scale)
+            this.scale = scale.clone();
+    }
+    /**
+     * 获取旋转角度（度数）
+     *
+     * @returns 以度数为单位的旋转角度
+     */
+    get rotationDegrees() {
+        return MathHelper.toDegrees(this.rotation);
+    }
+    /**
+     * 设置旋转角度（度数）
+     *
+     * @param value - 以度数为单位的旋转角度
+     */
+    set rotationDegrees(value) {
+        this.rotation = MathHelper.toRadians(value);
+    }
+    /**
+     * 获取世界坐标位置
+     *
+     * 计算并返回在世界坐标系中的绝对位置。
+     *
+     * @returns 世界坐标位置
+     */
+    get worldPosition() {
+        if (!this.parent) {
+            return this.position.clone();
+        }
+        // 计算世界位置
+        const parentWorld = this.parent.worldPosition;
+        const cos = Math.cos(this.parent.worldRotation);
+        const sin = Math.sin(this.parent.worldRotation);
+        const parentScale = this.parent.worldScale;
+        const scaledPos = Vector2.multiply(this.position, parentScale);
+        const rotatedX = scaledPos.x * cos - scaledPos.y * sin;
+        const rotatedY = scaledPos.x * sin + scaledPos.y * cos;
+        return new Vector2(parentWorld.x + rotatedX, parentWorld.y + rotatedY);
+    }
+    /**
+     * 获取世界旋转角度
+     *
+     * 计算并返回在世界坐标系中的绝对旋转角度。
+     *
+     * @returns 世界旋转角度（弧度）
+     */
+    get worldRotation() {
+        if (!this.parent) {
+            return this.rotation;
+        }
+        return this.parent.worldRotation + this.rotation;
+    }
+    /**
+     * 获取世界缩放比例
+     *
+     * 计算并返回在世界坐标系中的绝对缩放比例。
+     *
+     * @returns 世界缩放比例
+     */
+    get worldScale() {
+        if (!this.parent) {
+            return this.scale.clone();
+        }
+        return Vector2.multiply(this.parent.worldScale, this.scale);
+    }
+    /**
+     * 获取子变换数量
+     *
+     * @returns 子变换的数量
+     */
+    get childCount() {
+        return this._children.length;
+    }
+    /**
+     * 获取指定索引的子变换
+     *
+     * @param index - 子变换的索引
+     * @returns 子变换实例，如果索引无效则返回null
+     */
+    getChild(index) {
+        if (index >= 0 && index < this._children.length) {
+            return this._children[index];
+        }
+        return null;
+    }
+    /**
+     * 设置父变换
+     *
+     * 建立或断开与父变换的层级关系。
+     *
+     * @param parent - 新的父变换，传入null表示断开父子关系
+     */
+    setParent(parent) {
+        if (this.parent === parent)
+            return;
+        // 从旧父级移除
+        if (this.parent) {
+            const index = this.parent._children.indexOf(this);
+            if (index >= 0) {
+                this.parent._children.splice(index, 1);
+            }
+        }
+        // 设置新父级
+        this.parent = parent;
+        if (parent) {
+            parent._children.push(this);
+        }
+    }
+    /**
+     * 设置本地位置
+     *
+     * @param x - X坐标
+     * @param y - Y坐标
+     */
+    setPosition(x, y) {
+        this.position.set(x, y);
+    }
+    /**
+     * 设置本地旋转角度（弧度）
+     *
+     * @param radians - 旋转角度（弧度）
+     */
+    setRotation(radians) {
+        this.rotation = radians;
+    }
+    /**
+     * 设置本地旋转角度（度数）
+     *
+     * @param degrees - 旋转角度（度数）
+     */
+    setRotationDegrees(degrees) {
+        this.rotation = MathHelper.toRadians(degrees);
+    }
+    setScale(scaleOrX, y) {
+        if (typeof scaleOrX === 'number') {
+            this.scale.set(scaleOrX, y);
+        }
+        else {
+            this.scale.copyFrom(scaleOrX);
+        }
+    }
+    /**
+     * 朝向指定位置
+     *
+     * 调整旋转角度使变换朝向目标位置。
+     *
+     * @param target - 目标位置
+     */
+    lookAt(target) {
+        const direction = target.subtract(this.worldPosition);
+        this.rotation = Math.atan2(direction.y, direction.x);
+    }
+    /**
+     * 平移变换
+     *
+     * 在当前位置基础上添加偏移量。
+     *
+     * @param offset - 位置偏移量
+     */
+    translate(offset) {
+        this.position = this.position.add(offset);
+    }
+    /**
+     * 旋转
+     * @param radians 旋转角度（弧度）
+     */
+    rotate(radians) {
+        this.rotation += radians;
+    }
+    /**
+     * 复制另一个变换的值
+     * @param other 另一个变换
+     */
+    copyFrom(other) {
+        this.position.copyFrom(other.position);
+        this.rotation = other.rotation;
+        this.scale.copyFrom(other.scale);
+    }
+    /**
+     * 克隆变换
+     */
+    clone() {
+        const transform = new Transform(this.position, this.rotation, this.scale);
+        return transform;
+    }
+}
+//# sourceMappingURL=Transform.js.map

package/bin/ECS/Transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transform.js","sourceRoot":"","sources":["../../src/ECS/Transform.ts"],"names":[],"mappings":"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"}

package/bin/ECS/Utils/Bits.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 高性能位操作类
+ * 用于快速操作位数组，支持组件匹配等场景
+ */
+export declare class Bits {
+    private _words;
+    private static readonly WORD_SIZE;
+    constructor();
+    /**
+     * 设置指定位置的位为1
+     * @param index 位置索引
+     */
+    set(index: number): void;
+    /**
+     * 清除指定位置的位（设为0）
+     * @param index 位置索引
+     */
+    clear(index: number): void;
+    /**
+     * 获取指定位置的位值
+     * @param index 位置索引
+     * @returns 位值（true或false）
+     */
+    get(index: number): boolean;
+    /**
+     * 检查是否包含所有指定的位
+     * @param other 另一个Bits对象
+     * @returns 如果包含所有位则返回true
+     */
+    containsAll(other: Bits): boolean;
+    /**
+     * 检查是否包含任意一个指定的位
+     * @param other 另一个Bits对象
+     * @returns 如果包含任意位则返回true
+     */
+    intersects(other: Bits): boolean;
+    /**
+     * 检查是否不包含任何指定的位
+     * @param other 另一个Bits对象
+     * @returns 如果不包含任何位则返回true
+     */
+    excludes(other: Bits): boolean;
+    /**
+     * 清空所有位
+     */
+    clearAll(): void;
+    /**
+     * 检查是否为空（没有设置任何位）
+     * @returns 如果为空则返回true
+     */
+    isEmpty(): boolean;
+    /**
+     * 获取设置的位数量
+     * @returns 设置的位数量
+     */
+    cardinality(): number;
+    /**
+     * 计算一个32位整数中设置的位数量
+     * @param n 32位整数
+     * @returns 设置的位数量
+     */
+    private popCount;
+    /**
+     * 复制另一个Bits对象
+     * @param other 要复制的Bits对象
+     */
+    copyFrom(other: Bits): void;
+    /**
+     * 创建当前Bits的副本
+     * @returns 新的Bits对象
+     */
+    clone(): Bits;
+}
+//# sourceMappingURL=Bits.d.ts.map

package/bin/ECS/Utils/Bits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bits.d.ts","sourceRoot":"","sources":["../../../src/ECS/Utils/Bits.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,IAAI;IACb,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAM;;IAMvC;;;OAGG;IACI,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAY/B;;;OAGG;IACI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASjC;;;;OAIG;IACI,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAWlC;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAexC;;;;OAIG;IACI,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAYvC;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAIrC;;OAEG;IACI,QAAQ,IAAI,IAAI;IAIvB;;;OAGG;IACI,OAAO,IAAI,OAAO;IASzB;;;OAGG;IACI,WAAW,IAAI,MAAM;IAQ5B;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAMhB;;;OAGG;IACI,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAIlC;;;OAGG;IACI,KAAK,IAAI,IAAI;CAKvB"}

package/bin/ECS/Utils/Bits.js

@@ -0,0 +1,142 @@
+/**
+ * 高性能位操作类
+ * 用于快速操作位数组，支持组件匹配等场景
+ */
+export class Bits {
+    constructor() {
+        this._words = [];
+        this._words = [];
+    }
+    /**
+     * 设置指定位置的位为1
+     * @param index 位置索引
+     */
+    set(index) {
+        const wordIndex = Math.floor(index / Bits.WORD_SIZE);
+        const bitIndex = index % Bits.WORD_SIZE;
+        // 确保数组足够大
+        while (this._words.length <= wordIndex) {
+            this._words.push(0);
+        }
+        this._words[wordIndex] |= (1 << bitIndex);
+    }
+    /**
+     * 清除指定位置的位（设为0）
+     * @param index 位置索引
+     */
+    clear(index) {
+        const wordIndex = Math.floor(index / Bits.WORD_SIZE);
+        const bitIndex = index % Bits.WORD_SIZE;
+        if (wordIndex < this._words.length) {
+            this._words[wordIndex] &= ~(1 << bitIndex);
+        }
+    }
+    /**
+     * 获取指定位置的位值
+     * @param index 位置索引
+     * @returns 位值（true或false）
+     */
+    get(index) {
+        const wordIndex = Math.floor(index / Bits.WORD_SIZE);
+        const bitIndex = index % Bits.WORD_SIZE;
+        if (wordIndex >= this._words.length) {
+            return false;
+        }
+        return (this._words[wordIndex] & (1 << bitIndex)) !== 0;
+    }
+    /**
+     * 检查是否包含所有指定的位
+     * @param other 另一个Bits对象
+     * @returns 如果包含所有位则返回true
+     */
+    containsAll(other) {
+        const maxLength = Math.max(this._words.length, other._words.length);
+        for (let i = 0; i < maxLength; i++) {
+            const thisWord = i < this._words.length ? this._words[i] : 0;
+            const otherWord = i < other._words.length ? other._words[i] : 0;
+            if ((thisWord & otherWord) !== otherWord) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * 检查是否包含任意一个指定的位
+     * @param other 另一个Bits对象
+     * @returns 如果包含任意位则返回true
+     */
+    intersects(other) {
+        const minLength = Math.min(this._words.length, other._words.length);
+        for (let i = 0; i < minLength; i++) {
+            if ((this._words[i] & other._words[i]) !== 0) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * 检查是否不包含任何指定的位
+     * @param other 另一个Bits对象
+     * @returns 如果不包含任何位则返回true
+     */
+    excludes(other) {
+        return !this.intersects(other);
+    }
+    /**
+     * 清空所有位
+     */
+    clearAll() {
+        this._words.length = 0;
+    }
+    /**
+     * 检查是否为空（没有设置任何位）
+     * @returns 如果为空则返回true
+     */
+    isEmpty() {
+        for (const word of this._words) {
+            if (word !== 0) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * 获取设置的位数量
+     * @returns 设置的位数量
+     */
+    cardinality() {
+        let count = 0;
+        for (const word of this._words) {
+            count += this.popCount(word);
+        }
+        return count;
+    }
+    /**
+     * 计算一个32位整数中设置的位数量
+     * @param n 32位整数
+     * @returns 设置的位数量
+     */
+    popCount(n) {
+        n = n - ((n >>> 1) & 0x55555555);
+        n = (n & 0x33333333) + ((n >>> 2) & 0x33333333);
+        return (((n + (n >>> 4)) & 0xF0F0F0F) * 0x1010101) >>> 24;
+    }
+    /**
+     * 复制另一个Bits对象
+     * @param other 要复制的Bits对象
+     */
+    copyFrom(other) {
+        this._words = [...other._words];
+    }
+    /**
+     * 创建当前Bits的副本
+     * @returns 新的Bits对象
+     */
+    clone() {
+        const newBits = new Bits();
+        newBits.copyFrom(this);
+        return newBits;
+    }
+}
+Bits.WORD_SIZE = 32;
+//# sourceMappingURL=Bits.js.map

package/bin/ECS/Utils/Bits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bits.js","sourceRoot":"","sources":["../../../src/ECS/Utils/Bits.ts"],"names":[],"mappings":"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"}