feat: enhance Collection class with addArray method and update add method return type

Author: Vitexus

debian/changelog

@@ -1,8 +1,14 @@
-php-vitexsoftware-ease-core (1.50.0) UNRELEASED; urgency=medium
+php-vitexsoftware-ease-core (1.50.1) UNRELEASED; urgency=medium
+
+  * enhance Collection class with addArray method
+
+ -- vitex <info@vitexsoftware.cz>  Tue, 17 Feb 2026 18:39:40 +0100
+
+php-vitexsoftware-ease-core (1.50.0) unstable; urgency=medium
 
   * EaseURI functions added
 
- -- vitex <info@vitexsoftware.cz>  Fri, 30 Jan 2026 22:46:09 +0100
+ -- vitex <info@vitexsoftware.cz>  Tue, 17 Feb 2026 18:39:21 +0100
 
 php-vitexsoftware-ease-core (1.49.1) unstable; urgency=medium
 

src/Ease/Collection.php

@@ -54,8 +54,10 @@ public function __construct(string $class)
 
     /**
      * @param T $item
+     * 
+     * @return self
      */
-    public function add(object $item): void
+    public function add(object $item): self
     {
         if (!$item instanceof $this->class) {
             throw new \InvalidArgumentException(
@@ -64,6 +66,19 @@ public function add(object $item): void
         }
 
         $this->items[] = $item;
+        return $this;
+    }
+
+    /**
+     * Add New item defined by its pure data
+     * 
+     * @param array $data
+     * 
+     * @return self
+     */
+    public function addArray(array $data): self {
+        $this->add(new $this->class($data));
+        return $this;
     }
 
     /**

tests/src/Ease/AtomTest.php

@@ -35,7 +35,7 @@
 #[CoversClass(Atom::class)]
 class AtomTest extends \PHPUnit\Framework\TestCase
 {
-    protected \Ease\Atom $object;
+    protected $object;
 
     /**
      * Sets up the fixture, for example, opens a network connection.

tests/src/Ease/CollectionTest.php

@@ -67,7 +67,7 @@ public function testTypeValidation(): void
 
         // Invalid type should throw exception
         $this->expectException(\InvalidArgumentException::class);
-        $this->expectExceptionMessage('Item must be an instance of stdClass');
+        $this->expectExceptionMessage('Item must be instance of stdClass, Exception given');
 
         $bus->add(new \Exception());
     }
@@ -102,4 +102,28 @@ public function testGetItems(): void
         $this->assertSame($item1, $items[0]);
         $this->assertSame($item2, $items[1]);
     }
+
+    public function testAddArray(): void
+    {
+        // Anonymous class that accepts an array in constructor
+        $proto = new class(['a' => 1]) {
+            public array $data;
+
+            public function __construct(array $data)
+            {
+                $this->data = $data;
+            }
+        };
+
+        $className = \get_class($proto);
+
+        $collection = new Collection($className);
+
+        $collection->addArray(['a' => 1, 'b' => 2]);
+
+        $items = $collection->getItems();
+
+        $this->assertCount(1, $items);
+        $this->assertSame(['a' => 1, 'b' => 2], $items[0]->data);
+    }
 }