@valkyriestudios/utils 5.4.0 → 6.1.0

package/CHANGELOG.md

@@ -5,6 +5,60 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic
 Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [6.1.0] - 2023-04-23
+### Improved
+- Reduce eventual bundle size for package
+
+## [6.0.0] - 2023-04-22
+### Added
+- array/sort
+- string/humanizeNumber (with delim, separator, precision, units, divider) options
+- number/randomIntBetween
+- number/isAboveOrEqual
+- number/isBelowOrEqual
+- number/isIntegerAboveOrEqual
+- number/isIntegerBelowOrEqual
+- Is@NumberBelowOrEqual
+- Is@NumberAboveOrEqual
+- Is@IntegerBelowOrEqual
+- Is@IntegerAboveOrEqual
+- Is@Equal
+- Is@Eq (as alias of Is@Equal)
+- Is@NeArray (alias of Is@NotEmptyArray)
+- Is@NeObject (alias of Is@NotEmptyObject)
+- Is@NeString (alias of Is@NotEmptyString)
+- Is@Num (alias of Is@Number)
+- Is@NumBelow (alias of Is@NumberBelow)
+- Is@NumBelowOrEqual (alias of Is@NumberBelowOrEqual)
+- Is@NumAbove (alias of Is@NumberAbove)
+- Is@NumAboveOrEqual (alias of Is@NumberAboveOrEqual)
+- Is@NumBetween (alias of Is@NumberBetween)
+- Is@NumLt (alias of Is@NumberBelow)
+- Is@NumLte (alias of Is@NumberBelowOrEqual)
+- Is@NumGt (alias of Is@NumberAbove)
+- Is@NumGte (alias of Is@NumberAboveOrEqual)
+- Is@Int (alias of Is@Integer)
+- Is@IntBelow (alias of Is@IntegerBelow)
+- Is@IntBelowOrEqual (alias of Is@IntegerBelowOrEqual)
+- Is@IntAbove (alias of Is@IntegerAbove)
+- Is@IntAboveOrEqual (alias of Is@IntegerAboveOrEqual)
+- Is@IntBetween (alias of Is@IntegerBetween)
+- Is@IntLt (alias of Is@IntegerBelow)
+- Is@IntLte (alias of Is@IntegerBelowOrEqual)
+- Is@IntGt (alias of Is@IntegerAbove)
+- Is@IntGte (alias of Is@IntegerAboveOrEqual)
+
+### Improved
+- Dep: Upgrade eslint to 8.39.0
+- object/pick: Now internally validates keys as strings and autotrims keys when picking
+- number/round: Performance improvement due to usage of scientific notation not requiring math.pow
+- number/round: Will only accept integers for precision variable from now on
+- hash/guid: Is now 4x faster than previous implementation thanks to usage of bitwise operators and a precalculated hexmap (0-255), able to generate 50.000 guids in ~65ms and also no longer relying on high-performance timers
+- string/humanizeBytes: Now humanizes the real number part and allows passing a custom delimiter for natural numbers (eg: 1024 -> 1,024, 1024 {delim:'.'} -> 1.024)
+- string/humanizeBytes: Now allows passing a custom separator (eg: 10.024 {separator: ','} -> 10,024)
+- string/humanizeBytes: Now allows passing a precision variable (default:2) 
+- string/humanizeBytes: Now allows passing a custom units array (eg: humanizeBytes(1024, {units: [' Jedi', ' Darth']}) -> 1 Darth, humanizeBytes(20, {units: [' Jedi', 'Darth']}) -> 20 Jedi)
+
 ## [5.4.0] - 2023-04-08
 ### Added
 - String/humanizeBytes

package/README.md

