
Blockstudio 7.6 omogoča pregledovanje projekta in izrisovanje iz PHP ter prenaša privzete nastavitve produkcijskega sprednjega dela v `blockstudio.json`: inventar API, samostojno izrisovanje, pomočnike predlog za medije in Tailwind, profile zmogljivosti, en imenik predpomnilnika, statično predizrisovanje z zgodnjim streženjem, strožje prednastavitve analize ter ustvarjena projektna orodja za kodirne agente.

Večino izdaje omogočata dva klica. `Canvas::inventory()` vrne vse strani, bloke, vzorce, predloge urejevalnika spletnega mesta, dele predlog in primere pakiranega UI, ki jih registrira projekt. `Render::document()` za katerikoli od njih vrne končni HTML in natančno tista sredstva, ki so bila uporabljena pri izrisovanju.

> **Posodobitev 7.6.2:** strani iz datotek se med običajnimi zahtevami WordPress ne usklajujejo več. Pri uveljavljanju sprememb virov zaženite `wp bs pages sync` ali pokličite `Blockstudio\Pages::reconcile()`. Usmerjanje zbirk in privzete nastavitve `templateFor` uporabljajo shranjeno konfiguracijo izvajalnega okolja, izrecno usklajevanje pa se izogne prejšnji obsežni večjezični poizvedbi OR-meta. Kratkotrajna možnost `themeDefaults.syncPagesInDevelopment` je odstranjena, ker se sinhronizacija strani ne izvaja več iz kavljev zahtev. `Pages::init()` je zdaj namenjen samo inicializaciji; integracije, ki so posredovale `force`, morajo uporabiti `Pages::reconcile()` ali CLI. Ob odprtju Canvas se še vedno izvede eno overjeno, izrecno usklajevanje inventarja za avtorje.

> **7.6.12 posodobitev:** Slogovne datoteke urejevalnika se zdaj opremijo s predponami v enem samem
> prehodu prepisovanja namesto s prevajanjem SASS za vsako sredstvo posebej, zato pri hladni gradnji urejevalnika na
> spletnem mestu z veliko bloki ni več nevarnosti, da bi zmanjkalo skromnega pomnilniškega limita. Predpomnjena vnaprej izrisana stran, katere vsebinsko zgoščena slogovna datoteka Tailwind je bila
> odstranjena iz predpomnilnika, se znova izriše namesto, da bi bila prikazana brez slogov, tako prek predpomnilnika PHP
> kot prek dodatka Early Serve. Atributi blokov, zapisani na najvišji ravni, se pri izrisu preberejo namesto zavržejo, zato je shema Blockstudio,
> registrirana v `WP_Block_Type`, upoštevana tudi pri programskih zapisovalnikih.

> **7.6.11 posodobitev:** Namestitev artefaktov grafa zdaj atomsko zamenja dokument poti, če se je kopija v shrambi spremenila pod istim ključem, nespremenjene dokumente pa pusti pri miru; promovirane, zamenjane, preskočene in ohranjene poti poroča prek `Static_Prerender_Early_Serve::last_promotion()`.

> **7.6.10 posodobitev:** Zadetki v izvajalnem predpomnilniku zdaj zaznajo odstranjena prevedena sredstva tudi med zakasnitvijo opazovanja sprememb, ploščati izvajalni predpomnilniki pred različico 7.6 pa so atomsko premaknjeni v karanteno in izbrisani v omejenih paketih cron. Vdelane globalne spremenljivke UI se izpišejo enkrat na stran. Early Serve v načinu grafa lahko iz predpomnilnika identitet streže poti, izrisane v živo, ki niso v zemljevidu uvedenih poti. Tailwind lahko po želji izpiše datoteko predpomnilnika z zgoščeno vsebino pod `tailwind.output: "link"`; privzeto se izpisuje neposredno.

Na kratko:

- **Pregled projekta**: `Canvas::inventory()` vrne vse registrirane zapise z njihovimi viri in stabilnim vrstnim redom prikaza.
- **Ciljni izbor**: z navedbo blokov in strani se odkrivanje, sinhronizacija, izris in prevajanje omejijo na te zapise.
- **Samostojni izris**: `Blockstudio\Render` vrne dokončan HTML za blok, kompozicijo ali celoten dokument.
- **Družine komponent UI**: `Blockstudio\Ui` združi priloženo knjižnico v eno javno družino na komponento, za vsako s primerom.
- **Nespremenljive dimenzije slik**: `bs_media_image()` izriše sredstva teme z dejanskimi dimenzijami iz ustvarjenega `assets/media.json`.
- **Pomožne funkcije za razrede Tailwind**: `bs_tw_merge()` in `bs_tw_variants()` sestavljata razrede v PHP ter združujeta ob upoštevanju sporov.
- **Profili zmogljivosti**: `performance.profile` naenkrat vklopi privzete nastavitve produkcijskega sprednjega dela; podrejene vrednosti jih preglasijo.
- **Dostop do tipiziranih nastavitev**: `Settings::get_bool()` in sorodne funkcije berejo `blockstudio.json` z dejanskimi tipi ter prikažejo napake pri razčlenjevanju.
- **En imenik predpomnilnika**: vsaka ustvarjena datoteka je pod `cache.path` in je določena z identiteto izvajalnega okolja.
- **Statični vnaprejšnji izris**: anonimne dokumente HTML je mogoče predpomniti, razveljaviti prek grafa odvisnosti in streči, še preden se zažene WordPress.
- **Prednastavitve analize**: `theme`, `extreme-theme` in `wordpress-render` razširijo `blockstudio/phpstan` onkraj predlog blokov.
- **Upravljan potrditveni kavelj**: `blockstudio-githooks sync` zapiše in upravlja kavelj pred potrditvijo, ki zažene nastavljeno prednastavitev.
- **Pogodba projekta**: `blockstudio-agents` zapiše `AGENTS.md` z opisom, kaj ustvarjalci projekta pripravljajo, katere funkcije omogočajo in kaj prednastavitev uveljavlja.
- **Kazalo dokumentacije**: datoteka konteksta za UI je zdaj kazalo vseh dokumentov, njihovega namena in identifikatorjev, ki jih upravljajo.
- **Kanonične oznake blokov**: samostojni ukaz prepiše okrajšave predpon in vzdevkov v `<bs:namespace-slug>`; na voljo je tudi suhi zagon.
- **Privzeto združljivo**: nič od naštetega ne spremeni spletnega mesta, dokler ni navedeno v `blockstudio.json`.

## Branje in izris projekta

### Pregled projekta

`Canvas::inventory()` vrne vse, kar projekt registrira, kot eno navadno polje, ne da bi karkoli izrisal.

