@esengine/ecs-framework 2.1.28 → 2.1.30

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

@@ -0,0 +1,92 @@
+import { Component } from '../../Component';
+import { IBigIntLike } from '../../Utils/BigIntCompatibility';
+/**
+ * 组件类型定义
+ */
+export type ComponentType<T extends Component = Component> = new (...args: unknown[]) => T;
+/**
+ * 组件注册表
+ * 管理组件类型的位掩码分配
+ */
+export declare class ComponentRegistry {
+    protected static readonly _logger: import("../../../Utils/Logger").ILogger;
+    private static componentTypes;
+    private static componentNameToType;
+    private static componentNameToId;
+    private static maskCache;
+    private static nextBitIndex;
+    private static maxComponents;
+    /**
+     * 注册组件类型并分配位掩码
+     * @param componentType 组件类型
+     * @returns 分配的位索引
+     */
+    static register<T extends Component>(componentType: ComponentType<T>): number;
+    /**
+     * 获取组件类型的位掩码
+     * @param componentType 组件类型
+     * @returns 位掩码
+     */
+    static getBitMask<T extends Component>(componentType: ComponentType<T>): IBigIntLike;
+    /**
+     * 获取组件类型的位索引
+     * @param componentType 组件类型
+     * @returns 位索引
+     */
+    static getBitIndex<T extends Component>(componentType: ComponentType<T>): number;
+    /**
+     * 检查组件类型是否已注册
+     * @param componentType 组件类型
+     * @returns 是否已注册
+     */
+    static isRegistered<T extends Component>(componentType: ComponentType<T>): boolean;
+    /**
+     * 通过名称获取组件类型
+     * @param componentName 组件名称
+     * @returns 组件类型构造函数
+     */
+    static getComponentType(componentName: string): Function | null;
+    /**
+     * 获取所有已注册的组件类型
+     * @returns 组件类型映射
+     */
+    static getAllRegisteredTypes(): Map<Function, number>;
+    /**
+     * 获取所有组件名称到类型的映射
+     * @returns 名称到类型的映射
+     */
+    static getAllComponentNames(): Map<string, Function>;
+    /**
+     * 通过名称获取组件类型ID
+     * @param componentName 组件名称
+     * @returns 组件类型ID
+     */
+    static getComponentId(componentName: string): number | undefined;
+    /**
+     * 注册组件类型（通过名称）
+     * @param componentName 组件名称
+     * @returns 分配的组件ID
+     */
+    static registerComponentByName(componentName: string): number;
+    /**
+     * 创建单个组件的掩码
+     * @param componentName 组件名称
+     * @returns 组件掩码
+     */
+    static createSingleComponentMask(componentName: string): IBigIntLike;
+    /**
+     * 创建多个组件的掩码
+     * @param componentNames 组件名称数组
+     * @returns 组合掩码
+     */
+    static createComponentMask(componentNames: string[]): IBigIntLike;
+    /**
+     * 清除掩码缓存
+     */
+    static clearMaskCache(): void;
+    /**
+     * 重置注册表（用于测试）
+     */
+    static reset(): void;
+}
+//# sourceMappingURL=ComponentRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentRegistry.d.ts","sourceRoot":"","sources":["../../../../src/ECS/Core/ComponentStorage/ComponentRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAiB,MAAM,iCAAiC,CAAC;AAG7E;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAE3F;;;GAGG;AACH,qBAAa,iBAAiB;IAC1B,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,0CAAoC;IACrE,OAAO,CAAC,MAAM,CAAC,cAAc,CAA+B;IAC5D,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAA+B;IACjE,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAA6B;IAC7D,OAAO,CAAC,MAAM,CAAC,SAAS,CAAkC;IAC1D,OAAO,CAAC,MAAM,CAAC,YAAY,CAAK;IAChC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAM;IAElC;;;;OAIG;WACW,QAAQ,CAAC,CAAC,SAAS,SAAS,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM;IAgBpF;;;;OAIG;WACW,UAAU,CAAC,CAAC,SAAS,SAAS,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,WAAW;IAQ3F;;;;OAIG;WACW,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM;IAQvF;;;;OAIG;WACW,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO;IAIzF;;;;OAIG;WACW,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAItE;;;OAGG;WACW,qBAAqB,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;IAI5D;;;OAGG;WACW,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC;IAI3D;;;;OAIG;WACW,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvE;;;;OAIG;WACW,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAcpE;;;;OAIG;WACW,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW;IAiB3E;;;;OAIG;WACW,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,WAAW;IAoBxE;;OAEG;WACW,cAAc,IAAI,IAAI;IAIpC;;OAEG;WACW,KAAK,IAAI,IAAI;CAO9B"}

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

