@esengine/ecs-framework 2.1.29 → 2.1.30

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

@@ -0,0 +1,200 @@
+import { Entity } from '../Entity';
+import { Matcher } from '../Utils/Matcher';
+import type { Scene } from '../Scene';
+import type { ISystemBase } from '../../Types';
+/**
+ * 实体系统的基类
+ *
+ * 用于处理一组符合特定条件的实体。系统是ECS架构中的逻辑处理单元，
+ * 负责对拥有特定组件组合的实体执行业务逻辑。
+ *
+ * @example
+ * ```typescript
+ * class MovementSystem extends EntitySystem {
+ *     constructor() {
+ *         super(Transform, Velocity);
+ *     }
+ *
+ *     protected process(entities: Entity[]): void {
+ *         for (const entity of entities) {
+ *             const transform = entity.getComponent(Transform);
+ *             const velocity = entity.getComponent(Velocity);
+ *             transform.position.add(velocity.value);
+ *         }
+ *     }
+ * }
+ * ```
+ */
+export declare abstract class EntitySystem implements ISystemBase {
+    private _updateOrder;
+    private _enabled;
+    private _performanceMonitor;
+    private _systemName;
+    private _initialized;
+    private _matcher;
+    private _trackedEntities;
+    private _lastQueryResult;
+    /**
+     * 获取系统处理的实体列表（动态查询）
+     */
+    get entities(): readonly Entity[];
+    /**
+     * 获取系统的更新时序
+     */
+    get updateOrder(): number;
+    set updateOrder(value: number);
+    /**
+     * 获取系统的启用状态
+     */
+    get enabled(): boolean;
+    /**
+     * 设置系统的启用状态
+     */
+    set enabled(value: boolean);
+    /**
+     * 获取系统名称
+     */
+    get systemName(): string;
+    constructor(matcher?: Matcher);
+    private _scene;
+    /**
+     * 这个系统所属的场景
+     */
+    get scene(): Scene | null;
+    set scene(value: Scene | null);
+    /**
+     * 获取实体匹配器
+     */
+    get matcher(): Matcher;
+    /**
+     * 设置更新时序
+     * @param order 更新时序
+     */
+    setUpdateOrder(order: number): void;
+    /**
+     * 系统初始化（框架调用）
+     *
+     * 在系统创建时调用。框架内部使用，用户不应直接调用。
+     */
+    initialize(): void;
+    /**
+     * 系统初始化回调
+     *
+     * 子类可以重写此方法进行初始化操作。
+     */
+    protected onInitialize(): void;
+    /**
+     * 重置系统状态
+     *
+     * 当系统从场景中移除时调用，重置初始化状态以便重新添加时能正确初始化。
+     */
+    reset(): void;
+    /**
+     * 查询匹配的实体
+     */
+    private queryEntities;
+    /**
+     * 检查是否为单一条件查询
+     */
+    private isSingleCondition;
+    /**
+     * 执行单一条件查询
+     */
+    private executeSingleConditionQuery;
+    /**
+     * 执行复合查询
+     */
+    private executeComplexQuery;
+    /**
+     * 更新系统
+     *
+     * 在每帧调用，处理系统的主要逻辑。
+     */
+    update(): void;
+    /**
+     * 后期更新系统
+     *
+     * 在所有系统的update方法执行完毕后调用。
+     */
+    lateUpdate(): void;
+    /**
+     * 在系统处理开始前调用
+     *
+     * 子类可以重写此方法进行预处理操作。
+     */
+    protected onBegin(): void;
+    /**
+     * 处理实体列表
+     *
+     * 系统的核心逻辑，子类必须实现此方法来定义具体的处理逻辑。
+     *
+     * @param entities 要处理的实体列表
+     */
+    protected process(entities: Entity[]): void;
+    /**
+     * 后期处理实体列表
+     *
+     * 在主要处理逻辑之后执行，子类可以重写此方法。
+     *
+     * @param entities 要处理的实体列表
+     */
+    protected lateProcess(entities: Entity[]): void;
+    /**
+     * 系统处理完毕后调用
+     *
+     * 子类可以重写此方法进行后处理操作。
+     */
+    protected onEnd(): void;
+    /**
+     * 检查系统是否需要处理
+     *
+     * 在启用系统时有用，但仅偶尔需要处理。
+     * 这只影响处理，不影响事件或订阅列表。
+     *
+     * @returns 如果系统应该处理，则为true，如果不处理则为false
+     */
+    protected onCheckProcessing(): boolean;
+    /**
+     * 获取系统的性能数据
+     *
+     * @returns 性能数据或undefined
+     */
+    getPerformanceData(): import("../../Utils/PerformanceMonitor").PerformanceData | undefined;
+    /**
+     * 获取系统的性能统计
+     *
+     * @returns 性能统计或undefined
+     */
+    getPerformanceStats(): import("../../Utils/PerformanceMonitor").PerformanceStats | undefined;
+    /**
+     * 重置系统的性能数据
+     */
+    resetPerformanceData(): void;
+    /**
+     * 获取系统信息的字符串表示
+     *
+     * @returns 系统信息字符串
+     */
+    toString(): string;
+    /**
+     * 更新实体跟踪，检查新增和移除的实体
+     */
+    private updateEntityTracking;
+    /**
+     * 当实体被添加到系统时调用
+     *
+     * 子类可以重写此方法来处理实体添加事件。
+     *
+     * @param entity 被添加的实体
+     */
+    protected onAdded(_entity: Entity): void;
+    /**
+     * 当实体从系统中移除时调用
+     *
+     * 子类可以重写此方法来处理实体移除事件。
+     *
+     * @param entity 被移除的实体
+     */
+    protected onRemoved(_entity: Entity): void;
+}
+//# sourceMappingURL=EntitySystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntitySystem.d.ts","sourceRoot":"","sources":["../../../src/ECS/Systems/EntitySystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,8BAAsB,YAAa,YAAW,WAAW;IACrD,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,mBAAmB,CAA+B;IAC1D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,gBAAgB,CAAgB;IAExC;;OAEG;IACH,IAAW,QAAQ,IAAI,SAAS,MAAM,EAAE,CAEvC;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,WAAW,CAAC,KAAK,EAAE,MAAM,EAEnC;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;OAEG;IACH,IAAW,OAAO,CAAC,KAAK,EAAE,OAAO,EAEhC;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,MAAM,CAE9B;gBAEW,OAAO,CAAC,EAAE,OAAO;IAK7B,OAAO,CAAC,MAAM,CAAsB;IAEpC;;OAEG;IACH,IAAW,KAAK,IAAI,KAAK,GAAG,IAAI,CAE/B;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAEnC;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;OAGG;IACI,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO1C;;;;OAIG;IACI,UAAU,IAAI,IAAI;IAYzB;;;;OAIG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAQ9B;;;;OAIG;IACI,KAAK,IAAI,IAAI;IAMpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAgCnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0E3B;;;;OAIG;IACI,MAAM,IAAI,IAAI;IAmBrB;;;;OAIG;IACI,UAAU,IAAI,IAAI;IAmBzB;;;;OAIG;IACH,SAAS,CAAC,OAAO,IAAI,IAAI;IAIzB;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAI3C;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAI/C;;;;OAIG;IACH,SAAS,CAAC,KAAK,IAAI,IAAI;IAIvB;;;;;;;OAOG;IACH,SAAS,CAAC,iBAAiB,IAAI,OAAO;IAItC;;;;OAIG;IACI,kBAAkB;IAIzB;;;;OAIG;IACI,mBAAmB;IAI1B;;OAEG;IACI,oBAAoB,IAAI,IAAI;IAKnC;;;;OAIG;IACI,QAAQ,IAAI,MAAM;IAQzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIxC;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG7C"}

