
Blockstudio Verzia 7.6 umožňuje čítať a vykresľovať projekt z PHP a presúva predvolené nastavenia produkčného frontendu do `blockstudio.json`: inventár API, samostatné vykresľovanie, pomocné funkcie šablón pre médiá a Tailwind, profily výkonu, jeden adresár vyrovnávacej pamäte, predbežné statické vykresľovanie s včasným poskytovaním, prísnejšie predvoľby analýzy a generované nástroje projektu pre programovacích agentov.

Dve volania pokrývajú väčšinu možností vydania. `Canvas::inventory()` vráti každú stránku, blok, vzor, šablónu editora webu, časť šablóny a príklad pribaleného UI zaregistrovaný v projekte. `Render::document()` vráti hotové HTML pre ktorúkoľvek z nich spolu s presne tými prostriedkami, ktoré sa použili pri vykreslení.

> **Aktualizácia 7.6.2:** Stránky zo súborov sa už nezosúlaďujú počas bežných požiadaviek WordPress. Pri uplatňovaní zmien zdrojov spustite `wp bs pages sync` alebo zavolajte `Blockstudio\Pages::reconcile()`. Predvolené nastavenia smerovania kolekcií a `templateFor` používajú uloženú konfiguráciu runtime prostredia a výslovné zosúladenie sa vyhýba predchádzajúcemu rozsiahlemu viacjazyčnému dopytu OR-meta. Krátkodobá možnosť `themeDefaults.syncPagesInDevelopment` bola odstránená, pretože synchronizácia stránok už neprebieha z hákov požiadaviek. `Pages::init()` teraz slúži iba na zavedenie; integrácie, ktoré odovzdávali `force`, musia použiť `Pages::reconcile()` alebo CLI. Otvorenie Canvasu naďalej vykoná jedno výslovné, overené zosúladenie inventára pre tvorbu obsahu.

> **7.6.12 aktualizácia:** Štýly editora sa teraz dopĺňajú o prefixy v jednom prepisovacom kroku namiesto kompilácie SASS pre každý súbor, takže zostavenie editora za studena na webe s mnohými blokmi už nehrozí prekročením skromného limitu pamäte. Stránka z predpripraveného vykreslenia uložená v cache, ktorej štýl Tailwind s hashom obsahu bol odstránený, sa vykreslí znova namiesto toho, aby sa zobrazila bez štýlov, a to cez cache PHP aj doplnok Early Serve. Atribúty blokov zapísané na najvyššej úrovni sa pri vykreslení načítajú namiesto zahodenia, takže schéma Blockstudio zaregistrovaná v `WP_Block_Type` sa uplatní aj pri programovom zápise.

> **7.6.11 aktualizácia:** Inštalácia artefaktov grafu teraz atómovo nahradí dokument trasy, keď sa kópia v úložisku zmenila pod tým istým kľúčom, nezmenené dokumenty ponechá bez zásahu a cez `Static_Prerender_Early_Serve::last_promotion()` hlási povýšené, nahradené, preskočené a ponechané trasy.

> **7.6.10 aktualizácia:** Zásahy do runtime cache teraz rozpoznajú odstránené skompilované súbory aj počas oneskorenia sledovania zmien a ploché runtime cache staršie než 7.6 sa atómovo umiestnia do karantény a odstránia v obmedzených dávkach cron. Globálne premenné UI v balíku sa vypíšu raz na stránku. Early Serve v režime grafu môže obsluhovať trasy vykreslené za behu, ktoré nie sú v nasadenej mape trás, z cache identít. Tailwind môže voliteľne vytvoriť súbor cache s hashom obsahu pomocou `tailwind.output: "link"`; predvolene sa výstup vkladá priamo.

Stručne:

