tang-ui-x 1.1.1 → 1.1.2

package/composables/i18n/task23-verification.uts

@@ -0,0 +1,343 @@
+/**
+ * Task 23 验证脚本
+ * 验证全局函数支持注册模式
+ */
+
+import { 
+  registerLocale, 
+  registerLocaleWithMode, 
+  replaceLocale,
+  setLanguage,
+  getCurrentLocale
+} from './index.uts'
+import { I18nManager } from './manager.uts'
+
+/**
+ * 验证 registerLocale 保持向后兼容（默认合并模式）
+ */
+function testRegisterLocaleBackwardCompatibility(): boolean {
+  console.log('\n=== 测试 1: registerLocale 向后兼容性（默认合并模式） ===')
+  
+  const manager = I18nManager.getInstance()
+  
+  // 注册初始语言包
+  registerLocale('test-locale-1', {
+    common: {
+      confirm: '确定',
+      cancel: '取消',
+      ok: '好的'
+    },
+    dialog: {
+      title: '提示',
+      confirmText: '确定'
+    }
+  })
+  
+  // 使用 registerLocale 覆盖部分内容（应该使用合并模式）
+  registerLocale('test-locale-1', {
+    common: {
+      confirm: '好的'  // 覆盖这个键
+      // cancel 和 ok 应该保留
+    }
+  })
+  
+  // 验证合并结果
+  setLanguage('test-locale-1')
+  const messages = manager.messages.get('test-locale-1')
+  
+  if (!messages) {
+    console.log('❌ 失败：语言包未注册')
+    return false
+  }
+  
+  // 检查 common 模块
+  const common = messages['common']
+  if (!common) {
+    console.log('❌ 失败：common 模块不存在')
+    return false
+  }
+  
+  // 验证覆盖的键
+  if (common['confirm'] !== '好的') {
+    console.log('❌ 失败：confirm 应该被覆盖为 "好的"，实际为:', common['confirm'])
+    return false
+  }
+  
+  // 验证保留的键
+  if (common['cancel'] !== '取消') {
+    console.log('❌ 失败：cancel 应该保留为 "取消"，实际为:', common['cancel'])
+    return false
+  }
+  
+  if (common['ok'] !== '好的') {
+    console.log('❌ 失败：ok 应该保留为 "好的"，实际为:', common['ok'])
+    return false
+  }
+  
+  // 验证 dialog 模块应该保留
+  const dialog = messages['dialog']
+  if (!dialog || dialog['title'] !== '提示') {
+    console.log('❌ 失败：dialog 模块应该保留')
+    return false
+  }
+  
+  console.log('✅ 通过：registerLocale 默认使用合并模式')
+  return true
+}
+
+/**
+ * 验证 registerLocaleWithMode 合并模式
+ */
+function testRegisterLocaleWithModeMerge(): boolean {
+  console.log('\n=== 测试 2: registerLocaleWithMode 合并模式 ===')
+  
+  const manager = I18nManager.getInstance()
+  
+  // 注册初始语言包
+  registerLocaleWithMode('test-locale-2', {
+    common: {
+      confirm: '确定',
+      cancel: '取消'
+    },
+    dialog: {
+      title: '提示'
+    }
+  }, 'merge')
+  
+  // 使用合并模式添加新内容
+  registerLocaleWithMode('test-locale-2', {
+    common: {
+      ok: '好的'  // 添加新键
+    },
+    empty: {
+      title: '暂无数据'  // 添加新模块
+    }
+  }, 'merge')
+  
+  const messages = manager.messages.get('test-locale-2')
+  
+  if (!messages) {
+    console.log('❌ 失败：语言包未注册')
+    return false
+  }
+  
+  // 验证原有内容保留
+  const common = messages['common']
+  if (!common || common['confirm'] !== '确定' || common['cancel'] !== '取消') {
+    console.log('❌ 失败：原有 common 内容应该保留')
+    return false
+  }
+  
+  // 验证新内容添加
+  if (common['ok'] !== '好的') {
+    console.log('❌ 失败：新键 ok 应该被添加')
+    return false
+  }
+  
+  // 验证原有模块保留
+  const dialog = messages['dialog']
+  if (!dialog || dialog['title'] !== '提示') {
+    console.log('❌ 失败：原有 dialog 模块应该保留')
+    return false
+  }
+  
+  // 验证新模块添加
+  const empty = messages['empty']
+  if (!empty || empty['title'] !== '暂无数据') {
+    console.log('❌ 失败：新模块 empty 应该被添加')
+    return false
+  }
+  
+  console.log('✅ 通过：registerLocaleWithMode 合并模式正常工作')
+  return true
+}
+
+/**
+ * 验证 registerLocaleWithMode 替换模式
+ */
+function testRegisterLocaleWithModeReplace(): boolean {
+  console.log('\n=== 测试 3: registerLocaleWithMode 替换模式 ===')
+  
+  const manager = I18nManager.getInstance()
+  
+  // 注册初始语言包
+  registerLocaleWithMode('test-locale-3', {
+    common: {
+      confirm: '确定',
+      cancel: '取消',
+      ok: '好的'
+    },
+    dialog: {
+      title: '提示',
+      confirmText: '确定'
+    }
+  }, 'merge')
+  
+  // 使用替换模式完全替换
+  registerLocaleWithMode('test-locale-3', {
+    common: {
+      confirm: '好的'  // 只有这一个键
+    }
+    // dialog 模块应该被移除
+  }, 'replace')
+  
+  const messages = manager.messages.get('test-locale-3')
+  
+  if (!messages) {
+    console.log('❌ 失败：语言包未注册')
+    return false
+  }
+  
+  // 验证只有新内容
+  const common = messages['common']
+  if (!common) {
+    console.log('❌ 失败：common 模块应该存在')
+    return false
+  }
+  
+  if (common['confirm'] !== '好的') {
+    console.log('❌ 失败：confirm 应该是 "好的"')
+    return false
+  }
+  
+  // 验证原有的其他键被移除
+  if ('cancel' in common || 'ok' in common) {
+    console.log('❌ 失败：原有的 cancel 和 ok 键应该被移除')
+    return false
+  }
+  
+  // 验证原有模块被移除
+  if ('dialog' in messages) {
+    console.log('❌ 失败：原有的 dialog 模块应该被移除')
+    return false
+  }
+  
+  console.log('✅ 通过：registerLocaleWithMode 替换模式正常工作')
+  return true
+}
+
+/**
+ * 验证 replaceLocale 函数
+ */
+function testReplaceLocale(): boolean {
+  console.log('\n=== 测试 4: replaceLocale 函数 ===')
+  
+  const manager = I18nManager.getInstance()
+  
+  // 注册初始语言包
+  registerLocale('test-locale-4', {
+    common: {
+      confirm: '确定',
+      cancel: '取消',
+      ok: '好的'
+    },
+    dialog: {
+      title: '提示'
+    },
+    empty: {
+      title: '暂无数据'
+    }
+  })
+  
+  // 使用 replaceLocale 完全替换
+  replaceLocale('test-locale-4', {
+    common: {
+      confirm: '好的',
+      cancel: '取消'
+    }
+    // 只保留 common 模块，其他模块应该被移除
+  })
+  
+  const messages = manager.messages.get('test-locale-4')
+  
+  if (!messages) {
+    console.log('❌ 失败：语言包未注册')
+    return false
+  }
+  
+  // 验证新内容存在
+  const common = messages['common']
+  if (!common || common['confirm'] !== '好的' || common['cancel'] !== '取消') {
+    console.log('❌ 失败：新的 common 内容应该存在')
+    return false
+  }
+  
+  // 验证原有的 ok 键被移除
+  if ('ok' in common) {
+    console.log('❌ 失败：原有的 ok 键应该被移除')
+    return false
+  }
+  
+  // 验证原有模块被移除
+  if ('dialog' in messages || 'empty' in messages) {
+    console.log('❌ 失败：原有的 dialog 和 empty 模块应该被移除')
+    return false
+  }
+  
+  console.log('✅ 通过：replaceLocale 函数正常工作')
+  return true
+}
+
+/**
+ * 验证函数导出
+ */
+function testFunctionExports(): boolean {
+  console.log('\n=== 测试 5: 函数导出验证 ===')
+  
+  // 验证所有函数都已导出
+  if (typeof registerLocale !== 'function') {
+    console.log('❌ 失败：registerLocale 未导出')
+    return false
+  }
+  
+  if (typeof registerLocaleWithMode !== 'function') {
+    console.log('❌ 失败：registerLocaleWithMode 未导出')
+    return false
+  }
+  
+  if (typeof replaceLocale !== 'function') {
+    console.log('❌ 失败：replaceLocale 未导出')
+    return false
+  }
+  
+  console.log('✅ 通过：所有函数都已正确导出')
+  return true
+}
+
+/**
+ * 运行所有测试
+ */
+export function runTask23Verification(): void {
+  console.log('========================================')
+  console.log('Task 23 验证：全局函数支持注册模式')
+  console.log('========================================')
+  
+  const results: boolean[] = []
+  
+  results.push(testFunctionExports())
+  results.push(testRegisterLocaleBackwardCompatibility())
+  results.push(testRegisterLocaleWithModeMerge())
+  results.push(testRegisterLocaleWithModeReplace())
+  results.push(testReplaceLocale())
+  
+  const passed = results.filter(r => r).length
+  const total = results.length
+  
+  console.log('\n========================================')
+  console.log(`测试结果: ${passed}/${total} 通过`)
+  console.log('========================================')
+  
+  if (passed === total) {
+    console.log('✅ Task 23 验证通过！')
+    console.log('\n实现的功能：')
+    console.log('1. ✅ registerLocale() 保持向后兼容（默认合并模式）')
+    console.log('2. ✅ registerLocaleWithMode() 支持指定模式')
+    console.log('3. ✅ replaceLocale() 提供便捷的替换方法')
+    console.log('4. ✅ 所有函数都已正确导出')
+  } else {
+    console.log('❌ 部分测试失败，请检查实现')
+  }
+}
+
+// 如果直接运行此文件，执行验证
+// runTask23Verification()

