
Blockstudio 7.3 добавляет новый уровень в фреймворк: повторно используемые компоненты UI, которые можно выводить как любые другие блоки.

Если в версии 7.1 блоки превратились в полнофункциональные приложения, а в 7.2 упростились просмотр, проверка и распространение крупных проектов, то версия 7.3 сосредоточена на повседневной разработке и редактировании этих приложений.

Кратко:

- **Компоненты UI**: библиотека компонентов `bsui/*` в составе пакета, подключаемая по желанию и работающая на основе WordPress Interactivity API.
- **Приложения**: примеры `app/*` в составе пакета, показывающие, как компоненты UI объединяются в более крупные интерфейсы.
- **Расширенный редактор**: более широкая выдвижная панель для редактирования полей Blockstudio, когда боковая панель становится слишком тесной.
- **Область действия селекторов ресурсов**: ресурсы CSS и SCSS могут использовать `%selector%` для выбора класса-обёртки блока.
- **Зависимости плагинов**: блоки могут требовать активные плагины WordPress, при необходимости с ограничениями по версии.
- **Политики редактора**: `blockstudio.json` могут настраивать глобальные блоки, паттерны и работу с медиафайлами с помощью хуков редактора, основанных на WordPress PHP.
- **Псевдонимы тегов блоков**: пользовательские псевдонимы для создания тегов блоков.
- **Статический анализ и документация**: более полный охват PHPStan для внешних библиотек блоков и сгенерированная документация по настройкам и хукам.
- **Исправления страниц и редактора**: более надёжный разбор страниц из файлов, обнаружение кандидатов Tailwind, режим сброса, изоляция кэша рендеринга и предварительная загрузка данных редактора.

## Библиотека UI

В версии 7.3 появилась библиотека компонентов в составе пакета и созданные на её основе примеры приложений.

### Компоненты UI

Blockstudio 7.3 включает библиотеку UI в составе пакета под пространством имён `bsui/*`. Эти компоненты — обычные блоки Blockstudio, поэтому их можно выводить в шаблонах, страницах из файлов, паттернах и содержимом записей с помощью уже знакомого вам синтаксиса тегов блоков.

Библиотека компонентов UI находится в бета-версии, пока мы собираем отзывы. Цель версии 7.3 — представить первый набор компонентов, проверить его на реальных проектах и до объявления стабильности интерфейса API уточнить названия, поведение и значения по умолчанию.

Библиотеку можно подключить по желанию:

```json title="blockstudio.json"
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "ui": {
    "enabled": true
  }
}
```

После подключения простые компоненты можно выводить напрямую:

```html
<block name="bsui/button" label="Save" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
  name="bsui/input"
  nameAlt="email"
  type="email"
  placeholder="Email"
></block>
```

Также доступен сокращённый синтаксис `bs:`:

```html
<bs:bsui-button label="Save" variant="default" />
```

Цель не в том, чтобы превратить Blockstudio в набор инструментов UI для создания страниц. Нужно сделать распространённые элементы интерфейса доступными в виде блоков, чтобы приложения на основе Blockstudio не создавали заново кнопки, диалоги, вкладки, списки выбора, поля формы, меню, панели инструментов и компоненты обратной связи для каждого проекта.

Первый набор компонентов включает базовые элементы для компоновки, действий, ввода, наложений, навигации, обратной связи, форм и отображения данных:

- `bsui/button`, `bsui/button-group`, `bsui/toggle`, `bsui/toggle-group`,
  `bsui/toolbar`
- `bsui/input`, `bsui/textarea`, `bsui/select`, `bsui/checkbox`,
  `bsui/radio-group`, `bsui/slider`, `bsui/switch`, `bsui/number-field`,
  `bsui/password-input`, `bsui/phone-input`, `bsui/otp-input`,
  `bsui/date-input`, `bsui/time-picker`
- `bsui/dialog`, `bsui/drawer`, `bsui/popover`, `bsui/menu`,
  `bsui/context-menu`, `bsui/menubar`, `bsui/tooltip`, `bsui/alert-dialog`
- `bsui/tabs`, `bsui/accordion`, `bsui/breadcrumb`, `bsui/pagination`,
  `bsui/navigation-menu`
- `bsui/card`, `bsui/table`, `bsui/stack`, `bsui/separator`,
  `bsui/aspect-ratio`, `bsui/badge`, `bsui/avatar`, `bsui/progress`,
  `bsui/meter`, `bsui/skeleton`, `bsui/spinner`, `bsui/kbd`
- `bsui/form`, `bsui/field`, `bsui/field-group`, `bsui/file-upload`,
  `bsui/color-picker`, `bsui/rating`

Многие из них — составные блоки. Блок `bsui/tabs` управляет интерактивным состоянием, а дочерние блоки, такие как `bsui/tabs-list`, `bsui/tabs-trigger` и `bsui/tabs-panel`, описывают структуру.

