Respect · henriquemoody · Dec 29, 2025 · Dec 28, 2025
diff --git a/docs/06-concrete-api.md b/docs/06-concrete-api.md
@@ -7,22 +7,25 @@ or magic methods. We'll use a traditional dependency injection approach.
 ```php
 use Respect\Validation\Validator as v;
 
-$usernameValidator = v::alnum()->noWhitespace()->length(1, 15);
+$usernameValidator = v::alnum()->notSpaced()->length(1, 15);
 $usernameValidator->isValid('alganet'); // true
 ```
 
 If you `var_dump($usernameValidator)`, you'll see a composite of objects with
-`Respect\Validation\Rules\Alnum`, `Respect\Validation\Rules\NoWhitespace` and
+`Respect\Validation\Rules\Alnum`, `Respect\Validation\Rules\Spaced` wrapped in `Respect\Validation\Rules\Not` and
 `Respect\Validation\Rules\Length`. There is a specific object for each rule, and
 the chain only builds the structure. You can build it by yourself:
 
 ```php
 use Respect\Validation\Rules;
+use Respect\Validation\Validator;
 
-$usernameValidator = new Rules\AllOf(
+$usernameValidator = Validator::create(
     new Rules\Alnum(),
-    new Rules\NoWhitespace(),
-    new Rules\Length(1, 15)
+    new Rules\Not(
+        new Rules\Spaced(),
+    ),
+    new Rules\Length(1, 15),
 );
 $usernameValidator->isValid('alganet'); // true
 ```
@@ -33,12 +36,18 @@ container or test it in the way you want. Nesting is still possible:
 ```php
 use Respect\Validation\Rules;
 
-$usernameValidator = new Rules\AllOf(
-    new Rules\Alnum(),
-    new Rules\NoWhitespace(),
-    new Rules\Length(1, 15)
+$usernameValidator = Validator::create(
+    new Rules\Key(
+        'name',
+        new Rules\AllOf(
+            new Rules\Alnum(),
+            new Rules\Not(
+                new Rules\Spaced(),
+            ),
+            new Rules\Length(1, 15),
+        )
+    )
 );
-$userValidator = new Rules\Key('name', $usernameValidator);
 $userValidator->isValid(['name' => 'alganet']); // true
 ```
 
@@ -63,7 +72,7 @@ something complex and returns for you.
 
 > I really don't like static calls, can I avoid it?
 
-Yes. Just use `$validator = new Validator();` each time you want a new validator,
+Yes. Just use `$validator = Validator::create();` each time you want a new validator,
 and continue from there.
 
 > Do you have a static method for each rule?

diff --git a/docs/09-list-of-rules-by-category.md b/docs/09-list-of-rules-by-category.md
@@ -236,7 +236,6 @@
 - [Json](rules/Json.md)
 - [Lowercase](rules/Lowercase.md)
 - [NotEmoji](rules/NotEmoji.md)
-- [NoWhitespace](rules/NoWhitespace.md)
 - [Phone](rules/Phone.md)
 - [PhpLabel](rules/PhpLabel.md)
 - [PostalCode](rules/PostalCode.md)
@@ -246,6 +245,7 @@
 - [Slug](rules/Slug.md)
 - [Sorted](rules/Sorted.md)
 - [Space](rules/Space.md)
+- [Spaced](rules/Spaced.md)
 - [StartsWith](rules/StartsWith.md)
 - [StringType](rules/StringType.md)
 - [StringVal](rules/StringVal.md)
@@ -406,7 +406,6 @@
 - [Not](rules/Not.md)
 - [NotEmoji](rules/NotEmoji.md)
 - [NotEmpty](rules/NotEmpty.md)
-- [NoWhitespace](rules/NoWhitespace.md)
 - [NullOr](rules/NullOr.md)
 - [NullType](rules/NullType.md)
 - [Number](rules/Number.md)
@@ -439,6 +438,7 @@
 - [Slug](rules/Slug.md)
 - [Sorted](rules/Sorted.md)
 - [Space](rules/Space.md)
+- [Spaced](rules/Spaced.md)
 - [StartsWith](rules/StartsWith.md)
 - [StringType](rules/StringType.md)
 - [StringVal](rules/StringVal.md)

diff --git a/docs/rules/Alnum.md b/docs/rules/Alnum.md
@@ -72,8 +72,8 @@ See also:
 - [Digit](Digit.md)
 - [Lowercase](Lowercase.md)
 - [NotEmoji](NotEmoji.md)
-- [NoWhitespace](NoWhitespace.md)
 - [Regex](Regex.md)
+- [Spaced](Spaced.md)
 - [StringType](StringType.md)
 - [StringVal](StringVal.md)
 - [Uppercase](Uppercase.md)

diff --git a/docs/rules/Alpha.md b/docs/rules/Alpha.md
@@ -66,7 +66,7 @@ See also:
 - [Digit](Digit.md)
 - [Lowercase](Lowercase.md)
 - [NotEmoji](NotEmoji.md)
