CS & Update README.md

Author: k2gl

README.md

@@ -77,6 +77,64 @@ fact([1, 2, 3])->none(fn($v) => $v > 10); // Passes
 fact([1, 2, 3])->none(fn($v) => $v > 2); // Fails
 ```
 
+### Boolean assertions
+```php
+fact(true)->true(); // Passes
+fact(1)->true(); // Fails due to strict comparison
+
+fact(false)->notTrue(); // Passes
+fact(true)->notTrue(); // Fails
+
+fact(false)->false(); // Passes
+fact(0)->false(); // Fails due to strict comparison
+
+fact(true)->notFalse(); // Passes
+fact(false)->notFalse(); // Fails
+```
+
+### Comparison and equality assertions
+```php
+fact(42)->is(42); // Passes
+fact(42)->is('42'); // Fails due to type difference
+
+fact(42)->equals(42); // Passes
+fact(42)->equals('42'); // Passes due to loose comparison
+
+fact(42)->not(43); // Passes
+fact(42)->not(42); // Fails
+```
+
+### Null assertions
+```php
+fact(null)->null(); // Passes
+fact('')->null(); // Fails
+
+fact(42)->notNull(); // Passes
+fact(null)->notNull(); // Fails
+```
+
+### Numeric assertions
+```php
+fact(5)->isLowerThan(10); // Passes
+fact(10)->isLowerThan(5); // Fails
+
+fact(10)->isGreaterThan(5); // Passes
+fact(5)->isGreaterThan(10); // Fails
+
+fact(5)->isPositive(); // Passes
+fact(-3)->isPositive(); // Fails
+
+fact(-3)->isNegative(); // Passes
+fact(5)->isNegative(); // Fails
+
+fact(0)->isZero(); // Passes
+fact(0.0)->isZero(); // Passes
+fact(1)->isZero(); // Fails
+
+fact(5)->isBetween(1, 10); // Passes
+fact(15)->isBetween(1, 10); // Fails
+```
+
 ### String assertions
 ```php
 fact('abc123')->matchesRegularExpression('/^[a-z]+\d+$/'); // Passes

src/Traits/ArrayAssertions.php

@@ -259,18 +259,23 @@ public function isNotEmptyArray(string $message = ''): self
     public function every(callable $callback, string $message = ''): self
     {
         $array = $this->variable;
+
         if (!is_array($array)) {
             Assert::assertTrue(false, $message ?: 'Variable is not an array.');
         }
+
         if (empty($array)) {
             Assert::assertTrue(false, $message ?: 'Array is empty, cannot evaluate condition on elements.');
         }
+
         foreach ($array as $key => $value) {
             if (!$callback($value, $key)) {
                 Assert::assertTrue(false, $message ?: 'Not all elements satisfy the condition.');
             }
         }
+
         Assert::assertTrue(true, $message);
+
         return $this;
     }
 
@@ -292,18 +297,23 @@ public function every(callable $callback, string $message = ''): self
     public function some(callable $callback, string $message = ''): self
     {
         $array = $this->variable;
+
         if (!is_array($array)) {
             Assert::assertTrue(false, $message ?: 'Variable is not an array.');
         }
+
         if (empty($array)) {
             Assert::assertTrue(false, $message ?: 'Array is empty, cannot evaluate condition on elements.');
         }
+
         foreach ($array as $key => $value) {
             if ($callback($value, $key)) {
                 Assert::assertTrue(true, $message);
+
                 return $this;
             }
         }
+
         Assert::assertTrue(false, $message ?: 'No elements satisfy the condition.');
     }
 
@@ -325,18 +335,23 @@ public function some(callable $callback, string $message = ''): self
     public function none(callable $callback, string $message = ''): self
     {
         $array = $this->variable;
+
         if (!is_array($array)) {
             Assert::assertTrue(false, $message ?: 'Variable is not an array.');
         }
+
         if (empty($array)) {
             Assert::assertTrue(false, $message ?: 'Array is empty, cannot evaluate condition on elements.');
         }
+
         foreach ($array as $key => $value) {
             if ($callback($value, $key)) {
                 Assert::assertTrue(false, $message ?: 'At least one element satisfies the condition.');
             }
         }
+
         Assert::assertTrue(true, $message);
+
         return $this;
     }
 }