@esengine/ecs-framework 2.1.28 → 2.1.30

package/bin/ECS/Core/ComponentIndex.js

@@ -0,0 +1,405 @@
+/**
+ * 组件索引类型
+ */
+export var IndexType;
+(function (IndexType) {
+    /** 哈希索引 - 最快查找 */
+    IndexType["HASH"] = "hash";
+    /** 位图索引 - 内存高效 */
+    IndexType["BITMAP"] = "bitmap";
+    /** 排序索引 - 支持范围查询 */
+    IndexType["SORTED"] = "sorted";
+})(IndexType || (IndexType = {}));
+/**
+ * 哈希索引实现
+ *
+ * 使用Map数据结构，提供O(1)的查找性能。
+ * 适合大多数查询场景。
+ */
+export class HashComponentIndex {
+    constructor() {
+        this.type = IndexType.HASH;
+        this._componentToEntities = new Map();
+        this._entityToComponents = new Map();
+        this._queryCount = 0;
+        this._totalQueryTime = 0;
+        this._lastUpdated = Date.now();
+        this._setPool = [];
+        this._componentTypeSetPool = [];
+    }
+    addEntity(entity) {
+        if (entity.components.length === 0) {
+            const componentTypes = this._componentTypeSetPool.pop() || new Set();
+            componentTypes.clear();
+            this._entityToComponents.set(entity, componentTypes);
+            this._lastUpdated = Date.now();
+            return;
+        }
+        const componentTypes = this._componentTypeSetPool.pop() || new Set();
+        componentTypes.clear();
+        for (const component of entity.components) {
+            const componentType = component.constructor;
+            componentTypes.add(componentType);
+            let entities = this._componentToEntities.get(componentType);
+            if (!entities) {
+                entities = this._setPool.pop() || new Set();
+                entities.clear();
+                this._componentToEntities.set(componentType, entities);
+            }
+            entities.add(entity);
+        }
+        this._entityToComponents.set(entity, componentTypes);
+        this._lastUpdated = Date.now();
+    }
+    removeEntity(entity) {
+        const componentTypes = this._entityToComponents.get(entity);
+        if (!componentTypes)
+            return;
+        for (const componentType of componentTypes) {
+            const entities = this._componentToEntities.get(componentType);
+            if (entities) {
+                entities.delete(entity);
+                if (entities.size === 0) {
+                    this._componentToEntities.delete(componentType);
+                    if (this._setPool.length < 50) {
+                        entities.clear();
+                        this._setPool.push(entities);
+                    }
+                }
+            }
+        }
+        this._entityToComponents.delete(entity);
+        if (this._componentTypeSetPool.length < 50) {
+            componentTypes.clear();
+            this._componentTypeSetPool.push(componentTypes);
+        }
+        this._lastUpdated = Date.now();
+    }
+    query(componentType) {
+        const startTime = performance.now();
+        const entities = this._componentToEntities.get(componentType);
+        const result = entities ? new Set(entities) : new Set();
+        this._queryCount++;
+        this._totalQueryTime += performance.now() - startTime;
+        return result;
+    }
+    queryMultiple(componentTypes, operation) {
+        const startTime = performance.now();
+        if (componentTypes.length === 0) {
+            return new Set();
+        }
+        if (componentTypes.length === 1) {
+            return this.query(componentTypes[0]);
+        }
+        let result;
+        if (operation === 'AND') {
+            let smallestSet;
+            let smallestSize = Infinity;
+            for (const componentType of componentTypes) {
+                const entities = this._componentToEntities.get(componentType);
+                if (!entities || entities.size === 0) {
+                    this._queryCount++;
+                    this._totalQueryTime += performance.now() - startTime;
+                    return new Set();
+                }
+                if (entities.size < smallestSize) {
+                    smallestSize = entities.size;
+                    smallestSet = entities;
+                }
+            }
+            result = new Set();
+            if (smallestSet) {
+                for (const entity of smallestSet) {
+                    let hasAll = true;
+                    for (const componentType of componentTypes) {
+                        const entities = this._componentToEntities.get(componentType);
+                        if (!entities || !entities.has(entity)) {
+                            hasAll = false;
+                            break;
+                        }
+                    }
+                    if (hasAll) {
+                        result.add(entity);
+                    }
+                }
+            }
+        }
+        else {
+            result = new Set();
+            for (const componentType of componentTypes) {
+                const entities = this._componentToEntities.get(componentType);
+                if (entities) {
+                    for (const entity of entities) {
+                        result.add(entity);
+                    }
+                }
+            }
+        }
+        this._queryCount++;
+        this._totalQueryTime += performance.now() - startTime;
+        return result;
+    }
+    clear() {
+        this._componentToEntities.clear();
+        this._entityToComponents.clear();
+        this._lastUpdated = Date.now();
+    }
+    getStats() {
+        let memoryUsage = 0;
+        memoryUsage += this._componentToEntities.size * 64;
+        memoryUsage += this._entityToComponents.size * 64;
+        for (const entities of this._componentToEntities.values()) {
+            memoryUsage += entities.size * 8;
+        }
+        for (const components of this._entityToComponents.values()) {
+            memoryUsage += components.size * 8;
+        }
+        return {
+            type: this.type,
+            size: this._componentToEntities.size,
+            memoryUsage,
+            queryCount: this._queryCount,
+            avgQueryTime: this._queryCount > 0 ? this._totalQueryTime / this._queryCount : 0,
+            lastUpdated: this._lastUpdated
+        };
+    }
+}
+/**
+ * 位图索引实现
+ *
+ * 使用位操作进行快速集合运算，内存效率高。
+ * 适合有限组件类型和大量实体的场景。
+ */
+export class BitmapComponentIndex {
+    constructor() {
+        this.type = IndexType.BITMAP;
+        this._componentTypeToBit = new Map();
+        this._entityToBitmap = new Map();
+        this._bitToEntities = new Map();
+        this._nextBit = 0;
+        this._queryCount = 0;
+        this._totalQueryTime = 0;
+        this._lastUpdated = Date.now();
+    }
+    addEntity(entity) {
+        let bitmap = 0;
+        for (const component of entity.components) {
+            const componentType = component.constructor;
+            let bit = this._componentTypeToBit.get(componentType);
+            if (bit === undefined) {
+                bit = this._nextBit++;
+                this._componentTypeToBit.set(componentType, bit);
+            }
+            bitmap |= (1 << bit);
+            let entities = this._bitToEntities.get(1 << bit);
+            if (!entities) {
+                entities = new Set();
+                this._bitToEntities.set(1 << bit, entities);
+            }
+            entities.add(entity);
+        }
+        this._entityToBitmap.set(entity, bitmap);
+        this._lastUpdated = Date.now();
+    }
+    removeEntity(entity) {
+        const bitmap = this._entityToBitmap.get(entity);
+        if (bitmap === undefined)
+            return;
+        // 从所有相关的位集合中移除实体
+        for (const [bitMask, entities] of this._bitToEntities) {
+            if ((bitmap & bitMask) !== 0) {
+                entities.delete(entity);
+                if (entities.size === 0) {
+                    this._bitToEntities.delete(bitMask);
+                }
+            }
+        }
+        this._entityToBitmap.delete(entity);
+        this._lastUpdated = Date.now();
+    }
+    query(componentType) {
+        const startTime = performance.now();
+        const bit = this._componentTypeToBit.get(componentType);
+        if (bit === undefined) {
+            this._queryCount++;
+            this._totalQueryTime += performance.now() - startTime;
+            return new Set();
+        }
+        const result = new Set(this._bitToEntities.get(1 << bit) || []);
+        this._queryCount++;
+        this._totalQueryTime += performance.now() - startTime;
+        return result;
+    }
+    queryMultiple(componentTypes, operation) {
+        const startTime = performance.now();
+        if (componentTypes.length === 0) {
+            return new Set();
+        }
+        let targetBitmap = 0;
+        const validBits = [];
+        for (const componentType of componentTypes) {
+            const bit = this._componentTypeToBit.get(componentType);
+            if (bit !== undefined) {
+                targetBitmap |= (1 << bit);
+                validBits.push(1 << bit);
+            }
+        }
+        const result = new Set();
+        if (operation === 'AND') {
+            for (const [entity, entityBitmap] of this._entityToBitmap) {
+                if ((entityBitmap & targetBitmap) === targetBitmap) {
+                    result.add(entity);
+                }
+            }
+        }
+        else {
+            for (const bitMask of validBits) {
+                const entities = this._bitToEntities.get(bitMask);
+                if (entities) {
+                    for (const entity of entities) {
+                        result.add(entity);
+                    }
+                }
+            }
+        }
+        this._queryCount++;
+        this._totalQueryTime += performance.now() - startTime;
+        return result;
+    }
+    clear() {
+        this._componentTypeToBit.clear();
+        this._entityToBitmap.clear();
+        this._bitToEntities.clear();
+        this._nextBit = 0;
+        this._lastUpdated = Date.now();
+    }
+    getStats() {
+        let memoryUsage = 0;
+        memoryUsage += this._componentTypeToBit.size * 12;
+        memoryUsage += this._entityToBitmap.size * 12;
+        memoryUsage += this._bitToEntities.size * 64;
+        for (const entities of this._bitToEntities.values()) {
+            memoryUsage += entities.size * 8;
+        }
+        return {
+            type: this.type,
+            size: this._componentTypeToBit.size,
+            memoryUsage,
+            queryCount: this._queryCount,
+            avgQueryTime: this._queryCount > 0 ? this._totalQueryTime / this._queryCount : 0,
+            lastUpdated: this._lastUpdated
+        };
+    }
+}
+/**
+ * 智能组件索引管理器
+ *
+ * 根据使用模式自动选择最优的索引策略。
+ * 支持动态切换索引类型以获得最佳性能。
+ */
+export class ComponentIndexManager {
+    constructor(initialType = IndexType.HASH) {
+        this._indexHistory = new Map();
+        this._autoOptimize = true;
+        this._optimizationThreshold = 1000;
+        this._activeIndex = this.createIndex(initialType);
+    }
+    /**
+     * 添加实体到索引
+     */
+    addEntity(entity) {
+        this._activeIndex.addEntity(entity);
+        if (this._autoOptimize && this._activeIndex.getStats().queryCount % 100 === 0) {
+            this.checkOptimization();
+        }
+    }
+    /**
+     * 从索引中移除实体
+     */
+    removeEntity(entity) {
+        this._activeIndex.removeEntity(entity);
+    }
+    /**
+     * 查询包含指定组件的实体
+     */
+    query(componentType) {
+        return this._activeIndex.query(componentType);
+    }
+    /**
+     * 批量查询多个组件
+     */
+    queryMultiple(componentTypes, operation) {
+        return this._activeIndex.queryMultiple(componentTypes, operation);
+    }
+    /**
+     * 手动切换索引类型
+     */
+    switchIndexType(type) {
+        if (type === this._activeIndex.type)
+            return;
+        this._indexHistory.set(this._activeIndex.type, this._activeIndex.getStats());
+        const oldIndex = this._activeIndex;
+        this._activeIndex = this.createIndex(type);
+        oldIndex.clear();
+    }
+    /**
+     * 启用/禁用自动优化
+     */
+    setAutoOptimize(enabled) {
+        this._autoOptimize = enabled;
+    }
+    /**
+     * 获取当前索引统计信息
+     */
+    getStats() {
+        return this._activeIndex.getStats();
+    }
+    /**
+     * 获取所有索引类型的历史统计信息
+     */
+    getAllStats() {
+        const current = this._activeIndex.getStats();
+        return new Map([
+            ...this._indexHistory,
+            [current.type, current]
+        ]);
+    }
+    /**
+     * 清空索引
+     */
+    clear() {
+        this._activeIndex.clear();
+    }
+    /**
+     * 创建指定类型的索引
+     */
+    createIndex(type) {
+        switch (type) {
+            case IndexType.HASH:
+                return new HashComponentIndex();
+            case IndexType.BITMAP:
+                return new BitmapComponentIndex();
+            case IndexType.SORTED:
+                return new HashComponentIndex();
+            default:
+                return new HashComponentIndex();
+        }
+    }
+    /**
+     * 检查是否需要优化索引
+     */
+    checkOptimization() {
+        if (!this._autoOptimize)
+            return;
+        const stats = this._activeIndex.getStats();
+        if (stats.queryCount < this._optimizationThreshold)
+            return;
+        if (stats.avgQueryTime > 1.0 && stats.type !== IndexType.HASH) {
+            this.switchIndexType(IndexType.HASH);
+        }
+        else if (stats.memoryUsage > 10 * 1024 * 1024 && stats.type !== IndexType.BITMAP) {
+            this.switchIndexType(IndexType.BITMAP);
+        }
+    }
+}
+//# sourceMappingURL=ComponentIndex.js.map

