Bump to v4.10.0.

README.md

@@ -1,10 +1,10 @@
-# lodash-es v4.7.0
+# lodash-es v4.10.0
 
-The [lodash](https://lodash.com/) library exported as [ES](http://www.ecma-international.org/ecma-262/6.0/) modules.
+The [Lodash](https://lodash.com/) library exported as [ES](http://www.ecma-international.org/ecma-262/6.0/) modules.
 
 Generated using [lodash-cli](https://www.npmjs.com/package/lodash-cli):
 ```bash
 $ lodash modularize exports=es -o ./
 ```
 
-See the [package source](https://github.com/lodash/lodash/tree/4.7.0-es) for more details.
+See the [package source](https://github.com/lodash/lodash/tree/4.10.0-es) for more details.

_Hash.js

@@ -4,7 +4,7 @@ import nativeCreate from './_nativeCreate';
 var objectProto = Object.prototype;
 
 /**
- * Creates an hash object.
+ * Creates a hash object.
  *
  * @private
  * @constructor

_apply.js

@@ -5,7 +5,7 @@
  * @private
  * @param {Function} func The function to invoke.
  * @param {*} thisArg The `this` binding of `func`.
- * @param {...*} args The arguments to invoke `func` with.
+ * @param {Array} args The arguments to invoke `func` with.
  * @returns {*} Returns the result of `func`.
  */
 function apply(func, thisArg, args) {

_baseFlatten.js

@@ -1,7 +1,5 @@
 import arrayPush from './_arrayPush';
-import isArguments from './isArguments';
+import isFlattenable from './_isFlattenable';
-import isArray from './isArray';
-import isArrayLikeObject from './isArrayLikeObject';
 
 /**
  * The base implementation of `_.flatten` with support for restricting flattening.
@@ -9,23 +7,24 @@ import isArrayLikeObject from './isArrayLikeObject';
  * @private
  * @param {Array} array The array to flatten.
  * @param {number} depth The maximum recursion depth.
- * @param {boolean} [isStrict] Restrict flattening to arrays-like objects.
+ * @param {boolean} [predicate=isFlattenable] The function invoked per iteration.
+ * @param {boolean} [isStrict] Restrict to values that pass `predicate` checks.
  * @param {Array} [result=[]] The initial result value.
  * @returns {Array} Returns the new flattened array.
  */
-function baseFlatten(array, depth, isStrict, result) {
+function baseFlatten(array, depth, predicate, isStrict, result) {
-  result || (result = []);
-
   var index = -1,
       length = array.length;
 
+  predicate || (predicate = isFlattenable);
+  result || (result = []);
+
   while (++index < length) {
     var value = array[index];
-    if (depth > 0 && isArrayLikeObject(value) &&
+    if (depth > 0 && predicate(value)) {
-        (isStrict || isArray(value) || isArguments(value))) {
       if (depth > 1) {
         // Recursively flatten arrays (susceptible to call stack limits).
-        baseFlatten(value, depth - 1, isStrict, result);
+        baseFlatten(value, depth - 1, predicate, isStrict, result);
       } else {
         arrayPush(result, value);
       }

_baseFor.js

@@ -2,7 +2,7 @@ import createBaseFor from './_createBaseFor';
 
 /**
  * The base implementation of `baseForOwn` which iterates over `object`
- * properties returned by `keysFunc` invoking `iteratee` for each property.
+ * properties returned by `keysFunc` and invokes `iteratee` for each property.
  * Iteratee functions may exit iteration early by explicitly returning `false`.
  *
  * @private

_baseGet.js

@@ -1,4 +1,4 @@
-import baseCastPath from './_baseCastPath';
+import castPath from './_castPath';
 import isKey from './_isKey';
 
 /**
@@ -10,7 +10,7 @@ import isKey from './_isKey';
  * @returns {*} Returns the resolved value.
  */
 function baseGet(object, path) {
-  path = isKey(path, object) ? [path] : baseCastPath(path);
+  path = isKey(path, object) ? [path] : castPath(path);
 
   var index = 0,
       length = path.length;

_baseInvoke.js

@@ -1,5 +1,5 @@
 import apply from './_apply';
-import baseCastPath from './_baseCastPath';
+import castPath from './_castPath';
 import isKey from './_isKey';
 import last from './last';
 import parent from './_parent';
@@ -16,7 +16,7 @@ import parent from './_parent';
  */
 function baseInvoke(object, path, args) {
   if (!isKey(path, object)) {
-    path = baseCastPath(path);
+    path = castPath(path);
     object = parent(object, path);
     path = last(path);
   }

_baseMatches.js

@@ -1,5 +1,6 @@
 import baseIsMatch from './_baseIsMatch';
 import getMatchData from './_getMatchData';
+import matchesStrictComparable from './_matchesStrictComparable';
 
 /**
  * The base implementation of `_.matches` which doesn't clone `source`.
@@ -11,16 +12,7 @@ import getMatchData from './_getMatchData';
 function baseMatches(source) {
   var matchData = getMatchData(source);
   if (matchData.length == 1 && matchData[0][2]) {
-    var key = matchData[0][0],
+    return matchesStrictComparable(matchData[0][0], matchData[0][1]);
-        value = matchData[0][1];
-
-    return function(object) {
-      if (object == null) {
-        return false;
-      }
-      return object[key] === value &&
-        (value !== undefined || (key in Object(object)));
-    };
   }
   return function(object) {
     return object === source || baseIsMatch(object, source, matchData);

_baseMatchesProperty.js

@@ -1,6 +1,9 @@
 import baseIsEqual from './_baseIsEqual';
 import get from './get';
 import hasIn from './hasIn';
+import isKey from './_isKey';
+import isStrictComparable from './_isStrictComparable';
+import matchesStrictComparable from './_matchesStrictComparable';
 
 /** Used to compose bitmasks for comparison styles. */
 var UNORDERED_COMPARE_FLAG = 1,
@@ -15,6 +18,9 @@ var UNORDERED_COMPARE_FLAG = 1,
  * @returns {Function} Returns the new function.
  */
 function baseMatchesProperty(path, srcValue) {
+  if (isKey(path) && isStrictComparable(srcValue)) {
+    return matchesStrictComparable(path, srcValue);
+  }
   return function(object) {
     var objValue = get(object, path);
     return (objValue === undefined && objValue === srcValue)

_basePullAt.js

@@ -1,4 +1,4 @@
-import baseCastPath from './_baseCastPath';
+import castPath from './_castPath';
 import isIndex from './_isIndex';
 import isKey from './_isKey';
 import last from './last';
@@ -31,7 +31,7 @@ function basePullAt(array, indexes) {
         splice.call(array, index, 1);
       }
       else if (!isKey(index, array)) {
-        var path = baseCastPath(index),
+        var path = castPath(index),
             object = parent(array, path);
 
         if (object != null) {

_baseSet.js

@@ -1,5 +1,5 @@
 import assignValue from './_assignValue';
-import baseCastPath from './_baseCastPath';
+import castPath from './_castPath';
 import isIndex from './_isIndex';
 import isKey from './_isKey';
 import isObject from './isObject';
@@ -15,7 +15,7 @@ import isObject from './isObject';
  * @returns {Object} Returns `object`.
  */
 function baseSet(object, path, value, customizer) {
-  path = isKey(path, object) ? [path] : baseCastPath(path);
+  path = isKey(path, object) ? [path] : castPath(path);
 
   var index = -1,
       length = path.length,

_baseUnset.js

@@ -1,4 +1,4 @@
-import baseCastPath from './_baseCastPath';
+import castPath from './_castPath';
 import has from './has';
 import isKey from './_isKey';
 import last from './last';
@@ -13,7 +13,7 @@ import parent from './_parent';
  * @returns {boolean} Returns `true` if the property is deleted, else `false`.
  */
 function baseUnset(object, path) {
-  path = isKey(path, object) ? [path] : baseCastPath(path);
+  path = isKey(path, object) ? [path] : castPath(path);
   object = parent(object, path);
   var key = last(path);
   return (object != null && has(object, key)) ? delete object[key] : true;

_castArrayLikeObject.js

@@ -7,8 +7,8 @@ import isArrayLikeObject from './isArrayLikeObject';
  * @param {*} value The value to inspect.
  * @returns {Array|Object} Returns the cast array-like object.
  */
-function baseCastArrayLikeObject(value) {
+function castArrayLikeObject(value) {
   return isArrayLikeObject(value) ? value : [];
 }
 
-export default baseCastArrayLikeObject;
+export default castArrayLikeObject;

_castFunction.js

@@ -7,8 +7,8 @@ import identity from './identity';
  * @param {*} value The value to inspect.
  * @returns {Function} Returns cast function.
  */
-function baseCastFunction(value) {
+function castFunction(value) {
   return typeof value == 'function' ? value : identity;
 }
 
-export default baseCastFunction;
+export default castFunction;

_castPath.js

@@ -8,8 +8,8 @@ import stringToPath from './_stringToPath';
  * @param {*} value The value to inspect.
  * @returns {Array} Returns the cast property path array.
  */
-function baseCastPath(value) {
+function castPath(value) {
   return isArray(value) ? value : stringToPath(value);
 }
 
-export default baseCastPath;
+export default castPath;

_castSlice.js

@@ -0,0 +1,18 @@
+import baseSlice from './_baseSlice';
+
+/**
+ * Casts `array` to a slice if it's needed.
+ *
+ * @private
+ * @param {Array} array The array to inspect.
+ * @param {number} start The start position.
+ * @param {number} [end=array.length] The end position.
+ * @returns {Array} Returns the cast slice.
+ */
+function castSlice(array, start, end) {
+  var length = array.length;
+  end = end === undefined ? length : end;
+  return (!start && end >= length) ? array : baseSlice(array, start, end);
+}
+
+export default castSlice;

_createCaseFirst.js

@@ -1,18 +1,8 @@
+import castSlice from './_castSlice';
+import reHasComplexSymbol from './_reHasComplexSymbol';
 import stringToArray from './_stringToArray';
 import toString from './toString';
 
-/** Used to compose unicode character classes. */
-var rsAstralRange = '\\ud800-\\udfff',
-    rsComboMarksRange = '\\u0300-\\u036f\\ufe20-\\ufe23',
-    rsComboSymbolsRange = '\\u20d0-\\u20f0',
-    rsVarRange = '\\ufe0e\\ufe0f';
-
-/** Used to compose unicode capture groups. */
-var rsZWJ = '\\u200d';
-
-/** Used to detect strings with [zero-width joiners or code points from the astral planes](http://eev.ee/blog/2015/09/12/dark-corners-of-unicode/). */
-var reHasComplexSymbol = RegExp('[' + rsZWJ + rsAstralRange  + rsComboMarksRange + rsComboSymbolsRange + rsVarRange + ']');
-
 /**
  * Creates a function like `_.lowerFirst`.
  *
@@ -28,8 +18,13 @@ function createCaseFirst(methodName) {
       ? stringToArray(string)
       : undefined;
 
-    var chr = strSymbols ? strSymbols[0] : string.charAt(0),
+    var chr = strSymbols
-        trailing = strSymbols ? strSymbols.slice(1).join('') : string.slice(1);
+      ? strSymbols[0]
+      : string.charAt(0);
+
+    var trailing = strSymbols
+      ? castSlice(strSymbols, 1).join('')
+      : string.slice(1);
 
     return chr[methodName]() + trailing;
   };

_createCtorWrapper.js

@@ -11,8 +11,8 @@ import isObject from './isObject';
  */
 function createCtorWrapper(Ctor) {
   return function() {
-    // Use a `switch` statement to work with class constructors.
+    // Use a `switch` statement to work with class constructors. See
-    // See http://ecma-international.org/ecma-262/6.0/#sec-ecmascript-function-objects-call-thisargument-argumentslist
+    // http://ecma-international.org/ecma-262/6.0/#sec-ecmascript-function-objects-call-thisargument-argumentslist
     // for more details.
     var args = arguments;
     switch (args.length) {

_createOver.js

@@ -2,6 +2,7 @@ import apply from './_apply';
 import arrayMap from './_arrayMap';
 import baseFlatten from './_baseFlatten';
 import baseIteratee from './_baseIteratee';
+import isFlattenableIteratee from './_isFlattenableIteratee';
 import rest from './rest';
 
 /**
@@ -13,7 +14,7 @@ import rest from './rest';
  */
 function createOver(arrayFunc) {
   return rest(function(iteratees) {
-    iteratees = arrayMap(baseFlatten(iteratees, 1), baseIteratee);
+    iteratees = arrayMap(baseFlatten(iteratees, 1, isFlattenableIteratee), baseIteratee);
     return rest(function(args) {
       var thisArg = this;
       return arrayFunc(iteratees, function(iteratee) {

_createPadding.js

@@ -1,19 +1,9 @@
 import baseRepeat from './_baseRepeat';
+import castSlice from './_castSlice';
+import reHasComplexSymbol from './_reHasComplexSymbol';
 import stringSize from './_stringSize';
 import stringToArray from './_stringToArray';
 
-/** Used to compose unicode character classes. */
-var rsAstralRange = '\\ud800-\\udfff',
-    rsComboMarksRange = '\\u0300-\\u036f\\ufe20-\\ufe23',
-    rsComboSymbolsRange = '\\u20d0-\\u20f0',
-    rsVarRange = '\\ufe0e\\ufe0f';
-
-/** Used to compose unicode capture groups. */
-var rsZWJ = '\\u200d';
-
-/** Used to detect strings with [zero-width joiners or code points from the astral planes](http://eev.ee/blog/2015/09/12/dark-corners-of-unicode/). */
-var reHasComplexSymbol = RegExp('[' + rsZWJ + rsAstralRange  + rsComboMarksRange + rsComboSymbolsRange + rsVarRange + ']');
-
 /* Built-in method references for those with the same name as other `lodash` methods. */
 var nativeCeil = Math.ceil;
 
@@ -35,7 +25,7 @@ function createPadding(length, chars) {
   }
   var result = baseRepeat(chars, nativeCeil(length / stringSize(chars)));
   return reHasComplexSymbol.test(chars)
-    ? stringToArray(result).slice(0, length).join('')
+    ? castSlice(stringToArray(result), 0, length).join('')
     : result.slice(0, length);
 }
 

_createPartialWrapper.js

@@ -6,9 +6,8 @@ import root from './_root';
 var BIND_FLAG = 1;
 
 /**
- * Creates a function that wraps `func` to invoke it with the optional `this`
+ * Creates a function that wraps `func` to invoke it with the `this` binding
- * binding of `thisArg` and the `partials` prepended to those provided to
+ * of `thisArg` and `partials` prepended to the arguments it receives.
- * the wrapper.
  *
  * @private
  * @param {Function} func The function to wrap.

_equalByTag.js

@@ -78,7 +78,8 @@ function equalByTag(object, other, tag, equalFunc, customizer, bitmask, stack) {
     case regexpTag:
     case stringTag:
       // Coerce regexes to strings and treat strings, primitives and objects,
-      // as equal. See https://es5.github.io/#x15.10.6.4 for more details.
+      // as equal. See http://www.ecma-international.org/ecma-262/6.0/#sec-regexp.prototype.tostring
+      // for more details.
       return object == (other + '');
 
     case mapTag:

_getTag.js

@@ -3,6 +3,7 @@ import Map from './_Map';
 import Promise from './_Promise';
 import Set from './_Set';
 import WeakMap from './_WeakMap';
+import toSource from './_toSource';
 
 /** `Object#toString` result references. */
 var mapTag = '[object Map]',
@@ -16,21 +17,19 @@ var dataViewTag = '[object DataView]';
 /** Used for built-in method references. */
 var objectProto = Object.prototype;
 
-/** Used to resolve the decompiled source of functions. */
-var funcToString = Function.prototype.toString;
-
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;
 
 /** Used to detect maps, sets, and weakmaps. */
-var dataViewCtorString = DataView ? (DataView + '') : '',
+var dataViewCtorString = toSource(DataView),
-    mapCtorString = Map ? funcToString.call(Map) : '',
+    mapCtorString = toSource(Map),
-    promiseCtorString = Promise ? funcToString.call(Promise) : '',
+    promiseCtorString = toSource(Promise),
-    setCtorString = Set ? funcToString.call(Set) : '',
+    setCtorString = toSource(Set),
-    weakMapCtorString = WeakMap ? funcToString.call(WeakMap) : '';
+    weakMapCtorString = toSource(WeakMap);
 
 /**
  * Gets the `toStringTag` of `value`.
@@ -52,8 +51,8 @@ if ((DataView && getTag(new DataView(new ArrayBuffer(1))) != dataViewTag) ||
     (WeakMap && getTag(new WeakMap) != weakMapTag)) {
   getTag = function(value) {
     var result = objectToString.call(value),
-        Ctor = result == objectTag ? value.constructor : null,
+        Ctor = result == objectTag ? value.constructor : undefined,
-        ctorString = typeof Ctor == 'function' ? funcToString.call(Ctor) : '';
+        ctorString = Ctor ? toSource(Ctor) : undefined;
 
     if (ctorString) {
       switch (ctorString) {

_hasPath.js

@@ -1,4 +1,4 @@
-import baseCastPath from './_baseCastPath';
+import castPath from './_castPath';
 import isArguments from './isArguments';
 import isArray from './isArray';
 import isIndex from './_isIndex';
@@ -16,29 +16,25 @@ import isString from './isString';
  * @returns {boolean} Returns `true` if `path` exists, else `false`.
  */
 function hasPath(object, path, hasFunc) {
-  if (object == null) {
+  path = isKey(path, object) ? [path] : castPath(path);
-    return false;
-  }
-  var result = hasFunc(object, path);
-  if (!result && !isKey(path)) {
-    path = baseCastPath(path);
 
-    var index = -1,
+  var result,
-        length = path.length;
+      index = -1,
+      length = path.length;
 
-    while (object != null && ++index < length) {
+  while (++index < length) {
-      var key = path[index];
+    var key = path[index];
-      if (!(result = hasFunc(object, key))) {
+    if (!(result = object != null && hasFunc(object, key))) {
-        break;
+      break;
-      }
-      object = object[key];
     }
+    object = object[key];
   }
-  var length = object ? object.length : undefined;
+  if (result) {
-  return result || (
+    return result;
-    !!length && isLength(length) && isIndex(path, length) &&
+  }
-    (isArray(object) || isString(object) || isArguments(object))
+  var length = object ? object.length : 0;
-  );
+  return !!length && isLength(length) && isIndex(key, length) &&
+    (isArray(object) || isString(object) || isArguments(object));
 }
 
 export default hasPath;

_isFlattenable.js

@@ -0,0 +1,16 @@
+import isArguments from './isArguments';
+import isArray from './isArray';
+import isArrayLikeObject from './isArrayLikeObject';
+
+/**
+ * Checks if `value` is a flattenable `arguments` object or array.
+ *
+ * @private
+ * @param {*} value The value to check.
+ * @returns {boolean} Returns `true` if `value` is flattenable, else `false`.
+ */
+function isFlattenable(value) {
+  return isArrayLikeObject(value) && (isArray(value) || isArguments(value));
+}
+
+export default isFlattenable;

_isFlattenableIteratee.js

@@ -0,0 +1,16 @@
+import isArray from './isArray';
+import isFunction from './isFunction';
+
+/**
+ * Checks if `value` is a flattenable array and not a `_.matchesProperty`
+ * iteratee shorthand.
+ *
+ * @private
+ * @param {*} value The value to check.
+ * @returns {boolean} Returns `true` if `value` is flattenable, else `false`.
+ */
+function isFlattenableIteratee(value) {
+  return isArray(value) && !(value.length == 2 && !isFunction(value[0]));
+}
+
+export default isFlattenableIteratee;

_matchesStrictComparable.js

@@ -0,0 +1,20 @@
+/**
+ * A specialized version of `matchesProperty` for source values suitable
+ * for strict equality comparisons, i.e. `===`.
+ *
+ * @private
+ * @param {string} key The key of the property to get.
+ * @param {*} srcValue The value to match.
+ * @returns {Function} Returns the new function.
+ */
+function matchesStrictComparable(key, srcValue) {
+  return function(object) {
+    if (object == null) {
+      return false;
+    }
+    return object[key] === srcValue &&
+      (srcValue !== undefined || (key in Object(object)));
+  };
+}
+
+export default matchesStrictComparable;

_reHasComplexSymbol.js

@@ -0,0 +1,13 @@
+/** Used to compose unicode character classes. */
+var rsAstralRange = '\\ud800-\\udfff',
+    rsComboMarksRange = '\\u0300-\\u036f\\ufe20-\\ufe23',
+    rsComboSymbolsRange = '\\u20d0-\\u20f0',
+    rsVarRange = '\\ufe0e\\ufe0f';
+
+/** Used to compose unicode capture groups. */
+var rsZWJ = '\\u200d';
+
+/** Used to detect strings with [zero-width joiners or code points from the astral planes](http://eev.ee/blog/2015/09/12/dark-corners-of-unicode/). */
+var reHasComplexSymbol = RegExp('[' + rsZWJ + rsAstralRange  + rsComboMarksRange + rsComboSymbolsRange + rsVarRange + ']');
+
+export default reHasComplexSymbol;

_stringSize.js

@@ -1,3 +1,5 @@
+import reHasComplexSymbol from './_reHasComplexSymbol';
+
 /** Used to compose unicode character classes. */
 var rsAstralRange = '\\ud800-\\udfff',
     rsComboMarksRange = '\\u0300-\\u036f\\ufe20-\\ufe23',
@@ -24,9 +26,6 @@ var reOptMod = rsModifier + '?',
 /** Used to match [string symbols](https://mathiasbynens.be/notes/javascript-unicode). */
 var reComplexSymbol = RegExp(rsFitz + '(?=' + rsFitz + ')|' + rsSymbol + rsSeq, 'g');
 
-/** Used to detect strings with [zero-width joiners or code points from the astral planes](http://eev.ee/blog/2015/09/12/dark-corners-of-unicode/). */
-var reHasComplexSymbol = RegExp('[' + rsZWJ + rsAstralRange  + rsComboMarksRange + rsComboSymbolsRange + rsVarRange + ']');
-
 /**
  * Gets the number of symbols in `string`.
  *

_toKey.js

@@ -1,14 +1,14 @@
 import isSymbol from './isSymbol';
 
 /**
- * Casts `value` to a string if it's not a string or symbol.
+ * Converts `value` to a string key if it's not a string or symbol.
  *
  * @private
  * @param {*} value The value to inspect.
- * @returns {string|symbol} Returns the cast key.
+ * @returns {string|symbol} Returns the key.
  */
-function baseCastKey(key) {
+function toKey(key) {
   return (typeof key == 'string' || isSymbol(key)) ? key : (key + '');
 }
 
-export default baseCastKey;
+export default toKey;

_toSource.js

@@ -0,0 +1,23 @@
+/** Used to resolve the decompiled source of functions. */
+var funcToString = Function.prototype.toString;
+
+/**
+ * Converts `func` to its source code.
+ *
+ * @private
+ * @param {Function} func The function to process.
+ * @returns {string} Returns the source code.
+ */
+function toSource(func) {
+  if (func != null) {
+    try {
+      return funcToString.call(func);
+    } catch (e) {}
+    try {
+      return (func + '');
+    } catch (e) {}
+  }
+  return '';
+}
+
+export default toSource;

ary.js

@@ -4,8 +4,8 @@ import createWrapper from './_createWrapper';
 var ARY_FLAG = 128;
 
 /**
- * Creates a function that accepts up to `n` arguments, ignoring any
+ * Creates a function that invokes `func`, with up to `n` arguments,
- * additional arguments.
+ * ignoring any additional arguments.
  *
  * @static
  * @memberOf _

assignInWith.js

@@ -5,7 +5,7 @@ import keysIn from './keysIn';
 /**
  * This method is like `_.assignIn` except that it accepts `customizer`
  * which is invoked to produce the assigned values. If `customizer` returns
- * `undefined` assignment is handled by the method instead. The `customizer`
+ * `undefined`, assignment is handled by the method instead. The `customizer`
  * is invoked with five arguments: (objValue, srcValue, key, object, source).
  *
  * **Note:** This method mutates `object`.

assignWith.js

@@ -5,7 +5,7 @@ import keys from './keys';
 /**
  * This method is like `_.assign` except that it accepts `customizer`
  * which is invoked to produce the assigned values. If `customizer` returns
- * `undefined` assignment is handled by the method instead. The `customizer`
+ * `undefined`, assignment is handled by the method instead. The `customizer`
  * is invoked with five arguments: (objValue, srcValue, key, object, source).
  *
  * **Note:** This method mutates `object`.

at.js

@@ -10,8 +10,7 @@ import rest from './rest';
  * @since 1.0.0
  * @category Object
  * @param {Object} object The object to iterate over.
- * @param {...(string|string[])} [paths] The property paths of elements to pick,
+ * @param {...(string|string[])} [paths] The property paths of elements to pick.
- *  specified individually or in arrays.
  * @returns {Array} Returns the new array of picked elements.
  * @example
  *

bind.js

@@ -9,8 +9,7 @@ var BIND_FLAG = 1,
 
 /**
  * Creates a function that invokes `func` with the `this` binding of `thisArg`
- * and prepends any additional `_.bind` arguments to those provided to the
+ * and `partials` prepended to the arguments it receives.
- * bound function.
  *
  * The `_.bind.placeholder` value, which defaults to `_` in monolithic builds,
  * may be used as a placeholder for partially applied arguments.

bindAll.js

@@ -14,8 +14,7 @@ import rest from './rest';
  * @memberOf _
  * @category Util
  * @param {Object} object The object to bind and assign the bound methods to.
- * @param {...(string|string[])} methodNames The object method names to bind,
+ * @param {...(string|string[])} methodNames The object method names to bind.
- *  specified individually or in arrays.
  * @returns {Object} Returns `object`.
  * @example
  *

bindKey.js

@@ -9,8 +9,8 @@ var BIND_FLAG = 1,
     PARTIAL_FLAG = 32;
 
 /**
- * Creates a function that invokes the method at `object[key]` and prepends
+ * Creates a function that invokes the method at `object[key]` with `partials`
- * any additional `_.bindKey` arguments to those provided to the bound function.
+ * prepended to the arguments it receives.
  *
  * This method differs from `_.bind` by allowing bound functions to reference
  * methods that may be redefined or don't yet exist. See

chunk.js

@@ -1,4 +1,5 @@
 import baseSlice from './_baseSlice';
+import isIterateeCall from './_isIterateeCall';
 import toInteger from './toInteger';
 
 /* Built-in method references for those with the same name as other `lodash` methods. */
@@ -15,7 +16,8 @@ var nativeCeil = Math.ceil,
  * @since 3.0.0
  * @category Array
  * @param {Array} array The array to process.
- * @param {number} [size=0] The length of each chunk.
+ * @param {number} [size=1] The length of each chunk
+ * @param- {Object} [guard] Enables use as an iteratee for methods like `_.map`.
  * @returns {Array} Returns the new array containing chunks.
  * @example
  *
@@ -25,9 +27,12 @@ var nativeCeil = Math.ceil,
  * _.chunk(['a', 'b', 'c', 'd'], 3);
  * // => [['a', 'b', 'c'], ['d']]
  */
-function chunk(array, size) {
+function chunk(array, size, guard) {
-  size = nativeMax(toInteger(size), 0);
+  if ((guard ? isIterateeCall(array, size, guard) : size === undefined)) {
-
+    size = 1;
+  } else {
+    size = nativeMax(toInteger(size), 0);
+  }
   var length = array ? array.length : 0;
   if (!length || size < 1) {
     return [];

cloneWith.js

@@ -2,7 +2,7 @@ import baseClone from './_baseClone';
 
 /**
  * This method is like `_.clone` except that it accepts `customizer` which
- * is invoked to produce the cloned value. If `customizer` returns `undefined`
+ * is invoked to produce the cloned value. If `customizer` returns `undefined`,
  * cloning is handled by the method instead. The `customizer` is invoked with
  * up to four arguments; (value [, index|key, object, stack]).
  *

cond.js

@@ -7,7 +7,7 @@ import rest from './rest';
 var FUNC_ERROR_TEXT = 'Expected a function';
 
 /**
- * Creates a function that iterates over `pairs` invoking the corresponding
+ * Creates a function that iterates over `pairs` and invokes the corresponding
  * function of the first predicate to return truthy. The predicate-function
  * pairs are invoked with the `this` binding and arguments of the created
  * function.

countBy.js

@@ -8,9 +8,9 @@ var hasOwnProperty = objectProto.hasOwnProperty;
 
 /**
  * Creates an object composed of keys generated from the results of running
- * each element of `collection` through `iteratee`. The corresponding value
+ * each element of `collection` thru `iteratee`. The corresponding value of
- * of each key is the number of times the key was returned by `iteratee`.
+ * each key is the number of times the key was returned by `iteratee`. The
- * The iteratee is invoked with one argument: (value).
+ * iteratee is invoked with one argument: (value).
  *
  * @static
  * @memberOf _

create.js

@@ -3,7 +3,7 @@ import baseCreate from './_baseCreate';
 
 /**
  * Creates an object that inherits from the `prototype` object. If a
- * `properties` object is given its own enumerable string keyed properties
+ * `properties` object is given, its own enumerable string keyed properties
  * are assigned to the created object.
  *
  * @static

debounce.js

@@ -23,7 +23,7 @@ var nativeMax = Math.max,
  * on the trailing edge of the timeout only if the debounced function is
  * invoked more than once during the `wait` timeout.
  *
- * See [David Corbacho's article](http://drupalmotion.com/article/debounce-and-throttle-visual-explanation)
+ * See [David Corbacho's article](https://css-tricks.com/debouncing-throttling-explained-examples/)
  * for details over the differences between `_.debounce` and `_.throttle`.
  *
  * @static
@@ -169,6 +169,9 @@ function debounce(func, wait, options) {
       timerId = setTimeout(timerExpired, wait);
       return invokeFunc(lastCallTime);
     }
+    if (timerId === undefined) {
+      timerId = setTimeout(timerExpired, wait);
+    }
     return result;
   }
   debounced.cancel = cancel;

difference.js

@@ -23,7 +23,7 @@ import rest from './rest';
  */
 var difference = rest(function(array, values) {
   return isArrayLikeObject(array)
-    ? baseDifference(array, baseFlatten(values, 1, true))
+    ? baseDifference(array, baseFlatten(values, 1, isArrayLikeObject, true))
     : [];
 });
 

differenceBy.js

@@ -35,7 +35,7 @@ var differenceBy = rest(function(array, values) {
     iteratee = undefined;
   }
   return isArrayLikeObject(array)
-    ? baseDifference(array, baseFlatten(values, 1, true), baseIteratee(iteratee))
+    ? baseDifference(array, baseFlatten(values, 1, isArrayLikeObject, true), baseIteratee(iteratee))
     : [];
 });
 

differenceWith.js

@@ -31,7 +31,7 @@ var differenceWith = rest(function(array, values) {
     comparator = undefined;
   }
   return isArrayLikeObject(array)
-    ? baseDifference(array, baseFlatten(values, 1, true), undefined, comparator)
+    ? baseDifference(array, baseFlatten(values, 1, isArrayLikeObject, true), undefined, comparator)
     : [];
 });
 

escapeRegExp.js

@@ -1,6 +1,9 @@
 import toString from './toString';
 
-/** Used to match `RegExp` [syntax characters](http://ecma-international.org/ecma-262/6.0/#sec-patterns). */
+/**
+ * Used to match `RegExp`
+ * [syntax characters](http://ecma-international.org/ecma-262/6.0/#sec-patterns).
+ */
 var reRegExpChar = /[\\^$.*+?()[\]{}|]/g,
     reHasRegExpChar = RegExp(reRegExpChar.source);
 

flatMap.js

@@ -3,8 +3,8 @@ import map from './map';
 
 /**
  * Creates a flattened array of values by running each element in `collection`
- * through `iteratee` and flattening the mapped results. The iteratee is
+ * thru `iteratee` and flattening the mapped results. The iteratee is invoked
- * invoked with three arguments: (value, index|key, collection).
+ * with three arguments: (value, index|key, collection).
  *
  * @static
  * @memberOf _

forEach.js

@@ -4,7 +4,7 @@ import baseIteratee from './_baseIteratee';
 import isArray from './isArray';
 
 /**
- * Iterates over elements of `collection` invoking `iteratee` for each element.
+ * Iterates over elements of `collection` and invokes `iteratee` for each element.
  * The iteratee is invoked with three arguments: (value, index|key, collection).
  * Iteratee functions may exit iteration early by explicitly returning `false`.
  *

forIn.js

@@ -4,9 +4,9 @@ import keysIn from './keysIn';
 
 /**
  * Iterates over own and inherited enumerable string keyed properties of an
- * object invoking `iteratee` for each property. The iteratee is invoked with
+ * object and invokes `iteratee` for each property. The iteratee is invoked
- * three arguments: (value, key, object). Iteratee functions may exit iteration
+ * with three arguments: (value, key, object). Iteratee functions may exit
- * early by explicitly returning `false`.
+ * iteration early by explicitly returning `false`.
  *
  * @static
  * @memberOf _

forOwn.js

@@ -2,10 +2,10 @@ import baseForOwn from './_baseForOwn';
 import baseIteratee from './_baseIteratee';
 
 /**
- * Iterates over own enumerable string keyed properties of an object invoking
+ * Iterates over own enumerable string keyed properties of an object and
- * `iteratee` for each property. The iteratee is invoked with three arguments:
+ * invokes `iteratee` for each property. The iteratee is invoked with three
- * (value, key, object). Iteratee functions may exit iteration early by
+ * arguments: (value, key, object). Iteratee functions may exit iteration
- * explicitly returning `false`.
+ * early by explicitly returning `false`.
  *
  * @static
  * @memberOf _

get.js

@@ -2,7 +2,7 @@ import baseGet from './_baseGet';
 
 /**
  * Gets the value at `path` of `object`. If the resolved value is
- * `undefined` the `defaultValue` is used in its place.
+ * `undefined`, the `defaultValue` is used in its place.
  *
  * @static
  * @memberOf _

groupBy.js

@@ -8,9 +8,10 @@ var hasOwnProperty = objectProto.hasOwnProperty;
 
 /**
  * Creates an object composed of keys generated from the results of running
- * each element of `collection` through `iteratee`. The corresponding value
+ * each element of `collection` thru `iteratee`. The order of grouped values
- * of each key is an array of elements responsible for generating the key.
+ * is determined by the order they occur in `collection`. The corresponding
- * The iteratee is invoked with one argument: (value).
+ * value of each key is an array of elements responsible for generating the
+ * key. The iteratee is invoked with one argument: (value).
  *
  * @static
  * @memberOf _

has.js

@@ -13,23 +13,23 @@ import hasPath from './_hasPath';
  * @returns {boolean} Returns `true` if `path` exists, else `false`.
  * @example
  *
- * var object = { 'a': { 'b': { 'c': 3 } } };
+ * var object = { 'a': { 'b': 2 } };
- * var other = _.create({ 'a': _.create({ 'b': _.create({ 'c': 3 }) }) });
+ * var other = _.create({ 'a': _.create({ 'b': 2 }) });
  *
  * _.has(object, 'a');
  * // => true
  *
- * _.has(object, 'a.b.c');
+ * _.has(object, 'a.b');
  * // => true
  *
- * _.has(object, ['a', 'b', 'c']);
+ * _.has(object, ['a', 'b']);
  * // => true
  *
  * _.has(other, 'a');
  * // => false
  */
 function has(object, path) {
-  return hasPath(object, path, baseHas);
+  return object != null && hasPath(object, path, baseHas);
 }
 
 export default has;

hasIn.js

@@ -13,22 +13,22 @@ import hasPath from './_hasPath';
  * @returns {boolean} Returns `true` if `path` exists, else `false`.
  * @example
  *
- * var object = _.create({ 'a': _.create({ 'b': _.create({ 'c': 3 }) }) });
+ * var object = _.create({ 'a': _.create({ 'b': 2 }) });
  *
  * _.hasIn(object, 'a');
  * // => true
  *
- * _.hasIn(object, 'a.b.c');
+ * _.hasIn(object, 'a.b');
  * // => true
  *
- * _.hasIn(object, ['a', 'b', 'c']);
+ * _.hasIn(object, ['a', 'b']);
  * // => true
  *
  * _.hasIn(object, 'b');
  * // => false
  */
 function hasIn(object, path) {
-  return hasPath(object, path, baseHasIn);
+  return object != null && hasPath(object, path, baseHasIn);
 }
 
 export default hasIn;

inRange.js

@@ -3,7 +3,7 @@ import toNumber from './toNumber';
 
 /**
  * Checks if `n` is between `start` and up to but not including, `end`. If
- * `end` is not specified it's set to `start` with `start` then set to `0`.
+ * `end` is not specified, it's set to `start` with `start` then set to `0`.
  * If `start` is greater than `end` the params are swapped to support
  * negative ranges.
  *

includes.js

@@ -8,7 +8,7 @@ import values from './values';
 var nativeMax = Math.max;
 
 /**
- * Checks if `value` is in `collection`. If `collection` is a string it's
+ * Checks if `value` is in `collection`. If `collection` is a string, it's
  * checked for a substring of `value`, otherwise
  * [`SameValueZero`](http://ecma-international.org/ecma-262/6.0/#sec-samevaluezero)
  * is used for equality comparisons. If `fromIndex` is negative, it's used as

indexOf.js

@@ -7,8 +7,8 @@ var nativeMax = Math.max;
 /**
  * Gets the index at which the first occurrence of `value` is found in `array`
  * using [`SameValueZero`](http://ecma-international.org/ecma-262/6.0/#sec-samevaluezero)
- * for equality comparisons. If `fromIndex` is negative, it's used as the offset
+ * for equality comparisons. If `fromIndex` is negative, it's used as the
- * from the end of `array`.
+ * offset from the end of `array`.
  *
  * @static
  * @memberOf _

intersection.js

@@ -1,6 +1,6 @@
 import arrayMap from './_arrayMap';
-import baseCastArrayLikeObject from './_baseCastArrayLikeObject';
 import baseIntersection from './_baseIntersection';
+import castArrayLikeObject from './_castArrayLikeObject';
 import rest from './rest';
 
 /**
@@ -21,7 +21,7 @@ import rest from './rest';
  * // => [2]
  */
 var intersection = rest(function(arrays) {
-  var mapped = arrayMap(arrays, baseCastArrayLikeObject);
+  var mapped = arrayMap(arrays, castArrayLikeObject);
   return (mapped.length && mapped[0] === arrays[0])
     ? baseIntersection(mapped)
     : [];

intersectionBy.js

@@ -1,7 +1,7 @@
 import arrayMap from './_arrayMap';
-import baseCastArrayLikeObject from './_baseCastArrayLikeObject';
 import baseIntersection from './_baseIntersection';
 import baseIteratee from './_baseIteratee';
+import castArrayLikeObject from './_castArrayLikeObject';
 import last from './last';
 import rest from './rest';
 
@@ -30,7 +30,7 @@ import rest from './rest';
  */
 var intersectionBy = rest(function(arrays) {
   var iteratee = last(arrays),
-      mapped = arrayMap(arrays, baseCastArrayLikeObject);
+      mapped = arrayMap(arrays, castArrayLikeObject);
 
   if (iteratee === last(mapped)) {
     iteratee = undefined;

intersectionWith.js

@@ -1,6 +1,6 @@
 import arrayMap from './_arrayMap';
-import baseCastArrayLikeObject from './_baseCastArrayLikeObject';
 import baseIntersection from './_baseIntersection';
+import castArrayLikeObject from './_castArrayLikeObject';
 import last from './last';
 import rest from './rest';
 
@@ -27,7 +27,7 @@ import rest from './rest';
  */
 var intersectionWith = rest(function(arrays) {
   var comparator = last(arrays),
-      mapped = arrayMap(arrays, baseCastArrayLikeObject);
+      mapped = arrayMap(arrays, castArrayLikeObject);
 
   if (comparator === last(mapped)) {
     comparator = undefined;

invertBy.js

@@ -9,8 +9,8 @@ var hasOwnProperty = objectProto.hasOwnProperty;
 
 /**
  * This method is like `_.invert` except that the inverted object is generated
- * from the results of running each element of `object` through `iteratee`.
+ * from the results of running each element of `object` thru `iteratee`. The
- * The corresponding inverted value of each inverted key is an array of keys
+ * corresponding inverted value of each inverted key is an array of keys
  * responsible for generating the inverted value. The iteratee is invoked
  * with one argument: (value).
  *

invokeMap.js

@@ -8,8 +8,8 @@ import rest from './rest';
 /**
  * Invokes the method at `path` of each element in `collection`, returning
  * an array of the results of each invoked method. Any additional arguments
- * are provided to each invoked method. If `methodName` is a function it's
+ * are provided to each invoked method. If `methodName` is a function, it's
- * invoked for, and `this` bound to, each element in `collection`.
+ * invoked for and `this` bound to, each element in `collection`.
  *
  * @static
  * @memberOf _

isArguments.js

@@ -10,7 +10,8 @@ var objectProto = Object.prototype;
 var hasOwnProperty = objectProto.hasOwnProperty;
 
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;

isArrayBuffer.js

@@ -6,7 +6,8 @@ var arrayBufferTag = '[object ArrayBuffer]';
 var objectProto = Object.prototype;
 
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;

isBoolean.js

@@ -7,7 +7,8 @@ var boolTag = '[object Boolean]';
 var objectProto = Object.prototype;
 
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;

isDate.js

@@ -7,7 +7,8 @@ var dateTag = '[object Date]';
 var objectProto = Object.prototype;
 
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;

isEqualWith.js

@@ -2,7 +2,7 @@ import baseIsEqual from './_baseIsEqual';
 
 /**
  * This method is like `_.isEqual` except that it accepts `customizer` which
- * is invoked to compare values. If `customizer` returns `undefined` comparisons
+ * is invoked to compare values. If `customizer` returns `undefined`, comparisons
  * are handled by the method instead. The `customizer` is invoked with up to
  * six arguments: (objValue, othValue [, index|key, object, other, stack]).
  *

isError.js

@@ -7,7 +7,8 @@ var errorTag = '[object Error]';
 var objectProto = Object.prototype;
 
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;

isFunction.js

@@ -8,7 +8,8 @@ var funcTag = '[object Function]',
 var objectProto = Object.prototype;
 
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;

isMatchWith.js

@@ -3,7 +3,7 @@ import getMatchData from './_getMatchData';
 
 /**
  * This method is like `_.isMatch` except that it accepts `customizer` which
- * is invoked to compare values. If `customizer` returns `undefined` comparisons
+ * is invoked to compare values. If `customizer` returns `undefined`, comparisons
  * are handled by the method instead. The `customizer` is invoked with five
  * arguments: (objValue, srcValue, index|key, object, source).
  *

isNaN.js

@@ -3,9 +3,10 @@ import isNumber from './isNumber';
 /**
  * Checks if `value` is `NaN`.
  *
- * **Note:** This method is not the same as
+ * **Note:** This method is based on
- * [`isNaN`](https://es5.github.io/#x15.1.2.4) which returns `true` for
+ * [`Number.isNaN`](https://mdn.io/Number/isNaN) and is not the same as
- * `undefined` and other non-numeric values.
+ * global [`isNaN`](https://mdn.io/isNaN) which returns `true` for
+ * `undefined` and other non-number values.
  *
  * @static
  * @memberOf _

isNative.js

@@ -1,8 +1,12 @@
 import isFunction from './isFunction';
 import isHostObject from './_isHostObject';
-import isObjectLike from './isObjectLike';
+import isObject from './isObject';
+import toSource from './_toSource';
 
-/** Used to match `RegExp` [syntax characters](http://ecma-international.org/ecma-262/6.0/#sec-patterns). */
+/**
+ * Used to match `RegExp`
+ * [syntax characters](http://ecma-international.org/ecma-262/6.0/#sec-patterns).
+ */
 var reRegExpChar = /[\\^$.*+?()[\]{}|]/g;
 
 /** Used to detect host constructors (Safari). */
@@ -42,14 +46,11 @@ var reIsNative = RegExp('^' +
  * // => false
  */
 function isNative(value) {
-  if (value == null) {
+  if (!isObject(value)) {
     return false;
   }
-  if (isFunction(value)) {
+  var pattern = (isFunction(value) || isHostObject(value)) ? reIsNative : reIsHostCtor;
-    return reIsNative.test(funcToString.call(value));
+  return pattern.test(toSource(value));
-  }
-  return isObjectLike(value) &&
-    (isHostObject(value) ? reIsNative : reIsHostCtor).test(value);
 }
 
 export default isNative;

isNumber.js

@@ -7,7 +7,8 @@ var numberTag = '[object Number]';
 var objectProto = Object.prototype;
 
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;

isObject.js

@@ -1,6 +1,7 @@
 /**
- * Checks if `value` is the [language type](https://es5.github.io/#x8) of `Object`.
+ * Checks if `value` is the
- * (e.g. arrays, functions, objects, regexes, `new Number(0)`, and `new String('')`)
+ * [language type](http://www.ecma-international.org/ecma-262/6.0/#sec-ecmascript-language-types)
+ * of `Object`. (e.g. arrays, functions, objects, regexes, `new Number(0)`, and `new String('')`)
  *
  * @static
  * @memberOf _

isPlainObject.js

@@ -18,7 +18,8 @@ var hasOwnProperty = objectProto.hasOwnProperty;
 var objectCtorString = funcToString.call(Object);
 
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;

isRegExp.js

@@ -7,7 +7,8 @@ var regexpTag = '[object RegExp]';
 var objectProto = Object.prototype;
 
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;

isString.js

@@ -8,7 +8,8 @@ var stringTag = '[object String]';
 var objectProto = Object.prototype;
 
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;

isSymbol.js

@@ -7,7 +7,8 @@ var symbolTag = '[object Symbol]';
 var objectProto = Object.prototype;
 
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;

isTypedArray.js

@@ -48,7 +48,8 @@ typedArrayTags[weakMapTag] = false;
 var objectProto = Object.prototype;
 
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;

isWeakSet.js

@@ -7,7 +7,8 @@ var weakSetTag = '[object WeakSet]';
 var objectProto = Object.prototype;
 
 /**
- * Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
+ * Used to resolve the
+ * [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
  * of values.
  */
 var objectToString = objectProto.toString;

iteratee.js

@@ -3,8 +3,8 @@ import baseIteratee from './_baseIteratee';
 
 /**
  * Creates a function that invokes `func` with the arguments of the created
- * function. If `func` is a property name the created function returns the
+ * function. If `func` is a property name, the created function returns the
- * property value for a given element. If `func` is an array or object the
+ * property value for a given element. If `func` is an array or object, the
  * created function returns `true` for elements that contain the equivalent
  * source properties, otherwise it returns `false`.
  *

keyBy.js

@@ -2,8 +2,8 @@ import createAggregator from './_createAggregator';
 
 /**
  * Creates an object composed of keys generated from the results of running
- * each element of `collection` through `iteratee`. The corresponding value
+ * each element of `collection` thru `iteratee`. The corresponding value of
- * of each key is the last element responsible for generating the key. The
+ * each key is the last element responsible for generating the key. The
  * iteratee is invoked with one argument: (value).
  *
  * @static

lodash.default.js

@@ -1,6 +1,6 @@
 /**
  * @license
- * lodash 4.7.0 (Custom Build) <https://lodash.com/>
+ * lodash 4.10.0 (Custom Build) <https://lodash.com/>
  * Build: `lodash modularize exports="es" -o ./`
  * Copyright jQuery Foundation and other contributors <https://jquery.org/>
  * Released under MIT license <https://lodash.com/license>
@@ -44,7 +44,7 @@ import toInteger from './toInteger';
 import lodash from './wrapperLodash';
 
 /** Used as the semantic version number. */
-var VERSION = '4.7.0';
+var VERSION = '4.10.0';
 
 /** Used to compose bitmasks for wrapper metadata. */
 var BIND_KEY_FLAG = 2;

lodash.js

@@ -1,6 +1,6 @@
 /**
  * @license
- * lodash 4.7.0 (Custom Build) <https://lodash.com/>
+ * lodash 4.10.0 (Custom Build) <https://lodash.com/>
  * Build: `lodash modularize exports="es" -o ./`
  * Copyright jQuery Foundation and other contributors <https://jquery.org/>
  * Released under MIT license <https://lodash.com/license>

map.js

@@ -4,7 +4,7 @@ import baseMap from './_baseMap';
 import isArray from './isArray';
 
 /**
- * Creates an array of values by running each element in `collection` through
+ * Creates an array of values by running each element in `collection` thru
  * `iteratee`. The iteratee is invoked with three arguments:
  * (value, index|key, collection).
  *
@@ -12,10 +12,10 @@ import isArray from './isArray';
  * `_.every`, `_.filter`, `_.map`, `_.mapValues`, `_.reject`, and `_.some`.
  *
  * The guarded methods are:
- * `ary`, `curry`, `curryRight`, `drop`, `dropRight`, `every`, `fill`,
+ * `ary`, `chunk`, `curry`, `curryRight`, `drop`, `dropRight`, `every`,
- * `invert`, `parseInt`, `random`, `range`, `rangeRight`, `slice`, `some`,
+ * `fill`, `invert`, `parseInt`, `random`, `range`, `rangeRight`, `repeat`,
- * `sortBy`, `take`, `takeRight`, `template`, `trim`, `trimEnd`, `trimStart`,
+ * `sampleSize`, `slice`, `some`, `sortBy`, `split`, `take`, `takeRight`,
- * and `words`
+ * `template`, `trim`, `trimEnd`, `trimStart`, and `words`
  *
  * @static
  * @memberOf _

mapKeys.js

@@ -4,8 +4,8 @@ import baseIteratee from './_baseIteratee';
 /**
  * The opposite of `_.mapValues`; this method creates an object with the
  * same values as `object` and keys generated by running each own enumerable
- * string keyed property of `object` through `iteratee`. The iteratee is
+ * string keyed property of `object` thru `iteratee`. The iteratee is invoked
- * invoked with three arguments: (value, key, object).
+ * with three arguments: (value, key, object).
  *
  * @static
  * @memberOf _

mapValues.js

@@ -2,8 +2,8 @@ import baseForOwn from './_baseForOwn';
 import baseIteratee from './_baseIteratee';
 
 /**
- * Creates an object with the same keys as `object` and values generated by
+ * Creates an object with the same keys as `object` and values generated
- * running each own enumerable string keyed property of `object` through
+ * by running each own enumerable string keyed property of `object` thru
  * `iteratee`. The iteratee is invoked with three arguments:
  * (value, key, object).
  *

max.js

@@ -3,7 +3,7 @@ import gt from './gt';
 import identity from './identity';
 
 /**
- * Computes the maximum value of `array`. If `array` is empty or falsey
+ * Computes the maximum value of `array`. If `array` is empty or falsey,
  * `undefined` is returned.
  *
  * @static

memoize.js

@@ -5,7 +5,7 @@ var FUNC_ERROR_TEXT = 'Expected a function';
 
 /**
  * Creates a function that memoizes the result of `func`. If `resolver` is
- * provided it determines the cache key for storing the result based on the
+ * provided, it determines the cache key for storing the result based on the
  * arguments provided to the memoized function. By default, the first argument
  * provided to the memoized function is used as the map cache key. The `func`
  * is invoked with the `this` binding of the memoized function.

mergeWith.js

@@ -4,7 +4,7 @@ import createAssigner from './_createAssigner';
 /**
  * This method is like `_.merge` except that it accepts `customizer` which
  * is invoked to produce the merged values of the destination and source
- * properties. If `customizer` returns `undefined` merging is handled by the
+ * properties. If `customizer` returns `undefined`, merging is handled by the
  * method instead. The `customizer` is invoked with seven arguments:
  * (objValue, srcValue, key, object, source, stack).
  *

method.js

@@ -15,14 +15,14 @@ import rest from './rest';
  * @example
  *
  * var objects = [
- *   { 'a': { 'b': { 'c': _.constant(2) } } },
+ *   { 'a': { 'b': _.constant(2) } },
- *   { 'a': { 'b': { 'c': _.constant(1) } } }
+ *   { 'a': { 'b': _.constant(1) } }
  * ];
  *
- * _.map(objects, _.method('a.b.c'));
+ * _.map(objects, _.method('a.b'));
  * // => [2, 1]
  *
- * _.map(objects, _.method(['a', 'b', 'c']));
+ * _.map(objects, _.method(['a', 'b']));
  * // => [2, 1]
  */
 var method = rest(function(path, args) {

min.js

@@ -3,7 +3,7 @@ import identity from './identity';
 import lt from './lt';
 
 /**
- * Computes the minimum value of `array`. If `array` is empty or falsey
+ * Computes the minimum value of `array`. If `array` is empty or falsey,
  * `undefined` is returned.
  *
  * @static

mixin.js

@@ -8,7 +8,7 @@ import keys from './keys';
 
 /**
  * Adds all own enumerable string keyed function properties of a source
- * object to the destination object. If `object` is a function then methods
+ * object to the destination object. If `object` is a function, then methods
  * are added to its prototype as well.
  *
  * **Note:** Use `_.runInContext` to create a pristine `lodash` function to

omit.js

@@ -1,10 +1,10 @@
 import arrayMap from './_arrayMap';
-import baseCastKey from './_baseCastKey';
 import baseDifference from './_baseDifference';
 import baseFlatten from './_baseFlatten';
 import basePick from './_basePick';
 import getAllKeysIn from './_getAllKeysIn';
 import rest from './rest';
+import toKey from './_toKey';
 
 /**
  * The opposite of `_.pick`; this method creates an object composed of the
@@ -16,8 +16,7 @@ import rest from './rest';
  * @memberOf _
  * @category Object
  * @param {Object} object The source object.
- * @param {...(string|string[])} [props] The property identifiers to omit,
+ * @param {...(string|string[])} [props] The property identifiers to omit.
- *  specified individually or in arrays.
  * @returns {Object} Returns the new object.
  * @example
  *
@@ -30,7 +29,7 @@ var omit = rest(function(object, props) {
   if (object == null) {
     return {};
   }
-  props = arrayMap(baseFlatten(props, 1), baseCastKey);
+  props = arrayMap(baseFlatten(props, 1), toKey);
   return basePick(object, baseDifference(getAllKeysIn(object), props));
 });
 

over.js

@@ -2,14 +2,15 @@ import arrayMap from './_arrayMap';
 import createOver from './_createOver';
 
 /**
- * Creates a function that invokes `iteratees` with the arguments provided
+ * Creates a function that invokes `iteratees` with the arguments it receives
- * to the created function and returns their results.
+ * and returns their results.
  *
  * @static
  * @memberOf _
  * @since 4.0.0
  * @category Util
- * @param {...(Function|Function[])} iteratees The iteratees to invoke.
+ * @param {...(Array|Array[]|Function|Function[]|Object|Object[]|string|string[])}
+ *  [iteratees=[_.identity]] The iteratees to invoke.
  * @returns {Function} Returns the new function.
  * @example
  *

overArgs.js

@@ -2,6 +2,7 @@ import apply from './_apply';
 import arrayMap from './_arrayMap';
 import baseFlatten from './_baseFlatten';
 import baseIteratee from './_baseIteratee';
+import isFlattenableIteratee from './_isFlattenableIteratee';
 import rest from './rest';
 
 /* Built-in method references for those with the same name as other `lodash` methods. */
@@ -16,8 +17,8 @@ var nativeMin = Math.min;
  * @memberOf _
  * @category Function
  * @param {Function} func The function to wrap.
- * @param {...(Function|Function[])} [transforms] The functions to transform
+ * @param {...(Array|Array[]|Function|Function[]|Object|Object[]|string|string[])}
- * arguments, specified individually or in arrays.
+ *  [transforms[_.identity]] The functions to transform.
  * @returns {Function} Returns the new function.
  * @example
  *
@@ -40,8 +41,7 @@ var nativeMin = Math.min;
  * // => [100, 10]
  */
 var overArgs = rest(function(func, transforms) {
-  transforms = arrayMap(baseFlatten(transforms, 1), baseIteratee);
+  transforms = arrayMap(baseFlatten(transforms, 1, isFlattenableIteratee), baseIteratee);
-
   var funcsLength = transforms.length;
   return rest(function(args) {
     var index = -1,

overEvery.js

@@ -3,13 +3,14 @@ import createOver from './_createOver';
 
 /**
  * Creates a function that checks if **all** of the `predicates` return
- * truthy when invoked with the arguments provided to the created function.
+ * truthy when invoked with the arguments it receives.
  *
  * @static
  * @memberOf _
  * @since 4.0.0
  * @category Util
- * @param {...(Function|Function[])} predicates The predicates to check.
+ * @param {...(Array|Array[]|Function|Function[]|Object|Object[]|string|string[])}
+ *  [predicates=[_.identity]] The predicates to check.
  * @returns {Function} Returns the new function.
  * @example
  *

overSome.js

@@ -3,13 +3,14 @@ import createOver from './_createOver';
 
 /**
  * Creates a function that checks if **any** of the `predicates` return
- * truthy when invoked with the arguments provided to the created function.
+ * truthy when invoked with the arguments it receives.
  *
  * @static
  * @memberOf _
  * @since 4.0.0
  * @category Util
- * @param {...(Function|Function[])} predicates The predicates to check.
+ * @param {...(Array|Array[]|Function|Function[]|Object|Object[]|string|string[])}
+ *  [predicates=[_.identity]] The predicates to check.
  * @returns {Function} Returns the new function.
  * @example
  *