@oxy.so/bloom 5.0.0 → 5.1.1

package/src/vendor-card/messages.ts

@@ -0,0 +1,145 @@
+import type { BloomLanguage } from '../locale/languages';
+import type { MessageCatalog } from '../locale/messages';
+import { plural, pluralCategory, type PluralCategory } from '../locale/plural';
+import type { VendorAvailability, VendorFactKey } from './types';
+
+/**
+ * Every fixed string the vendor card draws or announces, in each Bloom
+ * language. A caller's `factLabels`, `availabilityLabel`, `newLabel` and
+ * `accessibilityLabel` still win over any entry here.
+ */
+export interface VendorCardMessages {
+  /** The word said before each reading in the card's accessible name. */
+  facts: Record<VendorFactKey, string>;
+  /** The status pill. `open` draws none. */
+  availability: Record<Exclude<VendorAvailability, 'open'>, string>;
+  /** An unrated vendor's mark. */
+  new: string;
+  /**
+   * The rating in the card's accessible name: "Rated 4.8 out of 5, 214
+   * reviews". `reviews` is the app's count, a number or pre-formatted text.
+   */
+  rated: (value: string, reviews?: number | string) => string;
+}
+
+/** A count the app may hand over as a number or as its own text ("1.2k"). */
+function counted(
+  language: BloomLanguage,
+  count: number | string,
+  forms: Partial<Record<PluralCategory, string>> & { other: string },
+): string {
+  if (typeof count === 'number') return plural(language, count, forms);
+  const form = /^\d+$/.test(count) ? forms[pluralCategory(language, Number(count))] : undefined;
+  return (form ?? forms.other).replace('{n}', count);
+}
+
+const has = (reviews: number | string | undefined): reviews is number | string =>
+  reviews != null && reviews !== '';
+
+export const VENDOR_CARD_MESSAGES: MessageCatalog<VendorCardMessages> = {
+  en: {
+    facts: { deliveryTime: 'Delivery time', deliveryFee: 'Delivery', distance: 'Distance', minimumOrder: 'Minimum order' },
+    availability: { paused: 'Paused', closed: 'Closed' },
+    new: 'New',
+    rated: (value, reviews) =>
+      `Rated ${value} out of 5${has(reviews) ? `, ${counted('en', reviews, { one: '{n} review', other: '{n} reviews' })}` : ''}`,
+  },
+  es: {
+    facts: { deliveryTime: 'Tiempo de entrega', deliveryFee: 'Envío', distance: 'Distancia', minimumOrder: 'Pedido mínimo' },
+    availability: { paused: 'En pausa', closed: 'Cerrado' },
+    new: 'Nuevo',
+    rated: (value, reviews) =>
+      `Valoración: ${value} de 5${has(reviews) ? `, ${counted('es', reviews, { one: '{n} reseña', other: '{n} reseñas' })}` : ''}`,
+  },
+  ca: {
+    facts: { deliveryTime: "Temps d'entrega", deliveryFee: 'Enviament', distance: 'Distància', minimumOrder: 'Comanda mínima' },
+    availability: { paused: 'En pausa', closed: 'Tancat' },
+    new: 'Nou',
+    rated: (value, reviews) =>
+      `Valoració: ${value} de 5${has(reviews) ? `, ${counted('ca', reviews, { one: '{n} ressenya', other: '{n} ressenyes' })}` : ''}`,
+  },
+  de: {
+    facts: { deliveryTime: 'Lieferzeit', deliveryFee: 'Liefergebühr', distance: 'Entfernung', minimumOrder: 'Mindestbestellwert' },
+    availability: { paused: 'Pausiert', closed: 'Geschlossen' },
+    new: 'Neu',
+    rated: (value, reviews) =>
+      `Bewertet mit ${value} von 5${has(reviews) ? `, ${counted('de', reviews, { one: '{n} Bewertung', other: '{n} Bewertungen' })}` : ''}`,
+  },
+  fr: {
+    facts: { deliveryTime: 'Délai de livraison', deliveryFee: 'Livraison', distance: 'Distance', minimumOrder: 'Commande minimum' },
+    availability: { paused: 'En pause', closed: 'Fermé' },
+    new: 'Nouveau',
+    rated: (value, reviews) =>
+      `Noté ${value} sur 5${has(reviews) ? `, ${counted('fr', reviews, { one: '{n} avis', other: '{n} avis' })}` : ''}`,
+  },
+  it: {
+    facts: { deliveryTime: 'Tempo di consegna', deliveryFee: 'Consegna', distance: 'Distanza', minimumOrder: 'Ordine minimo' },
+    availability: { paused: 'In pausa', closed: 'Chiuso' },
+    new: 'Nuovo',
+    rated: (value, reviews) =>
+      `Valutazione ${value} su 5${has(reviews) ? `, ${counted('it', reviews, { one: '{n} recensione', other: '{n} recensioni' })}` : ''}`,
+  },
+  pt: {
+    facts: { deliveryTime: 'Tempo de entrega', deliveryFee: 'Entrega', distance: 'Distância', minimumOrder: 'Pedido mínimo' },
+    availability: { paused: 'Pausado', closed: 'Fechado' },
+    new: 'Novo',
+    rated: (value, reviews) =>
+      `Avaliação ${value} de 5${has(reviews) ? `, ${counted('pt', reviews, { one: '{n} avaliação', other: '{n} avaliações' })}` : ''}`,
+  },
+  ru: {
+    facts: { deliveryTime: 'Время доставки', deliveryFee: 'Доставка', distance: 'Расстояние', minimumOrder: 'Минимальный заказ' },
+    availability: { paused: 'Приостановлено', closed: 'Закрыто' },
+    new: 'Новое',
+    rated: (value, reviews) =>
+      `Оценка ${value} из 5${has(reviews) ? `, ${counted('ru', reviews, { one: '{n} отзыв', few: '{n} отзыва', many: '{n} отзывов', other: '{n} отзыва' })}` : ''}`,
+  },
+  tr: {
+    facts: { deliveryTime: 'Teslimat süresi', deliveryFee: 'Teslimat', distance: 'Mesafe', minimumOrder: 'Minimum sipariş' },
+    availability: { paused: 'Duraklatıldı', closed: 'Kapalı' },
+    new: 'Yeni',
+    rated: (value, reviews) =>
+      `5 üzerinden ${value} puan${has(reviews) ? `, ${counted('tr', reviews, { other: '{n} değerlendirme' })}` : ''}`,
+  },
+  ja: {
+    facts: { deliveryTime: '配達時間', deliveryFee: '配達料', distance: '距離', minimumOrder: '最低注文金額' },
+    availability: { paused: '一時停止中', closed: '営業時間外' },
+    new: '新着',
+    rated: (value, reviews) =>
+      `評価 ${value}（5点満点）${has(reviews) ? `、${counted('ja', reviews, { other: 'レビュー{n}件' })}` : ''}`,
+  },
+  zh: {
+    facts: { deliveryTime: '配送时间', deliveryFee: '配送费', distance: '距离', minimumOrder: '起送价' },
+    availability: { paused: '暂停营业', closed: '已打烊' },
+    new: '新店',
+    rated: (value, reviews) =>
+      `评分 ${value}（满分 5 分）${has(reviews) ? `，${counted('zh', reviews, { other: '{n} 条评价' })}` : ''}`,
+  },
+  ar: {
+    facts: { deliveryTime: 'وقت التوصيل', deliveryFee: 'التوصيل', distance: 'المسافة', minimumOrder: 'الحد الأدنى للطلب' },
+    availability: { paused: 'متوقف مؤقتًا', closed: 'مغلق' },
+    new: 'جديد',
+    rated: (value, reviews) =>
+      `التقييم ${value} من 5${has(reviews) ? `، ${counted('ar', reviews, { zero: 'لا مراجعات', one: 'مراجعة واحدة', two: 'مراجعتان', few: '{n} مراجعات', many: '{n} مراجعة', other: '{n} مراجعة' })}` : ''}`,
+  },
+  hi: {
+    facts: { deliveryTime: 'डिलीवरी का समय', deliveryFee: 'डिलीवरी', distance: 'दूरी', minimumOrder: 'न्यूनतम ऑर्डर' },
+    availability: { paused: 'रुका हुआ', closed: 'बंद' },
+    new: 'नया',
+    rated: (value, reviews) =>
+      `5 में से ${value} रेटिंग${has(reviews) ? `, ${counted('hi', reviews, { one: '{n} समीक्षा', other: '{n} समीक्षाएँ' })}` : ''}`,
+  },
+  bn: {
+    facts: { deliveryTime: 'ডেলিভারির সময়', deliveryFee: 'ডেলিভারি', distance: 'দূরত্ব', minimumOrder: 'ন্যূনতম অর্ডার' },
+    availability: { paused: 'বিরতিতে', closed: 'বন্ধ' },
+    new: 'নতুন',
+    rated: (value, reviews) =>
+      `৫-এর মধ্যে ${value} রেটিং${has(reviews) ? `, ${counted('bn', reviews, { other: '{n}টি রিভিউ' })}` : ''}`,
+  },
+  id: {
+    facts: { deliveryTime: 'Waktu pengantaran', deliveryFee: 'Ongkos kirim', distance: 'Jarak', minimumOrder: 'Pesanan minimum' },
+    availability: { paused: 'Dijeda', closed: 'Tutup' },
+    new: 'Baru',
+    rated: (value, reviews) =>
+      `Rating ${value} dari 5${has(reviews) ? `, ${counted('id', reviews, { other: '{n} ulasan' })}` : ''}`,
+  },
+};