```php
use Blockstudio\Canvas;

$result = Canvas::inventory();

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

Zapisi so združeni po tipu: `pages`, `blocks`, `patterns`, `templates`,
`parts` in `ui`. `order` določa stabilni vrstni red prikaza za vse tipe,
`sources` vsak zapis poveže z njegovimi izvornimi potmi, `warnings` in `errors`
pa zbirata težave kot strukturirane vnose.

Zapisi blokov vsebujejo `id`, `name`, `title`, `source`, `path`, `provenance` in
`declaration`, pripravljen za izris. Zapisi strani ohranijo `source` kot stabilno identiteto
in `path` kot predlogo za izris.

### Ciljni izbor

Z navedbo zapisov se delo omeji že vnaprej, namesto da bi ga filtrirali naknadno.

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

To vrne en blok in eno stran. `patterns`, `templates`, `parts` in `ui`
so prazni, njihovi viri pa se nikoli ne preberejo, sinhronizirajo, izrišejo ali
prevedejo.

Pravila so natančna:

- Če ni nobenega ključa tipa, se naložijo vsi tipi.
- `true`, `null` ali `"*"` naloži vse zapise tega tipa.
- Niz ali seznam se natančno ujema po ID-ju, imenu, polžu, poti ali izvorni poti.
- Prazen niz, prazen seznam ali `false` ne naloži nobenega zapisa tega tipa.
- Ko je prisoten kateri koli ključ tipa, izpuščeni tipi ostanejo nedotaknjeni.

Identifikatorji, ki ne obstajajo več, so vrnjeni pod `deleted`, namesto da bi prišlo do napake,
in končna točka za osvežitev Canvas REST enako pravilo uporabi za parametra `blocks` in
`pages`.

`Canvas::documents()` sprejme enak izbor in doda po en izrisan dokument
za vsak zapis. Izbrane strani se izrišejo v obnovljenem kontekstu sprednjega dela, zato pogojni izrazi poizvedb, razredi telesa, kratke kode, postavitve, preusmeritve in povratni klici za vključitev sredstev vidijo to stran, ne zahteve, ki je zanjo zaprosila.

### Samostojni izris

`Blockstudio\Render` vrne izrisani HTML kot niz po istem
cevovodu, kot ga uporablja sprednji del.

```php
use Blockstudio\Render;

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

V ozadju je ena oblika deklaracije s štirimi ključi: `name`, `attributes`,
`content` in `children`. `root`, `data`, `inner`, `innerBlocks`, `layers` in
`example` so priročnejši načini vnosa, ki jih `Render::normalize()` združi v to obliko.
Podrejeni elementi se izrišejo rekurzivno, napačen vnos pa sproži izjemo, ki navede sporni blok.

`Render::document()` ovije izhod v celoten samostojni dokument HTML.

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

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

`body` je samo izhod bloka, `html` sestavljeni dokument, `blocks` imena
blokov, ki so prispevali k njemu, `assets` pa razdeli označevalno kodo na `head`,
`footer`, `styles`, `scripts`, `modules`, `interactivity`, `ui` in `tailwind`.
Sredstva so omejena na tisto, kar je bilo izrisano, zato se sredstva, namenjena samo urejevalniku, nikoli ne pojavijo.

`Render::document_from_html()` ovije HTML, ki je izrisan drugje, in
`Render::content()` izriše serializirano vsebino bloka brez dokumenta. Pokličite
`Blockstudio\Batch_Render::reset()` med dokumenti v enem procesu PHP;
`Canvas::documents()` to že naredi.

### Družine komponent UI

`Blockstudio\Ui` razkrije priloženo knjižnico UI kot en vnos na javno komponento, namesto kot seznam notranjih delov.

`Ui::inventory()` vrne en vnos na družino z njenim korenskim blokom, naslovom in potrebnimi bloki izvedbe. `Ui::examples()` doda določljivo deklaracijo za vsako družino: privzete vrednosti so ohranjene, zahtevane podrejene plasti so ugnezdene pod nadrejene, prazna polja pa dobijo stabilno ponazoritveno besedilo. Ta deklaracija je kanonična, zato gre neposredno v `Render::document()`.

Canvas združuje na enak način. Priloženi UI je prikazan pod tipom `ui`, po en primer za vsako družino, registracije izvedbenih blokov pa niso vključene v `blocks`.

