TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the TYPO3 CMS project.
+ *
+ * It is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License, either version 2
+ * of the License, or any later version.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ *
+ * The TYPO3 project - inspiring people to share!
+ */
+
+namespace TYPO3\CMS\Core\TypoScript\AST\Traverser;
+
+use TYPO3\CMS\Core\TypoScript\AST\CurrentObjectPath\CurrentObjectPath;
+use TYPO3\CMS\Core\TypoScript\AST\Node\NodeInterface;
+use TYPO3\CMS\Core\TypoScript\AST\Node\RootNode;
+use TYPO3\CMS\Core\TypoScript\AST\Visitor\AstVisitorInterface;
+
+/**
+ * Traverse the entire AST.
+ *
+ * @internal: Internal AST structure.
+ */
+final class AstTraverser
+{
+    /**
+     * @param AstVisitorInterface[] $visitors
+     */
+    public function traverse(RootNode $rootNode, array $visitors): void
+    {
+        foreach ($visitors as $visitor) {
+            if (!$visitor instanceof AstVisitorInterface) {
+                throw new \RuntimeException(
+                    'Visitors must implement AstTreeVisitorInterface',
+                    1689244842
+                );
+            }
+        }
+        $currentObjectPath = new CurrentObjectPath();
+        $this->traverseRecursive($visitors, $rootNode, $rootNode, $currentObjectPath, 0);
+    }
+
+    /**
+     * @param AstVisitorInterface[] $visitors
+     */
+    private function traverseRecursive(array $visitors, RootNode $nodeRoot, NodeInterface $node, CurrentObjectPath $currentObjectPath, int $currentDepth): void
+    {
+        $currentObjectPath->append($node);
+        foreach ($visitors as $visitor) {
+            $visitor->visitBeforeChildren($nodeRoot, $node, $currentObjectPath, $currentDepth);
+        }
+        foreach ($node->getNextChild() as $child) {
+            $this->traverseRecursive($visitors, $nodeRoot, $child, $currentObjectPath, $currentDepth + 1);
+            foreach ($visitors as $visitor) {
+                $visitor->visit($nodeRoot, $child, $currentObjectPath, $currentDepth);
+            }
+        }
+        foreach ($visitors as $visitor) {
+            $visitor->visitAfterChildren($nodeRoot, $node, $currentObjectPath, $currentDepth);
+        }
+        $currentObjectPath->removeLast();
+    }
+}