package/src/vendor-card/shared.ts

@@ -13,22 +13,18 @@
 import { PHOTO_RADIUS } from '../listing-card/shared';
 import type { ListingFact } from '../listing-card/types';
 import { formatRatingValue } from '../rating/Rating';
-import {
-  VENDOR_AVAILABILITY_LABELS,
-  VENDOR_CUISINE_LIMIT,
-  VENDOR_FACT_ICON,
-  VENDOR_FACT_LABELS,
-  VENDOR_FACT_ORDER,
-} from './constants';
+import { VENDOR_CUISINE_LIMIT, VENDOR_FACT_ICON, VENDOR_FACT_ORDER } from './constants';
+import { VENDOR_CARD_MESSAGES, type VendorCardMessages } from './messages';
 import type { VendorAvailability, VendorCardDensity, VendorCardProps, VendorFactKey } from './types';
 
 /** The status pill's label, or `null` for a vendor that is taking orders. */
 export function availabilityLabelFor(
   availability: VendorAvailability | undefined,
   override?: string,
+  messages: VendorCardMessages = VENDOR_CARD_MESSAGES.en,
 ): string | null {
   if (!availability || availability === 'open') return null;
-  return override ?? VENDOR_AVAILABILITY_LABELS[availability];
+  return override ?? messages.availability[availability];
 }
 
 /**
@@ -42,6 +38,7 @@ export function vendorFacts(
     VendorCardProps,
     'deliveryTime' | 'deliveryFee' | 'distance' | 'minimumOrder' | 'factLabels'
   >,
+  messages: VendorCardMessages = VENDOR_CARD_MESSAGES.en,
 ): ListingFact[] {
   const values: Record<VendorFactKey, string | undefined> = {
     deliveryTime: props.deliveryTime,
@@ -53,7 +50,7 @@ export function vendorFacts(
   for (const key of VENDOR_FACT_ORDER) {
     const value = values[key];
     if (!value) continue;
-    const word = props.factLabels?.[key] ?? VENDOR_FACT_LABELS[key];
+    const word = props.factLabels?.[key] ?? messages.facts[key];
     facts.push({ icon: VENDOR_FACT_ICON[key], label: value, accessibilityLabel: `${word} ${value}` });
   }
   return facts;
@@ -74,9 +71,12 @@ export function vendorCuisines(
  * pills because it ran out of width, which is not a reason to withhold them
  * from someone who is listening rather than looking.
  */