Družine so zasnovane za sestavljanje: izbirnik se odpre v pogovornem oknu, seznam pa prekriva sprožilec; meniji in kombinirana polja se sidrajo s fiksnimi koordinatami pogleda, ki ostanejo nespremenjene med pomikanjem; modalna okna se zlagajo in zapirajo po eno s tipko Escape; vsaka noga pa združuje isti kontrolnik za zapiranje z različico. Kako ti stiki delujejo in katere nespremenljivosti jih ohranjajo, pojasnjuje [poglavje o sestavljanju](https://blockstudio.dev/sl/ui/composition/); [/ui/examples](https://blockstudio.dev/sl/ui/examples/) prikazuje sestave v živo.

## Pomožne predloge

### Nespremenljive dimenzije slik

`bs_media_image()` izriše sredstva teme z dejansko širino, višino in rezerviranim
razmerjem stranic, zato slike zunaj medijske knjižnice ne premikajo več postavitve.

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

Izhod je `figure.blockstudio-media` z vdelanim `aspect-ratio` okoli
`img` z dejanskimi vrednostmi `width`, `height`, `loading` in `decoding`. Dimenzije
izhajajo iz ustvarjenega `assets/media.json`, ki ga v koraku gradnje zapiše
`Blockstudio\Media_Metadata_Builder` ali se ga pripravi ročno.

`src` sprejme relativno pot znotraj teme, absolutno pot ali celoten URL, slike iz medijske knjižnice pa pokriva `attachmentId`. Z `eager` onemogočite leno nalaganje nad pregibom, `sources` pa izpiše `<picture>`.

Ko je omogočen `performance.media.lazy`, se dejanski URL premakne v `data-src` za pravilno veliko označbo mesta.

### Pomožne funkcije za razrede Tailwind

`bs_tw_merge()` in `bs_tw_variants()` sestavljata razrede Tailwind v predlogah PHP z uporabo pogona, ki ga Blockstudio že vključuje.

`bs_tw_merge('px-2 text-sm', 'px-4')` vrne `text-sm px-4`: sporni `px-2` se odstrani, uveljavi pa se poznejša vrednost. Sprejema ugnezdene polja vrednosti razredov.

`bs_tw_variants()` vrne majhno funkcijo za različice komponent:

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

To izpiše `inline-flex items-center h-12 px-6 rounded`. Podprti so osnovni razredi, različice, privzete različice, sestavljene različice ter `class` ali `className`, podana ob posameznem klicu.

## Produkcijska konfiguracija

### Profili zmogljivosti

`performance.profile` na enem mestu vklopi privzete nastavitve produkcijskega sprednjega dela.

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

`compat` je privzet in ničesar ne spreminja. `speed` in `strict` omogočita isti nabor: iz glave odstranita izpis ustvarjalca, emodžijev, virov, odkrivanja in sosednjih objav; odstranita odkrivanje oEmbed in skripte gostitelja; onemogočita XML–RPC, povratne pinge in oddaljeno odkrivanje urejevalnika; odstranita splošna jedrna sredstva sprednjega dela; uporabita privzete nastavitve za izpis slik; omejita pogostost Heartbeata zunaj urejevalnikov; vnaprej naložita dokumente z istega izvora ob nameri pomika ali fokusa; ter uporabita nalagalnik slik iz Blockstudio.

Vsaka podrejena vrednost preglasi profil, kot to velja zgoraj za `preload.links`. Najprej preverite odstranitev jedrnih sredstev sprednjega dela, saj se stran, ki je od njih odvisna, vidno pokvari. `Runtime_Settings::current()` razkrije razrešeni profil.

`themeDefaults` pokriva dve stvari, ki bi ju sicer morale teme pripraviti ročno: `titleTag` in `suppressDirectoryUpdates` za skrivanje aktivne podrejene in nadrejene teme med rezultati posodobitev.

### Dostop do tipiziranih nastavitev

`Blockstudio\Settings` bere konfiguracijo z dejanskimi tipi, namesto da bi vrnil karkoli je vseboval 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);
}
```

O napačnem JSON se poroča prek `Settings::errors()`, namesto da bi se razrešilo na privzete vrednosti. `Settings::get_raw()` vrne samo to, kar je določil aktivni vir, zato je mogoče ločiti vrednost, nastavljeno na `false`, od vrednosti, ki ni bila nikoli nastavljena.

`Settings::fingerprint()` vrne stabilno identiteto učinkovitih nastavitev,
dostop do njih pa jih znova naloži, ko se spremeni `blockstudio.json`.

### En imenik predpomnilnika

Vsaka ustvarjena datoteka je zdaj shranjena pod `cache.path`, ki je privzeto `wp-content/blockstudio/cache`.

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

Tovori gradnje, podatki registracije blokov, sredstva urejevalnika, prevedeni Tailwind CSS,
dokumenti izrisa, fragmenti otokov, statični HTML, indeksi grafov, čakalne vrste za ogrevanje in diagnostika so vsi pod tem korenom. Relativna pot se razreši glede na `WP_CONTENT_DIR`, absolutna pot pa ga usmeri na namenski nosilec.

Objekti so razvrščeni glede na trenutno omrežje in spletno mesto, nato pa glede na identiteto izvajalnega okolja: prstni odtis različic Blockstudio, WordPress in PHP, učinkovitih nastavitev, aktivne teme in vtičnikov, virov za odkrivanje ter vključenih izvornih datotek. Ko se vhod spremeni, nastanejo novi zadevni objekti, stari pa se odstranijo.

Hladne gradnje se izvajajo enkrat: ena zahteva zgradi in atomsko objavi rezultat, druge pa počakajo. Če osvežitev spodleti, se še naprej streže zadnji dober objekt, napaka pa ostane vidna; `Blockstudio\Runtime_Cache::purge('tailwind')` počisti en obseg.

## Statični vnaprejšnji izris

Statični vnaprejšnji izris predpomni celotne anonimne dokumente HTML in jih lahko streže, še preden se zažene WordPress. Privzeto je izklopljen.

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

### Pogoji za vključitev

Vključiti je mogoče samo celotne anonimne dokumente HTML. Zahteve, ki niso GET, poizvedbeni nizi, skrbniški del, REST, Ajax, cron, viri, iskanje, predogledi, zahteve z nonce, personalizirani piškotki in vse poti pod `dynamicPaths` se preskočijo.
Odgovor se lahko v celoti izvzame z označevalnikom `<!-- blockstudio:no-cache -->`.

Ujemanje poti upošteva meje, zato `/account` zajema `/account/orders`, ne pa `/accounting`.

### Načina podpisa in grafa

`invalidate` določa, kako vnosi potečejo. Privzeti način `signature` ob anonimni zahtevi brez zadetka napolni odziv, določen z identiteto, po spremembah na ravni spletnega mesta pa zamenja identiteto; primeren je za običajno spletno mesto.

Način `graph` je namenjen izrecnim orodjem za gradnjo in uvedbo. Beleži izvorne odvisnosti vsake strani, zato načrt znova zgradi le prizadete URL-je.

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

### Zgodnje streženje

Ko je omogočen `earlyServe`, Blockstudio upravlja majhen zemljevid poti za vsako spletno mesto in dodatek `advanced-cache.php`, ki primerni zadetek pretaka še pred zagonom WordPress, vtičnikov ali teme.

Nikoli ne prepiše tujega zemljevida, dodatka ali deklaracije `WP_CACHE`. Pred zamenjavo zemljevida artefakt grafa preveri vsako navedeno datoteko HTML, zato ob delni uvedbi prejšnji graf ostane aktiven. Vnosi za večmestno namestitev so ločeni glede na gostitelja, domačo pot in ID spletnega mesta.

### Ogrevanje in stanje

Tri ukazi WP-CLI pokrivajo vsakodnevno uporabo:

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

`status` poroča o aktivni identiteti, številu datotek in bajtov, zapisih grafa, stanju čakalne vrste ter števcih zadetkov, zgrešenih poizvedb, gradenj in napak za vsak obseg.

## Analiza in orodja za agente

### Prednastavitve analize

`blockstudio/phpstan` pridobi tri plasti nad svojo analizo blokov in en ukaz, ki zažene plast, ki jo je izbral projekt.

| Prednastavitev | Kaj vključuje |
| --- | --- |
| `base` | Obstoječo analizo shem, predlog, kavljev, nastavitev in API. |
| `theme` | Korenike tem, glave slogov, sredstva, omejevanje obsega izbirnikov, privzete vrednosti polj, omejitve ponavljalnikov. |
| `extreme-theme` | Preverjanja PHPStan `max`, nevarnih PHP, ubežnih znakov, Tailwind, JavaScript in interaktivnosti. |
| `wordpress-render` | Preizkus izrisa v živo, ki ga poda klicatelj, poleg `extreme-theme`. |

Privzete vrednosti izvirajo iz `blockstudio.json`, zato interaktivni zagoni, CI in potrditveni kavlji uporabljajo isto konfiguracijo:

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

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

Kode izhoda so `0` ob uspehu, `1` ob diagnostiki in `2` pri neveljavni uporabi. Ovojnica sestavi konfiguracijo v sistemskem začasnem imeniku, zato se ustvarjena konfiguracija, osnovno stanje ali predpomnilnik ne shranijo v projekt; omejitev pomnilnika za PHPStan pa poveča na `1G`.

Ponuja tudi ponudnika BC Math, zato preverjanja JavaScript ne potrebujejo več `ext-bcmath`.

### Upravljan potrditveni kavelj

Ena nastavitev in en ukaz spremenita izbrano prednastavitev v pogoj za potrditev.

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

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

Sinhronizacija zapiše kavelj in zapis o lastništvu v skupni imenik Git, usmeri `core.hooksPath` v upravljani imenik ter poveže predhodno nastavljen kavelj pred potrditvijo. Kavelj ob potrditvi razreši koren skladišča in projekta, zato delujejo povezane delovne kopije in poti s presledki.

Kavelj zažene `vendor/bin/blockstudio-phpstan` in ničesar drugega; datotek nikoli ne oblikuje ali prepisuje. Če nastavitev `commit` spremenite v `false` in znova sinhronizirate ali zaženete `blockstudio-githooks remove`, se obnovi zabeležena pot kavlja in izbrišejo samo datoteke v lasti Blockstudio.

### Pogodba projekta

`blockstudio-agents` zapiše `AGENTS.md`, ki določa, kje so bloki, kaj v tem projektu pomeni stran, katere funkcije so omogočene in kaj bo analizator zavrnil.

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

Dokument je izpeljan, ne temelji na predlogi. Pogodba teme z glavo `style.css`, bloki in stranmi, ki temeljijo na datotekah, se razlikuje od pogodbe vtičnika, ki registrira le bloke; vsebuje števila, imenike, imenske prostore in jezike predlog, ki jih je našel pregledovalnik. `blockstudio.json` določa, katere funkcije so prikazane, zato projekt brez statičnega vnaprejšnjega izrisa o njem ne omenja.

Razdelek o pravilnosti se bere iz datotek pravil izbrane prednastavitve, plast za plastjo, zato se vsaka ustvarjena pogodba spremeni, ko prednastavitev pridobi novo pravilo.

Lastništvo deluje podobno kot pri potrditvenem kavlju. Če datoteka nima označevalnika ustvarjene vsebine, je ni mogoče prepisati, razen če `--force` določa drugače; območje z opombami na koncu se ohrani pri ponovnem ustvarjanju; `--check` se konča z izhodno kodo `1`, če je pogodba zastarela; `--stdout` pa jo izpiše, ne da bi posegel v datotečni sistem.

### Kazalo dokumentacije

`blockstudio-llm.txt` je zdaj kazalo namesto združene vsebine. Vsak objavljeni dokument je naveden enkrat, v svojem razdelku in podrazdelku, skupaj s svojo potjo, izvorno datoteko, enovrstičnim opisom namena in identifikatorji, ki jih upravlja: potmi nastavitev, imeni kavljev, funkcijami in razredi PHP ter ukazi.

```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 prebere kazalo, poišče dokument, ki vsebuje iskani identifikator, in ga odpre. Prejšnja združena datoteka velikosti pol megabajta se še vedno ustvari in objavi na `/blockstudio-llm-full.txt`; ni pa več prva stvar, ki jo kdo dobi.