package/bin/ECS/Core/ComponentIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentIndex.js","sourceRoot":"","sources":["../../../src/ECS/Core/ComponentIndex.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,CAAN,IAAY,SAOX;AAPD,WAAY,SAAS;IACjB,kBAAkB;IAClB,0BAAa,CAAA;IACb,kBAAkB;IAClB,8BAAiB,CAAA;IACjB,oBAAoB;IACpB,8BAAiB,CAAA;AACrB,CAAC,EAPW,SAAS,KAAT,SAAS,QAOpB;AAwCD;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAA/B;QACoB,SAAI,GAAG,SAAS,CAAC,IAAI,CAAC;QAE9B,yBAAoB,GAAG,IAAI,GAAG,EAA8B,CAAC;QAC7D,wBAAmB,GAAG,IAAI,GAAG,EAA8B,CAAC;QAC5D,gBAAW,GAAG,CAAC,CAAC;QAChB,oBAAe,GAAG,CAAC,CAAC;QACpB,iBAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE1B,aAAQ,GAAkB,EAAE,CAAC;QAC7B,0BAAqB,GAAyB,EAAE,CAAC;IAmK7D,CAAC;IAjKU,SAAS,CAAC,MAAc;QAC3B,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,cAAc,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,IAAI,IAAI,GAAG,EAAiB,CAAC;YACpF,cAAc,CAAC,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YACrD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,OAAO;QACX,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,IAAI,IAAI,GAAG,EAAiB,CAAC;QACpF,cAAc,CAAC,KAAK,EAAE,CAAC;QAEvB,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,aAAa,GAAG,SAAS,CAAC,WAA4B,CAAC;YAC7D,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAElC,IAAI,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,IAAI,GAAG,EAAU,CAAC;gBACpD,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACjB,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;YAC3D,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;QAED,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACrD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;IAEM,YAAY,CAAC,MAAc;QAC9B,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,cAAc;YAAE,OAAO;QAE5B,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC9D,IAAI,QAAQ,EAAE,CAAC;gBACX,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACxB,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACtB,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;oBAChD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;wBAC5B,QAAQ,CAAC,KAAK,EAAE,CAAC;wBACjB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACjC,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;QAED,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAExC,IAAI,IAAI,CAAC,qBAAqB,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACzC,cAAc,CAAC,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;IAEM,KAAK,CAAC,aAA4B;QACrC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAU,CAAC;QAEhE,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,eAAe,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAEtD,OAAO,MAAM,CAAC;IAClB,CAAC;IAEM,aAAa,CAAC,cAA+B,EAAE,SAAuB;QACzE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEpC,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,GAAG,EAAE,CAAC;QACrB,CAAC;QAED,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,MAAmB,CAAC;QAExB,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YACtB,IAAI,WAAoC,CAAC;YACzC,IAAI,YAAY,GAAG,QAAQ,CAAC;YAE5B,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;gBACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBAC9D,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACnC,IAAI,CAAC,WAAW,EAAE,CAAC;oBACnB,IAAI,CAAC,eAAe,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBACtD,OAAO,IAAI,GAAG,EAAE,CAAC;gBACrB,CAAC;gBACD,IAAI,QAAQ,CAAC,IAAI,GAAG,YAAY,EAAE,CAAC;oBAC/B,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC;oBAC7B,WAAW,GAAG,QAAQ,CAAC;gBAC3B,CAAC;YACL,CAAC;YAED,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACnB,IAAI,WAAW,EAAE,CAAC;gBACd,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;oBAC/B,IAAI,MAAM,GAAG,IAAI,CAAC;oBAClB,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;wBACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;wBAC9D,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;4BACrC,MAAM,GAAG,KAAK,CAAC;4BACf,MAAM;wBACV,CAAC;oBACL,CAAC;oBACD,IAAI,MAAM,EAAE,CAAC;wBACT,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACvB,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACnB,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;gBACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBAC9D,IAAI,QAAQ,EAAE,CAAC;oBACX,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;wBAC5B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACvB,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,eAAe,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAEtD,OAAO,MAAM,CAAC;IAClB,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;IAEM,QAAQ;QACX,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,WAAW,IAAI,IAAI,CAAC,oBAAoB,CAAC,IAAI,GAAG,EAAE,CAAC;QACnD,WAAW,IAAI,IAAI,CAAC,mBAAmB,CAAC,IAAI,GAAG,EAAE,CAAC;QAElD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,EAAE,CAAC;YACxD,WAAW,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,EAAE,CAAC;YACzD,WAAW,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;QACvC,CAAC;QAED,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI;YACpC,WAAW;YACX,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,YAAY,EAAE,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAChF,WAAW,EAAE,IAAI,CAAC,YAAY;SACjC,CAAC;IACN,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IAAjC;QACoB,SAAI,GAAG,SAAS,CAAC,MAAM,CAAC;QAEhC,wBAAmB,GAAG,IAAI,GAAG,EAAyB,CAAC;QACvD,oBAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC5C,mBAAc,GAAG,IAAI,GAAG,EAAuB,CAAC;QAChD,aAAQ,GAAG,CAAC,CAAC;QACb,gBAAW,GAAG,CAAC,CAAC;QAChB,oBAAe,GAAG,CAAC,CAAC;QACpB,iBAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAuItC,CAAC;IArIU,SAAS,CAAC,MAAc;QAC3B,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,aAAa,GAAG,SAAS,CAAC,WAA4B,CAAC;YAC7D,IAAI,GAAG,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAEtD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACpB,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACtB,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;YACrD,CAAC;YAED,MAAM,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YAErB,IAAI,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;gBACrB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,EAAE,QAAQ,CAAC,CAAC;YAChD,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;IAEM,YAAY,CAAC,MAAc;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO;QAEjC,iBAAiB;QACjB,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACpD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACxB,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACtB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACxC,CAAC;YACL,CAAC;QACL,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;IAEM,KAAK,CAAC,aAA4B;QACrC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEpC,MAAM,GAAG,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACxD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,eAAe,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACtD,OAAO,IAAI,GAAG,EAAE,CAAC;QACrB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAEhE,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,eAAe,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAEtD,OAAO,MAAM,CAAC;IAClB,CAAC;IAEM,aAAa,CAAC,cAA+B,EAAE,SAAuB;QACzE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEpC,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,GAAG,EAAE,CAAC;QACrB,CAAC;QAED,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACxD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACpB,YAAY,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;gBAC3B,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YAC7B,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QAEjC,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACxD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC,KAAK,YAAY,EAAE,CAAC;oBACjD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACvB,CAAC;YACL,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;gBAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAClD,IAAI,QAAQ,EAAE,CAAC;oBACX,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;wBAC5B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACvB,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,eAAe,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAEtD,OAAO,MAAM,CAAC;IAClB,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;IAEM,QAAQ;QACX,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,WAAW,IAAI,IAAI,CAAC,mBAAmB,CAAC,IAAI,GAAG,EAAE,CAAC;QAClD,WAAW,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,GAAG,EAAE,CAAC;QAC9C,WAAW,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,EAAE,CAAC;QAE7C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;YAClD,WAAW,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI;YACnC,WAAW;YACX,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,YAAY,EAAE,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAChF,WAAW,EAAE,IAAI,CAAC,YAAY;SACjC,CAAC;IACN,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IAM9B,YAAY,cAAyB,SAAS,CAAC,IAAI;QAJ3C,kBAAa,GAA+B,IAAI,GAAG,EAAE,CAAC;QACtD,kBAAa,GAAG,IAAI,CAAC;QACrB,2BAAsB,GAAG,IAAI,CAAC;QAGlC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACI,SAAS,CAAC,MAAc;QAC3B,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAEpC,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,UAAU,GAAG,GAAG,KAAK,CAAC,EAAE,CAAC;YAC5E,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC7B,CAAC;IACL,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,MAAc;QAC9B,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAA4B;QACrC,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,cAA+B,EAAE,SAAuB;QACzE,OAAO,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACI,eAAe,CAAC,IAAe;QAClC,IAAI,IAAI,KAAK,IAAI,CAAC,YAAY,CAAC,IAAI;YAAE,OAAO;QAE5C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE7E,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAE3C,QAAQ,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACI,eAAe,CAAC,OAAgB;QACnC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,QAAQ;QACX,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACI,WAAW;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC7C,OAAO,IAAI,GAAG,CAAC;YACX,GAAG,IAAI,CAAC,aAAa;YACrB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SAC1B,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,IAAe;QAC/B,QAAQ,IAAI,EAAE,CAAC;YACX,KAAK,SAAS,CAAC,IAAI;gBACf,OAAO,IAAI,kBAAkB,EAAE,CAAC;YACpC,KAAK,SAAS,CAAC,MAAM;gBACjB,OAAO,IAAI,oBAAoB,EAAE,CAAC;YACtC,KAAK,SAAS,CAAC,MAAM;gBACjB,OAAO,IAAI,kBAAkB,EAAE,CAAC;YACpC;gBACI,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACxC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,iBAAiB;QACrB,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO;QAEhC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,sBAAsB;YAAE,OAAO;QAG3D,IAAI,KAAK,CAAC,YAAY,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAC5D,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,KAAK,CAAC,WAAW,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;YACjF,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;IACL,CAAC;CACJ"}

