
Blockstudio 7.3 ergänzt eine neue Ebene des Frameworks: wiederverwendbare UI-Komponenten, die wie jeder andere Block gerendert werden können.

Während 7.1 Blöcke in Full-Stack-Anwendungen verwandelte und 7.2 das Prüfen, Validieren und Verteilen größerer Projekte erleichterte, konzentriert sich 7.3 auf den Arbeitsalltag beim Entwickeln und Bearbeiten dieser Anwendungen.

Kurz gesagt:

- **UI-Komponenten**: eine gebündelte, optionale `bsui/*`-Komponentenbibliothek auf Basis der WordPress-Interaktivität-API.
- **Apps**: gebündelte `app/*`-Beispiele, die zeigen, wie sich die UI-Komponenten zu größeren Oberflächen zusammenfügen.
- **Erweiterter Editor**: ein breiteres Seitenpanel zum Bearbeiten von Blockstudio-Feldern, wenn die Seitenleiste zu eng wird.
- **Begrenzte Asset-Selektoren**: CSS- und SCSS-Assets können `%selector%` verwenden, um die Wrapper-Klasse des Blocks direkt anzusprechen.
- **Plugin-Abhängigkeiten**: Blöcke können aktive WordPress-Plugins voraussetzen, bei Bedarf mit Versionsbeschränkungen.
- **Editor-Richtlinien**: `blockstudio.json` können globale Blöcke, Muster und Medienverhalten über Editor-Hooks konfigurieren, die von WordPress-PHP unterstützt werden.
- **Block-Tag-Aliasse**: Benutzerdefinierte Aliasse für das Verfassen von Block-Tags.
- **Statische Analyse und Dokumentation**: bessere PHPStan-Abdeckung für externe Block-Bibliotheken sowie generierte Dokumentation für Einstellungen und Hooks.
- **Seiten- und Editor-Korrekturen**: zuverlässigeres Parsing dateibasierter Seiten, Erkennung von Tailwind-Kandidaten, Zurücksetzen-Modus, Isolierung des Render-Caches und Editor-Vorladungen.

## UI-Bibliothek

7.3 enthält eine gebündelte Komponentenbibliothek und darauf aufbauende Beispiel-Apps.

### UI-Komponenten

Blockstudio 7.3 enthält eine gebündelte UI-Bibliothek unter dem Namespace `bsui/*`. Die Komponenten sind normale Blockstudio-Blöcke. Du kannst sie daher mit derselben Block-Tag-Syntax, die du bereits verwendest, in Templates, dateibasierten Seiten, Mustern und Beitragsinhalten rendern.

Die Komponentenbibliothek UI ist in der Beta-Phase, während wir weiteres Feedback sammeln. Ziel für 7.3 ist es, den ersten Komponentensatz bereitzustellen, Erfahrungen aus echten Projekten zu sammeln und Benennung, Verhalten und Standardwerte zu verfeinern, bevor wir die API-Oberfläche als stabil bezeichnen.

Die Bibliothek ist optional:

```json title="blockstudio.json"
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "ui": {
    "enabled": true
  }
}
```

Nach der Aktivierung lassen sich einfache Komponenten direkt rendern:

```html
<block name="bsui/button" label="Save" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
  name="bsui/input"
  nameAlt="email"
  type="email"
  placeholder="Email"
></block>
```

Auch die kürzere `bs:`-Syntax funktioniert:

```html
<bs:bsui-button label="Save" variant="default" />
```

Ziel ist nicht, Blockstudio in ein Page-Builder-UI-Toolkit zu verwandeln. Stattdessen sollen gängige Elemente der Benutzeroberfläche als Blöcke verfügbar sein, damit Anwendungen mit Blockstudio Schaltflächen, Dialoge, Tabs, Auswahlfelder, Formularfelder, Menüs, Werkzeugleisten und Feedback-Komponenten nicht in jedem Projekt neu erstellen müssen.

Der erste Komponentensatz umfasst Elemente für Layout, Aktionen, Eingaben, Overlays, Navigation, Feedback, Formulare und Datendarstellung:

- `bsui/button`, `bsui/button-group`, `bsui/toggle`, `bsui/toggle-group`,
  `bsui/toolbar`
- `bsui/input`, `bsui/textarea`, `bsui/select`, `bsui/checkbox`,
  `bsui/radio-group`, `bsui/slider`, `bsui/switch`, `bsui/number-field`,
  `bsui/password-input`, `bsui/phone-input`, `bsui/otp-input`,
  `bsui/date-input`, `bsui/time-picker`
- `bsui/dialog`, `bsui/drawer`, `bsui/popover`, `bsui/menu`,
  `bsui/context-menu`, `bsui/menubar`, `bsui/tooltip`, `bsui/alert-dialog`
