add
npx blockstudio add <blocks...> [options]
Mengunduh blok dari registry dan menyimpannya ke direktori blok proyek Anda.
Argumen
| Argumen | Deskripsi |
|---|---|
blocks |
Satu atau beberapa blok untuk ditambahkan. Format: namespace/block atau cukup block. |
Opsi
| Opsi | Deskripsi |
|---|---|
-y, --yes |
Lewati semua prompt (penimpaan, penyelesaian konflik). |
--dry-run |
Pratinjau yang akan diinstal tanpa menulis file. |
Resolusi namespace
Saat Anda menentukan namespace, CLI mencari di registry tersebut:
npx blockstudio add ui/tabs
Jika namespace tidak ditentukan, CLI mencari di semua registry yang dikonfigurasi:
npx blockstudio add tabs
Jika blok ditemukan tepat di satu registry, blok itu digunakan secara otomatis. Jika ditemukan di beberapa registry, CLI menampilkan prompt pilihan interaktif.
Dengan --yes, registry pertama yang cocok dalam urutan blocks.json akan digunakan.
Tanpa terminal, dan dengan --dry-run, nama yang ambigu akan menghentikan perintah dengan error yang mencantumkan registry terkait:
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
Sebelum menyelesaikan resolusi blok apa pun, add mengambil data dari setiap registry yang dikonfigurasi. Jika salah satunya tidak dapat dijangkau atau tidak valid, perintah gagal, termasuk untuk blok dengan namespace eksplisit.
Dependensi
Blok dapat menyatakan dependensi pada blok lain di registry yang sama. Saat Anda menambahkan blok, dependensinya akan dicari dan diinstal secara otomatis.
npx blockstudio add ui/tabs
Jika tabs bergantung pada tab-item, kedua blok akan diunduh dan diinstal.
Dependensi selalu diinstal sebelum blok yang bergantung padanya.
Dependensi melingkar akan dideteksi dan ditolak dengan error.
Perilaku penimpaan
Jika folder blok sudah ada di direktori tujuan:
- Mode interaktif: meminta konfirmasi sebelum menimpa
- Flag
--yes: menimpa tanpa bertanya - Flag
--dry-run: menampilkan apa yang akan ditimpa - Mode noninteraktif tanpa
--yes: berhenti sebelum mengunduh, denganBlock "<name>" already exists at <path>. Use --yes to overwrite.
Pemeriksaan ini juga mencakup dependensi, jadi menambahkan tabs saat tab-item sudah diinstal memerlukan --yes.
Beberapa blok
Blok yang diberikan dalam satu perintah diproses secara berurutan. Jika salah satunya gagal, perintah berhenti di situ, dan blok yang sudah diinstal sebelumnya dalam proses yang sama tetap tersimpan di disk.
Contoh
Tambahkan satu blok:
npx blockstudio add ui/hero
Tambahkan beberapa blok:
npx blockstudio add ui/tabs ui/hero ui/accordion
Pratinjau tanpa menulis:
npx blockstudio add ui/tabs --dry-run
Lewati semua prompt:
npx blockstudio add ui/tabs --yes