@esengine/ecs-framework 2.2.1 → 2.2.3

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @esengine/ecs-framework v2.2.1
+ * @esengine/ecs-framework v2.2.3
  * TypeScript definitions
  */
 /**
@@ -4466,17 +4466,17 @@ declare class SceneSerializer {
      *
      * @param scene 要序列化的场景
      * @param options 序列化选项
-     * @returns 序列化后的数据（JSON字符串或二进制Buffer）
+     * @returns 序列化后的数据（JSON字符串或二进制Uint8Array）
      */
-    static serialize(scene: IScene, options?: SceneSerializationOptions): string | Buffer;
+    static serialize(scene: IScene, options?: SceneSerializationOptions): string | Uint8Array;
     /**
      * 反序列化场景
      *
      * @param scene 目标场景
-     * @param saveData 序列化的数据（JSON字符串或二进制Buffer）
+     * @param saveData 序列化的数据（JSON字符串或二进制Uint8Array）
      * @param options 反序列化选项
      */
-    static deserialize(scene: IScene, saveData: string | Buffer, options?: SceneDeserializationOptions): void;
+    static deserialize(scene: IScene, saveData: string | Uint8Array, options?: SceneDeserializationOptions): void;
     /**
      * 序列化场景自定义数据
      *
@@ -4729,7 +4729,7 @@ declare class IncrementalSerializer {
      *
      * @param incremental 增量快照
      * @param options 序列化选项
-     * @returns 序列化后的数据（JSON字符串或二进制Buffer）
+     * @returns 序列化后的数据（JSON字符串或二进制Uint8Array）
      *
      * @example
      * ```typescript
@@ -4751,11 +4751,11 @@ declare class IncrementalSerializer {
     static serializeIncremental(incremental: IncrementalSnapshot, options?: {
         format?: IncrementalSerializationFormat;
         pretty?: boolean;
-    }): string | Buffer;
+    }): string | Uint8Array;
     /**
      * 反序列化增量快照
      *
-     * @param data 序列化的数据（JSON字符串或二进制Buffer）
+     * @param data 序列化的数据（JSON字符串或二进制Uint8Array）
      * @returns 增量快照
      *
      * @example
@@ -4767,7 +4767,7 @@ declare class IncrementalSerializer {
      * const snapshot = IncrementalSerializer.deserializeIncremental(buffer);
      * ```
      */
-    static deserializeIncremental(data: string | Buffer): IncrementalSnapshot;
+    static deserializeIncremental(data: string | Uint8Array): IncrementalSnapshot;
     /**
      * 计算增量快照的大小（字节）
      *
@@ -5195,10 +5195,10 @@ declare class Scene implements IScene {
     /**
      * 序列化场景
      *
-     * 将场景及其所有实体、组件序列化为JSON字符串或二进制Buffer
+     * 将场景及其所有实体、组件序列化为JSON字符串或二进制Uint8Array
      *
      * @param options 序列化选项
-     * @returns 序列化后的数据（JSON字符串或二进制Buffer）
+     * @returns 序列化后的数据（JSON字符串或二进制Uint8Array）
      *
      * @example
      * ```typescript
@@ -5214,13 +5214,13 @@ declare class Scene implements IScene {
      * });
      * ```
      */
-    serialize(options?: SceneSerializationOptions): string | Buffer;
+    serialize(options?: SceneSerializationOptions): string | Uint8Array;
     /**
      * 反序列化场景
      *
      * 从序列化数据恢复场景状态
      *
-     * @param saveData 序列化的数据（JSON字符串或二进制Buffer）
+     * @param saveData 序列化的数据（JSON字符串或二进制Uint8Array）
      * @param options 反序列化选项
      *
      * @example
@@ -5236,7 +5236,7 @@ declare class Scene implements IScene {
      * });
      * ```
      */
-    deserialize(saveData: string | Buffer, options?: SceneDeserializationOptions): void;
+    deserialize(saveData: string | Uint8Array, options?: SceneDeserializationOptions): void;
     /** 增量序列化的基础快照 */
     private _incrementalBaseSnapshot?;
     /**
@@ -5288,7 +5288,7 @@ declare class Scene implements IScene {
     /**
      * 应用增量变更到场景
      *
-     * @param incremental 增量快照数据（IncrementalSnapshot对象、JSON字符串或二进制Buffer）
+     * @param incremental 增量快照数据（IncrementalSnapshot对象、JSON字符串或二进制Uint8Array）
      * @param componentRegistry 组件类型注册表（可选，默认使用全局注册表）
      *
      * @example
@@ -5300,12 +5300,12 @@ declare class Scene implements IScene {
      * const jsonData = IncrementalSerializer.serializeIncremental(snapshot, { format: 'json' });
      * scene.applyIncremental(jsonData);
      *
-     * // 从二进制Buffer应用
+     * // 从二进制Uint8Array应用
      * const binaryData = IncrementalSerializer.serializeIncremental(snapshot, { format: 'binary' });
      * scene.applyIncremental(binaryData);
      * ```
      */
-    applyIncremental(incremental: IncrementalSnapshot | string | Buffer, componentRegistry?: Map<string, any>): void;
+    applyIncremental(incremental: IncrementalSnapshot | string | Uint8Array, componentRegistry?: Map<string, any>): void;
     /**
      * 更新增量快照基准
      *
@@ -7461,9 +7461,9 @@ declare function createECSAPI(scene: IScene, querySystem: QuerySystem, eventSyst
  */
 declare class SceneManager implements IService {
     /**
-     * 当前活跃场景
+     * 内部默认World
      */
-    private _currentScene;
+    private _defaultWorld;
     /**
      * 待切换的下一个场景（延迟切换用）
      */
@@ -7480,6 +7480,11 @@ declare class SceneManager implements IService {
      * 场景切换回调函数
      */
     private _onSceneChangedCallback?;
+    /**
+     * 默认场景ID
+     */
+    private static readonly DEFAULT_SCENE_ID;
+    constructor();
     /**
      * 设置场景切换回调
      *
@@ -7688,6 +7693,10 @@ declare class World {
      * 获取所有Scene
      */
     getAllScenes(): IScene[];
+    /**
+     * 移除所有Scene
+     */
+    removeAllScenes(): void;
     /**
      * 设置Scene激活状态
      */
@@ -9396,6 +9405,24 @@ declare class Core {
      * ```
      */
     static get services(): ServiceContainer;
+    /**
+     * 获取World管理器
+     *
+     * 用于管理多个独立的World实例（高级用户）。
+     *
+     * @returns WorldManager实例
+     * @throws 如果Core实例未创建
+     *
+     * @example
+     * ```typescript
+     * // 创建多个游戏房间
+     * const wm = Core.worldManager;
+     * const room1 = wm.createWorld('room_001');
+     * room1.createScene('game', new GameScene());
+     * room1.start();
+     * ```
+     */
+    static get worldManager(): WorldManager;
     /**
      * 创建Core实例
      *