
Blockstudio 7.2 одновременно развивает платформу в двух направлениях.

Первое — **видимость и рабочий процесс** в рамках одного проекта: новый обзор панели администратора, обозреватель базы данных, обозреватель реестра администратора и прелюдии SCSS для общей настройки Sass.

Второе — **экосистема вокруг Blockstudio**: реестр CLI для распространения блоков (как shadcn для WordPress) и расширение PHPStan, которое добавляет проверку типов в стиле TypeScript для шаблонов, тегов блоков, `db.php`, `rpc.php`, `cron.php` и связанных файлов схем.

Оба направления преследуют одну цель: упростить понимание, развитие и совместное использование крупных проектов Blockstudio.

## Работа в панели администратора

Два новых элемента упрощают навигацию по крупному проекту в wp-admin.

### Обзор панели администратора

Теперь Blockstudio включает экран панели администратора в разделе **Инструменты > Blockstudio**. Здесь можно посмотреть, что система зарегистрировала в файловой системе.

В обзоре есть отдельные вкладки для:

- Блоков
- Расширений
- Полей
- Страниц
- Схем

В дополнение к обзору в панели администратора появился отдельный раздел **Базы данных**. В нем перечислены все зарегистрированные схемы `Blockstudio\Db`, а реальные записи можно просматривать прямо в wp-admin.

Вместо пользовательской сетки панелей экран использует таблицы DataViews WordPress. Благодаря этому интерфейс UI соответствует панели администратора и остается удобным даже в проектах с десятками или сотнями регистраций.

В небольшом проекте можно держать состояние среды выполнения в голове. В крупной кодовой базе это уже не работает. Возникают вопросы:

- Какие блоки зарегистрированы сейчас?
- Какие расширения предназначены для `core/*`, а какие — для отдельных блоков?
- Какие страницы синхронизированы и к каким типам записей они относятся?
- Какие повторно используемые поля есть в проекте?
- Какие схемы зарегистрированы и какой тип хранилища они используют?

Раньше ответы приходилось искать, изучая папки, открывая файлы JSON и просматривая PHP. Теперь для этого есть отдельный экран панели администратора.

Каждая вкладка помогает найти ответы на определенные вопросы:

- **Блоки**: зарегистрированные типы блоков, режим рендеринга, версия API и число атрибутов
- **Расширения**: целевые блоки, приоритет и сведения о рендеринге
- **Поля**: краткий список повторно используемых определений пользовательских полей
- **Страницы**: синхронизированные страницы из файлов с типом записи, статусом, движком шаблонов и состоянием синхронизации
- **Схемы**: зарегистрированные схемы хранилища с указанием типа хранилища, числа полей и области разрешений

Просмотрщик базы данных намеренно отделён от первоначальной сводной нагрузки. Вместо сериализации каждой строки при загрузке страницы он заранее загружает только доступные схемы, а записи запрашивает по мере необходимости при открытии вкладки базы данных. Благодаря этому панель администратора остаётся удобной даже в проектах с большими наборами данных за `db.php`.

Первая версия намеренно сосредоточена на регистрациях, основанных на схемах. Это не страница настроек, а страница просмотра.

Если эта функция вам совсем не нужна, отключите её полностью:

```php
add_filter('blockstudio/admin/enabled', '__return_false');
```

### Просмотрщик реестра в панели администратора

Рядом со сводкой находится вторая вкладка — **Реестр**. Это просмотрщик удалённых реестров блоков, настроенных в `blocks.json` вашей темы. Он позволяет импортировать блоки прямо из панели администратора WordPress, не открывая CLI.

```json title="blocks.json"
{
  "directory": "blockstudio",
  "registries": {
    "ui": "https://blocks.example.com/registry.json",
    "private": {
      "url": "https://api.example.com/registry.json",
      "headers": {
        "Authorization": "Bearer ${REGISTRY_TOKEN}"
      }
    }
  }
}
```

Просмотрщик загружает каждый настроенный реестр, перечисляет все доступные блоки и показывает, установлен ли каждый из них локально или доступен для импорта. В каждой строке есть кнопка «Импорт», которая загружает файлы блока в настроенную директорию темы. Для уже установленных блоков вместо неё показывается кнопка «Импортировать повторно».

Поддерживаются реестры с аутентификацией в формате объекта с `headers`, включая подстановку `${ENV_VAR}`, поэтому токены никогда не попадают в систему контроля версий.

Так работа с реестрами становится полноценной частью интерфейса панели администратора, а не просто процессом CLI.

## Реестр CLI

Вторая часть работы с реестрами — отдельный CLI: `blockstudio/registry`.

Это инструмент в духе shadcn для блоков WordPress. Без пакета npm и этапа сборки. Вы запускаете команду, исходный код блока копируется в проект, и он полностью принадлежит вам.

```bash
npx blockstudio init
npx blockstudio add ui/tabs
```

