@esengine/ecs-framework 2.3.0 → 2.3.1

package/bin/ECS/Component.js

@@ -1,105 +0,0 @@
-import { __decorate, __metadata } from "tslib";
-import { Int32 } from './Core/SoAStorage';
-/**
- * 游戏组件基类
- *
- * ECS架构中的组件（Component）应该是纯数据容器。
- * 所有游戏逻辑应该在 EntitySystem 中实现，而不是在组件内部。
- *
- * @example
- * 推荐做法：纯数据组件
- * ```typescript
- * class HealthComponent extends Component {
- *     public health: number = 100;
- *     public maxHealth: number = 100;
- * }
- * ```
- *
- * @example
- * 推荐做法：在 System 中处理逻辑
- * ```typescript
- * class HealthSystem extends EntitySystem {
- *     process(entities: Entity[]): void {
- *         for (const entity of entities) {
- *             const health = entity.getComponent(HealthComponent);
- *             if (health && health.health <= 0) {
- *                 entity.destroy();
- *             }
- *         }
- *     }
- * }
- * ```
- */
-export class Component {
-    /**
-     * 创建组件实例
-     *
-     * 自动分配唯一ID给组件。
-     */
-    constructor() {
-        /**
-         * 所属实体ID
-         *
-         * 存储实体ID而非引用，避免循环引用，符合ECS数据导向设计。
-         */
-        this.entityId = null;
-        this.id = Component.idGenerator++;
-    }
-    /**
-     * 组件添加到实体时的回调
-     *
-     * 当组件被添加到实体时调用，可以在此方法中进行初始化操作。
-     *
-     * @remarks
-     * 这是一个生命周期钩子，用于组件的初始化逻辑。
-     * 虽然保留此方法，但建议将复杂的初始化逻辑放在 System 中处理。
-     */
-    onAddedToEntity() { }
-    /**
-     * 组件从实体移除时的回调
-     *
-     * 当组件从实体中移除时调用，可以在此方法中进行清理操作。
-     *
-     * @remarks
-     * 这是一个生命周期钩子，用于组件的清理逻辑。
-     * 虽然保留此方法，但建议将复杂的清理逻辑放在 System 中处理。
-     */
-    onRemovedFromEntity() { }
-    /**
-     * 组件反序列化后的回调
-     *
-     * 当组件从场景文件加载或快照恢复后调用，可以在此方法中恢复运行时数据。
-     *
-     * @remarks
-     * 这是一个生命周期钩子，用于恢复无法序列化的运行时数据。
-     * 例如：从图片路径重新加载图片尺寸信息，重建缓存等。
-     *
-     * @example
-     * ```typescript
-     * class TilemapComponent extends Component {
-     *     public tilesetImage: string = '';
-     *     private _tilesetData: TilesetData | undefined;
-     *
-     *     public async onDeserialized(): Promise<void> {
-     *         if (this.tilesetImage) {
-     *             // 重新加载 tileset 图片并恢复运行时数据
-     *             const img = await loadImage(this.tilesetImage);
-     *             this.setTilesetInfo(img.width, img.height, ...);
-     *         }
-     *     }
-     * }
-     * ```
-     */
-    onDeserialized() { }
-}
-/**
- * 组件ID生成器
- *
- * 用于为每个组件分配唯一的ID。
- */
-Component.idGenerator = 0;
-__decorate([
-    Int32,
-    __metadata("design:type", Object)
-], Component.prototype, "entityId", void 0);
-//# sourceMappingURL=Component.js.map

package/bin/ECS/Component.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Component.js","sourceRoot":"","sources":["../../src/ECS/Component.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAgB,SAAS;IAuB3B;;;;OAIG;IACH;QAbA;;;;WAIG;QAEI,aAAQ,GAAkB,IAAI,CAAC;QAQlC,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAED;;;;;;;;OAQG;IACI,eAAe,KAAU,CAAC;IAEjC;;;;;;;;OAQG;IACI,mBAAmB,KAAU,CAAC;IAErC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACI,cAAc,KAA0B,CAAC;;AA9EhD;;;;GAIG;AACY,qBAAW,GAAW,CAAC,AAAZ,CAAa;AAehC;IADN,KAAK;;2CACgC"}

