استفاده از دیگ بدونِ کدنویسی

npx digdesign@latest init --yes

چی می‌بینید: یک فایلِ کوچک به اسمِ dig.json در ریشهٔ پروژه اضافه می‌شود. همین.

به چه دردتون می‌خوره: این فایل به دیگ می‌گوید فایل‌های هر کامپوننت را کجا بگذارد (مثلاً پوشهٔ کامپوننت‌های پروژهٔ شما). فقط یک‌بار، در ابتدای کار لازم است.

npx digdesign@latest add button

چی می‌بینید: یک یا چند فایلِ تازه در پروژه‌تان اضافه می‌شود (مثلاً فایلِ دکمه)؛ اگر آن کامپوننت به چیزِ دیگری نیاز داشته باشد، آن هم خودکار نصب می‌شود.

به چه دردتون می‌خوره: به‌جای این‌که کسی از صفر یک دکمه طراحی/کدنویسی کند، یک نسخهٔ آماده و هماهنگ با بقیهٔ دیزاین‌سیستم می‌گیرید.

npx digdesign@latest diff button

npx digdesign@latest update button

چی می‌بینید: اول فقط یک گزارشِ تفاوت (چه چیزی قرار است عوض شود)؛ اگر گفتید انجام بده، فایل‌هایی که خودتان دست نزده‌اید با نسخهٔ تازه بازنویسی می‌شوند.

به چه دردتون می‌خوره: طراحی/رفتارِ کامپوننت‌ها هرازگاهی بهتر می‌شود (رفعِ باگ، دسترسی‌پذیریِ بهتر)؛ این‌طور آن بهبودها را می‌گیرید بدونِ این‌که دوباره از صفر نصب کنید.

npx digdesign@latest release button

چی می‌بینید: یادداشتِ انتشارِ نسخهٔ فعلیِ رجیستری برای همان کامپوننت — بدونِ این‌که چیزی در پروژه‌تان تغییر کند.

به چه دردتون می‌خوره: قبل از تصمیم به بروزرسانی، می‌فهمید ارزشش را دارد یا نه.

npx digdesign@latest status <نام‌کامپوننت>

چی می‌بینید: یکی از سه وضعیت: فعال، منسوخ (deprecated)، یا حذف‌شده.

به چه دردتون می‌خوره: اگر منسوخ شده، بهتر است به‌مرور جایگزینش کنید تا با نسخه‌های بعدیِ دیزاین‌سیستم ناسازگار نشوید.

npx digdesign@latest migrate button --plan

npx digdesign@latest migrate button --dry-run

چی می‌بینید: فهرستی از تغییراتِ لازم؛ با dry-run حتی می‌بینید دقیقاً کدام فایل‌ها تحتِ تأثیرند، بدونِ این‌که چیزی نوشته شود.

به چه دردتون می‌خوره: بعضی بروزرسانی‌ها فقط تعویضِ فایل نیست؛ اگر جایی از کد به شکلِ قدیمیِ کامپوننت متکی بود، اینجا زودتر می‌فهمید.

npx digdesign@latest migrate button --apply

چی می‌بینید: فایل‌های لازم به‌صورتِ خودکار بازنویسی می‌شوند.

به چه دردتون می‌خوره: بروزرسانی را کامل و امن تمام می‌کند، بدونِ این‌که چیزی نصفه‌کاره بماند.

npx digdesign@latest impact <نامِ‌وابستگی>

چی می‌بینید: فهرستِ همهٔ کامپوننت‌هایی که مستقیم یا غیرمستقیم به همان وابستگی متکی‌اند.

به چه دردتون می‌خوره: جلوی یک تغییرِ کوچک را می‌گیرد که قرار بود بزرگ باشد و چند جای دیگرِ پروژه را هم خراب کند.

npx digdesign@latest health

چی می‌بینید: نرخِ پذیرش، مهاجرت‌های در انتظار، کامپوننت‌های منسوخ، و ریسکِ وابستگی — همه در یک گزارش.

به چه دردتون می‌خوره: بدونِ این‌که تک‌تکِ کامپوننت‌ها را دستی چک کنید، می‌فهمید کجای پروژه نیاز به توجه دارد.

npx digdesign@latest export-health --json > export.json

npx digdesign@latest doctor --json > doctor.json

چی می‌بینید: دو فایلِ JSON که می‌توانید محتوایشان را در داشبورد آپلود کنید.

به چه دردتون می‌خوره: داشبوردِ هوشمندی همین دو فایل را به نمودار، جدول و تاریخچهٔ قابلِ مقایسه تبدیل می‌کند — بدونِ این‌که خودتان چیزی حساب کنید.