- **Prehľad projektu**: `Canvas::inventory()` vráti všetky zaregistrované záznamy spolu so zdrojmi a stabilným poradím zobrazenia.
- **Cielený výber**: pomenovanie blokov a stránok obmedzí vyhľadávanie, synchronizáciu, vykresľovanie a kompiláciu na tieto záznamy.
- **Samostatné vykreslenie**: `Blockstudio\Render` vráti hotové HTML pre blok, kompozíciu alebo celý dokument.
- **Rodiny komponentov UI**: `Blockstudio\Ui` zoskupí pribalenú knižnicu do jednej verejnej rodiny pre každý komponent, ku každej pridá príklad.
- **Stabilné rozmery obrázkov**: `bs_media_image()` vykreslí zdroje témy so skutočnými rozmermi z vygenerovaného `assets/media.json`.
- **Pomocné funkcie tried Tailwind**: `bs_tw_merge()` a `bs_tw_variants()` skladajú triedy v PHP a zlučujú ich s ohľadom na konflikty.
- **Výkonnostné profily**: `performance.profile` naraz zapne predvolené nastavenia produkčného frontendu; hodnoty podriadených nastavení majú prednosť.
- **Prístup k typovaným nastaveniam**: `Settings::get_bool()` a jeho príbuzné funkcie čítajú `blockstudio.json` so skutočnými typmi a zobrazujú chyby pri parsovaní.
- **Jeden adresár cache**: každý vygenerovaný súbor sa nachádza pod `cache.path` a je označený identitou runtime prostredia.
- **Statické predvykresľovanie**: anonymné dokumenty HTML možno ukladať do cache, zneplatniť cez graf závislostí a poskytnúť ešte pred spustením WordPress.
- **Predvoľby analýzy**: `theme`, `extreme-theme` a `wordpress-render` rozširujú `blockstudio/phpstan` aj nad rámec šablón blokov.
- **Spravovaná kontrola pri commite**: `blockstudio-githooks sync` vytvorí a spravuje kontrolný skript pred commitom, ktorý spustí nakonfigurovanú predvoľbu.
- **Zmluva projektu**: `blockstudio-agents` vytvorí súbor `AGENTS.md`, ktorý opisuje, čo projekt tvorí, ktoré funkcie zapína a čo jeho predvoľba vynucuje.
- **Index dokumentácie**: súbor kontextu pre AI teraz obsahuje index každého dokumentu, jeho účelu a identifikátorov, ktoré spravuje.
- **Kanonické značky blokov**: samostatný príkaz prepíše skrátené zápisy prefixov a aliasov na `<bs:namespace-slug>`; podporuje aj skúšobný režim.
- **Kompatibilita v predvolenom nastavení**: nič z uvedeného nezmení web, kým sa to výslovne neuvedie v `blockstudio.json`.

## Čítanie a vykresľovanie projektu

### Prehľad projektu

`Canvas::inventory()` vráti všetko, čo projekt zaregistruje, ako jedno obyčajné pole bez toho, aby čokoľvek vykreslil.

```php
use Blockstudio\Canvas;

$result = Canvas::inventory();

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

Záznamy sú zoskupené podľa typu: `pages`, `blocks`, `patterns`, `templates`, `parts` a `ui`. `order` určuje stabilné poradie zobrazenia naprieč všetkými typmi, `sources` mapuje každý záznam na jeho zdrojové cesty a `warnings` a `errors` zhromažďujú problémy v podobe štruktúrovaných záznamov.

Záznamy blokov obsahujú `id`, `name`, `title`, `source`, `path`, `provenance` a `declaration` pripravené na vykreslenie. Záznamy stránok uchovávajú `source` ako stabilnú identitu a `path` ako šablónu na vykreslenie.

### Cielený výber

Pomenovaním záznamov obmedzíte vykonávanú prácu, namiesto toho, aby ste výsledky filtrovali až dodatočne.

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

Výsledkom je jeden blok a jedna stránka. `patterns`, `templates`, `parts` a `ui` budú prázdne a ich zdroje sa nikdy nenačítajú, nesynchronizujú, nevykreslia ani neskompilujú.

Pravidlá sú presné:

- Ak neuvediete žiadne kľúče typov, načítajú sa všetky typy.
- `true`, `null` alebo `"*"` načíta všetky záznamy daného typu.
- Reťazec alebo zoznam presne zodpovedá ID, názvu, slug-u, ceste alebo zdrojovej ceste.
- Prázdny reťazec, prázdny zoznam alebo `false` nenačíta žiadny záznam daného typu.
- Keď uvediete kľúč aspoň jedného typu, vynechané typy zostanú bez zmeny.

Neexistujúce identifikátory sa vrátia pod `deleted` namiesto toho, aby vyvolali chybu, a obnovovací koncový bod Canvas REST uplatňuje rovnaké pravidlo na svoje parametre `blocks` a `pages`.

`Canvas::documents()` používa rovnaký výber a pridá jeden vykreslený dokument pre každý záznam. Vybrané stránky sa vykreslia v obnovenom kontexte frontendu, takže podmienené výrazy dotazu, triedy tela, shortcody, rozloženia, presmerovania a funkcie enqueue pracujú s danou stránkou, nie so stránkou požiadavky, ktorá o vykreslenie požiadala.

### Samostatné vykresľovanie

`Blockstudio\Render` vráti vykreslené HTML ako reťazec cez rovnaký postup, aký používa frontend.

```php
use Blockstudio\Render;

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

