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 número se lee como lo escribe el idioma, así que 2026 sale como 2,026 en inglés: pasa String(year) cuando el valor es una etiqueta, como el año de una línea de copyright, y no una cantidad. 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 tumban un render, y tampoco pasan de largo. Un formato desconocido, una unidad inválida, un hueco sin su argumento, una lista que no es una lista: cada uno avisa una vez, nombrando el mensaje, y cae 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 falla 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 '…'.
• Se comprueba como cualquier otro mensaje. Una traducción que aplanó un plural de ICU a texto plano, o que le quitó un parámetro, falla en verbaly check igual que uno nativo. El mismo guarda corre sobre lo que devuelve una traducción de máquina y sobre lo que importas.
• 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 un catálogo, una { o una } literal siempre se escribe doble. El texto escrito en tu código lo trae de serie, porque extract las duplica por ti; un catálogo escrito a mano tiene que hacerlo él mismo, traducciones incluidas.

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.