Политика поддержки
Активные ветки и ветки LTS, критерии несовместимых изменений и поддерживаемые среды выполнения.
На этой странице описано, как долго каждая ветка выпусков Text.js получает исправления и что считается несовместимым изменением.
Ветки выпусков
| Статус | Обновления | Срок |
|---|---|---|
| Активная | Новые функции, исправления, патчи безопасности | До следующего мажорного выпуска |
| LTS в режиме сопровождения | Критические исправления и патчи безопасности | 12 месяцев после выхода следующего мажорного выпуска |
| Поддержка завершена | Нет | — |
Исправления получает только последний минорный выпуск каждой мажорной версии: после выхода 1.5.0 исправления попадают в 1.5.x, а не в 1.4.x. После выхода 2.0.0 последний минорный выпуск 1.x становится веткой LTS в режиме сопровождения и публикуется с dist-тегами lts и v1-lts.
| Версия | Статус | Срок поддержки |
|---|---|---|
| 1.x | Активная | 12 месяцев после выхода 2.0.0 |
Исправления в LTS
- Уязвимости безопасности в пакетах Text.js
- Аварийные завершения, потеря данных и сбои сборки без обходного решения
- Совместимость с новыми выпусками Chrome, Edge, Firefox и Safari, которые нарушают рендеринг в консоли
- Совместимость с поддерживаемыми средами выполнения и целевыми платформами развёртывания
Новые функции, оптимизации производительности и рефакторинг попадают только в активную ветку.
Несовместимые изменения
Следующее меняется только в мажорном выпуске, после предупреждения об устаревании хотя бы в одном минорном выпуске:
- Публичные экспорты
@textjs/app,@textjs/reactи@textjs/core, включая@textjs/app/serverи@textjs/app/cache - Параметры
text.config.ts, команды и флаги CLItext - Файловые соглашения в
app/,middleware.tsи конфигурация сегментов маршрута - Структура выходных файлов адаптеров (
.vercel/output,_worker.js,dist/server.js)
Гарантии не распространяются на API с пометкой experimental или unstable_, включая всё в @textjs/core/experimental и @textjs/react/experimental (они могут меняться в минорном выпуске с примечаниями в журнале изменений), внутренние API вроде @textjs/core/internal, заголовки x-middleware-* и метаданные сборки в .text/, canary-выпуски, а также точные строки форматирования console.log и CSS (кадры остаются визуально идентичными; их кодирование может стать быстрее).
Поддержка сред выполнения
| Среда выполнения | Поддерживаемые версии |
|---|---|
| Chrome / Edge DevTools | Текущий и два предыдущих стабильных выпуска |
| Консоли Firefox и Safari | Текущий стабильный выпуск |
| Node.js | Активные выпуски LTS и выпуски LTS в режиме сопровождения (text start, функции Vercel) |
| Bun | Последний выпуск 1.x |
| Cloudflare Workers | compatibility_date от 2025-01-01, nodejs_compat |
Прекращение поддержки версии среды выполнения, срок поддержки которой уже истёк, не считается несовместимым изменением.
Безопасность
Сообщайте об уязвимостях конфиденциально на [email protected] или через уведомления безопасности GitHub. Исправления выходят одновременно для всех поддерживаемых веток, а уведомление публикуется после появления исправленных версий в npm.
О том, как создаются версии и dist-теги, читайте в разделе Каналы выпусков.