Added Logical rules

Added SingularRule, AndRule, OrRule

Author: Fa-BRAIK

src/Exceptions/LogicalRuleException.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Exceptions;
+
+use Exception;
+
+class LogicalRuleException extends Exception
+{
+    protected const int UNABLE_TO_CREATE_RULE_CODE = 1;
+
+    public static function unableToCreateRule(string $message = 'Unable to create rule'): self
+    {
+        return new self($message, self::UNABLE_TO_CREATE_RULE_CODE);
+    }
+}

src/Support/Collection.php

@@ -0,0 +1,82 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Support;
+
+/**
+ * @template TKey of array-key
+ * @template TValue of mixed
+ */
+class Collection
+{
+    /** @var array<TKey, TValue> */
+    protected array $items = [];
+
+    /**
+     * @param array<TKey, TValue> $items
+     */
+    public function __construct(array $items = [])
+    {
+        $this->items = $items;
+    }
+
+    /**
+     * @param TValue $item
+     *
+     * @return self<TKey, TValue>
+     */
+    public function push(mixed $item): self
+    {
+        $this->items[] = $item;
+        return $this;
+    }
+
+    /**
+     * @param TKey $key
+     * @param TValue $value
+     *
+     * @return self<TKey, TValue>
+     */
+    public function put(mixed $key, mixed $value): self
+    {
+        $this->items[$key] = $value;
+        return $this;
+    }
+
+    /**
+     * @param ?callable(TValue $item): bool $callable
+     *
+     * @return ?TValue
+     */
+    public function first(?callable $callable = null): mixed
+    {
+        return is_null($callable)
+            ? reset($this->items) ?: null
+            : array_find($this->items, $callable);
+    }
+
+    public function isNotEmpty(): bool
+    {
+        return !empty($this->items);
+    }
+
+    public function isEmpty(): bool
+    {
+        return !$this->isNotEmpty();
+    }
+
+    /**
+     * @param callable(TValue $item): bool $callable
+     */
+    public function every(callable $callable): bool
+    {
+        return array_all($this->items, $callable);
+    }
+
+    /**
+     * @param callable(TValue $item): bool $callable
+     */
+    public function some(callable $callable): bool
+    {
+        return array_any($this->items, $callable);
+    }
+}

src/Validation/Contracts/RuleEvaluator.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Validation\Contracts;
+
+interface RuleEvaluator
+{
+    public function evaluate(mixed $value): bool;
+}

src/Validation/Contracts/RuleGroup.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Validation\Contracts;
+
+use Nuxtifyts\PhpDto\Exceptions\ValidationRuleException;
+use Nuxtifyts\PhpDto\Support\Collection;
+
+interface RuleGroup
+{
+    /** @var Collection<array-key, RuleEvaluator> */
+    public Collection $rules { get; }
+
+    /**
+     * @throws ValidationRuleException
+     */
+    public function addRule(RuleEvaluator $rule): static;
+}

src/Validation/Logic/AndRule.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Validation\Logic;
+
+use Nuxtifyts\PhpDto\Validation\Contracts\RuleEvaluator;
+
+class AndRule extends LogicalRule
+{
+    public function evaluate(mixed $value): bool
+    {
+        return $this->rules->every(
+            static fn (RuleEvaluator $rule) => $rule->evaluate($value)
+        );
+    }
+}

src/Validation/Logic/LogicalRule.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Validation\Logic;
+
+use Nuxtifyts\PhpDto\Support\Collection;
+use Nuxtifyts\PhpDto\Validation\Contracts\RuleEvaluator;
+use Nuxtifyts\PhpDto\Validation\Contracts\RuleGroup;
+
+abstract class LogicalRule implements RuleGroup, RuleEvaluator
+{
+    /** @var ?Collection<array-key, RuleEvaluator> */
+    protected ?Collection $_rules = null;
+
+    /** @var Collection<array-key, RuleEvaluator> */
+    public Collection $rules {
+        get {
+            return $this->_rules ??= new Collection();
+        }
+    }
+
+    public function addRule(RuleEvaluator $rule): static
+    {
+        $this->rules->push($rule);
+        return $this;
+    }
+}

src/Validation/Logic/OrRule.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Validation\Logic;
+
+use Nuxtifyts\PhpDto\Validation\Contracts\RuleEvaluator;
+
+class OrRule extends LogicalRule
+{
+    public function evaluate(mixed $value): bool
+    {
+        return $this->rules->some(
+            static fn (RuleEvaluator $rule) => $rule->evaluate($value)
+        );
+    }
+}

src/Validation/Logic/SingularRule.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Validation\Logic;
+
+use Nuxtifyts\PhpDto\Exceptions\LogicalRuleException;
+use Nuxtifyts\PhpDto\Validation\Contracts\RuleEvaluator;
+use Override;
+
+class SingularRule extends LogicalRule
+{
+    /**
+     * @throws LogicalRuleException
+     */
+    #[Override]
+    public function addRule(RuleEvaluator $rule): static
+    {
+        if ($this->rules->isNotEmpty()) {
+            throw LogicalRuleException::unableToCreateRule('SingularRule can only have one rule');
+        }
+
+        $this->rules->push($rule);
+        return $this;
+    }
+
+    public function evaluate(mixed $value): bool
+    {
+        return (bool) $this->rules->first()?->evaluate($value);
+    }
+}

src/Validation/RuleContext.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Validation;
+
+class RuleContext
+{
+
+}

src/Validation/Rules/ValidationRule.php

@@ -3,13 +3,12 @@
 namespace Nuxtifyts\PhpDto\Validation\Rules;
 
 use Nuxtifyts\PhpDto\Exceptions\ValidationRuleException;
+use Nuxtifyts\PhpDto\Validation\Contracts\RuleEvaluator;
 
-interface ValidationRule
+interface ValidationRule extends RuleEvaluator
 {
     public string $name { get; }
 
-    public function evaluate(mixed $value): bool;
-
     /** 
      * @param ?array<string, mixed> $parameters
      *