
Blockstudio 7.6, projeyi PHP üzerinden okunabilir ve görüntülenebilir hale getiriyor, ön yüz üretim varsayılanlarını da `blockstudio.json` içine taşıyor: envanter API, bağımsız görüntüleme, medya ve Tailwind için şablon yardımcıları, performans profilleri, tek bir önbellek dizini, erken sunumla statik önceden görüntüleme, daha sıkı analiz hazır ayarları ve kodlama aracıları için oluşturulan proje araçları.

Sürümün büyük bölümünü iki çağrı oluşturuyor. `Canvas::inventory()`, projenin kaydettiği tüm sayfaları, blokları, desenleri, Site Editor şablonlarını, şablon parçalarını ve paketlenmiş UI örneklerini döndürür. `Render::document()`, her biri için tamamlanmış HTML ve görüntülemede kullanılan varlıkların tam listesini döndürür.

> **7.6.2 güncellemesi:** Dosya tabanlı sayfalar artık normal WordPress istekleri sırasında uzlaştırılmıyor. Kaynak değişikliklerini uygulamak için `wp bs pages sync` komutunu çalıştırın veya `Blockstudio\Pages::reconcile()` çağrısını yapın. Koleksiyon yönlendirmesi ve `templateFor` varsayılanları, kalıcı çalışma zamanı yapılandırmasını kullanıyor; açık uzlaştırma ise önceki büyük çok dilli OR-meta sorgusunu önlüyor. Sayfa eşitlemesi artık istek kancalarından çalışmadığı için kısa ömürlü `themeDefaults.syncPagesInDevelopment` seçeneği kaldırıldı. `Pages::init()` artık yalnızca başlatma içindir; `force` ileten entegrasyonlar `Pages::reconcile()` veya CLI kullanmalıdır. Canvas'ı açmak, yazarlık envanteri için hâlâ bir kez açık ve kimliği doğrulanmış uzlaştırma yapar.

> **7.6.12 güncellemesi:** Editör stil sayfaları artık her varlık için ayrı bir SASS derlemesi yerine tek bir yeniden yazma geçişiyle önekleniyor; bu sayede çok sayıda bloğu olan bir sitede soğuk editör derlemesi artık mütevazı bir bellek sınırını aşma riski taşımıyor. İçerik karmalı Tailwind stil sayfası önbellekten çıkarılmış önceden oluşturulmuş bir sayfa, hem PHP önbelleği hem de Early Serve drop-in'i üzerinden stilsiz sunulmak yerine yeniden oluşturuluyor. Üst düzeyde yazılan blok öznitelikleri artık atılmak yerine oluşturma sırasında okunuyor; böylece `WP_Block_Type` üzerindeki şema Blockstudio programatik yazıcılar tarafından dikkate alınıyor.

> **7.6.11 güncellemesi:** Grafik yapıtı kurulumu artık depo kopyası aynı anahtar altında değiştiğinde bir rotanın belgesini atomik olarak değiştiriyor, aynı belgeleri olduğu gibi bırakıyor ve yükseltilen, değiştirilen, atlanan ve korunan rotaları `Static_Prerender_Early_Serve::last_promotion()` üzerinden bildiriyor.

> **7.6.10 güncellemesi:** Çalışma zamanı önbellek isabetleri artık izleme gecikmesi sırasında bile kaldırılmış derlenmiş varlıkları algılıyor; 7.6 öncesi düz çalışma zamanı önbellekleri ise atomik olarak karantinaya alınıp sınırlı cron grupları halinde siliniyor. Paketlenmiş UI global'leri her sayfada bir kez çıktılanıyor. Grafik modundaki Early Serve, dağıtılan rota haritasının dışındaki canlı oluşturulmuş rotaları kimlik önbelleğinden sunabiliyor. Tailwind, içerik karmalı önbellek dosyasını isteğe bağlı olarak `tailwind.output: "link"` ile çıktılabilir; varsayılan olarak satır içi çıktı kullanılır.

Kısaca:

- **Proje envanteri**: `Canvas::inventory()`, tüm kayıtlı kayıtları kaynakları ve sabit bir görüntüleme sırasıyla döndürür.
- **Hedefli seçim**: Blok ve sayfa adlarını belirtmek; keşif, eşitleme, oluşturma ve derlemeyi bu kayıtlarla sınırlar.
- **Bağımsız oluşturma**: `Blockstudio\Render`, bir blok, bileşim veya eksiksiz belge için tamamlanmış HTML döndürür.
- **UI bileşen aileleri**: `Blockstudio\Ui`, paketlenmiş kütüphaneyi bileşen başına bir genel ailede ve her biri için bir örnekle gruplandırır.
- **Sabit görüntü boyutları**: `bs_media_image()`, tema varlıklarını oluşturulmuş bir `assets/media.json` dosyasındaki gerçek boyutlarla işler.
- **Tailwind sınıf yardımcıları**: `bs_tw_merge()` ve `bs_tw_variants()`, çakışma duyarlı birleştirmeyle PHP içinde sınıfları bir araya getirir.
- **Performans profilleri**: `performance.profile`, üretim ön yüzü varsayılanlarını tek seferde etkinleştirir; alt değerler bunları geçersiz kılar.
- **Türlenmiş ayarlara erişim**: `Settings::get_bool()` ve benzerleri, `blockstudio.json` dosyasını gerçek türlerle okur ve ayrıştırma hatalarını gösterir.
- **Tek önbellek dizini**: Oluşturulan her dosya, çalışma zamanı kimliğine göre anahtarlanan `cache.path` dizininin altında bulunur.
- **Statik önceden oluşturma**: Anonim HTML önbelleğe alınabilir, bağımlılık grafiği üzerinden geçersiz kılınabilir ve WordPress başlatılmadan önce sunulabilir.
- **Analiz hazır ayarları**: `theme`, `extreme-theme` ve `wordpress-render`, `blockstudio/phpstan` kapsamını blok şablonlarının ötesine taşır.
- **Yönetilen commit kancası**: `blockstudio-githooks sync`, yapılandırılmış hazır ayarı çalıştıran bir pre-commit kancası yazar ve yönetir.
- **Proje sözleşmesi**: `blockstudio-agents`; bir projenin neler ürettiğini, hangi özellikleri etkinleştirdiğini ve hazır ayarının neleri zorunlu kıldığını açıklayan bir `AGENTS.md` dosyası yazar.
- **Dokümantasyon dizini**: Yapay zekâ bağlam dosyası artık her belgenin, amacının ve sahip olduğu tanımlayıcıların dizinidir.
- **Kanonik blok etiketleri**: Bağımsız bir komut, önek ve takma ad kısaltmalarını `<bs:namespace-slug>` biçimine dönüştürür; deneme çalıştırması da yapabilir.
- **Varsayılan olarak uyumluluk**: Yukarıdakilerin hiçbiri, `blockstudio.json` içinde adı belirtilene kadar bir siteyi değiştirmez.

## Projeyi okuma ve oluşturma

### Proje envanteri

`Canvas::inventory()`, proje tarafından kaydedilen her şeyi oluşturma yapmadan tek bir yalın dizi olarak döndürür.

```php
use Blockstudio\Canvas;

$result = Canvas::inventory();

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

Kayıtlar türe göre gruplandırılır: `pages`, `blocks`, `patterns`, `templates`, `parts` ve `ui`. `order`, tüm türlerdeki sabit görüntüleme sırasıdır; `sources` her kaydı kaynak yollarına eşler; `warnings` ve `errors` ise sorunları yapılandırılmış girdiler halinde toplar.

Blok kayıtları `id`, `name`, `title`, `source`, `path`, `provenance` ve oluşturulmaya hazır bir `declaration` taşır. Sayfa kayıtları, sabit kimlik olarak `source` değerini ve sayfayı oluşturan şablon olarak `path` değerini korur.

### Hedefli seçim

Kayıtları adlandırmak, sonradan filtrelemek yerine yapılacak işi en baştan sınırlar.

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

Bu, bir blok ve bir sayfa döndürür. `patterns`, `templates`, `parts` ve `ui` boş döner; bu kayıtların kaynakları okunmaz, eşitlenmez, oluşturulmaz veya derlenmez.

Kurallar nettir:

- Hiç tür anahtarı belirtilmezse her tür yüklenir.
- `true`, `null` veya `"*"` belirtilirse o türdeki her kayıt yüklenir.
- Bir dize veya liste; kimlik, ad, kısa ad, yol ya da kaynak yolu ile tam eşleşir.
- Boş bir dize, boş bir liste veya `false`, o türden hiçbir kayıt yüklemez.
- Herhangi bir tür anahtarı belirtilirse belirtilmeyen türlere dokunulmaz.

Artık var olmayan tanımlayıcılar hata vermek yerine `deleted` altında döner; Canvas REST yenileme uç noktası da `blocks` ve `pages` parametrelerine aynı kuralı uygular.

`Canvas::documents()` aynı seçimi alır ve her kayıt için oluşturulmuş bir belge ekler. Seçilen sayfalar geri yüklenmiş bir ön yüz bağlamında oluşturulur; böylece sorgu koşulları, body sınıfları, kısa kodlar, düzenler, yönlendirmeler ve enqueue geri çağrıları, isteği yapan isteği değil o sayfayı görür.

### Bağımsız oluşturma

`Blockstudio\Render`, ön yüzün kullandığı işlem hattı üzerinden oluşturulmuş HTML değerini bir dize olarak döndürür.

```php
use Blockstudio\Render;

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

