Add contains operator to expressions

Author: jaapio

src/AST/Comparison.php

@@ -32,6 +32,7 @@ public function visit(Executor $param, $currentObject, $root): bool
             '==' => $param->evaluateEqualsComparison($root, $currentObject, $this->left, $this->right),
             '!=' => $param->evaluateNotEqualsComparison($root, $currentObject, $this->left, $this->right),
             'starts_with' => $param->evaluateStartsWithComparison($root, $currentObject, $this->left, $this->right),
+            'contains' => $param->evaluateContainsComparison($root, $currentObject, $this->left, $this->right),
             default => throw new InvalidArgumentException(),
         };
     }

src/Executor.php

@@ -87,6 +87,32 @@ public function evaluateStartsWithComparison(
         return str_starts_with((string) $leftValue, (string) $rightValue);
     }
 
+    public function evaluateContainsComparison(
+        mixed $root,
+        mixed $currentObject,
+        QueryNode $left,
+        QueryNode $right,
+    ): bool {
+        $leftValue = $this->toValue($this->evaluate($left, $currentObject, $root));
+        $rightValue = $this->toValue($this->evaluate($right, $currentObject, $root));
+
+        if (is_iterable($leftValue)) {
+            foreach ($leftValue as $value) {
+                if (is_string($rightValue) && ((string) $value) === $rightValue) {
+                    return true;
+                }
+
+                if ($value === $rightValue) {
+                    return true;
+                }
+            }
+
+            return false;
+        }
+
+        return false;
+    }
+
     /**
      * @param Generator<mixed>|mixed $value
      *

src/Parser/ParserBuilder.php

@@ -98,6 +98,7 @@ private static function expression(): Parser
             string('=='),
             string('!='),
             string('starts_with'),
+            string('contains'),
         );
 
         $value = choice(