ramda-adjunct 3.3.0 → 4.0.0

package/lib/anyP.js

@@ -1,27 +1,17 @@
 "use strict";
 
 function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
-
 exports.__esModule = true;
 exports["default"] = exports.anyPPonyfill = void 0;
-
 var _ramda = require("ramda");
-
 var _isFunction = _interopRequireDefault(require("./isFunction"));
-
 var _Promise = _interopRequireWildcard(require("./internal/ponyfills/Promise.any"));
-
 exports.AggregatedError = _Promise.AggregatedError;
-
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
-
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 var anyPPonyfill = (0, _ramda.curryN)(1, _Promise["default"]);
 exports.anyPPonyfill = anyPPonyfill;
-
 /**
  * Returns a promise that is fulfilled by the first given promise to be fulfilled,
  * or rejected with an array of rejection reasons if all of the given promises are rejected.

package/lib/appendFlipped.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Returns a new list containing the contents of the given list, followed by the given element.
  * Like {@link http://ramdajs.com/docs/#append|R.append} but with argument order reversed.

package/lib/argsPass.js

@@ -2,15 +2,10 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _list = _interopRequireDefault(require("./list"));
-
 var _isTruthy = _interopRequireDefault(require("./isTruthy"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * Takes a combining predicate and a list of functions and returns a function which will map the
  * arguments it receives to the list of functions and returns the result of passing the values

package/lib/async.js

@@ -2,15 +2,10 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _resolveP = _interopRequireDefault(require("./resolveP"));
-
 var _rejectP = _interopRequireDefault(require("./rejectP"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * Takes a generator function and returns an async function.
  * The async function returned is a curried function whose arity matches that of the generator function.
@@ -40,7 +35,6 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
 var async = (0, _ramda.curryN)(1, function (generatorFn) {
   function asyncWrapper() {
     var iterator = (0, _ramda.bind)(generatorFn, this).apply(void 0, arguments);
-
     var handle = function handle(result) {
       var resolved = (0, _resolveP["default"])(result.value);
       return result.done ? resolved : resolved.then(function (value) {
@@ -49,18 +43,15 @@ var async = (0, _ramda.curryN)(1, function (generatorFn) {
         return handle(iterator["throw"](error));
       });
     };
-
     try {
       return handle(iterator.next());
     } catch (error) {
       return (0, _rejectP["default"])(error);
     }
   }
-
   if (generatorFn.length > 0) {
     return (0, _ramda.curryN)(generatorFn.length, asyncWrapper);
   }
-
   return asyncWrapper;
 });
 var _default = async;

package/lib/cata.js

@@ -2,13 +2,9 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _isFunction = _interopRequireDefault(require("./isFunction"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * The catamorphism is a way of folding a type into a value.
  *
@@ -93,17 +89,14 @@ var catamorphism = (0, _ramda.curry)(function (leftFn, rightFn, catamorphicObj)
       }
     });
   }
-
   if ((0, _isFunction["default"])(catamorphicObj.cata)) {
     return catamorphicObj.cata(leftFn, rightFn);
   }
-
   if ((0, _isFunction["default"])(catamorphicObj.getOrElse)) {
     var elseValue = "RA.cata".concat(Math.random());
     var value = catamorphicObj.getOrElse(elseValue);
     return value === elseValue ? leftFn() : rightFn(value);
   }
-
   return catamorphicObj.either(leftFn, rightFn);
 });
 var _default = catamorphism;

package/lib/catchP.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Composable shortcut for `Promise.catch`.
  * The catchP function returns a Promise. It takes two arguments: a callback function for the failure of the Promise

package/lib/ceil.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Returns the smallest integer greater than or equal to a given number.
  *
@@ -27,6 +25,7 @@ var _ramda = require("ramda");
  * RA.ceil(-7.004); //=> -7
  * RA.ceil(null); //=> 0
  */
+
 var ceil = (0, _ramda.curryN)(1, (0, _ramda.bind)(Math.ceil, Math));
 var _default = ceil;
 exports["default"] = _default;

package/lib/compact.js

