Bump to v4.11.2.

README.md

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

_baseDifference.js

@@ -47,6 +47,7 @@ function baseDifference(array, values, iteratee, comparator) {
     var value = array[index],
         computed = iteratee ? iteratee(value) : value;
 
+    value = (comparator || value !== 0) ? value : 0;
     if (isCommon && computed === computed) {
       var valuesIndex = valuesLength;
       while (valuesIndex--) {

_baseExtremum.js

@@ -1,3 +1,5 @@
+import isSymbol from './isSymbol';
+
 /**
  * The base implementation of methods like `_.max` and `_.min` which accepts a
  * `comparator` to determine the extremum value.
@@ -17,7 +19,7 @@ function baseExtremum(array, iteratee, comparator) {
         current = iteratee(value);
 
     if (current != null && (computed === undefined
-          ? current === current
+          ? (current === current && !isSymbol(current))
           : comparator(current, computed)
         )) {
       var computed = current,

_baseGet.js

@@ -1,5 +1,6 @@
 import castPath from './_castPath';
 import isKey from './_isKey';
+import toKey from './_toKey';
 
 /**
  * The base implementation of `_.get` without support for default values.
@@ -16,7 +17,7 @@ function baseGet(object, path) {
       length = path.length;
 
   while (object != null && index < length) {
-    object = object[path[index++]];
+    object = object[toKey(path[index++])];
   }
   return (index && index == length) ? object : undefined;
 }

_baseGt.js

@@ -0,0 +1,14 @@
+/**
+ * The base implementation of `_.gt` which doesn't coerce arguments to numbers.
+ *
+ * @private
+ * @param {*} value The value to compare.
+ * @param {*} other The other value to compare.
+ * @returns {boolean} Returns `true` if `value` is greater than `other`,
+ *  else `false`.
+ */
+function baseGt(value, other) {
+  return value > other;
+}
+
+export default baseGt;

_baseIntersection.js

@@ -47,6 +47,7 @@ function baseIntersection(arrays, iteratee, comparator) {
     var value = array[index],
         computed = iteratee ? iteratee(value) : value;
 
+    value = (comparator || value !== 0) ? value : 0;
     if (!(seen
           ? cacheHas(seen, computed)
           : includes(result, computed, comparator)

_baseInvoke.js

@@ -3,6 +3,7 @@ import castPath from './_castPath';
 import isKey from './_isKey';
 import last from './last';
 import parent from './_parent';
+import toKey from './_toKey';
 
 /**
  * The base implementation of `_.invoke` without support for individual
@@ -20,7 +21,7 @@ function baseInvoke(object, path, args) {
     object = parent(object, path);
     path = last(path);
   }
-  var func = object == null ? object : object[path];
+  var func = object == null ? object : object[toKey(path)];
   return func == null ? undefined : apply(func, object, args);
 }
 

_baseLt.js

@@ -0,0 +1,14 @@
+/**
+ * The base implementation of `_.lt` which doesn't coerce arguments to numbers.
+ *
+ * @private
+ * @param {*} value The value to compare.
+ * @param {*} other The other value to compare.
+ * @returns {boolean} Returns `true` if `value` is less than `other`,
+ *  else `false`.
+ */
+function baseLt(value, other) {
+  return value < other;
+}
+
+export default baseLt;

_baseMatchesProperty.js

@@ -4,6 +4,7 @@ import hasIn from './hasIn';
 import isKey from './_isKey';
 import isStrictComparable from './_isStrictComparable';
 import matchesStrictComparable from './_matchesStrictComparable';
+import toKey from './_toKey';
 
 /** Used to compose bitmasks for comparison styles. */
 var UNORDERED_COMPARE_FLAG = 1,
@@ -19,7 +20,7 @@ var UNORDERED_COMPARE_FLAG = 1,
  */
 function baseMatchesProperty(path, srcValue) {
   if (isKey(path) && isStrictComparable(srcValue)) {
-    return matchesStrictComparable(path, srcValue);
+    return matchesStrictComparable(toKey(path), srcValue);
   }
   return function(object) {
     var objValue = get(object, path);

_basePullAt.js

@@ -3,6 +3,7 @@ import isIndex from './_isIndex';
 import isKey from './_isKey';
 import last from './last';
 import parent from './_parent';
+import toKey from './_toKey';
 
 /** Used for built-in method references. */
 var arrayProto = Array.prototype;
@@ -25,7 +26,7 @@ function basePullAt(array, indexes) {
 
   while (length--) {
     var index = indexes[length];
-    if (lastIndex == length || index != previous) {
+    if (length == lastIndex || index !== previous) {
       var previous = index;
       if (isIndex(index)) {
         splice.call(array, index, 1);
@@ -35,11 +36,11 @@ function basePullAt(array, indexes) {
             object = parent(array, path);
 
         if (object != null) {
-          delete object[last(path)];
+          delete object[toKey(last(path))];
         }
       }
       else {
-        delete array[index];
+        delete array[toKey(index)];
       }
     }
   }

_baseSet.js

@@ -3,6 +3,7 @@ import castPath from './_castPath';
 import isIndex from './_isIndex';
 import isKey from './_isKey';
 import isObject from './isObject';
+import toKey from './_toKey';
 
 /**
  * The base implementation of `_.set`.
@@ -23,7 +24,7 @@ function baseSet(object, path, value, customizer) {
       nested = object;
 
   while (nested != null && ++index < length) {
-    var key = path[index];
+    var key = toKey(path[index]);
     if (isObject(nested)) {
       var newValue = value;
       if (index != lastIndex) {

_baseSortedIndex.js

@@ -1,5 +1,6 @@
 import baseSortedIndexBy from './_baseSortedIndexBy';
 import identity from './identity';
+import isSymbol from './isSymbol';
 
 /** Used as references for the maximum length and index of an array. */
 var MAX_ARRAY_LENGTH = 4294967295,
@@ -26,7 +27,8 @@ function baseSortedIndex(array, value, retHighest) {
       var mid = (low + high) >>> 1,
           computed = array[mid];
 
-      if ((retHighest ? (computed <= value) : (computed < value)) && computed !== null) {
+      if (computed !== null && !isSymbol(computed) &&
+          (retHighest ? (computed <= value) : (computed < value))) {
         low = mid + 1;
       } else {
         high = mid;

_baseSortedIndexBy.js

@@ -1,3 +1,5 @@
+import isSymbol from './isSymbol';
+
 /** Used as references for the maximum length and index of an array. */
 var MAX_ARRAY_LENGTH = 4294967295,
     MAX_ARRAY_INDEX = MAX_ARRAY_LENGTH - 1;
@@ -26,21 +28,26 @@ function baseSortedIndexBy(array, value, iteratee, retHighest) {
       high = array ? array.length : 0,
       valIsNaN = value !== value,
       valIsNull = value === null,
-      valIsUndef = value === undefined;
+      valIsSymbol = isSymbol(value),
+      valIsUndefined = value === undefined;
 
   while (low < high) {
     var mid = nativeFloor((low + high) / 2),
         computed = iteratee(array[mid]),
-        isDef = computed !== undefined,
-        isReflexive = computed === computed;
+        othIsDefined = computed !== undefined,
+        othIsNull = computed === null,
+        othIsReflexive = computed === computed,
+        othIsSymbol = isSymbol(computed);
 
     if (valIsNaN) {
-      var setLow = isReflexive || retHighest;
+      var setLow = retHighest || othIsReflexive;
+    } else if (valIsUndefined) {
+      setLow = othIsReflexive && (retHighest || othIsDefined);
     } else if (valIsNull) {
-      setLow = isReflexive && isDef && (retHighest || computed != null);
-    } else if (valIsUndef) {
-      setLow = isReflexive && (retHighest || isDef);
-    } else if (computed == null) {
+      setLow = othIsReflexive && othIsDefined && (retHighest || !othIsNull);
+    } else if (valIsSymbol) {
+      setLow = othIsReflexive && othIsDefined && !othIsNull && (retHighest || !othIsSymbol);
+    } else if (othIsNull || othIsSymbol) {
       setLow = false;
     } else {
       setLow = retHighest ? (computed <= value) : (computed < value);

_baseSortedUniq.js

@@ -1,14 +1,30 @@
-import baseSortedUniqBy from './_baseSortedUniqBy';
+import eq from './eq';
 
 /**
- * The base implementation of `_.sortedUniq`.
+ * The base implementation of `_.sortedUniq` and `_.sortedUniqBy` without
+ * support for iteratee shorthands.
  *
  * @private
  * @param {Array} array The array to inspect.
+ * @param {Function} [iteratee] The iteratee invoked per element.
  * @returns {Array} Returns the new duplicate free array.
  */
-function baseSortedUniq(array) {
-  return baseSortedUniqBy(array);
+function baseSortedUniq(array, iteratee) {
+  var index = -1,
+      length = array.length,
+      resIndex = 0,
+      result = [];
+
+  while (++index < length) {
+    var value = array[index],
+        computed = iteratee ? iteratee(value) : value;
+
+    if (!index || !eq(computed, seen)) {
+      var seen = computed;
+      result[resIndex++] = value === 0 ? 0 : value;
+    }
+  }
+  return result;
 }
 
 export default baseSortedUniq;

_baseSortedUniqBy.js

@@ -1,33 +0,0 @@
-import eq from './eq';
-
-/**
- * The base implementation of `_.sortedUniqBy` without support for iteratee
- * shorthands.
- *
- * @private
- * @param {Array} array The array to inspect.
- * @param {Function} [iteratee] The iteratee invoked per element.
- * @returns {Array} Returns the new duplicate free array.
- */
-function baseSortedUniqBy(array, iteratee) {
-  var index = 0,
-      length = array.length,
-      value = array[0],
-      computed = iteratee ? iteratee(value) : value,
-      seen = computed,
-      resIndex = 1,
-      result = [value];
-
-  while (++index < length) {
-    value = array[index],
-    computed = iteratee ? iteratee(value) : value;
-
-    if (!eq(computed, seen)) {
-      seen = computed;
-      result[resIndex++] = value;
-    }
-  }
-  return result;
-}
-
-export default baseSortedUniqBy;

_baseToNumber.js

@@ -0,0 +1,24 @@
+import isSymbol from './isSymbol';
+
+/** Used as references for various `Number` constants. */
+var NAN = 0 / 0;
+
+/**
+ * The base implementation of `_.toNumber` which doesn't ensure correct
+ * conversions of binary, hexadecimal, or octal string values.
+ *
+ * @private
+ * @param {*} value The value to process.
+ * @returns {number} Returns the number.
+ */
+function baseToNumber(value) {
+  if (typeof value == 'number') {
+    return value;
+  }
+  if (isSymbol(value)) {
+    return NAN;
+  }
+  return +value;
+}
+
+export default baseToNumber;

_baseToString.js

@@ -0,0 +1,31 @@
+import Symbol from './_Symbol';
+import isSymbol from './isSymbol';
+
+/** Used as references for various `Number` constants. */
+var INFINITY = 1 / 0;
+
+/** Used to convert symbols to primitives and strings. */
+var symbolProto = Symbol ? Symbol.prototype : undefined,
+    symbolToString = symbolProto ? symbolProto.toString : undefined;
+
+/**
+ * The base implementation of `_.toString` which doesn't convert nullish
+ * values to empty strings.
+ *
+ * @private
+ * @param {*} value The value to process.
+ * @returns {string} Returns the string.
+ */
+function baseToString(value) {
+  // Exit early for strings to avoid a performance hit in some environments.
+  if (typeof value == 'string') {
+    return value;
+  }
+  if (isSymbol(value)) {
+    return symbolToString ? symbolToString.call(value) : '';
+  }
+  var result = (value + '');
+  return (result == '0' && (1 / value) == -INFINITY) ? '-0' : result;
+}
+
+export default baseToString;

_baseUniq.js

@@ -46,6 +46,7 @@ function baseUniq(array, iteratee, comparator) {
     var value = array[index],
         computed = iteratee ? iteratee(value) : value;
 
+    value = (comparator || value !== 0) ? value : 0;
     if (isCommon && computed === computed) {
       var seenIndex = seen.length;
       while (seenIndex--) {

_baseUnset.js

@@ -1,8 +1,9 @@
+import baseHas from './_baseHas';
 import castPath from './_castPath';
-import has from './has';
 import isKey from './_isKey';
 import last from './last';
 import parent from './_parent';
+import toKey from './_toKey';
 
 /**
  * The base implementation of `_.unset`.
@@ -15,8 +16,9 @@ import parent from './_parent';
 function baseUnset(object, path) {
   path = isKey(path, object) ? [path] : castPath(path);
   object = parent(object, path);
-  var key = last(path);
-  return (object != null && has(object, key)) ? delete object[key] : true;
+
+  var key = toKey(last(path));
+  return !(object != null && baseHas(object, key)) || delete object[key];
 }
 
 export default baseUnset;

_compareAscending.js

@@ -1,3 +1,5 @@
+import isSymbol from './isSymbol';
+
 /**
  * Compares values to sort them in ascending order.
  *
@@ -8,22 +10,28 @@
  */
 function compareAscending(value, other) {
   if (value !== other) {
-    var valIsNull = value === null,
-        valIsUndef = value === undefined,
-        valIsReflexive = value === value;
+    var valIsDefined = value !== undefined,
+        valIsNull = value === null,
+        valIsReflexive = value === value,
+        valIsSymbol = isSymbol(value);
 
-    var othIsNull = other === null,
-        othIsUndef = other === undefined,
-        othIsReflexive = other === other;
+    var othIsDefined = other !== undefined,
+        othIsNull = other === null,
+        othIsReflexive = other === other,
+        othIsSymbol = isSymbol(other);
 
-    if ((value > other && !othIsNull) || !valIsReflexive ||
-        (valIsNull && !othIsUndef && othIsReflexive) ||
-        (valIsUndef && othIsReflexive)) {
+    if ((!othIsNull && !othIsSymbol && !valIsSymbol && value > other) ||
+        (valIsSymbol && othIsDefined && othIsReflexive && !othIsNull && !othIsSymbol) ||
+        (valIsNull && othIsDefined && othIsReflexive) ||
+        (!valIsDefined && othIsReflexive) ||
+        !valIsReflexive) {
       return 1;
     }
-    if ((value < other && !valIsNull) || !othIsReflexive ||
-        (othIsNull && !valIsUndef && valIsReflexive) ||
-        (othIsUndef && valIsReflexive)) {
+    if ((!valIsNull && !valIsSymbol && !othIsSymbol && value < other) ||
+        (othIsSymbol && valIsDefined && valIsReflexive && !valIsNull && !valIsSymbol) ||
+        (othIsNull && valIsDefined && valIsReflexive) ||
+        (!othIsDefined && valIsReflexive) ||
+        !othIsReflexive) {
       return -1;
     }
   }

_createMathOperation.js

@@ -1,3 +1,6 @@
+import baseToNumber from './_baseToNumber';
+import baseToString from './_baseToString';
+
 /**
  * Creates a function that performs a mathematical operation on two values.
  *
@@ -15,7 +18,17 @@ function createMathOperation(operator) {
       result = value;
     }
     if (other !== undefined) {
-      result = result === undefined ? other : operator(result, other);
+      if (result === undefined) {
+        return other;
+      }
+      if (typeof value == 'string' || typeof other == 'string') {
+        value = baseToString(value);
+        other = baseToString(other);
+      } else {
+        value = baseToNumber(value);
+        other = baseToNumber(other);
+      }
+      result = operator(value, other);
     }
     return result;
   };

_createPadding.js

@@ -1,4 +1,5 @@
 import baseRepeat from './_baseRepeat';
+import baseToString from './_baseToString';
 import castSlice from './_castSlice';
 import reHasComplexSymbol from './_reHasComplexSymbol';
 import stringSize from './_stringSize';
@@ -17,7 +18,7 @@ var nativeCeil = Math.ceil;
  * @returns {string} Returns the padding for `string`.
  */
 function createPadding(length, chars) {
-  chars = chars === undefined ? ' ' : (chars + '');
+  chars = chars === undefined ? ' ' : baseToString(chars);
 
   var charsLength = chars.length;
   if (charsLength < 2) {

_createRelationalOperation.js

@@ -0,0 +1,20 @@
+import toNumber from './toNumber';
+
+/**
+ * Creates a function that performs a relational operation on two values.
+ *
+ * @private
+ * @param {Function} operator The function to perform the operation.
+ * @returns {Function} Returns the new relational operation function.
+ */
+function createRelationalOperation(operator) {
+  return function(value, other) {
+    if (!(typeof value == 'string' && typeof other == 'string')) {
+      value = toNumber(value);
+      other = toNumber(other);
+    }
+    return operator(value, other);
+  };
+}
+
+export default createRelationalOperation;

_createSet.js

@@ -1,5 +1,9 @@
 import Set from './_Set';
 import noop from './noop';
+import setToArray from './_setToArray';
+
+/** Used as references for various `Number` constants. */
+var INFINITY = 1 / 0;
 
 /**
  * Creates a set of `values`.
@@ -8,7 +12,7 @@ import noop from './noop';
  * @param {Array} values The values to add to the set.
  * @returns {Object} Returns the new set.
  */
-var createSet = !(Set && new Set([1, 2]).size === 2) ? noop : function(values) {
+var createSet = !(Set && (1 / setToArray(new Set([,-0]))[1]) == INFINITY) ? noop : function(values) {
   return new Set(values);
 };
 

_hasPath.js

@@ -5,6 +5,7 @@ import isIndex from './_isIndex';
 import isKey from './_isKey';
 import isLength from './isLength';
 import isString from './isString';
+import toKey from './_toKey';
 
 /**
  * Checks if `path` exists on `object`.
@@ -23,7 +24,7 @@ function hasPath(object, path, hasFunc) {
       length = path.length;
 
   while (++index < length) {
-    var key = path[index];
+    var key = toKey(path[index]);
     if (!(result = object != null && hasFunc(object, key))) {
       break;
     }

_isIndex.js

@@ -13,9 +13,10 @@ var reIsUint = /^(?:0|[1-9]\d*)$/;
  * @returns {boolean} Returns `true` if `value` is a valid index, else `false`.
  */
 function isIndex(value, length) {
-  value = (typeof value == 'number' || reIsUint.test(value)) ? +value : -1;
   length = length == null ? MAX_SAFE_INTEGER : length;
-  return value > -1 && value % 1 == 0 && value < length;
+  return !!length &&
+    (typeof value == 'number' || reIsUint.test(value)) &&
+    (value > -1 && value % 1 == 0 && value < length);
 }
 
 export default isIndex;

_isKey.js

@@ -14,13 +14,16 @@ var reIsDeepProp = /\.|\[(?:[^[\]]*|(["'])(?:(?!\1)[^\\]|\\.)*?\1)\]/,
  * @returns {boolean} Returns `true` if `value` is a property name, else `false`.
  */
 function isKey(value, object) {
+  if (isArray(value)) {
+    return false;
+  }
   var type = typeof value;
-  if (type == 'number' || type == 'symbol') {
+  if (type == 'number' || type == 'symbol' || type == 'boolean' ||
+      value == null || isSymbol(value)) {
     return true;
   }
-  return !isArray(value) &&
-    (isSymbol(value) || reIsPlainProp.test(value) || !reIsDeepProp.test(value) ||
-      (object != null && value in Object(object)));
+  return reIsPlainProp.test(value) || !reIsDeepProp.test(value) ||
+    (object != null && value in Object(object));
 }
 
 export default isKey;

_isKeyable.js

@@ -7,8 +7,9 @@
  */
 function isKeyable(value) {
   var type = typeof value;
-  return type == 'number' || type == 'boolean' ||
-    (type == 'string' && value != '__proto__') || value == null;
+  return (type == 'string' || type == 'number' || type == 'symbol' || type == 'boolean')
+    ? (value !== '__proto__')
+    : (value === null);
 }
 
 export default isKeyable;

_toKey.js

@@ -1,5 +1,8 @@
 import isSymbol from './isSymbol';
 
+/** Used as references for various `Number` constants. */
+var INFINITY = 1 / 0;
+
 /**
  * Converts `value` to a string key if it's not a string or symbol.
  *
@@ -7,8 +10,12 @@ import isSymbol from './isSymbol';
  * @param {*} value The value to inspect.
  * @returns {string|symbol} Returns the key.
  */
-function toKey(key) {
-  return (typeof key == 'string' || isSymbol(key)) ? key : (key + '');
+function toKey(value) {
+  if (typeof value == 'string' || isSymbol(value)) {
+    return value;
+  }
+  var result = (value + '');
+  return (result == '0' && (1 / value) == -INFINITY) ? '-0' : result;
 }
 
 export default toKey;

assign.js

@@ -32,6 +32,7 @@ var nonEnumShadows = !propertyIsEnumerable.call({ 'valueOf': 1 }, 'valueOf');
  * @param {Object} object The destination object.
  * @param {...Object} [sources] The source objects.
  * @returns {Object} Returns `object`.
+ * @see _.assignIn
  * @example
  *
  * function Foo() {

assignIn.js

@@ -28,6 +28,7 @@ var nonEnumShadows = !propertyIsEnumerable.call({ 'valueOf': 1 }, 'valueOf');
  * @param {Object} object The destination object.
  * @param {...Object} [sources] The source objects.
  * @returns {Object} Returns `object`.
+ * @see _.assign
  * @example
  *
  * function Foo() {

assignInWith.js

@@ -19,6 +19,7 @@ import keysIn from './keysIn';
  * @param {...Object} sources The source objects.
  * @param {Function} [customizer] The function to customize assigned values.
  * @returns {Object} Returns `object`.
+ * @see _.assignWith
  * @example
  *
  * function customizer(objValue, srcValue) {

assignWith.js

@@ -18,6 +18,7 @@ import keys from './keys';
  * @param {...Object} sources The source objects.
  * @param {Function} [customizer] The function to customize assigned values.
  * @returns {Object} Returns `object`.
+ * @see _.assignInWith
  * @example
  *
  * function customizer(objValue, srcValue) {

bindAll.js

@@ -2,6 +2,7 @@ import arrayEach from './_arrayEach';
 import baseFlatten from './_baseFlatten';
 import bind from './bind';
 import rest from './rest';
+import toKey from './_toKey';
 
 /**
  * Binds methods of an object to the object itself, overwriting the existing
@@ -31,6 +32,7 @@ import rest from './rest';
  */
 var bindAll = rest(function(object, methodNames) {
   arrayEach(baseFlatten(methodNames, 1), function(key) {
+    key = toKey(key);
     object[key] = bind(object[key], object);
   });
   return object;

clone.js

@@ -17,6 +17,7 @@ import baseClone from './_baseClone';
  * @category Lang
  * @param {*} value The value to clone.
  * @returns {*} Returns the cloned value.
+ * @see _.cloneDeep
  * @example
  *
  * var objects = [{ 'a': 1 }, { 'b': 2 }];

cloneDeep.js

@@ -9,6 +9,7 @@ import baseClone from './_baseClone';
  * @category Lang
  * @param {*} value The value to recursively clone.
  * @returns {*} Returns the deep cloned value.
+ * @see _.clone
  * @example
  *
  * var objects = [{ 'a': 1 }, { 'b': 2 }];

cloneDeepWith.js

@@ -10,6 +10,7 @@ import baseClone from './_baseClone';
  * @param {*} value The value to recursively clone.
  * @param {Function} [customizer] The function to customize cloning.
  * @returns {*} Returns the deep cloned value.
+ * @see _.cloneWith
  * @example
  *
  * function customizer(value) {

cloneWith.js

@@ -13,6 +13,7 @@ import baseClone from './_baseClone';
  * @param {*} value The value to clone.
  * @param {Function} [customizer] The function to customize cloning.
  * @returns {*} Returns the cloned value.
+ * @see _.cloneDeepWith
  * @example
  *
  * function customizer(value) {

defaults.js

@@ -18,6 +18,7 @@ import rest from './rest';
  * @param {Object} object The destination object.
  * @param {...Object} [sources] The source objects.
  * @returns {Object} Returns `object`.
+ * @see _.defaultsDeep
  * @example
  *
  * _.defaults({ 'user': 'barney' }, { 'age': 36 }, { 'user': 'fred' });

defaultsDeep.js

@@ -16,6 +16,7 @@ import rest from './rest';
  * @param {Object} object The destination object.
  * @param {...Object} [sources] The source objects.
  * @returns {Object} Returns `object`.
+ * @see _.defaults
  * @example
  *
  * _.defaultsDeep({ 'user': { 'name': 'barney' } }, { 'user': { 'name': 'fred', 'age': 36 } });

difference.js

@@ -16,6 +16,7 @@ import rest from './rest';
  * @param {Array} array The array to inspect.
  * @param {...Array} [values] The values to exclude.
  * @returns {Array} Returns the new array of filtered values.
+ * @see _.without, _.xor
  * @example
  *
  * _.difference([3, 2, 1], [4, 2]);

endsWith.js

@@ -1,4 +1,5 @@
 import baseClamp from './_baseClamp';
+import baseToString from './_baseToString';
 import toInteger from './toInteger';
 import toString from './toString';
 
@@ -27,7 +28,7 @@ import toString from './toString';
  */
 function endsWith(string, target, position) {
   string = toString(string);
-  target = typeof target == 'string' ? target : (target + '');
+  target = baseToString(target);
 
   var length = string.length;
   position = position === undefined

filter.js

@@ -16,6 +16,7 @@ import isArray from './isArray';
  * @param {Array|Function|Object|string} [predicate=_.identity]
  *  The function invoked per iteration.
  * @returns {Array} Returns the new filtered array.
+ * @see _.reject
  * @example
  *
  * var users = [

flow.js

@@ -11,6 +11,7 @@ import createFlow from './_createFlow';
  * @category Util
  * @param {...(Function|Function[])} [funcs] Functions to invoke.
  * @returns {Function} Returns the new function.
+ * @see _.flowRight
  * @example
  *
  * function square(n) {

flowRight.js

@@ -5,11 +5,12 @@ import createFlow from './_createFlow';
  * invokes the given functions from right to left.
  *
  * @static
- * @since 0.1.0
+ * @since 3.0.0
  * @memberOf _
  * @category Util
  * @param {...(Function|Function[])} [funcs] Functions to invoke.
  * @returns {Function} Returns the new function.
+ * @see _.flow
  * @example
  *
  * function square(n) {

forEach.js

@@ -20,6 +20,7 @@ import isArray from './isArray';
  * @param {Array|Object} collection The collection to iterate over.
  * @param {Function} [iteratee=_.identity] The function invoked per iteration.
  * @returns {Array|Object} Returns `collection`.
+ * @see _.forEachRight
  * @example
  *
  * _([1, 2]).forEach(function(value) {

forEachRight.js

@@ -15,6 +15,7 @@ import isArray from './isArray';
  * @param {Array|Object} collection The collection to iterate over.
  * @param {Function} [iteratee=_.identity] The function invoked per iteration.
  * @returns {Array|Object} Returns `collection`.
+ * @see _.forEach
  * @example
  *
  * _.forEachRight([1, 2], function(value) {

forIn.js

@@ -15,6 +15,7 @@ import keysIn from './keysIn';
  * @param {Object} object The object to iterate over.
  * @param {Function} [iteratee=_.identity] The function invoked per iteration.
  * @returns {Object} Returns `object`.
+ * @see _.forInRight
  * @example
  *
  * function Foo() {

forInRight.js

@@ -13,6 +13,7 @@ import keysIn from './keysIn';
  * @param {Object} object The object to iterate over.
  * @param {Function} [iteratee=_.identity] The function invoked per iteration.
  * @returns {Object} Returns `object`.
+ * @see _.forIn
  * @example
  *
  * function Foo() {

forOwn.js

@@ -14,6 +14,7 @@ import baseIteratee from './_baseIteratee';
  * @param {Object} object The object to iterate over.
  * @param {Function} [iteratee=_.identity] The function invoked per iteration.
  * @returns {Object} Returns `object`.
+ * @see _.forOwnRight
  * @example
  *
  * function Foo() {

forOwnRight.js

@@ -12,6 +12,7 @@ import baseIteratee from './_baseIteratee';
  * @param {Object} object The object to iterate over.
  * @param {Function} [iteratee=_.identity] The function invoked per iteration.
  * @returns {Object} Returns `object`.
+ * @see _.forOwn
  * @example
  *
  * function Foo() {

functions.js

@@ -11,6 +11,7 @@ import keys from './keys';
  * @category Object
  * @param {Object} object The object to inspect.
  * @returns {Array} Returns the new array of property names.
+ * @see _.functionsIn
  * @example
  *
  * function Foo() {

functionsIn.js

@@ -11,6 +11,7 @@ import keysIn from './keysIn';
  * @category Object
  * @param {Object} object The object to inspect.
  * @returns {Array} Returns the new array of property names.
+ * @see _.functions
  * @example
  *
  * function Foo() {

gt.js

@@ -1,3 +1,6 @@
+import baseGt from './_baseGt';
+import createRelationalOperation from './_createRelationalOperation';
+
 /**
  * Checks if `value` is greater than `other`.
  *
@@ -9,6 +12,7 @@
  * @param {*} other The other value to compare.
  * @returns {boolean} Returns `true` if `value` is greater than `other`,
  *  else `false`.
+ * @see _.lt
  * @example
  *
  * _.gt(3, 1);
@@ -20,8 +24,6 @@
  * _.gt(1, 3);
  * // => false
  */
-function gt(value, other) {
-  return value > other;
-}
+var gt = createRelationalOperation(baseGt);
 
 export default gt;

gte.js

@@ -1,3 +1,5 @@
+import createRelationalOperation from './_createRelationalOperation';
+
 /**
  * Checks if `value` is greater than or equal to `other`.
  *
@@ -9,6 +11,7 @@
  * @param {*} other The other value to compare.
  * @returns {boolean} Returns `true` if `value` is greater than or equal to
  *  `other`, else `false`.
+ * @see _.lte
  * @example
  *
  * _.gte(3, 1);
@@ -20,8 +23,8 @@
  * _.gte(1, 3);
  * // => false
  */
-function gte(value, other) {
+var gte = createRelationalOperation(function(value, other) {
   return value >= other;
-}
+});
 
 export default gte;

inRange.js

@@ -2,7 +2,7 @@ import baseInRange from './_baseInRange';
 import toNumber from './toNumber';
 
 /**
- * Checks if `n` is between `start` and up to but not including, `end`. If
+ * Checks if `n` is between `start` and up to, but not including, `end`. If
  * `end` is not specified, it's set to `start` with `start` then set to `0`.
  * If `start` is greater than `end` the params are swapped to support
  * negative ranges.
@@ -15,6 +15,7 @@ import toNumber from './toNumber';
  * @param {number} [start=0] The start of the range.
  * @param {number} end The end of the range.
  * @returns {boolean} Returns `true` if `number` is in the range, else `false`.
+ * @see _.range, _.rangeRight
  * @example
  *
  * _.inRange(3, 2, 4);

lodash.default.js

@@ -1,6 +1,6 @@
 /**
  * @license
- * lodash 4.11.1 (Custom Build) <https://lodash.com/>
+ * lodash 4.11.2 (Custom Build) <https://lodash.com/>
  * Build: `lodash modularize exports="es" -o ./`
  * Copyright jQuery Foundation and other contributors <https://jquery.org/>
  * Released under MIT license <https://lodash.com/license>
@@ -44,7 +44,7 @@ import toInteger from './toInteger';
 import lodash from './wrapperLodash';
 
 /** Used as the semantic version number. */
-var VERSION = '4.11.1';
+var VERSION = '4.11.2';
 
 /** Used to compose bitmasks for wrapper metadata. */
 var BIND_KEY_FLAG = 2;

lodash.js

@@ -1,6 +1,6 @@
 /**
  * @license
- * lodash 4.11.1 (Custom Build) <https://lodash.com/>
+ * lodash 4.11.2 (Custom Build) <https://lodash.com/>
  * Build: `lodash modularize exports="es" -o ./`
  * Copyright jQuery Foundation and other contributors <https://jquery.org/>
  * Released under MIT license <https://lodash.com/license>

lt.js

@@ -1,3 +1,6 @@
+import baseLt from './_baseLt';
+import createRelationalOperation from './_createRelationalOperation';
+
 /**
  * Checks if `value` is less than `other`.
  *
@@ -9,6 +12,7 @@
  * @param {*} other The other value to compare.
  * @returns {boolean} Returns `true` if `value` is less than `other`,
  *  else `false`.
+ * @see _.gt
  * @example
  *
  * _.lt(1, 3);
@@ -20,8 +24,6 @@
  * _.lt(3, 1);
  * // => false
  */
-function lt(value, other) {
-  return value < other;
-}
+var lt = createRelationalOperation(baseLt);
 
 export default lt;

lte.js

@@ -1,3 +1,5 @@
+import createRelationalOperation from './_createRelationalOperation';
+
 /**
  * Checks if `value` is less than or equal to `other`.
  *
@@ -9,6 +11,7 @@
  * @param {*} other The other value to compare.
  * @returns {boolean} Returns `true` if `value` is less than or equal to
  *  `other`, else `false`.
+ * @see _.gte
  * @example
  *
  * _.lte(1, 3);
@@ -20,8 +23,8 @@
  * _.lte(3, 1);
  * // => false
  */
-function lte(value, other) {
+var lte = createRelationalOperation(function(value, other) {
   return value <= other;
-}
+});
 
 export default lte;

mapKeys.js

@@ -15,6 +15,7 @@ import baseIteratee from './_baseIteratee';
  * @param {Array|Function|Object|string} [iteratee=_.identity]
  *  The function invoked per iteration.
  * @returns {Object} Returns the new mapped object.
+ * @see _.mapValues
  * @example
  *
  * _.mapKeys({ 'a': 1, 'b': 2 }, function(value, key) {

mapValues.js

@@ -15,6 +15,7 @@ import baseIteratee from './_baseIteratee';
  * @param {Array|Function|Object|string} [iteratee=_.identity]
  *  The function invoked per iteration.
  * @returns {Object} Returns the new mapped object.
+ * @see _.mapKeys
  * @example
  *
  * var users = {

max.js

@@ -1,5 +1,5 @@
 import baseExtremum from './_baseExtremum';
-import gt from './gt';
+import baseGt from './_baseGt';
 import identity from './identity';
 
 /**
@@ -22,7 +22,7 @@ import identity from './identity';
  */
 function max(array) {
   return (array && array.length)
-    ? baseExtremum(array, identity, gt)
+    ? baseExtremum(array, identity, baseGt)
     : undefined;
 }
 

maxBy.js

@@ -1,6 +1,6 @@
 import baseExtremum from './_baseExtremum';
+import baseGt from './_baseGt';
 import baseIteratee from './_baseIteratee';
-import gt from './gt';
 
 /**
  * This method is like `_.max` except that it accepts `iteratee` which is
@@ -28,7 +28,7 @@ import gt from './gt';
  */
 function maxBy(array, iteratee) {
   return (array && array.length)
-    ? baseExtremum(array, baseIteratee(iteratee), gt)
+    ? baseExtremum(array, baseIteratee(iteratee), baseGt)
     : undefined;
 }
 

min.js

@@ -1,6 +1,6 @@
 import baseExtremum from './_baseExtremum';
+import baseLt from './_baseLt';
 import identity from './identity';
-import lt from './lt';
 
 /**
  * Computes the minimum value of `array`. If `array` is empty or falsey,
@@ -22,7 +22,7 @@ import lt from './lt';
  */
 function min(array) {
   return (array && array.length)
-    ? baseExtremum(array, identity, lt)
+    ? baseExtremum(array, identity, baseLt)
     : undefined;
 }
 

minBy.js

@@ -1,6 +1,6 @@
 import baseExtremum from './_baseExtremum';
 import baseIteratee from './_baseIteratee';
-import lt from './lt';
+import baseLt from './_baseLt';
 
 /**
  * This method is like `_.min` except that it accepts `iteratee` which is
@@ -28,7 +28,7 @@ import lt from './lt';
  */
 function minBy(array, iteratee) {
   return (array && array.length)
-    ? baseExtremum(array, baseIteratee(iteratee), lt)
+    ? baseExtremum(array, baseIteratee(iteratee), baseLt)
     : undefined;
 }
 

package.json

@@ -1,20 +1,20 @@
 {
   "name": "lodash-es",
-  "version": "4.11.1",
+  "version": "4.11.2",
   "description": "Lodash exported as ES modules.",
+  "keywords": "es6, modules, stdlib, util",
   "homepage": "https://lodash.com/custom-builds",
+  "bugs": "https://github.com/lodash/lodash-cli/issues",
+  "repository": "lodash/lodash",
   "license": "MIT",
   "private": true,
   "jsnext:main": "lodash.js",
   "main": "lodash.js",
-  "keywords": "es6, modules, stdlib, util",
   "author": "John-David Dalton <john.david.dalton@gmail.com> (http://allyoucanleet.com/)",
   "contributors": [
     "John-David Dalton <john.david.dalton@gmail.com> (http://allyoucanleet.com/)",
     "Blaine Bublitz <blaine.bublitz@gmail.com> (https://github.com/phated)",
     "Mathias Bynens <mathias@qiwi.be> (https://mathiasbynens.be/)"
   ],
-  "bugs": "https://github.com/lodash/lodash-cli/issues",
-  "repository": "lodash/lodash",
   "scripts": { "test": "echo \"See https://travis-ci.org/lodash/lodash-cli for testing details.\"" }
 }

pick.js

@@ -1,6 +1,8 @@
+import arrayMap from './_arrayMap';
 import baseFlatten from './_baseFlatten';
 import basePick from './_basePick';
 import rest from './rest';
+import toKey from './_toKey';
 
 /**
  * Creates an object composed of the picked `object` properties.
@@ -20,7 +22,7 @@ import rest from './rest';
  * // => { 'a': 1, 'c': 3 }
  */
 var pick = rest(function(object, props) {
-  return object == null ? {} : basePick(object, baseFlatten(props, 1));
+  return object == null ? {} : basePick(object, arrayMap(baseFlatten(props, 1), toKey));
 });
 
 export default pick;

property.js

@@ -1,6 +1,7 @@
 import baseProperty from './_baseProperty';
 import basePropertyDeep from './_basePropertyDeep';
 import isKey from './_isKey';
+import toKey from './_toKey';
 
 /**
  * Creates a function that returns the value at `path` of a given object.
@@ -25,7 +26,7 @@ import isKey from './_isKey';
  * // => [1, 2]
  */
 function property(path) {
-  return isKey(path) ? baseProperty(path) : basePropertyDeep(path);
+  return isKey(path) ? baseProperty(toKey(path)) : basePropertyDeep(path);
 }
 
 export default property;

pullAt.js

@@ -3,6 +3,7 @@ import baseAt from './_baseAt';
 import baseFlatten from './_baseFlatten';
 import basePullAt from './_basePullAt';
 import compareAscending from './_compareAscending';
+import isIndex from './_isIndex';
 import rest from './rest';
 
 /**
@@ -30,10 +31,15 @@ import rest from './rest';
  * // => [10, 20]
  */
 var pullAt = rest(function(array, indexes) {
-  indexes = arrayMap(baseFlatten(indexes, 1), String);
+  indexes = baseFlatten(indexes, 1);
+
+  var length = array ? array.length : 0,
+      result = baseAt(array, indexes);
+
+  basePullAt(array, arrayMap(indexes, function(index) {
+    return isIndex(index, length) ? +index : index;
+  }).sort(compareAscending));
 
-  var result = baseAt(array, indexes);
-  basePullAt(array, indexes.sort(compareAscending));
   return result;
 });
 

range.js

@@ -17,6 +17,7 @@ import createRange from './_createRange';
  * @param {number} end The end of the range.
  * @param {number} [step=1] The value to increment or decrement by.
  * @returns {Array} Returns the new array of numbers.
+ * @see _.inRange, _.rangeRight
  * @example
  *
  * _.range(4);

rangeRight.js

@@ -12,6 +12,7 @@ import createRange from './_createRange';
  * @param {number} end The end of the range.
  * @param {number} [step=1] The value to increment or decrement by.
  * @returns {Array} Returns the new array of numbers.
+ * @see _.inRange, _.range
  * @example
  *
  * _.rangeRight(4);

reduce.js

@@ -27,6 +27,7 @@ import isArray from './isArray';
  * @param {Function} [iteratee=_.identity] The function invoked per iteration.
  * @param {*} [accumulator] The initial value.
  * @returns {*} Returns the accumulated value.
+ * @see _.reduceRight
  * @example
  *
  * _.reduce([1, 2], function(sum, n) {

reduceRight.js

@@ -16,6 +16,7 @@ import isArray from './isArray';
  * @param {Function} [iteratee=_.identity] The function invoked per iteration.
  * @param {*} [accumulator] The initial value.
  * @returns {*} Returns the accumulated value.
+ * @see _.reduce
  * @example
  *
  * var array = [[0, 1], [2, 3], [4, 5]];

reject.js

@@ -15,6 +15,7 @@ import isArray from './isArray';
  * @param {Array|Function|Object|string} [predicate=_.identity]
  *  The function invoked per iteration.
  * @returns {Array} Returns the new filtered array.
+ * @see _.filter
  * @example
  *
  * var users = [

result.js

@@ -1,6 +1,7 @@
 import castPath from './_castPath';
 import isFunction from './isFunction';
 import isKey from './_isKey';
+import toKey from './_toKey';
 
 /**
  * This method is like `_.get` except that if the resolved value is a
@@ -43,7 +44,7 @@ function result(object, path, defaultValue) {
     length = 1;
   }
   while (++index < length) {
-    var value = object == null ? undefined : object[path[index]];
+    var value = object == null ? undefined : object[toKey(path[index])];
     if (value === undefined) {
       index = length;
       value = defaultValue;

sortedUniqBy.js

@@ -1,5 +1,5 @@
 import baseIteratee from './_baseIteratee';
-import baseSortedUniqBy from './_baseSortedUniqBy';
+import baseSortedUniq from './_baseSortedUniq';
 
 /**
  * This method is like `_.uniqBy` except that it's designed and optimized
@@ -19,7 +19,7 @@ import baseSortedUniqBy from './_baseSortedUniqBy';
  */
 function sortedUniqBy(array, iteratee) {
   return (array && array.length)
-    ? baseSortedUniqBy(array, baseIteratee(iteratee))
+    ? baseSortedUniq(array, baseIteratee(iteratee))
     : [];
 }
 

split.js

@@ -1,3 +1,4 @@
+import baseToString from './_baseToString';
 import castSlice from './_castSlice';
 import isIterateeCall from './_isIterateeCall';
 import isRegExp from './isRegExp';
@@ -46,7 +47,7 @@ function split(string, separator, limit) {
         typeof separator == 'string' ||
         (separator != null && !isRegExp(separator))
       )) {
-    separator += '';
+    separator = baseToString(separator);
     if (separator == '' && reHasComplexSymbol.test(string)) {
       return castSlice(stringToArray(string), 0, limit);
     }

startsWith.js

@@ -1,4 +1,5 @@
 import baseClamp from './_baseClamp';
+import baseToString from './_baseToString';
 import toInteger from './toInteger';
 import toString from './toString';
 
@@ -28,7 +29,7 @@ import toString from './toString';
 function startsWith(string, target, position) {
   string = toString(string);
   position = baseClamp(toInteger(position), 0, string.length);
-  return string.lastIndexOf(target, position) == position;
+  return string.lastIndexOf(baseToString(target), position) == position;
 }
 
 export default startsWith;

toString.js

@@ -1,12 +1,4 @@
-import Symbol from './_Symbol';
-import isSymbol from './isSymbol';
-
-/** Used as references for various `Number` constants. */
-var INFINITY = 1 / 0;
-
-/** Used to convert symbols to primitives and strings. */
-var symbolProto = Symbol ? Symbol.prototype : undefined,
-    symbolToString = symbolProto ? symbolProto.toString : undefined;
+import baseToString from './_baseToString';
 
 /**
  * Converts `value` to a string. An empty string is returned for `null`
@@ -30,18 +22,7 @@ var symbolProto = Symbol ? Symbol.prototype : undefined,
  * // => '1,2,3'
  */
 function toString(value) {
-  // Exit early for strings to avoid a performance hit in some environments.
-  if (typeof value == 'string') {
-    return value;
-  }
-  if (value == null) {
-    return '';
-  }
-  if (isSymbol(value)) {
-    return symbolToString ? symbolToString.call(value) : '';
-  }
-  var result = (value + '');
-  return (result == '0' && (1 / value) == -INFINITY) ? '-0' : result;
+  return value == null ? '' : baseToString(value);
 }
 
 export default toString;

trim.js

@@ -1,3 +1,4 @@
+import baseToString from './_baseToString';
 import castSlice from './_castSlice';
 import charsEndIndex from './_charsEndIndex';
 import charsStartIndex from './_charsStartIndex';
@@ -31,13 +32,10 @@ var reTrim = /^\s+|\s+$/g;
  */
 function trim(string, chars, guard) {
   string = toString(string);
-  if (!string) {
-    return string;
-  }
-  if (guard || chars === undefined) {
+  if (string && (guard || chars === undefined)) {
     return string.replace(reTrim, '');
   }
-  if (!(chars += '')) {
+  if (!string || !(chars = baseToString(chars))) {
     return string;
   }
   var strSymbols = stringToArray(string),

trimEnd.js

@@ -1,3 +1,4 @@
+import baseToString from './_baseToString';
 import castSlice from './_castSlice';
 import charsEndIndex from './_charsEndIndex';
 import stringToArray from './_stringToArray';
@@ -27,13 +28,10 @@ var reTrimEnd = /\s+$/;
  */
 function trimEnd(string, chars, guard) {
   string = toString(string);
-  if (!string) {
-    return string;
-  }
-  if (guard || chars === undefined) {
+  if (string && (guard || chars === undefined)) {
     return string.replace(reTrimEnd, '');
   }
-  if (!(chars += '')) {
+  if (!string || !(chars = baseToString(chars))) {
     return string;
   }
   var strSymbols = stringToArray(string),

trimStart.js

@@ -1,3 +1,4 @@
+import baseToString from './_baseToString';
 import castSlice from './_castSlice';
 import charsStartIndex from './_charsStartIndex';
 import stringToArray from './_stringToArray';
@@ -27,13 +28,10 @@ var reTrimStart = /^\s+/;
  */
 function trimStart(string, chars, guard) {
   string = toString(string);
-  if (!string) {
-    return string;
-  }
-  if (guard || chars === undefined) {
+  if (string && (guard || chars === undefined)) {
     return string.replace(reTrimStart, '');
   }
-  if (!(chars += '')) {
+  if (!string || !(chars = baseToString(chars))) {
     return string;
   }
   var strSymbols = stringToArray(string),

truncate.js

@@ -1,3 +1,4 @@
+import baseToString from './_baseToString';
 import castSlice from './_castSlice';
 import isObject from './isObject';
 import isRegExp from './isRegExp';
@@ -58,7 +59,7 @@ function truncate(string, options) {
   if (isObject(options)) {
     var separator = 'separator' in options ? options.separator : separator;
     length = 'length' in options ? toInteger(options.length) : length;
-    omission = 'omission' in options ? toString(options.omission) : omission;
+    omission = 'omission' in options ? baseToString(options.omission) : omission;
   }
   string = toString(string);
 
@@ -98,7 +99,7 @@ function truncate(string, options) {
       }
       result = result.slice(0, newEnd === undefined ? end : newEnd);
     }
-  } else if (string.indexOf(separator, end) != end) {
+  } else if (string.indexOf(baseToString(separator), end) != end) {
     var index = result.lastIndexOf(separator);
     if (index > -1) {
       result = result.slice(0, index);

without.js

@@ -14,6 +14,7 @@ import rest from './rest';
  * @param {Array} array The array to filter.
  * @param {...*} [values] The values to exclude.
  * @returns {Array} Returns the new array of filtered values.
+ * @see _.difference, _.xor
  * @example
  *
  * _.without([1, 2, 1, 3], 1, 2);

words.js

@@ -11,11 +11,11 @@ var rsAstralRange = '\\ud800-\\udfff',
     rsLowerRange = 'a-z\\xdf-\\xf6\\xf8-\\xff',
     rsMathOpRange = '\\xac\\xb1\\xd7\\xf7',
     rsNonCharRange = '\\x00-\\x2f\\x3a-\\x40\\x5b-\\x60\\x7b-\\xbf',
-    rsQuoteRange = '\\u2018\\u2019\\u201c\\u201d',
+    rsPunctuationRange = '\\u2000-\\u206f',
     rsSpaceRange = ' \\t\\x0b\\f\\xa0\\ufeff\\n\\r\\u2028\\u2029\\u1680\\u180e\\u2000\\u2001\\u2002\\u2003\\u2004\\u2005\\u2006\\u2007\\u2008\\u2009\\u200a\\u202f\\u205f\\u3000',
     rsUpperRange = 'A-Z\\xc0-\\xd6\\xd8-\\xde',
     rsVarRange = '\\ufe0e\\ufe0f',
-    rsBreakRange = rsMathOpRange + rsNonCharRange + rsQuoteRange + rsSpaceRange;
+    rsBreakRange = rsMathOpRange + rsNonCharRange + rsPunctuationRange + rsSpaceRange;
 
 /** Used to compose unicode capture groups. */
 var rsApos = "['\u2019]",

xor.js

@@ -15,6 +15,7 @@ import rest from './rest';
  * @category Array
  * @param {...Array} [arrays] The arrays to inspect.
  * @returns {Array} Returns the new array of values.
+ * @see _.difference, _.without
  * @example
  *
  * _.xor([2, 1], [4, 2]);