Version bump to 0.53.0

README.md

@@ -45,15 +45,15 @@ The source map for the minified file is in the same `dist` folder.
 Lamb it's also delivered on a CDN, courtesy of [cdnjs](https://cdnjs.com/), [jsDelivr](https://www.jsdelivr.com/) and [unpkg](https://unpkg.com/):
 
 ```html
-<script src="https://cdnjs.cloudflare.com/ajax/libs/lamb/0.52.0/lamb.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/lamb/0.53.0/lamb.min.js"></script>
 ```
 
 ```html
-<script src="https://cdn.jsdelivr.net/lamb/0.52.0/lamb.min.js"></script>
+<script src="https://cdn.jsdelivr.net/lamb/0.53.0/lamb.min.js"></script>
 ```
 
 ```html
-<script src="https://unpkg.com/lamb@0.52.0/dist/lamb.min.js"></script>
+<script src="https://unpkg.com/lamb@0.53.0/dist/lamb.min.js"></script>
 ```
 
 Please note that Lamb is served by jsDelivr since version 0.42.0.
@@ -104,6 +104,13 @@ You can check the [recent](#recent_changes) or the [full](https://ascartabelli.g
 ## <a name="recent_changes"></a> Recent changes
 You can also check the [full changelog](https://ascartabelli.github.io/lamb/changelog.html).
 
+- **v0.53.0 - *2017/03/30***
+  - **API change**: unfilled placeholders in functions built with `asPartial` now assume an `undefined` value
+  - **API change**: `range` now converts to number its parameters and will return an empty array if the specified range is invalid
+  - **API change**: `difference` is now a binary function and returns a result without duplicates
+  - Changed the name of the property holding the library's version
+  - Added the possibility to use custom placeholders in partial application
+
 - **v0.52.0 - *2017/03/17***
   - **API change**: `partial` is no longer variadic and accepts a function and an array of arguments instead
   - **API change**: `getArgAt` and all array accessors now convert their index parameter to integer
@@ -149,10 +156,3 @@ You can also check the [full changelog](https://ascartabelli.github.io/lamb/chan
   - Updated tests for `hasPathValue` and "pick" and "skip" functions
   - Updated tests of `updatePath` to check negative array indexes that are out of bounds
   - Updated dev dependencies
-
-- **v0.48.0 - *2017/01/10***
-  - **API change**: `slice` isn't a generic anymore to ensure that dense arrays are returned and has no optional parameters
-  - **Fixed**: `pull` and `pullFrom` now consider `nil`s received as the `values` parameter as empty arrays
-  - Added `sliceAt`
-  - All array functions always return dense arrays now
-  - Updated tests

dist/lamb.js

@@ -1,7 +1,7 @@
 /**
  * @overview lamb - A lightweight, and docile, JavaScript library to help embracing functional programming.
  * @author Andrea Scartabelli <andrea.scartabelli@gmail.com>
- * @version 0.53.0-alpha.4
+ * @version 0.53.0
  * @module lamb
  * @license MIT
  * @preserve
@@ -44,7 +44,7 @@
          * @readonly
          * @type String
          */
-        "@@lamb/version": {value: "0.53.0-alpha.4"}
+        "@@lamb/version": {value: "0.53.0"}
     });
 
     // prototype shortcuts
@@ -3900,11 +3900,11 @@
     var insertAt = _makePartial3(insert);
 
     /**
-     * Returns an array of every item that is included in all given arrays or array-like objects.<br/>
+     * Returns an array of every unique item that is included in all given arrays or array-like objects.<br/>
      * Note that this function uses the ["SameValueZero" comparison]{@link module:lamb.areSVZ|areSVZ}.
      * @example
      * var a1 = [1, 2, 3, 4];
-     * var a2 = [2, 5, 4, 6];
+     * var a2 = [2, 5, 4, 2, 6];
      * var a3 = [5, 6, 7];
      *
      * _.intersection(a1, a2) // => [2, 4]
@@ -3942,7 +3942,7 @@
      * @see {@link module:lamb.partitionWith|partitionWith}
      * @param {ArrayLike} arrayLike
      * @param {ListIteratorCallback} predicate
-     * @returns {Array<Array<*>, Array<*>>}
+     * @returns {Array<Array, Array>}
      */
     function partition (arrayLike, predicate) {
         var result = [[], []];
@@ -4212,8 +4212,8 @@
      * @memberof module:lamb
      * @category Array
      * @see {@link module:lamb.zip|zip}
-     * @param {ArrayLike<ArrayLike<*>>} arrayLike
-     * @returns {Array<Array<*>>}
+     * @param {ArrayLike<ArrayLike>} arrayLike
+     * @returns {Array<Array>}
      */
     function transpose (arrayLike) {
         var minLen = MAX_ARRAY_LENGTH;
@@ -4376,7 +4376,7 @@
      * @see {@link module:lamb.transpose|transpose} for the reverse operation
      * @see {@link module:lamb.zipWithIndex|zipWithIndex}
      * @param {...ArrayLike} arrayLike
-     * @returns {Array<Array<*>>}
+     * @returns {Array<Array>}
      */
     var zip = compose(transpose, list);
 
@@ -6036,7 +6036,7 @@
      * @see {@link module:lamb.tearOwn|tearOwn}
      * @see {@link module:lamb.make|make} for the reverse operation
      * @param {Object} obj
-     * @returns {Array<Array<String>, Array<*>>}
+     * @returns {Array<String[], Array>}
      */
     var tear = _tearFrom(enumerables);
 
@@ -6058,7 +6058,7 @@
      * @see {@link module:lamb.tear|tear}
      * @see {@link module:lamb.make|make} for the reverse operation
      * @param {Object} obj
-     * @returns {Array<Array<String>, Array<*>>}
+     * @returns {Array<String[], Array>}
      */
     var tearOwn = _tearFrom(keys);
 

package.json

@@ -34,7 +34,7 @@
     "coveralls": "gulp coverage && cat ./coverage/lcov.info | ./node_modules/coveralls/bin/coveralls.js && rm -rf ./coverage"
   },
   "tonicExample": "var _ = require('lamb');",
-  "version": "0.53.0-alpha.4",
+  "version": "0.53.0",
   "devDependencies": {
     "coveralls": "^2.12.0",
     "gulp": "^3.9.1",

src/array.js

@@ -275,11 +275,11 @@ function insert (arrayLike, index, element) {
 var insertAt = _makePartial3(insert);
 
 /**
- * Returns an array of every item that is included in all given arrays or array-like objects.<br/>
+ * Returns an array of every unique item that is included in all given arrays or array-like objects.<br/>
  * Note that this function uses the ["SameValueZero" comparison]{@link module:lamb.areSVZ|areSVZ}.
  * @example
  * var a1 = [1, 2, 3, 4];
- * var a2 = [2, 5, 4, 6];
+ * var a2 = [2, 5, 4, 2, 6];
  * var a3 = [5, 6, 7];
  *
  * _.intersection(a1, a2) // => [2, 4]
@@ -317,7 +317,7 @@ function intersection () {
  * @see {@link module:lamb.partitionWith|partitionWith}
  * @param {ArrayLike} arrayLike
  * @param {ListIteratorCallback} predicate
- * @returns {Array<Array<*>, Array<*>>}
+ * @returns {Array<Array, Array>}
  */
 function partition (arrayLike, predicate) {
     var result = [[], []];
@@ -587,8 +587,8 @@ function takeWhile (predicate) {
  * @memberof module:lamb
  * @category Array
  * @see {@link module:lamb.zip|zip}
- * @param {ArrayLike<ArrayLike<*>>} arrayLike
- * @returns {Array<Array<*>>}
+ * @param {ArrayLike<ArrayLike>} arrayLike
+ * @returns {Array<Array>}
  */
 function transpose (arrayLike) {
     var minLen = MAX_ARRAY_LENGTH;
@@ -751,7 +751,7 @@ function uniquesBy (iteratee) {
  * @see {@link module:lamb.transpose|transpose} for the reverse operation
  * @see {@link module:lamb.zipWithIndex|zipWithIndex}
  * @param {...ArrayLike} arrayLike
- * @returns {Array<Array<*>>}
+ * @returns {Array<Array>}
  */
 var zip = compose(transpose, list);
 

src/object.js

@@ -558,7 +558,7 @@ var skipKeys = _curry2(skip, true);
  * @see {@link module:lamb.tearOwn|tearOwn}
  * @see {@link module:lamb.make|make} for the reverse operation
  * @param {Object} obj
- * @returns {Array<Array<String>, Array<*>>}
+ * @returns {Array<String[], Array>}
  */
 var tear = _tearFrom(enumerables);
 
@@ -580,7 +580,7 @@ var tear = _tearFrom(enumerables);
  * @see {@link module:lamb.tear|tear}
  * @see {@link module:lamb.make|make} for the reverse operation
  * @param {Object} obj
- * @returns {Array<Array<String>, Array<*>>}
+ * @returns {Array<String[], Array>}
  */
 var tearOwn = _tearFrom(keys);