
Blockstudio 7.2 razširja ogrodje v dveh smereh hkrati.

Prva smer je **preglednost in potek dela** znotraj posameznega projekta: nov pregled skrbniškega vmesnika, brskalnik podatkovnih zbirk, brskalnik registra skrbniškega vmesnika in uvodne datoteke SCSS za skupno nastavitev Sass.

Druga smer je **ekosistem okrog Blockstudio**: register CLI za distribucijo blokov (kot shadcn za WordPress) in razširitev PHPStan, ki predlogam, oznakam blokov, `db.php`, `rpc.php`, `cron.php` ter povezanim datotekam sheme prinaša tipsko varnost v slogu TypeScript.

Obe smeri se osredotočata na isto: olajšati razumevanje, nadgrajevanje in deljenje večjih projektov Blockstudio.

## Skrbniški vmesnik

Dodatka olajšata krmarjenje po večjem projektu v skrbniškem vmesniku wp-admin.

### Pregled skrbniškega vmesnika

Blockstudio zdaj vključuje skrbniški zaslon v razdelku **Orodja > Blockstudio**. Omogoča pregled, kaj je sistem registriral iz datotečnega sistema, na enem mestu.

Pregled vključuje namenske zavihke za:

- Bloki
- Razširitve
- Polja
- Strani
- Sheme

Poleg tega pregleda skrbniško območje zdaj vključuje namenski razdelek **Podatkovne zbirke**. V njem so navedene vse registrirane sheme `Blockstudio\Db`, dejanske zapise pa lahko pregledate neposredno v wp-admin.

Namesto lastne mreže plošč zaslon uporablja izvorne tabele DataViews WordPress. Tako ostane UI usklajen s skrbniškim vmesnikom wp-admin, rešitev pa je uporabna tudi, ko ima projekt več deset ali sto registracij.

Pri majhni namestitvi si lahko izvajalno stanje zapomnite. Pri večji kodni zbirki to ni več mogoče. Začnete si postavljati vprašanja, kot so:

- Kateri bloki so trenutno dejansko registrirani?
- Katere razširitve ciljajo na `core/*` in katere na posamezne bloke?
- Katere strani so sinhronizirane in katerim vrstam objav pripadajo?
- Katera polja za večkratno uporabo so na voljo v tem projektu?
- Katere sheme so registrirane in katero zaledje za shranjevanje uporabljajo?

Doslej je bilo treba za odgovor prebirati mape in datoteke JSON ter slediti izvajalnemu okolju PHP. Pregled te informacije zdaj prikazuje neposredno v skrbniškem vmesniku.

Vsak zavihek je zasnovan tako, da odgovarja na drugačna vprašanja:

- **Bloki** prikazujejo registrirane vrste blokov, način upodabljanja, različico API in število atributov
- **Razširitve** prikazujejo ciljne bloke, njihovo prednostno raven in podrobnosti upodabljanja
- **Polja** omogočajo hiter pregled definicij polj po meri za večkratno uporabo
- **Strani** prikazujejo sinhronizirane strani iz datotek, skupaj z vrsto objave, stanjem, pogonom predlog in stanjem sinhronizacije
- **Sheme** prikazujejo registrirane sheme shrambe, njihovo zaledje, število polj in obseg zmogljivosti

Brskalnik zbirk podatkov je namenoma ločen od začetnega preglednega tovora. Namesto da bi ob nalaganju strani serializiral vsako vrstico, vnaprej lokalizira le razpoložljive sheme, zapise pa pridobi na zahtevo, ko odprete zavihek zbirke podatkov. Tako skrbniški vmesnik ostane uporaben tudi pri projektih z večjimi nabori podatkov za `db.php`.

Ta prva različica je namenoma osredotočena na registracije, podprte s shemami. To ni stran z nastavitvami. To je stran za pregled.

Če ga sploh ne želite, ga v celoti onemogočite:

```php
add_filter('blockstudio/admin/enabled', '__return_false');
```

### Brskalnik skrbniškega registra

Ob pregledu je še en zavihek: **Register**. Gre za brskalnik oddaljenih registrov blokov, nastavljenih v `blocks.json` vaše teme, ki vam omogoča uvoz blokov neposredno iz skrbniškega vmesnika WordPress, ne da bi se dotaknili datoteke CLI.