package/composables/i18n/task8-demo.uts

@@ -0,0 +1,93 @@
+/**
+ * Task 8 功能演示
+ * 展示 getAvailableLocales() 和 getCurrentLocale() 的使用
+ */
+
+import { I18nManager } from './manager.uts'
+import type { ModularLocaleMessages } from './types.uts'
+
+// 获取管理器实例
+const manager = I18nManager.getInstance()
+
+// 准备测试数据
+const zhCN: ModularLocaleMessages = {
+  common: { confirm: '确定', cancel: '取消' }
+}
+
+const enUS: ModularLocaleMessages = {
+  common: { confirm: 'Confirm', cancel: 'Cancel' }
+}
+
+const zhTW: ModularLocaleMessages = {
+  common: { confirm: '確定', cancel: '取消' }
+}
+
+// 演示 1: 初始状态
+console.log('=== 演示 1: 初始状态 ===')
+console.log('当前语言:', manager.getCurrentLocale())
+console.log('可用语言:', manager.getAvailableLocales().value)
+console.log('')
+
+// 演示 2: 注册语言包
+console.log('=== 演示 2: 注册语言包 ===')
+manager.registerMessages('zh-CN', zhCN)
+console.log('注册 zh-CN 后:')
+console.log('  可用语言:', manager.getAvailableLocales().value)
+console.log('')
+
+manager.registerMessages('en-US', enUS)
+console.log('注册 en-US 后:')
+console.log('  可用语言:', manager.getAvailableLocales().value)
+console.log('')
+
+manager.registerMessages('zh-TW', zhTW)
+console.log('注册 zh-TW 后:')
+console.log('  可用语言:', manager.getAvailableLocales().value)
+console.log('')
+
+// 演示 3: 切换语言
+console.log('=== 演示 3: 切换语言 ===')
+console.log('初始语言:', manager.getCurrentLocale())
+
+manager.setLocale('en-US')
+console.log('切换到 en-US:', manager.getCurrentLocale())
+
+manager.setLocale('zh-TW')
+console.log('切换到 zh-TW:', manager.getCurrentLocale())
+
+manager.setLocale('zh-CN')
+console.log('切换回 zh-CN:', manager.getCurrentLocale())
+console.log('')
+
+// 演示 4: 响应式特性
+console.log('=== 演示 4: 响应式特性 ===')
+const availableLocales = manager.getAvailableLocales()
+console.log('获取响应式列表:', availableLocales.value)
+
+// 动态注册新语言
+const jaJP: ModularLocaleMessages = {
+  common: { confirm: '確認', cancel: 'キャンセル' }
+}
+manager.registerMessages('ja-JP', jaJP)
+console.log('注册 ja-JP 后，列表自动更新:', availableLocales.value)
+console.log('')
+
+// 演示 5: 实际应用场景
+console.log('=== 演示 5: 实际应用场景 - 语言选择器 ===')
+console.log('构建语言选择器选项:')
+const locales = manager.getAvailableLocales().value
+const localeNames: Record<string, string> = {
+  'zh-CN': '简体中文',
+  'en-US': 'English',
+  'zh-TW': '繁體中文',
+  'ja-JP': '日本語'
+}
+
+locales.forEach((locale: string) => {
+  const isCurrent = locale === manager.getCurrentLocale()
+  const marker = isCurrent ? '✓' : ' '
+  console.log(`  [${marker}] ${locale} - ${localeNames[locale]}`)
+})
+console.log('')
+
+console.log('=== 演示完成 ===')