## Kanonične oznake blokov

Samostojen ukaz prepiše okrajšave predpon in vzdevkov v kanonično obliko `<bs:namespace-slug>`, ki zabeleži pravo ime bloka in se razreši brez naloženega projektnega filtra.

S predpono `brand` za `theme-components` in predpono `ui` za `bsui` ta okrajšava:

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

pomeni enako kot:

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

Predpone in natančni vzdevki še vedno delujejo in niso opuščeni. Ukaz ne naloži WordPress in ne zapiše ničesar brez `--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` preslika vsako predpono v njene imenske prostore, `--known-blocks` pa navede registrirana imena blokov. Poročilo zabeleži preslikave iz zastarelih v kanonične oznake s številom pojavitev, zgoščenimi vrednostmi posameznih datotek ter ločenimi seznami neznanih oznak, dvoumnih vzdevkov in dinamičnih oznak. `--apply` zavrne zapis, dokler katera od teh postavk še obstaja, razen če je podan `--allow-unresolved`.

Obravnavani so seznanjeni, ugnezdeni in samozapiralni označevalni elementi, vključno z dobesednimi oznakami v nizih PHP. Spremenijo se samo imena oznak, drugi zagon ne povzroči sprememb, primeri v komentarjih, blokih kode, `<pre>` ali `<code>` pa so prikazani samo v poročilu.

