Lewati ke konten

Dennis · 10 April 2026

Blockstudio 7.2

Blockstudio 7.2 mengembangkan framework ke dua arah sekaligus.

Arah pertama adalah visibilitas dan alur kerja dalam satu proyek: ringkasan admin baru, penjelajah database, penjelajah registri admin, dan pengantar SCSS untuk penyiapan Sass bersama.

Arah kedua adalah ekosistem di sekitar Blockstudio: CLI registri untuk mendistribusikan blok (seperti shadcn untuk WordPress), dan ekstensi PHPStan yang menghadirkan keamanan tipe ala TypeScript pada templat, tag blok, db.php, rpc.php, cron.php, serta file skema terkait.

Kedua arah ini memiliki tujuan yang sama: membuat proyek Blockstudio yang lebih besar lebih mudah dipahami, dikembangkan, dan dibagikan.

Pengalaman admin

Dua tambahan memudahkan navigasi di wp-admin dalam proyek yang lebih besar.

Ringkasan admin

Kini, Blockstudio menyertakan layar admin di Alat > Blockstudio. Layar ini menyediakan satu tempat untuk memeriksa hal-hal yang telah didaftarkan sistem dari sistem berkas.

Ringkasan ini mencakup tab khusus untuk:

  • Blok
  • Ekstensi
  • Field
  • Halaman
  • Skema

Selain ringkasan itu, area admin kini memiliki bagian Database khusus. Bagian ini mencantumkan setiap skema Blockstudio\Db yang terdaftar dan memungkinkan Anda memeriksa rekaman sebenarnya langsung di wp-admin.

Alih-alih membuat kisi panel khusus, layar ini menggunakan tabel DataViews WordPress bawaan. Dengan begitu, UI tetap selaras dengan wp-admin dan praktis digunakan saat proyek memiliki puluhan atau ratusan pendaftaran.

