New ArrayOfObjects type

Remove `ArrayOfStrings` and related test; refactor types and examples to align with `PrimitiveType` namespace changes.

Author: georgedeploy

README.md

@@ -39,7 +39,7 @@ use TypedValues\Integer\IntegerPositive;
 $id = IntegerPositive::fromString('123');
 ```
 
-Instead of spreading validation across an application:
+Instead of spreading validation across an application
 
 ```php
 $id = (int) '123';

src/Abstract/Array/ArrayType.php

@@ -4,28 +4,23 @@
 
 namespace PhpTypedValues\Abstract\Array;
 
-use IteratorAggregate;
-use JsonSerializable;
-
 /**
  * Base implementation for array typed values.
  *
- * Provides an immutable, iterable, and JSON‑serializable collection of
- * typed items. Concrete implementations define item validation and
- * factory behavior.
+ * Provides an immutable, iterable, countable, and JSON‑serializable
+ * collection of typed items. Concrete implementations define item
+ * validation and factory behavior.
  *
  * @internal
  *
  * @psalm-internal PhpTypedValues
  *
  * @template TItem
  *
- * @implements IteratorAggregate<int, TItem>
- *
  * @template-implements ArrayTypeInterface<TItem>
  *
  * @psalm-immutable
  */
-abstract readonly class ArrayType implements ArrayTypeInterface, IteratorAggregate, JsonSerializable
+abstract readonly class ArrayType implements ArrayTypeInterface
 {
 }

src/Abstract/Array/ArrayTypeInterface.php

@@ -4,49 +4,67 @@
 
 namespace PhpTypedValues\Abstract\Array;
 
-use PhpTypedValues\Undefined\Alias\Undefined;
+use Countable;
+use IteratorAggregate;
+use JsonSerializable;
+use PhpTypedValues\Abstract\Shared\ArrayOfObjectsAndUndefinedInterface;
+use PhpTypedValues\Abstract\Shared\IsEmptyInterface;
+use PhpTypedValues\Abstract\Shared\IsUndefinedInterface;
+use PhpTypedValues\Abstract\TypeInterface;
+use PhpTypedValues\Exception\ArrayTypeException;
 
 /**
  * Contract for array typed values.
  *
  * Represents a read‑only collection of typed items with factory helpers
  * to construct the collection from raw arrays. Implementations are
- * immutable and iterable.
+ * immutable, iterable, countable, and serializable.
  *
  * @internal
  *
  * @psalm-internal PhpTypedValues
  *
  * @template TItem
  *
+ * @extends IteratorAggregate<int, TItem>
+ *
  * @psalm-immutable
  */
-interface ArrayTypeInterface
+interface ArrayTypeInterface extends TypeInterface, JsonSerializable, IteratorAggregate, Countable, IsEmptyInterface, IsUndefinedInterface, ArrayOfObjectsAndUndefinedInterface
 {
     /**
-     * Returns the underlying typed items.
+     * Returns the underlying Objects array.
      *
      * @psalm-return list<TItem>
      */
     public function value(): array;
 
     /**
-     * Creates a new collection from a list of raw values.
+     * Creates a new collection from a list of Objects.
      * Implementations MUST fail early on invalid input.
      *
-     * @param array $value raw input values
+     * @param list<mixed> $value
      *
-     * @psalm-param list<mixed> $value
+     * @throws ArrayTypeException
      */
     public static function fromArray(array $value): static;
 
     /**
-     * Creates a new collection from a list of raw values, allowing
-     * late/optional failure semantics via `Undefined` where applicable.
+     * Creates a new collection from a list of Objects or scalars (which
+     * will be converted to Undefined type class), allowing late/optional
+     * failure semantics via `Undefined` where applicable.
+     *
+     * @param list<mixed> $value
      *
-     * @param array $value raw input values
+     * @throws ArrayTypeException
+     */
+    public static function tryFromArray(array $value): static;
+
+    /**
+     * Convert to an array of scalars from an array of Objects.
+     * Each Item should implement JsonSerializable interface.
      *
-     * @psalm-param list<mixed> $value
+     * @throws ArrayTypeException
      */
-    public static function tryFromArray(array $value): static|Undefined;
+    public function toArray(): array;
 }

src/Abstract/Bool/BoolType.php src/Abstract/Primitive/Bool/BoolType.phpsrc/Abstract/Bool/BoolType.php renamed to src/Abstract/Primitive/Bool/BoolType.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PhpTypedValues\Abstract\Bool;
+namespace PhpTypedValues\Abstract\Primitive\Bool;
 
-use PhpTypedValues\Abstract\AbstractType;
+use PhpTypedValues\Abstract\Primitive\PrimitiveType;
 
 /**
  * Base implementation for boolean typed values.
@@ -23,6 +23,6 @@
  *
  * @psalm-immutable
  */
-abstract readonly class BoolType extends AbstractType implements BoolTypeInterface
+abstract readonly class BoolType extends PrimitiveType implements BoolTypeInterface
 {
 }

