
Blockstudio Verze 7.6 umožňuje číst projekt a vykreslovat jej z PHP a přesouvá výchozí nastavení produkčního frontendu do `blockstudio.json`: inventář API, samostatné vykreslování, pomocné funkce šablon pro média a Tailwind, výkonnostní profily, jediný adresář mezipaměti, statické předběžné vykreslování s přednostním poskytováním, přísnější předvolby analýzy a generované projektové nástroje pro programovací agenty.

Většinu funkcí této verze zajišťují dvě volání. `Canvas::inventory()` vrací každou stránku, blok, vzor, šablonu Editoru webu, část šablony a příklad sdruženého UI zaregistrovaný projektem. `Render::document()` vrací hotové HTML pro kteroukoli z nich spolu s přesně těmi prostředky, které byly při vykreslení použity.

> **Aktualizace 7.6.2:** U stránek uložených v souborech se synchronizace už neprovádí během běžných požadavků WordPress. Při aplikování změn zdrojů spusťte `wp bs pages sync` nebo zavolejte `Blockstudio\Pages::reconcile()`. Směrování kolekcí a výchozí hodnoty `templateFor` používají uloženou konfiguraci běhového prostředí a výslovná synchronizace se vyhýbá předchozímu rozsáhlému vícejazyčnému dotazu OR-meta. Krátkodobá možnost `themeDefaults.syncPagesInDevelopment` byla odstraněna, protože synchronizace stránek už neběží z háčků požadavků. `Pages::init()` nyní slouží pouze k zavedení; integrace, které předávaly `force`, musí použít `Pages::reconcile()` nebo CLI. Otevření Canvas stále provede jedno ověřené, výslovné synchronizování inventáře pro tvorbu obsahu.

> **7.6.12 aktualizace:** Styly editoru se nyní opatřují prefixy v jediném průchodu přepisem místo kompilace SASS pro každý asset, takže sestavení editoru za studena na webu s mnoha bloky už nehrozí vyčerpáním omezené paměti. Předrenderovaná stránka v mezipaměti, jejíž stylesheet s hashem obsahu Tailwind byl odstraněn, se znovu vykreslí místo toho, aby se zobrazila bez stylů; platí to pro mezipaměť PHP i doplněk Early Serve. Atributy bloku zapsané na nejvyšší úrovni se při vykreslení načtou místo toho, aby se zahodily, takže se respektuje schéma Blockstudio registrované v `WP_Block_Type` i u programových zapisovačů.

> **7.6.11 aktualizace:** Instalace artefaktů grafu nyní atomicky nahrazuje dokument trasy, pokud se kopie v úložišti pod stejným klíčem změnila, identické dokumenty ponechává beze změny a prostřednictvím `Static_Prerender_Early_Serve::last_promotion()` hlásí povýšené, nahrazené, přeskočené a zachované trasy.

> **7.6.10 aktualizace:** Zásahy do runtime mezipaměti nyní rozpoznají odstraněné zkompilované assety i během prodlevy sledování změn a ploché runtime mezipaměti z verzí před 7.6 se atomicky přesunou do karantény a odstraní v omezených dávkách cron. Globální proměnné z přibaleného UI se na každé stránce vypíší jen jednou. Early Serve v režimu grafu může z identity mezipaměti obsluhovat živě vykreslené trasy mimo nasazenou mapu tras. Tailwind může volitelně vypisovat soubor mezipaměti s hashem obsahu pomocí `tailwind.output: "link"`; výchozí zůstává vložený výstup.

Stručně řečeno:

