Add unit tests for Map class functionality in MapTest.php

- Implement tests for various methods including from, empty, make, put, putAll, get, has, first, last, sole, slice, reverse, merge, map, filter, reject, reduce, sort, values, keys, and remove.
- Include data providers for testing pairs with different types including primitive values, custom classes, and mixed types.
- Ensure immutability of the Map collection by verifying that original collections remain unchanged after operations.
- Validate behavior for edge cases such as empty collections and non-existent keys.

Author: endou-mame

README.md

@@ -126,7 +126,7 @@ if ($decimalResult->isOk()) {
 #### リストコレクション
 
 ```php
-use WizDevelop\PhpValueObject\Collection\ListCollection;
+use WizDevelop\PhpValueObject\Collection\ArrayList;
 use WizDevelop\PhpValueObject\Number\IntegerValue;
 
 // 整数値オブジェクトのコレクション
@@ -136,7 +136,7 @@ $numbers = [
     IntegerValue::from(3),
 ];
 
-$list = ListCollection::from($numbers);
+$list = ArrayList::from($numbers);
 
 // マップ操作
 $doubled = $list->map(fn ($num) => $num->mul(IntegerValue::from(2)));
@@ -158,11 +158,11 @@ $last = $list->last();    // 3
 #### マップコレクション
 
 ```php
-use WizDevelop\PhpValueObject\Collection\MapCollection;
+use WizDevelop\PhpValueObject\Collection\Map;
 use WizDevelop\PhpValueObject\String\StringValue;
 
 // 文字列値オブジェクトの連想配列
-$map = MapCollection::from([
+$map = Map::from([
     'name' => StringValue::from('John'),
     'email' => StringValue::from('[email protected]'),
 ]);
@@ -287,14 +287,14 @@ protected static function max(): \BcMath\Number  // 最大値
 protected static function isValid(\BcMath\Number $value): Result  // 追加の検証ロジック
 ```
 
-### ListCollection API
+### ArrayList API
 
 ```php
 // 静的ファクトリメソッド
-ListCollection::from(array $elements): static
-ListCollection::tryFrom(array $elements): Result<static, CollectionValueError>
-ListCollection::empty(): static
-ListCollection::make(iterable $items = []): static
+ArrayList::from(array $elements): static
+ArrayList::tryFrom(array $elements): Result<static, CollectionValueError>
+ArrayList::empty(): static
+ArrayList::make(iterable $items = []): static
 
 // 要素の取得
 public function first(?Closure $closure = null, $default = null): mixed
@@ -309,8 +309,8 @@ public function slice(int $offset, ?int $length = null): static
 public function reverse(): static
 public function push(...$values): static
 public function add($element): static
-public function concat(IListCollection $other): self
-public function merge(IListCollection $other): self
+public function concat(IArrayList $other): self
+public function merge(IArrayList $other): self
 
 // 高階関数
 public function map(Closure $closure): self
@@ -332,20 +332,20 @@ public function offsetExists(mixed $offset): bool
 public function offsetGet(mixed $offset): mixed
 ```
 
-### MapCollection API
+### Map API
 
 ```php
 // 静的ファクトリメソッド
-MapCollection::from(array $elements): static
-MapCollection::tryFrom(array $elements): Result<static, CollectionValueError>
-MapCollection::empty(): static
-MapCollection::make(iterable $items = []): static
+Map::from(array $elements): static
+Map::tryFrom(array $elements): Result<static, CollectionValueError>
+Map::empty(): static
+Map::make(iterable $items = []): static
 
 // 要素の取得
 public function get(string $key, $default = null): mixed
 public function has(string $key): bool
-public function keys(): ListCollection
-public function values(): ListCollection
+public function keys(): ArrayList
+public function values(): ArrayList
 
 // コレクション操作
 public function toArray(): array
@@ -455,13 +455,13 @@ final readonly class Age extends IntegerValue
 ### カスタムコレクションの作成
 
 ```php
-use WizDevelop\PhpValueObject\Collection\ListCollection;
+use WizDevelop\PhpValueObject\Collection\ArrayList;
 
 /**
  * @template T of User
- * @extends ListCollection<T>
+ * @extends ArrayList<T>
  */
-final readonly class UserCollection extends ListCollection
+final readonly class UserCollection extends ArrayList
 {
     // コレクションサイズの制約をオーバーライド
     protected static function minCount(): int

src/Collection/ListCollection.php renamed to src/Collection/ArrayList.php

@@ -16,18 +16,18 @@
 use WizDevelop\PhpValueObject\Collection\Base\CountableDefault;
 use WizDevelop\PhpValueObject\Collection\Exception\CollectionNotFoundException;
 use WizDevelop\PhpValueObject\Collection\Exception\MultipleCollectionsFoundException;
-use WizDevelop\PhpValueObject\Collection\List\IListCollection;
-use WizDevelop\PhpValueObject\Collection\List\IListCollectionFactory;
+use WizDevelop\PhpValueObject\Collection\List\IArrayList;
+use WizDevelop\PhpValueObject\Collection\List\IArrayListFactory;
 
 /**
  * リストコレクション
  * @template TValue
  * @extends CollectionBase<int,TValue>
- * @implements IListCollection<TValue>
- * @implements IListCollectionFactory<TValue>
+ * @implements IArrayList<TValue>
+ * @implements IArrayListFactory<TValue>
  * @implements ArrayAccess<int,TValue>
  */
-readonly class ListCollection extends CollectionBase implements IListCollection, IListCollectionFactory, ArrayAccess
+readonly class ArrayList extends CollectionBase implements IArrayList, IArrayListFactory, ArrayAccess
 {
     /** @use ArrayAccessDefault<int,TValue> */
     use ArrayAccessDefault;
@@ -80,7 +80,7 @@ final public function toArray(): array
     }
 
     // -------------------------------------------------------------------------
-    // NOTE: IListCollectionFactory
+    // NOTE: IArrayListFactory
     // -------------------------------------------------------------------------
     #[Override]
     final public static function from(array $elements): static
@@ -105,7 +105,7 @@ final public static function empty(): static
     }
 
     // -------------------------------------------------------------------------
-    // NOTE: IListCollection
+    // NOTE: IArrayList
     // -------------------------------------------------------------------------
     #[Override]
     final public static function make(iterable $items = []): static
@@ -225,11 +225,11 @@ final public function push(...$values): static
     /**
      * @template TValue2
      *
-     * @param  IListCollection<TValue2> $other
+     * @param  IArrayList<TValue2>  $other
      * @return self<TValue|TValue2>
      */
     #[Override]
-    final public function concat(IListCollection $other): self
+    final public function concat(IArrayList $other): self
     {
         $elements = $this->elements;
 
@@ -243,11 +243,11 @@ final public function concat(IListCollection $other): self
     /**
      * @template TValue2
      *
-     * @param  IListCollection<TValue2> $other
+     * @param  IArrayList<TValue2>  $other
      * @return self<TValue|TValue2>
      */
     #[Override]
-    final public function merge(IListCollection $other): self
+    final public function merge(IArrayList $other): self
     {
         return new self(array_merge($this->elements, $other->toArray()));
     }

src/Collection/Base/CollectionBase.php

@@ -6,7 +6,7 @@
 
 use Override;
 use WizDevelop\PhpMonad\Result;
-use WizDevelop\PhpValueObject\Collection\CollectionValueError;
+use WizDevelop\PhpValueObject\Collection\CollectionError;
 use WizDevelop\PhpValueObject\IValueObject;
 
 use function count;
@@ -66,7 +66,7 @@ abstract protected static function maxCount(): int;
      * @template TIsValidCountKey of TKey|array-key
      * @template TIsValidCountValue of TValue
      * @param  array<TIsValidCountKey,TIsValidCountValue> $elements
-     * @return Result<bool,CollectionValueError>
+     * @return Result<bool,CollectionError>
      */
     final protected static function isValidCount(array $elements): Result
     {
@@ -75,22 +75,22 @@ final protected static function isValidCount(array $elements): Result
         $max_count = static::maxCount() < self::MAX_COUNT ? static::maxCount() : self::MAX_COUNT;
 
         if ($element_count < $min_count && $element_count > $max_count) {
-            return Result\err(CollectionValueError::invalidRange(
+            return Result\err(CollectionError::invalidRange(
                 className: static::class,
                 min: $min_count,
                 max: $max_count,
                 count: $element_count,
             ));
         }
         if ($element_count < $min_count) {
-            return Result\err(CollectionValueError::invalidMinCount(
+            return Result\err(CollectionError::invalidMinCount(
                 className: static::class,
                 min: $min_count,
                 count: $element_count,
             ));
         }
         if ($element_count > $max_count) {
-            return Result\err(CollectionValueError::invalidMaxCount(
+            return Result\err(CollectionError::invalidMaxCount(
                 className: static::class,
                 max: $max_count,
                 count: $element_count,

src/Collection/CollectionValueError.php renamed to src/Collection/CollectionError.php

@@ -8,10 +8,10 @@
 use WizDevelop\PhpValueObject\ValueObjectError;
 
 /**
- * CollectionValue エラー
+ * Collection エラー
  * @extends ValueObjectError<CollectionBase<mixed,mixed>>
  */
-final readonly class CollectionValueError extends ValueObjectError
+final readonly class CollectionError extends ValueObjectError
 {
     public static function invalid(
         string $message,

src/Collection/List/IListCollection.php renamed to src/Collection/List/IArrayList.php

@@ -13,10 +13,10 @@
 /**
  * リストコレクション インターフェース
  * @template TValue
- * @uses WizDevelop\PhpValueObject\Collection\ListCollection
+ * @uses WizDevelop\PhpValueObject\Collection\ArrayList
  * @extends ICollection<int,TValue>
  */
-interface IListCollection extends ICollection
+interface IArrayList extends ICollection
 {
     /**
      * Create a new collection instance if the value isn't one already.
@@ -99,8 +99,8 @@ public function push(...$values): static;
      *
      * @template TValue2
      *
-     * @param  IListCollection<TValue2>        $other
-     * @return IListCollection<TValue|TValue2>
+     * @param  IArrayList<TValue2>        $other
+     * @return IArrayList<TValue|TValue2>
      */
     public function concat(self $other): self;
 
@@ -112,16 +112,16 @@ public function concat(self $other): self;
      *
      * @template TValue2
      *
-     * @param  IListCollection<TValue2>        $other
-     * @return IListCollection<TValue|TValue2>
+     * @param  IArrayList<TValue2>        $other
+     * @return IArrayList<TValue|TValue2>
      */
     public function merge(self $other): self;
 
     /**
      * @template TMapValue
      *
      * @param  Closure(TValue,int): TMapValue $closure
-     * @return IListCollection<TMapValue>
+     * @return IArrayList<TMapValue>
      */
     public function map(Closure $closure): self;
 

src/Collection/List/IListCollectionFactory.php renamed to src/Collection/List/IArrayListFactory.php

@@ -5,15 +5,15 @@
 namespace WizDevelop\PhpValueObject\Collection\List;
 
 use WizDevelop\PhpMonad\Result;
-use WizDevelop\PhpValueObject\Collection\CollectionValueError;
+use WizDevelop\PhpValueObject\Collection\CollectionError;
 
 /**
  * リストコレクション ファクトリインターフェース
- * @see WizDevelop\PhpValueObject\Collection\ListCollection
+ * @see WizDevelop\PhpValueObject\Collection\ArrayList
  *
  * @template TValue
  */
-interface IListCollectionFactory
+interface IArrayListFactory
 {
     /**
      * 信頼できるプリミティブ値からインスタンスを生成する
@@ -30,8 +30,8 @@ public static function from(array $elements): static;
      *
      * @template TTryFromValue of TValue
      *
-     * @param  array<int,TTryFromValue>                           $elements
-     * @return Result<static<TTryFromValue>,CollectionValueError>
+     * @param  array<int,TTryFromValue>                      $elements
+     * @return Result<static<TTryFromValue>,CollectionError>
      */
     public static function tryFrom(array $elements): Result;