Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.
TypeScript agent-skillscodex-clideskop-appdubbingimage-generationlocalizationskillsttsvideo-editingvideo-generationvideo-transcriptionvideo-translation
Load display language catalogs on demand
Leggettde3ffeaf3176
diff --git a/apps/web/src/i18n/LanguageProvider.tsx b/apps/web/src/i18n/LanguageProvider.tsxindex 864d62c7..a2f00bd9 100644--- a/apps/web/src/i18n/LanguageProvider.tsx+++ b/apps/web/src/i18n/LanguageProvider.tsx@@ -15,7 +15,7 @@ import {type AppLanguage,type AppLanguagePreference} from './language.js';-import { translateEnglishCopy } from './translated-copy.js';+import { hasLanguageCatalog, loadLanguageCatalog, translateEnglishCopy } from './translated-copy.js';const messages = {'zh-CN': {@@ -559,6 +559,18 @@ export function LanguageProvider(props: PropsWithChildren<{);const [systemLanguage, setSystemLanguage] = useState(() => resolveAppLanguage('system'));const language = preference === 'system' ? systemLanguage : preference;+ const [loadedLanguage, setLoadedLanguage] = useState<AppLanguage>();++ useEffect(() => {+ if (hasLanguageCatalog(language)) return;+ let active = true;+ void loadLanguageCatalog(language).then(() => {+ if (active) setLoadedLanguage(language);+ }).catch(error => {+ console.error('Failed to load display language', error);+ });+ return () => { active = false; };+ }, [language]);useEffect(() => {applyAppLanguage(language);@@ -576,7 +588,7 @@ export function LanguageProvider(props: PropsWithChildren<{setPreferenceState(nextPreference);if (nextPreference === 'system') setSystemLanguage(resolveAppLanguage('system'));}, []);- const t = useMemo(() => createTranslator(language), [language]);+ const t = useMemo(() => createTranslator(language), [language, loadedLanguage]);const value = useMemo<LanguageContextValue>(() => ({preference,language,diff --git a/apps/web/src/i18n/language-catalog-loading.test.tsx b/apps/web/src/i18n/language-catalog-loading.test.tsxnew file mode 100644index 00000000..ac792e09--- /dev/null+++ b/apps/web/src/i18n/language-catalog-loading.test.tsx@@ -0,0 +1,81 @@+import { act, fireEvent, render, screen } from '@testing-library/react';+import { useMemo, useState } from 'react';+import { afterEach, describe, expect, it, vi } from 'vitest';++afterEach(() => {+ vi.doUnmock('./translated-copy.js');+ vi.doUnmock('./locales/ja-JP.json');+});++describe('cold language catalog loading', () => {+ it('loads only the requested language and shares concurrent requests', async () => {+ vi.resetModules();+ const copy = await import('./translated-copy.js');+ expect(Object.keys(copy.additionalLanguageCatalogs)).toEqual([]);+ await copy.loadLanguageCatalog('zh-CN');+ await copy.loadLanguageCatalog('en-US');+ expect(Object.keys(copy.additionalLanguageCatalogs)).toEqual([]);+ expect(copy.translateEnglishCopy('ja-JP', 'Fetch')).toBe('Fetch');+ const first = copy.loadLanguageCatalog('ja-JP');+ expect(copy.loadLanguageCatalog('ja-JP')).toBe(first);+ await first;+ expect(Object.keys(copy.additionalLanguageCatalogs)).toEqual(['ja-JP']);+ expect(copy.translateEnglishCopy('ja-JP', 'Fetch')).toBe('取得');+ });++ it('allows retry after a failed catalog load', async () => {+ vi.resetModules();+ let attempts = 0;+ vi.doMock('./locales/ja-JP.json', () => ({+ get default() {+ if (attempts++ === 0) throw new Error('Temporary catalog failure');+ return { Fetch: '取得' };+ }+ }));+ const copy = await import('./translated-copy.js');+ await expect(copy.loadLanguageCatalog('ja-JP')).rejects.toThrow('Temporary catalog failure');+ expect(copy.hasLanguageCatalog('ja-JP')).toBe(false);+ expect(copy.translateEnglishCopy('ja-JP', 'Fetch')).toBe('Fetch');+ await copy.loadLanguageCatalog('ja-JP');+ expect(copy.translateEnglishCopy('ja-JP', 'Fetch')).toBe('取得');+ });++ it('refreshes memoized copy without losing drafts or applying an outdated language', async () => {+ vi.resetModules();+ const ready = new Set<string>();+ const completions = new Map<string, () => void>();+ vi.doMock('./translated-copy.js', () => ({+ hasLanguageCatalog: (language: string) => language === 'zh-CN' || language === 'en-US' || ready.has(language),+ loadLanguageCatalog: (language: string) => new Promise<void>(resolve => {+ completions.set(language, () => { ready.add(language); resolve(); });+ }),+ translateEnglishCopy: (language: string, source: string) => ready.has(language) ? `${language}: ${source}` : source+ }));+ const { LanguageProvider, useAppLanguage } = await import('./LanguageProvider.js');+ const { useLocalizedCopy } = await import('./useLocalizedCopy.js');+ function Probe() {+ const { setPreference, t } = useAppLanguage();+ const localize = useLocalizedCopy();+ const label = useMemo(() => localize('获取', 'Fetch'), [localize]);+ const [draft, setDraft] = useState('');+ return <>+ <button onClick={() => setPreference('ja-JP')}>Japanese</button>+ <button onClick={() => setPreference('fr-FR')}>French</button>+ <input aria-label="Draft" value={draft} onChange={event => setDraft(event.target.value)} />+ <span>{label}</span><span>{t('settings.language')}</span>+ </>;+ }+ render(<LanguageProvider initialPreference="zh-CN"><Probe /></LanguageProvider>);+ fireEvent.change(screen.getByRole('textbox', { name: 'Draft' }), { target: { value: 'Keep this draft' } });+ fireEvent.click(screen.getByRole('button', { name: 'Japanese' }));+ expect(screen.getByText('Fetch')).toBeVisible();+ fireEvent.click(screen.getByRole('button', { name: 'French' }));+ await act(async () => { completions.get('fr-FR')!(); });+ expect(screen.getByText('fr-FR: Fetch')).toBeVisible();+ expect(screen.getByText('fr-FR: Display language')).toBeVisible();+ await act(async () => { completions.get('ja-JP')!(); });+ expect(screen.getByText('fr-FR: Fetch')).toBeVisible();+ expect(document.documentElement.lang).toBe('fr-FR');+ expect(screen.getByRole('textbox', { name: 'Draft' })).toHaveValue('Keep this draft');+ });+});diff --git a/apps/web/src/i18n/translated-copy.test.ts b/apps/web/src/i18n/translated-copy.test.tsindex 9e64ad01..a97f38d4 100644--- a/apps/web/src/i18n/translated-copy.test.ts+++ b/apps/web/src/i18n/translated-copy.test.ts@@ -4,6 +4,7 @@ import type { AppLanguage } from './language.js';describe('additional language catalogs', () => {it('covers subtitle translation and download messages in every additional language', () => {+ expect(Object.keys(additionalLanguageCatalogs)).toHaveLength(7);const messages = ['Add an SRT file to translate first', 'Add source', 'Add subtitles', 'Automatic captions','Bilingual SRT', 'Manual subtitles', 'Remove subtitles', 'Replace file', 'Save subtitles',diff --git a/apps/web/src/i18n/translated-copy.ts b/apps/web/src/i18n/translated-copy.tsindex e4ff6275..b93c2459 100644--- a/apps/web/src/i18n/translated-copy.ts+++ b/apps/web/src/i18n/translated-copy.ts@@ -1,21 +1,36 @@-import japanese from './locales/ja-JP.json' with { type: 'json' };-import swedish from './locales/sv-SE.json' with { type: 'json' };-import korean from './locales/ko-KR.json' with { type: 'json' };-import spanish from './locales/es-ES.json' with { type: 'json' };-import french from './locales/fr-FR.json' with { type: 'json' };-import german from './locales/de-DE.json' with { type: 'json' };-import portuguese from './locales/pt-BR.json' with { type: 'json' };import type { AppLanguage } from './language.js';-export const additionalLanguageCatalogs: Readonly<Partial<Record<AppLanguage, Readonly<Record<string, string>>>>> = {- 'sv-SE': swedish,- 'ja-JP': japanese,- 'ko-KR': korean,- 'es-ES': spanish,- 'fr-FR': french,- 'de-DE': german,- 'pt-BR': portuguese+type LanguageCatalog = Readonly<Record<string, string>>;+const catalogs: Partial<Record<AppLanguage, LanguageCatalog>> = {};+export const additionalLanguageCatalogs: Readonly<typeof catalogs> = catalogs;++const catalogLoaders = {+ 'sv-SE': () => import('./locales/sv-SE.json'),+ 'ja-JP': () => import('./locales/ja-JP.json'),+ 'ko-KR': () => import('./locales/ko-KR.json'),+ 'es-ES': () => import('./locales/es-ES.json'),+ 'fr-FR': () => import('./locales/fr-FR.json'),+ 'de-DE': () => import('./locales/de-DE.json'),+ 'pt-BR': () => import('./locales/pt-BR.json')};+const pendingCatalogs = new Map<AppLanguage, Promise<void>>();++export function hasLanguageCatalog(language: AppLanguage): boolean {+ return !Object.hasOwn(catalogLoaders, language) || catalogs[language] !== undefined;+}++export function loadLanguageCatalog(language: AppLanguage): Promise<void> {+ if (hasLanguageCatalog(language)) return Promise.resolve();+ const pending = pendingCatalogs.get(language);+ if (pending !== undefined) return pending;+ const load = catalogLoaders[language as keyof typeof catalogLoaders]().then(module => {+ catalogs[language] = module.default;+ }).finally(() => {+ pendingCatalogs.delete(language);+ });+ pendingCatalogs.set(language, load);+ return load;+}type TemplateMatcher = { pattern: RegExp; slots: string[]; translation: string };const templateMatchers = new Map<AppLanguage, TemplateMatcher[]>();diff --git a/apps/web/src/i18n/useLocalizedCopy.ts b/apps/web/src/i18n/useLocalizedCopy.tsindex 47bcb417..fd4371ac 100644--- a/apps/web/src/i18n/useLocalizedCopy.ts+++ b/apps/web/src/i18n/useLocalizedCopy.ts@@ -5,6 +5,6 @@ import { createLocalizedCopy, type LocalizeCopy } from './localized-copy.js';export type { LocalizeCopy } from './localized-copy.js';export function useLocalizedCopy(): LocalizeCopy {- const { language } = useAppLanguage();- return useMemo(() => createLocalizedCopy(language), [language]);+ const { language, t } = useAppLanguage();+ return useMemo(() => createLocalizedCopy(language), [language, t]);}diff --git a/apps/web/src/main.tsx b/apps/web/src/main.tsxindex 03fc169a..d66d98e4 100644--- a/apps/web/src/main.tsx+++ b/apps/web/src/main.tsx@@ -22,6 +22,7 @@ import {} from './i18n/language.js';import { installAutoHidingScrollbars } from './styles/scrollbar-visibility.js';import { installWindowResizeStability } from './styles/window-resize-stability.js';+import { hasLanguageCatalog, loadLanguageCatalog } from './i18n/translated-copy.js';import './styles/app.css';const desktopHostBridge = readDesktopHostBridge();@@ -31,7 +32,8 @@ applyColorMode(initialColorMode);void desktopHostBridge?.setWindowColorMode?.(initialColorMode).catch(error => {console.error('Failed to synchronize native window color mode', error);});-applyAppLanguage(resolveAppLanguage(readLanguagePreference()));+const initialLanguage = resolveAppLanguage(readLanguagePreference());+applyAppLanguage(initialLanguage);applyAccentColor(readAccentColorPreference(),readCustomAccentColorPreference()@@ -39,14 +41,24 @@ applyAccentColor(installAutoHidingScrollbars();installWindowResizeStability();-createRoot(document.getElementById('root')!).render(- <StrictMode>- <>- <App {...(desktopHostBridge === undefined ? {} : { hostBridge: desktopHostBridge })} />- {desktopHostBridge === undefined ? null : <WorkspaceReadySignal />}- </>- </StrictMode>-);+function renderApp() {+ createRoot(document.getElementById('root')!).render(+ <StrictMode>+ <>+ <App {...(desktopHostBridge === undefined ? {} : { hostBridge: desktopHostBridge })} />+ {desktopHostBridge === undefined ? null : <WorkspaceReadySignal />}+ </>+ </StrictMode>+ );+}++if (hasLanguageCatalog(initialLanguage)) {+ renderApp();+} else {+ void loadLanguageCatalog(initialLanguage).catch(error => {+ console.error('Failed to load initial display language', error);+ }).then(renderApp);+}if (desktopHostBridge !== undefined) {subscribeDesktopNavigation(route => {diff --git a/apps/web/src/test/setup.ts b/apps/web/src/test/setup.tsindex 67b25a38..7bbc0f66 100644--- a/apps/web/src/test/setup.ts+++ b/apps/web/src/test/setup.ts@@ -1,5 +1,10 @@import '@testing-library/jest-dom/vitest';import 'fake-indexeddb/auto';+import { appLanguageOptions } from '../i18n/language.js';+import { loadLanguageCatalog } from '../i18n/translated-copy.js';++// Component tests exercise initialized copy; cold loading is covered separately.+await Promise.all(appLanguageOptions.map(({ value }) => loadLanguageCatalog(value)));Object.defineProperty(window.navigator, 'language', {configurable: true,