
Verze Blockstudio 7.3 přidává do frameworku novou vrstvu: opakovaně použitelné komponenty UI, které lze vykreslit jako jakýkoli jiný blok.

Zatímco verze 7.1 proměnila bloky v aplikace s celým zásobníkem a 7.2 usnadnila kontrolu, ověřování a distribuci větších projektů, verze 7.3 se zaměřuje na každodenní práci při tvorbě a úpravách těchto aplikací.

Stručně řečeno:

- **Komponenty UI**: knihovna komponent `bsui/*`, která je součástí balíčku, její zapnutí je volitelné a využívá framework Interactivity API WordPress.
- **Aplikace**: příklady `app/*` obsažené v balíčku ukazují, jak lze komponenty UI skládat do rozsáhlejších rozhraní.
- **Rozšířený editor**: širší postranní panel pro úpravy polí Blockstudio, když je postranní panel příliš úzký.
- **Selektory pro konkrétní prostředky**: prostředky CSS a SCSS mohou pomocí `%selector%` přímo cílit na třídu obalu bloku.
- **Závislosti pluginů**: bloky mohou vyžadovat aktivní pluginy WordPress a případně stanovit omezení jejich verzí.
- **Zásady editoru**: `blockstudio.json` mohou pomocí hooků editoru založených na WordPress PHP nastavit globální bloky, vzory a chování médií.
- **Alias názvů značek bloků**: vlastní aliasy pro zápis značek bloků.
- **Statická analýza a dokumentace**: lepší pokrytí PHPStan pro externí knihovny bloků a generovaná dokumentace k nastavením a hookům.
- **Opravy stránek a editoru**: spolehlivější parsování stránek ze souborů, detekce kandidátů Tailwind, režim resetování, oddělení mezipaměti vykreslování a přednačítání editoru.

## Knihovna UI

Verze 7.3 přináší knihovnu komponent obsaženou v balíčku a ukázkové aplikace, které ji využívají.

### Komponenty UI

Blockstudio 7.3 obsahuje knihovnu UI v rámci jmenného prostoru `bsui/*`.
Komponenty jsou běžné bloky Blockstudio, takže je lze vykreslit v šablonách, stránkách založených na souborech, vzorech i obsahu příspěvků pomocí stejné syntaxe značek bloků, kterou už používáte.

Knihovna komponent UI je ve fázi beta, během níž sbíráme další zpětnou vazbu. Cílem verze 7.3 je zpřístupnit první sadu komponent, získat zkušenosti ze skutečných projektů a vyladit názvy, chování i výchozí hodnoty, než označíme rozhraní API za stabilní.

Knihovna se zapíná volitelně:

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

Po zapnutí lze jednoduché komponenty vykreslit přímo:

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

Funguje také kratší syntaxe `bs:`:

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

Cílem není proměnit Blockstudio v sadu UI pro tvorbu stránek. Jde o zpřístupnění běžných základních prvků rozhraní jako bloků, aby aplikace vytvořené pomocí Blockstudio nemusely v každém projektu znovu vytvářet tlačítka, dialogy, karty, výběrová pole, formulářová pole, nabídky, panely nástrojů a komponenty pro zpětnou vazbu.

První sada komponent obsahuje základní prvky pro rozvržení, akce, vstupní pole, překryvné vrstvy, navigaci, zpětnou vazbu, formuláře a zobrazení dat:

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

Mnohé z nich jsou složené bloky. Blok `bsui/tabs` spravuje interaktivní stav, zatímco podřízené bloky, jako jsou `bsui/tabs-list`, `bsui/tabs-trigger` a `bsui/tabs-panel`, určují strukturu.

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

Díky tomu zůstává značení přehledné, zatímco stav a chování zajišťuje framework Interactivity API.

### Ukázkové aplikace

Jmenný prostor `app/*` obsahuje ukázky sestavené ze stejných komponent UI.

Nejde o samostatný framework. Jsou to referenční implementace rozsáhlejších rozhraní Blockstudio: složených bloků, vnořených prvků UI, stavu frameworku Interactivity API i míst, kde se komponenty UI propojují s funkcemi RPC nebo funkcemi využívajícími databázi.

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

Součástí knihovny UI je také vlastní dokumentace a živá ukázka komponent. Chování komponent není jen souborem šablon. Patří ke smluveným vlastnostem frameworku a s růstem knihovny zůstává konzistentní.

