Bump to v3.2.0.

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 }]
    */