@gravito/cosmos 3.0.1 → 3.2.0

package/tests/unit/fallback.test.ts

@@ -0,0 +1,66 @@
+import { describe, expect, it } from 'bun:test'
+import { I18nManager } from '../../src/I18nService'
+
+describe('Fallback Strategies', () => {
+  it('uses default fallback chain (defaultLocale)', () => {
+    const manager = new I18nManager({
+      defaultLocale: 'en',
+      supportedLocales: ['en', 'fr'],
+      translations: {
+        en: { hello: 'Hello' },
+        fr: {},
+      },
+    })
+    expect(manager.translate('fr', 'hello')).toBe('Hello')
+  })
+
+  it('uses configured fallback chain', () => {
+    const manager = new I18nManager({
+      defaultLocale: 'en',
+      supportedLocales: ['en', 'es', 'pt'],
+      translations: {
+        en: { hello: 'Hello' },
+        es: { hello: 'Hola' },
+        pt: {},
+      },
+      fallback: {
+        fallbackChain: {
+          pt: ['es', 'en'],
+        },
+      },
+    })
+    expect(manager.translate('pt', 'hello')).toBe('Hola')
+  })
+
+  it('handles missing key strategies', () => {
+    const manager = new I18nManager({
+      defaultLocale: 'en',
+      supportedLocales: ['en'],
+      translations: { en: {} },
+      fallback: {
+        onMissingKey: 'empty',
+      },
+    })
+    expect(manager.translate('en', 'missing')).toBe('')
+
+    const managerThrow = new I18nManager({
+      defaultLocale: 'en',
+      supportedLocales: ['en'],
+      translations: { en: {} },
+      fallback: {
+        onMissingKey: 'throw',
+      },
+    })
+    expect(() => managerThrow.translate('en', 'missing')).toThrow()
+
+    const managerCustom = new I18nManager({
+      defaultLocale: 'en',
+      supportedLocales: ['en'],
+      translations: { en: {} },
+      fallback: {
+        onMissingKey: (key, locale) => `Missing ${key} in ${locale}`,
+      },
+    })
+    expect(managerCustom.translate('en', 'missing')).toBe('Missing missing in en')
+  })
+})

package/tests/unit/hmr.test.ts

