@esengine/ecs-framework 2.1.28 → 2.1.30

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

@@ -0,0 +1,108 @@
+import { Entity } from '../Entity';
+import { Component } from '../Component';
+/**
+ * 高性能实体列表管理器
+ * 管理场景中的所有实体，支持快速查找和批量操作
+ */
+export declare class EntityList {
+    buffer: Entity[];
+    private _scene;
+    private _idToEntity;
+    private _nameToEntities;
+    private _entitiesToAdd;
+    private _entitiesToRemove;
+    private _isUpdating;
+    get count(): number;
+    constructor(scene: any);
+    /**
+     * 添加实体（立即添加或延迟添加）
+     * @param entity 要添加的实体
+     */
+    add(entity: Entity): void;
+    /**
+     * 立即添加实体
+     * @param entity 要添加的实体
+     */
+    private addImmediate;
+    /**
+     * 移除实体（立即移除或延迟移除）
+     * @param entity 要移除的实体
+     */
+    remove(entity: Entity): void;
+    /**
+     * 立即移除实体
+     * @param entity 要移除的实体
+     */
+    private removeImmediate;
+    /**
+     * 移除所有实体
+     */
+    removeAllEntities(): void;
+    /**
+     * 更新实体列表，处理延迟操作
+     */
+    updateLists(): void;
+    /**
+     * 更新所有实体
+     */
+    update(): void;
+    /**
+     * 根据名称查找实体（使用索引，O(1)复杂度）
+     * @param name 实体名称
+     * @returns 找到的第一个实体或null
+     */
+    findEntity(name: string): Entity | null;
+    /**
+     * 根据名称查找所有实体
+     * @param name 实体名称
+     * @returns 找到的所有实体数组
+     */
+    findEntitiesByName(name: string): Entity[];
+    /**
+     * 根据ID查找实体（使用索引，O(1)复杂度）
+     * @param id 实体ID
+     * @returns 找到的实体或null
+     */
+    findEntityById(id: number): Entity | null;
+    /**
+     * 根据标签查找实体
+     * @param tag 标签
+     * @returns 找到的所有实体数组
+     */
+    findEntitiesByTag(tag: number): Entity[];
+    /**
+     * 根据组件类型查找实体
+     * @param componentType 组件类型
+     * @returns 找到的所有实体数组
+     */
+    findEntitiesWithComponent<T extends Component>(componentType: new (...args: unknown[]) => T): Entity[];
+    /**
+     * 批量操作：对所有实体执行指定操作
+     * @param action 要执行的操作
+     */
+    forEach(action: (entity: Entity) => void): void;
+    /**
+     * 批量操作：对符合条件的实体执行指定操作
+     * @param predicate 筛选条件
+     * @param action 要执行的操作
+     */
+    forEachWhere(predicate: (entity: Entity) => boolean, action: (entity: Entity) => void): void;
+    /**
+     * 更新名称索引
+     * @param entity 实体
+     * @param isAdd 是否为添加操作
+     */
+    private updateNameIndex;
+    /**
+     * 获取实体列表的统计信息
+     * @returns 统计信息
+     */
+    getStats(): {
+        totalEntities: number;
+        activeEntities: number;
+        pendingAdd: number;
+        pendingRemove: number;
+        nameIndexSize: number;
+    };
+}
+//# sourceMappingURL=EntityList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntityList.d.ts","sourceRoot":"","sources":["../../../src/ECS/Utils/EntityList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;;GAGG;AACH,qBAAa,UAAU;IACZ,MAAM,EAAE,MAAM,EAAE,CAAM;IAC7B,OAAO,CAAC,MAAM,CAAM;IAGpB,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,eAAe,CAA+B;IAGtD,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,WAAW,CAAS;IAE5B,IAAW,KAAK,IAAI,MAAM,CAEzB;gBAEW,KAAK,EAAE,GAAG;IAItB;;;OAGG;IACI,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAShC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAapB;;;OAGG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASnC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACI,iBAAiB,IAAI,IAAI;IAuBhC;;OAEG;IACI,WAAW,IAAI,IAAI;IAkB1B;;OAEG;IACI,MAAM,IAAI,IAAI;IAkBrB;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK9C;;;;OAIG;IACI,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAIjD;;;;OAIG;IACI,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIhD;;;;OAIG;IACI,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAY/C;;;;OAIG;IACI,yBAAyB,CAAC,CAAC,SAAS,SAAS,EAAE,aAAa,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE;IAY7G;;;OAGG;IACI,OAAO,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAMtD;;;;OAIG;IACI,YAAY,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAQnG;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA4BvB;;;OAGG;IACI,QAAQ,IAAI;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACzB;CAgBJ"}

