fix: Insert entscheidet fail closed auf den komponierten Blöcken statt auf Client-Text; Update warnt bei Wechsel der Schleifen-Art unter unveränderten Kindern (X3)

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

src/Integrations/Divi/Compose/LoopContext.php

@@ -5,6 +5,7 @@ declare(strict_types=1);
 namespace LIT\MCP\Integrations\Divi\Compose;
 
 use LIT\MCP\Integrations\Divi\BlockTree\AttrMap;
+use LIT\MCP\Integrations\Divi\BlockTree\Block;
 use LIT\MCP\Integrations\Divi\BlockTree\NodeIndex;
 
 defined('ABSPATH') || exit;
@@ -63,6 +64,42 @@ final class LoopContext
         return LoopScope::none();
     }
 
+    /**
+     * The loop_* options $block and its descendants reference in their (canonical) attrs. Opaque blocks are not
+     * entered; $stopAtLoops leaves out descendants that run a loop of their own (their content has its own scope).
+     * A reference that is no clean whole value but names a loop_ option counts as "loop_?" (fail closed).
+     *
+     * @return list<string>
+     */
+    public static function optionsIn(Block $block, bool $stopAtLoops): array
+    {
+        if ($block->isOpaque()) {
+            return [];
+        }
+
+        $names = [];
+        $attrs = $block->attrs();
+        array_walk_recursive($attrs, static function (mixed $value) use (&$names): void {
+            if (! is_string($value)) {
+                return;
+            }
+            $name = VariableRef::nameOf($value);
+            if ($name === null && VariableRef::contains($value) && str_contains($value, 'loop_')) {
+                $name = 'loop_?';
+            }
+            if ($name !== null && str_starts_with($name, 'loop_')) {
+                $names[] = $name;
+            }
+        });
+        foreach ($block->children() as $child) {
+            if (! ($stopAtLoops && self::enabled($child->attrs()))) {
+                array_push($names, ...self::optionsIn($child, $stopAtLoops));
+            }
+        }
+
+        return array_values(array_unique($names));
+    }
+
     /** The loop of the node $nodeId (path ID) or its nearest ancestor; none() for an unknown ID. */
     public static function of(NodeIndex $index, string $nodeId): LoopScope
     {

src/Integrations/Divi/Pages/DiviInsertAbility.php

@@ -8,7 +8,6 @@ use LIT\MCP\Abilities\Annotations;
 use LIT\MCP\Abilities\Errors;
 use LIT\MCP\Integrations\Divi\BlockTree\Block;
 use LIT\MCP\Integrations\Divi\Compose\LoopContext;
-use LIT\MCP\Integrations\Divi\Compose\VariableRef;
 use LIT\MCP\Integrations\Divi\Release\DiviFeature;
 use WP_Error;
 
@@ -105,7 +104,7 @@ final class DiviInsertAbility extends DiviWriteAbility
 
         $scope = self::loopAt($page->index, $position['parent']);
         $composed = $composition->inLoop($scope)->composer()->compose($nodes, $position['parent'], 'nodes', $context);
-        if (self::startsLoop($composed['blocks']) && self::hasLoopContent($nodes)) {
+        if (self::startsLoop($composed['blocks']) && self::hasLoopContent($composed['blocks'])) {
             return Errors::invalidInput(
                 'Schleifen-Inhalte unter einer neuen Divi-Schleife gehen nicht in einem Aufruf; nichts wurde '
                     . 'gespeichert.',
@@ -152,20 +151,19 @@ final class DiviInsertAbility extends DiviWriteAbility
     }
 
     /**
-     * Whether the input names loop content: a {{loop:…}} placeholder or a reference to a loop_* option.
+     * Whether the composed (canonical, what would be saved) blocks reference loop_* options anywhere – the
+     * client's raw text is never looked at: the writers strip control characters and trim values (S35).
      *
-     * @param array<array-key, mixed> $nodes
+     * @param list<Block> $blocks
      */
-    private static function hasLoopContent(array $nodes): bool
+    private static function hasLoopContent(array $blocks): bool
     {
-        $found = false;
-        array_walk_recursive($nodes, static function (mixed $value) use (&$found): void {
-            $found = $found || (is_string($value) && (
-                preg_match('/^\s*\{\{\s*loop\s*:/', $value) === 1
-                || str_starts_with((string) VariableRef::nameOf($value), 'loop_')
-            ));
-        });
+        foreach ($blocks as $block) {
+            if (LoopContext::optionsIn($block, false) !== []) {
+                return true;
+            }
+        }
 
-        return $found;
+        return false;
     }
 }

src/Integrations/Divi/Pages/DiviMoveAbility.php

@@ -6,10 +6,7 @@ namespace LIT\MCP\Integrations\Divi\Pages;
 
 use LIT\MCP\Abilities\Annotations;
 use LIT\MCP\Abilities\Errors;
-use LIT\MCP\Integrations\Divi\BlockTree\Block;
 use LIT\MCP\Integrations\Divi\Compose\LoopContext;
-use LIT\MCP\Integrations\Divi\Compose\LoopScope;
-use LIT\MCP\Integrations\Divi\Compose\VariableRef;
 use LIT\MCP\Integrations\Divi\Release\DiviFeature;
 use WP_Error;
 
@@ -93,57 +90,11 @@ final class DiviMoveAbility extends DiviWriteAbility
         }
 
         $change = (new DiviChange(sprintf('Knoten %s verschoben', $id)))->record($node, 'moved');
-        $names = self::loopContent($node);
+        $names = LoopContext::enabled($node->attrs()) ? [] : LoopContext::optionsIn($node, true);
         if ($names !== [] && $from->kind() !== $to->kind()) {
             $change->warning(self::loopWarning($names, $from, $to));
         }
 
         return $change;
     }
