
Blockstudio 7.1 adalah rilis fitur pertama sejak penulisan ulang v7. Jika v7 membangun ulang fondasinya, 7.1 menambahkan bagian-bagian yang mengubah blok menjadi sesuatu yang lebih: lapisan database, fungsi server, tugas terjadwal, dan CLI. Kini, folder blok dapat menjadi aplikasi lengkap.

Berikut semua hal baru.

## Komponen

Selalu ada ketegangan antara blok yang digunakan editor di inserter dan blok yang digunakan developer sebagai blok penyusun untuk hal lain. Kartu, lencana, widget statistik, input formulir. Semua itu memerlukan alur Blockstudio lengkap (atribut, templat, aset, Tailwind), tetapi tidak seharusnya muncul di inserter.

7.1 memperkenalkan komponen untuk mengatasi hal ini. Tetapkan `"component": true` di block.json Anda, dan blok akan melewati seluruh alur build tetapi tidak pernah didaftarkan ke registri jenis blok milik WordPress. Blok tidak muncul di inserter maupun di data editor yang dikirim ke JavaScript, tetapi tetap tersedia sepenuhnya untuk dirender secara terprogram.

```json title="block.json"
{
  "name": "my-theme/card",
  "title": "Card",
  "blockstudio": {
    "component": true,
    "attributes": [
      { "id": "title", "type": "text" },
      { "id": "description", "type": "textarea" }
    ]
  }
}
```

Render dari PHP:

```php
bs_render_block([
  'name' => 'my-theme/card',
  'data' => ['title' => 'My Card', 'description' => 'Card content.'],
]);
```

Atau gunakan sintaks tag HTML yang baru:

```html
<bs:my-theme-card title="My Card" description="Card content." />
```

## Tag blok

Kini, blok dapat disematkan sebagai tag HTML menggunakan dua sintaks yang dapat saling dipertukarkan:

```html
<bs:acme-hero title="Welcome" />
<block name="acme/hero" title="Welcome" />
```

Keduanya menghasilkan output yang sama. Keduanya berfungsi dengan blok Blockstudio dan blok inti WordPress. Di dalam templat blok, keduanya dirender secara otomatis tanpa perlu mengaktifkan apa pun. Artinya, Anda dapat menyusun seluruh tata letak dari blok lain langsung di dalam templat:

```twig title="index.twig"
<div class="my-page">
  <bs:mytheme-card title="Featured" />
  <block name="core/separator" />
  <bs:core-heading level="2">Section Title</bs:core-heading>
  <block name="core/group">
    <block name="core/paragraph">Inside a core group block.</block>
    <bs:mytheme-cta variant="primary" />
  </block>
</div>
```

