Bump to v3.2.0.

README.md

@@ -1,4 +1,4 @@
-# lodash v3.0.1
+# lodash v3.2.0
 
 The [modern build](https://github.com/lodash/lodash/wiki/Build-Differences) of [lodash](https://lodash.com/) exported as [AMD](https://github.com/amdjs/amdjs-api/wiki/AMD) modules.
 

array.js

@@ -1,4 +1,4 @@
-define(['./array/chunk', './array/compact', './array/difference', './array/drop', './array/dropRight', './array/dropRightWhile', './array/dropWhile', './array/findIndex', './array/findLastIndex', './array/first', './array/flatten', './array/flattenDeep', './array/head', './array/indexOf', './array/initial', './array/intersection', './array/last', './array/lastIndexOf', './array/object', './array/pull', './array/pullAt', './array/remove', './array/rest', './array/slice', './array/sortedIndex', './array/sortedLastIndex', './array/tail', './array/take', './array/takeRight', './array/takeRightWhile', './array/takeWhile', './array/union', './array/uniq', './array/unique', './array/unzip', './array/without', './array/xor', './array/zip', './array/zipObject'], function(chunk, compact, difference, drop, dropRight, dropRightWhile, dropWhile, findIndex, findLastIndex, first, flatten, flattenDeep, head, indexOf, initial, intersection, last, lastIndexOf, object, pull, pullAt, remove, rest, slice, sortedIndex, sortedLastIndex, tail, take, takeRight, takeRightWhile, takeWhile, union, uniq, unique, unzip, without, xor, zip, zipObject) {
+define(['./array/chunk', './array/compact', './array/difference', './array/drop', './array/dropRight', './array/dropRightWhile', './array/dropWhile', './array/fill', './array/findIndex', './array/findLastIndex', './array/first', './array/flatten', './array/flattenDeep', './array/head', './array/indexOf', './array/initial', './array/intersection', './array/last', './array/lastIndexOf', './array/object', './array/pull', './array/pullAt', './array/remove', './array/rest', './array/slice', './array/sortedIndex', './array/sortedLastIndex', './array/tail', './array/take', './array/takeRight', './array/takeRightWhile', './array/takeWhile', './array/union', './array/uniq', './array/unique', './array/unzip', './array/without', './array/xor', './array/zip', './array/zipObject'], function(chunk, compact, difference, drop, dropRight, dropRightWhile, dropWhile, fill, findIndex, findLastIndex, first, flatten, flattenDeep, head, indexOf, initial, intersection, last, lastIndexOf, object, pull, pullAt, remove, rest, slice, sortedIndex, sortedLastIndex, tail, take, takeRight, takeRightWhile, takeWhile, union, uniq, unique, unzip, without, xor, zip, zipObject) {
   return {
     'chunk': chunk,
     'compact': compact,
@@ -7,6 +7,7 @@ define(['./array/chunk', './array/compact', './array/difference', './array/drop'
     'dropRight': dropRight,
     'dropRightWhile': dropRightWhile,
     'dropWhile': dropWhile,
+    'fill': fill,
     'findIndex': findIndex,
     'findLastIndex': findLastIndex,
     'first': first,

array/chunk.js

@@ -15,7 +15,7 @@ define(['../internal/baseSlice', '../internal/isIterateeCall'], function(baseSli
    * @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/drop.js

@@ -5,7 +5,6 @@ define(['../internal/baseSlice', '../internal/isIterateeCall'], function(baseSli
    *
    * @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

@@ -5,7 +5,6 @@ define(['../internal/baseSlice', '../internal/isIterateeCall'], function(baseSli
    *
    * @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

@@ -5,20 +5,23 @@ define(['../internal/baseCallback', '../internal/baseSlice'], function(baseCallb
    * 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
-   * callback returns `true` for elements that have the properties of the given
+   * 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 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
@@ -27,18 +30,22 @@ define(['../internal/baseCallback', '../internal/baseSlice'], function(baseCallb
    * // => [1]
    *
    * var users = [
-   *   { 'user': 'barney',  'status': 'busy', 'active': false },
-   *   { 'user': 'fred',    'status': 'busy', 'active': true },
-   *   { 'user': 'pebbles', 'status': 'away', 'active': true }
+   *   { 'user': 'barney',  'active': true },
+   *   { 'user': 'fred',    'active': false },
+   *   { 'user': 'pebbles', 'active': false }
    * ];
    *
-   * // using the "_.property" callback shorthand
-   * _.pluck(_.dropRightWhile(users, 'active'), 'user');
+   * // using the `_.matches` callback shorthand
+   * _.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
-   * _.pluck(_.dropRightWhile(users, { 'status': 'away' }), 'user');
-   * // => ['barney', 'fred']
+   * // using the `_.property` callback shorthand
+   * _.pluck(_.dropRightWhile(users, 'active'), 'user');
+   * // => ['barney', 'fred', 'pebbles']
    */
   function dropRightWhile(array, predicate, thisArg) {
     var length = array ? array.length : 0;

array/dropWhile.js

@@ -5,20 +5,23 @@ define(['../internal/baseCallback', '../internal/baseSlice'], function(baseCallb
    * 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
@@ -27,18 +30,22 @@ define(['../internal/baseCallback', '../internal/baseSlice'], function(baseCallb
    * // => [3]
    *
    * var users = [
-   *   { 'user': 'barney',  'status': 'busy', 'active': true },
-   *   { 'user': 'fred',    'status': 'busy', 'active': false },
-   *   { 'user': 'pebbles', 'status': 'away', 'active': true }
+   *   { 'user': 'barney',  'active': false },
+   *   { 'user': 'fred',    'active': false },
+   *   { 'user': 'pebbles', 'active': true }
    * ];
    *
-   * // using the "_.property" callback shorthand
-   * _.pluck(_.dropWhile(users, 'active'), 'user');
+   * // using the `_.matches` callback shorthand
+   * _.pluck(_.dropWhile(users, { 'user': 'barney', 'active': false }), 'user');
    * // => ['fred', 'pebbles']
    *
-   * // using the "_.matches" callback shorthand
-   * _.pluck(_.dropWhile(users, { 'status': 'busy' }), 'user');
+   * // using the `_.matchesProperty` callback shorthand
+   * _.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 @@
+define(['../internal/baseFill', '../internal/isIterateeCall'], function(baseFill, 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);
+  }
+
+  return fill;
+});

array/findIndex.js

@@ -4,10 +4,14 @@ define(['../internal/baseCallback'], function(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,31 @@ define(['../internal/baseCallback'], function(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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @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': 'fred',    'age': 40, 'active': true },
-   *   { 'user': 'pebbles', 'age': 1,  'active': false }
+   *   { 'user': 'barney',  'active': false },
+   *   { 'user': 'fred',    '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
-   * _.findIndex(users, { 'age': 1 });
-   * // => 2
-   *
-   * // using the "_.property" callback shorthand
-   * _.findIndex(users, 'active');
+   * // using the `_.matches` callback shorthand
+   * _.findIndex(users, { 'user': 'fred', 'active': false });
    * // => 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 @@ define(['../internal/baseCallback'], function(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,29 @@ define(['../internal/baseCallback'], function(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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @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': 'fred',    'age': 40, 'active': false },
-   *   { 'user': 'pebbles', 'age': 1,  'active': false }
+   *   { 'user': 'barney',  'active': true },
+   *   { 'user': 'fred',    '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
-   * _.findLastIndex(users, { 'age': 40 });
+   * // using the `_.matches` callback shorthand
+   * _.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/remove.js

@@ -11,10 +11,14 @@ define(['../internal/baseCallback'], function(baseCallback) {
    * 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,8 +29,7 @@ define(['../internal/baseCallback'], function(baseCallback) {
    * @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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `predicate`.
    * @returns {Array} Returns the new array of removed elements.
    * @example

array/sortedIndex.js

@@ -7,10 +7,14 @@ define(['../internal/baseCallback', '../internal/binaryIndex', '../internal/bina
    * 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`.
    *
@@ -20,8 +24,7 @@ define(['../internal/baseCallback', '../internal/binaryIndex', '../internal/bina
    * @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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `iteratee`.
    * @returns {number} Returns the index at which `value` should be inserted
    *  into `array`.
@@ -41,7 +44,7 @@ define(['../internal/baseCallback', '../internal/binaryIndex', '../internal/bina
    * }, dict);
    * // => 1
    *
-   * // using the "_.property" callback shorthand
+   * // using the `_.property` callback shorthand
    * _.sortedIndex([{ 'x': 30 }, { 'x': 50 }], { 'x': 40 }, 'x');
    * // => 1
    */

array/sortedLastIndex.js

@@ -11,8 +11,7 @@ define(['../internal/baseCallback', '../internal/binaryIndex', '../internal/bina
    * @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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `iteratee`.
    * @returns {number} Returns the index at which `value` should be inserted
    *  into `array`.

array/take.js

@@ -5,7 +5,6 @@ define(['../internal/baseSlice', '../internal/isIterateeCall'], function(baseSli
    *
    * @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

@@ -5,7 +5,6 @@ define(['../internal/baseSlice', '../internal/isIterateeCall'], function(baseSli
    *
    * @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

@@ -5,20 +5,23 @@ define(['../internal/baseCallback', '../internal/baseSlice'], function(baseCallb
    * 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
@@ -27,18 +30,22 @@ define(['../internal/baseCallback', '../internal/baseSlice'], function(baseCallb
    * // => [2, 3]
    *
    * var users = [
-   *   { 'user': 'barney',  'status': 'busy', 'active': false },
-   *   { 'user': 'fred',    'status': 'busy', 'active': true },
-   *   { 'user': 'pebbles', 'status': 'away', 'active': true }
+   *   { 'user': 'barney',  'active': true },
+   *   { 'user': 'fred',    'active': false },
+   *   { 'user': 'pebbles', 'active': false }
    * ];
    *
-   * // using the "_.property" callback shorthand
-   * _.pluck(_.takeRightWhile(users, 'active'), 'user');
+   * // using the `_.matches` callback shorthand
+   * _.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
-   * _.pluck(_.takeRightWhile(users, { 'status': 'away' }), 'user');
-   * // => ['pebbles']
+   * // using the `_.property` callback shorthand
+   * _.pluck(_.takeRightWhile(users, 'active'), 'user');
+   * // => []
    */
   function takeRightWhile(array, predicate, thisArg) {
     var length = array ? array.length : 0;

array/takeWhile.js

@@ -5,20 +5,23 @@ define(['../internal/baseCallback', '../internal/baseSlice'], function(baseCallb
    * 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
@@ -27,18 +30,22 @@ define(['../internal/baseCallback', '../internal/baseSlice'], function(baseCallb
    * // => [1, 2]
    *
    * var users = [
-   *   { 'user': 'barney',  'status': 'busy', 'active': true },
-   *   { 'user': 'fred',    'status': 'busy', 'active': false },
-   *   { 'user': 'pebbles', 'status': 'away', 'active': true }
+   *   { 'user': 'barney',  'active': false },
+   *   { 'user': 'fred',    'active': false},
+   *   { 'user': 'pebbles', 'active': true }
    * ];
    *
-   * // using the "_.property" callback shorthand
-   * _.pluck(_.takeWhile(users, 'active'), 'user');
+   * // using the `_.matches` callback shorthand
+   * _.pluck(_.takeWhile(users, { 'user': 'barney', 'active': false }), 'user');
    * // => ['barney']
    *
-   * // using the "_.matches" callback shorthand
-   * _.pluck(_.takeWhile(users, { 'status': 'busy' }), 'user');
+   * // using the `_.matchesProperty` callback shorthand
+   * _.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/uniq.js

@@ -8,10 +8,14 @@ define(['../internal/baseCallback', '../internal/baseUniq', '../internal/isItera
    * 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`.
    *
@@ -27,8 +31,6 @@ define(['../internal/baseCallback', '../internal/baseUniq', '../internal/isItera
    * @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,7 +46,7 @@ define(['../internal/baseCallback', '../internal/baseUniq', '../internal/isItera
    * _.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 }]
    */

chain.js

@@ -1,8 +1,11 @@
-define(['./chain/chain', './chain/lodash', './chain/reverse', './chain/tap', './chain/thru', './chain/toJSON', './chain/toString', './chain/value', './chain/valueOf', './chain/wrapperChain'], function(chain, lodash, reverse, tap, thru, toJSON, toString, value, valueOf, wrapperChain) {
+define(['./chain/chain', './chain/commit', './chain/lodash', './chain/plant', './chain/reverse', './chain/run', './chain/tap', './chain/thru', './chain/toJSON', './chain/toString', './chain/value', './chain/valueOf', './chain/wrapperChain'], function(chain, commit, lodash, plant, reverse, run, tap, thru, toJSON, toString, value, valueOf, wrapperChain) {
   return {
     'chain': chain,
+    'commit': commit,
     'lodash': lodash,
+    'plant': plant,
     'reverse': reverse,
+    'run': run,
     'tap': tap,
     'thru': thru,
     'toJSON': toJSON,

chain/chain.js

@@ -8,7 +8,7 @@ define(['./lodash'], function(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 = [

chain/commit.js

@@ -0,0 +1,3 @@
+define(["./wrapperCommit"], function(wrapperCommit) {
+  return wrapperCommit;
+});

chain/lodash.js

@@ -1,4 +1,4 @@
-define(['../internal/LodashWrapper', '../internal/arrayCopy', '../lang/isArray', '../internal/isObjectLike'], function(LodashWrapper, arrayCopy, isArray, isObjectLike) {
+define(['../internal/LazyWrapper', '../internal/LodashWrapper', '../lang/isArray', '../internal/isObjectLike', '../internal/wrapperClone'], function(LazyWrapper, LodashWrapper, isArray, isObjectLike, wrapperClone) {
 
   /** Used for native method references. */
   var objectProto = Object.prototype;
@@ -7,7 +7,7 @@ define(['../internal/LodashWrapper', '../internal/arrayCopy', '../lang/isArray',
   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
@@ -26,51 +26,53 @@ define(['../internal/LodashWrapper', '../internal/arrayCopy', '../lang/isArray',
    * `concat`, `join`, `pop`, `push`, `reverse`, `shift`, `slice`, `sort`, `splice`,
    * and `unshift`
    *
-   * The wrapper functions that support shortcut fusion are:
-   * `drop`, `dropRight`, `dropRightWhile`, `dropWhile`, `filter`, `first`,
-   * `initial`, `last`, `map`, `pluck`, `reject`, `rest`, `reverse`, `slice`,
-   * `take`, `takeRight`, `takeRightWhile`, `takeWhile`, and `where`
+   * The wrapper methods that support shortcut fusion are:
+   * `compact`, `drop`, `dropRight`, `dropRightWhile`, `dropWhile`, `filter`,
+   * `first`, `initial`, `last`, `map`, `pluck`, `reject`, `rest`, `reverse`,
+   * `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`,
-   * `create`, `curry`, `debounce`, `defaults`, `defer`, `delay`, `difference`,
-   * `drop`, `dropRight`, `dropRightWhile`, `dropWhile`, `filter`, `flatten`,
-   * `flattenDeep`, `flow`, `flowRight`, `forEach`, `forEachRight`, `forIn`,
-   * `forInRight`, `forOwn`, `forOwnRight`, `functions`, `groupBy`, `indexBy`,
-   * `initial`, `intersection`, `invert`, `invoke`, `keys`, `keysIn`, `map`,
-   * `mapValues`, `matches`, `memoize`, `merge`, `mixin`, `negate`, `noop`,
-   * `omit`, `once`, `pairs`, `partial`, `partialRight`, `partition`, `pick`,
-   * `pluck`, `property`, `propertyOf`, `pull`, `pullAt`, `push`, `range`,
-   * `rearg`, `reject`, `remove`, `rest`, `reverse`, `shuffle`, `slice`, `sort`,
-   * `sortBy`, `sortByAll`, `splice`, `take`, `takeRight`, `takeRightWhile`,
-   * `takeWhile`, `tap`, `throttle`, `thru`, `times`, `toArray`, `toPlainObject`,
-   * `transform`, `union`, `uniq`, `unshift`, `unzip`, `values`, `valuesIn`,
-   * `where`, `without`, `wrap`, `xor`, `zip`, and `zipObject`
+   * `callback`, `chain`, `chunk`, `commit`, `compact`, `concat`, `constant`,
+   * `countBy`, `create`, `curry`, `debounce`, `defaults`, `defer`, `delay`,
+   * `difference`, `drop`, `dropRight`, `dropRightWhile`, `dropWhile`, `fill`,
+   * `filter`, `flatten`, `flattenDeep`, `flow`, `flowRight`, `forEach`,
+   * `forEachRight`, `forIn`, `forInRight`, `forOwn`, `forOwnRight`, `functions`,
+   * `groupBy`, `indexBy`, `initial`, `intersection`, `invert`, `invoke`, `keys`,
+   * `keysIn`, `map`, `mapValues`, `matches`, `matchesProperty`, `memoize`, `merge`,
+   * `mixin`, `negate`, `noop`, `omit`, `once`, `pairs`, `partial`, `partialRight`,
+   * `partition`, `pick`, `plant`, `pluck`, `property`, `propertyOf`, `pull`,
+   * `pullAt`, `push`, `range`, `rearg`, `reject`, `remove`, `rest`, `reverse`,
+   * `shuffle`, `slice`, `sort`, `sortBy`, `sortByAll`, `splice`, `spread`,
+   * `take`, `takeRight`, `takeRightWhile`, `takeWhile`, `tap`, `throttle`,
+   * `thru`, `times`, `toArray`, `toPlainObject`, `transform`, `union`, `uniq`,
+   * `unshift`, `unzip`, `values`, `valuesIn`, `where`, `without`, `wrap`, `xor`,
+   * `zip`, and `zipObject`
    *
-   * 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`,
-   * `unescape`, `uniqueId`, `value`, and `words`
+   * `startCase`, `startsWith`, `template`, `trim`, `trimLeft`, `trimRight`,
+   * `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]);
@@ -89,19 +91,16 @@ define(['../internal/LodashWrapper', '../internal/arrayCopy', '../lang/isArray',
    * // => 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__')) {
-        return new LodashWrapper(value.__wrapped__, value.__chain__, arrayCopy(value.__actions__));
+      if (hasOwnProperty.call(value, '__chain__') && hasOwnProperty.call(value, '__wrapped__')) {
+        return wrapperClone(value);
       }
     }
     return new LodashWrapper(value);
   }
 
-  // Ensure `new LodashWrapper` is an instance of `lodash`.
-  LodashWrapper.prototype = lodash.prototype;
-
   return lodash;
 });

chain/plant.js

@@ -0,0 +1,3 @@
+define(["./wrapperPlant"], function(wrapperPlant) {
+  return wrapperPlant;
+});

chain/run.js

@@ -0,0 +1,3 @@
+define(["./wrapperValue"], function(wrapperValue) {
+  return wrapperValue;
+});

chain/wrapperChain.js

@@ -6,7 +6,7 @@ define(['./chain'], function(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,33 @@
+define(['../internal/LodashWrapper'], function(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__);
+  }
+
+  return wrapperCommit;
+});

chain/wrapperPlant.js

@@ -0,0 +1,45 @@
+define(['../internal/LodashWrapper', '../internal/wrapperClone'], function(LodashWrapper, 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 LodashWrapper) {
+      var clone = wrapperClone(parent);
+      if (result) {
+        previous.__wrapped__ = clone;
+      } else {
+        result = clone;
+      }
+      var previous = clone;
+      parent = parent.__wrapped__;
+    }
+    previous.__wrapped__ = value;
+    return result;
+  }
+
+  return wrapperPlant;
+});

chain/wrapperReverse.js

@@ -9,7 +9,7 @@ define(['../internal/LazyWrapper', '../internal/LodashWrapper', './thru'], funct
    * @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];
@@ -26,7 +26,7 @@ define(['../internal/LazyWrapper', '../internal/LodashWrapper', './thru'], funct
       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 @@ define(['../internal/baseWrapperValue'], function(baseWrapperValue) {
    *
    * @name value
    * @memberOf _
-   * @alias toJSON, valueOf
+   * @alias run, toJSON, valueOf
    * @category Chain
    * @returns {*} Returns the resolved unwrapped value.
    * @example

collection/countBy.js

@@ -13,10 +13,14 @@ define(['../internal/createAggregator'], function(createAggregator) {
    * 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,8 +29,7 @@ define(['../internal/createAggregator'], function(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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `iteratee`.
    * @returns {Object} Returns the composed aggregate object.
    * @example

collection/every.js

@@ -5,10 +5,14 @@ define(['../internal/arrayEvery', '../internal/baseCallback', '../internal/baseE
    * 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,27 +22,30 @@ define(['../internal/arrayEvery', '../internal/baseCallback', '../internal/baseE
    * @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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @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': 'fred',   'age': 40 }
+   *   { 'user': 'barney', 'active': false },
+   *   { 'user': 'fred',   'active': false }
    * ];
    *
-   * // using the "_.property" callback shorthand
-   * _.every(users, 'age');
+   * // using the `_.matches` callback shorthand
+   * _.every(users, { 'user': 'barney', 'active': false });
+   * // => false
+   *
+   * // using the `_.matchesProperty` callback shorthand
+   * _.every(users, 'active', false);
    * // => true
    *
-   * // using the "_.matches" callback shorthand
-   * _.every(users, { 'age': 36 });
+   * // using the `_.property` callback shorthand
+   * _.every(users, 'active');
    * // => false
    */
   function every(collection, predicate, thisArg) {

collection/filter.js

@@ -5,10 +5,14 @@ define(['../internal/arrayFilter', '../internal/baseCallback', '../internal/base
    * `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`.
    *
@@ -18,8 +22,7 @@ define(['../internal/arrayFilter', '../internal/baseCallback', '../internal/base
    * @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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `predicate`.
    * @returns {Array} Returns the new filtered array.
    * @example
@@ -28,16 +31,20 @@ define(['../internal/arrayFilter', '../internal/baseCallback', '../internal/base
    * // => [2, 4]
    *
    * var users = [
-   *   { 'user': 'barney', 'age': 36, 'active': false },
-   *   { 'user': 'fred',   'age': 40, 'active': true }
+   *   { 'user': 'barney', 'age': 36, 'active': true },
+   *   { 'user': 'fred',   'age': 40, 'active': false }
    * ];
    *
-   * // using the "_.property" callback shorthand
-   * _.pluck(_.filter(users, 'active'), 'user');
+   * // using the `_.matches` callback shorthand
+   * _.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
-   * _.pluck(_.filter(users, { 'age': 36 }), 'user');
+   * // using the `_.property` callback shorthand
+   * _.pluck(_.filter(users, 'active'), 'user');
    * // => ['barney']
    */
   function filter(collection, predicate, thisArg) {

collection/find.js

@@ -8,10 +8,14 @@ define(['../internal/baseCallback', '../internal/baseEach', '../internal/baseFin
    * `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,28 +25,31 @@ define(['../internal/baseCallback', '../internal/baseEach', '../internal/baseFin
    * @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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `predicate`.
    * @returns {*} Returns the matched element, else `undefined`.
    * @example
    *
    * var users = [
-   *   { 'user': 'barney',  'age': 36, 'active': false },
-   *   { 'user': 'fred',    'age': 40, 'active': true },
-   *   { 'user': 'pebbles', 'age': 1,  'active': false }
+   *   { 'user': 'barney',  'age': 36, 'active': true },
+   *   { 'user': 'fred',    'age': 40, 'active': false },
+   *   { 'user': 'pebbles', 'age': 1,  'active': true }
    * ];
    *
    * _.result(_.find(users, function(chr) { return chr.age < 40; }), 'user');
    * // => 'barney'
    *
-   * // using the "_.matches" callback shorthand
-   * _.result(_.find(users, { 'age': 1 }), 'user');
+   * // using the `_.matches` callback shorthand
+   * _.result(_.find(users, { 'age': 1, 'active': true }), 'user');
    * // => 'pebbles'
    *
-   * // using the "_.property" callback shorthand
-   * _.result(_.find(users, 'active'), 'user');
+   * // using the `_.matchesProperty` callback shorthand
+   * _.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

@@ -9,8 +9,7 @@ define(['../internal/baseCallback', '../internal/baseEachRight', '../internal/ba
    * @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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `predicate`.
    * @returns {*} Returns the matched element, else `undefined`.
    * @example

collection/findWhere.js

@@ -1,10 +1,15 @@
-define(['./find', '../utility/matches'], function(find, matches) {
+define(['../internal/baseMatches', './find'], function(baseMatches, 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
@@ -14,18 +19,18 @@ define(['./find', '../utility/matches'], function(find, matches) {
    * @example
    *
    * var users = [
-   *   { 'user': 'barney', 'age': 36, 'status': 'busy' },
-   *   { 'user': 'fred',   'age': 40, 'status': 'busy' }
+   *   { 'user': 'barney', 'age': 36, 'active': true },
+   *   { '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));
   }
 
   return findWhere;

collection/groupBy.js

@@ -13,10 +13,14 @@ define(['../internal/createAggregator'], function(createAggregator) {
    * 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,8 +29,7 @@ define(['../internal/createAggregator'], function(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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `iteratee`.
    * @returns {Object} Returns the composed aggregate object.
    * @example
@@ -37,7 +40,7 @@ define(['../internal/createAggregator'], function(createAggregator) {
    * _.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 @@ define(['../internal/createAggregator'], function(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 @@ define(['../internal/createAggregator'], function(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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `iteratee`.
    * @returns {Object} Returns the composed aggregate object.
    * @example

collection/map.js

@@ -5,21 +5,34 @@ define(['../internal/arrayMap', '../internal/baseCallback', '../internal/baseMap
    * `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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
+   *  create a `_.property` or `_.matches` style callback respectively.
    * @param {*} [thisArg] The `this` binding of `iteratee`.
    * @returns {Array} Returns the new mapped array.
    * @example
@@ -35,7 +48,7 @@ define(['../internal/arrayMap', '../internal/baseCallback', '../internal/baseMap
    *   { 'user': 'fred' }
    * ];
    *
-   * // using the "_.property" callback shorthand
+   * // using the `_.property` callback shorthand
    * _.map(users, 'user');
    * // => ['barney', 'fred']
    */

collection/max.js

@@ -7,10 +7,14 @@ define(['../internal/arrayMax', '../internal/createExtremum'], function(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`.
    *
@@ -19,8 +23,6 @@ define(['../internal/arrayMax', '../internal/createExtremum'], function(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
@@ -39,7 +41,7 @@ define(['../internal/arrayMax', '../internal/createExtremum'], function(arrayMax
    * _.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

@@ -7,10 +7,14 @@ define(['../internal/arrayMin', '../internal/createExtremum'], function(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`.
    *
@@ -19,8 +23,6 @@ define(['../internal/arrayMin', '../internal/createExtremum'], function(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
@@ -39,7 +41,7 @@ define(['../internal/arrayMin', '../internal/createExtremum'], function(arrayMin
    * _.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 @@ define(['../internal/createAggregator'], function(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,8 +22,7 @@ define(['../internal/createAggregator'], function(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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `predicate`.
    * @returns {Array} Returns the array of grouped elements.
    * @example
@@ -36,12 +39,18 @@ define(['../internal/createAggregator'], function(createAggregator) {
    *   { 'user': 'pebbles', 'age': 1,  'active': false }
    * ];
    *
-   * // using the "_.matches" callback shorthand
-   * _.map(_.partition(users, { 'age': 1 }), function(array) { return _.pluck(array, 'user'); });
+   * var mapper = function(array) { 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
-   * _.map(_.partition(users, 'active'), function(array) { return _.pluck(array, 'user'); });
+   * // using the `_.matchesProperty` callback shorthand
+   * _.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,4 +1,4 @@
-define(['./map', '../utility/property'], function(map, property) {
+define(['../internal/baseProperty', './map'], function(baseProperty, map) {
 
   /**
    * Gets the value of `key` from all elements in `collection`.
@@ -24,7 +24,7 @@ define(['./map', '../utility/property'], function(map, property) {
    * // => [36, 40] (iteration order is not guaranteed)
    */
   function pluck(collection, key) {
-    return map(collection, property(key));
+    return map(collection, baseProperty(key));
   }
 
   return pluck;

collection/reduce.js

@@ -8,6 +8,12 @@ define(['../internal/arrayReduce', '../internal/baseCallback', '../internal/base
    * 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

collection/reject.js

@@ -4,10 +4,14 @@ define(['../internal/arrayFilter', '../internal/baseCallback', '../internal/base
    * 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`.
    *
@@ -16,8 +20,7 @@ define(['../internal/arrayFilter', '../internal/baseCallback', '../internal/base
    * @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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `predicate`.
    * @returns {Array} Returns the new filtered array.
    * @example
@@ -30,13 +33,17 @@ define(['../internal/arrayFilter', '../internal/baseCallback', '../internal/base
    *   { 'user': 'fred',   'age': 40, 'active': true }
    * ];
    *
-   * // using the "_.property" callback shorthand
-   * _.pluck(_.reject(users, 'active'), 'user');
+   * // using the `_.matches` callback shorthand
+   * _.pluck(_.reject(users, { 'age': 40, 'active': true }), 'user');
    * // => ['barney']
    *
-   * // using the "_.matches" callback shorthand
-   * _.pluck(_.reject(users, { 'age': 36 }), 'user');
+   * // using the `_.matchesProperty` callback shorthand
+   * _.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/some.js

@@ -6,10 +6,14 @@ define(['../internal/arraySome', '../internal/baseCallback', '../internal/baseSo
    * 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`.
    *
@@ -19,8 +23,7 @@ define(['../internal/arraySome', '../internal/baseCallback', '../internal/baseSo
    * @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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `predicate`.
    * @returns {boolean} Returns `true` if any element passes the predicate check,
    *  else `false`.
@@ -30,17 +33,21 @@ define(['../internal/arraySome', '../internal/baseCallback', '../internal/baseSo
    * // => true
    *
    * var users = [
-   *   { 'user': 'barney', 'age': 36, 'active': false },
-   *   { 'user': 'fred',   'age': 40, 'active': true }
+   *   { 'user': 'barney', 'active': true },
+   *   { 'user': 'fred',   'active': false }
    * ];
    *
-   * // using the "_.property" callback shorthand
-   * _.some(users, 'active');
+   * // using the `_.matches` callback shorthand
+   * _.some(users, { user': 'barney', 'active': false });
+   * // => false
+   *
+   * // using the `_.matchesProperty` callback shorthand
+   * _.some(users, 'active', false);
    * // => true
    *
-   * // using the "_.matches" callback shorthand
-   * _.some(users, { 'age': 1 });
-   * // => false
+   * // using the `_.property` callback shorthand
+   * _.some(users, 'active');
+   * // => true
    */
   function some(collection, predicate, thisArg) {
     var func = isArray(collection) ? arraySome : baseSome;

collection/sortBy.js

@@ -7,10 +7,14 @@ define(['../internal/baseCallback', '../internal/baseEach', '../internal/baseSor
    * 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`.
    *
@@ -20,7 +24,7 @@ define(['../internal/baseCallback', '../internal/baseEach', '../internal/baseSor
    * @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
@@ -37,7 +41,7 @@ define(['../internal/baseCallback', '../internal/baseEach', '../internal/baseSor
    *   { 'user': 'barney' }
    * ];
    *
-   * // using the "_.property" callback shorthand
+   * // using the `_.property` callback shorthand
    * _.pluck(_.sortBy(users, 'user'), 'user');
    * // => ['barney', 'fred', 'pebbles']
    */

collection/sortByAll.js

@@ -36,7 +36,7 @@ define(['../internal/baseEach', '../internal/baseFlatten', '../internal/baseSort
         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,10 +1,15 @@
-define(['./filter', '../utility/matches'], function(filter, matches) {
+define(['../internal/baseMatches', './filter'], function(baseMatches, 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
@@ -14,21 +19,18 @@ define(['./filter', '../utility/matches'], function(filter, matches) {
    * @example
    *
    * var users = [
-   *   { 'user': 'barney', 'age': 36, 'status': 'busy', 'pets': ['hoppy'] },
-   *   { 'user': 'fred',   'age': 40, 'status': 'busy', 'pets': ['baby puss', 'dino'] }
+   *   { 'user': 'barney', 'age': 36, 'active': false, 'pets': ['hoppy'] },
+   *   { '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));
   }
 
   return where;

function.js

@@ -1,4 +1,4 @@
-define(['./function/after', './function/ary', './function/backflow', './function/before', './function/bind', './function/bindAll', './function/bindKey', './function/compose', './function/curry', './function/curryRight', './function/debounce', './function/defer', './function/delay', './function/flow', './function/flowRight', './function/memoize', './function/negate', './function/once', './function/partial', './function/partialRight', './function/rearg', './function/throttle', './function/wrap'], function(after, ary, backflow, before, bind, bindAll, bindKey, compose, curry, curryRight, debounce, defer, delay, flow, flowRight, memoize, negate, once, partial, partialRight, rearg, throttle, wrap) {
+define(['./function/after', './function/ary', './function/backflow', './function/before', './function/bind', './function/bindAll', './function/bindKey', './function/compose', './function/curry', './function/curryRight', './function/debounce', './function/defer', './function/delay', './function/flow', './function/flowRight', './function/memoize', './function/negate', './function/once', './function/partial', './function/partialRight', './function/rearg', './function/spread', './function/throttle', './function/wrap'], function(after, ary, backflow, before, bind, bindAll, bindKey, compose, curry, curryRight, debounce, defer, delay, flow, flowRight, memoize, negate, once, partial, partialRight, rearg, spread, throttle, wrap) {
   return {
     'after': after,
     'ary': ary,
@@ -21,6 +21,7 @@ define(['./function/after', './function/ary', './function/backflow', './function
     'partial': partial,
     'partialRight': partialRight,
     'rearg': rearg,
+    'spread': spread,
     'throttle': throttle,
     'wrap': wrap
   };

function/after.js

@@ -1,4 +1,4 @@
-define(['../lang/isFunction', '../internal/root'], function(isFunction, root) {
+define(['../internal/root'], function(root) {
 
   /** Used as the `TypeError` message for "Functions" methods. */
   var FUNC_ERROR_TEXT = 'Expected a function';
@@ -30,8 +30,8 @@ define(['../lang/isFunction', '../internal/root'], function(isFunction, root) {
    * // => logs 'done saving!' after the two async saves have completed
    */
   function after(n, func) {
-    if (!isFunction(func)) {
-      if (isFunction(n)) {
+    if (typeof func != 'function') {
+      if (typeof n == 'function') {
         var temp = n;
         n = func;
         func = temp;

function/before.js

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

function/debounce.js

@@ -1,4 +1,4 @@
-define(['../lang/isFunction', '../lang/isObject', '../date/now'], function(isFunction, isObject, now) {
+define(['../lang/isObject', '../date/now'], function(isObject, now) {
 
   /** Used as a safe reference for `undefined` in pre-ES5 environments. */
   var undefined;
@@ -83,7 +83,7 @@ define(['../lang/isFunction', '../lang/isObject', '../date/now'], function(isFun
         maxWait = false,
         trailing = true;
 
-    if (!isFunction(func)) {
+    if (typeof func != 'function') {
       throw new TypeError(FUNC_ERROR_TEXT);
     }
     wait = wait < 0 ? 0 : wait;

function/flow.js

@@ -32,7 +32,7 @@ define(['../internal/arrayEvery', '../lang/isFunction'], function(arrayEvery, is
         length = funcs.length;
 
     if (!length) {
-      return function() {};
+      return function() { return arguments[0]; };
     }
     if (!arrayEvery(funcs, isFunction)) {
       throw new TypeError(FUNC_ERROR_TEXT);

function/flowRight.js

@@ -32,7 +32,7 @@ define(['../internal/arrayEvery', '../lang/isFunction'], function(arrayEvery, is
         fromIndex = funcs.length - 1;
 
     if (fromIndex < 0) {
-      return function() {};
+      return function() { return arguments[0]; };
     }
     if (!arrayEvery(funcs, isFunction)) {
       throw new TypeError(FUNC_ERROR_TEXT);

function/memoize.js

@@ -1,4 +1,4 @@
-define(['../internal/MapCache', '../lang/isFunction'], function(MapCache, isFunction) {
+define(['../internal/MapCache'], function(MapCache) {
 
   /** Used as the `TypeError` message for "Functions" methods. */
   var FUNC_ERROR_TEXT = 'Expected a function';
@@ -57,7 +57,7 @@ define(['../internal/MapCache', '../lang/isFunction'], function(MapCache, isFunc
    * // => { '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,4 +1,4 @@
-define(['../lang/isFunction'], function(isFunction) {
+define([], function() {
 
   /** Used as the `TypeError` message for "Functions" methods. */
   var FUNC_ERROR_TEXT = 'Expected a function';
@@ -23,7 +23,7 @@ define(['../lang/isFunction'], function(isFunction) {
    * // => [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 @@ define(['./before'], function(before) {
    *
    * @static
    * @memberOf _
-   * @type Function
    * @category Function
    * @param {Function} func The function to restrict.
    * @returns {Function} Returns the new restricted function.

function/spread.js

@@ -0,0 +1,46 @@
+define([], function() {
+
+  /** 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);
+    };
+  }
+
+  return spread;
+});

function/throttle.js

@@ -1,4 +1,4 @@
-define(['./debounce', '../lang/isFunction', '../lang/isObject'], function(debounce, isFunction, isObject) {
+define(['./debounce', '../lang/isObject'], function(debounce, isObject) {
 
   /** Used as the `TypeError` message for "Functions" methods. */
   var FUNC_ERROR_TEXT = 'Expected a function';
@@ -52,7 +52,7 @@ define(['./debounce', '../lang/isFunction', '../lang/isObject'], function(deboun
     var leading = true,
         trailing = true;
 
-    if (!isFunction(func)) {
+    if (typeof func != 'function') {
       throw new TypeError(FUNC_ERROR_TEXT);
     }
     if (options === false) {

internal/LazyWrapper.js

@@ -10,14 +10,14 @@ define([], function() {
    * @param {*} value The value to wrap.
    */
   function LazyWrapper(value) {
-    this.actions = null;
-    this.dir = 1;
-    this.dropCount = 0;
-    this.filtered = false;
-    this.iteratees = null;
-    this.takeCount = POSITIVE_INFINITY;
-    this.views = null;
-    this.wrapped = value;
+    this.__wrapped__ = value;
+    this.__actions__ = null;
+    this.__dir__ = 1;
+    this.__dropCount__ = 0;
+    this.__filtered__ = false;
+    this.__iteratees__ = null;
+    this.__takeCount__ = POSITIVE_INFINITY;
+    this.__views__ = null;
   }
 
   return LazyWrapper;

internal/LodashWrapper.js

@@ -9,9 +9,9 @@ define([], function() {
    * @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;
   }
 
   return LodashWrapper;

internal/baseAssign.js

@@ -16,7 +16,7 @@ define(['./baseCopy', '../object/keys'], function(baseCopy, keys) {
       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,4 @@
-define(['./baseMatches', './baseProperty', './bindCallback', '../utility/identity', './isBindable'], function(baseMatches, baseProperty, bindCallback, identity, isBindable) {
+define(['./baseMatches', './baseMatchesProperty', './baseProperty', './bindCallback', '../utility/identity', './isBindable'], function(baseMatches, baseMatchesProperty, baseProperty, bindCallback, identity, isBindable) {
 
   /**
    * The base implementation of `_.callback` which supports specifying the
@@ -20,10 +20,12 @@ define(['./baseMatches', './baseProperty', './bindCallback', '../utility/identit
     if (func == null) {
       return identity;
     }
-    // Handle "_.property" and "_.matches" style callback shorthands.
-    return type == 'object'
-      ? baseMatches(func, !argCount)
-      : baseProperty(func + '');
+    if (type == 'object') {
+      return baseMatches(func);
+    }
+    return typeof thisArg == 'undefined'
+      ? baseProperty(func + '')
+      : baseMatchesProperty(func + '', thisArg);
   }
 
   return baseCallback;

internal/baseDelay.js

@@ -1,4 +1,4 @@
-define(['./baseSlice', '../lang/isFunction'], function(baseSlice, isFunction) {
+define(['./baseSlice'], function(baseSlice) {
 
   /** Used as a safe reference for `undefined` in pre-ES5 environments. */
   var undefined;
@@ -17,7 +17,7 @@ define(['./baseSlice', '../lang/isFunction'], function(baseSlice, isFunction) {
    * @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/baseFill.js

@@ -0,0 +1,34 @@
+define([], function() {
+
+  /**
+   * 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;
+  }
+
+  return baseFill;
+});

internal/baseIsMatch.js

@@ -14,7 +14,7 @@ define(['./baseIsEqual'], function(baseIsEqual) {
    * 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/baseMatches.js

@@ -1,4 +1,4 @@
-define(['./baseClone', './baseIsMatch', './isStrictComparable', '../object/keys'], function(baseClone, baseIsMatch, isStrictComparable, keys) {
+define(['./baseIsMatch', './isStrictComparable', '../object/keys'], function(baseIsMatch, isStrictComparable, keys) {
 
   /** Used for native method references. */
   var objectProto = Object.prototype;
@@ -7,15 +7,13 @@ define(['./baseClone', './baseIsMatch', './isStrictComparable', '../object/keys'
   var hasOwnProperty = objectProto.hasOwnProperty;
 
   /**
-   * The base implementation of `_.matches` which supports specifying whether
-   * `source` should be cloned.
+   * The base implementation of `_.matches` which does not clone `source`.
    *
    * @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;
 
@@ -25,13 +23,10 @@ define(['./baseClone', './baseIsMatch', './isStrictComparable', '../object/keys'
 
       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 @@
+define(['./baseIsEqual', './isStrictComparable'], function(baseIsEqual, 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);
+    };
+  }
+
+  return baseMatchesProperty;
+});

internal/baseReduce.js

@@ -18,7 +18,7 @@ define([], function() {
     eachFunc(collection, function(value, index, collection) {
       accumulator = initFromCollection
         ? (initFromCollection = false, value)
-        : iteratee(accumulator, value, index, collection)
+        : iteratee(accumulator, value, index, collection);
     });
     return accumulator;
   }

internal/createAggregator.js

@@ -3,8 +3,7 @@ define(['./baseCallback', './baseEach', '../lang/isArray'], function(baseCallbac
   /**
    * 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
-   * object. If `initializer` is provided initializes the accumulator object.
+   * through an iteratee.
    *
    * @private
    * @param {Function} setter The function to set keys and values of the accumulator object.

internal/createWrapper.js

@@ -1,4 +1,7 @@
-define(['./baseSetData', './createBindWrapper', './createHybridWrapper', './createPartialWrapper', './getData', '../lang/isFunction', './mergeData', './setData'], function(baseSetData, createBindWrapper, createHybridWrapper, createPartialWrapper, getData, isFunction, mergeData, setData) {
+define(['./baseSetData', './createBindWrapper', './createHybridWrapper', './createPartialWrapper', './getData', './mergeData', './setData'], function(baseSetData, createBindWrapper, createHybridWrapper, createPartialWrapper, getData, mergeData, setData) {
+
+  /** Used as a safe reference for `undefined` in pre-ES5 environments. */
+  var undefined;
 
   /** Used to compose bitmasks for wrapper metadata. */
   var BIND_FLAG = 1,
@@ -39,7 +42,7 @@ define(['./baseSetData', './createBindWrapper', './createHybridWrapper', './crea
    */
   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;
@@ -69,9 +72,9 @@ define(['./baseSetData', './createBindWrapper', './createHybridWrapper', './crea
     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);

internal/isIndex.js

@@ -2,7 +2,7 @@ define([], function() {
 
   /**
    * Used as the maximum length of an array-like value.
-   * See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-tolength)
+   * See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-number.max_safe_integer)
    * for more details.
    */
   var MAX_SAFE_INTEGER = Math.pow(2, 53) - 1;

internal/isIterateeCall.js

@@ -18,7 +18,7 @@ define(['./isIndex', './isLength', '../lang/isObject'], function(isIndex, isLeng
       var length = object.length,
           prereq = isLength(length) && isIndex(index, length);
     } else {
-      prereq = type == 'string' && index in value;
+      prereq = type == 'string' && index in object;
     }
     return prereq && object[index] === value;
   }

internal/isLength.js

@@ -2,7 +2,7 @@ define([], function() {
 
   /**
    * Used as the maximum length of an array-like value.
-   * See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-tolength)
+   * See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-number.max_safe_integer)
    * for more details.
    */
   var MAX_SAFE_INTEGER = Math.pow(2, 53) - 1;
@@ -10,6 +10,10 @@ define([], function() {
   /**
    * Checks if `value` is a valid array-like length.
    *
+   * **Note:** This function is based on ES `ToLength`. See the
+   * [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-tolength)
+   * for more details.
+   *
    * @private
    * @param {*} value The value to check.
    * @returns {boolean} Returns `true` if `value` is a valid length, else `false`.

internal/lazyClone.js

@@ -9,18 +9,18 @@ define(['./LazyWrapper', './arrayCopy'], function(LazyWrapper, arrayCopy) {
    * @returns {Object} Returns the cloned `LazyWrapper` object.
    */
   function lazyClone() {
-    var actions = this.actions,
-        iteratees = this.iteratees,
-        views = this.views,
-        result = new LazyWrapper(this.wrapped);
+    var actions = this.__actions__,
+        iteratees = this.__iteratees__,
+        views = this.__views__,
+        result = new LazyWrapper(this.__wrapped__);
 
-    result.actions = actions ? arrayCopy(actions) : null;
-    result.dir = this.dir;
-    result.dropCount = this.dropCount;
-    result.filtered = this.filtered;
-    result.iteratees = iteratees ? arrayCopy(iteratees) : null;
-    result.takeCount = this.takeCount;
-    result.views = views ? arrayCopy(views) : null;
+    result.__actions__ = actions ? arrayCopy(actions) : null;
+    result.__dir__ = this.__dir__;
+    result.__dropCount__ = this.__dropCount__;
+    result.__filtered__ = this.__filtered__;
+    result.__iteratees__ = iteratees ? arrayCopy(iteratees) : null;
+    result.__takeCount__ = this.__takeCount__;
+    result.__views__ = views ? arrayCopy(views) : null;
     return result;
   }
 

internal/lazyReverse.js

@@ -9,13 +9,13 @@ define(['./LazyWrapper'], function(LazyWrapper) {
    * @returns {Object} Returns the new reversed `LazyWrapper` object.
    */
   function lazyReverse() {
-    if (this.filtered) {
+    if (this.__filtered__) {
       var result = new LazyWrapper(this);
-      result.dir = -1;
-      result.filtered = true;
+      result.__dir__ = -1;
+      result.__filtered__ = true;
     } else {
       result = this.clone();
-      result.dir *= -1;
+      result.__dir__ *= -1;
     }
     return result;
   }

internal/lazyValue.js

@@ -16,20 +16,20 @@ define(['./baseWrapperValue', './getView', '../lang/isArray'], function(baseWrap
    * @returns {*} Returns the unwrapped value.
    */
   function lazyValue() {
-    var array = this.wrapped.value();
+    var array = this.__wrapped__.value();
     if (!isArray(array)) {
-      return baseWrapperValue(array, this.actions);
+      return baseWrapperValue(array, this.__actions__);
     }
-    var dir = this.dir,
+    var dir = this.__dir__,
         isRight = dir < 0,
-        view = getView(0, array.length, this.views),
+        view = getView(0, array.length, this.__views__),
         start = view.start,
         end = view.end,
         length = end - start,
-        dropCount = this.dropCount,
-        takeCount = nativeMin(length, this.takeCount - dropCount),
+        dropCount = this.__dropCount__,
+        takeCount = nativeMin(length, this.__takeCount__),
         index = isRight ? end : start - 1,
-        iteratees = this.iteratees,
+        iteratees = this.__iteratees__,
         iterLength = iteratees ? iteratees.length : 0,
         resIndex = 0,
         result = [];

internal/wrapperClone.js

@@ -0,0 +1,17 @@
+define(['./LazyWrapper', './LodashWrapper', './arrayCopy'], function(LazyWrapper, LodashWrapper, arrayCopy) {
+
+  /**
+   * Creates a clone of `wrapper`.
+   *
+   * @private
+   * @param {Object} wrapper The wrapper to clone.
+   * @returns {Object} Returns the cloned wrapper.
+   */
+  function wrapperClone(wrapper) {
+    return wrapper instanceof LazyWrapper
+      ? wrapper.clone()
+      : new LodashWrapper(wrapper.__wrapped__, wrapper.__chain__, arrayCopy(wrapper.__actions__));
+  }
+
+  return wrapperClone;
+});

lang/isEqual.js

@@ -11,7 +11,8 @@ define(['../internal/baseIsEqual', '../internal/bindCallback', '../internal/isSt
    * arguments; (value, other [, index|key]).
    *
    * **Note:** This method supports comparing arrays, booleans, `Date` objects,
-   * numbers, `Object` objects, regexes, and strings. Functions and DOM nodes
+   * numbers, `Object` objects, regexes, and strings. Objects are compared by
+   * their own, not inherited, enumerable properties. Functions and DOM nodes
    * are **not** supported. Provide a customizer function to extend support
    * for comparing other values.
    *

lang/isMatch.js

@@ -21,7 +21,7 @@ define(['../internal/baseIsMatch', '../internal/bindCallback', '../internal/isSt
    * @static
    * @memberOf _
    * @category Lang
-   * @param {Object} source The object to inspect.
+   * @param {Object} object The object to inspect.
    * @param {Object} source The object of property values to match.
    * @param {Function} [customizer] The function to customize comparing values.
    * @param {*} [thisArg] The `this` binding of `customizer`.

object/findKey.js

@@ -4,10 +4,14 @@ define(['../internal/baseCallback', '../internal/baseFind', '../internal/baseFor
    * This method is like `_.findIndex` except that it returns the key 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,8 +20,7 @@ define(['../internal/baseCallback', '../internal/baseFind', '../internal/baseFor
    * @category Object
    * @param {Object} object The object 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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `predicate`.
    * @returns {string|undefined} Returns the key of the matched element, else `undefined`.
    * @example
@@ -31,11 +34,15 @@ define(['../internal/baseCallback', '../internal/baseFind', '../internal/baseFor
    * _.findKey(users, function(chr) { return chr.age < 40; });
    * // => 'barney' (iteration order is not guaranteed)
    *
-   * // using the "_.matches" callback shorthand
-   * _.findKey(users, { 'age': 1 });
+   * // using the `_.matches` callback shorthand
+   * _.findKey(users, { 'age': 1, 'active': true });
    * // => 'pebbles'
    *
-   * // using the "_.property" callback shorthand
+   * // using the `_.matchesProperty` callback shorthand
+   * _.findKey(users, 'active', false);
+   * // => 'fred'
+   *
+   * // using the `_.property` callback shorthand
    * _.findKey(users, 'active');
    * // => 'barney'
    */

object/findLastKey.js

@@ -4,10 +4,14 @@ define(['../internal/baseCallback', '../internal/baseFind', '../internal/baseFor
    * This method is like `_.findKey` except that it iterates over elements of
    * a collection in the opposite order.
    *
-   * 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,8 +20,7 @@ define(['../internal/baseCallback', '../internal/baseFind', '../internal/baseFor
    * @category Object
    * @param {Object} object The object 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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `predicate`.
    * @returns {string|undefined} Returns the key of the matched element, else `undefined`.
    * @example
@@ -31,11 +34,15 @@ define(['../internal/baseCallback', '../internal/baseFind', '../internal/baseFor
    * _.findLastKey(users, function(chr) { return chr.age < 40; });
    * // => returns `pebbles` assuming `_.findKey` returns `barney`
    *
-   * // using the "_.matches" callback shorthand
-   * _.findLastKey(users, { 'age': 36 });
+   * // using the `_.matches` callback shorthand
+   * _.findLastKey(users, { 'age': 36, 'active': true });
    * // => 'barney'
    *
-   * // using the "_.property" callback shorthand
+   * // using the `_.matchesProperty` callback shorthand
+   * _.findLastKey(users, 'active', false);
+   * // => 'fred'
+   *
+   * // using the `_.property` callback shorthand
    * _.findLastKey(users, 'active');
    * // => 'pebbles'
    */

object/keysIn.js

@@ -41,7 +41,7 @@ define(['../lang/isArguments', '../lang/isArray', '../internal/isIndex', '../int
 
     var Ctor = object.constructor,
         index = -1,
-        isProto = typeof Ctor == 'function' && Ctor.prototype == object,
+        isProto = typeof Ctor == 'function' && Ctor.prototype === object,
         result = Array(length),
         skipIndexes = length > 0;
 

object/mapValues.js

@@ -6,10 +6,14 @@ define(['../internal/baseCallback', '../internal/baseForOwn'], function(baseCall
    * iteratee function is bound to `thisArg` and invoked with three arguments;
    * (value, key, object).
    *
-   * If a property name is provided for `iteratee` the created "_.property"
+   * If a property name is provided for `iteratee` the created `_.property`
    * style callback returns the property value of the given element.
    *
-   * If an object is provided for `iteratee` 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 `iteratee` the created `_.matches` style
    * callback returns `true` for elements that have the properties of the given
    * object, else `false`.
    *
@@ -18,8 +22,7 @@ define(['../internal/baseCallback', '../internal/baseForOwn'], function(baseCall
    * @category Object
    * @param {Object} object The object 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
-   *  create a "_.property" or "_.matches" style callback respectively.
+   *  per iteration.
    * @param {*} [thisArg] The `this` binding of `iteratee`.
    * @returns {Object} Returns the new mapped object.
    * @example
@@ -32,7 +35,7 @@ define(['../internal/baseCallback', '../internal/baseForOwn'], function(baseCall
    *   'pebbles': { 'user': 'pebbles', 'age': 1 }
    * };
    *
-   * // using the "_.property" callback shorthand
+   * // using the `_.property` callback shorthand
    * _.mapValues(users, 'age');
    * // => { 'fred': 40, 'pebbles': 1 } (iteration order is not guaranteed)
    */

object/transform.js

@@ -1,4 +1,4 @@
-define(['../internal/arrayEach', '../internal/baseCallback', '../internal/baseCreate', '../internal/baseForOwn', '../lang/isArray', '../lang/isObject', '../lang/isTypedArray'], function(arrayEach, baseCallback, baseCreate, baseForOwn, isArray, isObject, isTypedArray) {
+define(['../internal/arrayEach', '../internal/baseCallback', '../internal/baseCreate', '../internal/baseForOwn', '../lang/isArray', '../lang/isFunction', '../lang/isObject', '../lang/isTypedArray'], function(arrayEach, baseCallback, baseCreate, baseForOwn, isArray, isFunction, isObject, isTypedArray) {
 
   /**
    * An alternative to `_.reduce`; this method transforms `object` to a new
@@ -41,7 +41,7 @@ define(['../internal/arrayEach', '../internal/baseCallback', '../internal/baseCr
         if (isArr) {
           accumulator = isArray(object) ? new Ctor : [];
         } else {
-          accumulator = baseCreate(typeof Ctor == 'function' && Ctor.prototype);
+          accumulator = baseCreate(isFunction(Ctor) && Ctor.prototype);
         }
       } else {
         accumulator = {};

package.json

@@ -1,6 +1,6 @@
 {
   "name": "lodash",
-  "version": "3.0.1",
+  "version": "3.2.0",
   "main": "main.js",
   "private": true,
   "volo": {

string.js

@@ -1,4 +1,4 @@
-define(['./string/camelCase', './string/capitalize', './string/deburr', './string/endsWith', './string/escape', './string/escapeRegExp', './string/kebabCase', './string/pad', './string/padLeft', './string/padRight', './string/parseInt', './string/repeat', './string/snakeCase', './string/startsWith', './string/template', './string/templateSettings', './string/trim', './string/trimLeft', './string/trimRight', './string/trunc', './string/unescape', './string/words'], function(camelCase, capitalize, deburr, endsWith, escape, escapeRegExp, kebabCase, pad, padLeft, padRight, parseInt, repeat, snakeCase, startsWith, template, templateSettings, trim, trimLeft, trimRight, trunc, unescape, words) {
+define(['./string/camelCase', './string/capitalize', './string/deburr', './string/endsWith', './string/escape', './string/escapeRegExp', './string/kebabCase', './string/pad', './string/padLeft', './string/padRight', './string/parseInt', './string/repeat', './string/snakeCase', './string/startCase', './string/startsWith', './string/template', './string/templateSettings', './string/trim', './string/trimLeft', './string/trimRight', './string/trunc', './string/unescape', './string/words'], function(camelCase, capitalize, deburr, endsWith, escape, escapeRegExp, kebabCase, pad, padLeft, padRight, parseInt, repeat, snakeCase, startCase, startsWith, template, templateSettings, trim, trimLeft, trimRight, trunc, unescape, words) {
   return {
     'camelCase': camelCase,
     'capitalize': capitalize,
@@ -13,6 +13,7 @@ define(['./string/camelCase', './string/capitalize', './string/deburr', './strin
     'parseInt': parseInt,
     'repeat': repeat,
     'snakeCase': snakeCase,
+    'startCase': startCase,
     'startsWith': startsWith,
     'template': template,
     'templateSettings': templateSettings,

string/camelCase.js

@@ -22,7 +22,7 @@ define(['../internal/createCompounder'], function(createCompounder) {
    */
   var camelCase = createCompounder(function(result, word, index) {
     word = word.toLowerCase();
-    return index ? (result + word.charAt(0).toUpperCase() + word.slice(1)) : word;
+    return result + (index ? (word.charAt(0).toUpperCase() + word.slice(1)) : word);
   });
 
   return camelCase;

string/snakeCase.js

@@ -14,10 +14,10 @@ define(['../internal/createCompounder'], function(createCompounder) {
    * _.snakeCase('Foo Bar');
    * // => 'foo_bar'
    *
-   * _.snakeCase('--foo-bar');
+   * _.snakeCase('fooBar');
    * // => 'foo_bar'
    *
-   * _.snakeCase('fooBar');
+   * _.snakeCase('--foo-bar');
    * // => 'foo_bar'
    */
   var snakeCase = createCompounder(function(result, word, index) {

string/startCase.js

@@ -0,0 +1,29 @@
+define(['../internal/createCompounder'], function(createCompounder) {
+
+  /**
+   * Converts `string` to start case.
+   * See [Wikipedia](https://en.wikipedia.org/wiki/Letter_case#Stylistic_or_specialised_usage)
+   * for more details.
+   *
+   * @static
+   * @memberOf _
+   * @category String
+   * @param {string} [string=''] The string to convert.
+   * @returns {string} Returns the start cased string.
+   * @example
+   *
+   * _.startCase('--foo-bar');
+   * // => 'Foo Bar'
+   *
+   * _.startCase('fooBar');
+   * // => 'Foo Bar'
+   *
+   * _.startCase('__foo_bar__');
+   * // => 'Foo Bar'
+   */
+  var startCase = createCompounder(function(result, word, index) {
+    return result + (index ? ' ' : '') + (word.charAt(0).toUpperCase() + word.slice(1));
+  });
+
+  return startCase;
+});

string/trim.js

@@ -30,7 +30,7 @@ define(['../internal/baseToString', '../internal/charsLeftIndex', '../internal/c
     if (guard ? isIterateeCall(value, chars, guard) : chars == null) {
       return string.slice(trimmedLeftIndex(string), trimmedRightIndex(string) + 1);
     }
-    chars = baseToString(chars);
+    chars = (chars + '');
     return string.slice(charsLeftIndex(string, chars), charsRightIndex(string, chars) + 1);
   }
 

string/trimLeft.js

@@ -25,9 +25,9 @@ define(['../internal/baseToString', '../internal/charsLeftIndex', '../internal/i
       return string;
     }
     if (guard ? isIterateeCall(value, chars, guard) : chars == null) {
-      return string.slice(trimmedLeftIndex(string))
+      return string.slice(trimmedLeftIndex(string));
     }
-    return string.slice(charsLeftIndex(string, baseToString(chars)));
+    return string.slice(charsLeftIndex(string, (chars + '')));
   }
 
   return trimLeft;

string/trimRight.js

@@ -25,9 +25,9 @@ define(['../internal/baseToString', '../internal/charsRightIndex', '../internal/
       return string;
     }
     if (guard ? isIterateeCall(value, chars, guard) : chars == null) {
-      return string.slice(0, trimmedRightIndex(string) + 1)
+      return string.slice(0, trimmedRightIndex(string) + 1);
     }
-    return string.slice(0, charsRightIndex(string, baseToString(chars)) + 1);
+    return string.slice(0, charsRightIndex(string, (chars + '')) + 1);
   }
 
   return trimRight;

utility.js

@@ -1,4 +1,4 @@
-define(['./utility/attempt', './utility/callback', './utility/constant', './utility/identity', './utility/iteratee', './utility/matches', './utility/mixin', './utility/noop', './utility/property', './utility/propertyOf', './utility/range', './utility/times', './utility/uniqueId'], function(attempt, callback, constant, identity, iteratee, matches, mixin, noop, property, propertyOf, range, times, uniqueId) {
+define(['./utility/attempt', './utility/callback', './utility/constant', './utility/identity', './utility/iteratee', './utility/matches', './utility/matchesProperty', './utility/mixin', './utility/noop', './utility/property', './utility/propertyOf', './utility/range', './utility/times', './utility/uniqueId'], function(attempt, callback, constant, identity, iteratee, matches, matchesProperty, mixin, noop, property, propertyOf, range, times, uniqueId) {
   return {
     'attempt': attempt,
     'callback': callback,
@@ -6,6 +6,7 @@ define(['./utility/attempt', './utility/callback', './utility/constant', './util
     'identity': identity,
     'iteratee': iteratee,
     'matches': matches,
+    'matchesProperty': matchesProperty,
     'mixin': mixin,
     'noop': noop,
     'property': property,

utility/attempt.js

@@ -1,8 +1,11 @@
-define(['../lang/isError'], function(isError) {
+define(['../internal/baseSlice', '../lang/isError'], function(baseSlice, isError) {
+
+  /** Used as a safe reference for `undefined` in pre-ES5 environments. */
+  var undefined;
 
   /**
-   * Attempts to invoke `func`, returning either the result or the caught
-   * error object.
+   * Attempts to invoke `func`, returning either the result or the caught error
+   * object. Any additional arguments are provided to `func` when it is invoked.
    *
    * @static
    * @memberOf _
@@ -12,9 +15,9 @@ define(['../lang/isError'], function(isError) {
    * @example
    *
    * // avoid throwing errors for invalid selectors
-   * var elements = _.attempt(function() {
+   * var elements = _.attempt(function(selector) {
    *   return document.querySelectorAll(selector);
-   * });
+   * }, '>_>');
    *
    * if (_.isError(elements)) {
    *   elements = [];
@@ -22,9 +25,9 @@ define(['../lang/isError'], function(isError) {
    */
   function attempt(func) {
     try {
-      return func();
+      return func.apply(undefined, baseSlice(arguments, 1));
     } catch(e) {
-      return isError(e) ? e : Error(e);
+      return isError(e) ? e : new Error(e);
     }
   }
 

utility/callback.js

@@ -1,10 +1,11 @@
-define(['../internal/baseCallback', '../internal/isIterateeCall'], function(baseCallback, isIterateeCall) {
+define(['../internal/baseCallback', '../internal/isIterateeCall', '../internal/isObjectLike', './matches'], function(baseCallback, isIterateeCall, isObjectLike, matches) {
 
   /**
-   * Creates a function bound to an optional `thisArg`. If `func` is a property
-   * name the created callback returns the property value for a given element.
-   * If `func` is an object the created callback returns `true` for elements
-   * that contain the equivalent object properties, otherwise it returns `false`.
+   * Creates a function that invokes `func` with the `this` binding of `thisArg`
+   * and arguments of the created function. If `func` is a property name the
+   * created callback returns the property value for a given element. If `func`
+   * is an object the created callback returns `true` for elements that contain
+   * the equivalent object properties, otherwise it returns `false`.
    *
    * @static
    * @memberOf _
@@ -39,7 +40,9 @@ define(['../internal/baseCallback', '../internal/isIterateeCall'], function(base
     if (guard && isIterateeCall(func, thisArg, guard)) {
       thisArg = null;
     }
-    return baseCallback(func, thisArg);
+    return isObjectLike(func)
+      ? matches(func)
+      : baseCallback(func, thisArg);
   }
 
   return callback;

utility/matches.js

@@ -1,10 +1,15 @@
-define(['../internal/baseMatches'], function(baseMatches) {
+define(['../internal/baseClone', '../internal/baseMatches'], function(baseClone, baseMatches) {
 
   /**
    * Creates a function which performs a deep comparison between a given object
    * and `source`, returning `true` if the given object has equivalent property
    * values, else `false`.
    *
+   * **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 Utility
@@ -13,20 +18,15 @@ define(['../internal/baseMatches'], function(baseMatches) {
    * @example
    *
    * var users = [
-   *   { 'user': 'fred',   'age': 40 },
-   *   { 'user': 'barney', 'age': 36 }
+   *   { 'user': 'barney', 'age': 36, 'active': true },
+   *   { 'user': 'fred',   'age': 40, 'active': false }
    * ];
    *
-   * var matchesAge = _.matches({ 'age': 36 });
-   *
-   * _.filter(users, matchesAge);
-   * // => [{ 'user': 'barney', 'age': 36 }]
-   *
-   * _.find(users, matchesAge);
-   * // => { 'user': 'barney', 'age': 36 }
+   * _.filter(users, _.matches({ 'age': 40, 'active': false }));
+   * // => [{ 'user': 'fred', 'age': 40, 'active': false }]
    */
   function matches(source) {
-    return baseMatches(source, true);
+    return baseMatches(baseClone(source, true));
   }
 
   return matches;

utility/matchesProperty.js

@@ -0,0 +1,33 @@
+define(['../internal/baseClone', '../internal/baseMatchesProperty'], function(baseClone, baseMatchesProperty) {
+
+  /**
+   * Creates a function which compares the property value of `key` on a given
+   * object to `value`.
+   *
+   * **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.
+   *
+   * @static
+   * @memberOf _
+   * @category Utility
+   * @param {string} key The key of the property to get.
+   * @param {*} value The value to compare.
+   * @returns {Function} Returns the new function.
+   * @example
+   *
+   * var users = [
+   *   { 'user': 'barney' },
+   *   { 'user': 'fred' },
+   *   { 'user': 'pebbles' }
+   * ];
+   *
+   * _.find(users, _.matchesProperty('user', 'fred'));
+   * // => { 'user': 'fred', 'age': 40 }
+   */
+  function matchesProperty(key, value) {
+    return baseMatchesProperty(key + '', baseClone(value, true));
+  }
+
+  return matchesProperty;
+});

utility/mixin.js

@@ -28,6 +28,9 @@ define(['../internal/arrayCopy', '../internal/baseFunctions', '../lang/isFunctio
    *   });
    * }
    *
+   * // use `_.runInContext` to avoid potential conflicts (esp. in Node.js)
+   * var _ = require('lodash').runInContext();
+   *
    * _.mixin({ 'vowels': vowels });
    * _.vowels('fred');
    * // => ['e']