@@ -155,6 +155,102 @@ shuffle(arr);
 // [4, 6, 3, 2, 5, 1]
 ```
 
+- **sort(val:Array[object], by:String|Function, dir:Enum(asc,desc), options:Object)**
+Sort an array of objects, uses an implementation of [Tony Hoare's quicksort](https://cs.stanford.edu/people/eroberts/courses/soco/projects/2008-09/tony-hoare/quicksort.html) 
+
+```js
+const out = sort([
+    {test: 'Peter'},
+    {test: 'Jack'},
+    {test: 'Pony'},
+    {test: 'John'},
+    {test: 'Joe'},
+    {test: 'Bob'},
+    {test: 'Alice'},
+], 'test', 'desc'); 
+// [{test: 'Pony'}, {test: 'Peter'}, {test: 'John'}, {test: 'Joe'}, {test: 'Jack'}, {test: 'Bob'}, {test: 'Alice'}]
+```
+
+```js
+const out = sort([
+    {test: 'Peter'},
+    {test: 'Jack'},
+    {test: 'Pony'},
+    {test: 'John'},
+    {test: 'Joe'},
+    {test: 'Bob'},
+    {test: 'Alice'},
+], 'test', 'asc'); 
+// [{test: 'Alice'}, {test: 'Bob'}, {test: 'Jack'}, {test: 'Joe'}, {test: 'John'}, {test: 'Peter'}, {test: 'Pony'}]
+```
+
+allows passing a function to determine the key to sort by
+
+```js
+const out = sort([
+    {test: 'Peter'},
+    {test: 'Jack'},
+    {test: 'Pony'},
+    {test: 'JOHn'},
+    {test: 'Joe'},
+    {test: 'Bob'},
+    {test: 'Alice'},
+], el => el.test.toLowerCase(), 'desc'); 
+// [{test: 'Pony'}, {test: 'Peter'}, {test: 'JOHn'}, {test: 'Joe'}, {test: 'Jack'}, {test: 'Bob'}, {test: 'Alice'}]
+```
+
+auto-cleans input to only contains non-empty objects
+
+```js
+const out = sort([
+    {test: 'Peter'},
+    {},
+    {test: 'Jack'},
+    {test: 'Pony'},
+    {test: 'JOHn'},
+    false,
+    {test: 'Joe'},
+    {test: 'Bob'},
+    undefined,
+    {test: 'Alice'},
+], el => el.test.toLowerCase(), 'desc'); 
+// [{test: 'Pony'}, {test: 'Peter'}, {test: 'JOHn'}, {test: 'Joe'}, {test: 'Jack'}, {test: 'Bob'}, {test: 'Alice'}]
+```
+
+allows passing custom filter function to clean input
+
+```js
+const out = sort([
+    {test: 'Peter'},
+    {},
+    {test: 'Jack'},
+    {test: 'Pony'},
+    {test: false},
+    {test: 'JOHn'},
+    false,
+    {test: 'Joe'},
+    {test: undefined},
+    {test: 'Bob'},
+    undefined,
+    {test: 'Alice'},
+], el => el.test.toLowerCase(), 'desc', {filter_fn: el => isObject(el) && isNotEmptyString(el.test)}); 
+// [{test: 'Pony'}, {test: 'Peter'}, {test: 'JOHn'}, {test: 'Joe'}, {test: 'Jack'}, {test: 'Bob'}, {test: 'Alice'}]
+```
+
+allows passing custom options to position elements without a proper key (nokey_atend, defaults to true), or hide them (nokey_hide, defaults to false)
+
+```js
+const arr = [{test: 'Peter'}, {test: undefined}, {test: 'Jack'}, {test: 'Pony'}, {uid: 100}, {test: 'JOHn'}];
+const out = sort(arr, el => el.test.toLowerCase(), 'desc', {nokey_atend: false}); 
+// [{test: undefined}, {uid: 100}, {test: 'Pony'}, {test: 'Peter'}, {test: 'JOHn'}, {test: 'Jack'}]
+
+const out = sort(arr, el => el.test.toLowerCase(), 'desc', {nokey_atend: true}); 
+// [{test: 'Pony'}, {test: 'Peter'}, {test: 'JOHn'}, {test: 'Jack'}, {test: undefined}, {uid: 100}]
+
+const out = sort(arr, el => el.test.toLowerCase(), 'desc', {nokey_hide: true}); 
+// [{test: 'Pony'}, {test: 'Peter'}, {test: 'JOHn'}, {test: 'Jack'}]
+```
+
 ### boolean
 - **isBoolean(val:any)**
 Check if a variable is of type Boolean
@@ -331,7 +427,7 @@ isNumber(0.5); // TRUE
 ```
 
 - **isNumberAbove(val:number, comp:number)**
