
A Blockstudio 7.6 olvashatóvá és renderelhetővé teszi a projektet a PHP számára, az éles frontend alapértelmezéseit pedig áthelyezi a `blockstudio.json` rendszerbe: leltár API, önálló renderelés, média- és Tailwind-sablonsegédek, teljesítményprofilok, egyetlen gyorsítótárkönyvtár, statikus előrenderelés korai kiszolgálással, szigorúbb elemzési beállításkészletek, valamint generált projekt-eszközök a kódoló ügynökök számára.

A kiadás legfontosabb részét két hívás adja. A `Canvas::inventory()` visszaadja a projekt által regisztrált összes oldalt, blokkot, mintát, Site Editor-sablont, sablonrészt és csomagolt UI-példát. A `Render::document()` mindegyikhez kész HTML-t ad vissza, pontosan azokkal az eszközökkel, amelyeket a renderelés használt.

> **7.6.2-frissítés:** A fájlból betöltött oldalak egyeztetése többé nem fut le a szokásos WordPress kérések során. A forrásmódosítások alkalmazásához futtassa a `wp bs pages sync` parancsot, vagy hívja meg a `Blockstudio\Pages::reconcile()` függvényt. A gyűjtemények útvonalkezelése és a `templateFor` alapértelmezései mentett futtatókörnyezeti konfigurációt használnak, a kifejezett egyeztetés pedig elkerüli a korábbi, nagy méretű, többnyelvű OR-metaadat-lekérdezést. A rövid élettartamú `themeDefaults.syncPagesInDevelopment` beállítás megszűnt, mivel az oldalak szinkronizálása többé nem fut le a kérési hookokból. A `Pages::init()` mostantól csak bootstrapelést végez; azoknak az integrációknak, amelyek `force`-t adtak át, a `Pages::reconcile()` függvényt vagy a CLI-t kell használniuk. A Canvas megnyitása továbbra is egy hitelesített, kifejezett egyeztetést indít a szerzői leltárhoz.

> **7.6.12 frissítés:** A szerkesztői stíluslapok előtagja mostantól egyetlen
> átírási menetben készül el eszközönkénti SASS-fordítás helyett, így a sok
> blokkot tartalmazó webhelyek szerkesztőjének hideg buildje már nem kockáztatja
> a szerény memóriakeret kimerítését. Ha egy gyorsítótárazott, előrenderelt oldal
> tartalom-hash alapján azonosított Tailwind stíluslapját eltávolították,
> az oldal újrarenderelődik ahelyett, hogy stílusok nélkül szolgálnánk ki, mind a
> PHP gyorsítótáron, mind az Early Serve drop-inen keresztül. A legfelső szinten
> megadott blokkattribútumokat rendereléskor beolvassuk, nem dobjuk el, így a
> `WP_Block_Type`-on regisztrált séma Blockstudio a programozott írók esetén is érvényesül.

> **7.6.11 frissítés:** A Graph-artefaktumok telepítése mostantól atomikusan
> lecseréli egy útvonal dokumentumát, ha az áruházban ugyanazon kulcs alatt
> megváltozott a másolat, az azonos dokumentumokat érintetlenül hagyja, és a
> `Static_Prerender_Early_Serve::last_promotion()` segítségével jelenti a promótált, lecserélt, kihagyott és megtartott
> útvonalakat.

> **7.6.10 frissítés:** A futásidejű gyorsítótár-találatok mostantól a figyelési
> késleltetés alatt is észlelik az eltávolított lefordított eszközöket, a 7.6
> előtti lapos futásidejű gyorsítótárakat pedig atomikusan karanténba helyezzük,
> majd korlátozott cron-kötegekben töröljük. A csomagolt UI-globálisok
> oldalanként egyszer jelennek meg. Graph módban az Early Serve az identitás-
> gyorsítótárból a telepített útvonaltérképen kívüli, élőben renderelt útvonalakat
> is ki tudja szolgálni. A Tailwind igény szerint a tartalom-hash alapú gyorsítótárfájlt
> `tailwind.output: "link"`-ként is kibocsáthatja; alapértelmezésként továbbra is a beágyazott kimenet
> használatos.

Röviden:

