A free and open source instant messaging and VoIP chat app built for friends, groups, and communities.
// SPDX-License-Identifier: AGPL-3.0-or-later
import {Logger} from '@app/features/platform/utils/AppLogger';
import {ensureDesktopModule, isDesktopModuleUnavailable} from '@app/features/platform/utils/DesktopModuleAssets';
import {loadLazyModule} from '@app/features/platform/utils/LazyModuleLoader';
import {DESKTOP_FONT_MODULE_NAMES, type DesktopFontScript} from '@fluxer/desktop_ipc/src/ModuleContract';
const logger = new Logger('ScriptFontLoader');
type ScriptChunk = 'non-latin' | 'sc' | 'tc' | 'jp' | 'kr';
const CHUNK_IMPORTS: Record<ScriptChunk, () => Promise<unknown>> = {
'non-latin': () => import('@app/features/theme/fonts/ScriptFacesNonLatin'),
sc: () => import('@app/features/theme/fonts/ScriptFacesSC'),
tc: () => import('@app/features/theme/fonts/ScriptFacesTC'),
jp: () => import('@app/features/theme/fonts/ScriptFacesJP'),
kr: () => import('@app/features/theme/fonts/ScriptFacesKR'),
};
const KANA = /[\u3040-\u30FF\u31F0-\u31FF\uFF66-\uFF9D]/;
const HANGUL = /[\u1100-\u11FF\u3130-\u318F\uA960-\uA97F\uAC00-\uD7FF]/;
const HAN = /[\u3400-\u4DBF\u4E00-\u9FFF\uF900-\uFAFF]|[\uD840-\uD87F][\uDC00-\uDFFF]/;
const requested = new Set<ScriptChunk>();
const inFlight = new Set<Promise<void>>();
const FONT_MODULE_RETRY_DELAY_MS = 60_000;
function isDesktopFontScript(chunk: ScriptChunk): chunk is DesktopFontScript {
return Object.hasOwn(DESKTOP_FONT_MODULE_NAMES, chunk);
}
async function loadChunk(chunk: ScriptChunk): Promise<void> {
if (isDesktopFontScript(chunk)) {
const moduleName = DESKTOP_FONT_MODULE_NAMES[chunk];
if (!(await ensureDesktopModule(moduleName))) {
if (isDesktopModuleUnavailable(moduleName)) {
logger.warn(
`The ${chunk} font module is unavailable from the desktop shell; using OS script fonts for this session`,
);
return;
}
setTimeout(() => {
requested.delete(chunk);
request(chunk);
}, FONT_MODULE_RETRY_DELAY_MS);
logger.warn(`The ${chunk} font module is not available yet; using OS script fonts until it is`);
return;
}
}
await loadLazyModule(CHUNK_IMPORTS[chunk]);
}
function request(chunk: ScriptChunk): void {
if (requested.has(chunk)) return;
requested.add(chunk);
const load = loadChunk(chunk)
.catch((error: unknown) => {
logger.warn(`Failed to load the ${chunk} font faces; falling back to OS script fonts:`, error);
})
.finally(() => {
inFlight.delete(load);
});
inFlight.add(load);
}
const HAN_CHUNKS: ReadonlyArray<ScriptChunk> = ['jp', 'sc', 'tc', 'kr'];
function cjkChunkForLanguage(language: string | null | undefined): ScriptChunk | null {
const tag = (language ?? '').toLowerCase();
if (tag === 'ja' || tag.startsWith('ja-')) return 'jp';
if (tag === 'ko' || tag.startsWith('ko-')) return 'kr';
if (tag === 'zh' || tag.startsWith('zh-')) {
if (/(^|-)(tw|hk|mo|hant)(-|$)/.test(tag)) return 'tc';
return 'sc';
}
return null;
}
function preferredLanguages(): ReadonlyArray<string> {
if (typeof navigator === 'undefined') return [];
return navigator.languages ?? (navigator.language ? [navigator.language] : []);
}
function hanChunkForLanguage(
language: string | null | undefined,
systemLanguages: ReadonlyArray<string> = preferredLanguages(),
alreadyRequested: ReadonlySet<ScriptChunk> = requested,
): ScriptChunk {
const fromLocale = cjkChunkForLanguage(language);
if (fromLocale) return fromLocale;
const loaded = HAN_CHUNKS.find((chunk) => alreadyRequested.has(chunk));
if (loaded) return loaded;
for (const systemLanguage of systemLanguages) {
const fromSystem = cjkChunkForLanguage(systemLanguage);
if (fromSystem) return fromSystem;
}
return 'sc';
}
function chunksForText(text: string, language: string | null | undefined = documentLanguage()): Array<ScriptChunk> {
const chunks: Array<ScriptChunk> = [];
const kana = KANA.test(text);
const hangul = HANGUL.test(text);
if (kana) chunks.push('jp');
if (hangul) chunks.push('kr');
if (!kana && !hangul && HAN.test(text)) chunks.push(hanChunkForLanguage(language));
return chunks;
}
function documentLanguage(): string | null {
if (typeof document === 'undefined') return null;
return document.documentElement.lang || null;
}
export function noteText(text: string | null | undefined): void {
if (!text) return;
for (const chunk of chunksForText(text)) request(chunk);
}
export function noteLocale(language: string | null | undefined = documentLanguage()): void {
const chunk = cjkChunkForLanguage(language);
if (chunk) request(chunk);
}
export function scheduleNonLatinScriptFaces(): void {
const run = () => request('non-latin');
if (typeof requestIdleCallback === 'function') {
requestIdleCallback(run, {timeout: 3000});
return;
}
setTimeout(run, 1000);
}