- **Inventář projektu**: `Canvas::inventory()` vrací každý registrovaný záznam včetně zdrojů a stabilního pořadí zobrazení.
- **Cílený výběr**: zadáním bloků a stránek se hledání, synchronizace, vykreslování a kompilace omezí na tyto záznamy.
- **Samostatné vykreslení**: `Blockstudio\Render` vrací hotový HTML pro blok, kompozici nebo celý dokument.
- **Rodiny komponent UI**: `Blockstudio\Ui` seskupuje přibalenou knihovnu do jedné veřejné rodiny pro každou komponentu a ke každé přidává příklad.
- **Stabilní rozměry obrázků**: `bs_media_image()` vykresluje assety šablony se skutečnými rozměry z generovaného `assets/media.json`.
- **Pomocné funkce pro třídy Tailwind**: `bs_tw_merge()` a `bs_tw_variants()` skládají třídy v PHP a slučují je s ohledem na konflikty.
- **Výkonnostní profily**: `performance.profile` najednou zapíná výchozí nastavení produkčního frontendu; hodnoty potomků mají přednost.
- **Typovaný přístup k nastavení**: `Settings::get_bool()` a jeho související funkce čtou `blockstudio.json` se skutečnými typy a zobrazují chyby parsování.
- **Jeden adresář mezipaměti**: všechny generované soubory jsou uloženy pod `cache.path` a klíčem je identita runtime.
- **Statické předrenderování**: anonymní HTML lze ukládat do mezipaměti, zneplatňovat pomocí grafu závislostí a obsluhovat ještě před spuštěním WordPress.
- **Předvolby analýzy**: `theme`, `extreme-theme` a `wordpress-render` rozšiřují `blockstudio/phpstan` i mimo šablony bloků.
- **Spravovaný commit hook**: `blockstudio-githooks sync` vytváří a spravuje hook před potvrzením, který spouští nakonfigurovanou předvolbu.
- **Smlouva projektu**: `blockstudio-agents` vytváří `AGENTS.md` s popisem toho, co autoři projektu vytvářejí, které funkce zapínají a co jejich předvolba vynucuje.
- **Rejstřík dokumentace**: soubor kontextu pro AI nyní obsahuje rejstřík všech dokumentů, jejich účelů a identifikátorů, za které odpovídají.
- **Kanonické značky bloků**: samostatný příkaz přepisuje zkrácené zápisy prefixů a aliasů na `<bs:namespace-slug>`; k dispozici je také zkušební spuštění.
- **Kompatibilita ve výchozím nastavení**: žádná z výše uvedených změn se webu nedotkne, dokud ji neuvedete v `blockstudio.json`.

## Čtení a vykreslování projektu

### Inventář projektu

`Canvas::inventory()` vrací vše, co projekt zaregistruje, jako jedno běžné pole, aniž by cokoli vykresloval.

```php
use Blockstudio\Canvas;

$result = Canvas::inventory();

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

Záznamy jsou seskupené podle typu: `pages`, `blocks`, `patterns`, `templates`, `parts` a `ui`. `order` určuje stabilní pořadí zobrazení napříč všemi typy, `sources` mapuje každý záznam na cesty ke zdrojům a `warnings` a `errors` shromažďují problémy jako strukturované položky.

Záznamy bloků obsahují `id`, `name`, `title`, `source`, `path`, `provenance` a `declaration` připravený k vykreslení. Záznamy stránek zachovávají `source` jako stabilní identitu a `path` jako šablonu, která stránku vykresluje.

### Cílený výběr

Výběrem záznamů se práce zúží hned, místo aby se výsledky filtrovaly až dodatečně.

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

Tím se vrátí jeden blok a jedna stránka. `patterns`, `templates`, `parts` a `ui` budou prázdné a jejich zdroje se nikdy nenačtou, nesynchronizují, nevykreslí ani nezkompilují.

Pravidla jsou přesná:

- Pokud nejsou zadány žádné klíče typů, načtou se všechny typy.
- `true`, `null` nebo `"*"` načte všechny záznamy daného typu.
- Řetězec nebo seznam přesně odpovídá ID, názvu, slugu, cestě nebo cestě ke zdroji.
- Prázdný řetězec, prázdný seznam nebo `false` nenačte žádný záznam daného typu.
- Jakmile je zadán jakýkoli klíč typu, vynechané typy zůstanou beze změny.

Neexistující identifikátory se vrátí pod `deleted` místo toho, aby vyvolaly chybu. Stejné pravidlo platí i pro koncový bod obnovení REST v Canvasu a jeho parametry `blocks` a `pages`.

`Canvas::documents()` používá stejný výběr a ke každému záznamu přidává jeden vykreslený dokument. Vybrané stránky se vykreslují v obnoveném kontextu frontendu, takže podmínky dotazů, třídy body, shortcody, rozvržení, přesměrování a callbacky enqueue pracují s danou stránkou, nikoli s požadavkem, který si o ni řekl.

### Samostatné vykreslení

`Blockstudio\Render` vrací vykreslené HTML jako řetězec pomocí stejného postupu, jaký používá frontend.

```php
use Blockstudio\Render;

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