package/bin/ECS/Core/ComponentPool.d.ts

@@ -0,0 +1,88 @@
+import { Component } from '../Component';
+/**
+ * 组件对象池，用于复用组件实例以减少内存分配
+ */
+export declare class ComponentPool<T extends Component> {
+    private pool;
+    private createFn;
+    private resetFn?;
+    private maxSize;
+    constructor(createFn: () => T, resetFn?: (component: T) => void, maxSize?: number);
+    /**
+     * 获取一个组件实例
+     */
+    acquire(): T;
+    /**
+     * 释放一个组件实例回池中
+     */
+    release(component: T): void;
+    /**
+     * 预填充对象池
+     */
+    prewarm(count: number): void;
+    /**
+     * 清空对象池
+     */
+    clear(): void;
+    /**
+     * 获取池中可用对象数量
+     */
+    getAvailableCount(): number;
+    /**
+     * 获取池的最大容量
+     */
+    getMaxSize(): number;
+}
+/**
+ * 全局组件池管理器
+ */
+export declare class ComponentPoolManager {
+    private static instance;
+    private pools;
+    private constructor();
+    static getInstance(): ComponentPoolManager;
+    /**
+     * 注册组件池
+     */
+    registerPool<T extends Component>(componentName: string, createFn: () => T, resetFn?: (component: T) => void, maxSize?: number): void;
+    /**
+     * 获取组件实例
+     */
+    acquireComponent<T extends Component>(componentName: string): T | null;
+    /**
+     * 释放组件实例
+     */
+    releaseComponent<T extends Component>(componentName: string, component: T): void;
+    /**
+     * 预热所有池
+     */
+    prewarmAll(count?: number): void;
+    /**
+     * 清空所有池
+     */
+    clearAll(): void;
+    /**
+     * 重置管理器，移除所有注册的池
+     */
+    reset(): void;
+    /**
+     * 获取池统计信息
+     */
+    getPoolStats(): Map<string, {
+        available: number;
+        maxSize: number;
+    }>;
+    /**
+     * 获取池利用率信息（用于调试）
+     */
+    getPoolUtilization(): Map<string, {
+        used: number;
+        total: number;
+        utilization: number;
+    }>;
+    /**
+     * 获取指定组件的池利用率
+     */
+    getComponentUtilization(componentName: string): number;
+}
+//# sourceMappingURL=ComponentPool.d.ts.map

