Обзор

gt-next@6.11.0 добавляет поддержку параметра $maxChars для функций перевода, расширяя функциональность formatCutoff(), представленную в generaltranslation@8.1.0.

Использование

Параметр $maxChars применяется при любых вызовах перевода строк:

gt('Welcome to our application', { $maxChars: 20 })
// ИИ пытается выполнить перевод в пределах 20 символов: "Bienvenido a app"

Обработка ограничения по количеству символов

Параметр $maxChars запускает два разных механизма:

1. Оптимизация AI‑перевода: AI получает ограничение по количеству символов и пытается сгенерировать перевод, который укладывается в заданную длину.

2. Обрезка на уровне библиотеки: Если какой‑либо перевод (от AI или из кэша) превышает лимит символов, библиотека применяет обрезку с учётом локали, чтобы соблюсти ограничение.

gt('Long description text', { $maxChars: 15 })
// ИИ пытается создать краткий перевод: "Texto breve"
// Если результат превышает лимит: "Texto de desc…" (обрезан)

Интеграция

Совместимо с существующими решениями для перевода:

gt('User notification', {
  $context: 'mobile-alert',
  $maxChars: 30
})
// ИИ пытается выполнить перевод в пределах 30 символов: "Notificación usuario"
// Библиотека обрезает текст при необходимости: "Notificación del usuario…"

Этот параметр влияет на хеширование переводов, гарантируя, что разные ограничения по длине строки создают отдельные записи перевода.