-Check if a variable is above a certain bound
+Check if a variable is a number above a certain bound
 ```js
 isNumberAbove(5, 0); // TRUE
 isNumberAbove(.1, 0); // TRUE
@@ -339,8 +435,17 @@ isNumberAbove(-1, -1); // FALSE
 isNumberAbove(-10, -9); // FALSE
 ```
 
+- **isNumberAboveOrEqual(val:number, comp:number)**
+Check if a variable is a number above or equal to a certain bound
+```js
+isNumberAboveOrEqual(5, 0); // TRUE
+isNumberAboveOrEqual(.1, 0); // TRUE
+isNumberAboveOrEqual(-1, -1); // TRUE
+isNumberAboveOrEqual(-10, -9); // FALSE
+```
+
 - **isNumberBelow(val:number, comp:number)**
-Check if a variable is below a certain bound
+Check if a variable is a number below a certain bound
 ```js
 isNumberBelow(0, 5); // TRUE
 isNumberBelow(0, .1); // TRUE
@@ -348,8 +453,17 @@ isNumberBelow(-1, -1); // FALSE
 isNumberBelow(-9, -10); // FALSE
 ```
 
+- **isNumberBelowOrEqual(val:number, comp:number)**
+Check if a variable is a number below or equal a certain bound
+```js
+isNumberBelowOrEqual(0, 5); // TRUE
+isNumberBelowOrEqual(0, .1); // TRUE
+isNumberBelowOrEqual(-1, -1); // TRUE
+isNumberBelowOrEqual(-9, -10); // FALSE
+```
+
 - **isNumberBetween(val:number, min:number, max:number)**
-Check if a variable is between a range of numbers
+Check if a variable is a number between a range of numbers
 ```js
 isNumberBetween(5, 0, 10); // TRUE
 isNumberBetween(.1, 0, 1); // TRUE
@@ -375,16 +489,35 @@ isIntegerAbove(-1, -1); // FALSE
 isIntegerAbove(-10, -9); // FALSE
 ```
 
+- **isIntegerAboveOrEqual(val:number, comp:number)**
+Check if a variable is an integer above or equal to a certain bound
+```js
+isIntegerAboveOrEqual(5, 0); // TRUE
+isIntegerAboveOrEqual(.1, 0); // FALSE
+isIntegerAboveOrEqual(-1, -1); // TRUE
+isIntegerAboveOrEqual(-10, -9); // FALSE
+```
+
 - **isIntegerBelow(val:number, comp:number)**
 Check if a variable is an integer below a certain bound
 ```js
 isIntegerBelow(0, 5); // TRUE
 isIntegerBelow(0, .1); // TRUE
-isIntegerBelow(.4, 5); // FALsE
+isIntegerBelow(.4, 5); // FALSE
 isIntegerBelow(-1, -1); // FALSE
 isIntegerBelow(-9, -10); // FALSE
 ```
 
+- **isIntegerBelowOrEqual(val:number, comp:number)**
+Check if a variable is an integer below or equal to a certain bound
+```js
+isIntegerBelowOrEqual(0, 5); // TRUE
+isIntegerBelowOrEqual(0, .1); // TRUE
+isIntegerBelowOrEqual(.4, 5); // FALSE
+isIntegerBelowOrEqual(-1, -1); // TRUE
+isIntegerBelowOrEqual(-9, -10); // FALSE
+```
+
 - **isIntegerBetween(val:number, min:number, max:number)**
 Check if a variable is an integer between a range of numbers
 ```js
@@ -425,6 +558,13 @@ randomBetween(); // Will generate a random between 0 and 10
 randomBetween(25, 100); // Will generate a random between 25 and 100
 ```
 
+- **randomIntBetween(min:Number=0,max:Number=10)**
+Generate a random numeric value between a min and max range (max not inclusive)
+```js
+randomIntBetween(); // Will generate a random between 0 and 10 (10 not inclusive)
+randomIntBetween(25, 100); // Will generate a random between 25 and 100 (100 not inclusive)
+```
+
 ### object
 - **forValues(obj:Object={}, cb:Function=noopreturn)**
 Iterate over the keys of the object and apply the callback function to their values
@@ -575,6 +715,10 @@ shorten('To the moon and beyond', 11, ' '); // 'To the moon '
 
 - **humanizeBytes(val:number|string)**
 Humanize an amount of bytes
