
Blockstudio 7.2 vienu metu plečia sistemą dviem kryptimis.

Pirmoji kryptis – **matomumas ir darbo eiga** viename projekte: nauja administravimo apžvalga, duomenų bazės naršyklė, administravimo registro naršyklė ir SCSS pradiniai bendros Sass sąrankos nustatymai.

Antroji kryptis – **ekosistema aplink Blockstudio**: registras CLI blokams platinti (panašiai kaip shadcn, skirtas WordPress) ir plėtinys PHPStan, suteikiantis šablonams, blokų žymoms, `db.php`, `rpc.php`, `cron.php` ir susijusiems schemų failams TypeScript stiliaus tipų saugą.

Abi kryptys siekia to paties: padaryti didesnius Blockstudio projektus lengviau suprantamus, plečiamus ir bendrinamus.

## Administravimo patirtis

Du nauji elementai palengvina naršymą didesniame projekte wp-admin aplinkoje.

### Administratoriaus apžvalga

Blockstudio dabar pateikiamas su administratoriaus ekranu, pasiekiamu per **Tools > Blockstudio**. Vienoje vietoje galite patikrinti, ką sistema užregistravo iš failų sistemos.

Apžvalgoje yra atskiri skirtukai:

- Blokai
- Plėtiniai
- Laukai
- Puslapiai
- Schemos

Kartu su apžvalga administravimo srityje dabar yra atskira skiltis **Duomenų bazės**. Joje pateikiamos visos registruotos `Blockstudio\Db` schemos, o tikrus įrašus galima peržiūrėti tiesiogiai wp-admin aplinkoje.

Užuot kūręs pasirinktinį skydelių tinklelį, ekranas naudoja įprastas WordPress DataViews lenteles. Taip UI išlieka suderinta su wp-admin, o sprendimas praktiškas net tada, kai projekte yra dešimtys ar šimtai registracijų.

Nedideliame dieginyje vykdymo būseną galite įsiminti. Didesnėje kodų bazėje tai nebeveikia. Kyla tokie klausimai:

- Kurie blokai šiuo metu iš tikrųjų užregistruoti?
- Kurie plėtiniai skirti `core/*`, o kurie – atskiriems blokams?
- Kurie puslapiai sinchronizuoti ir kokiems įrašų tipams jie priklauso?
- Kokie pakartotinai naudojami laukai yra šiame projekte?
- Kokios schemos užregistruotos ir kokią saugyklos posistemę jos naudoja?

Iki šiol atsakymą tekdavo rasti derinant aplankų peržiūrą, JSON failų atvėrimą ir PHP analizę žingsnis po žingsnio. Dabar visa tai pateikta tikrame administravimo ekrane.

Kiekvienas skirtukas skirtas atsakyti į skirtingus klausimus:

- **Blokai** rodo užregistruotus blokų tipus, atvaizdavimo režimą, API versiją ir atributų skaičių
- **Plėtiniai** rodo, kuriems blokams jie taikomi, taip pat prioritetą ir atvaizdavimo informaciją
- **Laukai** pateikia pakartotinai naudojamų pasirinktinių laukų aprašų sąrašą
- **Puslapiai** rodo sinchronizuotus failais pagrįstus puslapius, jų įrašų tipą, būseną, šablonų variklį ir sinchronizavimo būseną
- **Schemos** pateikia užregistruotas saugyklos schemas, jų posistemę, laukų skaičių ir galimybių aprėptį

Duomenų bazės naršyklė sąmoningai atskirta nuo pradinės apžvalgos duomenų. Užuot įkėlus visų įrašų duomenis, iš pradžių pateikiamos tik galimos schemos, o įrašai įkeliami pagal poreikį atidarius duomenų bazės skirtuką. Taip administravimo sąsaja išlieka naudinga net ir tada, kai projektas turi didesnius duomenų rinkinius už `db.php`.

Ši pirmoji versija sąmoningai skirta schemomis pagrįstoms registracijoms. Tai ne nustatymų puslapis. Tai peržiūros puslapis.

Jei jos visai nenorite, visiškai ją išjunkite:

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

### Administravimo registro naršyklė