package/composables/i18n/task8-verification.uts

@@ -0,0 +1,98 @@
+/**
+ * Task 8 验证脚本
+ * 验证 getAvailableLocales() 和 getCurrentLocale() 方法
+ */
+
+import { I18nManager } from './manager.uts'
+import type { ModularLocaleMessages } from './types.uts'
+
+console.log('=== Task 8 验证：可用语言查询功能 ===\n')
+
+// 获取管理器实例
+const manager = I18nManager.getInstance()
+
+// 注册测试语言包
+console.log('1. 注册测试语言包...')
+const zhCN: ModularLocaleMessages = {
+  common: {
+    confirm: '确定',
+    cancel: '取消'
+  }
+}
+
+const enUS: ModularLocaleMessages = {
+  common: {
+    confirm: 'Confirm',
+    cancel: 'Cancel'
+  }
+}
+
+const zhTW: ModularLocaleMessages = {
+  common: {
+    confirm: '確定',
+    cancel: '取消'
+  }
+}
+
+manager.registerMessages('zh-CN', zhCN)
+manager.registerMessages('en-US', enUS)
+manager.registerMessages('zh-TW', zhTW)
+console.log('✓ 已注册 3 个语言包\n')
+
+// 测试 getCurrentLocale()
+console.log('2. 测试 getCurrentLocale() 方法')
+const currentLocale = manager.getCurrentLocale()
+console.log(`   当前语言: ${currentLocale}`)
+console.log(`   ✓ getCurrentLocale() 返回: ${currentLocale}\n`)
+
+// 测试 getAvailableLocales()
+console.log('3. 测试 getAvailableLocales() 方法')
+const availableLocales = manager.getAvailableLocales()
+console.log(`   可用语言列表: ${availableLocales.value.join(', ')}`)
+console.log(`   语言数量: ${availableLocales.value.length}`)
+console.log(`   ✓ getAvailableLocales() 返回响应式列表\n`)
+
+// 验证列表包含所有注册的语言
+console.log('4. 验证列表与 messages Map 同步')
+const expectedLocales = ['zh-CN', 'en-US', 'zh-TW']
+let allPresent = true
+for (const locale of expectedLocales) {
+  const isPresent = availableLocales.value.includes(locale)
+  console.log(`   ${locale}: ${isPresent ? '✓' : '✗'}`)
+  if (!isPresent) allPresent = false
+}
+console.log(`   ${allPresent ? '✓' : '✗'} 所有语言都在列表中\n`)
+
+// 测试语言切换后 getCurrentLocale() 的更新
+console.log('5. 测试语言切换后 getCurrentLocale() 更新')
+console.log(`   切换前: ${manager.getCurrentLocale()}`)
+manager.setLocale('en-US')
+console.log(`   切换到 en-US`)
+console.log(`   切换后: ${manager.getCurrentLocale()}`)
+console.log(`   ✓ getCurrentLocale() 正确反映当前语言\n`)
+
+// 测试动态注册后列表更新
+console.log('6. 测试动态注册后列表更新')
+console.log(`   注册前语言数量: ${availableLocales.value.length}`)
+const jaJP: ModularLocaleMessages = {
+  common: {
+    confirm: '確認',
+    cancel: 'キャンセル'
+  }
+}
+manager.registerMessages('ja-JP', jaJP)
+console.log(`   注册 ja-JP 后语言数量: ${availableLocales.value.length}`)
+console.log(`   ja-JP 在列表中: ${availableLocales.value.includes('ja-JP') ? '✓' : '✗'}`)
+console.log(`   ✓ 列表自动更新\n`)
+
+// 验证响应式特性
+console.log('7. 验证 getAvailableLocales() 返回的是 ComputedRef')
+console.log(`   类型检查: ${typeof availableLocales.value}`)
+console.log(`   是数组: ${Array.isArray(availableLocales.value) ? '✓' : '✗'}`)
+console.log(`   ✓ 返回响应式 computed 对象\n`)
+
+console.log('=== 所有验证通过 ✓ ===')
+console.log('\n需求验证:')
+console.log('✓ 5.1: getAvailableLocales() 返回所有已注册语言的语言代码数组')
+console.log('✓ 5.2: getCurrentLocale() 返回当前激活的语言代码')
+console.log('✓ 5.3: 语言包动态注册后，可用语言列表自动更新并保持准确性')

