tang-ui-x 1.1.1 → 1.1.2

package/composables/i18n/validation-demo.uts

@@ -0,0 +1,45 @@
+/**
+ * JSON 结构验证演示
+ * 展示 validateMessages 方法的工作原理
+ */
+
+import { registerLocale, registerLocaleWithMode, replaceLocale } from './index.uts'
+import type { ModularLocaleMessages } from './types.uts'
+
+console.log('=== JSON 结构验证演示 ===\n')
+
+// 示例 1: 有效的语言包
+console.log('1. 注册有效的语言包')
+const validMessages: ModularLocaleMessages = {
+  common: {
+    confirm: '确定',
+    cancel: '取消'
+  }
+}
+registerLocale('demo-valid', validMessages)
+console.log('✓ 成功\n')
+
+// 示例 2: 无效的语言包（null）
+console.log('2. 尝试注册 null')
+registerLocale('demo-null', null as any)
+console.log('✗ 应该被拒绝\n')
+
+// 示例 3: 无效的模块
+console.log('3. 尝试注册无效模块')
+const invalidModule: any = {
+  common: 'not an object'
+}
+registerLocale('demo-invalid-module', invalidModule)
+console.log('✗ 应该被拒绝\n')
+
+// 示例 4: 无效的键值
+console.log('4. 尝试注册无效键值')
+const invalidValue: any = {
+  common: {
+    confirm: 123
+  }
+}
+registerLocale('demo-invalid-value', invalidValue)
+console.log('✗ 应该被拒绝\n')
+
+console.log('=== 演示完成 ===')

package/composables/i18n/validation-test.uts

@@ -0,0 +1,106 @@
+/**
+ * 验证 JSON 结构验证功能
+ * 测试 validateMessages 方法的各种场景
+ */
+
+import { I18nManager } from './manager.uts'
+import type { ModularLocaleMessages } from './types.uts'
+
+console.log('=== JSON 结构验证测试 ===\n')
+
+const manager = I18nManager.getInstance()
+
+// 测试 1: 有效的语言包结构
+console.log('测试 1: 有效的语言包结构')
+const validMessages: ModularLocaleMessages = {
+  common: {
+    confirm: '确定',
+    cancel: '取消'
+  },
+  dialog: {
+    title: '提示'
+  }
+}
+manager.registerMessages('test-valid', validMessages)
+console.log('✓ 有效语言包注册成功')
+console.log('可用语言:', manager.getAvailableLocales().value)
+console.log('')
+
+// 测试 2: 无效的语言包（null）
+console.log('测试 2: 无效的语言包（null）')
+try {
+  manager.registerMessages('test-null', null as any)
+  console.log('✗ 应该拒绝 null 语言包')
+} catch (e) {
+  console.log('✓ 正确拒绝 null 语言包')
+}
+console.log('')
+
+// 测试 3: 无效的语言包（数组）
+console.log('测试 3: 无效的语言包（数组）')
+manager.registerMessages('test-array', [] as any)
+console.log('检查是否注册:', manager.hasLocale('test-array'))
+console.log('')
+
+// 测试 4: 无效的模块（不是对象）
+console.log('测试 4: 无效的模块（不是对象）')
+const invalidModule: any = {
+  common: 'not an object'
+}
+manager.registerMessages('test-invalid-module', invalidModule)
+console.log('检查是否注册:', manager.hasLocale('test-invalid-module'))
+console.log('')
+
+// 测试 5: 无效的键值（不是字符串）
+console.log('测试 5: 无效的键值（不是字符串）')
+const invalidValue: any = {
+  common: {
+    confirm: 123,  // 数字而非字符串
+    cancel: '取消'
+  }
+}
+manager.registerMessages('test-invalid-value', invalidValue)
+console.log('检查是否注册:', manager.hasLocale('test-invalid-value'))
+console.log('')
+
+// 测试 6: 部分有效的语言包（应该完全拒绝）
+console.log('测试 6: 部分有效的语言包')
+const partiallyValid: any = {
+  common: {
+    confirm: '确定',
+    cancel: '取消'
+  },
+  dialog: {
+    title: '提示',
+    invalid: { nested: 'object' }  // 嵌套对象而非字符串
+  }
+}
+manager.registerMessages('test-partial', partiallyValid)
+console.log('检查是否注册:', manager.hasLocale('test-partial'))
+console.log('')
+
+// 测试 7: 替换模式也应该验证
+console.log('测试 7: 替换模式验证')
+manager.registerMessagesWithMode('test-replace', invalidValue, 'replace')
+console.log('检查是否注册:', manager.hasLocale('test-replace'))
+console.log('')
+
+// 测试 8: 空对象是有效的
+console.log('测试 8: 空对象是有效的')
+manager.registerMessages('test-empty', {})
+console.log('✓ 空对象注册成功')
+console.log('检查是否注册:', manager.hasLocale('test-empty'))
+console.log('')
+
+// 测试 9: 空模块是有效的
+console.log('测试 9: 空模块是有效的')
+const emptyModule: ModularLocaleMessages = {
+  common: {}
+}
+manager.registerMessages('test-empty-module', emptyModule)
+console.log('✓ 空模块注册成功')
+console.log('检查是否注册:', manager.hasLocale('test-empty-module'))
+console.log('')
+
+console.log('=== 测试完成 ===')
+console.log('最终可用语言列表:', manager.getAvailableLocales().value)

