tang-ui-x 1.1.1 → 1.1.3

package/composables/i18n/task22-verification.uts

@@ -0,0 +1,198 @@
+/**
+ * Task 22 验证脚本
+ * 验证语言包注册模式功能
+ */
+
+import { I18nManager } from './manager.uts'
+import type { ModularLocaleMessages } from './types.uts'
+
+/**
+ * 测试语言包注册模式功能
+ */
+export function testRegistrationModes(): void {
+  console.log('=== Task 22: 语言包注册模式功能验证 ===\n')
+  
+  const manager = I18nManager.getInstance()
+  
+  // 测试 1: 合并模式（默认）
+  console.log('测试 1: 合并模式（默认 registerMessages）')
+  const initialMessages: ModularLocaleMessages = {
+    common: {
+      confirm: '确定',
+      cancel: '取消',
+      ok: '好的'
+    },
+    dialog: {
+      title: '提示',
+      confirmText: '确定'
+    }
+  }
+  
+  manager.registerMessages('test-locale', initialMessages)
+  console.log('✓ 初始语言包已注册')
+  
+  // 部分覆盖
+  const partialMessages: ModularLocaleMessages = {
+    common: {
+      confirm: '好的',  // 覆盖
+      close: '关闭'     // 新增
+    },
+    empty: {            // 新模块
+      title: '暂无数据'
+    }
+  }
+  
+  manager.registerMessages('test-locale', partialMessages)
+  console.log('✓ 部分语言包已合并')
+  
+  // 验证合并结果
+  manager.setLocale('test-locale')
+  const confirmText = manager.translate('common.confirm')
+  const cancelText = manager.translate('common.cancel')
+  const okText = manager.translate('common.ok')
+  const closeText = manager.translate('common.close')
+  const dialogTitle = manager.translate('dialog.title')
+  const emptyTitle = manager.translate('empty.title')
+  
+  console.log(`  common.confirm: ${confirmText} (应为 "好的")`)
+  console.log(`  common.cancel: ${cancelText} (应为 "取消" - 保留)`)
+  console.log(`  common.ok: ${okText} (应为 "好的" - 保留)`)
+  console.log(`  common.close: ${closeText} (应为 "关闭" - 新增)`)
+  console.log(`  dialog.title: ${dialogTitle} (应为 "提示" - 保留)`)
+  console.log(`  empty.title: ${emptyTitle} (应为 "暂无数据" - 新模块)`)
+  
+  const mergeSuccess = 
+    confirmText === '好的' &&
+    cancelText === '取消' &&
+    okText === '好的' &&
+    closeText === '关闭' &&
+    dialogTitle === '提示' &&
+    emptyTitle === '暂无数据'
+  
+  if (mergeSuccess) {
+    console.log('✅ 合并模式测试通过\n')
+  } else {
+    console.log('❌ 合并模式测试失败\n')
+  }
+  
+  // 测试 2: 替换模式（registerMessagesWithMode）
+  console.log('测试 2: 替换模式（registerMessagesWithMode）')
+  const replaceMessages: ModularLocaleMessages = {
+    button: {
+      submit: '提交',
+      reset: '重置'
+    }
+  }
+  
+  manager.registerMessagesWithMode('test-locale', replaceMessages, 'replace')
+  console.log('✓ 语言包已完全替换')
+  
+  // 验证替换结果 - 旧内容应该不存在
+  const submitText = manager.translate('button.submit')
+  const oldConfirmText = manager.translate('common.confirm')
+  const oldDialogTitle = manager.translate('dialog.title')
+  
+  console.log(`  button.submit: ${submitText} (应为 "提交")`)
+  console.log(`  common.confirm: ${oldConfirmText} (应为 "common.confirm" - 已被清除)`)
+  console.log(`  dialog.title: ${oldDialogTitle} (应为 "dialog.title" - 已被清除)`)
+  
+  const replaceSuccess = 
+    submitText === '提交' &&
+    oldConfirmText === 'common.confirm' &&
+    oldDialogTitle === 'dialog.title'
+  
+  if (replaceSuccess) {
+    console.log('✅ 替换模式测试通过\n')
+  } else {
+    console.log('❌ 替换模式测试失败\n')
+  }
+  
+  // 测试 3: replaceMessages 方法
+  console.log('测试 3: replaceMessages 方法')
+  const newMessages: ModularLocaleMessages = {
+    search: {
+      placeholder: '搜索',
+      cancel: '取消'
+    }
+  }
+  
+  manager.replaceMessages('test-locale', newMessages)
+  console.log('✓ 使用 replaceMessages 方法替换')
+  
+  const searchPlaceholder = manager.translate('search.placeholder')
+  const oldSubmitText = manager.translate('button.submit')
+  
+  console.log(`  search.placeholder: ${searchPlaceholder} (应为 "搜索")`)
+  console.log(`  button.submit: ${oldSubmitText} (应为 "button.submit" - 已被清除)`)
+  
+  const replaceMethodSuccess = 
+    searchPlaceholder === '搜索' &&
+    oldSubmitText === 'button.submit'
+  
+  if (replaceMethodSuccess) {
+    console.log('✅ replaceMessages 方法测试通过\n')
+  } else {
+    console.log('❌ replaceMessages 方法测试失败\n')
+  }
+  
+  // 测试 4: 合并模式使用 registerMessagesWithMode
+  console.log('测试 4: 合并模式使用 registerMessagesWithMode')
+  const baseMessages: ModularLocaleMessages = {
+    common: {
+      yes: '是',
+      no: '否'
+    }
+  }
+  
+  manager.registerMessagesWithMode('test-locale-2', baseMessages, 'merge')
+  console.log('✓ 基础语言包已注册')
+  
+  const additionalMessages: ModularLocaleMessages = {
+    common: {
+      yes: 'Yes',  // 覆盖
+      maybe: 'Maybe'  // 新增
+    }
+  }
+  
+  manager.registerMessagesWithMode('test-locale-2', additionalMessages, 'merge')
+  console.log('✓ 额外语言包已合并')
+  
+  manager.setLocale('test-locale-2')
+  const yesText = manager.translate('common.yes')
+  const noText = manager.translate('common.no')
+  const maybeText = manager.translate('common.maybe')
+  
+  console.log(`  common.yes: ${yesText} (应为 "Yes")`)
+  console.log(`  common.no: ${noText} (应为 "否" - 保留)`)
+  console.log(`  common.maybe: ${maybeText} (应为 "Maybe" - 新增)`)
+  
+  const mergeWithModeSuccess = 
+    yesText === 'Yes' &&
+    noText === '否' &&
+    maybeText === 'Maybe'
+  
+  if (mergeWithModeSuccess) {
+    console.log('✅ registerMessagesWithMode 合并模式测试通过\n')
+  } else {
+    console.log('❌ registerMessagesWithMode 合并模式测试失败\n')
+  }
+  
+  // 总结
+  console.log('=== 测试总结 ===')
+  const allSuccess = mergeSuccess && replaceSuccess && replaceMethodSuccess && mergeWithModeSuccess
+  
+  if (allSuccess) {
+    console.log('✅ 所有测试通过！')
+    console.log('\n实现的功能：')
+    console.log('1. registerMessages() - 默认使用合并模式')
+    console.log('2. registerMessagesWithMode() - 支持 merge 和 replace 模式')
+    console.log('3. replaceMessages() - 完全替换语言包')
+    console.log('4. 合并模式正确保留未覆盖的内容')
+    console.log('5. 替换模式完全清除旧内容')
+  } else {
+    console.log('❌ 部分测试失败，请检查实现')
+  }
+}
+
+// 执行测试
+testRegistrationModes()

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('=== 演示完成 ===')