package/composables/i18n/test-task23.uts

@@ -0,0 +1,9 @@
+/**
+ * Task 23 简单测试
+ * 快速验证新函数是否可用
+ */
+
+import { runTask23Verification } from './task23-verification.uts'
+
+// 运行验证
+runTask23Verification()

package/composables/i18n/types.uts

@@ -0,0 +1,46 @@
+/**
+ * i18n 类型定义
+ * 定义多语言系统的所有类型
+ */
+
+/**
+ * 语言包消息类型
+ * 每个模块是一个扁平的键值对对象
+ */
+export type LocaleMessages = {
+  [key: string]: string | LocaleMessages
+}
+
+/**
+ * 模块化语言包类型
+ * 按模块名组织
+ */
+export type ModularLocaleMessages = {
+  [moduleName: string]: {
+    [key: string]: string
+  }
+}
+
+/**
+ * 语言代码类型
+ * 支持内置语言和自定义语言代码
+ */
+export type LocaleCode = 'zh-CN' | 'en-US' | 'zh-TW' | string
+
+/**
+ * i18n 配置类型
+ */
+export type I18nConfig = {
+  /** 当前语言 */
+  locale: LocaleCode
+  /** 回退语言 */
+  fallbackLocale: LocaleCode
+  /** 语言包 */
+  messages: Record<string, LocaleMessages>
+}
+
+/**
+ * 翻译参数类型
+ * 用于字符串插值
+ */
+export type TranslateParams = Record<string, string | number>

