@esengine/ecs-framework 2.2.20 → 2.3.0

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

@@ -0,0 +1,185 @@
+import { Component } from '../Component';
+import { BitMask64Data } from '../Utils/BigIntCompatibility';
+import { SoAStorage, SupportedTypedArray } from './SoAStorage';
+import { ComponentRegistry, ComponentType } from './ComponentStorage/ComponentRegistry';
+export { ComponentRegistry, ComponentType };
+/**
+ * 高性能组件存储器
+ */
+export declare class ComponentStorage<T extends Component> {
+    private dense;
+    private entityIds;
+    private entityToIndex;
+    private componentType;
+    constructor(componentType: ComponentType<T>);
+    /**
+     * 添加组件
+     * @param entityId 实体ID
+     * @param component 组件实例
+     */
+    addComponent(entityId: number, component: T): void;
+    /**
+     * 获取组件
+     * @param entityId 实体ID
+     * @returns 组件实例或null
+     */
+    getComponent(entityId: number): T | null;
+    /**
+     * 检查实体是否有此组件
+     * @param entityId 实体ID
+     * @returns 是否有组件
+     */
+    hasComponent(entityId: number): boolean;
+    /**
+     * 移除组件
+     * @param entityId 实体ID
+     * @returns 被移除的组件或null
+     */
+    removeComponent(entityId: number): T | null;
+    /**
+     * 高效遍历所有组件
+     * @param callback 回调函数
+     */
+    forEach(callback: (component: T, entityId: number, index: number) => void): void;
+    /**
+     * 获取所有组件
+     * @returns 组件数组
+     */
+    getDenseArray(): {
+        components: T[];
+        entityIds: number[];
+    };
+    /**
+     * 清空所有组件
+     */
+    clear(): void;
+    /**
+     * 获取组件数量
+     */
+    get size(): number;
+    /**
+     * 获取组件类型
+     */
+    get type(): ComponentType<T>;
+    /**
+     * 获取存储统计信息
+     */
+    getStats(): {
+        totalSlots: number;
+        usedSlots: number;
+        freeSlots: number;
+        fragmentation: number;
+    };
+}
+/**
+ * 组件存储管理器
+ * 管理所有组件类型的存储器
+ */
+export declare class ComponentStorageManager {
+    private static readonly _logger;
+    private storages;
+    /**
+     * 检查组件类型是否启用SoA存储
+     * @param componentType 组件类型
+     * @returns 是否为SoA存储
+     */
+    isSoAStorage<T extends Component>(componentType: ComponentType<T>): boolean;
+    /**
+     * 获取SoA存储器（类型安全）
+     * @param componentType 组件类型
+     * @returns SoA存储器或null
+     */
+    getSoAStorage<T extends Component>(componentType: ComponentType<T>): SoAStorage<T> | null;
+    /**
+     * 直接获取SoA字段数组（类型安全）
+     * @param componentType 组件类型
+     * @param fieldName 字段名
+     * @returns TypedArray或null
+     */
+    getFieldArray<T extends Component>(componentType: ComponentType<T>, fieldName: string): SupportedTypedArray | null;
+    /**
+     * 直接获取SoA字段数组（类型安全，带字段名检查）
+     * @param componentType 组件类型
+     * @param fieldName 字段名（类型检查）
+     * @returns TypedArray或null
+     */
+    getTypedFieldArray<T extends Component, K extends keyof T>(componentType: ComponentType<T>, fieldName: K): SupportedTypedArray | null;
+    /**
+     * 获取SoA存储的活跃索引
+     * @param componentType 组件类型
+     * @returns 活跃索引数组或空数组
+     */
+    getActiveIndices<T extends Component>(componentType: ComponentType<T>): number[];
+    /**
+     * 获取实体在SoA存储中的索引
+     * @param componentType 组件类型
+     * @param entityId 实体ID
+     * @returns 存储索引或undefined
+     */
+    getEntityIndex<T extends Component>(componentType: ComponentType<T>, entityId: number): number | undefined;
+    /**
+     * 根据索引获取实体ID
+     * @param componentType 组件类型
+     * @param index 存储索引
+     * @returns 实体ID或undefined
+     */
+    getEntityIdByIndex<T extends Component>(componentType: ComponentType<T>, index: number): number | undefined;
+    /**
+     * 获取或创建组件存储器（默认原始存储）
+     * @param componentType 组件类型
+     * @returns 组件存储器
+     */
+    getStorage<T extends Component>(componentType: ComponentType<T>): ComponentStorage<T> | SoAStorage<T>;
+    /**
+     * 添加组件
+     * @param entityId 实体ID
+     * @param component 组件实例
+     */
+    addComponent<T extends Component>(entityId: number, component: T): void;
+    /**
+     * 获取组件
+     * @param entityId 实体ID
+     * @param componentType 组件类型
+     * @returns 组件实例或null
+     */
+    getComponent<T extends Component>(entityId: number, componentType: ComponentType<T>): T | null;
+    /**
+     * 检查实体是否有组件
+     * @param entityId 实体ID
+     * @param componentType 组件类型
+     * @returns 是否有组件
+     */
+    hasComponent<T extends Component>(entityId: number, componentType: ComponentType<T>): boolean;
+    /**
+     * 移除组件
+     * @param entityId 实体ID
+     * @param componentType 组件类型
+     * @returns 被移除的组件或null
+     */
+    removeComponent<T extends Component>(entityId: number, componentType: ComponentType<T>): T | null;
+    /**
+     * 移除实体的所有组件
+     * @param entityId 实体ID
+     */
+    removeAllComponents(entityId: number): void;
+    /**
+     * 获取实体的组件位掩码
+     * @param entityId 实体ID
+     * @returns 组件位掩码
+     */
+    getComponentMask(entityId: number): BitMask64Data;
+    /**
+     * 获取所有存储器的统计信息
+     */
+    getAllStats(): Map<string, {
+        totalSlots: number;
+        usedSlots: number;
+        freeSlots: number;
+        fragmentation: number;
+    }>;
+    /**
+     * 清空所有存储器
+     */
+    clear(): void;
+}
+//# sourceMappingURL=ComponentStorage.d.ts.map

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

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