## Privzeto delovanje

Namestitev različice 7.6 sama po sebi ničesar ne spremeni.

**Profil zmogljivosti je privzeto nastavljen na `compat`.** Izhod v glavi, oEmbed, XML-RPC, Heartbeat, privzete nastavitve slik, vnaprejšnje nalaganje povezav, leno nalaganje in frontend `<title>` ostanejo takšni, kot so jih nastavili WordPress in tema.

**Te možnosti ostanejo izklopljene, dokler jih ne omogočite:** vsak ključ `performance.staticPrerender`, `performance.measurement`, `performance.media` in `themeDefaults` ter `githooks.commit`, `dev.canvas.enabled`, `ui.enabled`, `tailwind.enabled` in `blockTags.enabled`. Statično vnaprejšnje upodabljanje med izklopom ne ustvari datotek in ne namesti dodatka.

**Canvas in Render sta pasivna.** Prebereta obstoječe registre in upodobita samo tisto, kar zahteva klicatelj; ne posegata v izhod frontenda in ne registrirata poti. Za skrbniški zaslon Canvas sta še vedno potrebna `dev.canvas.enabled` in `edit_posts`.

**Strožjo analizo morate izrecno določiti.** Namestitev `blockstudio/phpstan` omogoči samo osnovno razširitev, kanonični ukaz pa zažene `base`, razen če projekt določi prednastavitev.

