Bump to v3.5.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.5.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.5.0-es) for more details.

array/difference.js

@@ -24,16 +24,17 @@ import isArray from '../lang/isArray';
  * // => [1, 3]
  */
 function difference() {
-  var index = -1,
-      length = arguments.length;
+  var args = arguments,
+      index = -1,
+      length = args.length;
 
   while (++index < length) {
-    var value = arguments[index];
+    var value = args[index];
     if (isArray(value) || isArguments(value)) {
       break;
     }
   }
-  return baseDifference(value, baseFlatten(arguments, false, true, ++index));
+  return baseDifference(value, baseFlatten(args, false, true, ++index));
 }
 
 export default difference;

array/dropRightWhile.js

@@ -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

array/findLastIndex.js

@@ -42,7 +42,7 @@ import baseCallback from '../internal/baseCallback';
  *
  * // using the `_.matchesProperty` callback shorthand
  * _.findLastIndex(users, 'active', false);
- * // => 1
+ * // => 2
  *
  * // using the `_.property` callback shorthand
  * _.findLastIndex(users, 'active');

array/flatten.js

@@ -26,7 +26,7 @@ function flatten(array, isDeep, guard) {
   if (guard && isIterateeCall(array, isDeep, guard)) {
     isDeep = false;
   }
-  return length ? baseFlatten(array, isDeep) : [];
+  return length ? baseFlatten(array, isDeep, false, 0) : [];
 }
 
 export default flatten;

array/flattenDeep.js

@@ -15,7 +15,7 @@ import baseFlatten from '../internal/baseFlatten';
  */
 function flattenDeep(array) {
   var length = array ? array.length : 0;
-  return length ? baseFlatten(array, true) : [];
+  return length ? baseFlatten(array, true, false, 0) : [];
 }
 
 export default flattenDeep;

array/indexOf.js

@@ -42,14 +42,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

@@ -47,11 +47,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

@@ -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/union.js

@@ -21,7 +21,7 @@ import baseUniq from '../internal/baseUniq';
  * // => [1, 2, 4]
  */
 function union() {
-  return baseUniq(baseFlatten(arguments, false, true));
+  return baseUniq(baseFlatten(arguments, false, true, 0));
 }
 
 export default union;

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:
- * `concat`, `join`, `pop`, `push`, `reverse`, `shift`, `slice`, `sort`, `splice`,
- * and `unshift`
+ * In addition to lodash methods, wrappers have `Array` and `String` methods.
+ *
+ * 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`,
- * `take`, `takeRight`, `takeRightWhile`, `takeWhile`, `tap`, `throttle`,
- * `thru`, `times`, `toArray`, `toPlainObject`, `transform`, `union`, `uniq`,
- * `unshift`, `unzip`, `values`, `valuesIn`, `where`, `without`, `wrap`, `xor`,
- * `zip`, and `zipObject`
+ * `shuffle`, `slice`, `sort`, `sortBy`, `sortByAll`, `sortByOrder`, `splice`,
+ * `spread`, `take`, `takeRight`, `takeRightWhile`, `takeWhile`, `tap`,
+ * `throttle`, `thru`, `times`, `toArray`, `toPlainObject`, `transform`,
+ * `union`, `uniq`, `unshift`, `unzip`, `values`, `valuesIn`, `where`,
+ * `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`,
- * `isDate`, `isElement`, `isEmpty`, `isEqual`, `isError`, `isFinite`,
- * `isFunction`, `isMatch`, `isNative`, `isNaN`, `isNull`, `isNumber`,
+ * `identity`, `includes`, `indexOf`, `inRange`, `isArguments`, `isArray`,
+ * `isBoolean`, `isDate`, `isElement`, `isEmpty`, `isEqual`, `isError`,
+ * `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`,
- * `trunc`, `unescape`, `uniqueId`, `value`, and `words`
+ * `startCase`, `startsWith`, `sum`, `template`, `trim`, `trimLeft`,
+ * `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.

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 min from './collection/min';
+import max from './math/max';
+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/max.js

@@ -1,53 +1,2 @@
-import arrayMax from '../internal/arrayMax';
-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);
-
+import max from '../math/max'
 export default max;

collection/min.js

@@ -1,53 +1,2 @@
-import arrayMin from '../internal/arrayMin';
-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);
-
+import min from '../math/min'
 export default min;

collection/partition.js

@@ -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/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
- * array-like values or the number of own enumerable properties for objects.
+ * Gets the size of `collection` by returning its length for array-like
+ * values or the number of own enumerable properties for objects.
  *
  * @static
  * @memberOf _

collection/sortBy.js

@@ -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 compareMultipleAscending from '../internal/compareMultipleAscending';
+import baseSortByOrder from '../internal/baseSortByOrder';
 import isIterateeCall from '../internal/isIterateeCall';