package/bin/ECS/Utils/EntityList.js

@@ -0,0 +1,262 @@
+/**
+ * 高性能实体列表管理器
+ * 管理场景中的所有实体，支持快速查找和批量操作
+ */
+export class EntityList {
+    get count() {
+        return this.buffer.length;
+    }
+    constructor(scene) {
+        this.buffer = [];
+        // 索引映射，提升查找性能
+        this._idToEntity = new Map();
+        this._nameToEntities = new Map();
+        // 延迟操作队列
+        this._entitiesToAdd = [];
+        this._entitiesToRemove = [];
+        this._isUpdating = false;
+        this._scene = scene;
+    }
+    /**
+     * 添加实体（立即添加或延迟添加）
+     * @param entity 要添加的实体
+     */
+    add(entity) {
+        if (this._isUpdating) {
+            // 如果正在更新中，延迟添加
+            this._entitiesToAdd.push(entity);
+        }
+        else {
+            this.addImmediate(entity);
+        }
+    }
+    /**
+     * 立即添加实体
+     * @param entity 要添加的实体
+     */
+    addImmediate(entity) {
+        // 检查是否已存在
+        if (this._idToEntity.has(entity.id)) {
+            return;
+        }
+        this.buffer.push(entity);
+        this._idToEntity.set(entity.id, entity);
+        // 更新名称索引
+        this.updateNameIndex(entity, true);
+    }
+    /**
+     * 移除实体（立即移除或延迟移除）
+     * @param entity 要移除的实体
+     */
+    remove(entity) {
+        if (this._isUpdating) {
+            // 如果正在更新中，延迟移除
+            this._entitiesToRemove.push(entity);
+        }
+        else {
+            this.removeImmediate(entity);
+        }
+    }
+    /**
+     * 立即移除实体
+     * @param entity 要移除的实体
+     */
+    removeImmediate(entity) {
+        const index = this.buffer.indexOf(entity);
+        if (index !== -1) {
+            this.buffer.splice(index, 1);
+            this._idToEntity.delete(entity.id);
+            // 更新名称索引
+            this.updateNameIndex(entity, false);
+            // 回收实体ID到ID池
+            if (this._scene && this._scene.identifierPool) {
+                this._scene.identifierPool.checkIn(entity.id);
+            }
+        }
+    }
+    /**
+     * 移除所有实体
+     */
+    removeAllEntities() {
+        // 收集所有实体ID用于回收
+        const idsToRecycle = [];
+        for (let i = this.buffer.length - 1; i >= 0; i--) {
+            idsToRecycle.push(this.buffer[i].id);
+            this.buffer[i].destroy();
+        }
+        // 批量回收ID
+        if (this._scene && this._scene.identifierPool) {
+            for (const id of idsToRecycle) {
+                this._scene.identifierPool.checkIn(id);
+            }
+        }
+        this.buffer.length = 0;
+        this._idToEntity.clear();
+        this._nameToEntities.clear();
+        this._entitiesToAdd.length = 0;
+        this._entitiesToRemove.length = 0;
+    }
+    /**
+     * 更新实体列表，处理延迟操作
+     */
+    updateLists() {
+        // 处理延迟添加的实体
+        if (this._entitiesToAdd.length > 0) {
+            for (const entity of this._entitiesToAdd) {
+                this.addImmediate(entity);
+            }
+            this._entitiesToAdd.length = 0;
+        }
+        // 处理延迟移除的实体
+        if (this._entitiesToRemove.length > 0) {
+            for (const entity of this._entitiesToRemove) {
+                this.removeImmediate(entity);
+            }
+            this._entitiesToRemove.length = 0;
+        }
+    }
+    /**
+     * 更新所有实体
+     */
+    update() {
+        this._isUpdating = true;
+        try {
+            for (let i = 0; i < this.buffer.length; i++) {
+                const entity = this.buffer[i];
+                if (entity.enabled && !entity.isDestroyed) {
+                    entity.update();
+                }
+            }
+        }
+        finally {
+            this._isUpdating = false;
+        }
+        // 处理延迟操作
+        this.updateLists();
+    }
+    /**
+     * 根据名称查找实体（使用索引，O(1)复杂度）
+     * @param name 实体名称
+     * @returns 找到的第一个实体或null
+     */
+    findEntity(name) {
+        const entities = this._nameToEntities.get(name);
+        return entities && entities.length > 0 ? entities[0] : null;
+    }
+    /**
+     * 根据名称查找所有实体
+     * @param name 实体名称
+     * @returns 找到的所有实体数组
+     */
+    findEntitiesByName(name) {
+        return this._nameToEntities.get(name) || [];
+    }
+    /**
+     * 根据ID查找实体（使用索引，O(1)复杂度）
+     * @param id 实体ID
+     * @returns 找到的实体或null
+     */
+    findEntityById(id) {
+        return this._idToEntity.get(id) || null;
+    }
+    /**
+     * 根据标签查找实体
+     * @param tag 标签
+     * @returns 找到的所有实体数组
+     */
+    findEntitiesByTag(tag) {
+        const result = [];
+        for (const entity of this.buffer) {
+            if (entity.tag === tag) {
+                result.push(entity);
+            }
+        }
+        return result;
+    }
+    /**
+     * 根据组件类型查找实体
+     * @param componentType 组件类型
+     * @returns 找到的所有实体数组
+     */
+    findEntitiesWithComponent(componentType) {
+        const result = [];
+        for (const entity of this.buffer) {
+            if (entity.hasComponent(componentType)) {
+                result.push(entity);
+            }
+        }
+        return result;
+    }
+    /**
+     * 批量操作：对所有实体执行指定操作
+     * @param action 要执行的操作
+     */
+    forEach(action) {
+        for (const entity of this.buffer) {
+            action(entity);
+        }
+    }
+    /**
+     * 批量操作：对符合条件的实体执行指定操作
+     * @param predicate 筛选条件
+     * @param action 要执行的操作
+     */
+    forEachWhere(predicate, action) {
+        for (const entity of this.buffer) {
+            if (predicate(entity)) {
+                action(entity);
+            }
+        }
+    }
+    /**
+     * 更新名称索引
+     * @param entity 实体
+     * @param isAdd 是否为添加操作
+     */
+    updateNameIndex(entity, isAdd) {
+        if (!entity.name) {
+            return;
+        }
+        if (isAdd) {
+            let entities = this._nameToEntities.get(entity.name);
+            if (!entities) {
+                entities = [];
+                this._nameToEntities.set(entity.name, entities);
+            }
+            entities.push(entity);
+        }
+        else {
+            const entities = this._nameToEntities.get(entity.name);
+            if (entities) {
+                const index = entities.indexOf(entity);
+                if (index !== -1) {
+                    entities.splice(index, 1);
+                    // 如果数组为空，删除映射
+                    if (entities.length === 0) {
+                        this._nameToEntities.delete(entity.name);
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * 获取实体列表的统计信息
+     * @returns 统计信息
+     */
+    getStats() {
+        let activeCount = 0;
+        for (const entity of this.buffer) {
+            if (entity.enabled && !entity.isDestroyed) {
+                activeCount++;
+            }
+        }
+        return {
+            totalEntities: this.buffer.length,
+            activeEntities: activeCount,
+            pendingAdd: this._entitiesToAdd.length,
+            pendingRemove: this._entitiesToRemove.length,
+            nameIndexSize: this._nameToEntities.size
+        };
+    }
+}
+//# sourceMappingURL=EntityList.js.map

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

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

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

@@ -0,0 +1,56 @@
+import { EntitySystem } from '../Systems/EntitySystem';
+/**
+ * 实体处理器列表管理器
+ * 管理场景中的所有实体系统
+ */
+export declare class EntityProcessorList {
+    private static readonly _logger;
+    private _processors;
+    private _isDirty;
+    /**
+     * 设置为脏状态，需要重新排序
+     */
+    setDirty(): void;
+    /**
+     * 添加实体处理器
+     * @param processor 要添加的处理器
+     */
+    add(processor: EntitySystem): void;
+    /**
+     * 移除实体处理器
+     * @param processor 要移除的处理器
+     */
+    remove(processor: EntitySystem): void;
+    /**
+     * 获取指定类型的处理器
+     * @param type 处理器类型
+     */
+    getProcessor<T extends EntitySystem>(type: new (...args: unknown[]) => T): T | null;
+    /**
+     * 开始处理
+     *
+     * 对所有处理器进行排序以确保正确的执行顺序。
+     */
+    begin(): void;
+    /**
+     * 结束处理
+     */
+    end(): void;
+    /**
+     * 更新所有处理器
+     */
+    update(): void;
+    /**
+     * 后期更新所有处理器
+     */
+    lateUpdate(): void;
+    /**
+     * 排序处理器
+     */
+    private sortProcessors;
+    /** 获取处理器列表 */
+    get processors(): EntitySystem[];
+    /** 获取处理器数量 */
+    get count(): number;
+}
+//# sourceMappingURL=EntityProcessorList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntityProcessorList.d.ts","sourceRoot":"","sources":["../../../src/ECS/Utils/EntityProcessorList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD;;;GAGG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAuC;IACtE,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,QAAQ,CAAS;IAEzB;;OAEG;IACI,QAAQ,IAAI,IAAI;IAIvB;;;OAGG;IACI,GAAG,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;IAKzC;;;OAGG;IACI,MAAM,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;IAO5C;;;OAGG;IACI,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI;IAS1F;;;;OAIG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,GAAG,IAAI,IAAI;IAIlB;;OAEG;IACI,MAAM,IAAI,IAAI;IAWrB;;OAEG;IACI,UAAU,IAAI,IAAI;IAMzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB,cAAc;IACd,IAAW,UAAU,mBAEpB;IAED,cAAc;IACd,IAAW,KAAK,WAEf;CAGJ"}

package/bin/ECS/Utils/EntityProcessorList.js

@@ -0,0 +1,102 @@
+import { createLogger } from '../../Utils/Logger';
+/**
+ * 实体处理器列表管理器
+ * 管理场景中的所有实体系统
+ */
+export class EntityProcessorList {
+    constructor() {
+        this._processors = [];
+        this._isDirty = false;
+    }
+    /**
+     * 设置为脏状态，需要重新排序
+     */
+    setDirty() {
+        this._isDirty = true;
+    }
+    /**
+     * 添加实体处理器
+     * @param processor 要添加的处理器
+     */
+    add(processor) {
+        this._processors.push(processor);
+        this.setDirty();
+    }
+    /**
+     * 移除实体处理器
+     * @param processor 要移除的处理器
+     */
+    remove(processor) {
+        const index = this._processors.indexOf(processor);
+        if (index !== -1) {
+            this._processors.splice(index, 1);
+        }
+    }
+    /**
+     * 获取指定类型的处理器
+     * @param type 处理器类型
+     */
+    getProcessor(type) {
+        for (const processor of this._processors) {
+            if (processor instanceof type) {
+                return processor;
+            }
+        }
+        return null;
+    }
+    /**
+     * 开始处理
+     *
+     * 对所有处理器进行排序以确保正确的执行顺序。
+     */
+    begin() {
+        this.sortProcessors();
+    }
+    /**
+     * 结束处理
+     */
+    end() {
+        // 清理处理器
+    }
+    /**
+     * 更新所有处理器
+     */
+    update() {
+        this.sortProcessors();
+        for (const processor of this._processors) {
+            try {
+                processor.update();
+            }
+            catch (error) {
+                EntityProcessorList._logger.error(`Error in processor ${processor.constructor.name}:`, error);
+            }
+        }
+    }
+    /**
+     * 后期更新所有处理器
+     */
+    lateUpdate() {
+        for (const processor of this._processors) {
+            processor.lateUpdate();
+        }
+    }
+    /**
+     * 排序处理器
+     */
+    sortProcessors() {
+        if (this._isDirty) {
+            this._processors.sort((a, b) => a.updateOrder - b.updateOrder);
+            this._isDirty = false;
+        }
+    }
+    /** 获取处理器列表 */
+    get processors() {
+        return this._processors;
+    }
+    /** 获取处理器数量 */
+    get count() {
+        return this._processors.length;
+    }
+}
+EntityProcessorList._logger = createLogger('EntityProcessorList');
+//# sourceMappingURL=EntityProcessorList.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntityProcessorList.js","sourceRoot":"","sources":["../../../src/ECS/Utils/EntityProcessorList.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAAhC;QAEY,gBAAW,GAAmB,EAAE,CAAC;QACjC,aAAQ,GAAG,KAAK,CAAC;IAsG7B,CAAC;IApGG;;OAEG;IACI,QAAQ;QACX,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;OAGG;IACI,GAAG,CAAC,SAAuB;QAC9B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;IACpB,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,SAAuB;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,YAAY,CAAyB,IAAmC;QAC3E,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,IAAI,SAAS,YAAY,IAAI,EAAE,CAAC;gBAC5B,OAAO,SAAc,CAAC;YAC1B,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,KAAK;QACR,IAAI,CAAC,cAAc,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,GAAG;QACN,QAAQ;IACZ,CAAC;IAED;;OAEG;IACI,MAAM;QACT,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,IAAI,CAAC;gBACD,SAAS,CAAC,MAAM,EAAE,CAAC;YACvB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,SAAS,CAAC,WAAW,CAAC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YAClG,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACI,UAAU;QACb,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,SAAS,CAAC,UAAU,EAAE,CAAC;QAC3B,CAAC;IACL,CAAC;IAED;;OAEG;IACK,cAAc;QAClB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;YAC/D,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QAC1B,CAAC;IACL,CAAC;IAED,cAAc;IACd,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,cAAc;IACd,IAAW,KAAK;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;IACnC,CAAC;;AArGuB,2BAAO,GAAG,YAAY,CAAC,qBAAqB,CAAC,AAAtC,CAAuC"}