feat(i18n): 统一国际化系统架构,支持插件独立翻译 (#301)

* feat(i18n): 统一国际化系统架构,支持插件独立翻译

## 主要改动

### 核心架构
- 增强 LocaleService,支持插件命名空间翻译扩展
- 新增 editor-runtime/i18n 模块,提供 createPluginLocale/createPluginTranslator
- 新增 editor-core/tokens.ts,定义 LocaleServiceToken 等服务令牌
- 改进 PluginAPI 类型安全,使用 ServiceToken<T> 替代 any

### 编辑器本地化
- 扩展 en.ts/zh.ts 翻译文件,覆盖所有 UI 组件
- 新增 es.ts 西班牙语支持
- 重构 40+ 组件使用 useLocale() hook

### 插件本地化系统
- behavior-tree-editor: 新增 locales/ 和 useBTLocale hook
- material-editor: 新增 locales/ 和 useMaterialLocale hook
- particle-editor: 新增 locales/ 和 useParticleLocale hook
- tilemap-editor: 新增 locales/ 和 useTilemapLocale hook
- ui-editor: 新增 locales/ 和 useUILocale hook

### 类型安全改进
- 修复 Debug 工具使用公共接口替代 as any
- 修复 ChunkStreamingSystem 添加 forEachChunk 公共方法
- 修复 blueprint-editor 移除不必要的向后兼容代码

* fix(behavior-tree-editor): 使用 ServiceToken 模式修复服务解析

- 创建 BehaviorTreeServiceToken 遵循"谁定义接口,谁导出Token"原则
- 使用 ServiceToken.id (symbol) 注册服务到 ServiceContainer
- 更新 PluginSDKRegistry.resolveService 支持 ServiceToken 检测
- BehaviorTreeEditorPanel 现在使用类型安全的 PluginAPI.resolve

* fix(behavior-tree-editor): 使用 ServiceContainer.resolve 获取类注册的服务

* fix: 修复多个包的依赖和类型问题

- core: EntityDataCollector.getEntityDetails 使用 HierarchySystem 获取父实体
- ui-editor: 添加 @esengine/editor-runtime 依赖
- tilemap-editor: 添加 @esengine/editor-runtime 依赖
- particle-editor: 添加 @esengine/editor-runtime 依赖
This commit is contained in:
YHH
2025-12-09 18:04:03 +08:00
committed by GitHub
parent 995fa2d514
commit 1b0d38edce
103 changed files with 8015 additions and 1633 deletions

View File

@@ -1,29 +1,63 @@
/**
* Plugin API - 为插件提供简洁的访问接口
* Plugin API - Provides simple access interface for plugins
*
* 使用方式
* 使用方式 | Usage:
* ```typescript
* import { PluginAPI } from '@esengine/editor-runtime';
*
* const scene = PluginAPI.scene;
* const entityStore = PluginAPI.entityStore;
* const messageHub = PluginAPI.messageHub;
*
* // 使用 ServiceToken 获取服务(类型安全)| Get service with ServiceToken (type-safe)
* import { AssetManagerToken } from '@esengine/asset-system';
* const assetManager = PluginAPI.resolve(AssetManagerToken);
* ```
*
* 这个 API 会自动从全局 __ESENGINE__ 获取正确的实例,
* 避免模块实例不一致的问题。
* This API automatically gets correct instances from global __ESENGINE__,
* avoiding module instance inconsistency issues.
*/
import type { EntityStoreService, MessageHub } from '@esengine/editor-core';
import type { Scene, ServiceContainer } from '@esengine/ecs-framework';
import type { ServiceToken } from '@esengine/engine-core';
// 内部 API 接口定义
/**
* 核心服务接口
* Core service interface
*
* 定义内部 Core 提供的服务访问接口。
* Defines service access interface provided by internal Core.
*/
interface ICoreServices {
services: ServiceContainer;
}
/**
* 内部 API 接口定义
* Internal API interface definition
*
* 定义全局 __ESENGINE__.api 提供的方法。
* Defines methods provided by global __ESENGINE__.api.
*/
interface IPluginAPIInternal {
/** 获取当前场景 | Get current scene */
getScene(): Scene | null;
/** 获取实体存储服务 | Get entity store service */
getEntityStore(): EntityStoreService;
/** 获取消息总线 | Get message hub */
getMessageHub(): MessageHub;
resolveService<T>(serviceType: any): T;
getCore(): any;
/**
* 解析服务(类型安全)
* Resolve service (type-safe)
* @param token 服务令牌 | Service token
*/
resolveService<T>(token: ServiceToken<T>): T;
/** 获取核心实例 | Get core instance */
getCore(): ICoreServices;
}
// 声明全局类型
@@ -93,11 +127,24 @@ export const PluginAPI = {
},
/**
* 解析服务
* @param serviceType 服务类型
* 解析服务(类型安全)
* Resolve service (type-safe)
*
* 使用 ServiceToken 获取服务实例,提供完整的类型推断。
* Use ServiceToken to get service instance with full type inference.
*
* @param token 服务令牌 | Service token
* @returns 服务实例 | Service instance
*
* @example
* ```typescript
* import { AssetManagerToken } from '@esengine/asset-system';
* const assetManager = PluginAPI.resolve(AssetManagerToken);
* // assetManager 类型自动推断为 IAssetManager
* ```
*/
resolve<T>(serviceType: any): T {
return getInternalAPI().resolveService<T>(serviceType);
resolve<T>(token: ServiceToken<T>): T {
return getInternalAPI().resolveService<T>(token);
},
/**