@esengine/ecs-framework 2.1.13 → 2.1.15

package/.npmignore

@@ -23,12 +23,6 @@ node_modules/
 *.tmp
 *.temp
 
-# Rust 构建文件（保留编译后的WASM）
-src/wasm/rust-ecs-core/target/
-src/wasm/rust-ecs-core/Cargo.lock
-src/wasm/rust-ecs-core/pkg/
-!bin/wasm/
-
 # 文档草稿
 docs/draft/
 *.draft.md

package/README.md

@@ -151,7 +151,7 @@ eventBus.emit('player:levelup', { playerId: 123, newLevel: 5 });
 | **TypeScript 支持** | ✅ 原生支持 | ✅ 完整支持 | ⚠️ 部分支持 | ✅ 原生支持 |
 | **事件系统** | ✅ 类型安全+装饰器 | ❌ 无内置事件系统 | ⚠️ 基础事件 | ✅ 响应式事件 |
 | **查询系统** | ✅ 智能查询+流式API | ✅ 高性能 | ✅ 基础查询 | ✅ 响应式查询 |
-| **性能优化** | ✅ 多层优化系统 | ✅ WASM优化 | ⚠️ 基础优化 | ✅ React集成优化 |
+| **性能优化** | ✅ 多层优化系统 | ✅ 高性能优化 | ⚠️ 基础优化 | ✅ React集成优化 |
 | **实体管理器** | ✅ 统一管理接口 | ❌ 无统一接口 | ✅ 基础管理 | ✅ 响应式管理 |
 | **组件索引** | ✅ 哈希+位图索引 | ✅ 原生支持 | ❌ 无索引系统 | ✅ 自动索引 |
 | **Archetype系统** | ✅ 内置支持 | ✅ 内置支持 | ❌ 无Archetype | ❌ 无Archetype |

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @esengine/ecs-framework v2.1.13
+ * @esengine/ecs-framework v2.1.15
  * TypeScript definitions
  */
 /**
@@ -306,7 +306,7 @@ interface PerformanceData {
 /**
  * 性能统计信息
  */