```html
<block name="bsui/tabs" defaultValue="features">
  <block name="bsui/tabs-list">
    <block name="bsui/tabs-trigger" value="features" title="Features"></block>
    <block name="bsui/tabs-trigger" value="pricing" title="Pricing"></block>
  </block>
  <block name="bsui/tabs-panel" value="features">
    <p>Features content.</p>
  </block>
  <block name="bsui/tabs-panel" value="pricing">
    <p>Pricing content.</p>
  </block>
</block>
```

Благодаря этому разметка остаётся читаемой, а состояние и поведение обрабатывает API Interactivity.

### Примеры приложений

В пространстве имён `app/*` находятся примеры, созданные из тех же компонентов UI.

Это не отдельный фреймворк, а примеры реализации более крупных интерфейсов Blockstudio: составные блоки, вложенные UI, состояние Interactivity API и ситуации, в которых компоненты UI взаимодействуют с функциями RPC или базы данных.

```html
<block name="app/kitchen-sink"></block>

<block name="app/chat">
  <block name="app/chat-sidebar"></block>
  <block name="app/chat-header"></block>
  <block name="app/chat-messages"></block>
  <block name="app/chat-input"></block>
</block>
```

Библиотека UI также включает собственную документацию и интерактивный справочник компонентов. Поведение компонентов — не просто набор шаблонов, а часть условий использования фреймворка, которая остаётся согласованной по мере роста библиотеки.

## Разработка и редактирование

Несколько изменений упрощают разработку и редактирование блоков.

### Расширенный редактор

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

Blockstudio 7.3 добавляет в инспектор блока действие «Расширенный редактор». Оно открывает более широкую выдвижную панель справа в редакторе и отображает там те же поля Blockstudio.

Главное, что используется та же система полей. Отрисовка полей не дублируется и не появляется второй путь сохранения данных; изменения в расширенном редакторе обновляют выбранный блок так же, как изменения в обычной боковой панели.

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

### Селекторы ресурсов с заданной областью действия

В Blockstudio уже была поддержка `%selector%` для полей кода. В версии 7.3 для ресурсов блока CSS и SCSS можно использовать тот же подход.

В файле CSS конструкция `%selector%` преобразуется в класс с заданной областью действия блока:

```css title="style.scoped.css"
%selector% {
  --hero-gap: var(--wp--preset--spacing--space-10);
}

%selector%.hero {
  border-bottom: 1px solid currentColor;
}

.hero__title {
  color: red;
}
```

Это позволяет стилизовать сам элемент-обёртку:

```php title="index.php"
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
  <h1 class="hero__title">Hero</h1>
</section>
```

Обычные селекторы в `*.scoped.css` по-прежнему выбирают потомков. `%selector%` — явный хук для корневого элемента блока.

### Зависимости плагинов

Теперь блоки могут объявлять зависимости от плагинов WordPress в ключе `blockstudio` объекта `block.json`.

Простая форма проверяет, активен ли каждый указанный идентификатор плагина:

```json title="block.json"
{
  "blockstudio": {
    "pluginDependencies": ["woocommerce"]
  }
}
```

В форме объекта можно указать ограничения по версии:

```json title="block.json"
{
  "blockstudio": {
    "pluginDependencies": {
      "woocommerce": {
        "version": ">6"
      }
    }
  }
}
```

Идентификаторы — это слаги плагинов WordPress, соответствующие системе зависимостей плагинов ядра WordPress. Blockstudio определяет активные плагины по их слагам и пропускает регистрацию, если необходимый плагин отсутствует, неактивен или его версия ниже требуемой.

Ограничение версии использует ту же модель сравнения, что и `version_compare()` в PHP. Обычная версия, например `"6"`, считается версией `>=6`.

Это полезно для блоков, которым необходим определённый плагин: карточек товаров WooCommerce, интеграций с формами, интеграций SEO, компонентов членства, виджетов бронирования или элементов админ-панели UI, связанных со сторонним плагином.

### Политики редактора

Файл `blockstudio.json` становится ещё полезнее как файл политик редактора на уровне проекта.

В версии 7.3 добавлен уровень политик `blockEditor` на основе PHP для настроек WordPress, уже доступных через серверные хуки. Это позволяет задавать глобальное поведение вставщика блоков, паттернов и медиафайлов без отдельного связующего кода темы.

```json title="blockstudio.json"
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "blockEditor": {
    "blocks": {
      "allow": ["core/*", "my-theme/*"],
      "deny": ["core/embed", "core/freeform"],
      "directory": false,
      "categories": {
        "rename": {
          "text": "Writing",
          "design": "Layout"
        },
        "order": ["my-theme", "text", "media"]
      }
    },
    "patterns": {
      "core": false,
      "remote": false,
      "categories": {
        "deny": ["gallery"],
        "order": ["featured", "buttons"]
      }
    },
    "media": {
      "openverse": false,
      "imageSizes": {
        "allow": ["thumbnail", "large"]
      }
    }
  }
}
```

Первая версия намеренно ограничена возможностями, поддерживаемыми через PHP: разрешёнными и запрещёнными блоками, загрузкой каталога блоков, метками и порядком категорий вставщика, источниками и категориями паттернов, Openverse, вариантами размеров изображений, видимостью устаревших виджетов и удалением стилей блоков, зарегистрированных через PHP.