package/bin/ECS/Core/ComponentPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentPool.d.ts","sourceRoot":"","sources":["../../../src/ECS/Core/ComponentPool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;GAEG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,SAAS;IAC1C,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAyB;IACzC,OAAO,CAAC,OAAO,CAAS;gBAGpB,QAAQ,EAAE,MAAM,CAAC,EACjB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,EAChC,OAAO,GAAE,MAAa;IAO1B;;OAEG;IACH,OAAO,IAAI,CAAC;IAOZ;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,IAAI;IAS3B;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,UAAU,IAAI,MAAM;CAGvB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuB;IAC9C,OAAO,CAAC,KAAK,CAAyC;IAEtD,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,oBAAoB;IAO1C;;OAEG;IACH,YAAY,CAAC,CAAC,SAAS,SAAS,EAC5B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,CAAC,EACjB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,EAChC,OAAO,CAAC,EAAE,MAAM,GACjB,IAAI;IAIP;;OAEG;IACH,gBAAgB,CAAC,CAAC,SAAS,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAKtE;;OAEG;IACH,gBAAgB,CAAC,CAAC,SAAS,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI;IAOhF;;OAEG;IACH,UAAU,CAAC,KAAK,GAAE,MAAY,GAAG,IAAI;IAMrC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAMhB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAWnE;;OAEG;IACH,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBvF;;OAEG;IACH,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;CAUzD"}

