
Blockstudio 7.3 lisab raamistikku uue kihi: korduvkasutatavad UI komponendid, mida saab renderdada nagu iga teist plokki.

Versioon 7.1 muutis plokid täisrakendusteks ja 7.2 tegi suuremate projektide ülevaatamise, valideerimise ning levitamise lihtsamaks; 7.3 keskendub nende rakenduste loomise ja redigeerimise igapäevasele kogemusele.

Lühidalt:

- **UI komponendid**: komplektina kaasas olev valikuline `bsui/*` komponentide teek, mille jõuallikaks on WordPress interaktiivsus-API.
- **Rakendused**: komplektina kaasas olevad `app/*` näited, mis näitavad, kuidas UI komponendid moodustavad suuremaid liideseid.
- **Laiendatud redaktor**: laiem sahtel Blockstudio väljade redigeerimiseks, kui külgriba jääb kitsaks.
- **Piiritletud varavalijad**: CSS ja SCSS varad saavad kasutada `%selector%`-i otse ploki ümbrisklassi sihtimiseks.
- **Plugina sõltuvused**: plokid saavad nõuda aktiivseid WordPress pluginaid, vajaduse korral versioonipiirangutega.
- **Redaktori reeglid**: `blockstudio.json` saavad seadistada globaalseid plokke, mustreid ja meedia käitumist, kasutades WordPress PHP-il põhinevaid redaktori hooke.
- **Plokisiltide varjunimed**: kohandatud varjunimed plokisiltide kirjutamiseks.
- **Staatiline analüüs ja dokumentatsioon**: parem PHPStan tugi välistele plokiteekidele ning seadete ja hookide jaoks loodud dokumentatsioon.
- **Lehe- ja redaktoriparandused**: usaldusväärsem failipõhine lehtede parsimine, Tailwind kandidaatide tuvastamine, lähtestusrežiim, renderdamise vahemälu eraldamine ja redaktori eellaadimised.

## UI teek

Versiooniga 7.3 tuleb kaasa komponenditeek ning selle põhjal loodud näidisrakendused.

### UI komponendid

Blockstudio versiooniga 7.3 tuleb kaasa komplekti kuuluv UI teek nimeruumi `bsui/*` all. Komponendid on tavalised Blockstudio plokid, mistõttu saab neid renderdada mallides, failipõhistel lehtedel, mustrites ja postituste sisus sama plokisildi süntaksiga, mida juba kasutate.

UI komponenditeek on beetaversioonis, kuni kogume tagasisidet. Versiooni 7.3 eesmärk on teha esimene komponentide komplekt kättesaadavaks, õppida tegelikest projektidest ning täiustada nimesid, käitumist ja vaikeväärtusi enne, kui nimetame API liidese stabiilseks.

Teegi kasutamine on valikuline:

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

Pärast lubamist saab lihtsaid komponente otse renderdada:

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

Lühem süntaks `bs:` töötab samuti:

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

Eesmärk pole muuta Blockstudio-i lehekoostaja UI komplektiks. Eesmärk on teha levinud kasutajaliidese põhielemendid plokkidena kättesaadavaks, et Blockstudio abil loodud rakendused ei peaks igas projektis nuppe, dialooge, vahekaarte, valikuid, vormivälju, menüüsid, tööriistaribasid ja tagasisidekomponente uuesti looma.

Esimene komponentide komplekt sisaldab paigutuse, tegevuste, sisendite, ülekatete, navigeerimise, tagasiside, vormide ja andmekuva põhielemente:

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

Paljud neist on liitplokid. Plokk `bsui/tabs` haldab interaktiivset olekut, alamplokid, näiteks `bsui/tabs-list`, `bsui/tabs-trigger` ja `bsui/tabs-panel`, määravad aga struktuuri.

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

Nii jääb märgistus loetavaks ning oleku ja käitumise eest hoolitseb Interactivity API.

### Rakenduste näited

Nimeruum `app/*` sisaldab samadest UI komponentidest loodud näiteid.

Need pole eraldi raamistik, vaid viiterakendused suurematele Blockstudio liidestele: liitplokid, pesastatud UI, Interactivity API olek ning kohad, kus UI komponendid kohtuvad RPC või andmebaasipõhiste funktsioonidega.

