
Blockstudio 7.6 ļauj nolasīt un attēlot projektu no PHP un pārceļ produkcijas priekšgala noklusējuma iestatījumus uz `blockstudio.json`: inventāra API, patstāvīgu attēlošanu, veidņu palīgfunkcijas multividei un Tailwind, veiktspējas profilus, vienu kešatmiņas mapi, statisku iepriekšēju atveidošanu ar tūlītēju apkalpošanu, stingrākus analīzes iestatījumus un ģenerētus projektu rīkus programmēšanas aģentiem.

Lielāko daļu laidiena nodrošina divi izsaukumi. `Canvas::inventory()` atgriež visas lapas, blokus, rakstu paraugus, vietnes redaktora veidnes, veidņu daļas un komplektēto UI piemēru, ko projekts reģistrē. `Render::document()` atgriež gatavu HTML jebkuram no tiem, kā arī tieši tos resursus, kas izmantoti attēlošanā.

> **7.6.2 atjauninājums:** failos glabātās lapas parastu WordPress pieprasījumu laikā vairs netiek saskaņotas. Avota izmaiņas piemērojiet, izpildot `wp bs pages sync` vai izsaucot `Blockstudio\Pages::reconcile()`. Kolekciju maršrutēšanai un `templateFor` noklusējuma iestatījumiem tiek izmantota saglabātā izpildvides konfigurācija, un skaidra saskaņošana ļauj izvairīties no iepriekš izmantotā apjomīgā daudzvalodu OR-meta vaicājuma. Īslaicīgā opcija `themeDefaults.syncPagesInDevelopment` ir noņemta, jo lapu sinhronizācija vairs nenotiek pieprasījumu āķos. `Pages::init()` tagad tiek izmantots tikai inicializēšanai; integrācijām, kas nodeva `force`, jāizmanto `Pages::reconcile()` vai CLI. Atverot Canvas, autorēšanas inventāram joprojām tiek veikta viena autentificēta, skaidri izsaukta saskaņošana.

> **7.6.12 atjauninājums:** redaktora stilu lapām tagad tiek pievienots prefikss ar vienu
> pārrakstīšanas gājienu, nevis katram resursam atsevišķi kompilējot SASS, tāpēc
> redaktora aukstā būvēšana vietnē ar daudziem blokiem vairs nerada risku
> pārsniegt pieticīgu atmiņas ierobežojumu. Kešota iepriekš renderēta lapa, kuras
> satura jaucējvērtībā balstītā Tailwind stilu lapa ir izņemta no kešatmiņas,
> tiek renderēta no jauna, nevis rādīta bez stiliem — gan izmantojot PHP kešatmiņu,
> gan Early Serve papildmoduli. Augšējā līmenī ierakstītie bloka atribūti renderēšanas laikā
> tiek nolasīti, nevis atmesti, tāpēc shēmas Blockstudio reģistrācija vietnē `WP_Block_Type`
> tiek ievērota, ja datus raksta programmiski.

> **7.6.11 atjauninājums:** Graph artefaktu instalēšana tagad atomiski aizstāj maršruta
> dokumentu, ja krātuves kopija ar to pašu atslēgu ir mainījusies, nemaina
> identiskus dokumentus un ar `Static_Prerender_Early_Serve::last_promotion()` starpniecību ziņo par paaugstinātajiem, aizstātajiem,
> izlaistajiem un saglabātajiem maršrutiem.

> **7.6.10 atjauninājums:** izpildlaika kešatmiņas trāpījumi tagad konstatē izņemtus kompilētus resursus
> pat novērošanas aizkaves laikā, bet plakanās izpildlaika kešatmiņas pirms 7.6. versijas tiek atomiski
> ievietotas karantīnā un dzēstas ierobežota lieluma cron porcijās. Komplektētie UI globālie objekti tiek izvadīti
> vienreiz katrā lapā. Graph režīmā Early Serve var apkalpot tiešsaistē renderētus maršrutus ārpus
> izvietoto maršrutu kartes, izmantojot identitātes kešatmiņu. Tailwind pēc izvēles var izvadīt
> satura jaucējvērtībā balstīto kešatmiņas failu ar `tailwind.output: "link"`; pēc noklusējuma izvade ir
> iekļauta lapā.

Īsumā:

- **Projekta inventārs**: `Canvas::inventory()` atgriež katru reģistrēto ierakstu
  kopā ar tā avotiem un stabilu attēlošanas secību.
