@esengine/ecs-framework 2.2.21 → 2.3.0

package/bin/ECS/Utils/SparseSet.js

@@ -0,0 +1,280 @@
+/**
+ * 稀疏集合实现
+ *
+ * 提供O(1)的插入、删除、查找操作，同时保持数据的紧凑存储。
+ * 使用密集数组存储实际数据，稀疏映射提供快速访问
+ *
+ * @template T 存储的数据类型
+ *
+ * @example
+ * ```typescript
+ * const sparseSet = new SparseSet<Entity>();
+ *
+ * sparseSet.add(entity1);
+ * sparseSet.add(entity2);
+ *
+ * if (sparseSet.has(entity1)) {
+ *     sparseSet.remove(entity1);
+ * }
+ *
+ * sparseSet.forEach((entity, index) => {
+ *     console.log(`Entity at index ${index}: ${entity.name}`);
+ * });
+ * ```
+ */
+export class SparseSet {
+    constructor() {
+        /**
+         * 密集存储数组
+         *
+         * 连续存储所有有效数据，确保遍历时的缓存友好性。
+         */
+        this._dense = [];
+        /**
+         * 稀疏映射表
+         *
+         * 将数据项映射到密集数组中的索引，提供O(1)的查找性能。
+         */
+        this._sparse = new Map();
+    }
+    /**
+     * 添加元素到集合
+     *
+     * @param item 要添加的元素
+     * @returns 是否成功添加（false表示元素已存在）
+     */
+    add(item) {
+        if (this._sparse.has(item)) {
+            return false; // 元素已存在
+        }
+        const index = this._dense.length;
+        this._dense.push(item);
+        this._sparse.set(item, index);
+        return true;
+    }
+    /**
+     * 从集合中移除元素
+     *
+     * 使用swap-and-pop技术保持数组紧凑性：
+     * 1. 将要删除的元素与最后一个元素交换
+     * 2. 删除最后一个元素
+     * 3. 更新映射表
+     *
+     * @param item 要移除的元素
+     * @returns 是否成功移除（false表示元素不存在）
+     */
+    remove(item) {
+        const index = this._sparse.get(item);
+        if (index === undefined) {
+            return false; // 元素不存在
+        }
+        const lastIndex = this._dense.length - 1;
+        // 如果不是最后一个元素，则与最后一个元素交换
+        if (index !== lastIndex) {
+            const lastItem = this._dense[lastIndex];
+            this._dense[index] = lastItem;
+            this._sparse.set(lastItem, index);
+        }
+        // 移除最后一个元素
+        this._dense.pop();
+        this._sparse.delete(item);
+        return true;
+    }
+    /**
+     * 检查元素是否存在于集合中
+     *
+     * @param item 要检查的元素
+     * @returns 元素是否存在
+     */
+    has(item) {
+        return this._sparse.has(item);
+    }
+    /**
+     * 获取元素在密集数组中的索引
+     *
+     * @param item 要查询的元素
+     * @returns 索引，如果元素不存在则返回undefined
+     */
+    getIndex(item) {
+        return this._sparse.get(item);
+    }
+    /**
+     * 根据索引获取元素
+     *
+     * @param index 索引
+     * @returns 元素，如果索引无效则返回undefined
+     */
+    getByIndex(index) {
+        return this._dense[index];
+    }
+    /**
+     * 获取集合大小
+     */
+    get size() {
+        return this._dense.length;
+    }
+    /**
+     * 检查集合是否为空
+     */
+    get isEmpty() {
+        return this._dense.length === 0;
+    }
+    /**
+     * 遍历集合中的所有元素
+     *
+     * 保证遍历顺序与添加顺序一致（除非中间有删除操作）。
+     * 遍历性能优秀，因为数据在内存中连续存储。
+     *
+     * @param callback 遍历回调函数
+     */
+    forEach(callback) {
+        for (let i = 0; i < this._dense.length; i++) {
+            callback(this._dense[i], i);
+        }
+    }
+    /**
+     * 映射集合中的所有元素
+     *
+     * @param callback 映射回调函数
+     * @returns 映射后的新数组
+     */
+    map(callback) {
+        const result = [];
+        for (let i = 0; i < this._dense.length; i++) {
+            result.push(callback(this._dense[i], i));
+        }
+        return result;
+    }
+    /**
+     * 过滤集合中的元素
+     *
+     * @param predicate 过滤条件
+     * @returns 满足条件的元素数组
+     */
+    filter(predicate) {
+        const result = [];
+        for (let i = 0; i < this._dense.length; i++) {
+            if (predicate(this._dense[i], i)) {
+                result.push(this._dense[i]);
+            }
+        }
+        return result;
+    }
+    /**
+     * 查找第一个满足条件的元素
+     *
+     * @param predicate 查找条件
+     * @returns 找到的元素，如果没有则返回undefined
+     */
+    find(predicate) {
+        for (let i = 0; i < this._dense.length; i++) {
+            if (predicate(this._dense[i], i)) {
+                return this._dense[i];
+            }
+        }
+        return undefined;
+    }
+    /**
+     * 检查是否存在满足条件的元素
+     *
+     * @param predicate 检查条件
+     * @returns 是否存在满足条件的元素
+     */
+    some(predicate) {
+        for (let i = 0; i < this._dense.length; i++) {
+            if (predicate(this._dense[i], i)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * 检查是否所有元素都满足条件
+     *
+     * @param predicate 检查条件
+     * @returns 是否所有元素都满足条件
+     */
+    every(predicate) {
+        for (let i = 0; i < this._dense.length; i++) {
+            if (!predicate(this._dense[i], i)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * 获取密集数组的只读副本
+     *
+     * 返回数组的浅拷贝，确保外部无法直接修改内部数据。
+     */
+    getDenseArray() {
+        return [...this._dense];
+    }
+    /**
+     * 获取密集数组的直接引用（内部使用）
+     *
+     * 警告：直接修改返回的数组会破坏数据结构的完整性。
+     * 仅在性能关键场景下使用，并确保不会修改数组内容。
+     */
+    getDenseArrayUnsafe() {
+        return this._dense;
+    }
+    /**
+     * 清空集合
+     */
+    clear() {
+        this._dense.length = 0;
+        this._sparse.clear();
+    }
+    /**
+     * 转换为数组
+     */
+    toArray() {
+        return [...this._dense];
+    }
+    /**
+     * 转换为Set
+     */
+    toSet() {
+        return new Set(this._dense);
+    }
+    /**
+     * 获取内存使用统计信息
+     */
+    getMemoryStats() {
+        const denseArraySize = this._dense.length * 8; // 估计每个引用8字节
+        const sparseMapSize = this._sparse.size * 16; // 估计每个Map条目16字节
+        return {
+            denseArraySize,
+            sparseMapSize,
+            totalMemory: denseArraySize + sparseMapSize
+        };
+    }
+    /**
+     * 验证数据结构的完整性
+     *
+     * 调试用方法，检查内部数据结构是否一致。
+     */
+    validate() {
+        // 检查大小一致性
+        if (this._dense.length !== this._sparse.size) {
+            return false;
+        }
+        // 检查映射关系的正确性
+        for (let i = 0; i < this._dense.length; i++) {
+            const item = this._dense[i];
+            const mappedIndex = this._sparse.get(item);
+            if (mappedIndex !== i) {
+                return false;
+            }
+        }
+        // 检查稀疏映射中的所有项都在密集数组中
+        for (const [item, index] of this._sparse) {
+            if (index >= this._dense.length || this._dense[index] !== item) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=SparseSet.js.map

package/bin/ECS/Utils/SparseSet.js.map

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

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

@@ -0,0 +1,9 @@
+export { EntityList } from './EntityList';
+export { EntityProcessorList } from './EntityProcessorList';
+export { IdentifierPool } from './IdentifierPool';
+export { Matcher } from './Matcher';
+export { Bits } from './Bits';
+export { BitMask64Utils, BitMask64Data } from './BigIntCompatibility';
+export { SparseSet } from './SparseSet';
+export { ComponentSparseSet } from './ComponentSparseSet';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ECS/Utils/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/bin/ECS/Utils/index.js

@@ -0,0 +1,10 @@
+// ECS工具类导出
+export { EntityList } from './EntityList';
+export { EntityProcessorList } from './EntityProcessorList';
+export { IdentifierPool } from './IdentifierPool';
+export { Matcher } from './Matcher';
+export { Bits } from './Bits';
+export { BitMask64Utils } from './BigIntCompatibility';
+export { SparseSet } from './SparseSet';
+export { ComponentSparseSet } from './ComponentSparseSet';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ECS/Utils/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAiB,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/bin/ECS/World.d.ts

@@ -0,0 +1,238 @@
+import { IScene } from './IScene';
+import { ServiceContainer } from '../Core/ServiceContainer';
+/**
+ * 全局系统接口
+ * 全局系统是在World级别运行的系统，不依赖特定Scene
+ */
+export interface IGlobalSystem {
+    /**
+     * 系统名称
+     */
+    readonly name: string;
+    /**
+     * 初始化系统
+     */
+    initialize?(): void;
+    /**
+     * 更新系统
+     */
+    update(deltaTime?: number): void;
+    /**
+     * 重置系统
+     */
+    reset?(): void;
+    /**
+     * 销毁系统
+     */
+    destroy?(): void;
+}
+/**
+ * World配置接口
+ */
+export interface IWorldConfig {
+    /**
+     * World名称
+     */
+    name?: string;
+    /**
+     * 是否启用调试模式
+     */
+    debug?: boolean;
+    /**
+     * 最大Scene数量限制
+     */
+    maxScenes?: number;
+    /**
+     * 是否自动清理空Scene
+     */
+    autoCleanup?: boolean;
+}
+/**
+ * World类 - ECS世界管理器
+ *
+ * World是Scene的容器，每个World可以管理多个Scene。
+ * World拥有独立的服务容器，用于管理World级别的全局服务。
+ *
+ * 服务容器层级：
+ * - Core.services: 应用程序全局服务
+ * - World.services: World级别服务（每个World独立）
+ * - Scene.services: Scene级别服务（每个Scene独立）
+ *
+ * 这种设计允许创建独立的游戏世界，如：
+ * - 游戏房间（每个房间一个World）
+ * - 不同的游戏模式
+ * - 独立的模拟环境
+ *
+ * @example
+ * ```typescript
+ * // 创建游戏房间的World
+ * const roomWorld = new World({ name: 'Room_001' });
+ *
+ * // 注册World级别的服务
+ * roomWorld.services.registerSingleton(RoomManager);
+ *
+ * // 在World中创建Scene
+ * const gameScene = roomWorld.createScene('game', new Scene());
+ * const uiScene = roomWorld.createScene('ui', new Scene());
+ *
+ * // 在Scene中使用World级别的服务
+ * const roomManager = roomWorld.services.resolve(RoomManager);
+ *
+ * // 更新整个World
+ * roomWorld.update(deltaTime);
+ * ```
+ */
+export declare class World {
+    readonly name: string;
+    private readonly _config;
+    private readonly _scenes;
+    private readonly _activeScenes;
+    private readonly _globalSystems;
+    private readonly _services;
+    private _isActive;
+    private _createdAt;
+    constructor(config?: IWorldConfig);
+    /**
+     * World级别的服务容器
+     * 用于管理World范围内的全局服务
+     */
+    get services(): ServiceContainer;
+    /**
+     * 创建并添加Scene到World
+     */
+    createScene<T extends IScene>(sceneName: string, sceneInstance?: T): T;
+    /**
+     * 移除Scene
+     */
+    removeScene(sceneName: string): boolean;
+    /**
+     * 获取Scene
+     */
+    getScene<T extends IScene>(sceneName: string): T | null;
+    /**
+     * 获取所有Scene ID
+     */
+    getSceneIds(): string[];
+    /**
+     * 获取所有Scene
+     */
+    getAllScenes(): IScene[];
+    /**
+     * 移除所有Scene
+     */
+    removeAllScenes(): void;
+    /**
+     * 设置Scene激活状态
+     */
+    setSceneActive(sceneName: string, active: boolean): void;
+    /**
+     * 检查Scene是否激活
+     */
+    isSceneActive(sceneName: string): boolean;
+    /**
+     * 获取活跃Scene数量
+     */
+    getActiveSceneCount(): number;
+    /**
+     * 添加全局System
+     * 全局System会在所有激活Scene之前更新
+     */
+    addGlobalSystem<T extends IGlobalSystem>(system: T): T;
+    /**
+     * 移除全局System
+     */
+    removeGlobalSystem(system: IGlobalSystem): boolean;
+    /**
+     * 获取全局System
+     */
+    getGlobalSystem<T extends IGlobalSystem>(type: new (...args: any[]) => T): T | null;
+    /**
+     * 启动World
+     */
+    start(): void;
+    /**
+     * 停止World
+     */
+    stop(): void;
+    /**
+     * 更新World中的全局System
+     * 注意：此方法由Core.update()调用，不应直接调用
+     */
+    updateGlobalSystems(): void;
+    /**
+     * 更新World中的所有激活Scene
+     * 注意：此方法由Core.update()调用，不应直接调用
+     */
+    updateScenes(): void;
+    /**
+     * 销毁World
+     */
+    destroy(): void;
+    /**
+     * 获取World状态
+     */
+    getStatus(): {
+        name: string;
+        isActive: boolean;
+        sceneCount: number;
+        activeSceneCount: number;
+        globalSystemCount: number;
+        createdAt: number;
+        config: {
+            /**
+             * World名称
+             */
+            name?: string;
+            /**
+             * 是否启用调试模式
+             */
+            debug?: boolean;
+            /**
+             * 最大Scene数量限制
+             */
+            maxScenes?: number;
+            /**
+             * 是否自动清理空Scene
+             */
+            autoCleanup?: boolean;
+        };
+        scenes: {
+            id: string;
+            isActive: boolean;
+            name: string;
+        }[];
+    };
+    /**
+     * 获取World统计信息
+     */
+    getStats(): {
+        totalEntities: number;
+        totalSystems: number;
+        memoryUsage: number;
+        performance: {
+            averageUpdateTime: number;
+            maxUpdateTime: number;
+        };
+    };
+    /**
+     * 检查是否应该执行自动清理
+     */
+    private shouldAutoCleanup;
+    /**
+     * 执行清理操作
+     */
+    private cleanup;
+    /**
+     * 检查World是否激活
+     */
+    get isActive(): boolean;
+    /**
+     * 获取Scene数量
+     */
+    get sceneCount(): number;
+    /**
+     * 获取创建时间
+     */
+    get createdAt(): number;
+}
+//# sourceMappingURL=World.d.ts.map

package/bin/ECS/World.d.ts.map

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