CLI работает с блоками любого типа: блоками Blockstudio, выводом `@wordpress/create-block`, обычными блоками PHP. Реестру не важно, что находится в папке. Он читает манифест файлов из `registry.json` и копирует именно перечисленные в нём файлы.

Авторы блоков публикуют `registry.json` по любому URL (GitHub с исходным содержимым, S3 или собственный сервер), где перечислены доступные блоки, их метаданные, зависимости и списки файлов. Пользователи добавляют URL в свой `blocks.json` и загружают блоки по имени.

CLI поддерживает:

- **Разрешение зависимостей**: блоки могут объявлять зависимости от других блоков; они разрешаются автоматически с обнаружением циклов
- **Обработка конфликтов между реестрами**: если блок с одним именем есть в нескольких реестрах, CLI предложит выбрать нужный
- **Реестры с аутентификацией**: токены носителя, базовая аутентификация и пользовательские заголовки с подстановкой переменных окружения
- **Интерактивный TUI**: создан на Ink; включает индикаторы загрузки, запросы выбора и индикаторы выполнения
- **Неинтерактивный режим**: флаг `--yes` и автоматический переход в режим CI или конвейерной обработки
- **Поиск и список**: просмотр реестров из командной строки

В пакет входит 130 тестов схем, разрешения зависимостей, загрузки HTTP, записи файлов, всех сценариев команд и интерактивного UI Ink.