-- [NoWhitespace](NoWhitespace.md)
 - [Regex](Regex.md)
+- [Spaced](Spaced.md)
 - [Uppercase](Uppercase.md)
 - [Vowel](Vowel.md)
diff --git a/docs/rules/Blank.md b/docs/rules/Blank.md
@@ -56,8 +56,8 @@ It's similar to [NotEmpty](NotEmpty.md), but way stricter.
 See also:
 
 - [NotEmpty](NotEmpty.md)
-- [NoWhitespace](NoWhitespace.md)
 - [NullType](NullType.md)
 - [Number](Number.md)
+- [Spaced](Spaced.md)
 - [Undef](Undef.md)
 - [UndefOr](UndefOr.md)
diff --git a/docs/rules/CreditCard.md b/docs/rules/CreditCard.md
@@ -30,7 +30,7 @@ The current supported brands are:
 - RuPay (`'RuPay'` or `CreditCard::RUPAY`)
 
 It ignores any non-numeric characters, use [Digit](Digit.md),
-[NoWhitespace](NoWhitespace.md), or [Regex](Regex.md) when appropriate.
+[Spaced](Spaced.md), or [Regex](Regex.md) when appropriate.
 
 ```php
 v::digit()->creditCard()->isValid('5376747397208720'); // true
@@ -79,5 +79,5 @@ See also:
 - [Digit](Digit.md)
 - [Iban](Iban.md)
 - [Luhn](Luhn.md)
-- [NoWhitespace](NoWhitespace.md)
 - [Regex](Regex.md)
+- [Spaced](Spaced.md)
diff --git a/docs/rules/NoWhitespace.md b/docs/rules/NoWhitespace.md
diff --git a/docs/rules/NotEmpty.md b/docs/rules/NotEmpty.md
@@ -3,7 +3,7 @@
 - `NotEmpty()`
 
 Validates wether the given input is not empty. This function also takes whitespace
-into account, use `noWhitespace()` if no spaces or linebreaks and other
+into account, use `notSpaced()` if no spaces or linebreaks and other
 whitespace anywhere in the input is desired.
 
 ```php
@@ -68,8 +68,8 @@ See also:
 - [Each](Each.md)
 - [Max](Max.md)
 - [Min](Min.md)
-- [NoWhitespace](NoWhitespace.md)
 - [NullType](NullType.md)
 - [Number](Number.md)
+- [Spaced](Spaced.md)
 - [Undef](Undef.md)
 - [UndefOr](UndefOr.md)
diff --git a/docs/rules/Spaced.md b/docs/rules/Spaced.md
@@ -0,0 +1,55 @@
+# Spaced
+
+- `Spaced()`
+
+Validates if a string contains at least one whitespace (spaces, tabs, or line breaks);
+
+```php
+v::spaced()->isValid('foo bar'); // true
+v::spaced()->isValid("foo\nbar"); // true
+```
+
+This is most useful when inverting the validator as `notSpaced()`, and chaining with other validators such as [Alnum](Alnum.md) or [Alpha](Alpha.md) to ensure that a string contains no whitespace characters:
+
+```php
+v::notSpaced()->alnum()->isValid('username'); // true
+v::notSpaced()->alnum()->isValid('user name'); // false
+```
+
+## Templates
+
+### `Spaced::TEMPLATE_STANDARD`
+
+| Mode       | Template                                         |
+| ---------- | ------------------------------------------------ |
+| `default`  | {{subject}} must contain at least one whitespace |
+| `inverted` | {{subject}} must not contain whitespaces         |
+
+## Template placeholders
+
+| Placeholder | Description                                                      |
+| ----------- | ---------------------------------------------------------------- |
+| `subject`   | The validated input or the custom validator name (if specified). |
+
+## Categorization
+
+- Strings
+
+## Changelog
+
+| Version | Description                                  |
+| ------: | -------------------------------------------- |
+|   3.0.0 | Renamed to `Spaced` and changed the behavior |
+|   0.3.9 | Created as `NoWhitespace`                    |
+
+---
+
+See also:
+
+- [Alnum](Alnum.md)
+- [Alpha](Alpha.md)
+- [Blank](Blank.md)
+- [CreditCard](CreditCard.md)
+- [NotEmpty](NotEmpty.md)
+- [Undef](Undef.md)
+- [UndefOr](UndefOr.md)
diff --git a/docs/rules/Undef.md b/docs/rules/Undef.md
@@ -59,7 +59,7 @@ See also:
 
 - [Blank](Blank.md)
 - [NotEmpty](NotEmpty.md)
-- [NoWhitespace](NoWhitespace.md)
 - [NullType](NullType.md)
 - [Number](Number.md)
+- [Spaced](Spaced.md)
 - [UndefOr](UndefOr.md)
diff --git a/docs/rules/UndefOr.md b/docs/rules/UndefOr.md
@@ -67,7 +67,7 @@ See also:
 
 - [Blank](Blank.md)
 - [NotEmpty](NotEmpty.md)