```json title="blocks.json"
{
  "directory": "blockstudio",
  "registries": {
    "ui": "https://blocks.example.com/registry.json",
    "private": {
      "url": "https://api.example.com/registry.json",
      "headers": {
        "Authorization": "Bearer ${REGISTRY_TOKEN}"
      }
    }
  }
}
```

Brskalnik pridobi vsak nastavljen register, prikaže vse razpoložljive bloke ter pokaže, ali so že nameščeni lokalno ali jih je mogoče uvoziti. Vsaka vrstica ima gumb »Uvozi«, ki prenese datoteke bloka v nastavljeni imenik vaše teme. Za že nameščene bloke se namesto tega prikaže gumb »Znova uvozi«.

Podprti so tudi registri z avtentikacijo prek oblike objekta z `headers`, vključno z interpolacijo `${ENV_VAR}`, tako da žetoni nikoli ne končajo v sistemu za nadzor različic.

Tako je brskanje po registrih in njihova uporaba polnopravna izkušnja v skrbniškem vmesniku, ne zgolj potek dela prek CLI.

## Register CLI

Druga polovica zgodbe o registrih je samostojen CLI: `blockstudio/registry`.

To je orodje v slogu shadcn za bloke WordPress. Brez paketa npm in brez koraka gradnje. Zaženete ukaz, izvorna koda bloka se kopira v vaš projekt in je v celoti vaša.

```bash
npx blockstudio init
npx blockstudio add ui/tabs
```

CLI deluje z vsemi vrstami blokov: bloki Blockstudio, izhod `@wordpress/create-block` in navadni bloki PHP. Registru ni mar, kaj je v mapi. Prebere manifest datotek iz `registry.json` in kopira natanko te datoteke.

Avtorji blokov objavijo `registry.json` na poljubnem URL (GitHub surova vsebina, S3 ali strežnik po meri), ki navaja razpoložljive bloke z metapodatki, odvisnostmi in seznami datotek. Uporabniki dodajo URL v svoj `blocks.json` in pridobijo bloke po imenu.

CLI podpira:

- **Razreševanje odvisnosti**: bloki lahko navedejo odvisnosti od drugih blokov, ki se samodejno razrešijo z zaznavanjem ciklov
- **Obravnava konfliktov med več registri**: ko se isto ime bloka pojavi v več registrih, vas CLI pozove, da izberete enega
- **Registri z avtentikacijo**: žetone bearer, osnovno avtentikacijo in glave po meri z interpolacijo spremenljivk okolja
- **Interaktivni TUI**: zgrajen z Ink, s kazalniki dejavnosti, pozivi za izbiro in kazalniki napredka
- **Neinteraktivni način**: zastavica `--yes` in samodejni nadomestni način za CI oziroma preusmerjene tokove
- **Iskanje in seznam**: brskanje po registrih iz ukazne vrstice

Paket vključuje teste 130, ki pokrivajo sheme, razreševanje odvisnosti, pridobivanje HTTP, zapisovanje datotek, vse poteke ukazov in interaktivni UI v Ink.

