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

@@ -0,0 +1,66 @@
/**
* Behavior Tree Editor Service Tokens
* 行为树编辑器服务令牌
*
* 遵循"谁定义接口,谁导出 Token"的原则。
* Following the "who defines interface, who exports token" principle.
*/
import { createServiceToken } from '@esengine/engine-core';
import type { IService } from '@esengine/ecs-framework';
import type { BehaviorTree } from './domain/models/BehaviorTree';
/**
* 行为树服务接口
* Behavior Tree Service Interface
*/
export interface IBehaviorTreeService extends IService {
/**
* 创建新的行为树
* Create a new behavior tree
*/
createNew(): Promise<void>;
/**
* 从文件加载行为树
* Load behavior tree from file
* @param filePath 文件路径 | File path
*/
loadFromFile(filePath: string): Promise<void>;
/**
* 保存行为树到文件
* Save behavior tree to file
* @param filePath 文件路径 | File path
* @param metadata 可选的元数据 | Optional metadata
*/
saveToFile(filePath: string, metadata?: { name: string; description: string }): Promise<void>;
/**
* 获取当前行为树
* Get current behavior tree
*/
getCurrentTree(): BehaviorTree;
/**
* 设置行为树
* Set behavior tree
* @param tree 行为树 | Behavior tree
*/
setTree(tree: BehaviorTree): void;
}
/**
* 行为树服务令牌
* Behavior Tree Service Token
*
* @example
* ```typescript
* import { BehaviorTreeServiceToken } from '@esengine/behavior-tree-editor';
* import { PluginAPI } from '@esengine/editor-runtime';
*
* const service = PluginAPI.resolve(BehaviorTreeServiceToken);
* await service.loadFromFile('/path/to/tree.btree');
* ```
*/
export const BehaviorTreeServiceToken = createServiceToken<IBehaviorTreeService>('behaviorTreeService');