Add support for nullable expectations

Author: paulbalandan

src/Expectation.php

@@ -20,7 +20,7 @@
  */
 final readonly class Expectation implements Expectable
 {
-    private Exporter $exporter;
+    public Exporter $exporter;
 
     /**
      * @param TValue $value
@@ -39,6 +39,14 @@ public function not(): NegatedExpectation
         return new NegatedExpectation($this);
     }
 
+    /**
+     * @return NullableExpectation<TValue>
+     */
+    public function nullOr(): NullableExpectation
+    {
+        return new NullableExpectation($this);
+    }
+
     /**
      * @return self<TValue>
      */

src/NegatedExpectation.php

@@ -24,15 +24,18 @@
  */
 final readonly class NegatedExpectation implements Expectable
 {
-    private Exporter $exporter;
+    /**
+     * @var TValue
+     */
+    public mixed $value;
 
     /**
      * @param Expectation<TValue> $expectation
      */
     public function __construct(
         public Expectation $expectation,
     ) {
-        $this->exporter = new Exporter();
+        $this->value = $expectation->value;
     }
 
     /**
@@ -48,7 +51,7 @@ public function isArray(?string $message = null): self
 
         throw new ExpectationFailedException(
             $message ?? 'Value "{value}" is not expected to pass the negated expectation for method "isArray".',
-            ['value' => $this->exporter->exportValue($this->expectation->value)],
+            ['value' => $this->expectation->exporter->exportValue($this->value)],
         );
     }
 
@@ -65,7 +68,7 @@ public function isBool(?string $message = null): self
 
         throw new ExpectationFailedException(
             $message ?? 'Value "{value}" is not expected to pass the negated expectation for method "isBool".',
-            ['value' => $this->exporter->exportValue($this->expectation->value)],
+            ['value' => $this->expectation->exporter->exportValue($this->value)],
         );
     }
 
@@ -82,7 +85,7 @@ public function isFalse(?string $message = null): self
 
         throw new ExpectationFailedException(
             $message ?? 'Value "{value}" is not expected to pass the negated expectation for method "isFalse".',
-            ['value' => $this->exporter->exportValue($this->expectation->value)],
+            ['value' => $this->expectation->exporter->exportValue($this->value)],
         );
     }
 
@@ -99,7 +102,7 @@ public function isFloat(?string $message = null): self
 
         throw new ExpectationFailedException(
             $message ?? 'Value "{value}" is not expected to pass the negated expectation for method "isFloat".',
-            ['value' => $this->exporter->exportValue($this->expectation->value)],
+            ['value' => $this->expectation->exporter->exportValue($this->value)],
         );
     }
 
@@ -116,7 +119,7 @@ public function isInt(?string $message = null): self
 
         throw new ExpectationFailedException(
             $message ?? 'Value "{value}" is not expected to pass the negated expectation for method "isInt".',
-            ['value' => $this->exporter->exportValue($this->expectation->value)],
+            ['value' => $this->expectation->exporter->exportValue($this->value)],
         );
     }
 
@@ -133,7 +136,7 @@ public function isIterable(?string $message = null): self
 
         throw new ExpectationFailedException(
             $message ?? 'Value "{value}" is not expected to pass the negated expectation for method "isIterable".',
-            ['value' => $this->exporter->exportValue($this->expectation->value)],
+            ['value' => $this->expectation->exporter->exportValue($this->value)],
         );
     }
 
@@ -150,7 +153,7 @@ public function isNull(?string $message = null): self
 
         throw new ExpectationFailedException(
             $message ?? 'Value "{value}" is not expected to pass the negated expectation for method "isNull".',
-            ['value' => $this->exporter->exportValue($this->expectation->value)],
+            ['value' => $this->expectation->exporter->exportValue($this->value)],
         );
     }
 
@@ -167,7 +170,7 @@ public function isNumeric(?string $message = null): self
 
         throw new ExpectationFailedException(
             $message ?? 'Value "{value}" is not expected to pass the negated expectation for method "isNumeric".',
-            ['value' => $this->exporter->exportValue($this->expectation->value)],
+            ['value' => $this->expectation->exporter->exportValue($this->value)],
         );
     }
 
@@ -184,7 +187,7 @@ public function isObject(?string $message = null): self
 
         throw new ExpectationFailedException(
             $message ?? 'Value "{value}" is not expected to pass the negated expectation for method "isObject".',
-            ['value' => $this->exporter->exportValue($this->expectation->value)],
+            ['value' => $this->expectation->exporter->exportValue($this->value)],
         );
     }
 
@@ -201,7 +204,7 @@ public function isScalar(?string $message = null): self
 
         throw new ExpectationFailedException(
             $message ?? 'Value "{value}" is not expected to pass the negated expectation for method "isScalar".',
-            ['value' => $this->exporter->exportValue($this->expectation->value)],
+            ['value' => $this->expectation->exporter->exportValue($this->value)],
         );
     }
 
@@ -218,7 +221,7 @@ public function isString(?string $message = null): self
 
         throw new ExpectationFailedException(
             $message ?? 'Value "{value}" is not expected to pass the negated expectation for method "isString".',
-            ['value' => $this->exporter->exportValue($this->expectation->value)],
+            ['value' => $this->expectation->exporter->exportValue($this->value)],
         );
     }
 
@@ -235,7 +238,7 @@ public function isTrue(?string $message = null): self
 
         throw new ExpectationFailedException(
             $message ?? 'Value "{value}" is not expected to pass the negated expectation for method "isTrue".',
-            ['value' => $this->exporter->exportValue($this->expectation->value)],
+            ['value' => $this->expectation->exporter->exportValue($this->value)],
         );
     }
 }