@esengine/ecs-framework 2.3.0 → 2.3.1

package/bin/ECS/Utils/SparseSet.js

@@ -1,280 +0,0 @@
-/**
- * 稀疏集合实现
- *
- * 提供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

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

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

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

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

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

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

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