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

src/Primitive.php

@@ -20,7 +20,7 @@ class Primitive {
     }
 
     // int
-    public static function to_bool($value)
+    public static function to_bool($value): bool
     {
         return filter_var($value, FILTER_VALIDATE_BOOLEAN);//(int)((bool) $value);
     }
@@ -41,8 +41,12 @@ class Primitive {
         return ((string) $value);
     }
 
-    // date
-    public static function to_date($value)
+    /**
+     * Преобразование даты dd/mm/yy в unix timestamp
+     * @param string $value
+     * @return int
+     */
+    public static function to_date($value): int
     {
         $result = 0;
         $tmp = explode("/", $value ?? '', 3);
@@ -66,7 +70,12 @@ class Primitive {
         return $result;
     }
 
-    public static function to_datetime($value)
+    /**
+     * Преобразование даты ISO 8601 в unix timestamp
+     * @param string $value
+     * @return int
+     */
+    public static function to_datetime($value): int
     {
         $result = 0;
 
@@ -79,7 +88,12 @@ class Primitive {
         return $result;
     }
 
-    public static function from_date($value)
+    /**
+     * Преобразование даты в формат dd/mm/yyyy
+     * @param int $value
+     * @return string
+     */
+    public static function from_date($value): string
     {
         if ($value > 0) {
             return date("d/m/Y", $value);
@@ -87,7 +101,12 @@ class Primitive {
         return '';
     }
 
-    public static function from_datetime($value)
+    /**
+     * Преобразование даты в формат ISO 8601
+     * @param int $value
+     * @return string
+     */
+    public static function from_datetime($value): string
     {
         if ($value > 0) {
             return date("Y-m-d\TH:i\Z", $value);
@@ -96,24 +115,45 @@ class Primitive {
     }
 
 
-    // secure
+    /**
+     * @deprecated
+     * @template T
+     * @param T $value
+     * @return T
+     */
     public static function to_secure($value)
     {
         // Значение приабразуется во время сохранения в базе данных
         return $value;
     }
 
+    /**
+     * @deprecated
+     * @template T
+     * @param T $value
+     * @return T
+     */
     public static function from_secure($value)
     {
         return $value;
     }
 
-    // array
+    /**
+     * Преобразование значения в массив
+     * @param mixed $value
+     * @return array
+     */
     public static function to_array($value)
     {
         return (is_array($value)) ? $value : [];
     }
 
+    /**
+     * @deprecated
+     * @template T
+     * @param T $value
+     * @return T
+     */
     public static function from_array($value)
     {
         return $value;