V základu je jeden tvar deklarace se čtyřmi klíči: `name`, `attributes`, `content` a `children`. `root`, `data`, `inner`, `innerBlocks`, `layers` a `example` jsou pohodlnější vstupní formy, které do ní `Render::normalize()` převádí.
Potomci se vykreslují rekurzivně a při chybném vstupu se vyvolá výjimka s názvem příslušného bloku.

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

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

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

`body` je samotný výstup bloku, `html` sestavený dokument, `blocks` názvy bloků, které k němu přispěly, a `assets` rozděluje značky na `head`, `footer`, `styles`, `scripts`, `modules`, `interactivity`, `ui` a `tailwind`.
Assety jsou omezené na obsah, který se vykreslil, takže se assety určené jen pro editor nikdy neobjeví.

`Render::document_from_html()` obaluje výstup HTML vykreslený jinde a `Render::content()` vykresluje serializovaný obsah bloku bez dokumentu. Mezi dokumenty v jednom procesu PHP zavolejte `Blockstudio\Batch_Render::reset()`; `Canvas::documents()` to už dělá.

### Rodiny komponent UI

`Blockstudio\Ui` zpřístupňuje přibalenou knihovnu UI jako samostatnou položku pro každou veřejnou komponentu, místo aby vypisovalo interní části.

`Ui::inventory()` vrací jednu položku pro každou rodinu včetně jejího kořenového bloku, názvu a potřebných implementačních bloků. `Ui::examples()` přidává pro každou rodinu deterministickou deklaraci: zachovává výchozí hodnoty, vnořuje povinné podřízené vrstvy pod jejich rodiče a tam, kde by bylo pole prázdné, vkládá stabilní ilustrační text. Tato deklarace je kanonická, takže ji lze rovnou použít v `Render::document()`.

Canvas seskupuje položky stejně. Přibalená komponenta UI se v typu `ui` zobrazí jako jeden příklad pro každou rodinu a registrace implementací se v `blocks` nezobrazují.

