
Blockstudio 7.6 võimaldab projekti lugeda ja renderdada PHP abil ning viib kasutajaliidese tootmiskeskkonna vaikeväärtused üle `blockstudio.json`-i: inventar API, eraldiseisev renderdamine, meedia ja Tailwind malliabid, jõudlusprofiilid, üks vahemälukaust, staatiline eeljrenderdus varajase teenindamisega, rangemad analüüsieelistused ja loodud projektitööriistad koodiagentidele.

Suurema osa väljalaskest kannavad kaks kutset. `Canvas::inventory()` tagastab kõik registreeritud lehed, plokid, mustrid, Site Editori mallid, malliosad ja komplekteeritud UI näited. `Render::document()` tagastab neist igaühe jaoks valmis HTML koos täpselt nende varadega, mida renderdus kasutas.

> **7.6.2 uuendus:** failipõhiseid lehti ei kooskõlastata enam tavaliste WordPress päringute käigus. Allikamuudatuste rakendamiseks käivitage `wp bs pages sync` või kutsuge `Blockstudio\Pages::reconcile()`. Kogumite marsruutimine ja `templateFor` vaikeväärtused kasutavad salvestatud käitusaja konfiguratsiooni ning selgesõnaline kooskõlastamine väldib varasemat suurt mitmekeelset OR-meta päringut. Lühiajaline suvand `themeDefaults.syncPagesInDevelopment` on eemaldatud, sest lehti ei sünkroonita enam päringukonksudest. `Pages::init()` toimib nüüd ainult alglaadimisel; integratsioonid, mis edastasid väärtuse `force`, peavad kasutama väärtust `Pages::reconcile()` või CLI. Canvase avamine käivitab endiselt autori inventari jaoks ühe autentitud ja selgesõnalise kooskõlastamise.

> **7.6.12 uuendus:** Redaktori stiilitabelid lisatakse nüüd prefiksiga ühe
> ümberkirjutamise läbimisega, mitte iga vara eraldi SASS-i kompileerimisega, nii et
> paljude plokkidega saidi redaktori külmkäivitus ei ohusta enam mõõduka mälupiiri
> ületamist. Vahemällu salvestatud eeltöödeldud leht, mille sisu räsi sisaldava Tailwind stiilitabel on
> eemaldatud, renderdatakse uuesti, mitte ei väljastata stiilideta; see toimib nii PHP vahemälu
> kui ka Early Serve'i drop-in'i kaudu. Tipptasemele kirjutatud plokiatribuute
> loetakse renderdamisel, mitte ei jäeta kõrvale, seega skeemi Blockstudio
> registreeringut `WP_Block_Type`-is arvestatakse programmipõhiste kirjutajate puhul.

> **7.6.11 uuendus:** Graafi artefaktide paigaldamisel asendatakse marsruudi
> dokument aatomiliselt, kui poe koopia sama võtme all muutus; identsed dokumendid
> jäetakse puutumata ning edendatud, asendatud, vahele jäetud ja alles hoitud
> marsruutidest antakse teada `Static_Prerender_Early_Serve::last_promotion()` kaudu.

> **7.6.10 uuendus:** Käitusaja vahemälupäringud tuvastavad nüüd eemaldatud kompileeritud varad ka
> jälgimise viiteaja jooksul ning varasemad kui 7.6 lamedad käitusaja vahemälud paigutatakse aatomiliselt karantiini ja kustutatakse piiratud cron partiidena. Komplekteeritud UI globaalsed muutujad väljastatakse lehe kohta üks kord. Graafirežiimi Early Serve saab identiteedivahemälust edastada reaalajas renderdatud marsruute, mis pole juurutatud marsruudikaardil. Tailwind saab soovi korral väljastada sisuräsi sisaldava vahemälufaili koos `tailwind.output: "link"`-ga; vaikimisi väljastatakse sisu reas.

Lühidalt:

- **Projekti loend**: `Canvas::inventory()` tagastab kõik registreeritud kirjed koos nende allikate ja püsiva kuvamisjärjestusega.
- **Sihitud valik**: plokkide ja lehtede nimetamine piirab avastamise, sünkroonimise, renderdamise ja kompileerimise nende kirjetega.
- **Eraldiseisev renderdamine**: `Blockstudio\Render` tagastab valmis HTML-e ploki, kompositsiooni või tervikliku dokumendi jaoks.
- **UI komponendipered**: `Blockstudio\Ui` rühmitab komplekteeritud teegi üheks avalikuks pereks komponendi kohta ja lisab igaühe juurde näite.
- **Püsivad pildimõõtmed**: `bs_media_image()` renderdab teema varad tegelike mõõtmetega, mis pärinevad loodud failist `assets/media.json`.
- **Tailwind klassiabitööriistad**: `bs_tw_merge()` ja `bs_tw_variants()` koostavad klassid keeles PHP, liites need konfliktiteadlikult.
- **Jõudlusprofiilid**: `performance.profile` lülitab tootmise kasutajaliidese vaikeväärtused korraga sisse; alamelemendi väärtused kirjutavad profiili omad üle.
- **Tüübistatud seadete juurdepääs**: `Settings::get_bool()` ja selle kaasfunktsioonid loevad `blockstudio.json` tegelike tüüpidega ning toovad esile parsimisvead.
- **Üks vahemälukataloog**: kõik loodud failid asuvad `cache.path` all ja on seotud käitusaja identiteediga.
- **Staatiline eeltöötlus**: anonüümseid HTML saab vahemällu salvestada, sõltuvusgraafi kaudu kehtetuks muuta ning edastada enne WordPress käivitumist.
- **Analüüsi eelseadistused**: `theme`, `extreme-theme` ja `wordpress-render` laiendavad `blockstudio/phpstan` võimalusi plokimallidest kaugemale.
- **Hallatud sissekandekonks**: `blockstudio-githooks sync` loob sissekandmiseelse konksu ja haldab seda; konks käivitab seadistatud eelseadistuse.
- **Projekti leping**: `blockstudio-agents` loob faili `AGENTS.md`, mis kirjeldab, mida projekti autorid loovad, millised funktsioonid on lubatud ja mida eelseadistus nõuab.
- **Dokumentatsiooni register**: tehisintellekti kontekstifail sisaldab nüüd kõigi dokumentide registrit, nende eesmärke ja neile kuuluvaid tunnuseid.
- **Kanoonilised plokisildid**: eraldiseisev käsk asendab prefiksi- ja aliasekujud nimega `<bs:namespace-slug>`; saadaval on ka kuivkäivitus.
- **Ühilduvus vaikimisi**: ükski ülaltoodust ei muuda saiti enne, kui see on nimetatud failis `blockstudio.json`.

## Projekti lugemine ja renderdamine

### Projekti loend

`Canvas::inventory()` tagastab lihtsa massiivina kõik, mida projekt registreerib, ilma midagi renderdamata.

