
Το Blockstudio 7.6 επιτρέπει την ανάγνωση και απόδοση ενός έργου από το PHP και μεταφέρει τις προεπιλογές frontend παραγωγής στο `blockstudio.json`: απογραφή API, αυτόνομη απόδοση, βοηθητικές συναρτήσεις προτύπων για πολυμέσα και Tailwind, προφίλ επιδόσεων, έναν κατάλογο cache, στατική προαπόδοση με έγκαιρη εξυπηρέτηση, αυστηρότερα προφίλ ανάλυσης και παραγόμενα εργαλεία έργου για coding agents.

Δύο κλήσεις καλύπτουν το μεγαλύτερο μέρος της έκδοσης. Το `Canvas::inventory()` επιστρέφει κάθε σελίδα, block, μοτίβο, πρότυπο Site Editor, τμήμα προτύπου και ενσωματωμένο παράδειγμα UI που έχει καταχωρίσει ένα έργο. Το `Render::document()` επιστρέφει έτοιμο HTML για οποιοδήποτε από αυτά, μαζί με ακριβώς τα στοιχεία που χρησιμοποίησε η απόδοση.

> **Ενημέρωση 7.6.2:** Οι σελίδες από αρχεία δεν συγχρονίζονται πλέον κατά τα συνήθη αιτήματα WordPress. Εκτελέστε το `wp bs pages sync` ή καλέστε το `Blockstudio\Pages::reconcile()` κατά την εφαρμογή αλλαγών πηγής. Η δρομολόγηση συλλογών και οι προεπιλογές του `templateFor` χρησιμοποιούν μόνιμα αποθηκευμένες ρυθμίσεις runtime, ενώ η ρητή συμφωνία αποφεύγει το προηγούμενο μεγάλο ερώτημα OR-meta για πολλές γλώσσες. Η επιλογή `themeDefaults.syncPagesInDevelopment` μικρής διάρκειας αφαιρέθηκε, επειδή ο συγχρονισμός σελίδων δεν εκτελείται πλέον από hooks αιτημάτων. Το `Pages::init()` χρησιμοποιείται πλέον μόνο κατά την αρχικοποίηση· οι ενσωματώσεις που περνούσαν το `force` πρέπει να χρησιμοποιούν το `Pages::reconcile()` ή το CLI. Το άνοιγμα του Canvas εξακολουθεί να εκτελεί μία ρητή, πιστοποιημένη συμφωνία για την απογραφή συγγραφής.

> **7.6.12 ενημέρωση:** Τα φύλλα στυλ του επεξεργαστή αποκτούν πλέον πρόθεμα σε ένα μόνο
> πέρασμα επανεγγραφής, αντί για μεταγλώττιση SASS ανά στοιχείο, ώστε μια ψυχρή δημιουργία του επεξεργαστή σε
> ιστότοπο με πολλά blocks να μην κινδυνεύει πλέον να εξαντλήσει ένα περιορισμένο όριο μνήμης. Μια
> αποθηκευμένη στην προσωρινή μνήμη προ-αποδοσμένη σελίδα της οποίας το φύλλο στυλ Tailwind με κατακερματισμό περιεχομένου έχει
> εκκαθαριστεί αποδίδεται ξανά αντί να εμφανιστεί χωρίς στυλ, τόσο μέσω της προσωρινής μνήμης PHP
> όσο και μέσω του drop-in Early Serve. Τα γνωρίσματα block που γράφονται στο ανώτατο επίπεδο
> διαβάζονται κατά την απόδοση αντί να απορρίπτονται, οπότε το σχήμα Blockstudio
> που καταχωρίζεται στο `WP_Block_Type` τηρείται από προγραμματισμένους writers.

> **7.6.11 ενημέρωση:** Η εγκατάσταση τεχνουργημάτων γραφήματος αντικαθιστά πλέον ατομικά το έγγραφο μιας διαδρομής
> όταν αλλάξει το αντίγραφο στο store με το ίδιο κλειδί, αφήνει ανέπαφα τα
> πανομοιότυπα έγγραφα και αναφέρει τις διαδρομές που προωθήθηκαν, αντικαταστάθηκαν, παραλείφθηκαν και διατηρήθηκαν μέσω του `Static_Prerender_Early_Serve::last_promotion()`.

> **7.6.10 ενημέρωση:** Οι επιτυχίες της προσωρινής μνήμης χρόνου εκτέλεσης εντοπίζουν πλέον αφαιρεμένα μεταγλωττισμένα στοιχεία ακόμη
> και μέσα στην καθυστέρηση αποσφαλμάτωσης της παρακολούθησης, ενώ οι επίπεδες προσωρινές μνήμες χρόνου εκτέλεσης πριν από την 7.6 απομονώνονται και διαγράφονται ατομικά σε παρτίδες cron με όριο μεγέθους. Τα καθολικά στοιχεία UI που περιλαμβάνονται στο πακέτο εκπέμπονται μία φορά
> ανά σελίδα. Το Early Serve σε λειτουργία γραφήματος μπορεί να εξυπηρετεί διαδρομές που αποδίδονται ζωντανά, εκτός του
> αναπτυγμένου χάρτη διαδρομών, από την προσωρινή μνήμη ταυτότητας. Το Tailwind μπορεί προαιρετικά να εκπέμπει το αρχείο προσωρινής μνήμης με κατακερματισμό περιεχομένου με `tailwind.output: "link"`· η ενσωματωμένη έξοδος παραμένει
> η προεπιλογή.

Εν συντομία:

- **Απογραφή έργου**: Το `Canvas::inventory()` επιστρέφει κάθε καταχωρισμένη εγγραφή
  μαζί με τις πηγές της και σταθερή σειρά εμφάνισης.
- **Στοχευμένη επιλογή**: Η ονομασία blocks και σελίδων περιορίζει τον εντοπισμό, τον συγχρονισμό,
  την απόδοση και τη μεταγλώττιση σε αυτές τις εγγραφές.
- **Αυτόνομη απόδοση**: Το `Blockstudio\Render` επιστρέφει ολοκληρωμένο HTML για ένα
  block, μια σύνθεση ή ένα πλήρες έγγραφο.
- **Οικογένειες στοιχείων UI**: Το `Blockstudio\Ui` ομαδοποιεί τη βιβλιοθήκη που περιλαμβάνεται στο πακέτο
  σε μία δημόσια οικογένεια ανά στοιχείο, με ένα παράδειγμα για καθεμία.
- **Σταθερές διαστάσεις εικόνας**: Το `bs_media_image()` αποδίδει στοιχεία θέματος με πραγματικές
  διαστάσεις από ένα δημιουργημένο `assets/media.json`.
- **Βοηθητικές συναρτήσεις κλάσεων Tailwind**: Τα `bs_tw_merge()` και `bs_tw_variants()` συνθέτουν
  κλάσεις στο PHP με συγχώνευση που λαμβάνει υπόψη τις συγκρούσεις.
- **Προφίλ επιδόσεων**: Το `performance.profile` ενεργοποιεί μονομιάς τις προεπιλογές του frontend παραγωγής· οι τιμές των θυγατρικών ρυθμίσεων υπερισχύουν.
- **Πρόσβαση σε τυποποιημένες ρυθμίσεις**: Το `Settings::get_bool()` και τα αντίστοιχά του διαβάζουν
  `blockstudio.json` με πραγματικούς τύπους και εμφανίζουν σφάλματα ανάλυσης.
- **Ένας κατάλογος προσωρινής μνήμης**: Κάθε δημιουργημένο αρχείο βρίσκεται κάτω από το `cache.path`, με κλειδί
  μια ταυτότητα χρόνου εκτέλεσης.
- **Στατική προ-απόδοση**: Ανώνυμα έγγραφα HTML μπορούν να αποθηκευτούν στην προσωρινή μνήμη, να ακυρωθούν μέσω ενός
  γράφου εξαρτήσεων και να προβληθούν πριν από την εκκίνηση του WordPress.
- **Προεπιλογές ανάλυσης**: Τα `theme`, `extreme-theme` και `wordpress-render` επεκτείνουν
  το `blockstudio/phpstan` πέρα από τα πρότυπα block.
- **Διαχειριζόμενο άγκιστρο commit**: Το `blockstudio-githooks sync` δημιουργεί και διαχειρίζεται ένα
  άγκιστρο pre-commit που εκτελεί την επιλεγμένη προεπιλογή.
- **Σύμβαση έργου**: Το `blockstudio-agents` δημιουργεί ένα `AGENTS.md` που περιγράφει
  τι δημιουργεί το έργο, ποιες δυνατότητες ενεργοποιεί και τι επιβάλλει η προεπιλογή του.
- **Ευρετήριο τεκμηρίωσης**: Το αρχείο περιβάλλοντος AI είναι πλέον ευρετήριο κάθε
  εγγράφου, του σκοπού του και των αναγνωριστικών που του ανήκουν.
- **Κανονικές ετικέτες block**: Μια αυτόνομη εντολή ξαναγράφει συντομογραφίες προθεμάτων και ψευδωνύμων ως `<bs:namespace-slug>`, με δυνατότητα δοκιμαστικής εκτέλεσης.
- **Συμβατότητα από προεπιλογή**: Τίποτα από τα παραπάνω δεν αλλάζει έναν ιστότοπο μέχρι να κατονομαστεί στο `blockstudio.json`.

## Ανάγνωση και απόδοση ενός έργου

### Απογραφή έργου

Το `Canvas::inventory()` επιστρέφει όλα όσα καταχωρίζει ένα έργο σε έναν απλό πίνακα,
χωρίς να αποδώσει τίποτα.