Pada instalasi kecil, Anda dapat mengingat status runtime dengan mudah. Pada basis kode yang lebih besar, cara itu tidak lagi berhasil. Anda akan mulai menanyakan hal-hal seperti:

  • Blok mana yang benar-benar terdaftar saat ini?
  • Ekstensi mana yang menargetkan core/* dan mana yang menargetkan blok individual?
  • Halaman mana yang disinkronkan, dan jenis kiriman mana yang terkait dengannya?
  • Field yang dapat digunakan kembali apa saja yang ada di proyek ini?
  • Skema mana yang terdaftar, dan backend penyimpanan apa yang digunakannya?

Sebelumnya, jawabannya harus dicari dengan membaca folder, membuka file JSON, dan menelusuri PHP. Kini, ringkasan tersebut menyediakannya dalam tampilan admin khusus.

Setiap tab dirancang untuk menjawab pertanyaan yang berbeda:

  • Blok menampilkan jenis blok terdaftar, mode render, versi API, dan jumlah atribut
  • Ekstensi menampilkan blok yang ditargetkan, beserta prioritas dan detail render
  • Field menyediakan inventaris ringkas definisi field khusus yang dapat digunakan kembali
  • Halaman menampilkan halaman berbasis file yang disinkronkan, beserta jenis kiriman, status, mesin templat, dan status sinkronisasi
  • Skema menampilkan skema penyimpanan terdaftar, beserta backend, jumlah field, dan cakupan kapabilitas

Browser database sengaja dipisahkan dari payload ikhtisar awal. Alih-alih membuat serialisasi setiap baris saat halaman dimuat, browser ini hanya melokalkan skema yang tersedia terlebih dahulu dan mengambil data sesuai permintaan saat Anda membuka tab database. Dengan begitu, area admin tetap berguna meskipun proyek memiliki dataset yang lebih besar di balik db.php.

Versi pertama ini sengaja berfokus pada pendaftaran berbasis skema. Ini bukan halaman pengaturan. Ini halaman inspeksi.

Jika Anda sama sekali tidak menginginkannya, nonaktifkan sepenuhnya:

PHP
add_filter('blockstudio/admin/enabled', '__return_false');

Browser registri admin

Di samping ikhtisar terdapat tab kedua: Registry. Tab ini adalah browser untuk registri blok jarak jauh yang dikonfigurasi di blocks.json tema Anda, dan memungkinkan Anda mengimpor blok langsung dari admin WordPress tanpa menyentuh CLI.

JSON
{
  "directory": "blockstudio",
  "registries": {
    "ui": "https://blocks.example.com/registry.json",
    "private": {
      "url": "https://api.example.com/registry.json",
      "headers": {
        "Authorization": "Bearer ${REGISTRY_TOKEN}"
      }
    }
  }
}

Browser ini mengambil data dari setiap registri yang dikonfigurasi, menampilkan semua blok yang tersedia, serta menunjukkan apakah blok sudah terpasang secara lokal atau siap diimpor. Setiap baris memiliki tombol Import yang mengunduh file blok ke direktori yang dikonfigurasi untuk tema Anda. Blok yang sudah terpasang akan menampilkan tombol Reimport.

Registri yang memerlukan autentikasi didukung melalui format objek dengan headers, termasuk interpolasi ${ENV_VAR} agar token tidak pernah masuk ke kontrol versi.

Dengan demikian, menelusuri dan menggunakan registri menjadi pengalaman admin kelas satu, bukan sekadar alur kerja CLI.

CLI registri

Bagian lain dari ekosistem registri adalah CLI mandiri: blockstudio/registry.

Ini adalah alat bergaya shadcn untuk blok WordPress. Tidak memerlukan paket npm dan tidak perlu langkah build. Anda menjalankan perintah, kode sumber blok disalin ke proyek, lalu Anda memiliki kendali penuh atasnya.

Shell
npx blockstudio init
npx blockstudio add ui/tabs

CLI berfungsi dengan jenis blok apa pun: blok Blockstudio, output @wordpress/create-block, dan blok PHP biasa. Registri tidak memedulikan isi foldernya. Registri membaca manifes file dari registry.json dan menyalin file yang tercantum saja.

Pembuat blok menerbitkan registry.json di URL mana pun (konten mentah GitHub, S3, server khusus) yang mencantumkan blok yang tersedia beserta metadata, dependensi, dan daftar file. Pengguna menambahkan URL ke blocks.json mereka lalu mengambil blok berdasarkan nama.

CLI mendukung:

  • Resolusi dependensi: blok dapat mendeklarasikan dependensi pada blok lain, yang diresolusikan secara otomatis dengan deteksi siklus
  • Penanganan konflik multi-registri: jika nama blok yang sama tersedia di beberapa registri, CLI meminta Anda memilih salah satunya
  • Registri dengan autentikasi: token bearer, autentikasi dasar, dan header khusus dengan interpolasi variabel lingkungan
  • TUI interaktif: dibuat dengan Ink, dilengkapi indikator pemuatan, prompt pilihan, dan indikator progres
  • Mode noninteraktif: tanda --yes serta fallback otomatis untuk CI dan alur berpipa
  • Pencarian dan daftar: telusuri registri dari baris perintah

Paket ini menyertakan 130 pengujian yang mencakup skema, resolusi dependensi, pengambilan HTTP, penulisan file, setiap alur perintah, dan UI Ink interaktif.

Dokumentasi lengkap di blockstudio.dev/registry.

Ekstensi PHPStan

Tambahan besar lainnya adalah blockstudio/phpstan: ekstensi PHPStan yang memberi pengguna Blockstudio keamanan tipe seperti yang diharapkan pengembang TypeScript.

Shell
composer require --dev blockstudio/phpstan

Ekstensi ini membaca skema aktual proyek Anda saat analisis dan meneruskan tipe yang dihasilkan kembali ke PHPStan. Kini cakupannya meliputi templat PHP, Twig, Blade, tag blok, rekaman database bertipe, jalur pengaturan, nama hook, dan validasi skema di block.json, field.json, ekstensi JSON, page.json, db.php, rpc.php, cron.php, dan blockstudio.json.

Templat blok dengan keamanan tipe

Akses field pada $a divalidasi terhadap block.json yang terkait:

PHP
<?php
/** @var array<string, mixed> $a */

