docs: add PHPDoc

Author: kenjis

system/Helpers/Array/ArrayHelper.php

@@ -24,14 +24,21 @@ final class ArrayHelper
      *
      * @used-by dot_array_search()
      *
+     * @param string $index The index as dot array syntax.
+     *
      * @return array|bool|int|object|string|null
      */
     public static function dotSearch(string $index, array $array)
     {
         return self::arraySearchDot(self::convertToArray($index), $array);
     }
 
-    private static function convertToArray(string $index)
+    /**
+     * @param string $index The index as dot array syntax.
+     *
+     * @return list<string> The index as an array.
+     */
+    private static function convertToArray(string $index): array
     {
         // See https://regex101.com/r/44Ipql/1
         $segments = preg_split(