@esengine/ecs-framework 2.1.29 → 2.1.30

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

@@ -0,0 +1,163 @@
+import { IBigIntLike } from './BigIntCompatibility';
+/**
+ * 高性能位操作类
+ *
+ * 基于BigInt实现，支持任意数量的位操作。
+ * 自动适配运行环境，在不支持BigInt的环境中使用兼容实现。
+ *
+ * @example
+ * ```typescript
+ * const bits = new Bits();
+ * bits.set(0);
+ * bits.set(5);
+ * console.log(bits.get(0)); // true
+ * console.log(bits.get(1)); // false
+ * ```
+ */
+export declare class Bits {
+    private _value;
+    /**
+     * 构造函数
+     * @param initialValue 初始值，可以是IBigIntLike或数值
+     */
+    constructor(initialValue?: IBigIntLike | number | string);
+    /**
+     * 设置指定位置的位为1
+     * @param index 位索引（从0开始）
+     * @throws {Error} 当索引为负数时抛出错误
+     */
+    set(index: number): void;
+    /**
+     * 清除指定位置的位（设为0）
+     * @param index 位索引（从0开始）
+     * @throws {Error} 当索引为负数时抛出错误
+     */
+    clear(index: number): void;
+    /**
+     * 获取指定位置的位值
+     * @param index 位索引（从0开始）
+     * @returns 位值（true表示1，false表示0）
+     */
+    get(index: number): boolean;
+    /**
+     * 检查是否包含所有指定的位
+     * @param other 另一个Bits对象
+     * @returns 是否包含所有指定的位
+     */
+    containsAll(other: Bits): boolean;
+    /**
+     * 检查是否包含任意一个指定的位
+     * @param other 另一个Bits对象
+     * @returns 是否包含任意一个指定的位
+     */
+    intersects(other: Bits): boolean;
+    /**
+     * 检查是否不包含任何指定的位
+     * @param other 另一个Bits对象
+     * @returns 是否不包含任何指定的位
+     */
+    excludes(other: Bits): boolean;
+    /**
+     * 清空所有位
+     */
+    clearAll(): void;
+    /**
+     * 检查是否为空（没有设置任何位）
+     * @returns 是否为空
+     */
+    isEmpty(): boolean;
+    /**
+     * 获取设置的位数量
+     * @returns 设置为1的位数量
+     */
+    cardinality(): number;
+    /**
+     * 位运算：与
+     * @param other 另一个Bits对象
+     * @returns 新的Bits对象，包含与运算结果
+     */
+    and(other: Bits): Bits;
+    /**
+     * 位运算：或
+     * @param other 另一个Bits对象
+     * @returns 新的Bits对象，包含或运算结果
+     */
+    or(other: Bits): Bits;
+    /**
+     * 位运算：异或
+     * @param other 另一个Bits对象
+     * @returns 新的Bits对象，包含异或运算结果
+     */
+    xor(other: Bits): Bits;
+    /**
+     * 位运算：非
+     * @param maxBits 最大位数限制，默认64位
+     * @returns 新的Bits对象，包含非运算结果
+     */
+    not(maxBits?: number): Bits;
+    /**
+     * 复制另一个Bits对象
+     * @param other 要复制的Bits对象
+     */
+    copyFrom(other: Bits): void;
+    /**
+     * 创建当前Bits的副本
+     * @returns 新的Bits对象副本
+     */
+    clone(): Bits;
+    /**
+     * 获取原始值
+     * @returns 原始的IBigIntLike值
+     */
+    getValue(): IBigIntLike;
+    /**
+     * 设置原始值
+     * @param value 新的值，可以是IBigIntLike或数值
+     */
+    setValue(value: IBigIntLike | number | string): void;
+    /**
+     * 获取调试信息
+     * @returns 返回显示设置位索引的字符串
+     */
+    toString(): string;
+    /**
+     * 获取二进制表示
+     * @param maxBits 最大位数，默认64位
+     * @returns 二进制字符串表示
+     */
+    toBinaryString(maxBits?: number): string;
+    /**
+     * 获取十六进制表示
+     * @returns 十六进制字符串表示
+     */
+    toHexString(): string;
+    /**
+     * 从二进制字符串创建Bits
+     * @param binaryString 二进制字符串
+     * @returns 新的Bits对象
+     */
+    static fromBinaryString(binaryString: string): Bits;
+    /**
+     * 从十六进制字符串创建Bits
+     * @param hexString 十六进制字符串
+     * @returns 新的Bits对象
+     */
+    static fromHexString(hexString: string): Bits;
+    /**
+     * 比较两个Bits对象是否相等
+     * @param other 另一个Bits对象
+     * @returns 是否相等
+     */
+    equals(other: Bits): boolean;
+    /**
+     * 获取最高位的索引
+     * @returns 最高位的索引，如果为空则返回-1
+     */
+    getHighestBitIndex(): number;
+    /**
+     * 获取最低位的索引
+     * @returns 最低位的索引，如果为空则返回-1
+     */
+    getLowestBitIndex(): number;
+}
+//# 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,OAAO,EAAE,WAAW,EAAiB,MAAM,uBAAuB,CAAC;AAEnE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,IAAI;IACb,OAAO,CAAC,MAAM,CAAc;IAE5B;;;OAGG;gBACS,YAAY,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM;IAQxD;;;;OAIG;IACI,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ/B;;;;OAIG;IACI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQjC;;;;OAIG;IACI,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAQlC;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAKxC;;;;OAIG;IACI,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAIvC;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAIrC;;OAEG;IACI,QAAQ,IAAI,IAAI;IAIvB;;;OAGG;IACI,OAAO,IAAI,OAAO;IAIzB;;;OAGG;IACI,WAAW,IAAI,MAAM;IAe5B;;;;OAIG;IACI,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAI7B;;;;OAIG;IACI,EAAE,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAI5B;;;;OAIG;IACI,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAI7B;;;;OAIG;IACI,GAAG,CAAC,OAAO,GAAE,MAAW,GAAG,IAAI;IAItC;;;OAGG;IACI,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAIlC;;;OAGG;IACI,KAAK,IAAI,IAAI;IAIpB;;;OAGG;IACI,QAAQ,IAAI,WAAW;IAI9B;;;OAGG;IACI,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI;IAQ3D;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAiBzB;;;;OAIG;IACI,cAAc,CAAC,OAAO,GAAE,MAAW,GAAG,MAAM;IAWnD;;;OAGG;IACI,WAAW,IAAI,MAAM;IAI5B;;;;OAIG;WACW,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAM1D;;;;OAIG;WACW,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpD;;;;OAIG;IACI,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAInC;;;OAGG;IACI,kBAAkB,IAAI,MAAM;IAgBnC;;;OAGG;IACI,iBAAiB,IAAI,MAAM;CAgBrC"}

