@oxy.so/bloom 4.31.0 → 4.33.0

package/src/date-picker/messages.ts

@@ -0,0 +1,470 @@
+import type { MessageCatalog } from '../locale/messages';
+import { plural } from '../locale/plural';
+import type { DateRangePreset } from './types';
+
+/**
+ * Every fixed string the date-picker family draws or announces, in each Bloom
+ * language. Month titles, weekday names and dates come from `Intl` instead; a
+ * caller's `labels` prop still wins over any entry here.
+ */
+export interface DatePickerMessages {
+  cancel: string;
+  apply: string;
+  previousMonth: string;
+  nextMonth: string;
+  /** `DatePicker`'s empty trigger and its name. */
+  datePlaceholder: string;
+  dateLabel: string;
+  /** `DateRangePicker`'s empty trigger and its name. */
+  rangePlaceholder: string;
+  rangeLabel: string;
+  startDate: string;
+  endDate: string;
+  daysSelected: (days: number) => string;
+  presets: Record<DateRangePreset, string>;
+  /** `MeetingScheduler`'s trigger, its name, its commit button and its empty time chip. */
+  meetingTrigger: string;
+  meetingLabel: string;
+  send: string;
+  selectTime: string;
+  duration: (minutes: number) => string;
+}
+
+export const DATE_PICKER_MESSAGES: MessageCatalog<DatePickerMessages> = {
+  en: {
+    cancel: 'Cancel',
+    apply: 'Apply',
+    previousMonth: 'Previous month',
+    nextMonth: 'Next month',
+    datePlaceholder: 'Select date',
+    dateLabel: 'Date',
+    rangePlaceholder: 'Select date range',
+    rangeLabel: 'Date range',
+    startDate: 'Start date',
+    endDate: 'End date',
+    daysSelected: (n) => plural('en', n, { one: '{n} day selected', other: '{n} days selected' }),
+    presets: {
+      today: 'Today',
+      yesterday: 'Yesterday',
+      lastWeek: 'Last week',
+      thisMonth: 'This month',
+      lastMonth: 'Last month',
+      thisYear: 'This year',
+      lastYear: 'Last year',
+      allTime: 'All time',
+    },
+    meetingTrigger: 'Schedule a meeting',
+    meetingLabel: 'Schedule meeting',
+    send: 'Send meeting',
+    selectTime: 'Select a time',
+    duration: (n) => plural('en', n, { one: '{n} minute', other: '{n} minutes' }),
+  },
+  es: {
+    cancel: 'Cancelar',
+    apply: 'Aplicar',
+    previousMonth: 'Mes anterior',
+    nextMonth: 'Mes siguiente',
+    datePlaceholder: 'Seleccionar fecha',
+    dateLabel: 'Fecha',
+    rangePlaceholder: 'Seleccionar intervalo de fechas',
+    rangeLabel: 'Intervalo de fechas',
+    startDate: 'Fecha de inicio',
+    endDate: 'Fecha de fin',
+    daysSelected: (n) => plural('es', n, { one: '{n} día seleccionado', other: '{n} días seleccionados' }),
+    presets: {
+      today: 'Hoy',
+      yesterday: 'Ayer',
+      lastWeek: 'La semana pasada',
+      thisMonth: 'Este mes',
+      lastMonth: 'El mes pasado',
+      thisYear: 'Este año',
+      lastYear: 'El año pasado',
+      allTime: 'Todo',
+    },
+    meetingTrigger: 'Programar una reunión',
+    meetingLabel: 'Programar reunión',
+    send: 'Enviar invitación',
+    selectTime: 'Seleccionar hora',
+    duration: (n) => plural('es', n, { one: '{n} minuto', other: '{n} minutos' }),
+  },
+  ca: {
+    cancel: 'Cancel·la',
+    apply: 'Aplica',
+    previousMonth: 'Mes anterior',
+    nextMonth: 'Mes següent',
+    datePlaceholder: 'Selecciona una data',
+    dateLabel: 'Data',
+    rangePlaceholder: 'Selecciona un interval de dates',
+    rangeLabel: 'Interval de dates',
+    startDate: "Data d'inici",
+    endDate: 'Data de fi',
+    daysSelected: (n) => plural('ca', n, { one: '{n} dia seleccionat', other: '{n} dies seleccionats' }),
+    presets: {
+      today: 'Avui',
+      yesterday: 'Ahir',
+      lastWeek: 'La setmana passada',
+      thisMonth: 'Aquest mes',
+      lastMonth: 'El mes passat',
+      thisYear: 'Aquest any',
+      lastYear: "L'any passat",
+      allTime: 'Tot',
+    },
+    meetingTrigger: 'Programa una reunió',
+    meetingLabel: 'Programar reunió',
+    send: 'Envia la invitació',
+    selectTime: 'Selecciona una hora',
+    duration: (n) => plural('ca', n, { one: '{n} minut', other: '{n} minuts' }),
+  },
+  de: {
+    cancel: 'Abbrechen',
+    apply: 'Übernehmen',
+    previousMonth: 'Vorheriger Monat',
+    nextMonth: 'Nächster Monat',
+    datePlaceholder: 'Datum auswählen',
+    dateLabel: 'Datum',
+    rangePlaceholder: 'Zeitraum auswählen',
+    rangeLabel: 'Zeitraum',
+    startDate: 'Startdatum',
+    endDate: 'Enddatum',
+    daysSelected: (n) => plural('de', n, { one: '{n} Tag ausgewählt', other: '{n} Tage ausgewählt' }),
+    presets: {
+      today: 'Heute',
+      yesterday: 'Gestern',
+      lastWeek: 'Letzte Woche',
+      thisMonth: 'Dieser Monat',
+      lastMonth: 'Letzter Monat',
+      thisYear: 'Dieses Jahr',
+      lastYear: 'Letztes Jahr',
+      allTime: 'Gesamter Zeitraum',
+    },
+    meetingTrigger: 'Meeting planen',
+    meetingLabel: 'Meeting planen',
+    send: 'Einladung senden',
+    selectTime: 'Uhrzeit auswählen',
+    duration: (n) => plural('de', n, { one: '{n} Minute', other: '{n} Minuten' }),
+  },
+  fr: {
+    cancel: 'Annuler',
+    apply: 'Appliquer',
+    previousMonth: 'Mois précédent',
+    nextMonth: 'Mois suivant',
+    datePlaceholder: 'Sélectionner une date',
+    dateLabel: 'Date',
+    rangePlaceholder: 'Sélectionner une période',
+    rangeLabel: 'Période',
+    startDate: 'Date de début',
+    endDate: 'Date de fin',
+    daysSelected: (n) => plural('fr', n, { one: '{n} jour sélectionné', other: '{n} jours sélectionnés' }),
+    presets: {
+      today: "Aujourd'hui",
+      yesterday: 'Hier',
+      lastWeek: 'La semaine dernière',
+      thisMonth: 'Ce mois-ci',
+      lastMonth: 'Le mois dernier',
+      thisYear: 'Cette année',
+      lastYear: "L'année dernière",
+      allTime: 'Depuis toujours',
+    },
+    meetingTrigger: 'Planifier une réunion',
+    meetingLabel: 'Planifier une réunion',
+    send: "Envoyer l'invitation",
+    selectTime: 'Sélectionner une heure',
+    duration: (n) => plural('fr', n, { one: '{n} minute', other: '{n} minutes' }),
+  },
+  it: {
+    cancel: 'Annulla',
+    apply: 'Applica',
+    previousMonth: 'Mese precedente',
+    nextMonth: 'Mese successivo',
+    datePlaceholder: 'Seleziona una data',
+    dateLabel: 'Data',
+    rangePlaceholder: 'Seleziona un intervallo di date',
+    rangeLabel: 'Intervallo di date',
+    startDate: 'Data di inizio',
+    endDate: 'Data di fine',
+    daysSelected: (n) => plural('it', n, { one: '{n} giorno selezionato', other: '{n} giorni selezionati' }),
+    presets: {
+      today: 'Oggi',
+      yesterday: 'Ieri',
+      lastWeek: 'Settimana scorsa',
+      thisMonth: 'Questo mese',
+      lastMonth: 'Mese scorso',
+      thisYear: "Quest'anno",
+      lastYear: 'Anno scorso',
+      allTime: 'Sempre',
+    },
+    meetingTrigger: 'Pianifica una riunione',
+    meetingLabel: 'Pianifica riunione',
+    send: 'Invia invito',
+    selectTime: 'Seleziona un orario',
+    duration: (n) => plural('it', n, { one: '{n} minuto', other: '{n} minuti' }),
+  },
+  pt: {
+    cancel: 'Cancelar',
+    apply: 'Aplicar',
+    previousMonth: 'Mês anterior',
+    nextMonth: 'Próximo mês',
+    datePlaceholder: 'Selecionar data',
+    dateLabel: 'Data',
+    rangePlaceholder: 'Selecionar período',
+    rangeLabel: 'Período',
+    startDate: 'Data de início',
+    endDate: 'Data de término',
+    daysSelected: (n) => plural('pt', n, { one: '{n} dia selecionado', other: '{n} dias selecionados' }),
+    presets: {
+      today: 'Hoje',
+      yesterday: 'Ontem',
+      lastWeek: 'Semana passada',
+      thisMonth: 'Este mês',
+      lastMonth: 'Mês passado',
+      thisYear: 'Este ano',
+      lastYear: 'Ano passado',
+      allTime: 'Todo o período',
+    },
+    meetingTrigger: 'Agendar uma reunião',
+    meetingLabel: 'Agendar reunião',
+    send: 'Enviar convite',
+    selectTime: 'Selecionar horário',
+    duration: (n) => plural('pt', n, { one: '{n} minuto', other: '{n} minutos' }),
+  },
+  ru: {
+    cancel: 'Отмена',
+    apply: 'Применить',
+    previousMonth: 'Предыдущий месяц',
+    nextMonth: 'Следующий месяц',
+    datePlaceholder: 'Выберите дату',
+    dateLabel: 'Дата',
+    rangePlaceholder: 'Выберите период',
+    rangeLabel: 'Период',
+    startDate: 'Дата начала',
+    endDate: 'Дата окончания',
+    daysSelected: (n) =>
+      plural('ru', n, { one: 'Выбран {n} день', few: 'Выбрано {n} дня', many: 'Выбрано {n} дней', other: 'Выбрано {n} дня' }),
+    presets: {
+      today: 'Сегодня',
+      yesterday: 'Вчера',
+      lastWeek: 'Прошлая неделя',
+      thisMonth: 'Этот месяц',
+      lastMonth: 'Прошлый месяц',
+      thisYear: 'Этот год',
+      lastYear: 'Прошлый год',
+      allTime: 'Всё время',
+    },
+    meetingTrigger: 'Запланировать встречу',
+    meetingLabel: 'Запланировать встречу',
+    send: 'Отправить приглашение',
+    selectTime: 'Выберите время',
+    duration: (n) => plural('ru', n, { one: '{n} минута', few: '{n} минуты', many: '{n} минут', other: '{n} минуты' }),
+  },
+  tr: {
+    cancel: 'İptal',
+    apply: 'Uygula',
+    previousMonth: 'Önceki ay',
+    nextMonth: 'Sonraki ay',
+    datePlaceholder: 'Tarih seçin',
+    dateLabel: 'Tarih',
+    rangePlaceholder: 'Tarih aralığı seçin',
+    rangeLabel: 'Tarih aralığı',
+    startDate: 'Başlangıç tarihi',
+    endDate: 'Bitiş tarihi',
+    daysSelected: (n) => plural('tr', n, { other: '{n} gün seçildi' }),
+    presets: {
+      today: 'Bugün',
+      yesterday: 'Dün',
+      lastWeek: 'Geçen hafta',
+      thisMonth: 'Bu ay',
+      lastMonth: 'Geçen ay',
+      thisYear: 'Bu yıl',
+      lastYear: 'Geçen yıl',
+      allTime: 'Tüm zamanlar',
+    },
+    meetingTrigger: 'Toplantı planla',
+    meetingLabel: 'Toplantı planla',
+    send: 'Davet gönder',
+    selectTime: 'Saat seçin',
+    duration: (n) => plural('tr', n, { other: '{n} dakika' }),
+  },
+  ja: {
+    cancel: 'キャンセル',
+    apply: '適用',
+    previousMonth: '前の月',
+    nextMonth: '次の月',
+    datePlaceholder: '日付を選択',
+    dateLabel: '日付',
+    rangePlaceholder: '期間を選択',
+    rangeLabel: '期間',
+    startDate: '開始日',
+    endDate: '終了日',
+    daysSelected: (n) => plural('ja', n, { other: '{n}日間を選択' }),
+    presets: {
+      today: '今日',
+      yesterday: '昨日',
+      lastWeek: '先週',
+      thisMonth: '今月',
+      lastMonth: '先月',
+      thisYear: '今年',
+      lastYear: '昨年',
+      allTime: '全期間',
+    },
+    meetingTrigger: 'ミーティングを予約',
+    meetingLabel: 'ミーティングの予約',
+    send: '招待を送信',
+    selectTime: '時間を選択',
+    duration: (n) => plural('ja', n, { other: '{n}分' }),
+  },
+  zh: {
+    cancel: '取消',
+    apply: '应用',
+    previousMonth: '上个月',
+    nextMonth: '下个月',
+    datePlaceholder: '选择日期',
+    dateLabel: '日期',
+    rangePlaceholder: '选择日期范围',
+    rangeLabel: '日期范围',
+    startDate: '开始日期',
+    endDate: '结束日期',
+    daysSelected: (n) => plural('zh', n, { other: '已选择 {n} 天' }),
+    presets: {
+      today: '今天',
+      yesterday: '昨天',
+      lastWeek: '上周',
+      thisMonth: '本月',
+      lastMonth: '上个月',
+      thisYear: '今年',
+      lastYear: '去年',
+      allTime: '全部时间',
+    },
+    meetingTrigger: '安排会议',
+    meetingLabel: '安排会议',
+    send: '发送邀请',
+    selectTime: '选择时间',
+    duration: (n) => plural('zh', n, { other: '{n} 分钟' }),
+  },
+  ar: {
+    cancel: 'إلغاء',
+    apply: 'تطبيق',
+    previousMonth: 'الشهر السابق',
+    nextMonth: 'الشهر التالي',
+    datePlaceholder: 'اختر تاريخًا',
+    dateLabel: 'التاريخ',
+    rangePlaceholder: 'اختر نطاقًا زمنيًا',
+    rangeLabel: 'النطاق الزمني',
+    startDate: 'تاريخ البدء',
+    endDate: 'تاريخ الانتهاء',
+    daysSelected: (n) =>
+      plural('ar', n, {
+        zero: 'لم يتم تحديد أي يوم',
+        one: 'تم تحديد يوم واحد',
+        two: 'تم تحديد يومين',
+        few: 'تم تحديد {n} أيام',
+        many: 'تم تحديد {n} يومًا',
+        other: 'تم تحديد {n} يوم',
+      }),
+    presets: {
+      today: 'اليوم',
+      yesterday: 'أمس',
+      lastWeek: 'الأسبوع الماضي',
+      thisMonth: 'هذا الشهر',
+      lastMonth: 'الشهر الماضي',
+      thisYear: 'هذا العام',
+      lastYear: 'العام الماضي',
+      allTime: 'كل الأوقات',
+    },
+    meetingTrigger: 'جدولة اجتماع',
+    meetingLabel: 'جدولة اجتماع',
+    send: 'إرسال الدعوة',
+    selectTime: 'اختر وقتًا',
+    duration: (n) =>
+      plural('ar', n, {
+        one: 'دقيقة واحدة',
+        two: 'دقيقتان',
+        few: '{n} دقائق',
+        many: '{n} دقيقة',
+        other: '{n} دقيقة',
+      }),
+  },
+  hi: {
+    cancel: 'रद्द करें',
+    apply: 'लागू करें',
+    previousMonth: 'पिछला महीना',
+    nextMonth: 'अगला महीना',
+    datePlaceholder: 'तारीख़ चुनें',
+    dateLabel: 'तारीख़',
+    rangePlaceholder: 'तारीख़ की सीमा चुनें',
+    rangeLabel: 'तारीख़ की सीमा',
+    startDate: 'शुरू होने की तारीख़',
+    endDate: 'ख़त्म होने की तारीख़',
+    daysSelected: (n) => plural('hi', n, { one: '{n} दिन चुना गया', other: '{n} दिन चुने गए' }),
+    presets: {
+      today: 'आज',
+      yesterday: 'बीता कल',
+      lastWeek: 'पिछला सप्ताह',
+      thisMonth: 'इस महीने',
+      lastMonth: 'पिछला महीना',
+      thisYear: 'इस साल',
+      lastYear: 'पिछला साल',
+      allTime: 'पूरा समय',
+    },
+    meetingTrigger: 'मीटिंग शेड्यूल करें',
+    meetingLabel: 'मीटिंग शेड्यूल करें',
+    send: 'आमंत्रण भेजें',
+    selectTime: 'समय चुनें',
+    duration: (n) => plural('hi', n, { other: '{n} मिनट' }),
+  },
+  bn: {
+    cancel: 'বাতিল',
+    apply: 'প্রয়োগ করুন',
+    previousMonth: 'আগের মাস',
+    nextMonth: 'পরের মাস',
+    datePlaceholder: 'তারিখ বেছে নিন',
+    dateLabel: 'তারিখ',
+    rangePlaceholder: 'তারিখের পরিসর বেছে নিন',
+    rangeLabel: 'তারিখের পরিসর',
+    startDate: 'শুরুর তারিখ',
+    endDate: 'শেষের তারিখ',
+    daysSelected: (n) => plural('bn', n, { other: '{n} দিন নির্বাচিত' }),
+    presets: {
+      today: 'আজ',
+      yesterday: 'গতকাল',
+      lastWeek: 'গত সপ্তাহ',
+      thisMonth: 'এই মাস',
+      lastMonth: 'গত মাস',
+      thisYear: 'এই বছর',
+      lastYear: 'গত বছর',
+      allTime: 'সব সময়',
+    },
+    meetingTrigger: 'মিটিং নির্ধারণ করুন',
+    meetingLabel: 'মিটিং নির্ধারণ করুন',
+    send: 'আমন্ত্রণ পাঠান',
+    selectTime: 'সময় বেছে নিন',
+    duration: (n) => plural('bn', n, { other: '{n} মিনিট' }),
+  },
+  id: {
+    cancel: 'Batal',
+    apply: 'Terapkan',
+    previousMonth: 'Bulan sebelumnya',
+    nextMonth: 'Bulan berikutnya',
+    datePlaceholder: 'Pilih tanggal',
+    dateLabel: 'Tanggal',
+    rangePlaceholder: 'Pilih rentang tanggal',
+    rangeLabel: 'Rentang tanggal',
+    startDate: 'Tanggal mulai',
+    endDate: 'Tanggal selesai',
+    daysSelected: (n) => plural('id', n, { other: '{n} hari dipilih' }),
+    presets: {
+      today: 'Hari ini',
+      yesterday: 'Kemarin',
+      lastWeek: 'Minggu lalu',
+      thisMonth: 'Bulan ini',
+      lastMonth: 'Bulan lalu',
+      thisYear: 'Tahun ini',
+      lastYear: 'Tahun lalu',
+      allTime: 'Sepanjang waktu',
+    },
+    meetingTrigger: 'Jadwalkan rapat',
+    meetingLabel: 'Jadwalkan rapat',
+    send: 'Kirim undangan',
+    selectTime: 'Pilih waktu',
+    duration: (n) => plural('id', n, { other: '{n} menit' }),
+  },
+};

