TASK: Implement TextParser

Author: grebaldi

src/Language/AST/Node/Text/TextNode.php

@@ -0,0 +1,35 @@
+<?php
+
+/**
+ * PackageFactory.ComponentEngine - Universal View Components for PHP
+ *   Copyright (C) 2023 Contributors of PackageFactory.ComponentEngine
+ *
+ *   This program is free software: you can redistribute it and/or modify
+ *   it under the terms of the GNU General Public License as published by
+ *   the Free Software Foundation, either version 3 of the License, or
+ *   (at your option) any later version.
+ *
+ *   This program is distributed in the hope that it will be useful,
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *   GNU General Public License for more details.
+ *
+ *   You should have received a copy of the GNU General Public License
+ *   along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+namespace PackageFactory\ComponentEngine\Language\AST\Node\Text;
+
+use PackageFactory\ComponentEngine\Language\AST\Node\Node;
+use PackageFactory\ComponentEngine\Language\AST\NodeAttributes\NodeAttributes;
+
+final class TextNode extends Node
+{
+    public function __construct(
+        public readonly NodeAttributes $attributes,
+        public readonly string $value
+    ) {
+    }
+}

src/Language/Parser/Text/TextParser.php

@@ -0,0 +1,96 @@
+<?php
+
+/**
+ * PackageFactory.ComponentEngine - Universal View Components for PHP
+ *   Copyright (C) 2023 Contributors of PackageFactory.ComponentEngine
+ *
+ *   This program is free software: you can redistribute it and/or modify
+ *   it under the terms of the GNU General Public License as published by
+ *   the Free Software Foundation, either version 3 of the License, or
+ *   (at your option) any later version.
+ *
+ *   This program is distributed in the hope that it will be useful,
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *   GNU General Public License for more details.
+ *
+ *   You should have received a copy of the GNU General Public License
+ *   along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+namespace PackageFactory\ComponentEngine\Language\Parser\Text;
+
+use PackageFactory\ComponentEngine\Language\AST\Node\Text\TextNode;
+use PackageFactory\ComponentEngine\Language\AST\NodeAttributes\NodeAttributes;
+use PackageFactory\ComponentEngine\Parser\Source\Range;
+use PackageFactory\ComponentEngine\Parser\Tokenizer\Scanner;
+use PackageFactory\ComponentEngine\Parser\Tokenizer\Token;
+use PackageFactory\ComponentEngine\Parser\Tokenizer\TokenType;
+
+final class TextParser
+{
+    /**
+     * @param \Iterator<mixed,Token> $tokens
+     * @param boolean $preserveLeadingSpace
+     * @return null|TextNode
+     */
+    public function parse(\Iterator $tokens, bool $preserveLeadingSpace = false): ?TextNode
+    {
+        $value = '';
+        $startingToken = null;
+        $finalToken = null;
+        $ignoreSpace = false;
+        $keepTrailingSpace = false;
+        while (!Scanner::isEnd($tokens)) {
+            $startingToken ??= $tokens->current();
+            switch (Scanner::type($tokens)) {
+                case TokenType::BRACKET_CURLY_OPEN:
+                case TokenType::TAG_START_OPENING:
+                    $keepTrailingSpace = true;
+                    break 2;
+                case TokenType::TAG_START_CLOSING:
+                    $value = rtrim($value);
+                    break 2;
+                case TokenType::SPACE:
+                case TokenType::END_OF_LINE:
+                    if (!$ignoreSpace) {
+                        $value .= ' ';
+                    }
+                    $ignoreSpace = true;
+                    $finalToken = $tokens->current();
+                    Scanner::skipOne($tokens);
+                    break;
+                default:
+                    $value .= Scanner::value($tokens);
+                    $ignoreSpace = false;
+                    $finalToken = $tokens->current();
+                    Scanner::skipOne($tokens);
+                    break;
+            }
+        }
+
+        if (is_null($startingToken) || is_null($finalToken)) {
+            return null;
+        }
+
+        if (!$keepTrailingSpace) {
+            $value = $preserveLeadingSpace ? rtrim($value) : trim($value);
+        }
+
+        if ($value === '' || $value === ' ') {
+            return null;
+        }
+
+        return new TextNode(
+            attributes: new NodeAttributes(
+                rangeInSource: Range::from(
+                    $startingToken->boundaries->start,
+                    $finalToken->boundaries->end
+                )
+            ),
+            value: $value
+        );
+    }
+}

src/Parser/Tokenizer/Tokenizer.php

@@ -56,6 +56,10 @@ public function getIterator(): \Iterator
      */
     private static function block(\Iterator $fragments): \Iterator
     {
+        if (!$fragments->valid()) {
+            return;
+        }
+
         $bracket = TokenType::tryBracketOpenFromFragment($fragments->current());
         $buffer = Buffer::empty();