حزم Starter Kits في Laravel تعتمد Vite+ وتوحّد فحص الكود عبر vp check

انتقلت جميع Laravel Starter Kits إلى Vite+، لتوحيد أدوات الواجهة الأمامية في حزم React وVue وSvelte وLivewire. نُفّذ التغيير عبر laravel/maestro#60 ثم جرى تعميمه على مستودعات الحزم في اليوم نفسه، مع تثبيت vite-plus على الإصدار 0.3.0.

عملياً، لن تتضمن إعدادات الواجهة في حزم Inertia الجديدة ESLint وPrettier كأداتين منفصلتين. بدلاً من ذلك، تعتمد الحزم على CLI موحّد باسم vp ضمن Vite+.

من أوامر متعددة إلى فحص موحّد

كانت حزم Inertia تستخدم أوامر مستقلة للـ lint والتنسيق والتحقق منهما. أصبحت هذه المهام الآن متمركزة في أمرين:

{
  "scripts": {
    "build": "vp build",
    "build:ssr": "vp build && vp build --ssr",
    "dev": "vp dev",
    "check": "vp check",
    "check:fix": "vp check --fix",
    "types:check": "tsc --noEmit"
  }
}

ينفذ vp check التنسيق عبر Oxfmt، وفحص lint عبر Oxlint، والتحقق من الأنواع ضمن تمريرة واحدة. كما تغيّر مسار composer ci:check ليشغّل npm run check بدلاً من تشغيل lint:check وformat:check كل على حدة.

Vite+ عبارة عن toolchain موحّد يضم Vite وRolldown وVitest وtsdown وOxlint وOxfmt وVite Task خلف واجهة vp، ويتولى كذلك إدارة runtime ومدير الحزم المرتبطين بها.

الإعدادات انتقلت إلى vite.config.ts

أزيلت ملفات مثل eslint.config.js و.prettierrc و.prettierignore من حزم Inertia، إلى جانب مجموعة من devDependencies المرتبطة بها. وفي المقابل، أصبحت قواعد lint وformat داخل vite.config.ts عبر مفاتيح lint وfmt.

يتضمن الإعداد الجديد التعامل مع التحذيرات باعتبارها أخطاء، وتفعيل type-aware linting. كما يحافظ على إعدادات تنسيق مثل عرض السطر والمسافات والاقتباسات المفردة، إضافة إلى فرز Tailwind CSS في الدوال المحددة مثل clsx وcn وcva.

تضمنت بعض الحزم تعديلات خاصة بها:

• انتقلت حزمة React إلى @vitejs/plugin-react v6، وتشغّل React Compiler عبر @rolldown/plugin-babel.
• استبدلت حزمة Svelte الحزمة lucide-svelte بـ @lucide/svelte المدعومة.
• كان التغيير في Livewire محدوداً، لعدم وجود TypeScript فيها لفحصه، وشمل أساساً أوامر vp واستخدام lazyPlugins().

التطبيقات الجديدة التي تُنشأ عبر Starter Kits ستستخدم هذا الإعداد تلقائياً. أما المشاريع القائمة التي تعتمد Vite، فتوفّر VoidZero أمر migration للانتقال إلى Vite+، مع تنبيه بأن المشاريع المعقدة قد تحتاج إلى مراجعة وتعديلات يدوية بعد الترحيل.