Add visual button presets, jump targets and menu controls

src/Content/DocumentValidator.php

@@ -42,7 +42,7 @@ final class DocumentValidator
     public function validate(array $document, bool $requireHeading = true): void
     {
         $schemaVersion = $document['schemaVersion'] ?? null;
-        $this->require(in_array($schemaVersion, [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20], true), 'Unsupported document schema.');
+        $this->require(in_array($schemaVersion, [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21], true), 'Unsupported document schema.');
         $this->text($document['title'] ?? null, 160);
         $this->text($document['description'] ?? null, 320);
         $this->require(is_array($document['blocks'] ?? null) && array_is_list($document['blocks']), 'Blocks must be a list.');
@@ -52,6 +52,16 @@ final class DocumentValidator
         foreach ($document['blocks'] as $block) {
             $this->block($block, $ids, $headings, 0, $schemaVersion, null);
         }
+        $anchors = function (array $blocks) use (&$anchors, &$ids): void {
+            foreach ($blocks as $block) {
+                if (isset($block['anchor'])) {
+                    $this->require(!isset($ids[$block['anchor']]) && !in_array($block['anchor'], ['main', 'top', 'admin-main'], true), 'Dieses Sprungziel ist bereits belegt. Bitte einen eindeutigen Namen wählen.');
+                    $ids[$block['anchor']] = true;
+                }
+                $anchors($block['children'] ?? []);
+            }
+        };
+        $anchors($document['blocks']);
         $this->require(
             $requireHeading ? 1 === $headings : 0 === $headings,
             $requireHeading ? 'A page requires exactly one main heading.' : 'A shared area must not contain a main heading.',
@@ -65,6 +75,11 @@ final class DocumentValidator
         $this->require(is_string($id) && 1 === preg_match('/^[a-zA-Z0-9_-]{1,64}$/D', $id) && !isset($ids[$id]), 'Block IDs must be stable and unique.');
         $ids[$id] = true;
         $type = $block['type'] ?? null;
+        if (isset($block['anchor'])) {
+            $this->require($schemaVersion >= 21 && in_array($type, ['section', 'row', 'column'], true)
+                && is_string($block['anchor']) && 1 === preg_match('/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/D', $block['anchor']),
+                'Ein Sprungziel braucht einen Bereich und einen Namen wie kontakt (ohne #), Schema v21.');
+        }
         // From schema v4 on, a namespaced type belongs to a plugin. The core does not know its
         // property schema, so it keeps the block untouched instead of rejecting or dropping the
         // page: a deactivated plugin must never make stored content unreadable. Nothing from
@@ -96,6 +111,16 @@ final class DocumentValidator
         $layout = $block['layout'] ?? [];
         $this->require(is_array($props) && is_array($layout), 'Props and layout must be objects.');
         foreach ($layout as $key => $value) {
+            if ('button' === $key) {
+                $this->require($schemaVersion >= 21 && 'button' === $type && is_array($value), 'Button-Varianten brauchen einen Button und Schema v21.');
+                foreach ($value as $device => $settings) {
+                    $this->require(isset(StyleSchema::DEVICES[$device]) && is_array($settings), 'Unbekanntes Button-Gerät.');
+                    foreach ($settings as $setting => $token) {
+                        $this->require(is_string($token) && isset(ButtonDesign::OPTIONS[$setting][$token]), 'Unbekannte Button-Variante.');
+                    }
+                }
+                continue;
+            }
             if ('effects' === $key && $schemaVersion >= 3) {
                 $this->require(is_array($value), 'Effects must be an object.');
                 $effects = [