package/bin/ECS/Utils/Bits.js

@@ -0,0 +1,286 @@
+import { BigIntFactory } from './BigIntCompatibility';
+/**
+ * 高性能位操作类
+ *
+ * 基于BigInt实现，支持任意数量的位操作。
+ * 自动适配运行环境，在不支持BigInt的环境中使用兼容实现。
+ *
+ * @example
+ * ```typescript
+ * const bits = new Bits();
+ * bits.set(0);
+ * bits.set(5);
+ * console.log(bits.get(0)); // true
+ * console.log(bits.get(1)); // false
+ * ```
+ */
+export class Bits {
+    /**
+     * 构造函数
+     * @param initialValue 初始值，可以是IBigIntLike或数值
+     */
+    constructor(initialValue) {
+        if (initialValue && typeof initialValue === 'object') {
+            this._value = initialValue;
+        }
+        else {
+            this._value = BigIntFactory.create(initialValue || 0);
+        }
+    }
+    /**
+     * 设置指定位置的位为1
+     * @param index 位索引（从0开始）
+     * @throws {Error} 当索引为负数时抛出错误
+     */
+    set(index) {
+        if (index < 0) {
+            throw new Error('Bit index cannot be negative');
+        }
+        const mask = BigIntFactory.one().shiftLeft(index);
+        this._value = this._value.or(mask);
+    }
+    /**
+     * 清除指定位置的位（设为0）
+     * @param index 位索引（从0开始）
+     * @throws {Error} 当索引为负数时抛出错误
+     */
+    clear(index) {
+        if (index < 0) {
+            throw new Error('Bit index cannot be negative');
+        }
+        const mask = BigIntFactory.one().shiftLeft(index).not();
+        this._value = this._value.and(mask);
+    }
+    /**
+     * 获取指定位置的位值
+     * @param index 位索引（从0开始）
+     * @returns 位值（true表示1，false表示0）
+     */
+    get(index) {
+        if (index < 0) {
+            return false;
+        }
+        const mask = BigIntFactory.one().shiftLeft(index);
+        return !this._value.and(mask).isZero();
+    }
+    /**
+     * 检查是否包含所有指定的位
+     * @param other 另一个Bits对象
+     * @returns 是否包含所有指定的位
+     */
+    containsAll(other) {
+        const intersection = this._value.and(other._value);
+        return intersection.equals(other._value);
+    }
+    /**
+     * 检查是否包含任意一个指定的位
+     * @param other 另一个Bits对象
+     * @returns 是否包含任意一个指定的位
+     */
+    intersects(other) {
+        return !this._value.and(other._value).isZero();
+    }
+    /**
+     * 检查是否不包含任何指定的位
+     * @param other 另一个Bits对象
+     * @returns 是否不包含任何指定的位
+     */
+    excludes(other) {
+        return !this.intersects(other);
+    }
+    /**
+     * 清空所有位
+     */
+    clearAll() {
+        this._value = BigIntFactory.zero();
+    }
+    /**
+     * 检查是否为空（没有设置任何位）
+     * @returns 是否为空
+     */
+    isEmpty() {
+        return this._value.isZero();
+    }
+    /**
+     * 获取设置的位数量
+     * @returns 设置为1的位数量
+     */
+    cardinality() {
+        let count = 0;
+        let value = this._value.clone();
+        while (!value.isZero()) {
+            const one = BigIntFactory.one();
+            if (!value.and(one).isZero()) {
+                count++;
+            }
+            value = value.shiftRight(1);
+        }
+        return count;
+    }
+    /**
+     * 位运算：与
+     * @param other 另一个Bits对象
+     * @returns 新的Bits对象，包含与运算结果
+     */
+    and(other) {
+        return new Bits(this._value.and(other._value));
+    }
+    /**
+     * 位运算：或
+     * @param other 另一个Bits对象
+     * @returns 新的Bits对象，包含或运算结果
+     */
+    or(other) {
+        return new Bits(this._value.or(other._value));
+    }
+    /**
+     * 位运算：异或
+     * @param other 另一个Bits对象
+     * @returns 新的Bits对象，包含异或运算结果
+     */
+    xor(other) {
+        return new Bits(this._value.xor(other._value));
+    }
+    /**
+     * 位运算：非
+     * @param maxBits 最大位数限制，默认64位
+     * @returns 新的Bits对象，包含非运算结果
+     */
+    not(maxBits = 64) {
+        return new Bits(this._value.not(maxBits));
+    }
+    /**
+     * 复制另一个Bits对象
+     * @param other 要复制的Bits对象
+     */
+    copyFrom(other) {
+        this._value = other._value.clone();
+    }
+    /**
+     * 创建当前Bits的副本
+     * @returns 新的Bits对象副本
+     */
+    clone() {
+        return new Bits(this._value.clone());
+    }
+    /**
+     * 获取原始值
+     * @returns 原始的IBigIntLike值
+     */
+    getValue() {
+        return this._value;
+    }
+    /**
+     * 设置原始值
+     * @param value 新的值，可以是IBigIntLike或数值
+     */
+    setValue(value) {
+        if (typeof value === 'object') {
+            this._value = value;
+        }
+        else {
+            this._value = BigIntFactory.create(value);
+        }
+    }
+    /**
+     * 获取调试信息
+     * @returns 返回显示设置位索引的字符串
+     */
+    toString() {
+        const bits = [];
+        let index = 0;
+        let value = this._value.clone();
+        while (!value.isZero()) {
+            const one = BigIntFactory.one();
+            if (!value.and(one).isZero()) {
+                bits.push(index.toString());
+            }
+            value = value.shiftRight(1);
+            index++;
+        }
+        return `Bits[${bits.join(', ')}]`;
+    }
+    /**
+     * 获取二进制表示
+     * @param maxBits 最大位数，默认64位
+     * @returns 二进制字符串表示
+     */
+    toBinaryString(maxBits = 64) {
+        let result = '';
+        for (let i = maxBits - 1; i >= 0; i--) {
+            result += this.get(i) ? '1' : '0';
+            if (i % 8 === 0 && i > 0) {
+                result += ' ';
+            }
+        }
+        return result;
+    }
+    /**
+     * 获取十六进制表示
+     * @returns 十六进制字符串表示
+     */
+    toHexString() {
+        return '0x' + this._value.toString(16).toUpperCase();
+    }
+    /**
+     * 从二进制字符串创建Bits
+     * @param binaryString 二进制字符串
+     * @returns 新的Bits对象
+     */
+    static fromBinaryString(binaryString) {
+        const cleanString = binaryString.replace(/\s/g, '');
+        const value = BigIntFactory.fromBinaryString(cleanString);
+        return new Bits(value);
+    }
+    /**
+     * 从十六进制字符串创建Bits
+     * @param hexString 十六进制字符串
+     * @returns 新的Bits对象
+     */
+    static fromHexString(hexString) {
+        const value = BigIntFactory.fromHexString(hexString);
+        return new Bits(value);
+    }
+    /**
+     * 比较两个Bits对象是否相等
+     * @param other 另一个Bits对象
+     * @returns 是否相等
+     */
+    equals(other) {
+        return this._value.equals(other._value);
+    }
+    /**
+     * 获取最高位的索引
+     * @returns 最高位的索引，如果为空则返回-1
+     */
+    getHighestBitIndex() {
+        if (this._value.isZero()) {
+            return -1;
+        }
+        let index = 0;
+        let value = this._value.clone();
+        while (!value.shiftRight(1).isZero()) {
+            value = value.shiftRight(1);
+            index++;
+        }
+        return index;
+    }
+    /**
+     * 获取最低位的索引
+     * @returns 最低位的索引，如果为空则返回-1
+     */
+    getLowestBitIndex() {
+        if (this._value.isZero()) {
+            return -1;
+        }
+        let index = 0;
+        let value = this._value.clone();
+        const one = BigIntFactory.one();
+        while (value.and(one).isZero()) {
+            value = value.shiftRight(1);
+            index++;
+        }
+        return index;
+    }
+}
+//# 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":"AAAA,OAAO,EAAe,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,IAAI;IAGb;;;OAGG;IACH,YAAY,YAA4C;QACpD,IAAI,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACnD,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC/B,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC;QAC1D,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,KAAa;QACpB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,KAAa;QACtB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,KAAa;QACpB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACZ,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,KAAW;QAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACnD,OAAO,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAC,KAAW;QACzB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,QAAQ,CAAC,KAAW;QACvB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,QAAQ;QACX,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;IACvC,CAAC;IAED;;;OAGG;IACI,OAAO;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAChC,CAAC;IAED;;;OAGG;IACI,WAAW;QACd,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAEhC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC3B,KAAK,EAAE,CAAC;YACZ,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,KAAW;QAClB,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,EAAE,CAAC,KAAW;QACjB,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,KAAW;QAClB,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,UAAkB,EAAE;QAC3B,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,KAAW;QACvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACvC,CAAC;IAED;;;OAGG;IACI,KAAK;QACR,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACI,QAAQ;QACX,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,KAAoC;QAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACxB,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,QAAQ;QACX,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAEhC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC3B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAChC,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC5B,KAAK,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACI,cAAc,CAAC,UAAkB,EAAE;QACtC,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAClC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,GAAG,CAAC;YAClB,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;OAGG;IACI,WAAW;QACd,OAAO,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,gBAAgB,CAAC,YAAoB;QAC/C,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,aAAa,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAC1D,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,aAAa,CAAC,SAAiB;QACzC,MAAM,KAAK,GAAG,aAAa,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACrD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,KAAW;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACI,kBAAkB;QACrB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACvB,OAAO,CAAC,CAAC,CAAC;QACd,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAEhC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC5B,KAAK,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;OAGG;IACI,iBAAiB;QACpB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACvB,OAAO,CAAC,CAAC,CAAC;QACd,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC;QAEhC,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7B,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC5B,KAAK,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ"}

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

