Bump to v3.3.1.

README.md

@@ -1,4 +1,4 @@
-# lodash v3.0.1
+# lodash v3.3.1
 
 The [modern build](https://github.com/lodash/lodash/wiki/Build-Differences) of [lodash](https://lodash.com/) exported as [Node.js](http://nodejs.org/)/[io.js](https://iojs.org/) modules.
 
@@ -24,11 +24,11 @@ In Node.js/io.js:
 var _ = require('lodash');
 // or a method category
 var array = require('lodash/array');
-// or a method
+// or a method (works great with browserify/webpack to create smaller builds)
 var chunk = require('lodash/array/chunk');
 ```
 
-See the [package source](https://github.com/lodash/lodash/tree/3.0.1-npm) for more details.
+See the [package source](https://github.com/lodash/lodash/tree/3.3.1-npm) for more details.
 
 **Note:**<br>
 Don’t assign values to the [special variable](http://nodejs.org/api/repl.html#repl_repl_features) `_` when in the REPL.<br>
@@ -39,8 +39,8 @@ Install [n_](https://www.npmjs.com/package/n_) for a REPL that includes lodash b
 lodash is also available in a variety of other builds & module formats.
 
  * npm packages for [modern](https://www.npmjs.com/package/lodash), [compatibility](https://www.npmjs.com/package/lodash-compat), & [per method](https://www.npmjs.com/browse/keyword/lodash-modularized) builds
- * AMD modules for [modern](https://github.com/lodash/lodash/tree/3.0.1-amd) & [compatibility](https://github.com/lodash/lodash-compat/tree/3.0.1-amd) builds
+ * AMD modules for [modern](https://github.com/lodash/lodash/tree/3.3.1-amd) & [compatibility](https://github.com/lodash/lodash-compat/tree/3.3.1-amd) builds
- * ES modules for the [modern](https://github.com/lodash/lodash/tree/3.0.1-es) build
+ * ES modules for the [modern](https://github.com/lodash/lodash/tree/3.3.1-es) build
 
 ## Further Reading
 
@@ -68,47 +68,48 @@ lodash is also available in a variety of other builds & module formats.
  * [_.create](https://lodash.com/docs#create) for easier object inheritance
  * [_.curry](https://lodash.com/docs#curry) & [_.curryRight](https://lodash.com/docs#curryRight) for creating [curried](http://hughfdjackson.com/javascript/why-curry-helps/) functions
  * [_.debounce](https://lodash.com/docs#debounce) & [_.throttle](https://lodash.com/docs#throttle) are cancelable & accept options for more control
- * [_.findIndex](https://lodash.com/docs#findIndex) & [_.findKey](https://lodash.com/docs#findKey) for finding indexes & keys
+ * [_.fill](https://lodash.com/docs#fill) to fill arrays with values
- * [_.flow](https://lodash.com/docs#flow) to complement [_.flowRight](https://lodash.com/docs#flowRight) (a.k.a `_.backflow` & `_.compose`)
+ * [_.findKey](https://lodash.com/docs#findKey) for finding keys
+ * [_.flow](https://lodash.com/docs#flow) to complement [_.flowRight](https://lodash.com/docs#flowRight) (a.k.a `_.compose`)
  * [_.forEach](https://lodash.com/docs#forEach) supports exiting early
  * [_.forIn](https://lodash.com/docs#forIn) for iterating all enumerable properties
  * [_.forOwn](https://lodash.com/docs#forOwn) for iterating own properties
- * [_.includes](https://lodash.com/docs#includes) accepts a `fromIndex`
+ * [_.inRange](https://lodash.com/docs#inRange) for checking whether a number is within a given range
- * [_.isError](https://lodash.com/docs#isError) to check for error objects
  * [_.isNative](https://lodash.com/docs#isNative) to check for native functions
  * [_.isPlainObject](https://lodash.com/docs#isPlainObject) & [_.toPlainObject](https://lodash.com/docs#toPlainObject) to check for & convert to `Object` objects
  * [_.isTypedArray](https://lodash.com/docs#isTypedArray) to check for typed arrays
- * [_.keysIn](https://lodash.com/docs#keysIn) & [_.valuesIn](https://lodash.com/docs#valuesIn) for getting keys & values of all enumerable properties
- * [_.mapValues](https://lodash.com/docs#mapValues) for [mapping](https://lodash.com/docs#map) values to an object
  * [_.matches](https://lodash.com/docs#matches) supports deep object comparisons
+ * [_.matchesProperty](https://lodash.com/docs#matchesProperty) to complement [_.matches](https://lodash.com/docs#matches) & [_.property](https://lodash.com/docs#property)
  * [_.merge](https://lodash.com/docs#merge) for a deep [_.extend](https://lodash.com/docs#extend)
  * [_.parseInt](https://lodash.com/docs#parseInt) for consistent cross-environment behavior
- * [_.propertyOf](https://lodash.com/docs#propertyOf) to complement [_.property](https://lodash.com/docs#property)
  * [_.pull](https://lodash.com/docs#pull), [_.pullAt](https://lodash.com/docs#pullAt), & [_.remove](https://lodash.com/docs#remove) for mutating arrays
  * [_.random](https://lodash.com/docs#random) supports returning floating-point numbers
  * [_.runInContext](https://lodash.com/docs#runInContext) for collisionless mixins & easier mocking
  * [_.slice](https://lodash.com/docs#slice) for creating subsets of array-like values
  * [_.sortByAll](https://lodash.com/docs#sortBy) for sorting by multiple properties
+ * [_.spread](https://lodash.com/docs#spread) for creating a function to spread an array of arguments to another
  * [_.support](https://lodash.com/docs#support) for flagging environment features
  * [_.template](https://lodash.com/docs#template) supports [*“imports”*](https://lodash.com/docs#templateSettings-imports) options & [ES template delimiters](http://people.mozilla.org/~jorendorff/es6-draft.html#sec-template-literal-lexical-components)
  * [_.transform](https://lodash.com/docs#transform) as a powerful alternative to [_.reduce](https://lodash.com/docs#reduce) for transforming objects
- * [_.thru](https://lodash.com/docs#thru) to pass values thru method chains
  * [_.xor](https://lodash.com/docs#xor) to complement [_.difference](https://lodash.com/docs#difference), [_.intersection](https://lodash.com/docs#intersection), & [_.union](https://lodash.com/docs#union)
+ * [_.valuesIn](https://lodash.com/docs#valuesIn) for getting values of all enumerable properties
  * [_.bind](https://lodash.com/docs#bind), [_.curry](https://lodash.com/docs#curry), [_.partial](https://lodash.com/docs#partial), &
    [more](https://lodash.com/docs "_.bindKey, _.curryRight, _.partialRight") support customizable argument placeholders
  * [_.capitalize](https://lodash.com/docs#capitalize), [_.trim](https://lodash.com/docs#trim), &
-   [more](https://lodash.com/docs "_.camelCase, _.deburr, _.endsWith, _.escapeRegExp, _.kebabCase, _.pad, _.padLeft, _.padRight, _.repeat, _.snakeCase, _.startsWith, _.trimLeft, _.trimRight, _.trunc, _.words") string methods
+   [more](https://lodash.com/docs "_.camelCase, _.deburr, _.endsWith, _.escapeRegExp, _.kebabCase, _.pad, _.padLeft, _.padRight, _.repeat, _.snakeCase, _.startCase, _.startsWith, _.trimLeft, _.trimRight, _.trunc, _.words") string methods
  * [_.clone](https://lodash.com/docs#clone), [_.isEqual](https://lodash.com/docs#isEqual), &
    [more](https://lodash.com/docs "_.assign, _.cloneDeep, _.merge") accept callbacks
  * [_.dropWhile](https://lodash.com/docs#dropWhile), [_.takeWhile](https://lodash.com/docs#takeWhile), &
    [more](https://lodash.com/docs "_.drop, _.dropRightWhile, _.take, _.takeRightWhile") to complement [_.first](https://lodash.com/docs#first), [_.initial](https://lodash.com/docs#initial), [_.last](https://lodash.com/docs#last), & [_.rest](https://lodash.com/docs#rest)
- * [_.findLast](https://lodash.com/docs#findLast), [_.findLastIndex](https://lodash.com/docs#findLastIndex), &
+ * [_.findLast](https://lodash.com/docs#findLast), [_.findLastKey](https://lodash.com/docs#findLastKey), &
-   [more](https://lodash.com/docs "_.findLastKey, _.flowRight, _.forEachRight, _.forInRight, _.forOwnRight, _.partialRight") right-associative methods
+   [more](https://lodash.com/docs "_.flowRight, _.forEachRight, _.forInRight, _.forOwnRight, _.partialRight") right-associative methods
  * [_.includes](https://lodash.com/docs#includes), [_.toArray](https://lodash.com/docs#toArray), &
    [more](https://lodash.com/docs "_.at, _.countBy, _.every, _.filter, _.find, _.findLast, _.forEach, _.forEachRight, _.groupBy, _.indexBy, _.invoke, _.map, _.max, _.min, _.partition, _.pluck, _.reduce, _.reduceRight, _.reject, _.shuffle, _.size, _.some, _.sortBy") accept strings
+ * [_#commit](https://lodash.com/docs#prototype-commit) & [_#plant](https://lodash.com/docs#prototype-plant) for working with chain sequences
+ * [_#thru](https://lodash.com/docs#thru) to pass values thru a chain sequence
 
 ## Support
 
-Tested in Chrome 39-40, Firefox 34-35, IE 6-11, Opera 25-26, Safari 5-8, io.js 1.0.4, Node.js 0.8.28 & 0.10.35, PhantomJS 1.9.8, RingoJS 0.11, & Rhino 1.7RC5.
+Tested in Chrome 39-40, Firefox 34-35, IE 6-11, Opera 26-27, Safari 5-8, io.js 1.3.0, Node.js 0.8.28, 0.10.36, & 0.12.0, PhantomJS 1.9.8, RingoJS 0.11, & Rhino 1.7RC5.
 
 Automated [browser](https://saucelabs.com/u/lodash) & [CI](https://travis-ci.org/lodash/lodash/) test runs are available. Special thanks to [Sauce Labs](https://saucelabs.com/) for providing automated browser testing.

array.js

@@ -6,6 +6,7 @@ module.exports = {
   'dropRight': require('./array/dropRight'),
   'dropRightWhile': require('./array/dropRightWhile'),
   'dropWhile': require('./array/dropWhile'),
+  'fill': require('./array/fill'),
   'findIndex': require('./array/findIndex'),
   'findLastIndex': require('./array/findLastIndex'),
   'first': require('./array/first'),

array/chunk.js

@@ -16,7 +16,7 @@ var nativeMax = Math.max;
  * @memberOf _
  * @category Array
  * @param {Array} array The array to process.
- * @param {numer} [size=1] The length of each chunk.
+ * @param {number} [size=1] The length of each chunk.
  * @param- {Object} [guard] Enables use as a callback for functions like `_.map`.
  * @returns {Array} Returns the new array containing chunks.
  * @example

array/difference.js

@@ -20,7 +20,7 @@ var baseDifference = require('../internal/baseDifference'),
  * @returns {Array} Returns the new array of filtered values.
  * @example
  *
- * _.difference([1, 2, 3], [5, 2, 10]);
+ * _.difference([1, 2, 3], [4, 2]);
  * // => [1, 3]
  */
 function difference() {

array/drop.js

@@ -6,7 +6,6 @@ var baseSlice = require('../internal/baseSlice'),
  *
  * @static
  * @memberOf _
- * @type Function
  * @category Array
  * @param {Array} array The array to query.
  * @param {number} [n=1] The number of elements to drop.

array/dropRight.js

@@ -6,7 +6,6 @@ var baseSlice = require('../internal/baseSlice'),
  *
  * @static
  * @memberOf _
- * @type Function
  * @category Array
  * @param {Array} array The array to query.
  * @param {number} [n=1] The number of elements to drop.

array/dropRightWhile.js

@@ -6,40 +6,49 @@ var baseCallback = require('../internal/baseCallback'),
  * Elements are dropped until `predicate` returns falsey. The predicate is
  * bound to `thisArg` and invoked with three arguments; (value, index, array).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * If a value is also provided for `thisArg` the created `_.matchesProperty`
- * callback returns `true` for elements that have the properties of the given
+ * 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 match the properties of the given
  * object, else `false`.
  *
  * @static
  * @memberOf _
- * @type Function
  * @category Array
  * @param {Array} array The array to query.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per element.
+ *  per iteration.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {Array} Returns the slice of `array`.
  * @example
  *
- * _.dropRightWhile([1, 2, 3], function(n) { return n > 1; });
+ * _.dropRightWhile([1, 2, 3], function(n) {
+ *   return n > 1;
+ * });
  * // => [1]
  *
  * var users = [
- *   { 'user': 'barney',  'status': 'busy', 'active': false },
+ *   { 'user': 'barney',  'active': true },
- *   { 'user': 'fred',    'status': 'busy', 'active': true },
+ *   { 'user': 'fred',    'active': false },
- *   { 'user': 'pebbles', 'status': 'away', 'active': true }
+ *   { 'user': 'pebbles', 'active': false }
  * ];
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.matches` callback shorthand
- * _.pluck(_.dropRightWhile(users, 'active'), 'user');
+ * _.pluck(_.dropRightWhile(users, { 'user': pebbles, 'active': false }), 'user');
+ * // => ['barney', 'fred']
+ *
+ * // using the `_.matchesProperty` callback shorthand
+ * _.pluck(_.dropRightWhile(users, 'active', false), 'user');
  * // => ['barney']
  *
- * // using the "_.matches" callback shorthand
+ * // using the `_.property` callback shorthand
- * _.pluck(_.dropRightWhile(users, { 'status': 'away' }), 'user');
+ * _.pluck(_.dropRightWhile(users, 'active'), 'user');
- * // => ['barney', 'fred']
+ * // => ['barney', 'fred', 'pebbles']
  */
 function dropRightWhile(array, predicate, thisArg) {
   var length = array ? array.length : 0;

array/dropWhile.js

@@ -6,40 +6,49 @@ var baseCallback = require('../internal/baseCallback'),
  * Elements are dropped until `predicate` returns falsey. The predicate is
  * bound to `thisArg` and invoked with three arguments; (value, index, array).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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 _
- * @type Function
  * @category Array
  * @param {Array} array The array to query.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per element.
+ *  per iteration.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {Array} Returns the slice of `array`.
  * @example
  *
- * _.dropWhile([1, 2, 3], function(n) { return n < 3; });
+ * _.dropWhile([1, 2, 3], function(n) {
+ *   return n < 3;
+ * });
  * // => [3]
  *
  * var users = [
- *   { 'user': 'barney',  'status': 'busy', 'active': true },
+ *   { 'user': 'barney',  'active': false },
- *   { 'user': 'fred',    'status': 'busy', 'active': false },
+ *   { 'user': 'fred',    'active': false },
- *   { 'user': 'pebbles', 'status': 'away', 'active': true }
+ *   { 'user': 'pebbles', 'active': true }
  * ];
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.matches` callback shorthand
- * _.pluck(_.dropWhile(users, 'active'), 'user');
+ * _.pluck(_.dropWhile(users, { 'user': 'barney', 'active': false }), 'user');
  * // => ['fred', 'pebbles']
  *
- * // using the "_.matches" callback shorthand
+ * // using the `_.matchesProperty` callback shorthand
- * _.pluck(_.dropWhile(users, { 'status': 'busy' }), 'user');
+ * _.pluck(_.dropWhile(users, 'active', false), 'user');
  * // => ['pebbles']
+ *
+ * // using the `_.property` callback shorthand
+ * _.pluck(_.dropWhile(users, 'active'), 'user');
+ * // => ['barney', 'fred', 'pebbles']
  */
 function dropWhile(array, predicate, thisArg) {
   var length = array ? array.length : 0;

array/fill.js

@@ -0,0 +1,31 @@
+var baseFill = require('../internal/baseFill'),
+    isIterateeCall = require('../internal/isIterateeCall');
+
+/**
+ * Fills elements of `array` with `value` from `start` up to, but not
+ * including, `end`.
+ *
+ * **Note:** This method mutates `array`.
+ *
+ * @static
+ * @memberOf _
+ * @category Array
+ * @param {Array} array The array to fill.
+ * @param {*} value The value to fill `array` with.
+ * @param {number} [start=0] The start position.
+ * @param {number} [end=array.length] The end position.
+ * @returns {Array} Returns `array`.
+ */
+function fill(array, value, start, end) {
+  var length = array ? array.length : 0;
+  if (!length) {
+    return [];
+  }
+  if (start && typeof start != 'number' && isIterateeCall(array, value, start)) {
+    start = 0;
+    end = length;
+  }
+  return baseFill(array, value, start, end);
+}
+
+module.exports = fill;

array/findIndex.js

@@ -4,10 +4,14 @@ var baseCallback = require('../internal/baseCallback');
  * This method is like `_.find` except that it returns the index of the first
  * element `predicate` returns truthy for, instead of the element itself.
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -16,28 +20,33 @@ var baseCallback = require('../internal/baseCallback');
  * @category Array
  * @param {Array} array The array to search.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {number} Returns the index of the found element, else `-1`.
  * @example
  *
  * var users = [
- *   { 'user': 'barney',  'age': 36, 'active': false },
+ *   { 'user': 'barney',  'active': false },
- *   { 'user': 'fred',    'age': 40, 'active': true },
+ *   { 'user': 'fred',    'active': false },
- *   { 'user': 'pebbles', 'age': 1,  'active': false }
+ *   { 'user': 'pebbles', 'active': true }
  * ];
  *
- * _.findIndex(users, function(chr) { return chr.age < 40; });
+ * _.findIndex(users, function(chr) {
+ *   return chr.user == 'barney';
+ * });
  * // => 0
  *
- * // using the "_.matches" callback shorthand
+ * // using the `_.matches` callback shorthand
- * _.findIndex(users, { 'age': 1 });
+ * _.findIndex(users, { 'user': 'fred', 'active': false });
- * // => 2
- *
- * // using the "_.property" callback shorthand
- * _.findIndex(users, 'active');
  * // => 1
+ *
+ * // using the `_.matchesProperty` callback shorthand
+ * _.findIndex(users, 'active', false);
+ * // => 0
+ *
+ * // using the `_.property` callback shorthand
+ * _.findIndex(users, 'active');
+ * // => 2
  */
 function findIndex(array, predicate, thisArg) {
   var index = -1,

array/findLastIndex.js

@@ -4,10 +4,14 @@ var baseCallback = require('../internal/baseCallback');
  * This method is like `_.findIndex` except that it iterates over elements
  * of `collection` from right to left.
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -16,26 +20,31 @@ var baseCallback = require('../internal/baseCallback');
  * @category Array
  * @param {Array} array The array to search.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {number} Returns the index of the found element, else `-1`.
  * @example
  *
  * var users = [
- *   { 'user': 'barney',  'age': 36, 'active': true },
+ *   { 'user': 'barney',  'active': true },
- *   { 'user': 'fred',    'age': 40, 'active': false },
+ *   { 'user': 'fred',    'active': false },
- *   { 'user': 'pebbles', 'age': 1,  'active': false }
+ *   { 'user': 'pebbles', 'active': false }
  * ];
  *
- * _.findLastIndex(users, function(chr) { return chr.age < 40; });
+ * _.findLastIndex(users, function(chr) {
+ *   return chr.user == 'pebbles';
+ * });
  * // => 2
  *
- * // using the "_.matches" callback shorthand
+ * // using the `_.matches` callback shorthand
- * _.findLastIndex(users, { 'age': 40 });
+ * _.findLastIndex(users, { 'user': 'barney', 'active': true });
+ * // => 0
+ *
+ * // using the `_.matchesProperty` callback shorthand
+ * _.findLastIndex(users, 'active', false);
  * // => 1
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.property` callback shorthand
  * _.findLastIndex(users, 'active');
  * // => 0
  */

array/flatten.js

@@ -14,11 +14,11 @@ var baseFlatten = require('../internal/baseFlatten'),
  * @returns {Array} Returns the new flattened array.
  * @example
  *
- * _.flatten([1, [2], [3, [[4]]]]);
+ * _.flatten([1, [2, 3, [4]]]);
- * // => [1, 2, 3, [[4]]];
+ * // => [1, 2, 3, [4]];
  *
  * // using `isDeep`
- * _.flatten([1, [2], [3, [[4]]]], true);
+ * _.flatten([1, [2, 3, [4]]], true);
  * // => [1, 2, 3, 4];
  */
 function flatten(array, isDeep, guard) {

array/flattenDeep.js

@@ -10,7 +10,7 @@ var baseFlatten = require('../internal/baseFlatten');
  * @returns {Array} Returns the new flattened array.
  * @example
  *
- * _.flattenDeep([1, [2], [3, [[4]]]]);
+ * _.flattenDeep([1, [2, 3, [4]]]);
  * // => [1, 2, 3, 4];
  */
 function flattenDeep(array) {

array/indexOf.js

@@ -25,15 +25,15 @@ var nativeMax = Math.max;
  * @returns {number} Returns the index of the matched value, else `-1`.
  * @example
  *
- * _.indexOf([1, 2, 3, 1, 2, 3], 2);
+ * _.indexOf([1, 2, 1, 2], 2);
  * // => 1
  *
  * // using `fromIndex`
- * _.indexOf([1, 2, 3, 1, 2, 3], 2, 3);
+ * _.indexOf([1, 2, 1, 2], 2, 2);
- * // => 4
+ * // => 3
  *
  * // performing a binary search
- * _.indexOf([4, 4, 5, 5, 6, 6], 5, true);
+ * _.indexOf([1, 1, 2, 2], 2, true);
  * // => 2
  */
 function indexOf(array, value, fromIndex) {

array/intersection.js

@@ -19,9 +19,8 @@ var baseIndexOf = require('../internal/baseIndexOf'),
  * @param {...Array} [arrays] The arrays to inspect.
  * @returns {Array} Returns the new array of shared values.
  * @example
- *
+ * _.intersection([1, 2], [4, 2], [2, 1]);
- * _.intersection([1, 2, 3], [5, 2, 1, 4], [2, 1]);
+ * // => [2]
- * // => [1, 2]
  */
 function intersection() {
   var args = [],
@@ -35,7 +34,7 @@ function intersection() {
     var value = arguments[argsIndex];
     if (isArray(value) || isArguments(value)) {
       args.push(value);
-      caches.push(isCommon && value.length >= 120 && createCache(argsIndex && value));
+      caches.push((isCommon && value.length >= 120) ? createCache(argsIndex && value) : null);
     }
   }
   argsLength = args.length;

array/lastIndexOf.js

@@ -19,15 +19,15 @@ var nativeMax = Math.max,
  * @returns {number} Returns the index of the matched value, else `-1`.
  * @example
  *
- * _.lastIndexOf([1, 2, 3, 1, 2, 3], 2);
+ * _.lastIndexOf([1, 2, 1, 2], 2);
- * // => 4
+ * // => 3
  *
  * // using `fromIndex`
- * _.lastIndexOf([1, 2, 3, 1, 2, 3], 2, 3);
+ * _.lastIndexOf([1, 2, 1, 2], 2, 2);
  * // => 1
  *
  * // performing a binary search
- * _.lastIndexOf([4, 4, 5, 5, 6, 6], 5, true);
+ * _.lastIndexOf([1, 1, 2, 2], 2, true);
  * // => 3
  */
 function lastIndexOf(array, value, fromIndex) {

array/pull.js

@@ -25,6 +25,7 @@ var splice = arrayProto.splice;
  * @example
  *
  * var array = [1, 2, 3, 1, 2, 3];
+ *
  * _.pull(array, 2, 3);
  * console.log(array);
  * // => [1, 1]

array/pullAt.js

@@ -18,7 +18,7 @@ var baseFlatten = require('../internal/baseFlatten'),
  * @example
  *
  * var array = [5, 10, 15, 20];
- * var evens = _.pullAt(array, [1, 3]);
+ * var evens = _.pullAt(array, 1, 3);
  *
  * console.log(array);
  * // => [5, 15]

array/remove.js

@@ -11,10 +11,14 @@ var splice = arrayProto.splice;
  * and returns an array of the removed elements. The predicate is bound to
  * `thisArg` and invoked with three arguments; (value, index, array).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -25,14 +29,15 @@ var splice = arrayProto.splice;
  * @category Array
  * @param {Array} array The array to modify.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {Array} Returns the new array of removed elements.
  * @example
  *
  * var array = [1, 2, 3, 4];
- * var evens = _.remove(array, function(n) { return n % 2 == 0; });
+ * var evens = _.remove(array, function(n) {
+ *   return n % 2 == 0;
+ * });
  *
  * console.log(array);
  * // => [1, 3]

array/sortedIndex.js

@@ -9,10 +9,14 @@ var baseCallback = require('../internal/baseCallback'),
  * to compute their sort ranking. The iteratee is bound to `thisArg` and
  * invoked with one argument; (value).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -22,8 +26,7 @@ var baseCallback = require('../internal/baseCallback'),
  * @param {Array} array The sorted array to inspect.
  * @param {*} value The value to evaluate.
  * @param {Function|Object|string} [iteratee=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `iteratee`.
  * @returns {number} Returns the index at which `value` should be inserted
  *  into `array`.
@@ -32,7 +35,7 @@ var baseCallback = require('../internal/baseCallback'),
  * _.sortedIndex([30, 50], 40);
  * // => 1
  *
- * _.sortedIndex([4, 4, 5, 5, 6, 6], 5);
+ * _.sortedIndex([4, 4, 5, 5], 5);
  * // => 2
  *
  * var dict = { 'data': { 'thirty': 30, 'forty': 40, 'fifty': 50 } };
@@ -43,7 +46,7 @@ var baseCallback = require('../internal/baseCallback'),
  * }, dict);
  * // => 1
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.property` callback shorthand
  * _.sortedIndex([{ 'x': 30 }, { 'x': 50 }], { 'x': 40 }, 'x');
  * // => 1
  */

array/sortedLastIndex.js

@@ -13,14 +13,13 @@ var baseCallback = require('../internal/baseCallback'),
  * @param {Array} array The sorted array to inspect.
  * @param {*} value The value to evaluate.
  * @param {Function|Object|string} [iteratee=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `iteratee`.
  * @returns {number} Returns the index at which `value` should be inserted
  *  into `array`.
  * @example
  *
- * _.sortedLastIndex([4, 4, 5, 5, 6, 6], 5);
+ * _.sortedLastIndex([4, 4, 5, 5], 5);
  * // => 4
  */
 function sortedLastIndex(array, value, iteratee, thisArg) {

array/take.js

@@ -6,7 +6,6 @@ var baseSlice = require('../internal/baseSlice'),
  *
  * @static
  * @memberOf _
- * @type Function
  * @category Array
  * @param {Array} array The array to query.
  * @param {number} [n=1] The number of elements to take.

array/takeRight.js

@@ -6,7 +6,6 @@ var baseSlice = require('../internal/baseSlice'),
  *
  * @static
  * @memberOf _
- * @type Function
  * @category Array
  * @param {Array} array The array to query.
  * @param {number} [n=1] The number of elements to take.

array/takeRightWhile.js

@@ -6,40 +6,49 @@ var baseCallback = require('../internal/baseCallback'),
  * taken until `predicate` returns falsey. The predicate is bound to `thisArg`
  * and invoked with three arguments; (value, index, array).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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 _
- * @type Function
  * @category Array
  * @param {Array} array The array to query.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per element.
+ *  per iteration.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {Array} Returns the slice of `array`.
  * @example
  *
- * _.takeRightWhile([1, 2, 3], function(n) { return n > 1; });
+ * _.takeRightWhile([1, 2, 3], function(n) {
+ *   return n > 1;
+ * });
  * // => [2, 3]
  *
  * var users = [
- *   { 'user': 'barney',  'status': 'busy', 'active': false },
+ *   { 'user': 'barney',  'active': true },
- *   { 'user': 'fred',    'status': 'busy', 'active': true },
+ *   { 'user': 'fred',    'active': false },
- *   { 'user': 'pebbles', 'status': 'away', 'active': true }
+ *   { 'user': 'pebbles', 'active': false }
  * ];
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.matches` callback shorthand
- * _.pluck(_.takeRightWhile(users, 'active'), 'user');
+ * _.pluck(_.takeRightWhile(users, { 'user': 'pebbles', 'active': false }), 'user');
+ * // => ['pebbles']
+ *
+ * // using the `_.matchesProperty` callback shorthand
+ * _.pluck(_.takeRightWhile(users, 'active', false), 'user');
  * // => ['fred', 'pebbles']
  *
- * // using the "_.matches" callback shorthand
+ * // using the `_.property` callback shorthand
- * _.pluck(_.takeRightWhile(users, { 'status': 'away' }), 'user');
+ * _.pluck(_.takeRightWhile(users, 'active'), 'user');
- * // => ['pebbles']
+ * // => []
  */
 function takeRightWhile(array, predicate, thisArg) {
   var length = array ? array.length : 0;

array/takeWhile.js

@@ -6,40 +6,49 @@ var baseCallback = require('../internal/baseCallback'),
  * are taken until `predicate` returns falsey. The predicate is bound to
  * `thisArg` and invoked with three arguments; (value, index, array).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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 _
- * @type Function
  * @category Array
  * @param {Array} array The array to query.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per element.
+ *  per iteration.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {Array} Returns the slice of `array`.
  * @example
  *
- * _.takeWhile([1, 2, 3], function(n) { return n < 3; });
+ * _.takeWhile([1, 2, 3], function(n) {
+ *   return n < 3;
+ * });
  * // => [1, 2]
  *
  * var users = [
- *   { 'user': 'barney',  'status': 'busy', 'active': true },
+ *   { 'user': 'barney',  'active': false },
- *   { 'user': 'fred',    'status': 'busy', 'active': false },
+ *   { 'user': 'fred',    'active': false},
- *   { 'user': 'pebbles', 'status': 'away', 'active': true }
+ *   { 'user': 'pebbles', 'active': true }
  * ];
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.matches` callback shorthand
- * _.pluck(_.takeWhile(users, 'active'), 'user');
+ * _.pluck(_.takeWhile(users, { 'user': 'barney', 'active': false }), 'user');
  * // => ['barney']
  *
- * // using the "_.matches" callback shorthand
+ * // using the `_.matchesProperty` callback shorthand
- * _.pluck(_.takeWhile(users, { 'status': 'busy' }), 'user');
+ * _.pluck(_.takeWhile(users, 'active', false), 'user');
  * // => ['barney', 'fred']
+ *
+ * // using the `_.property` callback shorthand
+ * _.pluck(_.takeWhile(users, 'active'), 'user');
+ * // => []
  */
 function takeWhile(array, predicate, thisArg) {
   var length = array ? array.length : 0;

array/union.js

@@ -17,8 +17,8 @@ var baseFlatten = require('../internal/baseFlatten'),
  * @returns {Array} Returns the new array of combined values.
  * @example
  *
- * _.union([1, 2, 3], [5, 2, 1, 4], [2, 1]);
+ * _.union([1, 2], [4, 2], [2, 1]);
- * // => [1, 2, 3, 5, 4]
+ * // => [1, 2, 4]
  */
 function union() {
   return baseUniq(baseFlatten(arguments, false, true));

array/uniq.js

@@ -11,10 +11,14 @@ var baseCallback = require('../internal/baseCallback'),
  * uniqueness is computed. The `iteratee` is bound to `thisArg` and invoked
  * with three arguments; (value, index, array).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -30,8 +34,6 @@ var baseCallback = require('../internal/baseCallback'),
  * @param {Array} array The array to inspect.
  * @param {boolean} [isSorted] Specify the array is sorted.
  * @param {Function|Object|string} [iteratee] The function invoked per iteration.
- *  If a property name or object is provided it is used to create a "_.property"
- *  or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `iteratee`.
  * @returns {Array} Returns the new duplicate-value-free array.
  * @example
@@ -44,10 +46,12 @@ var baseCallback = require('../internal/baseCallback'),
  * // => [1, 2]
  *
  * // using an iteratee function
- * _.uniq([1, 2.5, 1.5, 2], function(n) { return this.floor(n); }, Math);
+ * _.uniq([1, 2.5, 1.5, 2], function(n) {
+ *   return this.floor(n);
+ * }, Math);
  * // => [1, 2.5]
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.property` callback shorthand
  * _.uniq([{ 'x': 1 }, { 'x': 2 }, { 'x': 1 }], 'x');
  * // => [{ 'x': 1 }, { 'x': 2 }]
  */
@@ -56,8 +60,7 @@ function uniq(array, isSorted, iteratee, thisArg) {
   if (!length) {
     return [];
   }
-  // Juggle arguments.
+  if (isSorted != null && typeof isSorted != 'boolean') {
-  if (typeof isSorted != 'boolean' && isSorted != null) {
     thisArg = iteratee;
     iteratee = isIterateeCall(array, isSorted, thisArg) ? null : isSorted;
     isSorted = false;

array/without.js

@@ -18,8 +18,8 @@ var baseDifference = require('../internal/baseDifference'),
  * @returns {Array} Returns the new array of filtered values.
  * @example
  *
- * _.without([1, 2, 1, 0, 3, 1, 4], 0, 1);
+ * _.without([1, 2, 1, 3], 1, 2);
- * // => [2, 3, 4]
+ * // => [3]
  */
 function without(array) {
   return baseDifference(array, baseSlice(arguments, 1));

array/xor.js

@@ -15,11 +15,8 @@ var baseDifference = require('../internal/baseDifference'),
  * @returns {Array} Returns the new array of values.
  * @example
  *
- * _.xor([1, 2, 3], [5, 2, 1, 4]);
+ * _.xor([1, 2], [4, 2]);
- * // => [3, 5, 4]
+ * // => [1, 4]
- *
- * _.xor([1, 2, 5], [2, 3, 5], [3, 4, 5]);
- * // => [1, 4, 5]
  */
 function xor() {
   var index = -1,

chain.js

@@ -1,7 +1,10 @@
 module.exports = {
   'chain': require('./chain/chain'),
+  'commit': require('./chain/commit'),
   'lodash': require('./chain/lodash'),
+  'plant': require('./chain/plant'),
   'reverse': require('./chain/reverse'),
+  'run': require('./chain/run'),
   'tap': require('./chain/tap'),
   'thru': require('./chain/thru'),
   'toJSON': require('./chain/toJSON'),

chain/chain.js

@@ -8,7 +8,7 @@ var lodash = require('./lodash');
  * @memberOf _
  * @category Chain
  * @param {*} value The value to wrap.
- * @returns {Object} Returns the new `lodash` object.
+ * @returns {Object} Returns the new `lodash` wrapper instance.
  * @example
  *
  * var users = [
@@ -19,7 +19,9 @@ var lodash = require('./lodash');
  *
  * var youngest = _.chain(users)
  *   .sortBy('age')
- *   .map(function(chr) { return chr.user + ' is ' + chr.age; })
+ *   .map(function(chr) {
+ *     return chr.user + ' is ' + chr.age;
+ *   })
  *   .first()
  *   .value();
  * // => 'pebbles is 1'

chain/commit.js

@@ -0,0 +1 @@
+module.exports = require('./wrapperCommit');

chain/lodash.js

@@ -1,7 +1,9 @@
-var LodashWrapper = require('../internal/LodashWrapper'),
+var LazyWrapper = require('../internal/LazyWrapper'),
-    arrayCopy = require('../internal/arrayCopy'),
+    LodashWrapper = require('../internal/LodashWrapper'),
+    baseLodash = require('../internal/baseLodash'),
     isArray = require('../lang/isArray'),
-    isObjectLike = require('../internal/isObjectLike');
+    isObjectLike = require('../internal/isObjectLike'),
+    wrapperClone = require('../internal/wrapperClone');
 
 /** Used for native method references. */
 var objectProto = Object.prototype;
@@ -10,7 +12,7 @@ var objectProto = Object.prototype;
 var hasOwnProperty = objectProto.hasOwnProperty;
 
 /**
- * Creates a `lodash` object which wraps `value` to enable intuitive chaining.
+ * Creates a `lodash` object which wraps `value` to enable implicit chaining.
  * Methods that operate on and return arrays, collections, and functions can
  * be chained together. Methods that return a boolean or single value will
  * automatically end the chain returning the unwrapped value. Explicit chaining
@@ -29,61 +31,67 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * `concat`, `join`, `pop`, `push`, `reverse`, `shift`, `slice`, `sort`, `splice`,
  * and `unshift`
  *
- * The wrapper functions that support shortcut fusion are:
+ * The wrapper methods that support shortcut fusion are:
- * `drop`, `dropRight`, `dropRightWhile`, `dropWhile`, `filter`, `first`,
+ * `compact`, `drop`, `dropRight`, `dropRightWhile`, `dropWhile`, `filter`,
- * `initial`, `last`, `map`, `pluck`, `reject`, `rest`, `reverse`, `slice`,
+ * `first`, `initial`, `last`, `map`, `pluck`, `reject`, `rest`, `reverse`,
- * `take`, `takeRight`, `takeRightWhile`, `takeWhile`, and `where`
+ * `slice`, `take`, `takeRight`, `takeRightWhile`, `takeWhile`, `toArray`,
+ * and `where`
  *
- * The chainable wrapper functions are:
+ * The chainable wrapper methods are:
  * `after`, `ary`, `assign`, `at`, `before`, `bind`, `bindAll`, `bindKey`,
- * `callback`, `chain`, `chunk`, `compact`, `concat`, `constant`, `countBy`,
+ * `callback`, `chain`, `chunk`, `commit`, `compact`, `concat`, `constant`,
- * `create`, `curry`, `debounce`, `defaults`, `defer`, `delay`, `difference`,
+ * `countBy`, `create`, `curry`, `debounce`, `defaults`, `defer`, `delay`,
- * `drop`, `dropRight`, `dropRightWhile`, `dropWhile`, `filter`, `flatten`,
+ * `difference`, `drop`, `dropRight`, `dropRightWhile`, `dropWhile`, `fill`,
- * `flattenDeep`, `flow`, `flowRight`, `forEach`, `forEachRight`, `forIn`,
+ * `filter`, `flatten`, `flattenDeep`, `flow`, `flowRight`, `forEach`,
- * `forInRight`, `forOwn`, `forOwnRight`, `functions`, `groupBy`, `indexBy`,
+ * `forEachRight`, `forIn`, `forInRight`, `forOwn`, `forOwnRight`, `functions`,
- * `initial`, `intersection`, `invert`, `invoke`, `keys`, `keysIn`, `map`,
+ * `groupBy`, `indexBy`, `initial`, `intersection`, `invert`, `invoke`, `keys`,
- * `mapValues`, `matches`, `memoize`, `merge`, `mixin`, `negate`, `noop`,
+ * `keysIn`, `map`, `mapValues`, `matches`, `matchesProperty`, `memoize`, `merge`,
- * `omit`, `once`, `pairs`, `partial`, `partialRight`, `partition`, `pick`,
+ * `mixin`, `negate`, `noop`, `omit`, `once`, `pairs`, `partial`, `partialRight`,
- * `pluck`, `property`, `propertyOf`, `pull`, `pullAt`, `push`, `range`,
+ * `partition`, `pick`, `plant`, `pluck`, `property`, `propertyOf`, `pull`,
- * `rearg`, `reject`, `remove`, `rest`, `reverse`, `shuffle`, `slice`, `sort`,
+ * `pullAt`, `push`, `range`, `rearg`, `reject`, `remove`, `rest`, `reverse`,
- * `sortBy`, `sortByAll`, `splice`, `take`, `takeRight`, `takeRightWhile`,
+ * `shuffle`, `slice`, `sort`, `sortBy`, `sortByAll`, `splice`, `spread`,
- * `takeWhile`, `tap`, `throttle`, `thru`, `times`, `toArray`, `toPlainObject`,
+ * `take`, `takeRight`, `takeRightWhile`, `takeWhile`, `tap`, `throttle`,
- * `transform`, `union`, `uniq`, `unshift`, `unzip`, `values`, `valuesIn`,
+ * `thru`, `times`, `toArray`, `toPlainObject`, `transform`, `union`, `uniq`,
- * `where`, `without`, `wrap`, `xor`, `zip`, and `zipObject`
+ * `unshift`, `unzip`, `values`, `valuesIn`, `where`, `without`, `wrap`, `xor`,
+ * `zip`, and `zipObject`
  *
- * The wrapper functions that are **not** chainable by default are:
+ * The wrapper methods that are **not** chainable by default are:
  * `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`,
+ * `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`,
- * `startsWith`, `template`, `trim`, `trimLeft`, `trimRight`, `trunc`,
+ * `startCase`, `startsWith`, `template`, `trim`, `trimLeft`, `trimRight`,
- * `unescape`, `uniqueId`, `value`, and `words`
+ * `trunc`, `unescape`, `uniqueId`, `value`, and `words`
  *
- * The wrapper function `sample` will return a wrapped value when `n` is provided,
+ * The wrapper method `sample` will return a wrapped value when `n` is provided,
  * otherwise an unwrapped value is returned.
  *
  * @name _
  * @constructor
  * @category Chain
  * @param {*} value The value to wrap in a `lodash` instance.
- * @returns {Object} Returns a `lodash` instance.
+ * @returns {Object} Returns the new `lodash` wrapper instance.
  * @example
  *
  * var wrapped = _([1, 2, 3]);
  *
  * // returns an unwrapped value
- * wrapped.reduce(function(sum, n) { return sum + n; });
+ * wrapped.reduce(function(sum, n) {
+ *   return sum + n;
+ * });
  * // => 6
  *
  * // returns a wrapped value
- * var squares = wrapped.map(function(n) { return n * n; });
+ * var squares = wrapped.map(function(n) {
+ *   return n * n;
+ * });
  *
  * _.isArray(squares);
  * // => false
@@ -92,18 +100,18 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * // => true
  */
 function lodash(value) {
-  if (isObjectLike(value) && !isArray(value)) {
+  if (isObjectLike(value) && !isArray(value) && !(value instanceof LazyWrapper)) {
     if (value instanceof LodashWrapper) {
       return value;
     }
-    if (hasOwnProperty.call(value, '__wrapped__')) {
+    if (hasOwnProperty.call(value, '__chain__') && hasOwnProperty.call(value, '__wrapped__')) {
-      return new LodashWrapper(value.__wrapped__, value.__chain__, arrayCopy(value.__actions__));
+      return wrapperClone(value);
     }
   }
   return new LodashWrapper(value);
 }
 
-// Ensure `new LodashWrapper` is an instance of `lodash`.
+// Ensure wrappers are instances of `baseLodash`.
-LodashWrapper.prototype = lodash.prototype;
+lodash.prototype = baseLodash.prototype;
 
 module.exports = lodash;

chain/plant.js

@@ -0,0 +1 @@
+module.exports = require('./wrapperPlant');

chain/run.js

@@ -0,0 +1 @@
+module.exports = require('./wrapperValue');

chain/tap.js

@@ -14,7 +14,9 @@
  * @example
  *
  * _([1, 2, 3])
- *  .tap(function(array) { array.pop(); })
+ *  .tap(function(array) {
+ *    array.pop();
+ *  })
  *  .reverse()
  *  .value();
  * // => [2, 1]

chain/thru.js

@@ -12,7 +12,9 @@
  *
  * _([1, 2, 3])
  *  .last()
- *  .thru(function(value) { return [value]; })
+ *  .thru(function(value) {
+ *    return [value];
+ *  })
  *  .value();
  * // => [3]
  */

chain/wrapperChain.js

@@ -6,7 +6,7 @@ var chain = require('./chain');
  * @name chain
  * @memberOf _
  * @category Chain
- * @returns {*} Returns the `lodash` object.
+ * @returns {Object} Returns the new `lodash` wrapper instance.
  * @example
  *
  * var users = [

chain/wrapperCommit.js

@@ -0,0 +1,32 @@
+var LodashWrapper = require('../internal/LodashWrapper');
+
+/**
+ * Executes the chained sequence and returns the wrapped result.
+ *
+ * @name commit
+ * @memberOf _
+ * @category Chain
+ * @returns {Object} Returns the new `lodash` wrapper instance.
+ * @example
+ *
+ * var array = [1, 2];
+ * var wrapper = _(array).push(3);
+ *
+ * console.log(array);
+ * // => [1, 2]
+ *
+ * wrapper = wrapper.commit();
+ * console.log(array);
+ * // => [1, 2, 3]
+ *
+ * wrapper.last();
+ * // => 3
+ *
+ * console.log(array);
+ * // => [1, 2, 3]
+ */
+function wrapperCommit() {
+  return new LodashWrapper(this.value(), this.__chain__);
+}
+
+module.exports = wrapperCommit;

chain/wrapperPlant.js

@@ -0,0 +1,45 @@
+var baseLodash = require('../internal/baseLodash'),
+    wrapperClone = require('../internal/wrapperClone');
+
+/**
+ * Creates a clone of the chained sequence planting `value` as the wrapped value.
+ *
+ * @name plant
+ * @memberOf _
+ * @category Chain
+ * @returns {Object} Returns the new `lodash` wrapper instance.
+ * @example
+ *
+ * var array = [1, 2];
+ * var wrapper = _(array).map(function(value) {
+ *   return Math.pow(value, 2);
+ * });
+ *
+ * var other = [3, 4];
+ * var otherWrapper = wrapper.plant(other);
+ *
+ * otherWrapper.value();
+ * // => [9, 16]
+ *
+ * wrapper.value();
+ * // => [1, 4]
+ */
+function wrapperPlant(value) {
+  var result,
+      parent = this;
+
+  while (parent instanceof baseLodash) {
+    var clone = wrapperClone(parent);
+    if (result) {
+      previous.__wrapped__ = clone;
+    } else {
+      result = clone;
+    }
+    var previous = clone;
+    parent = parent.__wrapped__;
+  }
+  previous.__wrapped__ = value;
+  return result;
+}
+
+module.exports = wrapperPlant;

chain/wrapperReverse.js

@@ -11,7 +11,7 @@ var LazyWrapper = require('../internal/LazyWrapper'),
  * @name reverse
  * @memberOf _
  * @category Chain
- * @returns {Object} Returns the new reversed `lodash` object.
+ * @returns {Object} Returns the new reversed `lodash` wrapper instance.
  * @example
  *
  * var array = [1, 2, 3];
@@ -28,7 +28,7 @@ function wrapperReverse() {
     if (this.__actions__.length) {
       value = new LazyWrapper(this);
     }
-    return new LodashWrapper(value.reverse());
+    return new LodashWrapper(value.reverse(), this.__chain__);
   }
   return this.thru(function(value) {
     return value.reverse();

chain/wrapperValue.js

@@ -5,7 +5,7 @@ var baseWrapperValue = require('../internal/baseWrapperValue');
  *
  * @name value
  * @memberOf _
- * @alias toJSON, valueOf
+ * @alias run, toJSON, valueOf
  * @category Chain
  * @returns {*} Returns the resolved unwrapped value.
  * @example

collection/at.js

@@ -17,8 +17,8 @@ var baseAt = require('../internal/baseAt'),
  * @returns {Array} Returns the new array of picked elements.
  * @example
  *
- * _.at(['a', 'b', 'c', 'd', 'e'], [0, 2, 4]);
+ * _.at(['a', 'b', 'c'], [0, 2]);
- * // => ['a', 'c', 'e']
+ * // => ['a', 'c']
  *
  * _.at(['fred', 'barney', 'pebbles'], 0, 2);
  * // => ['fred', 'pebbles']

collection/countBy.js

@@ -13,10 +13,14 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * The `iteratee` is bound to `thisArg` and invoked with three arguments;
  * (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -25,16 +29,19 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * @category Collection
  * @param {Array|Object|string} collection The collection to iterate over.
  * @param {Function|Object|string} [iteratee=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `iteratee`.
  * @returns {Object} Returns the composed aggregate object.
  * @example
  *
- * _.countBy([4.3, 6.1, 6.4], function(n) { return Math.floor(n); });
+ * _.countBy([4.3, 6.1, 6.4], function(n) {
+ *   return Math.floor(n);
+ * });
  * // => { '4': 1, '6': 2 }
  *
- * _.countBy([4.3, 6.1, 6.4], function(n) { return this.floor(n); }, Math);
+ * _.countBy([4.3, 6.1, 6.4], function(n) {
+ *   return this.floor(n);
+ * }, Math);
  * // => { '4': 1, '6': 2 }
  *
  * _.countBy(['one', 'two', 'three'], 'length');

collection/every.js

@@ -8,10 +8,14 @@ var arrayEvery = require('../internal/arrayEvery'),
  * The predicate is bound to `thisArg` and invoked with three arguments;
  * (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -21,27 +25,30 @@ var arrayEvery = require('../internal/arrayEvery'),
  * @category Collection
  * @param {Array|Object|string} collection The collection to iterate over.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {boolean} Returns `true` if all elements pass the predicate check,
  *  else `false`.
  * @example
  *
- * _.every([true, 1, null, 'yes']);
+ * _.every([true, 1, null, 'yes'], Boolean);
  * // => false
  *
  * var users = [
- *   { 'user': 'barney', 'age': 36 },
+ *   { 'user': 'barney', 'active': false },
- *   { 'user': 'fred',   'age': 40 }
+ *   { 'user': 'fred',   'active': false }
  * ];
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.matches` callback shorthand
- * _.every(users, 'age');
+ * _.every(users, { 'user': 'barney', 'active': false });
+ * // => false
+ *
+ * // using the `_.matchesProperty` callback shorthand
+ * _.every(users, 'active', false);
  * // => true
  *
- * // using the "_.matches" callback shorthand
+ * // using the `_.property` callback shorthand
- * _.every(users, { 'age': 36 });
+ * _.every(users, 'active');
  * // => false
  */
 function every(collection, predicate, thisArg) {

collection/filter.js

@@ -8,10 +8,14 @@ var arrayFilter = require('../internal/arrayFilter'),
  * `predicate` returns truthy for. The predicate is bound to `thisArg` and
  * invoked with three arguments; (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -21,26 +25,31 @@ var arrayFilter = require('../internal/arrayFilter'),
  * @category Collection
  * @param {Array|Object|string} collection The collection to iterate over.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {Array} Returns the new filtered array.
  * @example
  *
- * var evens = _.filter([1, 2, 3, 4], function(n) { return n % 2 == 0; });
+ * _.filter([4, 5, 6], function(n) {
- * // => [2, 4]
+ *   return n % 2 == 0;
+ * });
+ * // => [4, 6]
  *
  * var users = [
- *   { 'user': 'barney', 'age': 36, 'active': false },
+ *   { 'user': 'barney', 'age': 36, 'active': true },
- *   { 'user': 'fred',   'age': 40, 'active': true }
+ *   { 'user': 'fred',   'age': 40, 'active': false }
  * ];
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.matches` callback shorthand
- * _.pluck(_.filter(users, 'active'), 'user');
+ * _.pluck(_.filter(users, { 'age': 36, 'active': true }), 'user');
+ * // => ['barney']
+ *
+ * // using the `_.matchesProperty` callback shorthand
+ * _.pluck(_.filter(users, 'active', false), 'user');
  * // => ['fred']
  *
- * // using the "_.matches" callback shorthand
+ * // using the `_.property` callback shorthand
- * _.pluck(_.filter(users, { 'age': 36 }), 'user');
+ * _.pluck(_.filter(users, 'active'), 'user');
  * // => ['barney']
  */
 function filter(collection, predicate, thisArg) {

collection/find.js

@@ -9,10 +9,14 @@ var baseCallback = require('../internal/baseCallback'),
  * `predicate` returns truthy for. The predicate is bound to `thisArg` and
  * invoked with three arguments; (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -22,28 +26,33 @@ var baseCallback = require('../internal/baseCallback'),
  * @category Collection
  * @param {Array|Object|string} collection The collection to search.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {*} Returns the matched element, else `undefined`.
  * @example
  *
  * var users = [
- *   { 'user': 'barney',  'age': 36, 'active': false },
+ *   { 'user': 'barney',  'age': 36, 'active': true },
- *   { 'user': 'fred',    'age': 40, 'active': true },
+ *   { 'user': 'fred',    'age': 40, 'active': false },
- *   { 'user': 'pebbles', 'age': 1,  'active': false }
+ *   { 'user': 'pebbles', 'age': 1,  'active': true }
  * ];
  *
- * _.result(_.find(users, function(chr) { return chr.age < 40; }), 'user');
+ * _.result(_.find(users, function(chr) {
+ *   return chr.age < 40;
+ * }), 'user');
  * // => 'barney'
  *
- * // using the "_.matches" callback shorthand
+ * // using the `_.matches` callback shorthand
- * _.result(_.find(users, { 'age': 1 }), 'user');
+ * _.result(_.find(users, { 'age': 1, 'active': true }), 'user');
  * // => 'pebbles'
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.matchesProperty` callback shorthand
- * _.result(_.find(users, 'active'), 'user');
+ * _.result(_.find(users, 'active', false), 'user');
  * // => 'fred'
+ *
+ * // using the `_.property` callback shorthand
+ * _.result(_.find(users, 'active'), 'user');
+ * // => 'barney'
  */
 function find(collection, predicate, thisArg) {
   if (isArray(collection)) {

collection/findLast.js

@@ -11,13 +11,14 @@ var baseCallback = require('../internal/baseCallback'),
  * @category Collection
  * @param {Array|Object|string} collection The collection to search.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {*} Returns the matched element, else `undefined`.
  * @example
  *
- * _.findLast([1, 2, 3, 4], function(n) { return n % 2 == 1; });
+ * _.findLast([1, 2, 3, 4], function(n) {
+ *   return n % 2 == 1;
+ * });
  * // => 3
  */
 function findLast(collection, predicate, thisArg) {

collection/findWhere.js

@@ -1,11 +1,16 @@
-var find = require('./find'),
+var baseMatches = require('../internal/baseMatches'),
-    matches = require('../utility/matches');
+    find = require('./find');
 
 /**
  * Performs a deep comparison between each element in `collection` and the
  * source object, returning the first element that has equivalent property
  * values.
  *
+ * **Note:** This method supports comparing arrays, booleans, `Date` objects,
+ * numbers, `Object` objects, regexes, and strings. Objects are compared by
+ * their own, not inherited, enumerable properties. For comparing a single
+ * own or inherited property value see `_.matchesProperty`.
+ *
  * @static
  * @memberOf _
  * @category Collection
@@ -15,18 +20,18 @@ var find = require('./find'),
  * @example
  *
  * var users = [
- *   { 'user': 'barney', 'age': 36, 'status': 'busy' },
+ *   { 'user': 'barney', 'age': 36, 'active': true },
- *   { 'user': 'fred',   'age': 40, 'status': 'busy' }
+ *   { 'user': 'fred',   'age': 40, 'active': false }
  * ];
  *
- * _.result(_.findWhere(users, { 'status': 'busy' }), 'user');
+ * _.result(_.findWhere(users, { 'age': 36, 'active': true }), 'user');
  * // => 'barney'
  *
- * _.result(_.findWhere(users, { 'age': 40 }), 'user');
+ * _.result(_.findWhere(users, { 'age': 40, 'active': false }), 'user');
  * // => 'fred'
  */
 function findWhere(collection, source) {
-  return find(collection, matches(source));
+  return find(collection, baseMatches(source));
 }
 
 module.exports = findWhere;

collection/forEach.js

@@ -23,10 +23,14 @@ var arrayEach = require('../internal/arrayEach'),
  * @returns {Array|Object|string} Returns `collection`.
  * @example
  *
- * _([1, 2, 3]).forEach(function(n) { console.log(n); }).value();
+ * _([1, 2]).forEach(function(n) {
+ *   console.log(n);
+ * }).value();
  * // => logs each value from left to right and returns the array
  *
- * _.forEach({ 'one': 1, 'two': 2, 'three': 3 }, function(n, key) { console.log(n, key); });
+ * _.forEach({ 'a': 1, 'b': 2 }, function(n, key) {
+ *   console.log(n, key);
+ * });
  * // => logs each value-key pair and returns the object (iteration order is not guaranteed)
  */
 function forEach(collection, iteratee, thisArg) {

collection/forEachRight.js

@@ -17,7 +17,9 @@ var arrayEachRight = require('../internal/arrayEachRight'),
  * @returns {Array|Object|string} Returns `collection`.
  * @example
  *
- * _([1, 2, 3]).forEachRight(function(n) { console.log(n); }).join(',');
+ * _([1, 2]).forEachRight(function(n) {
+ *   console.log(n);
+ * }).join(',');
  * // => logs each value from right to left and returns the array
  */
 function forEachRight(collection, iteratee, thisArg) {

collection/groupBy.js

@@ -13,10 +13,14 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * The `iteratee` is bound to `thisArg` and invoked with three arguments;
  * (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -25,19 +29,22 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * @category Collection
  * @param {Array|Object|string} collection The collection to iterate over.
  * @param {Function|Object|string} [iteratee=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `iteratee`.
  * @returns {Object} Returns the composed aggregate object.
  * @example
  *
- * _.groupBy([4.2, 6.1, 6.4], function(n) { return Math.floor(n); });
+ * _.groupBy([4.2, 6.1, 6.4], function(n) {
+ *   return Math.floor(n);
+ * });
  * // => { '4': [4.2], '6': [6.1, 6.4] }
  *
- * _.groupBy([4.2, 6.1, 6.4], function(n) { return this.floor(n); }, Math);
+ * _.groupBy([4.2, 6.1, 6.4], function(n) {
+ *   return this.floor(n);
+ * }, Math);
  * // => { '4': [4.2], '6': [6.1, 6.4] }
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.property` callback shorthand
  * _.groupBy(['one', 'two', 'three'], 'length');
  * // => { '3': ['one', 'two'], '5': ['three'] }
  */

collection/indexBy.js

@@ -7,10 +7,14 @@ var createAggregator = require('../internal/createAggregator');
  * iteratee function is bound to `thisArg` and invoked with three arguments;
  * (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -19,8 +23,7 @@ var createAggregator = require('../internal/createAggregator');
  * @category Collection
  * @param {Array|Object|string} collection The collection to iterate over.
  * @param {Function|Object|string} [iteratee=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `iteratee`.
  * @returns {Object} Returns the composed aggregate object.
  * @example
@@ -33,10 +36,14 @@ var createAggregator = require('../internal/createAggregator');
  * _.indexBy(keyData, 'dir');
  * // => { 'left': { 'dir': 'left', 'code': 97 }, 'right': { 'dir': 'right', 'code': 100 } }
  *
- * _.indexBy(keyData, function(object) { return String.fromCharCode(object.code); });
+ * _.indexBy(keyData, function(object) {
+ *   return String.fromCharCode(object.code);
+ * });
  * // => { 'a': { 'dir': 'left', 'code': 97 }, 'd': { 'dir': 'right', 'code': 100 } }
  *
- * _.indexBy(keyData, function(object) { return this.fromCharCode(object.code); }, String);
+ * _.indexBy(keyData, function(object) {
+ *   return this.fromCharCode(object.code);
+ * }, String);
  * // => { 'a': { 'dir': 'left', 'code': 97 }, 'd': { 'dir': 'right', 'code': 100 } }
  */
 var indexBy = createAggregator(function(result, value, key) {

collection/map.js

@@ -8,37 +8,54 @@ var arrayMap = require('../internal/arrayMap'),
  * `iteratee`. The `iteratee` is bound to `thisArg` and invoked with three
  * arguments; (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
+ * Many lodash methods are guarded to work as interatees for methods like
+ * `_.every`, `_.filter`, `_.map`, `_.mapValues`, `_.reject`, and `_.some`.
+ *
+ * The guarded methods are:
+ * `ary`, `callback`, `chunk`, `clone`, `create`, `curry`, `curryRight`, `drop`,
+ * `dropRight`, `fill`, `flatten`, `invert`, `max`, `min`, `parseInt`, `slice`,
+ * `sortBy`, `take`, `takeRight`, `template`, `trim`, `trimLeft`, `trimRight`,
+ * `trunc`, `random`, `range`, `sample`, `uniq`, and `words`
+ *
  * @static
  * @memberOf _
  * @alias collect
  * @category Collection
  * @param {Array|Object|string} collection The collection to iterate over.
  * @param {Function|Object|string} [iteratee=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
+ *  create a `_.property` or `_.matches` style callback respectively.
  * @param {*} [thisArg] The `this` binding of `iteratee`.
  * @returns {Array} Returns the new mapped array.
  * @example
  *
- * _.map([1, 2, 3], function(n) { return n * 3; });
+ * function timesThree(n) {
- * // => [3, 6, 9]
+ *   return n * 3;
+ * }
  *
- * _.map({ 'one': 1, 'two': 2, 'three': 3 }, function(n) { return n * 3; });
+ * _.map([1, 2], timesThree);
- * // => [3, 6, 9] (iteration order is not guaranteed)
+ * // => [3, 6]
+ *
+ * _.map({ 'a': 1, 'b': 2 }, timesThree);
+ * // => [3, 6] (iteration order is not guaranteed)
  *
  * var users = [
  *   { 'user': 'barney' },
  *   { 'user': 'fred' }
  * ];
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.property` callback shorthand
  * _.map(users, 'user');
  * // => ['barney', 'fred']
  */

collection/max.js

@@ -8,10 +8,14 @@ var arrayMax = require('../internal/arrayMax'),
  * 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"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -20,8 +24,6 @@ var arrayMax = require('../internal/arrayMax'),
  * @category Collection
  * @param {Array|Object|string} collection The collection to iterate over.
  * @param {Function|Object|string} [iteratee] The function invoked per iteration.
- *  If a property name or object is provided it is used to create a "_.property"
- *  or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `iteratee`.
  * @returns {*} Returns the maximum value.
  * @example
@@ -37,10 +39,12 @@ var arrayMax = require('../internal/arrayMax'),
  *   { 'user': 'fred',   'age': 40 }
  * ];
  *
- * _.max(users, function(chr) { return chr.age; });
+ * _.max(users, function(chr) {
+ *   return chr.age;
+ * });
  * // => { 'user': 'fred', 'age': 40 };
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.property` callback shorthand
  * _.max(users, 'age');
  * // => { 'user': 'fred', 'age': 40 };
  */

collection/min.js

@@ -8,10 +8,14 @@ var arrayMin = require('../internal/arrayMin'),
  * 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"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -20,8 +24,6 @@ var arrayMin = require('../internal/arrayMin'),
  * @category Collection
  * @param {Array|Object|string} collection The collection to iterate over.
  * @param {Function|Object|string} [iteratee] The function invoked per iteration.
- *  If a property name or object is provided it is used to create a "_.property"
- *  or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `iteratee`.
  * @returns {*} Returns the minimum value.
  * @example
@@ -37,10 +39,12 @@ var arrayMin = require('../internal/arrayMin'),
  *   { 'user': 'fred',   'age': 40 }
  * ];
  *
- * _.min(users, function(chr) { return chr.age; });
+ * _.min(users, function(chr) {
+ *   return chr.age;
+ * });
  * // => { 'user': 'barney', 'age': 36 };
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.property` callback shorthand
  * _.min(users, 'age');
  * // => { 'user': 'barney', 'age': 36 };
  */

collection/partition.js

@@ -6,10 +6,14 @@ var createAggregator = require('../internal/createAggregator');
  * contains elements `predicate` returns falsey for. The predicate is bound
  * to `thisArg` and invoked with three arguments; (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -18,16 +22,19 @@ var createAggregator = require('../internal/createAggregator');
  * @category Collection
  * @param {Array|Object|string} collection The collection to iterate over.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {Array} Returns the array of grouped elements.
  * @example
  *
- * _.partition([1, 2, 3], function(n) { return n % 2; });
+ * _.partition([1, 2, 3], function(n) {
+ *   return n % 2;
+ * });
  * // => [[1, 3], [2]]
  *
- * _.partition([1.2, 2.3, 3.4], function(n) { return this.floor(n) % 2; }, Math);
+ * _.partition([1.2, 2.3, 3.4], function(n) {
+ *   return this.floor(n) % 2;
+ * }, Math);
  * // => [[1, 3], [2]]
  *
  * var users = [
@@ -36,12 +43,20 @@ var createAggregator = require('../internal/createAggregator');
  *   { 'user': 'pebbles', 'age': 1,  'active': false }
  * ];
  *
- * // using the "_.matches" callback shorthand
+ * var mapper = function(array) {
- * _.map(_.partition(users, { 'age': 1 }), function(array) { return _.pluck(array, 'user'); });
+ *   return _.pluck(array, 'user');
+ * };
+ *
+ * // using the `_.matches` callback shorthand
+ * _.map(_.partition(users, { 'age': 1, 'active': false }), mapper);
  * // => [['pebbles'], ['barney', 'fred']]
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.matchesProperty` callback shorthand
- * _.map(_.partition(users, 'active'), function(array) { return _.pluck(array, 'user'); });
+ * _.map(_.partition(users, 'active', false), mapper);
+ * // => [['barney', 'pebbles'], ['fred']]
+ *
+ * // using the `_.property` callback shorthand
+ * _.map(_.partition(users, 'active'), mapper);
  * // => [['fred'], ['barney', 'pebbles']]
  */
 var partition = createAggregator(function(result, value, key) {

collection/pluck.js

@@ -1,5 +1,5 @@
-var map = require('./map'),
+var baseProperty = require('../internal/baseProperty'),
-    property = require('../utility/property');
+    map = require('./map');
 
 /**
  * Gets the value of `key` from all elements in `collection`.
@@ -25,7 +25,7 @@ var map = require('./map'),
  * // => [36, 40] (iteration order is not guaranteed)
  */
 function pluck(collection, key) {
-  return map(collection, property(key));
+  return map(collection, baseProperty(key));
 }
 
 module.exports = pluck;

collection/reduce.js

@@ -12,6 +12,12 @@ var arrayReduce = require('../internal/arrayReduce'),
  * value. The `iteratee` is bound to `thisArg`and invoked with four arguments;
  * (accumulator, value, index|key, collection).
  *
+ * Many lodash methods are guarded to work as interatees for methods like
+ * `_.reduce`, `_.reduceRight`, and `_.transform`.
+ *
+ * The guarded methods are:
+ * `assign`, `defaults`, `merge`, and `sortAllBy`
+ *
  * @static
  * @memberOf _
  * @alias foldl, inject
@@ -23,14 +29,16 @@ var arrayReduce = require('../internal/arrayReduce'),
  * @returns {*} Returns the accumulated value.
  * @example
  *
- * var sum = _.reduce([1, 2, 3], function(sum, n) { return sum + n; });
+ * _.reduce([1, 2], function(sum, n) {
- * // => 6
+ *   return sum + n;
+ * });
+ * // => 3
  *
- * var mapped = _.reduce({ 'a': 1, 'b': 2, 'c': 3 }, function(result, n, key) {
+ * _.reduce({ 'a': 1, 'b': 2 }, function(result, n, key) {
  *   result[key] = n * 3;
  *   return result;
  * }, {});
- * // => { 'a': 3, 'b': 6, 'c': 9 } (iteration order is not guaranteed)
+ * // => { 'a': 3, 'b': 6 } (iteration order is not guaranteed)
  */
 function reduce(collection, iteratee, accumulator, thisArg) {
   var func = isArray(collection) ? arrayReduce : baseReduce;

collection/reduceRight.js

@@ -20,7 +20,10 @@ var arrayReduceRight = require('../internal/arrayReduceRight'),
  * @example
  *
  * var array = [[0, 1], [2, 3], [4, 5]];
- * _.reduceRight(array, function(flattened, other) { return flattened.concat(other); }, []);
+ *
+ * _.reduceRight(array, function(flattened, other) {
+ *   return flattened.concat(other);
+ * }, []);
  * // => [4, 5, 2, 3, 0, 1]
  */
 function reduceRight(collection, iteratee, accumulator, thisArg) {

collection/reject.js

@@ -7,10 +7,14 @@ var arrayFilter = require('../internal/arrayFilter'),
  * The opposite of `_.filter`; this method returns the elements of `collection`
  * that `predicate` does **not** return truthy for.
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -19,13 +23,14 @@ var arrayFilter = require('../internal/arrayFilter'),
  * @category Collection
  * @param {Array|Object|string} collection The collection to iterate over.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {Array} Returns the new filtered array.
  * @example
  *
- * var odds = _.reject([1, 2, 3, 4], function(n) { return n % 2 == 0; });
+ * _.reject([1, 2, 3, 4], function(n) {
+ *   return n % 2 == 0;
+ * });
  * // => [1, 3]
  *
  * var users = [
@@ -33,13 +38,17 @@ var arrayFilter = require('../internal/arrayFilter'),
  *   { 'user': 'fred',   'age': 40, 'active': true }
  * ];
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.matches` callback shorthand
- * _.pluck(_.reject(users, 'active'), 'user');
+ * _.pluck(_.reject(users, { 'age': 40, 'active': true }), 'user');
  * // => ['barney']
  *
- * // using the "_.matches" callback shorthand
+ * // using the `_.matchesProperty` callback shorthand
- * _.pluck(_.reject(users, { 'age': 36 }), 'user');
+ * _.pluck(_.reject(users, 'active', false), 'user');
  * // => ['fred']
+ *
+ * // using the `_.property` callback shorthand
+ * _.pluck(_.reject(users, 'active'), 'user');
+ * // => ['barney']
  */
 function reject(collection, predicate, thisArg) {
   var func = isArray(collection) ? arrayFilter : baseFilter;

collection/size.js

@@ -12,12 +12,12 @@ var isLength = require('../internal/isLength'),
  * @returns {number} Returns the size of `collection`.
  * @example
  *
- * _.size([1, 2]);
+ * _.size([1, 2, 3]);
- * // => 2
- *
- * _.size({ 'one': 1, 'two': 2, 'three': 3 });
  * // => 3
  *
+ * _.size({ 'a': 1, 'b': 2 });
+ * // => 2
+ *
  * _.size('pebbles');
  * // => 7
  */

collection/some.js

@@ -9,10 +9,14 @@ var arraySome = require('../internal/arraySome'),
  * over the entire collection. The predicate is bound to `thisArg` and invoked
  * with three arguments; (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -22,8 +26,7 @@ var arraySome = require('../internal/arraySome'),
  * @category Collection
  * @param {Array|Object|string} collection The collection to iterate over.
  * @param {Function|Object|string} [predicate=_.identity] The function invoked
- *  per iteration. If a property name or object is provided it is used to
+ *  per iteration.
- *  create a "_.property" or "_.matches" style callback respectively.
  * @param {*} [thisArg] The `this` binding of `predicate`.
  * @returns {boolean} Returns `true` if any element passes the predicate check,
  *  else `false`.
@@ -33,17 +36,21 @@ var arraySome = require('../internal/arraySome'),
  * // => true
  *
  * var users = [
- *   { 'user': 'barney', 'age': 36, 'active': false },
+ *   { 'user': 'barney', 'active': true },
- *   { 'user': 'fred',   'age': 40, 'active': true }
+ *   { 'user': 'fred',   'active': false }
  * ];
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.matches` callback shorthand
- * _.some(users, 'active');
+ * _.some(users, { 'user': 'barney', 'active': false });
+ * // => false
+ *
+ * // using the `_.matchesProperty` callback shorthand
+ * _.some(users, 'active', false);
  * // => true
  *
- * // using the "_.matches" callback shorthand
+ * // using the `_.property` callback shorthand
- * _.some(users, { 'age': 1 });
+ * _.some(users, 'active');
- * // => false
+ * // => true
  */
 function some(collection, predicate, thisArg) {
   var func = isArray(collection) ? arraySome : baseSome;

collection/sortBy.js

@@ -12,10 +12,14 @@ var baseCallback = require('../internal/baseCallback'),
  * The `iteratee` is bound to `thisArg` and invoked with three arguments;
  * (value, index|key, collection).
  *
- * If a property name is provided for `predicate` the created "_.property"
+ * If a property name is provided for `predicate` the created `_.property`
  * style callback returns the property value of the given element.
  *
- * If an object is provided for `predicate` the created "_.matches" style
+ * 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`.
  *
@@ -25,15 +29,19 @@ var baseCallback = require('../internal/baseCallback'),
  * @param {Array|Object|string} collection The collection to iterate over.
  * @param {Array|Function|Object|string} [iteratee=_.identity] The function
  *  invoked per iteration. If a property name or an object is provided it is
- *  used to create a "_.property" or "_.matches" style callback respectively.
+ *  used to create a `_.property` or `_.matches` style callback respectively.
  * @param {*} [thisArg] The `this` binding of `iteratee`.
  * @returns {Array} Returns the new sorted array.
  * @example
  *
- * _.sortBy([1, 2, 3], function(n) { return Math.sin(n); });
+ * _.sortBy([1, 2, 3], function(n) {
+ *   return Math.sin(n);
+ * });
  * // => [3, 1, 2]
  *
- * _.sortBy([1, 2, 3], function(n) { return this.sin(n); }, Math);
+ * _.sortBy([1, 2, 3], function(n) {
+ *   return this.sin(n);
+ * }, Math);
  * // => [3, 1, 2]
  *
  * var users = [
@@ -42,7 +50,7 @@ var baseCallback = require('../internal/baseCallback'),
  *   { 'user': 'barney' }
  * ];
  *
- * // using the "_.property" callback shorthand
+ * // using the `_.property` callback shorthand
  * _.pluck(_.sortBy(users, 'user'), 'user');
  * // => ['barney', 'fred', 'pebbles']
  */

collection/sortByAll.js

@@ -38,7 +38,7 @@ function sortByAll(collection) {
       props = baseFlatten(args, false, false, 1),
       result = isLength(length) ? Array(length) : [];
 
-  baseEach(collection, function(value, key, collection) {
+  baseEach(collection, function(value) {
     var length = props.length,
         criteria = Array(length);
 

collection/where.js

@@ -1,11 +1,16 @@
-var filter = require('./filter'),
+var baseMatches = require('../internal/baseMatches'),
-    matches = require('../utility/matches');
+    filter = require('./filter');
 
 /**
  * Performs a deep comparison between each element in `collection` and the
  * source object, returning an array of all elements that have equivalent
  * property values.
  *
+ * **Note:** This method supports comparing arrays, booleans, `Date` objects,
+ * numbers, `Object` objects, regexes, and strings. Objects are compared by
+ * their own, not inherited, enumerable properties. For comparing a single
+ * own or inherited property value see `_.matchesProperty`.
+ *
  * @static
  * @memberOf _
  * @category Collection
@@ -15,21 +20,18 @@ var filter = require('./filter'),
  * @example
  *
  * var users = [
- *   { 'user': 'barney', 'age': 36, 'status': 'busy', 'pets': ['hoppy'] },
+ *   { 'user': 'barney', 'age': 36, 'active': false, 'pets': ['hoppy'] },
- *   { 'user': 'fred',   'age': 40, 'status': 'busy', 'pets': ['baby puss', 'dino'] }
+ *   { 'user': 'fred',   'age': 40, 'active': true, 'pets': ['baby puss', 'dino'] }
  * ];
  *
- * _.pluck(_.where(users, { 'age': 36 }), 'user');
+ * _.pluck(_.where(users, { 'age': 36, 'active': false }), 'user');
  * // => ['barney']
  *
  * _.pluck(_.where(users, { 'pets': ['dino'] }), 'user');
  * // => ['fred']
- *
- * _.pluck(_.where(users, { 'status': 'busy' }), 'user');
- * // => ['barney', 'fred']
  */
 function where(collection, source) {
-  return filter(collection, matches(source));
+  return filter(collection, baseMatches(source));
 }
 
 module.exports = where;

date/now.js

@@ -12,7 +12,9 @@ var nativeNow = isNative(nativeNow = Date.now) && nativeNow;
  * @category Date
  * @example
  *
- * _.defer(function(stamp) { console.log(_.now() - stamp); }, _.now());
+ * _.defer(function(stamp) {
+ *   console.log(_.now() - stamp);
+ * }, _.now());
  * // => logs the number of milliseconds it took for the deferred function to be invoked
  */
 var now = nativeNow || function() {

function.js

@@ -20,6 +20,7 @@ module.exports = {
   'partial': require('./function/partial'),
   'partialRight': require('./function/partialRight'),
   'rearg': require('./function/rearg'),
+  'spread': require('./function/spread'),
   'throttle': require('./function/throttle'),
   'wrap': require('./function/wrap')
 };

function/after.js

@@ -1,5 +1,3 @@
-var isFunction = require('../lang/isFunction');
-
 /** Used as the `TypeError` message for "Functions" methods. */
 var FUNC_ERROR_TEXT = 'Expected a function';
 
@@ -30,8 +28,8 @@ var nativeIsFinite = global.isFinite;
  * // => logs 'done saving!' after the two async saves have completed
  */
 function after(n, func) {
-  if (!isFunction(func)) {
+  if (typeof func != 'function') {
-    if (isFunction(n)) {
+    if (typeof n == 'function') {
       var temp = n;
       n = func;
       func = temp;

function/before.js

@@ -1,5 +1,3 @@
-var isFunction = require('../lang/isFunction');
-
 /** Used as the `TypeError` message for "Functions" methods. */
 var FUNC_ERROR_TEXT = 'Expected a function';
 
@@ -21,8 +19,8 @@ var FUNC_ERROR_TEXT = 'Expected a function';
  */
 function before(n, func) {
   var result;
-  if (!isFunction(func)) {
+  if (typeof func != 'function') {
-    if (isFunction(n)) {
+    if (typeof n == 'function') {
       var temp = n;
       n = func;
       func = temp;

function/bindAll.js

@@ -21,7 +21,9 @@ var baseBindAll = require('../internal/baseBindAll'),
  *
  * var view = {
  *   'label': 'docs',
- *   'onClick': function() { console.log('clicked ' + this.label); }
+ *   'onClick': function() {
+ *     console.log('clicked ' + this.label);
+ *   }
  * };
  *
  * _.bindAll(view);

function/debounce.js

@@ -1,5 +1,4 @@
-var isFunction = require('../lang/isFunction'),
+var isObject = require('../lang/isObject'),
-    isObject = require('../lang/isObject'),
     now = require('../date/now');
 
 /** Used as the `TypeError` message for "Functions" methods. */
@@ -27,7 +26,7 @@ var nativeMax = Math.max;
  * @memberOf _
  * @category Function
  * @param {Function} func The function to debounce.
- * @param {number} wait The number of milliseconds to delay.
+ * @param {number} [wait=0] The number of milliseconds to delay.
  * @param {Object} [options] The options object.
  * @param {boolean} [options.leading=false] Specify invoking on the leading
  *  edge of the timeout.
@@ -82,10 +81,10 @@ function debounce(func, wait, options) {
       maxWait = false,
       trailing = true;
 
-  if (!isFunction(func)) {
+  if (typeof func != 'function') {
     throw new TypeError(FUNC_ERROR_TEXT);
   }
-  wait = wait < 0 ? 0 : wait;
+  wait = wait < 0 ? 0 : (+wait || 0);
   if (options === true) {
     var leading = true;
     trailing = false;

function/defer.js

@@ -12,7 +12,9 @@ var baseDelay = require('../internal/baseDelay');
  * @returns {number} Returns the timer id.
  * @example
  *
- * _.defer(function(text) { console.log(text); }, 'deferred');
+ * _.defer(function(text) {
+ *   console.log(text);
+ * }, 'deferred');
  * // logs 'deferred' after one or more milliseconds
  */
 function defer(func) {

function/delay.js

@@ -13,7 +13,9 @@ var baseDelay = require('../internal/baseDelay');
  * @returns {number} Returns the timer id.
  * @example
  *
- * _.delay(function(text) { console.log(text); }, 1000, 'later');
+ * _.delay(function(text) {
+ *   console.log(text);
+ * }, 1000, 'later');
  * // => logs 'later' after one second
  */
 function delay(func, wait) {

function/flow.js

@@ -1,5 +1,5 @@
 var arrayEvery = require('../internal/arrayEvery'),
-    isFunction = require('../lang/isFunction');
+    baseIsFunction = require('../internal/baseIsFunction');
 
 /** Used as the `TypeError` message for "Functions" methods. */
 var FUNC_ERROR_TEXT = 'Expected a function';
@@ -33,9 +33,9 @@ function flow() {
       length = funcs.length;
 
   if (!length) {
-    return function() {};
+    return function() { return arguments[0]; };
   }
-  if (!arrayEvery(funcs, isFunction)) {
+  if (!arrayEvery(funcs, baseIsFunction)) {
     throw new TypeError(FUNC_ERROR_TEXT);
   }
   return function() {

function/flowRight.js

@@ -1,5 +1,5 @@
 var arrayEvery = require('../internal/arrayEvery'),
-    isFunction = require('../lang/isFunction');
+    baseIsFunction = require('../internal/baseIsFunction');
 
 /** Used as the `TypeError` message for "Functions" methods. */
 var FUNC_ERROR_TEXT = 'Expected a function';
@@ -33,9 +33,9 @@ function flowRight() {
       fromIndex = funcs.length - 1;
 
   if (fromIndex < 0) {
-    return function() {};
+    return function() { return arguments[0]; };
   }
-  if (!arrayEvery(funcs, isFunction)) {
+  if (!arrayEvery(funcs, baseIsFunction)) {
     throw new TypeError(FUNC_ERROR_TEXT);
   }
   return function() {

function/memoize.js

@@ -1,5 +1,4 @@
-var MapCache = require('../internal/MapCache'),
+var MapCache = require('../internal/MapCache');
-    isFunction = require('../lang/isFunction');
 
 /** Used as the `TypeError` message for "Functions" methods. */
 var FUNC_ERROR_TEXT = 'Expected a function';
@@ -58,7 +57,7 @@ var FUNC_ERROR_TEXT = 'Expected a function';
  * // => { 'user': 'barney' }
  */
 function memoize(func, resolver) {
-  if (!isFunction(func) || (resolver && !isFunction(resolver))) {
+  if (typeof func != 'function' || (resolver && typeof resolver != 'function')) {
     throw new TypeError(FUNC_ERROR_TEXT);
   }
   var memoized = function() {

function/negate.js

@@ -1,5 +1,3 @@
-var isFunction = require('../lang/isFunction');
-
 /** Used as the `TypeError` message for "Functions" methods. */
 var FUNC_ERROR_TEXT = 'Expected a function';
 
@@ -23,7 +21,7 @@ var FUNC_ERROR_TEXT = 'Expected a function';
  * // => [1, 3, 5]
  */
 function negate(predicate) {
-  if (!isFunction(predicate)) {
+  if (typeof predicate != 'function') {
     throw new TypeError(FUNC_ERROR_TEXT);
   }
   return function() {

function/once.js

@@ -7,7 +7,6 @@ var before = require('./before');
  *
  * @static
  * @memberOf _
- * @type Function
  * @category Function
  * @param {Function} func The function to restrict.
  * @returns {Function} Returns the new restricted function.

function/rearg.js

@@ -27,7 +27,9 @@ var REARG_FLAG = 128;
  * // => ['a', 'b', 'c']
  *
  * var map = _.rearg(_.map, [1, 0]);
- * map(function(n) { return n * 3; }, [1, 2, 3]);
+ * map(function(n) {
+ *   return n * 3;
+ * }, [1, 2, 3]);
  * // => [3, 6, 9]
  */
 function rearg(func) {

function/spread.js

@@ -0,0 +1,43 @@
+/** Used as the `TypeError` message for "Functions" methods. */
+var FUNC_ERROR_TEXT = 'Expected a function';
+
+/**
+ * Creates a function that invokes `func` with the `this` binding of the
+ * created function and the array of arguments provided to the created
+ * function much like [Function#apply](http://es5.github.io/#x15.3.4.3).
+ *
+ * @static
+ * @memberOf _
+ * @category Function
+ * @param {Function} func The function to spread arguments over.
+ * @returns {*} Returns the new function.
+ * @example
+ *
+ * var spread = _.spread(function(who, what) {
+ *   return who + ' says ' + what;
+ * });
+ *
+ * spread(['Fred', 'hello']);
+ * // => 'Fred says hello'
+ *
+ * // with a Promise
+ * var numbers = Promise.all([
+ *   Promise.resolve(40),
+ *   Promise.resolve(36)
+ * ]);
+ *
+ * numbers.then(_.spread(function(x, y) {
+ *   return x + y;
+ * }));
+ * // => a Promise of 76
+ */
+function spread(func) {
+  if (typeof func != 'function') {
+    throw new TypeError(FUNC_ERROR_TEXT);
+  }
+  return function(array) {
+    return func.apply(this, array);
+  };
+}
+
+module.exports = spread;

function/throttle.js

@@ -1,5 +1,4 @@
 var debounce = require('./debounce'),
-    isFunction = require('../lang/isFunction'),
     isObject = require('../lang/isObject');
 
 /** Used as the `TypeError` message for "Functions" methods. */
@@ -31,7 +30,7 @@ var debounceOptions = {
  * @memberOf _
  * @category Function
  * @param {Function} func The function to throttle.
- * @param {number} wait The number of milliseconds to throttle invocations to.
+ * @param {number} [wait=0] The number of milliseconds to throttle invocations to.
  * @param {Object} [options] The options object.
  * @param {boolean} [options.leading=true] Specify invoking on the leading
  *  edge of the timeout.
@@ -44,8 +43,9 @@ var debounceOptions = {
  * jQuery(window).on('scroll', _.throttle(updatePosition, 100));
  *
  * // invoke `renewToken` when the click event is fired, but not more than once every 5 minutes
- * var throttled =  _.throttle(renewToken, 300000, { 'trailing': false })
+ * jQuery('.interactive').on('click', _.throttle(renewToken, 300000, {
- * jQuery('.interactive').on('click', throttled);
+ *   'trailing': false
+ * }));
  *
  * // cancel a trailing throttled call
  * jQuery(window).on('popstate', throttled.cancel);
@@ -54,7 +54,7 @@ function throttle(func, wait, options) {
   var leading = true,
       trailing = true;
 
-  if (!isFunction(func)) {
+  if (typeof func != 'function') {
     throw new TypeError(FUNC_ERROR_TEXT);
   }
   if (options === false) {

internal/LazyWrapper.js

@@ -1,3 +1,6 @@
+var baseCreate = require('./baseCreate'),
+    baseLodash = require('./baseLodash');
+
 /** Used as references for `-Infinity` and `Infinity`. */
 var POSITIVE_INFINITY = Number.POSITIVE_INFINITY;
 
@@ -8,14 +11,17 @@ var POSITIVE_INFINITY = Number.POSITIVE_INFINITY;
  * @param {*} value The value to wrap.
  */
 function LazyWrapper(value) {
-  this.actions = null;
+  this.__wrapped__ = value;
-  this.dir = 1;
+  this.__actions__ = null;
-  this.dropCount = 0;
+  this.__dir__ = 1;
-  this.filtered = false;
+  this.__dropCount__ = 0;
-  this.iteratees = null;
+  this.__filtered__ = false;
-  this.takeCount = POSITIVE_INFINITY;
+  this.__iteratees__ = null;
-  this.views = null;
+  this.__takeCount__ = POSITIVE_INFINITY;
-  this.wrapped = value;
+  this.__views__ = null;
 }
 
+LazyWrapper.prototype = baseCreate(baseLodash.prototype);
+LazyWrapper.prototype.constructor = LazyWrapper;
+
 module.exports = LazyWrapper;

internal/LodashWrapper.js

@@ -1,3 +1,6 @@
+var baseCreate = require('./baseCreate'),
+    baseLodash = require('./baseLodash');
+
 /**
  * The base constructor for creating `lodash` wrapper objects.
  *
@@ -7,9 +10,12 @@
  * @param {Array} [actions=[]] Actions to peform to resolve the unwrapped value.
  */
 function LodashWrapper(value, chainAll, actions) {
+  this.__wrapped__ = value;
   this.__actions__ = actions || [];
   this.__chain__ = !!chainAll;
-  this.__wrapped__ = value;
 }
 
+LodashWrapper.prototype = baseCreate(baseLodash.prototype);
+LodashWrapper.prototype.constructor = LodashWrapper;
+
 module.exports = LodashWrapper;

internal/baseAssign.js

@@ -17,7 +17,7 @@ function baseAssign(object, source, customizer) {
     return baseCopy(source, object, props);
   }
   var index = -1,
-      length = props.length
+      length = props.length;
 
   while (++index < length) {
     var key = props[index],

internal/baseCallback.js

@@ -1,4 +1,5 @@
 var baseMatches = require('./baseMatches'),
+    baseMatchesProperty = require('./baseMatchesProperty'),
     baseProperty = require('./baseProperty'),
     bindCallback = require('./bindCallback'),
     identity = require('../utility/identity'),
@@ -24,10 +25,12 @@ function baseCallback(func, thisArg, argCount) {
   if (func == null) {
     return identity;
   }
-  // Handle "_.property" and "_.matches" style callback shorthands.
+  if (type == 'object') {
-  return type == 'object'
+    return baseMatches(func);
-    ? baseMatches(func, !argCount)
+  }
-    : baseProperty(func + '');
+  return typeof thisArg == 'undefined'
+    ? baseProperty(func + '')
+    : baseMatchesProperty(func + '', thisArg);
 }
 
 module.exports = baseCallback;

internal/baseDelay.js

@@ -1,5 +1,4 @@
-var baseSlice = require('./baseSlice'),
+var baseSlice = require('./baseSlice');
-    isFunction = require('../lang/isFunction');
 
 /** Used as the `TypeError` message for "Functions" methods. */
 var FUNC_ERROR_TEXT = 'Expected a function';
@@ -15,7 +14,7 @@ var FUNC_ERROR_TEXT = 'Expected a function';
  * @returns {number} Returns the timer id.
  */
 function baseDelay(func, wait, args, fromIndex) {
-  if (!isFunction(func)) {
+  if (typeof func != 'function') {
     throw new TypeError(FUNC_ERROR_TEXT);
   }
   return setTimeout(function() { func.apply(undefined, baseSlice(args, fromIndex)); }, wait);

internal/baseDifference.js

@@ -21,7 +21,7 @@ function baseDifference(array, values) {
   var index = -1,
       indexOf = baseIndexOf,
       isCommon = true,
-      cache = isCommon && values.length >= 200 && createCache(values),
+      cache = (isCommon && values.length >= 200) ? createCache(values) : null,
       valuesLength = values.length;
 
   if (cache) {

internal/baseFill.js

@@ -0,0 +1,31 @@
+/**
+ * The base implementation of `_.fill` without an iteratee call guard.
+ *
+ * @private
+ * @param {Array} array The array to fill.
+ * @param {*} value The value to fill `array` with.
+ * @param {number} [start=0] The start position.
+ * @param {number} [end=array.length] The end position.
+ * @returns {Array} Returns `array`.
+ */
+function baseFill(array, value, start, end) {
+  var length = array.length;
+
+  start = start == null ? 0 : (+start || 0);
+  if (start < 0) {
+    start = -start > length ? 0 : (length + start);
+  }
+  end = (typeof end == 'undefined' || end > length) ? length : (+end || 0);
+  if (end < 0) {
+    end += length;
+  }
+  length = start > end ? 0 : end >>> 0;
+  start >>>= 0;
+
+  while (start < length) {
+    array[start++] = value;
+  }
+  return array;
+}
+
+module.exports = baseFill;

internal/baseIsFunction.js

@@ -0,0 +1,15 @@
+/**
+ * The base implementation of `_.isFunction` without support for environments
+ * with incorrect `typeof` results.
+ *
+ * @private
+ * @param {*} value The value to check.
+ * @returns {boolean} Returns `true` if `value` is correctly classified, else `false`.
+ */
+function baseIsFunction(value) {
+  // Avoid a Chakra JIT bug in compatibility modes of IE 11.
+  // See https://github.com/jashkenas/underscore/issues/1621 for more details.
+  return typeof value == 'function' || false;
+}
+
+module.exports = baseIsFunction;

internal/baseIsMatch.js

@@ -11,7 +11,7 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * shorthands or `this` binding.
  *
  * @private
- * @param {Object} source The object to inspect.
+ * @param {Object} object The object to inspect.
  * @param {Array} props The source property names to match.
  * @param {Array} values The source values to match.
  * @param {Array} strictCompareFlags Strict comparison flags for source values.

internal/baseLodash.js

@@ -0,0 +1,10 @@
+/**
+ * The function whose prototype all chaining wrappers inherit from.
+ *
+ * @private
+ */
+function baseLodash() {
+  // No operation performed.
+}
+
+module.exports = baseLodash;

internal/baseMatches.js

@@ -1,5 +1,4 @@
-var baseClone = require('./baseClone'),
+var baseIsMatch = require('./baseIsMatch'),
-    baseIsMatch = require('./baseIsMatch'),
     isStrictComparable = require('./isStrictComparable'),
     keys = require('../object/keys');
 
@@ -10,15 +9,13 @@ var objectProto = Object.prototype;
 var hasOwnProperty = objectProto.hasOwnProperty;
 
 /**
- * The base implementation of `_.matches` which supports specifying whether
+ * The base implementation of `_.matches` which does not clone `source`.
- * `source` should be cloned.
  *
  * @private
  * @param {Object} source The object of property values to match.
- * @param {boolean} [isCloned] Specify cloning the source object.
  * @returns {Function} Returns the new function.
  */
-function baseMatches(source, isCloned) {
+function baseMatches(source) {
   var props = keys(source),
       length = props.length;
 
@@ -28,13 +25,10 @@ function baseMatches(source, isCloned) {
 
     if (isStrictComparable(value)) {
       return function(object) {
-        return object != null && value === object[key] && hasOwnProperty.call(object, key);
+        return object != null && object[key] === value && hasOwnProperty.call(object, key);
       };
     }
   }
-  if (isCloned) {
-    source = baseClone(source, true);
-  }
   var values = Array(length),
       strictCompareFlags = Array(length);
 

internal/baseMatchesProperty.js

@@ -0,0 +1,24 @@
+var baseIsEqual = require('./baseIsEqual'),
+    isStrictComparable = require('./isStrictComparable');
+
+/**
+ * The base implementation of `_.matchesProperty` which does not coerce `key`
+ * to a string.
+ *
+ * @private
+ * @param {string} key The key of the property to get.
+ * @param {*} value The value to compare.
+ * @returns {Function} Returns the new function.
+ */
+function baseMatchesProperty(key, value) {
+  if (isStrictComparable(value)) {
+    return function(object) {
+      return object != null && object[key] === value;
+    };
+  }
+  return function(object) {
+    return object != null && baseIsEqual(value, object[key], null, true);
+  };
+}
+
+module.exports = baseMatchesProperty;

internal/baseMerge.js

@@ -3,6 +3,7 @@ var arrayEach = require('./arrayEach'),
     baseMergeDeep = require('./baseMergeDeep'),
     isArray = require('../lang/isArray'),
     isLength = require('./isLength'),
+    isObject = require('../lang/isObject'),
     isObjectLike = require('./isObjectLike'),
     isTypedArray = require('../lang/isTypedArray');
 
@@ -19,8 +20,10 @@ var arrayEach = require('./arrayEach'),
  * @returns {Object} Returns the destination object.
  */
 function baseMerge(object, source, customizer, stackA, stackB) {
+  if (!isObject(object)) {
+    return object;
+  }
   var isSrcArr = isLength(source.length) && (isArray(source) || isTypedArray(source));
-
   (isSrcArr ? arrayEach : baseForOwn)(source, function(srcValue, key, source) {
     if (isObjectLike(srcValue)) {
       stackA || (stackA = []);

internal/baseReduce.js

@@ -16,7 +16,7 @@ function baseReduce(collection, iteratee, accumulator, initFromCollection, eachF
   eachFunc(collection, function(value, index, collection) {
     accumulator = initFromCollection
       ? (initFromCollection = false, value)
-      : iteratee(accumulator, value, index, collection)
+      : iteratee(accumulator, value, index, collection);
   });
   return accumulator;
 }

internal/baseUniq.js

@@ -17,7 +17,7 @@ function baseUniq(array, iteratee) {
       length = array.length,
       isCommon = true,
       isLarge = isCommon && length >= 200,
-      seen = isLarge && createCache(),
+      seen = isLarge ? createCache() : null,
       result = [];
 
   if (seen) {

internal/createAggregator.js

@@ -5,8 +5,7 @@ var baseCallback = require('./baseCallback'),
 /**
  * Creates a function that aggregates a collection, creating an accumulator
  * object composed from the results of running each element in the collection
- * through an iteratee. The `setter` sets the keys and values of the accumulator
+ * through an iteratee.
- * object. If `initializer` is provided initializes the accumulator object.
  *
  * @private
  * @param {Function} setter The function to set keys and values of the accumulator object.

internal/createWrapper.js

@@ -3,7 +3,6 @@ var baseSetData = require('./baseSetData'),
     createHybridWrapper = require('./createHybridWrapper'),
     createPartialWrapper = require('./createPartialWrapper'),
     getData = require('./getData'),
-    isFunction = require('../lang/isFunction'),
     mergeData = require('./mergeData'),
     setData = require('./setData');
 
@@ -46,7 +45,7 @@ var nativeMax = Math.max;
  */
 function createWrapper(func, bitmask, thisArg, partials, holders, argPos, ary, arity) {
   var isBindKey = bitmask & BIND_KEY_FLAG;
-  if (!isBindKey && !isFunction(func)) {
+  if (!isBindKey && typeof func != 'function') {
     throw new TypeError(FUNC_ERROR_TEXT);
   }
   var length = partials ? partials.length : 0;
@@ -76,9 +75,9 @@ function createWrapper(func, bitmask, thisArg, partials, holders, argPos, ary, a
   if (bitmask == BIND_FLAG) {
     var result = createBindWrapper(newData[0], newData[2]);
   } else if ((bitmask == PARTIAL_FLAG || bitmask == (BIND_FLAG | PARTIAL_FLAG)) && !newData[4].length) {
-    result = createPartialWrapper.apply(null, newData);
+    result = createPartialWrapper.apply(undefined, newData);
   } else {
-    result = createHybridWrapper.apply(null, newData);
+    result = createHybridWrapper.apply(undefined, newData);
   }
   var setter = data ? baseSetData : setData;
   return setter(result, newData);