## Tvorba a úpravy

Několik změn usnadňuje tvorbu a úpravy bloků.

### Rozšířený editor

Při úpravách složitých bloků na postranním panelu inspektoru může rychle začít být těsno. Platí to zejména pro opakovače, kódová pole, formátovaný text a vnořené skupiny.

Verze Blockstudio 7.3 přidává do inspektoru bloku akci pro rozšířený editor. Otevře širší panel z pravé strany editoru a zobrazí v něm stejná pole Blockstudio.

Podstatné je, že se stále používá stejný systém polí. Vykreslování polí se neduplikuje, nezavádí se druhá cesta ukládání a změny provedené v rozšířeném editoru aktualizují vybraný blok stejně jako úpravy v běžném postranním panelu.

Použijte ho, když postranní panel stačí k procházení polí, ale pro zadávání údajů je příliš úzký.

### Selektory pro konkrétní prostředky

Blockstudio už podporoval `%selector%` pro kódová pole. Ve verzi 7.3 mohou stejný způsob zápisu používat také bloková prostředí CSS a prostředky SCSS.

V souboru CSS se `%selector%` rozbalí na třídu vymezenou pro daný blok:

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

Díky tomu lze stylovat skutečný obalový prvek:

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

Běžné selektory v `*.scoped.css` nadále cílí na potomky. `%selector%` je výslovný hook pro kořenový prvek bloku.

### Závislosti pluginů

Bloky mohou nyní deklarovat závislosti na pluginech WordPress uvnitř klíče `blockstudio` v `block.json`.

Jednoduchá forma ověřuje, zda jsou všechny uvedené identifikátory pluginů aktivní:

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

Objektová forma přidává omezení verzí:

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

Jde o identifikátory pluginů WordPress, které odpovídají systému závislostí pluginů v jádru WordPress. Blockstudio převede aktivní pluginy na tyto identifikátory a přeskočí registraci, pokud požadovaný plugin chybí, není aktivní nebo má nižší než požadovanou verzi.

Omezení verze používá stejný způsob porovnávání jako `version_compare()` v PHP. Jednoduchá verze, například `"6"`, se považuje za `>=6`.

To se hodí u bloků, které mají smysl jen tehdy, když je plugin dostupný: produktové karty WooCommerce, integrace formulářů, integrace SEO, členské komponenty, rezervační widgety nebo prvky administrace UI navázané na plugin třetí strany.

### Zásady editoru

Soubor `blockstudio.json` se stává užitečnějším také jako soubor se zásadami editoru na úrovni projektu.

Verze 7.3 přidává vrstvu zásad `blockEditor` založenou na PHP pro nastavení, která WordPress již zpřístupňuje prostřednictvím serverových hooků. Můžete tak definovat globální chování nástroje pro vkládání bloků, vzorů a médií, aniž byste museli přidávat jednorázový propojovací kód do šablony.

```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"]
      }
    }
  }
}
```

První verze záměrně zahrnuje jen možnosti podložené PHP: povolené a zakázané bloky, načítání adresáře bloků, názvy a pořadí kategorií vkládání, zdroje a kategorie vzorů, Openverse, volby velikosti obrázků, viditelnost starších widgetů a odebrání stylů bloků registrovaných pomocí PHP.

Nepokouší se přepisovat libovolná výchozí nastavení základních bloků. Nastavení jako `core/columns.isStackedOnMobile` jsou součástí procesu registrace JavaScript v editoru bloků, takže vyžadují samostatné, výslovnější API místo toho, aby se uměle vměstnala do souboru JSON.

### Aliasy značek bloků

Značky bloků nyní podporují filtr aliasů:

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

Projekt tak může definovat značky, které se snadno zapisují, a přitom je interně nadále převádět na kanonický název bloku.

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

To se hodí zejména při skládání šablon náročných na UI, kde jsou kanonické názvy bloků správné, ale ne vždy se s nimi nejsnáze pracuje.

## Nástroje a spolehlivost

Pokročila statická analýza, spolehlivost i nástroje pro měření výkonu.

### Statická analýza a generovaná dokumentace