package/bin/ECS/Systems/EntitySystem.js

@@ -0,0 +1,431 @@
+import { PerformanceMonitor } from '../../Utils/PerformanceMonitor';
+import { Matcher } from '../Utils/Matcher';
+/**
+ * 实体系统的基类
+ *
+ * 用于处理一组符合特定条件的实体。系统是ECS架构中的逻辑处理单元，
+ * 负责对拥有特定组件组合的实体执行业务逻辑。
+ *
+ * @example
+ * ```typescript
+ * class MovementSystem extends EntitySystem {
+ *     constructor() {
+ *         super(Transform, Velocity);
+ *     }
+ *
+ *     protected process(entities: Entity[]): void {
+ *         for (const entity of entities) {
+ *             const transform = entity.getComponent(Transform);
+ *             const velocity = entity.getComponent(Velocity);
+ *             transform.position.add(velocity.value);
+ *         }
+ *     }
+ * }
+ * ```
+ */
+export class EntitySystem {
+    /**
+     * 获取系统处理的实体列表（动态查询）
+     */
+    get entities() {
+        return this.queryEntities();
+    }
+    /**
+     * 获取系统的更新时序
+     */
+    get updateOrder() {
+        return this._updateOrder;
+    }
+    set updateOrder(value) {
+        this.setUpdateOrder(value);
+    }
+    /**
+     * 获取系统的启用状态
+     */
+    get enabled() {
+        return this._enabled;
+    }
+    /**
+     * 设置系统的启用状态
+     */
+    set enabled(value) {
+        this._enabled = value;
+    }
+    /**
+     * 获取系统名称
+     */
+    get systemName() {
+        return this._systemName;
+    }
+    constructor(matcher) {
+        this._updateOrder = 0;
+        this._enabled = true;
+        this._performanceMonitor = PerformanceMonitor.instance;
+        this._initialized = false;
+        this._trackedEntities = new Set();
+        this._lastQueryResult = [];
+        this._scene = null;
+        this._matcher = matcher ? matcher : Matcher.empty();
+        this._systemName = this.constructor.name;
+    }
+    /**
+     * 这个系统所属的场景
+     */
+    get scene() {
+        return this._scene;
+    }
+    set scene(value) {
+        this._scene = value;
+    }
+    /**
+     * 获取实体匹配器
+     */
+    get matcher() {
+        return this._matcher;
+    }
+    /**
+     * 设置更新时序
+     * @param order 更新时序
+     */
+    setUpdateOrder(order) {
+        this._updateOrder = order;
+        if (this.scene && this.scene.entityProcessors) {
+            this.scene.entityProcessors.setDirty();
+        }
+    }
+    /**
+     * 系统初始化（框架调用）
+     *
+     * 在系统创建时调用。框架内部使用，用户不应直接调用。
+     */
+    initialize() {
+        // 防止重复初始化
+        if (this._initialized) {
+            return;
+        }
+        this._initialized = true;
+        // 调用用户可重写的初始化方法
+        this.onInitialize();
+    }
+    /**
+     * 系统初始化回调
+     *
+     * 子类可以重写此方法进行初始化操作。
+     */
+    onInitialize() {
+        // 初始化时触发一次实体查询，以便正确跟踪现有实体
+        if (this.scene) {
+            this.queryEntities();
+        }
+        // 子类可以重写此方法进行初始化
+    }
+    /**
+     * 重置系统状态
+     *
+     * 当系统从场景中移除时调用，重置初始化状态以便重新添加时能正确初始化。
+     */
+    reset() {
+        this._initialized = false;
+        this._trackedEntities.clear();
+        this._lastQueryResult = [];
+    }
+    /**
+     * 查询匹配的实体
+     */
+    queryEntities() {
+        if (!this.scene?.querySystem || !this._matcher) {
+            this._lastQueryResult = [];
+            return [];
+        }
+        const condition = this._matcher.getCondition();
+        const querySystem = this.scene.querySystem;
+        let currentEntities = [];
+        // 空条件返回所有实体
+        if (this._matcher.isEmpty()) {
+            currentEntities = querySystem.getAllEntities();
+        }
+        else if (this.isSingleCondition(condition)) {
+            // 单一条件优化查询
+            currentEntities = this.executeSingleConditionQuery(condition, querySystem);
+        }
+        else {
+            // 复合查询
+            currentEntities = this.executeComplexQuery(condition, querySystem);
+        }
+        // 检查实体变化并触发回调
+        this.updateEntityTracking(currentEntities);
+        this._lastQueryResult = currentEntities;
+        return currentEntities;
+    }
+    /**
+     * 检查是否为单一条件查询
+     */
+    isSingleCondition(condition) {
+        const conditionCount = (condition.all.length > 0 ? 1 : 0) +
+            (condition.any.length > 0 ? 1 : 0) +
+            (condition.none.length > 0 ? 1 : 0) +
+            (condition.tag !== undefined ? 1 : 0) +
+            (condition.name !== undefined ? 1 : 0) +
+            (condition.component !== undefined ? 1 : 0);
+        return conditionCount === 1;
+    }
+    /**
+     * 执行单一条件查询
+     */
+    executeSingleConditionQuery(condition, querySystem) {
+        // 按标签查询
+        if (condition.tag !== undefined) {
+            return querySystem.queryByTag(condition.tag).entities;
+        }
+        // 按名称查询
+        if (condition.name !== undefined) {
+            return querySystem.queryByName(condition.name).entities;
+        }
+        // 单组件查询
+        if (condition.component !== undefined) {
+            return querySystem.queryByComponent(condition.component).entities;
+        }
+        // 基础组件查询
+        if (condition.all.length > 0 && condition.any.length === 0 && condition.none.length === 0) {
+            return querySystem.queryAll(...condition.all).entities;
+        }
+        if (condition.all.length === 0 && condition.any.length > 0 && condition.none.length === 0) {
+            return querySystem.queryAny(...condition.any).entities;
+        }
+        if (condition.all.length === 0 && condition.any.length === 0 && condition.none.length > 0) {
+            return querySystem.queryNone(...condition.none).entities;
+        }
+        return [];
+    }
+    /**
+     * 执行复合查询
+     */
+    executeComplexQuery(condition, querySystem) {
+        let result = null;
+        // 1. 应用标签条件作为基础集合
+        if (condition.tag !== undefined) {
+            const tagResult = querySystem.queryByTag(condition.tag);
+            result = new Set(tagResult.entities);
+        }
+        // 2. 应用名称条件
+        if (condition.name !== undefined) {
+            const nameResult = querySystem.queryByName(condition.name);
+            const nameSet = new Set(nameResult.entities);
+            if (result) {
+                result = new Set([...result].filter(e => nameSet.has(e)));
+            }
+            else {
+                result = nameSet;
+            }
+        }
+        // 3. 应用单组件条件
+        if (condition.component !== undefined) {
+            const componentResult = querySystem.queryByComponent(condition.component);
+            const componentSet = new Set(componentResult.entities);
+            if (result) {
+                result = new Set([...result].filter(e => componentSet.has(e)));
+            }
+            else {
+                result = componentSet;
+            }
+        }
+        // 4. 应用all条件
+        if (condition.all.length > 0) {
+            const allResult = querySystem.queryAll(...condition.all);
+            const allSet = new Set(allResult.entities);
+            if (result) {
+                result = new Set([...result].filter(e => allSet.has(e)));
+            }
+            else {
+                result = allSet;
+            }
+        }
+        // 5. 应用any条件（求交集）
+        if (condition.any.length > 0) {
+            const anyResult = querySystem.queryAny(...condition.any);
+            const anySet = new Set(anyResult.entities);
+            if (result) {
+                result = new Set([...result].filter(e => anySet.has(e)));
+            }
+            else {
+                result = anySet;
+            }
+        }
+        // 6. 应用none条件（排除）
+        if (condition.none.length > 0) {
+            if (!result) {
+                // 如果没有前置条件，从所有实体开始
+                result = new Set(querySystem.getAllEntities());
+            }
+            const noneResult = querySystem.queryAny(...condition.none);
+            const noneSet = new Set(noneResult.entities);
+            result = new Set([...result].filter(e => !noneSet.has(e)));
+        }
+        return result ? Array.from(result) : [];
+    }
+    /**
+     * 更新系统
+     *
+     * 在每帧调用，处理系统的主要逻辑。
+     */
+    update() {
+        if (!this._enabled || !this.onCheckProcessing()) {
+            return;
+        }
+        const startTime = this._performanceMonitor.startMonitoring(this._systemName);
+        let entityCount = 0;
+        try {
+            this.onBegin();
+            // 动态查询实体并处理
+            const entities = this.queryEntities();
+            entityCount = entities.length;
+            this.process(entities);
+        }
+        finally {
+            this._performanceMonitor.endMonitoring(this._systemName, startTime, entityCount);
+        }
+    }
+    /**
+     * 后期更新系统
+     *
+     * 在所有系统的update方法执行完毕后调用。
+     */
+    lateUpdate() {
+        if (!this._enabled || !this.onCheckProcessing()) {
+            return;
+        }
+        const startTime = this._performanceMonitor.startMonitoring(`${this._systemName}_Late`);
+        let entityCount = 0;
+        try {
+            // 动态查询实体并处理
+            const entities = this.queryEntities();
+            entityCount = entities.length;
+            this.lateProcess(entities);
+            this.onEnd();
+        }
+        finally {
+            this._performanceMonitor.endMonitoring(`${this._systemName}_Late`, startTime, entityCount);
+        }
+    }
+    /**
+     * 在系统处理开始前调用
+     *
+     * 子类可以重写此方法进行预处理操作。
+     */
+    onBegin() {
+        // 子类可以重写此方法
+    }
+    /**
+     * 处理实体列表
+     *
+     * 系统的核心逻辑，子类必须实现此方法来定义具体的处理逻辑。
+     *
+     * @param entities 要处理的实体列表
+     */
+    process(entities) {
+        // 子类必须实现此方法
+    }
+    /**
+     * 后期处理实体列表
+     *
+     * 在主要处理逻辑之后执行，子类可以重写此方法。
+     *
+     * @param entities 要处理的实体列表
+     */
+    lateProcess(entities) {
+        // 子类可以重写此方法
+    }
+    /**
+     * 系统处理完毕后调用
+     *
+     * 子类可以重写此方法进行后处理操作。
+     */
+    onEnd() {
+        // 子类可以重写此方法
+    }
+    /**
+     * 检查系统是否需要处理
+     *
+     * 在启用系统时有用，但仅偶尔需要处理。
+     * 这只影响处理，不影响事件或订阅列表。
+     *
+     * @returns 如果系统应该处理，则为true，如果不处理则为false
+     */
+    onCheckProcessing() {
+        return true;
+    }
+    /**
+     * 获取系统的性能数据
+     *
+     * @returns 性能数据或undefined
+     */
+    getPerformanceData() {
+        return this._performanceMonitor.getSystemData(this._systemName);
+    }
+    /**
+     * 获取系统的性能统计
+     *
+     * @returns 性能统计或undefined
+     */
+    getPerformanceStats() {
+        return this._performanceMonitor.getSystemStats(this._systemName);
+    }
+    /**
+     * 重置系统的性能数据
+     */
+    resetPerformanceData() {
+        this._performanceMonitor.resetSystem(this._systemName);
+    }
+    /**
+     * 获取系统信息的字符串表示
+     *
+     * @returns 系统信息字符串
+     */
+    toString() {
+        const entityCount = this.entities.length;
+        const perfData = this.getPerformanceData();
+        const perfInfo = perfData ? ` (${perfData.executionTime.toFixed(2)}ms)` : '';
+        return `${this._systemName}[${entityCount} entities]${perfInfo}`;
+    }
+    /**
+     * 更新实体跟踪，检查新增和移除的实体
+     */
+    updateEntityTracking(currentEntities) {
+        const currentSet = new Set(currentEntities);
+        // 检查新增的实体
+        for (const entity of currentEntities) {
+            if (!this._trackedEntities.has(entity)) {
+                this._trackedEntities.add(entity);
+                this.onAdded(entity);
+            }
+        }
+        // 检查移除的实体
+        for (const entity of this._trackedEntities) {
+            if (!currentSet.has(entity)) {
+                this._trackedEntities.delete(entity);
+                this.onRemoved(entity);
+            }
+        }
+    }
+    /**
+     * 当实体被添加到系统时调用
+     *
+     * 子类可以重写此方法来处理实体添加事件。
+     *
+     * @param entity 被添加的实体
+     */
+    onAdded(_entity) {
+        // 子类可以重写此方法
+    }
+    /**
+     * 当实体从系统中移除时调用
+     *
+     * 子类可以重写此方法来处理实体移除事件。
+     *
+     * @param entity 被移除的实体
+     */
+    onRemoved(_entity) {
+        // 子类可以重写此方法
+    }
+}
+//# sourceMappingURL=EntitySystem.js.map

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

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

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

