fix(view): support doc comment elements (#816)

Author: brendt

src/Tempest/View/src/Elements/CommentElement.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\View\Elements;
+
+use Tempest\View\Element;
+
+final class CommentElement implements Element
+{
+    use IsElement;
+
+    public function __construct(
+        private readonly string $content,
+    ) {
+    }
+
+    public function compile(): string
+    {
+        return sprintf('<!--%s-->', $this->content);
+    }
+}

src/Tempest/View/src/Elements/ElementFactory.php

@@ -4,6 +4,7 @@
 
 namespace Tempest\View\Elements;
 
+use Dom\Comment;
 use Dom\Element as DomElement;
 use Dom\Node;
 use Dom\Text;
@@ -12,7 +13,6 @@
 use Tempest\View\Renderers\TempestViewCompiler;
 use Tempest\View\ViewComponent;
 use Tempest\View\ViewConfig;
-use const XML_ELEMENT_NODE;
 use function Tempest\Support\str;
 
 final class ElementFactory
@@ -52,12 +52,14 @@ private function makeElement(Node $node, ?Element $parent): ?Element
             );
         }
 
-        $tagName = null;
-
-        if ($node->nodeType == XML_ELEMENT_NODE) {
-            $tagName = strtolower($node->tagName);
+        if ($node instanceof Comment) {
+            return new CommentElement(
+                content: $node->textContent,
+            );
         }
 
+        $tagName = strtolower($node->tagName);
+
         $attributes = [];
 
         /** @var \Dom\Attr $attribute */

tests/Integration/View/TempestViewRendererTest.php

@@ -421,22 +421,21 @@ public function test_view_component_with_multiple_attributes(): void
 
     public function test_slot_with_comment(): void
     {
-        $this->assertSame(
+        $this->assertStringEqualsStringIgnoringLineEndings(
             <<<'HTML'
-            <div class="base">
-                
-            
-                Test
-            
-            </div>
-            HTML,
-            $this->render(
-                <<<'HTML'
-                <x-base-layout>
-                    <!-- example of comment -->
+                <div class="base"><!-- example of comment -->
+
                     Test
-                </x-base-layout>
+
+                </div>
                 HTML,
+            $this->render(
+                <<<'HTML'
+                    <x-base-layout>
+                        <!-- example of comment -->
+                        Test
+                    </x-base-layout>
+                    HTML,
             ),
         );
     }