update some help methods

Author: inhere

src/Obj/AbstractMap.php

@@ -126,7 +126,7 @@ public function toJson(bool $filterEmpty = false): string
     /**
      * @return mixed
      */
-    public function jsonSerialize()
+    public function jsonSerialize(): array
     {
         return $this->toArray();
     }

src/Obj/Traits/StdObjectTrait.php

@@ -91,7 +91,7 @@ protected function init(): void
      *
      * @return mixed
      */
-    public function __call($method, array $args)
+    public function __call(string $method, array $args)
     {
         // if (method_exists($this, $method) && $this->isAllowCall($method) ) {
         //     return call_user_func_array( array($this, $method), (array) $args);

src/Str/Traits/StringCaseHelperTrait.php

@@ -178,24 +178,25 @@ public static function toCamel(string $str, bool $upperFirstChar = false): strin
     }
 
     /**
-     * to camel
+     * string to camel case
      *
      * @param string $name
-     * @param bool   $upperFirst
+     * @param bool   $upFirst
+     * @param string $sep eg: -_/
      *
      * @return string
      */
-    public static function camelCase(string $name, bool $upperFirst = false): string
+    public static function camelCase(string $name, bool $upFirst = false, string $sep = '-'): string
     {
-        $name = trim($name, '-_');
+        $name = trim($name, " $sep");
 
         // convert 'first-second' to 'firstSecond'
-        if (strpos($name, '-')) {
-            $name = ucwords(str_replace('-', ' ', $name));
-            $name = str_replace(' ', '', lcfirst($name));
+        if (strpos($name, $sep) > 0) {
+            $name = ucwords(str_replace($sep, ' ', $name));
+            $name = str_replace(' ', '', $name);
         }
 
-        return $upperFirst ? ucfirst($name) : $name;
+        return $upFirst ? $name : lcfirst($name);
     }
 
     /**

src/Str/UrlHelper.php

@@ -72,18 +72,22 @@ public static function isFullUrl(string $url): bool
     }
 
     /**
-     * @param string $url
-     * @param mixed  $data
+     * @param string       $baseUrl
+     * @param array|object $data
      *
      * @return string
      */
-    public static function build($url, $data = null): string
+    public static function build(string $baseUrl, $data = null): string
     {
         if ($data && ($param = http_build_query($data))) {
-            $url .= (strpos($url, '?') ? '&' : '?') . $param;
+            if ($baseUrl) {
+                $baseUrl .= (strpos($baseUrl, '?') ? '&' : '?') . $param;
+            } else {
+                $baseUrl = $param;
+            }
         }
 
-        return $url;
+        return $baseUrl;
     }
 
     /**

src/Type.php

@@ -9,14 +9,19 @@
 
 namespace Toolkit\Stdlib;
 
+use function gettype;
+
 /**
  * Class Type - php data type
  *
  * @package Toolkit\PhpKit
+ * @see     \gettype()
  */
 final class Type
 {
-    // basic types
+    // ------ basic types ------
+
+    // TIPS: not in gettype returns.
     public const INT = 'int';
 
     public const INTEGER = 'integer';
@@ -25,21 +30,51 @@ final class Type
 
     public const DOUBLE = 'double';
 
+    // TIPS: not in gettype returns.
     public const BOOL = 'bool';
 
     public const BOOLEAN = 'boolean';
 
     public const STRING = 'string';
 
-    // complex types
+    // ------ complex types ------
     public const ARRAY  = 'array';
 
     public const OBJECT = 'object';
 
     public const RESOURCE = 'resource';
 
+    // TIPS: since 7.2.0
+    public const RESOURCE_CLOSED = 'resource (closed)';
+
+    // ------ other type names ------
+
+    public const CALLABLE        = 'callable';
+
+    public const MiXED = 'mixed';
+
+    public const UNKNOWN = 'unknown type';
+
+    /**
+     * @param mixed $val
+     *
+     * @return string
+     */
+    public static function get($val): string
+    {
+        $typName = gettype($val);
+        if ($typName === self::UNKNOWN) {
+            $typName = self::MiXED;
+        } elseif ($typName === self::RESOURCE_CLOSED) {
+            $typName = self::RESOURCE;
+        }
+
+        return $typName;
+    }
+
     /**
      * @return array
+     * @see \gettype()
      */
     public static function all(): array
     {