@@ -0,0 +1,50 @@
+import { Component } from '../Component';
+import { Bits } from './Bits';
+/**
+ * 组件类型管理器
+ * 负责管理组件类型的注册和ID分配
+ */
+export declare class ComponentTypeManager {
+    private static _instance;
+    private _componentTypes;
+    private _typeNames;
+    private _nextTypeId;
+    /**
+     * 获取单例实例
+     */
+    static get instance(): ComponentTypeManager;
+    private constructor();
+    /**
+     * 获取组件类型的ID
+     * @param componentType 组件类型构造函数
+     * @returns 组件类型ID
+     */
+    getTypeId<T extends Component>(componentType: new (...args: unknown[]) => T): number;
+    /**
+     * 获取组件类型名称
+     * @param typeId 组件类型ID
+     * @returns 组件类型名称
+     */
+    getTypeName(typeId: number): string;
+    /**
+     * 创建包含指定组件类型的Bits对象
+     * @param componentTypes 组件类型构造函数数组
+     * @returns Bits对象
+     */
+    createBits(...componentTypes: (new (...args: unknown[]) => Component)[]): Bits;
+    /**
+     * 获取实体的组件位掩码
+     * @param components 组件数组
+     * @returns Bits对象
+     */
+    getEntityBits(components: Component[]): Bits;
+    /**
+     * 重置管理器（主要用于测试）
+     */
+    reset(): void;
+    /**
+     * 获取已注册的组件类型数量
+     */
+    get registeredTypeCount(): number;
+}
+//# sourceMappingURL=ComponentTypeManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentTypeManager.d.ts","sourceRoot":"","sources":["../../../src/ECS/Utils/ComponentTypeManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;;GAGG;AACH,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAuB;IAC/C,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,WAAW,CAAK;IAExB;;OAEG;IACH,WAAkB,QAAQ,IAAI,oBAAoB,CAKjD;IAED,OAAO;IAEP;;;;OAIG;IACI,SAAS,CAAC,CAAC,SAAS,SAAS,EAAE,aAAa,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM;IAY3F;;;;OAIG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI1C;;;;OAIG;IACI,UAAU,CAAC,GAAG,cAAc,EAAE,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,SAAS,CAAC,EAAE,GAAG,IAAI;IAWrF;;;;OAIG;IACI,aAAa,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI;IAWnD;;OAEG;IACI,KAAK,IAAI,IAAI;IAMpB;;OAEG;IACH,IAAW,mBAAmB,IAAI,MAAM,CAEvC;CACJ"}

