Zasady wsparcia
Aktywne linie wydań i LTS, kryteria zmian niezgodnych wstecz i obsługiwane środowiska uruchomieniowe.
Ta strona opisuje, jak długo każda linia wydań Text.js otrzymuje poprawki i co uznajemy za zmianę niezgodną wstecz.
Linie wydań
| Status | Zakres aktualizacji | Okres |
|---|---|---|
| Aktywna | Funkcje, poprawki, łatki bezpieczeństwa | Do następnego wydania głównego |
| Utrzymaniowa LTS | Krytyczne poprawki i łatki bezpieczeństwa | 12 miesięcy od publikacji następnego wydania głównego |
| Koniec wsparcia | Brak | — |
Poprawki otrzymuje tylko najnowsze wydanie poboczne danej wersji głównej: po publikacji 1.5.0 poprawki trafiają do 1.5.x, a nie do 1.4.x. Po publikacji 2.0.0 ostatnie wydanie poboczne 1.x staje się utrzymaniową linią LTS i jest publikowane pod tagami dystrybucji lts i v1-lts.
| Wersja | Status | Koniec wsparcia |
|---|---|---|
| 1.x | Aktywna | 12 miesięcy po wydaniu 2.0.0 |
Zakres poprawek w LTS
- Luki bezpieczeństwa w pakietach Text.js
- Awarie, utrata danych i błędy budowania bez dostępnego obejścia
- Zgodność z nowymi wydaniami przeglądarek Chrome, Edge, Firefox i Safari, które psują renderowanie w konsoli
- Zgodność z obsługiwanymi środowiskami uruchomieniowymi i docelowymi środowiskami wdrożenia
Nowe funkcje, usprawnienia wydajności i refaktoryzacje trafiają wyłącznie do aktywnej linii.
Zmiany niezgodne wstecz
Poniższe elementy zmieniają się tylko w wydaniu głównym, po ostrzeżeniu o wycofaniu w co najmniej jednym wydaniu pobocznym:
- Publiczne eksporty
@textjs/app,@textjs/reacti@textjs/core, w tym@textjs/app/serveri@textjs/app/cache - Opcje
text.config.ts, polecenia i flagi CLItext - Konwencje plików w
app/,middleware.tsi konfiguracja segmentów tras - Układy plików wyjściowych adapterów (
.vercel/output,_worker.js,dist/server.js)
Poza zakresem: API oznaczone jako eksperymentalne lub unstable_, w tym wszystko w @textjs/core/experimental i @textjs/react/experimental (mogą się zmieniać w wydaniu pobocznym, z adnotacją w historii zmian), elementy wewnętrzne, takie jak @textjs/core/internal, nagłówki x-middleware-* i metadane budowania w .text/, wydania canary oraz dokładna postać ciągów formatujących console.log i CSS (klatki pozostają wizualnie identyczne; ich kodowanie może stać się szybsze).
Obsługiwane środowiska uruchomieniowe
| Środowisko uruchomieniowe | Obsługiwane wersje |
|---|---|
| DevTools w Chrome / Edge | Bieżące i dwa poprzednie wydania stabilne |
| Konsole w Firefox i Safari | Bieżące wydanie stabilne |
| Node.js | Aktywne i utrzymaniowe wydania LTS (text start, funkcje Vercel) |
| Bun | Najnowsze 1.x |
| Cloudflare Workers | compatibility_date 2025-01-01 lub późniejsza, nodejs_compat |
Usunięcie obsługi wersji środowiska uruchomieniowego, której wsparcie już się zakończyło, nie jest zmianą niezgodną wstecz.
Bezpieczeństwo
Zgłaszaj luki prywatnie na adres [email protected] lub przez zgłoszenia bezpieczeństwa GitHub. Poprawki są publikowane jednocześnie dla każdej wspieranej linii, a komunikat o luce pojawia się, gdy poprawione wersje są już dostępne w npm.
Zobacz Kanały wydań, aby dowiedzieć się, jak powstają wersje i tagi dystrybucji.