@@ -0,0 +1,33 @@
+import { EntitySystem } from './EntitySystem';
+import { Matcher } from '../Utils/Matcher';
+/**
+ * 间隔系统抽象类
+ * 定义一个按时间间隔处理的抽象类，继承自EntitySystem类
+ * 子类需要实现process方法，用于实现具体的处理逻辑
+ */
+export declare abstract class IntervalSystem extends EntitySystem {
+    /** 累积增量以跟踪间隔 */
+    private acc;
+    /** 更新之间需要等待多长时间 */
+    private readonly interval;
+    /** 时间间隔的余数，用于计算下一次需要等待的时间 */
+    private intervalRemainder;
+    /**
+     * 构造函数，初始化时间间隔
+     * @param interval 时间间隔
+     * @param matcher 实体匹配器
+     */
+    constructor(interval: number, matcher?: Matcher);
+    /**
+     * 判断是否需要进行处理
+     * 如果需要进行处理，则更新累积增量和时间间隔余数，返回true
+     * 否则返回false
+     */
+    protected onCheckProcessing(): boolean;
+    /**
+     * 获取本系统上次处理后的实际delta值
+     * 实际delta值等于时间间隔加上时间间隔余数
+     */
+    protected getIntervalDelta(): number;
+}
+//# sourceMappingURL=IntervalSystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IntervalSystem.d.ts","sourceRoot":"","sources":["../../../src/ECS/Systems/IntervalSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG3C;;;;GAIG;AACH,8BAAsB,cAAe,SAAQ,YAAY;IACrD,gBAAgB;IAChB,OAAO,CAAC,GAAG,CAAa;IACxB,mBAAmB;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,6BAA6B;IAC7B,OAAO,CAAC,iBAAiB,CAAa;IAEtC;;;;OAIG;gBACS,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAK/C;;;;OAIG;cACgB,iBAAiB,IAAI,OAAO;IAkB/C;;;OAGG;IACH,SAAS,CAAC,gBAAgB,IAAI,MAAM;CAGvC"}