Vychádza sa z jedného tvaru deklarácie so štyrmi kľúčmi: `name`, `attributes`, `content` a `children`. `root`, `data`, `inner`, `innerBlocks`, `layers` a `example` sú pohodlnejšie vstupné možnosti, ktoré doň zlúči `Render::normalize()`. Podriadené prvky sa vykresľujú rekurzívne a pri nesprávnom vstupe sa vyvolá výnimka s názvom problematického bloku.

`Render::document()` obalí výstup do úplného samostatného dokumentu HTML.

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

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

`body` obsahuje iba výstup bloku, `html` zostavený dokument, `blocks` názvy blokov, ktoré prispeli k výsledku, a `assets` rozdelí značky na `head`, `footer`, `styles`, `scripts`, `modules`, `interactivity`, `ui` a `tailwind`. Zdroje sú obmedzené na obsah vykreslenia, takže sa nezobrazia zdroje určené iba pre editor.

`Render::document_from_html()` obalí HTML vykreslený inde a `Render::content()` vykreslí serializovaný obsah bloku bez dokumentu. Medzi dokumentmi v jednom procese PHP zavolajte `Blockstudio\Batch_Render::reset()`; `Canvas::documents()` to už robí.

### Rodiny komponentov UI

`Blockstudio\Ui` sprístupňuje pribalenú knižnicu UI ako jednu položku pre každý verejný komponent namiesto zoznamu interných častí.

`Ui::inventory()` vráti jednu položku pre každú rodinu s jej koreňovým blokom, názvom a potrebnými implementačnými blokmi. `Ui::examples()` pridá pre každú rodinu deterministickú deklaráciu: zachová predvolené hodnoty, požadované podriadené vrstvy vnorené pod rodičov a stabilný ukážkový text tam, kde by pole zostalo prázdne. Táto deklarácia je kanonická, takže ju možno použiť priamo v `Render::document()`.

Canvas zoskupuje položky rovnako. Pribalené UI sa zobrazujú pod typom `ui` ako jeden príklad pre každú rodinu a implementačné registrácie sa v `blocks` nezobrazujú.

