‏Nuxt CLI نسخهٔ ۴ منتشر شد

Nuxt CLI v4.0.0 همراه با Nuxt 4.6 منتشر شده و تیم Nuxt می‌گه با بیش از ۲۰۰ commit از نسخهٔ 3.37 تقریباً همهٔ issueهای باز رو حل کرده. تمرکز اصلی روی nuxt dev بوده: اینکه چقدر سریع بالا میاد، چه اطلاعاتی نشون می‌ده و وقتی چیزی خراب می‌شه چه اتفاقی می‌افته.

خطاهای زمان توسعه حالا به‌جای youch با ابزار جدید my-bad نمایش داده می‌شن. وقتی یه صفحه رندر نمی‌شه، یه overlay کوچیک گوشهٔ صفحه میاد که کد خطادار خودت رو (با source map، یعنی نگاشت به فایل اصلی)، call stack، trace کامپوننت‌های Vue و لاگ‌های سرور رو نشون می‌ده. یه دکمهٔ Copy error هم داره که حتی یه پرامپت آماده برای agent می‌سازه.

CLI یه error channel هم داره که بیرون از Nuxt زنده می‌مونه، پس اگه nuxt.config خطای syntax داشته باشه هم توی مرورگر صفحهٔ خطای درست می‌بینی که بعد از رفع خودش reload می‌شه. برای overlay کامل، Nuxt 4.6 لازمه.

تو ترمینال تعاملی، nuxt dev حالا یه پنل پایین صفحه داره با URLها، پیشرفت راه‌اندازی و یه ردیف میانبر: مثلاً r برای restart، o برای باز کردن مرورگر، n برای دیدن درخواست‌ها و e برای پریدن به آخرین خطا. هر درخواست یه id می‌گیره تا لاگ‌ها به درخواست مربوط وصل بشن و با enter می‌شه timeline کامل یه درخواست رو دید. سرور حالا می‌گه چرا reload یا restart شده. اگه این پنل رو نمی‌خوای، --no-tui یا NUXT_TUI=plain خروجی قدیمی رو برمی‌گردونه.

از نظر حجم، @nuxt/cli از ۷۰ پکیج به ۳۱ و از ۱۳.۱ به ۳.۵ مگابایت رسیده و nuxi سراسری از ۶ به ۰.۸ مگابایت. خیلی از وابستگی‌ها با ماژول‌های داخلی Node جایگزین شدن، مثلاً ofetch جاش رو به fetch بومی داده. طبق بنچمارک خودشون، اولین رندر پنل ۶.۶ برابر سریع‌تر شده (۳۳۰ به ۵۰ میلی‌ثانیه)، اولین صفحه ۱۹٪ زودتر سرو می‌شه و مصرف حافظه روی لینوکس از ۶۳۰ به ۴۴۰ مگابایت رسیده.

برای agentها هم فکر شده: سرور در حال اجرا خودش رو توی یه lock file داخل .nuxt/ ثبت می‌کنه. یعنی یه nuxt dev دوم سر پورت دعوا نمی‌کنه؛ یا سرور قبلی رو گزارش می‌ده یا (با --takeover) کنترلش رو می‌گیره. دو دستور جدید nuxt curl و nuxt task هم بدون دونستن پورت با سرور حرف می‌زنن. nuxt docs هم مستندات مخصوص نسخهٔ Nuxt پروژه‌ت رو از ترمینال جستجو می‌کنه.

تغییرات ناسازگار: حداقل Node.js 22.21 (یا 24.11+ یا 26+) لازمه، Nuxt 2 و @nuxt/bridge دیگه پشتیبانی نمی‌شن و nuxt init از CLI جدا شده و باید از npm create nuxt@latest استفاده کرد. راه گرفتن v4 هم ارتقا به Nuxt 4.6 هست، چون پروژه همون نسخه‌ای از CLI رو اجرا می‌کنه که nuxt بهش وابسته‌ست.

نکات کلیدی:

• Nuxt CLI 4.0.0 همراه Nuxt 4.6 اومده و با npx nuxt upgrade --dedupe نصب می‌شه.
• حجم @nuxt/cli از ۱۳.۱ به ۳.۵ مگابایت و تعداد وابستگی‌ها از ۷۰ به ۳۱ رسیده.
• خطاهای زمان توسعه با my-bad به‌جای youch نمایش داده می‌شن.
• nuxt dev توی ترمینال تعاملی یه پنل با میانبرها داره که با --no-tui خاموش می‌شه.
• حداقل Node.js 22.21 لازمه و Nuxt 2 و @nuxt/bridge حذف شدن.