@esengine/server 4.4.0 → 4.5.1

package/dist/chunk-ZUTL4RI7.js

@@ -0,0 +1,285 @@
+import { Room } from './chunk-T3QJOPNG.js';
+import { __name, __publicField } from './chunk-T626JPC7.js';
+import { Core, ECSEventType, NETWORK_ENTITY_METADATA, encodeDespawn, encodeSnapshot, SyncOperation, encodeSpawn, SYNC_METADATA, CHANGE_TRACKER, initChangeTracker } from '@esengine/ecs-framework';
+
+var DEFAULT_ECS_CONFIG = {
+  syncInterval: 50,
+  enableDeltaSync: true,
+  enableAutoNetworkEntity: true
+};
+var NETWORK_ENTITY_OWNER = /* @__PURE__ */ Symbol("NetworkEntityOwner");
+var _ECSRoom = class _ECSRoom extends Room {
+  constructor(ecsConfig) {
+    super();
+    /**
+     * @zh ECS World（由 Core.worldManager 管理）
+     * @en ECS World (managed by Core.worldManager)
+     */
+    __publicField(this, "world");
+    /**
+     * @zh World 在 WorldManager 中的 ID
+     * @en World ID in WorldManager
+     */
+    __publicField(this, "worldId");
+    /**
+     * @zh 房间的主场景
+     * @en Room's main scene
+     */
+    __publicField(this, "scene");
+    /**
+     * @zh ECS 配置
+     * @en ECS configuration
+     */
+    __publicField(this, "ecsConfig");
+    /**
+     * @zh 玩家 ID 到实体的映射
+     * @en Player ID to Entity mapping
+     */
+    __publicField(this, "_playerEntities", /* @__PURE__ */ new Map());
+    /**
+     * @zh 网络实体映射（实体 ID -> prefabType）
+     * @en Network entity mapping (entity ID -> prefabType)
+     */
+    __publicField(this, "_networkEntities", /* @__PURE__ */ new Map());
+    /**
+     * @zh 上次同步时间
+     * @en Last sync time
+     */
+    __publicField(this, "_lastSyncTime", 0);
+    if (!Core.worldManager) {
+      throw new Error("ECSRoom requires Core.create() to be called first. Ensure Core is initialized before creating ECSRoom instances.");
+    }
+    this.ecsConfig = {
+      ...DEFAULT_ECS_CONFIG,
+      ...ecsConfig
+    };
+    this.worldId = `room_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+    this.world = Core.worldManager.createWorld(this.worldId);
+    this.scene = this.world.createScene("game");
+    this.world.setSceneActive("game", true);
+    this.world.start();
+    if (this.ecsConfig.enableAutoNetworkEntity) {
+      this._setupAutoNetworkEntity();
+    }
+  }
+  /**
+   * @zh 设置自动网络实体广播
+   * @en Setup automatic network entity broadcasting
+   */
+  _setupAutoNetworkEntity() {
+    this.scene.eventSystem.on(ECSEventType.COMPONENT_ADDED, (event) => {
+      const { entity, component } = event;
+      const metadata = component.constructor[NETWORK_ENTITY_METADATA];
+      if (metadata?.autoSpawn) {
+        if (!this._networkEntities.has(entity.id)) {
+          this._networkEntities.set(entity.id, metadata.prefabType);
+          this.broadcastSpawn(entity, metadata.prefabType);
+        }
+      }
+      if (metadata?.autoDespawn && !this._networkEntities.has(entity.id)) {
+        this._networkEntities.set(entity.id, metadata.prefabType);
+      }
+    });
+    this.scene.eventSystem.on(ECSEventType.ENTITY_DESTROYED, (event) => {
+      const { entityId } = event;
+      if (this._networkEntities.has(entityId)) {
+        const despawnData = encodeDespawn(entityId);
+        this.broadcastBinary(despawnData);
+        this._networkEntities.delete(entityId);
+      }
+    });
+  }
+  // =========================================================================
+  // Scene Management | 场景管理
+  // =========================================================================
+  /**
+   * @zh 添加系统到场景
+   * @en Add system to scene
+   */
+  addSystem(system) {
+    this.scene.addSystem(system);
+  }
+  /**
+   * @zh 创建实体
+   * @en Create entity
+   */
+  createEntity(name) {
+    return this.scene.createEntity(name ?? `entity_${Date.now()}`);
+  }
+  /**
+   * @zh 为玩家创建实体
+   * @en Create entity for player
+   *
+   * @param playerId - @zh 玩家 ID @en Player ID
+   * @param name - @zh 实体名称 @en Entity name
+   * @returns @zh 创建的实体 @en Created entity
+   */
+  createPlayerEntity(playerId, name) {
+    const entityName = name ?? `player_${playerId}`;
+    const entity = this.scene.createEntity(entityName);
+    entity[NETWORK_ENTITY_OWNER] = playerId;
+    this._playerEntities.set(playerId, entity);
+    return entity;
+  }
+  /**
+   * @zh 获取玩家的实体
+   * @en Get player's entity
+   */
+  getPlayerEntity(playerId) {
+    return this._playerEntities.get(playerId);
+  }
+  /**
+   * @zh 销毁玩家的实体
+   * @en Destroy player's entity
+   */
+  destroyPlayerEntity(playerId) {
+    const entity = this._playerEntities.get(playerId);
+    if (entity) {
+      const despawnData = encodeDespawn(entity.id);
+      this.broadcastBinary(despawnData);
+      entity.destroy();
+      this._playerEntities.delete(playerId);
+    }
+  }
+  // =========================================================================
+  // State Sync | 状态同步
+  // =========================================================================
+  /**
+   * @zh 广播二进制数据
+   * @en Broadcast binary data
+   */
+  broadcastBinary(data) {
+    for (const player of this.players) {
+      this.sendBinary(player, data);
+    }
+  }
+  /**
+   * @zh 发送二进制数据给指定玩家
+   * @en Send binary data to specific player
+   *
+   * @zh 使用原生 WebSocket 二进制帧发送，效率更高
+   * @en Uses native WebSocket binary frames, more efficient
+   */
+  sendBinary(player, data) {
+    player.sendBinary(data);
+  }
+  /**
+   * @zh 发送完整状态给玩家（用于玩家刚加入时）
+   * @en Send full state to player (for when player just joined)
+   */
+  sendFullState(player) {
+    const entities = this._getSyncEntities();
+    if (entities.length === 0) return;
+    for (const entity of entities) {
+      this._initComponentTrackers(entity);
+    }
+    const data = encodeSnapshot(entities, SyncOperation.FULL);
+    this.sendBinary(player, data);
+  }
+  /**
+   * @zh 广播实体生成
+   * @en Broadcast entity spawn
+   */
+  broadcastSpawn(entity, prefabType) {
+    this._initComponentTrackers(entity);
+    const data = encodeSpawn(entity, prefabType);
+    this.broadcastBinary(data);
+  }
+  /**
+   * @zh 广播增量状态更新
+   * @en Broadcast delta state update
+   */
+  broadcastDelta() {
+    const entities = this._getSyncEntities();
+    const changedEntities = entities.filter((entity) => this._hasChanges(entity));
+    if (changedEntities.length === 0) return;
+    const data = encodeSnapshot(changedEntities, SyncOperation.DELTA);
+    this.broadcastBinary(data);
+    this._clearChangeTrackers(changedEntities);
+  }
+  // =========================================================================
+  // Lifecycle Overrides | 生命周期重载
+  // =========================================================================
+  /**
+   * @zh 游戏循环，处理状态同步
+   * @en Game tick, handles state sync
+   */
+  onTick(_dt) {
+    if (this.ecsConfig.enableDeltaSync) {
+      const now = Date.now();
+      if (now - this._lastSyncTime >= this.ecsConfig.syncInterval) {
+        this._lastSyncTime = now;
+        this.broadcastDelta();
+      }
+    }
+  }
+  /**
+   * @zh 玩家离开时自动销毁其实体
+   * @en Auto destroy player entity when leaving
+   */
+  async onLeave(player, reason) {
+    this.destroyPlayerEntity(player.id);
+  }
+  /**
+   * @zh 房间销毁时从 WorldManager 移除 World
+   * @en Remove World from WorldManager when room is disposed
+   */
+  onDispose() {
+    this._playerEntities.clear();
+    Core.worldManager.removeWorld(this.worldId);
+  }
+  // =========================================================================
+  // Internal | 内部方法
+  // =========================================================================
+  _getSyncEntities() {
+    const entities = [];
+    for (const entity of this.scene.entities.buffer) {
+      if (this._hasSyncComponents(entity)) {
+        entities.push(entity);
+      }
+    }
+    return entities;
+  }
+  _hasSyncComponents(entity) {
+    for (const component of entity.components) {
+      const metadata = component.constructor[SYNC_METADATA];
+      if (metadata && metadata.fields.length > 0) {
+        return true;
+      }
+    }
+    return false;
+  }
+  _hasChanges(entity) {
+    for (const component of entity.components) {
+      const tracker = component[CHANGE_TRACKER];
+      if (tracker?.hasChanges()) {
+        return true;
+      }
+    }
+    return false;
+  }
+  _initComponentTrackers(entity) {
+    for (const component of entity.components) {
+      const metadata = component.constructor[SYNC_METADATA];
+      if (metadata && metadata.fields.length > 0) {
+        initChangeTracker(component);
+      }
+    }
+  }
+  _clearChangeTrackers(entities) {
+    for (const entity of entities) {
+      for (const component of entity.components) {
+        const tracker = component[CHANGE_TRACKER];
+        if (tracker) {
+          tracker.clear();
+        }
+      }
+    }
+  }
+};
+__name(_ECSRoom, "ECSRoom");
+var ECSRoom = _ECSRoom;
+
+export { ECSRoom };
+//# sourceMappingURL=chunk-ZUTL4RI7.js.map
+//# sourceMappingURL=chunk-ZUTL4RI7.js.map

package/dist/chunk-ZUTL4RI7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ecs/ECSRoom.ts"],"names":["DEFAULT_ECS_CONFIG","syncInterval","enableDeltaSync","enableAutoNetworkEntity","NETWORK_ENTITY_OWNER","ECSRoom","Room","ecsConfig","world","worldId","scene","_playerEntities","Map","_networkEntities","_lastSyncTime","Core","worldManager","Error","Date","now","Math","random","toString","slice","createWorld","createScene","setSceneActive","start","_setupAutoNetworkEntity","eventSystem","on","ECSEventType","COMPONENT_ADDED","event","entity","component","metadata","NETWORK_ENTITY_METADATA","autoSpawn","has","id","set","prefabType","broadcastSpawn","autoDespawn","ENTITY_DESTROYED","entityId","despawnData","encodeDespawn","broadcastBinary","delete","addSystem","system","createEntity","name","createPlayerEntity","playerId","entityName","getPlayerEntity","get","destroyPlayerEntity","destroy","data","player","players","sendBinary","sendFullState","entities","_getSyncEntities","length","_initComponentTrackers","encodeSnapshot","SyncOperation","FULL","encodeSpawn","broadcastDelta","changedEntities","filter","_hasChanges","DELTA","_clearChangeTrackers","onTick","_dt","onLeave","reason","onDispose","clear","removeWorld","buffer","_hasSyncComponents","push","components","SYNC_METADATA","fields","tracker","CHANGE_TRACKER","hasChanges","initChangeTracker"],"mappings":"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","file":"chunk-ZUTL4RI7.js","sourcesContent":["/**\n * @zh ECS 房间基类\n * @en ECS Room base class\n */\n\nimport {\n    Core,\n    Scene,\n    World,\n    Entity,\n    EntitySystem,\n    type Component,\n    // Sync\n    SyncOperation,\n    SYNC_METADATA,\n    CHANGE_TRACKER,\n    type SyncMetadata,\n    type ChangeTracker,\n    encodeSnapshot,\n    encodeSpawn,\n    encodeDespawn,\n    initChangeTracker,\n    // Network Entity\n    NETWORK_ENTITY_METADATA,\n    type NetworkEntityMetadata,\n    // Events\n    ECSEventType\n} from '@esengine/ecs-framework';\n\nimport { Room, type RoomOptions } from '../room/Room.js';\nimport type { Player } from '../room/Player.js';\n\n// =============================================================================\n// Types | 类型定义\n// =============================================================================\n\n/**\n * @zh ECS 房间配置\n * @en ECS room configuration\n */\nexport interface ECSRoomConfig {\n    /**\n     * @zh 状态同步间隔（毫秒）\n     * @en State sync interval in milliseconds\n     */\n    syncInterval: number;\n\n    /**\n     * @zh 是否启用增量同步\n     * @en Whether to enable delta sync\n     */\n    enableDeltaSync: boolean;\n\n    /**\n     * @zh 是否启用自动网络实体广播（基于 @NetworkEntity 装饰器）\n     * @en Whether to enable automatic network entity broadcasting (based on @NetworkEntity decorator)\n     * @default true\n     */\n    enableAutoNetworkEntity: boolean;\n}\n\nconst DEFAULT_ECS_CONFIG: ECSRoomConfig = {\n    syncInterval: 50, // 20 Hz\n    enableDeltaSync: true,\n    enableAutoNetworkEntity: true\n};\n\n/**\n * @zh 网络实体标识组件\n * @en Network entity identity component\n */\nconst NETWORK_ENTITY_OWNER = Symbol('NetworkEntityOwner');\n\n// =============================================================================\n// ECSRoom | ECS 房间\n// =============================================================================\n\n/**\n * @zh ECS 房间基类，带有 ECS World 支持和自动状态同步\n * @en ECS Room base class with ECS World support and automatic state synchronization\n *\n * @example\n * ```typescript\n * // 服务端启动\n * Core.create();\n * setInterval(() => Core.update(1/60), 16);\n *\n * // 定义房间\n * class GameRoom extends ECSRoom {\n *     onCreate() {\n *         this.addSystem(new PhysicsSystem());\n *     }\n *\n *     onJoin(player: Player) {\n *         const entity = this.createPlayerEntity(player.id);\n *         entity.addComponent(new PlayerComponent());\n *     }\n * }\n * ```\n */\nexport abstract class ECSRoom<TState = any, TPlayerData = Record<string, unknown>> extends Room<TState, TPlayerData> {\n    /**\n     * @zh ECS World（由 Core.worldManager 管理）\n     * @en ECS World (managed by Core.worldManager)\n     */\n    protected readonly world: World;\n\n    /**\n     * @zh World 在 WorldManager 中的 ID\n     * @en World ID in WorldManager\n     */\n    protected readonly worldId: string;\n\n    /**\n     * @zh 房间的主场景\n     * @en Room's main scene\n     */\n    protected readonly scene: Scene;\n\n    /**\n     * @zh ECS 配置\n     * @en ECS configuration\n     */\n    protected readonly ecsConfig: ECSRoomConfig;\n\n    /**\n     * @zh 玩家 ID 到实体的映射\n     * @en Player ID to Entity mapping\n     */\n    private readonly _playerEntities: Map<string, Entity> = new Map();\n\n    /**\n     * @zh 网络实体映射（实体 ID -> prefabType）\n     * @en Network entity mapping (entity ID -> prefabType)\n     */\n    private readonly _networkEntities: Map<number, string> = new Map();\n\n    /**\n     * @zh 上次同步时间\n     * @en Last sync time\n     */\n    private _lastSyncTime: number = 0;\n\n    constructor(ecsConfig?: Partial<ECSRoomConfig>) {\n        super();\n\n        // Check Core initialization\n        if (!Core.worldManager) {\n            throw new Error(\n                'ECSRoom requires Core.create() to be called first. ' +\n                'Ensure Core is initialized before creating ECSRoom instances.'\n            );\n        }\n\n        this.ecsConfig = { ...DEFAULT_ECS_CONFIG, ...ecsConfig };\n\n        this.worldId = `room_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;\n        this.world = Core.worldManager.createWorld(this.worldId);\n        this.scene = this.world.createScene('game');\n        this.world.setSceneActive('game', true);\n        this.world.start();\n\n        // 设置自动网络实体广播\n        if (this.ecsConfig.enableAutoNetworkEntity) {\n            this._setupAutoNetworkEntity();\n        }\n    }\n\n    /**\n     * @zh 设置自动网络实体广播\n     * @en Setup automatic network entity broadcasting\n     */\n    private _setupAutoNetworkEntity(): void {\n        // 监听组件添加事件，自动广播 spawn\n        this.scene.eventSystem.on(ECSEventType.COMPONENT_ADDED, (event: any) => {\n            const { entity, component } = event;\n            const metadata: NetworkEntityMetadata | undefined =\n                (component.constructor as any)[NETWORK_ENTITY_METADATA];\n\n            if (metadata?.autoSpawn) {\n                // 避免重复广播同一实体\n                if (!this._networkEntities.has(entity.id)) {\n                    this._networkEntities.set(entity.id, metadata.prefabType);\n                    this.broadcastSpawn(entity, metadata.prefabType);\n                }\n            }\n\n            // 记录需要自动 despawn 的实体\n            if (metadata?.autoDespawn && !this._networkEntities.has(entity.id)) {\n                this._networkEntities.set(entity.id, metadata.prefabType);\n            }\n        });\n\n        // 监听实体销毁事件，自动广播 despawn\n        this.scene.eventSystem.on(ECSEventType.ENTITY_DESTROYED, (event: any) => {\n            const { entityId } = event;\n            if (this._networkEntities.has(entityId)) {\n                const despawnData = encodeDespawn(entityId);\n                this.broadcastBinary(despawnData);\n                this._networkEntities.delete(entityId);\n            }\n        });\n    }\n\n    // =========================================================================\n    // Scene Management | 场景管理\n    // =========================================================================\n\n    /**\n     * @zh 添加系统到场景\n     * @en Add system to scene\n     */\n    protected addSystem(system: EntitySystem): void {\n        this.scene.addSystem(system);\n    }\n\n    /**\n     * @zh 创建实体\n     * @en Create entity\n     */\n    protected createEntity(name?: string): Entity {\n        return this.scene.createEntity(name ?? `entity_${Date.now()}`);\n    }\n\n    /**\n     * @zh 为玩家创建实体\n     * @en Create entity for player\n     *\n     * @param playerId - @zh 玩家 ID @en Player ID\n     * @param name - @zh 实体名称 @en Entity name\n     * @returns @zh 创建的实体 @en Created entity\n     */\n    protected createPlayerEntity(playerId: string, name?: string): Entity {\n        const entityName = name ?? `player_${playerId}`;\n        const entity = this.scene.createEntity(entityName);\n        (entity as any)[NETWORK_ENTITY_OWNER] = playerId;\n        this._playerEntities.set(playerId, entity);\n        return entity;\n    }\n\n    /**\n     * @zh 获取玩家的实体\n     * @en Get player's entity\n     */\n    protected getPlayerEntity(playerId: string): Entity | undefined {\n        return this._playerEntities.get(playerId);\n    }\n\n    /**\n     * @zh 销毁玩家的实体\n     * @en Destroy player's entity\n     */\n    protected destroyPlayerEntity(playerId: string): void {\n        const entity = this._playerEntities.get(playerId);\n        if (entity) {\n            const despawnData = encodeDespawn(entity.id);\n            this.broadcastBinary(despawnData);\n            entity.destroy();\n            this._playerEntities.delete(playerId);\n        }\n    }\n\n    // =========================================================================\n    // State Sync | 状态同步\n    // =========================================================================\n\n    /**\n     * @zh 广播二进制数据\n     * @en Broadcast binary data\n     */\n    protected broadcastBinary(data: Uint8Array): void {\n        for (const player of this.players) {\n            this.sendBinary(player, data);\n        }\n    }\n\n    /**\n     * @zh 发送二进制数据给指定玩家\n     * @en Send binary data to specific player\n     *\n     * @zh 使用原生 WebSocket 二进制帧发送，效率更高\n     * @en Uses native WebSocket binary frames, more efficient\n     */\n    protected sendBinary(player: Player<TPlayerData>, data: Uint8Array): void {\n        player.sendBinary(data);\n    }\n\n    /**\n     * @zh 发送完整状态给玩家（用于玩家刚加入时）\n     * @en Send full state to player (for when player just joined)\n     */\n    protected sendFullState(player: Player<TPlayerData>): void {\n        const entities = this._getSyncEntities();\n        if (entities.length === 0) return;\n\n        for (const entity of entities) {\n            this._initComponentTrackers(entity);\n        }\n\n        const data = encodeSnapshot(entities, SyncOperation.FULL);\n        this.sendBinary(player, data);\n    }\n\n    /**\n     * @zh 广播实体生成\n     * @en Broadcast entity spawn\n     */\n    protected broadcastSpawn(entity: Entity, prefabType?: string): void {\n        this._initComponentTrackers(entity);\n        const data = encodeSpawn(entity, prefabType);\n        this.broadcastBinary(data);\n    }\n\n    /**\n     * @zh 广播增量状态更新\n     * @en Broadcast delta state update\n     */\n    protected broadcastDelta(): void {\n        const entities = this._getSyncEntities();\n        const changedEntities = entities.filter((entity) => this._hasChanges(entity));\n\n        if (changedEntities.length === 0) return;\n\n        const data = encodeSnapshot(changedEntities, SyncOperation.DELTA);\n        this.broadcastBinary(data);\n        this._clearChangeTrackers(changedEntities);\n    }\n\n    // =========================================================================\n    // Lifecycle Overrides | 生命周期重载\n    // =========================================================================\n\n    /**\n     * @zh 游戏循环，处理状态同步\n     * @en Game tick, handles state sync\n     */\n    override onTick(_dt: number): void {\n        if (this.ecsConfig.enableDeltaSync) {\n            const now = Date.now();\n            if (now - this._lastSyncTime >= this.ecsConfig.syncInterval) {\n                this._lastSyncTime = now;\n                this.broadcastDelta();\n            }\n        }\n    }\n\n    /**\n     * @zh 玩家离开时自动销毁其实体\n     * @en Auto destroy player entity when leaving\n     */\n    override async onLeave(player: Player<TPlayerData>, reason?: string): Promise<void> {\n        this.destroyPlayerEntity(player.id);\n    }\n\n    /**\n     * @zh 房间销毁时从 WorldManager 移除 World\n     * @en Remove World from WorldManager when room is disposed\n     */\n    override onDispose(): void {\n        this._playerEntities.clear();\n        Core.worldManager.removeWorld(this.worldId);\n    }\n\n    // =========================================================================\n    // Internal | 内部方法\n    // =========================================================================\n\n    private _getSyncEntities(): Entity[] {\n        const entities: Entity[] = [];\n        for (const entity of this.scene.entities.buffer) {\n            if (this._hasSyncComponents(entity)) {\n                entities.push(entity);\n            }\n        }\n        return entities;\n    }\n\n    private _hasSyncComponents(entity: Entity): boolean {\n        for (const component of entity.components) {\n            const metadata: SyncMetadata | undefined = (component.constructor as any)[SYNC_METADATA];\n            if (metadata && metadata.fields.length > 0) {\n                return true;\n            }\n        }\n        return false;\n    }\n\n    private _hasChanges(entity: Entity): boolean {\n        for (const component of entity.components) {\n            const tracker = (component as any)[CHANGE_TRACKER] as ChangeTracker | undefined;\n            if (tracker?.hasChanges()) {\n                return true;\n            }\n        }\n        return false;\n    }\n\n    private _initComponentTrackers(entity: Entity): void {\n        for (const component of entity.components) {\n            const metadata: SyncMetadata | undefined = (component.constructor as any)[SYNC_METADATA];\n            if (metadata && metadata.fields.length > 0) {\n                initChangeTracker(component);\n            }\n        }\n    }\n\n    private _clearChangeTrackers(entities: Entity[]): void {\n        for (const entity of entities) {\n            for (const component of entity.components) {\n                const tracker = (component as any)[CHANGE_TRACKER] as ChangeTracker | undefined;\n                if (tracker) {\n                    tracker.clear();\n                }\n            }\n        }\n    }\n}\n"]}

package/dist/ecs/index.d.ts

@@ -1,10 +1,34 @@
 import { World, Scene, EntitySystem, Entity } from '@esengine/ecs-framework';
 export { Component, Entity, EntitySystem, Scene, SyncFieldMetadata, SyncMetadata, SyncOperation, SyncType, World, clearChanges, getSyncMetadata, hasChanges, hasSyncFields, initChangeTracker, sync } from '@esengine/ecs-framework';
-import { R as Room, P as Player } from '../Room-BnKpl5Sj.js';
-export { I as IPlayer } from '../Room-BnKpl5Sj.js';
-export { o as onMessage } from '../decorators-DY8nZ8Nh.js';
+import { R as Room, P as Player } from '../Room-5owFVIFR.js';
+export { I as IPlayer } from '../Room-5owFVIFR.js';
 import '@esengine/rpc';
 
+/**
+ * @zh 房间装饰器
+ * @en Room decorators
+ */
+/**
+ * @zh 消息处理器装饰器
+ * @en Message handler decorator
+ *
+ * @example
+ * ```typescript
+ * class GameRoom extends Room {
+ *     @onMessage('Move')
+ *     handleMove(data: { x: number, y: number }, player: Player) {
+ *         // handle move
+ *     }
+ *
+ *     @onMessage('Chat')
+ *     handleChat(data: { text: string }, player: Player) {
+ *         this.broadcast('Chat', { from: player.id, text: data.text })
+ *     }
+ * }
+ * ```
+ */
+declare function onMessage(type: string): MethodDecorator;
+
 /**
  * @zh ECS 房间基类
  * @en ECS Room base class
@@ -134,6 +158,9 @@ declare abstract class ECSRoom<TState = any, TPlayerData = Record<string, unknow
     /**
      * @zh 发送二进制数据给指定玩家
      * @en Send binary data to specific player
+     *
+     * @zh 使用原生 WebSocket 二进制帧发送，效率更高
+     * @en Uses native WebSocket binary frames, more efficient
      */
     protected sendBinary(player: Player<TPlayerData>, data: Uint8Array): void;
     /**
@@ -173,4 +200,4 @@ declare abstract class ECSRoom<TState = any, TPlayerData = Record<string, unknow
     private _clearChangeTrackers;
 }
 
-export { ECSRoom, type ECSRoomConfig, Player };
+export { ECSRoom, type ECSRoomConfig, Player, onMessage };

package/dist/ecs/index.js

@@ -1,283 +1,6 @@
-import { Room } from '../chunk-FACTBKJ3.js';
-export { Player, onMessage } from '../chunk-FACTBKJ3.js';
-import { __name, __publicField } from '../chunk-T626JPC7.js';
-import { Core, ECSEventType, NETWORK_ENTITY_METADATA, encodeDespawn, encodeSnapshot, SyncOperation, encodeSpawn, SYNC_METADATA, CHANGE_TRACKER, initChangeTracker } from '@esengine/ecs-framework';
+export { ECSRoom } from '../chunk-ZUTL4RI7.js';
+export { Player, onMessage } from '../chunk-T3QJOPNG.js';
+import '../chunk-T626JPC7.js';
 export { SyncOperation, clearChanges, getSyncMetadata, hasChanges, hasSyncFields, initChangeTracker, sync } from '@esengine/ecs-framework';
-
-var DEFAULT_ECS_CONFIG = {
-  syncInterval: 50,
-  enableDeltaSync: true,
-  enableAutoNetworkEntity: true
-};
-var NETWORK_ENTITY_OWNER = /* @__PURE__ */ Symbol("NetworkEntityOwner");
-var _ECSRoom = class _ECSRoom extends Room {
-  constructor(ecsConfig) {
-    super();
-    /**
-     * @zh ECS World（由 Core.worldManager 管理）
-     * @en ECS World (managed by Core.worldManager)
-     */
-    __publicField(this, "world");
-    /**
-     * @zh World 在 WorldManager 中的 ID
-     * @en World ID in WorldManager
-     */
-    __publicField(this, "worldId");
-    /**
-     * @zh 房间的主场景
-     * @en Room's main scene
-     */
-    __publicField(this, "scene");
-    /**
-     * @zh ECS 配置
-     * @en ECS configuration
-     */
-    __publicField(this, "ecsConfig");
-    /**
-     * @zh 玩家 ID 到实体的映射
-     * @en Player ID to Entity mapping
-     */
-    __publicField(this, "_playerEntities", /* @__PURE__ */ new Map());
-    /**
-     * @zh 网络实体映射（实体 ID -> prefabType）
-     * @en Network entity mapping (entity ID -> prefabType)
-     */
-    __publicField(this, "_networkEntities", /* @__PURE__ */ new Map());
-    /**
-     * @zh 上次同步时间
-     * @en Last sync time
-     */
-    __publicField(this, "_lastSyncTime", 0);
-    this.ecsConfig = {
-      ...DEFAULT_ECS_CONFIG,
-      ...ecsConfig
-    };
-    this.worldId = `room_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
-    this.world = Core.worldManager.createWorld(this.worldId);
-    this.scene = this.world.createScene("game");
-    this.world.setSceneActive("game", true);
-    this.world.start();
-    if (this.ecsConfig.enableAutoNetworkEntity) {
-      this._setupAutoNetworkEntity();
-    }
-  }
-  /**
-   * @zh 设置自动网络实体广播
-   * @en Setup automatic network entity broadcasting
-   */
-  _setupAutoNetworkEntity() {
-    this.scene.eventSystem.on(ECSEventType.COMPONENT_ADDED, (event) => {
-      const { entity, component } = event;
-      const metadata = component.constructor[NETWORK_ENTITY_METADATA];
-      if (metadata?.autoSpawn) {
-        if (!this._networkEntities.has(entity.id)) {
-          this._networkEntities.set(entity.id, metadata.prefabType);
-          this.broadcastSpawn(entity, metadata.prefabType);
-        }
-      }
-      if (metadata?.autoDespawn && !this._networkEntities.has(entity.id)) {
-        this._networkEntities.set(entity.id, metadata.prefabType);
-      }
-    });
-    this.scene.eventSystem.on(ECSEventType.ENTITY_DESTROYED, (event) => {
-      const { entityId } = event;
-      if (this._networkEntities.has(entityId)) {
-        const despawnData = encodeDespawn(entityId);
-        this.broadcastBinary(despawnData);
-        this._networkEntities.delete(entityId);
-      }
-    });
-  }
-  // =========================================================================
-  // Scene Management | 场景管理
-  // =========================================================================
-  /**
-   * @zh 添加系统到场景
-   * @en Add system to scene
-   */
-  addSystem(system) {
-    this.scene.addSystem(system);
-  }
-  /**
-   * @zh 创建实体
-   * @en Create entity
-   */
-  createEntity(name) {
-    return this.scene.createEntity(name ?? `entity_${Date.now()}`);
-  }
-  /**
-   * @zh 为玩家创建实体
-   * @en Create entity for player
-   *
-   * @param playerId - @zh 玩家 ID @en Player ID
-   * @param name - @zh 实体名称 @en Entity name
-   * @returns @zh 创建的实体 @en Created entity
-   */
-  createPlayerEntity(playerId, name) {
-    const entityName = name ?? `player_${playerId}`;
-    const entity = this.scene.createEntity(entityName);
-    entity[NETWORK_ENTITY_OWNER] = playerId;
-    this._playerEntities.set(playerId, entity);
-    return entity;
-  }
-  /**
-   * @zh 获取玩家的实体
-   * @en Get player's entity
-   */
-  getPlayerEntity(playerId) {
-    return this._playerEntities.get(playerId);
-  }
-  /**
-   * @zh 销毁玩家的实体
-   * @en Destroy player's entity
-   */
-  destroyPlayerEntity(playerId) {
-    const entity = this._playerEntities.get(playerId);
-    if (entity) {
-      const despawnData = encodeDespawn(entity.id);
-      this.broadcastBinary(despawnData);
-      entity.destroy();
-      this._playerEntities.delete(playerId);
-    }
-  }
-  // =========================================================================
-  // State Sync | 状态同步
-  // =========================================================================
-  /**
-   * @zh 广播二进制数据
-   * @en Broadcast binary data
-   */
-  broadcastBinary(data) {
-    for (const player of this.players) {
-      this.sendBinary(player, data);
-    }
-  }
-  /**
-   * @zh 发送二进制数据给指定玩家
-   * @en Send binary data to specific player
-   */
-  sendBinary(player, data) {
-    player.send("$sync", {
-      data: Array.from(data)
-    });
-  }
-  /**
-   * @zh 发送完整状态给玩家（用于玩家刚加入时）
-   * @en Send full state to player (for when player just joined)
-   */
-  sendFullState(player) {
-    const entities = this._getSyncEntities();
-    if (entities.length === 0) return;
-    for (const entity of entities) {
-      this._initComponentTrackers(entity);
-    }
-    const data = encodeSnapshot(entities, SyncOperation.FULL);
-    this.sendBinary(player, data);
-  }
-  /**
-   * @zh 广播实体生成
-   * @en Broadcast entity spawn
-   */
-  broadcastSpawn(entity, prefabType) {
-    this._initComponentTrackers(entity);
-    const data = encodeSpawn(entity, prefabType);
-    this.broadcastBinary(data);
-  }
-  /**
-   * @zh 广播增量状态更新
-   * @en Broadcast delta state update
-   */
-  broadcastDelta() {
-    const entities = this._getSyncEntities();
-    const changedEntities = entities.filter((entity) => this._hasChanges(entity));
-    if (changedEntities.length === 0) return;
-    const data = encodeSnapshot(changedEntities, SyncOperation.DELTA);
-    this.broadcastBinary(data);
-    this._clearChangeTrackers(changedEntities);
-  }
-  // =========================================================================
-  // Lifecycle Overrides | 生命周期重载
-  // =========================================================================
-  /**
-   * @zh 游戏循环，处理状态同步
-   * @en Game tick, handles state sync
-   */
-  onTick(_dt) {
-    if (this.ecsConfig.enableDeltaSync) {
-      const now = Date.now();
-      if (now - this._lastSyncTime >= this.ecsConfig.syncInterval) {
-        this._lastSyncTime = now;
-        this.broadcastDelta();
-      }
-    }
-  }
-  /**
-   * @zh 玩家离开时自动销毁其实体
-   * @en Auto destroy player entity when leaving
-   */
-  async onLeave(player, reason) {
-    this.destroyPlayerEntity(player.id);
-  }
-  /**
-   * @zh 房间销毁时从 WorldManager 移除 World
-   * @en Remove World from WorldManager when room is disposed
-   */
-  onDispose() {
-    this._playerEntities.clear();
-    Core.worldManager.removeWorld(this.worldId);
-  }
-  // =========================================================================
-  // Internal | 内部方法
-  // =========================================================================
-  _getSyncEntities() {
-    const entities = [];
-    for (const entity of this.scene.entities.buffer) {
-      if (this._hasSyncComponents(entity)) {
-        entities.push(entity);
-      }
-    }
-    return entities;
-  }
-  _hasSyncComponents(entity) {
-    for (const component of entity.components) {
-      const metadata = component.constructor[SYNC_METADATA];
-      if (metadata && metadata.fields.length > 0) {
-        return true;
-      }
-    }
-    return false;
-  }
-  _hasChanges(entity) {
-    for (const component of entity.components) {
-      const tracker = component[CHANGE_TRACKER];
-      if (tracker?.hasChanges()) {
-        return true;
-      }
-    }
-    return false;
-  }
-  _initComponentTrackers(entity) {
-    for (const component of entity.components) {
-      const metadata = component.constructor[SYNC_METADATA];
-      if (metadata && metadata.fields.length > 0) {
-        initChangeTracker(component);
-      }
-    }
-  }
-  _clearChangeTrackers(entities) {
-    for (const entity of entities) {
-      for (const component of entity.components) {
-        const tracker = component[CHANGE_TRACKER];
-        if (tracker) {
-          tracker.clear();
-        }
-      }
-    }
-  }
-};
-__name(_ECSRoom, "ECSRoom");
-var ECSRoom = _ECSRoom;
-
-export { ECSRoom };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map