package/bin/ECS/Core/ComponentPool.js

@@ -0,0 +1,159 @@
+/**
+ * 组件对象池，用于复用组件实例以减少内存分配
+ */
+export class ComponentPool {
+    constructor(createFn, resetFn, maxSize = 1000) {
+        this.pool = [];
+        this.createFn = createFn;
+        this.resetFn = resetFn;
+        this.maxSize = maxSize;
+    }
+    /**
+     * 获取一个组件实例
+     */
+    acquire() {
+        if (this.pool.length > 0) {
+            return this.pool.pop();
+        }
+        return this.createFn();
+    }
+    /**
+     * 释放一个组件实例回池中
+     */
+    release(component) {
+        if (this.pool.length < this.maxSize) {
+            if (this.resetFn) {
+                this.resetFn(component);
+            }
+            this.pool.push(component);
+        }
+    }
+    /**
+     * 预填充对象池
+     */
+    prewarm(count) {
+        for (let i = 0; i < count && this.pool.length < this.maxSize; i++) {
+            this.pool.push(this.createFn());
+        }
+    }
+    /**
+     * 清空对象池
+     */
+    clear() {
+        this.pool.length = 0;
+    }
+    /**
+     * 获取池中可用对象数量
+     */
+    getAvailableCount() {
+        return this.pool.length;
+    }
+    /**
+     * 获取池的最大容量
+     */
+    getMaxSize() {
+        return this.maxSize;
+    }
+}
+/**
+ * 全局组件池管理器
+ */
+export class ComponentPoolManager {
+    constructor() {
+        this.pools = new Map();
+    }
+    static getInstance() {
+        if (!ComponentPoolManager.instance) {
+            ComponentPoolManager.instance = new ComponentPoolManager();
+        }
+        return ComponentPoolManager.instance;
+    }
+    /**
+     * 注册组件池
+     */
+    registerPool(componentName, createFn, resetFn, maxSize) {
+        this.pools.set(componentName, new ComponentPool(createFn, resetFn, maxSize));
+    }
+    /**
+     * 获取组件实例
+     */
+    acquireComponent(componentName) {
+        const pool = this.pools.get(componentName);
+        return pool ? pool.acquire() : null;
+    }
+    /**
+     * 释放组件实例
+     */
+    releaseComponent(componentName, component) {
+        const pool = this.pools.get(componentName);
+        if (pool) {
+            pool.release(component);
+        }
+    }
+    /**
+     * 预热所有池
+     */
+    prewarmAll(count = 100) {
+        for (const pool of this.pools.values()) {
+            pool.prewarm(count);
+        }
+    }
+    /**
+     * 清空所有池
+     */
+    clearAll() {
+        for (const pool of this.pools.values()) {
+            pool.clear();
+        }
+    }
+    /**
+     * 重置管理器，移除所有注册的池
+     */
+    reset() {
+        this.pools.clear();
+    }
+    /**
+     * 获取池统计信息
+     */
+    getPoolStats() {
+        const stats = new Map();
+        for (const [name, pool] of this.pools) {
+            stats.set(name, {
+                available: pool.getAvailableCount(),
+                maxSize: pool.getMaxSize()
+            });
+        }
+        return stats;
+    }
+    /**
+     * 获取池利用率信息（用于调试）
+     */
+    getPoolUtilization() {
+        const utilization = new Map();
+        for (const [name, pool] of this.pools) {
+            const available = pool.getAvailableCount();
+            const maxSize = pool.getMaxSize();
+            const used = maxSize - available;
+            const utilRate = maxSize > 0 ? (used / maxSize * 100) : 0;
+            utilization.set(name, {
+                used: used,
+                total: maxSize,
+                utilization: utilRate
+            });
+        }
+        return utilization;
+    }
+    /**
+     * 获取指定组件的池利用率
+     */
+    getComponentUtilization(componentName) {
+        const pool = this.pools.get(componentName);
+        if (!pool)
+            return 0;
+        const available = pool.getAvailableCount();
+        const maxSize = pool.getMaxSize();
+        const used = maxSize - available;
+        return maxSize > 0 ? (used / maxSize * 100) : 0;
+    }
+}
+//# sourceMappingURL=ComponentPool.js.map

package/bin/ECS/Core/ComponentPool.js.map

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