package/bin/ECS/Components/HierarchyComponent.d.ts

@@ -1,46 +0,0 @@
-import { Component } from '../Component';
-/**
- * 层级关系组件 - 用于建立实体间的父子关系
- *
- * 只有需要层级关系的实体才添加此组件，遵循 ECS 组合原则。
- * 层级操作应通过 HierarchySystem 进行，而非直接修改此组件。
- *
- * @example
- * ```typescript
- * // 通过 HierarchySystem 设置父子关系
- * const hierarchySystem = scene.getSystem(HierarchySystem);
- * hierarchySystem.setParent(childEntity, parentEntity);
- *
- * // 查询层级信息
- * const parent = hierarchySystem.getParent(entity);
- * const children = hierarchySystem.getChildren(entity);
- * ```
- */
-export declare class HierarchyComponent extends Component {
-    /**
-     * 父实体 ID
-     * null 表示根实体（无父级）
-     */
-    parentId: number | null;
-    /**
-     * 子实体 ID 列表
-     * 顺序即为子级的排列顺序
-     */
-    childIds: number[];
-    /**
-     * 在层级中的深度
-     * 根实体深度为 0，由 HierarchySystem 维护
-     */
-    depth: number;
-    /**
-     * 层级中是否激活
-     * 考虑所有祖先的激活状态，由 HierarchySystem 维护
-     */
-    bActiveInHierarchy: boolean;
-    /**
-     * 层级缓存是否脏
-     * 用于优化缓存更新
-     */
-    bCacheDirty: boolean;
-}
-//# sourceMappingURL=HierarchyComponent.d.ts.map

package/bin/ECS/Components/HierarchyComponent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"HierarchyComponent.d.ts","sourceRoot":"","sources":["../../../src/ECS/Components/HierarchyComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAEa,kBAAmB,SAAQ,SAAS;IAC7C;;;OAGG;IAEI,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEtC;;;OAGG;IAEI,QAAQ,EAAE,MAAM,EAAE,CAAM;IAE/B;;;OAGG;IACI,KAAK,EAAE,MAAM,CAAK;IAEzB;;;OAGG;IACI,kBAAkB,EAAE,OAAO,CAAQ;IAE1C;;;OAGG;IACI,WAAW,EAAE,OAAO,CAAQ;CACtC"}

package/bin/ECS/Components/HierarchyComponent.js

@@ -1,65 +0,0 @@
-import { __decorate, __metadata } from "tslib";
-import { Component } from '../Component';
-import { ECSComponent } from '../Decorators';
-import { Serializable, Serialize } from '../Serialization/SerializationDecorators';
-/**
- * 层级关系组件 - 用于建立实体间的父子关系
- *
- * 只有需要层级关系的实体才添加此组件，遵循 ECS 组合原则。
- * 层级操作应通过 HierarchySystem 进行，而非直接修改此组件。
- *
- * @example
- * ```typescript
- * // 通过 HierarchySystem 设置父子关系
- * const hierarchySystem = scene.getSystem(HierarchySystem);
- * hierarchySystem.setParent(childEntity, parentEntity);
- *
- * // 查询层级信息
- * const parent = hierarchySystem.getParent(entity);
- * const children = hierarchySystem.getChildren(entity);
- * ```
- */
-let HierarchyComponent = class HierarchyComponent extends Component {
-    constructor() {
-        super(...arguments);
-        /**
-         * 父实体 ID
-         * null 表示根实体（无父级）
-         */
-        this.parentId = null;
-        /**
-         * 子实体 ID 列表
-         * 顺序即为子级的排列顺序
-         */
-        this.childIds = [];
-        /**
-         * 在层级中的深度
-         * 根实体深度为 0，由 HierarchySystem 维护
-         */
-        this.depth = 0;
-        /**
-         * 层级中是否激活
-         * 考虑所有祖先的激活状态，由 HierarchySystem 维护
-         */
-        this.bActiveInHierarchy = true;
-        /**
-         * 层级缓存是否脏
-         * 用于优化缓存更新
-         */
-        this.bCacheDirty = true;
-    }
-};
-__decorate([
-    Serialize(),
-    __metadata("design:type", Object)
-], HierarchyComponent.prototype, "parentId", void 0);
-__decorate([
-    Serialize(),
-    __metadata("design:type", Array)
-], HierarchyComponent.prototype, "childIds", void 0);
-HierarchyComponent = __decorate([
-    ECSComponent('Hierarchy'),
-    Serializable({ version: 1, typeId: 'Hierarchy' })
-], HierarchyComponent);
-export { HierarchyComponent };
-//# sourceMappingURL=HierarchyComponent.js.map

