
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 по метаданным на многих языках. Кратковременная настройка `themeDefaults.syncPagesInDevelopment` удалена, поскольку синхронизация страниц больше не запускается из хуков запросов.
> Теперь `Pages::init()` выполняется только при загрузке; интеграциям, передававшим `force`, следует использовать `Pages::reconcile()` или CLI. При открытии Canvas по-прежнему выполняется одна явная аутентифицированная сверка перечня материалов для редактирования.

> **7.6.12 обновление:** Таблицы стилей редактора теперь получают префиксы за один проход переписывания, а не компилируются через SASS для каждого ресурса. Поэтому холодная сборка редактора на сайте с большим количеством блоков больше не рискует превысить скромный лимит памяти. Если из кэша вытеснена таблица стилей Tailwind с хешем содержимого, страница с предварительным рендерингом создаётся заново, а не отдаётся без стилей, как через кэш PHP, так и через drop-in 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` за пределы шаблонов блоков.
- **Управляемый хук коммита**: `blockstudio-githooks sync` создаёт хук 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, имени, slug, пути или пути к источнику.
- Пустая строка, пустой список или `false` не загружают записи этого типа.
- Если указан хотя бы один ключ типа, типы с пропущенными ключами остаются нетронутыми.

Несуществующие идентификаторы возвращаются в `deleted`, а не приводят к ошибке. Конечная точка обновления REST в Canvas применяет то же правило к параметрам `blocks` и `pages`.

`Canvas::documents()` принимает те же параметры выбора и добавляет по одному отрендеренному документу для каждой записи. Выбранные страницы рендерятся в восстановленном контексте фронтенда, поэтому условные запросы, классы body, шорткоды, макеты, перенаправления и функции обратного вызова для подключения ресурсов видят эту страницу, а не запрос, который запустил рендеринг.

### Автономный рендеринг

`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/ru/ui/composition/); [/ui/examples](https://blockstudio.dev/ru/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` включают один и тот же набор: удаляют из head данные генератора, эмодзи, ленты, обнаружения и соседних записей; отключают обнаружение oEmbed и скрипты хоста; отключают XML-RPC, пингбэки и обнаружение удалённого редактора; удаляют универсальные ресурсы ядра для фронтенда; применяют настройки изображений по умолчанию; ограничивают частоту 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, действующих настроек, активной темы и плагинов, источников обнаружения и участвующих исходных файлов. При изменении входных данных для затронутых объектов создаются новые версии, а старые удаляются.

Холодные сборки выполняются по принципу single-flight: один запрос собирает и атомарно публикует результат, пока остальные ждут. Если обновить кэш не удаётся, продолжает отдаваться последний корректный объект, а ошибка остаётся доступной для наблюдения. Команда `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, персонализированные cookie и любые пути под `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 управляет небольшой картой маршрутов для сайта и drop-in `advanced-cache.php`, который перед запуском WordPress, плагинов и темы передаёт поток подходящего кэшированного ответа.

Он никогда не перезаписывает чужую карту, drop-in или объявление `WP_CACHE`. Перед заменой карты каждый артефакт графа проверяет все указанные файлы HTML, поэтому неудачное развёртывание с неполным рендерингом оставляет активным предыдущий граф. Записи Multisite изолируются по хосту, домашнему пути и ID сайта.

### Прогрев и состояние

Для повседневной работы предусмотрены три команды WP-CLI:

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

`status` выводит активный идентификатор, количество файлов и байтов, записи графа, состояние очереди, а также счётчики попаданий в кэш, промахов, сборок и ошибок по каждой области.

## Анализ и инструменты для агентов

### Профили анализа

`blockstudio/phpstan` добавляет к анализу блоков ещё три уровня и команду для запуска уровня, выбранного проектом.

| Профиль | Что добавляет |
| --- | --- |
| `base` | Анализ существующих схем, шаблонов, хуков, настроек и API. |
| `theme` | Корневые каталоги темы, заголовки стилей, ресурсы, области действия селекторов, значения полей по умолчанию и ограничения повторителей. |
| `extreme-theme` | PHPStan `max`, небезопасный PHP, экранирование, Tailwind, JavaScript и проверки Interactivity. |
| `wordpress-render` | Выполняемая вызывающей стороной проверка с помощью живого рендеринга поверх `extreme-theme`. |

Настройки по умолчанию берутся из `blockstudio.json`, поэтому интерактивный запуск, CI и хуки коммита используют одну конфигурацию:

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

### Управляемый хук коммита

Одна настройка и одна команда превращают выбранный профиль в условие для коммита.

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

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

При синхронизации хук и запись о его принадлежности сохраняются в общем каталоге Git, а `core.hooksPath` направляется в управляемый каталог. При этом вызывается настроенный ранее хук pre-commit. Во время коммита хук находит корень репозитория и проекта, поэтому клонированные рабочие копии и пути с пробелами поддерживаются.

Хук запускает только `vendor/bin/blockstudio-phpstan`; форматирования и перезаписи файлов он не выполняет. Если задать для `commit` значение `false` и повторно выполнить синхронизацию или запустить `blockstudio-githooks remove`, восстановится записанный путь к хуку и будут удалены только файлы, принадлежащие Blockstudio.

### Контракт проекта

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

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

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

Раздел о корректности формируется по файлам правил каждого слоя выбранного профиля. Поэтому новое правило в профиле меняет все создаваемые контракты.

Управление принадлежностью работает так же, как для хука коммита. Файл без маркера генерации не перезаписывается, если только `--force` не разрешает это. Раздел примечаний в конце сохраняется при повторной генерации; `--check` завершается с кодом `1`, если контракт устарел; а `--stdout` выводит его, не обращаясь к файловой системе.

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

Теперь `blockstudio-llm.txt` — это индекс, а не объединённый текст. Каждый опубликованный документ указан один раз в своём разделе и подразделе вместе с маршрутом, исходным файлом, кратким описанием и принадлежащими ему идентификаторами: путями настроек, именами хуков, функциями и классами 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`. Пока статический пререндеринг отключён, файлы не записываются и drop-in не устанавливается.

**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` можно удалить; вместо этого фрагмент кода, который находил его по шаблону, должен вызывать `Blockstudio\Runtime_Cache::purge('tailwind')`.

Плоский каталог `wp-content/blockstudio/cache/runtime`, оставшийся от версий до 7.6, автоматически переименовывается и исключается из активного пути, а затем удаляется в ходе ограниченных проходов WP-Cron. Поэтому большие деревья устаревших файлов блокировок не нужно удалять во время запроса на развёртывание.

**У сгенерированных файлов есть владельцы.** `assets/media.json` нужно хранить в системе контроля версий или создавать на этапе сборки. Карта маршрутов, drop-in `advanced-cache.php` и объявление `WP_CACHE` существуют, только пока включён `earlyServe`; хук pre-commit — только пока он синхронизирован. Все остальные сгенерированные файлы находятся в `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/ru/docs/dev/canvas/) и его [инвентарь и документAPI](https://blockstudio.dev/ru/docs/dev/canvas/#public-inventory-and-document-api)
- [Рендеринг](https://blockstudio.dev/ru/docs/blocks/rendering/#structured-compositions-and-complete-documents), [UIКомпоненты](https://blockstudio.dev/ru/ui/#public-inventory-and-examples) и [UIКомпозиция](https://blockstudio.dev/ru/ui/composition/)
- [Настройки](https://blockstudio.dev/ru/docs/general/settings/) и [производительность](https://blockstudio.dev/ru/docs/general/settings/#performance)
- [Производительность](https://blockstudio.dev/ru/docs/production/performance/), [Кеширование](https://blockstudio.dev/ru/docs/production/caching/) и [Статический пререндеринг](https://blockstudio.dev/ru/docs/production/static-prerendering/)
- [Tailwind CSS](https://blockstudio.dev/ru/docs/tailwind/#template-composition-helpers)
- [PHPStan](https://blockstudio.dev/ru/docs/dev/phpstan/): [пресеты](https://blockstudio.dev/ru/docs/dev/phpstan/#analysis-presets), [каноническая команда](https://blockstudio.dev/ru/docs/dev/phpstan/#canonical-command), [управляемый хук фиксации](https://blockstudio.dev/ru/docs/dev/phpstan/#managed-commit-hook) и [контракт проекта](https://blockstudio.dev/ru/docs/dev/phpstan/#project-contract-for-coding-agents)
- [Интеграция с AI](https://blockstudio.dev/ru/docs/dev/ai/): индекс документации и полный текст
- [Миграция](https://blockstudio.dev/ru/docs/dev/migration/v7/#canonical-block-tags) и [PHPХуки](https://blockstudio.dev/ru/docs/blocks/hooks/php/)