package/composables/i18n/useI18n-verification.uts

@@ -0,0 +1,105 @@
+/**
+ * useI18n Composable 验证脚本
+ * 验证 useI18n 的基本功能
+ */
+
+import { I18nManager } from './manager.uts'
+import { useI18n } from '../useI18n.uts'
+
+/**
+ * 验证 useI18n Composable
+ */
+export function verifyUseI18n(): void {
+  console.log('=== useI18n Composable 验证 ===\n')
+  
+  // 准备测试数据
+  const manager = I18nManager.getInstance()
+  manager.registerMessages('zh-CN', {
+    common: {
+      confirm: '确定',
+      cancel: '取消',
+      hello: '你好，{name}'
+    },
+    dialog: {
+      title: '提示'
+    }
+  })
+  
+  manager.registerMessages('en-US', {
+    common: {
+      confirm: 'Confirm',
+      cancel: 'Cancel',
+      hello: 'Hello, {name}'
+    },
+    dialog: {
+      title: 'Notice'
+    }
+  })
+  
+  // 测试 useI18n
+  const { $t, locale, availableLocales, setLocale } = useI18n()
+  
+  // 1. 测试翻译函数
+  console.log('1. 测试翻译函数')
+  console.log('   $t("common.confirm"):', $t('common.confirm'))
+  console.log('   预期: "确定"')
+  console.log('   结果:', $t('common.confirm') === '确定' ? '✓ 通过' : '✗ 失败')
+  console.log()
+  
+  // 2. 测试带参数的翻译
+  console.log('2. 测试带参数的翻译')
+  const greeting = $t('common.hello', { name: '张三' })
+  console.log('   $t("common.hello", { name: "张三" }):', greeting)
+  console.log('   预期: "你好，张三"')
+  console.log('   结果:', greeting === '你好，张三' ? '✓ 通过' : '✗ 失败')
+  console.log()
+  
+  // 3. 测试当前语言（响应式）
+  console.log('3. 测试当前语言（响应式）')
+  console.log('   locale.value:', locale.value)
+  console.log('   预期: "zh-CN"')
+  console.log('   结果:', locale.value === 'zh-CN' ? '✓ 通过' : '✗ 失败')
+  console.log()
+  
+  // 4. 测试可用语言列表
+  console.log('4. 测试可用语言列表')
+  console.log('   availableLocales.value:', availableLocales.value)
+  console.log('   预期: 包含 "zh-CN" 和 "en-US"')
+  const hasZhCN = availableLocales.value.includes('zh-CN')
+  const hasEnUS = availableLocales.value.includes('en-US')
+  console.log('   结果:', hasZhCN && hasEnUS ? '✓ 通过' : '✗ 失败')
+  console.log()
+  
+  // 5. 测试语言切换
+  console.log('5. 测试语言切换')
+  const switchResult = setLocale('en-US')
+  console.log('   setLocale("en-US"):', switchResult)
+  console.log('   预期: true')
+  console.log('   结果:', switchResult === true ? '✓ 通过' : '✗ 失败')
+  console.log()
+  
+  // 6. 验证切换后的翻译
+  console.log('6. 验证切换后的翻译')
+  console.log('   locale.value:', locale.value)
+  console.log('   $t("common.confirm"):', $t('common.confirm'))
+  console.log('   预期语言: "en-US"')
+  console.log('   预期翻译: "Confirm"')
+  const localeCorrect = locale.value === 'en-US'
+  const translationCorrect = $t('common.confirm') === 'Confirm'
+  console.log('   结果:', localeCorrect && translationCorrect ? '✓ 通过' : '✗ 失败')
+  console.log()
+  
+  // 7. 测试无效语言代码
+  console.log('7. 测试无效语言代码')
+  const invalidResult = setLocale('invalid-locale')
+  console.log('   setLocale("invalid-locale"):', invalidResult)
+  console.log('   预期: false')
+  console.log('   当前语言保持不变:', locale.value)
+  console.log('   结果:', invalidResult === false && locale.value === 'en-US' ? '✓ 通过' : '✗ 失败')
+  console.log()
+  
+  console.log('=== 验证完成 ===')
+}
+
+// 如果直接运行此文件，执行验证
+// verifyUseI18n()