Add Text alias for StringText with usage example

- Introduced `StringText` class for MariaDB TEXT strings, enforcing a maximum length of 65,535 characters.
- Added `fromString` and `tryFromString` methods, returning `Undefined` for inputs exceeding the length limit.
- Created alias `Text` as a readonly extension of `StringText`.
- Updated `Usage` examples to demonstrate `StringText` and `Text` behavior.
- Included detailed unit tests to validate boundaries, exception handling, alias behavior, and `Undefined` returns for invalid cases.

Author: georgedeploy

src/Abstract/Bool/BoolType.php

@@ -4,10 +4,12 @@
 
 namespace PhpTypedValues\Abstract\Bool;
 
+use PhpTypedValues\Abstract\TypeInterface;
+
 /**
  * @psalm-immutable
  */
-abstract readonly class BoolType implements BoolTypeInterface
+abstract readonly class BoolType implements TypeInterface, BoolTypeInterface
 {
     abstract protected function __construct(bool $value);
 

src/Abstract/DateTime/DateTimeType.php

@@ -8,6 +8,7 @@
 
 use DateTimeImmutable;
 use DateTimeZone;
+use PhpTypedValues\Abstract\TypeInterface;
 use PhpTypedValues\Exception\DateTimeTypeException;
 use PhpTypedValues\Exception\ReasonableRangeDateTimeTypeException;
 
@@ -17,7 +18,7 @@
 /**
  * @psalm-immutable
  */
-abstract readonly class DateTimeType implements DateTimeTypeInterface
+abstract readonly class DateTimeType implements TypeInterface, DateTimeTypeInterface
 {
     protected const FORMAT = '';
     protected const ZONE = 'UTC';

src/Abstract/Float/FloatType.php

@@ -4,14 +4,15 @@
 
 namespace PhpTypedValues\Abstract\Float;
 
+use PhpTypedValues\Abstract\TypeInterface;
 use PhpTypedValues\Exception\FloatTypeException;
 
 use function sprintf;
 
 /**
  * @psalm-immutable
  */
-abstract readonly class FloatType implements FloatTypeInterface
+abstract readonly class FloatType implements TypeInterface, FloatTypeInterface
 {
     /**
      * @throws FloatTypeException

src/Abstract/Integer/IntType.php

@@ -4,14 +4,15 @@
 
 namespace PhpTypedValues\Abstract\Integer;
 
+use PhpTypedValues\Abstract\TypeInterface;
 use PhpTypedValues\Exception\IntegerTypeException;
 
 use function sprintf;
 
 /**
  * @psalm-immutable
  */
-abstract readonly class IntType implements IntTypeInterface
+abstract readonly class IntType implements TypeInterface, IntTypeInterface
 {
     /**
      * @throws IntegerTypeException

src/Abstract/String/StrType.php

@@ -4,10 +4,12 @@
 
 namespace PhpTypedValues\Abstract\String;
 
+use PhpTypedValues\Abstract\TypeInterface;
+
 /**
  * @psalm-immutable
  */
-abstract readonly class StrType implements StrTypeInterface
+abstract readonly class StrType implements TypeInterface, StrTypeInterface
 {
     public function toString(): string
     {

src/Abstract/TypeInterface.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpTypedValues\Abstract;
+
+/**
+ * @psalm-immutable
+ */
+interface TypeInterface
+{
+    //    public function toString(): string;
+    //
+    //    public function __toString(): string;
+}

src/Abstract/Undefined/UndefinedType.php

@@ -4,6 +4,7 @@
 
 namespace PhpTypedValues\Abstract\Undefined;
 
+use PhpTypedValues\Abstract\TypeInterface;
 use PhpTypedValues\Exception\UndefinedTypeException;
 
 /**
@@ -13,7 +14,7 @@
  *
  * @psalm-immutable
  */
-abstract readonly class UndefinedType implements UndefinedTypeInterface
+abstract readonly class UndefinedType implements TypeInterface, UndefinedTypeInterface
 {
     public static function create(): static
     {