Rodiny sú navrhnuté na skladanie: výberové pole sa otvorí vnútri dialógového okna a jeho zoznam prekryje spúšťač, ponuky a polia kombinovaného výberu zostanú ukotvené na pevných súradniciach výrezu aj pri posúvaní, modálne okná sa vrství a zatvárajú po jednom stlačení klávesu Escape a každá pätička skladá rovnaký ovládací prvok na zatvorenie s variantom. Ako tieto rozhrania fungujú a aké invarianty ich udržiavajú v správnom stave, vysvetľuje kapitola [o skladaní](https://blockstudio.dev/sk/ui/composition/); [/ui/examples](https://blockstudio.dev/sk/ui/examples/) obsahuje živé ukážky kompozícií.

## Pomocné funkcie šablón

### Stabilné rozmery obrázkov

`bs_media_image()` vykresľuje zdroje témy so skutočnou šírkou, výškou a vyhradeným pomerom strán, takže obrázky mimo knižnice médií už nemenia rozloženie.

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

Výstupom je `figure.blockstudio-media` s vloženým `aspect-ratio` okolo `img`, ktoré obsahuje skutočné hodnoty `width`, `height`, `loading` a `decoding`. Rozmery pochádzajú z vygenerovaného `assets/media.json`, ktorý vytvorí `Blockstudio\Media_Metadata_Builder` počas zostavenia alebo sa pripraví ručne.

`src` prijíma cestu relatívnu k téme, absolútnu cestu alebo úplnú hodnotu URL; `attachmentId` slúži pre obrázky z knižnice médií. `eager` vypne lenivé načítavanie nad záhybom stránky a `sources` vytvorí `<picture>`.

Keď je zapnuté `performance.media.lazy`, skutočné URL sa presunie na `data-src` za zástupný prvok so správnymi rozmermi.

### Pomocné funkcie tried Tailwind

`bs_tw_merge()` a `bs_tw_variants()` skladajú triedy Tailwind v šablónach PHP pomocou nástroja Blockstudio, ktorý je už súčasťou enginu.

`bs_tw_merge('px-2 text-sm', 'px-4')` vráti `text-sm px-4`: konfliktná `px-2` sa odstráni a neskoršia hodnota má prednosť. Podporované sú vnorené polia hodnôt tried.

`bs_tw_variants()` vráti malú volateľnú funkciu pre varianty komponentu:

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

Výsledkom je `inline-flex items-center h-12 px-6 rounded`. Podporované sú základné triedy, varianty, predvolené varianty, kombinované varianty a tiež `class` alebo `className` pre každé volanie.

## Produkčná konfigurácia

### Výkonnostné profily

`performance.profile` zapne predvolené nastavenia produkčného frontendu na jednom mieste.

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

`compat` je predvolený a nič nemení. `speed` a `strict` zapínajú rovnakú súpravu: odstránia z hlavičky výstup generátora, emoji, informačného kanála, vyhľadávania a súvisiacich článkov; odstránia vyhľadávanie oEmbed a skripty hostiteľa; vypnú XML-RPC, pingbacky a vzdialené vyhľadávanie editora; odstránia všeobecné zdroje jadra frontendu; nastavia predvolené hodnoty výstupu obrázkov; obmedzia Heartbeat mimo editorov; prednačítajú dokumenty z rovnakej domény pri prejdení kurzorom alebo zámere zaostrenia a použijú načítavač obrázkov z Blockstudio.

Každá podriadená hodnota má prednosť pred profilom, ako ukazuje `preload.links` vyššie. Najskôr otestujte odstránenie zdrojov jadra frontendu, pretože stránka, ktorá od nich závisí, bude viditeľne poškodená. `Runtime_Settings::current()` sprístupňuje vyriešený profil.

`themeDefaults` pokrýva dve veci, ktoré by si témy inak museli pripraviť samy: `titleTag` a `suppressDirectoryUpdates`, ktoré skryjú aktívnu podriadenú aj nadradenú tému pred výsledkami aktualizácií.

### Prístup k typovaným nastaveniam

`Blockstudio\Settings` číta konfiguráciu so skutočnými typmi namiesto vrátenia čohokoľvek, čo obsahovalo 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);
}
```

Nesprávne vytvorená hodnota JSON sa oznámi cez `Settings::errors()` namiesto toho, aby sa nahradila predvolenými hodnotami. `Settings::get_raw()` vráti iba hodnoty deklarované aktívnym zdrojom, vďaka čomu možno odlíšiť hodnotu nastavenú na `false` od hodnoty, ktorá nebola nikdy nastavená.

`Settings::fingerprint()` vráti stabilnú identitu efektívnych nastavení a prístup k nastaveniam ich znovu načíta, keď sa zmení `blockstudio.json`.

### Jeden adresár cache

Každý vygenerovaný súbor sa teraz nachádza pod `cache.path`, ktorého predvolená hodnota je `wp-content/blockstudio/cache`.

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

Dáta zostavenia, registračné údaje blokov, zdroje editora, skompilované Tailwind CSS, vykreslené dokumenty, fragmenty ostrovov, statické HTML, indexy grafu, fronty na predhriatie a diagnostika sa nachádzajú v tomto koreňovom adresári. Relatívna cesta sa vyhodnotí vzhľadom na `WP_CONTENT_DIR`, absolútna cesta ho nasmeruje na vyhradený zväzok.

Objekty sa ukladajú podľa aktuálnej siete a webu a potom podľa identity runtime prostredia: odtlačku verzií Blockstudio, WordPress a PHP, efektívnych nastavení, aktívnej témy a doplnkov, zdrojov vyhľadávania a použitých zdrojových súborov. Po zmene vstupu vzniknú nové dotknuté objekty a staré sa odstránia.

Prvé zostavenia sa vykonávajú po jednom: jedna požiadavka zostaví a atómovo zverejní výsledok, kým ostatné čakajú. Ak sa obnovenie nepodarí, naďalej sa poskytuje posledný správny objekt a chyba zostáva zaznamenaná. Funkcia `Blockstudio\Runtime_Cache::purge('tailwind')` vymaže jeden rozsah.

## Statické predvykresľovanie

Statické predvykresľovanie ukladá celé anonymné dokumenty HTML do cache a môže ich poskytovať ešte pred spustením WordPress. V predvolenom nastavení je vypnuté.

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

### Podmienky zaradenia

Zaradiť možno iba úplné anonymné dokumenty HTML. Obchádzajú sa požiadavky, ktoré nepoužívajú GET, požiadavky s reťazcami dotazu, administrácia, REST, Ajax, cron, informačné kanály, vyhľadávanie, náhľady, požiadavky obsahujúce nonce, personalizované súbory cookie a všetky cesty pod `dynamicPaths`. Odpoveď možno úplne vylúčiť pomocou značky `<!-- blockstudio:no-cache -->`.

Pri porovnávaní ciest sa rešpektujú hranice, takže `/account` zahŕňa `/account/orders`, ale nie `/accounting`.

### Režimy podpisu a grafu

`invalidate` určuje, ako záznamy vypršia. Predvolený režim `signature` pri anonymnej požiadavke bez zásahu naplní odpoveďou položku označenú identitou a po zmenách na úrovni webu ju obnoví; hodí sa preto pre bežný web.

Režim `graph` je určený pre výslovné nástroje na zostavenie a nasadenie. Zaznamenáva vlastné zdrojové závislosti každej stránky, takže plán znovu zostaví iba dotknuté URL.

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

### Včasné poskytovanie

Keď je zapnuté `earlyServe`, Blockstudio spravuje malú mapu trás pre každý web a doplnok `advanced-cache.php`, ktorý odošle vhodný zásah do cache ešte pred spustením WordPress, doplnkov alebo témy.

Nikdy neprepíše cudziu mapu, doplnok ani deklaráciu `WP_CACHE`. Artefakt grafu pred výmenou mapy overí každý odkazovaný súbor HTML, takže neúplne vykreslené nasadenie ponechá aktívny predchádzajúci graf. Položky vo viacerých weboch zostávajú oddelené podľa hostiteľa, domovskej cesty a ID webu.

### Predhrievanie a stav

Na každodenné používanie slúžia tri príkazy WP-CLI:

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

`status` hlási aktívnu identitu, počet súborov a bajtov, záznamy grafu, stav frontu a počítadlá zásahov do cache, minutí, zostavení a zlyhaní pre jednotlivé rozsahy.

## Analýza a nástroje pre agentov

### Predvoľby analýzy

`blockstudio/phpstan` pridáva k analýze blokov tri vrstvy a jeden príkaz na spustenie vrstvy vybratej projektom.

| Predvoľba | Čo pridáva |
| --- | --- |
| `base` | Existujúca analýza schémy, šablón, hookov, nastavení a API. |
| `theme` | Korene témy, hlavičky štýlov, zdroje, rozsahy selektorov, predvolené hodnoty polí a hranice opakovačov. |
| `extreme-theme` | PHPStan `max`, nebezpečné PHP, escapovanie, Tailwind, JavaScript a kontroly Interactivity. |
| `wordpress-render` | Skúšobné živé vykreslenie dodané volajúcim, navyše k `extreme-theme`. |

Predvolené hodnoty pochádzajú z `blockstudio.json`, takže interaktívne spustenia, CI a kontroly pri commite zdieľajú jednu konfiguráciu:

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

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

Návratové kódy sú `0` pri úspechu, `1` pri diagnostike a `2` pri neplatnom použití. Obal zostaví konfiguráciu v dočasnom systémovom adresári, takže v projekte nezostane vygenerovaná konfigurácia, základná línia ani cache, a zvýši pamäťový limit PHPStan na `1G`.

Súčasťou balíka je aj poskytovateľ BC Math, takže kontroly JavaScript už nepotrebujú `ext-bcmath`.

### Spravovaná kontrola pri commite

Jedno nastavenie a jeden príkaz zmenia nakonfigurovanú predvoľbu na podmienku povolenia commitu.

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

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

Synchronizácia zapíše kontrolný skript a záznam o jeho správe do spoločného adresára Git, nasmeruje `core.hooksPath` na spravovaný adresár a nadviaže na prípadný predtým nakonfigurovaný kontrolný skript pred commitom. Skript pri commite zistí koreňový adresár úložiska a projektu, takže funguje aj pri prepojených pracovných kópiách a cestách obsahujúcich medzery.

Kontrolný skript spustí `vendor/bin/blockstudio-phpstan` a nič iné; súbory nikdy neformátuje ani neprepisuje. Nastavením `commit` na `false` a opätovnou synchronizáciou alebo spustením `blockstudio-githooks remove` sa obnoví zaznamenaná cesta ku kontrolnému skriptu a odstránia sa iba súbory spravované cez Blockstudio.

### Zmluva projektu

`blockstudio-agents` vytvorí súbor `AGENTS.md`, ktorý uvádza, kde sa nachádzajú bloky, čo v tomto projekte predstavuje stránka, ktoré funkcie sú zapnuté a čo analyzátor odmietne.

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

Dokument sa odvodzuje od projektu, nejde o šablónu. Téma s hlavičkou `style.css`, blokmi a stránkami založenými na súboroch dostane inú zmluvu než doplnok, ktorý registruje iba bloky; zmluva obsahuje počty, adresáre, menných priestorov a jazyky šablón, ktoré skener našiel. O tom, ktoré funkcie sa uvedú, rozhoduje `blockstudio.json`, takže projekt bez statického predvykresľovania ho v dokumente vôbec nespomenie.

Časť o správnosti sa načítava priamo zo súborov pravidiel vybratej predvoľby, vrstvu po vrstve. Keď predvoľba získa nové pravidlo, zmenia sa všetky zmluvy, ktoré sa podľa nej vytvoria.

Správa vlastníctva funguje podobne ako pri kontrolnom skripte pri commite. Súbor bez značky vygenerovaného obsahu sa odmietne namiesto prepísania, ak `--force` neurčuje inak; oblasť poznámok na konci sa pri opätovnom vytvorení zachová; `--check` vráti kód `1`, keď je zmluva neaktuálna, a `--stdout` ju vypíše bez zásahu do súborového systému.

### Index dokumentácie

`blockstudio-llm.txt` je teraz indexom namiesto zreťazeného textu. Každý zverejnený dokument sa uvádza raz, vo svojej sekcii a podsekcii, spolu s trasou, zdrojovým súborom, stručným opisom účelu a identifikátormi, ktoré spravuje: cesty nastavení, názvy hookov, funkcie a triedy PHP a príkazy.

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

Agent si prečíta index, nájde jediný dokument, ktorý obsahuje identifikátor, o ktorý sa zaujíma, a otvorí ho. Predchádzajúce spojenie s veľkosťou pol megabajtu sa stále vytvára a publikuje na `/blockstudio-llm-full.txt`; už to nie je prvá vec, ktorú každý dostane.

## Kanonické značky blokov

Samostatný príkaz prepíše skratky prefixov a aliasov na kanonický zápis `<bs:namespace-slug>`, ktorý zaznamenáva skutočný názov bloku a rozlíši sa aj bez načítaného filtra projektu.

S prefixom `brand` pre `theme-components` a prefixom `ui` pre `bsui` má táto skratka takýto význam:

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

znamená to isté ako:

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

Prefixy a presné aliasy naďalej fungujú a nie sú zastarané. Príkaz nenačíta WordPress a bez `--apply` nič nezapíše:

```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` mapuje každý prefix na jeho menné priestory a `--known-blocks` uvádza registrované názvy blokov. V správe sú zaznamenané mapovania zo zastaraných názvov na kanonické vrátane počtov výskytov a hashov jednotlivých súborov, ako aj samostatné zoznamy neznámych značiek, nejednoznačných aliasov a dynamických značiek. `--apply` odmietne zapisovať, kým niektoré zostávajú, pokiaľ sa nepoužije `--allow-unresolved`.

Spracúvajú sa párové, vnorené aj samostatne uzatváracie značky vrátane doslovných značiek v reťazcoch PHP. Menia sa iba názvy značiek, druhý priechod neprinesie žiadne zmeny a príklady v komentároch, blokoch kódu, `<pre>` alebo `<code>` sa uvádzajú iba v správe.

## Predvolené správanie

Samotná inštalácia verzie 7.6 nič nemení.

**Profil výkonu má predvolene hodnotu `compat`.** Výstup hlavičky, oEmbed, XML-RPC, Heartbeat, predvolené nastavenia obrázkov, prednačítanie odkazov, lenivé načítavanie a frontendové `<title>` zostávajú v stave WordPress, ktorý nastavila téma.

**Tieto funkcie zostávajú vypnuté, kým ich nezapnete:** všetky kľúče `performance.staticPrerender`, `performance.measurement`, `performance.media` a `themeDefaults`, ako aj `githooks.commit`, `dev.canvas.enabled`, `ui.enabled`, `tailwind.enabled` a `blockTags.enabled`. Kým je statické predgenerovanie vypnuté, nevytvára žiadne súbory ani neinštaluje žiadny doplnok.

**Canvas a Render fungujú pasívne.** Čítajú existujúce registre a vykresľujú iba to, čo od nich volajúci požaduje; nepripájajú sa k výstupu frontendu ani neregistrujú trasy. Obrazovka správy Canvas stále vyžaduje `dev.canvas.enabled` a `edit_posts`.

**Prísnejšiu analýzu treba výslovne pomenovať.** Inštaláciou `blockstudio/phpstan` sa povolí iba základné rozšírenie a kanonický príkaz spustí `base`, pokiaľ projekt neurčí predvoľbu.

**Generované súbory vyžadujú spustenie príslušného príkazu.** `githooks.commit` neurobí nič, kým sa nespustí `blockstudio-githooks sync`, a `AGENTS.md` nič neurobí, kým sa nespustí `blockstudio-agents`.

## Aktualizácia z verzie 7.5

Požiadavky sa nemenia: PHP 8.2 alebo novší, WordPress 6.7 alebo novší.

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

**Vyrovnávacie pamäte sa obnovia raz.** Identita runtime obsahuje verziu Blockstudio, takže prvá požiadavka po aktualizácii bude bez vyrovnávacej pamäte a staré objekty sa odstránia. Starú vyrovnávaciu pamäť Tailwind v `wp-content/uploads/blockstudio/tailwind/cache` možno odstrániť; úryvok kódu, ktorý vyhľadával jej obsah pomocou globu, má namiesto toho volať `Blockstudio\Runtime_Cache::purge('tailwind')`.

Plochý adresár `wp-content/blockstudio/cache/runtime` z verzií pred 7.6 sa automaticky premenuje mimo aktívnej cesty a odstráni v ohraničených priechodoch WP-Cron. Veľké stromy starých uzamykacích súborov preto netreba odstraňovať počas nasadzovacej požiadavky.

**Generované súbory majú určených vlastníkov.** `assets/media.json` patrí do správy verzií alebo do zostavovacieho kroku. Mapa trás, doplnok `advanced-cache.php` a deklarácia `WP_CACHE` existujú iba vtedy, keď je povolené `earlyServe`, a hák pred potvrdením zmien iba vtedy, keď je synchronizovaný. Všetko ostatné generované sa nachádza v `cache.path` a možno to bezpečne odstrániť.

**Nič sa neodstránilo ani nepremenovalo.** `bs_render_block()`, `bs_block()`, `Blockstudio\Pages` a `Blockstudio\Patterns` zostávajú kanonickými povrchmi obsahu založeného na súboroch.

**Vrátenie zmien sa vykonáva pre každú funkciu zvlášť.** Vrátenie `performance.profile` na `compat`, `staticPrerender.enabled` na `false`, `githooks.commit` na `false` spolu s `sync` a `cache.enabled` na `false` vždy zruší jednu vrstvu.

Odporúčaný postup zavádzania:

1. Nastavte `performance.profile` na `speed`, potom skontrolujte výstup hlavičky, kanály a všetky doplnky závislé od oEmbed alebo XML-RPC.
2. Vygenerujte `assets/media.json`, presuňte šablóny do `bs_media_image()` a potom zapnite `performance.media.lazy`.
3. Zapnite `performance.staticPrerender` s vypnutým `earlyServe`, overte požiadavky pomocou `wp bs prerender status` a potom zapnite `earlyServe`.
4. Spúšťajte `blockstudio-phpstan --preset theme`, kým nebude bez chýb, a až potom umiestnite predvoľbu za `githooks.commit`.

## Kde nájdete podrobnosti

- [Canvas](https://blockstudio.dev/sk/docs/dev/canvas/) a jeho [inventár a dokumentAPI](https://blockstudio.dev/sk/docs/dev/canvas/#public-inventory-and-document-api)
- [Vykresľovanie](https://blockstudio.dev/sk/docs/blocks/rendering/#structured-compositions-and-complete-documents), [UI Komponenty](https://blockstudio.dev/sk/ui/#public-inventory-and-examples) a [UI Kompozícia](https://blockstudio.dev/sk/ui/composition/)
- [Nastavenia](https://blockstudio.dev/sk/docs/general/settings/) a [výkon](https://blockstudio.dev/sk/docs/general/settings/#performance)
- [Výkon](https://blockstudio.dev/sk/docs/production/performance/), [Ukladanie do vyrovnávacej pamäte](https://blockstudio.dev/sk/docs/production/caching/) a [Statické predgenerovanie](https://blockstudio.dev/sk/docs/production/static-prerendering/)
- [Tailwind CSS](https://blockstudio.dev/sk/docs/tailwind/#template-composition-helpers)
- [PHPStan](https://blockstudio.dev/sk/docs/dev/phpstan/): [predvoľby](https://blockstudio.dev/sk/docs/dev/phpstan/#analysis-presets), [kanonický príkaz](https://blockstudio.dev/sk/docs/dev/phpstan/#canonical-command), [spravovaný hák potvrdenia zmien](https://blockstudio.dev/sk/docs/dev/phpstan/#managed-commit-hook) a [zmluva projektu](https://blockstudio.dev/sk/docs/dev/phpstan/#project-contract-for-coding-agents)
- [Integrácia AI](https://blockstudio.dev/sk/docs/dev/ai/): index dokumentácie a celý text
- [Migrácia](https://blockstudio.dev/sk/docs/dev/migration/v7/#canonical-block-tags) a [PHP Háky](https://blockstudio.dev/sk/docs/blocks/hooks/php/)
