add
npx blockstudio add <blocks...> [options]
Pobiera bloki z rejestru i zapisuje je w katalogu bloków projektu.
Argumenty
| Argument | Opis |
|---|---|
blocks |
Jeden lub więcej bloków do dodania. Format: namespace/block lub samo block. |
Opcje
| Opcja | Opis |
|---|---|
-y, --yes |
Pomija wszystkie monity (nadpisywanie, rozwiązywanie konfliktów). |
--dry-run |
Wyświetla podgląd instalacji bez zapisywania plików. |
Rozpoznawanie przestrzeni nazw
Po podaniu przestrzeni nazw CLI szuka w określonym rejestrze:
npx blockstudio add ui/tabs
Jeśli nie podasz przestrzeni nazw, CLI przeszukuje wszystkie skonfigurowane rejestry:
npx blockstudio add tabs
Jeśli blok znajduje się dokładnie w jednym rejestrze, zostaje użyty automatycznie. Jeśli znajduje się w kilku, CLI wyświetla interaktywny monit wyboru.
Z opcją --yes używany jest pierwszy pasujący rejestr w kolejności blocks.json.
Bez terminala i z opcją --dry-run niejednoznaczna nazwa powoduje przerwanie polecenia z błędem zawierającym listę rejestrów:
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
Przed rozpoznaniem dowolnego bloku add pobiera dane ze wszystkich skonfigurowanych rejestrów. Jeśli któryś jest niedostępny lub nieprawidłowy, polecenie kończy się błędem, nawet gdy blok ma jawną przestrzeń nazw.
Zależności
Bloki mogą deklarować zależności od innych bloków w tym samym rejestrze. Po dodaniu bloku jego zależności są automatycznie rozpoznawane i instalowane.
npx blockstudio add ui/tabs
Jeśli tabs zależy od tab-item, oba bloki zostaną pobrane i zainstalowane. Zależności są zawsze instalowane przed blokami, które od nich zależą.
Wykryte zależności cykliczne powodują błąd i przerwanie polecenia.
Zasady nadpisywania
Jeśli folder bloku już istnieje w katalogu docelowym:
- Tryb interaktywny: prosi o potwierdzenie nadpisania
- Flaga
--yes: nadpisuje bez pytania - Flaga
--dry-run: informuje, co zostałoby nadpisane - Tryb nieinteraktywny bez
--yes: przerywa działanie przed pobieraniem, z komunikatemBlock "<name>" already exists at <path>. Use --yes to overwrite.
Kontrola obejmuje też zależności, więc dodanie tabs, gdy tab-item jest już zainstalowany, wymaga opcji --yes.
Wiele bloków
Bloki podane w jednym poleceniu są przetwarzane po kolei. Jeśli któryś z nich spowoduje błąd, polecenie zatrzymuje się w tym miejscu, a bloki zainstalowane wcześniej w ramach tego samego uruchomienia pozostają na dysku.
Przykłady
Dodaj jeden blok:
npx blockstudio add ui/hero
Dodaj wiele bloków:
npx blockstudio add ui/tabs ui/hero ui/accordion
Wyświetl podgląd bez zapisywania:
npx blockstudio add ui/tabs --dry-run
Pomiń wszystkie monity:
npx blockstudio add ui/tabs --yes