-import isLength from '../internal/isLength';
 
 /**
  * This method is like `_.sortBy` except that it sorts by property names
@@ -29,25 +26,16 @@ import isLength from '../internal/isLength';
  * // => [['barney', 26], ['barney', 36], ['fred', 30], ['fred', 40]]
  */
 function sortByAll(collection) {
-  var args = arguments;
-  if (args.length > 3 && isIterateeCall(args[1], args[2], args[3])) {
+  if (collection == null) {
+    return [];
+  }
+  var args = arguments,
+      guard = args[3];
+
+  if (guard && isIterateeCall(args[1], args[2], guard)) {
     args = [collection, args[1]];
   }
-  var index = -1,
-      length = collection ? collection.length : 0,
-      props = baseFlatten(args, false, false, 1),
-      result = isLength(length) ? Array(length) : [];
-
-  baseEach(collection, function(value) {
-    var length = props.length,
-        criteria = Array(length);
-
-    while (length--) {
-      criteria[length] = value == null ? undefined : value[props[length]];
-    }
-    result[++index] = { 'criteria': criteria, 'index': index, 'value': value };
-  });
-  return baseSortBy(result, compareMultipleAscending);
+  return baseSortByOrder(collection, baseFlatten(args, false, false, 1), []);
 }
 
 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/flow.js

@@ -1,8 +1,4 @@
-import arrayEvery from '../internal/arrayEvery';
-import baseIsFunction from '../internal/baseIsFunction';
-
-/** Used as the `TypeError` message for "Functions" methods. */
-var FUNC_ERROR_TEXT = 'Expected a function';
+import createComposer from '../internal/createComposer';
 
 /**
  * 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 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;
-  };
-}
+var flow = createComposer();
 
 export default flow;

function/flowRight.js

@@ -1,8 +1,4 @@
-import arrayEvery from '../internal/arrayEvery';
-import baseIsFunction from '../internal/baseIsFunction';
-
-/** Used as the `TypeError` message for "Functions" methods. */
-var FUNC_ERROR_TEXT = 'Expected a function';
+import createComposer from '../internal/createComposer';
 
 /**
  * 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 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;
-  };
-}
+var flowRight = createComposer(true);
 
 export default flowRight;

function/memoize.js

@@ -61,13 +61,14 @@ function memoize(func, resolver) {
     throw new TypeError(FUNC_ERROR_TEXT);
   }
   var memoized = function() {
-    var cache = memoized.cache,
-        key = resolver ? resolver.apply(this, arguments) : arguments[0];
+    var args = arguments,
+        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;
   };

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/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/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/baseFlatten.js

@@ -9,13 +9,13 @@ import isObjectLike from './isObjectLike';
  *
  * @private
  * @param {Array} array The array to flatten.
- * @param {boolean} [isDeep] Specify a deep flatten.
- * @param {boolean} [isStrict] Restrict flattening to arrays and `arguments` objects.
- * @param {number} [fromIndex=0] The index to start from.
+ * @param {boolean} isDeep Specify a deep flatten.
+ * @param {boolean} isStrict Restrict flattening to arrays and `arguments` objects.
+ * @param {number} fromIndex The index to start from.
  * @returns {Array} Returns the new flattened array.
  */
 function baseFlatten(array, isDeep, isStrict, fromIndex) {
-  var index = (fromIndex || 0) - 1,
+  var index = fromIndex - 1,
       length = array.length,
       resIndex = -1,
       result = [];
@@ -26,7 +26,7 @@ function baseFlatten(array, isDeep, isStrict, fromIndex) {
     if (isObjectLike(value) && isLength(value.length) && (isArray(value) || isArguments(value))) {
       if (isDeep) {
         // Recursively flatten arrays (susceptible to call stack limits).
-        value = baseFlatten(value, isDeep, isStrict);
+        value = baseFlatten(value, isDeep, isStrict, 0);
       }
       var valIndex = -1,
           valLength = value.length;

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/baseMerge.js

@@ -38,7 +38,7 @@ function baseMerge(object, source, customizer, stackA, stackB) {
       result = srcValue;
     }
     if ((isSrcArr || typeof result != 'undefined') &&
-        (isCommon || (result === result ? result !== value : value === value))) {
+        (isCommon || (result === result ? (result !== value) : (value === value)))) {
       object[key] = result;
     }
   });

internal/baseMergeDeep.js

@@ -59,7 +59,7 @@ function baseMergeDeep(object, source, key, mergeFunc, customizer, stackA, stack
   if (isCommon) {
     // Recursively merge objects and arrays (susceptible to call stack limits).
     object[key] = mergeFunc(result, srcValue, customizer, stackA, stackB);
-  } else if (result === result ? result !== value : value === value) {
+  } else if (result === result ? (result !== value) : (value === value)) {
     object[key] = result;
   }
 }

internal/baseSlice.js

@@ -19,7 +19,7 @@ function baseSlice(array, start, end) {
   if (end < 0) {
     end += length;
   }
-  length = start > end ? 0 : (end - start) >>> 0;
+  length = start > end ? 0 : ((end - start) >>> 0);
   start >>>= 0;
 
   var result = Array(length);

internal/baseSortBy.js

@@ -1,6 +1,6 @@
 /**
- * The base implementation of `_.sortBy` and `_.sortByAll` which uses `comparer`
- * to define the sort order of `array` and replaces criteria objects with their
+ * The base implementation of `_.sortBy` which uses `comparer` to define
+ * the sort order of `array` and replaces criteria objects with their
  * corresponding values.
  *
  * @private

internal/baseSortByOrder.js

@@ -0,0 +1,35 @@
+import baseEach from './baseEach';
+import baseSortBy from './baseSortBy';
+import compareMultiple from './compareMultiple';
+import isLength from './isLength';
+
+/**
+ * The base implementation of `_.sortByOrder` without param guards.
+ *
+ * @private
+ * @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`.
+ * @returns {Array} Returns the new sorted array.
+ */
+function baseSortByOrder(collection, props, orders) {
+  var index = -1,
+      length = collection.length,
+      result = isLength(length) ? Array(length) : [];
+
+  baseEach(collection, function(value) {
+    var length = props.length,
+        criteria = Array(length);
+
+    while (length--) {
+      criteria[length] = value == null ? undefined : value[props[length]];
+    }
+    result[++index] = { 'criteria': criteria, 'index': index, 'value': value };
+  });
+
+  return baseSortBy(result, function(object, other) {
+    return compareMultiple(object, other, orders);
+  });
+}
+
+export default baseSortByOrder;

internal/baseUniq.js

@@ -44,7 +44,7 @@ function baseUniq(array, iteratee) {
       }
       result.push(value);
     }
-    else if (indexOf(seen, computed) < 0) {
+    else if (indexOf(seen, computed, 0) < 0) {
       if (iteratee || isLarge) {
         seen.push(computed);
       }

internal/compareMultiple.js

@@ -1,24 +1,33 @@
 import baseCompareAscending from './baseCompareAscending';
 
 /**
- * Used by `_.sortByAll` to compare multiple properties of each element
- * in a collection and stable sort them in ascending order.
+ * Used by `_.sortByOrder` to compare multiple properties of each element
+ * in a collection and stable sort them in the following order:
+ *
+ * If orders is unspecified, sort in ascending order for all properties.
+ * Otherwise, for each property, sort in ascending order if its corresponding value in
+ * orders is true, and descending order if false.
  *
  * @private
  * @param {Object} object The object to compare to `other`.
  * @param {Object} other The object to compare to `object`.
+ * @param {boolean[]} orders The order to sort by for each property.
  * @returns {number} Returns the sort order indicator for `object`.
  */
-function compareMultipleAscending(object, other) {
+function compareMultiple(object, other, orders) {
   var index = -1,
       objCriteria = object.criteria,
       othCriteria = other.criteria,
-      length = objCriteria.length;
+      length = objCriteria.length,
+      ordersLength = orders.length;
 
   while (++index < length) {
     var result = baseCompareAscending(objCriteria[index], othCriteria[index]);
     if (result) {
-      return result;
+      if (index >= ordersLength) {
+        return result;
+      }
+      return result * (orders[index] ? 1 : -1);
     }
   }
   // Fixes an `Array#sort` bug in the JS engine embedded in Adobe applications
@@ -31,4 +40,4 @@ function compareMultipleAscending(object, other) {
   return object.index - other.index;
 }
 
-export default compareMultipleAscending;
+export default compareMultiple;

internal/createAssigner.js

@@ -11,24 +11,31 @@ import isIterateeCall from './isIterateeCall';
  */
 function createAssigner(assigner) {
   return function() {
-    var length = arguments.length,
-        object = arguments[0];
+    var args = arguments,
+        length = args.length,
+        object = args[0];
 
     if (length < 2 || object == null) {
       return object;
     }
-    if (length > 3 && isIterateeCall(arguments[1], arguments[2], arguments[3])) {
-      length = 2;
+    var customizer = args[length - 2],
+        thisArg = args[length - 1],
+        guard = args[3];
+
+    if (length > 3 && typeof customizer == 'function') {
+      customizer = bindCallback(customizer, thisArg, 5);
+      length -= 2;
+    } else {
+      customizer = (length > 2 && typeof thisArg == 'function') ? thisArg : null;
+      length -= (customizer ? 1 : 0);
     }
-    // Juggle arguments.
-    if (length > 3 && typeof arguments[length - 2] == 'function') {
-      var customizer = bindCallback(arguments[--length - 1], arguments[length--], 5);
-    } else if (length > 2 && typeof arguments[length - 1] == 'function') {
-      customizer = arguments[--length];
+    if (guard && isIterateeCall(args[1], args[2], guard)) {
+      customizer = length == 3 ? null : customizer;
+      length = 2;
     }
     var index = 0;
     while (++index < length) {
-      var source = arguments[index];
+      var source = args[index];
       if (source) {
         assigner(object, source, customizer);
       }

internal/createBindWrapper.js

@@ -1,4 +1,5 @@
 import createCtorWrapper from './createCtorWrapper';
+import root from './root';
 
 /**
  * Creates a function that wraps `func` and invokes it with the `this`
@@ -13,7 +14,8 @@ function createBindWrapper(func, thisArg) {
   var Ctor = createCtorWrapper(func);
 
   function wrapper() {
-    return (this instanceof wrapper ? Ctor : func).apply(thisArg, arguments);
+    var fn = (this && this !== root && this instanceof wrapper) ? Ctor : func;
+    return fn.apply(thisArg, arguments);
   }
   return wrapper;
 }

internal/createComposer.js

@@ -0,0 +1,39 @@
+/** Used as the `TypeError` message for "Functions" methods. */
+var FUNC_ERROR_TEXT = 'Expected a function';
+
+/**
+ * Creates a function to compose other functions into a single function.
+ *
+ * @private
+ * @param {boolean} [fromRight] Specify iterating from right to left.
+ * @returns {Function} Returns the new composer function.
+ */
+function createComposer(fromRight) {
+  return function() {
+    var length = arguments.length,
+        index = length,
+        fromIndex = fromRight ? (length - 1) : 0;
+
+    if (!length) {
+      return function() { return arguments[0]; };
+    }
+    var funcs = Array(length);
+    while (index--) {
+      funcs[index] = arguments[index];
+      if (typeof funcs[index] != 'function') {
+        throw new TypeError(FUNC_ERROR_TEXT);
+      }
+    }
+    return function() {
+      var index = fromIndex,
+          result = funcs[index].apply(this, arguments);
+
+      while ((fromRight ? index-- : ++index < length)) {
+        result = funcs[index].call(this, result);
+      }
+      return result;
+    };
+  };
+}
+
+export default createComposer;

internal/createHybridWrapper.js

@@ -4,6 +4,7 @@ import composeArgsRight from './composeArgsRight';
 import createCtorWrapper from './createCtorWrapper';
 import reorder from './reorder';
 import replaceHolders from './replaceHolders';
+import root from './root';
 
 /** Used to compose bitmasks for wrapper metadata. */
 var BIND_FLAG = 1,
@@ -96,7 +97,8 @@ function createHybridWrapper(func, bitmask, thisArg, partials, holders, partials
     if (isAry && ary < args.length) {
       args.length = ary;
     }
-    return (this instanceof wrapper ? (Ctor || createCtorWrapper(func)) : func).apply(thisBinding, args);
+    var fn = (this && this !== root && this instanceof wrapper) ? (Ctor || createCtorWrapper(func)) : func;
+    return fn.apply(thisBinding, args);
   }
   return wrapper;
 }

internal/createPartialWrapper.js

@@ -1,4 +1,5 @@
 import createCtorWrapper from './createCtorWrapper';
+import root from './root';
 
 /** Used to compose bitmasks for wrapper metadata. */
 var BIND_FLAG = 1;
@@ -34,7 +35,8 @@ function createPartialWrapper(func, bitmask, thisArg, partials) {
     while (argsLength--) {
       args[leftIndex++] = arguments[++argsIndex];
     }
-    return (this instanceof wrapper ? Ctor : func).apply(isBind ? thisArg : this, args);
+    var fn = (this && this !== root && this instanceof wrapper) ? Ctor : func;
+    return fn.apply(isBind ? thisArg : this, args);
   }
   return wrapper;
 }

internal/equalObjects.js

@@ -61,8 +61,10 @@ function equalObjects(object, other, equalFunc, customizer, isWhere, stackA, sta
         othCtor = other.constructor;
 
     // Non `Object` object instances with different constructors are not equal.
-    if (objCtor != othCtor && ('constructor' in object && 'constructor' in other) &&
-        !(typeof objCtor == 'function' && objCtor instanceof objCtor && typeof othCtor == 'function' && othCtor instanceof othCtor)) {
+    if (objCtor != othCtor &&
+        ('constructor' in object && 'constructor' in other) &&
+        !(typeof objCtor == 'function' && objCtor instanceof objCtor &&
+          typeof othCtor == 'function' && othCtor instanceof othCtor)) {
       return false;
     }
   }

internal/extremumBy.js

@@ -23,7 +23,8 @@ function extremumBy(collection, iteratee, isMin) {
 
   baseEach(collection, function(value, index, collection) {
     var current = iteratee(value, index, collection);
-    if ((isMin ? current < computed : current > computed) || (current === exValue && current === result)) {
+    if ((isMin ? (current < computed) : (current > computed)) ||
+        (current === exValue && current === result)) {
       computed = current;
       result = value;
     }

internal/indexOfNaN.js

@@ -4,13 +4,13 @@
  *
  * @private
  * @param {Array} array The array to search.
- * @param {number} [fromIndex] The index to search from.
+ * @param {number} fromIndex The index to search from.
  * @param {boolean} [fromRight] Specify iterating from right to left.
  * @returns {number} Returns the index of the matched `NaN`, else `-1`.
  */
 function indexOfNaN(array, fromIndex, fromRight) {
   var length = array.length,
-      index = fromRight ? (fromIndex || length) : ((fromIndex || 0) - 1);
+      index = fromIndex + (fromRight ? 0 : -1);
 
   while ((fromRight ? index-- : ++index < length)) {
     var other = array[index];

internal/isIterateeCall.js

@@ -24,7 +24,7 @@ function isIterateeCall(value, index, object) {
   }
   if (prereq) {
     var other = object[index];
-    return value === value ? value === other : other !== other;
+    return value === value ? (value === other) : (other !== other);
   }
   return false;
 }

internal/lazyClone.js

@@ -17,7 +17,6 @@ function lazyClone() {
 
   result.__actions__ = actions ? arrayCopy(actions) : null;
   result.__dir__ = this.__dir__;
-  result.__dropCount__ = this.__dropCount__;
   result.__filtered__ = this.__filtered__;
   result.__iteratees__ = iteratees ? arrayCopy(iteratees) : null;
   result.__takeCount__ = this.__takeCount__;

internal/lazyValue.js

@@ -3,8 +3,9 @@ import getView from './getView';
 import isArray from '../lang/isArray';
 
 /** Used to indicate the type of lazy iteratees. */
-var LAZY_FILTER_FLAG = 0,
-    LAZY_MAP_FLAG = 1;
+var LAZY_DROP_WHILE_FLAG = 0,
+    LAZY_FILTER_FLAG = 1,
+    LAZY_MAP_FLAG = 2;
 
 /* Native method references for those with the same name as other `lodash` methods. */
 var nativeMin = Math.min;
@@ -28,9 +29,8 @@ function lazyValue() {
       start = view.start,
       end = view.end,
       length = end - start,
-      dropCount = this.__dropCount__,
+      index = isRight ? end : (start - 1),
       takeCount = nativeMin(length, this.__takeCount__),
-      index = isRight ? end : start - 1,
       iteratees = this.__iteratees__,
       iterLength = iteratees ? iteratees.length : 0,
       resIndex = 0,
@@ -46,24 +46,34 @@ function lazyValue() {
     while (++iterIndex < iterLength) {
       var data = iteratees[iterIndex],
           iteratee = data.iteratee,
-          computed = iteratee(value, index, array),
           type = data.type;
 
-      if (type == LAZY_MAP_FLAG) {
-        value = computed;
-      } else if (!computed) {
-        if (type == LAZY_FILTER_FLAG) {
-          continue outer;
-        } else {
-          break outer;
+      if (type == LAZY_DROP_WHILE_FLAG) {
+        if (data.done && (isRight ? (index > data.index) : (index < data.index))) {
+          data.count = 0;
+          data.done = false;
+        }
+        data.index = index;
+        if (!data.done) {
+          var limit = data.limit;
+          if (!(data.done = limit > -1 ? (data.count++ >= limit) : !iteratee(value))) {
+            continue outer;
+          }
+        }
+      } else {
+        var computed = iteratee(value);
+        if (type == LAZY_MAP_FLAG) {
+          value = computed;
+        } else if (!computed) {
+          if (type == LAZY_FILTER_FLAG) {
+            continue outer;
+          } else {
+            break outer;
+          }
         }
       }
     }
-    if (dropCount) {
-      dropCount--;
-    } else {
-      result[resIndex++] = value;
-    }
+    result[resIndex++] = value;
   }
   return result;
 }

internal/root.js

@@ -4,24 +4,24 @@ var objectTypes = {
   'object': true
 };
 
-/**
- * Used as a reference to the global object.
- *
- * The `this` value is used if it is the global object to avoid Greasemonkey's
- * restricted `window` object, otherwise the `window` object is used.
- */
-var root = (objectTypes[typeof window] && window !== (this && this.window)) ? window : this;
-
 /** Detect free variable `exports`. */
 var freeExports = objectTypes[typeof exports] && exports && !exports.nodeType && exports;
 
 /** Detect free variable `module`. */
 var freeModule = objectTypes[typeof module] && module && !module.nodeType && module;
 
-/** Detect free variable `global` from Node.js or Browserified code and use it as `root`. */
+/** Detect free variable `global` from Node.js. */
 var freeGlobal = freeExports && freeModule && typeof global == 'object' && global;
-if (freeGlobal && (freeGlobal.global === freeGlobal || freeGlobal.window === freeGlobal || freeGlobal.self === freeGlobal)) {
-  root = freeGlobal;
-}
+
+/** Detect free variable `window`. */
+var freeWindow = objectTypes[typeof window] && window;
+
+/**
+ * Used as a reference to the global object.
+ *
+ * The `this` value is used if it is the global object to avoid Greasemonkey's
+ * restricted `window` object, otherwise the `window` object is used.
+ */
+var root = freeGlobal || ((freeWindow !== (this && this.window)) && freeWindow) || this;
 
 export default root;

lang/isElement.js

@@ -30,7 +30,7 @@ var objToString = objectProto.toString;
  */
 function isElement(value) {
   return (value && value.nodeType === 1 && isObjectLike(value) &&
-    objToString.call(value).indexOf('Element') > -1) || false;
+    (objToString.call(value).indexOf('Element') > -1)) || false;
 }
 // Fallback for environments without DOM support.
 if (!support.dom) {

lang/isEmpty.js

@@ -7,7 +7,7 @@ import isString from './isString';
 import keys from '../object/keys';
 
 /**
- * Checks if a value is empty. A value is considered empty unless it is an
+ * Checks if `value` is empty. A value is considered empty unless it is an
  * `arguments` object, array, string, or jQuery-like collection with a length
  * greater than `0` or an object with own enumerable properties.
  *

lodash.js

@@ -1,6 +1,6 @@
 /**
  * @license
- * lodash 3.3.1 (Custom Build) <https://lodash.com/>
+ * lodash 3.5.0 (Custom Build) <https://lodash.com/>
  * Build: `lodash modularize modern exports="es" -o ./`
  * Copyright 2012-2015 The Dojo Foundation <http://dojofoundation.org/>
  * Based on Underscore.js 1.8.2 <http://underscorejs.org/LICENSE>
@@ -13,6 +13,7 @@ import collection from './collection';
 import date from './date';
 import func from './function';
 import lang from './lang';
+import math from './math';
 import number from './number';
 import object from './object';
 import string from './string';
@@ -29,6 +30,7 @@ import identity from './utility/identity';
 import isArray from './lang/isArray';
 import isObject from './lang/isObject';
 import keys from './object/keys';
+import last from './array/last';
 import lazyClone from './internal/lazyClone';
 import lazyReverse from './internal/lazyReverse';
 import lazyValue from './internal/lazyValue';
@@ -38,14 +40,15 @@ import support from './support';
 import thru from './chain/thru';
 
 /** Used as the semantic version number. */
-var VERSION = '3.3.1';
+var VERSION = '3.5.0';
 
 /** Used to indicate the type of lazy iteratees. */
-var LAZY_FILTER_FLAG = 0,
-    LAZY_WHILE_FLAG = 2;
+var LAZY_DROP_WHILE_FLAG = 0,
+    LAZY_MAP_FLAG = 2;
 
 /** Used for native method references. */
-var arrayProto = Array.prototype;
+var arrayProto = Array.prototype,
+    stringProto = String.prototype;
 
 /** Native method references. */
 var floor = Math.floor,
@@ -150,6 +153,7 @@ lodash.shuffle = collection.shuffle;
 lodash.slice = array.slice;
 lodash.sortBy = collection.sortBy;
 lodash.sortByAll = collection.sortByAll;
+lodash.sortByOrder = collection.sortByOrder;
 lodash.spread = func.spread;
 lodash.take = array.take;
 lodash.takeRight = array.takeRight;
@@ -192,6 +196,7 @@ lodash.unique = array.uniq;
 mixin(lodash, lodash);
 
 // Add functions that return unwrapped values when chaining.
+lodash.add = math.add;
 lodash.attempt = utility.attempt;
 lodash.camelCase = string.camelCase;
 lodash.capitalize = string.capitalize;
@@ -237,10 +242,10 @@ lodash.isString = lang.isString;
 lodash.isTypedArray = lang.isTypedArray;
 lodash.isUndefined = lang.isUndefined;
 lodash.kebabCase = string.kebabCase;
-lodash.last = array.last;
+lodash.last = last;
 lodash.lastIndexOf = array.lastIndexOf;
-lodash.max = collection.max;
-lodash.min = collection.min;
+lodash.max = math.max;
+lodash.min = math.min;
 lodash.noop = utility.noop;
 lodash.now = date.now;
 lodash.pad = string.pad;
@@ -259,6 +264,7 @@ lodash.sortedIndex = array.sortedIndex;
 lodash.sortedLastIndex = array.sortedLastIndex;
 lodash.startCase = string.startCase;
 lodash.startsWith = string.startsWith;
+lodash.sum = math.sum;
 lodash.template = string.template;
 lodash.trim = string.trim;
 lodash.trimLeft = string.trimLeft;
@@ -319,31 +325,44 @@ arrayEach(['bind', 'bindKey', 'curry', 'curryRight', 'partial', 'partialRight'],
 });
 
 // Add `LazyWrapper` methods that accept an `iteratee` value.
-arrayEach(['filter', 'map', 'takeWhile'], function(methodName, index) {
-  var isFilter = index == LAZY_FILTER_FLAG || index == LAZY_WHILE_FLAG;
+arrayEach(['dropWhile', 'filter', 'map', 'takeWhile'], function(methodName, type) {
+  var isFilter = type != LAZY_MAP_FLAG,
+      isDropWhile = type == LAZY_DROP_WHILE_FLAG;
 
   LazyWrapper.prototype[methodName] = function(iteratee, thisArg) {
-    var result = this.clone(),
+    var filtered = this.__filtered__,
+        result = (filtered && isDropWhile) ? new LazyWrapper(this) : this.clone(),
         iteratees = result.__iteratees__ || (result.__iteratees__ = []);
 
-    result.__filtered__ = result.__filtered__ || isFilter;
-    iteratees.push({ 'iteratee': baseCallback(iteratee, thisArg, 3), 'type': index });
+    iteratees.push({
+      'done': false,
+      'count': 0,
+      'index': 0,
+      'iteratee': baseCallback(iteratee, thisArg, 1),
+      'limit': -1,
+      'type': type
+    });
+
+    result.__filtered__ = filtered || isFilter;
     return result;
   };
 });
 
 // Add `LazyWrapper` methods for `_.drop` and `_.take` variants.
 arrayEach(['drop', 'take'], function(methodName, index) {
-  var countName = '__' + methodName + 'Count__',
-      whileName = methodName + 'While';
+  var whileName = methodName + 'While';
 
   LazyWrapper.prototype[methodName] = function(n) {
-    n = n == null ? 1 : nativeMax(floor(n) || 0, 0);
+    var filtered = this.__filtered__,
+        result = (filtered && !index) ? this.dropWhile() : this.clone();
 
-    var result = this.clone();
-    if (result.__filtered__) {
-      var value = result[countName];
-      result[countName] = index ? nativeMin(value, n) : (value + n);
+    n = n == null ? 1 : nativeMax(floor(n) || 0, 0);
+    if (filtered) {
+      if (index) {
+        result.__takeCount__ = nativeMin(result.__takeCount__, n);
+      } else {
+        last(result.__iteratees__).limit = n;
+      }
     } else {
       var views = result.__views__ || (result.__views__ = []);
       views.push({ 'size': n, 'type': methodName + (result.__dir__ < 0 ? 'Right' : '') });
@@ -392,23 +411,10 @@ LazyWrapper.prototype.compact = function() {
   return this.filter(identity);
 };
 
-LazyWrapper.prototype.dropWhile = function(predicate, thisArg) {
-  var done,
-      lastIndex,
-      isRight = this.__dir__ < 0;
-
-  predicate = baseCallback(predicate, thisArg, 3);
-  return this.filter(function(value, index, array) {
-    done = done && (isRight ? index < lastIndex : index > lastIndex);
-    lastIndex = index;
-    return done || (done = !predicate(value, index, array));
-  });
-};
-
 LazyWrapper.prototype.reject = function(predicate, thisArg) {
-  predicate = baseCallback(predicate, thisArg, 3);
-  return this.filter(function(value, index, array) {
-    return !predicate(value, index, array);
+  predicate = baseCallback(predicate, thisArg, 1);
+  return this.filter(function(value) {
+    return !predicate(value);
   });
 };
 
@@ -430,16 +436,24 @@ LazyWrapper.prototype.toArray = function() {
 // Add `LazyWrapper` methods to `lodash.prototype`.
 baseForOwn(LazyWrapper.prototype, function(func, methodName) {
   var lodashFunc = lodash[methodName],
+      checkIteratee = /^(?:filter|map|reject)|While$/.test(methodName),
       retUnwrapped = /^(?:first|last)$/.test(methodName);
 
   lodash.prototype[methodName] = function() {
-    var value = this.__wrapped__,
-        args = arguments,
+    var args = arguments,
+        length = args.length,
         chainAll = this.__chain__,
+        value = this.__wrapped__,
         isHybrid = !!this.__actions__.length,
         isLazy = value instanceof LazyWrapper,
-        onlyLazy = isLazy && !isHybrid;
+        iteratee = args[0],
+        useLazy = isLazy || isArray(value);
 
+    if (useLazy && checkIteratee && typeof iteratee == 'function' && iteratee.length != 1) {
+      // avoid lazy use if the iteratee has a `length` other than `1`
+      isLazy = useLazy = false;
+    }
+    var onlyLazy = isLazy && !isHybrid;
     if (retUnwrapped && !chainAll) {
       return onlyLazy
         ? func.call(value)
@@ -450,7 +464,7 @@ baseForOwn(LazyWrapper.prototype, function(func, methodName) {
       push.apply(otherArgs, args);
       return lodashFunc.apply(lodash, otherArgs);
     };
-    if (isLazy || isArray(value)) {
+    if (useLazy) {
       var wrapper = onlyLazy ? value : new LazyWrapper(this),
           result = func.apply(wrapper, args);
 
@@ -464,11 +478,11 @@ baseForOwn(LazyWrapper.prototype, function(func, methodName) {
   };
 });
 
-// Add `Array.prototype` functions to `lodash.prototype`.
-arrayEach(['concat', 'join', 'pop', 'push', 'shift', 'sort', 'splice', 'unshift'], function(methodName) {
-  var func = arrayProto[methodName],
+// Add `Array` and `String` methods to `lodash.prototype`.
+arrayEach(['concat', 'join', 'pop', 'push', 'replace', 'shift', 'sort', 'splice', 'split', 'unshift'], function(methodName) {
+  var func = (/^(?:replace|split)$/.test(methodName) ? stringProto : arrayProto)[methodName],
       chainName = /^(?:push|sort|unshift)$/.test(methodName) ? 'tap' : 'thru',
-      retUnwrapped = /^(?:join|pop|shift)$/.test(methodName);
+      retUnwrapped = /^(?:join|pop|replace|shift)$/.test(methodName);
 
   lodash.prototype[methodName] = function() {
     var args = arguments;

math.js

@@ -0,0 +1,11 @@
+import add from './math/add';
+import max from './math/max';
+import min from './math/min';
+import sum from './math/sum';
+
+export default {
+  'add': add,
+  'max': max,
+  'min': min,
+  'sum': sum
+};

math/add.js

@@ -0,0 +1,19 @@
+/**
+ * Adds two numbers.
+ *
+ * @static
+ * @memberOf _
+ * @category Math
+ * @param {number} augend The first number to add.
+ * @param {number} addend The second number to add.
+ * @returns {number} Returns the sum.
+ * @example
+ *
+ * _.add(6, 4);
+ * // => 10
+ */
+function add(augend, addend) {
+  return augend + addend;
+}
+
+export default add;

math/max.js

@@ -0,0 +1,53 @@
+import arrayMax from '../internal/arrayMax';
+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 Math
+ * @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;

math/min.js

@@ -0,0 +1,53 @@
+import arrayMin from '../internal/arrayMin';
+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 Math
+ * @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;

math/sum.js

@@ -0,0 +1,33 @@
+import isArray from '../lang/isArray';
+import toIterable from '../internal/toIterable';
+
+/**
+ * Gets the sum of the values in `collection`.
+ *
+ * @static
+ * @memberOf _
+ * @category Math
+ * @param {Array|Object|string} collection The collection to iterate over.
+ * @returns {number} Returns the sum.
+ * @example
+ *
+ * _.sum([4, 6, 2]);
+ * // => 12
+ *
+ * _.sum({ 'a': 4, 'b': 6, 'c': 2 });
+ * // => 12
+ */
+function sum(collection) {
+  if (!isArray(collection)) {
+    collection = toIterable(collection);
+  }
+  var length = collection.length,
+      result = 0;
+
+  while (length--) {
+    result += +collection[length] || 0;
+  }
+  return result;
+}
+
+export default sum;

number/inRange.js

@@ -1,6 +1,6 @@
 /**
  * Checks if `n` is between `start` and up to but not including, `end`. If
- * `end` is not specified it defaults to `start` with `start` becoming `0`.
+ * `end` is not specified it is set to `start` with `start` then set to `0`.
  *
  * @static
  * @memberOf _

object/defaults.js

@@ -5,7 +5,7 @@ import assignDefaults from '../internal/assignDefaults';
 /**
  * Assigns own enumerable properties of source object(s) to the destination
  * object for all destination properties that resolve to `undefined`. Once a
- * property is set, additional defaults of the same property are ignored.
+ * property is set, additional values of the same property are ignored.
  *
  * @static
  * @memberOf _

object/keys.js

@@ -39,7 +39,7 @@ var keys = !nativeKeys ? shimKeys : function(object) {
         length = object.length;
   }
   if ((typeof Ctor == 'function' && Ctor.prototype === object) ||
-     (typeof object != 'function' && (length && isLength(length)))) {
+      (typeof object != 'function' && (length && isLength(length)))) {
     return shimKeys(object);
   }
   return isObject(object) ? nativeKeys(object) : [];

package.json

@@ -1,6 +1,6 @@
 {
   "name": "lodash-es",
-  "version": "3.3.1",
+  "version": "3.5.0",
   "description": "The modern build of lodash exported as ES modules.",
   "homepage": "https://lodash.com/custom-builds",
   "license": "MIT",

string/endsWith.js

@@ -29,7 +29,11 @@ function endsWith(string, target, position) {
   target = (target + '');
 
   var length = string.length;
-  position = (typeof position == 'undefined' ? length : nativeMin(position < 0 ? 0 : (+position || 0), length)) - target.length;
+  position = typeof position == 'undefined'
+    ? length
+    : nativeMin(position < 0 ? 0 : (+position || 0), length);
+
+  position -= target.length;
   return position >= 0 && string.indexOf(target, position) == position;
 }
 

string/escape.js

@@ -6,7 +6,7 @@ var reUnescapedHtml = /[&<>"'`]/g,
     reHasUnescapedHtml = RegExp(reUnescapedHtml.source);
 
 /**
- * Converts the characters "&", "<", ">", '"', "'", and '`', in `string` to
+ * Converts the characters "&", "<", ">", '"', "'", and "\`", in `string` to
  * their corresponding HTML entities.
  *
  * **Note:** No other characters are escaped. To escape additional characters

string/startsWith.js

@@ -26,7 +26,10 @@ var nativeMin = Math.min;
  */
 function startsWith(string, target, position) {
   string = baseToString(string);
-  position = position == null ? 0 : nativeMin(position < 0 ? 0 : (+position || 0), string.length);
+  position = position == null
+    ? 0
+    : nativeMin(position < 0 ? 0 : (+position || 0), string.length);
+
   return string.lastIndexOf(target, position) == position;
 }
 

string/trunc.js

@@ -60,7 +60,7 @@ function trunc(string, options, guard) {
   if (options != null) {
     if (isObject(options)) {
       var separator = 'separator' in options ? options.separator : separator;
-      length = 'length' in options ? +options.length || 0 : length;
+      length = 'length' in options ? (+options.length || 0) : length;
       omission = 'omission' in options ? baseToString(options.omission) : omission;
     } else {
       length = +options || 0;

string/words.js

@@ -6,7 +6,7 @@ var reWords = (function() {
   var upper = '[A-Z\\xc0-\\xd6\\xd8-\\xde]',
       lower = '[a-z\\xdf-\\xf6\\xf8-\\xff]+';
 
-  return RegExp(upper + '{2,}(?=' + upper + lower + ')|' + upper + '?' + lower + '|' + upper + '+|[0-9]+', 'g');
+  return RegExp(upper + '+(?=' + upper + lower + ')|' + upper + '?' + lower + '|' + upper + '+|[0-9]+', 'g');
 }());
 
 /**

utility/attempt.js

@@ -21,14 +21,14 @@ import isError from '../lang/isError';
  * }
  */
 function attempt() {
-  var length = arguments.length,
-      func = arguments[0];
+  var func = arguments[0],
+      length = arguments.length,
+      args = Array(length ? (length - 1) : 0);
 
+  while (--length > 0) {
+    args[length - 1] = arguments[length];
+  }
   try {
-    var args = Array(length ? length - 1 : 0);
-    while (--length > 0) {
-      args[length - 1] = arguments[length];
-    }
     return func.apply(undefined, args);
   } catch(e) {
     return isError(e) ? e : new Error(e);

utility/mixin.js

@@ -70,7 +70,11 @@ function mixin(object, source, options) {
           var chainAll = this.__chain__;
           if (chain || chainAll) {
             var result = object(this.__wrapped__);
-            (result.__actions__ = arrayCopy(this.__actions__)).push({ 'func': func, 'args': arguments, 'thisArg': object });
+            (result.__actions__ = arrayCopy(this.__actions__)).push({
+              'func': func,
+              'args': arguments,
+              'thisArg': object
+            });
             result.__chain__ = chainAll;
             return result;
           }

utility/range.js

@@ -8,9 +8,9 @@ var nativeMax = Math.max;
 
 /**
  * Creates an array of numbers (positive and/or negative) progressing from
- * `start` up to, but not including, `end`. If `end` is not specified it
- * defaults to `start` with `start` becoming `0`. If `start` is less than
- * `end` a zero-length range is created unless a negative `step` is specified.
+ * `start` up to, but not including, `end`. If `end` is not specified it is
+ * set to `start` with `start` then set to `0`. If `start` is less than `end`
+ * a zero-length range is created unless a negative `step` is specified.
  *
  * @static
  * @memberOf _