Skip to content

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.

Load display language catalogs on demand

Leggettde3ffeaf3176
diff --git a/apps/web/src/i18n/LanguageProvider.tsx b/apps/web/src/i18n/LanguageProvider.tsx
index 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.tsx
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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.tsx
index 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.ts
index 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,