
Blockstudio 7.6 membuat proyek dapat dibaca dan dirender dari PHP, serta memindahkan default frontend produksi ke `blockstudio.json`: inventaris API, rendering mandiri, helper templat untuk media dan Tailwind, profil performa, satu direktori cache, prerender statis dengan penyajian awal, preset analisis yang lebih ketat, serta alat proyek yang dihasilkan untuk agen coding.

Dua pemanggilan mencakup sebagian besar rilis ini. `Canvas::inventory()` mengembalikan setiap halaman, blok, pola, templat Site Editor, bagian templat, dan contoh UI terbundel yang didaftarkan proyek. `Render::document()` mengembalikan HTML yang sudah jadi untuk semuanya, beserta aset yang tepat yang digunakan saat rendering.

> **Pembaruan 7.6.2:** Halaman berbasis file tidak lagi direkonsiliasi selama permintaan WordPress biasa. Jalankan `wp bs pages sync` atau panggil `Blockstudio\Pages::reconcile()` saat menerapkan perubahan sumber. Perutean koleksi dan default `templateFor` menggunakan konfigurasi runtime yang tersimpan, dan rekonsiliasi eksplisit menghindari kueri OR-meta multibahasa besar sebelumnya. Opsi `themeDefaults.syncPagesInDevelopment` berumur singkat telah dihapus karena sinkronisasi halaman tidak lagi berjalan dari hook permintaan. `Pages::init()` kini hanya berjalan saat bootstrap; integrasi yang meneruskan `force` harus menggunakan `Pages::reconcile()` atau CLI. Membuka Canvas tetap menjalankan satu rekonsiliasi eksplisit yang terautentikasi untuk inventaris penulisan.

> **7.6.12 pembaruan:** Stylesheet editor kini diberi prefiks melalui satu proses penulisan ulang, bukan kompilasi SASS untuk setiap aset, sehingga build editor dingin di situs dengan banyak blok tidak lagi berisiko menghabiskan batas memori yang terbatas. Halaman prarender yang di-cache dan stylesheet Tailwind-nya yang memiliki hash konten telah dihapus dari cache akan dirender ulang, bukan disajikan tanpa gaya, baik melalui cache PHP maupun drop-in Early Serve. Atribut blok yang ditulis di tingkat teratas kini dibaca saat perenderan, bukan diabaikan, sehingga skema Blockstudio yang terdaftar pada `WP_Block_Type` dihormati oleh penulis programatik.

> **7.6.11 pembaruan:** Instalasi artefak Graph kini mengganti dokumen rute secara atomik saat salinan di penyimpanan berubah dengan kunci yang sama, membiarkan dokumen identik tetap utuh, serta melaporkan rute yang dipromosikan, diganti, dilewati, dan dipertahankan melalui `Static_Prerender_Early_Serve::last_promotion()`.

> **7.6.10 pembaruan:** Cache runtime kini mendeteksi aset kompilasi yang dihapus bahkan selama jeda debounce pemantauan, dan cache runtime datar sebelum 7.6 dikarantina secara atomik lalu dihapus dalam batch cron yang dibatasi. Global UI yang dibundel hanya dikeluarkan sekali per halaman. Early Serve dalam mode Graph dapat menyajikan rute yang dirender langsung di luar peta rute yang diterapkan dari cache identitas. Tailwind dapat secara opsional mengeluarkan file cache dengan hash kontennya menggunakan `tailwind.output: "link"`; keluaran inline tetap menjadi default.

Singkatnya:

- **Inventaris proyek**: `Canvas::inventory()` mengembalikan setiap rekaman terdaftar beserta sumber dan urutan tampilan yang stabil.
- **Pemilihan terarah**: menyebutkan blok dan halaman membatasi penemuan, sinkronisasi, perenderan, dan kompilasi hanya pada rekaman tersebut.
- **Perenderan mandiri**: `Blockstudio\Render` mengembalikan HTML yang sudah selesai untuk sebuah blok, komposisi, atau dokumen lengkap.
- **UI keluarga komponen**: `Blockstudio\Ui` mengelompokkan pustaka yang dibundel menjadi satu keluarga publik untuk setiap komponen, masing-masing dengan satu contoh.
- **Dimensi gambar stabil**: `bs_media_image()` merender aset tema dengan dimensi nyata dari `assets/media.json` yang dihasilkan.
- **Tailwind helper kelas**: `bs_tw_merge()` dan `bs_tw_variants()` menggabungkan kelas di PHP dengan penggabungan yang memperhitungkan konflik.
- **Profil performa**: `performance.profile` sekaligus mengaktifkan default frontend produksi; nilai turunan menggantikannya.
- **Akses pengaturan bertipe**: `Settings::get_bool()` dan saudaranya membaca `blockstudio.json` dengan tipe yang sesuai dan menampilkan kesalahan penguraian.
- **Satu direktori cache**: setiap file yang dihasilkan berada di bawah `cache.path`, dengan kunci berupa identitas runtime.
- **Prarender statis**: HTML anonim dapat di-cache, dibatalkan melalui grafik dependensi, dan disajikan sebelum WordPress dimulai.
- **Preset analisis**: `theme`, `extreme-theme`, dan `wordpress-render` memperluas `blockstudio/phpstan` melampaui templat blok.
- **Hook commit terkelola**: `blockstudio-githooks sync` menulis dan mengelola hook pre-commit yang menjalankan preset terkonfigurasi.
- **Kontrak proyek**: `blockstudio-agents` menulis `AGENTS.md` yang menjelaskan apa yang dibuat oleh penulis proyek, fitur yang diaktifkan, dan hal yang diberlakukan oleh presetnya.
- **Indeks dokumentasi**: file konteks AI kini menjadi indeks semua dokumen, tujuannya, dan identifier yang dimilikinya.
- **Tag blok kanonis**: sebuah perintah mandiri menulis ulang bentuk singkat prefiks dan alias menjadi `<bs:namespace-slug>`, dengan uji coba.
- **Kompatibel secara default**: tidak satu pun hal di atas mengubah situs sampai disebutkan di `blockstudio.json`.

## Membaca dan merender proyek

### Inventaris proyek

`Canvas::inventory()` mengembalikan semua yang didaftarkan proyek sebagai satu array biasa, tanpa merender apa pun.

```php
use Blockstudio\Canvas;

$result = Canvas::inventory();

foreach ($result['inventory']['blocks'] as $block) {
    echo $block['name'] . "\n";
}
```

Rekaman dikelompokkan berdasarkan tipe: `pages`, `blocks`, `patterns`, `templates`, `parts`, dan `ui`. `order` adalah urutan tampilan stabil untuk semua tipe, `sources` memetakan setiap rekaman ke jalur sumbernya, dan `warnings` serta `errors` mengumpulkan masalah sebagai entri terstruktur.

Rekaman blok memuat `id`, `name`, `title`, `source`, `path`, `provenance`, dan `declaration` yang siap dirender. Rekaman halaman menyimpan `source` sebagai identitas stabil dan `path` sebagai templat yang melakukan perenderan.

### Pemilihan terarah

Menyebutkan rekaman membatasi pekerjaan sejak awal, alih-alih memfilternya setelah itu.

```php
$changed = Canvas::inventory([
    'blocks' => ['mytheme/hero'],
    'pages' => ['about'],
]);
```

Hasilnya adalah satu blok dan satu halaman. `patterns`, `templates`, `parts`, dan `ui` kosong, dan sumbernya tidak pernah dibaca, disinkronkan, dirender, atau dikompilasi.

Aturannya tepat:

- Tanpa kunci tipe, semua tipe dimuat.
- `true`, `null`, atau `"*"` memuat semua rekaman dari tipe tersebut.
- String atau daftar mencocokkan ID, nama, slug, jalur, atau jalur sumber secara persis.
- String kosong, daftar kosong, atau `false` tidak memuat rekaman apa pun dari tipe tersebut.
- Jika ada kunci tipe, tipe yang tidak disebutkan tidak disentuh.

Identifier yang sudah tidak ada dikembalikan di bawah `deleted` alih-alih menyebabkan kegagalan, dan endpoint penyegaran Canvas REST menerapkan aturan yang sama pada parameter `blocks` dan `pages`.

