سیاست پشتیبانی
شاخه‌های انتشار فعال و LTS، معیار تغییر ناسازگار و محیط‌های اجرای پشتیبانی‌شده.
این صفحه مدت دریافت اصلاحات برای هر شاخهٔ انتشار Text.js و مواردی را که تغییر ناسازگار محسوب می‌شوند، توضیح می‌دهد.
شاخه‌های انتشار
| وضعیت | موارد دریافتی | مدت |
|---|---|---|
| فعال | قابلیت‌ها، اصلاحات، وصله‌های امنیتی | تا نسخهٔ اصلی بعدی |
| LTS در مرحلهٔ نگهداری | اصلاحات حیاتی و وصله‌های امنیتی | 12 ماه پس از انتشار نسخهٔ اصلی بعدی |
| پایان عمر | هیچ‌چیز | — |
فقط آخرین نسخهٔ فرعی از هر نسخهٔ اصلی وصله دریافت می‌کند: با انتشار 1.5.0، اصلاحات در 1.5.x اعمال می‌شوند، نه در 1.4.x. با انتشار 2.0.0، آخرین نسخهٔ فرعی 1.x به شاخهٔ LTS در مرحلهٔ نگهداری تبدیل می‌شود و با برچسب‌های توزیع 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، فرمان‌ها و پرچم‌های رابط خط فرمانtext - قراردادهای فایل در
app/، فایلmiddleware.tsو پیکربندی بخش مسیر - چیدمان‌های خروجی آداپتور (
.vercel/output،_worker.js،dist/server.js)
موارد خارج از پوشش: APIهایی با برچسب آزمایشی یا unstable_، شامل همهٔ موارد زیرمجموعهٔ @textjs/core/experimental و @textjs/react/experimental (ممکن است در یک نسخهٔ فرعی تغییر کنند و در گزارش تغییرات توضیح داده شوند)، موارد داخلی مانند @textjs/core/internal، سرآیندهای x-middleware-* و فرادادهٔ ساخت .text/، نسخه‌های canary و رشته‌های قالب‌بندی دقیق console.log و CSS (ظاهر فریم‌ها یکسان می‌ماند؛ کدگذاری آن‌ها ممکن است سریع‌تر شود).
پشتیبانی از محیط اجرا
| محیط اجرا | نسخه‌های پشتیبانی‌شده |
|---|---|
| Chrome / Edge DevTools | نسخهٔ پایدار فعلی و دو نسخهٔ پایدار قبلی |
| کنسول‌های Firefox و Safari | نسخهٔ پایدار فعلی |
| Node.js | نسخه‌های LTS فعال و در مرحلهٔ نگهداری (text start، توابع Vercel) |
| Bun | آخرین نسخهٔ 1.x |
| Cloudflare Workers | compatibility_date برابر با 2025-01-01 یا پس از آن، nodejs_compat |
قطع پشتیبانی از نسخهٔ محیط اجرایی که به پایان عمر خود رسیده است، تغییر ناسازگار محسوب نمی‌شود.
امنیت
آسیب‌پذیری‌ها را به‌صورت خصوصی به security@textjs.org یا از طریق اطلاعیه‌های امنیتی GitHub گزارش کنید. اصلاحات برای همهٔ شاخه‌های پشتیبانی‌شده هم‌زمان منتشر می‌شوند و اطلاعیه پس از قرار گرفتن نسخه‌های وصله‌شده در npm منتشر می‌شود.
برای آشنایی با نحوهٔ تولید نسخه‌ها و برچسب‌های توزیع، کانال‌های انتشار را ببینید.