سياسة الدعم

توضح هذه الصفحة مدة تلقّي كل سلسلة إصدارات من Text.js للإصلاحات، وما يُعد تغييرًا غير متوافق.

#سلاسل الإصدارات

تُطبّق التصحيحات على أحدث إصدار فرعي من كل إصدار رئيسي فقط: عند طرح 1.5.0، تصل الإصلاحات إلى 1.5.x، لا إلى 1.4.x. عند طرح 2.0.0، يصبح آخر إصدار فرعي من 1.x سلسلة صيانة بدعم طويل الأمد، ويُنشر بعلامتَي التوزيع lts و v1-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 (تبقى الإطارات متطابقة بصريًا؛ وقد يصبح ترميزها أسرع).

#دعم بيئات التشغيل

لا يُعد إسقاط دعم إصدار من بيئة تشغيل بلغ نهاية عمره تغييرًا غير متوافق.

#الأمان

أبلغ عن الثغرات بشكل خاص عبر security⁦@textjs.org⁩ أو من خلال تنبيهات الأمان في GitHub. تصدر الإصلاحات لكل سلسلة مدعومة في الوقت نفسه، ويُنشر التنبيه بعد إتاحة الإصدارات المصححة على npm.

راجع قنوات الإصدار لمعرفة كيفية إنتاج الإصدارات وعلامات التوزيع.