Kedua sintaks dapat disarangkan secara bebas. Blok Blockstudio dirender melalui alur lengkap (templat, Tailwind, aset). Blok inti dirender melalui WordPress menggunakan perender yang sama dengan yang menjalankan [Pages and Patterns](https://blockstudio.dev/id/docs/pages-and-patterns/).

Untuk perenderan tingkat halaman (konten kiriman, area widget), aktifkan di `blockstudio.json`:

```json
{ "blockTags": { "enabled": true } }
```

Daftar izinkan dan daftar tolak mengatur blok mana yang dapat dirender melalui tag menggunakan pola wildcard. Atribut `data-*` dan `html-*` diteruskan ke elemen akar HTML blok yang dirender. Perender khusus dapat didaftarkan melalui filter `blockstudio/block_tags/renderers`.

Di balik layar, parser tag menggunakan pemindai string ringan baru yang sepenuhnya menggantikan DOMDocument. Parser ini menangani tag bertingkat dengan pelacakan kedalaman, blok kontainer rekursif, dan sintaks campuran dalam satu kali proses. Dalam pengujian performa, parser memproses 1,000 tag datar dalam 2.4ms dan 100 tingkat penyarangan dalam 3.7ms, secara konsisten lebih cepat daripada DOMDocument maupun `WP_HTML_Tag_Processor` milik WordPress. Parser yang sama juga menangani penguraian elemen HTML mentah untuk [Pages and Patterns](https://blockstudio.dev/id/docs/pages-and-patterns/), menggantikan parser berbasis DOMDocument yang sebelumnya menangani elemen `<p>`, `<div>`, dan HTML lainnya.

## Jenis field baru

### Blok

Jenis field `block` baru yang memungkinkan Anda merujuk blok Blockstudio lain sebagai atribut. Field blok yang dirujuk diperluas secara inline menggunakan `idStructure` dan `overrides`, sama seperti field khusus. Bedanya, di dalam templat, mengakses nilainya akan mengembalikan output blok yang telah dirender.

```json title="block.json"
{
  "blockstudio": {
    "attributes": [
      {
        "id": "card",
        "type": "block",
        "block": "mytheme/card",
        "idStructure": "card_{id}"
      }
    ]
  }
}
```

Jika `mytheme/card` memiliki field `heading` dan `content`, blok induk akan mendapatkan `card_heading` dan `card_content` di bilah sisinya. Di dalam templat, `{{ a.card }}` menghasilkan kartu yang telah dirender. Berfungsi dengan blok biasa maupun komponen.

### Tag HTML

Setiap tema memiliki blok dengan tingkat judul yang perlu berubah sesuai konteks. H1 di beranda, H2 di halaman dalam. Kini tersedia jenis field `html-tag` khusus dengan preset bawaan, sehingga Anda tidak perlu lagi membuatnya sebagai field pilihan dengan opsi yang ditetapkan secara hardcode setiap kali.

```json
{
  "id": "tag",
  "type": "html-tag",
  "default": "h2",
  "tags": "heading",
  "exclude": ["h5", "h6"]
}
```

Preset: `heading` (h1-h6), `text` (judul + p, span, div), `structural` (div, section, article, aside, main, header, footer, nav), `all`. Atau berikan array khusus. `exclude` menghapus tag tertentu dari preset mana pun.

```twig
<{{ a.tag }}>{{ a.title }}</{{ a.tag }}>
```

## Database

Inilah fitur utama rilis ini. Tambahkan file `db.php` ke direktori blok mana pun, lalu Blockstudio akan membuat lima endpoint CRUD REST, memvalidasi setiap operasi tulis terhadap skema, mengelola backend penyimpanan secara otomatis, serta menyediakan klien JavaScript (`bs.db()`) dan PHP API (`Db::get()`). Tanpa file migrasi, kelas pengontrol, maupun pendaftaran rute.

```php title="db.php"
return [
    'subscribers' => [
        'storage'    => 'table',
        'capability' => [
            'create' => true,
            'read'   => true,
            'update' => 'edit_posts',
            'delete' => 'manage_options',
        ],
        'fields' => [
            'email' => [
                'type'     => 'string',
                'format'   => 'email',
                'required' => true,
                'validate' => function ($value) {
                    if (str_ends_with($value, '@spam.com')) {
                        return 'This domain is blocked.';
                    }
                    return true;
                },
            ],
            'name' => ['type' => 'string', 'maxLength' => 100],
            'plan' => ['type' => 'string', 'enum' => ['free', 'pro']],
        ],
    ],
];
```

Skema itu saja menghasilkan API yang berfungsi penuh dengan endpoint buat, daftar, ambil, perbarui, dan hapus, semuanya dilengkapi validasi input.

### Penyimpanan

Lima backend penyimpanan, masing-masing sesuai untuk kasus penggunaan yang berbeda:

- **`table`**: Tabel MySQL khusus yang dikelola melalui `dbDelta()`. Menambahkan field ke skema akan menambahkan kolom saat halaman dimuat berikutnya. Default produksi.
- **`sqlite`**: Satu file SQLite di folder `db/` blok. Kueri SQL sungguhan, mode WAL untuk pembacaan serentak, dan sepenuhnya portabel. Salin foldernya, salin databasenya.
- **`jsonc`**: Satu objek JSON per baris dalam file datar. Mudah dibaca manusia, dapat dikontrol versinya, ramah git.
- **`meta`**: Array JSON di meta pos WordPress, terikat pada pos tertentu.
- **`post_type`**: Setiap record menjadi pos WordPress dalam jenis pos khusus. Field disimpan sebagai entri meta pos terpisah, sepenuhnya dapat dikueri dengan `WP_Query`.

### Klien

Di sisi JavaScript, `bs.db()` menyediakan klien CRUD lengkap:

```js
const db = bs.db('my-theme/block', 'subscribers');
const record = await db.create({ email: 'a@b.com', plan: 'pro' });
const pros = await db.list({ plan: 'pro' });
await db.update(record.id, { plan: 'free' });
await db.delete(record.id);
```

Tiga utilitas pendamping disertakan bersama klien ini:

- **`bs.cache`**: Cache kueri dalam memori dengan `get`, `set`, `invalidate`, dan `clear`. Digunakan bersama oleh semua pemanggilan kueri dan mutasi.
- **`bs.query(key, fn, options)`**: Membungkus fungsi asinkron apa pun dengan caching, deduplikasi permintaan, dan `staleTime` yang dapat dikonfigurasi. Beberapa pemanggilan dengan kunci yang sama saat permintaan sedang berlangsung akan mengembalikan promise yang sama.
- **`bs.mutate(options)`**: Menangani mutasi optimistis dengan rollback otomatis. Berikan objek state reaktif, aksi (`create`, `update`, `delete`), dan data optimistis. UI diperbarui seketika. Jika pemanggilan server gagal, state dikembalikan ke snapshot sebelum mutasi.

Ketiganya mencakup seluruh siklus baca/tulis: `bs.query` untuk pembacaan yang di-cache, `bs.mutate` untuk penulisan optimistis, `bs.cache` untuk kendali manual.

Di sisi PHP, kelas `Db` menyediakan operasi yang sama:

```php
use Blockstudio\Db;

$db = Db::get('my-theme/block', 'subscribers');
$db->create(['email' => 'a@b.com', 'plan' => 'pro']);
$db->list(['plan' => 'pro']);
```

### Validasi

Kesalahan validasi dikembalikan sebagai array kesalahan per field, terinspirasi format `fieldErrors` milik Zod. Beberapa aturan dapat gagal pada field yang sama, dan strukturnya memudahkan pemetaan kesalahan ke field formulir di frontend:

```json
{
  "data": {
    "status": 400,
    "errors": {
      "email": ["Must be a valid email address.", "This domain is blocked."],
      "plan": ["Must be one of: free, pro."]
    }
  }
}
```

Callback `validate` khusus dijalankan di sisi server untuk hal-hal yang tidak dapat ditangani aturan bawaan: pemblokiran domain, validasi lintas field, dan pencarian eksternal.

### Data dengan cakupan pengguna

Untuk data per pengguna seperti daftar tugas, favorit, atau draf, tetapkan `userScoped` ke `true` dan Blockstudio akan menangani sisanya. Fitur ini menambahkan kolom `user_id`, mengisinya secara otomatis saat pembuatan, dan memfilter setiap kueri untuk pengguna saat ini. Pembaruan dan penghapusan memeriksa kepemilikan. Tanpa field `user_id` manual, hook `before_create`, atau pemfilteran di RPC. Cukup satu baris konfigurasi. Saat menggunakan penyimpanan `post_type`, `userScoped` dipetakan ke `post_author`, bukan ke kolom terpisah.

```php
return [
    'storage'    => 'sqlite',
    'userScoped' => true,
    'fields'     => [ /* ... */ ],
];
```

### Polling real-time

Tetapkan `'realtime' => true` di skema Anda dan klien akan otomatis melakukan polling untuk memeriksa perubahan. Saat terjadi perubahan di server, store Interactivity API diperbarui dan UI dirender ulang tanpa perubahan JavaScript di sisi Anda. Konfigurasikan dengan `'realtime' => ['key' => 'todos', 'interval' => 5000]` untuk kunci state dan interval khusus. Polling menggunakan perbandingan hash agar permintaan tetap ringan dan dijeda saat tab browser tersembunyi.

### Keamanan, hook, portabilitas

Endpoint publik dilindungi oleh header CSRF `X-BS-Token` yang disisipkan otomatis. Gunakan `'open'` jika Anda memerlukan akses yang benar-benar tanpa autentikasi, misalnya untuk webhook masuk.

Hook siklus hidup dijalankan sebelum dan sesudah setiap operasi tulis. Definisikan hook secara inline di `db.php` atau secara global melalui aksi WordPress.

Field dapat menentukan kunci `component` untuk perenderan formulir berbasis skema melalui `bs_db_form()`.

Dengan penyimpanan SQLite atau JSONC, seluruh aplikasi berada dalam satu folder: kode, logika, kontrol akses, dan data. Salin folder itu untuk men-deploy aplikasi.

## RPC

Terkadang CRUD saja tidak cukup. Anda memerlukan logika server khusus, seperti mengubah status tugas, mengirim notifikasi, atau mengagregasi statistik. Itulah fungsi `rpc.php`. Definisikan fungsi PHP, panggil dari frontend menggunakan `bs.fn()`, lalu Blockstudio akan menangani endpoint REST, autentikasi, perlindungan CSRF, dan serialisasi JSON. Polanya terinspirasi [tRPC](https://trpc.io): prosedur didefinisikan di sisi server dan dipanggil dari klien berdasarkan nama.

```php title="rpc.php"
return [
    'subscribe' => function (array $params): array {
        $email = sanitize_email($params['email']);
        return ['success' => true];
    },
];
```

```js
const result = await bs.fn('subscribe', { email: 'user@example.com' });
```

Skrip inline (`script-inline.js`) mendeteksi otomatis nama blok dari atribut `data-block` pada tag skripnya, jadi Anda tidak perlu mengirimkannya secara manual. Skrip modul meneruskannya sebagai argumen ketiga.

Opsi kontrol akses mencakup `public` (dengan CSRF), `'open'` (tanpa perlindungan), string kapabilitas, atau array. Kontrol metode HTTP per fungsi, hook siklus hidup, dan pemanggilan lintas blok dari JS maupun PHP semuanya didukung.

## Cron

Tugas latar belakang didefinisikan dalam file `cron.php`. Tetapkan jadwal dan callback, lalu Blockstudio mendaftarkannya ke WordPress Cron saat inisialisasi. Ketika plugin dinonaktifkan, semua jadwal dibatalkan dengan rapi.

```php title="cron.php"
return [
    'cleanup' => [
        'schedule' => 'daily',
        'callback' => function () {
            $db = Db::get('my-theme/app', 'logs');
            // delete old entries
        },
    ],
    'sync' => [
        'schedule' => 'hourly',
        'callback' => function () {
            // pull from external API
        },
    ],
];
```

Semua jadwal WordPress bawaan didukung, ditambah interval khusus melalui filter `cron_schedules`.

## CLI

Perintah `wp bs` baru mencakup seluruh rangkaian fitur Blockstudio: blok, database, RPC, cron, pengaturan, kompilasi Tailwind, kompilasi SCSS, field khusus, dan pengelolaan aset.

```bash
wp bs blocks list --components
wp bs db schemas
wp bs db create my-theme/app subs --email=a@b.com
wp bs db list my-theme/app subs --plan=pro --format=json
wp bs rpc call my-theme/app subscribe --email=a@b.com
wp bs cron run my-theme/app cleanup
wp bs tailwind compile --file=template.html
wp bs scss compile --file=style.scss
wp bs fields list
wp bs assets list --type=global
wp bs settings get tailwind/enabled
```

Semua perintah mendukung `--format=json` untuk pembuatan skrip.

## Peningkatan repeater

### textMinimized untuk field objek

Baris repeater yang diciutkan kini menangani nilai field objek dengan benar. Sebelumnya, mengarahkan `textMinimized` ke field tautan akan menampilkan `[object Object]`. Kini Blockstudio membaca otomatis subproperti yang tepat berdasarkan jenis field: `title` untuk tautan, `value` untuk warna dan gradien, `icon` untuk ikon. Anda juga dapat menetapkan properti `key` secara eksplisit untuk membaca subproperti mana pun yang diinginkan.

```json
{
  "type": "repeater",
  "textMinimized": { "id": "href", "fallback": "Add a link" },
  "attributes": [{ "id": "href", "type": "link" }]
}
```

### RichText dan MediaPlaceholder

Kedua komponen templat kini berfungsi di dalam field repeater dengan notasi tanda kurung siku untuk menargetkan baris yang benar. Judul dan paragraf yang dapat diedit secara inline, serta zona unggah media tersedia di setiap baris repeater.

```twig
{% for item in a.items %}
  <div class="card">
    <MediaPlaceholder attribute="items[{{ loop.index0 }}].image" />
    <RichText tag="h2" attribute="items[{{ loop.index0 }}].heading" />
    <RichText tag="p" attribute="items[{{ loop.index0 }}].content" />
  </div>
{% endfor %}
```

## Kondisi field khusus dengan idStructure

Saat menggunakan field khusus dengan `idStructure`, ID kondisi di dalam definisi field kini ditulis ulang secara otomatis agar sesuai dengan nama yang diperluas. Jika grup field ukuran font memiliki kondisi pada `enable` dan Anda memperluasnya menggunakan `idStructure: "title_font_{id}"`, kondisi kini merujuk dengan benar ke `title_font_enable`, bukan ke `enable` yang asli.

Kondisi tingkat referensi juga didukung. Tambahkan `conditions` pada referensi field khusus untuk menerapkannya sekaligus ke setiap field yang diperluas.

## Argumen populate dinamis

Argumen populate kini dapat merujuk atribut blok lain menggunakan sintaks `{attributes.*}`. Saat atribut yang dirujuk berubah, field pilihan akan mengambil ulang opsinya secara otomatis. Rangkaikan beberapa pilihan: satu untuk memilih jenis kiriman, lalu satu lagi untuk memuat kiriman dari jenis tersebut.

```json
{
  "id": "selected_post",
  "type": "select",
  "populate": {
    "type": "query",
    "query": "posts",
    "arguments": {
      "post_type": "{attributes.post_type}"
    }
  }
}
```

Ubah `post_type` menjadi "page" dan pilihan kedua akan memuat halaman. Ubah menjadi "post" dan pilihan itu akan memuat kiriman. Berfungsi dengan jenis populate dan atribut apa pun.

## Composer

Blockstudio kini berfungsi saat dimuat dari mana pun di bawah `wp-content/`, bukan hanya dari direktori plugin. URL aset diselesaikan melalui konstanta `BLOCKSTUDIO_URL`, bukan `plugins_url()`, sehingga instalasi yang disertakan dalam tema dapat langsung berfungsi:

```php title="functions.php"
require_once __DIR__ . '/vendor/autoload.php';
require_once __DIR__ . '/vendor/blockstudio/blockstudio/blockstudio.php';
```

Dependensi runtime `composer.json` telah dirapikan. Paket berskop (TailwindPHP, ScssPhp, Minify) yang sudah disertakan dalam `lib/` tidak lagi tercantum sebagai dependensi runtime. Hanya `php >= 8.2` dan `plugin-update-checker` yang tersisa.

Ketiga metode instalasi (zip plugin, plugin melalui Composer, tema yang menyertakan paket melalui Composer) menghasilkan kondisi awal yang sama: aktivasi penuh WordPress, pendaftaran blok, dan perenderan frontend.

Lihat dokumentasi [Composer](https://blockstudio.dev/id/docs/dev/composer/) untuk petunjuk penyiapan.

## Profiler performa

Tambahkan `?blockstudio-perf` ke halaman mana pun URL dan panel debug akan muncul di bagian bawah, menampilkan waktu render per blok, rincian tiap fase, serta rasio cache hit. Data waktu juga dikirim sebagai header Server-Timing yang dapat dilihat di tab Network pada DevTools browser.

```json title="blockstudio.json"
{ "dev": { "perf": true } }
```

Aktifkan secara permanen melalui pengaturan untuk membuat profil setiap pemuatan halaman. Hanya terlihat oleh pengguna yang sudah masuk dengan kapabilitas `edit_posts`.

Tag blok yang menutup dirinya sendiri kini juga di-cache di memori. Saat blok yang sama dengan atribut identik muncul beberapa kali di halaman, perenderan berikutnya melewati seluruh alur templat.

## Perbaikan bug

- **Peringatan penghentian PHP 8.4**: Memperbaiki peringatan penghentian `strpos()` dan `str_replace()` yang disebabkan oleh penerusan `null` ke `add_submenu_page()`.

## Lainnya

- **Field kode SCSS**: Field kode mendukung `language: "scss"`. Nilai dikompilasi melalui ScssPhp baik di editor maupun di frontend.
- **Blok WordPress standar**: Direktori Blockstudio dapat berisi output `@wordpress/create-block` bersama blok Blockstudio. Blok akan didaftarkan otomatis tanpa kode plugin terpisah.

---

Jika Anda ingin melihat pola full-stack beraksi, panduan [Full-Stack Blocks](https://blockstudio.dev/id/guides/full-stack-blocks/) menjelaskan langkah demi langkah pembuatan aplikasi daftar tugas per pengguna dan formulir pendaftaran buletin publik dari awal.