Bunun altında dört anahtarlı tek bir bildirim biçimi bulunur: `name`, `attributes`, `content` ve `children`. `root`, `data`, `inner`, `innerBlocks`, `layers` ve `example`, `Render::normalize()` tarafından bu biçime dönüştürülen girdi kolaylıklarıdır.
Alt öğeler özyinelemeli olarak oluşturulur; hatalı girdilerde, sorunlu bloğun adını belirten bir istisna oluşur.

`Render::document()`, çıktıyı eksiksiz ve bağımsız bir HTML belgesine sarar.

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

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

`body` yalnızca blok çıktısıdır; `html` birleştirilmiş belgedir; `blocks` katkıda bulunan blok adlarıdır; `assets` ise işaretlemeyi `head`, `footer`, `styles`, `scripts`, `modules`, `interactivity`, `ui` ve `tailwind` olarak parçalara ayırır.
Varlıklar yalnızca oluşturulan öğelerle sınırlıdır; bu nedenle yalnızca editörde kullanılan varlıklar çıktıda yer almaz.

`Render::document_from_html()`, başka yerde oluşturulmuş HTML öğesini sarar; `Render::content()` ise serileştirilmiş blok içeriğini belge olmadan oluşturur. Tek bir PHP işlemi içinde belgeler arasında `Blockstudio\Batch_Render::reset()` çağrısını yapın; `Canvas::documents()` bunu zaten yapar.

### UI bileşen aileleri

`Blockstudio\Ui`, paketlenmiş UI kütüphanesini iç parçaların listesi yerine her genel bileşen için bir girdiyle sunar.

`Ui::inventory()`, kök bloğu, başlığı ve gereken uygulama bloklarıyla birlikte her aile için bir girdi döndürür. `Ui::examples()`, her aile için belirlenimci bir bildirim ekler: varsayılanlar korunur, gerekli alt katmanlar üst öğelerinin altına yerleştirilir ve boş kalacak alanlara sabit örnek metin eklenir. Bu bildirim kanoniktir ve doğrudan `Render::document()` içine konabilir.

Canvas da aynı şekilde gruplandırır. Paketlenmiş UI, `ui` türünde her aile için bir örnek olarak görünür; uygulama kayıtları `blocks` dışında kalır.

