feat: Presets als Stapel, Gruppen-Presets und clear_overrides im Composer

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

src/Integrations/Divi/Pages/DiviUpdateAbility.php

@@ -35,9 +35,12 @@ final class DiviUpdateAbility extends DiviWriteAbility
     public function description(): string
     {
         return 'Ändert vorhandene Divi-Knoten: changes = Liste von {id, set: {Kurzform-Felder}, attrs: {Attributpfad: '
-            . '{Breakpoint: Wert}}, preset, label}. null entfernt einen Wert. Nicht genannte Einstellungen bleiben '
-            . 'unverändert. Jeder Knoten nur einmal pro Aufruf; denselben Pfad nicht zugleich über set und attrs. '
-            . 'tree_rev aus lit-divi-outline ist Pflicht; alles oder nichts.';
+            . '{Breakpoint: Wert}}, preset, group_presets, clear_overrides, label}. null entfernt einen Wert. '
+            . 'preset = Name/ID oder Liste (Stapel, bis 10; bei gleicher Priorität gewinnt das letzte Preset im '
+            . 'Stapel); group_presets = {Gruppe: Preset}, z. B. {"font-body": "Fließtext"}. Überdecken lokale Werte '
+            . 'ein Preset, meldet die Antwort das; clear_overrides: true entfernt sie (nach set/attrs). Nicht '
+            . 'genannte Einstellungen bleiben unverändert. Jeder Knoten nur einmal pro Aufruf; denselben Pfad nicht '
+            . 'zugleich über set und attrs. tree_rev aus lit-divi-outline ist Pflicht; alles oder nichts.';
     }
 
     public function inputSchema(): array
@@ -58,7 +61,22 @@ final class DiviUpdateAbility extends DiviWriteAbility
                                 'type' => 'object',
                                 'description' => 'Vollform: Attributpfad → Breakpoint-Werte.',
                             ],
-                            'preset' => ['type' => ['string', 'null'], 'description' => 'Preset-Name; null entfernt.'],
+                            'preset' => self::presetValue(
+                                'Preset-Name oder -ID, Liste (Stapel, 1–10) oder null zum Entfernen. Bei gleicher '
+                                    . 'Priorität gewinnt das letzte Preset im Stapel.'
+                            ),
+                            'group_presets' => [
+                                'type' => 'object',
+                                'description' => 'Gruppen-Presets: {Gruppe: Preset-Name | Liste | null}. Gruppe = '
+                                    . 'Kurzname (font-body), voller Name (divi/font-body) oder Attributpfad; null '
+                                    . 'entfernt den Eintrag der Gruppe.',
+                                'additionalProperties' => self::presetValue(),
+                            ],
+                            'clear_overrides' => [
+                                'type' => 'boolean',
+                                'description' => 'true entfernt lokale Werte, die Werte der zugewiesenen Presets '
+                                    . 'überdecken (nach set und attrs).',
+                            ],
                             'label' => [
                                 'type' => ['string', 'null'],
                                 'description' => 'Admin-Label im Divi-Builder; null entfernt.',
@@ -154,4 +172,21 @@ final class DiviUpdateAbility extends DiviWriteAbility
 
         return $change;
     }
+
+    /**
+     * Schema of one preset value: a name or id, a stack of 1–10 of them, or null.
+     *
+     * @return array<string, mixed>
+     */
+    private static function presetValue(string $description = ''): array
+    {
+        $schema = [
+            'type' => ['string', 'array', 'null'],
+            'items' => ['type' => 'string'],
+            'minItems' => 1,
+            'maxItems' => 10,
+        ];
+
+        return $description === '' ? $schema : $schema + ['description' => $description];
+    }
 }