**Ustvarjene datoteke zahtevajo zagon ustreznega ukaza.** `githooks.commit` ne naredi ničesar, dokler se ne zažene `blockstudio-githooks sync`, prav tako `AGENTS.md` ne naredi ničesar, dokler se ne zažene `blockstudio-agents`.

## Nadgradnja z različice 7.5

Zahteve ostajajo nespremenjene: PHP 8.2 ali novejši, WordPress 6.7 ali novejši.

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

**Predpomnilniki se enkrat znova zgradijo.** Identiteta izvajalnega okolja vključuje različico Blockstudio, zato je prva zahteva po nadgradnji neogreta, stari objekti pa se odstranijo. Stari predpomnilnik Tailwind v `wp-content/uploads/blockstudio/tailwind/cache` lahko izbrišete; delček kode, ki je uporabljal vzorec glob zanj, naj namesto tega pokliče `Blockstudio\Runtime_Cache::purge('tailwind')`.

Imenik `wp-content/blockstudio/cache/runtime` v stari ploščati strukturi pred različico 7.6 se samodejno preimenuje in odstrani iz aktivne poti, nato pa se izbriše v omejenih prehodih WP-Cron. Zato velikih dreves starih zaklepnih datotek med zahtevo za uvedbo ni treba brisati.

**Ustvarjene datoteke imajo določene lastnike.** `assets/media.json` sodi v nadzor različic ali v gradbeni korak. Zemljevid poti, dodatna datoteka `advanced-cache.php` in deklaracija `WP_CACHE` obstajajo samo, dokler je omogočen `earlyServe`, kavelj pred potrditvijo pa samo, dokler je sinhroniziran. Vse drugo ustvarjeno je shranjeno pod `cache.path` in ga lahko varno izbrišete.

