Descripción general

gt-next@6.11.0 incorpora compatibilidad para el parámetro $maxChars en las funciones de traducción, basándose en la funcionalidad formatCutoff() presentada en generaltranslation@8.1.0.

Uso

El parámetro $maxChars funciona con cualquier llamada de traducción de cadenas de texto:

gt('Welcome to our application', { $maxChars: 20 })
// La IA intenta la traducción en 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 en la biblioteca: Si alguna traducción (proveniente de la IA o de la caché) supera el límite de caracteres, la biblioteca aplica un truncamiento adaptado a 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 excede 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 la traducción dentro de 30 caracteres: "Notificación usuario"
// La biblioteca trunca si es necesario: "Notificación del usuario…"

El parámetro afecta el cálculo del hash de las traducciones, garantizando que distintos límites de caracteres generen entradas de traducción independientes.