- **Mērķēta atlase**: norādot blokus un lapas, atklāšana, sinhronizēšana,
  renderēšana un kompilēšana tiek ierobežota līdz šiem ierakstiem.
- **Atsevišķa renderēšana**: `Blockstudio\Render` atgriež gatavu HTML blokam,
  kompozīcijai vai pilnam dokumentam.
- **UI komponentu saimes**: `Blockstudio\Ui` grupē komplektēto bibliotēku vienā publiskā
  saimē katram komponentam, pievienojot pa piemēram.
- **Stabili attēlu izmēri**: `bs_media_image()` renderē tēmas resursus ar īstajiem
  izmēriem no ģenerēta `assets/media.json`.
- **Tailwind klašu palīgi**: `bs_tw_merge()` un `bs_tw_variants()` apvieno
  klases PHP, ņemot vērā konfliktus.
- **Veiktspējas profili**: `performance.profile` uzreiz ieslēdz ražošanas vides priekšgala
  noklusējuma iestatījumus; pakārtotās vērtības tos pārraksta.
- **Tipizēta iestatījumu piekļuve**: `Settings::get_bool()` un līdzīgās funkcijas nolasa
  `blockstudio.json`, izmantojot īstos tipus, un parāda parsēšanas kļūdas.
- **Viena kešatmiņas mape**: visi ģenerētie faili atrodas zem `cache.path`, un to nosaukumos
  izmantota izpildlaika identitāte.
- **Statiskā iepriekšējā renderēšana**: anonīmus HTML var kešot, invalidēt, izmantojot
  atkarību grafu, un apkalpot, pirms tiek palaists WordPress.
- **Analīzes sākotnējie iestatījumi**: `theme`, `extreme-theme` un `wordpress-render` paplašina
  `blockstudio/phpstan` iespējas ārpus bloku veidnēm.
- **Pārvaldīts apstiprināšanas āķis**: `blockstudio-githooks sync` izveido un pārvalda
  pre-commit āķi, kas izpilda konfigurēto sākotnējo iestatījumu.
- **Projekta līgums**: `blockstudio-agents` izveido `AGENTS.md`, kurā aprakstīts,
  ko projekts veido, kādas funkcijas tas iespējo un ko pārbauda tā sākotnējais iestatījums.
- **Dokumentācijas rādītājs**: AI konteksta fails tagad ir visu dokumentu rādītājs,
  kurā norādīts katra dokumenta mērķis un tam piederošie identifikatori.
- **Kanoniskie bloku tagi**: atsevišķa komanda pārraksta prefiksu un aizstājvārdu
  saīsinājumus par `<bs:namespace-slug>`, un to var palaist izmēģinājuma režīmā.
- **Saderība pēc noklusējuma**: neviena no iepriekš minētajām izmaiņām neietekmē vietni, kamēr tā nav norādīta
  vietnē `blockstudio.json`.

## Projekta nolasīšana un renderēšana

### Projekta inventārs

`Canvas::inventory()` atgriež visu, ko projekts reģistrē, kā vienu vienkāršu masīvu,
neko nerenderējot.

