
Blockstudio 7.3 pridáva do frameworku novú vrstvu: opakovane použiteľné komponenty UI,
ktoré možno vykresliť ako akýkoľvek iný blok.

Kým verzia 7.1 zmenila bloky na aplikácie s plným zásobníkom a verzia 7.2 uľahčila kontrolu, validáciu a distribúciu väčších projektov, verzia 7.3 sa zameriava na každodennú prácu pri tvorbe a úpravách týchto aplikácií.

Stručne:

- **Komponenty UI**: zoskupená knižnica komponentov `bsui/*` s voliteľným zapojením, poháňaná rozhraním WordPress Interactivity API.
- **Aplikácie**: zoskupené príklady `app/*`, ktoré ukazujú, ako sa komponenty UI skladajú do väčších rozhraní.
- **Rozšírený editor**: širší vysúvací panel na úpravu polí Blockstudio, keď je bočný panel príliš stiesnený.
- **Selektory prostriedkov s obmedzeným rozsahom**: prostriedky CSS a SCSS môžu používať `%selector%` na zacielenie priamo na obalovú triedu bloku.
- **Závislosti doplnkov**: bloky môžu vyžadovať aktívne doplnky WordPress s voliteľnými obmedzeniami verzií.
- **Pravidlá editora**: `blockstudio.json` môže pomocou hákov editora založených na PHP WordPress konfigurovať globálne bloky,
  vzory a správanie médií.
- **Aliasy značiek blokov**: vlastné aliasy na tvorbu značiek blokov.
- **Statická analýza a dokumentácia**: lepšie pokrytie PHPStan pre externé knižnice blokov a generovaná dokumentácia nastavení a hákov.
- **Opravy stránok a editora**: spoľahlivejšie spracovanie stránok založených na súboroch, rozpoznávanie kandidátov Tailwind, režim resetovania, izolácia vyrovnávacej pamäte vykresľovania a prednačítanie editora.

## Knižnica UI

Verzia 7.3 obsahuje zoskupenú knižnicu komponentov a ukážkové aplikácie, ktoré ju využívajú.

### Komponenty UI

Blockstudio 7.3 obsahuje zoskupenú knižnicu UI v mennom priestore `bsui/*`.
Komponenty sú bežné bloky Blockstudio, takže ich možno vykresliť v
šablónach, stránkach založených na súboroch, vzoroch aj obsahu príspevkov pomocou rovnakej syntaxe značiek blokov,
ktorú už používate.

Knižnica komponentov UI je v beta verzii, kým získavame ďalšie pripomienky. Cieľom verzie
7.3 je sprístupniť prvú sadu komponentov, poučiť sa zo skutočných projektov a
vyladiť názvy, správanie a predvolené nastavenia predtým, než označíme rozhranie API za stabilné.

Knižnica sa používa na základe vlastného rozhodnutia:

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

Po jej zapnutí možno jednoduché komponenty vykresliť priamo:

```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 aj kratšia syntax `bs:`:

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

Cieľom nie je zmeniť Blockstudio na súpravu UI na tvorbu stránok. Cieľom je
sprístupniť bežné základné prvky rozhrania ako bloky, aby aplikácie vytvorené pomocou Blockstudio nemuseli v každom projekte znova vytvárať tlačidlá, dialógové okná, karty, výberové polia, polia formulárov, ponuky, panely nástrojov a komponenty spätnej väzby.

Prvá sada komponentov zahŕňa základné prvky rozloženia, akcií, vstupov, prekryvných vrstiev, navigácie,
spätnej väzby, formulárov a zobrazovania údajov:

- `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 sú zložené bloky. Blok `bsui/tabs` spravuje interaktívny
stav, zatiaľ čo podriadené bloky, ako `bsui/tabs-list`, `bsui/tabs-trigger` a
`bsui/tabs-panel`, opisujú štruktúru.

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

Vďaka tomu zostáva značkovanie čitateľné a stav aj správanie spravuje rozhranie
Interactivity API.

### Príklady aplikácií

Menný priestor `app/*` obsahuje príklady vytvorené z rovnakých komponentov UI.

Nie sú samostatným frameworkom. Sú referenčnými implementáciami väčších rozhraní Blockstudio: zložených blokov, vnorených UI, stavu API Interactivity a miest, kde sa komponenty UI spájajú s funkciami RPC alebo databáz.

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

Knižnica UI obsahuje aj vlastnú dokumentáciu a živú referenciu komponentov.
Správanie komponentov netvorí iba súbor šablón. Je súčasťou zmluvy frameworku a
zostáva konzistentné aj s rastom knižnice.

## Tvorba a úpravy

