Improve code consistency based on documentation and interfaces.

spec/loophp/collection/CollectionSpec.php

@@ -264,11 +264,11 @@ public function it_can_combine(): void
             ->beConstructedThrough('with', [range('A', 'E')]);
 
         $this
-            ->combine(range('e', 'a'))
+            ->combine(...range('e', 'a'))
             ->shouldIterateAs(['e' => 'A', 'd' => 'B', 'c' => 'C', 'b' => 'D', 'a' => 'E']);
 
         $this
-            ->combine(range(1, 100))
+            ->combine(...range(1, 100))
             ->shouldThrow(Exception::class)
             ->during('all');
     }

src/Collection.php

@@ -116,17 +116,17 @@ public function collapse(): BaseInterface
      *
      * @return \loophp\collection\Contract\Collection
      */
-    public function combinate(?int $size = null): BaseInterface
+    public function combinate(?int $length = null): BaseInterface
     {
-        return $this->run(new Combinate($size));
+        return $this->run(new Combinate($length));
     }
 
     /**
      * {@inheritdoc}
      *
      * @return \loophp\collection\Contract\Collection
      */
-    public function combine($keys): BaseInterface
+    public function combine(...$keys): BaseInterface
     {
         return $this->run(new Combine($keys));
     }
@@ -182,9 +182,9 @@ public static function empty(): CollectionInterface
      *
      * @return \loophp\collection\Contract\Collection
      */
-    public function explode(string ...$strings): BaseInterface
+    public function explode(...$explodes): BaseInterface
     {
-        return $this->run(new Explode(...$strings));
+        return $this->run(new Explode(...$explodes));
     }
 
     /**

src/Contract/Applyable.php

@@ -5,12 +5,12 @@
 namespace loophp\collection\Contract;
 
 /**
- * Interface Appendable.
+ * Interface Applyable.
  */
 interface Applyable
 {
     /**
-     * Apply a callback to all the element of an array.
+     * Execute a callback for each element of the collection.
      *
      * @param callable ...$callables
      *

src/Contract/Collapseable.php

@@ -10,7 +10,7 @@
 interface Collapseable
 {
     /**
-     * Collapse the collection of items into a single array.
+     * Collapse a collection of items into a simple flat collection.
      *
      * @return \loophp\collection\Contract\Collection<mixed>
      */

src/Contract/Combinateable.php

@@ -10,11 +10,12 @@
 interface Combinateable
 {
     /**
-     * TODO: Combinations.
+     * Get all the combinations of a given length of a collection of items.
      *
-     * @param int $size
+     * @param int $length
+     *   The length.
      *
      * @return \loophp\collection\Contract\Collection<mixed>
      */
-    public function combinate(?int $size = null): Base;
+    public function combinate(?int $length = null): Base;
 }

src/Contract/Combineable.php

@@ -10,9 +10,11 @@
 interface Combineable
 {
     /**
-     * @param mixed $keys
+     * Combine a collection of items with some other keys.
+     *
+     * @param mixed ...$keys
      *
      * @return \loophp\collection\Contract\Collection<mixed>
      */
-    public function combine($keys): Base;
+    public function combine(...$keys): Base;
 }

src/Contract/Distinctable.php

@@ -10,6 +10,8 @@
 interface Distinctable
 {
     /**
+     * Remove duplicated values from a collection.
+     *
      * @return \loophp\collection\Contract\Base<mixed>
      */
     public function distinct(): Base;

src/Contract/Explodeable.php

@@ -10,9 +10,11 @@
 interface Explodeable
 {
     /**
-     * @param string ...$explodes
+     * Explode a collection into subsets based on a given value.
+     *
+     * @param mixed ...$explodes
      *
      * @return \loophp\collection\Contract\Collection<mixed>
      */
-    public function explode(string ...$explodes): Base;
+    public function explode(...$explodes): Base;
 }

src/Contract/Filterable.php

@@ -10,7 +10,7 @@
 interface Filterable
 {
     /**
-     * Run a filter over each of the items.
+     * Filter collection items based on one or more callbacks.
      *
      * @param callable ...$callbacks
      *

src/Operation/Combinate.php

@@ -24,7 +24,7 @@ final class Combinate implements Operation
     private $length;
 
     /**
-     * Permutations constructor.
+     * Combinate constructor.
      *
      * @param int $length
      */

src/Operation/Explode.php

@@ -13,16 +13,16 @@
 final class Explode implements Operation
 {
     /**
-     * @var string[]
+     * @var array<mixed>
      */
     private $explodes;
 
     /**
      * Explode constructor.
      *
-     * @param string ...$explodes
+     * @param mixed ...$explodes
      */
-    public function __construct(string ...$explodes)
+    public function __construct(...$explodes)
     {
         $this->explodes = $explodes;
     }