package/bin/ECS/Utils/ComponentTypeManager.js

@@ -0,0 +1,84 @@
+import { Bits } from './Bits';
+/**
+ * 组件类型管理器
+ * 负责管理组件类型的注册和ID分配
+ */
+export class ComponentTypeManager {
+    /**
+     * 获取单例实例
+     */
+    static get instance() {
+        if (!ComponentTypeManager._instance) {
+            ComponentTypeManager._instance = new ComponentTypeManager();
+        }
+        return ComponentTypeManager._instance;
+    }
+    constructor() {
+        this._componentTypes = new Map();
+        this._typeNames = new Map();
+        this._nextTypeId = 0;
+    }
+    /**
+     * 获取组件类型的ID
+     * @param componentType 组件类型构造函数
+     * @returns 组件类型ID
+     */
+    getTypeId(componentType) {
+        let typeId = this._componentTypes.get(componentType);
+        if (typeId === undefined) {
+            typeId = this._nextTypeId++;
+            this._componentTypes.set(componentType, typeId);
+            this._typeNames.set(typeId, componentType.name);
+        }
+        return typeId;
+    }
+    /**
+     * 获取组件类型名称
+     * @param typeId 组件类型ID
+     * @returns 组件类型名称
+     */
+    getTypeName(typeId) {
+        return this._typeNames.get(typeId) || 'Unknown';
+    }
+    /**
+     * 创建包含指定组件类型的Bits对象
+     * @param componentTypes 组件类型构造函数数组
+     * @returns Bits对象
+     */
+    createBits(...componentTypes) {
+        const bits = new Bits();
+        for (const componentType of componentTypes) {
+            const typeId = this.getTypeId(componentType);
+            bits.set(typeId);
+        }
+        return bits;
+    }
+    /**
+     * 获取实体的组件位掩码
+     * @param components 组件数组
+     * @returns Bits对象
+     */
+    getEntityBits(components) {
+        const bits = new Bits();
+        for (const component of components) {
+            const typeId = this.getTypeId(component.constructor);
+            bits.set(typeId);
+        }
+        return bits;
+    }
+    /**
+     * 重置管理器（主要用于测试）
+     */
+    reset() {
+        this._componentTypes.clear();
+        this._typeNames.clear();
+        this._nextTypeId = 0;
+    }
+    /**
+     * 获取已注册的组件类型数量
+     */
+    get registeredTypeCount() {
+        return this._componentTypes.size;
+    }
+}
+//# sourceMappingURL=ComponentTypeManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentTypeManager.js","sourceRoot":"","sources":["../../../src/ECS/Utils/ComponentTypeManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IAM7B;;OAEG;IACI,MAAM,KAAK,QAAQ;QACtB,IAAI,CAAC,oBAAoB,CAAC,SAAS,EAAE,CAAC;YAClC,oBAAoB,CAAC,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAChE,CAAC;QACD,OAAO,oBAAoB,CAAC,SAAS,CAAC;IAC1C,CAAC;IAED;QAdQ,oBAAe,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC9C,eAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;QACvC,gBAAW,GAAG,CAAC,CAAC;IAYD,CAAC;IAExB;;;;OAIG;IACI,SAAS,CAAsB,aAA4C;QAC9E,IAAI,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAErD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YAChD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,MAAc;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAC,GAAG,cAAyD;QAC1E,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAExB,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;YAC7C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,aAAa,CAAC,UAAuB;QACxC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAExB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,WAAoD,CAAC,CAAC;YAC9F,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAW,mBAAmB;QAC1B,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;IACrC,CAAC;CACJ"}