
Blockstudio Версия 7.6 позволява проектът да се преглежда и визуализира от PHP и премества настройките по подразбиране за производствения фронтенд в `blockstudio.json`: опис API, самостоятелно визуализиране, помощници за шаблони за мултимедия и Tailwind, профили за производителност, една директория за кеша, статично предварително визуализиране с ранно обслужване, по-строги предварителни настройки за анализ и генерирани инструменти за проекти за агенти за програмиране.

Две извиквания осигуряват повечето възможности в това издание. `Canvas::inventory()` връща всяка страница, блок, шаблон, шаблон или част от шаблон за редактора на сайта и включен пример на UI, регистрирани от проекта. `Render::document()` връща завършен HTML за всеки от тях заедно с точните ресурси, използвани при визуализирането.

> **Актуализация на 7.6.2:** страниците, базирани на файлове, вече не се съгласуват при обикновени заявки WordPress. Изпълнете `wp bs pages sync` или извикайте `Blockstudio\Pages::reconcile()`, когато прилагате промени от източника. Маршрутизирането на колекциите и настройките по подразбиране на `templateFor` използват запазена конфигурация на средата за изпълнение, а изричното съгласуване пропускаше предишната голяма OR-meta заявка за многоезични страници. Краткотрайната опция `themeDefaults.syncPagesInDevelopment` е премахната, защото синхронизирането на страниците вече не се изпълнява от куки за заявките. `Pages::init()` вече се използва само при зареждане; интеграциите, които са подавали `force`, трябва да използват `Pages::reconcile()` или CLI. Отварянето на Canvas все още извършва едно изрично съгласуване с удостоверяване за опис на съдържанието за авторите.

> **7.6.12 актуализация:** Стиловите таблици на редактора вече се префиксират с едно
> преминаване за пренаписване вместо с компилация на SASS за всеки ресурс, така че студено
> изграждане на редактора на сайт с много блокове вече не рискува да изчерпи умерено ограничение на паметта. Кеширана предварително рендерирана страница, чиято хеширана по съдържание Tailwind таблица със стилове е
> премахната, се рендерира отново, вместо да се показва без стилове, както през кеша PHP,
> така и чрез добавката Early Serve. Атрибутите на блокове, записани на най-горно ниво, вече
> се прочитат при рендериране, вместо да бъдат отхвърляни, така че схемата Blockstudio,
> регистрирана в `WP_Block_Type`, се спазва от програмните инструменти за запис.

> **7.6.11 актуализация:** Инсталирането на графови артефакти вече заменя документа на маршрут атомарно, когато копието в хранилището се е променило със същия ключ, оставя идентичните документи непроменени и отчита повишените, заменените, пропуснатите и запазените маршрути чрез `Static_Prerender_Early_Serve::last_promotion()`.

> **7.6.10 актуализация:** Попаденията в кеша на средата за изпълнение вече откриват премахнати компилирани ресурси дори по време на забавянето за изчакване на промените, а плоските кешове за среда за изпълнение отпреди 7.6 се изолират атомарно и изтриват на ограничени партиди cron. Глобалните елементи на включения UI се извеждат веднъж на страница. Early Serve в графов режим може да обслужва рендерирани на живо маршрути извън внедрената карта на маршрутите от кеша на идентичностите. Tailwind може по избор да извежда своя кеш файл с хеширано съдържание чрез `tailwind.output: "link"`; вграденото извеждане остава по подразбиране.

Накратко:

- **Инвентаризация на проекта**: `Canvas::inventory()` връща всеки регистриран запис с източниците му и стабилен ред за показване.
- **Целеви избор**: посочването на блокове и страници ограничава откриването, синхронизирането, рендерирането и компилирането до тези записи.
- **Самостоятелно рендериране**: `Blockstudio\Render` връща готов HTML за блок, композиция или цял документ.
- **UI семейства компоненти**: `Blockstudio\Ui` групира включената библиотека в едно публично семейство за всеки компонент, с по един пример.
- **Стабилни размери на изображенията**: `bs_media_image()` рендерира ресурсите на темата с реални размери от генериран `assets/media.json`.
- **Tailwind помощни функции за класове**: `bs_tw_merge()` и `bs_tw_variants()` комбинират класове в PHP с обединяване, което отчита конфликтите.
- **Профили за производителност**: `performance.profile` включва наведнъж стандартните настройки за производствената среда на фронтенда; стойностите на дъщерните настройки ги заместват.
- **Достъп до типизирани настройки**: `Settings::get_bool()` и сродните му функции четат `blockstudio.json` с реални типове и показват грешките при парсване.
- **Една директория за кеша**: всеки генериран файл се намира под `cache.path` и е обозначен с идентичност на средата за изпълнение.
- **Статично предварително рендериране**: анонимните документи HTML могат да се кешират, обезсилват чрез граф на зависимостите и обслужват преди стартирането на WordPress.
- **Предварителни настройки за анализ**: `theme`, `extreme-theme` и `wordpress-render` разширяват `blockstudio/phpstan` отвъд шаблоните на блоковете.
- **Управляван hook за commit**: `blockstudio-githooks sync` записва и управлява hook за pre-commit, който изпълнява конфигурираната предварителна настройка.
- **Договор на проекта**: `blockstudio-agents` записва `AGENTS.md`, описващ какво създава проектът, кои функции включва и какво налага неговата предварителна настройка.
- **Индекс на документацията**: файлът с контекст за ИИ вече е индекс на всеки документ, неговото предназначение и идентификаторите, за които отговаря.
- **Канонични етикети на блокове**: самостоятелна команда пренаписва съкратените форми с префикси и псевдоними като `<bs:namespace-slug>`, с пробно изпълнение.
- **Съвместимост по подразбиране**: нищо от горното не променя даден сайт, докато не бъде посочено в `blockstudio.json`.

## Четене и рендериране на проект

### Инвентаризация на проекта

`Canvas::inventory()` връща всичко, което проектът регистрира, като обикновен масив,
без да рендерира нищо.

```php
use Blockstudio\Canvas;

$result = Canvas::inventory();

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

Записите са групирани по тип: `pages`, `blocks`, `patterns`, `templates`,
`parts` и `ui`. `order` е стабилният ред за показване за всички типове,
`sources` свързва всеки запис с пътищата до източниците му, а `warnings` и `errors`
събират проблемите като структурирани записи.

Записите за блокове съдържат `id`, `name`, `title`, `source`, `path`, `provenance` и готов за рендериране `declaration`. Записите за страници запазват `source` като стабилна идентичност и `path` като шаблона, който ги рендерира.

### Целеви избор

Посочването на записи ограничава обхвата на работата, вместо да се филтрират резултати след това.

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

Това връща един блок и една страница. `patterns`, `templates`, `parts` и `ui`
са празни, а източниците им изобщо не се прочитат, синхронизират, рендерират или
компилират.

Правилата са точни:

- Без ключове за типове се зарежда всеки тип.
- `true`, `null` или `"*"` зарежда всеки запис от съответния тип.
- Низ или списък съвпада точно по ID, име, кратко име, път или път до източника.
- Празен низ, празен списък или `false` не зарежда нищо от този тип.
- Щом присъства ключ за който и да е тип, пропуснатите типове остават недокоснати.

Идентификаторите, които вече не съществуват, се връщат под `deleted`, вместо да се получи грешка,
а крайната точка за опресняване на Canvas REST прилага същото правило към параметрите си `blocks` и
`pages`.

`Canvas::documents()` използва същия избор и добавя по един рендериран документ за
всеки запис. Избраните страници се рендерират във възстановен контекст на фронтенда, така че условните проверки на заявката, класовете на тялото, кратките кодове, оформленията, пренасочванията и обратните извиквания за зареждане виждат тази страница, а не заявката, която я е поискала.

### Самостоятелно рендериране

`Blockstudio\Render` връща рендерирано HTML като низ чрез същия
конвейер, който използва фронтендът.

```php
use Blockstudio\Render;

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

