ramda-adjunct 3.2.0 → 3.4.0

package/lib/resolveP.js

@@ -2,11 +2,8 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /* eslint-disable max-len */
-
 /**
  * Composable shortcut for `Promise.resolve`.
  *
@@ -28,7 +25,6 @@ var _ramda = require("ramda");
  * RA.resolveP('a'); //=> Promise('a')
  * RA.resolveP([1, 2, 3]); //=> Promise([1, 2, 3])
  */
-
 /* eslint-enable max-len */
 var resolveP = (0, _ramda.bind)(Promise.resolve, Promise);
 var _default = resolveP;

package/lib/round.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Returns the value of a number rounded to the nearest integer.
  *
@@ -25,6 +23,7 @@ var _ramda = require("ramda");
  * RA.round(-5.5); //=> -5
  * RA.round(-5.95); //=> -6
  */
+
 var round = (0, _ramda.curryN)(1, (0, _ramda.bind)(Math.round, Math));
 var _default = round;
 exports["default"] = _default;

package/lib/seq.js

@@ -2,11 +2,8 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /* eslint-disable max-len */
-
 /**
  * Runs the given list of functions in order with the supplied object, then returns the object.
  * Also known as the normal order sequencing combinator.
@@ -37,8 +34,8 @@ var _ramda = require("ramda");
  *   R.toUpper
  * )('test'); //=> 'PREFIX TEST'
  */
-
 /* eslint-enable max-len */