@@ -0,0 +1,167 @@
+import { BigIntFactory } from '../../Utils/BigIntCompatibility';
+import { createLogger } from '../../../Utils/Logger';
+/**
+ * 组件注册表
+ * 管理组件类型的位掩码分配
+ */
+export class ComponentRegistry {
+    /**
+     * 注册组件类型并分配位掩码
+     * @param componentType 组件类型
+     * @returns 分配的位索引
+     */
+    static register(componentType) {
+        if (this.componentTypes.has(componentType)) {
+            return this.componentTypes.get(componentType);
+        }
+        if (this.nextBitIndex >= this.maxComponents) {
+            throw new Error(`Maximum number of component types (${this.maxComponents}) exceeded`);
+        }
+        const bitIndex = this.nextBitIndex++;
+        this.componentTypes.set(componentType, bitIndex);
+        this.componentNameToType.set(componentType.name, componentType);
+        this.componentNameToId.set(componentType.name, bitIndex);
+        return bitIndex;
+    }
+    /**
+     * 获取组件类型的位掩码
+     * @param componentType 组件类型
+     * @returns 位掩码
+     */
+    static getBitMask(componentType) {
+        const bitIndex = this.componentTypes.get(componentType);
+        if (bitIndex === undefined) {
+            throw new Error(`Component type ${componentType.name} is not registered`);
+        }
+        return BigIntFactory.one().shiftLeft(bitIndex);
+    }
+    /**
+     * 获取组件类型的位索引
+     * @param componentType 组件类型
+     * @returns 位索引
+     */
+    static getBitIndex(componentType) {
+        const bitIndex = this.componentTypes.get(componentType);
+        if (bitIndex === undefined) {
+            throw new Error(`Component type ${componentType.name} is not registered`);
+        }
+        return bitIndex;
+    }
+    /**
+     * 检查组件类型是否已注册
+     * @param componentType 组件类型
+     * @returns 是否已注册
+     */
+    static isRegistered(componentType) {
+        return this.componentTypes.has(componentType);
+    }
+    /**
+     * 通过名称获取组件类型
+     * @param componentName 组件名称
+     * @returns 组件类型构造函数
+     */
+    static getComponentType(componentName) {
+        return this.componentNameToType.get(componentName) || null;
+    }
+    /**
+     * 获取所有已注册的组件类型
+     * @returns 组件类型映射
+     */
+    static getAllRegisteredTypes() {
+        return new Map(this.componentTypes);
+    }
+    /**
+     * 获取所有组件名称到类型的映射
+     * @returns 名称到类型的映射
+     */
+    static getAllComponentNames() {
+        return new Map(this.componentNameToType);
+    }
+    /**
+     * 通过名称获取组件类型ID
+     * @param componentName 组件名称
+     * @returns 组件类型ID
+     */
+    static getComponentId(componentName) {
+        return this.componentNameToId.get(componentName);
+    }
+    /**
+     * 注册组件类型（通过名称）
+     * @param componentName 组件名称
+     * @returns 分配的组件ID
+     */
+    static registerComponentByName(componentName) {
+        if (this.componentNameToId.has(componentName)) {
+            return this.componentNameToId.get(componentName);
+        }
+        if (this.nextBitIndex >= this.maxComponents) {
+            throw new Error(`Maximum number of component types (${this.maxComponents}) exceeded`);
+        }
+        const bitIndex = this.nextBitIndex++;
+        this.componentNameToId.set(componentName, bitIndex);
+        return bitIndex;
+    }
+    /**
+     * 创建单个组件的掩码
+     * @param componentName 组件名称
+     * @returns 组件掩码
+     */
+    static createSingleComponentMask(componentName) {
+        const cacheKey = `single:${componentName}`;
+        if (this.maskCache.has(cacheKey)) {
+            return this.maskCache.get(cacheKey);
+        }
+        const componentId = this.getComponentId(componentName);
+        if (componentId === undefined) {
+            throw new Error(`Component type ${componentName} is not registered`);
+        }
+        const mask = BigIntFactory.one().shiftLeft(componentId);
+        this.maskCache.set(cacheKey, mask);
+        return mask;
+    }
+    /**
+     * 创建多个组件的掩码
+     * @param componentNames 组件名称数组
+     * @returns 组合掩码
+     */
+    static createComponentMask(componentNames) {
+        const sortedNames = [...componentNames].sort();
+        const cacheKey = `multi:${sortedNames.join(',')}`;
+        if (this.maskCache.has(cacheKey)) {
+            return this.maskCache.get(cacheKey);
+        }
+        let mask = BigIntFactory.zero();
+        for (const name of componentNames) {
+            const componentId = this.getComponentId(name);
+            if (componentId !== undefined) {
+                mask = mask.or(BigIntFactory.one().shiftLeft(componentId));
+            }
+        }
+        this.maskCache.set(cacheKey, mask);
+        return mask;
+    }
+    /**
+     * 清除掩码缓存
+     */
+    static clearMaskCache() {
+        this.maskCache.clear();
+    }
+    /**
+     * 重置注册表（用于测试）
+     */
+    static reset() {
+        this.componentTypes.clear();
+        this.componentNameToType.clear();
+        this.componentNameToId.clear();
+        this.maskCache.clear();
+        this.nextBitIndex = 0;
+    }
+}
+ComponentRegistry._logger = createLogger('ComponentStorage');
+ComponentRegistry.componentTypes = new Map();
+ComponentRegistry.componentNameToType = new Map();
+ComponentRegistry.componentNameToId = new Map();
+ComponentRegistry.maskCache = new Map();
+ComponentRegistry.nextBitIndex = 0;
+ComponentRegistry.maxComponents = 64; // 支持最多64种组件类型
+//# sourceMappingURL=ComponentRegistry.js.map

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

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

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

