feat: added Type rule documentation

Author: andrepimpao

docs/03-rules.md

@@ -8,6 +8,7 @@
 ## Basic Rules
 
 - [NotBlank](03x-rules-not-blank.md)
+- [Type](03x-rules-type.md)
 
 ## Comparison Rules
 

docs/03x-rules-type.md

@@ -0,0 +1,87 @@
+# Type
+
+Validates that a value is of a specific type.
+
+If an array with multiple types is provided, it will validate if the value is of at least one of the given types.
+For example, if `['alpha', 'numeric']` is provided, it will validate if the value is of type `alpha` or of type `numeric`.
+
+```php
+Type(
+    string|array $constraint,
+    string $message = 'The "{{ name }}" value should be of type "{{ constraint }}", "{{ value }}" given.'
+)
+```
+
+## Basic Usage
+
+```php
+// Single data type
+Validator::type('string')->validate('green'); // true
+Validator::type('alphanumeric')->validate('gr33n'); // true
+
+// Multiple data types
+// Validates if value is of at least one of the provided types
+Validator::type(['alpha', 'numeric'])->validate('green'); // true (alpha)
+Validator::type(['alpha', 'numeric'])->validate('33'); // true (numeric)
+Validator::type(['alpha', 'numeric'])->validate('gr33n'); // false (not alpha nor numeric)
+
+// Class or interface type
+Validator::type(\DateTime::class)->validate(new \DateTime()); // true
+Validator::type(\DateTimeInterface::class)->validate(new \DateTime()); // true
+```
+
+> **Note**
+> An `UnexpectedValueException` will be thrown when a constraint type, class and interface is invalid.
+
+## Options
+
+### `constraints`
+
+type: `string`|`array` `required`
+
+Type(s) to validate the input value type. 
+Can validate instances of classes and interfaces.
+
+If an array with multiple types is provided, it will validate if the value is of at least one of the given types.
+For example, if `['alpha', 'numeric']` is provided, it will validate if the value is of type `alpha` or of type `numeric`.
+
+Available constraint types:
+
+- [`bool`](https://www.php.net/manual/en/function.is-bool.php), [`boolean`](https://www.php.net/manual/en/function.is-bool.php)
+- [`int`](https://www.php.net/manual/en/function.is-int.php), [`integer`](https://www.php.net/manual/en/function.is-int.php), [`long`](https://www.php.net/manual/en/function.is-int.php)
+- [`float`](https://www.php.net/manual/en/function.is-float.php), [`double`](https://www.php.net/manual/en/function.is-float.php), [`real`](https://www.php.net/manual/en/function.is-float.php)
+- [`numeric`](https://www.php.net/manual/en/function.is-numeric.php)
+- [`string`](https://www.php.net/manual/en/function.is-string.php)
+- [`scalar`](https://www.php.net/manual/en/function.is-scalar.php)
+- [`array`](https://www.php.net/manual/en/function.is-array.php)
+- [`iterable`](https://www.php.net/manual/en/function.is-iterable.php)
+- [`countable`](https://www.php.net/manual/en/function.is-countable.php)
+- [`callable`](https://www.php.net/manual/en/function.is-callable.php)
+- [`object`](https://www.php.net/manual/en/function.is-object.php)
+- [`resource`](https://www.php.net/manual/en/function.is-resource.php)
+- [`null`](https://www.php.net/manual/en/function.is-null.php)
+- [`alphanumeric`](https://www.php.net/manual/en/function.ctype-alnum)
+- [`alpha`](https://www.php.net/manual/en/function.ctype-alpha.php)
+- [`digit`](https://www.php.net/manual/en/function.ctype-digit.php)
+- [`control`](https://www.php.net/manual/en/function.ctype-cntrl.php)
+- [`punctuation`](https://www.php.net/manual/en/function.ctype-punct.php)
+- [`hexadecimal`](https://www.php.net/manual/en/function.ctype-xdigit.php)
+- [`graph`](https://www.php.net/manual/en/function.ctype-graph.php)
+- [`printable`](https://www.php.net/manual/en/function.ctype-print.php)
+- [`whitespace`](https://www.php.net/manual/en/function.ctype-space.php)
+- [`lowercase`](https://www.php.net/manual/en/function.ctype-lower.php)
+- [`uppercase`](https://www.php.net/manual/en/function.ctype-upper.php)
+
+### `message`
+
+type `string` default: `The "{{ name }}" value should be of type "{{ constraint }}", "{{ value }}" given.`
+
+Message that will be shown if input value is not of a specific type.
+
+The following parameters are available:
+
+| Parameter           | Description               |
+|---------------------|---------------------------|
+| `{{ value }}`       | The current invalid value |
+| `{{ name }}`        | Name of the invalid value |
+| `{{ constraints }}` | The valid type(s)         |

src/ChainedValidatorInterface.php

@@ -64,4 +64,9 @@ public function range(
     ): ChainedValidatorInterface;
 
     public function rule(RuleInterface $constraint): ChainedValidatorInterface;
+
+    public function type(
+        string|array $constraints,
+        string $message = 'The "{{ name }}" value should be of type "{{ constraint }}", "{{ value }}" given.'
+    ): ChainedValidatorInterface;
 }

src/StaticValidatorInterface.php

@@ -54,4 +54,9 @@ public static function range(
     ): ChainedValidatorInterface;
 
     public static function rule(RuleInterface $constraint): ChainedValidatorInterface;
+
+    public static function type(
+        string|array $constraints,
+        string $message = 'The "{{ name }}" value should be of type "{{ constraint }}", "{{ value }}" given.'
+    ): ChainedValidatorInterface;
 }