
Blockstudio 7.3 menambahkan lapisan baru ke kerangka kerja: komponen UI yang dapat digunakan kembali dan dirender seperti blok lainnya.

Jika versi 7.1 mengubah blok menjadi aplikasi full-stack dan versi 7.2 memudahkan proyek besar untuk diperiksa, divalidasi, dan didistribusikan, versi 7.3 berfokus pada pengalaman sehari-hari dalam membangun dan menyunting aplikasi tersebut.

Singkatnya:

- **Komponen UI**: pustaka komponen `bsui/*` bawaan yang bersifat opsional dan didukung oleh WordPress Interactivity API.
- **Aplikasi**: contoh `app/*` bawaan yang menunjukkan cara komponen UI digabungkan menjadi antarmuka yang lebih besar.
- **Editor Diperluas**: panel geser yang lebih lebar untuk menyunting field Blockstudio saat bilah sisi terlalu sempit.
- **Selector aset tercakup**: aset CSS dan SCSS dapat menggunakan `%selector%` untuk menargetkan kelas pembungkus blok secara langsung.
- **Dependensi plugin**: blok dapat mewajibkan plugin WordPress yang aktif, dengan batasan versi opsional.
- **Kebijakan editor**: `blockstudio.json` dapat mengonfigurasi blok global, pola, dan perilaku media menggunakan hook editor berbasis WordPress PHP.
- **Alias tag blok**: alias khusus untuk penulisan tag blok.
- **Analisis statis dan dokumentasi**: cakupan PHPStan yang lebih baik untuk pustaka blok eksternal, serta dokumentasi yang dibuat untuk pengaturan dan hook.
- **Perbaikan halaman dan editor**: penguraian halaman berbasis file yang lebih andal, deteksi kandidat Tailwind, mode reset, isolasi cache render, dan pramuat editor.

## Pustaka UI

Versi 7.3 menyertakan pustaka komponen bawaan dan contoh aplikasi yang dibuat dengan pustaka tersebut.

### Komponen UI

Blockstudio 7.3 menyertakan pustaka UI bawaan dalam namespace `bsui/*`. Komponennya adalah blok Blockstudio biasa, sehingga dapat dirender dalam templat, halaman berbasis file, pola, dan konten pos menggunakan sintaks tag blok yang sudah Anda pakai.

Pustaka komponen UI masih dalam versi beta sementara kami mengumpulkan masukan. Tujuan versi 7.3 adalah menyediakan kumpulan komponen pertama, mempelajari penggunaan di proyek nyata, serta menyempurnakan penamaan, perilaku, dan nilai default sebelum menyatakan antarmuka API stabil.

Pustaka ini bersifat opsional:

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

Setelah diaktifkan, komponen sederhana dapat dirender secara langsung:

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

Sintaks `bs:` yang lebih singkat juga dapat digunakan:

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

Tujuannya bukan mengubah Blockstudio menjadi perangkat UI pembuat halaman. Tujuannya adalah menyediakan elemen dasar antarmuka umum sebagai blok, sehingga aplikasi yang dibuat dengan Blockstudio tidak perlu membuat ulang tombol, dialog, tab, pilihan, field formulir, menu, bilah alat, dan komponen umpan balik di setiap proyek.

Kumpulan komponen pertama mencakup elemen dasar tata letak, tindakan, input, overlay, navigasi, umpan balik, formulir, dan tampilan data:

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

Banyak di antaranya adalah blok gabungan. Blok `bsui/tabs` mengelola status interaktif, sementara blok anak seperti `bsui/tabs-list`, `bsui/tabs-trigger`, dan `bsui/tabs-panel` menjelaskan strukturnya.

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

Dengan begitu, markup tetap mudah dibaca, sementara status dan perilaku ditangani oleh API Interactivity.

### Contoh aplikasi

Namespace `app/*` berisi contoh yang dibuat menggunakan komponen UI yang sama.

Contoh-contoh tersebut bukan kerangka kerja terpisah. Contoh itu adalah implementasi referensi untuk antarmuka Blockstudio yang lebih besar: blok gabungan, UI bertingkat, status Interactivity API, dan bagian tempat komponen UI bertemu dengan RPC atau fitur berbasis database.

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

Pustaka UI juga menyertakan dokumentasi dan referensi komponen langsung. Perilaku komponen bukan sekadar kumpulan templat. Perilaku tersebut merupakan bagian dari kontrak kerangka kerja dan tetap konsisten seiring perkembangan pustaka.

