
Blockstudio 7.6 versijoje projektą galima peržiūrėti ir atvaizduoti naudojant PHP, o numatytieji gamybinės aplinkos svetainės sąsajos nustatymai perkeliami į `blockstudio.json`: inventoriaus API, savarankiškas atvaizdavimas, medijos ir Tailwind šablonų pagalbinės funkcijos, našumo profiliai, vienas podėlio katalogas, statinis išankstinis atvaizdavimas ir ankstyvas pateikimas, griežtesni analizės išankstiniai nustatymai bei programavimo agentams skirti sugeneruoti projektų įrankiai.

Daugumą leidimo funkcijų apima du iškvietimai. `Canvas::inventory()` grąžina visus projekto registruotus puslapius, blokus, šablonų rinkinius, Svetainės redaktoriaus šablonus, šablonų dalis ir įtrauktus UI pavyzdžius. `Render::document()` grąžina bet kurio iš jų paruoštą HTML kartu su tiksliai tais ištekliais, kuriuos naudojo atvaizdavimas.

> **7.6.2 naujinys:** failais pagrįsti puslapiai nebesinchronizuojami įprastų WordPress užklausų metu. Taikydami šaltinio pakeitimus paleiskite `wp bs pages sync` arba iškvieskite `Blockstudio\Pages::reconcile()`. Kolekcijų maršrutizavimas ir numatytieji `templateFor` nustatymai naudoja išsaugotą vykdymo aplinkos konfigūraciją, o aiškiai paleidžiant sutikrinimą nebeatliekama ankstesnė didelė daugiakalbė OR-meta užklausa. Trumpalaikė parinktis `themeDefaults.syncPagesInDevelopment` pašalinta, nes puslapių sinchronizavimas nebevykdomas iš užklausų kablių. `Pages::init()` dabar naudojamas tik paleidimo metu; integracijos, kurios perduodavo `force`, turi naudoti `Pages::reconcile()` arba CLI. Atidarant Canvas vis dar atliekamas vienas autentifikuotas, aiškiai paleistas sutikrinimas, skirtas kūrimo inventoriui.

> **7.6.12 atnaujinimas:** redaktoriaus stilių lentelės dabar nurodomos prefiksu vienu perrašymo veiksmu, o ne kiekvienam ištekliui atskirai kompiliuojant SASS, todėl šaltas redaktoriaus kūrimas svetainėje su daug blokų nebeišsekina nedidelio atminties limito. Jei iš talpyklos pašalinama talpykloje saugomo iš anksto atvaizduoto puslapio turinio maiša pagrįsta Tailwind stilių lentelė, puslapis atvaizduojamas iš naujo, užuot pateikus jį be stilių; tai taikoma ir PHP talpyklai, ir Early Serve papildiniui. Aukščiausio lygio blokų atributai nuskaitomi atvaizduojant, o ne atmetami, todėl schemos Blockstudio registracija `WP_Block_Type` tinkamai veikia programinėmis priemonėmis rašantiems įrankiams.

> **7.6.11 atnaujinimas:** diegiant grafo artefaktus, maršruto dokumentas dabar pakeičiamas atominiu būdu, jei saugyklos kopija tuo pačiu raktu pasikeitė; identiški dokumentai paliekami nepakeisti, o paaukštinti, pakeisti, praleisti ir išsaugoti maršrutai pateikiami per `Static_Prerender_Early_Serve::last_promotion()`.

> **7.6.10 atnaujinimas:** vykdymo aplinkos talpyklos pataikymų metu dabar aptinkami pašalinti kompiliuoti ištekliai net ir stebėjimo atidėjimo laikotarpiu, o senesnės nei 7.6 plokščios vykdymo aplinkos talpyklos atominiu būdu izoliuojamos ir ištrinamos riboto dydžio cron paketais. Įtraukti UI globalūs objektai išvedami po kartą kiekviename puslapyje. Grafo režimo Early Serve gali pateikti tiesiogiai atvaizduotus maršrutus, kurių nėra įdiegtų maršrutų žemėlapyje, naudodama tapatybės talpyklą. Tailwind pasirinktinai gali išvesti turinio maiša pagrįstą talpyklos failą su `tailwind.output: "link"`; pagal numatytuosius nustatymus išvestis lieka įterptinė.

Trumpai:

- **Projekto inventorius**: `Canvas::inventory()` pateikia visus registruotus įrašus su jų šaltiniais ir stabiliu rodymo eiliškumu.
- **Tikslinė atranka**: nurodžius blokus ir puslapius, jų paieška, sinchronizavimas, atvaizdavimas ir kompiliavimas apribojami šiais įrašais.
- **Savarankiškas atvaizdavimas**: `Blockstudio\Render` pateikia galutinį HTML blokui, kompozicijai arba visam dokumentui.
- **UI komponentų grupės**: `Blockstudio\Ui` suskirsto įtrauktą biblioteką į po vieną viešą grupę kiekvienam komponentui ir pateikia po pavyzdį.
- **Stabilūs vaizdų matmenys**: `bs_media_image()` atvaizduoja temos išteklius su tikrais matmenimis iš sugeneruoto `assets/media.json`.
- **Tailwind klasių pagalbinės funkcijos**: `bs_tw_merge()` ir `bs_tw_variants()` sujungia klases PHP ir atsižvelgia į konfliktus.
- **Našumo profiliai**: `performance.profile` vienu kartu įjungia gamybinės aplinkos sąsajos numatytąsias nuostatas; antrinių elementų reikšmės jas pakeičia.
- **Tipizuota nuostatų prieiga**: `Settings::get_bool()` ir kitos panašios funkcijos nuskaito `blockstudio.json` su tikraisiais tipais ir pateikia analizės klaidas.
- **Vienas talpyklos katalogas**: visi sugeneruoti failai saugomi `cache.path` kataloge ir susiejami su vykdymo aplinkos tapatybe.
- **Statinis išankstinis atvaizdavimas**: anoniminių HTML turinį galima išsaugoti talpykloje, negaliojančiu pažymėti pagal priklausomybių grafą ir pateikti dar prieš paleidžiant WordPress.
- **Analizės išankstinės nuostatos**: `theme`, `extreme-theme` ir `wordpress-render` išplečia `blockstudio/phpstan` galimybes už blokų šablonų ribų.
- **Valdomas pateikimo pakeitimų kabliukas**: `blockstudio-githooks sync` sukuria ir valdo išankstinio pateikimo kabliuką, kuris paleidžia sukonfigūruotą išankstinę nuostatą.
- **Projekto sutartis**: `blockstudio-agents` sukuria `AGENTS.md`, kuriame aprašoma, ką projekto autoriai kuria, kokias funkcijas jis įjungia ir ką užtikrina jo išankstinė nuostata.
- **Dokumentacijos rodyklė**: AI konteksto failas dabar yra visų dokumentų, jų paskirties ir jiems priklausančių identifikatorių rodyklė.
- **Kanoninės blokų žymos**: atskira komanda perrašo prefiksų ir alternatyvių pavadinimų trumpinius į `<bs:namespace-slug>`; galima vykdyti bandomąjį paleidimą.
- **Suderinamumas pagal numatytuosius nustatymus**: nė vienas iš šių pakeitimų nepaveikia svetainės, kol jis nenurodomas `blockstudio.json`.

## Projekto skaitymas ir atvaizdavimas

### Projekto inventorius

`Canvas::inventory()` pateikia viską, ką projektas užregistruoja, viename paprastame masyve, nieko neatvaizduodama.

```php
use Blockstudio\Canvas;

$result = Canvas::inventory();

foreach ($result['inventory']['blocks'] as $block) {
    echo $block['name'] . "\n";
}
```

Įrašai grupuojami pagal tipą: `pages`, `blocks`, `patterns`, `templates`, `parts` ir `ui`. `order` nustato stabilų visų tipų rodymo eiliškumą, `sources` susieja kiekvieną įrašą su jo šaltinio keliais, o `warnings` ir `errors` renka problemas kaip struktūruotus įrašus.

Blokų įrašuose yra `id`, `name`, `title`, `source`, `path`, `provenance` ir paruoštas atvaizduoti `declaration`. Puslapių įrašuose `source` išlieka stabilus identifikatorius, o `path` – atvaizduojantis šablonas.

### Tikslinė atranka

Nurodžius įrašus, darbo apimtis sumažinama, užuot viską iš pradžių aptikus ir tik tada atrinkus.

```php
$changed = Canvas::inventory([
    'blocks' => ['mytheme/hero'],
    'pages' => ['about'],
]);
```

Taip gaunamas vienas blokas ir vienas puslapis. `patterns`, `templates`, `parts` ir `ui` grąžinami tušti, o jų šaltiniai neskaitomi, nesinchronizuojami, neatvaizduojami ir nekompiliuojami.

Taisyklės tikslios:

- Nenurodžius nė vieno tipo rakto, įkeliami visi tipai.
- Nurodžius `true`, `null` arba `"*"`, įkeliami visi to tipo įrašai.
- Eilutė arba sąrašas tiksliai atitinka ID, pavadinimą, trumpąjį pavadinimą, kelią arba šaltinio kelią.
- Tuščia eilutė, tuščias sąrašas arba `false` neįkelia nė vieno to tipo įrašo.
- Nurodžius bent vieną tipo raktą, nenurodyti tipai lieka nepaliesti.