package/bin/ECS/Core/ComponentStorage.js

@@ -0,0 +1,321 @@
+import { BitMask64Utils } from '../Utils/BigIntCompatibility';
+import { SoAStorage } from './SoAStorage';
+import { createLogger } from '../../Utils/Logger';
+import { getComponentTypeName } from '../Decorators';
+import { ComponentRegistry } from './ComponentStorage/ComponentRegistry';
+// 导出核心类型
+export { ComponentRegistry };
+/**
+ * 高性能组件存储器
+ */
+export class ComponentStorage {
+    constructor(componentType) {
+        this.dense = [];
+        this.entityIds = [];
+        this.entityToIndex = new Map();
+        this.componentType = componentType;
+        // 确保组件类型已注册
+        if (!ComponentRegistry.isRegistered(componentType)) {
+            ComponentRegistry.register(componentType);
+        }
+    }
+    /**
+     * 添加组件
+     * @param entityId 实体ID
+     * @param component 组件实例
+     */
+    addComponent(entityId, component) {
+        // 检查实体是否已有此组件
+        if (this.entityToIndex.has(entityId)) {
+            throw new Error(`Entity ${entityId} already has component ${getComponentTypeName(this.componentType)}`);
+        }
+        // 末尾插入到致密数组
+        const index = this.dense.length;
+        this.dense.push(component);
+        this.entityIds.push(entityId);
+        this.entityToIndex.set(entityId, index);
+    }
+    /**
+     * 获取组件
+     * @param entityId 实体ID
+     * @returns 组件实例或null
+     */
+    getComponent(entityId) {
+        const index = this.entityToIndex.get(entityId);
+        return index !== undefined ? this.dense[index] : null;
+    }
+    /**
+     * 检查实体是否有此组件
+     * @param entityId 实体ID
+     * @returns 是否有组件
+     */
+    hasComponent(entityId) {
+        return this.entityToIndex.has(entityId);
+    }
+    /**
+     * 移除组件
+     * @param entityId 实体ID
+     * @returns 被移除的组件或null
+     */
+    removeComponent(entityId) {
+        const index = this.entityToIndex.get(entityId);
+        if (index === undefined) {
+            return null;
+        }
+        const component = this.dense[index];
+        const lastIndex = this.dense.length - 1;
+        if (index !== lastIndex) {
+            // 将末尾元素交换到要删除的位置
+            const lastComponent = this.dense[lastIndex];
+            const lastEntityId = this.entityIds[lastIndex];
+            this.dense[index] = lastComponent;
+            this.entityIds[index] = lastEntityId;
+            // 更新被交换元素的映射
+            this.entityToIndex.set(lastEntityId, index);
+        }
+        // 移除末尾元素
+        this.dense.pop();
+        this.entityIds.pop();
+        this.entityToIndex.delete(entityId);
+        return component;
+    }
+    /**
+     * 高效遍历所有组件
+     * @param callback 回调函数
+     */
+    forEach(callback) {
+        for (let i = 0; i < this.dense.length; i++) {
+            callback(this.dense[i], this.entityIds[i], i);
+        }
+    }
+    /**
+     * 获取所有组件
+     * @returns 组件数组
+     */
+    getDenseArray() {
+        return {
+            components: [...this.dense],
+            entityIds: [...this.entityIds]
+        };
+    }
+    /**
+     * 清空所有组件
+     */
+    clear() {
+        this.dense.length = 0;
+        this.entityIds.length = 0;
+        this.entityToIndex.clear();
+    }
+    /**
+     * 获取组件数量
+     */
+    get size() {
+        return this.dense.length;
+    }
+    /**
+     * 获取组件类型
+     */
+    get type() {
+        return this.componentType;
+    }
+    /**
+     * 获取存储统计信息
+     */
+    getStats() {
+        const totalSlots = this.dense.length;
+        const usedSlots = this.dense.length;
+        const freeSlots = 0; // 永远无空洞
+        const fragmentation = 0; // 永远无碎片
+        return {
+            totalSlots,
+            usedSlots,
+            freeSlots,
+            fragmentation
+        };
+    }
+}
+/**
+ * 组件存储管理器
+ * 管理所有组件类型的存储器
+ */
+export class ComponentStorageManager {
+    constructor() {
+        this.storages = new Map();
+    }
+    /**
+     * 检查组件类型是否启用SoA存储
+     * @param componentType 组件类型
+     * @returns 是否为SoA存储
+     */
+    isSoAStorage(componentType) {
+        const storage = this.storages.get(componentType);
+        return storage instanceof SoAStorage;
+    }
+    /**
+     * 获取SoA存储器（类型安全）
+     * @param componentType 组件类型
+     * @returns SoA存储器或null
+     */
+    getSoAStorage(componentType) {
+        const storage = this.getStorage(componentType);
+        return storage instanceof SoAStorage ? storage : null;
+    }
+    /**
+     * 直接获取SoA字段数组（类型安全）
+     * @param componentType 组件类型
+     * @param fieldName 字段名
+     * @returns TypedArray或null
+     */
+    getFieldArray(componentType, fieldName) {
+        const soaStorage = this.getSoAStorage(componentType);
+        return soaStorage ? soaStorage.getFieldArray(fieldName) : null;
+    }
+    /**
+     * 直接获取SoA字段数组（类型安全，带字段名检查）
+     * @param componentType 组件类型
+     * @param fieldName 字段名（类型检查）
+     * @returns TypedArray或null
+     */
+    getTypedFieldArray(componentType, fieldName) {
+        const soaStorage = this.getSoAStorage(componentType);
+        return soaStorage ? soaStorage.getTypedFieldArray(fieldName) : null;
+    }
+    /**
+     * 获取SoA存储的活跃索引
+     * @param componentType 组件类型
+     * @returns 活跃索引数组或空数组
+     */
+    getActiveIndices(componentType) {
+        const soaStorage = this.getSoAStorage(componentType);
+        return soaStorage ? soaStorage.getActiveIndices() : [];
+    }
+    /**
+     * 获取实体在SoA存储中的索引
+     * @param componentType 组件类型
+     * @param entityId 实体ID
+     * @returns 存储索引或undefined
+     */
+    getEntityIndex(componentType, entityId) {
+        const soaStorage = this.getSoAStorage(componentType);
+        return soaStorage ? soaStorage.getEntityIndex(entityId) : undefined;
+    }
+    /**
+     * 根据索引获取实体ID
+     * @param componentType 组件类型
+     * @param index 存储索引
+     * @returns 实体ID或undefined
+     */
+    getEntityIdByIndex(componentType, index) {
+        const soaStorage = this.getSoAStorage(componentType);
+        return soaStorage ? soaStorage.getEntityIdByIndex(index) : undefined;
+    }
+    /**
+     * 获取或创建组件存储器（默认原始存储）
+     * @param componentType 组件类型
+     * @returns 组件存储器
+     */
+    getStorage(componentType) {
+        let storage = this.storages.get(componentType);
+        if (!storage) {
+            // 检查是否启用SoA优化
+            const enableSoA = componentType.__enableSoA;
+            if (enableSoA) {
+                // 使用SoA优化存储
+                storage = new SoAStorage(componentType);
+                ComponentStorageManager._logger.info(`为 ${getComponentTypeName(componentType)} 启用SoA优化（适用于大规模批量操作）`);
+            }
+            else {
+                // 默认使用原始存储
+                storage = new ComponentStorage(componentType);
+            }
+            this.storages.set(componentType, storage);
+        }
+        return storage;
+    }
+    /**
+     * 添加组件
+     * @param entityId 实体ID
+     * @param component 组件实例
+     */
+    addComponent(entityId, component) {
+        const componentType = component.constructor;
+        const storage = this.getStorage(componentType);
+        storage.addComponent(entityId, component);
+    }
+    /**
+     * 获取组件
+     * @param entityId 实体ID
+     * @param componentType 组件类型
+     * @returns 组件实例或null
+     */
+    getComponent(entityId, componentType) {
+        const storage = this.storages.get(componentType);
+        return storage ? storage.getComponent(entityId) : null;
+    }
+    /**
+     * 检查实体是否有组件
+     * @param entityId 实体ID
+     * @param componentType 组件类型
+     * @returns 是否有组件
+     */
+    hasComponent(entityId, componentType) {
+        const storage = this.storages.get(componentType);
+        return storage ? storage.hasComponent(entityId) : false;
+    }
+    /**
+     * 移除组件
+     * @param entityId 实体ID
+     * @param componentType 组件类型
+     * @returns 被移除的组件或null
+     */
+    removeComponent(entityId, componentType) {
+        const storage = this.storages.get(componentType);
+        return storage ? storage.removeComponent(entityId) : null;
+    }
+    /**
+     * 移除实体的所有组件
+     * @param entityId 实体ID
+     */
+    removeAllComponents(entityId) {
+        for (const storage of this.storages.values()) {
+            storage.removeComponent(entityId);
+        }
+    }
+    /**
+     * 获取实体的组件位掩码
+     * @param entityId 实体ID
+     * @returns 组件位掩码
+     */
+    getComponentMask(entityId) {
+        const mask = BitMask64Utils.clone(BitMask64Utils.ZERO);
+        for (const [componentType, storage] of this.storages.entries()) {
+            if (storage.hasComponent(entityId)) {
+                const componentMask = ComponentRegistry.getBitMask(componentType);
+                BitMask64Utils.orInPlace(mask, componentMask);
+            }
+        }
+        return mask;
+    }
+    /**
+     * 获取所有存储器的统计信息
+     */
+    getAllStats() {
+        const stats = new Map();
+        for (const [componentType, storage] of this.storages.entries()) {
+            const typeName = getComponentTypeName(componentType);
+            stats.set(typeName, storage.getStats());
+        }
+        return stats;
+    }
+    /**
+     * 清空所有存储器
+     */
+    clear() {
+        for (const storage of this.storages.values()) {
+            storage.clear();
+        }
+        this.storages.clear();
+    }
+}
+ComponentStorageManager._logger = createLogger('ComponentStorage');
+//# sourceMappingURL=ComponentStorage.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * 实体生命周期策略
+ *
+ * 定义实体在场景切换时的行为。
+ *
+ * Entity lifecycle policy.
+ * Defines entity behavior during scene transitions.
+ */
+export declare const enum EEntityLifecyclePolicy {
+    /**
+     * 默认策略 - 随场景销毁
+     *
+     * Default policy - destroyed with scene.
+     */
+    SceneLocal = 0,
+    /**
+     * 持久化策略 - 跨场景保留
+     *
+     * 实体在场景切换时自动迁移到新场景。
+     *
+     * Persistent policy - survives scene transitions.
+     * Entity is automatically migrated to the new scene.
+     */
+    Persistent = 1
+}
+//# sourceMappingURL=EntityLifecyclePolicy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntityLifecyclePolicy.d.ts","sourceRoot":"","sources":["../../../src/ECS/Core/EntityLifecyclePolicy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,0BAAkB,sBAAsB;IACpC;;;;OAIG;IACH,UAAU,IAAI;IAEd;;;;;;;OAOG;IACH,UAAU,IAAI;CACjB"}

package/bin/ECS/Core/EntityLifecyclePolicy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EntityLifecyclePolicy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntityLifecyclePolicy.js","sourceRoot":"","sources":["../../../src/ECS/Core/EntityLifecyclePolicy.ts"],"names":[],"mappings":""}