**Nič ni bilo odstranjeno ali preimenovano.** `bs_render_block()`, `bs_block()`, `Blockstudio\Pages` in `Blockstudio\Patterns` ostajajo kanonična vsebinska območja, ki temeljijo na datotekah.

**Vrnitev na prejšnje stanje poteka za vsako funkcijo posebej.** Vrnitev `performance.profile` na `compat`, `staticPrerender.enabled` na `false`, `githooks.commit` na `false` skupaj z `sync` ter `cache.enabled` na `false` vsakič razveljavi eno plast.

Smiseln vrstni red uvedbe:

1. Nastavite `performance.profile` na `speed`, nato preverite izhod v glavi, vire in vse vtičnike, ki se zanašajo na oEmbed ali XML-RPC.
2. Ustvarite `assets/media.json`, premaknite predloge v `bs_media_image()`, nato omogočite `performance.media.lazy`.
3. Omogočite `performance.staticPrerender` z izklopljenim `earlyServe`, preverite zadetke z `wp bs prerender status`, nato vklopite `earlyServe`.
4. Zaženite `blockstudio-phpstan --preset theme` in ga očistite, preden katero koli prednastavitev določite v `githooks.commit`.

## Kje so podrobnosti

- [Canvas](https://blockstudio.dev/sl/docs/dev/canvas/) in njegov [inventarAPI dokumentov](https://blockstudio.dev/sl/docs/dev/canvas/#public-inventory-and-document-api)
- [Upodabljanje](https://blockstudio.dev/sl/docs/blocks/rendering/#structured-compositions-and-complete-documents), [KomponenteUI](https://blockstudio.dev/sl/ui/#public-inventory-and-examples) in [SestavljanjeUI](https://blockstudio.dev/sl/ui/composition/)
- [Nastavitve](https://blockstudio.dev/sl/docs/general/settings/) in [zmogljivost](https://blockstudio.dev/sl/docs/general/settings/#performance)
- [Zmogljivost](https://blockstudio.dev/sl/docs/production/performance/), [Predpomnjenje](https://blockstudio.dev/sl/docs/production/caching/) in [Statično vnaprejšnje upodabljanje](https://blockstudio.dev/sl/docs/production/static-prerendering/)
- [Tailwind CSS](https://blockstudio.dev/sl/docs/tailwind/#template-composition-helpers)
- [PHPStan](https://blockstudio.dev/sl/docs/dev/phpstan/): [prednastavitve](https://blockstudio.dev/sl/docs/dev/phpstan/#analysis-presets), [kanonični ukaz](https://blockstudio.dev/sl/docs/dev/phpstan/#canonical-command), [upravljani kavelj potrditve](https://blockstudio.dev/sl/docs/dev/phpstan/#managed-commit-hook) in [pogodba projekta](https://blockstudio.dev/sl/docs/dev/phpstan/#project-contract-for-coding-agents)
- [Integracija z AI](https://blockstudio.dev/sl/docs/dev/ai/): kazalo dokumentacije in celotno besedilo
- [Selitev](https://blockstudio.dev/sl/docs/dev/migration/v7/#canonical-block-tags) in [KavljiPHP](https://blockstudio.dev/sl/docs/blocks/hooks/php/)