@@ -0,0 +1,255 @@
+/**
+ * @file packages/cosmos/tests/unit/hmr.test.ts
+ * @description 測試 HMR (熱重載) 功能
+ */
+
+import { afterEach, beforeEach, describe, expect, it } from 'bun:test'
+import { mkdtempSync, writeFileSync } from 'node:fs'
+import { rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { HMRWatcher } from '../../src/HMRWatcher'
+
+describe('HMRWatcher', () => {
+  let tmpDir: string
+
+  beforeEach(() => {
+    tmpDir = mkdtempSync(join(tmpdir(), 'gravito-hmr-test-'))
+  })
+
+  afterEach(async () => {
+    await rm(tmpDir, { force: true, recursive: true })
+  })
+
+  it('should detect file changes', async () => {
+    const filePath = join(tmpDir, 'zh-TW.json')
+    writeFileSync(filePath, JSON.stringify({ test: 'initial' }))
+
+    const changeEvents: Array<{ locale: string; type: string }> = []
+
+    const watcher = new HMRWatcher({
+      enabled: true,
+      watchDirs: [tmpDir],
+      debounce: 100,
+      verbose: false,
+    })
+
+    watcher.onChange((event) => {
+      changeEvents.push({
+        locale: event.locale,
+        type: event.type,
+      })
+    })
+
+    watcher.start()
+
+    // 等待監視器啟動
+    await new Promise((resolve) => setTimeout(resolve, 100))
+
+    // 修改檔案
+    await writeFile(filePath, JSON.stringify({ test: 'updated' }))
+
+    // 等待防抖和事件處理
+    await new Promise((resolve) => setTimeout(resolve, 500))
+
+    watcher.stop()
+
+    expect(changeEvents.length).toBeGreaterThan(0)
+    expect(changeEvents[0].locale).toBe('zh-TW')
+  })
+
+  it('should not watch when disabled', async () => {
+    const watcher = new HMRWatcher({
+      enabled: false,
+      watchDirs: [tmpDir],
+    })
+
+    watcher.start()
+    expect(watcher.isActive()).toBe(false)
+  })
+
+  it('should filter by file extension', async () => {
+    const jsonFile = join(tmpDir, 'en.json')
+    const txtFile = join(tmpDir, 'en.txt')
+
+    writeFileSync(jsonFile, '{}')
+    writeFileSync(txtFile, 'text')
+
+    const changeEvents: string[] = []
+
+    const watcher = new HMRWatcher({
+      enabled: true,
+      watchDirs: [tmpDir],
+      extensions: ['.json'],
+      debounce: 100,
+      verbose: false,
+    })
+
+    watcher.onChange((event) => {
+      changeEvents.push(event.filePath)
+    })
+
+    watcher.start()
+    await new Promise((resolve) => setTimeout(resolve, 100))
+
+    // 修改 JSON 檔案 (應該被檢測到)
+    await writeFile(jsonFile, '{"updated": true}')
+    await new Promise((resolve) => setTimeout(resolve, 300))
+
+    // 修改 TXT 檔案 (應該被忽略)
+    await writeFile(txtFile, 'updated text')
+    await new Promise((resolve) => setTimeout(resolve, 300))
+
+    watcher.stop()
+
+    // 只有 JSON 檔案的變更應該被檢測到
+    expect(changeEvents.some((path) => path.includes('.json'))).toBe(true)
+    expect(changeEvents.some((path) => path.includes('.txt'))).toBe(false)
+  })
+
+  it('should support multiple listeners', async () => {
+    const filePath = join(tmpDir, 'test.json')
+    writeFileSync(filePath, '{}')
+
+    let listener1Called = false
+    let listener2Called = false
+
+    const watcher = new HMRWatcher({
+      enabled: true,
+      watchDirs: [tmpDir],
+      debounce: 100,
+      verbose: false,
+    })
+
+    watcher.onChange(() => {
+      listener1Called = true
+    })
+
+    watcher.onChange(() => {
+      listener2Called = true
+    })
+
+    watcher.start()
+    await new Promise((resolve) => setTimeout(resolve, 100))
+
+    await writeFile(filePath, '{"updated": true}')
+    await new Promise((resolve) => setTimeout(resolve, 300))
+
+    watcher.stop()
+
+    expect(listener1Called).toBe(true)
+    expect(listener2Called).toBe(true)
+  })
+
+  it('should allow removing listeners', async () => {
+    const filePath = join(tmpDir, 'test.json')
+    writeFileSync(filePath, '{}')
+
+    let callCount = 0
+    const listener = () => {
+      callCount++
+    }
+
+    const watcher = new HMRWatcher({
+      enabled: true,
+      watchDirs: [tmpDir],
+      debounce: 100,
+      verbose: false,
+    })
+
+    watcher.onChange(listener)
+    watcher.start()
+    await new Promise((resolve) => setTimeout(resolve, 100))
+
+    // 第一次變更
+    await writeFile(filePath, '{"v": 1}')
+    await new Promise((resolve) => setTimeout(resolve, 300))
+
+    const initialCallCount = callCount
+    expect(initialCallCount).toBeGreaterThan(0)
+
+    // 移除監聽器
+    watcher.removeListener(listener)
+
+    // 第二次變更 (不應該觸發)
+    await writeFile(filePath, '{"v": 2}')
+    await new Promise((resolve) => setTimeout(resolve, 300))
+
+    watcher.stop()
+
+    // 移除後,callCount 應該不再增加
+    expect(callCount).toBe(initialCallCount)
+  })
+
+  it('should debounce rapid changes', async () => {
+    const filePath = join(tmpDir, 'rapid.json')
+    writeFileSync(filePath, '{}')
+
+    let callCount = 0
+
+    const watcher = new HMRWatcher({
+      enabled: true,
+      watchDirs: [tmpDir],
+      debounce: 200,
+      verbose: false,
+    })
+
+    watcher.onChange(() => {
+      callCount++
+    })
+
+    watcher.start()
+    await new Promise((resolve) => setTimeout(resolve, 100))
+
+    // 快速連續修改多次
+    await writeFile(filePath, '{"v": 1}')
+    await new Promise((resolve) => setTimeout(resolve, 50))
+    await writeFile(filePath, '{"v": 2}')
+    await new Promise((resolve) => setTimeout(resolve, 50))
+    await writeFile(filePath, '{"v": 3}')
+
+    // 等待防抖完成
+    await new Promise((resolve) => setTimeout(resolve, 400))
+
+    watcher.stop()
+
+    // 由於防抖,應該只觸發一次或少數幾次,而不是每次修改都觸發
+    expect(callCount).toBeLessThan(3)
+  })
+
+  it('should handle errors in listeners gracefully', async () => {
+    const filePath = join(tmpDir, 'error-test.json')
+    writeFileSync(filePath, '{}')
+
+    const errorListener = () => {
+      throw new Error('Listener error')
+    }
+
+    let goodListenerCalled = false
+    const goodListener = () => {
+      goodListenerCalled = true
+    }
+
+    const watcher = new HMRWatcher({
+      enabled: true,
+      watchDirs: [tmpDir],
+      debounce: 100,
+      verbose: false,
+    })
+
+    // 註冊會拋出錯誤的監聽器和正常的監聽器
+    watcher.onChange(errorListener)
+    watcher.onChange(goodListener)
+
+    watcher.start()
+    await new Promise((resolve) => setTimeout(resolve, 100))
+
+    await writeFile(filePath, '{"updated": true}')
+    await new Promise((resolve) => setTimeout(resolve, 300))
+
+    watcher.stop()
+
+    // 即使有監聽器出錯,其他監聽器仍應該被呼叫
+    expect(goodListenerCalled).toBe(true)
+  })
+})

package/tests/unit/lazy.test.ts

@@ -0,0 +1,35 @@
+import { describe, expect, it } from 'bun:test'
+import { mkdtempSync, writeFileSync } from 'node:fs'
+import { rm } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { I18nManager } from '../../src/I18nService'
+
+describe('Lazy Loading', () => {
+  it('loads translations on demand', async () => {
+    const tmpDir = mkdtempSync(join(tmpdir(), 'gravito-i18n-lazy-'))
+
+    try {
+      writeFileSync(join(tmpDir, 'fr.json'), JSON.stringify({ greeting: 'Bonjour' }))
+
+      const manager = new I18nManager({
+        defaultLocale: 'en',
+        supportedLocales: ['en', 'fr'],
+        lazyLoad: {
+          baseDir: tmpDir,
+        },
+      })
+
+      expect(manager.translate('fr', 'greeting')).toBe('greeting')
+
+      await manager.ensureLocale('fr')
+
+      expect(manager.translate('fr', 'greeting')).toBe('Bonjour')
+
+      await manager.ensureLocale('fr')
+      expect(manager.translate('fr', 'greeting')).toBe('Bonjour')
+    } finally {
+      await rm(tmpDir, { force: true, recursive: true })
+    }
+  })
+})

package/tests/unit/loader.test.ts

@@ -0,0 +1,72 @@
+import { describe, expect, it, mock, spyOn } from 'bun:test'
+import { mkdtempSync, writeFileSync } from 'node:fs'
+import { rm } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { I18nManager } from '../../src/I18nService'
+import * as loader from '../../src/loader'
+
+describe('I18n Loading', () => {
+  describe('Loading Coalescing', () => {
+    it('should coalesce concurrent load requests', async () => {
+      const mockLoader = mock(async () => {
+        await new Promise((resolve) => setTimeout(resolve, 50))
+        return { title: 'Loaded' }
+      })
+
+      const manager = new I18nManager({
+        defaultLocale: 'en',
+        supportedLocales: ['en'],
+        lazyLoad: {
+          baseDir: '/tmp',
+          loader: mockLoader,
+        },
+      })
+
+      const p1 = manager.ensureLocale('en')
+      const p2 = manager.ensureLocale('en')
+
+      await Promise.all([p1, p2])
+
+      expect(mockLoader).toHaveBeenCalledTimes(1)
+    })
+  })
+
+  describe('loadTranslations', () => {
+    it('loads json translation files from a directory', async () => {
+      const tmpDir = mkdtempSync(join(tmpdir(), 'gravito-i18n-'))
+
+      try {
+        writeFileSync(join(tmpDir, 'en.json'), JSON.stringify({ hello: 'Hello' }))
+        writeFileSync(join(tmpDir, 'zh.json'), JSON.stringify({ hello: '你好' }))
+
+        const translations = await loader.loadTranslations(tmpDir)
+
+        expect(translations.en.hello).toBe('Hello')
+        expect(translations.zh.hello).toBe('你好')
+      } finally {
+        await rm(tmpDir, { force: true, recursive: true })
+      }
+    })
+
+    it('skips invalid json files and returns empty for missing dir', async () => {
+      const tmpDir = mkdtempSync(join(tmpdir(), 'gravito-i18n-invalid-'))
+
+      const errorSpy = spyOn(console, 'error').mockImplementation(() => {})
+      const warnSpy = spyOn(console, 'warn').mockImplementation(() => {})
+
+      try {
+        writeFileSync(join(tmpDir, 'en.json'), '{invalid json}')
+        const translations = await loader.loadTranslations(tmpDir)
+        expect(translations.en).toBeUndefined()
+
+        const missing = await loader.loadTranslations(join(tmpDir, 'missing'))
+        expect(missing).toEqual({})
+      } finally {
+        errorSpy.mockRestore()
+        warnSpy.mockRestore()
+        await rm(tmpDir, { force: true, recursive: true })
+      }
+    })
+  })
+})