@esengine/ecs-framework 2.1.14 → 2.1.16

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @esengine/ecs-framework v2.1.14
+ * @esengine/ecs-framework v2.1.16
  * TypeScript definitions
  */
 /**
@@ -258,6 +258,14 @@ declare class Timer implements ITimer {
     _isDone: boolean;
     _elapsedTime: number;
     getContext<T>(): T;
+    /**
+     * 定时器是否已完成
+     */
+    get isDone(): boolean;
+    /**
+     * 定时器已运行的时间
+     */
+    get elapsedTime(): number;
     reset(): void;
     stop(): void;
     tick(): boolean;
@@ -306,7 +314,7 @@ interface PerformanceData {
 /**
  * 性能统计信息
  */
-interface PerformanceStats$1 {
+interface PerformanceStats {
     /** 总执行时间 */
     totalTime: number;
     /** 平均执行时间 */
@@ -457,7 +465,7 @@ declare class PerformanceMonitor {
      * @param systemName 系统名称
      * @returns 统计信息或undefined
      */
-    getSystemStats(systemName: string): PerformanceStats$1 | undefined;
+    getSystemStats(systemName: string): PerformanceStats | undefined;
     /**
      * 获取所有系统的性能数据
      * @returns 所有系统的性能数据
@@ -467,7 +475,7 @@ declare class PerformanceMonitor {
      * 获取所有系统的统计信息
      * @returns 所有系统的统计信息
      */
-    getAllSystemStats(): Map<string, PerformanceStats$1>;
+    getAllSystemStats(): Map<string, PerformanceStats>;
     /**
      * 获取性能报告
      * @returns 格式化的性能报告字符串
@@ -737,24 +745,6 @@ declare class PoolManager {
 /**
  * 框架核心类型定义
  */
-/** 更新顺序比较器接口 */
-interface IUpdateOrderComparable {
-    updateOrder: number;
-}
-/** 日志类型枚举 */
-declare enum LogType {
-    Error = 0,
-    Assert = 1,
-    Warning = 2,
-    Log = 3,
-    Exception = 4
-}
-/** 组件变换类型枚举 */
-declare enum ComponentTransform {
-    Position = 1,
-    Scale = 2,
-    Rotation = 4
-}
 /**
  * 组件接口
  *
@@ -781,125 +771,14 @@ interface IComponent {
     update(): void;
 }
 /**
- * 实体接口
- *
- * 定义实体的基本契约，所有实体都应该实现此接口
- */
-interface IEntity {
-    /** 实体唯一标识符 */
-    readonly id: string | number;
-    /** 实体名称 */
-    name: string;
-    /** 实体激活状态 */
-    active: boolean;
-    /** 实体启用状态 */
-    enabled: boolean;
-    /** 实体是否已销毁 */
-    readonly isDestroyed: boolean;
-    /** 更新顺序 */
-    updateOrder: number;
-    /** 实体标签 */
-    tag: number;
-    /** 添加组件 */
-    addComponent<T extends IComponent>(component: T): T;
-    /** 创建并添加组件 */
-    createComponent<T extends IComponent>(componentType: ComponentType$1<T>, ...args: any[]): T;
-    /** 获取组件 */
-    getComponent<T extends IComponent>(type: ComponentType$1<T>): T | null;
-    /** 获取或创建组件 */
-    getOrCreateComponent<T extends IComponent>(type: ComponentType$1<T>, ...args: any[]): T;
-    /** 移除组件 */
-    removeComponent(component: IComponent): void;
-    /** 通过类型移除组件 */
-    removeComponentByType<T extends IComponent>(type: ComponentType$1<T>): T | null;
-    /** 检查是否有组件 */
-    hasComponent<T extends IComponent>(type: ComponentType$1<T>): boolean;
-    /** 获取所有指定类型的组件 */
-    getComponents<T extends IComponent>(type: ComponentType$1<T>): T[];
-    /** 添加子实体 */
-    addChild(child: IEntity): IEntity;
-    /** 移除子实体 */
-    removeChild(child: IEntity): boolean;
-    /** 查找子实体 */
-    findChild(name: string, recursive?: boolean): IEntity | null;
-    /** 更新实体 */
-    update(): void;
-    /** 销毁实体 */
-    destroy(): void;
-}
-/**
- * 实体基础接口（向后兼容）
+ * 系统基础接口
  *
- * 为现有的Entity类提供更灵活的类型定义
- */
-interface IEntityBase {
-    /** 实体唯一标识符 */
-    readonly id: string | number;
-    /** 实体名称 */
-    name: string;
-    /** 实体激活状态 */
-    active: boolean;
-    /** 实体启用状态 */
-    enabled: boolean;
-    /** 实体是否已销毁 */
-    readonly isDestroyed: boolean;
-    /** 更新顺序 */
-    updateOrder: number;
-    /** 实体标签 */
-    tag: number;
-    /** 添加组件（泛型版本） */
-    addComponent<T>(component: T): T;
-    /** 获取组件（泛型版本） */
-    getComponent<T>(type: ComponentClass<T>): T | null;
-    /** 检查是否有组件（泛型版本） */
-    hasComponent<T>(type: ComponentClass<T>): boolean;
-    /** 添加子实体 */
-    addChild(child: any): any;
-    /** 移除子实体 */
-    removeChild(child: any): boolean;
-    /** 查找子实体 */
-    findChild(name: string, recursive?: boolean): any;
-    /** 更新实体 */
-    update(): void;
-    /** 销毁实体 */
-    destroy(): void;
-}
-/**
- * 系统接口
- *
- * 定义系统的基本契约，所有系统都应该实现此接口
- */
-interface ISystem {
-    /** 系统名称 */
-    readonly systemName: string;
-    /** 系统处理的实体列表 */
-    readonly entities: readonly IEntity[];
-    /** 更新顺序/优先级 */
-    updateOrder: number;
-    /** 系统启用状态 */
-    enabled: boolean;
-    /** 系统初始化 */
-    initialize(): void;
-    /** 更新系统（主要处理阶段） */
-    update(): void;
-    /** 延迟更新系统 */
-    lateUpdate?(): void;
-    /** 当实体添加到系统时的回调 */
-    onEntityAdded?(entity: IEntity): void;
-    /** 当实体从系统移除时的回调 */
-    onEntityRemoved?(entity: IEntity): void;
-    /** 当实体组件发生变化时的回调 */
-    onEntityChanged?(entity: IEntity): void;
-}
-/**
- * 系统基础接口（向后兼容）
- *
- * 为现有的EntitySystem类提供更灵活的类型定义
+ * 为现有的EntitySystem类提供类型定义
  */
 interface ISystemBase {
     /** 系统名称 */
     readonly systemName: string;
-    /** 系统处理的实体列表（泛型版本） */
+    /** 系统处理的实体列表 */
     readonly entities: readonly any[];
     /** 更新顺序/优先级 */
     updateOrder: number;
@@ -912,191 +791,12 @@ interface ISystemBase {
     /** 延迟更新系统 */
     lateUpdate?(): void;
 }
-/**
- * 场景接口
- *
- * 定义场景的基本契约
- */
-interface IScene {
-    /** 场景名称 */
-    name: string;
-    /** 场景中的实体列表 */
-    readonly entities: readonly IEntity[];
-    /** 场景中的系统列表 */
-    readonly systems: readonly ISystem[];
-    /** 创建实体 */
-    createEntity(name: string): IEntity;
-    /** 添加实体到场景 */
-    addEntity(entity: IEntity): void;
-    /** 从场景移除实体 */
-    removeEntity(entity: IEntity): void;
-    /** 查找实体 */
-    findEntity(name: string): IEntity | null;
-    /** 添加系统到场景 */
-    addSystem<T extends ISystem>(system: T): T;
-    /** 从场景移除系统 */
-    removeSystem(system: ISystem): void;
-    /** 获取系统 */
-    getSystem<T extends ISystem>(systemType: new (...args: any[]) => T): T | null;
-    /** 更新场景 */
-    update(): void;
-}
 /**
  * 组件类型定义
  *
  * 用于类型安全的组件操作
  */
 type ComponentType$1<T extends IComponent = IComponent> = new (...args: any[]) => T;
-/**
- * 原始组件类型（向后兼容）
- *
- * 用于与现有Component类的兼容
- */
-type ComponentClass<T = any> = new (...args: any[]) => T;
-/**
- * 实体查询匹配器接口
- *
- * 用于查询符合特定条件的实体
- */
-interface IMatcher {
-    /** 必须包含的组件类型 */
-    all(...componentTypes: ComponentType$1[]): IMatcher;
-    /** 至少包含其中一个组件类型 */
-    any(...componentTypes: ComponentType$1[]): IMatcher;
-    /** 不能包含的组件类型 */
-    exclude(...componentTypes: ComponentType$1[]): IMatcher;
-    /** 检查实体是否匹配 */
-    isInterestedEntity(entity: IEntity): boolean;
-}
-/**
- * 性能监控接口
- */
-interface IPerformanceData {
-    /** 执行时间（毫秒） */
-    executionTime: number;
-    /** 调用次数 */
-    callCount: number;
-    /** 平均执行时间 */
-    averageTime: number;
-    /** 最大执行时间 */
-    maxTime: number;
-    /** 最小执行时间 */
-    minTime: number;
-}
-/**
- * 生命周期管理接口
- */
-interface ILifecycle {
-    /** 初始化 */
-    initialize?(): void;
-    /** 启动 */
-    start?(): void;
-    /** 更新 */
-    update?(): void;
-    /** 延迟更新 */
-    lateUpdate?(): void;
-    /** 停止 */
-    stop?(): void;
-    /** 销毁 */
-    destroy?(): void;
-}
-/**
- * 实体管理器接口
- *
- * 提供统一的实体管理和查询机制，支持高效的实体操作
- */
-interface IEntityManager {
-    /** 所有实体数量 */
-    readonly entityCount: number;
-    /** 激活的实体数量 */
-    readonly activeEntityCount: number;
-    /** 创建实体 */
-    createEntity(name?: string): IEntity;
-    /** 销毁实体 */
-    destroyEntity(entity: IEntity | string | number): boolean;
-    /** 批量销毁实体 */
-    destroyEntities(entities: (IEntity | string | number)[]): number;
-    /** 销毁所有实体 */
-    destroyAllEntities(): number;
-    /** 根据ID获取实体 */
-    getEntity(id: string | number): IEntity | null;
-    /** 根据名称获取实体 */
-    getEntityByName(name: string): IEntity | null;
-    /** 根据名称获取所有实体 */
-    getEntitiesByName(name: string): IEntity[];
-    /** 根据标签获取实体 */
-    getEntitiesByTag(tag: number): IEntity[];
-    /** 获取所有实体 */
-    getAllEntities(): IEntity[];
-    /** 获取所有激活的实体 */
-    getActiveEntities(): IEntity[];
-    /** 获取拥有指定组件的实体 */
-    getEntitiesWithComponent<T extends IComponent>(componentType: ComponentType$1<T>): IEntity[];
-    /** 获取拥有指定组件的实体及其组件 */
-    getEntitiesWithComponentData<T extends IComponent>(componentType: ComponentType$1<T>): Array<{
-        entity: IEntity;
-        component: T;
-    }>;
-    /** 获取拥有所有指定组件的实体 */
-    getEntitiesWithComponents(...componentTypes: ComponentType$1[]): IEntity[];
-    /** 获取拥有任一指定组件的实体 */
-    getEntitiesWithAnyComponent(...componentTypes: ComponentType$1[]): IEntity[];
-    /** 获取不包含指定组件的实体 */
-    getEntitiesWithoutComponent<T extends IComponent>(componentType: ComponentType$1<T>): IEntity[];
-    /** 对所有实体执行操作 */
-    forEachEntity(action: (entity: IEntity) => void): void;
-    /** 对符合条件的实体执行操作 */
-    forEachEntityWhere(predicate: (entity: IEntity) => boolean, action: (entity: IEntity) => void): void;
-    /** 对拥有指定组件的实体执行操作 */
-    forEachEntityWithComponent<T extends IComponent>(componentType: ComponentType$1<T>, action: (entity: IEntity, component: T) => void): void;
-    /** 查找第一个符合条件的实体 */
-    findEntity(predicate: (entity: IEntity) => boolean): IEntity | null;
-    /** 查找所有符合条件的实体 */
-    findEntities(predicate: (entity: IEntity) => boolean): IEntity[];
-    /** 获取统计信息 */
-    getStatistics(): {
-        totalEntities: number;
-        activeEntities: number;
-        destroyedEntities: number;
-        entitiesByTag: Map<number, number>;
-        componentsCount: Map<string, number>;
-    };
-    /** 清理已销毁的实体 */
-    cleanup(): number;
-    /** 压缩存储空间 */
-    compact(): void;
-}
-/**
- * 实体查询构建器接口
- *
- * 提供流式API构建复杂的实体查询条件
- */
-interface IEntityQueryBuilder {
-    /** 必须包含所有指定组件 */
-    withAll(...componentTypes: ComponentType$1[]): IEntityQueryBuilder;
-    /** 必须包含任一指定组件 */
-    withAny(...componentTypes: ComponentType$1[]): IEntityQueryBuilder;
-    /** 必须不包含指定组件 */
-    without(...componentTypes: ComponentType$1[]): IEntityQueryBuilder;
-    /** 必须包含指定标签 */
-    withTag(tag: number): IEntityQueryBuilder;
-    /** 必须不包含指定标签 */
-    withoutTag(tag: number): IEntityQueryBuilder;
-    /** 必须处于激活状态 */
-    active(): IEntityQueryBuilder;
-    /** 必须处于启用状态 */
-    enabled(): IEntityQueryBuilder;
-    /** 自定义过滤条件 */
-    where(predicate: (entity: IEntity) => boolean): IEntityQueryBuilder;
-    /** 执行查询，返回所有匹配的实体 */
-    execute(): IEntity[];
-    /** 执行查询，返回第一个匹配的实体 */
-    first(): IEntity | null;
-    /** 执行查询，返回匹配实体的数量 */
-    count(): number;
-    /** 对查询结果执行操作 */
-    forEach(action: (entity: IEntity) => void): void;
-}
 /**
  * 事件总线接口
  * 提供类型安全的事件发布订阅机制
@@ -1798,8 +1498,8 @@ declare class ComponentCache {
  * // 获取组件
  * const health = entity.getComponent(HealthComponent);
  *
- * // 设置位置
- * entity.position = new Vector2(100, 200);
+ * // 添加位置组件
+ * entity.addComponent(new PositionComponent(100, 200));
  *
  * // 添加子实体
  * const weapon = new Entity("Weapon", 2);
@@ -2683,7 +2383,7 @@ declare abstract class EntitySystem implements ISystemBase {
      *
      * @returns 性能统计或undefined
      */
-    getPerformanceStats(): PerformanceStats$1 | undefined;
+    getPerformanceStats(): PerformanceStats | undefined;
     /**
      * 重置系统的性能数据
      */
@@ -3014,7 +2714,7 @@ declare class ArchetypeSystem {
 /**
  * 实体查询结果接口
  */
-interface QueryResult$1 {
+interface QueryResult {
     entities: Entity[];
     count: number;
     /** 查询执行时间（毫秒） */
@@ -3045,7 +2745,6 @@ interface QueryResult$1 {
  */
 declare class QuerySystem {
     private entities;
-    private wasmAvailable;
     private entityIndex;
     private indexDirty;
     private queryCache;
@@ -3059,13 +2758,6 @@ declare class QuerySystem {
     private dirtyTrackingSystem;
     private queryStats;
     constructor();
-    /**
-     * 初始化WebAssembly支持
-     *
-     * 自动检测运行环境并启用WebAssembly计算加速。
-     * 如果WebAssembly不可用，系统将自动回退到JavaScript实现。
-     */
-    private initializeWasm;
     /**
      * 设置实体列表并重建索引
      *
@@ -3142,7 +2834,7 @@ declare class QuerySystem {
      * console.log(`找到 ${result.count} 个移动实体`);
      * ```
      */
-    queryAll(...componentTypes: ComponentType[]): QueryResult$1;
+    queryAll(...componentTypes: ComponentType[]): QueryResult;
     /**
      * 多组件查询算法
      *
@@ -3179,7 +2871,7 @@ declare class QuerySystem {
      * console.log(`找到 ${result.count} 个装备实体`);
      * ```
      */
-    queryAny(...componentTypes: ComponentType[]): QueryResult$1;
+    queryAny(...componentTypes: ComponentType[]): QueryResult;
     /**
      * 查询不包含任何指定组件的实体
      *
@@ -3196,7 +2888,7 @@ declare class QuerySystem {
      * console.log(`找到 ${result.count} 个静态实体`);
      * ```
      */
-    queryNone(...componentTypes: ComponentType[]): QueryResult$1;
+    queryNone(...componentTypes: ComponentType[]): QueryResult;
     /**
      * 按标签查询实体
      *
@@ -3212,7 +2904,7 @@ declare class QuerySystem {
      * const players = querySystem.queryByTag(PLAYER_TAG);
      * ```
      */
-    queryByTag(tag: number): QueryResult$1;
+    queryByTag(tag: number): QueryResult;
     /**
      * 按名称查询实体
      *
@@ -3228,7 +2920,7 @@ declare class QuerySystem {
      * const player = querySystem.queryByName("Player");
      * ```
      */
-    queryByName(name: string): QueryResult$1;
+    queryByName(name: string): QueryResult;
     /**
      * 按单个组件类型查询实体
      *
@@ -3244,7 +2936,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 +2963,6 @@ declare class QuerySystem {
      * 批量更新实体组件
      *
      * 对大量实体进行批量组件更新操作。
-     * 当更新数量超过阈值时，系统会自动使用WebAssembly加速。
      *
      * @param updates 更新操作列表，包含实体ID和新的组件掩码
      *
@@ -3289,34 +2980,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 +3006,6 @@ declare class QuerySystem {
             tagIndexSize: number;
             nameIndexSize: number;
         };
-        accelerationStatus: ReturnType<QuerySystem['getAccelerationStatus']>;
         queryStats: {
             totalQueries: number;
             cacheHits: number;
@@ -3358,6 +3020,10 @@ declare class QuerySystem {
             archetypeSystem: any;
             dirtyTracking: any;
         };
+        cacheStats: {
+            size: number;
+            hitRate: string;
+        };
     };
     /**
      * 切换组件索引类型
@@ -3444,7 +3110,7 @@ declare class QueryBuilder {
      *
      * @returns 查询结果，包含匹配的实体和性能信息
      */
-    execute(): QueryResult$1;
+    execute(): QueryResult;
     /**
      * 创建组件掩码
      */
@@ -3751,9 +3417,8 @@ declare class Scene {
     get systems(): EntitySystem[];
     /**
      * 创建场景实例
-     * @param enableWasmAcceleration 是否启用WebAssembly加速，默认为true
      */
-    constructor(enableWasmAcceleration?: boolean);
+    constructor();
     /**
      * 初始化场景
      *
@@ -4377,16 +4042,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 +5068,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, 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, Matcher, NumberExtension, PassiveSystem, PerformanceMonitor, PerformanceWarningType, Pool, PoolManager, ProcessingSystem, QuerySystem, Scene, TieredObjectPool, Time, Timer, TimerManager, TypeSafeEventSystem, TypeUtils, createECSAPI };
+export type { Archetype, ArchetypeQueryResult, ComponentType$1 as ComponentType, DirtyData, DirtyListener, EventListenerConfig, EventStats, IComponent, IComponentEventData, IEntityEventData, IEventBus, IEventData, IEventListenerConfig, IEventStats, IPerformanceEventData, IPoolable, ISceneEventData, ISystemBase, ISystemEventData, ITimer, PerformanceData, PerformanceStats, PerformanceThresholds, PerformanceWarning, PoolStats };