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

Така маркировката остава лесна за четене, а състоянието и поведението се обработват от Interactivity API.

### Примери за приложения

Пространството от имена `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 преобразува активните плъгини до тези идентификатори и пропуска регистрацията, ако задължителен плъгин липсва, е неактивен или е с по-стара от необходимата версия.

Ограничението за версия използва същия модел за сравнение като PHP `version_compare()`. Обикновена версия като `"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`, когато не предоставят обвиващ markup. Така синхронизираното съдържание на страниците става по-предвидимо и сериализацията на блокове в WordPress остава валидна.

Редакторът получи набор от корекции за визуализациите и предварителното зареждане:

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

Режимът за нулиране също е подобрен. Вече неутрализира правилата за ширина на блоковете и вертикални отстъпи в редактора на Gutenberg за конфигурираните типове публикации, премахва стиловете за съдържание и нулиране на iframe в WordPress, когато е нужно, и осигурява по-изчистени наслагвания при посочване и избор в Blockstudio.

Обхватът на регресионните проверки за сложни модели с InnerBlocks също беше разширен и вече включва вложени блокове Blockstudio, така че пътят за визуализация в редактора се проверява и при случаите на вмъкване на модели, които най-трудно се забелязват ръчно.

### Инструменти за производителност

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

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

## Защо тази версия е важна

Основната тема на версия 7.3 е композирането.

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

Blockstudio все още е базиран на файлове. Блоковете все още са папки. Шаблоните все още вършат работата. Но върху тази основа рамката вече има по-силен слой UI.