Rodiny jsou navržené tak, aby se daly skládat: výběrové pole se otevírá uvnitř dialogu a jeho seznam překrývá spouštěcí prvek, nabídky a kombinovaná pole se ukotvují pomocí pevných souřadnic v okně, které zůstávají správné i při posouvání, modální okna se vrství a zavírají po jednom stisknutí Escape a každá patička kombinuje stejné zavírací tlačítko s variantou. Jak tyto styčné body fungují a jaké invarianty je udržují funkční, vysvětluje [kapitola o skládání komponent](https://blockstudio.dev/cs/ui/composition/); [/ui/examples](https://blockstudio.dev/cs/ui/examples/) ukazuje jednotlivé sestavy v praxi.

## Pomocné funkce šablon

### Stabilní rozměry obrázků

`bs_media_image()` vykresluje assety šablony se skutečnou šířkou a výškou a vyhrazeným poměrem stran, takže obrázky mimo knihovnu médií už nezpůsobují poskakování rozvržení.

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

Výstupem je `figure.blockstudio-media` s vloženým `aspect-ratio` kolem `img`, které obsahuje skutečné `width`, `height`, `loading` a `decoding`. Rozměry pocházejí z vygenerovaného `assets/media.json`, které vytvoří `Blockstudio\Media_Metadata_Builder` během sestavení nebo se doplní ručně.

`src` přijímá relativní cestu k šabloně, absolutní cestu nebo úplnou URL; pro obrázky z knihovny médií slouží `attachmentId`. Pomocí `eager` lze vypnout líné načítání nad přehybem stránky a `sources` vypisuje `<picture>`.

Když je zapnuto `performance.media.lazy`, skutečné URL se přesune do `data-src` za správně velký zástupný prvek.

### Pomocné funkce pro třídy Tailwind

`bs_tw_merge()` a `bs_tw_variants()` skládají třídy Tailwind v šablonách PHP pomocí enginu Blockstudio, který je už přibalený.

`bs_tw_merge('px-2 text-sm', 'px-4')` vrací `text-sm px-4`: konfliktní `px-2` se odstraní a přednost má pozdější hodnota. Přijímá i vnořená pole hodnot tříd.

`bs_tw_variants()` vrací malou volatelnou funkci pro varianty komponent:

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

Tím se vypíše `inline-flex items-center h-12 px-6 rounded`. Podporovány jsou základní třídy, varianty, výchozí varianty, složené varianty a také `class` nebo `className` předané při volání.

## Konfigurace pro produkční prostředí

### Výkonnostní profily

`performance.profile` zapíná výchozí nastavení produkčního frontendu na jednom místě.

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

Výchozí je `compat` a nic nemění. `speed` a `strict` zapínají stejnou sadu nastavení: odstranění výstupu generátoru, emotikonů, feedu, informací o objevování obsahu a souvisejících příspěvků z hlavičky; odstranění objevování oEmbed a skriptů hostitele; vypnutí XML-RPC, pingbacků a vzdáleného objevování editorů; odstranění obecných assetů jádra pro frontend; použití výchozího nastavení výstupu obrázků; omezení frekvence Heartbeat mimo editory; přednačítání dokumentů ze stejného původu při záměru najetí nebo zaměření; a použití načítače obrázků z Blockstudio.

Každá hodnota potomka přepíše profil, jako je tomu výše u `preload.links`. Jako první otestujte odstranění assetů jádra pro frontend, protože stránka, která na nich závisí, přestane správně fungovat. `Runtime_Settings::current()` zpřístupňuje vyřešený profil.

`themeDefaults` řeší dvě věci, které by jinak museli autoři šablon vytvářet ručně: `titleTag` a `suppressDirectoryUpdates` pro skrytí aktivní podřízené a nadřazené šablony ve výsledcích aktualizací.

### Typovaný přístup k nastavení

`Blockstudio\Settings` čte konfiguraci se skutečnými typy místo toho, aby vracelo cokoli, co obsahuje 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);
}
```

Chybně utvořené JSON se hlásí prostřednictvím `Settings::errors()` místo toho, aby se použily výchozí hodnoty. `Settings::get_raw()` vrací jen hodnoty deklarované aktivním zdrojem, takže lze rozlišit hodnotu nastavenou na `false` od hodnoty, která nikdy nastavena nebyla.

`Settings::fingerprint()` vrací stabilní identitu efektivního nastavení a přístup znovu načte hodnoty, když se změní `blockstudio.json`.

### Jeden adresář mezipaměti

Všechny generované soubory jsou nyní uloženy pod `cache.path`, jehož výchozí hodnota je `wp-content/blockstudio/cache`.

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

V tomto kořenovém adresáři jsou uloženy payloady sestavení, registrační data bloků, assety editoru, zkompilované Tailwind CSS, vykreslené dokumenty, fragmenty ostrovů, statické HTML, indexy grafu, fronty zahřívání i diagnostika. Relativní cesta se vyhodnocuje vůči `WP_CONTENT_DIR`, zatímco absolutní cesta ji nasměruje na vyhrazený svazek.

Objekty se ukládají pod aktuální síť a web a dále pod identitu runtime: otisk verzí Blockstudio, WordPress a PHP, efektivního nastavení, aktivní šablony a pluginů, zdrojů zjištěných při hledání i příslušných zdrojových souborů. Změna vstupu vytvoří nové ovlivněné objekty a staré se odstraní.

Sestavení za studena používají princip single-flight: jeden požadavek sestaví a atomicky zveřejní výsledek, zatímco ostatní čekají. Pokud se obnovení nezdaří, poslední správný objekt se dál obsluhuje a chyba zůstává viditelná. Pomocí `Blockstudio\Runtime_Cache::purge('tailwind')` lze vymazat jeden rozsah.

## Statické předrenderování

Statické předrenderování ukládá do mezipaměti úplné anonymní dokumenty HTML a může je obsluhovat ještě před spuštěním WordPress. Ve výchozím nastavení je vypnuté.

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

### Podmínky způsobilosti

Způsobilé jsou pouze úplné anonymní dokumenty HTML. Obcházejí se požadavky, které nejsou GET, řetězce dotazu, administrace, REST, Ajax, cron, feedy, vyhledávání, náhledy, požadavky s nonce, personalizované cookies a všechny cesty pod `dynamicPaths`. Odpověď lze zcela vyloučit pomocí značky `<!-- blockstudio:no-cache -->`.

Při porovnávání cest se respektují hranice, takže `/account` zahrnuje `/account/orders`, ale ne `/accounting`.

### Režimy podpisu a grafu

`invalidate` určuje, jak položky vyprší. Výchozí režim `signature` vytvoří odpověď s klíčem identity při anonymním požadavku bez zásahu do mezipaměti a obnoví ji po změnách na úrovni webu, což vyhovuje běžnému webu.

Režim `graph` je určen pro výslovné nástroje sestavení a nasazení. Zaznamenává vlastní zdrojové závislosti každé stránky, takže plán znovu sestaví pouze ovlivněné 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é obsluhování

Když je zapnuto `earlyServe`, Blockstudio spravuje malou mapu tras pro každý web a doplněk `advanced-cache.php`, který před spuštěním WordPress, pluginů nebo šablony streamuje způsobilé výsledky z mezipaměti.

Nikdy nepřepisuje cizí mapu, doplněk ani deklaraci `WP_CACHE`. Před výměnou mapy artefakt grafu ověří každý odkazovaný soubor HTML, takže při částečně vykresleném nasazení zůstane aktivní předchozí graf. Položky ve více webech zůstávají oddělené podle hostitele, domovské cesty a ID webu.

### Zahřívání a stav

Každodenní práci pokrývají tři příkazy WP-CLI:

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

`status` uvádí aktivní identitu, počet souborů a bajtů, záznamy grafu, stav fronty a počitadla zásahů do mezipaměti, nezasažených požadavků, sestavení a chyb pro každý rozsah.

## Analýza a nástroje pro agenty

### Předvolby analýzy

`blockstudio/phpstan` rozšiřuje analýzu bloků o tři další vrstvy a jeden příkaz, který spustí vrstvu zvolenou projektem.

| Předvolba | Co přidává |
| --- | --- |
| `base` | Stávající analýzu schématu, šablon, hooků, nastavení a API. |
| `theme` | Kořenové adresáře šablon, hlavičky stylů, assety, omezení selektorů, výchozí hodnoty polí a meze opakovačů. |
| `extreme-theme` | PHPStan `max`, nebezpečné PHP, escapování, Tailwind, JavaScript a kontroly Interactivity. |
| `wordpress-render` | Živou sondu vykreslení dodanou volajícím, která rozšiřuje `extreme-theme`. |

Výchozí hodnoty pocházejí z `blockstudio.json`, takže interaktivní spuštění, CI i hooky při potvrzení změn sdílejí jednu konfiguraci:

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

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

Návratové kódy jsou `0` při úspěchu, `1` při diagnostických nálezech a `2` při neplatném použití. Obalovací skript skládá konfiguraci v dočasném adresáři systému, takže v projektu nezůstane vygenerovaná konfigurace, základní sada ani mezipaměť. Zároveň zvyšuje limit paměti PHPStan na `1G`.

Obsahuje také poskytovatele BC Math, takže kontroly JavaScript už nepotřebují `ext-bcmath`.

### Spravovaný commit hook

Jedno nastavení a jeden příkaz promění nakonfigurovanou předvolbu v kontrolu před potvrzením změn.

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

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

Synchronizace zapíše hook a záznam o vlastnictví do společného adresáře Git, nasměruje `core.hooksPath` do spravovaného adresáře a připojí původně nakonfigurovaný hook před potvrzením. Hook při potvrzení vyhledá kořen úložiště i projektu, takže funguje s propojenými pracovními kopiemi i cestami obsahujícími mezery.

Hook spouští pouze `vendor/bin/blockstudio-phpstan`; soubory nikdy neformátuje ani nepřepisuje. Nastavením `commit` na `false` a opětovnou synchronizací nebo spuštěním `blockstudio-githooks remove` se obnoví zaznamenaná cesta k hooku a odstraní se pouze soubory spravované pomocí Blockstudio.

### Smlouva projektu

`blockstudio-agents` vytváří `AGENTS.md`, který uvádí, kde se nacházejí bloky, co v tomto projektu představuje stránku, které funkce jsou zapnuté a co analyzátor odmítne.

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

Dokument vychází ze skutečného projektu, nejde o předem připravenou šablonu. Šablona se záhlavím `style.css`, bloky a stránkami založenými na souborech tak dostane jinou smlouvu než plugin, který registruje pouze bloky. Dokument uvádí počty, adresáře, jmenné prostory a jazyky šablon nalezené skenerem. O tom, které funkce se v něm objeví, rozhoduje `blockstudio.json`, takže projekt bez statického předrenderování se o něm vůbec nezmiňuje.

Část o správnosti se čte přímo ze souborů pravidel vybrané předvolby, vrstvu po vrstvě, takže když předvolba získá nové pravidlo, promítne se do všech vygenerovaných smluv.

Vlastnictví funguje stejně jako u hooku při potvrzení. Soubor bez značky označující vygenerovaný obsah se odmítne přepsat, pokud `--force` neurčuje jinak. Oblast poznámek na konci se při opětovném generování zachová, `--check` vrátí kód `1`, pokud je smlouva zastaralá, a `--stdout` ji vypíše, aniž by změnil souborový systém.

### Rejstřík dokumentace

`blockstudio-llm.txt` nyní obsahuje rejstřík, nikoli souvislý výpis. Každý publikovaný dokument je uveden jednou, v příslušné sekci a podsekci, spolu se svou trasou, zdrojovým souborem, stručným popisem účelu a identifikátory, za které odpovídá: cestami k nastavení, názvy hooků, funkcemi a třídami PHP a pří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 přečte rejstřík, najde jediný dokument, který obsahuje identifikátor, jenž hledá, a otevře ho. Předchozí půlmegabajtové sloučení se stále vytváří a publikuje na `/blockstudio-llm-full.txt`; už ale není první věcí, kterou kdokoli dostane.

## Kanonické značky bloků

Samostatný příkaz přepíše zkrácené zápisy prefixů a aliasů na kanonický zápis `<bs:namespace-slug>`, který uvádí skutečný název bloku a lze jej vyřešit i bez načteného filtru projektu.

S prefixem `brand` pro `theme-components` a prefixem `ui` pro `bsui` tento zkrácený zápis:

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

znamená totéž co:

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

Prefixy a přesné aliasy stále fungují a nejsou zastaralé. Příkaz nenačítá WordPress a bez `--apply` nic nezapisuje:

```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 jmenné prostory a `--known-blocks` vypisuje registrované názvy bloků. Zpráva zaznamenává mapování zastaralých názvů na kanonické včetně počtu výskytů, hashů jednotlivých souborů a samostatných seznamů neznámých značek, nejednoznačných aliasů a dynamických značek. `--apply` odmítne zapisovat, dokud některé z nich zůstávají, pokud není předáno `--allow-unresolved`.