```php
use Blockstudio\Canvas;

$result = Canvas::inventory();

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

Οι εγγραφές ομαδοποιούνται ανά τύπο: `pages`, `blocks`, `patterns`, `templates`,
`parts` και `ui`. Το `order` είναι η σταθερή σειρά εμφάνισης σε όλους τους τύπους,
το `sources` αντιστοιχίζει κάθε εγγραφή στις διαδρομές προέλευσής της και τα `warnings` και `errors`
συγκεντρώνουν προβλήματα ως δομημένες καταχωρίσεις.

Οι εγγραφές block περιλαμβάνουν τα `id`, `name`, `title`, `source`, `path`, `provenance` και ένα `declaration` έτοιμο για απόδοση. Οι εγγραφές σελίδων διατηρούν το `source` ως σταθερή ταυτότητα
και το `path` ως το πρότυπο που αποδίδει.

### Στοχευμένη επιλογή

Η ονομασία εγγραφών περιορίζει την εργασία, αντί να γίνεται φιλτράρισμα εκ των υστέρων.

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

Αυτό επιστρέφει ένα block και μία σελίδα. Τα `patterns`, `templates`, `parts` και `ui`
επιστρέφουν κενά και οι πηγές τους δεν διαβάζονται, συγχρονίζονται, αποδίδονται ή
μεταγλωττίζονται ποτέ.

Οι κανόνες είναι ακριβείς:

- Χωρίς καθόλου κλειδιά τύπων, φορτώνονται όλοι οι τύποι.
- Τα `true`, `null` ή `"*"` φορτώνουν όλες τις εγγραφές αυτού του τύπου.
- Μια συμβολοσειρά ή λίστα αντιστοιχίζεται ακριβώς σε ID, όνομα, slug, διαδρομή ή διαδρομή πηγής.
- Μια κενή συμβολοσειρά, μια κενή λίστα ή το `false` δεν φορτώνουν καμία εγγραφή αυτού του τύπου.
- Μόλις υπάρχει οποιοδήποτε κλειδί τύπου, οι τύποι που παραλείπονται παραμένουν ανέγγιχτοι.

Αναγνωριστικά που δεν υπάρχουν πλέον επιστρέφονται κάτω από το `deleted` αντί να προκαλείται αποτυχία,
και το τελικό σημείο ανανέωσης REST του Canvas εφαρμόζει τον ίδιο κανόνα στις παραμέτρους `blocks` και
`pages` του.

Το `Canvas::documents()` δέχεται την ίδια επιλογή και προσθέτει ένα αποδοσμένο έγγραφο
ανά εγγραφή. Οι επιλεγμένες σελίδες αποδίδονται σε αποκατεστημένο περιβάλλον frontend, ώστε οι συνθήκες ερωτημάτων,
οι κλάσεις body, τα shortcodes, οι διατάξεις, οι ανακατευθύνσεις και οι συναρτήσεις enqueue να βλέπουν εκείνη τη σελίδα
και όχι το αίτημα που ζήτησε την απόδοσή της.

### Αυτόνομη απόδοση

Το `Blockstudio\Render` επιστρέφει αποδοσμένο HTML ως συμβολοσειρά, μέσω της ίδιας
διαδικασίας που χρησιμοποιεί το frontend.

```php
use Blockstudio\Render;

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

Υπάρχει από κάτω ένα σχήμα δήλωσης με τέσσερα κλειδιά: `name`, `attributes`,
`content` και `children`. Τα `root`, `data`, `inner`, `innerBlocks`, `layers` και
`example` είναι διευκολύνσεις εισόδου που το `Render::normalize()` ενσωματώνει σε αυτό.
Τα παιδιά αποδίδονται αναδρομικά και η κακοσχηματισμένη είσοδος προκαλεί εξαίρεση που κατονομάζει το
προβληματικό block.

Το `Render::document()` περιβάλλει την έξοδο με ένα πλήρες αυτόνομο έγγραφο HTML.

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

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

Το `body` είναι μόνο η έξοδος του block, το `html` το συναρμολογημένο έγγραφο, το `blocks` τα
ονόματα των block που συνέβαλαν και το `assets` χωρίζει τη σήμανση σε `head`,
`footer`, `styles`, `scripts`, `modules`, `interactivity`, `ui` και `tailwind`.
Τα στοιχεία περιορίζονται σε όσα αποδόθηκαν, επομένως δεν εμφανίζονται ποτέ στοιχεία που αφορούν μόνο τον επεξεργαστή.

Το `Render::document_from_html()` περιβάλλει το HTML που αποδόθηκε αλλού, ενώ το
`Render::content()` αποδίδει σειριοποιημένο περιεχόμενο block χωρίς έγγραφο. Καλέστε το
`Blockstudio\Batch_Render::reset()` ανάμεσα σε έγγραφα μέσα στην ίδια διεργασία PHP·
το `Canvas::documents()` το κάνει ήδη.

### Οικογένειες στοιχείων UI

Το `Blockstudio\Ui` εκθέτει τη βιβλιοθήκη UI που περιλαμβάνεται στο πακέτο ως μία καταχώριση ανά δημόσιο
στοιχείο αντί για λίστα εσωτερικών μερών.

Το `Ui::inventory()` επιστρέφει μία καταχώριση ανά οικογένεια, μαζί με το block ρίζας, τον τίτλο και
τα block υλοποίησης που χρειάζεται. Το `Ui::examples()` προσθέτει μια ντετερμινιστική
δήλωση ανά οικογένεια: οι προεπιλογές διατηρούνται, τα απαιτούμενα θυγατρικά επίπεδα τοποθετούνται κάτω από
τους γονείς τους και προστίθεται σταθερό ενδεικτικό κείμενο όπου ένα πεδίο θα ήταν κενό. Αυτή
η δήλωση είναι κανονική, επομένως περνά απευθείας στο `Render::document()`.

Το Canvas ομαδοποιεί με τον ίδιο τρόπο. Τα UI που περιλαμβάνονται στο πακέτο εμφανίζονται κάτω από τον τύπο `ui` ως ένα
παράδειγμα ανά οικογένεια, ενώ οι καταχωρίσεις υλοποίησης δεν εμφανίζονται στο `blocks`.