- **Projektleltár**: a `Canvas::inventory()` minden regisztrált rekordot visszaad a forrásaival és stabil megjelenítési sorrendjével.
- **Célzott kiválasztás**: blokkok és oldalak megadásával a feltárás, szinkronizálás, renderelés és fordítás ezekre a rekordokra szűkül.
- **Önálló renderelés**: a `Blockstudio\Render` kész HTML értéket ad vissza egy blokkhoz, kompozícióhoz vagy teljes dokumentumhoz.
- **UI komponenscsaládok**: a `Blockstudio\Ui` a csomagolt könyvtárat komponensenként egy nyilvános családba rendezi, mindegyikhez egy példával.
- **Stabil képméretek**: a `bs_media_image()` valós méretekkel rendereli a téma eszközeit egy generált `assets/media.json` alapján.
- **Tailwind osztálysegédek**: a `bs_tw_merge()` és a `bs_tw_variants()` konfliktusokat kezelve fűz össze PHP-osztályokat.
- **Teljesítményprofilok**: a `performance.profile` egyszerre bekapcsolja az éles frontend alapbeállításait; a gyermekértékek felülírják.
- **Típusos beállításelérés**: a `Settings::get_bool()` és társai valódi típusokkal olvassák be a `blockstudio.json` értékeit, és jelzik a feldolgozási hibákat.
- **Egyetlen gyorsítótárkönyvtár**: minden generált fájl a `cache.path` alatt található, futásidejű identitás szerint rendezve.
- **Statikus előrenderelés**: az anonim HTML gyorsítótárazható, függőségi gráfon keresztül érvényteleníthető, és még azelőtt kiszolgálható, hogy elindulna a WordPress.
- **Elemzési presetek**: a `theme`, a `extreme-theme` és a `wordpress-render` a `blockstudio/phpstan` képességeit a blokk-sablonokon túlra bővíti.
- **Kezelt commit hook**: a `blockstudio-githooks sync` létrehozza és kezeli a beállított preseten futó pre-commit hookot.
- **Projektmegállapodás**: a `blockstudio-agents` olyan `AGENTS.md` fájlt hoz létre, amely leírja, mit készítenek a projekt szerzői, milyen funkciókat engedélyeznek, és mit követel meg a preset.
- **Dokumentációs index**: az AI-környezetfájl mostantól minden dokumentumot, annak célját és a hozzá tartozó azonosítókat indexeli.
- **Kanonikus blokkcímkék**: egy önálló parancs az előtagos és alias rövidítéseket `<bs:namespace-slug>` formára írja át, próbaüzemmel.
- **Alapértelmezett kompatibilitás**: a fentiek egyike sem módosít egy webhelyet, amíg nincs megadva a `blockstudio.json` fájlban.

## Projekt olvasása és renderelése

### Projektleltár

A `Canvas::inventory()` egyetlen egyszerű tömbként visszaad mindent, amit a projekt regisztrál, renderelés nélkül.

```php
use Blockstudio\Canvas;

$result = Canvas::inventory();

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

A rekordok típus szerint csoportosulnak: `pages`, `blocks`, `patterns`, `templates`,
`parts` és `ui`. A `order` adja az összes típus stabil megjelenítési sorrendjét,
a `sources` minden rekordhoz hozzárendeli a forrásútvonalakat, a `warnings` és a `errors` pedig strukturált bejegyzésekként gyűjti össze a problémákat.

A blokkrekordok a `id`, `name`, `title`, `source`, `path`, `provenance` és egy
renderelésre kész `declaration` értéket tartalmaznak. Az oldalrekordok stabil azonosítóként
őrzik meg a `source` értékét, a renderelő sablont pedig a `path` tárolja.

### Célzott kiválasztás

A rekordok megadása szűkíti a feldolgozást, így nincs szükség utólagos szűrésre.

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

Ez egy blokkot és egy oldalt ad vissza. A `patterns`, a `templates`, a `parts` és a `ui` üresen tér vissza; a hozzájuk tartozó forrásokat nem olvassuk be, nem szinkronizáljuk, nem rendereljük és nem fordítjuk le.

A szabályok pontosak:

- Típusazonosító nélkül minden típus betöltődik.
- A `true`, a `null` vagy a `"*"` az adott típus összes rekordját betölti.
- Egy karakterlánc vagy lista pontos egyezést keres az azonosító, név, slug, útvonal vagy forrásútvonal alapján.
- Az üres karakterlánc, az üres lista vagy a `false` az adott típusból semmit sem tölt be.
- Ha bármelyik típusazonosító szerepel, a kihagyott típusok változatlanok maradnak.

A már nem létező azonosítók hiba helyett a `deleted` alatt jelennek meg, a Canvas
REST frissítési végpontja pedig ugyanezt a szabályt alkalmazza az `blocks` és
`pages` paraméterekre.

A `Canvas::documents()` ugyanazt a kiválasztást fogadja, és rekordként egy-egy renderelt dokumentumot ad hozzá. A kiválasztott oldalak visszaállított frontendkörnyezetben renderelődnek, így a lekérdezési feltételek, a törzsosztályok, a shortcode-ok, az elrendezések, az átirányítások és a sorba állítási visszahívások a kiválasztott oldalt látják, nem az azt lekérő kérést.

### Önálló renderelés

A `Blockstudio\Render` karakterláncként adja vissza a renderelt HTML értéket, a frontendével azonos folyamaton keresztül.

```php
use Blockstudio\Render;

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