Aileler bir araya getirilmek üzere tasarlanmıştır: bir seçici, liste kutusu tetikleyicinin üstüne yerleşecek şekilde bir iletişim kutusunun içinde açılır; menüler ve birleşik kutular, kaydırmada da değişmeyen sabit görüntü alanı koordinatlarına tutunur; kalıcı pencereler üst üste açılır ve her Escape tuşu basışında birer birer kapanır; her alt bilgi, aynı kapatma denetimini bir varyantla birleştirir. Bu bağlantı noktalarının nasıl çalıştığı ve çalışır kalmalarını sağlayan değişmezler [bileşim bölümünde](https://blockstudio.dev/tr/ui/composition/) açıklanır; [/ui/examples](https://blockstudio.dev/tr/ui/examples/) bileşimleri çalışır halde gösterir.

## Şablon yardımcıları

### Sabit görüntü boyutları

`bs_media_image()`, tema varlıklarını gerçek genişlik ve yükseklikleriyle, ayrıca ayrılmış bir en-boy oranıyla işler; böylece ortam kitaplığının dışındaki görseller artık sayfa düzenini kaydırmaz.

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

Çıktı, `img` taşıyan bir `figure.blockstudio-media` ve bunun çevresindeki satır içi `aspect-ratio` öğesidir; bu öğede gerçek `width`, `height`, `loading` ve `decoding` bulunur. Boyutlar, derleme adımında `Blockstudio\Media_Metadata_Builder` tarafından veya elle yazılan, oluşturulmuş bir `assets/media.json` dosyasından alınır.

`src`, temaya göreli bir yol, mutlak bir yol veya tam bir URL alır; ortam kitaplığı görselleri için `attachmentId` kullanılır. `eager`, sayfanın üst kısmında geç yüklemeyi devre dışı bırakır; `sources` ise bir `<picture>` çıktılar.

`performance.media.lazy` etkin olduğunda gerçek URL, doğru boyutlandırılmış bir yer tutucunun arkasındaki `data-src` konumuna taşınır.

### Tailwind sınıf yardımcıları

`bs_tw_merge()` ve `bs_tw_variants()`, PHP şablonlarında Tailwind sınıflarını birleştirir; bunun için Blockstudio tarafından zaten paketlenmiş motoru kullanır.

`bs_tw_merge('px-2 text-sm', 'px-4')`, `text-sm px-4` değerini döndürür: çakışan `px-2` kaldırılır ve sonraki değer kazanır. İç içe geçmiş sınıf değerleri dizileri kabul edilir.

`bs_tw_variants()`, bileşen varyantları için çağrılabilir küçük bir işlev döndürür:

```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']);
```

Bu, `inline-flex items-center h-12 px-6 rounded` çıktısını verir. Temel sınıflar, varyantlar, varsayılan varyantlar, birleşik varyantlar ve her çağrıya özel bir `class` veya `className` desteklenir.

## Üretim yapılandırması

### Performans profilleri

`performance.profile`, üretim ön yüzü varsayılanlarını tek bir yerden etkinleştirir.

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

Varsayılan değer olan `compat` hiçbir şeyi değiştirmez. `speed` ve `strict` aynı kümeyi etkinleştirir: head bölümünden generator, emoji, feed, discovery ve bitişik gönderi çıktıları kaldırılır; oEmbed discovery ve host betikleri çıkarılır; XML-RPC, pingback'ler ve uzak editör keşfi devre dışı bırakılır; genel core ön yüz varlıkları kaldırılır; görsel çıktısı varsayılanları uygulanır; Heartbeat editörlerin dışında yavaşlatılır; aynı kaynaktan belgeler üzerine gelme veya odaklanma niyetiyle önceden getirilir ve Blockstudio görsel yükleyicisi kullanılır.

Her alt değer, yukarıdaki `preload.links` gibi profili geçersiz kılar. Core ön yüz varlıklarını kaldırmayı önce test edin; çünkü bunlara bağlı bir sayfa görünür biçimde bozulur. `Runtime_Settings::current()` çözümlenen profili gösterir.

`themeDefaults`, temaların aksi halde elle oluşturacağı iki şeyi kapsar: `titleTag` ve etkin alt temayı ve üst temayı güncelleme sonuçlarından gizlemek için `suppressDirectoryUpdates`.

### Türlenmiş ayarlara erişim

`Blockstudio\Settings`, JSON içinde ne varsa onu döndürmek yerine yapılandırmayı gerçek türlerle okur.

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

Bozuk JSON, varsayılanlara çözümlenmek yerine `Settings::errors()` üzerinden bildirilir. `Settings::get_raw()` yalnızca etkin kaynağın bildirdiği değerleri döndürür; bu sayede `false` olarak ayarlanmış bir değerle hiç ayarlanmamış bir değer birbirinden ayrılır.

`Settings::fingerprint()`, etkin ayarlar için sabit bir kimlik döndürür; `blockstudio.json` değiştiğinde erişim ayarları yeniden yükler.

### Tek önbellek dizini

Oluşturulan tüm dosyalar artık varsayılanı `wp-content/blockstudio/cache` olan `cache.path` dizininin altında bulunur.

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

Derleme yükleri, blok kayıt verileri, editör varlıkları, derlenmiş Tailwind CSS, oluşturma belgeleri, ada parçaları, statik HTML, grafik dizinleri, ısıtma kuyrukları ve tanılama verilerinin tümü bu kök dizinin altında bulunur. Göreli bir yol `WP_CONTENT_DIR` konumundan çözümlenir; mutlak bir yol ise verileri özel bir birime yönlendirir.

Nesneler önce geçerli ağ ve site altında, ardından çalışma zamanı kimliğine göre kaydedilir: bu kimlik; Blockstudio, WordPress ve PHP sürümlerinin parmak izini, etkin ayarları, etkin temayı ve eklentileri, keşif kaynaklarını ve ilgili kaynak dosyalarını içerir. Bir girdi değiştiğinde etkilenen nesneler yenileriyle değiştirilir; eskiler temizlenir.

Soğuk derlemeler tek uçuşludur: bir istek derlemeyi yapıp sonucu atomik olarak yayımlar, diğerleri ise bekler. Yenileme başarısız olursa hata görünür kalırken son sağlam nesne sunulmaya devam eder; `Blockstudio\Runtime_Cache::purge('tailwind')` ise tek bir kapsamı temizler.

## Statik önceden oluşturma

Statik önceden oluşturma, anonim HTML belgelerinin tamamını önbelleğe alır ve bunları WordPress başlatılmadan önce sunabilir. Varsayılan olarak kapalıdır.

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

### Uygunluk

Yalnızca anonim HTML belgelerinin tamamı uygundur. GET dışındaki istekler, sorgu dizeleri, yönetim sayfaları, REST, Ajax, cron, feed'ler, arama, önizlemeler, nonce içeren istekler, kişiselleştirilmiş çerezler ve `dynamicPaths` altındaki tüm yollar kapsam dışı bırakılır.
Bir yanıt, `<!-- blockstudio:no-cache -->` işaretleyicisiyle özelliği tamamen devre dışı bırakabilir.

Yol eşleştirme sınırları dikkate alır; bu nedenle `/account`, `/account/orders` yolunu kapsar ancak `/accounting` yolunu kapsamaz.

### İmza ve grafik modları

`invalidate`, girdilerin nasıl sona ereceğini belirler. Varsayılan `signature` modu, anonim bir önbellek kaçırmasında kimliğe göre anahtarlanan bir yanıtı doldurur ve site düzeyindeki değişikliklerden sonra kimliği yeniler; sıradan bir site için uygundur.

`graph` modu, açık derleme ve dağıtım araçları içindir. Her sayfanın kendi kaynak bağımlılıklarını kaydeder; böylece bir plan yalnızca etkilenen URL'leri yeniden oluşturur.

```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']));
```

### Erken sunum

`earlyServe` etkin olduğunda Blockstudio, site başına küçük bir rota haritasını ve uygun bir önbellek isabetini WordPress, eklentiler veya tema başlatılmadan önce akış olarak sunan bir `advanced-cache.php` drop-in'ini yönetir.

Hiçbir zaman başka bir tarafa ait haritanın, drop-in'in veya `WP_CACHE` bildiriminin üzerine yazmaz. Bir grafik yapıtı, harita değiştirilmeden önce başvurulan her HTML dosyasını doğrular; böylece yarım kalmış bir dağıtımda önceki grafik etkin kalır. Multisite girdileri ana makineye, ana yola ve site kimliğine göre birbirinden ayrı tutulur.

### Isıtma ve durum

Günlük kullanımı üç WP-CLI komutu kapsar:

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

`status`; etkin kimliği, dosya ve bayt sayılarını, grafik kayıtlarını, kuyruk durumunu ve kapsam başına isabet, kaçırma, derleme ve hata sayaçlarını bildirir.

## Analiz ve aracı araçları

### Analiz hazır ayarları

`blockstudio/phpstan`, blok analizinin üzerine üç katman ve projenin seçtiği katmanı çalıştıran bir komut ekler.

| Hazır ayar | Ekledikleri |
| --- | --- |
| `base` | Mevcut şema, şablon, kanca, ayar ve API analizi. |
| `theme` | Tema kökleri, stil başlıkları, varlıklar, seçici kapsamı, alan varsayılanları ve yineleyici sınırları. |
| `extreme-theme` | PHPStan `max`, güvenli olmayan PHP, kaçışlama, Tailwind, JavaScript ve Interactivity denetimleri. |
| `wordpress-render` | `extreme-theme` üzerine çağıranın sağladığı canlı oluşturma yoklaması. |

Varsayılanlar `blockstudio.json` kaynağından gelir; böylece etkileşimli çalıştırmalar, CI ve commit kancaları aynı yapılandırmayı paylaşır:

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

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

Çıkış kodları başarılı durumda `0`, tanılamalar için `1` ve geçersiz kullanım için `2` değeridir. Sarmalayıcı, yapılandırmasını sistemin geçici dizininde oluşturduğundan projeye oluşturulmuş bir yapılandırma, temel çizgi veya önbellek bırakmaz; ayrıca PHPStan bellek sınırını `1G` değerine yükseltir.

Ayrıca bir BC Math sağlayıcısını da paketler; böylece JavaScript denetimleri artık `ext-bcmath` gerektirmez.

### Yönetilen commit kancası

Tek bir ayar ve tek bir komut, yapılandırılmış hazır ayarı commit koşuluna dönüştürür.

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

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

Eşitleme, kancayı ve sahiplik kaydını Git ortak dizinine yazar, `core.hooksPath` yolunu yönetilen dizine yönlendirir ve önceden yapılandırılmış pre-commit kancasını zincire ekler. Kanca, commit sırasında depo ve proje kökünü çözümler; böylece bağlantılı çalışma kopyaları ve boşluk içeren yollar sorunsuz çalışır.

Kanca yalnızca `vendor/bin/blockstudio-phpstan` komutunu çalıştırır; dosyaları hiçbir zaman biçimlendirmez veya yeniden yazmaz. `commit` değerini `false` olarak ayarlayıp yeniden eşitlemek veya `blockstudio-githooks remove` komutunu çalıştırmak, kayıtlı kanca yolunu geri yükler ve yalnızca Blockstudio tarafından yönetilen dosyaları siler.

### Proje sözleşmesi

`blockstudio-agents`; blokların nerede bulunduğunu, bu projede sayfanın ne olduğunu, hangi özelliklerin etkinleştirildiğini ve analiz aracının neleri reddedeceğini belirten bir `AGENTS.md` yazar.

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

Belge şablondan değil, proje yapısından türetilir. `style.css` başlığı, blokları ve dosya tabanlı sayfaları olan bir tema; yalnızca blok kaydeden bir eklentiden farklı bir sözleşme alır. Sözleşme, tarayıcının bulduğu sayıları, dizinleri, ad alanlarını ve şablon dillerini içerir. Hangi özelliklerin görüneceğini `blockstudio.json` belirler; dolayısıyla statik önceden oluşturma kullanmayan bir projede bundan hiç söz edilmez.

Doğruluk bölümü, seçilen hazır ayarın kendi kural dosyalarından katman katman okunur; bu nedenle yeni bir kural eklenen hazır ayar, oluşturulan her sözleşmeyi değiştirir.

Sahiplik, commit kancasındaki gibi işler. Oluşturulmuş işaretleyicisi olmayan bir dosya, `--force` aksini belirtmedikçe değiştirilmek yerine reddedilir; sondaki notlar bölgesi yeniden oluşturma sırasında korunur; sözleşme güncel değilse `--check`, `1` koduyla çıkar; `--stdout` ise dosya sistemine dokunmadan sözleşmeyi yazdırır.

### Dokümantasyon dizini

`blockstudio-llm.txt` artık birleştirilmiş bir metin değil, bir dizindir. Yayımlanan her belge; bölüm ve alt bölümünde, rotası, kaynak dosyası, tek satırlık amacı ve sahip olduğu tanımlayıcılarla birlikte bir kez yer alır: ayar yolları, kanca adları, PHP işlevleri ve sınıfları ile komutlar.

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

Bir aracı, dizini okur, ilgilendiği tanımlayıcıya sahip tek belgeyi bulur ve o belgeyi açar. Önceki yarım megabaytlık birleştirilmiş dosya hâlâ `/blockstudio-llm-full.txt` adresinde oluşturulup yayımlanıyor; artık kullanıcılara verilen ilk şey değil.

## Kanonik blok etiketleri

Tek başına çalışan bir komut, önek ve takma ad kısaltmalarını kanonik `<bs:namespace-slug>` yazımına dönüştürür; bu yazım gerçek blok adını kaydeder ve proje filtresi yüklenmeden de çözümlenir.

`brand` öneki `theme-components` üzerinde ve `ui` öneki `bsui` üzerinde olduğunda, bu kısaltma:

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

şununla aynı anlama gelir:

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

Önekler ve tam takma adlar hâlâ çalışır ve kullanımdan kaldırılmamıştır. Komut WordPress yüklemez ve `--apply` olmadan hiçbir şey yazmaz:

```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` her öneki ad alanlarıyla eşleştirir ve `--known-blocks` kayıtlı blok adlarını listeler. Rapor; eski adlardan kanonik adlara eşlemeleri, kullanım sayılarını, dosya başına özetleri ve bilinmeyen etiketler, belirsiz takma adlar ile dinamik etiketler için ayrı listeleri kaydeder. Bunlardan herhangi biri kaldığında `--apply` yazmayı reddeder; bunu aşmak için `--allow-unresolved` seçeneği gerekir.

PHP dizelerindeki gerçek etiketler de dâhil olmak üzere eşleştirilmiş, iç içe ve kendi kendini kapatan işaretlemeler işlenir. Yalnızca etiket adları değiştirilir; ikinci çalıştırma değişiklik yapmaz. Yorumlardaki, kod bloklarındaki, `<pre>` veya `<code>` içindeki örnekler yalnızca raporlanır.

## Varsayılan davranış

7.6'yı yüklemek tek başına hiçbir şeyi değiştirmez.

**Performans profili varsayılan olarak `compat` olur.** Head çıktısı, oEmbed, XML-RPC, Heartbeat, görsel varsayılanları, bağlantı ön yüklemesi, tembel yükleme ve ön uç `<title>`, WordPress ile temanın belirlediği şekilde kalır.

**Etkinleştirilmedikçe bunlar kapalı kalır:** her `performance.staticPrerender`, `performance.measurement`, `performance.media` ve `themeDefaults` anahtarı ile `githooks.commit`, `dev.canvas.enabled`, `ui.enabled`, `tailwind.enabled` ve `blockTags.enabled`. Devre dışıyken statik ön oluşturma hiçbir dosya yazmaz ve ek bir bileşen yüklemez.

**Canvas ve Render pasiftir.** Mevcut kayıtları okur ve yalnızca çağıranın istediği içeriği işler; hiçbiri ön uç çıktısına kanca eklemez veya rota kaydetmez. Canvas yönetici ekranı için hâlâ `dev.canvas.enabled` ve `edit_posts` gerekir.

**Daha sıkı analiz için açıkça adlandırma gerekir.** `blockstudio/phpstan` yüklemek yalnızca temel uzantıyı etkinleştirir ve proje bir ön ayar belirtmediği sürece kanonik komut `base` çalıştırır.

**Oluşturulan dosyalar için ilgili komutun çalıştırılması gerekir.** `githooks.commit`, `blockstudio-githooks sync` çalışana kadar hiçbir şey yapmaz; `AGENTS.md` de `blockstudio-agents` çalışana kadar işlem yapmaz.

## 7.5'ten yükseltme

Gereksinimler değişmedi: PHP 8.2 veya üzeri, WordPress 6.7 veya üzeri.

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

**Önbellekler bir kez yeniden oluşturulur.** Çalışma zamanı kimliği Blockstudio sürümünü içerir; bu nedenle yükseltmeden sonraki ilk istek soğuk başlar ve eski nesneler temizlenir. `wp-content/uploads/blockstudio/tailwind/cache` altındaki eski Tailwind önbelleği silinebilir; bunu glob ile arayan bir kod parçacığı bunun yerine `Blockstudio\Runtime_Cache::purge('tailwind')` çağırmalıdır.

7.6 öncesindeki düz `wp-content/blockstudio/cache/runtime` dizini etkin yolun dışına otomatik olarak taşınır ve sınırlı WP-Cron geçişleriyle kaldırılır. Bu nedenle büyük eski kilit dosyası ağaçlarının dağıtım isteği sırasında silinmesi gerekmez.

**Oluşturulan dosyaların sahipleri bellidir.** `assets/media.json` sürüm kontrolünde veya derleme adımında yer almalıdır. Rota eşlemesi, `advanced-cache.php` ek bileşeni ve `WP_CACHE` bildirimi yalnızca `earlyServe` etkin olduğunda, commit öncesi kanca ise yalnızca eşitlenmişken bulunur. Oluşturulan diğer her şey `cache.path` altında yer alır ve güvenle silinebilir.

**Hiçbir şey kaldırılmadı veya yeniden adlandırılmadı.** `bs_render_block()`, `bs_block()`, `Blockstudio\Pages` ve `Blockstudio\Patterns` kanonik, dosya tabanlı içerik yüzeyleri olmaya devam eder.

**Geri alma özellik bazında yapılır.** `performance.profile` yeniden `compat` sürümüne, `staticPrerender.enabled` yeniden `false` sürümüne, `githooks.commit` yeniden `false` sürümüne ve bir `sync` ile `cache.enabled` yeniden `false` sürümüne alınarak her biri bir katman geri alınır.

Uygulamaya başlamak için makul bir sıra:

1. `performance.profile` değerini `speed` olarak ayarlayın; ardından head çıktısını, akışları ve oEmbed veya XML-RPC kullanan eklentileri kontrol edin.
2. `assets/media.json` oluşturun, şablonları `bs_media_image()` konumuna taşıyın, ardından `performance.media.lazy` özelliğini etkinleştirin.
3. `earlyServe` kapalıyken `performance.staticPrerender` özelliğini etkinleştirin, istekleri `wp bs prerender status` ile doğrulayın, ardından `earlyServe` özelliğini açın.
4. Herhangi bir ön ayarı `githooks.commit` arkasına almadan önce `blockstudio-phpstan --preset theme` temiz sonuç verene kadar çalıştırın.

## Ayrıntılar nerede bulunur

- [Canvas](https://blockstudio.dev/tr/docs/dev/canvas/) ve [envanteri ile belge API](https://blockstudio.dev/tr/docs/dev/canvas/#public-inventory-and-document-api)
- [İşleme](https://blockstudio.dev/tr/docs/blocks/rendering/#structured-compositions-and-complete-documents), [UI Bileşenleri](https://blockstudio.dev/tr/ui/#public-inventory-and-examples) ve [UI Bileşimi](https://blockstudio.dev/tr/ui/composition/)
- [Ayarlar](https://blockstudio.dev/tr/docs/general/settings/) ve [performans](https://blockstudio.dev/tr/docs/general/settings/#performance)
- [Performans](https://blockstudio.dev/tr/docs/production/performance/), [Önbelleğe alma](https://blockstudio.dev/tr/docs/production/caching/) ve [Statik Ön Oluşturma](https://blockstudio.dev/tr/docs/production/static-prerendering/)
- [Tailwind CSS](https://blockstudio.dev/tr/docs/tailwind/#template-composition-helpers)
- [PHPStan](https://blockstudio.dev/tr/docs/dev/phpstan/): [ön ayarlar](https://blockstudio.dev/tr/docs/dev/phpstan/#analysis-presets), [kanonik komut](https://blockstudio.dev/tr/docs/dev/phpstan/#canonical-command), [yönetilen commit kancası](https://blockstudio.dev/tr/docs/dev/phpstan/#managed-commit-hook) ve [proje sözleşmesi](https://blockstudio.dev/tr/docs/dev/phpstan/#project-contract-for-coding-agents)
- [Yapay Zekâ Entegrasyonu](https://blockstudio.dev/tr/docs/dev/ai/): dokümantasyon dizini ve tam metin
- [Geçiş](https://blockstudio.dev/tr/docs/dev/migration/v7/#canonical-block-tags) ve [PHP Kancaları](https://blockstudio.dev/tr/docs/blocks/hooks/php/)