+
 var seq = (0, _ramda.curry)(function (fns, x) {
   return (0, _ramda.tap)(function (tx) {
     return (0, _ramda.map)(function (fn) {

package/lib/sign.js

@@ -2,16 +2,12 @@
 
 exports.__esModule = true;
 exports.signPonyfill = exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _isFunction = _interopRequireDefault(require("./isFunction"));
-
 var _Math = _interopRequireDefault(require("./internal/ponyfills/Math.sign"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 var signPonyfill = (0, _ramda.curryN)(1, _Math["default"]);
+
 /**
  * Returns the sign of a number, indicating whether the number is positive, negative or zero.
  *
@@ -32,7 +28,6 @@ var signPonyfill = (0, _ramda.curryN)(1, _Math["default"]);
  * RA.sign(NaN); // NaN
  * RA.sign('foo'); // NaN
  */
-
 exports.signPonyfill = signPonyfill;
 var sign = (0, _isFunction["default"])(Math.sign) ? (0, _ramda.curryN)(1, (0, _ramda.bind)(Math.sign, Math)) : signPonyfill;
 var _default = sign;

package/lib/skipTake.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * When given a number n and an array, returns an array containing every nth element.
  *
@@ -21,6 +19,7 @@ var _ramda = require("ramda");
  * RA.skipTake(2, [1,2,3,4]) //=> [1, 3]
  * RA.skipTake(3, R.range(0, 20)); //=> [0, 3, 6, 9, 12, 15, 18]
  */
+
 var skipTake = (0, _ramda.curry)(function (n, list) {
   return (0, _ramda.addIndex)(_ramda.filter)((0, _ramda.pipe)((0, _ramda.nthArg)(1), (0, _ramda.modulo)(_ramda.__, n), (0, _ramda.identical)(0)))(list);
 });

package/lib/sliceFrom.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Returns the elements of the given list or string (or object with a slice method)
  * from fromIndex (inclusive).

package/lib/sliceTo.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Returns the elements of the given list or string (or object with a slice method)
  * to toIndex (exclusive).

package/lib/sortByPaths.js

@@ -2,11 +2,10 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var pathToAscendSort = (0, _ramda.pipe)(_ramda.path, _ramda.ascend);
 var mapPathsToAscendSort = (0, _ramda.map)(pathToAscendSort);
+
 /**
  * Sort a list of objects by a list of paths (if first path value is equivalent, sort by second, etc).
  *

package/lib/sortByProp.js

@@ -0,0 +1,47 @@
+"use strict";
+
+exports.__esModule = true;
+exports["default"] = void 0;
+var _ramda = require("ramda");
+var _sortByProps = _interopRequireDefault(require("./sortByProps"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+/**
+ * Sort a list of objects by a property.
+ *
+ * @func sortByProp
+ * @memberOf RA
+ * @since {@link https://char0n.github.io/ramda-adjunct/3.4.0|v3.4.0}
+ * @category List
+ * @sig k -> [{k: v}] -> [{k: v}]
+ * @param {Array.<string>} prop The property in the list param to sort by
+ * @param {Array.<object>} list A list of objects to be sorted
+ * @return {Array.<object>} A new list sorted by the property in the prop param
+ * @example
+ *
+ * // sorting list of tuples
+ * const sortByFirstItem = sortByProp(0);
+ * const listOfTuples = [[-1, 1], [-2, 2], [-3, 3]];
+ * sortByFirstItem(listOfTuples); // => [[-3, 3], [-2, 2], [-1, 1]]
+ *
+ * // sorting list of objects
+ * const sortByName = sortByProp('name');
+ * const alice = {
+ *   name: 'ALICE',
+ *   age: 101,
+ * };
+ * const bob = {
+ *   name: 'Bob',
+ *   age: -10,
+ * };
+ * const clara = {
+ *   name: 'clara',
+ *   age: 314.159,
+ * };
+ * const people = [clara, bob, alice];
+ * sortByName(people); // => [alice, bob, clara]
+ */
+
+var addValueInAnArray = (0, _ramda.append)(_ramda.__, []);
+var sortByProp = (0, _ramda.useWith)(_sortByProps["default"], [addValueInAnArray, _ramda.identity]);
+var _default = sortByProp;
+exports["default"] = _default;

package/lib/sortByProps.js

@@ -2,21 +2,13 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 function _toArray(arr) { return _arrayWithHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableRest(); }
-
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure 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 _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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
-
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
-
 /**
  * Sort a list of objects by a list of props (if first prop value is equivalent, sort by second, etc).
  *
@@ -37,21 +29,19 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
  * sortByProps(['name', 'num'], [{num: 3}, {num: 2}, {num: 1}])
  * //=> [{num: 1}, {num: 2}, {num: 3}]
  */
+
 var sortByProps = (0, _ramda.curry)(function (props, list) {
   var firstTruthy = function firstTruthy(_ref) {
     var _ref2 = _toArray(_ref),
-        head = _ref2[0],
-        tail = _ref2.slice(1);
-
+      head = _ref2[0],
+      tail = _ref2.slice(1);
     return (0, _ramda.reduce)(_ramda.either, head, tail);
   };
-
   var makeComparator = function makeComparator(propName) {
     return (0, _ramda.comparator)(function (a, b) {
       return (0, _ramda.lt)((0, _ramda.prop)(propName, a), (0, _ramda.prop)(propName, b));
     });
   };
-
   return (0, _ramda.sort)(firstTruthy((0, _ramda.map)(makeComparator, props)), list);
 });
 var _default = sortByProps;

package/lib/spreadPath.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Spreads object under property path onto provided object.
  * It's like {@link RA.flattenPath|flattenPath}, but removes object under the property path.

package/lib/spreadProp.js

@@ -2,13 +2,9 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _spreadPath = _interopRequireDefault(require("./spreadPath"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * Spreads object under property onto provided object.
  * It's like {@link RA.flattenProp|flattenProp}, but removes object under the property.

package/lib/stubArray.js

@@ -2,7 +2,6 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 /**
  * A function that returns new empty array on every call.
  *
@@ -17,9 +16,9 @@ exports["default"] = void 0;
  * RA.stubArray(); //=> []
  * RA.stubArray(1, 2, 3); //=> []
  */
+
 var stubArray = function stubArray() {
   return [];
 };
-
 var _default = stubArray;
 exports["default"] = _default;

package/lib/stubNull.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * A function that returns `null`.
  *

package/lib/stubObj.js

@@ -2,7 +2,6 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 /**
  * This function returns a new empty object.
  *
@@ -18,9 +17,9 @@ exports["default"] = void 0;
  * RA.stubObj(); //=> {}
  * RA.stubObj(1, 2, 3); //=> {}
  */
+
 var stubObj = function stubObj() {
   return {};
 };
-
 var _default = stubObj;
 exports["default"] = _default;

package/lib/stubString.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * A function that returns empty string.
  *

package/lib/stubUndefined.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * A function that returns `undefined`.
  *
@@ -20,6 +18,5 @@ var _ramda = require("ramda");
  * RA.stubUndefined(1, 2, 3); //=> undefined
  */
 var stubUndefined = (0, _ramda.always)(void 0); // eslint-disable-line no-void
-
 var _default = stubUndefined;
 exports["default"] = _default;

package/lib/subtractNum.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Subtracts its first argument from its second argument.
  *

package/lib/thenCatchP.js

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

package/lib/toArray.js

@@ -2,20 +2,15 @@
 
 exports.__esModule = true;
 exports.fromPonyfill = exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _isIterable = _interopRequireDefault(require("./isIterable"));
-
 var _isFunction = _interopRequireDefault(require("./isFunction"));
-
 var _Array = _interopRequireDefault(require("./internal/ponyfills/Array.from"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 var fromPonyfill = (0, _ramda.curryN)(1, _Array["default"]);
 exports.fromPonyfill = fromPonyfill;
 var fromArray = (0, _isFunction["default"])(Array.from) ? (0, _ramda.curryN)(1, Array.from) : fromPonyfill;
+
 /**
  * Converts value to an array.
  *

package/lib/toInteger32.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Converts double-precision 64-bit binary format IEEE 754 to signed 32 bit integer number.
  *

package/lib/toNumber.js

@@ -2,13 +2,9 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _isCoercible = _interopRequireDefault(require("./internal/isCoercible"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * Converts value to a number.
  *

package/lib/toUinteger32.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Converts double-precision 64-bit binary format IEEE 754 to unsigned 32 bit integer number.
  *
@@ -24,6 +22,7 @@ var _ramda = require("ramda");
  * RA.toInteger32(2 ** 31); // => 2147483648
  * RA.toInteger32(2 ** 30); // => 1073741824
  */
+
 // eslint-disable-next-line no-bitwise
 var toUinteger32 = (0, _ramda.curryN)(1, function (val) {
   return val >>> 0;

package/lib/trimCharsEnd.js

@@ -2,13 +2,9 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _included = _interopRequireDefault(require("./included"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * Removes specified characters from the end of a string.
  *
@@ -24,6 +20,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  *
  * RA.trimCharsEnd('_-', '-_-abc-_-'); //=> '-_-abc'
  */
+
 var trimCharsEnd = (0, _ramda.curry)(function (chars, value) {
   return (0, _ramda.pipe)((0, _ramda.split)(''), (0, _ramda.dropLastWhile)((0, _included["default"])(chars)), (0, _ramda.join)(''))(value);
 });

package/lib/trimCharsStart.js

@@ -2,13 +2,9 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _included = _interopRequireDefault(require("./included"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * Removes specified characters from the beginning of a string.
  *
@@ -24,6 +20,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  *
  * RA.trimCharsStart('_-', '-_-abc-_-'); //=> 'abc-_-'
  */
+
 var trimCharsStart = (0, _ramda.curry)(function (chars, value) {
   return (0, _ramda.pipe)((0, _ramda.split)(''), (0, _ramda.dropWhile)((0, _included["default"])(chars)), (0, _ramda.join)(''))(value);
 });

package/lib/trimEnd.js

@@ -2,18 +2,14 @@
 
 exports.__esModule = true;
 exports.trimEndPonyfill = exports.trimEndInvoker = exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _String = _interopRequireDefault(require("./internal/ponyfills/String.trimEnd"));
-
 var _isFunction = _interopRequireDefault(require("./isFunction"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 var trimEndPonyfill = _String["default"];
 exports.trimEndPonyfill = trimEndPonyfill;
 var trimEndInvoker = (0, _ramda.invoker)(0, 'trimEnd');
+
 /**
  * Removes whitespace from the end of a string.
  *
@@ -29,7 +25,6 @@ var trimEndInvoker = (0, _ramda.invoker)(0, 'trimEnd');
  *
  * RA.trimEnd('abc   '); //=> 'abc'
  */
-
 exports.trimEndInvoker = trimEndInvoker;
 var trimEnd = (0, _isFunction["default"])(String.prototype.trimEnd) ? trimEndInvoker : trimEndPonyfill;
 var _default = trimEnd;

package/lib/trimStart.js

@@ -2,18 +2,14 @@
 
 exports.__esModule = true;
 exports.trimStartPonyfill = exports.trimStartInvoker = exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _String = _interopRequireDefault(require("./internal/ponyfills/String.trimStart"));
-
 var _isFunction = _interopRequireDefault(require("./isFunction"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 var trimStartPonyfill = _String["default"];
 exports.trimStartPonyfill = trimStartPonyfill;
 var trimStartInvoker = (0, _ramda.invoker)(0, 'trimStart');
+
 /**
  * Removes whitespace from the beginning of a string.
  *
@@ -28,7 +24,6 @@ var trimStartInvoker = (0, _ramda.invoker)(0, 'trimStart');
  *
  * RA.trimStart('  abc'); //=> 'abc'
  */
-
 exports.trimStartInvoker = trimStartInvoker;
 var trimStart = (0, _isFunction["default"])(String.prototype.trimStart) ? trimStartInvoker : trimStartPonyfill;
 var _default = trimStart;

package/lib/trunc.js

@@ -2,16 +2,12 @@
 
 exports.__esModule = true;
 exports.truncPonyfill = exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _Math = _interopRequireDefault(require("./internal/ponyfills/Math.trunc"));
-
 var _isFunction = _interopRequireDefault(require("./isFunction"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 var truncPonyfill = (0, _ramda.curryN)(1, _Math["default"]);
+
 /**
  * Returns the integer part of a number by removing any fractional digits.
  *
@@ -32,7 +28,6 @@ var truncPonyfill = (0, _ramda.curryN)(1, _Math["default"]);
  * RA.trunc(NaN); //=> NaN
  * RA.trunc('foo'); //=> NaN
  */
-
 exports.truncPonyfill = truncPonyfill;
 var trunc = (0, _isFunction["default"])(Math.trunc) ? (0, _ramda.curryN)(1, (0, _ramda.bind)(Math.trunc, Math)) : truncPonyfill;
 var _default = trunc;

package/lib/unzipObjWith.js

@@ -2,13 +2,9 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 var _lengthEq = _interopRequireDefault(require("./lengthEq"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * Creates a new list out of the supplied object by applying the function to each key/value pairing.
  *

package/lib/viewOr.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Returns a "view" of the given data structure, determined by the given lens.
  * The lens's focus determines which portion of the data structure is visible.
@@ -29,6 +27,7 @@ var _ramda = require("ramda");
  * RA.viewOr('some', R.lensProp('y'), { y: null }); // => 'some'
  * RA.viewOr('some', R.lensProp('y'), { y: false }); // => false
  */
+
 var viewOr = (0, _ramda.curryN)(3, function (defaultValue, lens, data) {
   return (0, _ramda.defaultTo)(defaultValue, (0, _ramda.view)(lens, data));
 });

package/lib/weave.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Weaves a configuration into function returning the runnable monad like `Reader` or `Free`.
  * This allows us to pre-bind the configuration in advance and use the weaved function

package/lib/weaveLazy.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Weaves a configuration into function returning the runnable monad like `Reader` or `Free`.
  * This allows us to pre-bind the configuration in advance and use the weaved function

package/lib/zipObjWith.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
-
 var _ramda = require("ramda");
-
 /**
  * Creates a new object out of a list of keys and a list of values by applying the function
  * to each equally-positioned pair in the lists.