fix+doc: minor fixes, add docs

Author: adhocore

src/UnderscoreBase.php

@@ -12,7 +12,7 @@ class UnderscoreBase implements \ArrayAccess, \Countable, \IteratorAggregate, \J
     /**
      * Constructor.
      *
-     * @param array|mixed $data.
+     * @param array|mixed $data Array or array like or array convertible.
      */
     public function __construct($data = [])
     {
@@ -38,11 +38,12 @@ public function get($index = null)
     /**
      * Get data as array.
      *
-     * @param mixed $data
+     * @param mixed $data Arbitrary data.
+     * @param bool  $cast Force casting to array!
      *
      * @return array
      */
-    public function asArray($data)
+    public function asArray($data, $cast = true)
     {
         if (\is_array($data)) {
             return $data;
@@ -66,7 +67,7 @@ public function asArray($data)
             return $data->toArray();
         }
 
-        return (array) $data;
+        return  $cast ? (array) $data : $data;
     }
 
     /**
@@ -76,12 +77,12 @@ public function asArray($data)
      */
     public function toArray()
     {
-        return array_map(function ($value) {
+        return \array_map(function ($value) {
             if (\is_scalar($value)) {
                 return $value;
             }
 
-            return $this->asArray($value);
+            return $this->asArray($value, false);
         }, $this->data);
     }
 
@@ -143,68 +144,97 @@ protected function valueFn($fn)
 
             $value = \array_column([$value], $fn);
 
-            return $value ? $value[0] : null;
+            return  $value ? $value[0] : null;
         };
     }
 
     /**
-     * {@inheritdoc}
+     * Checks if offset/index exists.
+     *
+     * @param string|int $index
+     *
+     * @return bool
      */
     public function offsetExists($index)
     {
         return \array_key_exists($index, $this->data);
     }
 
     /**
-     * {@inheritdoc}
+     * Gets the value at given offset/index.
+     *
+     * @return mixed
      */
     public function offsetGet($index)
     {
         return $this->data[$index];
     }
 
     /**
-     * {@inheritdoc}
+     * Sets a new value at the given offset/index.
+     *
+     * @param string|int $index
+     * @param mixed      $value
+     *
+     * @return void
      */
     public function offsetSet($index, $value)
     {
         $this->data[$index] = $value;
     }
 
     /**
-     * {@inheritdoc}
+     * Unsets/removes the value at given index.
+     *
+     * @param string|int $index
      */
     public function offsetUnset($index)
     {
         unset($this->data[$index]);
     }
 
     /**
-     * {@inheritdoc}
+     * Gets the count of items.
+     *
+     * @return int
      */
     public function count()
     {
         return \count($this->data);
     }
 
     /**
-     * {@inheritdoc}
+     * Alias of count().
+     */
+    public function size()
+    {
+        return $this->count();
+    }
+
+    /**
+     * Gets the iterator for looping.
+     *
+     * @return \ArrayIterator
      */
     public function getIterator()
     {
         return new \ArrayIterator($this->data);
     }
 
     /**
-     * {@inheritdoc}
+     * Gets the data for json serialization.
+     *
+     * @return array
      */
     public function jsonSerialize()
     {
-        return $this->data;
+        return $this->toArray();
     }
 
     /**
-     * {@inheritdoc}
+     * Stringify the underscore instance.
+     *
+     * @return string Json encoded data.
      */
     public function __toString()
     {
@@ -218,7 +248,7 @@ public function __toString()
      */
     public function now()
     {
-        return microtime(1) * 1000;
+        return \microtime(1) * 1000;
     }
 
     /**