```php
use Blockstudio\Canvas;

$result = Canvas::inventory();

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

Kirjed on rühmitatud tüübi järgi: `pages`, `blocks`, `patterns`, `templates`,
`parts` ja `ui`. `order` määrab kõigi tüüpide püsiva kuvamisjärjestuse,
`sources` seostab iga kirje lähtefailide radadega ning `warnings` ja `errors`
koondavad probleemid struktureeritud kirjeteks.

Plokikirjed sisaldavad `id`, `name`, `title`, `source`, `path`, `provenance` ja
valmis renderdamiseks mõeldud `declaration`-e. Lehekirjete püsivaks tunnuseks jääb
`source` ning renderdavaks malliks `path`.

### Sihitud valik

Kirjete nimetamine piirab tööd, selle asemel et tulemusi hiljem filtreerida.

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

See tagastab ühe ploki ja ühe lehe. `patterns`, `templates`, `parts` ja `ui`
tagastatakse tühjana ning nende allikaid ei loeta, sünkroonita, renderdata ega
kompileerita.

Reeglid on täpsed:

- Kui ühtegi tüübi võtit pole, laaditakse kõik tüübid.
- `true`, `null` või `"*"` laadib kõik seda tüüpi kirjed.
- String või loend leiab täpse vaste ID, nime, slugi, raja või lähteraja järgi.
- Tühi string, tühi loend või `false` ei laadi seda tüüpi kirjeid.
- Kui olemas on vähemalt üks tüübi võti, jäävad väljajäetud tüübid puutumata.

Tunnused, mida enam ei eksisteeri, tagastatakse vea asemel jaotises `deleted`,
ning Canvas REST värskendusotspunkt rakendab sama reeglit oma parameetritele `blocks` ja
`pages`.

`Canvas::documents()` kasutab sama valikut ja lisab iga kirje juurde ühe renderdatud dokumendi.
Valitud lehed renderdatakse taastatud kasutajaliidese kontekstis, nii et päringu
 tingimused, body-klassid, lühikoodid, paigutused, ümbersuunamised ja laadimise
 tagasikutsed käsitlevad seda lehte, mitte päringut, millega seda küsiti.

### Eraldiseisev renderdamine

`Blockstudio\Render` tagastab renderdatud HTML-e stringina, kasutades sama
konveierit nagu kasutajaliides.

```php
use Blockstudio\Render;

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

Aluseks on üks deklaratsiooni kuju nelja võtmega: `name`, `attributes`,
`content` ja `children`. `root`, `data`, `inner`, `innerBlocks`, `layers` ja
`example` on mugavad sisendkujud, mille `Render::normalize()` sellesse koondab.
Alamelemendid renderdatakse rekursiivselt ning vigase sisendi korral visatakse
viga, milles nimetatakse probleemset plokki.

`Render::document()` ümbritseb väljundi tervikliku eraldiseisva HTML dokumendiga.

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

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

`body` on ainult ploki väljund, `html` koostatud dokument, `blocks`
sisendi andnud plokkide nimed ning `assets` jagab märgenduse osadeks: `head`,
`footer`, `styles`, `scripts`, `modules`, `interactivity`, `ui` ja `tailwind`.
Varad piirduvad renderdatud sisuga, nii et redaktori varasid ei lisata.

`Render::document_from_html()` ümbritseb mujal renderdatud HTML-e ja
`Render::content()` renderdab serialiseeritud plokisisu ilma dokumendita. Kutsu
`Blockstudio\Batch_Render::reset()` välja ühe PHP protsessi dokumentide vahel;
`Canvas::documents()` teeb seda juba.

### UI komponendipered

`Blockstudio\Ui` esitab komplekteeritud teegi UI ühe kirjena avaliku
komponendi kohta, mitte sisemiste osade loendina.

`Ui::inventory()` tagastab iga pere kohta ühe kirje koos juurploki, pealkirja ja vajalike
teostusplokkidega. `Ui::examples()` lisab iga pere kohta deterministliku deklaratsiooni: vaikeväärtused säilivad, nõutavad alamkihid pesastatakse vanemelemendi alla ning tühjade väljade asemel kasutatakse püsivat näiteteksti. See deklaratsioon on kanooniline ja sobib otse `Render::document()`-i.

Canvas rühmitab samamoodi. Komplekti UI kuvatakse tüübi `ui` all ühe näitena pere kohta ning teostuse registreeringuid `blocks`-is ei kuvata.