package/src/date-picker/types.ts

@@ -19,15 +19,31 @@ export interface CalendarConstraintProps {
   isDateUnavailable?: (date: Date) => boolean;
   /** First column of the grid. Defaults to `0` (Sunday). */
   weekStartsOn?: WeekStart;
-  /** BCP 47 locale for month, weekday and trigger text. Defaults to the runtime's. */
+  /**
+   * BCP 47 locale for month, weekday and trigger text, and for Bloom's own
+   * strings (Cancel, Apply, …). Defaults to `BloomProvider`'s `locale`, else the
+   * runtime's.
+   */
   locale?: string;
 }
 
+/**
+ * Overrides for the month panels' fixed strings. Bloom already speaks them in
+ * the picker's `locale`; pass these only for wording of your own.
+ */
+export interface CalendarLabels {
+  /** Names the previous-month chevron (`'Previous month'` in English). */
+  previousMonth?: string;
+  /** Names the next-month chevron (`'Next month'` in English). */
+  nextMonth?: string;
+}
+
 interface CalendarBaseProps extends CalendarConstraintProps {
   /** Month shown first. Defaults to the selected day's month, else today's. */
   defaultMonth?: Date;
   /** Names the calendar grid. Defaults to the month title. */
   accessibilityLabel?: string;
+  labels?: CalendarLabels;
   style?: StyleProp<ViewStyle>;
   testID?: string;
 }
