@esengine/ecs-framework 2.1.29 → 2.1.30

package/bin/ECS/Systems/IntervalSystem.js

@@ -0,0 +1,50 @@
+import { EntitySystem } from './EntitySystem';
+import { Time } from '../../Utils/Time';
+/**
+ * 间隔系统抽象类
+ * 定义一个按时间间隔处理的抽象类，继承自EntitySystem类
+ * 子类需要实现process方法，用于实现具体的处理逻辑
+ */
+export class IntervalSystem extends EntitySystem {
+    /**
+     * 构造函数，初始化时间间隔
+     * @param interval 时间间隔
+     * @param matcher 实体匹配器
+     */
+    constructor(interval, matcher) {
+        super(matcher);
+        /** 累积增量以跟踪间隔 */
+        this.acc = 0;
+        /** 时间间隔的余数，用于计算下一次需要等待的时间 */
+        this.intervalRemainder = 0;
+        this.interval = interval;
+    }
+    /**
+     * 判断是否需要进行处理
+     * 如果需要进行处理，则更新累积增量和时间间隔余数，返回true
+     * 否则返回false
+     */
+    onCheckProcessing() {
+        // 更新累积增量
+        this.acc += Time.deltaTime;
+        // 如果累积增量超过时间间隔，则进行处理
+        if (this.acc >= this.interval) {
+            // 更新时间间隔余数
+            this.intervalRemainder = this.acc - this.interval;
+            // 重置累积增量
+            this.acc = 0;
+            // 返回true，表示需要进行处理
+            return true;
+        }
+        // 返回false，表示不需要进行处理
+        return false;
+    }
+    /**
+     * 获取本系统上次处理后的实际delta值
+     * 实际delta值等于时间间隔加上时间间隔余数
+     */
+    getIntervalDelta() {
+        return this.interval + this.intervalRemainder;
+    }
+}
+//# sourceMappingURL=IntervalSystem.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IntervalSystem.js","sourceRoot":"","sources":["../../../src/ECS/Systems/IntervalSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC;;;;GAIG;AACH,MAAM,OAAgB,cAAe,SAAQ,YAAY;IAQrD;;;;OAIG;IACH,YAAY,QAAgB,EAAE,OAAiB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QAbnB,gBAAgB;QACR,QAAG,GAAW,CAAC,CAAC;QAGxB,6BAA6B;QACrB,sBAAiB,GAAW,CAAC,CAAC;QASlC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACgB,iBAAiB;QAChC,SAAS;QACT,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC;QAE3B,qBAAqB;QACrB,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,WAAW;YACX,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;YAClD,SAAS;YACT,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;YACb,kBAAkB;YAClB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,oBAAoB;QACpB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;OAGG;IACO,gBAAgB;QACtB,OAAO,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC;IAClD,CAAC;CACJ"}

package/bin/ECS/Systems/PassiveSystem.d.ts

@@ -0,0 +1,17 @@
+import { EntitySystem } from './EntitySystem';
+import { Entity } from '../Entity';
+import { Matcher } from '../Utils/Matcher';
+/**
+ * 被动实体系统
+ * 定义一个被动的实体系统，继承自EntitySystem类
+ * 被动的实体系统不会对实体进行任何修改，只会被动地接收实体的变化事件
+ */
+export declare abstract class PassiveSystem extends EntitySystem {
+    constructor(matcher?: Matcher);
+    /**
+     * 不进行任何处理
+     * @param entities 实体数组，未被使用
+     */
+    protected process(entities: Entity[]): void;
+}
+//# sourceMappingURL=PassiveSystem.d.ts.map

package/bin/ECS/Systems/PassiveSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PassiveSystem.d.ts","sourceRoot":"","sources":["../../../src/ECS/Systems/PassiveSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C;;;;GAIG;AACH,8BAAsB,aAAc,SAAQ,YAAY;gBAExC,OAAO,CAAC,EAAE,OAAO;IAI7B;;;OAGG;cACgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;CAGvD"}

package/bin/ECS/Systems/PassiveSystem.js

@@ -0,0 +1,19 @@
+import { EntitySystem } from './EntitySystem';
+/**
+ * 被动实体系统
+ * 定义一个被动的实体系统，继承自EntitySystem类
+ * 被动的实体系统不会对实体进行任何修改，只会被动地接收实体的变化事件
+ */
+export class PassiveSystem extends EntitySystem {
+    constructor(matcher) {
+        super(matcher);
+    }
+    /**
+     * 不进行任何处理
+     * @param entities 实体数组，未被使用
+     */
+    process(entities) {
+        // 被动系统不进行任何处理
+    }
+}
+//# sourceMappingURL=PassiveSystem.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PassiveSystem.js","sourceRoot":"","sources":["../../../src/ECS/Systems/PassiveSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C;;;;GAIG;AACH,MAAM,OAAgB,aAAc,SAAQ,YAAY;IAEpD,YAAY,OAAiB;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IAED;;;OAGG;IACgB,OAAO,CAAC,QAAkB;QACzC,cAAc;IAClB,CAAC;CACJ"}

