vimeo / psalm

src/Psalm/Internal/Stubs/ext-ds.php

Doc Comments +16 added lines, -7 removed lines

@@ -466,6 +466,7 @@ 
 
     /**
      * @param TValue ...$values
+     * @param TValue[] $values
      */
     public function contains(...$values): bool;
 
@@ -482,19 +483,20 @@ 
     public function find($value);
 
     /**
-     * @return TValue
+     * @return TValue|null
      * @throws \UnderflowException
      */
     public function first();
 
     /**
-     * @return TValue
+     * @return TValue|null
      * @throws \OutOfRangeException
      */
     public function get(int $index);
 
     /**
      * @param TValue ...$values
+     * @param TValue[] $values
      * @throws \OutOfRangeException
      */
     public function insert(int $index, ...$values);
@@ -506,7 +508,7 @@ 
     public function join(string $glue = null): string;
 
     /**
-     * @return TValue
+     * @return TValue|null
      * @throws \UnderflowException
      */
     public function last();
@@ -526,13 +528,14 @@ 
     public function merge(iterable $values): Sequence;
 
     /**
-     * @return TValue
+     * @return TValue|null
      * @throws \UnderflowException
      */
     public function pop();
 
     /**
      * @param TValue ...$values
+     * @param TValue[] $values
      */
     public function push(...$values);
 
@@ -540,12 +543,12 @@ 
      * @template TCarry
      * @param callable(TCarry, TValue): TCarry $callback
      * @param TCarry $initial
-     * @return TCarry
+     * @return TCarry|null
      */
     public function reduce(callable $callback, $initial = null);
 
     /**
-     * @return TValue
+     * @return TValue|null
      * @throws \OutOfRangeException
      */
     public function remove(int $index);
@@ -562,7 +565,7 @@ 
     public function set(int $index, $value);
 
     /**
-     * @return TValue
+     * @return TValue|null
      * @throws \UnderflowException
      */
     public function shift();
@@ -585,6 +588,7 @@ 
 
     /**
      * @param TValue ...$values
+     * @param TValue[] $values
      */
     public function unshift(...$values);
 }
@@ -739,6 +743,7 @@ 
 
     /**
      * @param TValue ...$values
+     * @param TValue[] $values
      */
     public function add(...$values): void
     {
@@ -746,6 +751,7 @@ 
 
     /**
      * @param TValue ...$values
+     * @param TValue[] $values
      */
     public function contains(...$values): bool
     {
@@ -819,6 +825,7 @@ 
 
     /**
      * @param TValue ...$values
+     * @param TValue[] $values
      */
     public function remove(...$values): void
     {
@@ -917,6 +924,7 @@ 
 
     /**
      * @param TValue ...$values
+     * @param TValue[] $values
      */
     public function push(...$values): void
     {
@@ -968,6 +976,7 @@ 
 
     /**
      * @param TValue ...$values
+     * @param TValue[] $values
      */
     public function push(...$values): void
     {