`Canvas::documents()` menggunakan pemilihan yang sama dan menambahkan satu dokumen hasil render untuk setiap rekaman. Halaman yang dipilih dirender dalam konteks frontend yang dipulihkan, sehingga conditional query, kelas body, shortcode, tata letak, pengalihan, dan callback enqueue melihat halaman tersebut, bukan permintaan yang memintanya.

### Perenderan mandiri

`Blockstudio\Render` mengembalikan HTML hasil render sebagai string melalui pipeline yang sama dengan frontend.

```php
use Blockstudio\Render;

$html = Render::composition([
    'root' => 'mytheme/card',
    'data' => ['heading' => 'Example card'],
    'layers' => [
        ['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
    ],
]);
```

Di baliknya terdapat satu bentuk deklarasi dengan empat kunci: `name`, `attributes`, `content`, dan `children`. `root`, `data`, `inner`, `innerBlocks`, `layers`, dan `example` adalah kemudahan input yang disatukan oleh `Render::normalize()`. Anak dirender secara rekursif, dan input yang tidak valid memunculkan pengecualian yang menyebutkan blok penyebabnya.

`Render::document()` membungkus keluaran dalam dokumen HTML mandiri yang lengkap.

```php
$document = Render::document('mytheme/hero', [
    'title' => 'Hero preview',
]);

echo $document['html'];
```

`body` adalah keluaran blok saja, `html` adalah dokumen yang dirangkai, `blocks` adalah nama blok yang berkontribusi, dan `assets` membagi markup menjadi `head`, `footer`, `styles`, `scripts`, `modules`, `interactivity`, `ui`, dan `tailwind`. Aset dibatasi pada yang digunakan dalam hasil render, sehingga aset khusus editor tidak pernah muncul.

`Render::document_from_html()` membungkus HTML yang dirender di tempat lain, sedangkan `Render::content()` merender konten blok berseri tanpa dokumen. Panggil `Blockstudio\Batch_Render::reset()` di antara dokumen dalam satu proses PHP; `Canvas::documents()` sudah melakukannya.

### Keluarga komponen UI

`Blockstudio\Ui` menyajikan pustaka UI yang dibundel sebagai satu entri untuk setiap komponen publik, bukan sebagai daftar bagian internal.

`Ui::inventory()` mengembalikan satu entri untuk setiap keluarga, beserta blok akar, judul, dan blok implementasi yang dibutuhkannya. `Ui::examples()` menambahkan deklarasi deterministik untuk setiap keluarga: nilai default dipertahankan, lapisan anak yang wajib ditempatkan di bawah induknya, dan teks ilustratif yang stabil digunakan saat suatu bidang kosong. Deklarasi tersebut bersifat kanonis, sehingga langsung dimasukkan ke `Render::document()`.

Canvas mengelompokkannya dengan cara yang sama. UI yang dibundel muncul di bawah tipe `ui` sebagai satu contoh untuk setiap keluarga, sementara pendaftaran implementasi tidak dimasukkan ke `blocks`.

