Use self return type

src/Chain.php

@@ -102,9 +102,9 @@ public function __construct(array $array = [])
     /**
      * @param array $array
      *
-     * @return Chain
+     * @return self
      */
-    public static function create(array $array = []): Chain
+    public static function create(array $array = []): self
     {
         return new static($array);
     }
@@ -115,9 +115,9 @@ public static function create(array $array = []): Chain
      * @param array  $options   If the option `regexp` is `true` the string is split by using `preg_split()`, otherwise
      *                          `explode()` is used.
      *
-     * @return Chain
+     * @return self
      */
-    public static function createFromString(string $delimiter, string $string, array $options = []): Chain
+    public static function createFromString(string $delimiter, string $string, array $options = []): self
     {
         $options = array_merge(['regexp' => false], $options);
         $chain   = new static();

src/Link/ChangeKeyCase.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * Class ChangeKeyCase.
  *
@@ -18,9 +16,9 @@ trait ChangeKeyCase
      *
      * @param int $case Either `CASE_UPPER` or `CASE_LOWER` (default).
      *
-     * @return Chain
+     * @return self
      */
-    public function changeKeyCase(int $case = CASE_LOWER): Chain
+    public function changeKeyCase(int $case = CASE_LOWER): self
     {
         $this->array = array_change_key_case($this->array, $case);
 

src/Link/Combine.php

@@ -18,9 +18,9 @@ trait Combine
      *                            will be converted to string.
      * @param Chain|array $values Array or instance of `Cocur\Chain\Chain` of values to be used.
      *
-     * @return Chain
+     * @return self
      */
-    public function combine($keys, $values): Chain
+    public function combine($keys, $values): self
     {
         $this->array = array_combine(
             $keys instanceof Chain ? $keys->array : $keys,

src/Link/Diff.php

@@ -20,9 +20,9 @@ trait Diff
      *
      * @param Chain|array $array2 An array or instance of `Cocur\Chain\Chain` to compare against.
      *
-     * @return Chain
+     * @return self
      */
-    public function diff($array2): Chain
+    public function diff($array2): self
     {
         $this->array = array_diff(
             $this->array,

src/Link/Fill.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * Fill.
  *
@@ -23,9 +21,9 @@ trait Fill
      * @param int   $num        Number of elements to insert. Must be greater than or equal to zero.
      * @param mixed $value      Value to use for filling.
      *
-     * @return Chain
+     * @return self
      */
-    public static function fill(int $startIndex, int $num, $value = null): Chain
+    public static function fill(int $startIndex, int $num, $value = null): self
     {
         return new self(array_fill($startIndex, $num, $value));
     }

src/Link/Filter.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * Filter.
  *
@@ -20,9 +18,9 @@ trait Filter
      *
      * @param callable $callback The callback function to use.
      *
-     * @return Chain
+     * @return self
      */
-    public function filter(callable $callback): Chain
+    public function filter(callable $callback): self
     {
         $this->array = array_filter($this->array, $callback, ARRAY_FILTER_USE_BOTH);
 

src/Link/Find.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * Find
  *

src/Link/FlatMap.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * FlatMap.
  *
@@ -14,9 +12,9 @@ trait FlatMap
     /**
      * @param callable $callback
      *
-     * @return Chain
+     * @return self
      */
-    public function flatMap(callable $callback): Chain
+    public function flatMap(callable $callback): self
     {
         $flattened = [];
         foreach ($this->array as $index => $element) {

src/Link/Flip.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * Flip.
  *
@@ -13,9 +11,9 @@
 trait Flip
 {
     /**
-     * @return Chain
+     * @return self
      */
-    public function flip(): Chain
+    public function flip(): self
     {
         $this->array = array_flip($this->array);
 

src/Link/Intersect.php

@@ -15,9 +15,9 @@ trait Intersect
     /**
      * @param Chain|array $array2
      *
-     * @return Chain
+     * @return self
      */
-    public function intersect($array2): Chain
+    public function intersect($array2): self
     {
         $this->array = array_intersect($this->array, $array2 instanceof Chain ? $array2->array : $array2);
 

src/Link/IntersectAssoc.php

@@ -15,9 +15,9 @@ trait IntersectAssoc
     /**
      * @param Chain|array $array
      *
-     * @return Chain
+     * @return self
      */
-    public function intersectAssoc($array): Chain
+    public function intersectAssoc($array): self
     {
         $this->array = array_intersect_assoc($this->array, $array instanceof Chain ? $array->array : $array);
 

src/Link/IntersectKey.php

@@ -15,9 +15,9 @@ trait IntersectKey
     /**
      * @param Chain|array $array
      *
-     * @return Chain
+     * @return self
      */
-    public function intersectKey($array): Chain
+    public function intersectKey($array): self
     {
         $this->array = array_intersect_key($this->array, $array instanceof Chain ? $array->array : $array);
 

src/Link/Keys.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * Keys.
  *
@@ -13,9 +11,9 @@
 trait Keys
 {
     /**
-     * @return Chain
+     * @return self
      */
-    public function keys(): Chain
+    public function keys(): self
     {
         $this->array = array_keys($this->array);
 

src/Link/Map.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * Map.
  *
@@ -15,9 +13,9 @@ trait Map
     /**
      * @param callable $callback
      *
-     * @return Chain
+     * @return self
      */
-    public function map(callable $callback): Chain
+    public function map(callable $callback): self
     {
         foreach ($this->array as $index => $element) {
             $this->array[$index] = $callback($element, $index);

src/Link/Merge.php

@@ -20,9 +20,9 @@ trait Merge
      * @param Chain|array $array   Array to merge with
      * @param array       $options Options, including `recursive` to merge arrays recursive.
      *
-     * @return Chain
+     * @return self
      */
-    public function merge($array, array $options = []): Chain
+    public function merge($array, array $options = []): self
     {
         $options = array_merge(['recursive' => false], $options);
 

src/Link/Pad.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * Pad.
  *
@@ -16,9 +14,9 @@ trait Pad
      * @param int   $size
      * @param mixed $value
      *
-     * @return Chain
+     * @return self
      */
-    public function pad(int $size, $value): Chain
+    public function pad(int $size, $value): self
     {
         $this->array = array_pad($this->array, $size, $value);
 

src/Link/Push.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * Push.
  *
@@ -15,9 +13,9 @@ trait Push
     /**
      * @param mixed $element
      *
-     * @return Chain
+     * @return self
      */
-    public function push($element): Chain
+    public function push($element): self
     {
         array_push($this->array, $element);
 

src/Link/Replace.php

@@ -15,9 +15,9 @@ trait Replace
     /**
      * @param Chain|array $array
      *
-     * @return Chain
+     * @return self
      */
-    public function replace($array): Chain
+    public function replace($array): self
     {
         $this->array = array_replace($this->array, $array instanceof Chain ? $chain->array : $array);
 

src/Link/Reverse.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * Reverse.
  *
@@ -15,9 +13,9 @@ trait Reverse
     /**
      * @param bool $preserveKeys
      *
-     * @return Chain
+     * @return self
      */
-    public function reverse(bool $preserveKeys = false): Chain
+    public function reverse(bool $preserveKeys = false): self
     {
         $this->array = array_reverse($this->array, $preserveKeys);
 

src/Link/Shuffle.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * Shuffle.
  *
@@ -13,9 +11,9 @@
 trait Shuffle
 {
     /**
-     * @return Chain
+     * @return self
      */
-    public function shuffle(): Chain
+    public function shuffle(): self
     {
         shuffle($this->array);
 

src/Link/Slice.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * Slice.
  *
@@ -17,9 +15,9 @@ trait Slice
      * @param int|null $length
      * @param bool     $preserveKeys
      *
-     * @return Chain
+     * @return self
      */
-    public function slice(int $offset, ?int $length = null, bool $preserveKeys = false): Chain
+    public function slice(int $offset, ?int $length = null, bool $preserveKeys = false): self
     {
         $this->array = array_slice($this->array, $offset, $length, $preserveKeys);
 

src/Link/Sort.php

@@ -2,8 +2,6 @@
 
 namespace Cocur\Chain\Link;
 
-use Cocur\Chain\Chain;
-
 /**
  * Class Sort.
  *
@@ -18,9 +16,9 @@ trait Sort
      * @param int|callable $sortBy
      * @param array        $options
      *
-     * @return Chain
+     * @return self
      */
-    public function sort($sortBy = SORT_REGULAR, array $options = []): Chain
+    public function sort($sortBy = SORT_REGULAR, array $options = []): self
     {
         if (!$sortBy) {
             $sortBy = SORT_REGULAR;