chore: Аннотации к типам

src/Functions.php

@@ -160,7 +160,7 @@ class Functions {
     }
 
     /**
-     * @deprecated
+     * @deprecated use fn and <=> operator
      * @param array $a
      * @param array $b
      * @param $key
@@ -174,6 +174,14 @@ class Functions {
         return ($a[$key] > $b[$key]) ? -1 : 1;
     }
 
+    /**
+     * @deprecated use fn and <=> operator
+     * @param array $a
+     * @param array $b
+     * @param $key
+     *
+     * @return int
+     */
     static function __cmp_less($a, $b, $key) {
         if ($a[$key] == $b[$key]) {
             return 0;
@@ -224,6 +232,11 @@ class Functions {
         return $result;
     }
 
+    /**
+     * @param string $key
+     * @param string $value
+     * @param array|\ArrayIterator $array
+     */
     static function assoc_key_values($key, $value, $array) {
         $result = [];
         foreach ($array as $item) {
@@ -232,6 +245,10 @@ class Functions {
         return $result;
     }
 
+    /**
+     * @param string $key
+     * @param array|\ArrayIterator $array
+     */
     static function assoc_key($key, $array) {
         $result = [];
         foreach ($array as $item) {
@@ -241,6 +258,7 @@ class Functions {
     }
 
     /**
+     * Возвращает значение по ключу
      * @param string $key
      * @param mixed $value
      * @param array $array
@@ -248,14 +266,25 @@ class Functions {
      */
     static function _get($key, $value, $array) {
         foreach ($array as $item) {
-            if ($item[$key] == $value) return $item;
+            if ($item[$key] == $value) {
+                return $item;
+            }
         }
         return null;
     }
 
+    /**
+     * Возвращает ключ по значению
+     * @param string $key
+     * @param mixed $value
+     * @param array $array
+     * @return mixed
+     */
     static function _get_key($key, $value, $array) {
         foreach ($array as $name => $item) {
-            if ($item[$key] == $value) return $name;
+            if ($item[$key] == $value) {
+                return $name;
+            }
         }
         return null;
     }
@@ -279,7 +308,6 @@ class Functions {
      * @return mixed
      */
     static function some(array $array, callable $callback) {
-
         foreach ($array as $key => $value) {
             if (call_user_func($callback, $value) === true) {
                 return $key;
@@ -288,8 +316,14 @@ class Functions {
         return false;
     }
 
+    /**
+     * Разбивает массив на массивы определенной длины
+     * @template T
+     * @param int $length Длина массива
+     * @param T[] $array Массив
+     * @return T[][]
+     */
     static function span(int $length, array $array) {
-
         $result = [];
         $count = count($array);
         for($i = 0; $i < $count; $i += $length) {
@@ -298,12 +332,22 @@ class Functions {
         return $result;
     }
 
+    /**
+     * Возвращает значение массива
+     * @param array $data Массив
+     * @param string|int $n Ключ
+     * @return mixed
+     */
     static function array_ref(array $data, string|int $n) {
         return $data[$n];
     }
 
-    static function call() {
-        $args = func_get_args();
+    /**
+     * Вызывает функцию с аргументами
+     * @param mixed ...$args Аргументы
+     * @return mixed
+     */
+    static function call(...$args) {
         $name = array_shift($args);
         return call_user_func_array($name, $args);
     }