TASK: Add isEmpty method to proxy collection and a helper method for combining imageSourceProxies

Author: mficzel

Classes/Eel/ValueObjectHelper.php

@@ -36,6 +36,22 @@ public function unwrapProxyCollection(?ImageSourceProxyCollection $proxyCollecti
         return $this->imageSourceFactory->createFromProxyCollection($proxyCollection);
     }
 
+    public function combineCollection(ImageSourceProxyCollection|ImageSourceProxy|null ...$items): ImageSourceProxyCollection
+    {
+        /**
+         * @var ImageSourceProxy[] $proxies
+         */
+        $proxies = [];
+        foreach ($items as $item) {
+            if ($item instanceof ImageSourceProxy) {
+                $proxies[] = $item;
+            } elseif ($item instanceof ImageSourceProxyCollection) {
+                $proxies = array_merge($proxies, $item->items);
+            }
+        }
+        return new ImageSourceProxyCollection(...$proxies);
+    }
+
     public function allowsCallOfMethod($methodName)
     {
         return true;

Classes/ImageSourceProxyCollection.php

@@ -25,6 +25,45 @@ public function __construct(
         $this->items = $items;
     }
 
+    public function isEmpty(): bool
+    {
+        return empty($this->items);
+    }
+
+    public function getFirst(): ?ImageSourceProxy
+    {
+        if (count($this->items) > 0) {
+            return $this->items[array_key_first($this->items)];
+        }
+        return null;
+    }
+
+    public function getRandom(): ?ImageSourceProxy
+    {
+        if (count($this->items) > 0) {
+            $randomKey = array_rand($this->items);
+            return $this->items[$randomKey];
+        }
+        return null;
+    }
+
+    public function withRandomOrder(): self
+    {
+        $items = $this->items;
+        shuffle($items);
+        return new self(...$items);
+    }
+
+    public function widthAppendedCollection(ImageSourceProxyCollection $collection): self
+    {
+        return new self(...$this->items, ...$collection->items);
+    }
+
+    public function widthAppendedItem(ImageSourceProxy $item): self
+    {
+        return new self(...$this->items, ...[$item]);
+    }
+
     /**
      * @return \Traversable<ImageSourceProxy>
      */