Az alapja egyetlen deklarációs forma négy kulccsal: `name`, `attributes`,
`content` és `children`. A `root`, a `data`, a `inner`, a `innerBlocks`, a `layers` és a
`example` bemeneti kényelmi formák, amelyeket a `Render::normalize()` egyesít vele.
A gyermekelemek rekurzívan renderelődnek, a hibás bemenet pedig a problémás blokkot
megnevező kivételt vált ki.

A `Render::document()` teljes, önálló HTML dokumentumba foglalja a kimenetet.

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

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

A `body` maga a blokk kimenete, a `html` az összeállított dokumentum, a `blocks` a közreműködő blokkok nevei, a `assets` pedig a jelölést a következő részekre bontja: `head`, `footer`, `styles`, `scripts`, `modules`, `interactivity`, `ui` és `tailwind`.
Az eszközök köre csak a renderelt tartalomra terjed ki, így a kizárólag a szerkesztőhöz tartozó eszközök nem jelennek meg.

A `Render::document_from_html()` egy máshol renderelt HTML dokumentumot foglal keretbe, a
`Render::content()` pedig dokumentum nélkül rendereli a szerializált blokktartalmat. Egyetlen
PHP folyamaton belül a dokumentumok között hívd meg a `Blockstudio\Batch_Render::reset()`-t;
a `Canvas::documents()` ezt már megteszi.

### UI komponenscsaládok

A `Blockstudio\Ui` a csomagolt UI könyvtárat nyilvános komponensenként egy bejegyzéssel teszi elérhetővé, nem a belső részek listájaként.

A `Ui::inventory()` családonként egy bejegyzést ad vissza a gyökérblokkjával, címével és a szükséges megvalósítási blokkokkal. A `Ui::examples()` családonként determinisztikus deklarációt ad hozzá: megőrzi az alapértelmezéseket, a szükséges gyermekrétegeket a szülőjük alá rendezi, az üres mezőkhöz pedig stabil szemléltető szöveget használ. Ez a deklaráció kanonikus, ezért közvetlenül bekerül a `Render::document()` értékbe.

A Canvas ugyanezt a csoportosítást használja. A csomagolt UI a `ui` típus alatt jelenik meg, családonként egy példával, a megvalósítási regisztrációk pedig kimaradnak a `blocks` értékből.

