Add __toString method to BoolType and standardize use of Undefined alias

- Implemented `__toString` in `BoolType`, enabling seamless string conversion.
- Introduced `tryFromString` and `tryFromInt` methods accepting `Undefined` alias instead of `UndefinedStandard`.
- Updated relevant tests to reflect changes in `Undefined` alias usage.

Author: georgedeploy

src/Abstract/Bool/BoolType.php

@@ -20,4 +20,9 @@ public static function fromBool(bool $value): static
     {
         return new static($value);
     }
+
+    public function __toString(): string
+    {
+        return $this->toString();
+    }
 }

src/Abstract/Bool/BoolTypeInterface.php

@@ -4,16 +4,24 @@
 
 namespace PhpTypedValues\Abstract\Bool;
 
+use PhpTypedValues\Undefined\Alias\Undefined;
+
 /**
  * @psalm-immutable
  */
 interface BoolTypeInterface
 {
     public function value(): bool;
 
+    public static function tryFromString(string $value): static|Undefined;
+
+    public static function tryFromInt(int $value): static|Undefined;
+
     public static function fromString(string $value): static;
 
     public static function fromBool(bool $value): static;
 
     public function toString(): string;
+
+    public function __toString(): string;
 }

src/Bool/BoolStandard.php

@@ -7,7 +7,7 @@
 use PhpTypedValues\Abstract\Bool\BoolType;
 use PhpTypedValues\Exception\BoolTypeException;
 use PhpTypedValues\Exception\TypeException;
-use PhpTypedValues\Undefined\UndefinedStandard;
+use PhpTypedValues\Undefined\Alias\Undefined;
 
 use function sprintf;
 
@@ -27,21 +27,21 @@ public function __construct(bool $value)
         $this->value = $value;
     }
 
-    public static function tryFromString(string $value): static|UndefinedStandard
+    public static function tryFromString(string $value): static|Undefined
     {
         try {
             return static::fromString($value);
         } catch (TypeException) {
-            return UndefinedStandard::create();
+            return Undefined::create();
         }
     }
 
-    public static function tryFromInt(int $value): static|UndefinedStandard
+    public static function tryFromInt(int $value): static|Undefined
     {
         try {
             return static::fromInt($value);
         } catch (TypeException) {
-            return UndefinedStandard::create();
+            return Undefined::create();
         }
     }
 

tests/Unit/Bool/BoolStandardTest.php

@@ -64,7 +64,7 @@
         ->and($ok->value())->toBeTrue();
 
     // Undefined type instance indicates failure without throwing
-    expect($fail::class)->toBe(PhpTypedValues\Undefined\UndefinedStandard::class);
+    expect($fail::class)->toBe(PhpTypedValues\Undefined\Alias\Undefined::class);
 });
 
 it('tryFromInt returns Undefined on invalid input and BoolStandard on valid', function (): void {
@@ -76,7 +76,7 @@
         ->and($one->value())->toBeTrue()
         ->and($zero)->toBeInstanceOf(BoolStandard::class)
         ->and($zero->value())->toBeFalse()
-        ->and($bad::class)->toBe(PhpTypedValues\Undefined\UndefinedStandard::class);
+        ->and($bad::class)->toBe(PhpTypedValues\Undefined\Alias\Undefined::class);
 });
 
 it('parses string values with surrounding whitespace', function (): void {
@@ -85,3 +85,11 @@
         ->and(BoolStandard::fromString('  on ')->value())->toBeTrue()
         ->and(BoolStandard::fromString(' off  ')->value())->toBeFalse();
 });
+
+it('casts to string via __toString magic method', function (): void {
+    $t = new BoolStandard(true);
+    $f = BoolStandard::fromBool(false);
+
+    expect((string) $t)->toBe('true')
+        ->and((string) $f)->toBe('false');
+});