-export function composeVendorName(props: VendorCardProps): string {
+export function composeVendorName(
+  props: VendorCardProps,
+  messages: VendorCardMessages = VENDOR_CARD_MESSAGES.en,
+): string {
   const parts: string[] = [props.name];
-  const status = availabilityLabelFor(props.availability, props.availabilityLabel);
+  const status = availabilityLabelFor(props.availability, props.availabilityLabel, messages);
   if (status) parts.push(status);
   if (status && props.opensAt) parts.push(props.opensAt);
   if (props.promo) parts.push(props.promo);
@@ -84,14 +84,12 @@ export function composeVendorName(props: VendorCardProps): string {
   if (props.rating !== undefined) {
     const rated = props.rating !== null && props.rating !== '';
     if (rated) {
-      const count =
-        props.reviewCount != null && props.reviewCount !== '' ? `, ${props.reviewCount} reviews` : '';
-      parts.push(`Rated ${formatRatingValue(props.rating as number | string)} out of 5${count}`);
+      parts.push(messages.rated(formatRatingValue(props.rating as number | string), props.reviewCount));
     } else {
-      parts.push(props.newLabel ?? 'New');
+      parts.push(props.newLabel ?? messages.new);
     }
   }
-  for (const fact of vendorFacts(props)) parts.push(fact.accessibilityLabel ?? fact.label);
+  for (const fact of vendorFacts(props, messages)) parts.push(fact.accessibilityLabel ?? fact.label);
   return parts.join(', ');
 }
 

package/src/vendor-card/types.ts

@@ -52,7 +52,7 @@ export interface VendorCardProps {
   rating?: number | string | null;
   /** The review count, drawn after the rating ("(128)"). */
   reviewCount?: number | string;
-  /** The "New" label of an unrated vendor. Default `"New"`. */
+  /** The "New" label of an unrated vendor (`"New"` in English). */
   newLabel?: string;
   /** Pre-formatted — "25–35 min". */
   deliveryTime?: string;
@@ -64,8 +64,8 @@ export interface VendorCardProps {
   minimumOrder?: string;
   /**
    * The WORD said before each reading in the card's accessible name —
-   * "Delivery time 25–35 min". Defaults are English ("Delivery time",
-   * "Delivery", "Distance", "Minimum order"); a bare "25–35 min" beside a glyph
+   * "Delivery time 25–35 min". Defaults follow the locale ("Delivery time",
+   * "Delivery", "Distance", "Minimum order" in English); a bare "25–35 min" beside a glyph
    * means nothing read aloud, and the glyph is not announced.
    */
   factLabels?: Partial<Record<VendorFactKey, string>>;
@@ -75,7 +75,7 @@ export interface VendorCardProps {
   promoTone?: AccentTone;
   /** Default `open`. */
   availability?: VendorAvailability;
-  /** Replaces the English status label ("Paused", "Closed"). */
+  /** Replaces the localised status label ("Paused", "Closed" in English). */
   availabilityLabel?: string;
   /**
    * When the vendor takes orders again, PRE-FORMATTED by the app — "Opens at
@@ -106,8 +106,8 @@ export interface VendorCardProps {
   density?: VendorCardDensity;
   /**
    * Replaces the composed accessible name ("Fig & Ember, Closed, Japanese,
-   * Sushi, Rated 4.8 out of 5, 214 reviews, Delivery time 25–35 min"), which is
-   * English.
+   * Sushi, Rated 4.8 out of 5, 214 reviews, Delivery time 25–35 min" in
+   * English), which follows the locale.
    */
   accessibilityLabel?: string;
   style?: StyleProp<ViewStyle>;