@oxy.so/bloom 5.1.1 → 5.3.0

package/src/locale/common-messages.ts

@@ -1,4 +1,4 @@
-import { useMessages, type MessageCatalog } from './messages';
+import { defineMessages, useMessages, type MessageCatalog } from './messages';
 
 /**
  * The words every family says — a close button's name, "Loading", "Back" —
@@ -48,505 +48,44 @@ export interface CommonMessages {
   send: string;
   clear: string;
   seeAll: string;
+  /** The divider between two resizable panes (`AiChatResizeHandle`). */
+  resizePanels: string;
 }
 
-export const COMMON_MESSAGES: MessageCatalog<CommonMessages> = {
-  en: {
-    close: 'Close',
-    dismiss: 'Dismiss',
-    back: 'Back',
-    goBack: 'Go back',
-    loading: 'Loading',
-    more: 'More',
-    moreOptions: 'More options',
-    moreActions: 'More actions',
-    progress: 'Progress',
-    stepOf: (step, total) => `Step ${step} of ${total}`,
-    labelFor: (label, subject) => `${label} for ${subject}`,
-    tapToClose: 'Tap to close',
-    cancel: 'Cancel',
-    done: 'Done',
-    save: 'Save',
-    delete: 'Delete',
-    edit: 'Edit',
-    remove: 'Remove',
-    retry: 'Retry',
-    search: 'Search',
-    showMore: 'Show more',
-    showLess: 'Show less',
-    next: 'Next',
-    previous: 'Previous',
-    open: 'Open',
-    menu: 'Menu',
-    copy: 'Copy',
-    copied: 'Copied',
-    send: 'Send',
-    clear: 'Clear',
-    seeAll: 'See all',
-  },
-  es: {
-    close: 'Cerrar',
-    dismiss: 'Descartar',
-    back: 'Atrás',
-    goBack: 'Volver',
-    loading: 'Cargando',
-    more: 'Más',
-    moreOptions: 'Más opciones',
-    moreActions: 'Más acciones',
-    progress: 'Progreso',
-    stepOf: (step, total) => `Paso ${step} de ${total}`,
-    labelFor: (label, subject) => `${label} de ${subject}`,
-    tapToClose: 'Toca para cerrar',
-    cancel: 'Cancelar',
-    done: 'Hecho',
-    save: 'Guardar',
-    delete: 'Eliminar',
-    edit: 'Editar',
-    remove: 'Quitar',
-    retry: 'Reintentar',
-    search: 'Buscar',
-    showMore: 'Mostrar más',
-    showLess: 'Mostrar menos',
-    next: 'Siguiente',
-    previous: 'Anterior',
-    open: 'Abrir',
-    menu: 'Menú',
-    copy: 'Copiar',
-    copied: 'Copiado',
-    send: 'Enviar',
-    clear: 'Borrar',
-    seeAll: 'Ver todo',
-  },
-  ca: {
-    close: 'Tanca',
-    dismiss: 'Descarta',
-    back: 'Enrere',
-    goBack: 'Torna enrere',
-    loading: "S'està carregant",
-    more: 'Més',
-    moreOptions: 'Més opcions',
-    moreActions: 'Més accions',
-    progress: 'Progrés',
-    stepOf: (step, total) => `Pas ${step} de ${total}`,
-    labelFor: (label, subject) => `${label} de ${subject}`,
-    tapToClose: 'Toca per tancar',
-    cancel: 'Cancel·la',
-    done: 'Fet',
-    save: 'Desa',
-    delete: 'Suprimeix',
-    edit: 'Edita',
-    remove: 'Treu',
-    retry: 'Torna-ho a provar',
-    search: 'Cerca',
-    showMore: "Mostra'n més",
-    showLess: "Mostra'n menys",
-    next: 'Següent',
-    previous: 'Anterior',
-    open: 'Obre',
-    menu: 'Menú',
-    copy: 'Copia',
-    copied: 'Copiat',
-    send: 'Envia',
-    clear: 'Esborra',
-    seeAll: 'Mostra-ho tot',
-  },
-  de: {
-    close: 'Schließen',
-    dismiss: 'Ausblenden',
-    back: 'Zurück',
-    goBack: 'Zurückgehen',
-    loading: 'Wird geladen',
-    more: 'Mehr',
-    moreOptions: 'Weitere Optionen',
-    moreActions: 'Weitere Aktionen',
-    progress: 'Fortschritt',
-    stepOf: (step, total) => `Schritt ${step} von ${total}`,
-    labelFor: (label, subject) => `${label} für ${subject}`,
-    tapToClose: 'Zum Schließen tippen',
-    cancel: 'Abbrechen',
-    done: 'Fertig',
-    save: 'Speichern',
-    delete: 'Löschen',
-    edit: 'Bearbeiten',
-    remove: 'Entfernen',
-    retry: 'Erneut versuchen',
-    search: 'Suchen',
-    showMore: 'Mehr anzeigen',
-    showLess: 'Weniger anzeigen',
-    next: 'Weiter',
-    previous: 'Vorherige',
-    open: 'Öffnen',
-    menu: 'Menü',
-    copy: 'Kopieren',
-    copied: 'Kopiert',
-    send: 'Senden',
-    clear: 'Leeren',
-    seeAll: 'Alle anzeigen',
-  },
-  fr: {
-    close: 'Fermer',
-    dismiss: 'Ignorer',
-    back: 'Retour',
-    goBack: 'Revenir en arrière',
-    loading: 'Chargement',
-    more: 'Plus',
-    moreOptions: "Plus d'options",
-    moreActions: "Plus d'actions",
-    progress: 'Progression',
-    stepOf: (step, total) => `Étape ${step} sur ${total}`,
-    labelFor: (label, subject) => `${label} pour ${subject}`,
-    tapToClose: 'Touchez pour fermer',
-    cancel: 'Annuler',
-    done: 'Terminé',
-    save: 'Enregistrer',
-    delete: 'Supprimer',
-    edit: 'Modifier',
-    remove: 'Retirer',
-    retry: 'Réessayer',
-    search: 'Rechercher',
-    showMore: 'Afficher plus',
-    showLess: 'Afficher moins',
-    next: 'Suivant',
-    previous: 'Précédent',
-    open: 'Ouvrir',
-    menu: 'Menu',
-    copy: 'Copier',
-    copied: 'Copié',
-    send: 'Envoyer',
-    clear: 'Effacer',
-    seeAll: 'Tout afficher',
-  },
-  it: {
-    close: 'Chiudi',
-    dismiss: 'Ignora',
-    back: 'Indietro',
-    goBack: 'Torna indietro',
-    loading: 'Caricamento',
-    more: 'Altro',
-    moreOptions: 'Altre opzioni',
-    moreActions: 'Altre azioni',
-    progress: 'Avanzamento',
-    stepOf: (step, total) => `Passaggio ${step} di ${total}`,
-    labelFor: (label, subject) => `${label} per ${subject}`,
-    tapToClose: 'Tocca per chiudere',
-    cancel: 'Annulla',
-    done: 'Fine',
-    save: 'Salva',
-    delete: 'Elimina',
-    edit: 'Modifica',
-    remove: 'Rimuovi',
-    retry: 'Riprova',
-    search: 'Cerca',
-    showMore: 'Mostra di più',
-    showLess: 'Mostra di meno',
-    next: 'Avanti',
-    previous: 'Precedente',
-    open: 'Apri',
-    menu: 'Menu',
-    copy: 'Copia',
-    copied: 'Copiato',
-    send: 'Invia',
-    clear: 'Cancella',
-    seeAll: 'Mostra tutto',
-  },
-  pt: {
-    close: 'Fechar',
-    dismiss: 'Dispensar',
-    back: 'Voltar',
-    goBack: 'Voltar atrás',
-    loading: 'Carregando',
-    more: 'Mais',
-    moreOptions: 'Mais opções',
-    moreActions: 'Mais ações',
-    progress: 'Progresso',
-    stepOf: (step, total) => `Etapa ${step} de ${total}`,
-    labelFor: (label, subject) => `${label} de ${subject}`,
-    tapToClose: 'Toque para fechar',
-    cancel: 'Cancelar',
-    done: 'Concluído',
-    save: 'Salvar',
-    delete: 'Excluir',
-    edit: 'Editar',
-    remove: 'Remover',
-    retry: 'Tentar novamente',
-    search: 'Pesquisar',
-    showMore: 'Mostrar mais',
-    showLess: 'Mostrar menos',
-    next: 'Próximo',
-    previous: 'Anterior',
-    open: 'Abrir',
-    menu: 'Menu',
-    copy: 'Copiar',
-    copied: 'Copiado',
-    send: 'Enviar',
-    clear: 'Limpar',
-    seeAll: 'Ver tudo',
-  },
-  ru: {
-    close: 'Закрыть',
-    dismiss: 'Скрыть',
-    back: 'Назад',
-    goBack: 'Вернуться',
-    loading: 'Загрузка',
-    more: 'Ещё',
-    moreOptions: 'Другие параметры',
-    moreActions: 'Другие действия',
-    progress: 'Прогресс',
-    stepOf: (step, total) => `Шаг ${step} из ${total}`,
-    labelFor: (label, subject) => `${label}: ${subject}`,
-    tapToClose: 'Нажмите, чтобы закрыть',
-    cancel: 'Отмена',
-    done: 'Готово',
-    save: 'Сохранить',
-    delete: 'Удалить',
-    edit: 'Изменить',
-    remove: 'Убрать',
-    retry: 'Повторить',
-    search: 'Поиск',
-    showMore: 'Показать больше',
-    showLess: 'Показать меньше',
-    next: 'Далее',
-    previous: 'Предыдущий',
-    open: 'Открыть',
-    menu: 'Меню',
-    copy: 'Копировать',
-    copied: 'Скопировано',
-    send: 'Отправить',
-    clear: 'Очистить',
-    seeAll: 'Показать все',
-  },
-  tr: {
-    close: 'Kapat',
-    dismiss: 'Yoksay',
-    back: 'Geri',
-    goBack: 'Geri dön',
-    loading: 'Yükleniyor',
-    more: 'Daha fazla',
-    moreOptions: 'Diğer seçenekler',
-    moreActions: 'Diğer işlemler',
-    progress: 'İlerleme',
-    stepOf: (step, total) => `Adım ${step}/${total}`,
-    labelFor: (label, subject) => `${subject}: ${label}`,
-    tapToClose: 'Kapatmak için dokunun',
-    cancel: 'İptal',
-    done: 'Bitti',
-    save: 'Kaydet',
-    delete: 'Sil',
-    edit: 'Düzenle',
-    remove: 'Kaldır',
-    retry: 'Yeniden dene',
-    search: 'Ara',
-    showMore: 'Daha fazla göster',
-    showLess: 'Daha az göster',
-    next: 'İleri',
-    previous: 'Önceki',
-    open: 'Aç',
-    menu: 'Menü',
-    copy: 'Kopyala',
-    copied: 'Kopyalandı',
-    send: 'Gönder',
-    clear: 'Temizle',
-    seeAll: 'Tümünü gör',
-  },
-  ja: {
-    close: '閉じる',
-    dismiss: '非表示',
-    back: '戻る',
-    goBack: '前に戻る',
-    loading: '読み込み中',
-    more: 'その他',
-    moreOptions: 'その他のオプション',
-    moreActions: 'その他の操作',
-    progress: '進捗',
-    stepOf: (step, total) => `ステップ ${step}/${total}`,
-    labelFor: (label, subject) => `${subject}の${label}`,
-    tapToClose: 'タップして閉じる',
-    cancel: 'キャンセル',
-    done: '完了',
-    save: '保存',
-    delete: '削除',
-    edit: '編集',
-    remove: '取り除く',
-    retry: '再試行',
-    search: '検索',
-    showMore: 'もっと見る',
-    showLess: '表示を減らす',
-    next: '次へ',
-    previous: '前へ',
-    open: '開く',
-    menu: 'メニュー',
-    copy: 'コピー',
-    copied: 'コピーしました',
-    send: '送信',
-    clear: 'クリア',
-    seeAll: 'すべて表示',
-  },
-  zh: {
-    close: '关闭',
-    dismiss: '忽略',
-    back: '返回',
-    goBack: '返回上一页',
-    loading: '正在加载',
-    more: '更多',
-    moreOptions: '更多选项',
-    moreActions: '更多操作',
-    progress: '进度',
-    stepOf: (step, total) => `第 ${step} 步，共 ${total} 步`,
-    labelFor: (label, subject) => `${subject}的${label}`,
-    tapToClose: '轻触以关闭',
-    cancel: '取消',
-    done: '完成',
-    save: '保存',
-    delete: '删除',
-    edit: '编辑',
-    remove: '移除',
-    retry: '重试',
-    search: '搜索',
-    showMore: '显示更多',
-    showLess: '收起',
-    next: '下一个',
-    previous: '上一个',
-    open: '打开',
-    menu: '菜单',
-    copy: '复制',
-    copied: '已复制',
-    send: '发送',
-    clear: '清除',
-    seeAll: '查看全部',
-  },
-  ar: {
-    close: 'إغلاق',
-    dismiss: 'تجاهل',
-    back: 'رجوع',
-    goBack: 'العودة',
-    loading: 'جارٍ التحميل',
-    more: 'المزيد',
-    moreOptions: 'خيارات إضافية',
-    moreActions: 'إجراءات إضافية',
-    progress: 'التقدم',
-    stepOf: (step, total) => `الخطوة ${step} من ${total}`,
-    labelFor: (label, subject) => `${label}: ${subject}`,
-    tapToClose: 'انقر للإغلاق',
-    cancel: 'إلغاء',
-    done: 'تم',
-    save: 'حفظ',
-    delete: 'حذف',
-    edit: 'تعديل',
-    remove: 'إزالة',
-    retry: 'إعادة المحاولة',
-    search: 'بحث',
-    showMore: 'عرض المزيد',
-    showLess: 'عرض أقل',
-    next: 'التالي',
-    previous: 'السابق',
-    open: 'فتح',
-    menu: 'القائمة',
-    copy: 'نسخ',
-    copied: 'تم النسخ',
-    send: 'إرسال',
-    clear: 'مسح',
-    seeAll: 'عرض الكل',
-  },
-  hi: {
-    close: 'बंद करें',
-    dismiss: 'ख़ारिज करें',
-    back: 'वापस',
-    goBack: 'वापस जाएं',
-    loading: 'लोड हो रहा है',
-    more: 'और',
-    moreOptions: 'और विकल्प',
-    moreActions: 'और कार्रवाइयां',
-    progress: 'प्रगति',
-    stepOf: (step, total) => `चरण ${step} / ${total}`,
-    labelFor: (label, subject) => `${subject} के लिए ${label}`,
-    tapToClose: 'बंद करने के लिए टैप करें',
-    cancel: 'रद्द करें',
-    done: 'हो गया',
-    save: 'सहेजें',
-    delete: 'हटाएं',
-    edit: 'संपादित करें',
-    remove: 'निकालें',
-    retry: 'फिर से कोशिश करें',
-    search: 'खोजें',
-    showMore: 'और दिखाएं',
-    showLess: 'कम दिखाएं',
-    next: 'अगला',
-    previous: 'पिछला',
-    open: 'खोलें',
-    menu: 'मेन्यू',
-    copy: 'कॉपी करें',
-    copied: 'कॉपी हो गया',
-    send: 'भेजें',
-    clear: 'साफ़ करें',
-    seeAll: 'सभी देखें',
-  },
-  bn: {
-    close: 'বন্ধ করুন',
-    dismiss: 'খারিজ করুন',
-    back: 'পিছনে',
-    goBack: 'ফিরে যান',
-    loading: 'লোড হচ্ছে',
-    more: 'আরও',
-    moreOptions: 'আরও বিকল্প',
-    moreActions: 'আরও কাজ',
-    progress: 'অগ্রগতি',
-    stepOf: (step, total) => `ধাপ ${step}/${total}`,
-    labelFor: (label, subject) => `${subject}-এর জন্য ${label}`,
-    tapToClose: 'বন্ধ করতে ট্যাপ করুন',
-    cancel: 'বাতিল',
-    done: 'সম্পন্ন',
-    save: 'সংরক্ষণ করুন',
-    delete: 'মুছুন',
-    edit: 'সম্পাদনা করুন',
-    remove: 'সরান',
-    retry: 'আবার চেষ্টা করুন',
-    search: 'অনুসন্ধান',
-    showMore: 'আরও দেখান',
-    showLess: 'কম দেখান',
-    next: 'পরবর্তী',
-    previous: 'পূর্ববর্তী',
-    open: 'খুলুন',
-    menu: 'মেনু',
-    copy: 'কপি করুন',
-    copied: 'কপি হয়েছে',
-    send: 'পাঠান',
-    clear: 'মুছে ফেলুন',
-    seeAll: 'সব দেখুন',
-  },
-  id: {
-    close: 'Tutup',
-    dismiss: 'Abaikan',
-    back: 'Kembali',
-    goBack: 'Kembali ke sebelumnya',
-    loading: 'Memuat',
-    more: 'Lainnya',
-    moreOptions: 'Opsi lainnya',
-    moreActions: 'Tindakan lainnya',
-    progress: 'Kemajuan',
-    stepOf: (step, total) => `Langkah ${step} dari ${total}`,
-    labelFor: (label, subject) => `${label} untuk ${subject}`,
-    tapToClose: 'Ketuk untuk menutup',
-    cancel: 'Batal',
-    done: 'Selesai',
-    save: 'Simpan',
-    delete: 'Hapus',
-    edit: 'Edit',
-    remove: 'Keluarkan',
-    retry: 'Coba lagi',
-    search: 'Cari',
-    showMore: 'Tampilkan lebih banyak',
-    showLess: 'Tampilkan lebih sedikit',
-    next: 'Berikutnya',
-    previous: 'Sebelumnya',
-    open: 'Buka',
-    menu: 'Menu',
-    copy: 'Salin',
-    copied: 'Disalin',
-    send: 'Kirim',
-    clear: 'Bersihkan',
-    seeAll: 'Lihat semua',
-  },
-};
+export const COMMON_MESSAGES: MessageCatalog<CommonMessages> = defineMessages<CommonMessages>('COMMON_MESSAGES', {
+  close: 'Close',
+  dismiss: 'Dismiss',
+  back: 'Back',
+  goBack: 'Go back',
+  loading: 'Loading',
+  more: 'More',
+  moreOptions: 'More options',
+  moreActions: 'More actions',
+  progress: 'Progress',
+  stepOf: (step, total) => `Step ${step} of ${total}`,
+  labelFor: (label, subject) => `${label} for ${subject}`,
+  tapToClose: 'Tap to close',
+  cancel: 'Cancel',
+  done: 'Done',
+  save: 'Save',
+  delete: 'Delete',
+  edit: 'Edit',
+  remove: 'Remove',
+  retry: 'Retry',
+  search: 'Search',
+  showMore: 'Show more',
+  showLess: 'Show less',
+  next: 'Next',
+  previous: 'Previous',
+  open: 'Open',
+  menu: 'Menu',
+  copy: 'Copy',
+  copied: 'Copied',
+  send: 'Send',
+  clear: 'Clear',
+  seeAll: 'See all',
+  resizePanels: 'Resize panels',
+});
 
 /** The common words in the locale in effect (prop → `LocaleProvider` → runtime). */
 export function useCommonMessages(locale?: string): CommonMessages {

package/src/locale/context.ts

@@ -1,15 +1,85 @@
-import { createContext, createElement, useContext, type ReactNode } from 'react';
+import {
+  createContext,
+  createElement,
+  useContext,
+  useEffect,
+  useMemo,
+  useState,
+  useSyncExternalStore,
+  type ReactNode,
+} from 'react';
 
-const LocaleContext = createContext<string | undefined>(undefined);
+import { resolveBloomLanguage, runtimeLocale } from './languages';
+import {
+  getBloomTranslations,
+  isBloomLanguageSettled,
+  loadBloomLanguage,
+  subscribeBloomTranslations,
+  type LoadedTranslations,
+} from './translations';
+
+export interface LocaleScope {
+  /** The locale published to this subtree; `undefined` means the runtime's. */
+  locale: string | undefined;
+  /** The languages loaded when this scope last rendered. */
+  translations: LoadedTranslations;
+}
+
+export const LocaleContext = createContext<LocaleScope | null>(null);
+
+export interface LocaleProviderProps {
+  locale?: string;
+  /**
+   * Rendered instead of `children` until the locale's strings are available
+   * the FIRST time, so a translated app never paints in English first.
+   * Omitted, children render at once and the strings arrive in place.
+   * `BloomProvider` passes its `onFontsLoading`.
+   */
+  fallback?: ReactNode;
+  children?: ReactNode;
+}
 
 /**
  * Sets the locale every Bloom component below it formats and speaks in —
  * month names, dates, and Bloom's own fixed strings (Cancel, Apply, …).
  * `BloomProvider`'s `locale` prop mounts one; mount another to scope a subtree.
  * Unset, components follow the runtime's locale.
+ *
+ * Bloom's non-English strings load on demand, so a newly asked-for locale is
+ * published only once its strings have loaded: until then the subtree keeps
+ * the locale it had (or, on first mount, its parent's, or `fallback`). A
+ * switch therefore changes every string, date and number in one render, with
+ * no English frame in between.
  */
-export function LocaleProvider({ locale, children }: { locale?: string; children?: ReactNode }) {
-  return createElement(LocaleContext.Provider, { value: locale }, children);
+export function LocaleProvider({ locale, fallback, children }: LocaleProviderProps) {
+  const parent = useContext(LocaleContext);
+  const translations = useSyncExternalStore(subscribeBloomTranslations, getBloomTranslations, getBloomTranslations);
+  const requested = locale ?? parent?.locale;
+  const language = resolveBloomLanguage(requested ?? runtimeLocale());
+  const settled = isBloomLanguageSettled(translations, language);
+
+  // The last locale this scope published. Adjusted during render — React's
+  // pattern for state derived from a changing input — so a settled locale is
+  // published in the same render that notices it, not one commit later.
+  const [shown, setShown] = useState<{ locale: string | undefined; ever: boolean }>(() =>
+    settled ? { locale: requested, ever: true } : { locale: parent?.locale, ever: false },
+  );
+  if (settled && (!shown.ever || shown.locale !== requested)) {
+    setShown({ locale: requested, ever: true });
+  }
+
+  useEffect(() => {
+    // A failed load settles the language (English stands in); nothing to report here.
+    if (!settled) loadBloomLanguage(language).catch(() => undefined);
+  }, [language, settled]);
+
+  const published = settled ? requested : shown.locale;
+  const value = useMemo<LocaleScope>(() => ({ locale: published, translations }), [published, translations]);
+
+  if (fallback !== undefined && !settled && !shown.ever) {
+    return createElement(LocaleContext.Provider, { value }, fallback);
+  }
+  return createElement(LocaleContext.Provider, { value }, children);
 }
 
 /**
@@ -19,5 +89,5 @@ export function LocaleProvider({ locale, children }: { locale?: string; children
  */
 export function useBloomLocale(locale?: string): string | undefined {
   const inherited = useContext(LocaleContext);
-  return locale ?? inherited;
+  return locale ?? inherited?.locale;
 }

package/src/locale/format-number.ts

@@ -1,4 +1,4 @@
-import type { MessageCatalog } from './messages';
+import { defineMessages, type MessageCatalog } from './messages';
 import { pickMessages } from './messages';
 
 /**
@@ -126,7 +126,7 @@ export function formatCompactCurrency(amount: number, currency: string, locale?:
   return format ? format.format(amount) : `${currency} ${formatCompactNumber(amount)}`;
 }
 
-interface SizeUnits {
+export interface SizeUnits {
   byte: string;
   kilobyte: string;
   megabyte: string;
@@ -134,23 +134,7 @@ interface SizeUnits {
 }
 
 /** Byte-size unit symbols: French writes `Ko`/`Mo`/`Go`, Russian `КБ`/`МБ`/`ГБ`. */
-const FILE_SIZE_UNITS: MessageCatalog<SizeUnits> = {
-  en: { byte: 'B', kilobyte: 'KB', megabyte: 'MB', gigabyte: 'GB' },
-  es: { byte: 'B', kilobyte: 'KB', megabyte: 'MB', gigabyte: 'GB' },
-  ca: { byte: 'B', kilobyte: 'kB', megabyte: 'MB', gigabyte: 'GB' },
-  de: { byte: 'B', kilobyte: 'KB', megabyte: 'MB', gigabyte: 'GB' },
-  fr: { byte: 'o', kilobyte: 'Ko', megabyte: 'Mo', gigabyte: 'Go' },
-  it: { byte: 'B', kilobyte: 'KB', megabyte: 'MB', gigabyte: 'GB' },
-  pt: { byte: 'B', kilobyte: 'KB', megabyte: 'MB', gigabyte: 'GB' },
-  ru: { byte: 'Б', kilobyte: 'КБ', megabyte: 'МБ', gigabyte: 'ГБ' },
-  tr: { byte: 'B', kilobyte: 'KB', megabyte: 'MB', gigabyte: 'GB' },
-  ja: { byte: 'B', kilobyte: 'KB', megabyte: 'MB', gigabyte: 'GB' },
-  zh: { byte: 'B', kilobyte: 'KB', megabyte: 'MB', gigabyte: 'GB' },
-  ar: { byte: 'بايت', kilobyte: 'ك.ب', megabyte: 'م.ب', gigabyte: 'غ.ب' },
-  hi: { byte: 'B', kilobyte: 'KB', megabyte: 'MB', gigabyte: 'GB' },
-  bn: { byte: 'B', kilobyte: 'KB', megabyte: 'MB', gigabyte: 'GB' },
-  id: { byte: 'B', kilobyte: 'KB', megabyte: 'MB', gigabyte: 'GB' },
-};
+export const FILE_SIZE_UNITS: MessageCatalog<SizeUnits> = defineMessages<SizeUnits>('FILE_SIZE_UNITS', { byte: 'B', kilobyte: 'KB', megabyte: 'MB', gigabyte: 'GB' });
 
 /**
  * `2400000` → `2.4 MB` (en), `2,4 MB` (es), `2,4 Mo` (fr). One decimal under

package/src/locale/index.ts

@@ -1,4 +1,5 @@
-export { LocaleProvider, useBloomLocale } from './context';
+export { LocaleProvider, useBloomLocale, type LocaleProviderProps } from './context';
+export { loadBloomLocale } from './translations';
 export { BLOOM_LANGUAGES, resolveBloomLanguage, type BloomLanguage } from './languages';
 // `messages.ts` and `plural.ts` are how families localise themselves, not app
 // API: an app speaks through `locale` and each family's `labels` overrides.