```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 teegiga on kaasas ka selle enda dokumentatsioon ja reaalajas komponendiviide. Komponentide käitumine pole lihtsalt mallide kogum, vaid osa raamistiku lepingust, mis püsib terviklikuna ka teegi kasvades.

## Loomine ja redigeerimine

Mitmed muudatused muudavad plokkide loomise ja redigeerimise lihtsamaks.

### Laiendatud redaktor

Keerukate plokkide redigeerimiseks inspektori külgribal võib ruumist kiiresti nappida. See kehtib eriti kordajate, koodiväljade, rikaste tekstide ja pesastatud rühmade puhul.

Blockstudio 7.3 lisab plokiinspektorisse laiendatud redaktori toimingu. See avab redaktori paremast servast laiema sahtli ja kuvab seal samu Blockstudio välju.

Oluline on see, et kasutusel on endiselt sama väljade süsteem. Väljade renderdamist ei dubleerita ega looda teist salvestusviisi; laiendatud redaktoris tehtud muudatused uuendavad valitud plokki nagu tavalise külgriba kaudu tehtud muudatusedki.

Kasutage seda siis, kui külgriba sobib sirvimiseks, kuid on tegelikuks sisestamiseks liiga kitsas.

### Piiritletud varavalijad

Blockstudio toetas juba `%selector%` koodivälju. Versioonis 7.3 saavad ploki CSS ja SCSS varad kasutada sama loomismustrit.

CSS failis laieneb `%selector%` ploki piiritletud klassiks:

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

Nii saab kujundada tegelikku ümbriselementi:

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

Tavalised valijad failis `*.scoped.css` sihivad endiselt järglaselemente. `%selector%` on selgesõnaline hook ploki juurelemendi jaoks.

### Plugina sõltuvused

Plokid saavad nüüd deklareerida WordPress plugina sõltuvused võtmes `blockstudio`, mis asub jaotises `block.json`.

Lihtvorm kontrollib, kas kõik loetletud plugina tunnused on aktiivsed:

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

Objektvorm lisab versioonipiirangud:

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

Tunnused on WordPress pluginate tunnused, mis vastavad WordPress tuuma plugina sõltuvuste süsteemile. Blockstudio teisendab aktiivsed pluginad nende tunnusteks ja jätab registreerimise vahele, kui vajalik plugin puudub, pole aktiivne või ei vasta nõutud miinimumversioonile.

Versioonipiirangu puhul kasutatakse sama võrdlusmudelit nagu PHP `version_compare()` puhul. Lihtsat versiooninumbrit, näiteks `"6"`, käsitletakse kui `>=6`.

See sobib plokkidele, millel on mõtet ainult siis, kui vastav plugin on saadaval: WooCommerce tootekaardid, vormiühendused, SEO ühendused, liikmesuse komponendid, broneerimisvidinad või kolmanda osapoole pluginaga seotud haldusliidese UI.

### Redaktori reeglid

Fail `blockstudio.json` muutub järjest kasulikumaks ka projekti tasandi redaktorireeglite failina.

Versioon 7.3 lisab PHP-il põhineva `blockEditor` reeglikihi seadetele, mida WordPress juba serveripoolsete hookide kaudu pakub. Nii saate määrata globaalse sisestaja, mustrite ja meedia käitumise, ilma et peaksite kirjutama ühekordset teemakoodi.

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

Esimene versioon piirdub teadlikult sellega, mida toetab PHP: lubatud ja keelatud plokid, plokkide kataloogi laadimine, sisestaja kategooriate sildid ja järjestus, mustrite allikad ja kategooriad, Openverse, piltide suuruste valikud, pärandvidinate nähtavus ning PHP-iga registreeritud plokistiilide eemaldamine.

See ei püüa muuta tuuma suvalisi plokkide vaikeväärtusi. Sellised seaded nagu `core/columns.isStackedOnMobile` asuvad plokiredaktori JavaScript registreerimisvoos. Nende jaoks on vaja eraldi ja selgesõnalisemat API-i, mitte teeselda, et need kuuluvad JSON faili.

### Plokisiltide varjunimed

Plokisiltidele lisandus varjunimede filter:

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

Nii saab projekt määrata autorile mugavad sildid, mis lahendatakse sisemiselt endiselt kanooniliseks plokinimeks.

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

See on eriti kasulik UI-mahukate mallide koostamisel, kui kanoonilised plokinimed on küll õiged, kuid pole alati kõige mugavamad kasutada.

## Tööriistad ja töökindlus

Staatiline analüüs, töökindlus ja jõudlustööriistad arenesid kõik edasi.

### Staatiline analüüs ja loodud dokumentatsioon

Laiend PHPStan toetab nüüd selgesõnalisi väliste plokiteekide skannimise juurkaustu. Nii saab projekt valideerida silte `<bs:*>` ja `<block>` ka praegusest pluginast või teemast väljaspool asuvate plokkide suhtes, jättes need juurkaustad analüüsiks ainult registripõhiseks.

Skeemikontrolle laiendati ka lehe metaandmete ja `pluginDependencies` osas, et vigast väljalaskmiseelset seadistust oleks lihtsam tuvastada enne, kui see jõuab keskkonda WordPress.

Dokumentatsiooni genereerimine hõlmab nüüd seadete filtrite viiteid ja PHP hooke. See on üha olulisem, kuna `blockstudio.json`-ist saab mõne hajusa lüliti asemel päris projekti reeglifail.

### Lehtede ja redaktori töökindlus

Versioon 7.3 sisaldab ka mitut parandust, mis puudutavad failipõhiseid lehti, redaktori renderdamist ja lähtestusrežiimi.

Failipõhine leheparsimine käsitleb nüüd atribuuditeadlikke kohandatud konteinerivastendusi HTML parsimisel. `bs:` lehesildid lahendavad nüüd õigesti ka sidekriipsuga plokinimeruume, nii et nimed nagu `custom-theme/card` ei aja parserit enam segadusse.

Üldised tuumavälised konteinerisildid serialiseeritakse nüüd korrektse `innerContent`-ina, kui need ei paku ümbrismärgistust. See muudab sünkroonitud lehe sisu etteaimatavamaks ja hoiab WordPress plokiserialiseerimise korrektsena.

Redaktoris parandati eelvaate ja eellaadimisega seotud käitumist:

- Tailwind redaktor CSS sisaldab nüüd ka failipõhiste lehemallide klassikandidaate.
- Redaktori eellaadimisel säilivad sama tüüpi korduvate plokkide RichTexti ümbrisklassid.
- Redaktori eellaadimine leiab plokid, mille vaikeväljade väärtused laiendab Gutenberg, kuid mis salvestatud ploki märgistusest puuduvad.
- Gutenberg laiendatud registreeritud vaikeatribuute eiratakse enne renderdusvahemälu võtmete võrdlemist.
- Redaktori ja lisaja eelvaaterenderdustel on nüüd eraldi vahemikukirjed isegi siis, kui neil on sama kliendi ID.
- `bs_get_group()` töötab nüüd sujuvalt korduvkasutatavate kohandatud väljarühmadega, sealhulgas rühmadega, mille ID vastab kohandatud välja nimele, ning eraldab ainult täpsed rühmaprefiksid.
- `withCreateSuggestion`-iga lingiväljad ühendavad nüüd WordPress LinkControli loomistoimingu õigesti ja loovad mustandlehti REST API kaudu.
- PHP plokimallid käivitatakse nüüd renderduse kohta üks kord, selle asemel et käivitada kasutuseta eelkontrolli kaasamine.

Lähtestusrežiimi täiustati samuti. Nüüd tühistab see seadistatud postitustüüpide puhul Gutenberg redaktori plokkide laiuse ja vertikaalse veerise reeglid, eemaldab vajaduse korral WordPress iframe'i sisu- ja lähtestusstiilid ning muudab Blockstudio hõljumis- ja valikukatted puhtamaks.

Keerukate InnerBlocksi mustrite regressioonitestide katvust laiendati samuti, lisades pesastatud Blockstudio plokid. Nii kontrollitakse redaktori renderdusteed mustri lisamise juhtudega, mida on käsitsi kõige raskem märgata.

### Jõudlustööriistad

Kohalikud anonüümsed `blockstudio-perf=1` sondid saavad nüüd väljastada `Server-Timing` päiseid ilma silumispaneeli lisamata.

Ajastused hõlmavad nüüd suuremat osa ehituse elutsüklist: avastamist, varade töötlemist, registreerimist ja ülekirjutusi. Nii on lihtsam näha, kuhu aeg tegelikult kulub, ilma nähtavat profileerimis-UI sisse lülitamata.

## Miks see väljalase on oluline

Versiooni 7.3 keskne teema on kompositsioon.

UI komponendid hõlbustavad rakenduse kasutajaliideste kokkupanekut. Laiendatud redaktor muudab suuremate plokkide redigeerimise lihtsamaks. Pluginate sõltuvused võimaldavad plokkidel kirjeldada vajalikku pluginate konteksti. Redaktori reeglid toovad projekti taseme plokiredaktori reeglid `blockstudio.json` sisse. Plokisiltide aliased muudavad mallide loomise mugavamaks. Parseri, PHPStan ja redaktori parandused muudavad need kompositsioonid usaldusväärsemaks, kui need läbivad WordPress.

Blockstudio on endiselt failipõhine. Plokid on endiselt kaustad. Mallid teevad endiselt töö ära. Kuid raamistikul on nüüd selle vundamendi peal tugevam UI kiht.