package/bin/ECS/Components/HierarchyComponent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"HierarchyComponent.js","sourceRoot":"","sources":["../../../src/ECS/Components/HierarchyComponent.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAEnF;;;;;;;;;;;;;;;;GAgBG;AAGI,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,SAAS;IAA1C;;QACH;;;WAGG;QAEI,aAAQ,GAAkB,IAAI,CAAC;QAEtC;;;WAGG;QAEI,aAAQ,GAAa,EAAE,CAAC;QAE/B;;;WAGG;QACI,UAAK,GAAW,CAAC,CAAC;QAEzB;;;WAGG;QACI,uBAAkB,GAAY,IAAI,CAAC;QAE1C;;;WAGG;QACI,gBAAW,GAAY,IAAI,CAAC;IACvC,CAAC;CAAA,CAAA;AA1BU;IADN,SAAS,EAAE;;oDAC0B;AAO/B;IADN,SAAS,EAAE;;oDACmB;AAbtB,kBAAkB;IAF9B,YAAY,CAAC,WAAW,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;GACrC,kBAAkB,CAgC9B"}

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

@@ -1,2 +0,0 @@
-export { HierarchyComponent } from './HierarchyComponent';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ECS/Components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/bin/ECS/Components/index.js

@@ -1,2 +0,0 @@
-export { HierarchyComponent } from './HierarchyComponent';
-//# sourceMappingURL=index.js.map