Функция не пытается переопределять произвольные настройки блоков ядра по умолчанию. Такие настройки, как `core/columns.isStackedOnMobile`, задаются на этапе регистрации JavaScript в редакторе блоков, поэтому для них нужен отдельный, более явный API, вместо того чтобы имитировать их поддержку в файле JSON.

### Псевдонимы тегов блоков

Для тегов блоков появился фильтр псевдонимов:

```php title="functions.php"
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
    $aliases['theme-button'] = 'bsui/button';
    return $aliases;
});
```

Так проект может задавать удобные для автора теги, которые внутри системы по-прежнему соответствуют каноническому имени блока.

```html
<bs:theme-button label="Continue" />
```

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

## Инструменты и надёжность

Статический анализ, надёжность и инструменты повышения производительности стали лучше.

### Статический анализ и сгенерированная документация

Расширение PHPStan теперь поддерживает явное указание корневых директорий для сканирования внешних библиотек блоков. Благодаря этому проект может проверять теги `<bs:*>` и `<block>` по блокам за пределами текущего плагина или темы, учитывая эти директории только в реестре для целей анализа.

Проверки схем также расширены для метаданных страницы и `pluginDependencies`. Благодаря этому недопустимую конфигурацию при выпуске проще обнаружить до её появления в WordPress.

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

### Надёжность страниц и редактора

В версию 7.3 также вошёл ряд исправлений для страниц из файлов, отображения редактора и режима сброса.

Разбор страниц на основе файлов теперь учитывает атрибуты при сопоставлении пользовательских контейнеров во время разбора HTML. Теги страниц `bs:` также корректно обрабатывают пространства имен блоков с дефисами, поэтому такие имена, как `custom-theme/card`, больше не сбивают парсер.

Универсальные теги контейнеров, не относящиеся к ядру, теперь сериализуют корректный `innerContent`, если не предоставляют разметку оболочки. Благодаря этому синхронизированное содержимое страниц становится предсказуемее, а сериализация блоков WordPress остается корректной.

В редакторе исправлено несколько проблем с предварительным просмотром и предварительной загрузкой:

- Tailwind редактор CSS теперь включает кандидаты классов из файловых шаблонов страниц.
- Предварительная загрузка редактора сохраняет классы обёртки RichText для повторяющихся блоков одного типа.
- Предварительная загрузка редактора учитывает блоки, значения полей по умолчанию которых раскрываются с помощью Gutenberg, но отсутствуют в сохранённой разметке блока.
- Зарегистрированные атрибуты по умолчанию, раскрываемые с помощью Gutenberg, игнорируются перед сравнением ключей кэша рендеринга.
- Предварительный просмотр в редакторе и вставщике теперь хранится в отдельных записях кэша, даже если у них общий идентификатор клиента.
- `bs_get_group()` теперь корректно работает с повторно используемыми группами пользовательских полей, в том числе с группами, идентификатор которых совпадает с именем пользовательского поля, и извлекает только точные префиксы групп.
- Поля ссылок с `withCreateSuggestion` теперь корректно подключают сценарий создания WordPress LinkControl и создают черновые страницы через REST API.
- Шаблоны блоков PHP теперь выполняются один раз за рендеринг вместо запуска отброшенного предварительного подключения.

Режим сброса также стал точнее. Теперь он нейтрализует правила ширины и вертикальных отступов блоков редактора Gutenberg для настроенных типов записей, при необходимости удаляет стили содержимого и сброса в iframe WordPress, а также улучшает наложения при наведении и выборе в Blockstudio.

Проверки регрессий для сложных шаблонов InnerBlocks также расширены: теперь они охватывают вложенные блоки Blockstudio, чтобы проверить путь рендеринга редактора на самых трудных для ручной проверки сценариях вставки шаблонов.

### Инструменты оценки производительности

Локальные анонимные пробы `blockstudio-perf=1` теперь могут добавлять заголовки `Server-Timing`, не внедряя панель отладки.

Теперь замеры охватывают больше этапов сборки: обнаружение, обработку ресурсов, регистрацию и переопределения. Так проще увидеть, куда уходит время, не включая видимую панель профилирования UI.

## Почему этот релиз важен

Главная тема версии 7.3 — композиция.

Компоненты UI упрощают создание интерфейсов приложений. Расширенный редактор облегчает работу с крупными блоками. Зависимости плагинов позволяют блокам указывать, какой контекст плагинов им нужен. Политики редактора переносят правила редактора блоков на уровне проекта в `blockstudio.json`. Псевдонимы тегов блоков упрощают создание шаблонов. Исправления парсера, PHPStan и редактора повышают надежность этих композиций при прохождении через WordPress.

Blockstudio по-прежнему основан на файлах. Блоки по-прежнему представлены папками. Шаблоны по-прежнему выполняют свою работу. Но теперь поверх этой основы у фреймворка есть более развитый слой UI.