Niekoľko zmien uľahčuje tvorbu a úpravy blokov.

### Rozšírený editor

Pri úpravách zložitých blokov v bočnom paneli inšpektora môže rýchlo chýbať
miesto. Platí to najmä pre opakovače, polia kódu, formátovaný text a vnorené skupiny.

Blockstudio 7.3 pridáva do inšpektora bloku akciu rozšíreného editora. Otvorí
širší panel vysúvaný z pravej strany editora a zobrazí tie isté polia Blockstudio.

Dôležité je, že stále ide o ten istý systém polí. Vykresľovanie polí sa neduplikuje a nepridáva sa druhý spôsob ukladania. Zmeny vykonané v rozšírenom editore aktualizujú vybraný blok rovnako ako zmeny v bežnom bočnom paneli.

Použite ho, keď bočný panel stačí na prezeranie, ale na zadávanie údajov je príliš stiesnený.

### Selektory prostriedkov s obmedzeným rozsahom

Blockstudio už podporoval `%selector%` pre polia kódu. Vo verzii 7.3 môžu blokové prostriedky CSS
a SCSS používať rovnaký spôsob tvorby.

V súbore CSS sa `%selector%` rozbalí na triedu bloku s obmedzeným rozsahom:

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

Vďaka tomu možno upraviť štýl skutočného obaľujúceho prvku:

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

Bežné selektory v `*.scoped.css` naďalej zacieľujú na potomkov. `%selector%` je
výslovný hák pre koreňový prvok bloku.

### Závislosti doplnkov

Bloky teraz môžu deklarovať závislosti WordPress od doplnkov v rámci kľúča `blockstudio`
rozhrania `block.json`.

Jednoduchá forma overuje, či je každý uvedený identifikátor doplnku aktívny:

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

Objektová forma pridáva obmedzenia verzií:

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

Ide o identifikátory doplnkov WordPress, ktoré zodpovedajú systému závislostí doplnkov jadra WordPress. Blockstudio priradí aktívne doplnky k týmto identifikátorom a vynechá registráciu, ak požadovaný doplnok chýba, nie je aktívny alebo má nižšiu než požadovanú verziu.

Obmedzenie verzie používa rovnaký spôsob porovnávania ako PHP `version_compare()`. Bežná verzia, napríklad `"6"`, sa považuje za `>=6`.

Je to užitočné pri blokoch, ktoré majú zmysel iba vtedy, keď je k dispozícii doplnok:
produktové karty WooCommerce, integrácie formulárov, integrácie SEO, členské
komponenty, rezervačné widgety alebo prvky administrácie UI naviazané na doplnok tretej strany.

### Pravidlá editora

Súbor `blockstudio.json` sa stáva užitočnejším aj ako súbor pravidiel editora na úrovni projektu.

Verzia 7.3 pridáva vrstvu pravidiel `blockEditor` založenú na PHP pre nastavenia WordPress,
ktoré už poskytuje prostredníctvom hákov na strane servera. Môžete tak definovať globálne správanie nástroja na vkladanie blokov, vzorov a médií bez dodatočného účelového kódu v téme.

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

Prvá fáza sa zámerne obmedzuje na možnosti podporované PHP: povolené a zakázané
bloky, načítavanie adresára blokov, názvy a poradie kategórií nástroja na vkladanie blokov, zdroje a kategórie vzorov, Openverse, možnosti veľkostí obrázkov, viditeľnosť zastaraných widgetov
a odstraňovanie štýlov blokov registrovaných pomocou PHP.

Nesnaží sa prepísať ľubovoľné predvolené nastavenia základných blokov. Nastavenia ako
`core/columns.isStackedOnMobile` sa spravujú v registračnom postupe JavaScript editora blokov,
preto si vyžadujú samostatné, explicitnejšie API, namiesto toho, aby sa
predstieralo, že patria do súboru JSON.

### Alias názvov blokov

Pre značky blokov pribudol filter aliasov:

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

Projekt tak môže definovať značky vhodné na tvorbu obsahu, ktoré sa interne stále mapujú na kanonický názov bloku.

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

Je to obzvlášť užitočné pri skladaní šablón náročných na UI, kde sú kanonické názvy blokov správne, ale nie vždy najpríjemnejšie na používanie pri tvorbe obsahu.

## Nástroje a spoľahlivosť

Pokročila statická analýza, spoľahlivosť aj nástroje na meranie výkonu.

### Statická analýza a generovaná dokumentácia

Rozšírenie PHPStan teraz podporuje explicitné koreňové adresáre externých knižníc blokov na skenovanie. Projekt tak môže overovať značky `<bs:*>` a `<block>` voči blokom mimo aktuálneho pluginu alebo témy, pričom tieto adresáre sa pri analýze používajú iba v registri.

