
A Blockstudio 7.2 két irányban is bővíti a keretrendszert.

Az első a **láthatóság és a munkafolyamat** egyetlen projekten belül: új adminisztrációs áttekintés, adatbázis-böngésző, adminisztrációs nyilvántartás-böngésző és SCSS előbeállítások a megosztott Sass beállításához.

A második a **Blockstudio körüli ökoszisztéma**: egy blokkok terjesztésére szolgáló nyilvántartás-CLI (a shadcn mintájára, WordPress-hez), valamint egy PHPStan kiterjesztés, amely TypeScript-szerű típusbiztonságot biztosít a sablonokhoz, blokkcímkékhez, `db.php`, `rpc.php`, `cron.php` és a kapcsolódó sém fájlokhoz.

Mindkét irány ugyanazt a célt szolgálja: megkönnyíteni a nagyobb Blockstudio projektek átlátását, továbbfejlesztését és megosztását.

## Adminisztrációs felület

Két újdonság könnyíti meg a nagyobb projektek áttekintését a wp-adminon belül.

### Adminisztrációs áttekintés

A Blockstudio mostantól a **Eszközök > Blockstudio** alatt adminisztrációs képernyőt biztosít. Egyetlen helyen tekintheti meg, mit regisztrált a rendszer a fájlrendszerből.

Az áttekintés külön lapokat tartalmaz a következőkhöz:

- Blokkok
- Kiterjesztések
- Mezők
- Oldalak
- Sémák

Az áttekintés mellett az adminisztrációs felület egy külön **Adatbázisok** részt is kapott. Itt minden regisztrált `Blockstudio\Db` séma listázható, és a tényleges rekordok közvetlenül a wp-adminban tekinthetők meg.

Egyéni panelrács helyett a képernyő natív WordPress DataViews táblázatokat használ. Így az UI összhangban marad a wp-adminnal, és több tucat vagy akár több száz regisztráció esetén is praktikus.

Kisebb telepítésnél fejben tarthatja a rendszer aktuális állapotát. Egy nagyobb kódbázisnál ez már nem működik. Ilyenkor ilyen kérdések merülnek fel:

- Jelenleg mely blokkok vannak ténylegesen regisztrálva?
- Mely kiterjesztések vonatkoznak a `core/*` egészére, és melyek egyes blokkokra?
- Mely oldalak vannak szinkronizálva, és melyik bejegyzéstípushoz tartoznak?
- Milyen újrafelhasználható mezők vannak a projektben?
- Mely sémák vannak regisztrálva, és milyen tárolási hátteret használnak?

Eddig erre csak mappák átnézésével, JSON fájlok megnyitásával és a PHP lépéseinek követésével lehetett választ kapni. Az áttekintés mindezt tényleges adminisztrációs felületté alakítja.

Az egyes lapok különböző kérdések megválaszolására szolgálnak:

- **Blokkok**: a regisztrált blokktípusok, megjelenítési mód, a API verziója és az attribútumok száma
- **Kiterjesztések**: a célzott blokkok, a prioritás és a megjelenítési részletek
- **Mezők**: az újrafelhasználható egyéni meződefiníciók gyors áttekintése
- **Oldalak**: a fájlalapú, szinkronizált oldalak bejegyzéstípussal, állapottal, sablonmotorral és szinkronizálási állapottal
- **Sémák**: a regisztrált tárolási sémák háttere, mezőinek száma és jogosultsági köre

Az adatbázis-böngésző szándékosan különálló az áttekintés kezdeti adatcsomagjától. Az oldal betöltésekor nem szerializál minden sort: először csak az elérhető sémákat tölti be, a rekordokat pedig igény szerint kéri le, amikor megnyit egy adatbázisfület. Így az adminfelület nagyobb adathalmazokkal rendelkező projektek esetén is használható marad a `db.php` mögött.

Ez az első verzió szándékosan a sémára épülő regisztrációkra összpontosít. Ez nem beállítási oldal, hanem ellenőrző oldal.

Ha egyáltalán nincs rá szüksége, teljesen letilthatja:

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

### Adminisztrációs regisztrációs böngésző

Az áttekintés mellett egy második fül is található: **Registry**. Ez a téma `blocks.json` fájljában beállított távoli blokkregiszterek böngészője, amely lehetővé teszi, hogy közvetlenül az WordPress adminfelületéről importáljon blokkokat egy CLI érintése nélkül.

```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}"
      }
    }
  }
}
```

A böngésző lekéri az összes beállított regisztert, felsorolja az elérhető blokkokat, és jelzi, hogy azok már telepítve vannak-e helyben, vagy importálhatók. Minden sorban található egy Import gomb, amely letölti a blokkfájlokat a téma beállított könyvtárába. A már telepített blokkoknál ehelyett Újraimportálás gomb jelenik meg.

A hitelesített regiszterek is támogatottak a `headers` mezőt tartalmazó objektumformátummal, beleértve a `${ENV_VAR}` behelyettesítését is, így a tokenek sosem kerülnek verziókezelésbe.

