Null undefined

README.md

@@ -15,34 +15,26 @@ Code quality:
 ![psalm](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/georgii-web/75977b7515de20d7382f6855d44a1d97/raw/psalm.json)
 ![cs-fixer](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/georgii-web/75977b7515de20d7382f6855d44a1d97/raw/cs_fixer.json)
 
-PHP supported version:
-
-![Version 3.x](https://img.shields.io/badge/Version-3.x-777BB4)
-![PHP >=8.4](https://img.shields.io/badge/PHP->=8.4-8892BF?logo=php)
-
-![Version 2.x](https://img.shields.io/badge/Version-2.x-777BB4)
-![PHP >=8.2 <8.4](https://img.shields.io/badge/PHP->=8.2--<8.4-8892BF?logo=php)
-
-![Version 1.x](https://img.shields.io/badge/Version-1.x-777BB4)
-![PHP >=7.4 <8.2](https://img.shields.io/badge/PHP->=7.4--<8.2-8892BF?logo=php)
-
 ---
 
 ### Install
 
-- Use V3 for PHP >=8.4:
+![Version 3.x](https://img.shields.io/badge/Version-3.x-777BB4)
+![PHP >=8.4](https://img.shields.io/badge/PHP->=8.4-8892BF?logo=php)
 
 ```bash
 composer require georgii-web/php-typed-values:^3
 ```
 
-- Use V2 for PHP >=8.2 & <8.4:
+![Version 2.x](https://img.shields.io/badge/Version-2.x-777BB4)
+![PHP >=8.2 <8.4](https://img.shields.io/badge/PHP->=8.2--<8.4-8892BF?logo=php)
 
 ```bash
 composer require georgii-web/php-typed-values:^2
 ```
 
-- Use V1 for PHP >=7.4 & <8.2:
+![Version 1.x](https://img.shields.io/badge/Version-1.x-777BB4)
+![PHP >=7.4 <8.2](https://img.shields.io/badge/PHP->=7.4--<8.2-8892BF?logo=php)
 
 ```bash
 composer require georgii-web/php-typed-values:^1
@@ -100,9 +92,11 @@ final readonly class Profile
 
 #### Undefined
 
-Prefer using the `Undefined` type over `null` to maintain consistency and improve type safety within the codebase.
+Prefer using the `Undefined` type over `null` to maintain consistency and improve type safety within the codebase [null-is-evil](https://sidburn.github.io/blog/2016/03/20/null-is-evil).
+
+#### Other usage examples 
 
-Other usage examples [docs/USAGE.md](docs/USAGE.md)
+[docs/USAGE.md](docs/USAGE.md)
 
 ### Key features
 

composer.json

@@ -68,15 +68,15 @@
       "echo \"Coverage\" && ./vendor/bin/pest --coverage --min=100 --parallel"
     ],
     "mutate": [
+      "echo \"Undefined\" && ./vendor/bin/pest tests/Unit/Undefined --mutate --covered-only --parallel --min=100",
       "echo \"String\" && ./vendor/bin/pest tests/Unit/String --mutate --covered-only --parallel --min=100",
       "echo \"Integer\" && ./vendor/bin/pest tests/Unit/Integer --mutate --covered-only --parallel --min=100",
       "echo \"DateTime\" && ./vendor/bin/pest tests/Unit/DateTime --mutate --covered-only --parallel --min=100",
       "echo \"Decimal\" && ./vendor/bin/pest tests/Unit/Decimal --mutate --covered-only --parallel --min=100",
       "echo \"Float\" && ./vendor/bin/pest tests/Unit/Float --mutate --covered-only --parallel --min=100",
       "echo \"Base\" && ./vendor/bin/pest tests/Unit/Base --mutate --covered-only --parallel --min=100",
       "echo \"Array\" && ./vendor/bin/pest tests/Unit/ArrayType --mutate --covered-only --parallel --min=100",
-      "echo \"Bool\" && ./vendor/bin/pest tests/Unit/Bool --mutate --covered-only --parallel --min=100",
-      "echo \"Undefined\" && ./vendor/bin/pest tests/Unit/Undefined --mutate --covered-only --parallel --min=100"
+      "echo \"Bool\" && ./vendor/bin/pest tests/Unit/Bool --mutate --covered-only --parallel --min=100"
     ]
   },
   "config": {

src/Base/Primitive/Bool/BoolTypeAbstract.php

@@ -34,6 +34,8 @@ abstract public static function fromFloat(float $value): static;
 
     abstract public static function fromInt(int $value): static;
 
+    abstract public static function fromNull(null $value): never;
+
     abstract public static function fromString(string $value): static;
 
     abstract public function isTypeOf(string ...$classNames): bool;
@@ -46,6 +48,8 @@ abstract public function toFloat(): float;
 
     abstract public function toInt(): int;
 
+    abstract public static function toNull(): never;
+
     abstract public function toString(): string;
 
     /**

src/Base/Primitive/Bool/BoolTypeInterface.php

@@ -30,6 +30,8 @@ public static function fromFloat(float $value): static;
 
     public static function fromInt(int $value): static;
 
+    public static function fromNull(null $value): never;
+
     public static function fromString(string $value): static;
 
     public function isTypeOf(string ...$classNames): bool;
@@ -42,6 +44,8 @@ public function toFloat(): float;
 
     public function toInt(): int;
 
+    public static function toNull(): never;
+
     public function toString(): string;
 
     /**

src/Base/Primitive/DateTime/DateTimeTypeAbstract.php

@@ -37,6 +37,8 @@
 {
     abstract public static function fromDateTime(DateTimeImmutable $value): static;
 
+    abstract public static function fromNull(null $value): never;
+
     /**
      * @param non-empty-string $timezone
      */
@@ -49,6 +51,8 @@ abstract public static function getFormat(): string;
 
     abstract public function isTypeOf(string ...$classNames): bool;
 
+    abstract public static function toNull(): never;
+
     abstract public function toString(): string;
 
     /**

src/Base/Primitive/Decimal/DecimalTypeAbstract.php

@@ -37,6 +37,8 @@ abstract public static function fromFloat(float $value): static;
 
     abstract public static function fromInt(int $value): static;
 
+    abstract public static function fromNull(null $value): never;
+
     abstract public static function fromString(string $value): static;
 
     abstract public function isTypeOf(string ...$classNames): bool;
@@ -76,6 +78,8 @@ abstract public function toFloat(): float;
 
     abstract public function toInt(): int;
 
+    abstract public function toNull(): never;
+
     abstract public function toString(): string;
 
     /**

src/Base/Primitive/Decimal/DecimalTypeInterface.php

@@ -29,6 +29,8 @@ public static function fromFloat(float $value): static;
 
     public static function fromInt(int $value): static;
 
+    public static function fromNull(null $value): never;
+
     public static function fromString(string $value): static;
 
     public function isTypeOf(string ...$classNames): bool;
@@ -41,6 +43,8 @@ public function toFloat(): float;
 
     public function toInt(): int;
 
+    public function toNull(): never;
+
     public function toString(): string;
 
     /**

src/Base/Primitive/Float/FloatTypeAbstract.php

@@ -34,6 +34,8 @@ abstract public static function fromFloat(float $value): static;
 
     abstract public static function fromInt(int $value): static;
 
+    abstract public static function fromNull(null $value): never;
+
     abstract public static function fromString(string $value): static;
 
     abstract public function toBool(): bool;
@@ -44,6 +46,8 @@ abstract public function toFloat(): float;
 
     abstract public function toInt(): int;
 
+    abstract public static function toNull(): never;
+
     abstract public function toString(): string;
 
     /**

src/Base/Primitive/Float/FloatTypeInterface.php

@@ -29,6 +29,8 @@ public static function fromFloat(float $value): static;
 
     public static function fromInt(int $value): static;
 
+    public static function fromNull(null $value): never;
+
     public static function fromString(string $value): static;
 
     public function isTypeOf(string ...$classNames): bool;
@@ -41,6 +43,8 @@ public function toFloat(): float;
 
     public function toInt(): int;
 
+    public static function toNull(): never;
+
     public function toString(): string;
 
     /**

src/Base/Primitive/Integer/IntegerTypeAbstract.php

@@ -34,6 +34,8 @@ abstract public static function fromFloat(float $value): static;
 
     abstract public static function fromInt(int $value): static;
 
+    abstract public static function fromNull(null $value): never;
+
     abstract public static function fromString(string $value): static;
 
     abstract public function isTypeOf(string ...$classNames): bool;
@@ -46,6 +48,8 @@ abstract public function toFloat(): float;
 
     abstract public function toInt(): int;
 
+    abstract public static function toNull(): never;
+
     abstract public function toString(): string;
 
     /**

src/Base/Primitive/Integer/IntegerTypeInterface.php

@@ -29,6 +29,8 @@ public static function fromFloat(float $value): static;
 
     public static function fromInt(int $value): static;
 
+    public static function fromNull(null $value): never;
+
     public static function fromString(string $value): static;
 
     public function isTypeOf(string ...$classNames): bool;
@@ -41,6 +43,8 @@ public function toFloat(): float;
 
     public function toInt(): int;
 
+    public static function toNull(): never;
+
     public function toString(): string;
 
     /**

src/Base/Primitive/PrimitiveTypeInterface.php

@@ -24,7 +24,6 @@
  */
 interface PrimitiveTypeInterface extends TypeInterface, JsonSerializable
 {
-    // todo add all methods converters
     /**
      * Returns true if the Object value is empty.
      */

src/Base/Primitive/Undefined/UndefinedTypeAbstract.php

@@ -29,22 +29,32 @@
 {
     abstract public static function create(): static;
 
-    abstract public static function fromArray(array $value): static;
-
+    /**
+     * @throws UndefinedTypeException
+     */
     abstract public static function fromBool(bool $value): static;
 
+    /**
+     * @throws UndefinedTypeException
+     */
     abstract public static function fromDecimal(string $value): static;
 
+    /**
+     * @throws UndefinedTypeException
+     */
     abstract public static function fromFloat(float $value): static;
 
+    /**
+     * @throws UndefinedTypeException
+     */
     abstract public static function fromInt(int $value): static;
 
-    abstract public static function fromString(string $value): static;
+    abstract public static function fromNull(null $value): static;
 
     /**
      * @throws UndefinedTypeException
      */
-    abstract public function toArray(): never;
+    abstract public static function fromString(string $value): static;
 
     /**
      * @throws UndefinedTypeException
@@ -54,7 +64,7 @@ abstract public function toBool(): never;
     /**
      * @throws UndefinedTypeException
      */
-    abstract public function toDecimal(): string;
+    abstract public function toDecimal(): never;
 
     /**
      * @throws UndefinedTypeException
@@ -66,51 +76,51 @@ abstract public function toFloat(): never;
      */
     abstract public function toInt(): never;
 
+    abstract public function toNull(): null;
+
     /**
      * @throws UndefinedTypeException
      */
     abstract public function toString(): string;
 
-    abstract public static function tryFromArray(
-        array $value,
-        PrimitiveTypeAbstract $default = new Undefined(),
-    ): static;
-
     abstract public static function tryFromBool(
         bool $value,
         PrimitiveTypeAbstract $default = new Undefined(),
-    ): static;
+    ): PrimitiveTypeAbstract|static;
 
     abstract public static function tryFromDecimal(
         string $value,
         PrimitiveTypeAbstract $default = new Undefined(),
-    ): static;
+    ): PrimitiveTypeAbstract|static;
 
     abstract public static function tryFromFloat(
         float $value,
         PrimitiveTypeAbstract $default = new Undefined(),
-    ): static;
+    ): PrimitiveTypeAbstract|static;
 
     abstract public static function tryFromInt(
         int $value,
         PrimitiveTypeAbstract $default = new Undefined(),
-    ): static;
+    ): PrimitiveTypeAbstract|static;
 
     abstract public static function tryFromMixed(
         mixed $value,
         PrimitiveTypeAbstract $default = new Undefined(),
-    ): static;
+    ): PrimitiveTypeAbstract|static;
 
     abstract public static function tryFromString(
         string $value,
         PrimitiveTypeAbstract $default = new Undefined(),
-    ): static;
+    ): PrimitiveTypeAbstract|static;
 
     /**
      * @throws UndefinedTypeException
      */
     abstract public function value(): string;
 
+    /**
+     * @throws UndefinedTypeException
+     */
     public function __toString(): string
     {
         return $this->toString();