refactor(plugin): 重构插件系统架构，统一类型导入路径 (#296)

* refactor(plugin): 重构插件系统架构，统一类型导入路径

## 主要更改

### 新增 @esengine/plugin-types 包
- 提供打破循环依赖的最小类型定义
- 包含 ServiceToken, createServiceToken, PluginServiceRegistry, IEditorModuleBase

### engine-core 类型统一
- IPlugin<T> 泛型参数改为 T = unknown
- 所有运行时类型（IRuntimeModule, ModuleManifest, SystemContext）在此定义
- 新增 PluginServiceRegistry.ts 导出服务令牌相关类型

### editor-core 类型优化
- 重命名 IPluginLoader.ts 为 EditorModule.ts
- 新增 IEditorPlugin = IPlugin<IEditorModuleLoader> 类型别名
- 移除弃用别名 IPluginLoader, IRuntimeModuleLoader

### 编辑器插件更新
- 所有 9 个编辑器插件使用 IEditorPlugin 类型
- 统一从 editor-core 导入编辑器类型

### 服务令牌规范
- 各模块在 tokens.ts 中定义自己的服务接口和令牌
- 遵循"谁定义接口，谁导出 Token"原则

## 导入规范

| 场景 | 导入来源 |
|------|---------|
| 运行时模块 | @esengine/engine-core |
| 编辑器插件 | @esengine/editor-core |
| 服务令牌 | @esengine/engine-core |

* refactor(plugin): 完善服务令牌规范，统一运行时模块

## 更改内容

### 运行时模块优化
- particle: 使用 PluginServiceRegistry 获取依赖服务
- physics-rapier2d: 通过服务令牌注册/获取物理查询接口
- tilemap: 使用服务令牌获取物理系统依赖
- sprite: 导出服务令牌
- ui: 导出服务令牌
- behavior-tree: 使用服务令牌系统

### 资产系统增强
- IAssetManager 接口扩展
- 加载器使用服务令牌获取依赖

### 运行时核心
- GameRuntime 使用 PluginServiceRegistry
- 导出服务令牌相关类型

### 编辑器服务
- EngineService 适配新的服务令牌系统
- AssetRegistryService 优化

* fix: 修复 editor-app 和 behavior-tree-editor 中的类型引用

- editor-app/PluginLoader.ts: 使用 IPlugin 替代 IPluginLoader
- behavior-tree-editor: 使用 IEditorPlugin 替代 IPluginLoader

* fix(ui): 添加缺失的 ecs-engine-bindgen 依赖

UIRuntimeModule 使用 EngineBridgeToken，需要声明对 ecs-engine-bindgen 的依赖

* fix(type): 解决 ServiceToken 跨包类型兼容性问题

- 在 engine-core 中直接定义 ServiceToken 和 PluginServiceRegistry
  而不是从 plugin-types 重新导出，确保 tsup 生成的类型声明
  以 engine-core 作为类型来源
- 移除 RuntimeResolver.ts 中的硬编码模块 ID 检查，
  改用 module.json 中的 name 配置
- 修复 pnpm-lock.yaml 中的依赖记录

* refactor(arch): 改进架构设计，移除硬编码

- 统一类型导出：editor-core 从 engine-core 导入 IEditorModuleBase
- RuntimeResolver: 将硬编码路径改为配置常量和搜索路径列表
- 添加跨平台安装路径支持（Windows/macOS/Linux）
- 使用 ENGINE_WASM_CONFIG 配置引擎 WASM 文件信息
- IBundlePackOptions 添加 preloadBundles 配置项

* fix(particle): 添加缺失的 ecs-engine-bindgen 依赖

ParticleRuntimeModule 导入了 @esengine/ecs-engine-bindgen 的 tokens，
但 package.json 中未声明该依赖，导致 CI 构建失败。

* fix(physics-rapier2d): 移除不存在的 PhysicsSystemContext 导出

PhysicsRuntimeModule 中不存在该类型，导致 type-check 失败

packages/ui/package.json

@@ -29,6 +29,7 @@
     "devDependencies": {
         "@esengine/ecs-framework": "workspace:*",
         "@esengine/engine-core": "workspace:*",
+        "@esengine/ecs-engine-bindgen": "workspace:*",
         "@esengine/build-config": "workspace:*",
         "rimraf": "^5.0.5",
         "tsup": "^8.0.0",

packages/ui/src/UIRuntimeModule.ts

@@ -1,6 +1,7 @@
 import type { IScene } from '@esengine/ecs-framework';
 import { ComponentRegistry } from '@esengine/ecs-framework';
 import type { IRuntimeModule, IPlugin, ModuleManifest, SystemContext } from '@esengine/engine-core';
+import { EngineBridgeToken } from '@esengine/ecs-engine-bindgen';
 
 import {
     UITransformComponent,
@@ -26,13 +27,20 @@ import {
     UISliderRenderSystem,
     UIScrollViewRenderSystem
 } from './systems/render';
+import {
+    UILayoutSystemToken,
+    UIInputSystemToken,
+    UIRenderProviderToken,
+    UITextRenderSystemToken
+} from './tokens';
 
-export interface UISystemContext extends SystemContext {
-    uiLayoutSystem?: UILayoutSystem;
-    uiRenderProvider?: UIRenderDataProvider;
-    uiInputSystem?: UIInputSystem;
-    uiTextRenderSystem?: UITextRenderSystem;
-}
+// 重新导出 tokens | Re-export tokens
+export {
+    UILayoutSystemToken,
+    UIInputSystemToken,
+    UIRenderProviderToken,
+    UITextRenderSystemToken
+} from './tokens';
 
 class UIRuntimeModule implements IRuntimeModule {
     registerComponents(registry: typeof ComponentRegistry): void {
@@ -48,7 +56,8 @@ class UIRuntimeModule implements IRuntimeModule {
     }
 
     createSystems(scene: IScene, context: SystemContext): void {
-        const uiContext = context as UISystemContext;
+        // 从服务注册表获取依赖 | Get dependencies from service registry
+        const engineBridge = context.services.get(EngineBridgeToken);
 
         const layoutSystem = new UILayoutSystem();
         scene.addSystem(layoutSystem);
@@ -77,9 +86,9 @@ class UIRuntimeModule implements IRuntimeModule {
         const textRenderSystem = new UITextRenderSystem();
         scene.addSystem(textRenderSystem);
 
-        if (uiContext.engineBridge) {
+        if (engineBridge) {
             textRenderSystem.setTextureCallback((id: number, dataUrl: string) => {
-                uiContext.engineBridge.loadTexture(id, dataUrl);
+                engineBridge.loadTexture(id, dataUrl);
             });
         }
 
@@ -88,10 +97,11 @@ class UIRuntimeModule implements IRuntimeModule {
         inputSystem.setLayoutSystem(layoutSystem);
         scene.addSystem(inputSystem);
 
-        uiContext.uiLayoutSystem = layoutSystem;
-        uiContext.uiRenderProvider = uiRenderProvider;
-        uiContext.uiInputSystem = inputSystem;
-        uiContext.uiTextRenderSystem = textRenderSystem;
+        // 注册服务到服务注册表 | Register services to service registry
+        context.services.register(UILayoutSystemToken, layoutSystem);
+        context.services.register(UIRenderProviderToken, uiRenderProvider);
+        context.services.register(UIInputSystemToken, inputSystem);
+        context.services.register(UITextRenderSystemToken, textRenderSystem);
     }
 }
 

packages/ui/src/index.ts

@@ -162,4 +162,12 @@ export {
 } from './UIBuilder';
 
 // Runtime module and plugin
-export { UIRuntimeModule, UIPlugin, type UISystemContext } from './UIRuntimeModule';
+export { UIRuntimeModule, UIPlugin } from './UIRuntimeModule';
+
+// Service tokens | 服务令牌
+export {
+    UILayoutSystemToken,
+    UIInputSystemToken,
+    UIRenderProviderToken,
+    UITextRenderSystemToken
+} from './tokens';

packages/ui/src/tokens.ts

@@ -0,0 +1,38 @@
+/**
+ * UI 模块服务令牌
+ * UI module service tokens
+ */
+
+import { createServiceToken } from '@esengine/engine-core';
+import type { UILayoutSystem } from './systems/UILayoutSystem';
+import type { UIInputSystem } from './systems/UIInputSystem';
+import type { UIRenderDataProvider } from './systems/UIRenderDataProvider';
+import type { UITextRenderSystem } from './systems/render';
+
+// ============================================================================
+// UI 模块导出的令牌 | Tokens exported by UI module
+// ============================================================================
+
+/**
+ * UI 布局系统令牌
+ * UI layout system token
+ */
+export const UILayoutSystemToken = createServiceToken<UILayoutSystem>('uiLayoutSystem');
+
+/**
+ * UI 输入系统令牌
+ * UI input system token
+ */
+export const UIInputSystemToken = createServiceToken<UIInputSystem>('uiInputSystem');
+
+/**
+ * UI 渲染数据提供者令牌
+ * UI render data provider token
+ */
+export const UIRenderProviderToken = createServiceToken<UIRenderDataProvider>('uiRenderProvider');
+
+/**
+ * UI 文本渲染系统令牌
+ * UI text render system token
+ */
+export const UITextRenderSystemToken = createServiceToken<UITextRenderSystem>('uiTextRenderSystem');