Pered on loodud kokkupanekuks: valik avaneb dialoogis ja selle loendikast katab päästiku; menüüd ja liitkastid kinnituvad fikseeritud vaateava koordinaatidele, mis säilivad kerimisel; modaalaknad kuhjuvad ja sulguvad ükshaaval Escape-klahviga; iga jalus ühendab sama sulgemisnupu variandiga. Nende ühenduskohtade toimimist ja seda tagavaid muutumatuid tingimusi käsitleb [kompositsiooni peatükk](https://blockstudio.dev/et/ui/composition/); [/ui/examples](https://blockstudio.dev/et/ui/examples/) näitab kompositsioone töötavana.

## Malli abitööriistad

### Püsivad pildimõõtmed

`bs_media_image()` renderdab teema varad tegeliku laiuse ja kõrgusega ning reserveeritud
kuvasuhtega, nii et väljaspool meediateeki olevad pildid ei nihuta enam paigutust.

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

Väljund on `figure.blockstudio-media`, mille ümber on reas `aspect-ratio` ning mille
`img` sisaldab tegelikke väärtusi `width`, `height`, `loading` ja `decoding`. Mõõtmed
pärinevad loodud failist `assets/media.json`, mille kirjutab ehitussammus `Blockstudio\Media_Metadata_Builder` või mis luuakse käsitsi.

`src` võtab teema suhtelise raja, absoluutse raja või täieliku URL-i; meediateegi pilte käsitleb `attachmentId`. `eager` lülitab laiska laadimise välja lehe ülaosas ning `sources` väljastab `<picture>`.

Kui `performance.media.lazy` on sisse lülitatud, liigub tegelik URL taustal asukohta `data-src` ning selle ees on õigete mõõtmetega kohatäide.

### Tailwind klassiabitööriistad

`bs_tw_merge()` ja `bs_tw_variants()` koostavad klasse mallides Tailwind keeles PHP, kasutades mootorit, mille Blockstudio juba komplekti lisab.

`bs_tw_merge('px-2 text-sm', 'px-4')` tagastab `text-sm px-4`: konfliktne
`px-2` jäetakse välja ja hilisem väärtus jääb kehtima. Toetatud on ka pesastatud klassiväärtuste massiivid.

`bs_tw_variants()` tagastab komponendivariantide jaoks väikese väljakutsutava funktsiooni:

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

See väljastab `inline-flex items-center h-12 px-6 rounded`. Toetatud on baasklassid,
variandid, vaikevariandid, liitvariandid ning päringupõhine `class` või
`className`.

## Tootmise konfiguratsioon

### Jõudlusprofiilid

`performance.profile` lülitab tootmise kasutajaliidese vaikeväärtused ühest kohast sisse.

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

`compat` on vaikevalik ega muuda midagi. `speed` ja `strict` lubavad
sisse sama komplekti: generaator, emotikonid, voog, avastamine ja seotud postitused eemaldatakse päisest; oEmbedi avastamine ja hosti skriptid jäetakse välja; XML–RPC, pingbackid ja redaktori kaugavastamine lülitatakse välja; üldised tuuma kasutajaliidese varad eemaldatakse; rakendatakse pildi väljundi vaikeväärtusi; Heartbeat'i piiratakse väljaspool redaktoreid; sama päritoluga dokumendid eellaaditakse hõljutamisel või fookuse kavatsuse korral; ning kasutatakse Blockstudio pildilaadijat.

Iga alamväärtus kirjutab profiili üle, nagu ülal teeb `preload.links`. Tuuma kasutajaliidese varade eemaldamist tasub esimesena katsetada, sest neist sõltuv leht läheb nähtavalt katki. `Runtime_Settings::current()` näitab lahendatud profiili.

`themeDefaults` katab kaks ülesannet, mida teemad muidu käsitsi lahendavad: `titleTag` ning `suppressDirectoryUpdates`, et aktiivne alam- ja emateema värskendustulemustest peita.

### Tüübistatud seadete juurdepääs

`Blockstudio\Settings` loeb konfiguratsiooni tegelike tüüpidega, selle asemel et tagastada
JSON-is leiduvat suvalist väärtust.

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

Vigast JSON-i kohta antakse teada `Settings::errors()` kaudu, selle asemel et kasutada vaikeväärtusi. `Settings::get_raw()` tagastab ainult aktiivse allika deklareeritud väärtused,
mis võimaldab eristada väärtuseks määratud `false`-i väärtusest, mida pole kunagi määratud.

`Settings::fingerprint()` tagastab tõhusa seadistuse püsiva identiteedi,
ja juurdepääs laetakse uuesti, kui `blockstudio.json` muutub.

### Üks vahemälukataloog

Kõik loodud failid asuvad nüüd `cache.path` all, mille vaikeväärtus on
`wp-content/blockstudio/cache`.

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

Ehituse kasulikud andmed, plokkide registreerimisandmed, redaktori varad, kompileeritud Tailwind CSS,
renderdamisdokumendid, saarekesefragmendid, staatilised HTML-id, graafide indeksid, soojendamisjärjekorrad ja diagnostika asuvad kõik selle juure all. Suhteline rada lahendatakse alates asukohast `WP_CONTENT_DIR`; absoluutse rajaga saab määrata eraldi köite.

Objektid talletatakse praeguse võrgu ja saidi alla ning seejärel käitusaja identiteedi järgi: see on sõrmejälg versioonidest Blockstudio, WordPress ja PHP, tõhusatest seadetest, aktiivsest teemast ja pluginatest, avastusallikatest ning kaasatud lähtefailidest. Sisendi muutmisel luuakse mõjutatud objektidest uued versioonid ja vanad kärbitakse.

Külmkäivituse ehitused toimuvad ühe päringu kaupa: üks päring ehitab ja avaldab tulemuse aatomiliselt, teised ootavad. Ebaõnnestunud värskenduse korral edastatakse edasi viimane hea objekt, samal ajal kui tõrge jääb nähtavaks, ning
`Blockstudio\Runtime_Cache::purge('tailwind')` tühjendab ühe ulatuse.

## Staatiline eeltöötlus

Staatiline eeltöötlus salvestab vahemällu terviklikud anonüümsed HTML dokumendid ja saab neid edastada enne WordPress käivitumist. Vaikimisi on see välja lülitatud.

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

### Sobivus

Sobivad ainult terviklikud anonüümsed HTML dokumendid. Vahele jäetakse GET-ist erinevad päringud, päringustringid, halduslehed, REST, Ajax, cron, vood, otsing, eelvaated, nonce'i sisaldavad päringud, isikupärastatud küpsised ja kõik rajad `dynamicPaths` all.
Vastus saab sellest täielikult loobuda markeriga `<!-- blockstudio:no-cache -->`.

Rajavaste järgib piire, nii et `/account` hõlmab rada `/account/orders`, kuid
mitte rada `/accounting`.

### Allkirja- ja graafirežiimid

`invalidate` määrab kirjete aegumise. Vaikimisi kasutatav režiim `signature` täidab anonüümse vahemälupäringu korral identiteedipõhise vastuse ning vahetab selle saidi tasemel muudatuste järel välja; see sobib tavalisele saidile.

Režiim `graph` on mõeldud selgesõnaliste ehitus- ja juurutustööriistade jaoks. See salvestab iga lehe enda lähtefailide sõltuvused, nii et plaan koostab uuesti ainult mõjutatud URL-id.

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

### Varajane edastamine

Kui `earlyServe` on sisse lülitatud, haldab Blockstudio väikest saidipõhist marsruudikaarti ja `advanced-cache.php` drop-in'i, mis edastab sobiva vahemälutulemuse enne kui WordPress, pluginad või teema käivituvad.

See ei kirjuta kunagi üle võõrast kaarti, drop-in'i ega `WP_CACHE` deklaratsiooni. Graafi artefakt kontrollib kõiki viidatud HTML faile enne kaardi vahetamist, nii et pooleliolev juurutus jätab eelmise graafi aktiivseks. Mitme saidiga keskkonnas eraldatakse kirjed hosti, kodutee ja saidi ID järgi.

### Soojendamine ja olek

Igapäevaseks kasutuseks on kolm WP-CLI käsku:

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

`status` esitab aktiivse identiteedi, failide ja baitide arvu, graafikirjed, järjekorra oleku ning iga ulatuse tabamuste, möödalaskmiste, ehituste ja tõrgete loendurid.

## Analüüs ja agenditööriistad

### Analüüsi eelseadistused

`blockstudio/phpstan` lisab plokianalüüsile kolm tasandit ning ühe käsu, mis käivitab projektis valitud tasandi.

| Eelseadistus | Lisatav |
| --- | --- |
| `base` | Olemasoleva skeemi, mallide, konksude, seadete ja API analüüs. |
| `theme` | Teema juurkataloogid, stiilipäised, varad, valijate ulatus, välja vaikeväärtused, kordaja piirid. |
| `extreme-theme` | PHPStan `max`, ohtlik PHP, paomärgid, Tailwind, JavaScript ja interaktiivsuse kontrollid. |
| `wordpress-render` | Kutsuja antud reaalajas renderdamise kontroll lisaks tasandile `extreme-theme`. |

Vaikeväärtused pärinevad asukohast `blockstudio.json`, nii et interaktiivsed käitused, CI ja sissekandekonksud kasutavad sama seadistust:

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

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

Väljumiskoodid on `0` edukal läbimisel, `1` diagnostika korral ja `2` vigase kasutuse puhul. Ümbris koostab konfiguratsiooni süsteemi ajutises kataloogis, nii et projekti ei teki loodud konfiguratsiooni, lähtealust ega vahemälu, ning tõstab PHPStan mälupiiri väärtuseni `1G`.

Komplektis on ka BC Mathi pakkuja, nii et JavaScript kontrollid ei vaja enam `ext-bcmath`-i.

### Hallatud sissekandekonks

Üks seade ja üks käsk muudavad seadistatud eelseadistuse sissekande eeltingimuseks.

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

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

Sünkroonimine kirjutab konksu ja omandikirje asukohta Git-i ühiskasutatavasse kataloogi, suunab `core.hooksPath` hallatud kataloogi ning seob sellega varem seadistatud sissekandmiseelse konksu. Konks tuvastab sissekandmise ajal hoidla ja projekti juurkataloogi, nii et seotud väljavõtted ja tühikuid sisaldavad rajad toimivad.

Konks käivitab ainult `vendor/bin/blockstudio-phpstan` ega tee midagi muud; see ei vorminda ega kirjuta faile ümber. Kui määrate `commit` väärtuseks `false` ja sünkroonite uuesti või käivitate `blockstudio-githooks remove`, taastatakse salvestatud konksu rada ning kustutatakse ainult Blockstudio omandis olevad failid.

### Projekti leping

`blockstudio-agents` loob faili `AGENTS.md`, mis kirjeldab, kus plokid asuvad, mida leht selles projektis tähendab, millised funktsioonid on lubatud ja mida analüsaator tagasi lükkab.

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

Dokument koostatakse projekti põhjal, seda ei täideta mallist. Päisega `style.css` teema, plokkide ja failipõhiste lehtede leping erineb ainult plokke registreeriva plugina omast ning sisaldab skanneri leitud arve, katalooge, nimeruume ja mallikeeli. `blockstudio.json` määrab, millised funktsioonid lepingusse lisatakse, nii et staatilise eeltöötluseta projektis ei mainita seda üldse.

Korrektsuse jaotis loetakse valitud eelseadistuse enda reeglifailidest tasandite kaupa, nii et uue reegli lisamine eelseadistusse muudab kõiki selle põhjal loodavaid lepinguid.

Omandihaldus toimib nagu sissekandekonks. Loodud markerita faili ei asendata, välja arvatud juhul, kui `--force` määrab teisiti; lõpus olev märkmete jaotis säilib regenereerimisel; `--check` väljub koodiga `1`, kui leping on aegunud; ning `--stdout` kuvab selle failisüsteemi muutmata.

### Dokumentatsiooni register

`blockstudio-llm.txt` on nüüd register, mitte dokumentide kokkuliitmine. Iga avaldatud dokument esineb oma jaotises ja alajaotises ühe korra ning sisaldab marsruuti, lähtefaili, üherealist eesmärki ja talle kuuluvaid tunnuseid: seadete radu, konksude nimesid, PHP funktsioone ja klasse ning käske.

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

Agent loeb indeksit, leiab dokumendi, millele kuulub teda huvitav tunnus, ja avab selle dokumendi. Varasemat poole megabaidi suurust ühendatud faili luuakse ja avaldatakse endiselt aadressil `/blockstudio-llm-full.txt`; see ei ole enam esimene asi, mida kellelegi kätte antakse.

## Kanoonilised plokisildid

Eraldiseisev käsk asendab eesliite- ja aliase-lühivormid kanoonilise `<bs:namespace-slug>` kirjapildiga, mis salvestab tegeliku ploki nime ja lahendatakse ka ilma projekti filtrit laadimata.

Kui eesliide `brand` käib üle `theme-components` ja eesliide `ui` üle `bsui`, tähendab see lühivorm järgmist:

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

tähendab sama mis:

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

Eesliited ja täpsed aliased töötavad endiselt ning neid ei ole aegunud kasutusest eemaldatud. Käsk ei laadi WordPress ega kirjuta midagi ilma valikuta `--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` seostab iga eesliite selle nimeruumidega ja `--known-blocks` loetleb registreeritud plokinimed. Aruanne sisaldab vastendusi pärandkujult kanoonilisele kujule koos esinemiskordade arvu ja failipõhiste räsidega ning eraldi loendeid tundmatute siltide, mitmetähenduslike aliaste ja dünaamiliste siltide kohta. `--apply` keeldub kirjutamast, kui mõni neist alles on, välja arvatud juhul, kui antakse `--allow-unresolved`.

Töödeldakse paaris-, pesastatud ja isesulguvat märgendust, sealhulgas sõnasõnalisi silte stringides PHP. Muutuvad ainult siltide nimed, teine käivituskord ei tee muudatusi ning kommentaarides, koodiplokkides, `<pre>` või `<code>` sisalduvaid näiteid kajastatakse ainult aruandes.

## Vaikekäitumine

Versiooni 7.6 paigaldamine ei muuda iseenesest midagi.

**Jõudlusprofiili vaikeväärtus on `compat`.** Päise väljund, oEmbed, XML-RPC, Heartbeat, piltide vaikeväärtused, linkide eellaadimine, laisk laadimine ja esiosa `<title>` jäävad selliseks, nagu WordPress ja teema need jätsid.

**Need on välja lülitatud, kuni need lubatakse:** iga `performance.staticPrerender`, `performance.measurement`, `performance.media` ja `themeDefaults` võti ning `githooks.commit`, `dev.canvas.enabled`, `ui.enabled`, `tailwind.enabled` ja `blockTags.enabled`. Kui staatiline eelpärendus on välja lülitatud, ei kirjuta see faile ega paigalda lisamoodulit.

**Canvas ja Render töötavad passiivselt.** Need loevad olemasolevaid registreid ja renderdavad ainult seda, mida helistaja küsib; kumbki ei haaku esiosa väljundiga ega registreeri marsruute. Canvas-e halduskuva nõuab endiselt `dev.canvas.enabled` ja `edit_posts`.

**Rangema analüüsi jaoks tuleb see nimetada.** `blockstudio/phpstan` paigaldamine lubab ainult põhilaienduse ning kanooniline käsk käivitab `base`, kui projekt pole eelseadistust nimetanud.

**Genereeritud failid nõuavad käsu käivitamist.** `githooks.commit` ei tee midagi enne, kui käivitatakse `blockstudio-githooks sync`, ja `AGENTS.md` enne, kui seda teeb `blockstudio-agents`.

## Uuendamine versioonilt 7.5

Nõuded ei ole muutunud: PHP 8.2 või uuem, WordPress 6.7 või uuem.

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

**Vahemälud luuakse üks kord uuesti.** Käitusaja identiteet sisaldab Blockstudio versiooni, seega on esimene päring pärast uuendamist külm ja vanad objektid eemaldatakse. Vana Tailwind vahemälu asukohas `wp-content/uploads/blockstudio/tailwind/cache` võib kustutada; koodijupp, mis kasutas selle leidmiseks glob-mustrit, peaks selle asemel kutsuma `Blockstudio\Runtime_Cache::purge('tailwind')`.

Versioonile 7.6 eelnenud lame `wp-content/blockstudio/cache/runtime` kataloog nimetatakse automaatselt aktiivsest teest välja ning eemaldatakse piiratud WP-Cron läbimistega. Seega ei pea juurutuspäringu ajal suuri pärandlukufailide puid kustutama.

**Genereeritud failidel on omanikud.** `assets/media.json` kuulub versioonihaldusse või ehitusetappi. Marsruudikaart, `advanced-cache.php` lisamoodul ja `WP_CACHE` deklaratsioon eksisteerivad ainult siis, kui `earlyServe` on lubatud; sissekande-eelne konks ainult sünkroonimise ajal. Kõik muu genereeritud sisu asub kataloogis `cache.path` ja selle võib turvaliselt kustutada.

**Midagi ei eemaldatud ega nimetatud ümber.** `bs_render_block()`, `bs_block()`, `Blockstudio\Pages` ja `Blockstudio\Patterns` jäävad kanoonilisteks failipõhisteks sisupindadeks.

**Tagasipööramine käib funktsioonide kaupa.** `performance.profile` väärtuseks `compat`, `staticPrerender.enabled` väärtuseks `false`, `githooks.commit` väärtuseks `false` koos `sync`-ga ning `cache.enabled` väärtuseks `false` pööravad igaüks ühe kihi tagasi.

Mõistlik kasutuselevõtu järjekord:

1. Määra `performance.profile` väärtuseks `speed`, seejärel kontrolli päise väljundit, vooge ja kõiki pluginaid, mis sõltuvad oEmbedist või XML-RPC-st.
2. Loo `assets/media.json`, vii mallid asukohta `bs_media_image()` ja lülita seejärel sisse `performance.media.lazy`.
3. Luba `performance.staticPrerender` nii, et `earlyServe` on välja lülitatud, kontrolli päringuid tööriistaga `wp bs prerender status` ja lülita seejärel sisse `earlyServe`.
4. Käivita `blockstudio-phpstan --preset theme`, kuni tulemus on puhas, enne kui asetad mõne eelseadistuse valiku `githooks.commit` taha.

## Kust üksikasju leida

- [Canvas](https://blockstudio.dev/et/docs/dev/canvas/) ja selle [inventar ning dokumendi API](https://blockstudio.dev/et/docs/dev/canvas/#public-inventory-and-document-api)
- [Renderdamine](https://blockstudio.dev/et/docs/blocks/rendering/#structured-compositions-and-complete-documents), [UI komponendid](https://blockstudio.dev/et/ui/#public-inventory-and-examples) ja [UI kompositsioon](https://blockstudio.dev/et/ui/composition/)
- [Seaded](https://blockstudio.dev/et/docs/general/settings/) ja [jõudlus](https://blockstudio.dev/et/docs/general/settings/#performance)
- [Jõudlus](https://blockstudio.dev/et/docs/production/performance/), [vahemällu salvestamine](https://blockstudio.dev/et/docs/production/caching/) ja [staatiline eelpärendus](https://blockstudio.dev/et/docs/production/static-prerendering/)
- [Tailwind CSS](https://blockstudio.dev/et/docs/tailwind/#template-composition-helpers)
- [PHPStan](https://blockstudio.dev/et/docs/dev/phpstan/): [eelseadistused](https://blockstudio.dev/et/docs/dev/phpstan/#analysis-presets), [kanooniline käsk](https://blockstudio.dev/et/docs/dev/phpstan/#canonical-command), [hallatav sissekande-eelne konks](https://blockstudio.dev/et/docs/dev/phpstan/#managed-commit-hook) ja [projekti leping](https://blockstudio.dev/et/docs/dev/phpstan/#project-contract-for-coding-agents)
- [Tehisintellekti integratsioon](https://blockstudio.dev/et/docs/dev/ai/): dokumentatsiooniindeks ja täistekst
- [Migreerimine](https://blockstudio.dev/et/docs/dev/migration/v7/#canonical-block-tags) ja [PHP konksud](https://blockstudio.dev/et/docs/blocks/hooks/php/)
