vidply 1.2.0 → 1.2.1

package/src/i18n/i18n.ts

@@ -1,223 +1,223 @@
-import { getBaseTranslations, getBuiltInLanguageLoaders, loadBuiltInTranslation, type TranslationData } from './translations.js';
-import { deepSanitize, isForbiddenKey } from '../utils/Sanitize.js';
-
-declare global {
-  interface Window {
-    jsyaml?: { load(input: string): unknown };
-  }
-}
-
-/**
- * Escape RegExp meta-characters so a placeholder name like
- * `{name.first}` does not turn into a wildcard or backreference when
- * compiled into a `RegExp`.
- */
-function escapeRegExp(input: string): string {
-  return input.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-/**
- * Recursively copy a translation object onto a null-prototype map and
- * drop forbidden keys (`__proto__`, `prototype`, `constructor`) so a
- * malicious translation file cannot pollute Object.prototype on its way
- * through `Object.assign`.
- */
-function deepSanitizeTranslations(input: unknown): TranslationData {
-  return deepSanitize<TranslationData>(input);
-}
-
-class I18n {
-  currentLanguage: string;
-  translations: Record<string, TranslationData>;
-  private loadingPromises: Map<string, Promise<unknown>>;
-  private builtInLanguageLoaders: Record<string, () => Promise<Record<string, TranslationData>>>;
-
-  constructor() {
-    this.currentLanguage = 'en';
-    this.translations = Object.create(null) as Record<string, TranslationData>;
-    Object.assign(this.translations, getBaseTranslations());
-    this.loadingPromises = new Map();
-    this.builtInLanguageLoaders = getBuiltInLanguageLoaders();
-  }
-
-  setLanguage(lang: string): void {
-    if (this.translations[lang]) {
-      this.currentLanguage = lang;
-    } else {
-      console.warn(`Language "${lang}" not found, falling back to English`);
-      this.currentLanguage = 'en';
-    }
-  }
-
-  getLanguage(): string {
-    return this.currentLanguage;
-  }
-
-  async ensureLanguage(lang: string): Promise<string | null> {
-    const normalizedLang = (lang || '').toLowerCase();
-    if (!normalizedLang) return this.currentLanguage;
-
-    if (this.translations[normalizedLang]) {
-      return normalizedLang;
-    }
-
-    if (this.loadingPromises.has(normalizedLang)) {
-      await this.loadingPromises.get(normalizedLang);
-      return this.translations[normalizedLang] ? normalizedLang : null;
-    }
-
-    if (!this.builtInLanguageLoaders[normalizedLang]) {
-      return null;
-    }
-
-    const loadPromise = (async () => {
-      try {
-        const loaded = await loadBuiltInTranslation(normalizedLang);
-        if (loaded) {
-          this.translations[normalizedLang] = deepSanitizeTranslations(loaded);
-        }
-      } catch (error) {
-        console.warn(`Language "${normalizedLang}" failed to load:`, error);
-      } finally {
-        this.loadingPromises.delete(normalizedLang);
-      }
-    })();
-
-    this.loadingPromises.set(normalizedLang, loadPromise);
-    await loadPromise;
-
-    return this.translations[normalizedLang] ? normalizedLang : null;
-  }
-
-  t(key: string, replacements: Record<string, string | number> = {}): string {
-    const keys = key.split('.');
-    let value: unknown = this.translations[this.currentLanguage];
-
-    for (const k of keys) {
-      if (value && typeof value === 'object' && k in (value as Record<string, unknown>)) {
-        value = (value as Record<string, unknown>)[k];
-      } else {
-        value = this.translations.en;
-        for (const fallbackKey of keys) {
-          if (value && typeof value === 'object' && fallbackKey in (value as Record<string, unknown>)) {
-            value = (value as Record<string, unknown>)[fallbackKey];
-          } else {
-            return key;
-          }
-        }
-        break;
-      }
-    }
-
-    if (typeof value === 'string') {
-      let result = value;
-      for (const [placeholder, replacement] of Object.entries(replacements)) {
-        if (isForbiddenKey(placeholder)) continue;
-        const safe = escapeRegExp(placeholder);
-        result = result.replace(new RegExp(`\\{${safe}\\}`, 'g'), String(replacement));
-      }
-      return result;
-    }
-
-    return typeof value === 'string' ? value : key;
-  }
-
-  addTranslation(lang: string, newTranslations: TranslationData): void {
-    if (isForbiddenKey(lang)) {
-      console.warn(`[VidPly] Refusing to register language with forbidden name "${lang}"`);
-      return;
-    }
-    if (!this.translations[lang]) {
-      this.translations[lang] = Object.create(null) as TranslationData;
-    }
-    const sanitized = deepSanitizeTranslations(newTranslations);
-    Object.assign(this.translations[lang], sanitized);
-  }
-
-  /**
-   * Load a translation file from a URL. Bounded by an `AbortSignal.timeout`
-   * (default 8s) plus an optional caller-supplied signal — typically the
-   * Player's lifecycle controller — so a torn-down player does not keep
-   * the request alive.
-   */
-  async loadLanguageFromUrl(
-    langCode: string,
-    url: string,
-    options: { signal?: AbortSignal; timeoutMs?: number } = {}
-  ): Promise<unknown> {
-    if (this.loadingPromises.has(url)) {
-      return this.loadingPromises.get(url);
-    }
-
-    const loadPromise = (async () => {
-      const signals: AbortSignal[] = [];
-      if (options.signal) signals.push(options.signal);
-      if (typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function') {
-        signals.push(AbortSignal.timeout(options.timeoutMs ?? 8000));
-      }
-      const signal = signals.length === 0
-        ? undefined
-        : signals.length === 1
-          ? signals[0]
-          : (AbortSignal as { any?: (sigs: AbortSignal[]) => AbortSignal }).any?.(signals) ?? signals[0];
-
-      try {
-        const response = await fetch(url, { signal });
-        if (!response.ok) {
-          throw new Error(`Failed to load language file: ${response.statusText}`);
-        }
-
-        const contentType = response.headers.get('content-type') || '';
-        let loadedTranslations: TranslationData;
-
-        const buffer = await response.arrayBuffer();
-        const utf8Text = new TextDecoder('utf-8').decode(buffer);
-
-        if (contentType.includes('application/json') || url.endsWith('.json')) {
-          loadedTranslations = JSON.parse(utf8Text);
-        } else if (
-          contentType.includes('text/yaml') ||
-          contentType.includes('application/x-yaml') ||
-          url.endsWith('.yaml') ||
-          url.endsWith('.yml')
-        ) {
-          try {
-            loadedTranslations = JSON.parse(utf8Text);
-          } catch {
-            if (typeof window !== 'undefined' && window.jsyaml) {
-              loadedTranslations = window.jsyaml.load(utf8Text) as TranslationData;
-            } else {
-              console.warn('YAML parsing requires js-yaml library. Please include it or use JSON format.');
-              throw new Error('YAML parsing not available. Please use JSON format or include js-yaml library.');
-            }
-          }
-        } else {
-          loadedTranslations = JSON.parse(utf8Text);
-        }
-
-        this.addTranslation(langCode, loadedTranslations);
-        return loadedTranslations;
-      } catch (error) {
-        console.error(`Error loading language file from ${url}:`, error);
-        throw error;
-      } finally {
-        this.loadingPromises.delete(url);
-      }
-    })();
-
-    this.loadingPromises.set(url, loadPromise);
-    return loadPromise;
-  }
-
-  async loadLanguagesFromUrls(
-    languageMap: Record<string, string>,
-    options: { signal?: AbortSignal; timeoutMs?: number } = {}
-  ): Promise<void> {
-    const promises = Object.entries(languageMap).map(([langCode, url]) =>
-      this.loadLanguageFromUrl(langCode, url, options)
-    );
-    await Promise.all(promises);
-  }
-}
-
-export const i18n = new I18n();
+import { getBaseTranslations, getBuiltInLanguageLoaders, loadBuiltInTranslation, type TranslationData } from './translations.js';
+import { deepSanitize, isForbiddenKey } from '../utils/Sanitize.js';
+
+declare global {
+  interface Window {
+    jsyaml?: { load(input: string): unknown };
+  }
+}
+
+/**
+ * Escape RegExp meta-characters so a placeholder name like
+ * `{name.first}` does not turn into a wildcard or backreference when
+ * compiled into a `RegExp`.
+ */
+function escapeRegExp(input: string): string {
+  return input.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+/**
+ * Recursively copy a translation object onto a null-prototype map and
+ * drop forbidden keys (`__proto__`, `prototype`, `constructor`) so a
+ * malicious translation file cannot pollute Object.prototype on its way
+ * through `Object.assign`.
+ */
+function deepSanitizeTranslations(input: unknown): TranslationData {
+  return deepSanitize<TranslationData>(input);
+}
+
+class I18n {
+  currentLanguage: string;
+  translations: Record<string, TranslationData>;
+  private loadingPromises: Map<string, Promise<unknown>>;
+  private builtInLanguageLoaders: Record<string, () => Promise<Record<string, TranslationData>>>;
+
+  constructor() {
+    this.currentLanguage = 'en';
+    this.translations = Object.create(null) as Record<string, TranslationData>;
+    Object.assign(this.translations, getBaseTranslations());
+    this.loadingPromises = new Map();
+    this.builtInLanguageLoaders = getBuiltInLanguageLoaders();
+  }
+
+  setLanguage(lang: string): void {
+    if (this.translations[lang]) {
+      this.currentLanguage = lang;
+    } else {
+      console.warn(`Language "${lang}" not found, falling back to English`);
+      this.currentLanguage = 'en';
+    }
+  }
+
+  getLanguage(): string {
+    return this.currentLanguage;
+  }
+
+  async ensureLanguage(lang: string): Promise<string | null> {
+    const normalizedLang = (lang || '').toLowerCase();
+    if (!normalizedLang) return this.currentLanguage;
+
+    if (this.translations[normalizedLang]) {
+      return normalizedLang;
+    }
+
+    if (this.loadingPromises.has(normalizedLang)) {
+      await this.loadingPromises.get(normalizedLang);
+      return this.translations[normalizedLang] ? normalizedLang : null;
+    }
+
+    if (!this.builtInLanguageLoaders[normalizedLang]) {
+      return null;
+    }
+
+    const loadPromise = (async () => {
+      try {
+        const loaded = await loadBuiltInTranslation(normalizedLang);
+        if (loaded) {
+          this.translations[normalizedLang] = deepSanitizeTranslations(loaded);
+        }
+      } catch (error) {
+        console.warn(`Language "${normalizedLang}" failed to load:`, error);
+      } finally {
+        this.loadingPromises.delete(normalizedLang);
+      }
+    })();
+
+    this.loadingPromises.set(normalizedLang, loadPromise);
+    await loadPromise;
+
+    return this.translations[normalizedLang] ? normalizedLang : null;
+  }
+
+  t(key: string, replacements: Record<string, string | number> = {}): string {
+    const keys = key.split('.');
+    let value: unknown = this.translations[this.currentLanguage];
+
+    for (const k of keys) {
+      if (value && typeof value === 'object' && k in (value as Record<string, unknown>)) {
+        value = (value as Record<string, unknown>)[k];
+      } else {
+        value = this.translations.en;
+        for (const fallbackKey of keys) {
+          if (value && typeof value === 'object' && fallbackKey in (value as Record<string, unknown>)) {
+            value = (value as Record<string, unknown>)[fallbackKey];
+          } else {
+            return key;
+          }
+        }
+        break;
+      }
+    }
+
+    if (typeof value === 'string') {
+      let result = value;
+      for (const [placeholder, replacement] of Object.entries(replacements)) {
+        if (isForbiddenKey(placeholder)) continue;
+        const safe = escapeRegExp(placeholder);
+        result = result.replace(new RegExp(`\\{${safe}\\}`, 'g'), String(replacement));
+      }
+      return result;
+    }
+
+    return typeof value === 'string' ? value : key;
+  }
+
+  addTranslation(lang: string, newTranslations: TranslationData): void {
+    if (isForbiddenKey(lang)) {
+      console.warn(`[VidPly] Refusing to register language with forbidden name "${lang}"`);
+      return;
+    }
+    if (!this.translations[lang]) {
+      this.translations[lang] = Object.create(null) as TranslationData;
+    }
+    const sanitized = deepSanitizeTranslations(newTranslations);
+    Object.assign(this.translations[lang], sanitized);
+  }
+
+  /**
+   * Load a translation file from a URL. Bounded by an `AbortSignal.timeout`
+   * (default 8s) plus an optional caller-supplied signal — typically the
+   * Player's lifecycle controller — so a torn-down player does not keep
+   * the request alive.
+   */
+  async loadLanguageFromUrl(
+    langCode: string,
+    url: string,
+    options: { signal?: AbortSignal; timeoutMs?: number } = {}
+  ): Promise<unknown> {
+    if (this.loadingPromises.has(url)) {
+      return this.loadingPromises.get(url);
+    }
+
+    const loadPromise = (async () => {
+      const signals: AbortSignal[] = [];
+      if (options.signal) signals.push(options.signal);
+      if (typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function') {
+        signals.push(AbortSignal.timeout(options.timeoutMs ?? 8000));
+      }
+      const signal = signals.length === 0
+        ? undefined
+        : signals.length === 1
+          ? signals[0]
+          : (AbortSignal as { any?: (sigs: AbortSignal[]) => AbortSignal }).any?.(signals) ?? signals[0];
+
+      try {
+        const response = await fetch(url, { signal });
+        if (!response.ok) {
+          throw new Error(`Failed to load language file: ${response.statusText}`);
+        }
+
+        const contentType = response.headers.get('content-type') || '';
+        let loadedTranslations: TranslationData;
+
+        const buffer = await response.arrayBuffer();
+        const utf8Text = new TextDecoder('utf-8').decode(buffer);
+
+        if (contentType.includes('application/json') || url.endsWith('.json')) {
+          loadedTranslations = JSON.parse(utf8Text);
+        } else if (
+          contentType.includes('text/yaml') ||
+          contentType.includes('application/x-yaml') ||
+          url.endsWith('.yaml') ||
+          url.endsWith('.yml')
+        ) {
+          try {
+            loadedTranslations = JSON.parse(utf8Text);
+          } catch {
+            if (typeof window !== 'undefined' && window.jsyaml) {
+              loadedTranslations = window.jsyaml.load(utf8Text) as TranslationData;
+            } else {
+              console.warn('YAML parsing requires js-yaml library. Please include it or use JSON format.');
+              throw new Error('YAML parsing not available. Please use JSON format or include js-yaml library.');
+            }
+          }
+        } else {
+          loadedTranslations = JSON.parse(utf8Text);
+        }
+
+        this.addTranslation(langCode, loadedTranslations);
+        return loadedTranslations;
+      } catch (error) {
+        console.error(`Error loading language file from ${url}:`, error);
+        throw error;
+      } finally {
+        this.loadingPromises.delete(url);
+      }
+    })();
+
+    this.loadingPromises.set(url, loadPromise);
+    return loadPromise;
+  }
+
+  async loadLanguagesFromUrls(
+    languageMap: Record<string, string>,
+    options: { signal?: AbortSignal; timeoutMs?: number } = {}
+  ): Promise<void> {
+    const promises = Object.entries(languageMap).map(([langCode, url]) =>
+      this.loadLanguageFromUrl(langCode, url, options)
+    );
+    await Promise.all(promises);
+  }
+}
+
+export const i18n = new I18n();