CLI

@akhatmirzo/cli ikki ishni avtomatlashtiradi: kutubxonani loyihaga ulaydi (init) va tayyor bloklarni — kirish formasi, narxlar, dashboard — to'g'ridan-to'g'ri kodingizga ko'chiradi (add). Bloklar paket ichida emas, sizning faylingizda bo'ladi: xohlaganingizcha o'zgartiring.

O'rnatish shart emas — npx (yoki pnpm dlx, yarn dlx, bunx) orqali ishga tushiring:

npx @akhatmirzo/cli init              # paketlar + CSS sozlamasi
npx @akhatmirzo/cli list              # mavjud bloklar
npx @akhatmirzo/cli add login pricing # bloklarni loyihaga ko'chirish

Talablar: Node.js 18.17+. CLI'ning o'zi hech qanday bog'liqliksiz — faqat Node'ning ichki modullari.

initBo'lim havolasini nusxalash

Loyiha papkasida (package.json yonida) ishga tushiring:

npx @akhatmirzo/cli init

Nima qiladi:

1. Tailwind CSS v4 borligini tekshiradi (package.jsondagi tailwindcss). Yo'q yoki v3 bo'lsa — ogohlantiradi, lekin to'xtamaydi.
2. Paket menejerini aniqlaydi — lockfile bo'yicha (pnpm-lock.yaml, package-lock.json, yarn.lock, bun.lockb/bun.lock; monorepoda yuqori papkalar ham qaraladi). Lockfile bo'lmasa — CLI qaysi menejer orqali chaqirilgan bo'lsa o'sha, aks holda npm.
3. @akhatmirzo/ui va @akhatmirzo/tokens ni o'rnatadi (allaqachon bo'lsa — o'tkazib yuboradi).
4. Global CSS faylni topadi: app/globals.css, src/app/globals.css, src/index.css, src/styles/globals.css, styles/globals.css va boshqalar. Topilmasa — so'raydi (yoki --css).
5. CSS'ga ikki qator qo'shadi — Tailwind importidan keyin tokenlar va importlardan keyin @source:

@import 'tailwindcss';
@import '@akhatmirzo/tokens/theme.css'; /* qo'shildi */
@source '../../node_modules/@akhatmirzo/ui/dist'; /* qo'shildi */

@source yo'li CSS fayldan node_modules gacha nisbiy hisoblanadi. Qatorlar allaqachon bo'lsa qayta qo'shilmaydi — init ni bir necha marta ishga tushirish xavfsiz.

Shundan so'ng ilova ildiziga provayderlarni qo'ying — O'rnatish sahifasiga qarang.

addBo'lim havolasini nusxalash

npx @akhatmirzo/cli add login
npx @akhatmirzo/cli add login pricing --dir src/components/blocks

• Har bir blok registry'dan yuklanadi va --dir papkasiga (standart: components/blocks) yoziladi.
• Avval hamma bloklar yuklanib tekshiriladi — biror xato bo'lsa, hech narsa yozilmaydi.
• Fayl allaqachon bor bo'lsa — so'raydi. --overwrite — savolsiz ustidan yozadi. --yes mavjud fayllarni o'zgartirmaydi (o'tkazib yuboradi): kodingiz tasodifan yo'qolmasin.
• Blokka qo'shimcha paketlar kerak bo'lsa (react-hook-form, zod, recharts ...) va ular package.jsonda bo'lmasa — o'rnatishni taklif qiladi.

listBo'lim havolasini nusxalash

npx @akhatmirzo/cli list

Bloklarni kategoriya bo'yicha nomi va tavsifi bilan chiqaradi. Bloklarni ko'rish — Bloklar bo'limida.

ParametrlarBo'lim havolasini nusxalash

CI kabi interaktiv bo'lmagan muhitda savol berilmaydi: init uchun --yes majburiy, add esa yangi fayllarni yozadi, mavjudlarini o'tkazib yuboradi va paketlarni o'rnatmaydi (o'rnatish buyrug'ini ko'rsatadi). Ranglar faqat terminalda va NO_COLOR o'rnatilmagan bo'lsa chiqadi.

Registry va oflayn ishlashBo'lim havolasini nusxalash

Registry — oddiy JSON fayllar: <registry>/index.json (ro'yxat) va <registry>/<nom>.json:

{
  "name": "login",
  "title": { "uz": "Kirish", "en": "Login" },
  "description": { "uz": "...", "en": "..." },
  "category": "auth",
  "dependencies": ["react-hook-form", "zod"],
  "files": [{ "path": "login.tsx", "content": "..." }]
}

--registry (yoki AKHATMIRZO_REGISTRY muhit o'zgaruvchisi) bilan boshqa manzil bering — o'z serveringiz, file:// URL yoki oddiy lokal papka:

npx @akhatmirzo/cli add login --registry ./registry
npx @akhatmirzo/cli list --registry https://example.com/r