+-- option:delim (default:','): Override the delimiter used, eg: `20000 -> 20,000`
+-- option:separator (default:'.'): Override the separator used for floats, eg: '20.034' -> '20,034'
+-- option:precision (default:2):  Override decimal precision for floats: eg: '20.0344233' with precision 2 -> '20.03'
+-- option:units (default:[' byes', ' KB', ' MB', ' GB', ' TB', ' PB', ' EB', ' ZB', ' YB']): Override units used, eg: `4893290423489 with units [' Jedi', ' Darth', ' Vader', ' Force'] and precision of 0` -> `'4,893 Force'`
 ```js
 humanizeBytes(1504230); // '1.4 MB'
 humanizeBytes(23); // '23 bytes'
@@ -582,6 +726,24 @@ humanizeBytes(-374237489237); // '-348.5 GB'
 humanizeBytes('-1504230'); // '-1.4 MB'
 ```
 
+- **humanizeNumber(val:number|string, options:Object)**
+Humanize a number
+-- option:delim (default:','): Override the delimiter used, eg: `20000 -> 20,000`
+-- option:separator (default:'.'): Override the separator used for floats, eg: '20.034' -> '20,034'
+-- option:precision (default:2):  Override decimal precision for floats: eg: '20.0344233' with precision 2 -> '20.03'
+-- option:units (default:['', 'k', 'm', 'b', 't', 'q']): Override units used, eg: `1073741823 with units ['', 'K']` -> `1.073.741,82K`
+-- option:real (default:false): Set to true to automatically round input numbers
+-- option:divider (default:1000): Override default divider used for units (used internally for humanizeBytes with 1024 as divider)
+
+```js
+humanizeNumber(4327963279469432); // '4.33q'
+humanizeNumber(1504230); // '1.5m'
+humanizeNumber(-432443); // '-432.44k'
+humanizeNumber('-1500'); // '-1.5k'
+humanizeNumber(47328748923747923479); // '47,328.75q'
+```
+
+allows passing options to control the output, following options are possible:
+
 ## Contributors
 - Peter Vermeulen : [Valkyrie Studios](www.valkyriestudios.be) 
-

package/array/dedupe.js

