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

Основну частину випуску забезпечують два виклики. `Canvas::inventory()` повертає всі сторінки, блоки, патерни, шаблони Site Editor, частини шаблонів і приклади 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` за межі шаблонів блоків.
- **Керований хук коміту**: `blockstudio-githooks sync` створює та керує хуком pre-commit, який запускає налаштований набір правил.
- **Контракт проєкту**: `blockstudio-agents` створює `AGENTS.md` з описом того, що створюють автори проєкту, які функції ввімкнені та що вимагає його набір правил.
- **Покажчик документації**: файл контексту для AI тепер містить покажчик усіх документів, їх призначення та ідентифікаторів, за які вони відповідають.
- **Канонічні теги блоків**: окрема команда переписує скорочення префіксів і псевдонімів у `<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` або `"*"` завантажує всі записи відповідного типу.
- Рядок або список шукає точний збіг за ідентифікатором, назвою, слагом, шляхом або шляхом до джерела.
- Порожній рядок, порожній список або `false` не завантажує жодного запису цього типу.
- Щойно задано ключ будь-якого типу, пропущені типи залишаються без змін.

Ідентифікатори, яких більше не існує, повертаються в `deleted`, а не спричиняють помилку,
і кінцева точка оновлення Canvas REST застосовує те саме правило до параметрів `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/uk/ui/composition/); у [/ui/examples](https://blockstudio.dev/uk/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, pingbacks
і виявлення віддаленого редактора вимикаються; загальні ресурси фронтенду core видаляються;
застосовуються типові налаштування виводу зображень; Heartbeat обмежується поза редакторами; документи з того самого джерела попередньо завантажуються за наведенням або наміром фокусування; використовується завантажувач зображень Blockstudio.

Кожне дочірнє значення перевизначає профіль, як це робить `preload.links` вище. Спершу варто перевірити видалення ресурсів фронтенду core, оскільки залежна від них сторінка матиме видимі проблеми. `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,
персоналізовані файли 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 керує невеликою картою маршрутів для сайту та модулем `advanced-cache.php`, який передає вміст придатного запиту з кешу ще до запуску WordPress,
плагінів або теми.

Він ніколи не перезаписує чужу карту, модуль або оголошення `WP_CACHE`. Перш ніж замінити карту, артефакт графа перевіряє кожен файл HTML, на який є посилання, тож невдале розгортання з частковим рендерингом залишає активним попередній граф. Записи Multisite ізольовано за хостом, домашнім шляхом та ідентифікатором сайту.

### Прогрівання та стан

Для щоденної роботи призначено три команди 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` можна видалити; замість цього сніпет, який шукав там файли через glob, має викликати `Blockstudio\Runtime_Cache::purge('tailwind')`.

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

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