src/Abstract/Bool/BoolTypeInterface.php …act/Primitive/Bool/BoolTypeInterface.phpsrc/Abstract/Bool/BoolTypeInterface.php renamed to src/Abstract/Primitive/Bool/BoolTypeInterface.php src/Abstract/Bool/BoolTypeInterface.php renamed to src/Abstract/Primitive/Bool/BoolTypeInterface.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PhpTypedValues\Abstract\Bool;
+namespace PhpTypedValues\Abstract\Primitive\Bool;
 
 use PhpTypedValues\Exception\BoolTypeException;
 use PhpTypedValues\Undefined\Alias\Undefined;

src/Abstract/DateTime/DateTimeType.php …ract/Primitive/DateTime/DateTimeType.phpsrc/Abstract/DateTime/DateTimeType.php renamed to src/Abstract/Primitive/DateTime/DateTimeType.php src/Abstract/DateTime/DateTimeType.php renamed to src/Abstract/Primitive/DateTime/DateTimeType.php

@@ -2,13 +2,13 @@
 
 declare(strict_types=1);
 
-namespace PhpTypedValues\Abstract\DateTime;
+namespace PhpTypedValues\Abstract\Primitive\DateTime;
 
 use const PHP_EOL;
 
 use DateTimeImmutable;
 use DateTimeZone;
-use PhpTypedValues\Abstract\AbstractType;
+use PhpTypedValues\Abstract\Primitive\PrimitiveType;
 use PhpTypedValues\Exception\DateTimeTypeException;
 use PhpTypedValues\Exception\ReasonableRangeDateTimeTypeException;
 
@@ -32,7 +32,7 @@
  *
  * @psalm-immutable
  */
-abstract readonly class DateTimeType extends AbstractType implements DateTimeTypeInterface
+abstract readonly class DateTimeType extends PrimitiveType implements DateTimeTypeInterface
 {
     protected const FORMAT = '';
     protected const ZONE = 'UTC';

…tract/DateTime/DateTimeTypeInterface.php …itive/DateTime/DateTimeTypeInterface.phpsrc/Abstract/DateTime/DateTimeTypeInterface.php renamed to src/Abstract/Primitive/DateTime/DateTimeTypeInterface.php src/Abstract/DateTime/DateTimeTypeInterface.php renamed to src/Abstract/Primitive/DateTime/DateTimeTypeInterface.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PhpTypedValues\Abstract\DateTime;
+namespace PhpTypedValues\Abstract\Primitive\DateTime;
 
 use DateTimeImmutable;
 use PhpTypedValues\Undefined\Alias\Undefined;

src/Abstract/Float/FloatType.php …c/Abstract/Primitive/Float/FloatType.phpsrc/Abstract/Float/FloatType.php renamed to src/Abstract/Primitive/Float/FloatType.php src/Abstract/Float/FloatType.php renamed to src/Abstract/Primitive/Float/FloatType.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PhpTypedValues\Abstract\Float;
+namespace PhpTypedValues\Abstract\Primitive\Float;
 
-use PhpTypedValues\Abstract\AbstractType;
+use PhpTypedValues\Abstract\Primitive\PrimitiveType;
 use PhpTypedValues\Exception\FloatTypeException;
 
 use function sprintf;
@@ -26,7 +26,7 @@
  *
  * @psalm-immutable
  */
-abstract readonly class FloatType extends AbstractType implements FloatTypeInterface
+abstract readonly class FloatType extends PrimitiveType implements FloatTypeInterface
 {
     /**
      * @throws FloatTypeException

src/Abstract/Float/FloatTypeInterface.php …t/Primitive/Float/FloatTypeInterface.phpsrc/Abstract/Float/FloatTypeInterface.php renamed to src/Abstract/Primitive/Float/FloatTypeInterface.php src/Abstract/Float/FloatTypeInterface.php renamed to src/Abstract/Primitive/Float/FloatTypeInterface.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PhpTypedValues\Abstract\Float;
+namespace PhpTypedValues\Abstract\Primitive\Float;
 
 use PhpTypedValues\Undefined\Alias\Undefined;
 

src/Abstract/Integer/IntType.php …c/Abstract/Primitive/Integer/IntType.phpsrc/Abstract/Integer/IntType.php renamed to src/Abstract/Primitive/Integer/IntType.php src/Abstract/Integer/IntType.php renamed to src/Abstract/Primitive/Integer/IntType.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PhpTypedValues\Abstract\Integer;
+namespace PhpTypedValues\Abstract\Primitive\Integer;
 
-use PhpTypedValues\Abstract\AbstractType;
+use PhpTypedValues\Abstract\Primitive\PrimitiveType;
 use PhpTypedValues\Exception\IntegerTypeException;
 
 use function sprintf;
@@ -26,7 +26,7 @@
  *
  * @psalm-immutable
  */
-abstract readonly class IntType extends AbstractType implements IntTypeInterface
+abstract readonly class IntType extends PrimitiveType implements IntTypeInterface
 {
     /**
      * @throws IntegerTypeException