-- [NoWhitespace](NoWhitespace.md)
 - [NullOr](NullOr.md)
 - [NullType](NullType.md)
+- [Spaced](Spaced.md)
 - [Undef](Undef.md)
diff --git a/library/Mixins/Builder.php b/library/Mixins/Builder.php
@@ -238,8 +238,6 @@ public static function nip(): Chain;
 
     public static function no(bool $useLocale = false): Chain;
 
-    public static function noWhitespace(): Chain;
-
     public static function noneOf(Rule $rule1, Rule $rule2, Rule ...$rules): Chain;
 
     public static function not(Rule $rule): Chain;
@@ -313,6 +311,8 @@ public static function sorted(string $direction): Chain;
 
     public static function space(string ...$additionalChars): Chain;
 
+    public static function spaced(): Chain;
+
     public static function startsWith(mixed $startValue, bool $identical = false): Chain;
 
     public static function stringType(): Chain;

diff --git a/library/Mixins/Chain.php b/library/Mixins/Chain.php
@@ -241,8 +241,6 @@ public function nip(): Chain;
 
     public function no(bool $useLocale = false): Chain;
 
-    public function noWhitespace(): Chain;
-
     public function noneOf(Rule $rule1, Rule $rule2, Rule ...$rules): Chain;
 
     public function not(Rule $rule): Chain;
@@ -316,6 +314,8 @@ public function sorted(string $direction): Chain;
 
     public function space(string ...$additionalChars): Chain;
 
+    public function spaced(): Chain;
+
     public function startsWith(mixed $startValue, bool $identical = false): Chain;
 
     public function stringType(): Chain;

diff --git a/library/Mixins/KeyBuilder.php b/library/Mixins/KeyBuilder.php
@@ -217,8 +217,6 @@ public static function keyNip(int|string $key): Chain;
 
     public static function keyNo(int|string $key, bool $useLocale = false): Chain;
 
-    public static function keyNoWhitespace(int|string $key): Chain;
-
     public static function keyNoneOf(int|string $key, Rule $rule1, Rule $rule2, Rule ...$rules): Chain;
 
     public static function keyNot(int|string $key, Rule $rule): Chain;
@@ -284,6 +282,8 @@ public static function keySorted(int|string $key, string $direction): Chain;
 
     public static function keySpace(int|string $key, string ...$additionalChars): Chain;
 
+    public static function keySpaced(int|string $key): Chain;
+
     public static function keyStartsWith(int|string $key, mixed $startValue, bool $identical = false): Chain;
 
     public static function keyStringType(int|string $key): Chain;

diff --git a/library/Mixins/KeyChain.php b/library/Mixins/KeyChain.php
@@ -217,8 +217,6 @@ public function keyNip(int|string $key): Chain;
 
     public function keyNo(int|string $key, bool $useLocale = false): Chain;
 
-    public function keyNoWhitespace(int|string $key): Chain;
-
     public function keyNoneOf(int|string $key, Rule $rule1, Rule $rule2, Rule ...$rules): Chain;
 
     public function keyNot(int|string $key, Rule $rule): Chain;
@@ -284,6 +282,8 @@ public function keySorted(int|string $key, string $direction): Chain;
 
     public function keySpace(int|string $key, string ...$additionalChars): Chain;
 
+    public function keySpaced(int|string $key): Chain;
+
     public function keyStartsWith(int|string $key, mixed $startValue, bool $identical = false): Chain;
 
     public function keyStringType(int|string $key): Chain;

diff --git a/library/Mixins/NotBuilder.php b/library/Mixins/NotBuilder.php
@@ -225,8 +225,6 @@ public static function notNip(): Chain;
 
     public static function notNo(bool $useLocale = false): Chain;
 
-    public static function notNoWhitespace(): Chain;
-
     public static function notNoneOf(Rule $rule1, Rule $rule2, Rule ...$rules): Chain;
 
     public static function notNullType(): Chain;
@@ -292,6 +290,8 @@ public static function notSorted(string $direction): Chain;
 
     public static function notSpace(string ...$additionalChars): Chain;
 
+    public static function notSpaced(): Chain;
+
     public static function notStartsWith(mixed $startValue, bool $identical = false): Chain;
 
     public static function notStringType(): Chain;

diff --git a/library/Mixins/NotChain.php b/library/Mixins/NotChain.php
@@ -225,8 +225,6 @@ public function notNip(): Chain;
 
     public function notNo(bool $useLocale = false): Chain;
 
-    public function notNoWhitespace(): Chain;
-
     public function notNoneOf(Rule $rule1, Rule $rule2, Rule ...$rules): Chain;
 
     public function notNullType(): Chain;
@@ -292,6 +290,8 @@ public function notSorted(string $direction): Chain;
 
     public function notSpace(string ...$additionalChars): Chain;
 
+    public function notSpaced(): Chain;
+
     public function notStartsWith(mixed $startValue, bool $identical = false): Chain;
 
     public function notStringType(): Chain;