-interface PerformanceStats$1 {
+interface PerformanceStats {
     /** 总执行时间 */
     totalTime: number;
     /** 平均执行时间 */
@@ -457,7 +457,7 @@ declare class PerformanceMonitor {
      * @param systemName 系统名称
      * @returns 统计信息或undefined
      */
-    getSystemStats(systemName: string): PerformanceStats$1 | undefined;
+    getSystemStats(systemName: string): PerformanceStats | undefined;
     /**
      * 获取所有系统的性能数据
      * @returns 所有系统的性能数据
@@ -467,7 +467,7 @@ declare class PerformanceMonitor {
      * 获取所有系统的统计信息
      * @returns 所有系统的统计信息
      */
-    getAllSystemStats(): Map<string, PerformanceStats$1>;
+    getAllSystemStats(): Map<string, PerformanceStats>;
     /**
      * 获取性能报告
      * @returns 格式化的性能报告字符串
@@ -2683,7 +2683,7 @@ declare abstract class EntitySystem implements ISystemBase {
      *
      * @returns 性能统计或undefined
      */
-    getPerformanceStats(): PerformanceStats$1 | undefined;
+    getPerformanceStats(): PerformanceStats | undefined;
     /**
      * 重置系统的性能数据
      */
@@ -3014,7 +3014,7 @@ declare class ArchetypeSystem {
 /**
  * 实体查询结果接口
  */
-interface QueryResult$1 {
+interface QueryResult {
     entities: Entity[];
     count: number;
     /** 查询执行时间（毫秒） */
@@ -3045,7 +3045,6 @@ interface QueryResult$1 {
  */
 declare class QuerySystem {
     private entities;
-    private wasmAvailable;
     private entityIndex;
     private indexDirty;
     private queryCache;
@@ -3059,13 +3058,6 @@ declare class QuerySystem {
     private dirtyTrackingSystem;
     private queryStats;
     constructor();
-    /**
-     * 初始化WebAssembly支持
-     *
-     * 自动检测运行环境并启用WebAssembly计算加速。
-     * 如果WebAssembly不可用，系统将自动回退到JavaScript实现。
-     */
-    private initializeWasm;
     /**
      * 设置实体列表并重建索引
      *
@@ -3142,7 +3134,7 @@ declare class QuerySystem {
      * console.log(`找到 ${result.count} 个移动实体`);
      * ```
      */
-    queryAll(...componentTypes: ComponentType[]): QueryResult$1;
+    queryAll(...componentTypes: ComponentType[]): QueryResult;
     /**
      * 多组件查询算法
      *
@@ -3179,7 +3171,7 @@ declare class QuerySystem {
      * console.log(`找到 ${result.count} 个装备实体`);
      * ```
      */
-    queryAny(...componentTypes: ComponentType[]): QueryResult$1;
+    queryAny(...componentTypes: ComponentType[]): QueryResult;
     /**
      * 查询不包含任何指定组件的实体
      *
@@ -3196,7 +3188,7 @@ declare class QuerySystem {
      * console.log(`找到 ${result.count} 个静态实体`);
      * ```
      */
-    queryNone(...componentTypes: ComponentType[]): QueryResult$1;
+    queryNone(...componentTypes: ComponentType[]): QueryResult;
     /**
      * 按标签查询实体
      *
@@ -3212,7 +3204,7 @@ declare class QuerySystem {
      * const players = querySystem.queryByTag(PLAYER_TAG);
      * ```
      */
-    queryByTag(tag: number): QueryResult$1;
+    queryByTag(tag: number): QueryResult;
     /**
      * 按名称查询实体
      *
@@ -3228,7 +3220,7 @@ declare class QuerySystem {
      * const player = querySystem.queryByName("Player");
      * ```
      */
-    queryByName(name: string): QueryResult$1;
+    queryByName(name: string): QueryResult;
     /**
      * 按单个组件类型查询实体
      *
@@ -3244,7 +3236,7 @@ declare class QuerySystem {
      * const entitiesWithPosition = querySystem.queryByComponent(PositionComponent);
      * ```
      */
-    queryByComponent<T extends Component>(componentType: ComponentType<T>): QueryResult$1;
+    queryByComponent<T extends Component>(componentType: ComponentType<T>): QueryResult;
     /**
      * 从缓存获取查询结果
      */
@@ -3271,7 +3263,6 @@ declare class QuerySystem {
      * 批量更新实体组件
      *
      * 对大量实体进行批量组件更新操作。
-     * 当更新数量超过阈值时，系统会自动使用WebAssembly加速。
      *
      * @param updates 更新操作列表，包含实体ID和新的组件掩码
      *
@@ -3289,34 +3280,6 @@ declare class QuerySystem {
         entityId: number;
         componentMask: bigint;
     }>): void;
-    /**
-     * JavaScript实现的批量更新
-     */
-    private batchUpdateComponentsJS;
-    /**
-     * 获取加速状态信息
-     *
-     * 返回当前查询系统的加速状态和性能信息。
-     * 包括WebAssembly可用性、缓存统计等详细信息。
-     *
-     * @returns 加速状态信息对象
-     */
-    getAccelerationStatus(): {
-        wasmEnabled: boolean;
-        currentProvider: string;
-        availableProviders: string[];
-        performanceInfo?: any;
-    };
-    /**
-     * 切换加速提供者
-     *
-     * 兼容性接口，保持向后兼容。
-     * 系统会自动选择最佳的实现方式。
-     *
-     * @param providerName 提供者名称
-     * @returns 是否切换成功
-     */
-    switchAccelerationProvider(providerName: string): Promise<boolean>;
     /**
      * 创建组件掩码
      *
@@ -3343,7 +3306,6 @@ declare class QuerySystem {
             tagIndexSize: number;
             nameIndexSize: number;
         };
-        accelerationStatus: ReturnType<QuerySystem['getAccelerationStatus']>;
         queryStats: {
             totalQueries: number;
             cacheHits: number;
@@ -3358,6 +3320,10 @@ declare class QuerySystem {
             archetypeSystem: any;
             dirtyTracking: any;
         };
+        cacheStats: {
+            size: number;
+            hitRate: string;
+        };
     };
     /**
      * 切换组件索引类型
@@ -3444,7 +3410,7 @@ declare class QueryBuilder {
      *
      * @returns 查询结果，包含匹配的实体和性能信息
      */
-    execute(): QueryResult$1;
+    execute(): QueryResult;
     /**
      * 创建组件掩码
      */
@@ -3751,9 +3717,8 @@ declare class Scene {
     get systems(): EntitySystem[];
     /**
      * 创建场景实例
-     * @param enableWasmAcceleration 是否启用WebAssembly加速，默认为true
      */
-    constructor(enableWasmAcceleration?: boolean);
+    constructor();
     /**
      * 初始化场景
      *
@@ -4377,16 +4342,7 @@ declare class Core {
      * @param options - 额外的配置选项
      * @returns Core实例
      */
-    static create(debug?: boolean, options?: {
-        disableWasm?: boolean;
-    }): Core;
-    /**
-     * 禁用WASM支持
-     *
-     * 当WASM加载失败或在不支持的环境中使用时调用。
-     * 这将使ECS系统使用JavaScript回退实现。
-     */
-    static disableWasm(): void;
+    static create(debug?: boolean): Core;
     /**
      * 注册全局管理器
      *
@@ -5412,172 +5368,5 @@ declare class Time {
     static checkEvery(interval: number, lastTime: number): boolean;
 }
 
-/**
- * WASM ECS核心类型定义
- */
-type EntityId = number;
-type ComponentMask = bigint;
-interface QueryResult {
-    entities: Uint32Array;
-    count: number;
-}
-interface PerformanceStats {
-    entityCount: number;
-    indexCount: number;
-    queryCount: number;
-    updateCount: number;
-    wasmEnabled: boolean;
-}
-interface WasmEcsCoreInstance {
-    create_entity(): number;
-    destroy_entity(entity_id: number): boolean;
-    update_entity_mask(entity_id: number, mask: bigint): void;
-    batch_update_masks(entity_ids: Uint32Array, masks: BigUint64Array): void;
-    query_entities(mask: bigint, max_results: number): number;
-    get_query_result_count(): number;
-    query_cached(mask: bigint): number;
-    get_cached_query_count(mask: bigint): number;
-    query_multiple_components(masks: BigUint64Array, max_results: number): number;
-    query_with_exclusion(include_mask: bigint, exclude_mask: bigint, max_results: number): number;
-    get_entity_mask(entity_id: number): bigint;
-    entity_exists(entity_id: number): boolean;
-    get_entity_count(): number;
-    get_performance_stats(): Array<any>;
-    clear(): void;
-    rebuild_query_cache(): void;
-    free?(): void;
-}
-interface WasmModule {
-    EcsCore: new () => WasmEcsCoreInstance;
-    create_component_mask: (componentIds: Uint32Array) => ComponentMask;
-    mask_contains_component: (mask: ComponentMask, componentId: number) => boolean;
-    default: (input?: any) => Promise<any>;
-    initSync?: (input: any) => any;
-    memory?: WebAssembly.Memory;
-}
-
-/**
- * WASM模块加载器
- */
-
-declare class WasmLoader {
-    private wasmModule;
-    private wasmCore;
-    private silent;
-    setSilent(silent: boolean): void;
-    /**
-     * 手动初始化WASM模块
-     *
-     * @param wasmFactory WASM工厂函数（从.js文件导入的default）
-     * @param wasmFile WASM文件数据
-     * @returns 是否初始化成功
-     *
-     * @example
-     * ```typescript
-     * import { ecsCore } from '@esengine/ecs-framework';
-     *
-     * // 1. 导入WASM的JS文件
-     * import('./ecs_wasm_core.js').then(({ default: wasmFactory }) => {
-     *     // 2. 加载WASM文件（具体方式根据引擎而定）
-     *     // Cocos Creator: this.loadWasmOrAsm("wasmFiles", "ecs_wasm_core", "uuid")
-     *     // 其他环境: fetch('./ecs_wasm_core_bg.wasm')
-     *     loadWasmFile().then((wasmFile) => {
-     *         // 3. 手动初始化ECS的WASM支持
-     *         ecsCore.initializeWasm(wasmFactory, wasmFile).then((success) => {
-     *             if (success) {
-     *                 console.log("ECS WASM初始化成功");
-     *             } else {
-     *                 console.log("ECS WASM初始化失败，使用JavaScript回退");
-     *             }
-     *         });
-     *     });
-     * });
-     * ```
-     */
-    initializeWasm(wasmFactory: any, wasmFile: any): Promise<boolean>;
-    /**
-     * 通用WASM初始化方法
-     */
-    private initWasmInstance;
-    loadWasmModule(): Promise<boolean>;
-    private initializeWasmModule;
-    getWasmCore(): WasmEcsCoreInstance | null;
-    getWasmModule(): WasmModule | null;
-    cleanup(): void;
-}
-
-/**
- * JavaScript回退实现
- */
-
-declare class JavaScriptFallback {
-    private jsEntityMasks;
-    private jsNextEntityId;
-    private jsQueryCount;
-    private jsUpdateCount;
-    createEntity(): EntityId;
-    destroyEntity(entityId: EntityId): boolean;
-    updateEntityMask(entityId: EntityId, mask: ComponentMask): void;
-    batchUpdateMasks(entityIds: EntityId[], masks: ComponentMask[]): void;
-    queryEntities(mask: ComponentMask, maxResults?: number): QueryResult;
-    queryCached(mask: ComponentMask): QueryResult;
-    queryMultipleComponents(masks: ComponentMask[], maxResults?: number): QueryResult;
-    queryWithExclusion(includeMask: ComponentMask, excludeMask: ComponentMask, maxResults?: number): QueryResult;
-    getEntityMask(entityId: EntityId): ComponentMask | null;
-    entityExists(entityId: EntityId): boolean;
-    createComponentMask(componentIds: number[]): ComponentMask;
-    maskContainsComponent(mask: ComponentMask, componentId: number): boolean;
-    getPerformanceStats(): PerformanceStats;
-    clear(): void;
-    getEntityCount(): number;
-}
-
-/**
- * WASM ECS核心模块
- */
-
-declare class WasmEcsCore {
-    private wasmLoader;
-    private jsFallback;
-    private initialized;
-    private usingWasm;
-    constructor();
-    setSilent(silent: boolean): void;
-    /**
-     * 手动初始化WASM模块
-     *
-     * @param wasmFactory WASM工厂函数（从.js文件导入的default）
-     * @param wasmFile WASM文件数据
-     * @returns 是否初始化成功
-     */
-    initializeWasm(wasmFactory: any, wasmFile: any): Promise<boolean>;
-    initialize(): Promise<boolean>;
-    createEntity(): EntityId;
-    destroyEntity(entityId: EntityId): boolean;
-    updateEntityMask(entityId: EntityId, mask: ComponentMask): void;
-    batchUpdateMasks(entityIds: EntityId[], masks: ComponentMask[]): void;
-    queryEntities(mask: ComponentMask, maxResults?: number): QueryResult;
-    queryCached(mask: ComponentMask): QueryResult;
-    queryMultipleComponents(masks: ComponentMask[], maxResults?: number): QueryResult;
-    queryWithExclusion(includeMask: ComponentMask, excludeMask: ComponentMask, maxResults?: number): QueryResult;
-    getEntityMask(entityId: EntityId): ComponentMask | null;
-    entityExists(entityId: EntityId): boolean;
-    createComponentMask(componentIds: number[]): ComponentMask;
-    maskContainsComponent(mask: ComponentMask, componentId: number): boolean;
-    getPerformanceStats(): PerformanceStats;
-    clear(): void;
-    isUsingWasm(): boolean;
-    isInitialized(): boolean;
-    private ensureInitialized;
-    cleanup(): void;
-}
-
-/**
- * WASM ECS核心全局实例
- */
-
-declare const ecsCore: WasmEcsCore;
-declare function initializeEcs(silent?: boolean): Promise<boolean>;
-
-export { ArchetypeSystem, AsyncEventHandler$1 as AsyncEventHandler, BitMaskOptimizer, BitmapComponentIndex, Bits, Component, ComponentIndexManager, ComponentPool, ComponentStorage, ComponentTransform, ComponentTypeManager, Core, CoreEvents, DirtyFlag, DirtyTrackingSystem, ECSEventType, ECSFluentAPI, EVENT_TYPES, Emitter, Entity, EntityList, EntityManager, EntityProcessorList, EntityQueryBuilder, EntitySystem, EventBus, EventHandler$1 as EventHandler, EventPriority, EventTypeValidator, FuncPack, GlobalEventBus, GlobalManager, HashComponentIndex, IdentifierPool, IndexType, IndexUpdateBatcher, IntervalSystem, JavaScriptFallback, LogType, Matcher, NumberExtension, PassiveSystem, PerformanceMonitor, PerformanceWarningType, Pool, PoolManager, ProcessingSystem, QuerySystem, Scene, TieredObjectPool, Time, Timer, TimerManager, TypeSafeEventSystem, TypeUtils, WasmEcsCore, WasmLoader, createECSAPI, ecsCore, initializeEcs };
-export type { Archetype, ArchetypeQueryResult, ComponentClass, ComponentMask, ComponentType$1 as ComponentType, DirtyData, DirtyListener, EntityId, EventListenerConfig, EventStats, IComponent, IComponentEventData, IEntity, IEntityBase, IEntityEventData, IEntityManager, IEntityQueryBuilder, IEventBus, IEventData, IEventListenerConfig, IEventStats, ILifecycle, IMatcher, IPerformanceData, IPerformanceEventData, IPoolable, IScene, ISceneEventData, ISystem, ISystemBase, ISystemEventData, ITimer, IUpdateOrderComparable, PerformanceData, PerformanceStats$1 as PerformanceStats, PerformanceThresholds, PerformanceWarning, PoolStats, QueryResult, PerformanceStats as WasmPerformanceStats };
+export { ArchetypeSystem, AsyncEventHandler$1 as AsyncEventHandler, BitMaskOptimizer, BitmapComponentIndex, Bits, Component, ComponentIndexManager, ComponentPool, ComponentStorage, ComponentTransform, ComponentTypeManager, Core, CoreEvents, DirtyFlag, DirtyTrackingSystem, ECSEventType, ECSFluentAPI, EVENT_TYPES, Emitter, Entity, EntityList, EntityManager, EntityProcessorList, EntityQueryBuilder, EntitySystem, EventBus, EventHandler$1 as EventHandler, EventPriority, EventTypeValidator, FuncPack, GlobalEventBus, GlobalManager, HashComponentIndex, IdentifierPool, IndexType, IndexUpdateBatcher, IntervalSystem, LogType, Matcher, NumberExtension, PassiveSystem, PerformanceMonitor, PerformanceWarningType, Pool, PoolManager, ProcessingSystem, QuerySystem, Scene, TieredObjectPool, Time, Timer, TimerManager, TypeSafeEventSystem, TypeUtils, createECSAPI };
+export type { Archetype, ArchetypeQueryResult, ComponentClass, ComponentType$1 as ComponentType, DirtyData, DirtyListener, EventListenerConfig, EventStats, IComponent, IComponentEventData, IEntity, IEntityBase, IEntityEventData, IEntityManager, IEntityQueryBuilder, IEventBus, IEventData, IEventListenerConfig, IEventStats, ILifecycle, IMatcher, IPerformanceData, IPerformanceEventData, IPoolable, IScene, ISceneEventData, ISystem, ISystemBase, ISystemEventData, ITimer, IUpdateOrderComparable, PerformanceData, PerformanceStats, PerformanceThresholds, PerformanceWarning, PoolStats };