المؤلف:
    إنشاء:2026-09-23آخر تحديث:2026-11-13

    ترقية حزم Intlayer

    bash
    npx intlayer upgrade
    

    يعرض الأمر upgrade حزم Intlayer المعرّفة في كل ملف package.json في مشروعك، بما في ذلك مساحات العمل في monorepo، ويرقّيها إلى أحدث إصدار منشور: تكاملات أطر العمل، وeslint-plugin-intlayer، وprettier-plugin-intlayer، وintlayer-editor، و@intlayer/mcp، وكل حزم @intlayer/* الأخرى. ثم يحدّث الأدوات المرتبطة بها.

    الوسيطات:

    • --project-root [projectRoot] - اختياري. دليل جذر المشروع. افتراضيًا، يبدأ الأمر من أقرب package.json أعلى دليل العمل الحالي.
    • --dry-run - اختياري. يسرد الحزم وإصدارها المستهدف دون تعديل أي ملف.
    • --tag <tag> - اختياري. npm dist-tag للترقية إليه (على سبيل المثال canary). الافتراضي هو latest.
    • --no-eslint - اختياري. لا يثبّت ولا يسجّل قواعد lint الخاصة بـ Intlayer.
    • --no-prettier - اختياري. لا يثبّت ولا يسجّل إضافة Prettier الخاصة بـ Intlayer.

    ما يقوم به:

    1. يسرد حزم Intlayer - يفحص كل package.json في المشروع (متجاوزًا node_modules ومخرجات البناء) بحثًا عن تبعيات و devDependencies الخاصة بـ intlayer و @intlayer/* و *-intlayer و intlayer-*.
    2. يجلب الإصدار المستهدف - يقرأ إصدار الـ dist-tag المحدد (افتراضيًا latest) لكل حزمة من سجل npm.
    3. يعيد كتابة النطاقات - يحدّث كل نطاق قديم في مكانه، مع الحفاظ على المعامل الخاص به (^ أو ~ أو لا شيء) ومسافات بادئة الملف.
    4. يثبت مرة واحدة - ينفذ عملية تثبيت واحدة من جذر مساحة العمل (أقرب دليل يحتوي على lock file)، باستخدام مدير الحزم المالك لملف القفل:
    ملف القفل (Lock file)الأمر
    bun.lock / bun.lockbbun install
    pnpm-lock.yamlpnpm install
    yarn.lockyarn install
    package-lock.json أو بدون قفلnpm install

    إذا لم يكن هناك ملف قفل، فسيتم استخدام حقل packageManager في package.json (على سبيل المثال "bun@1.2.0") قبل الرجوع إلى npm.

    النطاقات التي لا تشير إلى السجل، مثل workspace:* أو file: أو link: أو catalog: أو عناوين git URL، لا يتم تعديلها أبدًا.

    1. إضافات lint وPrettier - عندما يستخدم المشروع ESLint / oxlint أو Prettier، يثبّت eslint-plugin-intlayer / prettier-plugin-intlayer إن كانت مفقودة ويسجّلها: ...intlayer.configs.recommended في إعداد ESLint flat، والقواعد في .oxlintrc.json، والإضافة في إعداد Prettier (JSON أو YAML أو JavaScript أو TypeScript). إذا تعذّر تعديل الإعداد بأمان، يُعرض المقتطف لتلصقه بنفسك.
    2. خادم MCP - يوجّه إدخالات MCP من نوع stdio الخاصة بـ Intlayer في المشروع (.mcp.json، .cursor/mcp.json، .vscode/mcp.json…) إلى @intlayer/mcp@<tag>، حتى يشغّل npx الخادم المحدَّث بدلًا من نسخة مخزنة مؤقتًا.

    أمثلة:

    سرد الترقيات المتاحة دون تطبيقها:

    bash
    npx intlayer upgrade --dry-run
    

    الترقية إلى إصدار canary:

    bash
    npx intlayer upgrade --tag canary
    

    مثال للمخرجات:

    bash
    npx intlayer upgrade
    Intlayer packages:
      package.json
        intlayer ^9.0.0 → ^9.5.7
      apps/web/package.json
        next-intlayer ^9.5.7 (latest)
        vite-intlayer ~9.2.0 → ~9.5.7
    Running bun install...
    ✓ Upgraded 2 Intlayer dependencies to latest
    

    ملاحظات:

    • شغّل الأمر من جذر المستودع الخاص بك لترقية كل مساحة عمل. شغّله من مساحة عمل معينة لترقية تلك المساحة فقط.
    • الحزم التي لا يمكن جلب إصدارها (غير متصل بالإنترنت، حزمة خاصة أو غير منشورة) يتم سردها وتُترك دون تغيير.
    • إذا فشل التثبيت، فسيتم الاحتفاظ بالنطاقات التي تمت ترقيتها في package.json. شغّل أمر التثبيت الخاص بمدير الحزم يدويًا.