Így a regiszterek böngészése és használata az adminfelület szerves részévé válik, nem csupán egy CLI munkafolyamat.

## Registry CLI

A regiszterek másik fontos eleme az önálló CLI: `blockstudio/registry`.

Ez egy shadcn-stílusú eszköz WordPress blokkokhoz. Nincs szükség npm csomagra vagy buildlépésre. Futtat egy parancsot, a blokk forráskódja bemásolódik a projektjébe, és teljes egészében az Öné lesz.

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

A CLI bármilyen blokktípussal működik: Blockstudio blokkokkal, `@wordpress/create-block` kimenettel és egyszerű PHP blokkokkal. A regisztert nem érdekli, mi van a mappában. Beolvassa a fájlmanifestet innen: `registry.json`, és pontosan azokat a fájlokat másolja át.

A blokk szerzői bármely URL helyen közzétehetnek egy `registry.json`-t (GitHub nyers tartalmat, S3-t vagy egy egyéni szervert), amely metaadatokkal, függőségekkel és fájllistákkal együtt felsorolja az elérhető blokkokat. A felhasználók hozzáadják a URL-t a `blocks.json`-jukhoz, majd név alapján letöltik a blokkokat.

A CLI a következőket támogatja:

- **Függőségek feloldása**: a blokkok más blokkoktól való függőségeket adhatnak meg, amelyeket a rendszer automatikusan old fel, a körkörös függőségek felismerésével
- **Több regiszter közötti ütközések kezelése**: ha ugyanaz a blokknév több regiszterben is megtalálható, a CLI felszólítja, hogy válasszon egyet
- **Hitelesített regiszterek**: bearer tokenek, alapvető hitelesítés és egyéni fejlécek környezeti változók behelyettesítésével
- **Interaktív TUI**: Ink használatával készült, pörgő jelzőkkel, választási lehetőségekkel és folyamatjelzőkkel
- **Nem interaktív mód**: `--yes` jelző és automatikus tartalékmegoldás CI vagy csővezeték esetén
- **Keresés és listázás**: regiszterek böngészése parancssorból

A csomag 130 tesztet tartalmaz a sémák, a függőségek feloldása, a HTTP lekérése, a fájlírás, az összes parancsfolyamat és az interaktív Ink UI ellenőrzésére.