Zpracovávají se párové, vnořené i samouzavírací značky, včetně doslovných značek v řetězcích PHP. Mění se pouze názvy značek, druhé spuštění neprovede žádné změny a příklady v komentářích, blocích kódu, `<pre>` nebo `<code>` se pouze uvedou ve zprávě.

## Výchozí chování

Samotná instalace verze 7.6 nic nemění.

**Profil výkonu je ve výchozím nastavení `compat`.** Výstup hlavičky, oEmbed, XML-RPC, Heartbeat, výchozí nastavení obrázků, přednačítání odkazů, líné načítání a frontendový `<title>` zůstávají takové, jaké je nastavily WordPress a šablona.

**Zůstávají vypnuté, dokud je nepovolíte:** všechny klíče `performance.staticPrerender`, `performance.measurement`, `performance.media` a `themeDefaults`, dále `githooks.commit`, `dev.canvas.enabled`, `ui.enabled`, `tailwind.enabled` a `blockTags.enabled`. Dokud je statické předběžné vykreslování vypnuté, nezapisuje žádné soubory ani neinstaluje žádný doplněk.

**Canvas a Render jsou pasivní.** Čtou existující registry a vykreslují pouze to, co si volající vyžádá; ani jeden nezasahuje do výstupu frontendu ani neregistruje trasy. Obrazovka správy Canvas stále vyžaduje `dev.canvas.enabled` a `edit_posts`.

