Update typing information.

src/Contract/Operation/Appendable.php

@@ -18,7 +18,7 @@ interface Appendable
      *
      * @param mixed ...$items
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function append(...$items): Collection;
 }

src/Contract/Operation/Applyable.php

@@ -19,7 +19,7 @@ interface Applyable
      * @param callable ...$callables
      * @psalm-param callable(TKey, T):(bool) ...$callables
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function apply(callable ...$callables): Collection;
 }

src/Contract/Operation/Cacheable.php

@@ -15,7 +15,7 @@
 interface Cacheable
 {
     /**
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function cache(?CacheItemPoolInterface $cache = null): Collection;
 }

src/Contract/Operation/Chunkable.php

@@ -18,7 +18,7 @@ interface Chunkable
      *
      * @param int ...$size
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function chunk(int ...$size): Collection;
 }

src/Contract/Operation/Collapseable.php

@@ -16,7 +16,7 @@ interface Collapseable
     /**
      * Collapse a collection of items into a simple flat collection.
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function collapse(): Collection;
 }

src/Contract/Operation/Columnable.php

@@ -18,7 +18,7 @@ interface Columnable
      *
      * @param int|string $index
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function column($index): Collection;
 }

src/Contract/Operation/Combinateable.php

@@ -19,7 +19,7 @@ interface Combinateable
      * @param int $length
      *   The length.
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function combinate(?int $length = null): Collection;
 }

src/Contract/Operation/Combineable.php

@@ -18,7 +18,7 @@ interface Combineable
      *
      * @param mixed ...$keys
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function combine(...$keys): Collection;
 }

src/Contract/Operation/Compactable.php

@@ -18,7 +18,7 @@ interface Compactable
      *
      * @param mixed ...$values
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function compact(...$values): Collection;
 }

src/Contract/Operation/Cycleable.php

@@ -14,7 +14,7 @@
 interface Cycleable
 {
     /**
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function cycle(?int $length = null): Collection;
 }

src/Contract/Operation/Diffable.php

@@ -16,7 +16,7 @@ interface Diffable
     /**
      * @param mixed ...$values
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function diff(...$values): Collection;
 }

src/Contract/Operation/Diffkeysable.php

@@ -16,7 +16,7 @@ interface Diffkeysable
     /**
      * @param mixed ...$values
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function diffKeys(...$values): Collection;
 }

src/Contract/Operation/Distinctable.php

@@ -14,7 +14,7 @@
 interface Distinctable
 {
     /**
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function distinct(): Collection;
 }

src/Contract/Operation/Explodeable.php

@@ -18,7 +18,7 @@ interface Explodeable
      *
      * @param mixed ...$explodes
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function explode(...$explodes): Collection;
 }

src/Contract/Operation/Filterable.php

@@ -18,7 +18,7 @@ interface Filterable
      *
      * @param callable ...$callbacks
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function filter(callable ...$callbacks): Collection;
 }

src/Contract/Operation/Flattenable.php

@@ -18,7 +18,7 @@ interface Flattenable
     /**
      * Flatten a collection of items into a simple flat collection.
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function flatten(int $depth = PHP_INT_MAX): Collection;
 }

src/Contract/Operation/Flipable.php

@@ -16,7 +16,7 @@ interface Flipable
     /**
      * Flip keys and items in a collection.
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function flip(): Collection;
 }

src/Contract/Operation/Forgetable.php

@@ -18,7 +18,7 @@ interface Forgetable
      *
      * @param mixed ...$keys
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function forget(...$keys): Collection;
 }

src/Contract/Operation/Frequencyable.php

@@ -14,7 +14,7 @@
 interface Frequencyable
 {
     /**
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function frequency(): Collection;
 }

src/Contract/Operation/Groupable.php

@@ -14,7 +14,7 @@
 interface Groupable
 {
     /**
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function group(?callable $callback = null): Collection;
 }

src/Contract/Operation/Intersectable.php

@@ -16,7 +16,7 @@ interface Intersectable
     /**
      * @param mixed ...$values
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function intersect(...$values): Collection;
 }

src/Contract/Operation/Intersectkeysable.php

@@ -16,7 +16,7 @@ interface Intersectkeysable
     /**
      * @param mixed ...$values
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function intersectKeys(...$values): Collection;
 }

src/Contract/Operation/Intersperseable.php

@@ -19,7 +19,7 @@ interface Intersperseable
      *
      * @param mixed $element
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function intersperse($element, int $every = 1, int $startAt = 0): Collection;
 }

src/Contract/Operation/Iterateable.php

@@ -15,7 +15,7 @@ interface Iterateable
      *
      * @param mixed ...$parameters
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public static function iterate(callable $callback, ...$parameters): Collection;
 }

src/Contract/Operation/Keysable.php

@@ -16,7 +16,7 @@ interface Keysable
     /**
      * Get the keys of the items.
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function keys(): Collection;
 }

src/Contract/Operation/Limitable.php

@@ -16,7 +16,7 @@ interface Limitable
     /**
      * Limit the first {$limit} items.
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function limit(int $limit): Collection;
 }

src/Contract/Operation/Loopable.php

@@ -14,7 +14,7 @@
 interface Loopable
 {
     /**
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function loop(): Collection;
 }

src/Contract/Operation/Mapable.php

@@ -18,7 +18,7 @@ interface Mapable
      *
      * @param callable ...$callbacks
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function map(callable ...$callbacks): Collection;
 }

src/Contract/Operation/Mergeable.php

@@ -18,7 +18,7 @@ interface Mergeable
      *
      * @param iterable<mixed> ...$sources
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function merge(iterable ...$sources): Collection;
 }

src/Contract/Operation/Normalizeable.php

@@ -16,7 +16,7 @@ interface Normalizeable
     /**
      * Replace, reorder and use numeric keys on a collection.
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function normalize(): Collection;
 }

src/Contract/Operation/Nthable.php

@@ -16,7 +16,7 @@ interface Nthable
     /**
      * Get every n-th element of a collection.
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function nth(int $step, int $offset = 0): Collection;
 }

src/Contract/Operation/Onlyable.php

@@ -18,7 +18,7 @@ interface Onlyable
      *
      * @param mixed ...$keys
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function only(...$keys): Collection;
 }

src/Contract/Operation/Padable.php

@@ -18,7 +18,7 @@ interface Padable
      *
      * @param mixed $value
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function pad(int $size, $value): Collection;
 }

src/Contract/Operation/Pairable.php

@@ -14,7 +14,7 @@
 interface Pairable
 {
     /**
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function pair(): Collection;
 }

src/Contract/Operation/Permutateable.php

@@ -16,7 +16,7 @@ interface Permutateable
     /**
      * Find all the permutations of a collection.
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function permutate(): Collection;
 }

src/Contract/Operation/Pluckable.php

@@ -19,7 +19,7 @@ interface Pluckable
      * @param array<int, string>|string $pluck
      * @param mixed|null $default
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function pluck($pluck, $default = null): Collection;
 }

src/Contract/Operation/Prependable.php

@@ -18,7 +18,7 @@ interface Prependable
      *
      * @param mixed ...$items
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function prepend(...$items): Collection;
 }

src/Contract/Operation/Productable.php

@@ -18,7 +18,7 @@ interface Productable
      *
      * @param iterable<mixed> ...$iterables
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function product(iterable ...$iterables): Collection;
 }

src/Contract/Operation/RSampleable.php

@@ -14,7 +14,7 @@
 interface RSampleable
 {
     /**
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function rsample(float $probability): Collection;
 }

src/Contract/Operation/Randomable.php

@@ -14,7 +14,7 @@
 interface Randomable
 {
     /**
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function random(int $size = 1): Collection;
 }

src/Contract/Operation/Rangeable.php

@@ -17,7 +17,7 @@ interface Rangeable
      * @psalm-template TKey of array-key
      * @psalm-template T
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public static function range(float $start = 0.0, float $end = INF, float $step = 1.0): Collection;
 }

src/Contract/Operation/Reductionable.php

@@ -18,7 +18,7 @@ interface Reductionable
      *
      * @param mixed $initial
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function reduction(callable $callback, $initial = null): Collection;
 }

src/Contract/Operation/Reverseable.php

@@ -16,7 +16,7 @@ interface Reverseable
     /**
      * Reverse order items of a collection.
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function reverse(): Collection;
 }

src/Contract/Operation/Scaleable.php

@@ -20,7 +20,7 @@ interface Scaleable
      * @param ?float $wantedUpperBound
      * @param ?float $base
      *
-     * @return \loophp\collection\Contract\Collection<TKey, T>
+     * @psalm-return \loophp\collection\Contract\Collection<TKey, T>
      */
     public function scale(
         float $lowerBound,