Refactor static return types across interfaces and implementations

- Updated `self` return types to `static` for improved covariant return type support in interfaces and classes.
- Adjusted method signatures across various type interfaces and implementations (`BoolType`, `FloatType`, `IntType`, `DateTimeType`, etc.) accordingly.
- Updated related examples in `README.md` and `USAGE.md` for consistency.

Author: georgedeploy

README.md

@@ -54,8 +54,8 @@ final class Profile
         int $id,
         string $firstName,
         string|float|int|null $height,
-    ): self {
-        return new self(
+    ): static {
+        return new static(
             PositiveInt::fromInt($id),
             NonEmptyStr::fromString($firstName),
             $height !== null ? FloatNonNegative::fromString((string) $height) : null,

docs/USAGE.md

@@ -98,17 +98,17 @@ readonly class EvenPositiveInt extends IntType
     }
 
     /** @throws IntegerTypeException */
-    public static function fromInt(int $value): self
+    public static function fromInt(int $value): static
     {
-        return new self($value);
+        return new static($value);
     }
 
     /** @throws IntegerTypeException */
-    public static function fromString(string $value): self
+    public static function fromString(string $value): static
     {
         parent::assertIntegerString($value);
 
-        return new self((int) $value);
+        return new static((int) $value);
     }
 }
 
@@ -151,8 +151,8 @@ final class Profile
         ?string $middleName,
         ?string $birthDateAtom,   // e.g. "2025-01-02T03:04:05+00:00"
         int|float|string|null $heightM
-    ): self {
-        return new self(
+    ): static {
+        return new static(
             IntegerPositive::fromInt($id),
             StringNonEmpty::fromString($firstName),
             StringNonEmpty::fromString($lastName),

src/Abstract/Bool/BoolType.php

@@ -16,7 +16,7 @@ public function toString(): string
         return $this->value() ? 'true' : 'false';
     }
 
-    public static function fromBool(bool $value): self
+    public static function fromBool(bool $value): static
     {
         return new static($value);
     }

src/Abstract/Bool/BoolTypeInterface.php

@@ -11,9 +11,9 @@ interface BoolTypeInterface
 {
     public function value(): bool;
 
-    public static function fromString(string $value): self;
+    public static function fromString(string $value): static;
 
-    public static function fromBool(bool $value): self;
+    public static function fromBool(bool $value): static;
 
     public function toString(): string;
 }

src/Abstract/DateTime/DateTimeTypeInterface.php

@@ -13,9 +13,9 @@ interface DateTimeTypeInterface
 {
     public function value(): DateTimeImmutable;
 
-    public static function fromDateTime(DateTimeImmutable $value): self;
+    public static function fromDateTime(DateTimeImmutable $value): static;
 
     public function toString(): string;
 
-    public static function fromString(string $value): self;
+    public static function fromString(string $value): static;
 }

src/Abstract/Float/FloatTypeInterface.php

@@ -11,9 +11,9 @@ interface FloatTypeInterface
 {
     public function value(): float;
 
-    public static function fromFloat(float $value): self;
+    public static function fromFloat(float $value): static;
 
     public function toString(): string;
 
-    public static function fromString(string $value): self;
+    public static function fromString(string $value): static;
 }

src/Abstract/Integer/IntTypeInterface.php

@@ -11,9 +11,9 @@ interface IntTypeInterface
 {
     public function value(): int;
 
-    public static function fromInt(int $value): self;
+    public static function fromInt(int $value): static;
 
     public function toString(): string;
 
-    public static function fromString(string $value): self;
+    public static function fromString(string $value): static;
 }

src/Abstract/String/StrTypeInterface.php

@@ -11,7 +11,7 @@ interface StrTypeInterface
 {
     public function value(): string;
 
-    public static function fromString(string $value): self;
+    public static function fromString(string $value): static;
 
     public function toString(): string;
 }

src/Abstract/Undefined/UndefinedTypeInterface.php

@@ -9,7 +9,7 @@
  */
 interface UndefinedTypeInterface
 {
-    public static function create(): self;
+    public static function create(): static;
 
     public function value(): void;
 

src/Bool/BoolStandard.php

@@ -27,7 +27,7 @@ public function __construct(bool $value)
         $this->value = $value;
     }
 
-    public static function tryFromString(string $value): self|UndefinedStandard
+    public static function tryFromString(string $value): static|UndefinedStandard
     {
         try {
             return static::fromString($value);
@@ -36,7 +36,7 @@ public static function tryFromString(string $value): self|UndefinedStandard
         }
     }
 
-    public static function tryFromInt(int $value): self|UndefinedStandard
+    public static function tryFromInt(int $value): static|UndefinedStandard
     {
         try {
             return static::fromInt($value);