Create and implement CollectionInterface as contract of all collections (e.g. based on the BaseCollection class)

src/Collection/BaseCollection.php

@@ -6,11 +6,11 @@
  * file that was distributed with this source code.
  */
 
+declare(strict_types=1);
+
 namespace Meritoo\Common\Collection;
 
-use ArrayAccess;
-use Countable;
-use IteratorAggregate;
+use Meritoo\Common\Contract\Collection\CollectionInterface;
 use Meritoo\Common\Traits\CollectionTrait;
 
 /**
@@ -19,7 +19,7 @@ use Meritoo\Common\Traits\CollectionTrait;
  * @author    Meritoo <github@meritoo.pl>
  * @copyright Meritoo <http://www.meritoo.pl>
  */
-abstract class BaseCollection implements Countable, ArrayAccess, IteratorAggregate
+abstract class BaseCollection implements CollectionInterface
 {
     use CollectionTrait;
 

src/Contract/Collection/CollectionInterface.php

@@ -0,0 +1,52 @@
+<?php
+
+/**
+ * (c) Meritoo.pl, http://www.meritoo.pl
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Meritoo\Common\Contract\Collection;
+
+use ArrayAccess;
+use Countable;
+use IteratorAggregate;
+
+/**
+ * Interface/Contract of collection of elements with the same type
+ *
+ * @author    Meritoo <github@meritoo.pl>
+ * @copyright Meritoo <http://www.meritoo.pl>
+ */
+interface CollectionInterface extends Countable, ArrayAccess, IteratorAggregate
+{
+    public function toArray(): array;
+
+    public function add($element, $index = null): void;
+
+    public function addMultiple($elements, bool $useIndexes = false): void;
+
+    public function prepend($element): void;
+
+    public function remove($element): void;
+
+    public function getPrevious($element);
+
+    public function getNext($element);
+
+    public function getFirst();
+
+    public function getLast();
+
+    public function getByIndex($index);
+
+    public function isEmpty(): bool;
+
+    public function isFirst($element): bool;
+
+    public function isLast($element): bool;
+
+    public function has($element): bool;
+}

src/Contract/Renderable/RenderableInterface.php

@@ -13,7 +13,7 @@ namespace Meritoo\Common\Contract\Renderable;
 use Meritoo\Common\Collection\Templates;
 
 /**
- * Something that may be rendered
+ * Interface/Contract of something that may be rendered
  *
  * @author    Meritoo <github@meritoo.pl>
  * @copyright Meritoo <http://www.meritoo.pl>

src/Traits/Collection/AddTrait.php

@@ -8,7 +8,7 @@
 
 namespace Meritoo\Common\Traits\Collection;
 
-use Meritoo\Common\Collection\BaseCollection;
+use Meritoo\Common\Contract\Collection\CollectionInterface;
 
 /**
  * Trait for the Collection with add*() methods
@@ -42,9 +42,9 @@ trait AddTrait
     /**
      * Adds given elements (at the end of collection)
      *
-     * @param array|BaseCollection $elements   The elements to add
-     * @param bool                 $useIndexes (optional) If is set to true, indexes of given elements will be used in
-     *                                         this collection. Otherwise - not.
+     * @param array|CollectionInterface $elements   The elements to add
+     * @param bool                      $useIndexes (optional) If is set to true, indexes of given elements will be
+     *                                              used in this collection. Otherwise - not.
      */
     public function addMultiple($elements, bool $useIndexes = false): void
     {

src/Traits/CollectionTrait.php

@@ -6,6 +6,8 @@
  * file that was distributed with this source code.
  */
 
+declare(strict_types=1);
+
 namespace Meritoo\Common\Traits;
 
 use Meritoo\Common\Traits\Collection\AddTrait;

src/Utilities/Reflection.php

@@ -10,7 +10,7 @@ namespace Meritoo\Common\Utilities;
 
 use Doctrine\Inflector\InflectorFactory;
 use Doctrine\Persistence\Proxy;
-use Meritoo\Common\Collection\BaseCollection;
+use Meritoo\Common\Contract\Collection\CollectionInterface;
 use Meritoo\Common\Exception\Reflection\CannotResolveClassNameException;
 use Meritoo\Common\Exception\Reflection\MissingChildClassesException;
 use Meritoo\Common\Exception\Reflection\NotExistingPropertyException;
@@ -207,11 +207,11 @@ class Reflection
      * Returns values of given property for given objects.
      * Looks for proper getter for the property.
      *
-     * @param array|BaseCollection|object $objects  The objects that should contain given property. It may be also one
-     *                                              object.
-     * @param string                      $property Name of the property that contains a value
-     * @param bool                        $force    (optional) If is set to true, try to retrieve value even if the
-     *                                              object does not have property. Otherwise - not.
+     * @param array|CollectionInterface|object $objects  The objects that should contain given property. It may be also
+     *                                                   one object.
+     * @param string                           $property Name of the property that contains a value
+     * @param bool                             $force    (optional) If is set to true, try to retrieve value even if
+     *                                                   the object does not have property. Otherwise - not.
      * @return array
      */
     public static function getPropertyValues($objects, string $property, bool $force = false): array
@@ -224,7 +224,7 @@ class Reflection
             return [];
         }
 
-        if ($objects instanceof BaseCollection) {
+        if ($objects instanceof CollectionInterface) {
             $objects = $objects->toArray();
         }