Šalia apžvalgos yra antras skirtukas: **Registras**. Tai nuotolinių blokų registrų, sukonfigūruotų jūsų temos `blocks.json`, naršyklė, leidžianti importuoti blokus tiesiai iš WordPress administravimo sąsajos, neliečiant 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}"
      }
    }
  }
}
```

Naršyklė gauna duomenis iš kiekvieno sukonfigūruoto registro, pateikia visus galimus blokus ir nurodo, ar jie jau įdiegti vietoje, ar juos galima importuoti. Kiekvienoje eilutėje yra mygtukas „Importuoti“, kuriuo bloko failai atsisiunčiami į sukonfigūruotą temos katalogą. Jau įdiegtiems blokams vietoj jo rodomas mygtukas „Importuoti iš naujo“.

Palaikomi autentifikuoti registrai, naudojantys objektų formatą su `headers`, įskaitant `${ENV_VAR}` interpoliaciją, kad prieigos žetonai niekada nepatektų į versijų valdymą.

Dėl to registrų naršymas ir naudojimas tampa visaverte administravimo patirtimi, o ne tik CLI darbo eiga.

## Registro CLI

Kita registro funkcionalumo dalis – atskiras CLI: `blockstudio/registry`.

Tai „shadcn“ stiliaus įrankis, skirtas WordPress blokams. Nereikia npm paketo ar kūrimo veiksmo. Paleidžiate komandą, bloko pradinis kodas nukopijuojamas į projektą ir visiškai priklauso jums.

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

CLI veikia su bet kokio tipo blokais: Blockstudio blokais, `@wordpress/create-block` išvestimi ir paprastais PHP blokais. Registrui nesvarbu, kas yra aplanke. Jis perskaito failų aprašą iš `registry.json` ir nukopijuoja tiksliai jame nurodytus failus.

Blokų autoriai gali paskelbti `registry.json` bet kuriame URL (GitHub neapdorotame turinyje, S3 ar pasirinktiniame serveryje), kuriame pateikiami jų blokai su metaduomenimis, priklausomybėmis ir failų sąrašais. Naudotojai prideda URL prie savo `blocks.json` ir gauna blokus pagal pavadinimą.

CLI palaiko:

- **Priklausomybių sprendimas**: blokai gali nurodyti priklausomybes nuo kitų blokų; jos išsprendžiamos automatiškai, aptinkant ciklus
- **Kelių registrų konfliktų tvarkymas**: kai tas pats bloko pavadinimas yra keliuose registruose, CLI paragina pasirinkti vieną
- **Autentifikuoti registrai**: „bearer“ žetonai, bazinis autentifikavimas ir pasirinktinės antraštės su aplinkos kintamųjų interpoliacija
- **Interaktyvi TUI**: sukurta naudojant „Ink“, su eigos indikatoriais, pasirinkimo paraginimais ir progreso rodikliais
- **Neinteraktyvus režimas**: vėliavėlė `--yes` ir automatinis atsarginis režimas CI arba nukreiptos įvesties atveju
- **Paieška ir sąrašas**: registrus galima naršyti komandinėje eilutėje

Pakete yra 130 testų, apimančių schemas, priklausomybių sprendimą, HTTP duomenų gavimą, failų įrašymą, visus komandų srautus ir interaktyvią „Ink“ UI.

Visą dokumentaciją rasite [blockstudio.dev/registry](https://blockstudio.dev/lt/registry/).

## PHPStan plėtinys

Kitas didelis papildymas – `blockstudio/phpstan`: PHPStan plėtinys, suteikiantis Blockstudio naudotojams tokį tipų saugumą, kokio tikisi TypeScript kūrėjai.

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

Plėtinys analizės metu nuskaito tikrąsias projekto schemas ir perduoda gautus tipus PHPStan. Dabar tai apima PHP šablonus, Twig, Blade, blokų žymas, tipizuotus duomenų bazės įrašus, nustatymų kelius, kabliukų pavadinimus ir schemų tikrinimą `block.json`, `field.json`, plėtinio JSON, `page.json`, `db.php`, `rpc.php`, `cron.php` ir `blockstudio.json` aplinkose.

### Tipams saugūs blokų šablonai

Laukų prieigos `$a` tikrinamos pagal gretimą `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"?
```

### Tipams saugūs duomenų bazės įrašai

`Db::get()` grąžina tipizuotą egzempliorių pagal jūsų `db.php` schemą. Įrašo struktūra sudaroma iš tikrųjų laukų:

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

### Schemos tikrinimas

Netinkami schemų failai aptinkami analizės metu: `block.json`, `field.json`, plėtinio JSON, `page.json`, `db.php`, `rpc.php`, `cron.php` ir `blockstudio.json`. Pranešama apie trūkstamus pavadinimus, netinkamus laukų tipus, netaisyklingus apibrėžimus ir nebenaudojamus sutrumpintus loginius parametrus (`"tailwind": true` vietoj įdėtinio objekto), nurodant tikslią eilutę pradiniame faile.

### Nustatymų kelių tikrinimas

`Settings::get()` iškvietimai tikrinami pagal žinomą nustatymų schemą:

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

### Kabliukų pavadinimų tikrinimas

Taip pat tikrinami filtrų ir veiksmų kabliukų pavadinimai:

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

Plėtinyje taip pat yra visos viešosios Blockstudio API aplinkos aprašai: `Db`, `Settings`, `Field_Registry`, `Build` ir visuotinės pagalbinės funkcijos. Visoms Blockstudio API sąsajoms gaunate automatinį užbaigimą ir tipų tikrinimą, todėl kūrimo kompiuteryje nereikia turėti papildinio pradinio kodo.

## Patogesnis kūrimas

Šį leidimą papildo du nedideli patogesnio kūrimo patobulinimai.

### Visuotinės SCSS pradžios nuostatos

Blockstudio jau palaikė SCSS kompiliavimą, tačiau buvo viena erzinanti kliūtis: bendros Sass sąrankos nustatymas.

Jei norėdavote naudoti bendrą kintamųjų, funkcijų ar mišinių rinkinį, turėdavote juos importuoti kiekviename SCSS faile. Tai greitai ima kartotis, ypač naudojant didesnes dizaino sistemas ar Sass įrankių rinkinius, tokius kaip Bootstrap.

7.2 versijoje tam pridėtas pradinių nuostatų kabliukas:

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

Kartu su esamu `blockstudio/assets/process/scss/import_paths` filtru galite vieną kartą apibrėžti bendrą Sass sritį, kuri bus prieinama kiekviename kompiliuojamame faile.

Bloko stiliaus faile galima palikti tik jam reikalingus stilius:

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

Nebereikia kartoti importų kiekviename bloko ištekliuje. Tai nėra specialus „Bootstrap palaikymo“ režimas. Tai bendras kabliukas, skirtas bendrai Sass visame projekte, nesvarbu, ar ji gaunama iš Bootstrap, ar iš jūsų vidinio įrankių rinkinio.

### PHP savieji blokų API apibrėžimai

7.2 versijoje taip pat pridėta pasirenkama PHP savoji sintaksė viso steko blokų API sąsajoms. Masyvai lieka numatytuoju ir visiškai palaikomu formatu. Nieko nepakeitėme. Tačiau jei vietoj įdėtinių konfigūracijos masyvų pageidaujate vardinių argumentų, išvardijimų ir atributų, dabar galite rinktis šį stilių.

Jei reikia `rpc.php`, grąžinkite objektą su atributais pažymėtais metodais:

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

Jei reikia `cron.php`, tą patį galima padaryti naudojant `#[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 {
    }
};
```

Jei reikia `db.php`, dabar yra nedidelis kūrimo priemonių sluoksnis:

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

Taip pasiekiama geresnė pusiausvyra didesnėms kodų bazėms. Kai norite, galite naudoti paprastą masyvo formatą, o blokui išaugus ir turint daugiau nei kelis laukus ar galinius taškus, pereiti prie lengviau perprantamos PHP sąsajos.

## Kodėl šios funkcijos išleidžiamos kartu

Administravimo apžvalga, registro naršyklė, registro CLI ir PHPStan plėtinys atsako į tą patį klausimą: kaip išlaikyti Blockstudio projektą suprantamą jam augant?

Administravimo įrankiai padeda tai užtikrinti projekto lygmeniu: matyti, kas užregistruota, įtraukti blokus iš registrų ir mažiau spėlioti.

CLI padeda tai užtikrinti ekosistemos lygmeniu: dalytis blokais tarp projektų ir komandų, neįtraukiant jų į npm paketus ir nekovojant su kūrimo sistemomis.

PHPStan plėtinys padeda tai užtikrinti kodo lygmeniu: aptikti netinkamas prieigas prie laukų, schemų rašybos klaidas ir neveikiančius kabliukų atgalinius iškvietimus dar prieš vykdymą.

Tokios apskritai yra 7.2 versijos kryptys: mažiau spėliojimo ir pasikartojimų, geresnis matomumas ir dabar – tikras tipų saugumas.

## Klaidų taisymai

- **Klasių laukas**: naudotojo įvesti pasirinktiniai klasių pavadinimai tyliai dingdavo praradus lauko židinį, nes tikrintuvas priimdavo tik klases iš iš anksto nustatyto Tailwind / nustatymų sąrašo. Dabar priimama bet kokia netuščia eilutė.
- **Atributų laukas**: pašalinus atributų porą, išsaugotuose duomenyse likdavo `null` įrašai. Vietoj „lodash“ `unset()`, kuris masyvo elementus pakeičia į „null“, pradėta naudoti `splice()`, kuri juos pašalina.
- **CSS minifikatorius**: TailwindPHP minifikatorius pašalindavo tarpus aplink `+`, esančius `calc()` ir `clamp()`, todėl susidarydavo netinkamas CSS, pavyzdžiui, `calc(1rem+0.5vw)`. Problema ištaisyta aukštesniame projekte TailwindPHP v1.3.1: dabar naudojamas gylį įvertinantis simbolių perėjimas, šalinantis tarpus aplink selektorių jungiklius tik tada, kai skliaustų gylis yra 0.
- **Blokų įterpimo peržiūra**: `$isPreview` blokų įterpimo peržiūroje visada būdavo `false`, nes atvaizdavimo talpyklos maišos raktas neapėmė atvaizdavimo režimo. Dabar rengyklės ir peržiūros atvaizdavimams naudojami atskiri talpyklos įrašai.
- **Įdėtinis „InnerBlocks“ šablonas**: komponentas `<InnerBlocks template="..."/>` išmesdavo trečiąjį elementą (vaikus) iš šablono eilučių, pavyzdžiui, `['core/group', {}, [['core/paragraph']]]`, todėl konteinerio blokai likdavo tušti. Dabar įdėtiniai vaikai išsaugomi.