Nebegzistuojantys identifikatoriai pateikiami `deleted`, užuot sukėlus klaidą, o Canvas REST atnaujinimo galinis taškas tą pačią taisyklę taiko parametrams `blocks` ir `pages`.

`Canvas::documents()` naudoja tą pačią atranką ir prie kiekvieno įrašo prideda po atvaizduotą dokumentą. Atrinkti puslapiai atvaizduojami atkurtame sąsajos kontekste, todėl užklausų sąlygos, turinio klasės, trumpieji kodai, išdėstymai, peradresavimai ir išteklių įtraukimo atgaliniai iškvietimai gauna tą puslapį, o ne užklausą, kuri jo paprašė.

### Savarankiškas atvaizdavimas

`Blockstudio\Render` grąžina atvaizduotą HTML kaip eilutę, naudodama tą patį konvejerį kaip sąsaja.

```php
use Blockstudio\Render;

$html = Render::composition([
    'root' => 'mytheme/card',
    'data' => ['heading' => 'Example card'],
    'layers' => [
        ['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
    ],
]);
```

Visas pagrindas yra viena deklaracijos forma su keturiais raktais: `name`, `attributes`, `content` ir `children`. `root`, `data`, `inner`, `innerBlocks`, `layers` ir `example` yra patogesni įvesties variantai, kuriuos `Render::normalize()` sujungia į šią formą.
Vaikiniai elementai atvaizduojami rekursyviai, o netinkama įvestis sukelia išimtį, kurioje nurodomas problemą sukėlęs blokas.

`Render::document()` apgaubia išvestį visu savarankišku HTML dokumentu.

```php
$document = Render::document('mytheme/hero', [
    'title' => 'Hero preview',
]);

echo $document['html'];
```

`body` yra vien bloko išvestis, `html` – surinktas dokumentas, `blocks` – prisidėjusių blokų pavadinimai, o `assets` suskaido žymėjimą į `head`, `footer`, `styles`, `scripts`, `modules`, `interactivity`, `ui` ir `tailwind`.
Ištekliai apribojami atvaizduotu turiniu, todėl vien redaktoriui skirti ištekliai nepateikiami.

`Render::document_from_html()` apgaubia kitur atvaizduotą HTML, o `Render::content()` atvaizduoja serializuotą blokų turinį be dokumento. Viename PHP procese tarp dokumentų iškvieskite `Blockstudio\Batch_Render::reset()`; `Canvas::documents()` tai jau atlieka.

### UI komponentų grupės

`Blockstudio\Ui` pateikia įtrauktą UI biblioteką po vieną įrašą kiekvienam viešam komponentui, o ne vidinių dalių sąrašą.

`Ui::inventory()` pateikia po vieną kiekvienos grupės įrašą su pagrindiniu bloku, pavadinimu ir reikalingais įgyvendinimo blokais. `Ui::examples()` kiekvienai grupei prideda deterministinę deklaraciją: išsaugomos numatytosios reikšmės, būtini vaikiniai sluoksniai įterpiami po savo tėviniais, o kai laukas būtų tuščias, įrašomas stabilus pavyzdinis tekstas. Ši deklaracija yra kanoninė, todėl ją galima tiesiogiai naudoti `Render::document()`.

Canvas grupuoja taip pat. Įtrauktas UI rodomas po tipu `ui` kaip po vieną kiekvienos grupės pavyzdį, o įgyvendinimo registracijos nepatenka į `blocks`.