@@ -2,13 +2,9 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _isFalsy = _interopRequireDefault(require("./isFalsy"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * Creates an array with all falsy values removed.
  * The values false, null, 0, "", undefined, and NaN are falsy.

package/lib/concatAll.js

@@ -2,16 +2,13 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _stubUndefined = _interopRequireDefault(require("./stubUndefined"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 var leftIdentitySemigroup = {
   concat: _ramda.identity
 };
+
 /**
  * Returns the result of concatenating the given lists or strings.
  * Note: RA.concatAll expects all elements to be of the same type. It will throw an error if you concat an Array with a non-Array value.
@@ -32,9 +29,9 @@ var leftIdentitySemigroup = {
  *
  * concatAll([[1], [2], [3]]); //=> [1, 2, 3]
  * concatAll(['1', '2', '3']); //=> '123'
- * concatAll([]); //=> undefined;
+ * concatAll([]); //=> undefined
+ * concatAll(null); //=> undefined
  */
-
 var concatAll = (0, _ramda.pipe)((0, _ramda.reduce)(_ramda.concat, leftIdentitySemigroup), (0, _ramda.when)((0, _ramda.identical)(leftIdentitySemigroup), _stubUndefined["default"]));
 var _default = concatAll;
 exports["default"] = _default;

package/lib/concatRight.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Returns the result of concatenating the given lists or strings.
  *

package/lib/copyKeys.js

@@ -2,19 +2,15 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _renameKeys = _interopRequireDefault(require("./renameKeys"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
-
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
-
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
 /**
  * Creates a new object with the own properties of the provided object, and the
  * keys copied according to the keysMap object as `{oldKey: newKey}`.

package/lib/curryRight.js

@@ -2,13 +2,9 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _curryRightN = _interopRequireDefault(require("./curryRightN"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * Returns a curried equivalent of the provided function.
  * This function is like curry, except that the provided arguments order is reversed.

package/lib/curryRightN.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Returns a curried equivalent of the provided function, with the specified arity.
  * This function is like curryN, except that the provided arguments order is reversed.
@@ -30,7 +28,6 @@ var curryRightN = (0, _ramda.curryN)(2, function (arity, fn) {
     for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
       args[_key] = arguments[_key];
     }
-
     return fn.apply(this, (0, _ramda.reverse)(args));
   });
 });

package/lib/defaultWhen.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Returns the second argument if predicate function returns `true`,
  * otherwise the third argument is returned.

package/lib/delayP.js

@@ -2,15 +2,10 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _isNonNegative = _interopRequireDefault(require("./isNonNegative"));
-
 var _isInteger = _interopRequireDefault(require("./isInteger"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * Creates a promise which resolves/rejects after the specified milliseconds.
  *
@@ -28,22 +23,20 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  * RA.delayP.reject(100); //=> Promise(undefined)
  * RA.delayP.reject({ timeout: 100, value: new Error('error') }); //=> Promise(Error('error'))
  */
+
 var makeDelay = (0, _ramda.curry)(function (settleFnPicker, opts) {
   var timeout;
   var value;
-
   if ((0, _isInteger["default"])(opts) && (0, _isNonNegative["default"])(opts)) {
     timeout = opts;
   } else {
     timeout = (0, _ramda.propOr)(0, 'timeout', opts);
     value = (0, _ramda.propOr)(value, 'value', opts);
   }
-
   return new Promise(function () {
     for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
       args[_key] = arguments[_key];
     }
-
     var settleFn = settleFnPicker(args);
     setTimeout((0, _ramda.partial)(settleFn, [value]), timeout);
   });

package/lib/dispatch.js

@@ -2,29 +2,52 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _isNotNil = _interopRequireDefault(require("./isNotNil"));
-
 var _isNonEmptyArray = _interopRequireDefault(require("./isNonEmptyArray"));
-
 var _stubUndefined = _interopRequireDefault(require("./stubUndefined"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
-
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-
 function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
-
 function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
-
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; } /**
+                                                                                                                                                                                     * Can be used as a way to compose multiple invokers together to form polymorphic functions,
+                                                                                                                                                                                     * or functions that exhibit different behaviors based on their argument(s).
+                                                                                                                                                                                     * Consumes dispatching functions and keep trying to invoke each in turn, until a non-nil value is returned.
+                                                                                                                                                                                     *
+                                                                                                                                                                                     * Accepts a list of dispatching functions and returns a new function.
+                                                                                                                                                                                     * When invoked, this new function is applied to some arguments,
+                                                                                                                                                                                     * each dispatching function is applied to those same arguments until one of the
+                                                                                                                                                                                     * dispatching functions returns a non-nil value.
+                                                                                                                                                                                     *
+                                                                                                                                                                                     * @func dispatch
+                                                                                                                                                                                     * @memberOf RA
+                                                                                                                                                                                     * @since {@link https://char0n.github.io/ramda-adjunct/2.6.0|v2.6.0}
+                                                                                                                                                                                     * @category Function
+                                                                                                                                                                                     * @sig [((a, b, ...) -> x1), ((a, b, ...) -> x2), ...] -> x1 | x2 | ...
+                                                                                                                                                                                     * @param {!Array} functions A list of functions
+                                                                                                                                                                                     * @return {*|undefined} Returns the first not-nil value, or undefined if either an empty list is provided or none of the dispatching functions returns a non-nil value
+                                                                                                                                                                                     * @see {@link RA.isNotNil}
+                                                                                                                                                                                     * @example
+                                                                                                                                                                                     *
+                                                                                                                                                                                     * // returns first non-nil value
+                                                                                                                                                                                     * const stubNil = () => null;
+                                                                                                                                                                                     * const stubUndefined = () => undefined;
+                                                                                                                                                                                     * const addOne = v => v + 1;
+                                                                                                                                                                                     * const addTwo = v => v + 2;
+                                                                                                                                                                                     *
+                                                                                                                                                                                     * RA.dispatch([stubNil, stubUndefined, addOne, addTwo])(1); //=> 2
+                                                                                                                                                                                     *
+                                                                                                                                                                                     * // acts as a switch
+                                                                                                                                                                                     * const fnSwitch = RA.dispatch([
+                                                                                                                                                                                     *   R.ifElse(RA.isString, s => `${s}-join`, RA.stubUndefined),
+                                                                                                                                                                                     *   R.ifElse(RA.isNumber, n => n + 1, RA.stubUndefined),
+                                                                                                                                                                                     *   R.ifElse(RA.isDate, R.T, RA.stubUndefined),
+                                                                                                                                                                                     * ]);
+                                                                                                                                                                                     * fnSwitch(1); //=> 2
+                                                                                                                                                                                     */
 var byArity = (0, _ramda.comparator)(function (a, b) {
   return a.length > b.length;
 });
@@ -33,18 +56,15 @@ var iteratorFn = (0, _ramda.curry)(function (args, accumulator, fn) {
   var result = fn.apply(void 0, _toConsumableArray(args));
   return (0, _isNotNil["default"])(result) ? (0, _ramda.reduced)(result) : accumulator;
 });
-
 var dispatchImpl = function dispatchImpl(functions) {
   var arity = getMaxArity(functions);
   return (0, _ramda.curryN)(arity, function () {
     for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
       args[_key] = arguments[_key];
     }
-
     return (0, _ramda.reduce)(iteratorFn(args), undefined, functions);
   });
 };
-
 var dispatch = (0, _ramda.ifElse)(_isNonEmptyArray["default"], dispatchImpl, _stubUndefined["default"]);
 var _default = dispatch;
 exports["default"] = _default;

package/lib/divideNum.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Divides two numbers, where the second number is divided by the first number.
  *

package/lib/dropArgs.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Accepts a function with any arity and returns a function with arity of zero.
  * The returned function ignores any arguments supplied to it.

package/lib/ensureArray.js

@@ -2,13 +2,9 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _isNotArray = _interopRequireDefault(require("./isNotArray"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * Returns a singleton array containing the value provided.
  * If value is already an array, it is returned as is.
@@ -26,6 +22,6 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  * RA.ensureArray(42); //=> [42]
  * RA.ensureArray([42]); //=> [42]
  */
-var ensureArray = (0, _ramda.when)(_isNotArray["default"], _ramda.of);
+var ensureArray = (0, _ramda.when)(_isNotArray["default"], (0, _ramda.of)(Array));
 var _default = ensureArray;
 exports["default"] = _default;

package/lib/escapeRegExp.js

@@ -2,13 +2,9 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _isString = _interopRequireDefault(require("./isString"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * Escapes the RegExp special characters.
  *