Text.js
التوثيق/البنية

قنوات الإصدار

وسوم التوزيع stable و canary و LTS، والإصدارات المتزامنة، وإثبات المصدر، وإصدار نسخة.

يُوزّع Text.js عبر ثلاثة وسوم توزيع في npm. تُحدّث إصدارات جميع الحزم (@textjs/app، @textjs/react، @textjs/core، @textjs/font، @textjs/opencode، create-text-app و eslint-plugin-textjs) بالتزامن، لذا يصف رقم إصدار واحد إطار العمل بأكمله.

القنوات

القناةوسم التوزيعالإصدارالتثبيت
المستقرةlatest1.0.xbun add @textjs/app
التجريبيةcanary1.0.x-canary.Nbun add @textjs/app@canary
الدعم طويل الأمدlts، v1-ltsيُنشر عند صدور 2.0.0bun add @textjs/app@lts

استخدم القناة المستقرة في بيئة الإنتاج. استخدم القناة التجريبية لتجربة الإصلاحات والميزات يوم وصولها إلى dev. عند توفر سلسلة إصدارات ذات دعم طويل الأمد، استخدمها إذا كنت ترقي مرة واحدة في السنة.

bun create text-app@canary my-console

القناة المستقرة

تتبع الإصدارات المستقرة الإصدارات الدلالية: تصلح الإصدارات التصحيحية الأخطاء، وتضيف الإصدارات الفرعية ميزات متوافقة مع الإصدارات السابقة، وقد تكسر الإصدارات الرئيسية توافق واجهات API بعد فترة إهمال. يُرقّى إصدار تجريبي اجتاز مجموعة الاختبارات الكاملة إلى إصدار مستقر، ويُنشر مع إثبات مصدر من npm.

القناة التجريبية

تُفحص الأنواع وتُجرى الاختبارات لكل عملية دفع إلى dev في المستودع الرسمي، ثم تُنشر بوصفها الإصدار التصحيحي التالي مع اللاحقة -canary.N:

latestعملية الدفع إلى devالإصدار المنشور
1.0.0الأولى1.0.1-canary.0
1.0.0الثانية1.0.1-canary.1
1.0.1التالية1.0.2-canary.0

تتابع قيمة N من أعلى إصدار تجريبي موجود على npm، لذا لا تتكرر الأرقام أبدًا. لا تُسجّل الإصدارات التجريبية في المستودع. أضف [skip canary] إلى رسالة الإيداع لتخطي النشر.

الإصدارات التجريبية هي نواتج بناء الفرع dev، الذي تُدمج فيه جميع طلبات السحب. قد تغيّر واجهات API غير الصادرة أو تزيلها دون إشعار. ثبّت رقم إصدار تجريبي محدد إذا كنت تعتمد على أحدها.

إثبات المصدر

تُنشر الإصدارات من ⁦GitHub Actions⁩ باستخدام npm publish --provenance، الذي يربط كل أرشيف tar بالإيداع وسير العمل اللذين بنياه تحديدًا. تحقّق من حزمة باستخدام:

npm audit signatures

إعداد إصدار

يرفع المشرفون إصدارات جميع حزم مساحة العمل بالتزامن باستخدام نصوص الإصدار البرمجية:

bun run release:version minor   # 1.0.0 → 1.1.0 (also: patch, major, canary, stable, x.y.z)bun run release:publish --tag latest --provenance

يعيد الأمر release:version كتابة كل ملف package.json وثوابت الإصدار التي تعكسه (VERSION و rendererVersion الخاص بآلية التوفيق)، ويرفض التشغيل عند اختلاف إصدارات الحزم، ويطبع الخيار --dry-run الخطة. يبني الأمر release:publish الحزم ويجهّزها للنشر (مع حل مراجع workspace:*)، ويطبّق publishConfig، ويرفض وضع إصدار تمهيدي على latest أو إصدار مستقر على canary، ويتخطى الإصدارات الموجودة بالفعل على npm.

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

تحرير هذه الصفحة على GitHub