@esengine/ecs-framework 2.1.49 → 2.1.50

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @esengine/ecs-framework v2.1.49
+ * @esengine/ecs-framework v2.1.50
  * TypeScript definitions
  */
 /**
@@ -2032,16 +2032,6 @@ declare class GlobalEventBus {
      */
     static reset(debugMode?: boolean): EventBus;
 }
-/**
- * 事件装饰器工厂
- * 用于自动注册事件监听器
- */
-declare function EventHandler$1(eventType: string, config?: IEventListenerConfig): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-/**
- * 异步事件装饰器工厂
- * 用于自动注册异步事件监听器
- */
-declare function AsyncEventHandler$1(eventType: string, config?: IEventListenerConfig): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 
 /**
  * 高性能实体列表管理器
@@ -2510,12 +2500,8 @@ interface Archetype {
     id: ArchetypeId;
     /** 包含的组件类型 */
     componentTypes: ComponentType[];
-    /** 属于该原型的实体列表 */
-    entities: Entity[];
-    /** 原型创建时间 */
-    createdAt: number;
-    /** 最后更新时间 */
-    updatedAt: number;
+    /** 属于该原型的实体集合 */
+    entities: Set<Entity>;
 }
 
 /**
@@ -2533,13 +2519,6 @@ interface QueryResult {
  * 高性能实体查询系统
  *
  * 提供快速的实体查询功能，支持按组件类型、标签、名称等多种方式查询实体。
- * 系统采用多级索引和智能缓存机制，确保在大量实体场景下的查询性能。
- *
- * 主要特性：
- * - 支持单组件和多组件查询
- * - 自动索引管理和缓存优化
- * - WebAssembly计算加速（如果可用）
- * - 详细的性能统计信息
  *
  * @example
  * ```typescript
@@ -2558,8 +2537,6 @@ declare class QuerySystem {
     private queryCache;
     private cacheMaxSize;
     private cacheTimeout;
-    private componentNameCache;
-    private cacheKeyCache;
     private componentMaskCache;
     private componentIndexManager;
     private archetypeSystem;
@@ -2610,6 +2587,14 @@ declare class QuerySystem {
      * @param entity 要移除的实体
      */
     removeEntity(entity: Entity): void;
+    /**
+     * 更新实体在查询系统中的索引
+     *
+     * 当实体的组件组合发生变化时调用此方法，高效地更新实体在查询系统中的索引。
+     *
+     * @param entity 要更新的实体
+     */
+    updateEntity(entity: Entity): void;
     /**
      * 将实体添加到各种索引中
      */
