Files
esengine/packages/behavior-tree-editor/src/hooks/useBTLocale.ts

74 lines
2.2 KiB
TypeScript
Raw Normal View History

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 依赖
2025-12-09 18:04:03 +08:00
/**
* Behavior Tree Editor Locale Hook
*
*
* Uses the unified plugin i18n infrastructure from editor-runtime.
* 使 editor-runtime
*/
import {
createPluginLocale,
createPluginTranslator,
getCurrentLocale
} from '@esengine/editor-runtime';
import { en, zh, es } from '../locales';
import type { Locale, TranslationParams } from '@esengine/editor-core';
// Create translations bundle
// 创建翻译包
const translations = { en, zh, es };
/**
* Hook for accessing behavior tree editor translations
* 访 Hook
*
* Uses the unified createPluginLocale factory from editor-runtime.
* 使 editor-runtime createPluginLocale
*
* @example
* ```tsx
* const { t, locale } = useBTLocale();
* return <button title={t('toolbar.save')}>{t('toolbar.saveUnsaved')}</button>;
* ```
*/
export const useBTLocale = createPluginLocale(translations);
// Create non-React translator using the unified infrastructure
// 使用统一基础设施创建非 React 翻译器
const btTranslator = createPluginTranslator(translations);
/**
* Non-React translation function for behavior tree editor
* React
*
* Use this in services, utilities, and other non-React contexts.
* React 使
*
* @param key - Translation key |
* @param locale - Optional locale, defaults to current locale | 使
* @param params - Optional interpolation parameters |
*
* @example
* ```typescript
* // With explicit locale
* translateBT('errors.notFound', 'zh');
*
* // With current locale (auto-detected)
* translateBT('errors.notFound');
*
* // With parameters
* translateBT('messages.saved', undefined, { name: 'MyTree' });
* ```
*/
export function translateBT(
key: string,
locale?: Locale,
params?: TranslationParams
): string {
const targetLocale = locale || getCurrentLocale();
return btTranslator(key, targetLocale, params);
}
// Re-export for external use
// 重新导出供外部使用
export { getCurrentLocale } from '@esengine/editor-runtime';