echo $a['title'];     // OK
echo $a['cta']['href']; // OK
echo $a['typo'];      // ERROR: Field "typo" does not exist in block.json (block: hero). Did you mean "title"?

Rekaman database dengan keamanan tipe

Db::get() mengembalikan instans bertipe berdasarkan skema db.php Anda. Bentuk rekaman dibuat dari field aktual:

PHP
return [
  'storage' => 'table',
  'fields' => [
    'email' => ['type' => 'string', 'required' => true],
    'name'  => ['type' => 'string'],
  ],
];
PHP
$db = Db::get('mytheme/subscribers');
$record = $db->create(['email' => 'a@b.com']);

echo $record['email']; // PHPStan: string
echo $record['name'];  // PHPStan: string|null
echo $record['typo'];  // ERROR: Offset 'typo' does not exist on array{id: int, email: string, name: string|null}

Validasi skema

File skema yang tidak valid terdeteksi saat analisis: block.json, field.json, ekstensi JSON, page.json, db.php, rpc.php, cron.php, dan blockstudio.json. Nama yang hilang, tipe field yang salah, definisi yang formatnya keliru, boolean singkat yang sudah usang ("tailwind": true alih-alih objek bertingkat), semuanya dilaporkan beserta nomor baris yang tepat dalam file sumber.

Validasi jalur pengaturan

Pemanggilan Settings::get() divalidasi terhadap skema pengaturan yang diketahui:

PHP
Settings::get('tailwind/enabled');  // OK, returns bool
Settings::get('tailwind/enabld');   // ERROR: Settings path "tailwind/enabld" is not a known Blockstudio setting. Did you mean "tailwind/enabled"?

Validasi nama hook

Hal yang sama berlaku untuk nama hook filter dan action:

PHP
add_filter('blockstudio/render', $cb);  // OK
add_filter('blockstudio/rendrr', $cb);  // ERROR: Unknown Blockstudio hook "blockstudio/rendrr". Did you mean "blockstudio/render"?

Ekstensi ini juga menyertakan stub untuk seluruh Blockstudio publik API: Db, Settings, Field_Registry, Build, dan helper global. Anda mendapatkan pelengkapan otomatis dan pemeriksaan tipe untuk semua API Blockstudio tanpa memerlukan sumber plugin di mesin pengembangan Anda.

Kemudahan penulisan

Dua kemudahan kecil untuk penulisan melengkapi rilis ini.

Pralude SCSS global

Blockstudio telah mendukung kompilasi SCSS, tetapi ada satu kendala yang mengganggu: penyiapan Sass bersama.

Jika Anda ingin menggunakan sekumpulan variabel, fungsi, atau mixin yang umum, Anda harus mengimpornya di setiap file SCSS. Hal ini cepat berulang, terutama pada sistem desain besar atau perangkat Sass seperti Bootstrap.

Versi 7.2 menambahkan hook pralude untuk kebutuhan tersebut:

PHP
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
  return '@import "functions";' . "\n"
    . '@import "variables";' . "\n"
    . '@import "mixins";';
}, 10, 3);

Jika digabungkan dengan filter blockstudio/assets/process/scss/import_paths yang sudah ada, Anda dapat mendefinisikan antarmuka Sass bersama satu kali dan menggunakannya di setiap file yang dikompilasi.

Stylesheet blok dapat tetap berfokus pada gaya yang benar-benar dibutuhkan:

Scss
.hero {
  @include media-breakpoint-up(lg) {
    padding: 4rem;
  }
}

Tak perlu mengulang impor di setiap aset blok. Ini bukan “dukungan Bootstrap” sebagai mode khusus. Ini adalah hook umum untuk Sass bersama di seluruh proyek, baik yang berasal dari Bootstrap maupun perangkat internal Anda sendiri.

Definisi API blok native PHP

Versi 7.2 juga menambahkan sintaks native PHP opsional untuk API blok full-stack. Array tetap menjadi format default dan didukung sepenuhnya. Tidak ada yang digantikan. Namun, jika Anda lebih menyukai argumen bernama, enum, dan atribut daripada array konfigurasi bertingkat, kini Anda dapat memilih gaya tersebut.

