Formato de mensajes

Una sintaxis pequeña, con Intl nativo por debajo: plurales, género y formato sin aprender ICU completo.

Interpolación

"Hola {name}"          → t('saludo', { name: 'Aron' })

Los valores se formatean solos según su tipo: números con Intl.NumberFormat, fechas con Intl.DateTimeFormat, textos tal cual. Un param que falta muestra el hueco literal y avisa una vez nombrando el mensaje, así que se ve rápido y nunca revienta.

Formatters

Agrega :formatter (con /arg opcional) a un param:

Los formatters custom se conectan al crear la instancia. La firma completa es (value, locale, arg?) => string, donde locale es el idioma activo y arg es lo que sigue al / en el placeholder:

createVerbaly({
  formatters: { upper: (v) => String(v).toUpperCase() },
});
// "{word:upper}" → HOLA

Tiempo relativo, listas y unidades

El formato cubre el resto del Intl moderno, siempre con cero dependencias:

"Updated {when:relative}"       → Updated 2 hours ago · yesterday
"Ready {n:relative/day}"        → Ready in 3 days
"Works in {langs:list}"         → Works in English, Spanish, and Portuguese
"Pick {opts:list/or}"           → Pick red, green, or blue
"{d:unit/kilometer}"            → 3 km

• relative: pasa un Date y la unidad se elige sola contra ahora (Intl.RelativeTimeFormat con numeric: 'auto', así obtienes ayer, no hace 1 día); pasa un número con unidad explícita (relative/hour).
• list: los arrays se localizan vía Intl.ListFormat, conjunción por defecto, /or para disyunción, /unit para listas de unidades. Cada elemento se auto-formatea por locale.
• unit: cualquier id de unidad CLDR (kilometer, megabyte, liter…) vía Intl.NumberFormat.
• Los datos malos nunca rompen el render, y tampoco pasan de largo: un formato desconocido, una unidad inválida, un hueco al que le falta su argumento o una lista que no es lista avisan una vez, nombrando el mensaje, y caen a String(value).

Plurales y selects: una sola sintaxis

"{count | =0: sin mensajes | one: un mensaje | other: # mensajes}"
"{gender | male: él | female: ella | other: elle}"

• Los números matchean primero los valores exactos =N, luego las categorías de Intl.PluralRules (zero one two few many other).
• Los strings matchean su variante, con fallback a other.
• # renderiza el número formateado al locale. Las variantes anidan placeholders libremente.
• Incluye siempre other en un bloque plural. Es el caso comodín, así que un bloque sin él no renderiza nada para cualquier cantidad que no liste. verbaly check rompe el build por eso, y además avisa cuando un idioma necesita formas que a tu mensaje le faltan: el polaco llega a few y many donde el inglés solo necesita one y other. Si un catálogo llega a tu app sin pasar por el build, desde un loader lazy o un CMS, el runtime avisa en la consola nombrando el mensaje en vez de renderizar una cadena vacía en silencio. Un bloque de género o de rol es distinto: dejar other fuera ahí es tu decisión, y Verbaly no lo toca.

Escape-hatch ICU

¿Tienes strings ICU MessageFormat existentes, o necesitas su sintaxis exacta? Escribe ICU y Verbaly lo detecta automáticamente y lo parsea al mismo motor, con cero dependencias extra.

"{count, plural, one {# item} other {# items}}"
"{gender, select, male {he} female {she} other {they}}"
"{n, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}"

• Auto-detectado por mensaje: sin config, sin marcador. Mensajes nativos e ICU conviven en el mismo catálogo.
• Soporta plural, select, selectordinal (reglas ordinales reales), {n, number/date/time, style}, #, =N, anidado y quoting con '…'.
• Prefiere la sintaxis nativa por defecto; usa ICU solo cuando lo necesites.
• Solo lo pagas si lo usas. Verbaly lee tus catálogos al construir, y el parser de ICU entra en tu aplicación solo cuando alguno de tus mensajes lo necesita. Son unos 544 bytes, y no hay nada que encender. El tiempo relativo funciona igual: otros 318 bytes que solo viajan cuando un mensaje los pide.

Escapes

En mensajes rich (data-verbaly-rich o <Trans>) la entidad numérica { también muestra una llave literal: se decodifica después del parseo, así que nunca toca la sintaxis de placeholders.