@@ -3341,6 +3326,7 @@ declare abstract class EntitySystem implements ISystemBase {
     private _matcher;
     private _eventListeners;
     private _scene;
+    protected logger: ReturnType<typeof createLogger>;
     /**
      * 实体ID映射缓存
      */
@@ -3562,13 +3548,21 @@ declare abstract class EntitySystem implements ISystemBase {
      */
     protected removeEventListener<T = any>(eventType: string, handler: EventHandler<T>): void;
     /**
-     * 清理所有事件监听器
-     *
-     * 系统移除时自动调用，清理所有通过addEventListener添加的监听器。
+     * 清理手动添加的事件监听器
+     */
+    private cleanupManualEventListeners;
+    /**
+     * 框架内部销毁方法
+     * 由框架调用，处理系统的完整销毁流程
      */
-    private cleanupEventListeners;
+    destroy(): void;
+    /**
+     * 获取Logger名称
+     * 子类可以重写此方法来自定义logger名称
+     */
+    protected getLoggerName(): string;
     /**
-     * 系统销毁时的回调
+     * 用户销毁回调
      *
      * 当系统从场景中移除时调用，子类可以重写此方法进行清理操作。
      * 注意：事件监听器会被框架自动清理，无需手动处理。
@@ -3817,6 +3811,12 @@ declare class Entity {
      * 用于发射组件相关事件
      */
     static eventBus: EventBus | null;
+    /**
+     * 通知Scene中的QuerySystem实体组件发生变动
+     *
+     * @param entity 发生组件变动的实体
+     */
+    private static notifyQuerySystems;
     /**
      * 实体名称
      */
@@ -5586,15 +5586,18 @@ declare class Core {
     /**
      * 获取WorldManager实例
      *
+     * @param config 可选的WorldManager配置，用于覆盖默认配置
      * @returns WorldManager实例，如果未初始化则自动创建
      */
-    static getWorldManager(): WorldManager;
+    static getWorldManager(config?: Partial<IWorldManagerConfig>): WorldManager;
     /**
      * 启用World管理
      *
      * 显式启用World功能，用于多房间/多世界架构
+     *
+     * @param config 可选的WorldManager配置，用于覆盖默认配置
      */
-    static enableWorldManager(): WorldManager;
+    static enableWorldManager(config?: Partial<IWorldManagerConfig>): WorldManager;
     /**
      * 确保默认World存在
      *
@@ -5876,6 +5879,315 @@ declare abstract class IntervalSystem extends EntitySystem {
     protected getIntervalDelta(): number;
 }
 
+/**
+ * Worker处理函数类型
+ * 用户编写的处理逻辑，会被序列化到Worker中执行
+ */
+type WorkerProcessFunction<T extends Record<string, any> = any> = (entities: T[], deltaTime: number, config?: any) => T[] | Promise<T[]>;
+/**
+ * Worker配置接口
+ */
+interface WorkerSystemConfig {
+    /** 是否启用Worker并行处理 */
+    enableWorker?: boolean;
+    /** Worker数量，默认为CPU核心数，自动限制在系统最大值内 */
+    workerCount?: number;
+    /** 每个Worker处理的实体数量，用于控制负载分布 */
+    entitiesPerWorker?: number;
+    /** 系统配置数据，会传递给Worker */
+    systemConfig?: any;
+    /** 是否使用SharedArrayBuffer优化 */
+    useSharedArrayBuffer?: boolean;
+    /** 每个实体在SharedArrayBuffer中占用的Float32数量 */
+    entityDataSize?: number;
+    /** 最大实体数量（用于预分配SharedArrayBuffer） */
+    maxEntities?: number;
+}
+/**
+ * SharedArrayBuffer处理函数类型
+ */
+type SharedArrayBufferProcessFunction = (sharedFloatArray: Float32Array, startIndex: number, endIndex: number, deltaTime: number, systemConfig?: any) => void;
+/**
+ * 支持Worker并行处理的EntitySystem基类
+ *
+ * 支持传统Worker和SharedArrayBuffer两种优化模式：
+ * - 传统模式：数据序列化传输，适用于复杂计算
+ * - SharedArrayBuffer模式：零拷贝数据共享，适用于大量简单计算
+ *
+ * 用户需要实现：
+ * 1. extractEntityData - 定义数据提取逻辑
+ * 2. workerProcess - 编写处理函数（纯函数，可序列化）
+ * 3. applyResult - 定义结果应用逻辑
+ * 4. (可选) SharedArrayBuffer相关方法
+ *
+ * @example
+ * ```typescript
+ * class PhysicsSystem extends WorkerEntitySystem<PhysicsData> {
+ *     constructor() {
+ *         super(Matcher.all(Transform, Velocity), {
+ *             enableWorker: true,
+ *             workerCount: 8, // 指定8个worker，系统会自动限制在系统最大值内
+ *             entitiesPerWorker: 100, // 每个worker处理100个实体
+ *             useSharedArrayBuffer: true,
+ *             entityDataSize: 6, // x, y, vx, vy, radius, mass
+ *             maxEntities: 10000,
+ *             systemConfig: { gravity: 100, friction: 0.95 }
+ *         });
+ *     }
+ *
+ *     protected getDefaultEntityDataSize(): number {
+ *         return 6; // x, y, vx, vy, radius, mass
+ *     }
+ *
+ *     protected extractEntityData(entity: Entity): PhysicsData {
+ *         const transform = entity.getComponent(Transform);
+ *         const velocity = entity.getComponent(Velocity);
+ *         const physics = entity.getComponent(PhysicsComponent);
+ *         return {
+ *             x: transform.x,
+ *             y: transform.y,
+ *             vx: velocity.x,
+ *             vy: velocity.y,
+ *             radius: physics.radius,
+ *             mass: physics.mass
+ *         };
+ *     }
+ *
+ *     protected workerProcess(entities: PhysicsData[], deltaTime: number, config: any): PhysicsData[] {
+ *         return entities.map(entity => {
+ *             // 应用重力
+ *             entity.vy += config.gravity * deltaTime;
+ *
+ *             // 更新位置
+ *             entity.x += entity.vx * deltaTime;
+ *             entity.y += entity.vy * deltaTime;
+ *
+ *             // 应用摩擦力
+ *             entity.vx *= config.friction;
+ *             entity.vy *= config.friction;
+ *
+ *             return entity;
+ *         });
+ *     }
+ *
+ *     protected applyResult(entity: Entity, result: PhysicsData): void {
+ *         const transform = entity.getComponent(Transform);
+ *         const velocity = entity.getComponent(Velocity);
+ *
+ *         transform.x = result.x;
+ *         transform.y = result.y;
+ *         velocity.x = result.vx;
+ *         velocity.y = result.vy;
+ *     }
+ *
+ *     // SharedArrayBuffer优化支持
+ *     protected writeEntityToBuffer(entityData: PhysicsData, offset: number): void {
+ *         if (!this.sharedFloatArray) return;
+ *
+ *         this.sharedFloatArray[offset] = entityData.x;
+ *         this.sharedFloatArray[offset + 1] = entityData.y;
+ *         this.sharedFloatArray[offset + 2] = entityData.vx;
+ *         this.sharedFloatArray[offset + 3] = entityData.vy;
+ *         this.sharedFloatArray[offset + 4] = entityData.radius;
+ *         this.sharedFloatArray[offset + 5] = entityData.mass;
+ *     }
+ *
+ *     protected readEntityFromBuffer(offset: number): PhysicsData | null {
+ *         if (!this.sharedFloatArray) return null;
+ *
+ *         return {
+ *             x: this.sharedFloatArray[offset],
+ *             y: this.sharedFloatArray[offset + 1],
+ *             vx: this.sharedFloatArray[offset + 2],
+ *             vy: this.sharedFloatArray[offset + 3],
+ *             radius: this.sharedFloatArray[offset + 4],
+ *             mass: this.sharedFloatArray[offset + 5]
+ *         };
+ *     }
+ *
+ *     protected getSharedArrayBufferProcessFunction(): SharedArrayBufferProcessFunction {
+ *         return function(sharedFloatArray: Float32Array, startIndex: number, endIndex: number, deltaTime: number, config: any) {
+ *             const entitySize = 6;
+ *             for (let i = startIndex; i < endIndex; i++) {
+ *                 const offset = i * entitySize;
+ *
+ *                 // 读取数据
+ *                 let x = sharedFloatArray[offset];
+ *                 let y = sharedFloatArray[offset + 1];
+ *                 let vx = sharedFloatArray[offset + 2];
+ *                 let vy = sharedFloatArray[offset + 3];
+ *                 const radius = sharedFloatArray[offset + 4];
+ *                 const mass = sharedFloatArray[offset + 5];
+ *
+ *                 // 物理计算
+ *                 vy += config.gravity * deltaTime;
+ *                 x += vx * deltaTime;
+ *                 y += vy * deltaTime;
+ *                 vx *= config.friction;
+ *                 vy *= config.friction;
+ *
+ *                 // 写回数据
+ *                 sharedFloatArray[offset] = x;
+ *                 sharedFloatArray[offset + 1] = y;
+ *                 sharedFloatArray[offset + 2] = vx;
+ *                 sharedFloatArray[offset + 3] = vy;
+ *             }
+ *         };
+ *     }
+ * }
+ *
+ * interface PhysicsData {
+ *     x: number;
+ *     y: number;
+ *     vx: number;
+ *     vy: number;
+ *     radius: number;
+ *     mass: number;
+ * }
+ * ```
+ */
+declare abstract class WorkerEntitySystem<TEntityData = any> extends EntitySystem {
+    protected config: Required<Omit<WorkerSystemConfig, 'systemConfig' | 'entitiesPerWorker'>> & {
+        systemConfig?: any;
+        entitiesPerWorker?: number;
+    };
+    private workerPool;
+    private isProcessing;
+    protected sharedBuffer: SharedArrayBuffer | null;
+    protected sharedFloatArray: Float32Array | null;
+    private platformAdapter;
+    constructor(matcher?: Matcher, config?: WorkerSystemConfig);
+    /**
+     * 检查是否支持Worker
+     */
+    private isWorkerSupported;
+    /**
+     * 检查是否支持SharedArrayBuffer
+     */
+    private isSharedArrayBufferSupported;
+    /**
+     * 获取系统支持的最大Worker数量
+     */
+    private getMaxSystemWorkerCount;
+    /**
+     * 获取实体数据大小 - 子类必须实现
+     * 返回每个实体在SharedArrayBuffer中占用的Float32数量
+     */
+    protected abstract getDefaultEntityDataSize(): number;
+    /**
+     * 初始化SharedArrayBuffer
+     */
+    private initializeSharedArrayBuffer;
+    /**
+     * 初始化Worker池
+     */
+    private initializeWorkerPool;
+    /**
+     * 创建Worker脚本
+     */
+    private createWorkerScript;
+    /**
+     * 重写process方法，支持Worker并行处理
+     */
+    protected process(entities: readonly Entity[]): void;
+    /**
+     * 使用SharedArrayBuffer优化的Worker处理
+     */
+    private processWithSharedArrayBuffer;
+    /**
+     * 使用Worker并行处理
+     */
+    private processWithWorker;
+    /**
+     * 同步处理（fallback）
+     */
+    private processSynchronously;
+    /**
+     * 创建数据批次 - 支持用户指定每个Worker的实体数量
+     */
+    private createBatches;
+    /**
+     * 将实体数据写入SharedArrayBuffer
+     */
+    private writeEntitiesToSharedBuffer;
+    /**
+     * 将单个实体数据写入SharedArrayBuffer - 子类必须实现
+     * @param entityData 实体数据
+     * @param offset 在SharedArrayBuffer中的偏移位置（Float32索引）
+     */
+    protected abstract writeEntityToBuffer(entityData: TEntityData, offset: number): void;
+    /**
+     * 创建SharedArrayBuffer任务 - 支持用户指定每个Worker的实体数量
+     */
+    private createSharedArrayBufferTasks;
+    /**
+     * 从SharedArrayBuffer读取结果并应用
+     */
+    private readResultsFromSharedBuffer;
+    /**
+     * 从SharedArrayBuffer读取单个实体数据 - 子类必须实现
+     * @param offset 在SharedArrayBuffer中的偏移位置（Float32索引）
+     * @returns 实体数据或null
+     */
+    protected abstract readEntityFromBuffer(offset: number): TEntityData | null;
+    /**
+     * 获取SharedArrayBuffer处理函数 - 子类可选实现
+     * 返回一个函数，该函数将被序列化到Worker中执行
+     */
+    protected getSharedArrayBufferProcessFunction?(): SharedArrayBufferProcessFunction;
+    /**
+     * 提取实体数据 - 子类必须实现
+     *
+     * 将Entity转换为可序列化的数据对象
+     */
+    protected abstract extractEntityData(entity: Entity): TEntityData;
+    /**
+     * Worker处理函数 - 子类必须实现
+     *
+     * 这个函数会被序列化并在Worker中执行，因此：
+     * 1. 必须是纯函数，不能访问外部变量
+     * 2. 不能使用闭包或this
+     * 3. 只能使用标准JavaScript API
+     */
+    protected abstract workerProcess(entities: TEntityData[], deltaTime: number, systemConfig?: any): TEntityData[] | Promise<TEntityData[]>;
+    /**
+     * 应用处理结果 - 子类必须实现
+     *
+     * 将Worker处理的结果应用回Entity的组件
+     */
+    protected abstract applyResult(entity: Entity, result: TEntityData): void;
+    /**
+     * 更新Worker配置
+     */
+    updateConfig(newConfig: Partial<WorkerSystemConfig>): void;
+    /**
+     * 重新初始化整个 Worker 系统（包括 SharedArrayBuffer）
+     */
+    private reinitializeWorkerSystem;
+    /**
+     * 重新初始化 Worker 池（保持 SharedArrayBuffer）
+     */
+    private reinitializeWorkerPool;
+    /**
+     * 获取系统性能信息
+     */
+    getWorkerInfo(): {
+        enabled: boolean;
+        workerCount: number;
+        entitiesPerWorker?: number;
+        maxSystemWorkerCount: number;
+        isProcessing: boolean;
+        sharedArrayBufferSupported: boolean;
+        sharedArrayBufferEnabled: boolean;
+        currentMode: 'shared-buffer' | 'worker' | 'sync';
+    };
+    /**
+     * 销毁系统时清理Worker池
+     */
+    protected onDestroy(): void;
+    protected getLoggerName(): string;
+}
+
 /**
  * 64位位集合类，用于高效的位操作
  * 支持最多64个位的设置、清除、查询和逻辑运算
@@ -6614,5 +6926,278 @@ declare class Time {
     static checkEvery(interval: number, lastTime: number): boolean;
 }
 
-export { AsyncEventHandler$1 as AsyncEventHandler, BitMask64Utils, Bits, COMPONENT_TYPE_NAME, Colors, Component, ComponentDataCollector, ComponentPool, ComponentPoolManager, ComponentRegistry, ComponentSparseSet, ComponentStorage, ComponentTypeManager, ConsoleLogger, Core, DebugManager, ECSComponent, ECSEventType, ECSFluentAPI, ECSSystem, EVENT_TYPES, Emitter, EnableSoA, Entity, EntityDataCollector, EntityList, EntityProcessorList, EntitySystem, EventBus, EventHandler$1 as EventHandler, EventPriority, EventTypeValidator, Float32, Float64, FuncPack, GlobalEventBus, GlobalManager, HighPrecision, IdentifierPool, Int32, IntervalSystem, LogLevel, Logger, LoggerManager, Matcher, NumberExtension, PassiveSystem, PerformanceDataCollector, PerformanceMonitor, PerformanceWarningType, Pool, PoolManager, ProcessingSystem, QuerySystem, SYSTEM_TYPE_NAME, Scene, SceneDataCollector, SerializeMap, SoAStorage, SparseSet, SystemDataCollector, Time, Timer, TimerManager, TypeSafeEventSystem, TypeUtils, WebSocketManager, World, WorldManager, createECSAPI, createLogger, getComponentInstanceTypeName, getComponentTypeName, getSystemInstanceTypeName, getSystemTypeName, resetLoggerColors, setGlobalLogLevel, setLoggerColors };
-export type { BitMask64Data, ComponentType$1 as ComponentType, EventListenerConfig, EventStats, IComponent, IComponentDebugData, IComponentEventData, ICoreConfig, IECSDebugConfig, IECSDebugData, IEntityDebugData, IEntityEventData, IEntityHierarchyNode, IEventBus, IEventData, IEventListenerConfig, IEventStats, ILogger, IPerformanceDebugData, IPerformanceEventData, IPoolable, IScene, ISceneConfig, ISceneDebugData, ISceneEventData, ISceneFactory, ISystemBase, ISystemDebugData, ISystemEventData, ITimer, IWorldConfig, IWorldManagerConfig, LoggerColorConfig, LoggerConfig, PerformanceData, PerformanceStats, PerformanceThresholds, PerformanceWarning, PoolStats };
+/**
+ * 平台适配器接口
+ * 用于适配不同的运行环境（浏览器、微信小游戏、字节跳动小游戏等）
+ */
+interface IPlatformAdapter {
+    /**
+     * 平台名称
+     */
+    readonly name: string;
+    /**
+     * 平台版本信息
+     */
+    readonly version?: string;
+    /**
+     * 检查是否支持Worker
+     */
+    isWorkerSupported(): boolean;
+    /**
+     * 检查是否支持SharedArrayBuffer
+     */
+    isSharedArrayBufferSupported(): boolean;
+    /**
+     * 获取硬件并发数（CPU核心数）
+     */
+    getHardwareConcurrency(): number;
+    /**
+     * 创建Worker
+     * @param script Worker脚本内容
+     * @param options Worker选项
+     */
+    createWorker(script: string, options?: WorkerCreationOptions): PlatformWorker;
+    /**
+     * 创建SharedArrayBuffer
+     * @param length 缓冲区大小（字节）
+     */
+    createSharedArrayBuffer(length: number): SharedArrayBuffer | null;
+    /**
+     * 获取高精度时间戳
+     */
+    getHighResTimestamp(): number;
+    /**
+     * 获取平台特定的配置
+     */
+    getPlatformConfig(): PlatformConfig;
+    /**
+     * 异步获取平台配置（包含需要异步获取的信息）
+     */
+    getPlatformConfigAsync?(): Promise<PlatformConfig>;
+}
+/**
+ * Worker创建选项
+ */
+interface WorkerCreationOptions {
+    /**
+     * Worker类型
+     */
+    type?: 'classic' | 'module';
+    /**
+     * 凭据模式
+     */
+    credentials?: 'omit' | 'same-origin' | 'include';
+    /**
+     * Worker名称（用于调试）
+     */
+    name?: string;
+}
+/**
+ * 平台Worker接口
+ */
+interface PlatformWorker {
+    /**
+     * 发送消息到Worker
+     */
+    postMessage(message: any, transfer?: Transferable[]): void;
+    /**
+     * 监听Worker消息
+     */
+    onMessage(handler: (event: {
+        data: any;
+    }) => void): void;
+    /**
+     * 监听Worker错误
+     */
+    onError(handler: (error: ErrorEvent) => void): void;
+    /**
+     * 终止Worker
+     */
+    terminate(): void;
+    /**
+     * Worker状态
+     */
+    readonly state: 'running' | 'terminated';
+}
+/**
+ * 平台配置
+ */
+interface PlatformConfig {
+    /**
+     * 最大Worker数量限制
+     */
+    maxWorkerCount: number;
+    /**
+     * 是否支持模块Worker
+     */
+    supportsModuleWorker: boolean;
+    /**
+     * 是否支持Transferable Objects
+     */
+    supportsTransferableObjects: boolean;
+    /**
+     * SharedArrayBuffer的最大大小限制（字节）
+     */
+    maxSharedArrayBufferSize?: number;
+    /**
+     * 平台特定的Worker脚本前缀（如果需要）
+     */
+    workerScriptPrefix?: string;
+    /**
+     * 平台特定的限制和特性
+     */
+    limitations?: {
+        /**
+         * 是否禁用eval（影响动态脚本创建）
+         */
+        noEval?: boolean;
+        /**
+         * 是否需要特殊的Worker初始化
+         */
+        requiresWorkerInit?: boolean;
+        /**
+         * 内存限制（字节）
+         */
+        memoryLimit?: number;
+        /**
+         * Worker是否不受支持（用于明确标记不支持Worker的平台）
+         */
+        workerNotSupported?: boolean;
+        /**
+         * Worker限制说明列表
+         */
+        workerLimitations?: string[];
+    };
+    /**
+     * 平台特定的扩展属性
+     */
+    extensions?: Record<string, any>;
+}
+/**
+ * 平台检测结果
+ */
+interface PlatformDetectionResult {
+    /**
+     * 平台类型
+     */
+    platform: 'browser' | 'wechat-minigame' | 'bytedance-minigame' | 'alipay-minigame' | 'baidu-minigame' | 'nodejs' | 'unknown';
+    /**
+     * 是否确定检测结果
+     */
+    confident: boolean;
+    /**
+     * 检测到的特征
+     */
+    features: string[];
+    /**
+     * 建议使用的适配器类名
+     */
+    adapterClass?: string;
+}
+
+/**
+ * 平台检测器
+ * 自动检测当前运行环境并返回对应的平台信息
+ */
+declare class PlatformDetector {
+    /**
+     * 检测当前平台
+     */
+    static detect(): PlatformDetectionResult;
+    /**
+     * 检测是否为微信小游戏环境
+     */
+    private static isWeChatMiniGame;
+    /**
+     * 检测是否为字节跳动小游戏环境
+     */
+    private static isByteDanceMiniGame;
+    /**
+     * 检测是否为Node.js环境
+     */
+    private static isNodeJS;
+    /**
+     * 检测是否为支付宝小游戏环境
+     */
+    private static isAlipayMiniGame;
+    /**
+     * 检测是否为百度小游戏环境
+     */
+    private static isBaiduMiniGame;
+    /**
+     * 检测是否为浏览器环境
+     */
+    private static isBrowser;
+    /**
+     * 获取详细的环境信息（用于调试）
+     */
+    static getDetailedInfo(): Record<string, any>;
+}
+
+/**
+ * 平台管理器
+ * 用户需要手动注册平台适配器
+ */
+declare class PlatformManager {
+    private static instance;
+    private adapter;
+    private readonly logger;
+    private constructor();
+    /**
+     * 获取单例实例
+     */
+    static getInstance(): PlatformManager;
+    /**
+     * 获取当前平台适配器
+     */
+    getAdapter(): IPlatformAdapter;
+    /**
+     * 注册平台适配器
+     */
+    registerAdapter(adapter: IPlatformAdapter): void;
+    /**
+     * 检查是否已注册适配器
+     */
+    hasAdapter(): boolean;
+    /**
+     * 获取平台适配器信息（用于调试）
+     */
+    getAdapterInfo(): any;
+    /**
+     * 检查当前平台是否支持特定功能
+     */
+    supportsFeature(feature: 'worker' | 'shared-array-buffer' | 'transferable-objects' | 'module-worker'): boolean;
+    /**
+     * 获取基础的Worker配置信息（不做自动决策）
+     * 用户应该根据自己的业务需求来配置Worker参数
+     */
+    getBasicWorkerConfig(): {
+        platformSupportsWorker: boolean;
+        platformSupportsSharedArrayBuffer: boolean;
+        platformMaxWorkerCount: number;
+        platformLimitations: any;
+    };
+    /**
+     * 异步获取完整的平台配置信息（包含性能信息）
+     */
+    getFullPlatformConfig(): Promise<any>;
+}
+
+/**
+ * 平台适配模块导出
+ */
+
+declare function registerPlatformAdapter(adapter: IPlatformAdapter): void;
+declare function getCurrentAdapter(): IPlatformAdapter;
+declare function getBasicWorkerConfig(): {
+    platformSupportsWorker: boolean;
+    platformSupportsSharedArrayBuffer: boolean;
+    platformMaxWorkerCount: number;
+    platformLimitations: any;
+};
+declare function getFullPlatformConfig(): Promise<any>;
+declare function supportsFeature(feature: 'worker' | 'shared-array-buffer' | 'transferable-objects' | 'module-worker'): boolean;
+declare function hasAdapter(): boolean;
+
+export { BitMask64Utils, Bits, COMPONENT_TYPE_NAME, Colors, Component, ComponentDataCollector, ComponentPool, ComponentPoolManager, ComponentRegistry, ComponentSparseSet, ComponentStorage, ComponentTypeManager, ConsoleLogger, Core, DebugManager, ECSComponent, ECSEventType, ECSFluentAPI, ECSSystem, EVENT_TYPES, Emitter, EnableSoA, Entity, EntityDataCollector, EntityList, EntityProcessorList, EntitySystem, EventBus, EventPriority, EventTypeValidator, Float32, Float64, FuncPack, GlobalEventBus, GlobalManager, HighPrecision, IdentifierPool, Int32, IntervalSystem, LogLevel, Logger, LoggerManager, Matcher, NumberExtension, PassiveSystem, PerformanceDataCollector, PerformanceMonitor, PerformanceWarningType, PlatformDetector, PlatformManager, Pool, PoolManager, ProcessingSystem, QuerySystem, SYSTEM_TYPE_NAME, Scene, SceneDataCollector, SerializeMap, SoAStorage, SparseSet, SystemDataCollector, Time, Timer, TimerManager, TypeSafeEventSystem, TypeUtils, WebSocketManager, WorkerEntitySystem, World, WorldManager, createECSAPI, createLogger, getBasicWorkerConfig, getComponentInstanceTypeName, getComponentTypeName, getCurrentAdapter, getFullPlatformConfig, getSystemInstanceTypeName, getSystemTypeName, hasAdapter, registerPlatformAdapter, resetLoggerColors, setGlobalLogLevel, setLoggerColors, supportsFeature };
+export type { BitMask64Data, ComponentType$1 as ComponentType, EventListenerConfig, EventStats, IComponent, IComponentDebugData, IComponentEventData, ICoreConfig, IECSDebugConfig, IECSDebugData, IEntityDebugData, IEntityEventData, IEntityHierarchyNode, IEventBus, IEventData, IEventListenerConfig, IEventStats, ILogger, IPerformanceDebugData, IPerformanceEventData, IPlatformAdapter, IPoolable, IScene, ISceneConfig, ISceneDebugData, ISceneEventData, ISceneFactory, ISystemBase, ISystemDebugData, ISystemEventData, ITimer, IWorldConfig, IWorldManagerConfig, LoggerColorConfig, LoggerConfig, PerformanceData, PerformanceStats, PerformanceThresholds, PerformanceWarning, PlatformConfig, PlatformDetectionResult, PlatformWorker, PoolStats, SharedArrayBufferProcessFunction, WorkerCreationOptions, WorkerProcessFunction, WorkerSystemConfig };