Bump to v3.6.0.

LICENSE.txt

@@ -1,5 +1,5 @@
 Copyright 2012-2015 The Dojo Foundation <http://dojofoundation.org/>
-Based on Underscore.js 1.7.0, copyright 2009-2015 Jeremy Ashkenas,
+Based on Underscore.js, copyright 2009-2015 Jeremy Ashkenas,
 DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>
 
 Permission is hereby granted, free of charge, to any person obtaining

README.md

@@ -1,4 +1,4 @@
-# lodash-es v3.3.1
+# lodash-es v3.6.0
 
 The [modern build](https://github.com/lodash/lodash/wiki/Build-Differences) of [lodash](https://lodash.com/) exported as [ES](https://people.mozilla.org/~jorendorff/es6-draft.html) modules.
 
@@ -7,4 +7,4 @@ Generated using [lodash-cli](https://www.npmjs.com/package/lodash-cli):
 $ lodash modularize modern exports=es -o ./
 ```
 
-See the [package source](https://github.com/lodash/lodash/tree/3.3.1-es) for more details.
+See the [package source](https://github.com/lodash/lodash/tree/3.6.0-es) for more details.

array/difference.js

@@ -2,15 +2,15 @@ import baseDifference from '../internal/baseDifference';
 import baseFlatten from '../internal/baseFlatten';
 import isArguments from '../lang/isArguments';
 import isArray from '../lang/isArray';
+import restParam from '../function/restParam';
 
 /**
  * Creates an array excluding all values of the provided arrays using
  * `SameValueZero` for equality comparisons.
  *
- * **Note:** `SameValueZero` comparisons are like strict equality comparisons,
+ * **Note:** [`SameValueZero`](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
- * e.g. `===`, except that `NaN` matches `NaN`. See the
+ * comparisons are like strict equality comparisons, e.g. `===`, except that
- * [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
+ * `NaN` matches `NaN`.
- * for more details.
  *
  * @static
  * @memberOf _
@@ -23,17 +23,10 @@ import isArray from '../lang/isArray';
  * _.difference([1, 2, 3], [4, 2]);
  * // => [1, 3]
  */
-function difference() {
+var difference = restParam(function(array, values) {
-  var index = -1,
+  return (isArray(array) || isArguments(array))
-      length = arguments.length;
+    ? baseDifference(array, baseFlatten(values, false, true))
-
+    : [];
-  while (++index < length) {
+});
-    var value = arguments[index];
-    if (isArray(value) || isArguments(value)) {
-      break;
-    }
-  }
-  return baseDifference(value, baseFlatten(arguments, false, true, ++index));
-}
 
 export default difference;

array/dropRightWhile.js

@@ -1,10 +1,10 @@
 import baseCallback from '../internal/baseCallback';
-import baseSlice from '../internal/baseSlice';
+import baseWhile from '../internal/baseWhile';
 
 /**
  * Creates a slice of `array` excluding elements dropped from the end.
  * Elements are dropped until `predicate` returns falsey. The predicate is
- * bound to `thisArg` and invoked with three arguments; (value, index, array).
+ * bound to `thisArg` and invoked with three arguments: (value, index, array).
  *
  * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
@@ -39,7 +39,7 @@ import baseSlice from '../internal/baseSlice';
  * ];
  *
  * // using the `_.matches` callback shorthand
- * _.pluck(_.dropRightWhile(users, { 'user': pebbles, 'active': false }), 'user');
+ * _.pluck(_.dropRightWhile(users, { 'user': 'pebbles', 'active': false }), 'user');
  * // => ['barney', 'fred']
  *
  * // using the `_.matchesProperty` callback shorthand
@@ -51,13 +51,9 @@ import baseSlice from '../internal/baseSlice';
  * // => ['barney', 'fred', 'pebbles']
  */
 function dropRightWhile(array, predicate, thisArg) {
-  var length = array ? array.length : 0;
+  return (array && array.length)
-  if (!length) {
+    ? baseWhile(array, baseCallback(predicate, thisArg, 3), true, true)
-    return [];
+    : [];
-  }
-  predicate = baseCallback(predicate, thisArg, 3);
-  while (length-- && predicate(array[length], length, array)) {}
-  return baseSlice(array, 0, length + 1);
 }
 
 export default dropRightWhile;

array/dropWhile.js

@@ -1,10 +1,10 @@
 import baseCallback from '../internal/baseCallback';
-import baseSlice from '../internal/baseSlice';
+import baseWhile from '../internal/baseWhile';
 
 /**
  * Creates a slice of `array` excluding elements dropped from the beginning.
  * Elements are dropped until `predicate` returns falsey. The predicate is
- * bound to `thisArg` and invoked with three arguments; (value, index, array).
+ * bound to `thisArg` and invoked with three arguments: (value, index, array).
  *
  * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
@@ -51,14 +51,9 @@ import baseSlice from '../internal/baseSlice';
  * // => ['barney', 'fred', 'pebbles']
  */
 function dropWhile(array, predicate, thisArg) {
-  var length = array ? array.length : 0;
+  return (array && array.length)
-  if (!length) {
+    ? baseWhile(array, baseCallback(predicate, thisArg, 3), true)
-    return [];
+    : [];
-  }
-  var index = -1;
-  predicate = baseCallback(predicate, thisArg, 3);
-  while (++index < length && predicate(array[index], index, array)) {}
-  return baseSlice(array, index);
 }
 
 export default dropWhile;

array/fill.js

@@ -15,6 +15,19 @@ import isIterateeCall from '../internal/isIterateeCall';
  * @param {number} [start=0] The start position.
  * @param {number} [end=array.length] The end position.
  * @returns {Array} Returns `array`.
+ * @example
+ *
+ * var array = [1, 2, 3];
+ *
+ * _.fill(array, 'a');
+ * console.log(array);
+ * // => ['a', 'a', 'a']
+ *
+ * _.fill(Array(3), 2);
+ * // => [2, 2, 2]
+ *
+ * _.fill([4, 6, 8], '*', 1, 2);
+ * // => [4, '*', 8]
  */
 function fill(array, value, start, end) {
   var length = array ? array.length : 0;

array/findIndex.js

@@ -1,8 +1,8 @@
-import baseCallback from '../internal/baseCallback';
+import createFindIndex from '../internal/createFindIndex';
 
 /**
  * This method is like `_.find` except that it returns the index of the first
- * element `predicate` returns truthy for, instead of the element itself.
+ * element `predicate` returns truthy for instead of the element itself.
  *
  * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
@@ -48,17 +48,6 @@ import baseCallback from '../internal/baseCallback';
  * _.findIndex(users, 'active');
  * // => 2
  */
-function findIndex(array, predicate, thisArg) {
+var findIndex = createFindIndex();
-  var index = -1,
-      length = array ? array.length : 0;
-
-  predicate = baseCallback(predicate, thisArg, 3);
-  while (++index < length) {
-    if (predicate(array[index], index, array)) {
-      return index;
-    }
-  }
-  return -1;
-}
 
 export default findIndex;

array/findLastIndex.js

@@ -1,4 +1,4 @@
-import baseCallback from '../internal/baseCallback';
+import createFindIndex from '../internal/createFindIndex';
 
 /**
  * This method is like `_.findIndex` except that it iterates over elements
@@ -42,21 +42,12 @@ import baseCallback from '../internal/baseCallback';
  *
  * // using the `_.matchesProperty` callback shorthand
  * _.findLastIndex(users, 'active', false);
- * // => 1
+ * // => 2
  *
  * // using the `_.property` callback shorthand
  * _.findLastIndex(users, 'active');
  * // => 0
  */
-function findLastIndex(array, predicate, thisArg) {
+var findLastIndex = createFindIndex(true);
-  var length = array ? array.length : 0;
-  predicate = baseCallback(predicate, thisArg, 3);
-  while (length--) {
-    if (predicate(array[length], length, array)) {
-      return length;
-    }
-  }
-  return -1;
-}
 
 export default findLastIndex;

array/flatten.js

@@ -15,11 +15,11 @@ import isIterateeCall from '../internal/isIterateeCall';
  * @example
  *
  * _.flatten([1, [2, 3, [4]]]);
- * // => [1, 2, 3, [4]];
+ * // => [1, 2, 3, [4]]
  *
  * // using `isDeep`
  * _.flatten([1, [2, 3, [4]]], true);
- * // => [1, 2, 3, 4];
+ * // => [1, 2, 3, 4]
  */
 function flatten(array, isDeep, guard) {
   var length = array ? array.length : 0;

array/flattenDeep.js

@@ -11,7 +11,7 @@ import baseFlatten from '../internal/baseFlatten';
  * @example
  *
  * _.flattenDeep([1, [2, 3, [4]]]);
- * // => [1, 2, 3, 4];
+ * // => [1, 2, 3, 4]
  */
 function flattenDeep(array) {
   var length = array ? array.length : 0;

array/indexOf.js

@@ -10,10 +10,9 @@ var nativeMax = Math.max;
  * it is used as the offset from the end of `array`. If `array` is sorted
  * providing `true` for `fromIndex` performs a faster binary search.
  *
- * **Note:** `SameValueZero` comparisons are like strict equality comparisons,
+ * **Note:** [`SameValueZero`](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
- * e.g. `===`, except that `NaN` matches `NaN`. See the
+ * comparisons are like strict equality comparisons, e.g. `===`, except that
- * [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
+ * `NaN` matches `NaN`.
- * for more details.
  *
  * @static
  * @memberOf _
@@ -42,14 +41,17 @@ function indexOf(array, value, fromIndex) {
     return -1;
   }
   if (typeof fromIndex == 'number') {
-    fromIndex = fromIndex < 0 ? nativeMax(length + fromIndex, 0) : (fromIndex || 0);
+    fromIndex = fromIndex < 0 ? nativeMax(length + fromIndex, 0) : fromIndex;
   } else if (fromIndex) {
     var index = binaryIndex(array, value),
         other = array[index];
 
-    return (value === value ? value === other : other !== other) ? index : -1;
+    if (value === value ? (value === other) : (other !== other)) {
+      return index;
+    }
+    return -1;
   }
-  return baseIndexOf(array, value, fromIndex);
+  return baseIndexOf(array, value, fromIndex || 0);
 }
 
 export default indexOf;

array/intersection.js

@@ -8,10 +8,9 @@ import isArray from '../lang/isArray';
  * Creates an array of unique values in all provided arrays using `SameValueZero`
  * for equality comparisons.
  *
- * **Note:** `SameValueZero` comparisons are like strict equality comparisons,
+ * **Note:** [`SameValueZero`](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
- * e.g. `===`, except that `NaN` matches `NaN`. See the
+ * comparisons are like strict equality comparisons, e.g. `===`, except that
- * [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
+ * `NaN` matches `NaN`.
- * for more details.
  *
  * @static
  * @memberOf _
@@ -47,11 +46,11 @@ function intersection() {
   outer:
   while (++index < length) {
     value = array[index];
-    if ((seen ? cacheIndexOf(seen, value) : indexOf(result, value)) < 0) {
+    if ((seen ? cacheIndexOf(seen, value) : indexOf(result, value, 0)) < 0) {
       argsIndex = argsLength;
       while (--argsIndex) {
         var cache = caches[argsIndex];
-        if ((cache ? cacheIndexOf(cache, value) : indexOf(args[argsIndex], value)) < 0) {
+        if ((cache ? cacheIndexOf(cache, value) : indexOf(args[argsIndex], value, 0)) < 0) {
           continue outer;
         }
       }

array/lastIndexOf.js

@@ -41,7 +41,10 @@ function lastIndexOf(array, value, fromIndex) {
   } else if (fromIndex) {
     index = binaryIndex(array, value, true) - 1;
     var other = array[index];
-    return (value === value ? value === other : other !== other) ? index : -1;
+    if (value === value ? (value === other) : (other !== other)) {
+      return index;
+    }
+    return -1;
   }
   if (value !== value) {
     return indexOfNaN(array, index, true);

array/pull.js

@@ -11,10 +11,10 @@ var splice = arrayProto.splice;
  * comparisons.
  *
  * **Notes:**
- *  - Unlike `_.without`, this method mutates `array`.
+ *  - Unlike `_.without`, this method mutates `array`
- *  - `SameValueZero` comparisons are like strict equality comparisons, e.g. `===`,
+ *  - [`SameValueZero`](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
- *    except that `NaN` matches `NaN`. See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
+ *    comparisons are like strict equality comparisons, e.g. `===`, except
- *    for more details.
+ *    that `NaN` matches `NaN`
  *
  * @static
  * @memberOf _
@@ -31,17 +31,19 @@ var splice = arrayProto.splice;
  * // => [1, 1]
  */
 function pull() {
-  var array = arguments[0];
+  var args = arguments,
+      array = args[0];
+
   if (!(array && array.length)) {
     return array;
   }
   var index = 0,
       indexOf = baseIndexOf,
-      length = arguments.length;
+      length = args.length;
 
   while (++index < length) {
     var fromIndex = 0,
-        value = arguments[index];
+        value = args[index];
 
     while ((fromIndex = indexOf(array, value, fromIndex)) > -1) {
       splice.call(array, fromIndex, 1);

array/pullAt.js

@@ -1,5 +1,14 @@
+import baseAt from '../internal/baseAt';
+import baseCompareAscending from '../internal/baseCompareAscending';
 import baseFlatten from '../internal/baseFlatten';
-import basePullAt from '../internal/basePullAt';
+import isIndex from '../internal/isIndex';
+import restParam from '../function/restParam';
+
+/** Used for native method references. */
+var arrayProto = Array.prototype;
+
+/** Native method references. */
+var splice = arrayProto.splice;
 
 /**
  * Removes elements from `array` corresponding to the given indexes and returns
@@ -26,8 +35,22 @@ import basePullAt from '../internal/basePullAt';
  * console.log(evens);
  * // => [10, 20]
  */
-function pullAt(array) {
+var pullAt = restParam(function(array, indexes) {
-  return basePullAt(array || [], baseFlatten(arguments, false, false, 1));
+  array || (array = []);
-}
+  indexes = baseFlatten(indexes);
+
+  var length = indexes.length,
+      result = baseAt(array, indexes);
+
+  indexes.sort(baseCompareAscending);
+  while (length--) {
+    var index = parseFloat(indexes[length]);
+    if (index != previous && isIndex(index)) {
+      var previous = index;
+      splice.call(array, index, 1);
+    }
+  }
+  return result;
+});
 
 export default pullAt;

array/remove.js

@@ -9,7 +9,7 @@ var splice = arrayProto.splice;
 /**
  * Removes all elements from `array` that `predicate` returns truthy for
  * and returns an array of the removed elements. The predicate is bound to
- * `thisArg` and invoked with three arguments; (value, index, array).
+ * `thisArg` and invoked with three arguments: (value, index, array).
  *
  * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.

array/sortedIndex.js

@@ -1,6 +1,4 @@
-import baseCallback from '../internal/baseCallback';
+import createSortedIndex from '../internal/createSortedIndex';
-import binaryIndex from '../internal/binaryIndex';
-import binaryIndexBy from '../internal/binaryIndexBy';
 
 /**
  * Uses a binary search to determine the lowest index at which `value` should
@@ -9,14 +7,14 @@ import binaryIndexBy from '../internal/binaryIndexBy';
  * to compute their sort ranking. The iteratee is bound to `thisArg` and
  * invoked with one argument; (value).
  *
- * If a property name is provided for `predicate` the created `_.property`
+ * If a property name is provided for `iteratee` the created `_.property`
  * style callback returns the property value of the given element.
  *
  * If a value is also provided for `thisArg` the created `_.matchesProperty`
  * style callback returns `true` for elements that have a matching property
  * value, else `false`.
  *
- * If an object is provided for `predicate` the created `_.matches` style
+ * If an object is provided for `iteratee` the created `_.matches` style
  * callback returns `true` for elements that have the properties of the given
  * object, else `false`.
  *
@@ -50,10 +48,6 @@ import binaryIndexBy from '../internal/binaryIndexBy';
  * _.sortedIndex([{ 'x': 30 }, { 'x': 50 }], { 'x': 40 }, 'x');
  * // => 1
  */
-function sortedIndex(array, value, iteratee, thisArg) {
+var sortedIndex = createSortedIndex();
-  return iteratee == null
-    ? binaryIndex(array, value)
-    : binaryIndexBy(array, value, baseCallback(iteratee, thisArg, 1));
-}
 
 export default sortedIndex;

array/sortedLastIndex.js

@@ -1,6 +1,4 @@
-import baseCallback from '../internal/baseCallback';
+import createSortedIndex from '../internal/createSortedIndex';
-import binaryIndex from '../internal/binaryIndex';
-import binaryIndexBy from '../internal/binaryIndexBy';
 
 /**
  * This method is like `_.sortedIndex` except that it returns the highest
@@ -22,10 +20,6 @@ import binaryIndexBy from '../internal/binaryIndexBy';
  * _.sortedLastIndex([4, 4, 5, 5], 5);
  * // => 4
  */
-function sortedLastIndex(array, value, iteratee, thisArg) {
+var sortedLastIndex = createSortedIndex(true);
-  return iteratee == null
-    ? binaryIndex(array, value, true)
-    : binaryIndexBy(array, value, baseCallback(iteratee, thisArg, 1), true);
-}
 
 export default sortedLastIndex;

array/takeRightWhile.js

@@ -1,10 +1,10 @@
 import baseCallback from '../internal/baseCallback';
-import baseSlice from '../internal/baseSlice';
+import baseWhile from '../internal/baseWhile';
 
 /**
  * Creates a slice of `array` with elements taken from the end. Elements are
  * taken until `predicate` returns falsey. The predicate is bound to `thisArg`
- * and invoked with three arguments; (value, index, array).
+ * and invoked with three arguments: (value, index, array).
  *
  * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
@@ -51,13 +51,9 @@ import baseSlice from '../internal/baseSlice';
  * // => []
  */
 function takeRightWhile(array, predicate, thisArg) {
-  var length = array ? array.length : 0;
+  return (array && array.length)
-  if (!length) {
+    ? baseWhile(array, baseCallback(predicate, thisArg, 3), false, true)
-    return [];
+    : [];
-  }
-  predicate = baseCallback(predicate, thisArg, 3);
-  while (length-- && predicate(array[length], length, array)) {}
-  return baseSlice(array, length + 1);
 }
 
 export default takeRightWhile;

array/takeWhile.js

@@ -1,10 +1,10 @@
 import baseCallback from '../internal/baseCallback';
-import baseSlice from '../internal/baseSlice';
+import baseWhile from '../internal/baseWhile';
 
 /**
  * Creates a slice of `array` with elements taken from the beginning. Elements
  * are taken until `predicate` returns falsey. The predicate is bound to
- * `thisArg` and invoked with three arguments; (value, index, array).
+ * `thisArg` and invoked with three arguments: (value, index, array).
  *
  * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
@@ -51,14 +51,9 @@ import baseSlice from '../internal/baseSlice';
  * // => []
  */
 function takeWhile(array, predicate, thisArg) {
-  var length = array ? array.length : 0;
+  return (array && array.length)
-  if (!length) {
+    ? baseWhile(array, baseCallback(predicate, thisArg, 3))
-    return [];
+    : [];
-  }
-  var index = -1;
-  predicate = baseCallback(predicate, thisArg, 3);
-  while (++index < length && predicate(array[index], index, array)) {}
-  return baseSlice(array, 0, index);
 }
 
 export default takeWhile;

array/union.js

@@ -1,14 +1,14 @@
 import baseFlatten from '../internal/baseFlatten';
 import baseUniq from '../internal/baseUniq';
+import restParam from '../function/restParam';
 
 /**
  * Creates an array of unique values, in order, of the provided arrays using
  * `SameValueZero` for equality comparisons.
  *
- * **Note:** `SameValueZero` comparisons are like strict equality comparisons,
+ * **Note:** [`SameValueZero`](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
- * e.g. `===`, except that `NaN` matches `NaN`. See the
+ * comparisons are like strict equality comparisons, e.g. `===`, except that
- * [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
+ * `NaN` matches `NaN`.
- * for more details.
  *
  * @static
  * @memberOf _
@@ -20,8 +20,8 @@ import baseUniq from '../internal/baseUniq';
  * _.union([1, 2], [4, 2], [2, 1]);
  * // => [1, 2, 4]
  */
-function union() {
+var union = restParam(function(arrays) {
-  return baseUniq(baseFlatten(arguments, false, true));
+  return baseUniq(baseFlatten(arrays, false, true));
-}
+});
 
 export default union;

array/uniq.js

@@ -9,23 +9,22 @@ import sortedUniq from '../internal/sortedUniq';
  * search algorithm for sorted arrays. If an iteratee function is provided it
  * is invoked for each value in the array to generate the criterion by which
  * uniqueness is computed. The `iteratee` is bound to `thisArg` and invoked
- * with three arguments; (value, index, array).
+ * with three arguments: (value, index, array).
  *
- * If a property name is provided for `predicate` the created `_.property`
+ * If a property name is provided for `iteratee` the created `_.property`
  * style callback returns the property value of the given element.
  *
  * If a value is also provided for `thisArg` the created `_.matchesProperty`
  * style callback returns `true` for elements that have a matching property
  * value, else `false`.
  *
- * If an object is provided for `predicate` the created `_.matches` style
+ * If an object is provided for `iteratee` the created `_.matches` style
  * callback returns `true` for elements that have the properties of the given
  * object, else `false`.
  *
- * **Note:** `SameValueZero` comparisons are like strict equality comparisons,
+ * **Note:** [`SameValueZero`](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
- * e.g. `===`, except that `NaN` matches `NaN`. See the
+ * comparisons are like strict equality comparisons, e.g. `===`, except that
- * [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
+ * `NaN` matches `NaN`.
- * for more details.
  *
  * @static
  * @memberOf _

array/without.js

@@ -1,14 +1,15 @@
 import baseDifference from '../internal/baseDifference';
-import baseSlice from '../internal/baseSlice';
+import isArguments from '../lang/isArguments';
+import isArray from '../lang/isArray';
+import restParam from '../function/restParam';
 
 /**
  * Creates an array excluding all provided values using `SameValueZero` for
  * equality comparisons.
  *
- * **Note:** `SameValueZero` comparisons are like strict equality comparisons,
+ * **Note:** [`SameValueZero`](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
- * e.g. `===`, except that `NaN` matches `NaN`. See the
+ * comparisons are like strict equality comparisons, e.g. `===`, except that
- * [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
+ * `NaN` matches `NaN`.
- * for more details.
  *
  * @static
  * @memberOf _
@@ -21,8 +22,10 @@ import baseSlice from '../internal/baseSlice';
  * _.without([1, 2, 1, 3], 1, 2);
  * // => [3]
  */
-function without(array) {
+var without = restParam(function(array, values) {
-  return baseDifference(array, baseSlice(arguments, 1));
+  return (isArray(array) || isArguments(array))
-}
+    ? baseDifference(array, values)
+    : [];
+});
 
 export default without;

array/xor.js

@@ -4,9 +4,8 @@ import isArguments from '../lang/isArguments';
 import isArray from '../lang/isArray';
 
 /**
- * Creates an array that is the symmetric difference of the provided arrays.
+ * Creates an array that is the [symmetric difference](https://en.wikipedia.org/wiki/Symmetric_difference)
- * See [Wikipedia](https://en.wikipedia.org/wiki/Symmetric_difference) for
+ * of the provided arrays.
- * more details.
  *
  * @static
  * @memberOf _

array/zip.js

@@ -1,3 +1,4 @@
+import restParam from '../function/restParam';
 import unzip from './unzip';
 
 /**
@@ -15,14 +16,6 @@ import unzip from './unzip';
  * _.zip(['fred', 'barney'], [30, 40], [true, false]);
  * // => [['fred', 30, true], ['barney', 40, false]]
  */
-function zip() {
+var zip = restParam(unzip);
-  var length = arguments.length,
-      array = Array(length);
-
-  while (length--) {
-    array[length] = arguments[length];
-  }
-  return unzip(array);
-}
 
 export default zip;

array/zipObject.js

@@ -1,9 +1,10 @@
 import isArray from '../lang/isArray';
 
 /**
- * Creates an object composed from arrays of property names and values. Provide
+ * The inverse of `_.pairs`; this method returns an object composed from arrays
- * either a single two dimensional array, e.g. `[[key1, value1], [key2, value2]]`
+ * of property names and values. Provide either a single two dimensional array,
- * or two arrays, one of property names and one of corresponding values.
+ * e.g. `[[key1, value1], [key2, value2]]` or two arrays, one of property names
+ * and one of corresponding values.
  *
  * @static
  * @memberOf _
@@ -14,6 +15,9 @@ import isArray from '../lang/isArray';
  * @returns {Object} Returns the new object.
  * @example
  *
+ * _.zipObject([['fred', 30], ['barney', 40]]);
+ * // => { 'fred': 30, 'barney': 40 }
+ *
  * _.zipObject(['fred', 'barney'], [30, 40]);
  * // => { 'fred': 30, 'barney': 40 }
  */

chain/lodash.js

@@ -27,9 +27,14 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * Chaining is supported in custom builds as long as the `_#value` method is
  * directly or indirectly included in the build.
  *
- * In addition to lodash methods, wrappers also have the following `Array` methods:
+ * In addition to lodash methods, wrappers have `Array` and `String` methods.
- * `concat`, `join`, `pop`, `push`, `reverse`, `shift`, `slice`, `sort`, `splice`,
+ *
- * and `unshift`
+ * The wrapper `Array` methods are:
+ * `concat`, `join`, `pop`, `push`, `reverse`, `shift`, `slice`, `sort`,
+ * `splice`, and `unshift`
+ *
+ * The wrapper `String` methods are:
+ * `replace` and `split`
  *
  * The wrapper methods that support shortcut fusion are:
  * `compact`, `drop`, `dropRight`, `dropRightWhile`, `dropWhile`, `filter`,
@@ -49,26 +54,26 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * `mixin`, `negate`, `noop`, `omit`, `once`, `pairs`, `partial`, `partialRight`,
  * `partition`, `pick`, `plant`, `pluck`, `property`, `propertyOf`, `pull`,
  * `pullAt`, `push`, `range`, `rearg`, `reject`, `remove`, `rest`, `reverse`,
- * `shuffle`, `slice`, `sort`, `sortBy`, `sortByAll`, `splice`, `spread`,
+ * `shuffle`, `slice`, `sort`, `sortBy`, `sortByAll`, `sortByOrder`, `splice`,
- * `take`, `takeRight`, `takeRightWhile`, `takeWhile`, `tap`, `throttle`,
+ * `spread`, `take`, `takeRight`, `takeRightWhile`, `takeWhile`, `tap`,
- * `thru`, `times`, `toArray`, `toPlainObject`, `transform`, `union`, `uniq`,
+ * `throttle`, `thru`, `times`, `toArray`, `toPlainObject`, `transform`,
- * `unshift`, `unzip`, `values`, `valuesIn`, `where`, `without`, `wrap`, `xor`,
+ * `union`, `uniq`, `unshift`, `unzip`, `values`, `valuesIn`, `where`,
- * `zip`, and `zipObject`
+ * `without`, `wrap`, `xor`, `zip`, and `zipObject`
  *
  * The wrapper methods that are **not** chainable by default are:
- * `attempt`, `camelCase`, `capitalize`, `clone`, `cloneDeep`, `deburr`,
+ * `add`, `attempt`, `camelCase`, `capitalize`, `clone`, `cloneDeep`, `deburr`,
  * `endsWith`, `escape`, `escapeRegExp`, `every`, `find`, `findIndex`, `findKey`,
  * `findLast`, `findLastIndex`, `findLastKey`, `findWhere`, `first`, `has`,
- * `identity`, `includes`, `indexOf`, `isArguments`, `isArray`, `isBoolean`,
+ * `identity`, `includes`, `indexOf`, `inRange`, `isArguments`, `isArray`,
- * `isDate`, `isElement`, `isEmpty`, `isEqual`, `isError`, `isFinite`,
+ * `isBoolean`, `isDate`, `isElement`, `isEmpty`, `isEqual`, `isError`,
- * `isFunction`, `isMatch`, `isNative`, `isNaN`, `isNull`, `isNumber`,
+ * `isFinite`,`isFunction`, `isMatch`, `isNative`, `isNaN`, `isNull`, `isNumber`,
  * `isObject`, `isPlainObject`, `isRegExp`, `isString`, `isUndefined`,
  * `isTypedArray`, `join`, `kebabCase`, `last`, `lastIndexOf`, `max`, `min`,
  * `noConflict`, `now`, `pad`, `padLeft`, `padRight`, `parseInt`, `pop`,
  * `random`, `reduce`, `reduceRight`, `repeat`, `result`, `runInContext`,
  * `shift`, `size`, `snakeCase`, `some`, `sortedIndex`, `sortedLastIndex`,
- * `startCase`, `startsWith`, `template`, `trim`, `trimLeft`, `trimRight`,
+ * `startCase`, `startsWith`, `sum`, `template`, `trim`, `trimLeft`,
- * `trunc`, `unescape`, `uniqueId`, `value`, and `words`
+ * `trimRight`, `trunc`, `unescape`, `uniqueId`, `value`, and `words`
  *
  * The wrapper method `sample` will return a wrapped value when `n` is provided,
  * otherwise an unwrapped value is returned.

chain/thru.js

@@ -10,13 +10,14 @@
  * @returns {*} Returns the result of `interceptor`.
  * @example
  *
- * _([1, 2, 3])
+ * _('  abc  ')
- *  .last()
+ *  .chain()
+ *  .trim()
  *  .thru(function(value) {
  *    return [value];
  *  })
  *  .value();
- * // => [3]
+ * // => ['abc']
  */
 function thru(value, interceptor, thisArg) {
   return interceptor.call(thisArg, value);

collection.js

@@ -23,8 +23,8 @@ import indexBy from './collection/indexBy';
 import inject from './collection/inject';
 import invoke from './collection/invoke';
 import map from './collection/map';
-import max from './collection/max';
+import max from './math/max';
-import min from './collection/min';
+import min from './math/min';
 import partition from './collection/partition';
 import pluck from './collection/pluck';
 import reduce from './collection/reduce';
@@ -37,6 +37,8 @@ import size from './collection/size';
 import some from './collection/some';
 import sortBy from './collection/sortBy';
 import sortByAll from './collection/sortByAll';
+import sortByOrder from './collection/sortByOrder';
+import sum from './math/sum';
 import where from './collection/where';
 
 export default {
@@ -79,5 +81,7 @@ export default {
   'some': some,
   'sortBy': sortBy,
   'sortByAll': sortByAll,
+  'sortByOrder': sortByOrder,
+  'sum': sum,
   'where': where
 };

collection/at.js

@@ -1,6 +1,7 @@
 import baseAt from '../internal/baseAt';
 import baseFlatten from '../internal/baseFlatten';
 import isLength from '../internal/isLength';
+import restParam from '../function/restParam';
 import toIterable from '../internal/toIterable';
 
 /**
@@ -20,15 +21,15 @@ import toIterable from '../internal/toIterable';
  * _.at(['a', 'b', 'c'], [0, 2]);
  * // => ['a', 'c']
  *
- * _.at(['fred', 'barney', 'pebbles'], 0, 2);
+ * _.at(['barney', 'fred', 'pebbles'], 0, 2);
- * // => ['fred', 'pebbles']
+ * // => ['barney', 'pebbles']
  */
-function at(collection) {
+var at = restParam(function(collection, props) {
   var length = collection ? collection.length : 0;
   if (isLength(length)) {
     collection = toIterable(collection);
   }
-  return baseAt(collection, baseFlatten(arguments, false, false, 1));
+  return baseAt(collection, baseFlatten(props));
-}
+});
 
 export default at;

collection/countBy.js

@@ -10,17 +10,17 @@ 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
  * of each key is the number of times the key was returned by `iteratee`.
- * The `iteratee` is bound to `thisArg` and invoked with three arguments;
+ * The `iteratee` is bound to `thisArg` and invoked with three arguments:
  * (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created `_.property`
+ * If a property name is provided for `iteratee` the created `_.property`
  * style callback returns the property value of the given element.
  *
  * If a value is also provided for `thisArg` the created `_.matchesProperty`
  * style callback returns `true` for elements that have a matching property
  * value, else `false`.
  *
- * If an object is provided for `predicate` the created `_.matches` style
+ * If an object is provided for `iteratee` the created `_.matches` style
  * callback returns `true` for elements that have the properties of the given
  * object, else `false`.
  *

collection/every.js

@@ -2,10 +2,11 @@ import arrayEvery from '../internal/arrayEvery';
 import baseCallback from '../internal/baseCallback';
 import baseEvery from '../internal/baseEvery';
 import isArray from '../lang/isArray';
+import isIterateeCall from '../internal/isIterateeCall';
 
 /**
  * Checks if `predicate` returns truthy for **all** elements of `collection`.
- * The predicate is bound to `thisArg` and invoked with three arguments;
+ * The predicate is bound to `thisArg` and invoked with three arguments:
  * (value, index|key, collection).
  *
  * If a property name is provided for `predicate` the created `_.property`
@@ -53,6 +54,9 @@ import isArray from '../lang/isArray';
  */
 function every(collection, predicate, thisArg) {
   var func = isArray(collection) ? arrayEvery : baseEvery;
+  if (thisArg && isIterateeCall(collection, predicate, thisArg)) {
+    predicate = null;
+  }
   if (typeof predicate != 'function' || typeof thisArg != 'undefined') {
     predicate = baseCallback(predicate, thisArg, 3);
   }

collection/filter.js

@@ -6,7 +6,7 @@ import isArray from '../lang/isArray';
 /**
  * Iterates over elements of `collection`, returning an array of all elements
  * `predicate` returns truthy for. The predicate is bound to `thisArg` and
- * invoked with three arguments; (value, index|key, collection).
+ * invoked with three arguments: (value, index|key, collection).
  *
  * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.

collection/find.js

@@ -1,13 +1,10 @@
-import baseCallback from '../internal/baseCallback';
 import baseEach from '../internal/baseEach';
-import baseFind from '../internal/baseFind';
+import createFind from '../internal/createFind';
-import findIndex from '../array/findIndex';
-import isArray from '../lang/isArray';
 
 /**
  * Iterates over elements of `collection`, returning the first element
  * `predicate` returns truthy for. The predicate is bound to `thisArg` and
- * invoked with three arguments; (value, index|key, collection).
+ * invoked with three arguments: (value, index|key, collection).
  *
  * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
@@ -54,13 +51,6 @@ import isArray from '../lang/isArray';
  * _.result(_.find(users, 'active'), 'user');
  * // => 'barney'
  */
-function find(collection, predicate, thisArg) {
+var find = createFind(baseEach);
-  if (isArray(collection)) {
-    var index = findIndex(collection, predicate, thisArg);
-    return index > -1 ? collection[index] : undefined;
-  }
-  predicate = baseCallback(predicate, thisArg, 3);
-  return baseFind(collection, predicate, baseEach);
-}
 
 export default find;

collection/findLast.js

@@ -1,6 +1,5 @@
-import baseCallback from '../internal/baseCallback';
 import baseEachRight from '../internal/baseEachRight';
-import baseFind from '../internal/baseFind';
+import createFind from '../internal/createFind';
 
 /**
  * This method is like `_.find` except that it iterates over elements of
@@ -21,9 +20,6 @@ import baseFind from '../internal/baseFind';
  * });
  * // => 3
  */
-function findLast(collection, predicate, thisArg) {
+var findLast = createFind(baseEachRight, true);
-  predicate = baseCallback(predicate, thisArg, 3);
-  return baseFind(collection, predicate, baseEachRight);
-}
 
 export default findLast;

collection/forEach.js

@@ -1,11 +1,10 @@
 import arrayEach from '../internal/arrayEach';
 import baseEach from '../internal/baseEach';
-import bindCallback from '../internal/bindCallback';
+import createForEach from '../internal/createForEach';
-import isArray from '../lang/isArray';
 
 /**
  * Iterates over elements of `collection` invoking `iteratee` for each element.
- * The `iteratee` is bound to `thisArg` and invoked with three arguments;
+ * The `iteratee` is bound to `thisArg` and invoked with three arguments:
  * (value, index|key, collection). Iterator functions may exit iteration early
  * by explicitly returning `false`.
  *
@@ -33,10 +32,6 @@ import isArray from '../lang/isArray';
  * });
  * // => logs each value-key pair and returns the object (iteration order is not guaranteed)
  */
-function forEach(collection, iteratee, thisArg) {
+var forEach = createForEach(arrayEach, baseEach);
-  return (typeof iteratee == 'function' && typeof thisArg == 'undefined' && isArray(collection))
-    ? arrayEach(collection, iteratee)
-    : baseEach(collection, bindCallback(iteratee, thisArg, 3));
-}
 
 export default forEach;

collection/forEachRight.js

@@ -1,7 +1,6 @@
 import arrayEachRight from '../internal/arrayEachRight';
 import baseEachRight from '../internal/baseEachRight';
-import bindCallback from '../internal/bindCallback';
+import createForEach from '../internal/createForEach';
-import isArray from '../lang/isArray';
 
 /**
  * This method is like `_.forEach` except that it iterates over elements of
@@ -19,13 +18,9 @@ import isArray from '../lang/isArray';
  *
  * _([1, 2]).forEachRight(function(n) {
  *   console.log(n);
- * }).join(',');
+ * }).value();
  * // => logs each value from right to left and returns the array
  */
-function forEachRight(collection, iteratee, thisArg) {
+var forEachRight = createForEach(arrayEachRight, baseEachRight);
-  return (typeof iteratee == 'function' && typeof thisArg == 'undefined' && isArray(collection))
-    ? arrayEachRight(collection, iteratee)
-    : baseEachRight(collection, bindCallback(iteratee, thisArg, 3));
-}
 
 export default forEachRight;

collection/groupBy.js

@@ -10,17 +10,17 @@ 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
  * of each key is an array of the elements responsible for generating the key.
- * The `iteratee` is bound to `thisArg` and invoked with three arguments;
+ * The `iteratee` is bound to `thisArg` and invoked with three arguments:
  * (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created `_.property`
+ * If a property name is provided for `iteratee` the created `_.property`
  * style callback returns the property value of the given element.
  *
  * If a value is also provided for `thisArg` the created `_.matchesProperty`
  * style callback returns `true` for elements that have a matching property
  * value, else `false`.
  *
- * If an object is provided for `predicate` the created `_.matches` style
+ * If an object is provided for `iteratee` the created `_.matches` style
  * callback returns `true` for elements that have the properties of the given
  * object, else `false`.
  *

collection/includes.js

@@ -1,5 +1,6 @@
 import baseIndexOf from '../internal/baseIndexOf';
 import isArray from '../lang/isArray';
+import isIterateeCall from '../internal/isIterateeCall';
 import isLength from '../internal/isLength';
 import isString from '../lang/isString';
 import values from '../object/values';
@@ -12,10 +13,9 @@ var nativeMax = Math.max;
  * comparisons. If `fromIndex` is negative, it is used as the offset from
  * the end of `collection`.
  *
- * **Note:** `SameValueZero` comparisons are like strict equality comparisons,
+ * **Note:** [`SameValueZero`](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
- * e.g. `===`, except that `NaN` matches `NaN`. See the
+ * comparisons are like strict equality comparisons, e.g. `===`, except that
- * [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero)
+ * `NaN` matches `NaN`.
- * for more details.
  *
  * @static
  * @memberOf _
@@ -24,6 +24,7 @@ var nativeMax = Math.max;
  * @param {Array|Object|string} collection The collection to search.
  * @param {*} target The value to search for.
  * @param {number} [fromIndex=0] The index to search from.
+ * @param- {Object} [guard] Enables use as a callback for functions like `_.reduce`.
  * @returns {boolean} Returns `true` if a matching element is found, else `false`.
  * @example
  *
@@ -39,7 +40,7 @@ var nativeMax = Math.max;
  * _.includes('pebbles', 'eb');
  * // => true
  */
-function includes(collection, target, fromIndex) {
+function includes(collection, target, fromIndex, guard) {
   var length = collection ? collection.length : 0;
   if (!isLength(length)) {
     collection = values(collection);
@@ -48,10 +49,10 @@ function includes(collection, target, fromIndex) {
   if (!length) {
     return false;
   }
-  if (typeof fromIndex == 'number') {
+  if (typeof fromIndex != 'number' || (guard && isIterateeCall(target, fromIndex, guard))) {
-    fromIndex = fromIndex < 0 ? nativeMax(length + fromIndex, 0) : (fromIndex || 0);
-  } else {
     fromIndex = 0;
+  } else {
+    fromIndex = fromIndex < 0 ? nativeMax(length + fromIndex, 0) : (fromIndex || 0);
   }
   return (typeof collection == 'string' || !isArray(collection) && isString(collection))
     ? (fromIndex < length && collection.indexOf(target, fromIndex) > -1)

collection/indexBy.js

@@ -4,17 +4,17 @@ import createAggregator from '../internal/createAggregator';
  * Creates an object composed of keys generated from the results of running
  * each element of `collection` through `iteratee`. The corresponding value
  * of each key is the last element responsible for generating the key. The
- * iteratee function is bound to `thisArg` and invoked with three arguments;
+ * iteratee function is bound to `thisArg` and invoked with three arguments:
  * (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created `_.property`
+ * If a property name is provided for `iteratee` the created `_.property`
  * style callback returns the property value of the given element.
  *
  * If a value is also provided for `thisArg` the created `_.matchesProperty`
  * style callback returns `true` for elements that have a matching property
  * value, else `false`.
  *
- * If an object is provided for `predicate` the created `_.matches` style
+ * If an object is provided for `iteratee` the created `_.matches` style
  * callback returns `true` for elements that have the properties of the given
  * object, else `false`.
  *

collection/invoke.js

@@ -1,5 +1,6 @@
-import baseInvoke from '../internal/baseInvoke';
+import baseEach from '../internal/baseEach';
-import baseSlice from '../internal/baseSlice';
+import isLength from '../internal/isLength';
+import restParam from '../function/restParam';
 
 /**
  * Invokes the method named by `methodName` on each element in `collection`,
@@ -23,8 +24,17 @@ import baseSlice from '../internal/baseSlice';
  * _.invoke([123, 456], String.prototype.split, '');
  * // => [['1', '2', '3'], ['4', '5', '6']]
  */
-function invoke(collection, methodName) {
+var invoke = restParam(function(collection, methodName, args) {
-  return baseInvoke(collection, methodName, baseSlice(arguments, 2));
+  var index = -1,
-}
+      isFunc = typeof methodName == 'function',
+      length = collection ? collection.length : 0,
+      result = isLength(length) ? Array(length) : [];
+
+  baseEach(collection, function(value) {
+    var func = isFunc ? methodName : (value != null && value[methodName]);
+    result[++index] = func ? func.apply(value, args) : undefined;
+  });
+  return result;
+});
 
 export default invoke;

collection/map.js

@@ -6,16 +6,16 @@ import isArray from '../lang/isArray';
 /**
  * Creates an array of values by running each element in `collection` through
  * `iteratee`. The `iteratee` is bound to `thisArg` and invoked with three
- * arguments; (value, index|key, collection).
+ * arguments: (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created `_.property`
+ * If a property name is provided for `iteratee` the created `_.property`
  * style callback returns the property value of the given element.
  *
  * If a value is also provided for `thisArg` the created `_.matchesProperty`
  * style callback returns `true` for elements that have a matching property
  * value, else `false`.
  *
- * If an object is provided for `predicate` the created `_.matches` style
+ * If an object is provided for `iteratee` the created `_.matches` style
  * callback returns `true` for elements that have the properties of the given
  * object, else `false`.
  *
@@ -24,9 +24,9 @@ import isArray from '../lang/isArray';
  *
  * The guarded methods are:
  * `ary`, `callback`, `chunk`, `clone`, `create`, `curry`, `curryRight`, `drop`,
- * `dropRight`, `fill`, `flatten`, `invert`, `max`, `min`, `parseInt`, `slice`,
+ * `dropRight`, `every`, `fill`, `flatten`, `invert`, `max`, `min`, `parseInt`,
- * `sortBy`, `take`, `takeRight`, `template`, `trim`, `trimLeft`, `trimRight`,
+ * `slice`, `sortBy`, `take`, `takeRight`, `template`, `trim`, `trimLeft`,
- * `trunc`, `random`, `range`, `sample`, `uniq`, and `words`
+ * `trimRight`, `trunc`, `random`, `range`, `sample`, `some`, `uniq`, and `words`
  *
  * @static
  * @memberOf _

collection/max.js

@@ -1,53 +1,2 @@
-import arrayMax from '../internal/arrayMax';
+import max from '../math/max'
-import createExtremum from '../internal/createExtremum';
-
-/**
- * Gets the maximum value of `collection`. If `collection` is empty or falsey
- * `-Infinity` is returned. If an iteratee function is provided it is invoked
- * for each value in `collection` to generate the criterion by which the value
- * is ranked. The `iteratee` is bound to `thisArg` and invoked with three
- * arguments; (value, index, collection).
- *
- * If a property name is provided for `predicate` the created `_.property`
- * style callback returns the property value of the given element.
- *
- * If a value is also provided for `thisArg` the created `_.matchesProperty`
- * style callback returns `true` for elements that have a matching property
- * value, else `false`.
- *
- * If an object is provided for `predicate` the created `_.matches` style
- * callback returns `true` for elements that have the properties of the given
- * object, else `false`.
- *
- * @static
- * @memberOf _
- * @category Collection
- * @param {Array|Object|string} collection The collection to iterate over.
- * @param {Function|Object|string} [iteratee] The function invoked per iteration.
- * @param {*} [thisArg] The `this` binding of `iteratee`.
- * @returns {*} Returns the maximum value.
- * @example
- *
- * _.max([4, 2, 8, 6]);
- * // => 8
- *
- * _.max([]);
- * // => -Infinity
- *
- * var users = [
- *   { 'user': 'barney', 'age': 36 },
- *   { 'user': 'fred',   'age': 40 }
- * ];
- *
- * _.max(users, function(chr) {
- *   return chr.age;
- * });
- * // => { 'user': 'fred', 'age': 40 };
- *
- * // using the `_.property` callback shorthand
- * _.max(users, 'age');
- * // => { 'user': 'fred', 'age': 40 };
- */
-var max = createExtremum(arrayMax);
-
 export default max;

collection/min.js

@@ -1,53 +1,2 @@
-import arrayMin from '../internal/arrayMin';
+import min from '../math/min'
-import createExtremum from '../internal/createExtremum';
-
-/**
- * Gets the minimum value of `collection`. If `collection` is empty or falsey
- * `Infinity` is returned. If an iteratee function is provided it is invoked
- * for each value in `collection` to generate the criterion by which the value
- * is ranked. The `iteratee` is bound to `thisArg` and invoked with three
- * arguments; (value, index, collection).
- *
- * If a property name is provided for `predicate` the created `_.property`
- * style callback returns the property value of the given element.
- *
- * If a value is also provided for `thisArg` the created `_.matchesProperty`
- * style callback returns `true` for elements that have a matching property
- * value, else `false`.
- *
- * If an object is provided for `predicate` the created `_.matches` style
- * callback returns `true` for elements that have the properties of the given
- * object, else `false`.
- *
- * @static
- * @memberOf _
- * @category Collection
- * @param {Array|Object|string} collection The collection to iterate over.
- * @param {Function|Object|string} [iteratee] The function invoked per iteration.
- * @param {*} [thisArg] The `this` binding of `iteratee`.
- * @returns {*} Returns the minimum value.
- * @example
- *
- * _.min([4, 2, 8, 6]);
- * // => 2
- *
- * _.min([]);
- * // => Infinity
- *
- * var users = [
- *   { 'user': 'barney', 'age': 36 },
- *   { 'user': 'fred',   'age': 40 }
- * ];
- *
- * _.min(users, function(chr) {
- *   return chr.age;
- * });
- * // => { 'user': 'barney', 'age': 36 };
- *
- * // using the `_.property` callback shorthand
- * _.min(users, 'age');
- * // => { 'user': 'barney', 'age': 36 };
- */
-var min = createExtremum(arrayMin, true);
-
 export default min;

collection/partition.js

@@ -4,7 +4,7 @@ import createAggregator from '../internal/createAggregator';
  * Creates an array of elements split into two groups, the first of which
  * contains elements `predicate` returns truthy for, while the second of which
  * contains elements `predicate` returns falsey for. The predicate is bound
- * to `thisArg` and invoked with three arguments; (value, index|key, collection).
+ * to `thisArg` and invoked with three arguments: (value, index|key, collection).
  *
  * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
@@ -35,7 +35,7 @@ import createAggregator from '../internal/createAggregator';
  * _.partition([1.2, 2.3, 3.4], function(n) {
  *   return this.floor(n) % 2;
  * }, Math);
- * // => [[1, 3], [2]]
+ * // => [[1.2, 3.4], [2.3]]
  *
  * var users = [
  *   { 'user': 'barney',  'age': 36, 'active': false },

collection/reduce.js

@@ -1,22 +1,20 @@
 import arrayReduce from '../internal/arrayReduce';
-import baseCallback from '../internal/baseCallback';
 import baseEach from '../internal/baseEach';
-import baseReduce from '../internal/baseReduce';
+import createReduce from '../internal/createReduce';
-import isArray from '../lang/isArray';
 
 /**
  * Reduces `collection` to a value which is the accumulated result of running
  * each element in `collection` through `iteratee`, where each successive
  * invocation is supplied the return value of the previous. If `accumulator`
  * is not provided the first element of `collection` is used as the initial
- * value. The `iteratee` is bound to `thisArg`and invoked with four arguments;
+ * value. The `iteratee` is bound to `thisArg` and invoked with four arguments:
  * (accumulator, value, index|key, collection).
  *
  * Many lodash methods are guarded to work as interatees for methods like
  * `_.reduce`, `_.reduceRight`, and `_.transform`.
  *
  * The guarded methods are:
- * `assign`, `defaults`, `merge`, and `sortAllBy`
+ * `assign`, `defaults`, `includes`, `merge`, `sortByAll`, and `sortByOrder`
  *
  * @static
  * @memberOf _
@@ -40,9 +38,6 @@ import isArray from '../lang/isArray';
  * }, {});
  * // => { 'a': 3, 'b': 6 } (iteration order is not guaranteed)
  */
-function reduce(collection, iteratee, accumulator, thisArg) {
+var reduce = createReduce(arrayReduce, baseEach);
-  var func = isArray(collection) ? arrayReduce : baseReduce;
-  return func(collection, baseCallback(iteratee, thisArg, 4), accumulator, arguments.length < 3, baseEach);
-}
 
 export default reduce;

collection/reduceRight.js

@@ -1,8 +1,6 @@
 import arrayReduceRight from '../internal/arrayReduceRight';
-import baseCallback from '../internal/baseCallback';
 import baseEachRight from '../internal/baseEachRight';
-import baseReduce from '../internal/baseReduce';
+import createReduce from '../internal/createReduce';
-import isArray from '../lang/isArray';
 
 /**
  * This method is like `_.reduce` except that it iterates over elements of
@@ -26,9 +24,6 @@ import isArray from '../lang/isArray';
  * }, []);
  * // => [4, 5, 2, 3, 0, 1]
  */
-function reduceRight(collection, iteratee, accumulator, thisArg) {
+var reduceRight =  createReduce(arrayReduceRight, baseEachRight);
-  var func = isArray(collection) ? arrayReduceRight : baseReduce;
-  return func(collection, baseCallback(iteratee, thisArg, 4), accumulator, arguments.length < 3, baseEachRight);
-}
 
 export default reduceRight;

collection/shuffle.js

@@ -2,9 +2,8 @@ import baseRandom from '../internal/baseRandom';
 import toIterable from '../internal/toIterable';
 
 /**
- * Creates an array of shuffled values, using a version of the Fisher-Yates
+ * Creates an array of shuffled values, using a version of the
- * shuffle. See [Wikipedia](https://en.wikipedia.org/wiki/Fisher-Yates_shuffle)
+ * [Fisher-Yates shuffle](https://en.wikipedia.org/wiki/Fisher-Yates_shuffle).
- * for more details.
  *
  * @static
  * @memberOf _

collection/size.js

@@ -2,8 +2,8 @@ import isLength from '../internal/isLength';
 import keys from '../object/keys';
 
 /**
- * Gets the size of `collection` by returning `collection.length` for
+ * Gets the size of `collection` by returning its length for array-like
- * array-like values or the number of own enumerable properties for objects.
+ * values or the number of own enumerable properties for objects.
  *
  * @static
  * @memberOf _

collection/some.js

@@ -2,12 +2,13 @@ import arraySome from '../internal/arraySome';
 import baseCallback from '../internal/baseCallback';
 import baseSome from '../internal/baseSome';
 import isArray from '../lang/isArray';
+import isIterateeCall from '../internal/isIterateeCall';
 
 /**
  * Checks if `predicate` returns truthy for **any** element of `collection`.
  * The function returns as soon as it finds a passing value and does not iterate
  * over the entire collection. The predicate is bound to `thisArg` and invoked
- * with three arguments; (value, index|key, collection).
+ * with three arguments: (value, index|key, collection).
  *
  * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
@@ -54,6 +55,9 @@ import isArray from '../lang/isArray';
  */
 function some(collection, predicate, thisArg) {
   var func = isArray(collection) ? arraySome : baseSome;
+  if (thisArg && isIterateeCall(collection, predicate, thisArg)) {
+    predicate = null;
+  }
   if (typeof predicate != 'function' || typeof thisArg != 'undefined') {
     predicate = baseCallback(predicate, thisArg, 3);
   }

collection/sortBy.js

@@ -9,17 +9,17 @@ import isLength from '../internal/isLength';
  * Creates an array of elements, sorted in ascending order by the results of
  * running each element in a collection through `iteratee`. This method performs
  * a stable sort, that is, it preserves the original sort order of equal elements.
- * The `iteratee` is bound to `thisArg` and invoked with three arguments;
+ * The `iteratee` is bound to `thisArg` and invoked with three arguments:
  * (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created `_.property`
+ * If a property name is provided for `iteratee` the created `_.property`
  * style callback returns the property value of the given element.
  *
  * If a value is also provided for `thisArg` the created `_.matchesProperty`
  * style callback returns `true` for elements that have a matching property
  * value, else `false`.
  *
- * If an object is provided for `predicate` the created `_.matches` style
+ * If an object is provided for `iteratee` the created `_.matches` style
  * callback returns `true` for elements that have the properties of the given
  * object, else `false`.
  *
@@ -55,8 +55,11 @@ import isLength from '../internal/isLength';
  * // => ['barney', 'fred', 'pebbles']
  */
 function sortBy(collection, iteratee, thisArg) {
+  if (collection == null) {
+    return [];
+  }
   var index = -1,
-      length = collection ? collection.length : 0,
+      length = collection.length,
       result = isLength(length) ? Array(length) : [];
 
   if (thisArg && isIterateeCall(collection, iteratee, thisArg)) {

collection/sortByAll.js

@@ -1,9 +1,6 @@
-import baseEach from '../internal/baseEach';
 import baseFlatten from '../internal/baseFlatten';
-import baseSortBy from '../internal/baseSortBy';
+import baseSortByOrder from '../internal/baseSortByOrder';
-import compareMultipleAscending from '../internal/compareMultipleAscending';
 import isIterateeCall from '../internal/isIterateeCall';
-import isLength from '../internal/isLength';
 
 /**
  * This method is like `_.sortBy` except that it sorts by property names
@@ -28,26 +25,24 @@ import isLength from '../internal/isLength';
  * _.map(_.sortByAll(users, ['user', 'age']), _.values);
  * // => [['barney', 26], ['barney', 36], ['fred', 30], ['fred', 40]]
  */
-function sortByAll(collection) {
+function sortByAll() {
-  var args = arguments;
+  var args = arguments,
-  if (args.length > 3 && isIterateeCall(args[1], args[2], args[3])) {
+      collection = args[0],
-    args = [collection, args[1]];
+      guard = args[3],
+      index = 0,
+      length = args.length - 1;
+
+  if (collection == null) {
+    return [];
   }
-  var index = -1,
+  var props = Array(length);
-      length = collection ? collection.length : 0,
+  while (index < length) {
-      props = baseFlatten(args, false, false, 1),
+    props[index] = args[++index];
-      result = isLength(length) ? Array(length) : [];
+  }
-
+  if (guard && isIterateeCall(args[1], args[2], guard)) {
-  baseEach(collection, function(value) {
+    props = args[1];
-    var length = props.length,
+  }
-        criteria = Array(length);
+  return baseSortByOrder(collection, baseFlatten(props), []);
-
-    while (length--) {
-      criteria[length] = value == null ? undefined : value[props[length]];
-    }
-    result[++index] = { 'criteria': criteria, 'index': index, 'value': value };
-  });
-  return baseSortBy(result, compareMultipleAscending);
 }
 
 export default sortByAll;

collection/sortByOrder.js

@@ -0,0 +1,48 @@
+import baseSortByOrder from '../internal/baseSortByOrder';
+import isArray from '../lang/isArray';
+import isIterateeCall from '../internal/isIterateeCall';
+
+/**
+ * This method is like `_.sortByAll` except that it allows specifying the
+ * sort orders of the property names to sort by. A truthy value in `orders`
+ * will sort the corresponding property name in ascending order while a
+ * falsey value will sort it in descending order.
+ *
+ * @static
+ * @memberOf _
+ * @category Collection
+ * @param {Array|Object|string} collection The collection to iterate over.
+ * @param {string[]} props The property names to sort by.
+ * @param {boolean[]} orders The sort orders of `props`.
+ * @param- {Object} [guard] Enables use as a callback for functions like `_.reduce`.
+ * @returns {Array} Returns the new sorted array.
+ * @example
+ *
+ * var users = [
+ *   { 'user': 'barney', 'age': 26 },
+ *   { 'user': 'fred',   'age': 40 },
+ *   { 'user': 'barney', 'age': 36 },
+ *   { 'user': 'fred',   'age': 30 }
+ * ];
+ *
+ * // sort by `user` in ascending order and by `age` in descending order
+ * _.map(_.sortByOrder(users, ['user', 'age'], [true, false]), _.values);
+ * // => [['barney', 36], ['barney', 26], ['fred', 40], ['fred', 30]]
+ */
+function sortByOrder(collection, props, orders, guard) {
+  if (collection == null) {
+    return [];
+  }
+  if (guard && isIterateeCall(props, orders, guard)) {
+    orders = null;
+  }
+  if (!isArray(props)) {
+    props = props == null ? [] : [props];
+  }
+  if (!isArray(orders)) {
+    orders = orders == null ? [] : [orders];
+  }
+  return baseSortByOrder(collection, props, orders);
+}
+
+export default sortByOrder;

collection/sum.js

@@ -0,0 +1,2 @@
+import sum from '../math/sum'
+export default sum;

function.js

@@ -19,6 +19,7 @@ import once from './function/once';
 import partial from './function/partial';
 import partialRight from './function/partialRight';
 import rearg from './function/rearg';
+import restParam from './function/restParam';
 import spread from './function/spread';
 import throttle from './function/throttle';
 import wrap from './function/wrap';
@@ -45,6 +46,7 @@ export default {
   'partial': partial,
   'partialRight': partialRight,
   'rearg': rearg,
+  'restParam': restParam,
   'spread': spread,
   'throttle': throttle,
   'wrap': wrap

function/ary.js

@@ -2,7 +2,7 @@ import createWrapper from '../internal/createWrapper';
 import isIterateeCall from '../internal/isIterateeCall';
 
 /** Used to compose bitmasks for wrapper metadata. */
-var ARY_FLAG = 256;
+var ARY_FLAG = 128;
 
 /* Native method references for those with the same name as other `lodash` methods. */
 var nativeMax = Math.max;

function/bind.js

@@ -1,6 +1,6 @@
-import baseSlice from '../internal/baseSlice';
 import createWrapper from '../internal/createWrapper';
 import replaceHolders from '../internal/replaceHolders';
+import restParam from './restParam';
 
 /** Used to compose bitmasks for wrapper metadata. */
 var BIND_FLAG = 1,
@@ -22,7 +22,7 @@ var BIND_FLAG = 1,
  * @category Function
  * @param {Function} func The function to bind.
  * @param {*} thisArg The `this` binding of `func`.
- * @param {...*} [args] The arguments to be partially applied.
+ * @param {...*} [partials] The arguments to be partially applied.
  * @returns {Function} Returns the new bound function.
  * @example
  *
@@ -41,16 +41,14 @@ var BIND_FLAG = 1,
  * bound('hi');
  * // => 'hi fred!'
  */
-function bind(func, thisArg) {
+var bind = restParam(function(func, thisArg, partials) {
   var bitmask = BIND_FLAG;
-  if (arguments.length > 2) {
+  if (partials.length) {
-    var partials = baseSlice(arguments, 2),
+    var holders = replaceHolders(partials, bind.placeholder);
-        holders = replaceHolders(partials, bind.placeholder);
-
     bitmask |= PARTIAL_FLAG;
   }
   return createWrapper(func, bitmask, thisArg, partials, holders);
-}
+});
 
 // Assign default placeholders.
 bind.placeholder = {};

function/bindAll.js

@@ -1,6 +1,10 @@
-import baseBindAll from '../internal/baseBindAll';
 import baseFlatten from '../internal/baseFlatten';
+import createWrapper from '../internal/createWrapper';
 import functions from '../object/functions';
+import restParam from './restParam';
+
+/** Used to compose bitmasks for wrapper metadata. */
+var BIND_FLAG = 1;
 
 /**
  * Binds methods of an object to the object itself, overwriting the existing
@@ -30,12 +34,17 @@ import functions from '../object/functions';
  * jQuery('#docs').on('click', view.onClick);
  * // => logs 'clicked docs' when the element is clicked
  */
-function bindAll(object) {
+var bindAll = restParam(function(object, methodNames) {
-  return baseBindAll(object,
+  methodNames = methodNames.length ? baseFlatten(methodNames) : functions(object);
-    arguments.length > 1
+
-      ? baseFlatten(arguments, false, false, 1)
+  var index = -1,
-      : functions(object)
+      length = methodNames.length;
-  );
+
-}
+  while (++index < length) {
+    var key = methodNames[index];
+    object[key] = createWrapper(object[key], BIND_FLAG, object);
+  }
+  return object;
+});
 
 export default bindAll;

function/bindKey.js

@@ -1,6 +1,6 @@
-import baseSlice from '../internal/baseSlice';
 import createWrapper from '../internal/createWrapper';
 import replaceHolders from '../internal/replaceHolders';
+import restParam from './restParam';
 
 /** Used to compose bitmasks for wrapper metadata. */
 var BIND_FLAG = 1,
@@ -24,7 +24,7 @@ var BIND_FLAG = 1,
  * @category Function
  * @param {Object} object The object the method belongs to.
  * @param {string} key The key of the method.
- * @param {...*} [args] The arguments to be partially applied.
+ * @param {...*} [partials] The arguments to be partially applied.
  * @returns {Function} Returns the new bound function.
  * @example
  *
@@ -51,16 +51,14 @@ var BIND_FLAG = 1,
  * bound('hi');
  * // => 'hiya fred!'
  */
-function bindKey(object, key) {
+var bindKey = restParam(function(object, key, partials) {
   var bitmask = BIND_FLAG | BIND_KEY_FLAG;
-  if (arguments.length > 2) {
+  if (partials.length) {
-    var partials = baseSlice(arguments, 2),
+    var holders = replaceHolders(partials, bindKey.placeholder);
-        holders = replaceHolders(partials, bindKey.placeholder);
-
     bitmask |= PARTIAL_FLAG;
   }
   return createWrapper(key, bitmask, object, partials, holders);
-}
+});
 
 // Assign default placeholders.
 bindKey.placeholder = {};

function/curry.js

@@ -1,5 +1,4 @@
-import createWrapper from '../internal/createWrapper';
+import createCurry from '../internal/createCurry';
-import isIterateeCall from '../internal/isIterateeCall';
 
 /** Used to compose bitmasks for wrapper metadata. */
 var CURRY_FLAG = 8;
@@ -44,14 +43,7 @@ var CURRY_FLAG = 8;
  * curried(1)(_, 3)(2);
  * // => [1, 2, 3]
  */
-function curry(func, arity, guard) {
+var curry = createCurry(CURRY_FLAG);
-  if (guard && isIterateeCall(func, arity, guard)) {
-    arity = null;
-  }
-  var result = createWrapper(func, CURRY_FLAG, null, null, null, null, null, arity);
-  result.placeholder = curry.placeholder;
-  return result;
-}
 
 // Assign default placeholders.
 curry.placeholder = {};

function/curryRight.js

@@ -1,5 +1,4 @@
-import createWrapper from '../internal/createWrapper';
+import createCurry from '../internal/createCurry';
-import isIterateeCall from '../internal/isIterateeCall';
 
 /** Used to compose bitmasks for wrapper metadata. */
 var CURRY_RIGHT_FLAG = 16;
@@ -41,14 +40,7 @@ var CURRY_RIGHT_FLAG = 16;
  * curried(3)(1, _)(2);
  * // => [1, 2, 3]
  */
-function curryRight(func, arity, guard) {
+var curryRight = createCurry(CURRY_RIGHT_FLAG);
-  if (guard && isIterateeCall(func, arity, guard)) {
-    arity = null;
-  }
-  var result = createWrapper(func, CURRY_RIGHT_FLAG, null, null, null, null, null, arity);
-  result.placeholder = curryRight.placeholder;
-  return result;
-}
 
 // Assign default placeholders.
 curryRight.placeholder = {};

function/defer.js

@@ -1,4 +1,5 @@
 import baseDelay from '../internal/baseDelay';
+import restParam from './restParam';
 
 /**
  * Defers invoking the `func` until the current call stack has cleared. Any
@@ -17,8 +18,8 @@ import baseDelay from '../internal/baseDelay';
  * }, 'deferred');
  * // logs 'deferred' after one or more milliseconds
  */
-function defer(func) {
+var defer = restParam(function(func, args) {
-  return baseDelay(func, 1, arguments, 1);
+  return baseDelay(func, 1, args);
-}
+});
 
 export default defer;

function/delay.js

@@ -1,4 +1,5 @@
 import baseDelay from '../internal/baseDelay';
+import restParam from './restParam';
 
 /**
  * Invokes `func` after `wait` milliseconds. Any additional arguments are
@@ -18,8 +19,8 @@ import baseDelay from '../internal/baseDelay';
  * }, 1000, 'later');
  * // => logs 'later' after one second
  */
-function delay(func, wait) {
+var delay = restParam(function(func, wait, args) {
-  return baseDelay(func, wait, arguments, 2);
+  return baseDelay(func, wait, args);
-}
+});
 
 export default delay;

function/flow.js

@@ -1,8 +1,4 @@
-import arrayEvery from '../internal/arrayEvery';
+import createFlow from '../internal/createFlow';
-import baseIsFunction from '../internal/baseIsFunction';
-
-/** Used as the `TypeError` message for "Functions" methods. */
-var FUNC_ERROR_TEXT = 'Expected a function';
 
 /**
  * Creates a function that returns the result of invoking the provided
@@ -16,37 +12,14 @@ var FUNC_ERROR_TEXT = 'Expected a function';
  * @returns {Function} Returns the new function.
  * @example
  *
- * function add(x, y) {
- *   return x + y;
- * }
- *
  * function square(n) {
  *   return n * n;
  * }
  *
- * var addSquare = _.flow(add, square);
+ * var addSquare = _.flow(_.add, square);
  * addSquare(1, 2);
  * // => 9
  */
-function flow() {
+var flow = createFlow();
-  var funcs = arguments,
-      length = funcs.length;
-
-  if (!length) {
-    return function() { return arguments[0]; };
-  }
-  if (!arrayEvery(funcs, baseIsFunction)) {
-    throw new TypeError(FUNC_ERROR_TEXT);
-  }
-  return function() {
-    var index = 0,
-        result = funcs[index].apply(this, arguments);
-
-    while (++index < length) {
-      result = funcs[index].call(this, result);
-    }
-    return result;
-  };
-}
 
 export default flow;

function/flowRight.js

@@ -1,8 +1,4 @@
-import arrayEvery from '../internal/arrayEvery';
+import createFlow from '../internal/createFlow';
-import baseIsFunction from '../internal/baseIsFunction';
-
-/** Used as the `TypeError` message for "Functions" methods. */
-var FUNC_ERROR_TEXT = 'Expected a function';
 
 /**
  * This method is like `_.flow` except that it creates a function that
@@ -16,37 +12,14 @@ var FUNC_ERROR_TEXT = 'Expected a function';
  * @returns {Function} Returns the new function.
  * @example
  *
- * function add(x, y) {
- *   return x + y;
- * }
- *
  * function square(n) {
  *   return n * n;
  * }
  *
- * var addSquare = _.flowRight(square, add);
+ * var addSquare = _.flowRight(square, _.add);
  * addSquare(1, 2);
  * // => 9
  */
-function flowRight() {
+var flowRight = createFlow(true);
-  var funcs = arguments,
-      fromIndex = funcs.length - 1;
-
-  if (fromIndex < 0) {
-    return function() { return arguments[0]; };
-  }
-  if (!arrayEvery(funcs, baseIsFunction)) {
-    throw new TypeError(FUNC_ERROR_TEXT);
-  }
-  return function() {
-    var index = fromIndex,
-        result = funcs[index].apply(this, arguments);
-
-    while (index--) {
-      result = funcs[index].call(this, result);
-    }
-    return result;
-  };
-}
 
 export default flowRight;

function/memoize.js

@@ -13,10 +13,8 @@ var FUNC_ERROR_TEXT = 'Expected a function';
  *
  * **Note:** The cache is exposed as the `cache` property on the memoized
  * function. Its creation may be customized by replacing the `_.memoize.Cache`
- * constructor with one whose instances implement the ES `Map` method interface
+ * constructor with one whose instances implement the [`Map`](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-properties-of-the-map-prototype-object)
- * of `get`, `has`, and `set`. See the
+ * method interface of `get`, `has`, and `set`.
- * [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-properties-of-the-map-prototype-object)
- * for more details.
  *
  * @static
  * @memberOf _
@@ -61,13 +59,14 @@ function memoize(func, resolver) {
     throw new TypeError(FUNC_ERROR_TEXT);
   }
   var memoized = function() {
-    var cache = memoized.cache,
+    var args = arguments,
-        key = resolver ? resolver.apply(this, arguments) : arguments[0];
+        cache = memoized.cache,
+        key = resolver ? resolver.apply(this, args) : args[0];
 
     if (cache.has(key)) {
       return cache.get(key);
     }
-    var result = func.apply(this, arguments);
+    var result = func.apply(this, args);
     cache.set(key, result);
     return result;
   };

function/once.js

@@ -3,7 +3,7 @@ import before from './before';
 /**
  * Creates a function that is restricted to invoking `func` once. Repeat calls
  * to the function return the value of the first call. The `func` is invoked
- * with the `this` binding of the created function.
+ * with the `this` binding and arguments of the created function.
  *
  * @static
  * @memberOf _

function/partial.js

@@ -1,6 +1,4 @@
-import baseSlice from '../internal/baseSlice';
+import createPartial from '../internal/createPartial';
-import createWrapper from '../internal/createWrapper';
-import replaceHolders from '../internal/replaceHolders';
 
 /** Used to compose bitmasks for wrapper metadata. */
 var PARTIAL_FLAG = 32;
@@ -20,7 +18,7 @@ var PARTIAL_FLAG = 32;
  * @memberOf _
  * @category Function
  * @param {Function} func The function to partially apply arguments to.
- * @param {...*} [args] The arguments to be partially applied.
+ * @param {...*} [partials] The arguments to be partially applied.
  * @returns {Function} Returns the new partially applied function.
  * @example
  *
@@ -37,12 +35,7 @@ var PARTIAL_FLAG = 32;
  * greetFred('hi');
  * // => 'hi fred'
  */
-function partial(func) {
+var partial = createPartial(PARTIAL_FLAG);
-  var partials = baseSlice(arguments, 1),
-      holders = replaceHolders(partials, partial.placeholder);
-
-  return createWrapper(func, PARTIAL_FLAG, null, partials, holders);
-}
 
 // Assign default placeholders.
 partial.placeholder = {};

function/partialRight.js

@@ -1,6 +1,4 @@
-import baseSlice from '../internal/baseSlice';
+import createPartial from '../internal/createPartial';
-import createWrapper from '../internal/createWrapper';
-import replaceHolders from '../internal/replaceHolders';
 
 /** Used to compose bitmasks for wrapper metadata. */
 var PARTIAL_RIGHT_FLAG = 64;
@@ -19,7 +17,7 @@ var PARTIAL_RIGHT_FLAG = 64;
  * @memberOf _
  * @category Function
  * @param {Function} func The function to partially apply arguments to.
- * @param {...*} [args] The arguments to be partially applied.
+ * @param {...*} [partials] The arguments to be partially applied.
  * @returns {Function} Returns the new partially applied function.
  * @example
  *
@@ -36,12 +34,7 @@ var PARTIAL_RIGHT_FLAG = 64;
  * sayHelloTo('fred');
  * // => 'hello fred'
  */
-function partialRight(func) {
+var partialRight = createPartial(PARTIAL_RIGHT_FLAG);
-  var partials = baseSlice(arguments, 1),
-      holders = replaceHolders(partials, partialRight.placeholder);
-
-  return createWrapper(func, PARTIAL_RIGHT_FLAG, null, partials, holders);
-}
 
 // Assign default placeholders.
 partialRight.placeholder = {};

function/rearg.js

@@ -1,8 +1,9 @@
 import baseFlatten from '../internal/baseFlatten';
 import createWrapper from '../internal/createWrapper';
+import restParam from './restParam';
 
 /** Used to compose bitmasks for wrapper metadata. */
-var REARG_FLAG = 128;
+var REARG_FLAG = 256;
 
 /**
  * Creates a function that invokes `func` with arguments arranged according
@@ -32,9 +33,8 @@ var REARG_FLAG = 128;
  * }, [1, 2, 3]);
  * // => [3, 6, 9]
  */
-function rearg(func) {
+var rearg = restParam(function(func, indexes) {
-  var indexes = baseFlatten(arguments, false, false, 1);
+  return createWrapper(func, REARG_FLAG, null, null, null, baseFlatten(indexes));
-  return createWrapper(func, REARG_FLAG, null, null, null, indexes);
+});
-}
 
 export default rearg;

function/restParam.js

@@ -0,0 +1,58 @@
+/** Used as the `TypeError` message for "Functions" methods. */
+var FUNC_ERROR_TEXT = 'Expected a function';
+
+/* Native method references for those with the same name as other `lodash` methods. */
+var nativeMax = Math.max;
+
+/**
+ * Creates a function that invokes `func` with the `this` binding of the
+ * created function and arguments from `start` and beyond provided as an array.
+ *
+ * **Note:** This method is based on the [rest parameter](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/rest_parameters).
+ *
+ * @static
+ * @memberOf _
+ * @category Function
+ * @param {Function} func The function to apply a rest parameter to.
+ * @param {number} [start=func.length-1] The start position of the rest parameter.
+ * @returns {Function} Returns the new function.
+ * @example
+ *
+ * var say = _.restParam(function(what, names) {
+ *   return what + ' ' + _.initial(names).join(', ') +
+ *     (_.size(names) > 1 ? ', & ' : '') + _.last(names);
+ * });
+ *
+ * say('hello', 'fred', 'barney', 'pebbles');
+ * // => 'hello fred, barney, & pebbles'
+ */
+function restParam(func, start) {
+  if (typeof func != 'function') {
+    throw new TypeError(FUNC_ERROR_TEXT);
+  }
+  start = nativeMax(typeof start == 'undefined' ? (func.length - 1) : (+start || 0), 0);
+  return function() {
+    var args = arguments,
+        index = -1,
+        length = nativeMax(args.length - start, 0),
+        rest = Array(length);
+
+    while (++index < length) {
+      rest[index] = args[start + index];
+    }
+    switch (start) {
+      case 0: return func.call(this, rest);
+      case 1: return func.call(this, args[0], rest);
+      case 2: return func.call(this, args[0], args[1], rest);
+    }
+    var otherArgs = Array(start + 1);
+    index = -1;
+    while (++index < start) {
+      otherArgs[index] = args[index];
+    }
+    otherArgs[start] = rest;
+    return func.apply(this, otherArgs);
+  };
+}
+
+export default restParam;

function/spread.js

@@ -2,23 +2,24 @@
 var FUNC_ERROR_TEXT = 'Expected a function';
 
 /**
- * Creates a function that invokes `func` with the `this` binding of the
+ * Creates a function that invokes `func` with the `this` binding of the created
- * created function and the array of arguments provided to the created
+ * function and an array of arguments much like [`Function#apply`](https://es5.github.io/#x15.3.4.3).
- * function much like [Function#apply](http://es5.github.io/#x15.3.4.3).
+ *
+ * **Note:** This method is based on the [spread operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Spread_operator).
  *
  * @static
  * @memberOf _
  * @category Function
  * @param {Function} func The function to spread arguments over.
- * @returns {*} Returns the new function.
+ * @returns {Function} Returns the new function.
  * @example
  *
- * var spread = _.spread(function(who, what) {
+ * var say = _.spread(function(who, what) {
  *   return who + ' says ' + what;
  * });
  *
- * spread(['Fred', 'hello']);
+ * say(['fred', 'hello']);
- * // => 'Fred says hello'
+ * // => 'fred says hello'
  *
  * // with a Promise
  * var numbers = Promise.all([

internal/arrayEach.js

@@ -1,6 +1,6 @@
 /**
  * A specialized version of `_.forEach` for arrays without support for callback
- * shorthands or `this` binding.
+ * shorthands and `this` binding.
  *
  * @private
  * @param {Array} array The array to iterate over.

internal/arrayEachRight.js

@@ -1,6 +1,6 @@
 /**
  * A specialized version of `_.forEachRight` for arrays without support for
- * callback shorthands or `this` binding.
+ * callback shorthands and `this` binding.
  *
  * @private
  * @param {Array} array The array to iterate over.

internal/arrayEvery.js

@@ -1,6 +1,6 @@
 /**
  * A specialized version of `_.every` for arrays without support for callback
- * shorthands or `this` binding.
+ * shorthands and `this` binding.
  *
  * @private
  * @param {Array} array The array to iterate over.

internal/arrayFilter.js

@@ -1,6 +1,6 @@
 /**
  * A specialized version of `_.filter` for arrays without support for callback
- * shorthands or `this` binding.
+ * shorthands and `this` binding.
  *
  * @private
  * @param {Array} array The array to iterate over.

internal/arrayMap.js

@@ -1,6 +1,6 @@
 /**
  * A specialized version of `_.map` for arrays without support for callback
- * shorthands or `this` binding.
+ * shorthands and `this` binding.
  *
  * @private
  * @param {Array} array The array to iterate over.

internal/arrayReduce.js

@@ -1,6 +1,6 @@
 /**
  * A specialized version of `_.reduce` for arrays without support for callback
- * shorthands or `this` binding.
+ * shorthands and `this` binding.
  *
  * @private
  * @param {Array} array The array to iterate over.

internal/arrayReduceRight.js

@@ -1,6 +1,6 @@
 /**
  * A specialized version of `_.reduceRight` for arrays without support for
- * callback shorthands or `this` binding.
+ * callback shorthands and `this` binding.
  *
  * @private
  * @param {Array} array The array to iterate over.

internal/arraySome.js

@@ -1,6 +1,6 @@
 /**
  * A specialized version of `_.some` for arrays without support for callback
- * shorthands or `this` binding.
+ * shorthands and `this` binding.
  *
  * @private
  * @param {Array} array The array to iterate over.

internal/arraySum.js

@@ -0,0 +1,18 @@
+/**
+ * A specialized version of `_.sum` for arrays without support for iteratees.
+ *
+ * @private
+ * @param {Array} array The array to iterate over.
+ * @returns {number} Returns the sum.
+ */
+function arraySum(array) {
+  var length = array.length,
+      result = 0;
+
+  while (length--) {
+    result += +array[length] || 0;
+  }
+  return result;
+}
+
+export default arraySum;

internal/baseAssign.js

@@ -24,7 +24,7 @@ function baseAssign(object, source, customizer) {
         value = object[key],
         result = customizer(value, source[key], key, object, source);
 
-    if ((result === result ? result !== value : value === value) ||
+    if ((result === result ? (result !== value) : (value === value)) ||
         (typeof value == 'undefined' && !(key in object))) {
       object[key] = result;
     }

internal/baseBindAll.js

@@ -1,26 +0,0 @@
-import createWrapper from './createWrapper';
-
-/** Used to compose bitmasks for wrapper metadata. */
-var BIND_FLAG = 1;
-
-/**
- * The base implementation of `_.bindAll` without support for individual
- * method name arguments.
- *
- * @private
- * @param {Object} object The object to bind and assign the bound methods to.
- * @param {string[]} methodNames The object method names to bind.
- * @returns {Object} Returns `object`.
- */
-function baseBindAll(object, methodNames) {
-  var index = -1,
-      length = methodNames.length;
-
-  while (++index < length) {
-    var key = methodNames[index];
-    object[key] = createWrapper(object[key], BIND_FLAG, object);
-  }
-  return object;
-}
-
-export default baseBindAll;

internal/baseCallback.js

@@ -3,7 +3,6 @@ import baseMatchesProperty from './baseMatchesProperty';
 import baseProperty from './baseProperty';
 import bindCallback from './bindCallback';
 import identity from '../utility/identity';
-import isBindable from './isBindable';
 
 /**
  * The base implementation of `_.callback` which supports specifying the
@@ -18,9 +17,9 @@ import isBindable from './isBindable';
 function baseCallback(func, thisArg, argCount) {
   var type = typeof func;
   if (type == 'function') {
-    return (typeof thisArg != 'undefined' && isBindable(func))
+    return typeof thisArg == 'undefined'
-      ? bindCallback(func, thisArg, argCount)
+      ? func
-      : func;
+      : bindCallback(func, thisArg, argCount);
   }
   if (func == null) {
     return identity;

internal/baseClone.js

@@ -54,9 +54,8 @@ cloneableTags[weakMapTag] = false;
 var objectProto = Object.prototype;
 
 /**
- * Used to resolve the `toStringTag` of values.
+ * Used to resolve the [`toStringTag`](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-object.prototype.tostring)
- * See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-object.prototype.tostring)
+ * of values.
- * for more details.
  */
 var objToString = objectProto.toString;
 

internal/baseDelay.js

@@ -1,5 +1,3 @@
-import baseSlice from './baseSlice';
-
 /** Used as the `TypeError` message for "Functions" methods. */
 var FUNC_ERROR_TEXT = 'Expected a function';
 
@@ -10,14 +8,14 @@ var FUNC_ERROR_TEXT = 'Expected a function';
  * @private
  * @param {Function} func The function to delay.
  * @param {number} wait The number of milliseconds to delay invocation.
- * @param {Object} args The `arguments` object to slice and provide to `func`.
+ * @param {Object} args The arguments provide to `func`.
  * @returns {number} Returns the timer id.
  */
-function baseDelay(func, wait, args, fromIndex) {
+function baseDelay(func, wait, args) {
   if (typeof func != 'function') {
     throw new TypeError(FUNC_ERROR_TEXT);
   }
-  return setTimeout(function() { func.apply(undefined, baseSlice(args, fromIndex)); }, wait);
+  return setTimeout(function() { func.apply(undefined, args); }, wait);
 }
 
 export default baseDelay;

internal/baseDifference.js

@@ -42,7 +42,7 @@ function baseDifference(array, values) {
       }
       result.push(value);
     }
-    else if (indexOf(values, value) < 0) {
+    else if (indexOf(values, value, 0) < 0) {
       result.push(value);
     }
   }

internal/baseEach.js

@@ -1,6 +1,5 @@
 import baseForOwn from './baseForOwn';
-import isLength from './isLength';
+import createBaseEach from './createBaseEach';
-import toObject from './toObject';
 
 /**
  * The base implementation of `_.forEach` without support for callback
@@ -11,20 +10,6 @@ import toObject from './toObject';
  * @param {Function} iteratee The function invoked per iteration.
  * @returns {Array|Object|string} Returns `collection`.
  */
-function baseEach(collection, iteratee) {
+var baseEach = createBaseEach(baseForOwn);
-  var length = collection ? collection.length : 0;
-  if (!isLength(length)) {
-    return baseForOwn(collection, iteratee);
-  }
-  var index = -1,
-      iterable = toObject(collection);
-
-  while (++index < length) {
-    if (iteratee(iterable[index], index, iterable) === false) {
-      break;
-    }
-  }
-  return collection;
-}
 
 export default baseEach;

internal/baseEachRight.js

@@ -1,6 +1,5 @@
 import baseForOwnRight from './baseForOwnRight';
-import isLength from './isLength';
+import createBaseEach from './createBaseEach';
-import toObject from './toObject';
 
 /**
  * The base implementation of `_.forEachRight` without support for callback
@@ -11,18 +10,6 @@ import toObject from './toObject';
  * @param {Function} iteratee The function invoked per iteration.
  * @returns {Array|Object|string} Returns `collection`.
  */
-function baseEachRight(collection, iteratee) {
+var baseEachRight = createBaseEach(baseForOwnRight, true);
-  var length = collection ? collection.length : 0;
-  if (!isLength(length)) {
-    return baseForOwnRight(collection, iteratee);
-  }
-  var iterable = toObject(collection);
-  while (length--) {
-    if (iteratee(iterable[length], length, iterable) === false) {
-      break;
-    }
-  }
-  return collection;
-}
 
 export default baseEachRight;

internal/baseEvery.js

@@ -2,7 +2,7 @@ import baseEach from './baseEach';
 
 /**
  * The base implementation of `_.every` without support for callback
- * shorthands or `this` binding.
+ * shorthands and `this` binding.
  *
  * @private
  * @param {Array|Object|string} collection The collection to iterate over.

internal/baseFill.js

@@ -19,7 +19,7 @@ function baseFill(array, value, start, end) {
   if (end < 0) {
     end += length;
   }
-  length = start > end ? 0 : end >>> 0;
+  length = start > end ? 0 : (end >>> 0);
   start >>>= 0;
 
   while (start < length) {

internal/baseFilter.js

@@ -2,7 +2,7 @@ import baseEach from './baseEach';
 
 /**
  * The base implementation of `_.filter` without support for callback
- * shorthands or `this` binding.
+ * shorthands and `this` binding.
  *
  * @private
  * @param {Array|Object|string} collection The collection to iterate over.

internal/baseFindIndex.js

@@ -0,0 +1,23 @@
+/**
+ * The base implementation of `_.findIndex` and `_.findLastIndex` without
+ * support for callback shorthands and `this` binding.
+ *
+ * @private
+ * @param {Array} array The array to search.
+ * @param {Function} predicate The function invoked per iteration.
+ * @param {boolean} [fromRight] Specify iterating from right to left.
+ * @returns {number} Returns the index of the matched value, else `-1`.
+ */
+function baseFindIndex(array, predicate, fromRight) {
+  var length = array.length,
+      index = fromRight ? length : -1;
+
+  while ((fromRight ? index-- : ++index < length)) {
+    if (predicate(array[index], index, array)) {
+      return index;
+    }
+  }
+  return -1;
+}
+
+export default baseFindIndex;

internal/baseFlatten.js

@@ -9,13 +9,12 @@ import isObjectLike from './isObjectLike';
  *
  * @private
  * @param {Array} array The array to flatten.
- * @param {boolean} [isDeep] Specify a deep flatten.
+ * @param {boolean} isDeep Specify a deep flatten.
- * @param {boolean} [isStrict] Restrict flattening to arrays and `arguments` objects.
+ * @param {boolean} isStrict Restrict flattening to arrays and `arguments` objects.
- * @param {number} [fromIndex=0] The index to start from.
  * @returns {Array} Returns the new flattened array.
  */
-function baseFlatten(array, isDeep, isStrict, fromIndex) {
+function baseFlatten(array, isDeep, isStrict) {
-  var index = (fromIndex || 0) - 1,
+  var index = -1,
       length = array.length,
       resIndex = -1,
       result = [];

internal/baseFor.js

@@ -1,4 +1,4 @@
-import toObject from './toObject';
+import createBaseFor from './createBaseFor';
 
 /**
  * The base implementation of `baseForIn` and `baseForOwn` which iterates
@@ -12,19 +12,6 @@ import toObject from './toObject';
  * @param {Function} keysFunc The function to get the keys of `object`.
  * @returns {Object} Returns `object`.
  */
-function baseFor(object, iteratee, keysFunc) {
+var baseFor = createBaseFor();
-  var index = -1,
-      iterable = toObject(object),
-      props = keysFunc(object),
-      length = props.length;
-
-  while (++index < length) {
-    var key = props[index];
-    if (iteratee(iterable[key], key, iterable) === false) {
-      break;
-    }
-  }
-  return object;
-}
 
 export default baseFor;

internal/baseForRight.js

@@ -1,4 +1,4 @@
-import toObject from './toObject';
+import createBaseFor from './createBaseFor';
 
 /**
  * This function is like `baseFor` except that it iterates over properties
@@ -10,18 +10,6 @@ import toObject from './toObject';
  * @param {Function} keysFunc The function to get the keys of `object`.
  * @returns {Object} Returns `object`.
  */
-function baseForRight(object, iteratee, keysFunc) {
+var baseForRight = createBaseFor(true);
-  var iterable = toObject(object),
-      props = keysFunc(object),
-      length = props.length;
-
-  while (length--) {
-    var key = props[length];
-    if (iteratee(iterable[key], key, iterable) === false) {
-      break;
-    }
-  }
-  return object;
-}
 
 export default baseForRight;

internal/baseIndexOf.js

@@ -6,14 +6,14 @@ import indexOfNaN from './indexOfNaN';
  * @private
  * @param {Array} array The array to search.
  * @param {*} value The value to search for.
- * @param {number} [fromIndex=0] The index to search from.
+ * @param {number} fromIndex The index to search from.
  * @returns {number} Returns the index of the matched value, else `-1`.
  */
 function baseIndexOf(array, value, fromIndex) {
   if (value !== value) {
     return indexOfNaN(array, fromIndex);
   }
-  var index = (fromIndex || 0) - 1,
+  var index = fromIndex - 1,
       length = array.length;
 
   while (++index < length) {

internal/baseInvoke.js

@@ -1,28 +0,0 @@
-import baseEach from './baseEach';
-import isLength from './isLength';
-
-/**
- * The base implementation of `_.invoke` which requires additional arguments
- * to be provided as an array of arguments rather than individually.
- *
- * @private
- * @param {Array|Object|string} collection The collection to iterate over.
- * @param {Function|string} methodName The name of the method to invoke or
- *  the function invoked per iteration.
- * @param {Array} [args] The arguments to invoke the method with.
- * @returns {Array} Returns the array of results.
- */
-function baseInvoke(collection, methodName, args) {
-  var index = -1,
-      isFunc = typeof methodName == 'function',
-      length = collection ? collection.length : 0,
-      result = isLength(length) ? Array(length) : [];
-
-  baseEach(collection, function(value) {
-    var func = isFunc ? methodName : (value != null && value[methodName]);
-    result[++index] = func ? func.apply(value, args) : undefined;
-  });
-  return result;
-}
-
-export default baseInvoke;

internal/baseIsEqual.js

@@ -8,12 +8,12 @@ import baseIsEqualDeep from './baseIsEqualDeep';
  * @param {*} value The value to compare.
  * @param {*} other The other value to compare.
  * @param {Function} [customizer] The function to customize comparing values.
- * @param {boolean} [isWhere] Specify performing partial comparisons.
+ * @param {boolean} [isLoose] Specify performing partial comparisons.
  * @param {Array} [stackA] Tracks traversed `value` objects.
  * @param {Array} [stackB] Tracks traversed `other` objects.
  * @returns {boolean} Returns `true` if the values are equivalent, else `false`.
  */
-function baseIsEqual(value, other, customizer, isWhere, stackA, stackB) {
+function baseIsEqual(value, other, customizer, isLoose, stackA, stackB) {
   // Exit early for identical values.
   if (value === other) {
     // Treat `+0` vs. `-0` as not equal.
@@ -28,7 +28,7 @@ function baseIsEqual(value, other, customizer, isWhere, stackA, stackB) {
     // Return `false` unless both values are `NaN`.
     return value !== value && other !== other;
   }
-  return baseIsEqualDeep(value, other, baseIsEqual, customizer, isWhere, stackA, stackB);
+  return baseIsEqualDeep(value, other, baseIsEqual, customizer, isLoose, stackA, stackB);
 }
 
 export default baseIsEqual;

internal/baseIsEqualDeep.js

@@ -7,6 +7,7 @@ import isTypedArray from '../lang/isTypedArray';
 /** `Object#toString` result references. */
 var argsTag = '[object Arguments]',
     arrayTag = '[object Array]',
+    funcTag = '[object Function]',
     objectTag = '[object Object]';
 
 /** Used for native method references. */
@@ -16,9 +17,8 @@ var objectProto = Object.prototype;
 var hasOwnProperty = objectProto.hasOwnProperty;
 
 /**
- * Used to resolve the `toStringTag` of values.
+ * Used to resolve the [`toStringTag`](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-object.prototype.tostring)
- * See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-object.prototype.tostring)
+ * of values.
- * for more details.
  */
 var objToString = objectProto.toString;
 
@@ -32,12 +32,12 @@ var objToString = objectProto.toString;
  * @param {Object} other The other object to compare.
  * @param {Function} equalFunc The function to determine equivalents of values.
  * @param {Function} [customizer] The function to customize comparing objects.
- * @param {boolean} [isWhere] Specify performing partial comparisons.
+ * @param {boolean} [isLoose] Specify performing partial comparisons.
  * @param {Array} [stackA=[]] Tracks traversed `value` objects.
  * @param {Array} [stackB=[]] Tracks traversed `other` objects.
  * @returns {boolean} Returns `true` if the objects are equivalent, else `false`.
  */
-function baseIsEqualDeep(object, other, equalFunc, customizer, isWhere, stackA, stackB) {
+function baseIsEqualDeep(object, other, equalFunc, customizer, isLoose, stackA, stackB) {
   var objIsArr = isArray(object),
       othIsArr = isArray(other),
       objTag = arrayTag,
@@ -59,21 +59,27 @@ function baseIsEqualDeep(object, other, equalFunc, customizer, isWhere, stackA,
       othIsArr = isTypedArray(other);
     }
   }
-  var objIsObj = objTag == objectTag,
+  var objIsObj = (objTag == objectTag || (isLoose && objTag == funcTag)),
-      othIsObj = othTag == objectTag,
+      othIsObj = (othTag == objectTag || (isLoose && othTag == funcTag)),
       isSameTag = objTag == othTag;
 
   if (isSameTag && !(objIsArr || objIsObj)) {
     return equalByTag(object, other, objTag);
   }
-  var valWrapped = objIsObj && hasOwnProperty.call(object, '__wrapped__'),
+  if (isLoose) {
-      othWrapped = othIsObj && hasOwnProperty.call(other, '__wrapped__');
+    if (!isSameTag && !(objIsObj && othIsObj)) {
+      return false;
+    }
+  } else {
+    var valWrapped = objIsObj && hasOwnProperty.call(object, '__wrapped__'),
+        othWrapped = othIsObj && hasOwnProperty.call(other, '__wrapped__');
 
-  if (valWrapped || othWrapped) {
+    if (valWrapped || othWrapped) {
-    return equalFunc(valWrapped ? object.value() : object, othWrapped ? other.value() : other, customizer, isWhere, stackA, stackB);
+      return equalFunc(valWrapped ? object.value() : object, othWrapped ? other.value() : other, customizer, isLoose, stackA, stackB);
-  }
+    }
-  if (!isSameTag) {
+    if (!isSameTag) {
-    return false;
+      return false;
+    }
   }
   // Assume cyclic values are equal.
   // For more information on detecting circular references see https://es5.github.io/#JO.
@@ -90,7 +96,7 @@ function baseIsEqualDeep(object, other, equalFunc, customizer, isWhere, stackA,
   stackA.push(object);
   stackB.push(other);
 
-  var result = (objIsArr ? equalArrays : equalObjects)(object, other, equalFunc, customizer, isWhere, stackA, stackB);
+  var result = (objIsArr ? equalArrays : equalObjects)(object, other, equalFunc, customizer, isLoose, stackA, stackB);
 
   stackA.pop();
   stackB.pop();