Bump to v4.2.0.

README.md

@@ -1,4 +1,4 @@
-# lodash-es v4.1.0
+# lodash-es v4.2.0
 
 The [lodash](https://lodash.com/) library exported as [ES](http://www.ecma-international.org/ecma-262/6.0/) modules.
 
@@ -7,4 +7,4 @@ Generated using [lodash-cli](https://www.npmjs.com/package/lodash-cli):
 $ lodash modularize exports=es -o ./
 ```
 
-See the [package source](https://github.com/lodash/lodash/tree/4.1.0-es) for more details.
+See the [package source](https://github.com/lodash/lodash/tree/4.2.0-es) for more details.

_apply.js

@@ -5,11 +5,11 @@
  * @private
  * @param {Function} func The function to invoke.
  * @param {*} thisArg The `this` binding of `func`.
- * @param {...*} [args] The arguments to invoke `func` with.
+ * @param {...*} args The arguments to invoke `func` with.
  * @returns {*} Returns the result of `func`.
  */
 function apply(func, thisArg, args) {
-  var length = args ? args.length : 0;
+  var length = args.length;
   switch (length) {
     case 0: return func.call(thisArg);
     case 1: return func.call(thisArg, args[0]);

_baseSum.js

@@ -17,7 +17,7 @@ function baseSum(array, iteratee) {
       result = result === undefined ? current : (result + current);
     }
   }
-  return length ? result : 0;
+  return result;
 }
 
 export default baseSum;

array.default.js

@@ -11,7 +11,6 @@ import dropWhile from './dropWhile';
 import fill from './fill';
 import findIndex from './findIndex';
 import findLastIndex from './findLastIndex';
-import flatMap from './flatMap';
 import flatten from './flatten';
 import flattenDeep from './flattenDeep';
 import fromPairs from './fromPairs';
@@ -64,15 +63,15 @@ import zipWith from './zipWith';
 export default {
   chunk, compact, concat, difference, differenceBy,
   differenceWith, drop, dropRight, dropRightWhile, dropWhile,
-  fill, findIndex, findLastIndex, flatMap, flatten,
-  flattenDeep, fromPairs, head, indexOf, initial,
-  intersection, intersectionBy, intersectionWith, join, last,
-  lastIndexOf, pull, pullAll, pullAllBy, pullAt,
-  remove, reverse, slice, sortedIndex, sortedIndexBy,
-  sortedIndexOf, sortedLastIndex, sortedLastIndexBy, sortedLastIndexOf, sortedUniq,
-  sortedUniqBy, tail, take, takeRight, takeRightWhile,
-  takeWhile, union, unionBy, unionWith, uniq,
-  uniqBy, uniqWith, unzip, unzipWith, without,
-  xor, xorBy, xorWith, zip, zipObject,
-  zipObjectDeep, zipWith
+  fill, findIndex, findLastIndex, flatten, flattenDeep,
+  fromPairs, head, indexOf, initial, intersection,
+  intersectionBy, intersectionWith, join, last, lastIndexOf,
+  pull, pullAll, pullAllBy, pullAt, remove,
+  reverse, slice, sortedIndex, sortedIndexBy, sortedIndexOf,
+  sortedLastIndex, sortedLastIndexBy, sortedLastIndexOf, sortedUniq, sortedUniqBy,
+  tail, take, takeRight, takeRightWhile, takeWhile,
+  union, unionBy, unionWith, uniq, uniqBy,
+  uniqWith, unzip, unzipWith, without, xor,
+  xorBy, xorWith, zip, zipObject, zipObjectDeep,
+  zipWith
 };

array.js

@@ -11,7 +11,6 @@ export { default as dropWhile } from './dropWhile';
 export { default as fill } from './fill';
 export { default as findIndex } from './findIndex';
 export { default as findLastIndex } from './findLastIndex';
-export { default as flatMap } from './flatMap';
 export { default as flatten } from './flatten';
 export { default as flattenDeep } from './flattenDeep';
 export { default as fromPairs } from './fromPairs';

attempt.js

@@ -1,5 +1,5 @@
 import apply from './_apply';
-import isError from './isError';
+import isObject from './isObject';
 import rest from './rest';
 
 /**
@@ -13,7 +13,7 @@ import rest from './rest';
  * @returns {*} Returns the `func` result or error object.
  * @example
  *
- * // avoid throwing errors for invalid selectors
+ * // Avoid throwing errors for invalid selectors.
  * var elements = _.attempt(function(selector) {
  *   return document.querySelectorAll(selector);
  * }, '>_>');
@@ -26,7 +26,7 @@ var attempt = rest(function(func, args) {
   try {
     return apply(func, undefined, args);
   } catch (e) {
-    return isError(e) ? e : new Error(e);
+    return isObject(e) ? e : new Error(e);
   }
 });
 

bind.js

@@ -36,7 +36,7 @@ var BIND_FLAG = 1,
  * bound('!');
  * // => 'hi fred!'
  *
- * // using placeholders
+ * // Bound with placeholders.
  * var bound = _.bind(greet, object, _, '!');
  * bound('hi');
  * // => 'hi fred!'

bindKey.js

@@ -46,7 +46,7 @@ var BIND_FLAG = 1,
  * bound('!');
  * // => 'hiya fred!'
  *
- * // using placeholders
+ * // Bound with placeholders.
  * var bound = _.bindKey(object, 'greet', _, '!');
  * bound('hi');
  * // => 'hiya fred!'

collection.default.js

@@ -6,6 +6,7 @@ import every from './every';
 import filter from './filter';
 import find from './find';
 import findLast from './findLast';
+import flatMap from './flatMap';
 import forEach from './forEach';
 import forEachRight from './forEachRight';
 import groupBy from './groupBy';
@@ -27,9 +28,9 @@ import sortBy from './sortBy';
 
 export default {
   at, countBy, each, eachRight, every,
-  filter, find, findLast, forEach, forEachRight,
-  groupBy, includes, invokeMap, keyBy, map,
-  orderBy, partition, reduce, reduceRight, reject,
-  sample, sampleSize, shuffle, size, some,
-  sortBy
+  filter, find, findLast, flatMap, forEach,
+  forEachRight, groupBy, includes, invokeMap, keyBy,
+  map, orderBy, partition, reduce, reduceRight,
+  reject, sample, sampleSize, shuffle, size,
+  some, sortBy
 };

collection.js

@@ -6,6 +6,7 @@ export { default as every } from './every';
 export { default as filter } from './filter';
 export { default as find } from './find';
 export { default as findLast } from './findLast';
+export { default as flatMap } from './flatMap';
 export { default as forEach } from './forEach';
 export { default as forEachRight } from './forEachRight';
 export { default as groupBy } from './groupBy';

curry.js

@@ -39,7 +39,7 @@ var CURRY_FLAG = 8;
  * curried(1, 2, 3);
  * // => [1, 2, 3]
  *
- * // using placeholders
+ * // Curried with placeholders.
  * curried(1)(_, 3)(2);
  * // => [1, 2, 3]
  */

curryRight.js

@@ -36,7 +36,7 @@ var CURRY_RIGHT_FLAG = 16;
  * curried(1, 2, 3);
  * // => [1, 2, 3]
  *
- * // using placeholders
+ * // Curried with placeholders.
  * curried(3)(1, _)(2);
  * // => [1, 2, 3]
  */

debounce.js

@@ -40,21 +40,21 @@ var nativeMax = Math.max;
  * @returns {Function} Returns the new debounced function.
  * @example
  *
- * // avoid costly calculations while the window size is in flux
+ * // Avoid costly calculations while the window size is in flux.
  * jQuery(window).on('resize', _.debounce(calculateLayout, 150));
  *
- * // invoke `sendMail` when clicked, debouncing subsequent calls
+ * // Invoke `sendMail` when clicked, debouncing subsequent calls.
  * jQuery(element).on('click', _.debounce(sendMail, 300, {
  *   'leading': true,
  *   'trailing': false
  * }));
  *
- * // ensure `batchLog` is invoked once after 1 second of debounced calls
+ * // Ensure `batchLog` is invoked once after 1 second of debounced calls.
  * var debounced = _.debounce(batchLog, 250, { 'maxWait': 1000 });
  * var source = new EventSource('/stream');
  * jQuery(source).on('message', debounced);
  *
- * // cancel a trailing debounced invocation
+ * // Cancel the trailing debounced invocation.
  * jQuery(window).on('popstate', debounced.cancel);
  */
 function debounce(func, wait, options) {

defer.js

@@ -16,7 +16,7 @@ import rest from './rest';
  * _.defer(function(text) {
  *   console.log(text);
  * }, 'deferred');
- * // logs 'deferred' after one or more milliseconds
+ * // => logs 'deferred' after one or more milliseconds
  */
 var defer = rest(function(func, args) {
   return baseDelay(func, 1, args);

differenceBy.js

@@ -22,7 +22,7 @@ import rest from './rest';
  * _.differenceBy([3.1, 2.2, 1.3], [4.4, 2.5], Math.floor);
  * // => [3.1, 1.3]
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.differenceBy([{ 'x': 2 }, { 'x': 1 }], [{ 'x': 1 }], 'x');
  * // => [{ 'x': 2 }]
  */

dropRightWhile.js

@@ -23,15 +23,15 @@ import baseWhile from './_baseWhile';
  * _.dropRightWhile(users, function(o) { return !o.active; });
  * // => objects for ['barney']
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.dropRightWhile(users, { 'user': 'pebbles', 'active': false });
  * // => objects for ['barney', 'fred']
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.dropRightWhile(users, ['active', false]);
  * // => objects for ['barney']
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.dropRightWhile(users, 'active');
  * // => objects for ['barney', 'fred', 'pebbles']
  */

dropWhile.js

@@ -23,15 +23,15 @@ import baseWhile from './_baseWhile';
  * _.dropWhile(users, function(o) { return !o.active; });
  * // => objects for ['pebbles']
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.dropWhile(users, { 'user': 'barney', 'active': false });
  * // => objects for ['fred', 'pebbles']
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.dropWhile(users, ['active', false]);
  * // => objects for ['pebbles']
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.dropWhile(users, 'active');
  * // => objects for ['barney', 'fred', 'pebbles']
  */

every.js

@@ -26,15 +26,15 @@ import isIterateeCall from './_isIterateeCall';
  *   { 'user': 'fred',   'active': false }
  * ];
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.every(users, { 'user': 'barney', 'active': false });
  * // => false
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.every(users, ['active', false]);
  * // => true
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.every(users, 'active');
  * // => false
  */

filter.js

@@ -24,15 +24,15 @@ import isArray from './isArray';
  * _.filter(users, function(o) { return !o.active; });
  * // => objects for ['fred']
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.filter(users, { 'age': 36, 'active': true });
  * // => objects for ['barney']
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.filter(users, ['active', false]);
  * // => objects for ['fred']
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.filter(users, 'active');
  * // => objects for ['barney']
  */

find.js

@@ -26,15 +26,15 @@ import isArray from './isArray';
  * _.find(users, function(o) { return o.age < 40; });
  * // => object for 'barney'
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.find(users, { 'age': 1, 'active': true });
  * // => object for 'pebbles'
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.find(users, ['active', false]);
  * // => object for 'fred'
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.find(users, 'active');
  * // => object for 'barney'
  */

findIndex.js

@@ -22,15 +22,15 @@ import baseIteratee from './_baseIteratee';
  * _.findIndex(users, function(o) { return o.user == 'barney'; });
  * // => 0
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.findIndex(users, { 'user': 'fred', 'active': false });
  * // => 1
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.findIndex(users, ['active', false]);
  * // => 0
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.findIndex(users, 'active');
  * // => 2
  */

findKey.js

@@ -23,15 +23,15 @@ import baseIteratee from './_baseIteratee';
  * _.findKey(users, function(o) { return o.age < 40; });
  * // => 'barney' (iteration order is not guaranteed)
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.findKey(users, { 'age': 1, 'active': true });
  * // => 'pebbles'
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.findKey(users, ['active', false]);
  * // => 'fred'
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.findKey(users, 'active');
  * // => 'barney'
  */

findLastIndex.js

@@ -22,15 +22,15 @@ import baseIteratee from './_baseIteratee';
  * _.findLastIndex(users, function(o) { return o.user == 'pebbles'; });
  * // => 2
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.findLastIndex(users, { 'user': 'barney', 'active': true });
  * // => 0
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.findLastIndex(users, ['active', false]);
  * // => 2
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.findLastIndex(users, 'active');
  * // => 0
  */

findLastKey.js

@@ -23,15 +23,15 @@ import baseIteratee from './_baseIteratee';
  * _.findLastKey(users, function(o) { return o.age < 40; });
  * // => returns 'pebbles' assuming `_.findKey` returns 'barney'
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.findLastKey(users, { 'age': 36, 'active': true });
  * // => 'barney'
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.findLastKey(users, ['active', false]);
  * // => 'fred'
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.findLastKey(users, 'active');
  * // => 'pebbles'
  */

flatMap.js

@@ -1,18 +1,17 @@
-import arrayMap from './_arrayMap';
 import baseFlatten from './_baseFlatten';
-import baseIteratee from './_baseIteratee';
+import map from './map';
 
 /**
- * Creates an array of flattened values by running each element in `array`
+ * Creates an array of flattened values by running each element in `collection`
  * through `iteratee` and concating its result to the other mapped values.
- * The iteratee is invoked with three arguments: (value, index|key, array).
+ * The iteratee is invoked with three arguments: (value, index|key, collection).
  *
  * @static
  * @memberOf _
- * @category Array
- * @param {Array} array The array to iterate over.
+ * @category Collection
+ * @param {Array|Object} collection The collection to iterate over.
  * @param {Function|Object|string} [iteratee=_.identity] The function invoked per iteration.
- * @returns {Array} Returns the new array.
+ * @returns {Array} Returns the new flattened array.
  * @example
  *
  * function duplicate(n) {
@@ -22,9 +21,8 @@ import baseIteratee from './_baseIteratee';
  * _.flatMap([1, 2], duplicate);
  * // => [1, 1, 2, 2]
  */
-function flatMap(array, iteratee) {
-  var length = array ? array.length : 0;
-  return length ? baseFlatten(arrayMap(array, baseIteratee(iteratee, 3))) : [];
+function flatMap(collection, iteratee) {
+  return baseFlatten(map(collection, iteratee));
 }
 
 export default flatMap;

groupBy.js

@@ -23,7 +23,7 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * _.groupBy([6.1, 4.2, 6.3], Math.floor);
  * // => { '4': [4.2], '6': [6.1, 6.3] }
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.groupBy(['one', 'two', 'three'], 'length');
  * // => { '3': ['one', 'two'], '5': ['three'] }
  */

indexOf.js

@@ -8,8 +8,7 @@ var nativeMax = Math.max;
  * Gets the index at which the first occurrence of `value` is found in `array`
  * using [`SameValueZero`](http://ecma-international.org/ecma-262/6.0/#sec-samevaluezero)
  * for equality comparisons. If `fromIndex` is negative, it's used as the offset
- * from the end of `array`. If `array` is sorted providing `true` for `fromIndex`
- * performs a faster binary search.
+ * from the end of `array`.
  *
  * @static
  * @memberOf _
@@ -23,7 +22,7 @@ var nativeMax = Math.max;
  * _.indexOf([1, 2, 1, 2], 2);
  * // => 1
  *
- * // using `fromIndex`
+ * // Search from the `fromIndex`.
  * _.indexOf([1, 2, 1, 2], 2, 2);
  * // => 3
  */

intersectionBy.js

@@ -21,7 +21,7 @@ import toArrayLikeObject from './_toArrayLikeObject';
  * _.intersectionBy([2.1, 1.2], [4.3, 2.4], Math.floor);
  * // => [2.1]
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.intersectionBy([{ 'x': 1 }], [{ 'x': 2 }, { 'x': 1 }], 'x');
  * // => [{ 'x': 1 }]
  */

iteratee.js

@@ -1,7 +1,5 @@
+import baseClone from './_baseClone';
 import baseIteratee from './_baseIteratee';
-import isArray from './isArray';
-import isObjectLike from './isObjectLike';
-import matches from './matches';
 
 /**
  * Creates a function that invokes `func` with the arguments of the created
@@ -21,7 +19,7 @@ import matches from './matches';
  *   { 'user': 'fred',   'age': 40 }
  * ];
  *
- * // create custom iteratee shorthands
+ * // Create custom iteratee shorthands.
  * _.iteratee = _.wrap(_.iteratee, function(callback, func) {
  *   var p = /^(\S+)\s*([<>])\s*(\S+)$/.exec(func);
  *   return !p ? callback(func) : function(object) {
@@ -33,9 +31,7 @@ import matches from './matches';
  * // => [{ 'user': 'fred', 'age': 40 }]
  */
 function iteratee(func) {
-  return (isObjectLike(func) && !isArray(func))
-    ? matches(func)
-    : baseIteratee(func);
+  return baseIteratee(typeof func == 'function' ? func : baseClone(func, true));
 }
 
 export default iteratee;

lastIndexOf.js

@@ -21,7 +21,7 @@ var nativeMax = Math.max,
  * _.lastIndexOf([1, 2, 1, 2], 2);
  * // => 3
  *
- * // using `fromIndex`
+ * // Search from the `fromIndex`.
  * _.lastIndexOf([1, 2, 1, 2], 2, 2);
  * // => 1
  */

lodash.default.js

@@ -1,6 +1,6 @@
 /**
  * @license
- * lodash 4.1.0 (Custom Build) <https://lodash.com/>
+ * lodash 4.2.0 (Custom Build) <https://lodash.com/>
  * Build: `lodash modularize exports="es" -o ./`
  * Copyright 2012-2016 The Dojo Foundation <http://dojofoundation.org/>
  * Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE>
@@ -44,7 +44,7 @@ import toInteger from './toInteger';
 import lodash from './wrapperLodash';
 
 /** Used as the semantic version number. */
-var VERSION = '4.1.0';
+var VERSION = '4.2.0';
 
 /** Used to compose bitmasks for wrapper metadata. */
 var BIND_KEY_FLAG = 2;
@@ -125,7 +125,7 @@ lodash.dropRightWhile = array.dropRightWhile;
 lodash.dropWhile = array.dropWhile;
 lodash.fill = array.fill;
 lodash.filter = collection.filter;
-lodash.flatMap = array.flatMap;
+lodash.flatMap = collection.flatMap;
 lodash.flatten = array.flatten;
 lodash.flattenDeep = array.flattenDeep;
 lodash.flip = func.flip;

lodash.js

@@ -1,6 +1,6 @@
 /**
  * @license
- * lodash 4.1.0 (Custom Build) <https://lodash.com/>
+ * lodash 4.2.0 (Custom Build) <https://lodash.com/>
  * Build: `lodash modularize exports="es" -o ./`
  * Copyright 2012-2016 The Dojo Foundation <http://dojofoundation.org/>
  * Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE>

map.js

@@ -40,7 +40,7 @@ import isArray from './isArray';
  *   { 'user': 'fred' }
  * ];
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.map(users, 'user');
  * // => ['barney', 'fred']
  */

mapValues.js

@@ -22,7 +22,7 @@ import baseIteratee from './_baseIteratee';
  * _.mapValues(users, function(o) { return o.age; });
  * // => { 'fred': 40, 'pebbles': 1 } (iteration order is not guaranteed)
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.mapValues(users, 'age');
  * // => { 'fred': 40, 'pebbles': 1 } (iteration order is not guaranteed)
  */

maxBy.js

@@ -20,7 +20,7 @@ import gt from './gt';
  * _.maxBy(objects, function(o) { return o.n; });
  * // => { 'n': 2 }
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.maxBy(objects, 'n');
  * // => { 'n': 2 }
  */

memoize.js

@@ -37,12 +37,12 @@ var FUNC_ERROR_TEXT = 'Expected a function';
  * values(object);
  * // => [1, 2]
  *
- * // modifying the result cache
+ * // Modify the result cache.
  * values.cache.set(object, ['a', 'b']);
  * values(object);
  * // => ['a', 'b']
  *
- * // replacing `_.memoize.Cache`
+ * // Replace `_.memoize.Cache`.
  * _.memoize.Cache = WeakMap;
  */
 function memoize(func, resolver) {

mergeWith.js

@@ -8,6 +8,8 @@ import createAssigner from './_createAssigner';
  * method instead. The `customizer` is invoked with seven arguments:
  * (objValue, srcValue, key, object, source, stack).
  *
+ * **Note:** This method mutates `object`.
+ *
  * @static
  * @memberOf _
  * @category Object

minBy.js

@@ -20,7 +20,7 @@ import lt from './lt';
  * _.minBy(objects, function(o) { return o.n; });
  * // => { 'n': 1 }
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.minBy(objects, 'n');
  * // => { 'n': 1 }
  */

orderBy.js

@@ -24,7 +24,7 @@ import isArray from './isArray';
  *   { 'user': 'barney', 'age': 36 }
  * ];
  *
- * // sort by `user` in ascending order and by `age` in descending order
+ * // Sort by `user` in ascending order and by `age` in descending order.
  * _.orderBy(users, ['user', 'age'], ['asc', 'desc']);
  * // => objects for [['barney', 36], ['barney', 34], ['fred', 48], ['fred', 42]]
  */

package.json

@@ -1,6 +1,6 @@
 {
   "name": "lodash-es",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "Lodash exported as ES modules.",
   "homepage": "https://lodash.com/custom-builds",
   "license": "MIT",

partial.js

@@ -32,7 +32,7 @@ var PARTIAL_FLAG = 32;
  * sayHelloTo('fred');
  * // => 'hello fred'
  *
- * // using placeholders
+ * // Partially applied with placeholders.
  * var greetFred = _.partial(greet, _, 'fred');
  * greetFred('hi');
  * // => 'hi fred'

partialRight.js

@@ -31,7 +31,7 @@ var PARTIAL_RIGHT_FLAG = 64;
  * greetFred('hi');
  * // => 'hi fred'
  *
- * // using placeholders
+ * // Partially applied with placeholders.
  * var sayHelloTo = _.partialRight(greet, 'hello', _);
  * sayHelloTo('fred');
  * // => 'hello fred'

partition.js

@@ -23,15 +23,15 @@ import createAggregator from './_createAggregator';
  * _.partition(users, function(o) { return o.active; });
  * // => objects for [['fred'], ['barney', 'pebbles']]
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.partition(users, { 'age': 1, 'active': false });
  * // => objects for [['pebbles'], ['barney', 'fred']]
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.partition(users, ['active', false]);
  * // => objects for [['barney', 'pebbles'], ['fred']]
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.partition(users, 'active');
  * // => objects for [['fred'], ['barney', 'pebbles']]
  */

pickBy.js

@@ -3,7 +3,7 @@ import basePickBy from './_basePickBy';
 
 /**
  * Creates an object composed of the `object` properties `predicate` returns
- * truthy for. The predicate is invoked with one argument: (value).
+ * truthy for. The predicate is invoked with two arguments: (value, key).
  *
  * @static
  * @memberOf _

reject.js

@@ -23,15 +23,15 @@ import isArray from './isArray';
  * _.reject(users, function(o) { return !o.active; });
  * // => objects for ['fred']
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.reject(users, { 'age': 40, 'active': true });
  * // => objects for ['barney']
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.reject(users, ['active', false]);
  * // => objects for ['fred']
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.reject(users, 'active');
  * // => objects for ['barney']
  */

set.js

@@ -6,6 +6,8 @@ import baseSet from './_baseSet';
  * are created for all other missing properties. Use `_.setWith` to customize
  * `path` creation.
  *
+ * **Note:** This method mutates `object`.
+ *
  * @static
  * @memberOf _
  * @category Object

setWith.js

@@ -6,6 +6,8 @@ import baseSet from './_baseSet';
  * path creation is handled by the method instead. The `customizer` is invoked
  * with three arguments: (nsValue, key, nsObject).
  *
+ * **Note:** This method mutates `object`.
+ *
  * @static
  * @memberOf _
  * @category Object

some.js

@@ -26,15 +26,15 @@ import isIterateeCall from './_isIterateeCall';
  *   { 'user': 'fred',   'active': false }
  * ];
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.some(users, { 'user': 'barney', 'active': false });
  * // => false
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.some(users, ['active', false]);
  * // => true
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.some(users, 'active');
  * // => true
  */

sortedIndexBy.js

@@ -20,7 +20,7 @@ import baseSortedIndexBy from './_baseSortedIndexBy';
  * _.sortedIndexBy(['thirty', 'fifty'], 'forty', _.propertyOf(dict));
  * // => 1
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.sortedIndexBy([{ 'x': 4 }, { 'x': 5 }], { 'x': 4 }, 'x');
  * // => 0
  */

sortedLastIndexBy.js

@@ -15,7 +15,7 @@ import baseSortedIndexBy from './_baseSortedIndexBy';
  * @returns {number} Returns the index at which `value` should be inserted into `array`.
  * @example
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.sortedLastIndexBy([{ 'x': 4 }, { 'x': 5 }], { 'x': 4 }, 'x');
  * // => 1
  */

sortedUniqBy.js

@@ -14,7 +14,7 @@ import baseSortedUniqBy from './_baseSortedUniqBy';
  * @example
  *
  * _.sortedUniqBy([1.1, 1.2, 2.3, 2.4], Math.floor);
- * // => [1.1, 2.2]
+ * // => [1.1, 2.3]
  */
 function sortedUniqBy(array, iteratee) {
   return (array && array.length)

spread.js

@@ -1,8 +1,14 @@
 import apply from './_apply';
+import arrayPush from './_arrayPush';
+import rest from './rest';
+import toInteger from './toInteger';
 
 /** Used as the `TypeError` message for "Functions" methods. */
 var FUNC_ERROR_TEXT = 'Expected a function';
 
+/* Built-in 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 an array of arguments much like [`Function#apply`](https://es5.github.io/#x15.3.4.3).
@@ -13,6 +19,7 @@ var FUNC_ERROR_TEXT = 'Expected a function';
  * @memberOf _
  * @category Function
  * @param {Function} func The function to spread arguments over.
+ * @param {number} [start=0] The start position of the spread.
  * @returns {Function} Returns the new function.
  * @example
  *
@@ -23,7 +30,6 @@ var FUNC_ERROR_TEXT = 'Expected a function';
  * say(['fred', 'hello']);
  * // => 'fred says hello'
  *
- * // with a Promise
  * var numbers = Promise.all([
  *   Promise.resolve(40),
  *   Promise.resolve(36)
@@ -34,13 +40,20 @@ var FUNC_ERROR_TEXT = 'Expected a function';
  * }));
  * // => a Promise of 76
  */
-function spread(func) {
+function spread(func, start) {
   if (typeof func != 'function') {
     throw new TypeError(FUNC_ERROR_TEXT);
   }
-  return function(array) {
-    return apply(func, this, array);
-  };
+  start = start === undefined ? 0 : nativeMax(toInteger(start), 0);
+  return rest(function(args) {
+    var array = args[start],
+        otherArgs = args.slice(0, start);
+
+    if (array) {
+      arrayPush(otherArgs, array);
+    }
+    return apply(func, this, otherArgs);
+  });
 }
 
 export default spread;

sumBy.js

@@ -19,7 +19,7 @@ import baseSum from './_baseSum';
  * _.sumBy(objects, function(o) { return o.n; });
  * // => 20
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.sumBy(objects, 'n');
  * // => 20
  */

takeRightWhile.js

@@ -23,15 +23,15 @@ import baseWhile from './_baseWhile';
  * _.takeRightWhile(users, function(o) { return !o.active; });
  * // => objects for ['fred', 'pebbles']
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.takeRightWhile(users, { 'user': 'pebbles', 'active': false });
  * // => objects for ['pebbles']
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.takeRightWhile(users, ['active', false]);
  * // => objects for ['fred', 'pebbles']
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.takeRightWhile(users, 'active');
  * // => []
  */

takeWhile.js

@@ -23,15 +23,15 @@ import baseWhile from './_baseWhile';
  * _.takeWhile(users, function(o) { return !o.active; });
  * // => objects for ['barney', 'fred']
  *
- * // using the `_.matches` iteratee shorthand
+ * // The `_.matches` iteratee shorthand.
  * _.takeWhile(users, { 'user': 'barney', 'active': false });
  * // => objects for ['barney']
  *
- * // using the `_.matchesProperty` iteratee shorthand
+ * // The `_.matchesProperty` iteratee shorthand.
  * _.takeWhile(users, ['active', false]);
  * // => objects for ['barney', 'fred']
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.takeWhile(users, 'active');
  * // => []
  */

tap.js

@@ -1,8 +1,7 @@
 /**
- * This method invokes `interceptor` and returns `value`. The interceptor is
- * invoked with one argument; (value). The purpose of this method is to "tap into"
- * a method chain in order to perform operations on intermediate results within
- * the chain.
+ * This method invokes `interceptor` and returns `value`. The interceptor
+ * is invoked with one argument; (value). The purpose of this method is to
+ * "tap into" a method chain in order to modify intermediate results.
  *
  * @static
  * @memberOf _
@@ -14,6 +13,7 @@
  *
  * _([1, 2, 3])
  *  .tap(function(array) {
+ *    // Mutate input array.
  *    array.pop();
  *  })
  *  .reverse()

template.js

@@ -56,54 +56,54 @@ var reUnescapedString = /['\n\r\u2028\u2029\\]/g;
  * @returns {Function} Returns the compiled template function.
  * @example
  *
- * // using the "interpolate" delimiter to create a compiled template
+ * // Use the "interpolate" delimiter to create a compiled template.
  * var compiled = _.template('hello <%= user %>!');
  * compiled({ 'user': 'fred' });
  * // => 'hello fred!'
  *
- * // using the HTML "escape" delimiter to escape data property values
+ * // Use the HTML "escape" delimiter to escape data property values.
  * var compiled = _.template('<b><%- value %></b>');
  * compiled({ 'value': '<script>' });
  * // => '<b>&lt;script&gt;</b>'
  *
- * // using the "evaluate" delimiter to execute JavaScript and generate HTML
+ * // Use the "evaluate" delimiter to execute JavaScript and generate HTML.
  * var compiled = _.template('<% _.forEach(users, function(user) { %><li><%- user %></li><% }); %>');
  * compiled({ 'users': ['fred', 'barney'] });
  * // => '<li>fred</li><li>barney</li>'
  *
- * // using the internal `print` function in "evaluate" delimiters
+ * // Use the internal `print` function in "evaluate" delimiters.
  * var compiled = _.template('<% print("hello " + user); %>!');
  * compiled({ 'user': 'barney' });
  * // => 'hello barney!'
  *
- * // using the ES delimiter as an alternative to the default "interpolate" delimiter
+ * // Use the ES delimiter as an alternative to the default "interpolate" delimiter.
  * var compiled = _.template('hello ${ user }!');
  * compiled({ 'user': 'pebbles' });
  * // => 'hello pebbles!'
  *
- * // using custom template delimiters
+ * // Use custom template delimiters.
  * _.templateSettings.interpolate = /{{([\s\S]+?)}}/g;
  * var compiled = _.template('hello {{ user }}!');
  * compiled({ 'user': 'mustache' });
  * // => 'hello mustache!'
  *
- * // using backslashes to treat delimiters as plain text
+ * // Use backslashes to treat delimiters as plain text.
  * var compiled = _.template('<%= "\\<%- value %\\>" %>');
  * compiled({ 'value': 'ignored' });
  * // => '<%- value %>'
  *
- * // using the `imports` option to import `jQuery` as `jq`
+ * // Use the `imports` option to import `jQuery` as `jq`.
  * var text = '<% jq.each(users, function(user) { %><li><%- user %></li><% }); %>';
  * var compiled = _.template(text, { 'imports': { 'jq': jQuery } });
  * compiled({ 'users': ['fred', 'barney'] });
  * // => '<li>fred</li><li>barney</li>'
  *
- * // using the `sourceURL` option to specify a custom sourceURL for the template
+ * // Use the `sourceURL` option to specify a custom sourceURL for the template.
  * var compiled = _.template('hello <%= user %>!', { 'sourceURL': '/basic/greeting.jst' });
  * compiled(data);
  * // => find the source of "greeting.jst" under the Sources tab or Resources panel of the web inspector
  *
- * // using the `variable` option to ensure a with-statement isn't used in the compiled template
+ * // Use the `variable` option to ensure a with-statement isn't used in the compiled template.
  * var compiled = _.template('hi <%= data.user %>!', { 'variable': 'data' });
  * compiled.source;
  * // => function(data) {
@@ -112,8 +112,8 @@ var reUnescapedString = /['\n\r\u2028\u2029\\]/g;
  * //   return __p;
  * // }
  *
- * // using the `source` property to inline compiled templates for meaningful
- * // line numbers in error messages and a stack trace
+ * // Use the `source` property to inline compiled templates for meaningful
+ * // line numbers in error messages and stack traces.
  * fs.writeFileSync(path.join(cwd, 'jst.js'), '\
  *   var JST = {\
  *     "main": ' + _.template(mainText).source + '\

throttle.js

@@ -34,14 +34,14 @@ var FUNC_ERROR_TEXT = 'Expected a function';
  * @returns {Function} Returns the new throttled function.
  * @example
  *
- * // avoid excessively updating the position while scrolling
+ * // Avoid excessively updating the position while scrolling.
  * jQuery(window).on('scroll', _.throttle(updatePosition, 100));
  *
- * // invoke `renewToken` when the click event is fired, but not more than once every 5 minutes
+ * // Invoke `renewToken` when the click event is fired, but not more than once every 5 minutes.
  * var throttled = _.throttle(renewToken, 300000, { 'trailing': false });
  * jQuery(element).on('click', throttled);
  *
- * // cancel a trailing throttled invocation
+ * // Cancel the trailing throttled invocation.
  * jQuery(window).on('popstate', throttled.cancel);
  */
 function throttle(func, wait, options) {

thru.js

@@ -1,5 +1,7 @@
 /**
  * This method is like `_.tap` except that it returns the result of `interceptor`.
+ * The purpose of this method is to "pass thru" values replacing intermediate
+ * results in a method chain.
  *
  * @static
  * @memberOf _

unionBy.js

@@ -21,7 +21,7 @@ import rest from './rest';
  * _.unionBy([2.1, 1.2], [4.3, 2.4], Math.floor);
  * // => [2.1, 1.2, 4.3]
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.unionBy([{ 'x': 1 }], [{ 'x': 2 }, { 'x': 1 }], 'x');
  * // => [{ 'x': 1 }, { 'x': 2 }]
  */

uniqBy.js

@@ -17,7 +17,7 @@ import baseUniq from './_baseUniq';
  * _.uniqBy([2.1, 1.2, 2.3], Math.floor);
  * // => [2.1, 1.2]
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.uniqBy([{ 'x': 1 }, { 'x': 2 }, { 'x': 1 }], 'x');
  * // => [{ 'x': 1 }, { 'x': 2 }]
  */

unset.js

@@ -3,6 +3,8 @@ import baseUnset from './_baseUnset';
 /**
  * Removes the property at `path` of `object`.
  *
+ * **Note:** This method mutates `object`.
+ *
  * @static
  * @memberOf _
  * @category Object

wrapperChain.js

@@ -14,11 +14,11 @@ import chain from './chain';
  *   { 'user': 'fred',   'age': 40 }
  * ];
  *
- * // without explicit chaining
+ * // A sequence without explicit chaining.
  * _(users).head();
  * // => { 'user': 'barney', 'age': 36 }
  *
- * // with explicit chaining
+ * // A sequence with explicit chaining.
  * _(users)
  *   .chain()
  *   .head()

wrapperLodash.js

@@ -109,11 +109,11 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  *
  * var wrapped = _([1, 2, 3]);
  *
- * // returns an unwrapped value
+ * // Returns an unwrapped value.
  * wrapped.reduce(_.add);
  * // => 6
  *
- * // returns a wrapped value
+ * // Returns a wrapped value.
  * var squares = wrapped.map(square);
  *
  * _.isArray(squares);

xorBy.js

@@ -21,7 +21,7 @@ import rest from './rest';
  * _.xorBy([2.1, 1.2], [4.3, 2.4], Math.floor);
  * // => [1.2, 4.3]
  *
- * // using the `_.property` iteratee shorthand
+ * // The `_.property` iteratee shorthand.
  * _.xorBy([{ 'x': 1 }], [{ 'x': 2 }, { 'x': 1 }], 'x');
  * // => [{ 'x': 2 }]
  */