Lewati ke konten

add

Shell
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:

Shell
npx blockstudio add ui/tabs

Jika namespace tidak ditentukan, CLI mencari di semua registry yang dikonfigurasi:

Shell
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:

Kode
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.

Shell
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, dengan Block "<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:

Shell
npx blockstudio add ui/hero

Tambahkan beberapa blok:

Shell
npx blockstudio add ui/tabs ui/hero ui/accordion

Pratinjau tanpa menulis:

Shell
npx blockstudio add ui/tabs --dry-run

Lewati semua prompt:

Shell
npx blockstudio add ui/tabs --yes