[FEATURE] Support automatically created multi-level menus

Resolves #1108

Author: linawolf

packages/guides-markdown/src/Markdown/Parsers/BlockQuoteParser.php

@@ -62,9 +62,9 @@ public function parse(MarkupLanguageParser $parser, NodeWalker $walker, CommonMa
 
             // leaving the heading node
             if ($commonMarkNode instanceof BlockQuote) {
-                if (count($content) > 0 and $content[0] instanceof ParagraphNode and ($content[0]->getValue()[0]) instanceof InlineCompoundNode) {
+                if (count($content) > 0 && $content[0] instanceof ParagraphNode && ($content[0]->getValue()[0]) instanceof InlineCompoundNode) {
                     $paragraphContent = $content[0]->getValue()[0]->getValue();
-                    if (count($paragraphContent) > 0 and $paragraphContent[0] instanceof PlainTextInlineNode) {
+                    if (count($paragraphContent) > 0 && $paragraphContent[0] instanceof PlainTextInlineNode) {
                         $text = trim($paragraphContent[0]->getValue());
                         $newParagraphContent = $paragraphContent;
                         array_shift($newParagraphContent);

packages/guides-restructured-text/src/RestructuredText/NodeRenderers/Html/AdmonitionNodeRenderer.php

@@ -13,47 +13,6 @@
 
 namespace phpDocumentor\Guides\RestructuredText\NodeRenderers\Html;
 
-use InvalidArgumentException;
-use phpDocumentor\Guides\NodeRenderers\NodeRenderer;
-use phpDocumentor\Guides\Nodes\AdmonitionNode;
-use phpDocumentor\Guides\Nodes\Node;
-use phpDocumentor\Guides\RenderContext;
-use phpDocumentor\Guides\TemplateRenderer;
-
-use function implode;
-use function is_a;
-
-/** @implements NodeRenderer<AdmonitionNode> */
-final class AdmonitionNodeRenderer implements NodeRenderer
+final class AdmonitionNodeRenderer extends \phpDocumentor\Guides\NodeRenderers\Html\AdmonitionNodeRenderer
 {
-    public function __construct(private readonly TemplateRenderer $renderer)
-    {
-    }
-
-    public function supports(string $nodeFqcn): bool
-    {
-        return $nodeFqcn === AdmonitionNode::class || is_a($nodeFqcn, AdmonitionNode::class, true);
-    }
-
-    public function render(Node $node, RenderContext $renderContext): string
-    {
-        if ($node instanceof AdmonitionNode === false) {
-            throw new InvalidArgumentException('Node must be an instance of ' . AdmonitionNode::class);
-        }
-
-        $classes = $node->getClasses();
-
-        return $this->renderer->renderTemplate(
-            $renderContext,
-            'body/admonition.html.twig',
-            [
-                'name' => $node->getName(),
-                'text' => $node->getText(),
-                'title' => $node->getTitle(),
-                'isTitled' => $node->isTitled(),
-                'class' => implode(' ', $classes),
-                'node' => $node->getValue(),
-            ],
-        );
-    }
 }

packages/guides-restructured-text/src/RestructuredText/Nodes/AdmonitionNode.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of phpDocumentor.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @link https://phpdoc.org
+ */
+
+namespace phpDocumentor\Guides\RestructuredText\Nodes;
+
+class AdmonitionNode extends \phpDocumentor\Guides\Nodes\AdmonitionNode
+{
+}

packages/guides/src/NodeRenderers/Html/AdmonitionNodeRenderer.php

@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of phpDocumentor.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @link https://phpdoc.org
+ */
+
+namespace phpDocumentor\Guides\NodeRenderers\Html;
+
+use InvalidArgumentException;
+use phpDocumentor\Guides\NodeRenderers\NodeRenderer;
+use phpDocumentor\Guides\Nodes\AdmonitionNode;
+use phpDocumentor\Guides\Nodes\Node;
+use phpDocumentor\Guides\RenderContext;
+use phpDocumentor\Guides\TemplateRenderer;
+
+use function implode;
+use function is_a;
+
+/** @implements NodeRenderer<AdmonitionNode> */
+class AdmonitionNodeRenderer implements NodeRenderer
+{
+    public function __construct(private readonly TemplateRenderer $renderer)
+    {
+    }
+
+    public function supports(string $nodeFqcn): bool
+    {
+        return $nodeFqcn === AdmonitionNode::class || is_a($nodeFqcn, AdmonitionNode::class, true);
+    }
+
+    public function render(Node $node, RenderContext $renderContext): string
+    {
+        if ($node instanceof AdmonitionNode === false) {
+            throw new InvalidArgumentException('Node must be an instance of ' . AdmonitionNode::class);
+        }
+
+        $classes = $node->getClasses();
+
+        return $this->renderer->renderTemplate(
+            $renderContext,
+            'body/admonition.html.twig',
+            [
+                'name' => $node->getName(),
+                'text' => $node->getText(),
+                'title' => $node->getTitle(),
+                'isTitled' => $node->isTitled(),
+                'class' => implode(' ', $classes),
+                'node' => $node->getValue(),
+            ],
+        );
+    }
+}

packages/guides/src/Nodes/AdmonitionNode.php

@@ -14,7 +14,7 @@
 namespace phpDocumentor\Guides\Nodes;
 
 /** @extends CompoundNode<Node> */
-final class AdmonitionNode extends CompoundNode
+class AdmonitionNode extends CompoundNode
 {
     /** @param Node[] $value */
     public function __construct(private readonly string $name, private readonly InlineCompoundNode|null $title, private readonly string $text, array $value, private readonly bool $isTitled = false)