Standardize validator tests using the catchAll() function

Legacy test patterns like using `catchMessage()` and generic "Scenario #X"
naming make it difficult to verify that all message templates behave correctly,
especially in inverted states. This change adopts the `catchAll()` function to
ensure a predictable testing matrix where every template is validated in both
default and inverted scenarios.

By enforcing this comprehensive template coverage and fixing naming typos, we
establish a robust foundation for the remaining Pest suite.

Author: henriquemoody

tests/feature/Validators/AlnumTest.php

@@ -7,42 +7,34 @@
 
 declare(strict_types=1);
 
-test('Scenario #1', catchMessage(
+test('Standard alnum template validation', catchAll(
     fn() => v::alnum()->assert('abc%1'),
-    fn(string $message) => expect($message)->toBe('"abc%1" must contain only letters (a-z) and digits (0-9)'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"abc%1" must contain only letters (a-z) and digits (0-9)')
+        ->and($fullMessage)->toBe('- "abc%1" must contain only letters (a-z) and digits (0-9)')
+        ->and($messages)->toBe(['alnum' => '"abc%1" must contain only letters (a-z) and digits (0-9)']),
 ));
 
-test('Scenario #2', catchMessage(
-    fn() => v::alnum(' ')->assert('abc%2'),
-    fn(string $message) => expect($message)->toBe('"abc%2" must contain only letters (a-z), digits (0-9), and " "'),
-));
-
-test('Scenario #3', catchMessage(
+test('Standard alnum template validation (inverted)', catchAll(
     fn() => v::not(v::alnum())->assert('abcd3'),
-    fn(string $message) => expect($message)->toBe('"abcd3" must not contain letters (a-z) or digits (0-9)'),
-));
-
-test('Scenario #4', catchMessage(
-    fn() => v::not(v::alnum('% '))->assert('abc%4'),
-    fn(string $message) => expect($message)->toBe('"abc%4" must not contain letters (a-z), digits (0-9), or "% "'),
-));
-
-test('Scenario #5', catchFullMessage(
-    fn() => v::alnum()->assert('abc^1'),
-    fn(string $fullMessage) => expect($fullMessage)->toBe('- "abc^1" must contain only letters (a-z) and digits (0-9)'),
-));
-
-test('Scenario #6', catchFullMessage(
-    fn() => v::not(v::alnum())->assert('abcd2'),
-    fn(string $fullMessage) => expect($fullMessage)->toBe('- "abcd2" must not contain letters (a-z) or digits (0-9)'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"abcd3" must not contain letters (a-z) or digits (0-9)')
+        ->and($fullMessage)->toBe('- "abcd3" must not contain letters (a-z) or digits (0-9)')
+        ->and($messages)->toBe(['notAlnum' => '"abcd3" must not contain letters (a-z) or digits (0-9)']),
 ));
 
-test('Scenario #7', catchFullMessage(
-    fn() => v::alnum('* &%')->assert('abc^3'),
-    fn(string $fullMessage) => expect($fullMessage)->toBe('- "abc^3" must contain only letters (a-z), digits (0-9), and "* &%"'),
-));
-
-test('Scenario #8', catchFullMessage(
-    fn() => v::not(v::alnum('^'))->assert('abc^4'),
-    fn(string $fullMessage) => expect($fullMessage)->toBe('- "abc^4" must not contain letters (a-z), digits (0-9), or "^"'),
+test('Extra alnum template validation with additional characters', catchAll(
+    fn() => v::alnum(' ')->assert('abc%2'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"abc%2" must contain only letters (a-z), digits (0-9), and " "')
+        ->and($fullMessage)->toBe('- "abc%2" must contain only letters (a-z), digits (0-9), and " "')
+        ->and($messages)->toBe(['alnum' => '"abc%2" must contain only letters (a-z), digits (0-9), and " "']),
+));
+
+test('Extra alnum template validation with additional characters (inverted)', catchAll(
+    fn() => v::not(v::alnum(' '))->assert('ab cd12'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"ab cd12" must not contain letters (a-z), digits (0-9), or " "')
+        ->and($fullMessage)->toBe('- "ab cd12" must not contain letters (a-z), digits (0-9), or " "')
+        ->and($messages)->toBe(['notAlnum' => '"ab cd12" must not contain letters (a-z), digits (0-9), or " "']),
 ));

tests/feature/Validators/AlphaTest.php

@@ -7,42 +7,34 @@
 
 declare(strict_types=1);
 
-test('Scenario #1', catchMessage(
+test('Standard alpha template validation', catchAll(
     fn() => v::alpha()->assert('aaa%a'),
-    fn(string $message) => expect($message)->toBe('"aaa%a" must contain only letters (a-z)'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"aaa%a" must contain only letters (a-z)')
+        ->and($fullMessage)->toBe('- "aaa%a" must contain only letters (a-z)')
+        ->and($messages)->toBe(['alpha' => '"aaa%a" must contain only letters (a-z)']),
 ));
 
-test('Scenario #2', catchMessage(
-    fn() => v::alpha(' ')->assert('bbb%b'),
-    fn(string $message) => expect($message)->toBe('"bbb%b" must contain only letters (a-z) and " "'),
-));
-
-test('Scenario #3', catchMessage(
+test('Standard alpha template validation (inverted)', catchAll(
     fn() => v::not(v::alpha())->assert('ccccc'),
-    fn(string $message) => expect($message)->toBe('"ccccc" must not contain letters (a-z)'),
-));
-
-test('Scenario #4', catchMessage(
-    fn() => v::not(v::alpha('% '))->assert('ddd%d'),
-    fn(string $message) => expect($message)->toBe('"ddd%d" must not contain letters (a-z) or "% "'),
-));
-
-test('Scenario #5', catchFullMessage(
-    fn() => v::alpha()->assert('eee^e'),
-    fn(string $fullMessage) => expect($fullMessage)->toBe('- "eee^e" must contain only letters (a-z)'),
-));
-
-test('Scenario #6', catchFullMessage(
-    fn() => v::not(v::alpha())->assert('fffff'),
-    fn(string $fullMessage) => expect($fullMessage)->toBe('- "fffff" must not contain letters (a-z)'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"ccccc" must not contain letters (a-z)')
+        ->and($fullMessage)->toBe('- "ccccc" must not contain letters (a-z)')
+        ->and($messages)->toBe(['notAlpha' => '"ccccc" must not contain letters (a-z)']),
 ));
 
-test('Scenario #7', catchFullMessage(
-    fn() => v::alpha('* &%')->assert('ggg^g'),
-    fn(string $fullMessage) => expect($fullMessage)->toBe('- "ggg^g" must contain only letters (a-z) and "* &%"'),
-));
-
-test('Scenario #8', catchFullMessage(
-    fn() => v::not(v::alpha('^'))->assert('hhh^h'),
-    fn(string $fullMessage) => expect($fullMessage)->toBe('- "hhh^h" must not contain letters (a-z) or "^"'),
+test('Extra alpha template validation with additional characters', catchAll(
+    fn() => v::alpha(' ')->assert('bbb%b'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"bbb%b" must contain only letters (a-z) and " "')
+        ->and($fullMessage)->toBe('- "bbb%b" must contain only letters (a-z) and " "')
+        ->and($messages)->toBe(['alpha' => '"bbb%b" must contain only letters (a-z) and " "']),
+));
+
+test('Extra alpha template validation with additional characters (inverted)', catchAll(
+    fn() => v::not(v::alpha(' '))->assert('dddd'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"dddd" must not contain letters (a-z) or " "')
+        ->and($fullMessage)->toBe('- "dddd" must not contain letters (a-z) or " "')
+        ->and($messages)->toBe(['notAlpha' => '"dddd" must not contain letters (a-z) or " "']),
 ));

tests/feature/Validators/AlwaysInvalidTest.php

@@ -7,12 +7,20 @@
 
 declare(strict_types=1);
 
-test('Scenario #1', catchMessage(
+use Respect\Validation\Validators\AlwaysInvalid;
+
+test('Standard alwaysInvalid template validation', catchAll(
     fn() => v::alwaysInvalid()->assert('whatever'),
-    fn(string $message) => expect($message)->toBe('"whatever" must be valid'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"whatever" must be valid')
+        ->and($fullMessage)->toBe('- "whatever" must be valid')
+        ->and($messages)->toBe(['alwaysInvalid' => '"whatever" must be valid']),
 ));
 
-test('Scenario #2', catchFullMessage(
-    fn() => v::alwaysInvalid()->assert(''),
-    fn(string $fullMessage) => expect($fullMessage)->toBe('- "" must be valid'),
+test('Simple alwaysInvalid template validation', catchAll(
+    fn() => v::templated(AlwaysInvalid::TEMPLATE_SIMPLE, v::alwaysInvalid())->assert('whatever'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"whatever" is invalid')
+        ->and($fullMessage)->toBe('- "whatever" is invalid')
+        ->and($messages)->toBe(['alwaysInvalid' => '"whatever" is invalid']),
 ));

tests/feature/Validators/BeetwenTest.php

@@ -0,0 +1,40 @@
+<?php
+
+/*
+ * Copyright (c) Alexandre Gomes Gaigalas <alganet@gmail.com>
+ * SPDX-License-Identifier: MIT
+ */
+
+declare(strict_types=1);
+
+test('Standard between template validation', catchAll(
+    fn() => v::between(1, 2)->assert(0),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('0 must be between 1 and 2')
+        ->and($fullMessage)->toBe('- 0 must be between 1 and 2')
+        ->and($messages)->toBe(['between' => '0 must be between 1 and 2']),
+));
+
+test('Standard between template validation (inverted)', catchAll(
+    fn() => v::not(v::between('yesterday', 'tomorrow'))->assert('today'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"today" must not be between "yesterday" and "tomorrow"')
+        ->and($fullMessage)->toBe('- "today" must not be between "yesterday" and "tomorrow"')
+        ->and($messages)->toBe(['notBetween' => '"today" must not be between "yesterday" and "tomorrow"']),
+));
+
+test('Between template validation with characters', catchAll(
+    fn() => v::between('a', 'c')->assert('d'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"d" must be between "a" and "c"')
+        ->and($fullMessage)->toBe('- "d" must be between "a" and "c"')
+        ->and($messages)->toBe(['between' => '"d" must be between "a" and "c"']),
+));
+
+test('Between template validation with characters (inverted)', catchAll(
+    fn() => v::not(v::between(-INF, INF))->assert(0),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('0 must not be between `-INF` and `INF`')
+        ->and($fullMessage)->toBe('- 0 must not be between `-INF` and `INF`')
+        ->and($messages)->toBe(['notBetween' => '0 must not be between `-INF` and `INF`']),
+));

tests/feature/Validators/BetweenTest.php

@@ -7,42 +7,34 @@
 
 declare(strict_types=1);
 
-test('Scenario #1', catchMessage(
+test('Standard consonant template validation', catchAll(
     fn() => v::consonant()->assert('aeiou'),
-    fn(string $message) => expect($message)->toBe('"aeiou" must only contain consonants'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"aeiou" must only contain consonants')
+        ->and($fullMessage)->toBe('- "aeiou" must only contain consonants')
+        ->and($messages)->toBe(['consonant' => '"aeiou" must only contain consonants']),
 ));
 
-test('Scenario #2', catchMessage(
-    fn() => v::consonant('d')->assert('daeiou'),
-    fn(string $message) => expect($message)->toBe('"daeiou" must only contain consonants and "d"'),
-));
-
-test('Scenario #3', catchMessage(
+test('Standard consonant template validation (inverted)', catchAll(
     fn() => v::not(v::consonant())->assert('bcd'),
-    fn(string $message) => expect($message)->toBe('"bcd" must not contain consonants'),
-));
-
-test('Scenario #4', catchMessage(
-    fn() => v::not(v::consonant('a'))->assert('abcd'),
-    fn(string $message) => expect($message)->toBe('"abcd" must not contain consonants or "a"'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"bcd" must not contain consonants')
+        ->and($fullMessage)->toBe('- "bcd" must not contain consonants')
+        ->and($messages)->toBe(['notConsonant' => '"bcd" must not contain consonants']),
 ));
 
-test('Scenario #5', catchFullMessage(
-    fn() => v::consonant()->assert('aeiou'),
-    fn(string $fullMessage) => expect($fullMessage)->toBe('- "aeiou" must only contain consonants'),
-));
-
-test('Scenario #6', catchFullMessage(
+test('Extra consonant template validation with additional characters', catchAll(
     fn() => v::consonant('d')->assert('daeiou'),
-    fn(string $fullMessage) => expect($fullMessage)->toBe('- "daeiou" must only contain consonants and "d"'),
-));
-
-test('Scenario #7', catchFullMessage(
-    fn() => v::not(v::consonant())->assert('bcd'),
-    fn(string $fullMessage) => expect($fullMessage)->toBe('- "bcd" must not contain consonants'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"daeiou" must only contain consonants and "d"')
+        ->and($fullMessage)->toBe('- "daeiou" must only contain consonants and "d"')
+        ->and($messages)->toBe(['consonant' => '"daeiou" must only contain consonants and "d"']),
 ));
 
-test('Scenario #8', catchFullMessage(
+test('Extra consonant template validation with additional characters (inverted)', catchAll(
     fn() => v::not(v::consonant('a'))->assert('abcd'),
-    fn(string $fullMessage) => expect($fullMessage)->toBe('- "abcd" must not contain consonants or "a"'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"abcd" must not contain consonants or "a"')
+        ->and($fullMessage)->toBe('- "abcd" must not contain consonants or "a"')
+        ->and($messages)->toBe(['notConsonant' => '"abcd" must not contain consonants or "a"']),
 ));

tests/feature/Validators/CntrlTest.php

@@ -0,0 +1,40 @@
+<?php
+
+/*
+ * Copyright (c) Alexandre Gomes Gaigalas <alganet@gmail.com>
+ * SPDX-License-Identifier: MIT
+ */
+
+declare(strict_types=1);
+
+test('Standard control template validation', catchAll(
+    fn() => v::control()->assert('16-50'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"16-50" must only contain control characters')
+        ->and($fullMessage)->toBe('- "16-50" must only contain control characters')
+        ->and($messages)->toBe(['control' => '"16-50" must only contain control characters']),
+));
+
+test('Standard control template validation (inverted)', catchAll(
+    fn() => v::not(v::control())->assert("\n"),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"\\n" must not contain control characters')
+        ->and($fullMessage)->toBe('- "\\n" must not contain control characters')
+        ->and($messages)->toBe(['notControl' => '"\\n" must not contain control characters']),
+));
+
+test('Extra control template validation with additional characters', catchAll(
+    fn() => v::control('16')->assert('16-50'),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"16-50" must only contain control characters and "16"')
+        ->and($fullMessage)->toBe('- "16-50" must only contain control characters and "16"')
+        ->and($messages)->toBe(['control' => '"16-50" must only contain control characters and "16"']),
+));
+
+test('Extra control template validation with additional characters (inverted)', catchAll(
+    fn() => v::not(v::control('16'))->assert("16\n"),
+    fn(string $message, string $fullMessage, array $messages) => expect()
+        ->and($message)->toBe('"16\\n" must not contain control characters or "16"')
+        ->and($fullMessage)->toBe('- "16\\n" must not contain control characters or "16"')
+        ->and($messages)->toBe(['notControl' => '"16\\n" must not contain control characters or "16"']),
+));