Grupės sukurtos taip, kad jas būtų galima jungti: pasirinkimo sąrašas atveriamas dialogo lange, kurio sąrašo perdanga yra virš paleidiklio; meniu ir kombinuotieji sąrašai prisitvirtina prie fiksuotų peržiūros srities koordinačių, kurios išlieka slenkant; modaliniai langai kaupiami sluoksniais ir uždaromi po vieną paspaudus Escape; kiekvienoje poraštėje tas pats uždarymo valdiklis derinamas su variantu. Kaip veikia šios sąsajos ir kokie nekintamieji užtikrina jų veikimą, aprašyta [kompozicijų skyriuje](https://blockstudio.dev/lt/ui/composition/); [/ui/examples](https://blockstudio.dev/lt/ui/examples/) pateikiamos veikiančios kompozicijos.

## Šablonų pagalbinės funkcijos

### Stabilūs vaizdų matmenys

`bs_media_image()` atvaizduoja temos išteklius su tikru pločiu, aukščiu ir rezervuotu kraštinių santykiu, todėl vaizdai, nepatenkantys į medijos biblioteką, nebesukelia išdėstymo poslinkių.

```php
<?php
echo bs_media_image([
    'src' => 'assets/images/hero.webp',
    'alt' => 'Hero',
]);
```

Išvestis yra `figure.blockstudio-media` su įterptine `aspect-ratio` aplink `img`, turintį tikrus `width`, `height`, `loading` ir `decoding`. Matmenys gaunami iš sugeneruoto `assets/media.json`, kurį kūrimo etapu įrašo `Blockstudio\Media_Metadata_Builder` arba kuris sukuriamas rankiniu būdu.

`src` priima su tema susietą santykinį kelią, absoliutų kelią arba visą URL, o `attachmentId` skirtas medijos bibliotekos vaizdams. `eager` išjungia atidėtą įkėlimą virš matomos srities, o `sources` išveda `<picture>`.

Kai įjungta `performance.media.lazy`, tikrasis URL perkeliamas į `data-src` ir pakeičiamas tinkamo dydžio vietaženkliu.

### Tailwind klasių pagalbinės funkcijos

`bs_tw_merge()` ir `bs_tw_variants()` sujungia Tailwind klases PHP šablonuose naudodamos variklį, kuris jau įtrauktas į Blockstudio.

`bs_tw_merge('px-2 text-sm', 'px-4')` grąžina `text-sm px-4`: pašalinamas konfliktuojantis `px-2`, o pirmenybė teikiama vėlesnei reikšmei. Priimami įdėtiniai klasės reikšmių masyvai.

`bs_tw_variants()` grąžina nedidelę iškviečiamą funkciją komponentų variantams:

```php
$button = bs_tw_variants([
    'base' => 'inline-flex items-center',
    'variants' => [
        'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
    ],
    'defaultVariants' => ['size' => 'sm'],
]);

echo $button(['size' => 'lg', 'class' => 'rounded']);
```

Taip išvedama `inline-flex items-center h-12 px-6 rounded`. Palaikomos pagrindinės klasės, variantai, numatytieji variantai, sudėtiniai variantai ir kiekvieno iškvietimo `class` arba `className`.

## Gamybinės aplinkos konfigūracija

### Našumo profiliai

`performance.profile` vienoje vietoje įjungia numatytąsias gamybinės aplinkos sąsajos nuostatas.

```json title="blockstudio.json"
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}
```

`compat` yra numatytoji reikšmė ir nieko nekeičia. `speed` ir `strict` įjungia tą patį nuostatų rinkinį: iš antraštės pašalinama generatoriaus, jaustukų, sklaidos kanalų, aptikimo ir susijusių įrašų išvestis; atsisakoma oEmbed aptikimo ir pagrindinio kompiuterio scenarijų; išjungiami XML-RPC, pingbacks ir nuotolinio redaktoriaus aptikimas; pašalinami bendrieji pagrindinės sistemos sąsajos ištekliai; pritaikomos numatytosios vaizdų išvesties nuostatos; „Heartbeat“ ribojamas ne redaktoriaus aplinkose; tos pačios kilmės dokumentai iš anksto įkeliami užvedus žymeklį arba sufokusavus; naudojama Blockstudio vaizdų įkėlimo priemonė.

Kiekviena antrinio elemento reikšmė pakeičia profilio nuostatą, kaip parodyta aukščiau su `preload.links`. Pirmiausia reikėtų išbandyti pagrindinės sistemos sąsajos išteklių šalinimą, nes nuo jų priklausantis puslapis akivaizdžiai sutriks. `Runtime_Settings::current()` pateikia išspręstą profilį.

`themeDefaults` apima du dalykus, kuriuos temos kitu atveju turėtų įgyvendinti pačios: `titleTag` ir `suppressDirectoryUpdates`, kurie pašalina aktyvią antrinę ir pagrindinę temas iš naujinimų rezultatų.

### Tipizuota nuostatų prieiga

`Blockstudio\Settings` nuskaito konfigūraciją su tikraisiais tipais, užuot grąžinusi bet ką, kas buvo saugoma JSON.

```php
use Blockstudio\Settings;

$lazy = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);
$roles = Settings::get_array('users/roles');

foreach (Settings::errors() as $error) {
    error_log($error);
}
```

Apie netaisyklingą JSON pranešama per `Settings::errors()`, užuot vietoj jo naudojus numatytąsias reikšmes. `Settings::get_raw()` pateikia tik tai, ką apibrėžė aktyvus šaltinis, todėl galima atskirti reikšmę, nustatytą į `false`, nuo niekada nenustatytos reikšmės.

`Settings::fingerprint()` pateikia stabilų veiksmingų nuostatų identifikatorių, o pasikeitus `blockstudio.json` prieiga iš naujo įkelia nuostatas.

### Vienas talpyklos katalogas

Visi sugeneruoti failai dabar saugomi `cache.path` kataloge, kurio numatytoji vieta yra `wp-content/blockstudio/cache`.

```json title="blockstudio.json"
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}
```

Kūrimo duomenys, blokų registracijos informacija, redaktoriaus ištekliai, sukompiliuoti Tailwind CSS, atvaizdavimo dokumentai, salų fragmentai, statiniai HTML, grafų indeksai, apšilimo eilės ir diagnostikos duomenys saugomi šiame pagrindiniame kataloge. Santykinis kelias skaičiuojamas nuo `WP_CONTENT_DIR`, o absoliutus kelias nurodo atskirą tomą.

Objektai saugomi pagal dabartinį tinklą ir svetainę, o tada pagal vykdymo aplinkos tapatybę: Blockstudio, WordPress ir PHP versijų kontrolinę santrauką, veiksmingas nuostatas, aktyvią temą ir papildinius, aptikimo šaltinius bei susijusius šaltinio failus. Pasikeitus įvesčiai, paveikti objektai sukuriami iš naujo, o senieji pašalinami.

Šalti kūrimo procesai vykdomi po vieną: viena užklausa sukuria ir atominiu būdu paskelbia rezultatą, o kitos laukia. Nepavykus atnaujinti, toliau pateikiamas paskutinis geras objektas, o apie klaidą ir toliau pranešama; `Blockstudio\Runtime_Cache::purge('tailwind')` išvalo vieną apimtį.

## Statinis išankstinis atvaizdavimas

Statinis išankstinis atvaizdavimas talpykloje saugo visus anoniminius HTML dokumentus ir gali juos pateikti dar prieš paleidžiant WordPress. Pagal numatytuosius nustatymus ši funkcija išjungta.

```json title="blockstudio.json"
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}
```

### Tinkamumo sąlygos

Tinka tik visi anoniminiai HTML dokumentai. Praleidžiamos ne GET užklausos, užklausos eilutės, administravimo skiltis, REST, Ajax, cron, sklaidos kanalai, paieška, peržiūros, užklausos su nonce, personalizuojantys slapukai ir visi keliai, prasidedantys `dynamicPaths`. Atsakymo galima visiškai atsisakyti naudojant `<!-- blockstudio:no-cache -->` žymeklį.

Keliai tikrinami atsižvelgiant į ribas, todėl `/account` apima `/account/orders`, bet ne `/accounting`.

### Parašo ir grafo režimai

`invalidate` parenka įrašų galiojimo pabaigos tvarką. Numatytojo `signature` režimo atveju, gavus anoniminę užklausą, sukuriamas su tapatybe susietas atsakymas, o pasikeitus svetainės lygio nuostatoms jis pakeičiamas. Šis režimas tinka įprastai svetainei.

`graph` režimas skirtas specialiai kūrimo ir diegimo įrankiams. Jis įrašo kiekvieno puslapio šaltinio priklausomybes, todėl planas atkuria tik paveiktus URL adresus.

```php
use Blockstudio\Static_Prerender_Runtime;

$plan = Static_Prerender_Runtime::build_plan($sourceUrls);

foreach ($plan['affectedUrls'] as $url) {
    $result = render_with_dependencies($url);

    Static_Prerender_Runtime::persist_built_response(
        $url,
        $result['html'],
        $result['files'],
        $result['virtualHashes']
    );
}

Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));
```

### Ankstyvas pateikimas

Įjungus `earlyServe`, Blockstudio valdo nedidelį kiekvienos svetainės maršrutų žemėlapį ir `advanced-cache.php` papildinį, kuris pateikia srautą, jei užklausa atitinka sąlygas, dar prieš paleidžiant WordPress, papildinius ar temą.

Ši funkcija niekada neperrašo kito savininko žemėlapio, papildinio ar `WP_CACHE` deklaracijos. Prieš pakeičiant žemėlapį, grafo artefaktas patikrina kiekvieną nurodytą HTML failą, todėl iš dalies atvaizduotas diegimas palieka aktyvų ankstesnį grafą. Daugelio svetainių įrašai atskiriami pagal pagrindinio kompiuterio vardą, pagrindinį kelią ir svetainės ID.

### Apšilimas ir būsena

Kasdieniam naudojimui skirtos trys WP-CLI komandos:

```bash
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
```

`status` pateikia aktyvią tapatybę, failų ir baitų skaičių, grafo įrašus, eilės būseną bei kiekvienos apimties pataikymų, praleidimų, kūrimo procesų ir klaidų skaitiklius.

## Analizės ir agentų įrankiai

### Analizės išankstinės nuostatos

`blockstudio/phpstan` prie blokų analizės prideda tris sluoksnius ir vieną komandą, paleidžiančią projekto pasirinktą sluoksnį.

| Išankstinė nuostata | Ką prideda |
| --- | --- |
| `base` | Esamos schemos, šablonų, kabliukų, nuostatų ir API analizė. |
| `theme` | Temų šakniniai katalogai, stilių antraštės, ištekliai, selektorių aprėpties apribojimai, laukų numatytosios reikšmės, pasikartojančių laukų ribos. |
| `extreme-theme` | PHPStan `max`, nesaugūs PHP, escapinimas, Tailwind, JavaScript ir „Interactivity“ patikros. |
| `wordpress-render` | Skambintojo pateiktas aktyvaus atvaizdavimo patikrinimas, papildantis `extreme-theme`. |

Numatytosios reikšmės gaunamos iš `blockstudio.json`, todėl interaktyviuose paleidimuose, CI ir pateikimo pakeitimų kabliukuose naudojama ta pati konfigūracija:

```json title="blockstudio.json"
{
  "phpstan": {
    "preset": "theme",
    "roots": ["."],
    "excludePaths": ["fixtures/**"],
    "maxFiles": 10000
  }
}
```

```bash
vendor/bin/blockstudio-phpstan --root . -- --no-progress
```

Sėkmingo vykdymo išėjimo kodas yra `0`, diagnostikos atveju – `1`, netinkamo naudojimo atveju – `2`. Apvalkalas sujungia konfigūraciją sistemos laikinajame kataloge, todėl projekte neatsiranda sugeneruotos konfigūracijos, bazinės linijos ar talpyklos, taip pat padidina PHPStan atminties limitą iki `1G`.

Taip pat įtrauktas BC Math teikėjas, todėl JavaScript patikroms nebereikia `ext-bcmath`.

### Valdomas pateikimo pakeitimų kabliukas

Viena nuostata ir viena komanda paverčia sukonfigūruotą išankstinę nuostatą pateikimo pakeitimų patikra.

```json title="blockstudio.json"
{
  "githooks": {
    "commit": true
  }
}
```

```bash
vendor/bin/blockstudio-githooks sync
```

Sinchronizavimo komanda įrašo kabliuką ir nuosavybės įrašą Git bendrame kataloge, nustato, kad `core.hooksPath` rodytų į valdomą katalogą, ir iškviečia anksčiau sukonfigūruotą išankstinio pateikimo kabliuką. Kabliukas pateikimo metu nustato saugyklos ir projekto šakninį katalogą, todėl veikia susietos darbinės kopijos ir keliai su tarpais.

Kabliukas paleidžia tik `vendor/bin/blockstudio-phpstan`; jis niekada neformatuoja ir neperrašo failų. Nustačius `commit` į `false` ir vėl sinchronizavus arba paleidus `blockstudio-githooks remove`, atkuriamas įraše nurodytas kabliuko kelias, o ištrinami tik Blockstudio priklausantys failai.

### Projekto sutartis

`blockstudio-agents` sukuria `AGENTS.md`, kuriame nurodoma, kur yra blokai, kas šiame projekte laikoma puslapiu, kokios funkcijos įjungtos ir ką analizatorius atmes.

```bash
vendor/bin/blockstudio-agents
```

Dokumentas generuojamas pagal aptiktus duomenis, o ne iš šablono. Temos su `style.css` antrašte, blokais ir failais pagrįstais puslapiais sutartis skiriasi nuo papildinio, registruojančio tik blokus; joje pateikiami skaitytuvo aptikti skaičiai, katalogai, vardų sritys ir šablonų kalbos. `blockstudio.json` lemia, kurios funkcijos įtraukiamos, todėl projekte be statinio išankstinio atvaizdavimo ši funkcija neminima.

Teisingumo skyrius skaitomas iš pasirinktos išankstinės nuostatos taisyklių failų sluoksnis po sluoksnio, todėl pridėjus taisyklę prie išankstinės nuostatos pasikeičia kiekviena pagal ją sugeneruota sutartis.

Nuosavybės valdymas veikia taip pat kaip pateikimo pakeitimų kabliukas. Jei faile nėra sugeneruoto žymeklio, jo pakeisti neleidžiama, nebent `--force` nurodo kitaip; pabaigoje esanti pastabų sritis išsaugoma generuojant iš naujo; kai sutartis pasenusi, `--check` baigiasi kodu `1`; o `--stdout` pateikia sutartį neliesdamas failų sistemos.

### Dokumentacijos rodyklė

`blockstudio-llm.txt` dabar yra rodyklė, o ne sujungtas tekstas. Kiekvienas paskelbtas dokumentas pateikiamas vieną kartą, nurodant jo skyrių ir poskyrį, maršrutą, šaltinio failą, vienos eilutės paskirties aprašą ir jam priklausančius identifikatorius: nuostatų kelius, kabliukų pavadinimus, PHP funkcijas bei klases ir komandas.

```text
## Docs / Dev / Inspection Tools

### Canvas
route: /docs/dev/canvas
file: docs/docs/dev/canvas.md
purpose: A visual workspace and public inventory API for Blockstudio content.
settings: dev/canvas/enabled, ui
hooks: blockstudio/settings/dev/canvas/admin_bar, blockstudio/settings/dev/canvas/enabled
php: Blockstudio\Canvas, Canvas::documents(), Canvas::inventory()
```

Agentas perskaito rodyklę, randa vienintelį dokumentą, kuriame apibrėžtas jam reikalingas identifikatorius, ir atidaro tą dokumentą. Ankstesnis pusės megabaito sujungtas failas vis dar generuojamas ir skelbiamas adresu `/blockstudio-llm-full.txt`; jis nebėra pirmasis dalykas, kurį kam nors pateikiame.

## Kanoninės blokų žymos

Atskira komanda perrašo prefiksų ir slapyvardžių trumpinius į kanoninę `<bs:namespace-slug>` rašybą, kurioje nurodomas tikrasis bloko pavadinimas ir kuri išsprendžiama neįkėlus projekto filtro.

Kai `brand` yra prefiksas, taikomas `theme-components`, o `ui` – prefiksas, taikomas `bsui`, šis trumpinys:

```html
<brand-card>
  <ui-input />
</brand-card>
```

reiškia tą patį kaip:

```html
<bs:theme-components-card>
  <bs:bsui-input />
</bs:theme-components-card>
```

Prefiksai ir tikslūs slapyvardžiai vis dar veikia ir nėra pasenę. Komanda neįkelia WordPress ir nieko neįrašo be `--apply`:

```bash
php vendor/blockstudio/blockstudio/bin/migrate-block-tags.php \
  --root="$PWD" \
  --prefix-map=/tmp/prefixes.json \
  --known-blocks=/tmp/blocks.json \
  --report=/tmp/tag-migration.json \
  --dry-run
```

`--prefix-map` susieja kiekvieną prefiksą su jo vardų sritimis, o `--known-blocks` pateikia registruotų blokų pavadinimus. Ataskaitoje įrašomi senųjų žymų ir kanoninių atitikmenų susiejimai su pasikartojimų skaičiumi, kiekvieno failo maišos reikšmės ir atskiri nežinomų žymų, dviprasmiškų slapyvardžių bei dinaminių žymų sąrašai. `--apply` atsisako įrašyti pakeitimus, kol jų dar yra, nebent perduodamas `--allow-unresolved`.

Apdorojamas suporuotas, įdėtinis ir savaime užsidarantis žymėjimas, įskaitant pažodines žymas PHP eilutėse. Keičiami tik žymų pavadinimai, antras paleidimas pakeitimų neatlieka, o pavyzdžiai komentaruose, kodo blokuose, `<pre>` arba `<code>` pateikiami tik ataskaitoje.

## Numatytoji elgsena

Įdiegus 7.6, niekas savaime nepasikeičia.

**Pagal numatytuosius nustatymus našumo profilis yra `compat`.** Antraštės išvestis, oEmbed, XML-RPC, Heartbeat, numatytieji vaizdų nustatymai, nuorodų išankstinis įkėlimas, tingusis įkėlimas ir priekinės dalies `<title>` lieka tokie, kokius nustatė WordPress ir tema.

**Šios funkcijos lieka išjungtos, kol neįjungtos:** visi `performance.staticPrerender`, `performance.measurement`, `performance.media` ir `themeDefaults` raktai, taip pat `githooks.commit`, `dev.canvas.enabled`, `ui.enabled`, `tailwind.enabled` ir `blockTags.enabled`. Kol statinis išankstinis generavimas išjungtas, jokie failai nerašomi ir joks papildomas įskiepis neįdiegiamas.

**Canvas ir Render veikia pasyviai.** Jie nuskaito esamus registrus ir atvaizduoja tik tai, ko paprašo iškvietėjas; nė vienas nesikiša į priekinės dalies išvestį ir neregistruoja maršrutų. Norint pasiekti Canvas administravimo ekraną, vis dar reikia `dev.canvas.enabled` ir `edit_posts`.

**Griežtesnė analizė įjungiama ją nurodžius.** Įdiegus `blockstudio/phpstan` įjungiamas tik pagrindinis plėtinys, o kanoninė komanda vykdo `base`, nebent projektas nurodo išankstinį nustatymą.

**Generuojami failai sukuriami paleidus jų komandą.** `githooks.commit` nieko nedaro, kol nepaleidžiamas `blockstudio-githooks sync`, o `AGENTS.md` – kol to nepadaro `blockstudio-agents`.

## Naujovinimas iš 7.5

Reikalavimai nepasikeitė: PHP 8.2 arba naujesnė versija, WordPress 6.7 arba naujesnė versija.

```bash
composer require blockstudio/blockstudio
```

**Talpyklos atkuriamos vieną kartą.** Vykdymo aplinkos tapatybėje yra Blockstudio versija, todėl po naujovinimo pirmoji užklausa vykdoma be talpyklos, o seni objektai pašalinami. Senąją Tailwind talpyklą, esančią `wp-content/uploads/blockstudio/tailwind/cache`, galima ištrinti; fragmentas, kuris ieškojo failų pagal šį šabloną, turėtų vietoj to iškviesti `Blockstudio\Runtime_Cache::purge('tailwind')`.

Plokščiasis `wp-content/blockstudio/cache/runtime` aplankas, naudotas iki 7.6 versijos, automatiškai pervadinamas, kad nebebūtų aktyviame kelyje, o pašalinamas ribotais WP-Cron etapais. Todėl diegimo užklausos metu nereikia ištrinti didelių senųjų užrakinimo failų medžių.

**Generuojami failai turi savininkus.** `assets/media.json` turi būti saugomas versijų valdymo sistemoje arba sukurtas atliekant komponavimo veiksmą. Maršrutų žemėlapis, papildomas `advanced-cache.php` failas ir `WP_CACHE` deklaracija egzistuoja tik tada, kai įjungtas `earlyServe`, o išankstinio patvirtinimo kablys – tik sinchronizavus. Visi kiti generuojami failai saugomi aplanke `cache.path` ir juos saugu ištrinti.

**Nieko nepašalinta ir nepervadinta.** `bs_render_block()`, `bs_block()`, `Blockstudio\Pages` ir `Blockstudio\Patterns` tebėra kanoniniai turinio šaltiniai, kurių turinys laikomas failuose.

**Sugrąžinti galima atskiras funkcijas.** Grąžinus `performance.profile` į `compat`, `staticPrerender.enabled` į `false`, `githooks.commit` į `false` ir pridėjus `sync`, taip pat `cache.enabled` į `false`, kiekvienu atveju atšaukiamas vienas sluoksnis.

Tinkama diegimo tvarka:

1. Nustatykite `performance.profile` į `speed`, tada patikrinkite antraštės išvestį, sklaidos kanalus ir visus įskiepius, kuriems reikia oEmbed arba XML-RPC.
2. Sugeneruokite `assets/media.json`, perkelkite šablonus į `bs_media_image()`, tada įjunkite `performance.media.lazy`.
3. Įjunkite `performance.staticPrerender`, palikite `earlyServe` išjungtą, patikrinkite užklausas naudodami `wp bs prerender status`, tada įjunkite `earlyServe`.
4. Vykdykite `blockstudio-phpstan --preset theme`, kol neliks klaidų, ir tik tada susiekite išankstinį nustatymą su `githooks.commit`.

## Kur rasti išsamią informaciją

- [Canvas](https://blockstudio.dev/lt/docs/dev/canvas/) ir jo [inventorius bei dokumento API](https://blockstudio.dev/lt/docs/dev/canvas/#public-inventory-and-document-api)
- [Atvaizdavimas](https://blockstudio.dev/lt/docs/blocks/rendering/#structured-compositions-and-complete-documents), [UI komponentai](https://blockstudio.dev/lt/ui/#public-inventory-and-examples) ir [UI komponavimas](https://blockstudio.dev/lt/ui/composition/)
- [Nustatymai](https://blockstudio.dev/lt/docs/general/settings/) ir [našumas](https://blockstudio.dev/lt/docs/general/settings/#performance)
- [Našumas](https://blockstudio.dev/lt/docs/production/performance/), [Talpyklos naudojimas](https://blockstudio.dev/lt/docs/production/caching/) ir [Statinis išankstinis generavimas](https://blockstudio.dev/lt/docs/production/static-prerendering/)
- [Tailwind CSS](https://blockstudio.dev/lt/docs/tailwind/#template-composition-helpers)
- [PHPStan](https://blockstudio.dev/lt/docs/dev/phpstan/): [išankstiniai nustatymai](https://blockstudio.dev/lt/docs/dev/phpstan/#analysis-presets), [kanoninė komanda](https://blockstudio.dev/lt/docs/dev/phpstan/#canonical-command), [valdomas patvirtinimo kablys](https://blockstudio.dev/lt/docs/dev/phpstan/#managed-commit-hook) ir [projekto sutartis](https://blockstudio.dev/lt/docs/dev/phpstan/#project-contract-for-coding-agents)
- [DI integravimas](https://blockstudio.dev/lt/docs/dev/ai/): dokumentacijos rodyklė ir visas tekstas
- [Perkėlimas](https://blockstudio.dev/lt/docs/dev/migration/v7/#canonical-block-tags) ir [PHP kabliai](https://blockstudio.dev/lt/docs/blocks/hooks/php/)