Kontroly schémy boli rozšírené aj o metadáta stránok a `pluginDependencies`, takže neplatnú konfiguráciu pri vydaní možno ľahšie zachytiť ešte predtým, ako sa dostane do WordPress.

Generovanie dokumentácie teraz zahŕňa aj referencie na filtre pre nastavenia a hooky PHP. Je to čoraz dôležitejšie, keď sa `blockstudio.json` stáva skutočným súborom projektových pravidiel namiesto niekoľkých roztrúsených prepínačov.

### Spoľahlivosť stránok a editora

Verzia 7.3 obsahuje aj viacero opráv týkajúcich sa stránok založených na súboroch, vykresľovania editora a režimu resetovania.

Analýza stránok založených na súboroch teraz pri parsovaní HTML správne spracúva vlastné mapovania kontajnerov zohľadňujúce atribúty. Značky stránok `bs:` tiež správne rozpoznávajú názvové priestory blokov s pomlčkami, takže názvy ako `custom-theme/card` už parser nezmätú.

Všeobecné značky kontajnerov, ktoré nepatria do jadra, teraz serializujú platný kód `innerContent`, ak neposkytujú obalové značky. Vďaka tomu je synchronizovaný obsah stránok predvídateľnejší a serializácia blokov WordPress zostáva platná.

V editore pribudlo viacero opráv týkajúcich sa ukážok a prednačítania:

- Tailwind editor CSS teraz zahŕňa kandidátov tried zo šablón stránok založených na súboroch.
- Prednačítanie Editora zachováva triedy obalov RichText pre opakované bloky rovnakého typu.
- Prednačítanie Editora zodpovedá blokom, ktorých predvolené hodnoty polí rozšíri Gutenberg, no v uloženej značke bloku chýbajú.
- Registrované predvolené atribúty rozšírené pomocou Gutenberg sa pred porovnaním kľúčov vyrovnávacej pamäte vykreslenia ignorujú.
- Náhľady vykreslenia Editora a vkladacieho nástroja teraz používajú samostatné položky vyrovnávacej pamäte, aj keď zdieľajú ID klienta.
- `bs_get_group()` teraz správne funguje pri opätovne použitých skupinách vlastných polí vrátane skupín, ktorých ID sa zhoduje s názvom vlastného poľa, a extrahuje iba presné predpony skupín.
- Polia odkazov s `withCreateSuggestion` teraz správne prepájajú proces vytvárania v LinkControl WordPress a vytvárajú koncepty stránok prostredníctvom REST API.
- Šablóny blokov PHP sa teraz vykonajú raz pri každom vykreslení namiesto spustenia zahodeného predbežného vloženia.

Vylepšený bol aj režim resetovania. Teraz neutralizuje pravidlá šírky blokov a zvislých okrajov editora Gutenberg pre nakonfigurované typy príspevkov, v prípade potreby odstraňuje štýly obsahu a resetovania prvku WordPress iframe a vylepšuje prekrytia pri umiestnení kurzora a výbere v Blockstudio.

Testy regresií pre zložité vzory InnerBlocks boli rozšírené aj o vnorené bloky Blockstudio, aby sa vykresľovanie v editore overilo aj v prípadoch vkladania vzorov, ktoré sa najťažšie kontrolujú manuálne.

### Nástroje na meranie výkonu

Lokálne anonymné sondy `blockstudio-perf=1` teraz môžu odosielať hlavičky `Server-Timing` bez vkladania panela ladenia.

Časové merania teraz pokrývajú väčšiu časť procesu zostavovania: vyhľadávanie, spracovanie zdrojov, registráciu a prepísania. Ľahšie tak zistíte, kde sa čas skutočne míňa, bez zapnutia viditeľného panela UI na profilovanie.

## Prečo je toto vydanie dôležité

Hlavnou témou verzie 7.3 je skladanie.

Komponenty UI uľahčujú skladanie rozhraní aplikácií. Rozšírený Editor uľahčuje úpravu väčších blokov. Závislosti pluginov umožňujú blokom uviesť, aký kontext pluginu potrebujú. Pravidlá editora presúvajú pravidlá editora blokov na úrovni projektu do `blockstudio.json`. Aliasy značiek blokov spríjemňujú tvorbu šablón.
Opravy parsera, PHPStan a editora zvyšujú spoľahlivosť týchto zostáv pri prechode cez WordPress.

Blockstudio je stále založený na súboroch. Bloky sú stále priečinky. Šablóny stále odvádzajú svoju prácu. Framework však teraz nad týmto základom ponúka robustnejšiu vrstvu UI.