package/bin/ECS/Systems/ProcessingSystem.d.ts

@@ -0,0 +1,21 @@
+import { EntitySystem } from './EntitySystem';
+import { Entity } from '../Entity';
+import { Matcher } from '../Utils/Matcher';
+/**
+ * 处理系统抽象类
+ * 定义一个处理实体的抽象类，继承自EntitySystem类
+ * 子类需要实现processSystem方法，用于实现具体的处理逻辑
+ */
+export declare abstract class ProcessingSystem extends EntitySystem {
+    constructor(matcher?: Matcher);
+    /**
+     * 处理实体，每帧调用processSystem方法进行处理
+     * @param entities 实体数组，未被使用
+     */
+    protected process(entities: Entity[]): void;
+    /**
+     * 处理实体的具体方法，由子类实现
+     */
+    abstract processSystem(): void;
+}
+//# sourceMappingURL=ProcessingSystem.d.ts.map

package/bin/ECS/Systems/ProcessingSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessingSystem.d.ts","sourceRoot":"","sources":["../../../src/ECS/Systems/ProcessingSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C;;;;GAIG;AACH,8BAAsB,gBAAiB,SAAQ,YAAY;gBAE3C,OAAO,CAAC,EAAE,OAAO;IAI7B;;;OAGG;cACgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAKpD;;OAEG;aACa,aAAa,IAAI,IAAI;CACxC"}

package/bin/ECS/Systems/ProcessingSystem.js

@@ -0,0 +1,20 @@
+import { EntitySystem } from './EntitySystem';
+/**
+ * 处理系统抽象类
+ * 定义一个处理实体的抽象类，继承自EntitySystem类
+ * 子类需要实现processSystem方法，用于实现具体的处理逻辑
+ */
+export class ProcessingSystem extends EntitySystem {
+    constructor(matcher) {
+        super(matcher);
+    }
+    /**
+     * 处理实体，每帧调用processSystem方法进行处理
+     * @param entities 实体数组，未被使用
+     */
+    process(entities) {
+        // 调用子类实现的processSystem方法进行实体处理
+        this.processSystem();
+    }
+}
+//# sourceMappingURL=ProcessingSystem.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessingSystem.js","sourceRoot":"","sources":["../../../src/ECS/Systems/ProcessingSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C;;;;GAIG;AACH,MAAM,OAAgB,gBAAiB,SAAQ,YAAY;IAEvD,YAAY,OAAiB;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IAED;;;OAGG;IACgB,OAAO,CAAC,QAAkB;QACzC,+BAA+B;QAC/B,IAAI,CAAC,aAAa,EAAE,CAAC;IACzB,CAAC;CAMJ"}

package/bin/ECS/Systems/index.d.ts

@@ -0,0 +1,5 @@
+export { EntitySystem } from './EntitySystem';
+export { ProcessingSystem } from './ProcessingSystem';
+export { PassiveSystem } from './PassiveSystem';
+export { IntervalSystem } from './IntervalSystem';
+//# sourceMappingURL=index.d.ts.map

package/bin/ECS/Systems/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ECS/Systems/index.ts"],"names":[],"mappings":"AACA,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/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/Utils/BigIntCompatibility.d.ts

