Add tryFromMixed implementation to type interfaces and classes, update usage examples, and refine convertMixedToString handling.

Author: georgedeploy

src/Abstract/AbstractTypeInterface.php

@@ -34,8 +34,6 @@ interface AbstractTypeInterface
      */
     public static function fromString(string $value): static;
 
-    //        public static function tryFromMixed(mixed $value): static|Undefined;  //todo enable it
-
     /**
      * Returns a normalized string representation of the underlying value.
      */

src/Abstract/Bool/BoolTypeInterface.php

@@ -26,6 +26,8 @@ public static function tryFromString(string $value): static|Undefined;
 
     public static function tryFromInt(int $value): static|Undefined;
 
+    public static function tryFromMixed(mixed $value): static|Undefined;
+
     /**
      * @throws BoolTypeException
      */

src/Abstract/DateTime/DateTimeTypeInterface.php

@@ -26,5 +26,7 @@ public function value(): DateTimeImmutable;
 
     public static function fromDateTime(DateTimeImmutable $value): static;
 
+    public static function tryFromMixed(mixed $value): static|Undefined;
+
     public static function tryFromString(string $value): static|Undefined;
 }

src/Abstract/Float/FloatTypeInterface.php

@@ -24,5 +24,7 @@ public function value(): float;
 
     public static function fromFloat(float $value): static;
 
+    public static function tryFromMixed(mixed $value): static|Undefined;
+
     public static function tryFromString(string $value): static|Undefined;
 }

src/Abstract/Integer/IntTypeInterface.php

@@ -26,5 +26,7 @@ public static function fromInt(int $value): static;
 
     public static function tryFromInt(int $value): static|Undefined;
 
+    public static function tryFromMixed(mixed $value): static|Undefined;
+
     public static function tryFromString(string $value): static|Undefined;
 }

src/Abstract/String/StrTypeInterface.php

@@ -23,4 +23,6 @@ interface StrTypeInterface
     public function value(): string;
 
     public static function tryFromString(string $value): static|Undefined;
+
+    public static function tryFromMixed(mixed $value): static|Undefined;
 }

src/Abstract/Undefined/UndefinedTypeInterface.php

@@ -5,6 +5,7 @@
 namespace PhpTypedValues\Abstract\Undefined;
 
 use PhpTypedValues\Exception\UndefinedTypeException;
+use PhpTypedValues\Undefined\Alias\Undefined;
 
 /**
  * Contract for the special Undefined typed value.
@@ -23,6 +24,8 @@ interface UndefinedTypeInterface
 {
     public static function create(): static;
 
+    public static function tryFromMixed(mixed $value): Undefined;
+
     /**
      * @throws UndefinedTypeException
      */

src/Bool/BoolStandard.php

@@ -34,6 +34,17 @@ public function __construct(bool $value)
         $this->value = $value;
     }
 
+    public static function tryFromMixed(mixed $value): static|Undefined
+    {
+        try {
+            return static::fromString(
+                static::convertMixedToString($value)
+            );
+        } catch (TypeException) {
+            return Undefined::create();
+        }
+    }
+
     public static function tryFromString(string $value): static|Undefined
     {
         try {

src/Bool/FalseStandard.php

@@ -44,6 +44,17 @@ public function __construct(bool $value)
         $this->value = false;
     }
 
+    public static function tryFromMixed(mixed $value): static|Undefined
+    {
+        try {
+            return static::fromString(
+                static::convertMixedToString($value)
+            );
+        } catch (TypeException) {
+            return Undefined::create();
+        }
+    }
+
     public static function tryFromString(string $value): static|Undefined
     {
         try {

src/Bool/TrueStandard.php

@@ -44,6 +44,17 @@ public function __construct(bool $value)
         $this->value = true;
     }
 
+    public static function tryFromMixed(mixed $value): static|Undefined
+    {
+        try {
+            return static::fromString(
+                static::convertMixedToString($value)
+            );
+        } catch (TypeException) {
+            return Undefined::create();
+        }
+    }
+
     public static function tryFromString(string $value): static|Undefined
     {
         try {