Под него стои една форма на декларация с четири ключа: `name`, `attributes`,
`content` и `children`. `root`, `data`, `inner`, `innerBlocks`, `layers` и
`example` са удобни варианти за вход, които `Render::normalize()` обединява в тази форма.
Дъщерните елементи се рендерират рекурсивно, а невалидните входни данни предизвикват изключение, което посочва проблемния блок.

`Render::document()` обвива резултата в пълен самостоятелен документ HTML.

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

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

`body` е само изходът на блока, `html` е сглобеният документ, `blocks` са
имената на блоковете, които участват, а `assets` разделя маркировката на `head`,
`footer`, `styles`, `scripts`, `modules`, `interactivity`, `ui` и `tailwind`.
Ресурсите са ограничени до използваните при рендерирането, така че ресурси само за редактора не се появяват.

`Render::document_from_html()` обвива рендерирано другаде HTML, а
`Render::content()` рендерира сериализирано съдържание на блокове без документ. Извикайте
`Blockstudio\Batch_Render::reset()` между документи в рамките на един процес PHP;
`Canvas::documents()` вече го прави.

### UI семейства компоненти

`Blockstudio\Ui` предоставя включената библиотека UI като по един запис за всеки публичен
компонент, вместо като списък от вътрешни части.

`Ui::inventory()` връща по един запис за всяко семейство с основния му блок, заглавието и
необходимите му блокове за реализация. `Ui::examples()` добавя детерминистична
декларация за всяко семейство: запазени стойности по подразбиране, задължителните дъщерни слоеве, вложени под родителите си, и стабилен примерен текст там, където дадено поле би било празно. Тази декларация е канонична и се подава директно към `Render::document()`.

Canvas групира по същия начин. Включеният UI се показва под типа `ui` с по един
пример за всяко семейство, а регистрациите за реализация не се включват в `blocks`.

