chore: release packages (#393)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

packages/framework/behavior-tree/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @esengine/behavior-tree
 
+## 2.0.1
+
+### Patch Changes
+
+- Updated dependencies [[`a08a84b`](https://github.com/esengine/esengine/commit/a08a84b7db28e1140cbc637d442552747ad81c76)]:
+    - @esengine/ecs-framework@2.5.1
+
 ## 2.0.0
 
 ### Patch Changes

packages/framework/behavior-tree/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@esengine/behavior-tree",
-    "version": "2.0.0",
+    "version": "2.0.1",
     "description": "ECS-based AI behavior tree system - works with any ECS framework (ESEngine, Cocos, Laya, etc.)",
     "main": "dist/index.js",
     "module": "dist/index.js",

packages/framework/blueprint/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @esengine/blueprint
 
+## 2.0.1
+
+### Patch Changes
+
+- Updated dependencies [[`a08a84b`](https://github.com/esengine/esengine/commit/a08a84b7db28e1140cbc637d442552747ad81c76)]:
+    - @esengine/ecs-framework@2.5.1
+
 ## 2.0.0
 
 ### Patch Changes

packages/framework/blueprint/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@esengine/blueprint",
-    "version": "2.0.0",
+    "version": "2.0.1",
     "description": "Visual scripting system - works with any ECS framework (ESEngine, Cocos, Laya, etc.)",
     "main": "dist/index.js",
     "module": "dist/index.js",

packages/framework/core/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @esengine/ecs-framework
 
+## 2.5.1
+
+### Patch Changes
+
+- [#392](https://github.com/esengine/esengine/pull/392) [`a08a84b`](https://github.com/esengine/esengine/commit/a08a84b7db28e1140cbc637d442552747ad81c76) Thanks [@esengine](https://github.com/esengine)! - fix(sync): Decoder 现在使用 GlobalComponentRegistry 查找组件 | Decoder now uses GlobalComponentRegistry for component lookup
+
+    **问题 | Problem:**
+    1. `Decoder.ts` 有自己独立的 `componentRegistry` Map，与 `GlobalComponentRegistry` 完全分离。这导致通过 `@ECSComponent` 装饰器注册的组件在网络反序列化时找不到，产生 "Unknown component type" 错误。
+    2. `@sync` 装饰器使用 `constructor.name` 作为 `typeId`，而不是 `@ECSComponent` 装饰器指定的名称，导致编码和解码使用不同的类型 ID。
+    3. `Decoder.ts` had its own local `componentRegistry` Map that was completely separate from `GlobalComponentRegistry`. This caused components registered via `@ECSComponent` decorator to not be found during network deserialization, resulting in "Unknown component type" errors.
+    4. `@sync` decorator used `constructor.name` as `typeId` instead of the name specified by `@ECSComponent` decorator, causing encoding and decoding to use different type IDs.
+
+    **修改 | Changes:**
+    - 从 Decoder.ts 中移除本地 `componentRegistry`
+    - 更新 `decodeEntity` 和 `decodeSpawn` 使用 `GlobalComponentRegistry.getComponentType()`
+    - 移除已废弃的 `registerSyncComponent` 和 `autoRegisterSyncComponent` 函数
+    - 更新 `@sync` 装饰器使用 `getComponentTypeName()` 获取组件类型名称
+    - 更新 `@ECSComponent` 装饰器同步更新 `SYNC_METADATA.typeId`
+    - Removed local `componentRegistry` from Decoder.ts
+    - Updated `decodeEntity` and `decodeSpawn` to use `GlobalComponentRegistry.getComponentType()`
+    - Removed deprecated `registerSyncComponent` and `autoRegisterSyncComponent` functions
+    - Updated `@sync` decorator to use `getComponentTypeName()` for component type name
+    - Updated `@ECSComponent` decorator to sync update `SYNC_METADATA.typeId`
+
+    现在使用 `@ECSComponent` 装饰器的组件会自动可用于网络同步解码，无需手动注册。
+
+    Now `@ECSComponent` decorated components are automatically available for network sync decoding without any manual registration.
+
 ## 2.5.0
 
 ### Minor Changes

packages/framework/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esengine/ecs-framework",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "用于Laya、Cocos Creator等JavaScript游戏引擎的高性能ECS框架",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",

packages/framework/core/src/ECS/Component.ts

@@ -10,10 +10,16 @@ import { Int32 } from './Core/SoAStorage';
  * @en Components in ECS architecture should be pure data containers.
  * All game logic should be implemented in EntitySystem, not inside components.
  *
+ * @zh **重要：所有 Component 子类都必须使用 @ECSComponent 装饰器！**
+ * @zh 该装饰器用于注册组件类型名称，是序列化、网络同步等功能正常工作的前提。
+ * @en **IMPORTANT: All Component subclasses MUST use the @ECSComponent decorator!**
+ * @en This decorator registers the component type name, which is required for serialization, network sync, etc.
+ *
  * @example
- * @zh 推荐做法：纯数据组件
- * @en Recommended: Pure data component
+ * @zh 正确做法：使用 @ECSComponent 装饰器
+ * @en Correct: Use @ECSComponent decorator
  * ```typescript
+ * @ECSComponent('HealthComponent')
  * class HealthComponent extends Component {
  *     public health: number = 100;
  *     public maxHealth: number = 100;

packages/framework/core/src/ECS/Decorators/TypeDecorators.ts

@@ -19,6 +19,7 @@ import {
     type ComponentEditorOptions,
     type ComponentType
 } from '../Core/ComponentStorage/ComponentTypeUtils';
+import { SYNC_METADATA, type SyncMetadata } from '../Sync/types';
 
 /**
  * 存储系统类型名称的Symbol键
@@ -138,6 +139,14 @@ export function ECSComponent(typeName: string, options?: ComponentOptions) {
             metadata[COMPONENT_EDITOR_OPTIONS] = options.editor;
         }
 
+        // 更新 @sync 装饰器创建的 SYNC_METADATA.typeId（如果存在）
+        // Update SYNC_METADATA.typeId created by @sync decorator (if exists)
+        // Property decorators execute before class decorators, so @sync may have used constructor.name
+        const syncMeta = (target as any)[SYNC_METADATA] as SyncMetadata | undefined;
+        if (syncMeta) {
+            syncMeta.typeId = typeName;
+        }
+
         // 自动注册到全局 ComponentRegistry，使组件可以通过名称查找
         // Auto-register to GlobalComponentRegistry, enabling lookup by name
         GlobalComponentRegistry.register(target);

packages/framework/core/src/ECS/Sync/decorators.ts

@@ -9,6 +9,7 @@
 import type { SyncType, SyncFieldMetadata, SyncMetadata } from './types';
 import { SYNC_METADATA, CHANGE_TRACKER } from './types';
 import { ChangeTracker } from './ChangeTracker';
+import { getComponentTypeName } from '../Core/ComponentStorage/ComponentTypeUtils';
 
 /**
  * @zh 获取或创建组件的同步元数据
@@ -31,8 +32,9 @@ function getOrCreateSyncMetadata(target: any): SyncMetadata {
     const inheritedMetadata: SyncMetadata | undefined = constructor[SYNC_METADATA];
 
     // Create new metadata (copy from inherited if exists)
+    // Use getComponentTypeName to get @ECSComponent decorator name, or fall back to constructor.name
     const metadata: SyncMetadata = {
-        typeId: constructor.name,
+        typeId: getComponentTypeName(constructor),
         fields: inheritedMetadata ? [...inheritedMetadata.fields] : [],
         fieldIndexMap: inheritedMetadata ? new Map(inheritedMetadata.fieldIndexMap) : new Map()
     };

packages/framework/core/src/ECS/Sync/encoding/Decoder.ts

@@ -12,39 +12,7 @@ import type { Scene } from '../../Scene';
 import type { SyncType, SyncMetadata } from '../types';
 import { SyncOperation, SYNC_METADATA } from '../types';
 import { BinaryReader } from './BinaryReader';
-
-/**
- * @zh 组件类型注册表
- * @en Component type registry
- */
-const componentRegistry = new Map<string, new () => Component>();
-
-/**
- * @zh 注册组件类型
- * @en Register component type
- *
- * @param typeId - @zh 组件类型 ID @en Component type ID
- * @param componentClass - @zh 组件类 @en Component class
- */
-export function registerSyncComponent<T extends Component>(
-    typeId: string,
-    componentClass: new () => T
-): void {
-    componentRegistry.set(typeId, componentClass);
-}
-
-/**
- * @zh 从 @ECSComponent 装饰器自动注册
- * @en Auto-register from @ECSComponent decorator
- *
- * @param componentClass - @zh 组件类 @en Component class
- */
-export function autoRegisterSyncComponent(componentClass: new () => Component): void {
-    const metadata: SyncMetadata | undefined = (componentClass as any)[SYNC_METADATA];
-    if (metadata) {
-        componentRegistry.set(metadata.typeId, componentClass);
-    }
-}
+import { GlobalComponentRegistry } from '../../Core/ComponentStorage/ComponentRegistry';
 
 /**
  * @zh 解码字段值
@@ -166,8 +134,8 @@ export function decodeEntity(
         const typeId = reader.readString();
         componentTypes.push(typeId);
 
-        // Find component class from registry
-        const componentClass = componentRegistry.get(typeId);
+        // Find component class from GlobalComponentRegistry
+        const componentClass = GlobalComponentRegistry.getComponentType(typeId) as (new () => Component) | null;
         if (!componentClass) {
             console.warn(`Unknown component type: ${typeId}`);
             // Skip component data - we need to read it to advance the reader
@@ -306,7 +274,7 @@ export function decodeSpawn(
         const typeId = reader.readString();
         componentTypes.push(typeId);
 
-        const componentClass = componentRegistry.get(typeId);
+        const componentClass = GlobalComponentRegistry.getComponentType(typeId) as (new () => Component) | null;
         if (!componentClass) {
             console.warn(`Unknown component type: ${typeId}`);
             // Try to skip
@@ -322,7 +290,7 @@ export function decodeSpawn(
             continue;
         }
 
-        const component = entity.addComponent(new componentClass());
+        const component = entity.addComponent(new (componentClass as new () => Component)());
         decodeComponent(component, metadata, reader);
     }
 

packages/framework/core/src/ECS/Sync/encoding/index.ts

@@ -34,8 +34,6 @@ export {
 
 // Decoder
 export {
-    registerSyncComponent,
-    autoRegisterSyncComponent,
     decodeComponent,
     decodeEntity,
     decodeSnapshot,

packages/framework/core/tests/ECS/Sync/decorators.test.ts

@@ -53,7 +53,7 @@ describe('@sync 装饰器测试', () => {
             const metadata = getSyncMetadata(PlayerComponent);
 
             expect(metadata).not.toBeNull();
-            expect(metadata!.typeId).toBe('PlayerComponent');
+            expect(metadata!.typeId).toBe('SyncTest_PlayerComponent');
             expect(metadata!.fields.length).toBe(4);
         });
 

packages/framework/core/tests/ECS/Sync/encoding.test.ts

@@ -13,8 +13,7 @@ import {
 import {
     decodeSnapshot,
     decodeSpawn,
-    processDespawn,
-    registerSyncComponent
+    processDespawn
 } from '../../../src/ECS/Sync/encoding/Decoder';
 import { SyncOperation } from '../../../src/ECS/Sync/types';
 
@@ -320,10 +319,7 @@ describe('BinaryWriter/BinaryReader - 二进制读写器测试', () => {
 describe('Encoder/Decoder - 实体编解码测试', () => {
     let scene: Scene;
 
-    beforeAll(() => {
-        registerSyncComponent('PlayerComponent', PlayerComponent);
-        registerSyncComponent('AllTypesComponent', AllTypesComponent);
-    });
+    // Components are auto-registered via @ECSComponent decorator
 
     beforeEach(() => {
         scene = new Scene();
@@ -414,7 +410,7 @@ describe('Encoder/Decoder - 实体编解码测试', () => {
 
             expect(result).not.toBeNull();
             expect(result!.prefabType).toBe('Player');
-            expect(result!.componentTypes).toContain('PlayerComponent');
+            expect(result!.componentTypes).toContain('EncodingTest_PlayerComponent');
 
             const decodedComp = result!.entity.getComponent(PlayerComponent);
             expect(decodedComp!.name).toBe("SpawnedPlayer");
@@ -470,10 +466,6 @@ describe('Encoder/Decoder - 实体编解码测试', () => {
     });
 
     describe('所有同步类型编解码', () => {
-        beforeAll(() => {
-            registerSyncComponent('AllTypesComponent', AllTypesComponent);
-        });
-
         test('应该正确编解码所有类型', () => {
             const entity = scene.createEntity('AllTypes');
             const comp = entity.addComponent(new AllTypesComponent());

packages/framework/fsm/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @esengine/fsm
 
+## 2.0.1
+
+### Patch Changes
+
+- Updated dependencies [[`a08a84b`](https://github.com/esengine/esengine/commit/a08a84b7db28e1140cbc637d442552747ad81c76)]:
+    - @esengine/ecs-framework@2.5.1
+    - @esengine/blueprint@2.0.1
+
 ## 2.0.0
 
 ### Patch Changes

packages/framework/fsm/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@esengine/fsm",
-    "version": "2.0.0",
+    "version": "2.0.1",
     "description": "Finite State Machine for ECS Framework / ECS 框架的有限状态机",
     "type": "module",
     "main": "./dist/index.js",

packages/framework/network/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @esengine/network
 
+## 3.0.1
+
+### Patch Changes
+
+- Updated dependencies [[`a08a84b`](https://github.com/esengine/esengine/commit/a08a84b7db28e1140cbc637d442552747ad81c76)]:
+    - @esengine/ecs-framework@2.5.1
+    - @esengine/blueprint@2.0.1
+
 ## 3.0.0
 
 ### Minor Changes

packages/framework/network/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@esengine/network",
-    "version": "3.0.0",
+    "version": "3.0.1",
     "description": "Network synchronization for multiplayer games",
     "esengine": {
         "plugin": true,

packages/framework/network/src/sync/ComponentSync.ts

@@ -23,7 +23,7 @@ import {
     decodeSnapshot,
     decodeSpawn,
     processDespawn,
-    registerSyncComponent,
+    GlobalComponentRegistry,
     type DecodeSnapshotResult,
     type DecodeSpawnResult,
 } from '@esengine/ecs-framework';
@@ -166,10 +166,7 @@ export class ComponentSyncSystem extends EntitySystem {
      * @en Client needs to call this to register all component types to be synced
      */
     public registerComponent<T extends new () => any>(componentClass: T): void {
-        const metadata: SyncMetadata | undefined = (componentClass as any)[SYNC_METADATA];
-        if (metadata) {
-            registerSyncComponent(metadata.typeId, componentClass as any);
-        }
+        GlobalComponentRegistry.register(componentClass as any);
     }
 
     // =========================================================================

packages/framework/pathfinding/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @esengine/pathfinding
 
+## 2.0.1
+
+### Patch Changes
+
+- Updated dependencies [[`a08a84b`](https://github.com/esengine/esengine/commit/a08a84b7db28e1140cbc637d442552747ad81c76)]:
+    - @esengine/ecs-framework@2.5.1
+    - @esengine/blueprint@2.0.1
+
 ## 2.0.0
 
 ### Patch Changes

packages/framework/pathfinding/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@esengine/pathfinding",
-    "version": "2.0.0",
+    "version": "2.0.1",
     "description": "寻路系统 | Pathfinding System - A*, Grid, NavMesh",
     "type": "module",
     "main": "./dist/index.js",

packages/framework/procgen/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @esengine/procgen
 
+## 2.0.1
+
+### Patch Changes
+
+- Updated dependencies [[`a08a84b`](https://github.com/esengine/esengine/commit/a08a84b7db28e1140cbc637d442552747ad81c76)]:
+    - @esengine/ecs-framework@2.5.1
+    - @esengine/blueprint@2.0.1
+
 ## 2.0.0
 
 ### Patch Changes

packages/framework/procgen/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@esengine/procgen",
-    "version": "2.0.0",
+    "version": "2.0.1",
     "description": "Procedural generation tools for ECS Framework / ECS 框架的程序化生成工具",
     "type": "module",
     "main": "./dist/index.js",

packages/framework/server/package.json

@@ -51,7 +51,7 @@
   "peerDependencies": {
     "ws": ">=8.0.0",
     "jsonwebtoken": ">=9.0.0",
-    "@esengine/ecs-framework": ">=2.5.0"
+    "@esengine/ecs-framework": ">=2.5.1"
   },
   "peerDependenciesMeta": {
     "jsonwebtoken": {

packages/framework/server/src/ecs/index.ts

@@ -32,6 +32,9 @@
 export { ECSRoom } from './ECSRoom.js';
 export type { ECSRoomConfig } from './ECSRoom.js';
 
+// Re-export Player for convenience
+export { Player, type IPlayer } from '../room/Player.js';
+
 // Re-export commonly used ECS types for convenience
 export type {
     Entity,

packages/framework/spatial/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @esengine/spatial
 
+## 2.0.1
+
+### Patch Changes
+
+- Updated dependencies [[`a08a84b`](https://github.com/esengine/esengine/commit/a08a84b7db28e1140cbc637d442552747ad81c76)]:
+    - @esengine/ecs-framework@2.5.1
+    - @esengine/blueprint@2.0.1
+
 ## 2.0.0
 
 ### Patch Changes

packages/framework/spatial/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@esengine/spatial",
-    "version": "2.0.0",
+    "version": "2.0.1",
     "description": "Spatial query and indexing system for ECS Framework / ECS 框架的空间查询和索引系统",
     "type": "module",
     "main": "./dist/index.js",

packages/framework/timer/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @esengine/timer
 
+## 2.0.1
+
+### Patch Changes
+
+- Updated dependencies [[`a08a84b`](https://github.com/esengine/esengine/commit/a08a84b7db28e1140cbc637d442552747ad81c76)]:
+    - @esengine/ecs-framework@2.5.1
+    - @esengine/blueprint@2.0.1
+
 ## 2.0.0
 
 ### Patch Changes

packages/framework/timer/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@esengine/timer",
-    "version": "2.0.0",
+    "version": "2.0.1",
     "description": "Timer and cooldown system for ECS Framework / ECS 框架的定时器和冷却系统",
     "type": "module",
     "main": "./dist/index.js",

packages/tools/demos/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @esengine/demos
 
+## 1.0.6
+
+### Patch Changes
+
+- Updated dependencies []:
+    - @esengine/fsm@2.0.1
+    - @esengine/pathfinding@2.0.1
+    - @esengine/procgen@2.0.1
+    - @esengine/spatial@2.0.1
+    - @esengine/timer@2.0.1
+
 ## 1.0.5
 
 ### Patch Changes

packages/tools/demos/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@esengine/demos",
-    "version": "1.0.5",
+    "version": "1.0.6",
     "private": true,
     "description": "Demo tests for ESEngine modules documentation",
     "type": "module",