Keluarga ini dirancang untuk dirangkai: select terbuka di dalam dialog dengan overlay listbox di atas pemicunya, menu dan combobox menambatkan diri menggunakan koordinat viewport tetap yang tidak berubah saat halaman digulir, modal ditumpuk dan ditutup satu per satu dengan Escape, dan setiap footer menggabungkan kontrol tutup yang sama dengan sebuah varian. Penjelasan tentang cara kerja hubungan ini dan invarian yang menjaganya dibahas di [bab komposisi](https://blockstudio.dev/id/ui/composition/); [/ui/examples](https://blockstudio.dev/id/ui/examples/) menampilkan komposisinya secara langsung.

## Helper templat

### Dimensi gambar stabil

`bs_media_image()` merender aset tema dengan lebar, tinggi, dan rasio aspek nyata yang dicadangkan, sehingga gambar di luar pustaka media tidak lagi menggeser tata letak.

```php
<?php
echo bs_media_image([
    'src' => 'assets/images/hero.webp',
    'alt' => 'Hero',
]);
```

Keluarannya berupa `figure.blockstudio-media` dengan `aspect-ratio` inline di sekeliling `img` yang memuat `width`, `height`, `loading`, dan `decoding` dengan nilai nyata. Dimensi diperoleh dari `assets/media.json` yang dihasilkan, yang ditulis oleh `Blockstudio\Media_Metadata_Builder` dalam langkah build atau secara manual.

`src` menerima jalur relatif terhadap tema, jalur absolut, atau URL lengkap, sedangkan `attachmentId` mencakup gambar dari pustaka media. `eager` memilih untuk tidak melakukan lazy loading pada area di atas lipatan, dan `sources` mengeluarkan `<picture>`.

Saat `performance.media.lazy` aktif, URL yang sebenarnya dipindahkan ke `data-src` di balik placeholder berukuran tepat.

### Helper kelas Tailwind

`bs_tw_merge()` dan `bs_tw_variants()` menggabungkan kelas Tailwind di templat PHP menggunakan mesin Blockstudio yang sudah dibundel.

`bs_tw_merge('px-2 text-sm', 'px-4')` mengembalikan `text-sm px-4`: `px-2` yang berkonflik dihapus dan nilai yang muncul belakangan akan digunakan. Array bersarang yang berisi nilai kelas juga diterima.

`bs_tw_variants()` mengembalikan fungsi yang dapat dipanggil untuk varian komponen berukuran kecil:

```php
$button = bs_tw_variants([
    'base' => 'inline-flex items-center',
    'variants' => [
        'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
    ],
    'defaultVariants' => ['size' => 'sm'],
]);

echo $button(['size' => 'lg', 'class' => 'rounded']);
```

Hasilnya adalah `inline-flex items-center h-12 px-6 rounded`. Kelas dasar, varian, varian default, varian gabungan, serta `class` atau `className` yang diberikan saat pemanggilan semuanya didukung.

## Konfigurasi produksi

### Profil performa

`performance.profile` mengaktifkan default frontend produksi dari satu tempat.

```json title="blockstudio.json"
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}
```

`compat` adalah default dan tidak mengubah apa pun. `speed` dan `strict` mengaktifkan rangkaian yang sama: keluaran generator, emoji, feed, discovery, dan pos terkait dihapus dari head; discovery oEmbed dan skrip host dihilangkan; XML-RPC, pingback, dan discovery editor jarak jauh dinonaktifkan; aset frontend inti umum dihapus; default keluaran gambar diterapkan; Heartbeat diperlambat di luar editor; dokumen dari origin yang sama diprafetch saat kursor diarahkan atau fokus diberikan; dan pemuat gambar milik Blockstudio digunakan.

Setiap nilai turunan menggantikan profil, seperti yang dilakukan `preload.links` di atas. Penghapusan aset frontend inti adalah hal pertama yang perlu diuji, karena halaman yang bergantung padanya akan terlihat rusak. `Runtime_Settings::current()` menampilkan profil yang telah ditetapkan.

`themeDefaults` menangani dua hal yang biasanya dibuat sendiri oleh tema: `titleTag` dan `suppressDirectoryUpdates` untuk menyembunyikan tema anak dan tema induk yang aktif dari hasil pembaruan.

### Akses pengaturan bertipe

`Blockstudio\Settings` membaca konfigurasi dengan tipe yang sesuai, alih-alih mengembalikan apa pun yang tersimpan di JSON.

```php
use Blockstudio\Settings;

$lazy = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);
$roles = Settings::get_array('users/roles');

foreach (Settings::errors() as $error) {
    error_log($error);
}
```

JSON yang formatnya tidak valid dilaporkan melalui `Settings::errors()` alih-alih menggunakan nilai default. `Settings::get_raw()` hanya mengembalikan hal yang dinyatakan oleh sumber aktif, sehingga nilai yang ditetapkan ke `false` dapat dibedakan dari nilai yang belum pernah ditetapkan.

`Settings::fingerprint()` mengembalikan identitas stabil untuk pengaturan efektif, dan akses memuat ulang saat `blockstudio.json` berubah.

### Satu direktori cache

Setiap file yang dihasilkan kini berada di bawah `cache.path`, yang default-nya adalah `wp-content/blockstudio/cache`.

```json title="blockstudio.json"
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}
```

Payload build, data pendaftaran blok, aset editor, Tailwind CSS yang dikompilasi, dokumen hasil render, fragmen island, HTML statis, indeks graph, antrean pemanasan, dan diagnostik semuanya berada di bawah direktori tersebut. Jalur relatif ditetapkan dari `WP_CONTENT_DIR`, sedangkan jalur absolut mengarahkannya ke volume khusus.

Objek disimpan berdasarkan jaringan dan situs saat ini, lalu berdasarkan identitas runtime: sidik jari dari versi Blockstudio, WordPress, dan PHP, pengaturan efektif, tema dan plugin aktif, sumber penemuan, serta file sumber yang terlibat. Jika input berubah, objek yang terdampak menjadi objek baru; objek lama dibersihkan.

Build dingin hanya dijalankan sekali: satu permintaan membangun dan menerbitkan hasil secara atomik, sementara permintaan lain menunggu. Penyegaran yang gagal tetap menyajikan objek terakhir yang baik selama kegagalannya tetap dapat diamati, dan `Blockstudio\Runtime_Cache::purge('tailwind')` membersihkan satu cakupan.

## Prarender statis

Prarender statis menyimpan dokumen HTML anonim yang lengkap di cache dan dapat menyajikannya sebelum WordPress dimulai. Fitur ini nonaktif secara default.

```json title="blockstudio.json"
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}
```

### Kelayakan

Hanya dokumen HTML anonim yang lengkap yang memenuhi syarat. Permintaan selain GET, string kueri, admin, REST, Ajax, cron, feed, pencarian, pratinjau, permintaan yang membawa nonce, cookie yang dipersonalisasi, dan jalur apa pun di bawah `dynamicPaths` akan dilewati. Respons dapat memilih untuk tidak ikut sama sekali dengan penanda `<!-- blockstudio:no-cache -->`.

Pencocokan jalur menghormati batas segmen, sehingga `/account` mencakup `/account/orders`, tetapi tidak mencakup `/accounting`.

### Mode tanda tangan dan graph

`invalidate` menentukan cara kedaluwarsa entri. Mode default `signature` mengisi respons berkunci identitas saat terjadi cache miss anonim dan memperbaruinya setelah perubahan tingkat situs, sehingga cocok untuk situs biasa.

Mode `graph` ditujukan untuk alat build dan deploy eksplisit. Mode ini mencatat dependensi sumber tiap halaman, sehingga sebuah rencana hanya membangun ulang URL yang terdampak.

```php
use Blockstudio\Static_Prerender_Runtime;

$plan = Static_Prerender_Runtime::build_plan($sourceUrls);

foreach ($plan['affectedUrls'] as $url) {
    $result = render_with_dependencies($url);

    Static_Prerender_Runtime::persist_built_response(
        $url,
        $result['html'],
        $result['files'],
        $result['virtualHashes']
    );
}

Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));
```

### Penyajian awal

Saat `earlyServe` aktif, Blockstudio mengelola peta rute kecil per situs dan drop-in `advanced-cache.php` yang mengalirkan respons cache yang memenuhi syarat sebelum WordPress, plugin, atau tema dimulai.

Fitur ini tidak pernah menimpa peta, drop-in, atau deklarasi `WP_CACHE` milik pihak lain. Artefak graph memvalidasi setiap file HTML yang dirujuk sebelum peta diganti, sehingga deploy yang dirender setengah jalan membiarkan graph sebelumnya tetap aktif. Entri multisitus tetap terisolasi berdasarkan host, jalur home, dan ID situs.

### Pengisian cache dan status

Tiga perintah WP-CLI mencakup penggunaan sehari-hari:

```bash
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
```

`status` melaporkan identitas aktif, jumlah file dan byte, rekaman graph, status antrean, serta penghitung hit, miss, build, dan kegagalan untuk setiap cakupan.

## Analisis dan alat agen

### Preset analisis

`blockstudio/phpstan` menambahkan tiga lapisan di atas analisis bloknya, serta satu perintah untuk menjalankan lapisan yang dipilih proyek.

| Preset | Yang ditambahkan |
| --- | --- |
| `base` | Analisis skema, templat, hook, pengaturan, dan API yang sudah ada. |
| `theme` | Akar tema, header gaya, aset, cakupan selector, default bidang, batas repeater. |
| `extreme-theme` | PHPStan `max`, PHP yang tidak aman, escaping, Tailwind, JavaScript, dan pemeriksaan Interactivity. |
| `wordpress-render` | Probe render langsung yang disediakan pemanggil di atas `extreme-theme`. |

Default berasal dari `blockstudio.json`, sehingga eksekusi interaktif, CI, dan hook commit menggunakan satu konfigurasi:

```json title="blockstudio.json"
{
  "phpstan": {
    "preset": "theme",
    "roots": ["."],
    "excludePaths": ["fixtures/**"],
    "maxFiles": 10000
  }
}
```

```bash
vendor/bin/blockstudio-phpstan --root . -- --no-progress
```

Kode keluar adalah `0` saat berhasil, `1` untuk diagnostik, dan `2` untuk penggunaan yang tidak valid. Wrapper menyusun konfigurasinya di direktori sementara sistem, sehingga tidak ada konfigurasi, baseline, atau cache hasil generate yang masuk ke proyek, dan batas memori PHPStan dinaikkan menjadi `1G`.

Paket ini juga menyertakan penyedia BC Math, sehingga pemeriksaan JavaScript tidak lagi memerlukan `ext-bcmath`.

### Hook commit terkelola

Satu pengaturan dan satu perintah menjadikan preset terkonfigurasi sebagai gerbang commit.

```json title="blockstudio.json"
{
  "githooks": {
    "commit": true
  }
}
```

```bash
vendor/bin/blockstudio-githooks sync
```

Sinkronisasi menulis hook dan catatan kepemilikan di direktori umum milik Git, mengarahkan `core.hooksPath` ke direktori terkelola, dan meneruskan hook pre-commit yang dikonfigurasi sebelumnya. Hook mencari repositori dan akar proyek saat commit dilakukan, sehingga checkout tertaut dan jalur yang memuat spasi dapat digunakan.

Hook menjalankan `vendor/bin/blockstudio-phpstan` saja; hook tidak pernah memformat atau menulis ulang file. Dengan mengatur `commit` ke `false` lalu menyinkronkan lagi, atau menjalankan `blockstudio-githooks remove`, jalur hook yang tercatat dipulihkan dan hanya file milik Blockstudio yang dihapus.

### Kontrak proyek

`blockstudio-agents` menulis `AGENTS.md` yang menyatakan lokasi blok, arti halaman dalam proyek ini, fitur yang diaktifkan, dan hal yang akan ditolak oleh penganalisis.

```bash
vendor/bin/blockstudio-agents
```

Dokumen ini diturunkan dari proyek, bukan dari templat. Tema dengan header `style.css`, blok, dan halaman berbasis file memiliki kontrak yang berbeda dari plugin yang hanya mendaftarkan blok, lengkap dengan jumlah, direktori, namespace, dan bahasa templat yang ditemukan oleh pemindai. `blockstudio.json` menentukan fitur yang ditampilkan, sehingga proyek tanpa prarender statis tidak akan menyebutkannya.

Bagian kebenaran dibaca lapis demi lapis dari file aturan milik preset yang dipilih, sehingga saat sebuah preset mendapat aturan baru, setiap kontrak yang dihasilkan ikut berubah.

Kepemilikannya bekerja seperti hook commit. File tanpa penanda hasil generate akan ditolak, bukan diganti, kecuali `--force` menyatakan sebaliknya; bagian catatan di akhir tetap ada saat dibuat ulang; `--check` keluar dengan kode `1` jika kontrak sudah kedaluwarsa; dan `--stdout` menampilkannya tanpa menyentuh sistem file.

### Indeks dokumentasi

`blockstudio-llm.txt` kini berupa indeks, bukan penggabungan dokumen. Setiap dokumen yang dipublikasikan muncul satu kali di bagian dan subbagiannya, beserta rute, file sumber, tujuan satu baris, dan identifier yang dimilikinya: jalur pengaturan, nama hook, fungsi dan kelas PHP, serta perintah.

```text
## Docs / Dev / Inspection Tools

### Canvas
route: /docs/dev/canvas
file: docs/docs/dev/canvas.md
purpose: A visual workspace and public inventory API for Blockstudio content.
settings: dev/canvas/enabled, ui
hooks: blockstudio/settings/dev/canvas/admin_bar, blockstudio/settings/dev/canvas/enabled
php: Blockstudio\Canvas, Canvas::documents(), Canvas::inventory()
```

Sebuah agen membaca indeks, menemukan satu dokumen yang memiliki pengenal yang dibutuhkannya, lalu membuka dokumen itu. Gabungan setengah megabita sebelumnya tetap dibuat dan diterbitkan di `/blockstudio-llm-full.txt`; kini bukan lagi hal pertama yang diberikan kepada siapa pun.

## Tag blok kanonis

Perintah mandiri menulis ulang singkatan prefix dan alias menjadi ejaan kanonis `<bs:namespace-slug>`, yang mencatat nama blok sebenarnya dan dapat di-resolve tanpa filter proyek dimuat.

Dengan prefix `brand` di atas `theme-components` dan prefix `ui` di atas `bsui`,
singkatan ini:

```html
<brand-card>
  <ui-input />
</brand-card>
```

berarti sama dengan:

```html
<bs:theme-components-card>
  <bs:bsui-input />
</bs:theme-components-card>
```

Prefix dan alias persis tetap berfungsi dan tidak deprecated. Perintah ini tidak memuat WordPress dan tidak menulis apa pun tanpa `--apply`:

```bash
php vendor/blockstudio/blockstudio/bin/migrate-block-tags.php \
  --root="$PWD" \
  --prefix-map=/tmp/prefixes.json \
  --known-blocks=/tmp/blocks.json \
  --report=/tmp/tag-migration.json \
  --dry-run
```

`--prefix-map` memetakan setiap prefix ke namespace-nya dan `--known-blocks` mencantumkan nama blok yang terdaftar. Laporan mencatat pemetaan lama ke kanonis beserta jumlah kemunculan, hash per berkas, serta daftar terpisah untuk tag tak dikenal, alias ambigu, dan tag dinamis. `--apply` menolak menulis selama masih ada yang tersisa, kecuali `--allow-unresolved` diberikan.

Markup berpasangan, bertingkat, dan tag mandiri ditangani, termasuk tag literal dalam string PHP. Hanya nama tag yang berubah, proses kedua tidak menghasilkan perubahan, dan contoh di dalam komentar, blok kode, `<pre>`, atau `<code>` hanya dilaporkan.

## Perilaku default

Menginstal 7.6 tidak mengubah apa pun dengan sendirinya.

**Profil performa secara default adalah `compat`.** Output head, oEmbed, XML-RPC,
Heartbeat, default gambar, prefetch tautan, pemuatan lambat, dan frontend
`<title>` tetap seperti yang ditetapkan WordPress dan tema.

**Semua ini tetap nonaktif kecuali diaktifkan:** setiap kunci `performance.staticPrerender`,
`performance.measurement`, `performance.media`, dan `themeDefaults`, ditambah
`githooks.commit`, `dev.canvas.enabled`, `ui.enabled`, `tailwind.enabled`, dan
`blockTags.enabled`. Prarender statis tidak menulis berkas dan tidak memasang drop-in
selama nonaktif.

**Canvas dan Render bersifat pasif.** Keduanya membaca registri yang sudah ada dan hanya merender yang diminta pemanggil; keduanya tidak memasang hook ke output frontend maupun mendaftarkan rute. Layar admin Canvas tetap memerlukan `dev.canvas.enabled` dan `edit_posts`.

**Analisis yang lebih ketat harus disebutkan secara eksplisit.** Menginstal `blockstudio/phpstan` hanya mengaktifkan ekstensi dasar, dan perintah kanonis menjalankan `base` kecuali proyek menyebutkan preset.

**Berkas yang dihasilkan memerlukan perintahnya untuk dijalankan.** `githooks.commit` tidak melakukan apa pun sampai `blockstudio-githooks sync` dijalankan, dan `AGENTS.md` juga tidak sampai `blockstudio-agents` dijalankan.

## Memutakhirkan dari 7.5

Persyaratannya tidak berubah: PHP 8.2 atau lebih baru, WordPress 6.7 atau lebih baru.

```bash
composer require blockstudio/blockstudio
```

**Cache dibangun ulang sekali.** Identitas runtime mencakup versi Blockstudio,
sehingga permintaan pertama setelah pemutakhiran berjalan tanpa cache dan objek lama dipangkas. Cache Tailwind lama di `wp-content/uploads/blockstudio/tailwind/cache` dapat dihapus; cuplikan yang melakukan glob terhadapnya sebaiknya memanggil `Blockstudio\Runtime_Cache::purge('tailwind')`.

Direktori `wp-content/blockstudio/cache/runtime` datar sebelum 7.6 otomatis diganti namanya agar keluar dari jalur aktif, lalu dihapus melalui proses WP-Cron terbatas. Karena itu, pohon berkas lock lama yang besar tidak perlu dihapus selama permintaan deployment.

**Berkas yang dihasilkan memiliki pemilik.** `assets/media.json` sebaiknya berada di kontrol versi atau dalam langkah build. Peta rute, drop-in `advanced-cache.php`, dan deklarasi `WP_CACHE` hanya ada saat `earlyServe` diaktifkan, dan hook pre-commit hanya ada selama sinkron. Semua hasil generasi lainnya berada di bawah `cache.path` dan aman untuk dihapus.

**Tidak ada yang dihapus atau diganti namanya.** `bs_render_block()`, `bs_block()`,
`Blockstudio\Pages`, dan `Blockstudio\Patterns` tetap menjadi permukaan konten kanonis berbasis berkas.

**Rollback dilakukan per fitur.** `performance.profile` kembali ke `compat`,
`staticPrerender.enabled` ke `false`, `githooks.commit` ke `false` ditambah
`sync`, dan `cache.enabled` ke `false` masing-masing membatalkan satu lapisan.

Urutan penerapan yang wajar:

1. Atur `performance.profile` ke `speed`, lalu periksa output head, feed, dan plugin apa pun yang bergantung pada oEmbed atau XML-RPC.
2. Buat `assets/media.json`, pindahkan template ke `bs_media_image()`, lalu aktifkan `performance.media.lazy`.
3. Aktifkan `performance.staticPrerender` dengan `earlyServe` nonaktif, verifikasi hit dengan `wp bs prerender status`, lalu aktifkan `earlyServe`.
4. Jalankan `blockstudio-phpstan --preset theme` hingga bersih sebelum menempatkan preset apa pun di balik `githooks.commit`.

## Lokasi detail selengkapnya

- [Canvas](https://blockstudio.dev/id/docs/dev/canvas/) dan
  [inventaris serta dokumen API](https://blockstudio.dev/id/docs/dev/canvas/#public-inventory-and-document-api)
- [Rendering](https://blockstudio.dev/id/docs/blocks/rendering/#structured-compositions-and-complete-documents),
  [Komponen UI](https://blockstudio.dev/id/ui/#public-inventory-and-examples), dan
  [Komposisi UI](https://blockstudio.dev/id/ui/composition/)
- [Pengaturan ](https://blockstudio.dev/id/docs/general/settings/) dan
  [performa](https://blockstudio.dev/id/docs/general/settings/#performance)
- [Performa](https://blockstudio.dev/id/docs/production/performance/),
  [Caching](https://blockstudio.dev/id/docs/production/caching/), dan
  [Prarender Statis](https://blockstudio.dev/id/docs/production/static-prerendering/)
- [Tailwind CSS](https://blockstudio.dev/id/docs/tailwind/#template-composition-helpers)
- [PHPStan](https://blockstudio.dev/id/docs/dev/phpstan/): [preset](https://blockstudio.dev/id/docs/dev/phpstan/#analysis-presets),
  [perintah kanonis](https://blockstudio.dev/id/docs/dev/phpstan/#canonical-command),
  [hook commit terkelola](https://blockstudio.dev/id/docs/dev/phpstan/#managed-commit-hook), dan
  [kontrak proyek](https://blockstudio.dev/id/docs/dev/phpstan/#project-contract-for-coding-agents)
- [Integrasi AI](https://blockstudio.dev/id/docs/dev/ai/): indeks dokumentasi dan teks lengkap
- [Migrasi](https://blockstudio.dev/id/docs/dev/migration/v7/#canonical-block-tags) dan
  [Hook PHP](https://blockstudio.dev/id/docs/blocks/hooks/php/)