Семействата са създадени за сглобяване: списък за избор се отваря в диалогов прозорец, а неговото наслагване с елементи на списък се разполага над спусъка; менютата и комбинираните полета се позиционират спрямо фиксирани координати на изгледа, които не се променят при превъртане; модалните прозорци се подреждат и затварят един по един с Escape; във всеки футър един и същ контрол за затваряне се комбинира с вариант. За обяснение как работят тези връзки и за инвариантите, които ги поддържат, вижте [главата за композирането](https://blockstudio.dev/bg/ui/composition/); в [/ui/examples](https://blockstudio.dev/bg/ui/examples/) можете да видите композициите на живо.

## Помощни функции за шаблони

### Стабилни размери на изображенията

`bs_media_image()` рендерира ресурсите на темата с реални ширина и височина и запазено
съотношение на страните, така че изображенията извън медийната библиотека вече не разместват оформлението.

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

Резултатът е `figure.blockstudio-media` с вграден `aspect-ratio` около
`img`, който съдържа реалните `width`, `height`, `loading` и `decoding`. Размерите
идват от генериран `assets/media.json`, записан чрез
`Blockstudio\Media_Metadata_Builder` по време на изграждане или ръчно.

`src` приема път спрямо темата, абсолютен път или пълен URL, а
`attachmentId` обработва изображенията от медийната библиотека. `eager` изключва отложеното зареждане
над видимата част на страницата, а `sources` извежда `<picture>`.

Когато `performance.media.lazy` е включено, реалното URL се премества на `data-src` зад
правилно оразмерен заместител.

### Tailwind помощни функции за класове

`bs_tw_merge()` и `bs_tw_variants()` комбинират класове Tailwind в шаблони PHP,
като използват механизма Blockstudio, който вече е включен в системата.

`bs_tw_merge('px-2 text-sm', 'px-4')` връща `text-sm px-4`: конфликтният
`px-2` се премахва и надделява по-късната стойност. Приемат се вложени масиви със стойности за класове.

`bs_tw_variants()` връща малка извикваема функция за варианти на компоненти:

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

Това извежда `inline-flex items-center h-12 px-6 rounded`. Поддържат се базови класове,
варианти, варианти по подразбиране, комбинирани варианти и зададен при извикването `class` или
`className`.

## Конфигурация за производствена среда

### Профили за производителност

`performance.profile` включва стандартните настройки за производствената среда на фронтенда на едно място.

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

`compat` е по подразбиране и не променя нищо. `speed` и `strict` включват
един и същ набор: премахват от главната част извеждането на генератор, емоджита, емисии, откриване и съседни публикации; премахват откриването на oEmbed и скриптовете на хоста; изключват XML–RPC, pingback съобщенията
и отдалеченото откриване на редактора; премахват общите ресурси на ядрото за фронтенда;
прилагат стандартни настройки за извеждане на изображения; ограничават Heartbeat извън редакторите; предварително зареждат документи от същия източник при намерение за посочване или фокус; и използват зареждача на изображения на Blockstudio.

Всяка дъщерна стойност замества профила, както `preload.links` по-горе. Премахването
на ресурси на ядрото за фронтенда е първото, което трябва да тествате, защото страница, зависеща от тях, ще се повреди видимо. `Runtime_Settings::current()` показва разрешения профил.

`themeDefaults` обхваща две неща, които иначе темите трябва да реализират сами: `titleTag` и
`suppressDirectoryUpdates`, за да скрият активната дъщерна и родителска тема от резултатите за актуализации.

### Достъп до типизирани настройки

`Blockstudio\Settings` чете конфигурацията с реални типове, вместо да връща
каквото се съдържало в 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);
}
```

Неправилно форматираният JSON се отчита чрез `Settings::errors()`, вместо да се
разрешава до стойности по подразбиране. `Settings::get_raw()` връща само декларираното от активния източник,
което позволява да се различи стойност, зададена на `false`, от стойност, която никога не е била задавана.

`Settings::fingerprint()` връща стабилна идентичност за ефективните настройки,
а достъпът презарежда, когато `blockstudio.json` се промени.

### Една директория за кеша

Всеки генериран файл вече се намира под `cache.path`, чиято стойност по подразбиране е
`wp-content/blockstudio/cache`.

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

Полезният товар за изграждане, регистрационните данни на блоковете, ресурсите на редактора, компилираният Tailwind CSS,
рендерираните документи, фрагментите на островите, статичният HTML, индексите на графите, опашките за затопляне и диагностиката се намират под този корен. Относителният път се разрешава спрямо
`WP_CONTENT_DIR`, а абсолютният сочи към специален том.

Обектите се съхраняват под текущите мрежа и сайт, а после под идентичност на средата за изпълнение: отпечатък от версиите на Blockstudio, WordPress и PHP,
ефективните настройки, активната тема и плъгини, източниците за откриване и участващите изходни файлове. При промяна на входните данни се създават нови засегнати обекти, а старите се премахват.

Студените изграждания се изпълняват само веднъж: една заявка изгражда и публикува резултата атомарно, докато останалите чакат. При неуспешно опресняване последният валиден обект продължава да се обслужва, като грешката остава видима, а
`Blockstudio\Runtime_Cache::purge('tailwind')` изчиства един обхват.

## Статично предварително рендериране

Статичното предварително рендериране кешира пълни анонимни документи HTML и може да ги обслужва
преди стартирането на WordPress. По подразбиране е изключено.

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

### Допустимост

Допустими са само пълни анонимни документи HTML. Заявки, които не са GET, низове на
заявки, администрацията, REST, Ajax, cron, емисии, търсене, предварителни прегледи, заявки с nonce,
бисквитки за персонализация и всички пътища под `dynamicPaths` се пропускат.
Отговорът може изцяло да се изключи с маркер `<!-- blockstudio:no-cache -->`.

Съвпадението по път отчита границите, така че `/account` включва `/account/orders`, но
не и `/accounting`.

### Режими с подпис и граф

`invalidate` определя кога записите изтичат. Режимът `signature` по подразбиране попълва
отговор с ключ по идентичност при анонимно пропускане в кеша и го ротира след промени на ниво сайт, което е подходящо за обикновен сайт.

Режимът `graph` е предназначен за изрични инструменти за изграждане и внедряване. Той записва
зависимостите на всяка страница от собствените ѝ източници, така че планът да изгражда отново само засегнатите 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']));
```