Οι οικογένειες έχουν σχεδιαστεί για σύνθεση: ένα select ανοίγει μέσα σε διάλογο, με το listbox να επικαλύπτει το στοιχείο ενεργοποίησης,
τα μενού και τα combobox αγκυρώνονται με σταθερές συντεταγμένες προβολής που παραμένουν σωστές κατά την κύλιση, τα modal στοιβάζονται και κλείνουν με ένα Escape κάθε φορά,
και κάθε υποσέλιδο συνθέτει το ίδιο στοιχείο ελέγχου κλεισίματος με μια παραλλαγή. Το πώς
λειτουργούν αυτές οι συνδέσεις και οι αμετάβλητες συνθήκες που τις διατηρούν, εξηγούνται στο
[κεφάλαιο σύνθεσης](https://blockstudio.dev/el/ui/composition/)· το [/ui/examples](https://blockstudio.dev/el/ui/examples/) παρουσιάζει τις συνθέσεις σε λειτουργία.

## Βοηθητικές συναρτήσεις προτύπων

### Σταθερές διαστάσεις εικόνας

Το `bs_media_image()` αποδίδει στοιχεία θέματος με πραγματικό πλάτος και ύψος, καθώς και δεσμευμένο
λόγο διαστάσεων, ώστε οι εικόνες εκτός της βιβλιοθήκης πολυμέσων να μην προκαλούν πλέον μετατοπίσεις στη διάταξη.

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

Η έξοδος είναι ένα `figure.blockstudio-media` με ενσωματωμένο `aspect-ratio` γύρω
από ένα `img` που φέρει πραγματικά `width`, `height`, `loading` και `decoding`. Οι διαστάσεις
προέρχονται από ένα δημιουργημένο `assets/media.json`, το οποίο γράφεται από το
`Blockstudio\Media_Metadata_Builder` σε βήμα της διαδικασίας δημιουργίας ή με μη αυτόματο τρόπο.

Το `src` δέχεται μια διαδρομή σχετική με το θέμα, μια απόλυτη διαδρομή ή ένα πλήρες URL, ενώ το
`attachmentId` καλύπτει εικόνες της βιβλιοθήκης πολυμέσων. Το `eager` παραλείπει τη νωχελική φόρτωση
πάνω από το πρώτο τμήμα της σελίδας και το `sources` εκπέμπει ένα `<picture>`.

Όταν είναι ενεργοποιημένο το `performance.media.lazy`, το πραγματικό URL μεταφέρεται στο `data-src` πίσω από ένα
σωστά διαστασιολογημένο σύμβολο κράτησης θέσης.

### Βοηθητικές συναρτήσεις κλάσεων Tailwind

Τα `bs_tw_merge()` και `bs_tw_variants()` συνθέτουν κλάσεις Tailwind σε πρότυπα PHP,
χρησιμοποιώντας τη μηχανή Blockstudio που ήδη περιλαμβάνει το πακέτο.

Το `bs_tw_merge('px-2 text-sm', 'px-4')` επιστρέφει `text-sm px-4`: το αντικρουόμενο
`px-2` απορρίπτεται και υπερισχύει η μεταγενέστερη τιμή. Γίνονται δεκτοί ένθετοι πίνακες τιμών κλάσεων.

Το `bs_tw_variants()` επιστρέφει μια μικρή κλήσιμη συνάρτηση για παραλλαγές στοιχείων:

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

Αυτό εκτυπώνει `inline-flex items-center h-12 px-6 rounded`. Υποστηρίζονται βασικές κλάσεις,
παραλλαγές, προεπιλεγμένες παραλλαγές, σύνθετες παραλλαγές και ένα `class` ή `className` ανά κλήση.

## Ρυθμίσεις παραγωγής

### Προφίλ επιδόσεων

Το `performance.profile` ενεργοποιεί τις προεπιλογές του frontend παραγωγής από ένα σημείο.

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

Το `compat` είναι η προεπιλογή και δεν αλλάζει τίποτα. Τα `speed` και `strict` ενεργοποιούν το
ίδιο σύνολο: αφαιρούνται από την κεφαλή οι πληροφορίες δημιουργού, emoji, τροφοδοσιών, ανακάλυψης και γειτονικών αναρτήσεων· αφαιρούνται οι πληροφορίες ανακάλυψης oEmbed και τα σενάρια του διακομιστή· απενεργοποιούνται τα XML-RPC, τα pingback
και η απομακρυσμένη ανακάλυψη επεξεργαστή· αφαιρούνται τα γενικά στοιχεία frontend του πυρήνα· εφαρμόζονται οι προεπιλογές εξόδου εικόνας· περιορίζεται ο ρυθμός του Heartbeat εκτός των επεξεργαστών· γίνεται προφόρτωση εγγράφων ίδιας προέλευσης κατά την πρόθεση αιώρησης ή εστίασης· και χρησιμοποιείται ο φορτωτής εικόνων του Blockstudio.

Κάθε θυγατρική τιμή υπερισχύει του προφίλ, όπως κάνει παραπάνω το `preload.links`. Η αφαίρεση των στοιχείων frontend του πυρήνα είναι η πρώτη που πρέπει να δοκιμαστεί, επειδή μια σελίδα που εξαρτάται από
αυτά θα παρουσιάσει εμφανή προβλήματα. Το `Runtime_Settings::current()` εμφανίζει το προφίλ που προκύπτει.

Το `themeDefaults` καλύπτει δύο εργασίες που διαφορετικά θα έπρεπε να υλοποιούν τα θέματα: τα `titleTag` και
`suppressDirectoryUpdates`, ώστε το ενεργό θυγατρικό και γονικό θέμα να αποκρύπτονται από τα αποτελέσματα ενημερώσεων.

### Πρόσβαση σε τυποποιημένες ρυθμίσεις

Το `Blockstudio\Settings` διαβάζει τις ρυθμίσεις με πραγματικούς τύπους αντί να επιστρέφει
ό,τι περιείχε το JSON.

```php
use Blockstudio\Settings;

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

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

Η κακοσχηματισμένη τιμή JSON αναφέρεται μέσω του `Settings::errors()` αντί να καταλήγει σε
προεπιλογές. Το `Settings::get_raw()` επιστρέφει μόνο όσα δήλωσε η ενεργή πηγή,
διαχωρίζοντας έτσι μια τιμή που ορίστηκε ως `false` από μια τιμή που δεν ορίστηκε ποτέ.

Το `Settings::fingerprint()` επιστρέφει μια σταθερή ταυτότητα για τις ισχύουσες ρυθμίσεις,
και η πρόσβαση επαναφορτώνει τα δεδομένα όταν αλλάζει το `blockstudio.json`.

### Ένας κατάλογος προσωρινής μνήμης

Κάθε δημιουργημένο αρχείο βρίσκεται πλέον κάτω από το `cache.path`, με προεπιλεγμένη τιμή
`wp-content/blockstudio/cache`.

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

Τα ωφέλιμα φορτία δημιουργίας, τα δεδομένα καταχώρισης block, τα στοιχεία επεξεργαστή, τα μεταγλωττισμένα Tailwind CSS,
τα έγγραφα απόδοσης, τα τμήματα island, τα στατικά HTML, τα ευρετήρια γραφήματος, οι ουρές προθέρμανσης και
τα διαγνωστικά βρίσκονται όλα κάτω από αυτή τη ρίζα. Μια σχετική διαδρομή επιλύεται με αφετηρία το
`WP_CONTENT_DIR`, ενώ μια απόλυτη διαδρομή την κατευθύνει σε έναν αποκλειστικό τόμο.

Τα αντικείμενα αποθηκεύονται κάτω από το τρέχον δίκτυο και τον ιστότοπο και κατόπιν κάτω από μια ταυτότητα χρόνου εκτέλεσης: ένα
δακτυλικό αποτύπωμα των εκδόσεων Blockstudio, WordPress και PHP,
των ισχυουσών ρυθμίσεων, του ενεργού θέματος και των προσθέτων, των πηγών εντοπισμού και των αρχείων πηγής
που χρησιμοποιούνται. Αν αλλάξει μια είσοδος, τα επηρεαζόμενα αντικείμενα γίνονται νέα και τα παλιά
εκκαθαρίζονται.

Οι ψυχρές δημιουργίες εκτελούνται μία φορά ταυτόχρονα: ένα αίτημα δημιουργεί και δημοσιεύει ατομικά
το αποτέλεσμα, ενώ τα υπόλοιπα περιμένουν. Αν μια ανανέωση αποτύχει, συνεχίζει να προβάλλεται το τελευταίο έγκυρο αντικείμενο,
ενώ η αποτυχία παραμένει ορατή, και το `Blockstudio\Runtime_Cache::purge('tailwind')` εκκαθαρίζει ένα πεδίο εφαρμογής.

## Στατική προ-απόδοση

Η στατική προ-απόδοση αποθηκεύει στην προσωρινή μνήμη πλήρη ανώνυμα έγγραφα HTML και μπορεί να τα προβάλλει
πριν από την εκκίνηση του WordPress. Είναι απενεργοποιημένη από προεπιλογή.

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

### Προϋποθέσεις επιλεξιμότητας

Επιλέξιμα είναι μόνο πλήρη ανώνυμα έγγραφα HTML. Παρακάμπτονται τα αιτήματα που δεν είναι GET, οι συμβολοσειρές ερωτημάτων, η διαχείριση, το REST, το Ajax, το cron, οι τροφοδοσίες, η αναζήτηση, οι προεπισκοπήσεις, τα αιτήματα που περιέχουν nonce, τα εξατομικευμένα cookie και κάθε διαδρομή κάτω από το `dynamicPaths`.
Μια απόκριση μπορεί να εξαιρεθεί πλήρως με έναν δείκτη `<!-- blockstudio:no-cache -->`.

Η αντιστοίχιση διαδρομών τηρεί τα όρια, επομένως το `/account` καλύπτει το `/account/orders` αλλά
όχι το `/accounting`.

### Λειτουργίες υπογραφής και γραφήματος

Το `invalidate` καθορίζει πότε λήγουν οι καταχωρίσεις. Η προεπιλεγμένη λειτουργία `signature` συμπληρώνει
μια απόκριση με κλειδί ταυτότητας όταν υπάρξει αστοχία στην προσωρινή μνήμη για ανώνυμο αίτημα και την ανανεώνει μετά από αλλαγές σε επίπεδο ιστότοπου, κάτι που ταιριάζει σε έναν συνηθισμένο ιστότοπο.

Η λειτουργία `graph` προορίζεται για ρητά εργαλεία δημιουργίας και ανάπτυξης. Καταγράφει τις εξαρτήσεις πηγής κάθε σελίδας,
ώστε ένα σχέδιο να αναδημιουργεί μόνο τις επηρεαζόμενες διευθύνσεις 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']));
```

### Πρώιμη εξυπηρέτηση

Όταν ενεργοποιηθεί το `earlyServe`, το Blockstudio διαχειρίζεται έναν μικρό χάρτη διαδρομών ανά ιστότοπο και ένα drop-in `advanced-cache.php` που μεταδίδει μια επιλέξιμη επιτυχία πριν από την εκκίνηση του WordPress,
των προσθέτων ή του θέματος.

Δεν αντικαθιστά ποτέ ξένο χάρτη, drop-in ή δήλωση `WP_CACHE`. Ένα τεχνούργημα γραφήματος επαληθεύει κάθε αναφερόμενο αρχείο HTML πριν από την εναλλαγή του χάρτη, ώστε μια ανάπτυξη που δεν ολοκληρώθηκε να αφήνει ενεργό το προηγούμενο γράφημα. Οι εγγραφές πολλών ιστότοπων παραμένουν απομονωμένες ανά κεντρικό υπολογιστή, διαδρομή αρχικής σελίδας και αναγνωριστικό ιστότοπου.

### Προθέρμανση και κατάσταση

Τρεις εντολές WP-CLI καλύπτουν την καθημερινή χρήση:

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

Το `status` αναφέρει την ενεργή ταυτότητα, τον αριθμό αρχείων και byte, τις εγγραφές γραφήματος, την κατάσταση ουράς και τους μετρητές επιτυχιών, αστοχιών, δημιουργιών και αποτυχιών ανά πεδίο εφαρμογής.

## Ανάλυση και εργαλεία agent

### Προεπιλογές ανάλυσης

Το `blockstudio/phpstan` προσθέτει τρία επίπεδα πάνω από την ανάλυση block, καθώς και μία
εντολή που εκτελεί το επίπεδο που επέλεξε το έργο.

| Προεπιλογή | Τι προσθέτει |
| --- | --- |
| `base` | Την υπάρχουσα ανάλυση σχήματος, προτύπων, hook, ρυθμίσεων και API. |
| `theme` | Ρίζες θέματος, κεφαλίδες στυλ, στοιχεία, περιορισμό εμβέλειας επιλογέων, προεπιλογές πεδίων και όρια επαναλήπτη. |
| `extreme-theme` | PHPStan `max`, μη ασφαλές PHP, διαφυγή, Tailwind, JavaScript και ελέγχους Interactivity. |
| `wordpress-render` | Ζωντανό probe απόδοσης που παρέχει ο καλών, επιπλέον του `extreme-theme`. |

Οι προεπιλογές προέρχονται από το `blockstudio.json`, ώστε οι διαδραστικές εκτελέσεις, το CI και τα hook commit
να μοιράζονται μία διαμόρφωση:

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

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

Οι κωδικοί εξόδου είναι `0` σε επιτυχία, `1` για διαγνωστικά και `2` για μη έγκυρη χρήση. Το
περίβλημα συνθέτει τη διαμόρφωσή του στον προσωρινό κατάλογο του συστήματος, ώστε να μη δημιουργείται διαμόρφωση, γραμμή βάσης ή προσωρινή μνήμη
στο έργο, και αυξάνει το όριο μνήμης του PHPStan σε `1G`.

Περιλαμβάνει επίσης έναν πάροχο BC Math, ώστε οι έλεγχοι JavaScript να μη χρειάζονται πλέον
το `ext-bcmath`.

### Διαχειριζόμενο άγκιστρο commit

Μία ρύθμιση και μία εντολή μετατρέπουν την επιλεγμένη προεπιλογή σε πύλη ελέγχου commit.

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

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

Ο συγχρονισμός δημιουργεί το hook και μια εγγραφή ιδιοκτησίας στον κοινό κατάλογο του Git,
κατευθύνει το `core.hooksPath` στον διαχειριζόμενο κατάλογο και συνδέει οποιοδήποτε pre-commit
hook είχε ρυθμιστεί προηγουμένως. Το hook εντοπίζει το αποθετήριο και τη ρίζα του έργου κατά τη στιγμή του
commit, ώστε να λειτουργούν οι συνδεδεμένες αναπτύξεις και οι διαδρομές που περιέχουν κενά.

Το hook εκτελεί μόνο το `vendor/bin/blockstudio-phpstan`· δεν
μορφοποιεί ούτε ξαναγράφει ποτέ αρχεία. Αν ορίσετε το `commit` σε `false` και συγχρονίσετε ξανά ή
εκτελέσετε το `blockstudio-githooks remove`, επαναφέρεται η καταγεγραμμένη διαδρομή του hook και
διαγράφονται μόνο τα αρχεία που ανήκουν στο Blockstudio.

### Σύμβαση έργου

Το `blockstudio-agents` δημιουργεί ένα `AGENTS.md` που δηλώνει πού βρίσκονται τα blocks, τι θεωρείται
σελίδα σε αυτό το έργο, ποιες δυνατότητες είναι ενεργοποιημένες και τι θα απορρίψει ο αναλυτής.

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

Το έγγραφο προκύπτει από τα δεδομένα και δεν βασίζεται σε πρότυπο. Ένα θέμα με κεφαλίδα `style.css`,
blocks και σελίδες που βασίζονται σε αρχεία αποκτά διαφορετική σύμβαση από ένα πρόσθετο που καταχωρίζει μόνο
blocks, συμπεριλαμβάνοντας τα πλήθη, τους καταλόγους, τους χώρους ονομάτων και τις γλώσσες προτύπων που εντόπισε ο σαρωτής. Το `blockstudio.json` καθορίζει ποιες δυνατότητες εμφανίζονται,
οπότε ένα έργο χωρίς στατική προ-απόδοση δεν θα τη δει να αναφέρεται.

Η ενότητα ορθότητας διαβάζεται από τα αρχεία κανόνων της επιλεγμένης προεπιλογής, επίπεδο προς επίπεδο, ώστε κάθε προσθήκη κανόνα στην προεπιλογή να αλλάζει όλες τις συμβάσεις που δημιουργούνται.

Η ιδιοκτησία λειτουργεί όπως και για το hook commit. Αν ένα αρχείο δεν έχει τον δείκτη δημιουργίας,
η αντικατάστασή του απορρίπτεται, εκτός αν το `--force` ορίζει διαφορετικά. Μια περιοχή σημειώσεων στο
τέλος διατηρείται κατά την αναδημιουργία, το `--check` τερματίζει με `1` όταν η σύμβαση είναι παρωχημένη
και το `--stdout` την εκτυπώνει χωρίς να αγγίξει το σύστημα αρχείων.

### Ευρετήριο τεκμηρίωσης

Το `blockstudio-llm.txt` είναι πλέον ευρετήριο αντί για συνένωση. Κάθε
δημοσιευμένο έγγραφο εμφανίζεται μία φορά, στην ενότητα και υποενότητά του, μαζί με τη διαδρομή του,
το αρχείο προέλευσής του, μια σύντομη περιγραφή του σκοπού του και τα αναγνωριστικά που του ανήκουν: διαδρομές
ρυθμίσεων, ονόματα hook, συναρτήσεις και κλάσεις PHP, καθώς και εντολές.

```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 διαβάζει το ευρετήριο, εντοπίζει το μοναδικό έγγραφο που περιέχει το αναγνωριστικό που τον ενδιαφέρει και ανοίγει αυτό το έγγραφο. Η προηγούμενη συνένωση του μισού megabyte εξακολουθεί να δημιουργείται και να δημοσιεύεται στο `/blockstudio-llm-full.txt`· απλώς δεν είναι πλέον το πρώτο πράγμα που δίνεται σε κανέναν.

## Κανονικές ετικέτες block

Μια αυτόνομη εντολή ξαναγράφει τις συντομογραφίες προθεμάτων και ψευδωνύμων με την κανονική γραφή `<bs:namespace-slug>`, η οποία καταγράφει το πραγματικό όνομα block και επιλύεται χωρίς φορτωμένο φίλτρο έργου.

Με πρόθεμα `brand` για το `theme-components` και πρόθεμα `ui` για το `bsui`, αυτή η συντομογραφία:

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

σημαίνει το ίδιο με:

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

Τα προθέματα και τα ακριβή ψευδώνυμα εξακολουθούν να λειτουργούν και δεν έχουν καταργηθεί. Η εντολή δεν φορτώνει το WordPress και δεν γράφει τίποτα χωρίς το `--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` αντιστοιχίζει κάθε πρόθεμα στους χώρους ονομάτων του και το `--known-blocks` παραθέτει τα καταχωρισμένα ονόματα block. Η αναφορά καταγράφει αντιστοιχίσεις από παλαιές σε κανονικές ονομασίες, μετρήσεις εμφανίσεων, hash ανά αρχείο και ξεχωριστές λίστες για άγνωστες ετικέτες, αμφίσημα ψευδώνυμα και δυναμικές ετικέτες. Το `--apply` αρνείται να γράψει όσο υπάρχουν τέτοιες περιπτώσεις, εκτός αν δοθεί το `--allow-unresolved`.

Υποστηρίζονται ζευγαρωμένα, ένθετα και αυτοκλειόμενα στοιχεία σήμανσης, καθώς και κυριολεκτικές ετικέτες σε συμβολοσειρές PHP. Αλλάζουν μόνο τα ονόματα των ετικετών, μια δεύτερη εκτέλεση δεν επιφέρει αλλαγές και τα παραδείγματα μέσα σε σχόλια, μπλοκ κώδικα, `<pre>` ή `<code>` εμφανίζονται μόνο στην αναφορά.

## Προεπιλεγμένη συμπεριφορά

Η εγκατάσταση της έκδοσης 7.6 δεν αλλάζει τίποτα από μόνη της.

**Το προφίλ επιδόσεων είναι από προεπιλογή `compat`.** Η έξοδος της κεφαλίδας, το oEmbed, τα XML-RPC, το Heartbeat, οι προεπιλογές εικόνων, η προφόρτωση συνδέσμων, η lazy loading και το `<title>` του frontend παραμένουν όπως τα άφησαν το WordPress και το θέμα.

**Αυτά παραμένουν απενεργοποιημένα μέχρι να ενεργοποιηθούν:** κάθε κλειδί `performance.staticPrerender`, `performance.measurement`, `performance.media` και `themeDefaults`, καθώς και τα `githooks.commit`, `dev.canvas.enabled`, `ui.enabled`, `tailwind.enabled` και `blockTags.enabled`. Όσο είναι απενεργοποιημένη η στατική προαπόδοση, δεν δημιουργεί αρχεία ούτε εγκαθιστά drop-in.

**Τα Canvas και Render είναι παθητικά.** Διαβάζουν τα υπάρχοντα μητρώα και αποδίδουν μόνο ό,τι ζητά ο καλών· κανένα από τα δύο δεν συνδέεται με την έξοδο του frontend ούτε καταχωρίζει διαδρομές. Η οθόνη διαχείρισης Canvas εξακολουθεί να απαιτεί τα `dev.canvas.enabled` και `edit_posts`.

**Για αυστηρότερη ανάλυση, πρέπει να την ονομάσετε.** Η εγκατάσταση του `blockstudio/phpstan` ενεργοποιεί μόνο τη βασική επέκταση και η κανονική εντολή εκτελεί το `base`, εκτός αν το έργο ορίσει ένα preset.

**Για να δημιουργηθούν τα αρχεία, πρέπει να εκτελέσετε την αντίστοιχη εντολή.** Το `githooks.commit` δεν κάνει τίποτα μέχρι να εκτελεστεί το `blockstudio-githooks sync`, ενώ το `AGENTS.md` δεν κάνει τίποτα μέχρι να εκτελεστεί το `blockstudio-agents`.

## Αναβάθμιση από την έκδοση 7.5

Οι απαιτήσεις παραμένουν ίδιες: PHP 8.2 ή νεότερη έκδοση, WordPress 6.7 ή νεότερη έκδοση.

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

**Οι κρυφές μνήμες αναδημιουργούνται μία φορά.** Η ταυτότητα χρόνου εκτέλεσης περιλαμβάνει την έκδοση Blockstudio, επομένως το πρώτο αίτημα μετά την αναβάθμιση ξεκινά χωρίς προσωρινά δεδομένα και τα παλιά αντικείμενα εκκαθαρίζονται. Η παλιά κρυφή μνήμη Tailwind στο `wp-content/uploads/blockstudio/tailwind/cache` μπορεί να διαγραφεί· ένα απόσπασμα κώδικα που χρησιμοποιούσε glob σε αυτήν θα πρέπει να καλεί το `Blockstudio\Runtime_Cache::purge('tailwind')`.

Ο επίπεδος κατάλογος `wp-content/blockstudio/cache/runtime` πριν από την έκδοση 7.6 μετονομάζεται αυτόματα και απομακρύνεται από την ενεργή διαδρομή, ενώ διαγράφεται σταδιακά με πεπερασμένα περάσματα WP-Cron. Έτσι, δεν χρειάζεται να διαγραφούν μεγάλα δέντρα παλαιών αρχείων κλειδώματος κατά τη διάρκεια ενός αιτήματος ανάπτυξης.

**Τα αρχεία που δημιουργούνται έχουν συγκεκριμένη θέση.** Το `assets/media.json` ανήκει στον έλεγχο εκδόσεων ή σε ένα βήμα δημιουργίας. Ο χάρτης διαδρομών, το drop-in `advanced-cache.php` και η δήλωση `WP_CACHE` υπάρχουν μόνο όσο είναι ενεργοποιημένο το `earlyServe`, ενώ το άγκιστρο pre-commit μόνο όσο είναι συγχρονισμένο. Όλα τα υπόλοιπα αρχεία που δημιουργούνται βρίσκονται κάτω από το `cache.path` και μπορούν να διαγραφούν με ασφάλεια.

**Δεν αφαιρέθηκε ούτε μετονομάστηκε τίποτα.** Τα `bs_render_block()`, `bs_block()`, `Blockstudio\Pages` και `Blockstudio\Patterns` παραμένουν οι κανονικές επιφάνειες περιεχομένου που βασίζονται σε αρχεία.

**Η επαναφορά γίνεται ανά λειτουργία.** Τα `performance.profile` πίσω στο `compat`, τα `staticPrerender.enabled` στο `false`, τα `githooks.commit` στο `false` μαζί με ένα `sync` και τα `cache.enabled` στο `false` αναιρούν το καθένα ένα επίπεδο.

Μια εύλογη σειρά υιοθέτησης:

1. Ορίστε το `performance.profile` σε `speed` και, στη συνέχεια, ελέγξτε την έξοδο της κεφαλίδας, τις ροές και τυχόν πρόσθετα που βασίζονται στο oEmbed ή στο XML-RPC.
2. Δημιουργήστε το `assets/media.json`, μεταφέρετε τα πρότυπα στο `bs_media_image()` και έπειτα ενεργοποιήστε το `performance.media.lazy`.
3. Ενεργοποιήστε το `performance.staticPrerender` με απενεργοποιημένο το `earlyServe`, επαληθεύστε τις επιτυχείς αντιστοιχίσεις με το `wp bs prerender status` και έπειτα ενεργοποιήστε το `earlyServe`.
4. Εκτελέστε το `blockstudio-phpstan --preset theme` μέχρι να μην εμφανίζει προβλήματα, πριν βάλετε οποιοδήποτε preset πίσω από το `githooks.commit`.

## Πού θα βρείτε τις λεπτομέρειες

- [Canvas](https://blockstudio.dev/el/docs/dev/canvas/) και το
  [απόθεμα και το έγγραφο API](https://blockstudio.dev/el/docs/dev/canvas/#public-inventory-and-document-api)
- [Απόδοση](https://blockstudio.dev/el/docs/blocks/rendering/#structured-compositions-and-complete-documents),
  [UI Components](https://blockstudio.dev/el/ui/#public-inventory-and-examples) και
  [UI Composition](https://blockstudio.dev/el/ui/composition/)
- [Ρυθμίσεις](https://blockstudio.dev/el/docs/general/settings/) και
  [απόδοση](https://blockstudio.dev/el/docs/general/settings/#performance)
- [Απόδοση](https://blockstudio.dev/el/docs/production/performance/),
  [Προσωρινή αποθήκευση](https://blockstudio.dev/el/docs/production/caching/) και
  [Στατική προαπόδοση](https://blockstudio.dev/el/docs/production/static-prerendering/)
- [Tailwind CSS](https://blockstudio.dev/el/docs/tailwind/#template-composition-helpers)
- [PHPStan](https://blockstudio.dev/el/docs/dev/phpstan/): [προεπιλογές](https://blockstudio.dev/el/docs/dev/phpstan/#analysis-presets),
  [κανονική εντολή](https://blockstudio.dev/el/docs/dev/phpstan/#canonical-command),
  [διαχειριζόμενο άγκιστρο commit](https://blockstudio.dev/el/docs/dev/phpstan/#managed-commit-hook) και το
  [συμβόλαιο έργου](https://blockstudio.dev/el/docs/dev/phpstan/#project-contract-for-coding-agents)
- [Ενσωμάτωση AI](https://blockstudio.dev/el/docs/dev/ai/): το ευρετήριο τεκμηρίωσης και το πλήρες κείμενο
- [Μετάβαση](https://blockstudio.dev/el/docs/dev/migration/v7/#canonical-block-tags) και
  [PHP Hooks](https://blockstudio.dev/el/docs/blocks/hooks/php/)