package/composables/useI18n.uts

@@ -0,0 +1,77 @@
+/**
+ * useI18n Composable
+ * 为组件提供响应式的 i18n 功能
+ */
+
+import { computed } from 'vue'
+import type { ComputedRef } from 'vue'
+import { I18nManager } from './i18n/manager.uts'
+import type { TranslateParams } from './i18n/types.uts'
+
+/**
+ * useI18n 返回类型
+ */
+export interface UseI18nReturn {
+  /** 翻译函数 */
+  $t: (key: string, params?: TranslateParams) => string
+  /** 当前语言（响应式） */
+  locale: ComputedRef<string>
+  /** 可用语言列表（响应式） */
+  availableLocales: ComputedRef<string[]>
+  /** 设置语言 */
+  setLocale: (locale: string) => boolean
+}
+
+/**
+ * useI18n Composable 函数
+ * 提供响应式的多语言功能
+ * 
+ * @returns i18n 功能对象
+ * 
+ * @example
+ * ```typescript
+ * const { $t, locale, setLocale, availableLocales } = useI18n()
+ * 
+ * // 翻译文本
+ * const title = $t('common.confirm')
+ * 
+ * // 带参数的翻译
+ * const greeting = $t('common.hello', { name: '张三' })
+ * 
+ * // 切换语言
+ * setLocale('en-US')
+ * 
+ * // 获取当前语言
+ * console.log(locale.value)
+ * 
+ * // 获取可用语言列表
+ * console.log(availableLocales.value)
+ * ```
+ */
+export function useI18n(): UseI18nReturn {
+  // 获取 I18nManager 单例实例
+  const manager = I18nManager.getInstance()
+  
+  // 翻译函数：调用 manager.translate()
+  const $t = (key: string, params?: TranslateParams): string => {
+    return manager.translate(key, params)
+  }
+  
+  // 当前语言（响应式 computed）
+  const locale = computed<string>(() => manager.currentLocale.value)
+  
+  // 可用语言列表（响应式 computed）
+  const availableLocales = manager.getAvailableLocales()
+  
+  // 设置语言方法
+  const setLocale = (locale: string): boolean => {
+    return manager.setLocale(locale)
+  }
+  
+  return {
+    $t,
+    locale,
+    availableLocales,
+    setLocale
+  }
+}

package/index.uts

@@ -30,6 +30,29 @@ export { useTheme } from './composables/useTheme.uts'
 export { useToast } from './composables/useToast.uts'
 export { useModal } from './composables/useModal.uts'
 
+// 导出 i18n composable
+export { useI18n } from './composables/useI18n.uts'
+export type { UseI18nReturn } from './composables/useI18n.uts'
+
+// 导出 i18n 全局函数
+export {
+  setLanguage,
+  registerLocale,
+  registerLocaleWithMode,
+  replaceLocale,
+  getCurrentLocale,
+  getAvailableLocales
+} from './composables/i18n/index.uts'
+
+// 导出 i18n 类型定义
+export type {
+  LocaleMessages,
+  ModularLocaleMessages,
+  LocaleCode,
+  I18nConfig,
+  TranslateParams
+} from './composables/i18n/types.uts'
+
 // 版本信息
 export const version: string = '1.0.5'