- `bsui/tabs`, `bsui/accordion`, `bsui/breadcrumb`, `bsui/pagination`,
  `bsui/navigation-menu`
- `bsui/card`, `bsui/table`, `bsui/stack`, `bsui/separator`,
  `bsui/aspect-ratio`, `bsui/badge`, `bsui/avatar`, `bsui/progress`,
  `bsui/meter`, `bsui/skeleton`, `bsui/spinner`, `bsui/kbd`
- `bsui/form`, `bsui/field`, `bsui/field-group`, `bsui/file-upload`,
  `bsui/color-picker`, `bsui/rating`

Viele davon sind zusammengesetzte Blöcke. Ein `bsui/tabs`-Block verwaltet den interaktiven Zustand, während untergeordnete Blöcke wie `bsui/tabs-list`, `bsui/tabs-trigger` und `bsui/tabs-panel` die Struktur beschreiben.

```html
<block name="bsui/tabs" defaultValue="features">
  <block name="bsui/tabs-list">
    <block name="bsui/tabs-trigger" value="features" title="Features"></block>
    <block name="bsui/tabs-trigger" value="pricing" title="Pricing"></block>
  </block>
  <block name="bsui/tabs-panel" value="features">
    <p>Features content.</p>
  </block>
  <block name="bsui/tabs-panel" value="pricing">
    <p>Pricing content.</p>
  </block>
</block>
```

So bleibt das Markup lesbar, während die Interactivity-API den Zustand und das Verhalten verwaltet.

### App-Beispiele

Der Namespace `app/*` enthält Beispiele, die aus denselben UI-Komponenten erstellt wurden.

Sie bilden kein separates Framework, sondern Referenzimplementierungen für größere Blockstudio-Oberflächen: zusammengesetzte Blöcke, verschachtelte UI, Interactivity-API-Zustand sowie Bereiche, in denen UI-Komponenten auf RPC- oder datenbankgestützte Funktionen treffen.

```html
<block name="app/kitchen-sink"></block>

<block name="app/chat">
  <block name="app/chat-sidebar"></block>
  <block name="app/chat-header"></block>
  <block name="app/chat-messages"></block>
  <block name="app/chat-input"></block>
</block>
```

Die UI-Bibliothek enthält auch eine eigene Dokumentation und eine Live-Komponentenreferenz. Das Verhalten der Komponenten ist mehr als eine Sammlung von Templates. Es gehört zum Vertrag des Frameworks und bleibt auch dann konsistent, wenn die Bibliothek wächst.

## Entwickeln und Bearbeiten

Mehrere Änderungen erleichtern das Entwickeln und Bearbeiten von Blöcken.

### Erweiterter Editor

Das Bearbeiten komplexer Blöcke in der Inspektor-Seitenleiste wird schnell eng. Das gilt besonders für Wiederholfelder, Codefelder, Rich Text und verschachtelte Gruppen.

Blockstudio 7.3 ergänzt im Block-Inspektor eine Aktion zum Öffnen des erweiterten Editors. Sie öffnet rechts im Editor ein breiteres Seitenpanel, in dem dieselben Blockstudio-Felder angezeigt werden.

Wichtig ist, dass weiterhin dasselbe Feldsystem verwendet wird. Die Felder werden nicht doppelt gerendert, es gibt keinen zweiten Speicherpfad, und Änderungen im erweiterten Editor aktualisieren den ausgewählten Block genau wie Änderungen in der normalen Seitenleiste.

Verwende ihn, wenn sich die Seitenleiste gut zum Überfliegen eignet, für die Eingabe aber zu eng ist.

### Begrenzte Asset-Selektoren

Blockstudio unterstützte bereits `%selector%` für Codefelder. In 7.3 können Block-CSS- und SCSS-Assets dasselbe Muster beim Entwickeln verwenden.

In einer CSS-Datei wird `%selector%` zur begrenzten Klasse des Blocks erweitert:

```css title="style.scoped.css"
%selector% {
  --hero-gap: var(--wp--preset--spacing--space-10);
}

%selector%.hero {
  border-bottom: 1px solid currentColor;
}

.hero__title {
  color: red;
}
```

Damit lässt sich das tatsächliche Wrapper-Element gestalten:

```php title="index.php"
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
  <h1 class="hero__title">Hero</h1>
</section>
```

Reguläre Selektoren in `*.scoped.css` zielen weiterhin auf untergeordnete Elemente. `%selector%` ist der explizite Hook für den Block-Stamm.

### Plugin-Abhängigkeiten

Blöcke können jetzt im Schlüssel `blockstudio` von `block.json` Plugin-Abhängigkeiten für WordPress deklarieren.

