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:
66
packages/behavior-tree-editor/src/tokens.ts
Normal file
66
packages/behavior-tree-editor/src/tokens.ts
Normal 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');
|
||||
Reference in New Issue
Block a user