### Ранно обслужване

Когато `earlyServe` е включено, Blockstudio управлява малка карта на маршрутите за всеки сайт и
добавка `advanced-cache.php`, която изпраща поток при попадение в кеша, преди да се стартират WordPress,
плъгините или темата.

То никога не презаписва чужда карта, добавка или декларация `WP_CACHE`. Графов
артефакт проверява всеки посочен файл HTML, преди да се смени картата, така че
частично рендерирано внедряване оставя предишния граф активен. Записите за мрежи от сайтове остават изолирани по хост, началния път и ID на сайта.

### Затопляне и състояние

Три команди WP-CLI покриват ежедневната употреба:

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

`status` отчита активната идентичност, броя на файловете и байтовете, записите в графа, състоянието на опашката и броячите за попадения, пропуски, изграждания и неуспешни операции за всеки обхват.

## Инструменти за анализ и агенти

### Предварителни настройки за анализ

`blockstudio/phpstan` получава три слоя над анализа на блоковете си, както и една
команда, която изпълнява избрания от проекта слой.

| Предварителна настройка | Какво добавя |
| --- | --- |
| `base` | Съществуващият анализ на схемата, шаблоните, hook-овете, настройките и API. |
| `theme` | Коренови директории на темите, заглавки на стилове, ресурси, ограничаване на обхвата на селекторите, стойности на полетата по подразбиране, граници на повторителите. |
| `extreme-theme` | PHPStan `max`, опасни PHP, екраниране, Tailwind, JavaScript и проверки на Interactivity. |
| `wordpress-render` | Проверка чрез рендериране на живо, предоставена от извикващия, над `extreme-theme`. |

Стойностите по подразбиране идват от `blockstudio.json`, така че интерактивните изпълнения, CI и hook-овете за commit
споделят една конфигурация:

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

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

Кодовете за изход са `0` при успех, `1` при диагностика и `2` при невалидна употреба. Обвивката сглобява конфигурацията си във временната системна директория, така че в проекта не се записват генерирана конфигурация, базова линия или кеш, и увеличава
ограничението за памет на PHPStan до `1G`.

Включен е и доставчик на BC Math, така че проверките на JavaScript вече не изискват
`ext-bcmath`.

### Управляван hook за commit

Една настройка и една команда превръщат конфигурираната предварителна настройка във входен контрол при commit.

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

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

Синхронизирането записва hook-а и запис за собственост в общата директория на Git,
насочва `core.hooksPath` към управляваната директория и свързва предходно конфигурирания hook за pre-commit. Hook-ът определя хранилището и основната директория на проекта при извършване на commit, така че свързаните работни копия и пътищата с интервали работят.

Hook-ът изпълнява `vendor/bin/blockstudio-phpstan` и нищо друго; никога
не форматира и не пренаписва файлове. Ако зададете `commit` на `false` и синхронизирате отново или
изпълните `blockstudio-githooks remove`, пътят до записания hook се възстановява и се изтриват само файловете, притежавани от Blockstudio.

### Договор на проекта

`blockstudio-agents` записва `AGENTS.md`, който указва къде се намират блоковете, какво представлява
страницата в този проект, кои функции са включени и какво ще отхвърли анализаторът.

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

Документът се генерира според проекта, а не от шаблон. Договорът за тема със заглавка `style.css`,
блокове и страници във файлове се различава от договора за плъгин, който регистрира само блокове, и включва броя, директориите, пространствата от имена и езиците за шаблони, открити от скенера. `blockstudio.json` определя кои функции се показват,
така че проект без статично предварително рендериране изобщо няма да го спомене.

Разделът за коректността се прочита слой по слой от собствените файлове с правила на избраната предварителна настройка. Затова добавянето на правило към предварителна настройка променя всеки генериран от нея договор.

