close #26

Author: rodber

README.md

@@ -205,7 +205,7 @@ $id = $arguments->get('id'); // 1
 
 ## Get argument value (typed)
 
-Use method `required()` to retrieve a explicit required argument value by name or position. It returns as `CastInterface`, enabling typed access to the value. The method `optional()` can be used to retrieve an optional argument value.
+Use method `required()` to retrieve a explicit required argument value by name or position. It returns as `TypedInterface`, enabling type-safe access to the value. The method `optional()` can be used to retrieve an optional argument value.
 
 ```php
 $id = $arguments->required('id')->int(); // 1

composer.json

@@ -18,7 +18,6 @@
         "chevere/regex": "^1.0.1"
     },
     "require-dev": {
-        "chevere/var-dump": "^2.0",
         "phpstan/phpstan": "^2.1",
         "phpunit/phpunit": "^10.5",
         "symplify/easy-coding-standard": "^12.3"

src/Arguments.php

@@ -14,8 +14,8 @@
 namespace Chevere\Parameter;
 
 use Chevere\Parameter\Interfaces\ArgumentsInterface;
-use Chevere\Parameter\Interfaces\CastInterface;
 use Chevere\Parameter\Interfaces\ParametersAccessInterface;
+use Chevere\Parameter\Interfaces\TypedInterface;
 use Chevere\Parameter\Traits\ArgumentsTrait;
 use Chevere\Parameter\Traits\ExceptionErrorMessageTrait;
 use InvalidArgumentException;
@@ -64,7 +64,7 @@ public function get(string $name): mixed
         return $this->arguments[$name] ?? null;
     }
 
-    public function required(string $name): CastInterface
+    public function required(string $name): TypedInterface
     {
         if ($this->parameters()->optionalKeys()->contains($name)) {
             throw new InvalidArgumentException(
@@ -75,10 +75,10 @@ public function required(string $name): CastInterface
             );
         }
 
-        return new Cast($this->arguments[$name]);
+        return new Typed($this->arguments[$name]);
     }
 
-    public function optional(string $name): ?CastInterface
+    public function optional(string $name): ?TypedInterface
     {
         if ($this->parameters()->has($name)
             && ! $this->parameters()->optionalKeys()->contains($name)
@@ -92,7 +92,7 @@ public function optional(string $name): ?CastInterface
         }
 
         if ($this->has($name)) {
-            return new Cast($this->arguments[$name]);
+            return new Typed($this->arguments[$name]);
         }
 
         return null;

src/Interfaces/ArgumentsInterface.php

@@ -52,12 +52,12 @@ public function get(string $name): mixed;
     /**
      * Provides access to the required argument for the parameter `$name`.
      */
-    public function required(string $name): CastInterface;
+    public function required(string $name): TypedInterface;
 
     /**
      * Provides access to the optional argument for the parameter `$name`.
      */
-    public function optional(string $name): ?CastInterface;
+    public function optional(string $name): ?TypedInterface;
 
     /**
      * Provides access to a nested ArgumentsInterface specific to the parameter `$name`

src/Interfaces/ParameterCastInterface.php …c/Interfaces/ParameterTypedInterface.phpsrc/Interfaces/ParameterCastInterface.php renamed to src/Interfaces/ParameterTypedInterface.php src/Interfaces/ParameterCastInterface.php renamed to src/Interfaces/ParameterTypedInterface.php

@@ -14,9 +14,9 @@
 namespace Chevere\Parameter\Interfaces;
 
 /**
- * Describes the component in charge of casting a parameter.
+ * Describes the component providing type-safe access to a parameter.
  */
-interface ParameterCastInterface
+interface ParameterTypedInterface
 {
     public function array(): ArrayParameterInterface;
 

src/Interfaces/ParametersInterface.php

@@ -124,22 +124,22 @@ public function optionalMinimum(): int;
     public function get(string $name): ParameterInterface;
 
     /**
-     * Provides cast access to the required parameter by name.
+     * Provides type-safe access to the required parameter by name.
      *
      * ```php
      * $parameters->required('name')->string();
      * ```
      */
-    public function required(string $name): ParameterCastInterface;
+    public function required(string $name): ParameterTypedInterface;
 
     /**
-     * Provides cast access to the optional parameter by name.
+     * Provides type-safe access to the optional parameter by name.
      *
      * ```php
      * $parameters->optional('name')->string();
      * ```
      */
-    public function optional(string $name): ParameterCastInterface;
+    public function optional(string $name): ParameterTypedInterface;
 
     /**
      * Return an instance with the specified $isVariadic.

src/Interfaces/CastInterface.php src/Interfaces/TypedInterface.phpsrc/Interfaces/CastInterface.php renamed to src/Interfaces/TypedInterface.php

@@ -14,9 +14,9 @@
 namespace Chevere\Parameter\Interfaces;
 
 /**
- * Describes the component in charge of casting an argument.
+ * Describes the component in charge of providing a type-safe accessor.
  */
-interface CastInterface
+interface TypedInterface
 {
     public function int(): int;
 

src/ParameterCast.php src/ParameterTyped.phpsrc/ParameterCast.php renamed to src/ParameterTyped.php

@@ -20,11 +20,11 @@
 use Chevere\Parameter\Interfaces\IterableParameterInterface;
 use Chevere\Parameter\Interfaces\NullParameterInterface;
 use Chevere\Parameter\Interfaces\ObjectParameterInterface;
-use Chevere\Parameter\Interfaces\ParameterCastInterface;
+use Chevere\Parameter\Interfaces\ParameterTypedInterface;
 use Chevere\Parameter\Interfaces\StringParameterInterface;
 use Chevere\Parameter\Interfaces\UnionParameterInterface;
 
-final class ParameterCast implements ParameterCastInterface
+final class ParameterTyped implements ParameterTypedInterface
 {
     // @phpstan-ignore-next-line
     public function __construct(

src/Parameters.php

@@ -19,9 +19,9 @@
 use Chevere\DataStructure\Traits\MapTrait;
 use Chevere\DataStructure\Vector;
 use Chevere\Parameter\Interfaces\ArgumentsInterface;
-use Chevere\Parameter\Interfaces\ParameterCastInterface;
 use Chevere\Parameter\Interfaces\ParameterInterface;
 use Chevere\Parameter\Interfaces\ParametersInterface;
+use Chevere\Parameter\Interfaces\ParameterTypedInterface;
 use InvalidArgumentException;
 use OverflowException;
 use function Chevere\Message\message;
@@ -216,7 +216,7 @@ public function get(string $name): ParameterInterface
         return $this->map->get($name);
     }
 
-    public function required(string $name): ParameterCastInterface
+    public function required(string $name): ParameterTypedInterface
     {
         $parameter = $this->get($name);
         if ($this->optionalKeys()->contains($name)) {
@@ -228,10 +228,10 @@ public function required(string $name): ParameterCastInterface
             );
         }
 
-        return new ParameterCast($parameter);
+        return new ParameterTyped($parameter);
     }
 
-    public function optional(string $name): ParameterCastInterface
+    public function optional(string $name): ParameterTypedInterface
     {
         $parameter = $this->get($name);
         if (! $this->optionalKeys()->contains($name)) {
@@ -243,7 +243,7 @@ public function optional(string $name): ParameterCastInterface
             );
         }
 
-        return new ParameterCast($parameter);
+        return new ParameterTyped($parameter);
     }
 
     private function remove(string ...$name): void

src/Cast.php src/Typed.phpsrc/Cast.php renamed to src/Typed.php

@@ -13,9 +13,9 @@
 
 namespace Chevere\Parameter;
 
-use Chevere\Parameter\Interfaces\CastInterface;
+use Chevere\Parameter\Interfaces\TypedInterface;
 
-final class Cast implements CastInterface
+final class Typed implements TypedInterface
 {
     // @phpstan-ignore-next-line
     public function __construct(