A teljes dokumentáció itt található: [blockstudio.dev/registry](https://blockstudio.dev/hu/registry/).

## PHPStan-bővítmény

A másik nagy újdonság a `blockstudio/phpstan`: egy PHPStan-bővítmény, amely a Blockstudio felhasználóinak azt a típusbiztonságot nyújtja, amelyet a TypeScript fejlesztői elvárnak.

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

A bővítmény elemzéskor beolvassa a projekt tényleges sémáit, és az így kapott típusokat visszaadja a PHPStan számára. Ez már lefedi a PHP sablonokat, a Twig-t, a Blade-t, a blokkcímkéket, a típusos adatbázis-rekordokat, a beállítási útvonalakat, a hookneveket, valamint a sémaellenőrzést a következőkben: `block.json`, `field.json`, bővítmény-JSON, `page.json`, `db.php`, `rpc.php`, `cron.php` és `blockstudio.json`.

### Típusbiztos blokksablonok

A `$a` mezőeléréseit a kapcsolódó `block.json` alapján ellenőrzi a rendszer:

```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"?
```

### Típusbiztos adatbázis-rekordok

A `Db::get()` a `db.php` séma alapján típusos példányt ad vissza. A rekord szerkezete a tényleges mezőkből épül fel:

```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}
```

### Sémaellenőrzés

Az érvénytelen sémafájlokat már elemzéskor felismeri a rendszer: `block.json`, `field.json`, bővítmény-JSON, `page.json`, `db.php`, `rpc.php`, `cron.php` és `blockstudio.json`. A rendszer jelzi a hiányzó neveket, a hibás mezőtípusokat, a rosszul formázott definíciókat és az elavult rövid logikai értékeket (`"tailwind": true` a beágyazott objektum helyett), mindig megadva a forrásfájl pontos sorszámát.

### Beállítási útvonalak ellenőrzése

A `Settings::get()` hívásokat a rendszer az ismert beállítási séma alapján ellenőrzi:

```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"?
```

### Hooknevek ellenőrzése

Ugyanez vonatkozik a filter- és action-hookok nevére is:

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

A bővítmény a teljes Blockstudio nyilvános API-jához is biztosít stubokat: `Db`, `Settings`, `Field_Registry`, `Build` és globális segédfüggvények. Minden Blockstudio API-hoz kap automatikus kiegészítést és típusellenőrzést anélkül, hogy a fejlesztői gépén szükség lenne a bővítmény forráskódjára.

## Kényelmesebb fejlesztés

A kiadást két kisebb, fejlesztést megkönnyítő újdonság teszi teljessé.

### Globális SCSS előtöltések

A Blockstudio már támogatta a SCSS fordítását, de volt egy bosszantó akadály: a megosztott Sass beállítása.

Ha hozzá akart férni egy közös változó-, függvény- vagy mixinkészlethez, minden SCSS fájlba importálnia kellett őket. Ez hamar ismétlődővé válik, különösen nagyobb dizájnrendszerek vagy olyan Sass eszközkészletek esetén, mint a Bootstrap.

A 7.2 pontosan erre ad egy előtöltési hookot:

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

A meglévő `blockstudio/assets/process/scss/import_paths` szűrővel együtt egyszer definiálhat egy megosztott Sass felületet, amely minden lefordított fájlban elérhető.

Így a blokk stíluslapja a ténylegesen szükséges stílusokra összpontosíthat:

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

Nem kell minden blokk erőforrásában újra importálni. Ez nem különleges módú „Bootstrap-támogatás”, hanem egy általános hook a projekt egészében megosztott Sass használatához, akár Bootstrap biztosítja, akár a saját belső eszközkészlete.

### PHP-natív blokk-API-definíciók

A 7.2 egy opcionális, PHP-natív szintaxist is bevezet a teljes stacket lefedő blokk-API-khoz. A tömbök továbbra is az alapértelmezett és teljes mértékben támogatott formátumot jelentik. Semmit sem váltottunk le. Ha viszont a beágyazott konfigurációs tömbök helyett inkább elnevezett argumentumokat, enumokat és attribútumokat használna, mostantól ezt a stílust is választhatja.

A `rpc.php` esetében attribútumokkal ellátott metódusokat tartalmazó objektumot adjon vissza:

```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'];
    }
};
```

A `cron.php` esetében ugyanez a megközelítés a `#[Cron]` használatával működik:

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

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

A `db.php` esetében mostantól egy egyszerű builderréteg is rendelkezésre áll:

```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),
    ],
);
```

Ez jobb egyensúlyt teremt a nagyobb kódbázisokban. Ha szeretné, megtarthatja a tömbformátum egyszerűségét, de választhat egy könnyebben felfedezhető PHP felületet is, amikor egy blokk néhány mezőnél vagy végpontnál összetettebbé válik.

## Miért jelentek meg együtt ezek az újdonságok?

Az adminisztrációs áttekintés, a regiszterböngésző, a regiszter-CLI és a PHPStan-bővítmény ugyanarra a kérdésre ad választ: hogyan tartható áttekinthető egy Blockstudio projekt, miközben növekszik?

Az adminisztrációs eszközök projektszinten segítenek: láthatóvá teszik, mi van regisztrálva, lehetővé teszik blokkok importálását a regiszterekből, és csökkentik a találgatást.

A CLI ökoszisztéma-szinten ad választ: lehetővé teszi a blokkok projektek és csapatok közötti megosztását anélkül, hogy npm csomagokba kellene őket foglalni, vagy a buildrendszerekkel kellene küzdeni.

A PHPStan-bővítmény kódszinten segít: már futás előtt felismeri a hibás mezőeléréseket, a sémák elgépeléseit és a hibás hook-visszahívásokat.

Általánosságban ez a 7.2 iránya: kevesebb találgatás és ismétlődés, jobb átláthatóság, valamint most már tényleges típusbiztonság.

## Hibajavítások

- **Classes mező**: a felhasználó által megadott egyéni osztálynevek elmosáskor észrevétlenül elvesztek, mert az ellenőrző csak az előre meghatározott Tailwind/beállításlistából fogadott el osztályokat. Mostantól bármilyen nem üres karakterláncot elfogad.
- **Attributes mező**: egy attribútumpár eltávolításakor `null` bejegyzések maradtak a mentett adatokban. A lodash `unset()` helyett `splice()` használatára tértünk át, amely eltávolítja az elemeket a tömbből.
- **CSS minifier**: a TailwindPHP minifier eltávolította a szóközöket a `+` körül a `calc()` és `clamp()` elemekben, így érvénytelen CSS keletkezett, például `calc(1rem+0.5vw)`. A hibát a TailwindPHP v1.3.1 javította: mélységérzékeny karakterbejárással csak a 0 zárójelmélységen lévő szelektorkombinátorok körüli szóközöket távolítja el.
- **Blokkbeszúró előnézete**: a `$isPreview` mindig `false` volt a Blokkbeszúró előnézetében, mert a renderelési gyorsítótár kulcsának hash-e nem tartalmazta a renderelési módot. A szerkesztő és az előnézet renderelése most külön gyorsítótár-bejegyzéseket kap.
- **Beágyazott InnerBlocks-sablon**: a `<InnerBlocks template="..."/>` komponens elhagyta a sablon-tuple-ök 3. elemét (a gyermekeket), például a `['core/group', {}, [['core/paragraph']]]` esetében, így üres tárolóblokkok jöttek létre. Mostantól megőrzi a beágyazott gyermekeket.