A családokat összeállíthatóra tervezték: a választó egy párbeszédablakon belül nyílik meg, a listája a kiváltó elem fölé rétegződik; a menük és a kombinált mezők olyan rögzített nézetport-koordinátákhoz igazodnak, amelyek görgetés közben is változatlanok maradnak; a modális ablakok egymásra rétegződnek, és egyszerre egyet zár be az Escape billentyű; minden lábléc ugyanazt a bezáró vezérlőt állítja össze egy változattal. A kapcsolódási pontok működését és a stabil működésüket biztosító invariánsokat a [kompozíciókról szóló fejezet](https://blockstudio.dev/hu/ui/composition/); a [/ui/examples](https://blockstudio.dev/hu/ui/examples/) oldalon élőben tekinthetők meg a kompozíciók.

## Sablonsegédek

### Stabil képméretek

A `bs_media_image()` valós szélességgel és magassággal, valamint fenntartott képaránnyal rendereli a téma eszközeit, így a médiatárban nem szereplő képek többé nem tolják el az elrendezést.

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

A kimenet egy `figure.blockstudio-media`, amely egy beágyazott `aspect-ratio` elemet tartalmaz egy valós `width`, `height`, `loading` és `decoding` értékkel rendelkező `img` körül. A méretek egy generált `assets/media.json` fájlból származnak, amelyet buildlépésben a `Blockstudio\Media_Metadata_Builder` ír meg, vagy kézzel hoznak létre.

A `src` relatív témaútvonalat, abszolút útvonalat vagy teljes URL címet fogad; a médiatár képeire a `attachmentId` használható. A `eager` kikapcsolja a lusta betöltést a hajtás felett, a `sources` pedig `<picture>` értéket bocsát ki.

Ha engedélyezve van a `performance.media.lazy`, a valódi URL a megfelelő méretű helyőrző mögé, a `data-src` értékbe kerül.

### Tailwind osztálysegédek

A `bs_tw_merge()` és a `bs_tw_variants()` a PHP sablonokban Tailwind osztályokat állít össze azzal a motorral, amelyet a Blockstudio már tartalmaz.

A `bs_tw_merge('px-2 text-sm', 'px-4')` a `text-sm px-4` értéket adja vissza: az ütköző `px-2` kiesik, a későbbi érték pedig érvényesül. Egymásba ágyazott, osztályértékeket tartalmazó tömbök is használhatók.

A `bs_tw_variants()` egy kis, meghívható függvényt ad vissza a komponensváltozatokhoz:

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

Ez `inline-flex items-center h-12 px-6 rounded` értéket ír ki. Támogatottak az alap osztályok, a változatok, az alapértelmezett változatok, az összetett változatok, valamint a hívásonkénti `class` vagy `className`.

## Éles környezeti konfiguráció

### Teljesítményprofilok

A `performance.profile` egyetlen helyen bekapcsolja az éles frontend alapértelmezett beállításait.

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

A `compat` az alapértelmezett, és nem módosít semmit. A `speed` és a `strict` ugyanazt a készletet engedélyezi: eltávolítja a fejlécből a generátort, az emojikat, a feedet, a felfedezési adatokat és a szomszédos bejegyzések kimenetét; elhagyja az oEmbed-felfedezést és a tárhely szkriptjeit; letiltja a XML–RPC értékeket, a pingbackeket és a távoli szerkesztő felderítését; eltávolítja az általános core frontend-eszközöket; alkalmazza a képkimenet alapértelmezéseit; az editorokon kívül korlátozza a Heartbeatet; előre betölti a webhelyen belüli dokumentumokat rámutatáskor vagy fókuszálási szándék esetén; és a Blockstudio képbetöltőjét használja.

Minden gyermekérték felülírja a profilbeállítást, ahogy fent a `preload.links` is. Elsőként a core frontend-eszközök eltávolítását érdemes tesztelni, mert látható hibát okoz, ha egy oldal ezekre támaszkodik. A `Runtime_Settings::current()` megjeleníti a feloldott profilt.

A `themeDefaults` két olyan feladatot lát el, amelyet a témák egyébként maguk oldanak meg: `titleTag` és `suppressDirectoryUpdates` elrejti az aktív gyermek- és szülőtémát a frissítési találatok közül.

### Típusos beállításelérés

A `Blockstudio\Settings` valódi típusokkal olvassa be a konfigurációt, ahelyett, hogy azt adná vissza, amit a JSON tárolt.

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

A hibás JSON feldolgozását a `Settings::errors()` jelzi, ahelyett, hogy alapértelmezett értékeket adna vissza. A `Settings::get_raw()` csak azt adja vissza, amit az aktív forrás deklarált, így megkülönböztethető a `false` értékre állított érték attól, amelyet sosem állítottak be.

A `Settings::fingerprint()` stabil identitást ad az érvényes beállításokhoz, az elérés pedig újratölt, ha megváltozik a `blockstudio.json`.

### Egyetlen gyorsítótárkönyvtár

Mostantól minden generált fájl a `cache.path` alatt található, amelynek alapértelmezett értéke `wp-content/blockstudio/cache`.

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

A build adatai, a blokkregisztrációs adatok, a szerkesztő eszközei, a lefordított Tailwind CSS, a renderelt dokumentumok, a szigettöredékek, a statikus HTML fájlok, a gráfindexek, a várósorok és a diagnosztikai adatok mind ebben a gyökérkönyvtárban találhatók. Relatív útvonal esetén az alap `WP_CONTENT_DIR`, abszolút útvonallal pedig külön kötet adható meg.

Az objektumokat az aktuális hálózat és webhely, majd a futásidejű identitás szerint tároljuk. Ez a Blockstudio, a WordPress és a PHP verzióinak, az érvényes beállításoknak, az aktív témának és bővítményeknek, a feltárási forrásoknak, valamint az érintett forrásfájloknak az ujjlenyomata. Ha egy bemenet megváltozik, az érintett objektumok újak lesznek, a régieket pedig eltávolítjuk.

A hideg buildek egyszerre csak egyszer futnak le: egy kérés felépíti és atomikusan közzéteszi az eredményt, a többi pedig várakozik. Sikertelen frissítéskor továbbra is az utolsó jó objektumot szolgáljuk ki, miközben a hiba megfigyelhető marad; a `Blockstudio\Runtime_Cache::purge('tailwind')` pedig egyetlen hatókört töröl.

## Statikus előrenderelés

A statikus előrenderelés teljes, anonim HTML dokumentumokat gyorsítótáraz, és még a WordPress elindulása előtt ki tudja szolgálni őket. Alapértelmezés szerint ki van kapcsolva.

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

### Jogosultsági feltételek

Csak a teljes, anonim HTML dokumentumok jogosultak. A nem GET-kérések, a lekérdezési karakterláncok, az adminisztrációs felület, a REST, az Ajax, a cron, a feedek, a keresés, az előnézetek, a nonce-ot tartalmazó kérések, a személyre szabott sütik és a `dynamicPaths` alatti útvonalak megkerülik a gyorsítótárat. Egy válasz a `<!-- blockstudio:no-cache -->` jelölővel teljesen kiiratkozhat.

Az útvonalillesztés figyelembe veszi a határokat, ezért a `/account` illeszkedik a `/account/orders` útvonalra, de a `/accounting` útvonalra nem.

### Aláírási és gráfmódok

A `invalidate` határozza meg a bejegyzések lejáratát. Az alapértelmezett `signature` mód névtelen gyorsítótárhiány esetén az identitáskulccsal ellátott választ tölti fel, és a webhely szintű változások után új identitást hoz létre; ez egy átlagos webhelyhez megfelelő.

A `graph` módot kifejezetten buildelésre és telepítésre szolgáló eszközökhöz tervezték. Rögzíti az egyes oldalak saját forrásfüggőségeit, így egy terv csak az érintett URL-eket építi újra.

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

### Korai kiszolgálás

Ha engedélyezve van a `earlyServe`, a Blockstudio minden webhelyhez egy kis útvonaltérképet és egy `advanced-cache.php` drop-int kezel, amely még a WordPress, a bővítmények vagy a téma indulása előtt streameli a jogosult találatokat.

Soha nem ír felül más által létrehozott térképet, drop-int vagy `WP_CACHE` deklarációt. A gráf-artefaktum ellenőrzi az összes hivatkozott HTML fájlt a térkép lecserélése előtt, így egy részben renderelt telepítés esetén az előző gráf marad aktív. A többhelyes bejegyzéseket a gazdagép, az alapútvonal és a webhelyazonosító szerint elkülönítjük.

### Előmelegítés és állapot

Három WP-CLI parancs fedi le a mindennapi használatot:

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

A `status` jelenti az aktív identitást, a fájlok és bájtok számát, a gráfrekordokat, a várólista állapotát, valamint a hatókörönkénti találatok, hiányok, buildek és hibák számlálóit.

## Elemzési és ügynökeszközök

### Elemzési presetek

A `blockstudio/phpstan` a blokkelemzés fölé három réteget ad, valamint egy parancsot, amely a projekt által kiválasztott réteget futtatja.

| Preset | Mit ad hozzá |
| --- | --- |
| `base` | A meglévő séma-, sablon-, hook-, beállítás- és API-elemzést. |
| `theme` | Témagyökerek, stílusfejlécek, eszközök, szelektorkörök, mezőalapértékek és ismétlőhatárok. |
| `extreme-theme` | PHPStan `max`, nem biztonságos PHP, escape-elés, Tailwind, JavaScript és Interactivity-ellenőrzések. |
| `wordpress-render` | A hívó által megadott élő renderelési próba a `extreme-theme` fölött. |

Az alapértékek a `blockstudio.json`-ból származnak, így az interaktív futtatások, a CI és a commit hookok ugyanazt a konfigurációt használják:

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

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

Kilépési kódok: `0` siker esetén, `1` diagnosztikai üzenetek esetén, `2` pedig érvénytelen használatkor. A wrapper a konfigurációt a rendszer ideiglenes könyvtárában állítja össze, így nem kerül generált konfiguráció, alapállapot vagy gyorsítótár a projektbe, és a PHPStan memóriakorlátját `1G`-ra emeli.

A csomag egy BC Math-szolgáltatót is tartalmaz, így a JavaScript ellenőrzésekhez már nincs szükség a `ext-bcmath` használatára.

### Kezelt commit hook

Egy beállítással és egy paranccsal a konfigurált preset commitkapuvá alakítható.

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

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

A szinkronizálás a hookot és a tulajdonosi rekordot a Git közös könyvtárába írja, a `core.hooksPath` útvonalát a kezelt könyvtárra állítja, és láncba fűzi a korábban beállított pre-commit hookot. A hook commitkor oldja fel a tároló és a projekt gyökérkönyvtárát, így a csatolt checkoutok és a szóközt tartalmazó útvonalak is működnek.

A hook csak a `vendor/bin/blockstudio-phpstan` parancsot futtatja, mást nem; soha nem formázza át és nem írja át a fájlokat. Ha a `commit` értékét `false`-ra állítod, majd újra szinkronizálsz, vagy futtatod a `blockstudio-githooks remove` parancsot, visszaállítja a rögzített hook útvonalát, és csak a Blockstudio által kezelt fájlokat törli.

### Projektmegállapodás

A `blockstudio-agents` létrehoz egy `AGENTS.md` fájlt, amely leírja, hol találhatók a blokkok, mit jelent az oldal ebben a projektben, mely funkciók vannak engedélyezve, és mit utasít el az elemző.

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

A dokumentum levezetett, nem sablon alapján készül. Egy `style.css` fejléccel, blokkokkal és fájlalapú oldalakkal rendelkező téma más megállapodást kap, mint egy olyan bővítmény, amely csak blokkokat regisztrál; a megállapodás tartalmazza a beolvasó által talált darabszámokat, könyvtárakat, névtereket és sablonnyelveket. A `blockstudio.json` határozza meg, mely funkciók jelennek meg, ezért a statikus előrenderelést nem használó projektekben annak említése sem szerepel.

A helyességi szakasz a kiválasztott preset saját szabályfájljaiból épül fel, rétegenként, ezért ha a preset új szabályt kap, az minden generált megállapodásban megjelenik.

A tulajdonjog kezelése a commit hookéhoz hasonló. Ha egy fájlból hiányzik a generált jelölő, a rendszer megtagadja a lecserélését, kivéve ha a `--force` másként rendelkezik; a végén található megjegyzésrész megmarad újrageneráláskor; a `--check` `1` értékkel lép ki, ha a megállapodás elavult; a `--stdout` pedig a fájlrendszer érintése nélkül írja ki.

### Dokumentációs index

A `blockstudio-llm.txt` mostantól index, nem összefűzött dokumentum. Minden közzétett dokumentum egyszer jelenik meg, a saját szakaszában és alszakaszában, az útvonalával, a forrásfájljával, egysoros leírásával és a hozzá tartozó azonosítókkal: beállítási útvonalak, hooknevek, PHP függvények és osztályok, valamint parancsok.

```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()
```

Az ügynök beolvassa az indexet, megkeresi azt az egy dokumentumot, amelyhez az őt érdeklő azonosító tartozik, majd megnyitja azt. A korábbi, fél megabájtos összefűzött fájl továbbra is létrejön és közzétételre kerül itt: `/blockstudio-llm-full.txt`; már nem ezt kapja meg elsőként mindenki.

## Kanonikus blokkcímkék

Egy önálló parancs a prefix- és aliasrövidítéseket a kanonikus `<bs:namespace-slug>` alakra írja át, amely rögzíti a valódi blokknevet, és betöltött projekt szűrő nélkül is feloldható.

`brand` előtaggal a `theme-components` esetén, és `ui` előtaggal a `bsui` esetén ez a rövidítés:

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

ugyanazt jelenti, mint:

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

Az előtagok és a pontos aliasok továbbra is működnek, és nincsenek elavultnak nyilvánítva. A parancs nem tölti be a WordPress-t, és `--apply` nélkül nem ír semmit:

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

A `--prefix-map` minden előtagot hozzárendel a névtereihez, a `--known-blocks` pedig felsorolja a regisztrált blokkneveket. A jelentés rögzíti a régi és kanonikus alakok közötti leképezéseket az előfordulások számával, a fájlonkénti hash-ekkel, valamint az ismeretlen címkék, a kétértelmű aliasok és a dinamikus címkék külön listáival. A `--apply` nem hajlandó írni, amíg bármelyik ilyen eset fennáll, kivéve ha meg van adva a `--allow-unresolved`.

A páros, egymásba ágyazott és önlezáró jelöléseket is kezeli, beleértve a karakterláncokban szereplő szó szerinti címkéket is: PHP. Csak a címkenevek változnak, a második futtatás nem eredményez módosításokat, a megjegyzésekben, kódblokkokban, `<pre>`-ben vagy `<code>`-ben szereplő példák pedig csak a jelentésben jelennek meg.

## Alapértelmezett működés

A 7.6 telepítése önmagában semmit sem változtat.

**A teljesítményprofil alapértelmezése: `compat`.** A fejléc kimenete, az oEmbed, a XML-RPC, a Heartbeat, a képek alapértelmezései, a hivatkozások előbetöltése, a lusta betöltés és a frontend `<title>` beállításai olyanok maradnak, ahogy a WordPress és a téma meghagyta őket.

**Ezek kikapcsolva maradnak, amíg nem engedélyezi őket:** minden `performance.staticPrerender`, `performance.measurement`, `performance.media` és `themeDefaults` kulcs, továbbá a `githooks.commit`, `dev.canvas.enabled`, `ui.enabled`, `tailwind.enabled` és `blockTags.enabled`. Kikapcsolt állapotban a statikus előrenderelés nem ír fájlokat és nem telepít drop-in fájlt.

**A Canvas és a Render passzív.** Beolvassák a meglévő regisztereket, és csak azt jelenítik meg, amit a hívó kér; egyik sem kapcsolódik be a frontend kimenetébe, és útvonalakat sem regisztrál. A Canvas adminisztrációs képernyőjéhez továbbra is szükséges a `dev.canvas.enabled` és a `edit_posts`.

**Szigorúbb elemzéshez név szerint kell megadni.** A `blockstudio/phpstan` telepítése csak az alapbővítményt engedélyezi, a kanonikus parancs pedig a `base` beállítást futtatja, hacsak a projekt nem nevez meg egy előbeállítást.

**A generált fájlok létrehozásához futtatni kell a hozzájuk tartozó parancsot.** A `githooks.commit` nem csinál semmit, amíg nem fut le a `blockstudio-githooks sync`, ahogy a `AGENTS.md` sem, amíg le nem fut a `blockstudio-agents`.

## Frissítés 7.5-ről

A követelmények nem változtak: PHP 8.2 vagy újabb, WordPress 6.7 vagy újabb.

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

**A gyorsítótárak egyszer épülnek újra.** A futásidejű identitás része a Blockstudio verziója, ezért a frissítés utáni első kérés hidegindítású, a régi objektumok pedig törlődnek. A régi Tailwind gyorsítótár törölhető innen: `wp-content/uploads/blockstudio/tailwind/cache`; az ezt glob mintával beolvasó kódrészlet helyette a `Blockstudio\Runtime_Cache::purge('tailwind')` függvényt hívja.

A 7.6 előtti, lapos `wp-content/blockstudio/cache/runtime` könyvtár automatikusan kikerül az aktív útvonalból, majd korlátozott WP-Cron műveletek távolítják el. Így a régi, nagyméretű zárolásifájl-fákat nem kell egy telepítési kérés során törölni.

**A generált fájloknak van felelősük.** A `assets/media.json` verziókezelőbe vagy egy buildlépésbe tartozik. Az útvonaltérkép, a `advanced-cache.php` drop-in fájl és a `WP_CACHE` deklaráció csak akkor létezik, ha a `earlyServe` engedélyezve van; az előzetes commit hook pedig csak szinkronizált állapotban. Minden más generált fájl a `cache.path` alatt található, és biztonságosan törölhető.

**Semmit sem távolítottak el és semmit sem neveztek át.** A `bs_render_block()`, a `bs_block()`, a `Blockstudio\Pages` és a `Blockstudio\Patterns` továbbra is a fájlalapú tartalom kanonikus felületei.

**A visszaállítás funkciónként történik.** A `performance.profile` visszaállítása erre: `compat`; a `staticPrerender.enabled` visszaállítása erre: `false`; a `githooks.commit` visszaállítása erre: `false` egy `sync` mellett; valamint a `cache.enabled` visszaállítása erre: `false` egy-egy réteget von vissza.

Egy ésszerű bevezetési sorrend:

1. Állítsa a `performance.profile` értékét erre: `speed`, majd ellenőrizze a fejléc kimenetét, a feedeket és minden olyan bővítményt, amely az oEmbedre vagy a XML-RPC funkcióra támaszkodik.
2. Generálja le a `assets/media.json`-t, helyezze át a sablonokat a `bs_media_image()` alá, majd kapcsolja be a `performance.media.lazy`-t.
3. Engedélyezze a `performance.staticPrerender`-t kikapcsolt `earlyServe` mellett, ellenőrizze a találatokat a `wp bs prerender status` segítségével, majd kapcsolja be a `earlyServe`-t.
4. Futtassa a `blockstudio-phpstan --preset theme`-t, amíg tiszta nem lesz, és csak ezután helyezzen bármilyen előbeállítást a `githooks.commit` mögé.

## Hol találhatók a részletek

- [Canvas](https://blockstudio.dev/hu/docs/dev/canvas/) és annak [leltára, valamint a dokumentum API](https://blockstudio.dev/hu/docs/dev/canvas/#public-inventory-and-document-api)
- [Megjelenítés](https://blockstudio.dev/hu/docs/blocks/rendering/#structured-compositions-and-complete-documents), [UI komponensek](https://blockstudio.dev/hu/ui/#public-inventory-and-examples) és a [UI kompozíció](https://blockstudio.dev/hu/ui/composition/)
- [Beállítások](https://blockstudio.dev/hu/docs/general/settings/) és [teljesítmény](https://blockstudio.dev/hu/docs/general/settings/#performance)
- [Teljesítmény](https://blockstudio.dev/hu/docs/production/performance/), [gyorsítótárazás](https://blockstudio.dev/hu/docs/production/caching/) és [statikus előrenderelés](https://blockstudio.dev/hu/docs/production/static-prerendering/)
- [Tailwind CSS](https://blockstudio.dev/hu/docs/tailwind/#template-composition-helpers)
- [PHPStan](https://blockstudio.dev/hu/docs/dev/phpstan/): [előbeállítások](https://blockstudio.dev/hu/docs/dev/phpstan/#analysis-presets), [kanonikus parancs](https://blockstudio.dev/hu/docs/dev/phpstan/#canonical-command), [kezelt commit hook](https://blockstudio.dev/hu/docs/dev/phpstan/#managed-commit-hook) és a [projekt szerződése](https://blockstudio.dev/hu/docs/dev/phpstan/#project-contract-for-coding-agents)
- [AI-integráció](https://blockstudio.dev/hu/docs/dev/ai/): a dokumentációs index és a teljes szöveg
- [Migráció](https://blockstudio.dev/hu/docs/dev/migration/v7/#canonical-block-tags) és [PHP hookok](https://blockstudio.dev/hu/docs/blocks/hooks/php/)