-
-    /**
-     * The loop_* options $block and its descendants show in the scope around $block; a block that runs its own
-     * loop keeps its content's scope, read-only blocks are not entered.
-     *
-     * @return list<string>
-     */
-    private static function loopContent(Block $block): array
-    {
-        if ($block->isOpaque() || LoopContext::enabled($block->attrs())) {
-            return [];
-        }
-
-        $names = [];
-        $attrs = $block->attrs();
-        array_walk_recursive($attrs, static function (mixed $value) use (&$names): void {
-            $name = is_string($value) ? VariableRef::nameOf($value) : null;
-            if ($name !== null && str_starts_with($name, 'loop_')) {
-                $names[] = $name;
-            }
-        });
-        foreach ($block->children() as $child) {
-            array_push($names, ...self::loopContent($child));
-        }
-
-        return array_values(array_unique($names));
-    }
-
-    /** @param list<string> $names */
-    private static function loopWarning(array $names, LoopScope $from, LoopScope $to): string
-    {
-        $where = $to->active()
-            ? sprintf(
-                'jetzt in einer Divi-Schleife vom Typ: %s (vorher: %s); passen sie nicht zu dieser Art, zeigt Divi '
-                    . 'sie leer oder mit Daten eines anderen Objekts mit derselben ID',
-                $to->label(),
-                $from->active() ? $from->label() : 'keine Schleife'
-            )
-            : 'jetzt außerhalb jeder Divi-Schleife; Divi zeigt sie dort leer';
-
-        return sprintf(
-            'Schleifen-Inhalte (%s) liegen %s. Zurückverschieben oder die Inhalte anpassen.',
-            implode(', ', $names),
-            $where
-        );
-    }
 }

src/Integrations/Divi/Pages/DiviUpdateAbility.php

@@ -10,6 +10,7 @@ use LIT\MCP\Integrations\Divi\BlockTree\Block;
 use LIT\MCP\Integrations\Divi\BlockTree\NodeIndex;
 use LIT\MCP\Integrations\Divi\Compose\ColumnWidths;
 use LIT\MCP\Integrations\Divi\Compose\Composer;
+use LIT\MCP\Integrations\Divi\Compose\LoopContext;
 use LIT\MCP\Integrations\Divi\Compose\LoopScope;
 use LIT\MCP\Integrations\Divi\Design\PresetAssignment;
 use LIT\MCP\Integrations\Divi\Release\DiviFeature;
@@ -191,11 +192,23 @@ final class DiviUpdateAbility extends DiviWriteAbility
             static fn (array $update): bool => $update[1] !== $update[0]->attrs()
         ));
         $change = new DiviChange(sprintf('%d Divi-Knoten geändert', count($updates)));
+        $before = [];
+        foreach ($updates as [$block]) {
+            $before[spl_object_id($block)] = self::loopAt($page->index, $block);
+        }
         foreach ($updates as [$block, $attrs]) {
             // Composer::update() output: every client value already passed the choke point.
             $block->setAttrs($attrs);
             $change->record($block, 'updated');
         }
+        foreach ($updates as [$block]) {
+            $from = $before[spl_object_id($block)];
+            $to = self::loopAt($page->index, $block);
+            $names = $from->kind() === $to->kind() ? [] : LoopContext::optionsIn($block, true);
+            if ($names !== []) {
+                $change->warning(sprintf('%s: %s', $page->index->idOf($block), self::loopWarning($names, $from, $to)));
+            }
+        }
 
         return $change;
     }

src/Integrations/Divi/Pages/DiviWriteAbility.php

@@ -136,4 +136,23 @@ abstract class DiviWriteAbility implements Ability, RequiresDiviFeatures
 
         return LoopContext::fromChain($chain);
     }
+
+    /** @param list<string> $names */
+    protected static function loopWarning(array $names, LoopScope $from, LoopScope $to): string
+    {
+        $where = $to->active()
+            ? sprintf(
+                'jetzt in einer Divi-Schleife vom Typ: %s (vorher: %s); passen sie nicht zu dieser Art, zeigt Divi '
+                    . 'sie leer oder mit Daten eines anderen Objekts mit derselben ID',
+                $to->label(),
+                $from->active() ? $from->label() : 'keine Schleife'
+            )
+            : 'jetzt außerhalb jeder Divi-Schleife; Divi zeigt sie dort leer';
+
+        return sprintf(
+            'Schleifen-Inhalte (%s) liegen %s. Zurückverschieben oder die Inhalte anpassen.',
+            implode(', ', $names),
+            $where
+        );
+    }
 }