Управлението на собствеността работи като при hook-а за commit. Ако във файла няма генериран маркер, той се отхвърля, вместо да бъде заменен, освен ако `--force` не указва друго; областта за бележки в края се запазва при регенериране; `--check` излиза с код `1`, когато договорът е остарял; а `--stdout` го извежда, без да докосва файловата система.

### Индекс на документацията

`blockstudio-llm.txt` вече е индекс, а не конкатенация. Всеки
публикуван документ се появява веднъж в своя раздел и подраздел, заедно с маршрута,
изходния файл, едноредово описание на предназначението и идентификаторите, за които отговаря: пътища към настройки,
имена на hook-ове, функции и класове PHP и команди.

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

Агентът прочита индекса, намира документа, който съдържа търсения от него идентификатор, и отваря този документ. Предишното обединение с размер половин мегабайт все още се генерира и публикува на `/blockstudio-llm-full.txt`; просто вече не е първото нещо, което се предоставя на всеки.

## Канонични етикети на блокове

Самостоятелна команда заменя съкратените форми с префикс и псевдоним с каноничния вариант `<bs:namespace-slug>`, който посочва действителното име на блока и се разрешава без зареден филтър за проекта.

С префикс `brand` за `theme-components` и префикс `ui` за `bsui`, тази съкратена форма:

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

означава същото като:

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

Префиксите и точните псевдоними продължават да работят и не са отхвърлени. Командата не зарежда WordPress и не записва нищо без `--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` свързва всеки префикс с неговите пространства от имена, а `--known-blocks` изброява регистрираните имена на блокове. Отчетът записва съпоставянията от остарели към канонични имена с броя срещания, хешове за всеки файл и отделни списъци за непознати етикети, двусмислени псевдоними и динамични етикети. `--apply` отказва да записва, докато има останали такива, освен ако не е подаден `--allow-unresolved`.

Обработват се сдвоени, вложени и самозатварящи се маркери, включително буквални маркери в низове PHP. Променят се само имената на маркерите, повторното изпълнение не води до промени, а примерите в коментари, блокове с код, `<pre>` или `<code>` се включват само в отчета.

## Поведение по подразбиране

Инсталирането на 7.6 само по себе си не променя нищо.

**Профилът за производителност по подразбиране е `compat`.** Изходът в head, oEmbed, XML-RPC, Heartbeat, настройките по подразбиране за изображения, предварителното зареждане на връзки, отложеното зареждане и `<title>` на предния край остават такива, каквито са ги задали WordPress и темата.

**Следните неща остават изключени, освен ако не бъдат активирани:** всички ключове `performance.staticPrerender`, `performance.measurement`, `performance.media` и `themeDefaults`, както и `githooks.commit`, `dev.canvas.enabled`, `ui.enabled`, `tailwind.enabled` и `blockTags.enabled`. Докато статичното предварително рендиране е изключено, не се записват файлове и не се инсталира допълнителен компонент.

**Canvas и Render са пасивни.** Те четат наличните регистри и рендират само поисканото от извикващия ги код; нито се включват в изхода на предния край, нито регистрират маршрути. Екранът за администриране на Canvas все още изисква `dev.canvas.enabled` и `edit_posts`.

**По-строгият анализ изисква изрично посочване.** Инсталирането на `blockstudio/phpstan` активира само базовото разширение, а каноничната команда изпълнява `base`, освен ако проектът не посочи предварително зададен профил.

**За генерирането на файлове трябва да се изпълни съответната команда.** `githooks.commit` не прави нищо, докато не се изпълни `blockstudio-githooks sync`, а `AGENTS.md` — докато не се изпълни `blockstudio-agents`.

## Надграждане от 7.5

Изискванията не са променени: PHP 8.2 или по-нова версия, WordPress 6.7 или по-нова версия.

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

**Кешовете се изграждат отново веднъж.** Идентификаторът на средата за изпълнение включва версията на Blockstudio, затова първата заявка след надграждането започва без кеш, а старите обекти се премахват. Старият кеш на Tailwind в `wp-content/uploads/blockstudio/tailwind/cache` може да бъде изтрит; фрагмент код, който го търси с glob, трябва вместо това да извика `Blockstudio\Runtime_Cache::purge('tailwind')`.

