@esengine/ecs-framework 2.2.20 → 2.3.0

package/bin/ECS/Component.js

@@ -0,0 +1,105 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,46 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,65 @@
+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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,103 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,244 @@
+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

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