Remove Masked validator in favor of Formatted

The Masked validator was a proxy for what the new Formatted validator
already does, so it is being removed to reduce redundancy. All tests and
documentation have been updated accordingly.

Assisted-by: OpenCode (ollama-cloud/glm-4.7)

Author: henriquemoody

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

@@ -591,7 +591,6 @@ Version 3.0 introduces several new validators:
 | `KeyExists`        | Checks if an array key exists                              |
 | `KeyOptional`      | Validates an array key only if it exists                   |
 | `Factory`          | Creates validators dynamically based on input              |
-| `Masked`           | Masks sensitive input values in error messages             |
 | `Named`            | Customizes the subject name in error messages              |
 | `PropertyExists`   | Checks if an object property exists                        |
 | `PropertyOptional` | Validates an object property only if it exists             |
@@ -732,18 +731,6 @@ v::factory(
 )->assert(['password' => 'secret', 'confirmation' => 'secret']); // passes
 ```
 
-#### Masked
-
-Decorates a validator to mask sensitive input values in error messages while still validating the original unmasked data. This allows applications to protect sensitive information like passwords, credit cards, or emails without implementing a custom layer between Validation and end users:
-
-```php
-v::masked('1-@', v::email(),v::email())->assert('invalid@example.com');
-// → "*******@example.com" must be a valid email address
-
-v::masked('6-12', v::creditCard(), 'X')->assert('4111111111111211');
-// → "41111XXXXXXX1211" must be a valid credit card number
-```
-
 #### Named
 
 Customizes the subject name in error messages:

docs/validators.md

@@ -27,7 +27,7 @@ In this page you will find a list of validators by their category.
 
 **Date and Time**: [Date][] - [DateTime][] - [DateTimeDiff][] - [LeapDate][] - [LeapYear][] - [Time][]
 
-**Display**: [Format][] - [Formatted][] - [Masked][] - [Named][] - [Templated][]
+**Display**: [Format][] - [Formatted][] - [Named][] - [Templated][]
 
 **File system**: [Directory][] - [Executable][] - [Exists][] - [Extension][] - [File][] - [Image][] - [Mimetype][] - [Readable][] - [Size][] - [SymbolicLink][] - [Writable][]
 
@@ -41,7 +41,7 @@ In this page you will find a list of validators by their category.
 
 **Math**: [Factor][] - [Finite][] - [Infinite][] - [Multiple][] - [Negative][] - [Positive][]
 
-**Miscellaneous**: [Blank][] - [Falsy][] - [Masked][] - [Named][] - [Templated][] - [Undef][]
+**Miscellaneous**: [Blank][] - [Falsy][] - [Named][] - [Templated][] - [Undef][]
 
 **Nesting**: [After][] - [AllOf][] - [AnyOf][] - [Each][] - [Factory][] - [Key][] - [KeySet][] - [NoneOf][] - [Not][] - [NullOr][] - [OneOf][] - [Property][] - [PropertyOptional][] - [ShortCircuit][] - [UndefOr][] - [When][]
 
@@ -151,7 +151,6 @@ In this page you will find a list of validators by their category.
 - [Lowercase][] - `v::stringType()->lowercase()->assert('xkcd');`
 - [Luhn][] - `v::luhn()->assert('2222400041240011');`
 - [MacAddress][] - `v::macAddress()->assert('00:11:22:33:44:55');`
-- [Masked][] - `v::masked('1-@', v::email())->assert('foo@example.com');`
 - [Max][] - `v::max(v::equals(30))->assert([10, 20, 30]);`
 - [Mimetype][] - `v::mimetype('image/png')->assert('/path/to/image.png');`
 - [Min][] - `v::min(v::equals(10))->assert([10, 20, 30]);`
@@ -309,7 +308,6 @@ In this page you will find a list of validators by their category.
 [Lowercase]: validators/Lowercase.md "Validates whether the characters in the input are lowercase."
 [Luhn]: validators/Luhn.md "Validate whether a given input is a Luhn number."
 [MacAddress]: validators/MacAddress.md "Validates whether the input is a valid MAC address."
-[Masked]: validators/Masked.md "Decorates a validator to mask input values in error messages while still validating the original unmasked input."
 [Max]: validators/Max.md "Validates the maximum value of the input against a given validator."
 [Mimetype]: validators/Mimetype.md "Validates if the input is a file and if its MIME type matches the expected one."
 [Min]: validators/Min.md "Validates the minimum value of the input against a given validator."

docs/validators/Format.md

@@ -62,7 +62,6 @@ stored data follows a required display format).
 
 ## See Also
 
-- [Masked](Masked.md)
 - [Templated](Templated.md)
 
 [Respect\StringFormatter]: https://github.com/Respect/StringFormatter

docs/validators/Formatted.md

@@ -47,6 +47,5 @@ The validator first ensures the input is a valid string using `StringVal`. If th
 
 ## See Also
 
-- [Masked](Masked.md)
 - [Named](Named.md)
 - [Templated](Templated.md)

docs/validators/Masked.md

@@ -53,6 +53,5 @@ This validator does not have any templates, as it will use the template of the g
 ## See Also
 
 - [Attributes](Attributes.md)
-- [Masked](Masked.md)
 - [Not](Not.md)
 - [Templated](Templated.md)

docs/validators/Named.md

@@ -54,6 +54,5 @@ This validator does not have any templates, as you must define the templates you
 ## See Also
 
 - [Attributes](Attributes.md)
-- [Masked](Masked.md)
 - [Named](Named.md)
 - [Not](Not.md)