Старата плоска директория `wp-content/blockstudio/cache/runtime` отпреди 7.6 автоматично се преименува и извежда от активния път, а след това се премахва на ограничени порции с WP-Cron. Така не се налага големите наследени дървета от заключващи файлове да бъдат изтривани по време на заявка за внедряване.

**Генерираните файлове имат собствени места.** `assets/media.json` трябва да бъде под контрола на версиите или част от стъпка по изграждането. Картата на маршрутите, допълнителният компонент `advanced-cache.php` и декларацията `WP_CACHE` съществуват само когато `earlyServe` е активирано, а куката за предварително потвърждаване — само докато е синхронизирана. Всички останали генерирани файлове се намират под `cache.path` и могат безопасно да бъдат изтрити.

**Нищо не е премахнато или преименувано.** `bs_render_block()`, `bs_block()`, `Blockstudio\Pages` и `Blockstudio\Patterns` остават каноничните източници на съдържание, представено чрез файлове.

**Връщането към предишна версия се прави за всяка функция поотделно.** Връщането на `performance.profile` към `compat`, на `staticPrerender.enabled` към `false`, на `githooks.commit` към `false` заедно с `sync` и на `cache.enabled` към `false` отменя по един слой.

Подходящ ред за внедряване:

1. Задайте `performance.profile` на `speed`, след което проверете изхода в head, информационните канали и всички разширения, които разчитат на oEmbed или XML-RPC.
2. Генерирайте `assets/media.json`, преместете шаблоните в `bs_media_image()` и след това включете `performance.media.lazy`.
3. Активирайте `performance.staticPrerender`, като оставите `earlyServe` изключено; проверете попаденията с `wp bs prerender status`, след което включете `earlyServe`.
4. Изпълнявайте `blockstudio-phpstan --preset theme`, докато отчетът е чист, преди да добавите предварително зададен профил към `githooks.commit`.

## Къде да намерите подробностите

- [Canvas](https://blockstudio.dev/bg/docs/dev/canvas/) и неговия [опис и документацияAPI](https://blockstudio.dev/bg/docs/dev/canvas/#public-inventory-and-document-api)
- [Рендиране](https://blockstudio.dev/bg/docs/blocks/rendering/#structured-compositions-and-complete-documents), [компоненти на UI](https://blockstudio.dev/bg/ui/#public-inventory-and-examples) и [композиция на UI](https://blockstudio.dev/bg/ui/composition/)
- [Настройки](https://blockstudio.dev/bg/docs/general/settings/) и [производителност](https://blockstudio.dev/bg/docs/general/settings/#performance)
- [Производителност](https://blockstudio.dev/bg/docs/production/performance/), [кеширане](https://blockstudio.dev/bg/docs/production/caching/) и [статично предварително рендиране](https://blockstudio.dev/bg/docs/production/static-prerendering/)
- [Tailwind CSS](https://blockstudio.dev/bg/docs/tailwind/#template-composition-helpers)
- [PHPStan](https://blockstudio.dev/bg/docs/dev/phpstan/): [предварително зададени профили](https://blockstudio.dev/bg/docs/dev/phpstan/#analysis-presets), [канонична команда](https://blockstudio.dev/bg/docs/dev/phpstan/#canonical-command), [управлявана кука за потвърждаване](https://blockstudio.dev/bg/docs/dev/phpstan/#managed-commit-hook) и [договор на проекта](https://blockstudio.dev/bg/docs/dev/phpstan/#project-contract-for-coding-agents)
- [Интеграция с AI](https://blockstudio.dev/bg/docs/dev/ai/): индексът на документацията и пълният текст
- [Миграция](https://blockstudio.dev/bg/docs/dev/migration/v7/#canonical-block-tags) и [кукиPHP](https://blockstudio.dev/bg/docs/blocks/hooks/php/)
