Renaming of classes, making true recursive structure

app/Support/Search/QueryParser/FieldNode.php

@@ -7,7 +7,7 @@ namespace FireflyIII\Support\Search\QueryParser;
 /**
  * Represents a field operator with value (e.g. amount:100)
  */
-class Field extends Node
+class FieldNode extends Node
 {
     private string $operator;
     private string $value;

app/Support/Search/QueryParser/GdbotsQueryParser.php

@@ -19,17 +19,18 @@ class GdbotsQueryParser implements QueryParserInterface
     }
 
     /**
-     * @return Node[]
+     * @return NodeGroup
      * @throws FireflyException
      */
-    public function parse(string $query): array
+    public function parse(string $query): NodeGroup
     {
         try {
             $result = $this->parser->parse($query);
-            return array_map(
+            $nodes = array_map(
                 fn(GdbotsNode\Node $node) => $this->convertNode($node),
                 $result->getNodes()
             );
+            return new NodeGroup($nodes);
         } catch (\LogicException|\TypeError $e) {
             fwrite(STDERR, "Setting up GdbotsQueryParserTest\n");
             dd('Creating GdbotsQueryParser');
@@ -44,17 +45,17 @@ class GdbotsQueryParser implements QueryParserInterface
     {
         switch (true) {
             case $node instanceof GdbotsNode\Word:
-                return new Word($node->getValue());
+                return new StringNode($node->getValue());
 
             case $node instanceof GdbotsNode\Field:
-                return new Field(
+                return new FieldNode(
                     $node->getValue(),
                     (string) $node->getNode()->getValue(),
                     BoolOperator::PROHIBITED === $node->getBoolOperator()
                 );
 
             case $node instanceof GdbotsNode\Subquery:
-                return new Subquery(
+                return new NodeGroup(
                     array_map(
                         fn(GdbotsNode\Node $subNode) => $this->convertNode($subNode),
                         $node->getNodes()
@@ -69,7 +70,7 @@ class GdbotsQueryParser implements QueryParserInterface
             case $node instanceof GdbotsNode\Mention:
             case $node instanceof GdbotsNode\Emoticon:
             case $node instanceof GdbotsNode\Emoji:
-                return new Word((string) $node->getValue());
+                return new StringNode((string) $node->getValue());
 
             default:
                 throw new FireflyException(

app/Support/Search/QueryParser/NodeGroup.php

@@ -5,9 +5,11 @@ declare(strict_types=1);
 namespace FireflyIII\Support\Search\QueryParser;
 
 /**
- * Represents a subquery (group of nodes)
+ * Represents a group of nodes.
+ *
+ * NodeGroups can be nested inside other NodeGroups, making them subqueries
  */
-class Subquery extends Node
+class NodeGroup extends Node
 {
     /** @var Node[] */
     private array $nodes;

app/Support/Search/QueryParser/QueryParser.php

@@ -30,16 +30,16 @@ class QueryParser implements QueryParserInterface
     private string $query;
     private int $position = 0;
 
-    /** @return Node[] */
-    public function parse(string $query): array
+    /** @return NodeGroup */
+    public function parse(string $query): NodeGroup
     {
         $this->query = $query;
         $this->position = 0;
-        return $this->parseQuery(false);
+        return $this->buildNodeGroup(false);
     }
 
-    /** @return Node[] */
-    private function parseQuery(bool $isSubquery): array
+    /** @return NodeGroup */
+    private function buildNodeGroup(bool $isSubquery, bool $prohibited = false): NodeGroup
     {
         $nodes = [];
         $nodeResult = $this->buildNextNode($isSubquery);
@@ -52,7 +52,7 @@ class QueryParser implements QueryParserInterface
             $nodeResult = $this->buildNextNode($isSubquery);
         }
 
-        return $nodes;
+        return new NodeGroup($nodes, $prohibited);
     }
 
     private function buildNextNode(bool $isSubquery): NodeResult
@@ -105,8 +105,7 @@ class QueryParser implements QueryParserInterface
                     if ($tokenUnderConstruction === '') {
                         // A left parentheses at the beginning of a token indicates the start of a subquery
                         $this->position++;
-                        return new NodeResult(
-                            new Subquery($this->parseQuery(true), $prohibited),
+                        return new NodeResult($this->buildNodeGroup(true, $prohibited),
                             false
                         );
                     } else {
@@ -161,16 +160,18 @@ class QueryParser implements QueryParserInterface
             $this->position++;
         }
 
-        return new NodeResult($tokenUnderConstruction !== '' || $fieldName !== ''
-            ? $this->createNode($tokenUnderConstruction, $fieldName, $prohibited)
-            : null, true);
+        $finalNode = $tokenUnderConstruction !== '' || $fieldName !== ''
+        ? $this->createNode($tokenUnderConstruction, $fieldName, $prohibited)
+        : null;
+
+        return new NodeResult($finalNode, true);
     }
 
     private function createNode(string $token, string $fieldName, bool $prohibited): Node
     {
         if (strlen($fieldName) > 0) {
-            return new Field(trim($fieldName), trim($token), $prohibited);
+            return new FieldNode(trim($fieldName), trim($token), $prohibited);
         }
-        return new Word(trim($token), $prohibited);
+        return new StringNode(trim($token), $prohibited);
     }
 }

app/Support/Search/QueryParser/QueryParserInterface.php

@@ -7,7 +7,7 @@ namespace FireflyIII\Support\Search\QueryParser;
 interface QueryParserInterface
 {
     /**
-     * @return Node[]
+     * @return NodeGroup
      */
-    public function parse(string $query): array;
+    public function parse(string $query): NodeGroup;
 }

app/Support/Search/QueryParser/StringNode.php

@@ -5,9 +5,9 @@ declare(strict_types=1);
 namespace FireflyIII\Support\Search\QueryParser;
 
 /**
- * Represents a word in the search query, meaning either a single-word without spaces or a quote-delimited string
+ * Represents a string in the search query, meaning either a single-word without spaces or a quote-delimited string
  */
-class Word extends Node
+class StringNode extends Node
 {
     private string $value;