Untuk rpc.php, kembalikan objek dengan metode beratribut:

PHP
<?php
use Blockstudio\Attributes\Rpc;
use Blockstudio\Rpc\Access;
use Blockstudio\Rpc\Method;

return new class {
    #[Rpc(access: Access::Session)]
    public function subscribe(array $params): array {
        return ['success' => true];
    }

    #[Rpc(name: 'status', methods: [Method::Get, Method::Post])]
    public function getStatus(array $params): array {
        return ['status' => 'ok'];
    }
};

Untuk cron.php, pendekatan yang sama dapat digunakan dengan #[Cron]:

PHP
<?php
use Blockstudio\Attributes\Cron;
use Blockstudio\Cron\Schedule;

return new class {
    #[Cron(schedule: Schedule::Hourly)]
    public function heartbeat(): void {
    }
};

Dan untuk db.php, kini tersedia lapisan builder kecil:

PHP
<?php
use Blockstudio\Db\Field;
use Blockstudio\Db\Schema;
use Blockstudio\Db\Storage;

return Schema::make(
    storage: Storage::Table,
    fields: [
        'email' => Field::string(required: true, format: 'email'),
        'active' => Field::boolean(default: false),
    ],
);

Ini memberikan keseimbangan yang lebih baik untuk basis kode yang lebih besar. Anda tetap dapat menggunakan format array yang sederhana saat menginginkannya, dan beralih ke antarmuka PHP yang lebih mudah ditemukan saat blok berkembang melebihi beberapa field atau endpoint.

Mengapa semua ini dirilis bersama

Ikhtisar admin, browser registri, CLI registri, dan ekstensi PHPStan menjawab pertanyaan yang sama: bagaimana menjaga proyek Blockstudio tetap mudah dipahami seiring perkembangannya?

Alat admin menjawabnya di tingkat proyek: visibilitas atas hal yang terdaftar, kemampuan mengambil blok dari registri, dan lebih sedikit tebak-tebakan.

CLI menjawabnya di tingkat ekosistem: cara berbagi blok antarproyek dan tim tanpa mengemasnya ke dalam paket npm atau bergulat dengan sistem build.

Ekstensi PHPStan menjawabnya di tingkat kode: mendeteksi akses field yang salah, kesalahan ketik dalam skema, dan callback hook yang rusak sebelum mencapai runtime.

Secara umum, itulah arah versi 7.2: lebih sedikit tebak-tebakan dan pengulangan, visibilitas lebih baik, dan kini keamanan tipe yang nyata.

Perbaikan bug

  • Field kelas: nama kelas khusus yang diketik pengguna diam-diam terhapus saat fokus berpindah karena validator hanya menerima kelas dari daftar Tailwind/pengaturan yang sudah ditentukan. Kini string apa pun yang tidak kosong diterima.
  • Field atribut: menghapus pasangan atribut meninggalkan entri null di data tersimpan. Penggunaan lodash unset() diganti dengan splice(), yang menghapus elemen array alih-alih mengosongkannya.
  • Minifier CSS: minifier TailwindPHP menghapus spasi di sekitar + di dalam calc() dan clamp(), sehingga menghasilkan CSS yang tidak valid seperti calc(1rem+0.5vw). Masalah diperbaiki di hulu pada TailwindPHP v1.3.1 dengan penelusuran karakter yang memperhitungkan kedalaman dan hanya menghapus spasi di sekitar kombinator selector pada kedalaman tanda kurung 0.
  • Pratinjau Block Inserter: $isPreview selalu false di pratinjau Block Inserter karena cache render tidak menyertakan mode render dalam kunci hash-nya. Render editor dan pratinjau kini menghasilkan entri cache terpisah.
  • Templat InnerBlocks bertingkat: komponen <InnerBlocks template="..."/> menghapus elemen ke-3 (anak) dari tupel templat seperti ['core/group', {}, [['core/paragraph']]], sehingga blok kontainer menjadi kosong. Kini anak bertingkat tetap dipertahankan.