Bump to v3.2.0.

chain/chain.js

@@ -8,7 +8,7 @@ var lodash = require('./lodash');
  * @memberOf _
  * @category Chain
  * @param {*} value The value to wrap.
- * @returns {Object} Returns the new `lodash` object.
+ * @returns {Object} Returns the new `lodash` wrapper instance.
  * @example
  *
  * var users = [

chain/commit.js

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

chain/lodash.js

@@ -1,7 +1,8 @@
-var LodashWrapper = require('../internal/LodashWrapper'),
-    arrayCopy = require('../internal/arrayCopy'),
+var LazyWrapper = require('../internal/LazyWrapper'),
+    LodashWrapper = require('../internal/LodashWrapper'),
     isArray = require('../lang/isArray'),
-    isObjectLike = require('../internal/isObjectLike');
+    isObjectLike = require('../internal/isObjectLike'),
+    wrapperClone = require('../internal/wrapperClone');
 
 /** Used for native method references. */
 var objectProto = Object.prototype;
@@ -10,7 +11,7 @@ var objectProto = Object.prototype;
 var hasOwnProperty = objectProto.hasOwnProperty;
 
 /**
- * Creates a `lodash` object which wraps `value` to enable intuitive chaining.
+ * Creates a `lodash` object which wraps `value` to enable implicit chaining.
  * Methods that operate on and return arrays, collections, and functions can
  * be chained together. Methods that return a boolean or single value will
  * automatically end the chain returning the unwrapped value. Explicit chaining
@@ -29,29 +30,31 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * `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`,
@@ -66,14 +69,14 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * `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]);
@@ -92,18 +95,15 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * // => true
  */
 function lodash(value) {
-  if (isObjectLike(value) && !isArray(value)) {
+  if (isObjectLike(value) && !isArray(value) && !(value instanceof LazyWrapper)) {
     if (value instanceof LodashWrapper) {
       return value;
     }
-    if (hasOwnProperty.call(value, '__wrapped__')) {
-      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;
-
 module.exports = lodash;

chain/plant.js

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

chain/run.js

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

chain/wrapperChain.js

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

chain/wrapperCommit.js

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

chain/wrapperPlant.js

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

chain/wrapperReverse.js

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

chain/wrapperValue.js

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