**Přísnější analýzu je třeba výslovně nastavit.** Instalace `blockstudio/phpstan` povolí pouze základní rozšíření a kanonický příkaz spustí `base`, pokud projekt neurčí předvolbu.

**Generované soubory vyžadují spuštění příslušného příkazu.** `githooks.commit` nedělá nic, dokud se nespustí `blockstudio-githooks sync`, a `AGENTS.md`, dokud se nespustí `blockstudio-agents`.

## Upgrade z verze 7.5

Požadavky se nemění: PHP 8.2 nebo novější, WordPress 6.7 nebo novější.

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

**Mezipaměti se obnoví jednou.** Identita běhového prostředí zahrnuje verzi Blockstudio, takže první požadavek po upgradu bude studený a staré objekty se odstraní. Starou mezipaměť Tailwind v `wp-content/uploads/blockstudio/tailwind/cache` lze smazat; úryvek kódu, který používal glob, by měl místo toho volat `Blockstudio\Runtime_Cache::purge('tailwind')`.

Plochý adresář `wp-content/blockstudio/cache/runtime` z verzí před 7.6 se automaticky přejmenuje mimo aktivní cestu a odstraní se v omezeném počtu průchodů WP-Cron. Velké stromy zastaralých zamykacích souborů proto není nutné mazat během požadavku na nasazení.