@@ -68,6 +84,40 @@ interface PickerBaseProps extends CalendarConstraintProps {
   testID?: string;
 }
 
+/** Overrides for `DatePicker`'s fixed strings, which Bloom already speaks in `locale`. */
+export interface DatePickerLabels extends CalendarLabels {
+  /** The footer's dismiss button (`'Cancel'` in English). */
+  cancel?: string;
+  /** The footer's commit button (`'Apply'` in English). */
+  apply?: string;
+}
+
+/** The quick-select column's rows, in the order they are drawn. */
+export type DateRangePreset =
+  | 'today'
+  | 'yesterday'
+  | 'lastWeek'
+  | 'thisMonth'
+  | 'lastMonth'
+  | 'thisYear'
+  | 'lastYear'
+  | 'allTime';
+
+/** Overrides for `DateRangePicker`'s fixed strings, which Bloom already speaks in `locale`. */
+export interface DateRangePickerLabels extends DatePickerLabels {
+  /**
+   * The footer pill. Receives the count; Bloom's own pluralises per language
+   * (`'14 days selected'` in English).
+   */
+  daysSelected?: (days: number) => string;
+  /** Names the start-date chip (`'Start date'` in English). */
+  startDate?: string;
+  /** Names the end-date chip (`'End date'` in English). */
+  endDate?: string;
+  /** Quick-select rows; any left out keep Bloom's (`'Today'`, `'Last week'`, … in English). */
+  presets?: Partial<Record<DateRangePreset, string>>;
+}
+
 export interface DatePickerProps extends PickerBaseProps {
   /** Committed day (controlled). `null` for none. */
   value?: Date | null;
@@ -75,10 +125,12 @@ export interface DatePickerProps extends PickerBaseProps {
   defaultValue?: Date | null;
   /** Called on Apply with the chosen day. */
   onChange?: (date: Date | null) => void;
-  /** Trigger text with no day committed. Defaults to `'Select date'`. */
+  /** Trigger text with no day committed. Defaults to Bloom's (`'Select date'` in English). */
   placeholder?: string;
-  /** Names the popup and its calendar. Defaults to `'Date'`. */
+  /** Names the popup and its calendar. Defaults to Bloom's (`'Date'` in English). */
   accessibilityLabel?: string;
+  /** Footer buttons and month chevrons. */
+  labels?: DatePickerLabels;
 }
 
 export interface DateRangePickerProps extends PickerBaseProps {
@@ -88,12 +140,14 @@ export interface DateRangePickerProps extends PickerBaseProps {
   defaultValue?: DateRange | null;
   /** Called on Apply with the chosen range. */
   onChange?: (range: DateRange | null) => void;
-  /** Trigger text with no range committed. Defaults to `'Select date range'`. */
+  /** Trigger text with no range committed. Defaults to Bloom's (`'Select date range'` in English). */
   placeholder?: string;
-  /** Names the popup and its calendar. Defaults to `'Date range'`. */
+  /** Names the popup and its calendar. Defaults to Bloom's (`'Date range'` in English). */
   accessibilityLabel?: string;
   /** Show the quick-select column (Today, Last week, …). Defaults to `true`. */
   quickSelect?: boolean;
+  /** Footer buttons and pill, date chips, quick-select rows and month chevrons. */
+  labels?: DateRangePickerLabels;
 }
 
 /** The person the meeting is booked with. */
@@ -135,13 +189,13 @@ export type HourFormat = '12h' | '24h';
 /** The hour-format toggle. An alias of {@link HourFormat}. */
 export type MeetingSchedulerHourFormat = HourFormat;
 
-/** Fixed strings, overridable for localisation. */
-export interface MeetingSchedulerLabels {
-  /** Default `'Send meeting'`. */
+/** Overrides for `MeetingScheduler`'s fixed strings, which Bloom already speaks in `locale`. */
+export interface MeetingSchedulerLabels extends CalendarLabels {
+  /** `'Send meeting'` in English. */
   send?: string;
-  /** Chip text before a time is picked. Default `'Select a time'`. */
+  /** Chip text before a time is picked (`'Select a time'` in English). */
   selectTime?: string;
-  /** `{n} minutes`. Default `(n) => \`${n} minutes\``. */
+  /** The duration row (`'30 minutes'` in English). */
   duration?: (minutes: number) => string;
 }
 
@@ -162,9 +216,9 @@ export interface MeetingSchedulerProps extends CalendarConstraintProps {
   onChange?: (value: MeetingSchedulerValue | null) => void;
   /** Initial hour format. Defaults to `'24h'`. */
   defaultHourFormat?: MeetingSchedulerHourFormat;
-  /** Trigger text. Defaults to `'Schedule a meeting'`. */
+  /** Trigger text. Defaults to Bloom's (`'Schedule a meeting'` in English). */
   triggerLabel?: string;
-  /** Names the popup and its calendar. Defaults to `'Schedule meeting'`. */
+  /** Names the popup and its calendar. Defaults to Bloom's (`'Schedule meeting'` in English). */
   accessibilityLabel?: string;
   labels?: MeetingSchedulerLabels;
   disabled?: boolean;

package/src/index.ts

@@ -80,6 +80,8 @@ export type { BloomIconComponent } from './icons/icon-component';
 // App-wide plumbing (pure JS — no peer beyond what this barrel already links)
 export { ImageResolverProvider, useImageResolver, isImageUrl } from './image-resolver';
 export type { ImageResolver } from './image-resolver';
+export { LocaleProvider, useBloomLocale, BLOOM_LANGUAGES, resolveBloomLanguage } from './locale';
+export type { BloomLanguage } from './locale';
 // A namespace, not seven loose verbs: `getAspectRatio`/`setAspectRatio`/
 // `hasAspectRatio` are exactly the collision-prone shape the namespace rule
 // covers.

package/src/index.web.ts

@@ -85,6 +85,8 @@ export type { BloomIconComponent } from './icons/icon-component';
 // App-wide plumbing (pure JS — no peer beyond what this barrel already links)
 export { ImageResolverProvider, useImageResolver, isImageUrl } from './image-resolver';
 export type { ImageResolver } from './image-resolver';
+export { LocaleProvider, useBloomLocale, BLOOM_LANGUAGES, resolveBloomLanguage } from './locale';
+export type { BloomLanguage } from './locale';
 // A namespace, not seven loose verbs: `getAspectRatio`/`setAspectRatio`/
 // `hasAspectRatio` are exactly the collision-prone shape the namespace rule
 // covers.

package/src/locale/context.ts

@@ -0,0 +1,23 @@
+import { createContext, createElement, useContext, type ReactNode } from 'react';
+
+const LocaleContext = createContext<string | undefined>(undefined);
+
+/**
+ * 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.
+ */
+export function LocaleProvider({ locale, children }: { locale?: string; children?: ReactNode }) {
+  return createElement(LocaleContext.Provider, { value: locale }, children);
+}
+
+/**
+ * The locale a component should use: its own `locale` prop, else the nearest
+ * `LocaleProvider`'s, else `undefined` — which `Intl` and the message catalogs
+ * both read as "the runtime's".
+ */
+export function useBloomLocale(locale?: string): string | undefined {
+  const inherited = useContext(LocaleContext);
+  return locale ?? inherited;
+}

package/src/locale/format-date.ts

@@ -0,0 +1,28 @@
+/**
+ * `Intl.DateTimeFormat` pinned to the GREGORIAN calendar, keeping the locale's
+ * language, digits and order.
+ *
+ * Bloom's grids lay out and return Gregorian `Date`s. A locale whose default
+ * calendar is another one — `fa-IR` (Persian, year 1405), `th-TH` (Buddhist,
+ * 2569), some `ar-*` — would otherwise title a Gregorian September with
+ * another calendar's month and year, so the day a reader picks and the day the
+ * app receives disagree. `null` when the runtime cannot format at all (a bad
+ * tag), for the caller's own fallback.
+ */
+export function formatGregorian(
+  date: Date,
+  locale: string | undefined,
+  options: Intl.DateTimeFormatOptions,
+): string | null {
+  try {
+    return new Intl.DateTimeFormat(locale, { ...options, calendar: 'gregory' }).format(date);
+  } catch {
+    // An engine that rejects the `calendar` option still formats the locale's
+    // words; only a tag it cannot read at all falls through to `null`.
+    try {
+      return new Intl.DateTimeFormat(locale, options).format(date);
+    } catch {
+      return null;
+    }
+  }
+}

package/src/locale/index.ts

@@ -0,0 +1,4 @@
+export { LocaleProvider, useBloomLocale } from './context';
+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.