Rozšíření PHPStan nově podporuje výslovné určení kořenových složek pro skenování externích knihoven bloků. Projekt tak může ověřovat značky `<bs:*>` a `<block>` podle bloků mimo aktuální plugin nebo šablonu, přičemž tyto složky zůstávají při analýze dostupné pouze přes registr.

Kontroly schémat byly rozšířeny také o metadata stránek a `pluginDependencies`, takže neplatné nastavení při vydání lze snáze zachytit dříve, než se dostane do WordPress.

Generování dokumentace nyní zahrnuje také referenční přehled filtrů pro nastavení a hooky PHP. S tím, jak se `blockstudio.json` stává skutečným souborem se zásadami projektu místo několika roztroušených přepínačů, je to stále důležitější.

### Spolehlivost stránek a editoru

Verze 7.3 obsahuje také několik oprav týkajících se stránek založených na souborech, vykreslování editoru a režimu resetování.

Zpracování stránek ze souborů nyní při parsování HTML zohledňuje atributy v mapování vlastních kontejnerů. Značky stránek `bs:` také správně rozpoznávají názvy bloků s pomlčkami, takže názvy jako `custom-theme/card` už parser nezmatou.

Obecné značky kontejnerů mimo jádro nyní serializují platné `innerContent`, pokud neposkytují obalové značky. Díky tomu je synchronizovaný obsah stránek předvídatelnější a serializace bloků WordPress zůstává platná.

Editor se dočkal několika oprav náhledu a předběžného načítání:

- Tailwind editor CSS nyní zahrnuje kandidátní třídy ze souborových šablon stránek.
- Přednačtení editoru zachovávají třídy obalu RichText u opakovaných bloků stejného typu.
- Přednačtení editoru odpovídají blokům, jejichž výchozí hodnoty polí rozšíří Gutenberg, ale v uloženém zápisu bloku chybějí.
- Registrované výchozí atributy rozšířené pomocí Gutenberg se před porovnáním klíčů mezipaměti vykreslení ignorují.
- Náhledy v editoru a vkladači nyní používají samostatné položky mezipaměti, i když sdílejí ID klienta.
- `bs_get_group()` nyní správně funguje s opakovaně používanými skupinami vlastních polí, včetně skupin, jejichž ID odpovídá názvu vlastního pole, a získává pouze přesné předpony skupin.
- Pole odkazů s `withCreateSuggestion` nyní správně propojují proces vytváření v WordPress LinkControl a vytvářejí koncepty stránek prostřednictvím REST API.
- Šablony bloků PHP se nyní spustí jednou při každém vykreslení namísto spuštění zahozeného předběžného vložení.

Režim resetování byl také zpřísněn. Nyní u nakonfigurovaných typů příspěvků neutralizuje pravidla šířky bloků a svislých okrajů editoru Gutenberg, podle potřeby odstraňuje styly obsahu a resetování v iframe WordPress a zajišťuje čistší překryvy při najetí a výběru v Blockstudio.

Rozšířily se také regresní testy složitých vzorů InnerBlocks o vnořené bloky Blockstudio, aby vykreslování v editoru bylo ověřeno i pro případy vkládání vzorů, které se ručně kontrolují nejobtížněji.

### Nástroje pro měření výkonu

Lokální anonymní sondy `blockstudio-perf=1` nyní mohou odesílat hlavičky `Server-Timing`, aniž by vkládaly panel ladění.

Měření nyní pokrývá větší část životního cyklu sestavení: objevování, zpracování prostředků, registraci a přepsání. Snáze tak zjistíte, kde se čas skutečně spotřebovává, aniž byste museli zapínat viditelný panel pro profilování UI.

## Proč na tomto vydání záleží

Hlavním tématem verze 7.3 je skládání.

Komponenty UI usnadňují skládání rozhraní aplikací. Rozšířený Editor usnadňuje úpravy větších bloků. Závislosti pluginů umožňují blokům popsat potřebný kontext pluginu. Zásady editoru přesouvají pravidla editoru bloků pro celý projekt do `blockstudio.json`. Aliasům značek bloků vděčíme za pohodlnější tvorbu šablon. Opravy parseru, PHPStan a editoru zajišťují spolehlivější fungování těchto celků při průchodu přes WordPress.

Blockstudio je stále založený na souborech. Bloky jsou stále složky. Práci stále odvádějí šablony. Nad tímto základem však framework nyní přidává silnější vrstvu UI.
