Remove "Wrapper" abstract class

With PHP's promoted properties, there is little reason to have an
abstract class that only provides a constructor and a proxy method.
The greater part of the classes that extended Wrapper had their own
implementation of evaluate(), hence it made very little sense to keep
Wrapper in the codebase.

Assisted-by: Claude Code (Opus 4.5)

Author: henriquemoody

docs/migrating-from-v2-to-v3.md

@@ -556,7 +556,6 @@ final class Custom implements Validator
 Base classes available in `Respect\Validation\Validators\Core`:
 
 - `Simple` - For validators with simple boolean logic
-- `Wrapper` - For validators that wrap another validator
 - `Composite` - For validators that combine multiple validators
 - `Envelope` - For validators that modify how another validator works
 

src/ValidatorBuilder.php

@@ -26,7 +26,7 @@
 use function is_string;
 
 /** @mixin Builder */
-final readonly class ValidatorBuilder implements Validator, Nameable
+final readonly class ValidatorBuilder implements Nameable
 {
     /** @var array<Validator> */
     private array $validators;

src/Validators/Core/FilteredArray.php

@@ -12,13 +12,19 @@
 namespace Respect\Validation\Validators\Core;
 
 use Respect\Validation\Result;
+use Respect\Validation\Validator;
 use Respect\Validation\Validators\IterableType;
 
 use function is_array;
 use function iterator_to_array;
 
-abstract class FilteredArray extends Wrapper
+abstract class FilteredArray implements Validator
 {
+    public function __construct(
+        protected Validator $validator,
+    ) {
+    }
+
     public function evaluate(mixed $input): Result
     {
         $iterableResult = (new IterableType())->evaluate($input);

src/Validators/Core/Nameable.php

@@ -15,8 +15,9 @@
 namespace Respect\Validation\Validators\Core;
 
 use Respect\Validation\Name;
+use Respect\Validation\Validator;
 
-interface Nameable
+interface Nameable extends Validator
 {
     public function getName(): Name|null;
 }

src/Validators/Core/Reducer.php

@@ -10,13 +10,21 @@
 
 namespace Respect\Validation\Validators\Core;
 
+use Respect\Validation\Result;
 use Respect\Validation\Validator;
 use Respect\Validation\Validators\AllOf;
 
-final class Reducer extends Wrapper
+final readonly class Reducer implements Validator
 {
+    private Validator $validator;
+
     public function __construct(Validator $validator1, Validator ...$validators)
     {
-        parent::__construct($validators === [] ? $validator1 : new AllOf($validator1, ...$validators));
+        $this->validator = $validators === [] ? $validator1 : new AllOf($validator1, ...$validators);
+    }
+
+    public function evaluate(mixed $input): Result
+    {
+        return $this->validator->evaluate($input);
     }
 }

src/Validators/Core/Wrapper.php

@@ -20,16 +20,14 @@
 use Respect\Validation\Result;
 use Respect\Validation\Validator;
 use Respect\Validation\Validators\Core\KeyRelated;
-use Respect\Validation\Validators\Core\Wrapper;
 
 #[Attribute(Attribute::TARGET_PROPERTY | Attribute::IS_REPEATABLE)]
-final class Key extends Wrapper implements KeyRelated
+final readonly class Key implements KeyRelated
 {
     public function __construct(
-        private readonly int|string $key,
-        Validator $validator,
+        private int|string $key,
+        private Validator $validator,
     ) {
-        parent::__construct($validator);
     }
 
     public function getKey(): int|string

src/Validators/Key.php

@@ -15,16 +15,14 @@
 use Respect\Validation\Result;
 use Respect\Validation\Validator;
 use Respect\Validation\Validators\Core\KeyRelated;
-use Respect\Validation\Validators\Core\Wrapper;
 
 #[Attribute(Attribute::TARGET_PROPERTY | Attribute::IS_REPEATABLE)]
-final class KeyOptional extends Wrapper implements KeyRelated
+final readonly class KeyOptional implements KeyRelated
 {
     public function __construct(
-        private readonly int|string $key,
-        Validator $validator,
+        private int|string $key,
+        private Validator $validator,
     ) {
-        parent::__construct($validator);
     }
 
     public function getKey(): int|string

src/Validators/KeyOptional.php

@@ -22,7 +22,7 @@
 use Countable as PhpCountable;
 use Respect\Validation\Message\Template;
 use Respect\Validation\Result;
-use Respect\Validation\Validators\Core\Wrapper;
+use Respect\Validation\Validator;
 
 use function count;
 use function is_array;
@@ -40,10 +40,15 @@
     '{{subject}} must not be a countable value or a string',
     self::TEMPLATE_WRONG_TYPE,
 )]
-final class Length extends Wrapper
+final readonly class Length implements Validator
 {
     public const string TEMPLATE_WRONG_TYPE = '__wrong_type__';
 
+    public function __construct(
+        private Validator $validator,
+    ) {
+    }
+
     public function evaluate(mixed $input): Result
     {
         $length = $this->extractLength($input);

src/Validators/Length.php

@@ -15,19 +15,18 @@
 use Respect\Validation\Result;
 use Respect\Validation\Validator;
 use Respect\Validation\Validators\Core\Nameable;
-use Respect\Validation\Validators\Core\Wrapper;
 
 use function is_string;
 
 #[Attribute(Attribute::TARGET_PROPERTY | Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
-final class Named extends Wrapper implements Nameable
+final readonly class Named implements Nameable
 {
-    private readonly Name $name;
-
-    public function __construct(string|Name $name, Validator $validator)
-    {
-        parent::__construct($validator);
+    private Name $name;
 
+    public function __construct(
+        string|Name $name,
+        private Validator $validator,
+    ) {
         $this->name = is_string($name) ? new Name($name) : $name;
     }