## Penulisan dan penyuntingan

Beberapa perubahan memudahkan penulisan dan penyuntingan blok.

### Editor Diperluas

Menyunting blok kompleks di bilah sisi inspektur dapat cepat terasa sempit. Hal ini terutama berlaku untuk repeater, field kode, teks kaya, dan grup bertingkat.

Blockstudio 7.3 menambahkan tindakan editor diperluas ke inspektur blok. Tindakan ini membuka panel geser yang lebih lebar dari sisi kanan editor dan menampilkan field Blockstudio yang sama di sana.

Yang terpenting, sistem field-nya tetap sama. Tindakan ini tidak menggandakan perenderan field atau memperkenalkan jalur persistensi kedua. Perubahan di editor diperluas memperbarui blok yang dipilih, sama seperti perubahan di bilah sisi biasa.

Gunakan fitur ini saat bilah sisi cukup nyaman untuk melihat-lihat, tetapi terlalu sempit untuk memasukkan data.

### Selector aset tercakup

Blockstudio sebelumnya telah mendukung `%selector%` untuk field kode. Pada versi 7.3, aset blok CSS dan SCSS dapat menggunakan pola penulisan yang sama.

Di file CSS, `%selector%` diperluas menjadi kelas cakupan 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;
}
```

Dengan begitu, elemen pembungkus yang sebenarnya dapat diberi gaya:

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

Selector biasa di `*.scoped.css` tetap menargetkan elemen turunan. `%selector%` adalah hook eksplisit untuk elemen akar blok.

### Dependensi plugin

Kini blok dapat mendeklarasikan dependensi plugin WordPress di dalam kunci `blockstudio` pada `block.json`.

Bentuk sederhana memeriksa apakah setiap slug plugin yang dicantumkan sedang aktif:

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

Bentuk objek menambahkan batasan versi:

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

Pengenal tersebut adalah slug plugin WordPress yang sesuai dengan sistem dependensi plugin inti WordPress. Blockstudio mencocokkan plugin aktif dengan slug tersebut dan melewati pendaftaran jika plugin yang diwajibkan tidak ada, tidak aktif, atau versinya di bawah yang diperlukan.

Batasan versi menggunakan model perbandingan yang sama dengan PHP `version_compare()`. Versi biasa seperti `"6"` dianggap sebagai `>=6`.

Ini berguna untuk blok yang hanya berfungsi jika plugin tersedia: kartu produk WooCommerce, integrasi formulir, integrasi SEO, komponen keanggotaan, widget pemesanan, atau UI admin yang terkait dengan plugin pihak ketiga.

### Kebijakan editor

File `blockstudio.json` juga semakin berguna sebagai file kebijakan editor tingkat proyek.

Versi 7.3 menambahkan lapisan kebijakan `blockEditor` berbasis PHP untuk pengaturan WordPress yang sudah tersedia melalui hook sisi server. Dengan begitu, Anda dapat menentukan perilaku inserter, pola, dan media secara global tanpa menambahkan kode perekat tema khusus.

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

Tahap pertama sengaja hanya mencakup hal-hal yang didukung oleh PHP: blok yang diizinkan dan ditolak, pemuatan direktori blok, label dan urutan kategori inserter, sumber dan kategori pola, Openverse, pilihan ukuran gambar, visibilitas widget lama, serta penghapusan gaya blok yang didaftarkan melalui PHP.

Fitur ini tidak mencoba menulis ulang nilai default blok inti yang sembarang. Pengaturan seperti `core/columns.isStackedOnMobile` berada di dalam alur pendaftaran JavaScript editor blok, sehingga memerlukan API yang lebih eksplisit dan terpisah, alih-alih dipaksakan ke file JSON.

### Alias tag blok

Tag blok kini memiliki filter alias:

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

Dengan demikian, proyek dapat menentukan tag yang mudah digunakan saat menulis, tetapi tetap merujuk ke nama blok kanonis di bagian dalam.

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

Fitur ini sangat berguna saat menyusun templat yang banyak menggunakan UI, ketika nama blok kanonis memang tepat tetapi tidak selalu paling nyaman untuk penulisan.

## Peralatan dan keandalan

Analisis statis, keandalan, dan peralatan kinerja semuanya mengalami kemajuan.

### Analisis statis dan dokumentasi yang dibuat otomatis

Ekstensi PHPStan kini mendukung akar pemindaian pustaka blok eksternal yang ditentukan secara eksplisit. Dengan begitu, proyek dapat memvalidasi tag `<bs:*>` dan `<block>` terhadap blok di luar plugin atau tema saat ini, sementara akar tersebut hanya digunakan sebagai registri untuk analisis.

Pemeriksaan skema juga diperluas untuk metadata halaman dan `pluginDependencies`, sehingga konfigurasi yang tidak valid saat rilis lebih mudah ditemukan sebelum mencapai WordPress.

Dokumentasi yang dibuat otomatis kini mencakup referensi filter untuk pengaturan dan hook PHP. Hal ini makin penting karena `blockstudio.json` kini menjadi file kebijakan proyek yang sesungguhnya, bukan sekadar beberapa pengalih yang tersebar.

### Keandalan halaman dan editor

Versi 7.3 juga mencakup sejumlah perbaikan untuk halaman berbasis file, perenderan editor, dan mode reset.

Parsing halaman berbasis file kini mendukung pemetaan kontainer kustom yang memperhatikan atribut selama parsing HTML. Tag halaman `bs:` juga kini menangani namespace blok ber-hubung dengan benar, sehingga nama seperti `custom-theme/card` tidak lagi mengganggu parser.

Tag kontainer non-core generik kini diserialisasi menjadi `innerContent` yang valid jika tidak menyediakan markup pembungkus. Ini membuat konten halaman yang disinkronkan lebih mudah diprediksi dan menjaga serialisasi blok WordPress tetap valid.

Editor menerima serangkaian perbaikan terkait perilaku pratinjau dan pramuat:

- Tailwind editor CSS kini menyertakan kandidat kelas dari templat halaman berbasis file.
- Pemuatan awal editor mempertahankan kelas pembungkus RichText untuk blok berulang dengan tipe yang sama.
- Pemuatan awal editor cocok dengan blok yang nilai kolom bawaannya diperluas oleh Gutenberg tetapi tidak disertakan dalam markup blok yang tersimpan.
- Atribut bawaan terdaftar yang diperluas oleh Gutenberg diabaikan sebelum membandingkan kunci cache render.
- Render pratinjau editor dan inserter kini menggunakan entri cache terpisah, meskipun berbagi ID klien.
- `bs_get_group()` kini berfungsi dengan baik pada grup kolom kustom yang digunakan kembali, termasuk grup yang ID-nya cocok dengan nama kolom kustom, dan hanya mengekstrak prefiks grup yang persis.
- Kolom tautan dengan `withCreateSuggestion` kini menghubungkan alur pembuatan LinkControl WordPress dengan benar dan membuat halaman draf melalui REST API.
- Templat blok PHP kini dijalankan sekali per render, alih-alih menjalankan penyertaan prapemeriksaan yang hasilnya dibuang.

Mode reset juga disempurnakan. Kini mode ini menetralkan aturan lebar blok editor dan margin vertikal Gutenberg untuk tipe pos yang dikonfigurasi, menghapus gaya konten/reset iframe WordPress jika diperlukan, dan membuat overlay hover/pemilihan Blockstudio lebih rapi.

Cakupan pengujian regresi untuk pola InnerBlocks yang kompleks juga diperluas agar mencakup blok Blockstudio bersarang, sehingga jalur render editor diperiksa terhadap kasus penyisipan pola yang paling sulit dilihat secara manual.

### Alat kinerja

Probe `blockstudio-perf=1` anonim lokal kini dapat mengeluarkan header `Server-Timing` tanpa menyisipkan panel debug.

Pengukuran waktu kini juga mencakup lebih banyak tahap siklus build: penemuan, pemrosesan aset, registrasi, dan override. Ini memudahkan Anda melihat ke mana waktu benar-benar digunakan tanpa mengaktifkan UI pemrofilan yang terlihat.

## Mengapa rilis ini penting

Tema utama 7.3 adalah komposisi.

Komponen UI memudahkan penyusunan antarmuka aplikasi. Editor yang diperluas memudahkan pengeditan blok yang lebih besar. Dependensi plugin memungkinkan blok menjelaskan konteks plugin yang dibutuhkannya. Kebijakan editor memindahkan aturan editor blok tingkat proyek ke `blockstudio.json`. Alias tag blok membuat penulisan templat lebih nyaman.
Perbaikan parser, PHPStan, dan editor membuat komposisi tersebut lebih andal saat melewati WordPress.

Blockstudio tetap berbasis file. Blok tetap berupa folder. Templat tetap menjalankan tugasnya. Namun, kini framework memiliki lapisan UI yang lebih kuat di atas fondasi tersebut.