@@ -3,11 +3,11 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
-exports["default"] = _default;
+exports["default"] = dedupe;
 var _fnv1A = _interopRequireDefault(require("../hash/fnv1A"));
 var _isNotEmpty = _interopRequireDefault(require("./isNotEmpty"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-function _default() {
+function dedupe() {
   var val = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
   if (!(0, _isNotEmpty["default"])(val)) return [];
   var seen = {};

package/array/is.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
-exports["default"] = _default;
-function _default(val) {
+exports["default"] = isArray;
+function isArray(val) {
   return Array.isArray(val);
 }

package/array/isNotEmpty.js

@@ -3,10 +3,10 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
-exports["default"] = _default;
+exports["default"] = isNotEmptyArray;
 var _is = _interopRequireDefault(require("./is"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-function _default(val) {
+function isNotEmptyArray(val) {
   if (!(0, _is["default"])(val)) return !1;
   return val.length !== 0;
 }

package/array/join.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
-exports["default"] = _default;
+exports["default"] = join;
 var _isNotEmpty = _interopRequireDefault(require("./isNotEmpty"));
 var _isNotEmpty2 = _interopRequireDefault(require("../string/isNotEmpty"));
 var _is = _interopRequireDefault(require("../number/is"));
@@ -13,7 +13,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: !0 }; return { done: !1, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = !0, didErr = !1, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = !0; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
 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 _default(arr) {
+function join(arr) {
   var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
   if (!(0, _isNotEmpty["default"])(arr)) return '';
   var OPTS = Object.assign({

package/array/mapFn.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
-exports["default"] = _default;
+exports["default"] = mapFn;
 var _is = _interopRequireDefault(require("../object/is"));
 var _isNotEmpty = _interopRequireDefault(require("./isNotEmpty"));
 var _is2 = _interopRequireDefault(require("../function/is"));
@@ -13,7 +13,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: !0 }; return { done: !1, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = !0, didErr = !1, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = !0; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
 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 _default(arr, fn) {
+function mapFn(arr, fn) {
   var opts = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
   if (!(0, _isNotEmpty["default"])(arr) || !(0, _is2["default"])(fn)) return {};
   var OPTS = Object.assign({

package/array/mapKey.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
-exports["default"] = _default;
+exports["default"] = mapKey;
 var _is = _interopRequireDefault(require("../object/is"));
 var _isNotEmpty = _interopRequireDefault(require("./isNotEmpty"));
 var _isNotEmpty2 = _interopRequireDefault(require("../string/isNotEmpty"));
@@ -11,7 +11,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: !0 }; return { done: !1, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = !0, didErr = !1, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = !0; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
 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 _default(arr, key) {
+function mapKey(arr, key) {
   var opts = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
   if (!(0, _isNotEmpty["default"])(arr) || !(0, _isNotEmpty2["default"])(key)) return {};
   var OPTS = Object.assign({

package/array/mapPrimitive.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
-exports["default"] = _default;
+exports["default"] = mapPrimitive;
 var _is = _interopRequireDefault(require("../number/is"));
 var _isNotEmpty = _interopRequireDefault(require("../string/isNotEmpty"));
 var _isNotEmpty2 = _interopRequireDefault(require("./isNotEmpty"));
@@ -12,7 +12,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: !0 }; return { done: !1, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = !0, didErr = !1, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = !0; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
 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 _default(arr) {
+function mapPrimitive(arr) {
   var opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
   if (!(0, _isNotEmpty2["default"])(arr)) return {};
   var OPTS = Object.assign({

package/array/sort.js

@@ -0,0 +1,123 @@
+'use strict';
+
+Object.defineProperty(exports, "__esModule", {
+  value: !0
+});
+exports["default"] = sort;
+var _is = _interopRequireDefault(require("../boolean/is"));
+var _isNotEmpty = _interopRequireDefault(require("./isNotEmpty"));
+var _is2 = _interopRequireDefault(require("../object/is"));
+var _isNotEmpty2 = _interopRequireDefault(require("../object/isNotEmpty"));
+var _isNotEmpty3 = _interopRequireDefault(require("../string/isNotEmpty"));
+var _is3 = _interopRequireDefault(require("../function/is"));
+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 _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 _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: !0 }; return { done: !1, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = !0, didErr = !1, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = !0; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+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 partition(arr, start_ix, end_ix) {
+  var pivotVal = arr[Math.floor((start_ix + end_ix) / 2)].t;
+  while (start_ix <= end_ix) {
+    while (arr[start_ix].t < pivotVal) {
+      start_ix++;
+    }
+    while (arr[end_ix].t > pivotVal) {
+      end_ix--;
+    }
+    if (start_ix <= end_ix) {
+      var temp = arr[start_ix];
+      arr[start_ix] = arr[end_ix];
+      arr[end_ix] = temp;
+      start_ix++;
+      end_ix--;
+    }
+  }
+  return start_ix;
+}
+function quickSort(arr) {
+  var start_ix = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+  var end_ix = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : arr.length - 1;
+  if (start_ix < end_ix) {
+    var ix = partition(arr, start_ix, end_ix);
+    quickSort(arr, start_ix, ix - 1);
+    quickSort(arr, ix, end_ix);
+  }
+  return arr;
+}
+function sort(arr, by) {
+  var dir = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'asc';
+  var options = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
+  if (!(0, _isNotEmpty["default"])(arr)) return [];
+  if (!(0, _isNotEmpty3["default"])(by) && !(0, _is3["default"])(by)) throw new Error('Sort by should be either a string or a function');
+  if (dir !== 'asc' && dir !== 'desc') throw new Error('dir should be either asc or desc');
+  var OPTS = {
+    filter_fn: (0, _is2["default"])(options) && (0, _is3["default"])(options.filter_fn) ? options.filter_fn : _isNotEmpty2["default"],
+    nokey_hide: (0, _is2["default"])(options) && (0, _is["default"])(options.nokey_hide) ? options.nokey_hide : !1,
+    nokey_atend: (0, _is2["default"])(options) && (0, _is["default"])(options.nokey_atend) ? options.nokey_atend : !0
+  };
+  var prepared_arr = [];
+  var nokey_arr = [];
+  if ((0, _isNotEmpty3["default"])(by)) {
+    var _iterator = _createForOfIteratorHelper(arr),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var el = _step.value;
+        if (!OPTS.filter_fn(el)) continue;
+        if (!el.hasOwnProperty(by) || el[by] === undefined) {
+          nokey_arr.push(el);
+        } else {
+          prepared_arr.push({
+            t: el[by],
+            el: el
+          });
+        }
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+  } else {
+    var key;
+    var _iterator2 = _createForOfIteratorHelper(arr),
+      _step2;
+    try {
+      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+        var _el = _step2.value;
+        if (!OPTS.filter_fn(_el)) continue;
+        key = by(_el);
+        if (key === undefined) {
+          nokey_arr.push(_el);
+        } else {
+          prepared_arr.push({
+            t: by(_el),
+            el: _el
+          });
+        }
+      }
+    } catch (err) {
+      _iterator2.e(err);
+    } finally {
+      _iterator2.f();
+    }
+  }
+  quickSort(prepared_arr);
+  if (dir === 'desc') prepared_arr.reverse();
+  if (OPTS.nokey_hide) {
+    return prepared_arr.map(function (obj) {
+      return obj.el;
+    });
+  } else if (OPTS.nokey_atend) {
+    return [].concat(_toConsumableArray(prepared_arr.map(function (obj) {
+      return obj.el;
+    })), nokey_arr);
+  } else {
+    return [].concat(nokey_arr, _toConsumableArray(prepared_arr.map(function (obj) {
+      return obj.el;
+    })));
+  }
+}

package/boolean/is.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
-exports["default"] = _default;
-function _default(val) {
+exports["default"] = isBoolean;
+function isBoolean(val) {
   return val === !0 || val === !1 || typeof val === 'boolean' || val instanceof Boolean;
 }

package/caching/memoize.js

@@ -3,10 +3,10 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
-exports["default"] = _default;
+exports["default"] = memoize;
 var _is = _interopRequireDefault(require("../function/is"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-function _default(fn) {
+function memoize(fn) {
   var resolver = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : !1;
   var has_resolver = (0, _is["default"])(resolver);
   var memoized = function memoized() {

package/date/is.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
-exports["default"] = _default;
-function _default(val) {
+exports["default"] = isDate;
+function isDate(val) {
   return Object.prototype.toString.call(val) === '[object Date]';
 }

package/deep/define.js

@@ -3,10 +3,10 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
-exports["default"] = _default;
+exports["default"] = deepDefine;
 var _set = _interopRequireDefault(require("./set"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-function _default(obj, path) {
+function deepDefine(obj, path) {
   var value = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
   return (0, _set["default"])(obj, path, value, !0);
 }

package/deep/freeze.js

@@ -3,22 +3,20 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
-exports["default"] = _default;
+exports["default"] = deepFreeze;
 var _is = _interopRequireDefault(require("../object/is"));
 var _is2 = _interopRequireDefault(require("../array/is"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 function deep(obj) {
   var next = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : Object.seal;
   (Object.keys(obj) || []).forEach(function (key) {
-    if ((0, _is["default"])(obj[key] || !1) || (0, _is2["default"])(obj[key] || !1)) {
+    if ((0, _is["default"])(obj[key]) || (0, _is2["default"])(obj[key])) {
       deep(obj[key], next);
     }
   });
   return next(obj);
 }
-function _default(obj) {
-  if (!(0, _is["default"])(obj) && !(0, _is2["default"])(obj)) {
-    throw new TypeError('Only objects can be frozen');
-  }
+function deepFreeze(obj) {
+  if (!(0, _is["default"])(obj) && !(0, _is2["default"])(obj)) throw new TypeError('Only objects can be frozen');
   return deep(obj, Object.freeze);
 }

package/deep/get.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
-exports["default"] = _default;
+exports["default"] = deepGet;
 var _is = _interopRequireDefault(require("../object/is"));
 var _is2 = _interopRequireDefault(require("../array/is"));
 var _isNotEmpty = _interopRequireDefault(require("../string/isNotEmpty"));
@@ -19,7 +19,7 @@ function interpolatePath(path) {
   if ((0, _is2["default"])(path)) return _toConsumableArray(path);
   return path.replace('[', '.').replace(']', '').split('.');
 }
-function _default(obj, path) {
+function deepGet(obj, path) {
   var get_parent = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : !1;
   if (!(0, _is["default"])(obj) && !(0, _is2["default"])(obj)) throw new TypeError('Deepget is only supported for objects');
   var parts = interpolatePath(path);