```php
use Blockstudio\Canvas;

$result = Canvas::inventory();

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

Ieraksti ir grupēti pēc tipa: `pages`, `blocks`, `patterns`, `templates`,
`parts` un `ui`. `order` nosaka stabilu attēlošanas secību visiem tipiem,
`sources` katram ierakstam piesaista tā avota ceļus, bet `warnings` un `errors`
apkopo problēmas strukturētos ierakstos.

Bloku ierakstos ir `id`, `name`, `title`, `source`, `path`, `provenance` un
renderēšanai gatavs `declaration`. Lapu ierakstos `source` ir stabila identitāte,
bet `path` — renderējamā veidne.

### Mērķēta atlase

Norādot ierakstus, tiek sašaurināts veicamais darbs, nevis vēlāk filtrēti rezultāti.

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

Tas atgriež vienu bloku un vienu lapu. `patterns`, `templates`, `parts` un `ui`
tiek atgriezti tukši, un to avoti netiek nolasīti, sinhronizēti, renderēti vai
kompilēti.

Noteikumi ir precīzi:

- Ja nav norādīta neviena tipa atslēga, tiek ielādēti visi tipi.
- `true`, `null` vai `"*"` ielādē visus attiecīgā tipa ierakstus.
- Virkne vai saraksts precīzi atbilst ID, nosaukumam, slug, ceļam vai avota ceļam.
- Tukša virkne, tukšs saraksts vai `false` neielādē nevienu attiecīgā tipa ierakstu.
- Ja ir norādīta kaut viena tipa atslēga, nenorādītie tipi paliek nemainīti.

Neesoši identifikatori tiek atgriezti sadaļā `deleted`, nevis izraisa kļūdu,
un Canvas REST atsvaidzināšanas galapunkts to pašu noteikumu piemēro saviem `blocks` un
`pages` parametriem.

`Canvas::documents()` izmanto to pašu atlasi un katram ierakstam pievieno vienu renderētu dokumentu.
Atlasītās lapas tiek renderētas atjaunotā priekšgala kontekstā, tāpēc vaicājumu
nosacījumi, body klases, īskodi, izkārtojumi, novirzīšana un resursu pievienošanas
atgriezeniskie izsaukumi izmanto šo lapu, nevis pieprasījuma kontekstu.

### Atsevišķa renderēšana

`Blockstudio\Render` atgriež renderētu HTML kā virkni, izmantojot to pašu
konveijeru, ko izmanto priekšgals.

```php
use Blockstudio\Render;

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

Pamatā ir viena deklarācijas forma ar četrām atslēgām: `name`, `attributes`,
`content` un `children`. `root`, `data`, `inner`, `innerBlocks`, `layers` un
`example` ir ievades saīsinājumi, ko `Render::normalize()` apvieno šajā formā.
Bērni tiek renderēti rekursīvi, un nederīga ievade izraisa izņēmumu, kurā norādīts
problemātiskais bloks.

`Render::document()` iekļauj izvadi pilnā atsevišķā HTML dokumentā.

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

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

`body` ir tikai bloka izvade, `html` — saliktais dokuments, `blocks` —
bloku nosaukumi, kas piedalījās, bet `assets` sadala marķējumu šādās daļās: `head`,
`footer`, `styles`, `scripts`, `modules`, `interactivity`, `ui` un `tailwind`.
Resursi tiek ierobežoti ar tiem, kas izmantoti renderēšanā, tāpēc redaktoram paredzētie resursi netiek iekļauti.

`Render::document_from_html()` iesaiņo citur renderētu HTML, bet
`Render::content()` renderē serializētu bloka saturu bez dokumenta. Starp dokumentiem vienā PHP
procesā izsauciet `Blockstudio\Batch_Render::reset()`; `Canvas::documents()` to jau dara.

### UI komponentu saimes

`Blockstudio\Ui` piedāvā komplektēto UI bibliotēku kā vienu ierakstu katram publiskajam
komponentam, nevis kā iekšējo daļu sarakstu.

`Ui::inventory()` atgriež vienu ierakstu katrai saimei, norādot tās saknes bloku, virsrakstu un
nepieciešamos implementācijas blokus. `Ui::examples()` pievieno katrai saimei deterministisku
deklarāciju: noklusējuma vērtības tiek saglabātas, obligātie bērnu slāņi ievietoti to vecākos,
un pievienots stabils ilustratīvs teksts, ja lauks citādi būtu tukšs. Šī deklarācija ir kanoniska,
tāpēc to var tieši ievietot vietnē `Render::document()`.

Canvas grupē komponentus tāpat. Komplektētais UI tiek rādīts kā viens piemērs katrai saimei
zem tipa `ui`, bet implementācijas reģistrācijas netiek iekļautas vietnē `blocks`.