@@ -0,0 +1,233 @@
+import { Component } from '../Component';
+import { IBigIntLike } from '../Utils/BigIntCompatibility';
+import { SoAStorage, EnableSoA, HighPrecision, Float64, Int32, SerializeMap, SerializeSet, SerializeArray, DeepCopy } from './SoAStorage';
+export { EnableSoA, HighPrecision, Float64, Int32, SerializeMap, SerializeSet, SerializeArray, DeepCopy };
+/**
+ * 组件类型定义
+ */
+export type ComponentType<T extends Component = Component> = new (...args: unknown[]) => T;
+/**
+ * 组件注册表
+ * 管理组件类型的位掩码分配
+ */
+export declare class ComponentRegistry {
+    protected static readonly _logger: import("../../Utils/Logger").ILogger;
+    private static componentTypes;
+    private static componentNameToType;
+    private static componentNameToId;
+    private static maskCache;
+    private static nextBitIndex;
+    private static maxComponents;
+    /**
+     * 注册组件类型并分配位掩码
+     * @param componentType 组件类型
+     * @returns 分配的位索引
+     */
+    static register<T extends Component>(componentType: ComponentType<T>): number;
+    /**
+     * 获取组件类型的位掩码
+     * @param componentType 组件类型
+     * @returns 位掩码
+     */
+    static getBitMask<T extends Component>(componentType: ComponentType<T>): IBigIntLike;
+    /**
+     * 获取组件类型的位索引
+     * @param componentType 组件类型
+     * @returns 位索引
+     */
+    static getBitIndex<T extends Component>(componentType: ComponentType<T>): number;
+    /**
+     * 检查组件类型是否已注册
+     * @param componentType 组件类型
+     * @returns 是否已注册
+     */
+    static isRegistered<T extends Component>(componentType: ComponentType<T>): boolean;
+    /**
+     * 通过名称获取组件类型
+     * @param componentName 组件名称
+     * @returns 组件类型构造函数
+     */
+    static getComponentType(componentName: string): Function | null;
+    /**
+     * 获取所有已注册的组件类型
+     * @returns 组件类型映射
+     */
+    static getAllRegisteredTypes(): Map<Function, number>;
+    /**
+     * 获取所有组件名称到类型的映射
+     * @returns 名称到类型的映射
+     */
+    static getAllComponentNames(): Map<string, Function>;
+    /**
+     * 通过名称获取组件类型ID
+     * @param componentName 组件名称
+     * @returns 组件类型ID
+     */
+    static getComponentId(componentName: string): number | undefined;
+    /**
+     * 注册组件类型（通过名称）
+     * @param componentName 组件名称
+     * @returns 分配的组件ID
+     */
+    static registerComponentByName(componentName: string): number;
+    /**
+     * 创建单个组件的掩码
+     * @param componentName 组件名称
+     * @returns 组件掩码
+     */
+    static createSingleComponentMask(componentName: string): IBigIntLike;
+    /**
+     * 创建多个组件的掩码
+     * @param componentNames 组件名称数组
+     * @returns 组合掩码
+     */
+    static createComponentMask(componentNames: string[]): IBigIntLike;
+    /**
+     * 清除掩码缓存
+     */
+    static clearMaskCache(): void;
+    /**
+     * 重置注册表（用于测试）
+     */
+    static reset(): void;
+}
+/**
+ * 高性能组件存储器
+ * 使用SoA（Structure of Arrays）模式存储组件
+ */
+export declare class ComponentStorage<T extends Component> {
+    private components;
+    private entityToIndex;
+    private indexToEntity;
+    private freeIndices;
+    private componentType;
+    private _size;
+    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>;
+    /**
+     * 压缩存储（移除空洞）
+     */
+    compact(): void;
+    /**
+     * 获取存储统计信息
+     */
+    getStats(): {
+        totalSlots: number;
+        usedSlots: number;
+        freeSlots: number;
+        fragmentation: number;
+    };
+}
+/**
+ * 组件存储管理器
+ * 管理所有组件类型的存储器
+ */
+export declare class ComponentStorageManager {
+    private static readonly _logger;
+    private storages;
+    /**
+     * 获取或创建组件存储器（默认原始存储）
+     * @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): IBigIntLike;
+    /**
+     * 压缩所有存储器
+     */
+    compactAll(): void;
+    /**
+     * 获取所有存储器的统计信息
+     */
+    getAllStats(): Map<string, any>;
+    /**
+     * 清空所有存储器
+     */
+    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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"}