Die einfache Form prüft, ob alle aufgeführten Plugin-Slugs aktiv sind:

```json title="block.json"
{
  "blockstudio": {
    "pluginDependencies": ["woocommerce"]
  }
}
```

Die Objektform ergänzt Versionsbeschränkungen:

```json title="block.json"
{
  "blockstudio": {
    "pluginDependencies": {
      "woocommerce": {
        "version": ">6"
      }
    }
  }
}
```

Die Kennungen sind Plugin-Slugs für WordPress und entsprechen dem Plugin-Abhängigkeitssystem des WordPress-Kerns. Blockstudio ordnet aktive Plugins diesen Slugs zu und überspringt die Registrierung, wenn ein erforderliches Plugin fehlt, inaktiv ist oder eine niedrigere als die erforderliche Version hat.

Für die Versionsbeschränkung gilt dasselbe Vergleichsmodell wie für `version_compare()` von PHP. Eine einfache Versionsangabe wie `"6"` wird als `>=6` behandelt.

Das ist nützlich für Blöcke, die nur mit einem verfügbaren Plugin sinnvoll sind: WooCommerce-Produktkarten, Formularintegrationen, SEO-Integrationen, Mitgliedschaftskomponenten, Buchungs-Widgets oder Admin-UI, die an ein Drittanbieter-Plugin gebunden sind.

### Editor-Richtlinien

Die Datei `blockstudio.json` entwickelt sich ebenfalls zu einer nützlicheren Richtliniendatei auf Projektebene für den Editor.

7.3 ergänzt eine Richtlinienebene für Einstellungen auf Basis von PHP und `blockEditor`, die WordPress bereits über serverseitige Hooks bereitstellt. Damit kannst du globales Verhalten für Inserter, Muster und Medien festlegen, ohne eigenen Theme-Verbindungscode auszuliefern.

```json title="blockstudio.json"
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "blockEditor": {
    "blocks": {
      "allow": ["core/*", "my-theme/*"],
      "deny": ["core/embed", "core/freeform"],
      "directory": false,
      "categories": {
        "rename": {
          "text": "Writing",
          "design": "Layout"
        },
        "order": ["my-theme", "text", "media"]
      }
    },
    "patterns": {
      "core": false,
      "remote": false,
      "categories": {
        "deny": ["gallery"],
        "order": ["featured", "buttons"]
      }
    },
    "media": {
      "openverse": false,
      "imageSizes": {
        "allow": ["thumbnail", "large"]
      }
    }
  }
}
```

Der erste Schritt beschränkt sich bewusst auf Funktionen, die von PHP unterstützt werden: erlaubte und gesperrte Blöcke, Laden des Block-Verzeichnisses, Bezeichnungen und Reihenfolge der Inserter-Kategorien, Musterquellen und -kategorien, Openverse, Bildgrößenauswahl, Sichtbarkeit älterer Widgets sowie das Entfernen von Blockstilen, die über PHP registriert wurden.

Die Funktion versucht nicht, beliebige Standardwerte für Kernblöcke neu zu schreiben. Einstellungen wie `core/columns.isStackedOnMobile` gehören zum JavaScript-Registrierungsablauf des Block-Editors. Dafür braucht es eine separate, ausdrücklich vorgesehene API, statt sie in eine JSON-Datei hineinzuzwängen.

### Block-Tag-Aliasse

Block-Tags erhielten einen Alias-Filter:

```php title="functions.php"
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
    $aliases['theme-button'] = 'bsui/button';
    return $aliases;
});
```

So kann ein Projekt leicht zu verwendende Tags fürs Entwickeln definieren, die intern weiterhin zum kanonischen Blocknamen aufgelöst werden.

```html
<bs:theme-button label="Continue" />
```

Das ist besonders nützlich beim Verfassen von UI-lastigen Templates, wenn die kanonischen Blocknamen zwar korrekt sind, sich aber nicht immer am besten zum Schreiben eignen.

## Werkzeugunterstützung und Zuverlässigkeit

Statische Analyse, Zuverlässigkeit und Werkzeuge zur Leistungsmessung wurden weiter verbessert.

### Statische Analyse und generierte Dokumentation

Die PHPStan-Erweiterung unterstützt jetzt explizite Scan-Stammverzeichnisse für externe Block-Bibliotheken. Damit kann ein Projekt `<bs:*>`- und `<block>`-Tags anhand von Blöcken validieren, die außerhalb des aktuellen Plugins oder Themes liegen, und diese Verzeichnisse bei der Analyse auf die Registry beschränken.

Die Schema-Prüfungen wurden auch auf Seiten-Metadaten und `pluginDependencies` ausgeweitet. So lassen sich ungültige Konfigurationen zur Veröffentlichungszeit leichter erkennen, bevor sie WordPress erreichen.