Saimes ir veidotas tā, lai tās varētu kombinēt: atlase atveras dialogā, kura saraksta lodziņš pārklāj palaidēju; izvēlnes un kombinētie lodziņi tiek piesaistīti fiksētām skata loga koordinātām, kas saglabājas ritinot; modālie logi tiek kārtoti cits virs cita un aizvērti pa vienam ar Escape; katrā kājenē viena un tā pati aizvēršanas vadīkla tiek kombinēta ar variantu. Sadaļā [kompozīciju nodaļa](https://blockstudio.dev/lv/ui/composition/) ir aprakstīts, kā darbojas šīs saskares vietas un invarianti, kas nodrošina to darbību; [/ui/examples](https://blockstudio.dev/lv/ui/examples/) redzamas kompozīcijas darbībā.

## Veidņu palīgi

### Stabili attēlu izmēri

`bs_media_image()` renderē tēmas resursus ar īsto platumu, augstumu un rezervētu
malu attiecību, tāpēc attēli ārpus multivides bibliotēkas vairs neizkustina izkārtojumu.

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

Izvade ir `figure.blockstudio-media` ar iekļautu `aspect-ratio` ap `img`, kuram ir īstās `width`, `height`, `loading` un `decoding` vērtības. Izmēri tiek nolasīti no ģenerēta `assets/media.json`, ko būvēšanas darbībā izveido `Blockstudio\Media_Metadata_Builder` vai ko var izveidot manuāli.

`src` pieņem tēmas relatīvo ceļu, absolūto ceļu vai pilnu URL, bet
`attachmentId` apstrādā multivides bibliotēkas attēlus. `eager` atspējo attēlu slinko ielādi
lapas augšdaļā, bet `sources` izvada `<picture>`.

Kad ir ieslēgts `performance.media.lazy`, īstais URL tiek pārvietots uz `data-src` aiz
pareizā izmērā esoša viettura.

### Tailwind klašu palīgi

`bs_tw_merge()` un `bs_tw_variants()` apvieno Tailwind klases PHP
veidnēs, izmantojot dzinēju Blockstudio, kas jau ir iekļauts komplektācijā.

`bs_tw_merge('px-2 text-sm', 'px-4')` atgriež `text-sm px-4`: konfliktējošā
`px-2` klase tiek atmesta, un uzvar vēlākā vērtība. Tiek pieņemti arī ligzdoti klašu vērtību masīvi.

`bs_tw_variants()` atgriež nelielu izsaucamu funkciju komponentu variantiem:

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

Tiek izvadīts `inline-flex items-center h-12 px-6 rounded`. Tiek atbalstītas bāzes klases,
varianti, noklusējuma varianti, saliktie varianti un katram izsaukumam paredzēts `class` vai
`className`.

## Ražošanas vides konfigurācija

### Veiktspējas profili

`performance.profile` vienuviet ieslēdz priekšgala noklusējuma iestatījumus ražošanas videi.

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

`compat` ir noklusējuma iestatījums un neko nemaina. `speed` un `strict` iespējo
vienu un to pašu kopu: no head tiek noņemta ģeneratora, emocijzīmju, plūsmas, atklāšanas un blakus ziņu izvade; tiek noņemta oEmbed atklāšana un resursdatora skripti; tiek atspējots XML-RPC, pingback un attālā redaktora atklāšana; tiek noņemti vispārīgie pamata priekšgala resursi; tiek piemēroti attēlu izvades noklusējuma iestatījumi; ārpus redaktoriem tiek ierobežota Heartbeat darbība; tāpat tiek iepriekš ielādēti tās pašas izcelsmes dokumenti, kad lietotājs norāda uz tiem vai fokusē tos; un tiek izmantots Blockstudio attēlu ielādētājs.

Katra pakārtotā vērtība pārraksta profilu, kā tas redzams iepriekš pie `preload.links`. Pirmā pārbaudāmā iespēja ir pamata priekšgala resursu noņemšana, jo lapa, kas ir atkarīga no tiem, redzami nedarbosies. `Runtime_Settings::current()` parāda atrisināto profilu.

`themeDefaults` nodrošina divas iespējas, ko tēmas citādi īstenotu pašas: `titleTag` un
`suppressDirectoryUpdates`, lai paslēptu aktīvo bērntēmu un vecāktēmu no atjauninājumu
rezultātiem.

### Tipizēta iestatījumu piekļuve

`Blockstudio\Settings` nolasa konfigurāciju ar īstiem datu tipiem, nevis atgriež
to, kas bija saglabāts 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);
}
```

Par nederīgu JSON tiek ziņots, izmantojot `Settings::errors()`, nevis aizstājot to ar
noklusējuma vērtībām. `Settings::get_raw()` atgriež tikai to, ko deklarējis aktīvais avots,
tādējādi var atšķirt vērtību, kas iestatīta uz `false`, no vērtības, kas nekad nav iestatīta.

`Settings::fingerprint()` atgriež stabilu efektīvo iestatījumu identitāti,
un piekļuve tiek pārlādēta, kad mainās `blockstudio.json`.

### Viena kešatmiņas mape

Visi ģenerētie faili tagad atrodas zem `cache.path`, kura noklusējuma vērtība ir
`wp-content/blockstudio/cache`.

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

Būvēšanas dati, bloku reģistrācijas dati, redaktora resursi, kompilētais Tailwind CSS,
renderēšanas dokumenti, salu fragmenti, statiskais HTML, Graph indeksi, iesildīšanas rindas un
diagnostika atrodas šajā saknes mapē. Relatīvais ceļš tiek atrisināts no
`WP_CONTENT_DIR`, bet absolūtais ceļš norāda uz atsevišķu sējumu.

Objekti tiek glabāti zem pašreizējā tīkla un vietnes, pēc tam — zem izpildlaika
identitātes: pirkstu nospieduma, ko veido Blockstudio, WordPress un PHP versijas,
efektīvie iestatījumi, aktīvā tēma un spraudņi, atklāšanas avoti un izmantotie avota
faili. Mainot kādu ievadi, attiecīgie objekti tiek aizstāti ar jauniem; vecie
objekti tiek iztīrīti.

Aukstā būvēšana tiek veikta tikai vienreiz: viens pieprasījums izveido un atomiski publicē
rezultātu, bet pārējie gaida. Ja atjaunināšana neizdodas, pēdējais sekmīgais objekts joprojām tiek
apkalpots, kļūdu vienlaikus saglabājot redzamu, un
`Blockstudio\Runtime_Cache::purge('tailwind')` notīra vienu tvērumu.

## Statiskā iepriekšējā renderēšana

Statiskā iepriekšējā renderēšana saglabā kešatmiņā pilnīgus anonīmus HTML dokumentus un var tos apkalpot,
pirms tiek palaists WordPress. Pēc noklusējuma tā ir izslēgta.

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

### Atbilstības nosacījumi

Atbilst tikai pilnīgi anonīmi HTML dokumenti. Netiek apkalpoti pieprasījumi, kas nav GET pieprasījumi, pieprasījumi ar vaicājuma virknēm, administrēšanas, REST, Ajax, cron, plūsmu, meklēšanas, priekšskatījuma vai nonce saturoši pieprasījumi, kā arī pieprasījumi ar personalizācijas sīkdatnēm vai ceļu zem `dynamicPaths`.
Atbilde var pilnībā atteikties no šīs iespējas, pievienojot marķieri `<!-- blockstudio:no-cache -->`.

Ceļu salīdzināšanā tiek ievērotas robežas, tāpēc `/account` aptver `/account/orders`, bet
ne `/accounting`.

### Paraksta un Graph režīmi

`invalidate` nosaka, kā beidzas ierakstu derīguma termiņš. Noklusējuma režīmā `signature` anonīms pieprasījums aizpilda pēc identitātes atslēgotu atbildes kešatmiņu, kas tiek pagriezta pēc izmaiņām vietnes līmenī; šis režīms ir piemērots parastai vietnei.

`graph` režīms paredzēts skaidri norādītiem būvēšanas un izvietošanas rīkiem. Tajā tiek reģistrētas katras lapas atkarības no avotiem, tāpēc plāns atjauno tikai ietekmētos URL.

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

### Agrīna apkalpošana

Kad ir ieslēgts `earlyServe`, Blockstudio pārvalda nelielu katras vietnes maršrutu karti un `advanced-cache.php` papildmoduli, kas straumē atbilstošu kešatmiņas trāpījumu, pirms tiek palaists WordPress,
spraudņi vai tēma.

Tas nekad nepārraksta citu maršrutu karti, papildmoduli vai `WP_CACHE` deklarāciju. Pirms kartes nomaiņas Graph artefaktā tiek pārbaudīts katrs atsauces HTML fails, tāpēc nepilnīga izvietošana atstāj aktīvu iepriekšējo grafu. Multivietņu ieraksti tiek izolēti pēc resursdatora, sākumlapas ceļa un vietnes ID.

### Iesildīšana un statuss

Ikdienas lietošanai paredzētas trīs WP-CLI komandas:

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

`status` parāda aktīvo identitāti, failu un baitu skaitu, grafa ierakstus, rindas stāvokli un tvērumu skaitītājus: trāpījumus, netrāpījumus, būvēšanas un kļūmes.

## Analīze un aģentu rīki

### Analīzes sākotnējie iestatījumi

`blockstudio/phpstan` papildina bloku analīzi ar trim slāņiem un vienu
komandu, kas palaiž projekta atlasīto slāni.

| Sākotnējais iestatījums | Ko tas pievieno |
| --- | --- |
| `base` | Esošo shēmu, veidņu, āķu, iestatījumu un API analīzi. |
| `theme` | Tēmu saknes, stilu galvenes, resursus, selektoru tvērumu, lauku noklusējuma vērtības, atkārtotāju robežas. |
| `extreme-theme` | PHPStan `max`, nedrošu PHP, izvairīšanos, Tailwind, JavaScript un Interactivity pārbaudes. |
| `wordpress-render` | Zvanītāja nodrošinātu aktīvās renderēšanas zondi papildus `extreme-theme`. |

Noklusējuma vērtības tiek ņemtas no `blockstudio.json`, lai interaktīvās palaišanas, CI un apstiprināšanas āķi
izmantotu vienu konfigurāciju:

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

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

Atgriešanas kodi ir `0`, ja pārbaude ir sekmīga, `1`, ja konstatēta diagnostikas informācija, un `2`, ja lietojums nav derīgs. Aptverošā programma izveido konfigurāciju sistēmas pagaidu mapē, tāpēc projektā netiek saglabāta ģenerēta konfigurācija, bāzlīnija vai kešatmiņa, kā arī tā palielina PHPStan atmiņas ierobežojumu līdz `1G`.

Tajā ir iekļauts arī BC Math nodrošinātājs, tāpēc JavaScript pārbaudēm vairs nav nepieciešams `ext-bcmath`.

### Pārvaldīts apstiprināšanas āķis

Ar vienu iestatījumu un vienu komandu konfigurēto sākotnējo iestatījumu var izmantot kā apstiprināšanas vārtus.

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

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

Sinhronizēšana ieraksta āķi un īpašumtiesību ierakstu kopējā mapē Git, norāda `core.hooksPath` uz pārvaldīto mapi un piesaista iepriekš konfigurēto pre-commit āķi. Apstiprināšanas brīdī āķis atrod repozitoriju un projekta saknes mapi, tāpēc darbojas gan saistītās darba kopijas, gan ceļi ar atstarpēm.

Āķis palaiž tikai `vendor/bin/blockstudio-phpstan`; tas nekad neformatē vai nepārraksta failus. Iestatot `commit` uz `false` un vēlreiz sinhronizējot, vai palaižot `blockstudio-githooks remove`, tiek atjaunots ierakstītais āķa ceļš un dzēsti tikai Blockstudio piederošie faili.

### Projekta līgums

`blockstudio-agents` izveido `AGENTS.md`, kurā norādīts, kur atrodas bloki, kā šajā projektā definēta lapa, kuras funkcijas ir iespējotas un ko analizators noraidīs.

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

Dokuments tiek iegūts no projekta, nevis veidots no veidnes. Tēmai ar `style.css` galveni, blokiem un failos glabātām lapām būs cits līgums nekā spraudnim, kurā reģistrēti tikai bloki; tajā būs norādīti skenētāja atrastie skaiti, mapes, nosaukumvietas un veidņu valodas. `blockstudio.json` nosaka, kuras funkcijas tiek iekļautas, tāpēc projektā bez statiskās iepriekšējās renderēšanas tā netiek pieminēta.

Pareizības sadaļa tiek nolasīta no atlasītā sākotnējā iestatījuma noteikumu failiem pa slāņiem, tāpēc, ja sākotnējam iestatījumam tiek pievienots noteikums, tas maina katru ģenerēto līgumu.

Īpašumtiesības darbojas tāpat kā apstiprināšanas āķim. Ja failā nav ģenerētā marķiera, to atsaka aizstāt, ja vien `--force` nenosaka citādi; piezīmju sadaļa beigās tiek saglabāta arī pēc atkārtotas ģenerēšanas; ja līgums ir novecojis, `--check` izvada `1`; bet `--stdout` to izvada, nemainot failu sistēmu.

### Dokumentācijas rādītājs

`blockstudio-llm.txt` tagad ir rādītājs, nevis dokumentu apvienojums. Katrs publicētais dokuments tajā parādās vienreiz, norādot sadaļu un apakšsadaļu, maršrutu, avota failu, vienas rindas aprakstu un tam piederošos identifikatorus: iestatījumu ceļus, āķu nosaukumus, PHP funkcijas un klases, kā arī komandas.

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

Aģents nolasa indeksu, atrod vienu dokumentu, kurā atrodas tam vajadzīgais identifikators, un atver šo dokumentu. Iepriekšējo pusmegabaita apvienoto failu joprojām ģenerē un publicē vietnē `/blockstudio-llm-full.txt`; tas vairs nav pirmais, kas tiek pasniegts ikvienam.

## Kanoniskie bloku tagi

Atsevišķa komanda pārraksta prefiksu un aizstājvārdu saīsinājumus kanoniskajā `<bs:namespace-slug>` pierakstā, kas norāda īsto bloka nosaukumu un tiek atrisināts arī tad, ja nav ielādēts projekta filtrs.

Ar prefiksu `brand` virs `theme-components` un prefiksu `ui` virs `bsui` šis saīsinājums:

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

nozīmē to pašu, ko:

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

Prefiksi un precīzi aizstājvārdi joprojām darbojas un nav novecojuši. Komanda neielādē WordPress un neko nepieraksta bez `--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` katru prefiksu piesaista tā nosaukumvietām, bet `--known-blocks` uzskaita reģistrētos bloku nosaukumus. Pārskatā norādītas mantotā un kanoniskā pieraksta atbilstības un to gadījumu skaits, katra faila jaucējkods un atsevišķi saraksti ar nezināmiem tagiem, neskaidriem aizstājvārdiem un dinamiskiem tagiem. `--apply` atsakās rakstīt, kamēr kāds no tiem saglabājas, ja vien nav norādīts `--allow-unresolved`.

Tiek apstrādāts pārots, ligzdots un pašnoslēdzošs marķējums, tostarp burtiski tagi PHP virknēs. Mainās tikai tagu nosaukumi; otrā palaišanas reizē izmaiņu nav, un piemēri komentāros, koda blokos, `<pre>` vai `<code>` tiek tikai iekļauti pārskatā.

## Noklusējuma darbība

7.6 instalēšana pati par sevi neko nemaina.

**Veiktspējas profils pēc noklusējuma ir `compat`.** Galvenes izvade, oEmbed, XML-RPC, Heartbeat, attēlu noklusējuma iestatījumi, saišu priekšielāde, slinkā ielāde un priekšgala `<title>` paliek tādi, kādus tos atstāja WordPress un tēma.

**Tie paliek izslēgti, kamēr nav iespējoti:** katra `performance.staticPrerender`, `performance.measurement`, `performance.media` un `themeDefaults` atslēga, kā arī `githooks.commit`, `dev.canvas.enabled`, `ui.enabled`, `tailwind.enabled` un `blockTags.enabled`. Kamēr statiskā iepriekšējā renderēšana ir izslēgta, tā neraksta failus un neinstalē papildu komponentu.

**Canvas un Render darbojas pasīvi.** Tie nolasa esošos reģistrus un renderē tikai to, ko pieprasa izsaucējs; neviens no tiem nepievieno savas funkcijas priekšgala izvadei un nereģistrē maršrutus. Canvas administrēšanas ekrānam joprojām nepieciešami `dev.canvas.enabled` un `edit_posts`.

**Stingrākai analīzei tā ir skaidri jānorāda.** Instalējot `blockstudio/phpstan`, tiek iespējots tikai pamata paplašinājums, un kanoniskā komanda palaiž `base`, ja vien projektā nav norādīts iepriekšiestatījums.

**Ģenerētie faili ir jāizveido, palaižot tiem paredzēto komandu.** `githooks.commit` neko nedara, līdz tiek palaists `blockstudio-githooks sync`, un `AGENTS.md` — līdz tiek palaists `blockstudio-agents`.

## Jaunināšana no 7.5

Prasības nav mainījušās: PHP 8.2 vai jaunāka versija, WordPress 6.7 vai jaunāka versija.

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

**Kešatmiņas tiek atjaunotas vienu reizi.** Izpildlaika identitātē ir iekļauta Blockstudio versija, tāpēc pirmais pieprasījums pēc jaunināšanas ir auksts, un vecie objekti tiek iztīrīti. Veco Tailwind kešatmiņu mapē `wp-content/uploads/blockstudio/tailwind/cache` var izdzēst; koda fragmentam, kas izmantoja globēšanu, tās vietā jāizsauc `Blockstudio\Runtime_Cache::purge('tailwind')`.

Pirms 7.6 izmantotā plakanā `wp-content/blockstudio/cache/runtime` mape tiek automātiski pārdēvēta, lai tā vairs neatrastos aktīvajā ceļā, un noņemta ierobežotās WP-Cron izpildēs. Tāpēc izvietošanas pieprasījuma laikā nav jādzēš lieli mantoto bloķēšanas failu koki.

**Ģenerētajiem failiem ir īpašnieki.** `assets/media.json` jāiekļauj versiju kontrolē vai veidošanas darbībā. Maršrutu karte, `advanced-cache.php` papildu komponents un `WP_CACHE` deklarācija pastāv tikai tad, ja ir iespējots `earlyServe`, bet pirmsiesniegšanas āķis — tikai sinhronizēšanas laikā. Viss pārējais ģenerētais saturs atrodas zem `cache.path`, un to var droši dzēst.

**Nekas nav noņemts vai pārdēvēts.** `bs_render_block()`, `bs_block()`, `Blockstudio\Pages` un `Blockstudio\Patterns` joprojām ir kanoniskās failos glabātā satura virsmas.

**Katru funkciju var atgriezt iepriekšējā stāvoklī atsevišķi.** `performance.profile` uz `compat`, `staticPrerender.enabled` uz `false`, `githooks.commit` uz `false` kopā ar `sync` un `cache.enabled` uz `false` — katra no šīm darbībām atceļ vienu slāni.

Ieteicamā ieviešanas secība:

1. Iestatiet `performance.profile` uz `speed`, pēc tam pārbaudiet galvenes izvadi, plūsmas un visus spraudņus, kas izmanto oEmbed vai XML-RPC.
2. Ģenerējiet `assets/media.json`, pārvietojiet veidnes uz `bs_media_image()` un pēc tam ieslēdziet `performance.media.lazy`.
3. Iespējojiet `performance.staticPrerender`, atstājot `earlyServe` izslēgtu; pārbaudiet trāpījumus, izmantojot `wp bs prerender status`, un pēc tam ieslēdziet `earlyServe`.
4. Palaidiet `blockstudio-phpstan --preset theme`, līdz pārbaudē vairs nav atradumu, un tikai tad pievienojiet jebkuru iepriekšiestatījumu pie `githooks.commit`.

## Kur atrast detalizētu informāciju

- [Canvas](https://blockstudio.dev/lv/docs/dev/canvas/), tā [inventārs un dokumenta API](https://blockstudio.dev/lv/docs/dev/canvas/#public-inventory-and-document-api)
- [Renderēšana](https://blockstudio.dev/lv/docs/blocks/rendering/#structured-compositions-and-complete-documents), [UI komponenti](https://blockstudio.dev/lv/ui/#public-inventory-and-examples) un [UI kompozīcija](https://blockstudio.dev/lv/ui/composition/)
- [Iestatījumi](https://blockstudio.dev/lv/docs/general/settings/) un [veiktspēja](https://blockstudio.dev/lv/docs/general/settings/#performance)
- [Veiktspēja](https://blockstudio.dev/lv/docs/production/performance/), [kešatmiņa](https://blockstudio.dev/lv/docs/production/caching/) un [statiskā iepriekšējā renderēšana](https://blockstudio.dev/lv/docs/production/static-prerendering/)
- [Tailwind CSS](https://blockstudio.dev/lv/docs/tailwind/#template-composition-helpers)
- [PHPStan](https://blockstudio.dev/lv/docs/dev/phpstan/): [iepriekšiestatījumi](https://blockstudio.dev/lv/docs/dev/phpstan/#analysis-presets), [kanoniskā komanda](https://blockstudio.dev/lv/docs/dev/phpstan/#canonical-command), [pārvaldītais iesniegšanas āķis](https://blockstudio.dev/lv/docs/dev/phpstan/#managed-commit-hook) un [projekta līgums](https://blockstudio.dev/lv/docs/dev/phpstan/#project-contract-for-coding-agents)
- [AI integrācija](https://blockstudio.dev/lv/docs/dev/ai/): dokumentācijas indekss un pilnais teksts
- [Migrēšana](https://blockstudio.dev/lv/docs/dev/migration/v7/#canonical-block-tags) un [PHP āķi](https://blockstudio.dev/lv/docs/blocks/hooks/php/)