package/bin/ECS/Components/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ECS/Components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -1,103 +0,0 @@
-import { Entity } from '../Entity';
-import { ComponentType } from './ComponentStorage';
-import { BitMask64Data } from '../Utils';
-/**
- * 原型标识符
- */
-export type ArchetypeId = BitMask64Data;
-/**
- * 原型数据结构
- */
-export interface Archetype {
-    /** 原型唯一标识符 */
-    id: ArchetypeId;
-    /** 包含的组件类型 */
-    componentTypes: ComponentType[];
-    /** 属于该原型的实体集合 */
-    entities: Set<Entity>;
-}
-/**
- * 原型查询结果
- */
-export interface ArchetypeQueryResult {
-    /** 匹配的原型列表 */
-    archetypes: Archetype[];
-    /** 所有匹配实体的总数 */
-    totalEntities: number;
-}
-/**
- * Archetype系统
- *
- * 根据实体的组件组合将实体分组到不同的原型中，提供高效的查询性能。
- */
-export declare class ArchetypeSystem {
-    /** 所有原型的映射表 */
-    private _archetypes;
-    /** 实体到原型的映射 */
-    private _entityToArchetype;
-    /** 组件类型到原型的映射 */
-    private _componentToArchetypes;
-    /** 实体组件类型缓存 */
-    private _entityComponentTypesCache;
-    /** 所有原型 */
-    private _allArchetypes;
-    /**
-     * 添加实体到原型系统
-     */
-    addEntity(entity: Entity): void;
-    /**
-     * 从原型系统中移除实体
-     */
-    removeEntity(entity: Entity): void;
-    /**
-     * 更新实体的原型归属
-     *
-     * 当实体的组件组合发生变化时调用此方法，将实体从旧原型移动到新原型。
-     * 如果新的组件组合对应的原型不存在，将自动创建新原型。
-     *
-     * @param entity 要更新的实体
-     */
-    updateEntity(entity: Entity): void;
-    /**
-     * 查询包含指定组件组合的原型
-     *
-     * @param componentTypes 要查询的组件类型列表
-     * @param operation 查询操作类型：'AND'（包含所有）或 'OR'（包含任意）
-     * @returns 匹配的原型列表及实体总数
-     */
-    queryArchetypes(componentTypes: ComponentType[], operation?: 'AND' | 'OR'): ArchetypeQueryResult;
-    /**
-     * 获取实体所属的原型
-     */
-    getEntityArchetype(entity: Entity): Archetype | undefined;
-    /**
-     * 获取所有原型
-     */
-    getAllArchetypes(): Archetype[];
-    /**
-     * 获取包含指定组件类型的所有实体
-     */
-    getEntitiesByComponent(componentType: ComponentType): Entity[];
-    /**
-     * 清空所有数据
-     */
-    clear(): void;
-    /**
-     * 更新所有原型数组
-     */
-    private updateAllArchetypeArrays;
-    /**
-     * 获取实体的组件类型列表
-     */
-    private getEntityComponentTypes;
-    /**
-     * 生成原型ID
-     * 使用ComponentRegistry确保与Entity.componentMask使用相同的bitIndex
-     */
-    private generateArchetypeId;
-    /**
-     * 创建新原型
-     */
-    private createArchetype;
-}
-//# sourceMappingURL=ArchetypeSystem.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ArchetypeSystem.d.ts","sourceRoot":"","sources":["../../../src/ECS/Core/ArchetypeSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,aAAa,EAAqB,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAkB,MAAM,UAAU,CAAC;AAGzD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,cAAc;IACd,EAAE,EAAE,WAAW,CAAC;IAChB,cAAc;IACd,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,iBAAiB;IACjB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,cAAc;IACd,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,gBAAgB;IAChB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,eAAe;IACxB,eAAe;IACf,OAAO,CAAC,WAAW,CAAmC;IAEtD,eAAe;IACf,OAAO,CAAC,kBAAkB,CAAgC;IAE1D,iBAAiB;IACjB,OAAO,CAAC,sBAAsB,CAA4C;IAE1E,eAAe;IACf,OAAO,CAAC,0BAA0B,CAAsC;IAExE,WAAW;IACX,OAAO,CAAC,cAAc,CAAmB;IAEzC;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAatC;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAWzC;;;;;;;OAOG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA8BzC;;;;;;OAMG;IACI,eAAe,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE,SAAS,GAAE,KAAK,GAAG,IAAY,GAAG,oBAAoB;IAyE9G;;OAEG;IACI,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIhE;;OAEG;IACI,gBAAgB,IAAI,SAAS,EAAE;IAItC;;OAEG;IACI,sBAAsB,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,EAAE;IAerE;;OAEG;IACI,KAAK,IAAI,IAAI;IAQpB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAOhC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAS/B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,OAAO,CAAC,eAAe;CAwB1B"}

package/bin/ECS/Core/ArchetypeSystem.js