Die Dokumentationsgenerierung enthält jetzt auch Filterreferenzen für Einstellungen und PHP-Hooks. Das ist umso wichtiger, je mehr sich `blockstudio.json` von einer Datei mit einigen verstreuten Schaltern zu einer echten Projektrichtliniendatei entwickelt.

### Zuverlässigkeit von Seiten und Editor

7.3 umfasst außerdem eine Reihe von Korrekturen für dateibasierte Seiten, das Rendern im Editor und den Zurücksetzen-Modus.

Die dateibasierte Seitenanalyse verarbeitet jetzt beim HTMLParsing Attribut-abhängige Zuordnungen benutzerdefinierter Container. `bs:`-Seitentags lösen außerdem Bindestrich-getrennte Block-Namespaces korrekt auf, sodass Namen wie `custom-theme/card` den Parser nicht mehr aus dem Tritt bringen.

Generische Container-Tags außerhalb des Kerns serialisieren jetzt gültiges `innerContent`, wenn sie kein Wrapper-Markup bereitstellen. Dadurch sind synchronisierte Seiteninhalte vorhersehbarer und die WordPress-Blockserialisierung bleibt gültig.

Der Editor wurde in mehreren Punkten beim Vorschau- und Preload-Verhalten verbessert:

- Tailwind-Editor-CSS enthalten jetzt Klassenkandidaten aus dateibasierten Seitenvorlagen.
- Editor-Preloads erhalten RichText-Wrapper-Klassen für wiederholte Blöcke desselben Typs.
- Editor-Preloads erkennen Blöcke, deren Standardfeldwerte von Gutenberg ergänzt, aber im gespeicherten Block-Markup ausgelassen werden.
- Von Gutenberg ergänzte registrierte Standardattribute werden vor dem Vergleich der Render-Cache-Schlüssel ignoriert.
- Editor- und Inserter-Vorschau-Renderings behalten jetzt getrennte Cache-Einträge, auch wenn sie dieselbe Client-ID verwenden.
- `bs_get_group()` funktioniert jetzt reibungslos mit wiederverwendeten benutzerdefinierten Feldgruppen, auch wenn die Gruppen-ID dem Namen des benutzerdefinierten Felds entspricht, und extrahiert nur exakte Gruppenpräfixe.
- Link-Felder mit `withCreateSuggestion` binden den WordPress-LinkControl-Erstellungsablauf jetzt korrekt ein und erstellen Entwurfsseiten über REST API.
- PHP-Blockvorlagen werden jetzt einmal pro Rendering ausgeführt, statt einen verworfenen Preflight-Include auszuführen.

Auch der Reset-Modus wurde verbessert. Er neutralisiert jetzt Gutenberg-Regeln für Blockbreite und vertikale Abstände bei konfigurierten Beitragstypen, entfernt bei Bedarf WordPress-Iframe-Inhalte und Reset-Stile und sorgt für übersichtlichere Hover- und Auswahl-Overlays in Blockstudio.

Die Regressionstests für komplexe InnerBlocks-Muster wurden ebenfalls um verschachtelte Blockstudio-Blöcke erweitert. So wird der Editor-Renderingpfad auch für die manuell am schwersten erkennbaren Mustereinfügungen geprüft.

### Performance-Tools

Lokale anonyme `blockstudio-perf=1`-Prüfungen können jetzt `Server-Timing`-Header ausgeben, ohne das Debug-Panel einzublenden.

Die Zeitmessungen decken jetzt mehr Phasen des Build-Lebenszyklus ab: Erkennung, Asset-Verarbeitung, Registrierung und Überschreibungen. So siehst du leichter, wofür die Zeit tatsächlich draufgeht, ohne ein sichtbares Profiling-UI einzuschalten.

## Warum dieses Release wichtig ist

Das zentrale Thema von 7.3 ist Komposition.

UI-Komponenten erleichtern die Komposition von Anwendungsoberflächen. Der erweiterte Editor macht die Bearbeitung größerer Blöcke einfacher. Plugin-Abhängigkeiten ermöglichen es Blöcken, den benötigten Plugin-Kontext anzugeben. Editor-Richtlinien verlagern projektweite Regeln für den Block-Editor in `blockstudio.json`. Block-Tag-Aliase vereinfachen das Schreiben von Vorlagen. Parser-, PHPStan- und Editor-Korrekturen sorgen dafür, dass diese Kompositionen auch beim Durchlaufen von WordPress zuverlässiger funktionieren.

Blockstudio ist weiterhin dateibasiert. Blöcke bleiben Ordner. Vorlagen übernehmen weiterhin die Arbeit. Doch das Framework bietet jetzt eine leistungsfähigere UI-Ebene auf dieser Grundlage.