@@ -0,0 +1,164 @@
+/**
+ * BigInt兼容性抽象层
+ *
+ * 为不支持BigInt的环境提供兼容实现，确保ECS框架在所有平台上都能正常运行。
+ * 自动检测运行时环境的BigInt支持情况，并提供统一的接口。
+ *
+ * @example
+ * ```typescript
+ * // 创建兼容的BigInt值
+ * const value = BigIntFactory.create(123);
+ *
+ * // 位运算
+ * const result = value.or(BigIntFactory.create(456));
+ *
+ * // 检查兼容性
+ * console.log(BigIntFactory.isNativeSupported()); // true/false
+ * ```
+ */
+/**
+ * BigInt兼容接口
+ *
+ * 定义了BigInt的基本操作接口，支持原生BigInt和兼容实现的统一调用。
+ */
+export interface IBigIntLike {
+    /**
+     * 获取数值表示
+     * @returns 数值
+     */
+    valueOf(): number;
+    /**
+     * 转换为字符串
+     * @param radix 进制，支持2、10、16
+     * @returns 字符串表示
+     */
+    toString(radix?: number): string;
+    /**
+     * 位运算：与
+     * @param other 另一个BigInt值
+     * @returns 运算结果
+     */
+    and(other: IBigIntLike): IBigIntLike;
+    /**
+     * 位运算：或
+     * @param other 另一个BigInt值
+     * @returns 运算结果
+     */
+    or(other: IBigIntLike): IBigIntLike;
+    /**
+     * 位运算：异或
+     * @param other 另一个BigInt值
+     * @returns 运算结果
+     */
+    xor(other: IBigIntLike): IBigIntLike;
+    /**
+     * 位运算：非
+     * @param maxBits 最大位数限制
+     * @returns 运算结果
+     */
+    not(maxBits?: number): IBigIntLike;
+    /**
+     * 左移位运算
+     * @param bits 移位数
+     * @returns 运算结果
+     */
+    shiftLeft(bits: number): IBigIntLike;
+    /**
+     * 右移位运算
+     * @param bits 移位数
+     * @returns 运算结果
+     */
+    shiftRight(bits: number): IBigIntLike;
+    /**
+     * 相等比较
+     * @param other 另一个BigInt值
+     * @returns 是否相等
+     */
+    equals(other: IBigIntLike): boolean;
+    /**
+     * 检查是否为零
+     * @returns 是否为零
+     */
+    isZero(): boolean;
+    /**
+     * 创建副本
+     * @returns 新的实例
+     */
+    clone(): IBigIntLike;
+}
+/**
+ * BigInt工厂类
+ *
+ * 自动检测运行时环境的BigInt支持情况，并提供统一的创建接口。
+ * 在支持BigInt的环境中使用原生实现，在不支持的环境中使用兼容实现。
+ */
+export declare class BigIntFactory {
+    private static _supportsBigInt;
+    private static _cachedZero;
+    private static _cachedOne;
+    /**
+     * 检查是否支持原生BigInt
+     * @returns 是否支持原生BigInt
+     */
+    static isNativeSupported(): boolean;
+    /**
+     * 检测BigInt支持情况
+     * @returns 是否支持BigInt
+     */
+    private static detectBigIntSupport;
+    /**
+     * 创建BigInt兼容值
+     * @param value 初始值
+     * @returns IBigIntLike实例
+     */
+    static create(value?: number | string | bigint): IBigIntLike;
+    /**
+     * 创建零值
+     * @returns 零值的IBigIntLike实例
+     */
+    static zero(): IBigIntLike;
+    /**
+     * 创建1值
+     * @returns 1值的IBigIntLike实例
+     */
+    static one(): IBigIntLike;
+    /**
+     * 从二进制字符串创建
+     * @param binary 二进制字符串
+     * @returns IBigIntLike实例
+     */
+    static fromBinaryString(binary: string): IBigIntLike;
+    /**
+     * 从十六进制字符串创建
+     * @param hex 十六进制字符串
+     * @returns IBigIntLike实例
+     */
+    static fromHexString(hex: string): IBigIntLike;
+    /**
+     * 获取环境信息
+     * @returns 环境信息对象
+     */
+    static getEnvironmentInfo(): EnvironmentInfo;
+    /**
+     * 检测运行环境
+     * @returns 环境类型
+     */
+    private static detectEnvironment;
+    /**
+     * 检测JavaScript引擎
+     * @returns JS引擎信息
+     */
+    private static detectJSEngine;
+}
+/**
+ * 环境信息接口
+ */
+export interface EnvironmentInfo {
+    /** 是否支持BigInt */
+    supportsBigInt: boolean;
+    /** 运行环境 */
+    environment: string;
+    /** JavaScript引擎 */
+    jsEngine: string;
+}
+//# sourceMappingURL=BigIntCompatibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BigIntCompatibility.d.ts","sourceRoot":"","sources":["../../../src/ECS/Utils/BigIntCompatibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;GAIG;AACH,MAAM,WAAW,WAAW;IACxB;;;OAGG;IACH,OAAO,IAAI,MAAM,CAAC;IAElB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjC;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC;IAErC;;;;OAIG;IACH,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC;IAEpC;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC;IAErC;;;;OAIG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAEnC;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAErC;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAEtC;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAEpC;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC;IAElB;;;OAGG;IACH,KAAK,IAAI,WAAW,CAAC;CACxB;AAmZD;;;;;GAKG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAwB;IACtD,OAAO,CAAC,MAAM,CAAC,WAAW,CAA4B;IACtD,OAAO,CAAC,MAAM,CAAC,UAAU,CAA4B;IAGrD;;;OAGG;WACW,iBAAiB,IAAI,OAAO;IAO1C;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA+BlC;;;;OAIG;WACW,MAAM,CAAC,KAAK,GAAE,MAAM,GAAG,MAAM,GAAG,MAAU,GAAG,WAAW;IA2BtE;;;OAGG;WACW,IAAI,IAAI,WAAW;IAOjC;;;OAGG;WACW,GAAG,IAAI,WAAW;IAOhC;;;;OAIG;WACW,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW;IAS3D;;;;OAIG;WACW,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAUrD;;;OAGG;WACW,kBAAkB,IAAI,eAAe;IAQnD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAgDhC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;CAuBhC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,iBAAiB;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;CACpB"}