**Generované soubory mají své vlastníky.** `assets/media.json` patří do správy verzí nebo do kroku sestavení. Mapa tras, doplněk `advanced-cache.php` a deklarace `WP_CACHE` existují pouze při povoleném `earlyServe` a předávací háček pouze při synchronizaci. Vše ostatní generované se nachází pod `cache.path` a lze to bezpečně smazat.

**Nic nebylo odstraněno ani přejmenováno.** `bs_render_block()`, `bs_block()`, `Blockstudio\Pages` a `Blockstudio\Patterns` zůstávají kanonickými zdroji obsahu založenými na souborech.

**Návrat k předchozímu stavu se provádí pro jednotlivé funkce.** `performance.profile` zpět na `compat`, `staticPrerender.enabled` na `false`, `githooks.commit` na `false` spolu s `sync` a `cache.enabled` na `false`; každý krok vrátí jednu vrstvu.

Rozumné pořadí zavádění:

1. Nastavte `performance.profile` na `speed` a pak zkontrolujte výstup hlavičky, kanály a všechny pluginy závislé na oEmbed nebo XML-RPC.
2. Vygenerujte `assets/media.json`, přesuňte šablony do `bs_media_image()` a pak zapněte `performance.media.lazy`.
3. Povolte `performance.staticPrerender` s vypnutým `earlyServe`, ověřte požadavky pomocí `wp bs prerender status` a pak zapněte `earlyServe`.
4. Spouštějte `blockstudio-phpstan --preset theme`, dokud nebude bez chyb, a teprve potom nastavte předvolbu za `githooks.commit`.

## Kde najdete podrobnosti

- [Canvas](https://blockstudio.dev/cs/docs/dev/canvas/) a jeho
  [inventář a dokument API](https://blockstudio.dev/cs/docs/dev/canvas/#public-inventory-and-document-api)
- [Vykreslování](https://blockstudio.dev/cs/docs/blocks/rendering/#structured-compositions-and-complete-documents),
  [komponenty UI](https://blockstudio.dev/cs/ui/#public-inventory-and-examples) a
  [skládání UI](https://blockstudio.dev/cs/ui/composition/)
- [Nastavení](https://blockstudio.dev/cs/docs/general/settings/) a
  [výkon](https://blockstudio.dev/cs/docs/general/settings/#performance)
- [Výkon](https://blockstudio.dev/cs/docs/production/performance/),
  [ukládání do mezipaměti](https://blockstudio.dev/cs/docs/production/caching/) a
  [statické předběžné vykreslování](https://blockstudio.dev/cs/docs/production/static-prerendering/)
- [Tailwind CSS](https://blockstudio.dev/cs/docs/tailwind/#template-composition-helpers)
- [PHPStan](https://blockstudio.dev/cs/docs/dev/phpstan/): [předvolby](https://blockstudio.dev/cs/docs/dev/phpstan/#analysis-presets),
  [kanonický příkaz](https://blockstudio.dev/cs/docs/dev/phpstan/#canonical-command),
  [spravovaný předávací háček](https://blockstudio.dev/cs/docs/dev/phpstan/#managed-commit-hook) a
  [smlouva projektu](https://blockstudio.dev/cs/docs/dev/phpstan/#project-contract-for-coding-agents)
- [Integrace AI](https://blockstudio.dev/cs/docs/dev/ai/): rejstřík dokumentace a úplný text
- [Migrace](https://blockstudio.dev/cs/docs/dev/migration/v7/#canonical-block-tags) a
  [PHP háčky](https://blockstudio.dev/cs/docs/blocks/hooks/php/)