@@ -1,244 +0,0 @@
-import { ComponentRegistry } from './ComponentStorage';
-import { BitMask64Utils } from '../Utils';
-import { BitMaskHashMap } from '../Utils/BitMaskHashMap';
-/**
- * Archetype系统
- *
- * 根据实体的组件组合将实体分组到不同的原型中，提供高效的查询性能。
- */
-export class ArchetypeSystem {
-    constructor() {
-        /** 所有原型的映射表 */
-        this._archetypes = new BitMaskHashMap();
-        /** 实体到原型的映射 */
-        this._entityToArchetype = new Map();
-        /** 组件类型到原型的映射 */
-        this._componentToArchetypes = new Map();
-        /** 实体组件类型缓存 */
-        this._entityComponentTypesCache = new Map();
-        /** 所有原型 */
-        this._allArchetypes = [];
-    }
-    /**
-     * 添加实体到原型系统
-     */
-    addEntity(entity) {
-        const componentTypes = this.getEntityComponentTypes(entity);
-        const archetypeId = this.generateArchetypeId(componentTypes);
-        let archetype = this._archetypes.get(archetypeId);
-        if (!archetype) {
-            archetype = this.createArchetype(componentTypes);
-        }
-        archetype.entities.add(entity);
-        this._entityToArchetype.set(entity, archetype);
-    }
-    /**
-     * 从原型系统中移除实体
-     */
-    removeEntity(entity) {
-        const archetype = this._entityToArchetype.get(entity);
-        if (!archetype)
-            return;
-        archetype.entities.delete(entity);
-        // 清理实体相关缓存
-        this._entityComponentTypesCache.delete(entity);
-        this._entityToArchetype.delete(entity);
-    }
-    /**
-     * 更新实体的原型归属
-     *
-     * 当实体的组件组合发生变化时调用此方法，将实体从旧原型移动到新原型。
-     * 如果新的组件组合对应的原型不存在，将自动创建新原型。
-     *
-     * @param entity 要更新的实体
-     */
-    updateEntity(entity) {
-        const currentArchetype = this._entityToArchetype.get(entity);
-        // 清理实体组件类型缓存，强制重新计算
-        this._entityComponentTypesCache.delete(entity);
-        const newComponentTypes = this.getEntityComponentTypes(entity);
-        const newArchetypeId = this.generateArchetypeId(newComponentTypes);
-        // 如果实体已在正确的原型中，无需更新
-        if (currentArchetype && currentArchetype.id === newArchetypeId) {
-            return;
-        }
-        // 从旧原型中移除实体
-        if (currentArchetype) {
-            currentArchetype.entities.delete(entity);
-        }
-        // 获取或创建新原型
-        let newArchetype = this._archetypes.get(newArchetypeId);
-        if (!newArchetype) {
-            newArchetype = this.createArchetype(newComponentTypes);
-        }
-        // 将实体添加到新原型
-        newArchetype.entities.add(entity);
-        this._entityToArchetype.set(entity, newArchetype);
-    }
-    /**
-     * 查询包含指定组件组合的原型
-     *
-     * @param componentTypes 要查询的组件类型列表
-     * @param operation 查询操作类型：'AND'（包含所有）或 'OR'（包含任意）
-     * @returns 匹配的原型列表及实体总数
-     */
-    queryArchetypes(componentTypes, operation = 'AND') {
-        const matchingArchetypes = [];
-        let totalEntities = 0;
-        if (operation === 'AND') {
-            if (componentTypes.length === 0) {
-                for (const archetype of this._allArchetypes) {
-                    matchingArchetypes.push(archetype);
-                    totalEntities += archetype.entities.size;
-                }
-                return { archetypes: matchingArchetypes, totalEntities };
-            }
-            if (componentTypes.length === 1) {
-                const archetypes = this._componentToArchetypes.get(componentTypes[0]);
-                if (archetypes) {
-                    for (const archetype of archetypes) {
-                        matchingArchetypes.push(archetype);
-                        totalEntities += archetype.entities.size;
-                    }
-                }
-                return { archetypes: matchingArchetypes, totalEntities };
-            }
-            let smallestSet;
-            let smallestSize = Infinity;
-            for (const componentType of componentTypes) {
-                const archetypes = this._componentToArchetypes.get(componentType);
-                if (!archetypes || archetypes.size === 0) {
-                    return { archetypes: [], totalEntities: 0 };
-                }
-                if (archetypes.size < smallestSize) {
-                    smallestSize = archetypes.size;
-                    smallestSet = archetypes;
-                }
-            }
-            const queryMask = this.generateArchetypeId(componentTypes);
-            if (smallestSet) {
-                for (const archetype of smallestSet) {
-                    if (BitMask64Utils.hasAll(archetype.id, queryMask)) {
-                        matchingArchetypes.push(archetype);
-                        totalEntities += archetype.entities.size;
-                    }
-                }
-            }
-        }
-        else {
-            const foundArchetypes = new Set();
-            for (const componentType of componentTypes) {
-                const archetypes = this._componentToArchetypes.get(componentType);
-                if (archetypes) {
-                    for (const archetype of archetypes) {
-                        foundArchetypes.add(archetype);
-                    }
-                }
-            }
-            for (const archetype of foundArchetypes) {
-                matchingArchetypes.push(archetype);
-                totalEntities += archetype.entities.size;
-            }
-        }
-        return {
-            archetypes: matchingArchetypes,
-            totalEntities
-        };
-    }
-    /**
-     * 获取实体所属的原型
-     */
-    getEntityArchetype(entity) {
-        return this._entityToArchetype.get(entity);
-    }
-    /**
-     * 获取所有原型
-     */
-    getAllArchetypes() {
-        return this._allArchetypes.slice();
-    }
-    /**
-     * 获取包含指定组件类型的所有实体
-     */
-    getEntitiesByComponent(componentType) {
-        const archetypes = this._componentToArchetypes.get(componentType);
-        if (!archetypes || archetypes.size === 0) {
-            return [];
-        }
-        const entities = [];
-        for (const archetype of archetypes) {
-            for (const entity of archetype.entities) {
-                entities.push(entity);
-            }
-        }
-        return entities;
-    }
-    /**
-     * 清空所有数据
-     */
-    clear() {
-        this._archetypes.clear();
-        this._entityToArchetype.clear();
-        this._componentToArchetypes.clear();
-        this._entityComponentTypesCache.clear();
-        this._allArchetypes = [];
-    }
-    /**
-     * 更新所有原型数组
-     */
-    updateAllArchetypeArrays() {
-        this._allArchetypes = [];
-        for (const archetype of this._archetypes.values()) {
-            this._allArchetypes.push(archetype);
-        }
-    }
-    /**
-     * 获取实体的组件类型列表
-     */
-    getEntityComponentTypes(entity) {
-        let componentTypes = this._entityComponentTypesCache.get(entity);
-        if (!componentTypes) {
-            componentTypes = entity.components.map((component) => component.constructor);
-            this._entityComponentTypesCache.set(entity, componentTypes);
-        }
-        return componentTypes;
-    }
-    /**
-     * 生成原型ID
-     * 使用ComponentRegistry确保与Entity.componentMask使用相同的bitIndex
-     */
-    generateArchetypeId(componentTypes) {
-        const mask = BitMask64Utils.clone(BitMask64Utils.ZERO);
-        for (const type of componentTypes) {
-            if (!ComponentRegistry.isRegistered(type)) {
-                ComponentRegistry.register(type);
-            }
-            const bitMask = ComponentRegistry.getBitMask(type);
-            BitMask64Utils.orInPlace(mask, bitMask);
-        }
-        return mask;
-    }
-    /**
-     * 创建新原型
-     */
-    createArchetype(componentTypes) {
-        const id = this.generateArchetypeId(componentTypes);
-        const archetype = {
-            id,
-            componentTypes: [...componentTypes],
-            entities: new Set()
-        };
-        this._archetypes.set(id, archetype);
-        this.updateAllArchetypeArrays();
-        for (const componentType of componentTypes) {
-            let archetypes = this._componentToArchetypes.get(componentType);
-            if (!archetypes) {
-                archetypes = new Set();
-                this._componentToArchetypes.set(componentType, archetypes);
-            }
-            archetypes.add(archetype);
-        }
-        return archetype;
-    }
-}
-//# sourceMappingURL=ArchetypeSystem.js.map

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

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