Resumen

gt-next@6.11.0 añade soporte para el parámetro $maxChars en las funciones de traducción, a partir de la funcionalidad formatCutoff() introducida en generaltranslation@8.1.0.

Uso

El parámetro $maxChars puede usarse con cualquier llamada de traducción de cadenas:

gt('Welcome to our application', { $maxChars: 20 });
// La IA intenta la traducción en menos de 20 caracteres: "Bienvenido a app"

Gestión del límite de caracteres

El parámetro $maxChars activa dos mecanismos distintos:

1. Optimización de la traducción con IA: La IA recibe el límite de caracteres e intenta generar una traducción que se ajuste a la longitud especificada.

2. Truncamiento de la biblioteca: Si alguna traducción (de la IA o de la caché) supera el límite de caracteres, la biblioteca aplica un truncamiento según la configuración regional para respetar ese límite.

gt('Long description text', { $maxChars: 15 });
// La IA intenta una traducción concisa: "Texto breve"
// Si el resultado supera el límite: "Texto de desc…" (truncado)

Integración

Compatible con las opciones de traducción existentes:

gt('User notification', {
  $context: 'mobile-alert',
  $maxChars: 30,
});
// La IA intenta traducir en menos de 30 caracteres: "Notificación usuario"
// La biblioteca trunca si es necesario: "Notificación del usuario…"

El parámetro afecta al hash de traducción, lo que garantiza que distintos límites de caracteres generen entradas de traducción independientes.