Celotna dokumentacija je na voljo na [Dokumentacija](https://blockstudio.dev/sl/registry/)/registryblockstudio.dev.

## Razširitev PHPStan

Druga velika novost je `blockstudio/phpstan`: razširitev PHPStan, ki uporabnikom Blockstudio zagotavlja varnost tipov, kakršno pričakujejo razvijalci TypeScript.

```bash
composer require --dev blockstudio/phpstan
```

Razširitev med analizo prebere dejanske sheme vašega projekta in dobljene tipe posreduje nazaj v PHPStan. Zdaj to zajema predloge PHP, Twig, Blade, oznake blokov, tipizirane zapise zbirk podatkov, poti nastavitev, imena kavljev in preverjanje shem v `block.json`, `field.json`, razširitvi JSON, `page.json`, `db.php`, `rpc.php`, `cron.php` in `blockstudio.json`.

### Predloge blokov z varnostjo tipov

Dostopi do polj na `$a` se preverjajo glede na sorodni `block.json`:

```php title="blockstudio/hero/index.php"
<?php
/** @var array<string, mixed> $a */

echo $a['title'];     // OK
echo $a['cta']['href']; // OK
echo $a['typo'];      // ERROR: Field "typo" does not exist in block.json (block: hero). Did you mean "title"?
```

### Zapisi zbirk podatkov z varnostjo tipov

`Db::get()` vrne tipiziran primerek na podlagi vaše sheme `db.php`. Oblika zapisa je sestavljena iz dejanskih polj:

```php title="db.php"
return [
  'storage' => 'table',
  'fields' => [
    'email' => ['type' => 'string', 'required' => true],
    'name'  => ['type' => 'string'],
  ],
];
```

```php
$db = Db::get('mytheme/subscribers');
$record = $db->create(['email' => 'a@b.com']);

echo $record['email']; // PHPStan: string
echo $record['name'];  // PHPStan: string|null
echo $record['typo'];  // ERROR: Offset 'typo' does not exist on array{id: int, email: string, name: string|null}
```

### Preverjanje shem

Neveljavne datoteke shem se zaznajo med analizo: `block.json`, `field.json`, razširitev JSON, `page.json`, `db.php`, `rpc.php`, `cron.php` in `blockstudio.json`. Manjkajoča imena, napačni tipi polj, nepravilno oblikovane definicije in zastarele skrajšane logične vrednosti (`"tailwind": true` namesto ugnezdenega objekta) so vse prijavljene z natančno številko vrstice v izvorni datoteki.

### Preverjanje poti nastavitev

Klici `Settings::get()` se preverjajo glede na znano shemo nastavitev:

```php
Settings::get('tailwind/enabled');  // OK, returns bool
Settings::get('tailwind/enabld');   // ERROR: Settings path "tailwind/enabld" is not a known Blockstudio setting. Did you mean "tailwind/enabled"?
```

### Preverjanje imen kavljev

Enako velja za imena kavljev filtrov in dejanj:

```php
add_filter('blockstudio/render', $cb);  // OK
add_filter('blockstudio/rendrr', $cb);  // ERROR: Unknown Blockstudio hook "blockstudio/rendrr". Did you mean "blockstudio/render"?
```

Razširitev vključuje tudi nadomestne definicije za celoten javni Blockstudio API: `Db`, `Settings`, `Field_Registry`, `Build` in globalne pomočnike. Za vse API-je Blockstudio dobite samodokončanje in preverjanje tipov, ne da bi na svojem razvojnem računalniku potrebovali izvorno kodo vtičnika.

## Pripomočki za avtorje

Izdajo dopolnjujeta dva manjša pripomočka za avtorje.

### Globalni uvodni bloki SCSS

Blockstudio je že podpiral prevajanje SCSS, vendar je ostalo eno nadležno ozko grlo: skupna nastavitev Sass.

Če ste želeli dostop do nabora skupnih spremenljivk, funkcij ali mešanic, ste jih morali uvoziti v vsako datoteko SCSS. To hitro postane ponavljajoče, zlasti pri večjih oblikovalskih sistemih ali zbirkah orodij Sass, kot je Bootstrap.

Različica 7.2 dodaja kljuko za uvodni blok, namenjeno prav temu:

```php
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
  return '@import "functions";' . "\n"
    . '@import "variables";' . "\n"
    . '@import "mixins";';
}, 10, 3);
```

V kombinaciji z obstoječim filtrom `blockstudio/assets/process/scss/import_paths` enkrat določite skupno površino Sass, ki je nato na voljo vsem prevedenim datotekam.

Slogovna datoteka bloka se lahko osredotoča na sloge, ki jih dejansko potrebuje:

```scss title="style.scss"
.hero {
  @include media-breakpoint-up(lg) {
    padding: 4rem;
  }
}
```

Brez ponavljajočih se uvozov v vseh datotekah sredstev blokov. To ni »podpora za Bootstrap« kot poseben način. Gre za splošno kljuko za skupni Sass v projektu, ne glede na to, ali prihaja iz Bootstrap ali vašega lastnega internega nabora orodij.

### Definicije blokov, izvorno za PHP API

Različica 7.2 dodaja tudi izbirno sintakso, izvorno za PHP, za API-je blokov za celoten sklad. Polja ostajajo privzeta in v celoti podprta. Nič ni bilo zamenjano. Če pa imate raje poimenovane argumente, naštete vrednosti in atribute kot ugnezdena polja nastavitev, se zdaj lahko odločite za ta slog.

Za `rpc.php` vrnite objekt z metodami, opremljenimi z atributi:

```php title="rpc.php"
<?php
use Blockstudio\Attributes\Rpc;
use Blockstudio\Rpc\Access;
use Blockstudio\Rpc\Method;

return new class {
    #[Rpc(access: Access::Session)]
    public function subscribe(array $params): array {
        return ['success' => true];
    }

    #[Rpc(name: 'status', methods: [Method::Get, Method::Post])]
    public function getStatus(array $params): array {
        return ['status' => 'ok'];
    }
};
```

Za `cron.php` enaka zamisel deluje z `#[Cron]`:

```php title="cron.php"
<?php
use Blockstudio\Attributes\Cron;
use Blockstudio\Cron\Schedule;

return new class {
    #[Cron(schedule: Schedule::Hourly)]
    public function heartbeat(): void {
    }
};
```

Za `db.php` je zdaj na voljo tudi preprosta plast za sestavljanje:

```php title="db.php"
<?php
use Blockstudio\Db\Field;
use Blockstudio\Db\Schema;
use Blockstudio\Db\Storage;

return Schema::make(
    storage: Storage::Table,
    fields: [
        'email' => Field::string(required: true, format: 'email'),
        'active' => Field::boolean(default: false),
    ],
);
```

To zagotavlja boljše ravnovesje za večje kodne zbirke. Po želji ohranite preprostost oblike polj, ko pa blok preraste nekaj polj ali končnih točk, lahko preklopite na bolj pregledno površino PHP.

## Zakaj so te novosti izdane skupaj

Skrbniški pregled, brskalnik registrov, register CLI in razširitev PHPStan so odgovori na isto vprašanje: kako ohraniti razumljivost projekta Blockstudio, ko raste?

Skrbniška orodja odgovarjajo na ravni projekta: pregled nad tem, kaj je registrirano, možnost pridobivanja blokov iz registrov in manj ugibanja.

CLI odgovarja na ravni ekosistema: omogoča skupno rabo blokov med projekti in ekipami, ne da bi jih združevali v pakete npm ali se borili s sistemi za gradnjo.

Razširitev PHPStan odgovarja na ravni kode: napačne dostope do polj, tipkarske napake v shemah in pokvarjene povratne klice kavljev zazna, še preden pridejo do izvajanja.

To je splošna usmeritev različice 7.2: manj ugibanja, manj ponavljanja, boljši pregled in zdaj tudi prava varnost tipov.

## Popravki napak

- **Polje »Classes«**: uporabniško vnesena imena razredov so bila ob izgubi fokusa tiho zavržena, ker je validator sprejemal le razrede s seznama Tailwind/nastavitev. Zdaj sprejme vsak neprazen niz.
- **Polje »Attributes«**: odstranitev para atributov je v shranjenih podatkih pustila vnose `null`. lodash `unset()` (ki elemente polja nastavi na null) smo zamenjali z `splice()` (ki jih odstrani).
- **Minifikator CSS**: minifikator TailwindPHP je odstranil presledke okoli `+` znotraj `calc()` in `clamp()`, zaradi česar je nastal neveljaven CSS, kot je `calc(1rem+0.5vw)`. Napaka je bila odpravljena v izvorni kodi TailwindPHP v1.3.1 z obhodom znakov, ki upošteva globino in odstrani le presledke okoli kombinatorjev izbirnikov pri globini oklepajev 0.
- **Predogled vstavljalnika blokov**: `$isPreview` je bil v predogledu vstavljalnika blokov vedno `false`, ker predpomnilniški ključ zgoščene vrednosti za upodabljanje ni vključeval načina upodabljanja. Upodobitve v urejevalniku in predogledu imajo zdaj ločene vnose v predpomnilniku.
- **Ugnezdena predloga InnerBlocks**: komponenta `<InnerBlocks template="..."/>` je iz trojčkov predlog, kot je `['core/group', {}, [['core/paragraph']]]`, izpustila tretji element (otroke), zaradi česar so nastali prazni bloki vsebnikov. Zdaj ohranja ugnezdene otroke.
