Version bump to 0.58.0

README.md

@@ -51,18 +51,20 @@ or
 Doing so a `lamb` variable will be created in the global object.
 The source map for the minified file is in the same `dist` folder.
 
+Since version 0.58.0 there is also a one file ES modules build, always in the `dist` folder, named `lamb.esm.js` and its minified version `lamb.esm.min.js`.
+
 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.57.0/lamb.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/lamb/0.58.0/lamb.min.js"></script>
 ```
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/lamb@0.57.0/dist/lamb.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/lamb@0.58.0/dist/lamb.min.js"></script>
 ```
 
 ```html
-<script src="https://unpkg.com/lamb@0.57.0/dist/lamb.min.js"></script>
+<script src="https://unpkg.com/lamb@0.58.0/dist/lamb.min.js"></script>
 ```
 
 Please note that Lamb is served by jsDelivr since version 0.42.0.
@@ -113,6 +115,16 @@ 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.58.0 - *2019/06/18**
+  - Added one file ES modules build
+  - **API change**: `invoker` now accepts an array of bound arguments
+  - **API change**: benched `immutable` for the moment being
+  - Added `join` and `joinWith`
+  - Added `findLast`, `findLastWhere`, `findLastIndex`, `findLastIndexWhere`
+  - Added `dropLastWhile` and `takeLastWhile`
+  - Switched from uglify-js to terser
+  - Updated docs, linting and tests
+
 - **v0.57.0 - *2019/02/12***
   - Splitted the library into ES modules
   - **API change**: `sort`, `sortWith` and `sortedInsert` now accept an array of sorters
@@ -134,8 +146,3 @@ You can also check the [full changelog](https://ascartabelli.github.io/lamb/chan
   - **Fixed**: `setPath` and `updatePath` weren't returning unary functions, and further arguments would have overwritten the previous ones
   - Updated doc comments
   - Updated linting rules
-
-- **v0.54.0 - *2017/08/01***
-  - Added `mapValues` and `mapValuesWith`
-  - Added "@since" tags to doc comments
-  - Added linting for tests

dist/lamb.esm.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.58.0-alpha.9
+* @version 0.58.0
 * @module lamb
 * @license MIT
 */
@@ -1547,8 +1547,8 @@ function findLast (arrayLike, predicate) {
 var findLastIndexWhere = _curry2(findLastIndex, true);
 
 /**
- * A curried version of {@link module:lamb.findLast|findLast} expecting the array-like object
- * to search.
+ * A curried version of {@link module:lamb.findLast|findLast} that uses the given
+ * predicate to build a function expecting the array-like object to search.
  * @example
  * var isEven = function (n) { return n % 2 === 0; };
  * var findEven = _.findLastWhere(isEven);
@@ -1571,8 +1571,8 @@ var findLastIndexWhere = _curry2(findLastIndex, true);
 var findLastWhere = _curry2(findLast, true);
 
 /**
- * A curried version of {@link module:lamb.find|find} expecting the array-like object
- * to search.
+ * A curried version of {@link module:lamb.find|find} that uses the given
+ * predicate to build a function expecting the array-like object to search.
  * @example
  * var isEven = function (n) { return n % 2 === 0; };
  * var findEven = _.findWhere(isEven);
@@ -4115,7 +4115,7 @@ function unary (fn) {
  * to mimic conditional logic or pattern matching, and also to build polymorphic functions.
  * @example
  * var isEven = function (n) { return n % 2 === 0; };
- * var filterString = _.compose(_.invoker("join", [""]), _.filter);
+ * var filterString = _.compose(_.joinWith(""), _.filter);
  * var filterAdapter = _.adapter([
  *     _.invoker("filter"),
  *     _.case(_.isType("String"), filterString)

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.58.0-alpha.9
+* @version 0.58.0
 * @module lamb
 * @license MIT
 */
@@ -1553,8 +1553,8 @@
     var findLastIndexWhere = _curry2(findLastIndex, true);
 
     /**
-     * A curried version of {@link module:lamb.findLast|findLast} expecting the array-like object
-     * to search.
+     * A curried version of {@link module:lamb.findLast|findLast} that uses the given
+     * predicate to build a function expecting the array-like object to search.
      * @example
      * var isEven = function (n) { return n % 2 === 0; };
      * var findEven = _.findLastWhere(isEven);
@@ -1577,8 +1577,8 @@
     var findLastWhere = _curry2(findLast, true);
 
     /**
-     * A curried version of {@link module:lamb.find|find} expecting the array-like object
-     * to search.
+     * A curried version of {@link module:lamb.find|find} that uses the given
+     * predicate to build a function expecting the array-like object to search.
      * @example
      * var isEven = function (n) { return n % 2 === 0; };
      * var findEven = _.findWhere(isEven);
@@ -4121,7 +4121,7 @@
      * to mimic conditional logic or pattern matching, and also to build polymorphic functions.
      * @example
      * var isEven = function (n) { return n % 2 === 0; };
-     * var filterString = _.compose(_.invoker("join", [""]), _.filter);
+     * var filterString = _.compose(_.joinWith(""), _.filter);
      * var filterAdapter = _.adapter([
      *     _.invoker("filter"),
      *     _.case(_.isType("String"), filterString)

package.json

@@ -8,11 +8,7 @@
         "node": ">=4.0.0"
     },
     "files": [
-        "dist/lamb.js",
-        "dist/lamb.min.js",
-        "dist/lamb.min.js.map",
-        "src/*.js",
-        "src/**/!(__tests__)/*.js"
+        "dist"
     ],
     "homepage": "https://ascartabelli.github.io/lamb/",
     "keywords": [
@@ -51,7 +47,7 @@
     "unpkg": "dist/lamb.min.js",
     "sideEffects": false,
     "tonicExample": "var _ = require('lamb');",
-    "version": "0.58.0-alpha.9",
+    "version": "0.58.0",
     "devDependencies": {
         "@babel/preset-env": "^7.4.5",
         "coveralls": "^3.0.4",

src/array/findLastWhere.js

@@ -2,8 +2,8 @@ import _curry2 from "../privates/_curry2";
 import findLast from "./findLast";
 
 /**
- * A curried version of {@link module:lamb.findLast|findLast} expecting the array-like object
- * to search.
+ * A curried version of {@link module:lamb.findLast|findLast} that uses the given
+ * predicate to build a function expecting the array-like object to search.
  * @example
  * var isEven = function (n) { return n % 2 === 0; };
  * var findEven = _.findLastWhere(isEven);

src/array/findWhere.js

@@ -2,8 +2,8 @@ import _curry2 from "../privates/_curry2";
 import find from "./find";
 
 /**
- * A curried version of {@link module:lamb.find|find} expecting the array-like object
- * to search.
+ * A curried version of {@link module:lamb.find|find} that uses the given
+ * predicate to build a function expecting the array-like object to search.
  * @example
  * var isEven = function (n) { return n % 2 === 0; };
  * var findEven = _.findWhere(isEven);

src/logic/adapter.js

@@ -9,7 +9,7 @@ import _makeTypeErrorFor from "../privates/_makeTypeErrorFor";
  * to mimic conditional logic or pattern matching, and also to build polymorphic functions.
  * @example
  * var isEven = function (n) { return n % 2 === 0; };
- * var filterString = _.compose(_.invoker("join", [""]), _.filter);
+ * var filterString = _.compose(_.joinWith(""), _.filter);
  * var filterAdapter = _.adapter([
  *     _.invoker("filter"),
  *     _.case(_.isType("String"), filterString)