Полная документация: [blockstudio.dev/registry](https://blockstudio.dev/ru/registry/).

## Расширение PHPStan

Ещё одно крупное нововведение — `blockstudio/phpstan`: расширение PHPStan, которое даёт пользователям Blockstudio такую же безопасность типов, какую ожидают разработчики TypeScript.

```bash
composer require --dev blockstudio/phpstan
```

Во время анализа расширение считывает реальные схемы проекта и передаёт полученные типы обратно в PHPStan. Теперь поддерживаются шаблоны PHP, Twig, Blade, теги блоков, типизированные записи базы данных, пути настроек, имена хуков и проверка схем в `block.json`, `field.json`, расширении JSON, `page.json`, `db.php`, `rpc.php`, `cron.php` и `blockstudio.json`.

### Типобезопасные шаблоны блоков

Обращения к полям в `$a` проверяются по соседнему `block.json`:

```php title="blockstudio/hero/index.php"
<?php
/** @var array<string, mixed> $a */

echo $a['title'];     // OK
echo $a['cta']['href']; // OK
echo $a['typo'];      // ERROR: Field "typo" does not exist in block.json (block: hero). Did you mean "title"?
```

### Типобезопасные записи базы данных

`Db::get()` возвращает типизированный экземпляр на основе схемы `db.php`. Структура записи формируется по фактическим полям:

```php title="db.php"
return [
  'storage' => 'table',
  'fields' => [
    'email' => ['type' => 'string', 'required' => true],
    'name'  => ['type' => 'string'],
  ],
];
```

```php
$db = Db::get('mytheme/subscribers');
$record = $db->create(['email' => 'a@b.com']);

echo $record['email']; // PHPStan: string
echo $record['name'];  // PHPStan: string|null
echo $record['typo'];  // ERROR: Offset 'typo' does not exist on array{id: int, email: string, name: string|null}
```

### Проверка схем

Недопустимые файлы схем выявляются во время анализа: `block.json`, `field.json`, расширение JSON, `page.json`, `db.php`, `rpc.php`, `cron.php` и `blockstudio.json`. Отсутствующие имена, неправильные типы полей, некорректные определения и устаревшие логические значения в сокращённой форме (`"tailwind": true` вместо вложенного объекта) — обо всех ошибках сообщается с указанием точной строки в исходном файле.

### Проверка путей настроек

Вызовы `Settings::get()` проверяются по известной схеме настроек:

```php
Settings::get('tailwind/enabled');  // OK, returns bool
Settings::get('tailwind/enabld');   // ERROR: Settings path "tailwind/enabld" is not a known Blockstudio setting. Did you mean "tailwind/enabled"?
```

### Проверка имён хуков

То же самое выполняется для имён хуков фильтров и действий:

```php
add_filter('blockstudio/render', $cb);  // OK
add_filter('blockstudio/rendrr', $cb);  // ERROR: Unknown Blockstudio hook "blockstudio/rendrr". Did you mean "blockstudio/render"?
```

Расширение также включает заглушки для всего публичного API Blockstudio: `Db`, `Settings`, `Field_Registry`, `Build` и глобальных вспомогательных функций. Вы получаете автодополнение и проверку типов для всех API Blockstudio без исходного кода плагина на машине разработчика.

## Удобства для разработки

Релиз дополняют два небольших удобства для разработки.

### Глобальные прелюдии SCSS

Blockstudio уже поддерживал компиляцию SCSS, но оставалось одно неудобство: настройка общих Sass.

Если вам нужен общий набор переменных, функций или примесей, приходилось импортировать их в каждый файл SCSS. Это быстро надоедает, особенно при работе с большими дизайн-системами или наборами инструментов Sass, такими как Bootstrap.

В версии 7.2 для этого добавлен хук прелюдии:

```php
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
  return '@import "functions";' . "\n"
    . '@import "variables";' . "\n"
    . '@import "mixins";';
}, 10, 3);
```

В сочетании с существующим фильтром `blockstudio/assets/process/scss/import_paths` вы один раз определяете общую среду Sass, доступную каждому скомпилированному файлу.

Таблица стилей блока может содержать только нужные ему стили:

```scss title="style.scss"
.hero {
  @include media-breakpoint-up(lg) {
    padding: 4rem;
  }
}
```

Больше не нужно повторять импорты в ресурсах каждого блока. Это не особый режим «поддержки Bootstrap», а универсальный хук для общего Sass проекта, будь то Bootstrap или ваш собственный внутренний набор инструментов.

### Определения блоков в нативном синтаксисе PHP для API

В версии 7.2 также появился необязательный синтаксис PHP для полнофункциональных API блоков. Массивы остаются форматом по умолчанию и полностью поддерживаются. Ничего не заменено. Но если вы предпочитаете именованные аргументы, перечисления и атрибуты вложенным массивам конфигурации, теперь можно выбрать этот стиль.

Для `rpc.php` верните объект с методами, помеченными атрибутами:

```php title="rpc.php"
<?php
use Blockstudio\Attributes\Rpc;
use Blockstudio\Rpc\Access;
use Blockstudio\Rpc\Method;

return new class {
    #[Rpc(access: Access::Session)]
    public function subscribe(array $params): array {
        return ['success' => true];
    }

    #[Rpc(name: 'status', methods: [Method::Get, Method::Post])]
    public function getStatus(array $params): array {
        return ['status' => 'ok'];
    }
};
```

Для `cron.php` тот же подход работает с `#[Cron]`:

```php title="cron.php"
<?php
use Blockstudio\Attributes\Cron;
use Blockstudio\Cron\Schedule;

return new class {
    #[Cron(schedule: Schedule::Hourly)]
    public function heartbeat(): void {
    }
};
```

А для `db.php` теперь есть небольшой уровень построителя:

```php title="db.php"
<?php
use Blockstudio\Db\Field;
use Blockstudio\Db\Schema;
use Blockstudio\Db\Storage;

return Schema::make(
    storage: Storage::Table,
    fields: [
        'email' => Field::string(required: true, format: 'email'),
        'active' => Field::boolean(default: false),
    ],
);
```

Такой подход лучше подходит для крупных кодовых баз. Когда нужно, вы сохраняете простоту формата массивов, а по мере роста блока и увеличения числа полей или конечных точек можете перейти к более понятной среде PHP.

## Почему эти возможности выпущены вместе

Сводка панели администратора, просмотрщик реестра, реестр CLI и расширение PHPStan отвечают на один и тот же вопрос: как сохранить понятность проекта Blockstudio по мере его роста?

Инструменты панели администратора помогают на уровне проекта: дают представление о зарегистрированных компонентах, позволяют добавлять блоки из реестров и уменьшают необходимость в догадках.

CLI помогает на уровне экосистемы: позволяет обмениваться блоками между проектами и командами, не упаковывая их в пакеты npm и не борясь с системами сборки.

Расширение PHPStan помогает на уровне кода: выявляет неправильное обращение к полям, опечатки в схемах и ошибочные колбэки хуков до их выполнения.

В этом и состоит общее направление версии 7.2: меньше догадок и повторений, больше наглядности и теперь ещё настоящая безопасность типов.

## Исправления ошибок

- **Поле классов**: введённые пользователем имена пользовательских классов незаметно удалялись при потере фокуса, потому что валидатор принимал только классы из предопределённого списка Tailwind/настроек. Теперь принимается любая непустая строка.
- **Поле атрибутов**: после удаления пары атрибутов в сохранённых данных оставались элементы `null`. Вместо lodash `unset()` (который обнуляет элементы массива) теперь используется `splice()` (который их удаляет).
- **Минификатор CSS**: минификатор TailwindPHP удалял пробелы вокруг `+` внутри `calc()` и `clamp()`, из-за чего получались недопустимые CSS, например `calc(1rem+0.5vw)`. Исправлено в вышестоящем TailwindPHP v1.3.1: теперь символы обходятся с учётом глубины, и пробелы удаляются только вокруг комбинаторов селекторов на глубине скобок 0.
- **Предпросмотр вставщика блоков**: в предпросмотре вставщика блоков `$isPreview` всегда имел значение `false`, потому что хеш-ключ кэша рендеринга не учитывал режим рендеринга. Теперь для рендеринга в редакторе и предпросмотре создаются отдельные записи кэша.
- **Вложенный шаблон InnerBlocks**: компонент `<InnerBlocks template="..."/>` отбрасывал третий элемент (дочерние элементы) из кортежей шаблона, например `['core/group', {}, [['core/paragraph']]]`, из-за чего блоки-контейнеры оказывались пустыми. Теперь вложенные дочерние элементы сохраняются.
