@valkyriestudios/utils 7.5.0 → 8.1.0

package/number/isIntegerAboveOrEqual.js

@@ -1,13 +1,8 @@
 'use strict';
-
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = isIntegerAboveOrEqual;
-var _is = _interopRequireDefault(require("../number/is"));
-var _isInteger = _interopRequireDefault(require("../number/isInteger"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 function isIntegerAboveOrEqual(val, ref) {
-  if (!(0, _isInteger["default"])(val) || !(0, _is["default"])(ref)) return !1;
-  return val >= ref;
+  return !Number.isInteger(val) || !Number.isFinite(ref) ? !1 : val >= ref;
 }

package/number/isIntegerBelow.js

@@ -1,13 +1,8 @@
 'use strict';
-
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = isIntegerBelow;
-var _is = _interopRequireDefault(require("../number/is"));
-var _isInteger = _interopRequireDefault(require("../number/isInteger"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 function isIntegerBelow(val, ref) {
-  if (!(0, _isInteger["default"])(val) || !(0, _is["default"])(ref)) return !1;
-  return val < ref;
+  return !Number.isInteger(val) || !Number.isFinite(ref) ? !1 : val < ref;
 }

package/number/isIntegerBelowOrEqual.js

@@ -1,13 +1,8 @@
 'use strict';
-
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = isIntegerBelowOrEqual;
-var _is = _interopRequireDefault(require("../number/is"));
-var _isInteger = _interopRequireDefault(require("../number/isInteger"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 function isIntegerBelowOrEqual(val, ref) {
-  if (!(0, _isInteger["default"])(val) || !(0, _is["default"])(ref)) return !1;
-  return val <= ref;
+  return !Number.isInteger(val) || !Number.isFinite(ref) ? !1 : val <= ref;
 }

package/number/isIntegerBetween.js

@@ -1,13 +1,9 @@
 'use strict';
-
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = isIntegerBetween;
-var _is = _interopRequireDefault(require("../number/is"));
-var _isInteger = _interopRequireDefault(require("../number/isInteger"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 function isIntegerBetween(val, min, max) {
-  if (!(0, _isInteger["default"])(val) || !(0, _is["default"])(min) || !(0, _is["default"])(max) || min >= max) return !1;
+  if (!Number.isInteger(val) || !Number.isFinite(min) || !Number.isFinite(max) || min >= max) return !1;
   return val >= min && val <= max;
 }

package/number/isNumericalNaN.js

@@ -1,8 +1,9 @@
 'use strict';
+
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = isNumericalNaN;
 function isNumericalNaN(val) {
-  return Number.isNaN(val) || val === Infinity || val === NaN;
+  return Number.isNaN(val) || val === Infinity;
 }

package/number/randomBetween.js

@@ -1,14 +1,11 @@
 'use strict';
-
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = randomBetween;
-var _is = _interopRequireDefault(require("./is"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 function randomBetween() {
   var min = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
   var max = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 10;
-  if (!(0, _is["default"])(min) || !(0, _is["default"])(max)) throw new TypeError('Min/Max should be numeric');
+  if (!Number.isFinite(min) || !Number.isFinite(max)) throw new TypeError('Min/Max should be numeric');
   return Math.random() * (max - min) + min;
 }

package/number/randomIntBetween.js

@@ -1,14 +1,11 @@
 'use strict';
-
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = randomIntBetween;
-var _is = _interopRequireDefault(require("./is"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 function randomIntBetween() {
   var min = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
   var max = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 10;
-  if (!(0, _is["default"])(min) || !(0, _is["default"])(max)) throw new TypeError('Min/Max should be numeric');
+  if (!Number.isFinite(min) || !Number.isFinite(max)) throw new TypeError('Min/Max should be numeric');
   return Math.floor(Math.random() * (max - min) + min);
 }

package/number/round.js

@@ -1,16 +1,12 @@
 'use strict';
-
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = round;
-var _is = _interopRequireDefault(require("./is"));
-var _isIntegerAbove = _interopRequireDefault(require("./isIntegerAbove"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 function round(val) {
   var precision = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
-  if (!(0, _is["default"])(val)) throw new TypeError('Value should be numeric');
-  var exp = Math.pow(10, (0, _isIntegerAbove["default"])(precision, 0) ? precision : 0);
+  if (!Number.isFinite(val)) throw new TypeError('Value should be numeric');
+  var exp = Math.pow(10, Number.isInteger(precision) && precision > 0 ? precision : 0);
   var num = val * exp * (1 + Number.EPSILON);
   return Math.round(num) / exp;
 }

package/number/toPercentage.js

@@ -4,13 +4,12 @@ Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = toPercentage;
-var _is = _interopRequireDefault(require("./is"));
-var _round = _interopRequireDefault(require("./round"));
+var _round = _interopRequireDefault(require("./round.js"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 function toPercentage(val) {
   var precision = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
   var min = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;
   var max = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 1;
-  if (!(0, _is["default"])(val) || !(0, _is["default"])(min) || !(0, _is["default"])(max)) throw new TypeError('Value should be numeric');
+  if (!Number.isFinite(val) || !Number.isFinite(min) || !Number.isFinite(max)) throw new TypeError('value/min/max should be numeric');
   return (0, _round["default"])((val - min) / (max - min) * 100, precision);
 }

package/object/define.js

@@ -4,11 +4,9 @@ Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = define;
-var _is = _interopRequireDefault(require("./is"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-function define() {
-  var props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+var _is = require("./is.js");
+function define(props) {
   var obj = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-  if (!(0, _is["default"])(props) || !(0, _is["default"])(obj)) throw new TypeError('Please pass an object as the value for props and obj');
+  if (Object.prototype.toString.call(props) !== _is.PROTO_OBJ || Object.prototype.toString.call(obj) !== _is.PROTO_OBJ) throw new TypeError('Please pass an object as the value for props and obj');
   return Object.defineProperties(obj, props);
 }

package/object/is.js

@@ -3,7 +3,9 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
+exports.PROTO_OBJ = void 0;
 exports["default"] = isObject;
+var PROTO_OBJ = exports.PROTO_OBJ = '[object Object]';
 function isObject(val) {
-  return val !== null && Object.prototype.toString.call(val) === '[object Object]';
+  return Object.prototype.toString.call(val) === PROTO_OBJ;
 }

package/object/isNotEmpty.js

@@ -4,9 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = isNotEmptyObject;
-var _is = _interopRequireDefault(require("./is"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+var _is = require("./is.js");
 function isNotEmptyObject(val) {
-  if (!(0, _is["default"])(val)) return !1;
-  return Object.keys(val).length !== 0;
+  return Object.prototype.toString.call(val) === _is.PROTO_OBJ && Object.keys(val).length > 0;
 }

package/object/merge.js

@@ -4,18 +4,15 @@ Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = void 0;
-var _is = _interopRequireDefault(require("../array/is"));
-var _is2 = _interopRequireDefault(require("./is"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-var merge = function merge() {
-  var target = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-  var obj = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-  if (!(0, _is2["default"])(target)) throw new TypeError('Please pass an object to merge');
+var _is = require("./is.js");
+var merge = function merge(target) {
+  var source = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  if (Object.prototype.toString.call(target) !== _is.PROTO_OBJ || Object.prototype.toString.call(source) !== _is.PROTO_OBJ) throw new TypeError('Please pass a target and object to merge');
   return Object.keys(target).reduce(function (acc, key) {
-    if ((0, _is2["default"])(target[key]) && !(0, _is["default"])(target[key])) {
-      acc[key] = merge(target[key], obj[key] || {});
+    if (Object.prototype.toString.call(target[key]) === _is.PROTO_OBJ && !Array.isArray(target[key])) {
+      acc[key] = merge(target[key], source[key] || {});
     } else {
-      acc[key] = obj.hasOwnProperty(key) ? obj[key] : target[key];
+      acc[key] = source.hasOwnProperty(key) ? source[key] : target[key];
     }
     return acc;
   }, {});

package/object/pick.js

@@ -4,29 +4,33 @@ Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = pick;
-var _get = _interopRequireDefault(require("../deep/get"));
-var _set = _interopRequireDefault(require("../deep/set"));
-var _is = _interopRequireDefault(require("../array/is"));
-var _isNotEmpty = _interopRequireDefault(require("../string/isNotEmpty"));
-var _is2 = _interopRequireDefault(require("./is"));
+var _get = _interopRequireDefault(require("../deep/get.js"));
+var _set = _interopRequireDefault(require("../deep/set.js"));
+var _isNotEmpty = _interopRequireDefault(require("../string/isNotEmpty.js"));
+var _is = require("./is.js");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 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 pick() {
-  var obj = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-  var keys = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
-  if (!(0, _is2["default"])(obj)) throw new TypeError('Please pass an object to pick as the value for obj');
-  if (!(0, _is["default"])(keys)) throw new TypeError('Please pass an array as the value for keys');
+function pick(obj, keys) {
+  if (Object.prototype.toString.call(obj) !== _is.PROTO_OBJ || !Array.isArray(keys) || keys.length === 0) throw new TypeError('Please pass an object to pick from and a keys array');
   var map = {};
+  var key_deep = !1;
+  var val;
   var _iterator = _createForOfIteratorHelper(keys),
     _step;
   try {
     for (_iterator.s(); !(_step = _iterator.n()).done;) {
       var key = _step.value;
       if (!(0, _isNotEmpty["default"])(key)) continue;
-      var val = (0, _get["default"])(obj, key.trim());
-      if (val !== undefined) (0, _set["default"])(map, key.trim(), val);
+      key_deep = key.match(/(\.|\[)/g);
+      val = key_deep ? (0, _get["default"])(obj, key.trim()) : obj[key.trim()];
+      if (val === undefined) continue;
+      if (key_deep) {
+        (0, _set["default"])(map, key.trim(), val);
+      } else {
+        map[key.trim()] = val;
+      }
     }
   } catch (err) {
     _iterator.e(err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valkyriestudios/utils",
-  "version": "7.5.0",
+  "version": "8.1.0",
   "description": "A collection of single-function utilities for common tasks",
   "main": "index.js",
   "author": {
@@ -17,10 +17,13 @@
   ],
   "license": "MIT",
   "scripts": {
-    "test": "nyc --reporter=lcov --reporter=text-summary mocha --colors --require @babel/register ./test/**/*.test.js",
-    "test_ci": "nyc --reporter=lcov mocha --colors --require @babel/register ./test/**/*.test.js",
-    "lint": "./node_modules/.bin/eslint ./src",
-    "build": "npx babel src --out-dir ./ && npm run lint",
+    "test": "node --test ./test/src",
+    "test:only": "node --test --test-only ./test/src",
+    "test:coverage": "c8 node --test ./test/src",
+    "lint": "npm run lint:src && npm run lint:test",
+    "lint:src": "./node_modules/.bin/eslint --ext .js,.mjs ./src",
+    "lint:test": "./node_modules/.bin/eslint --ext .js,.mjs ./test",
+    "build": "npm run lint && npm run test:coverage && rm -rf ./dist && mkdir ./dist && npx babel src --out-dir ./dist && sh ./adjust_esm_to_cjs.sh && mv -f ./dist/* ./ && rm -rf ./dist",
     "codecov": "codecov"
   },
   "repository": {
@@ -32,20 +35,13 @@
   },
   "homepage": "https://github.com/ValkyrieStudios/utils#readme",
   "devDependencies": {
-    "@babel/cli": "^7.23.0",
+    "@babel/cli": "^7.23.4",
     "@babel/core": "^7.23.2",
     "@babel/preset-env": "^7.23.2",
     "@babel/register": "^7.22.15",
-    "babel-plugin-check-es2015-constants": "^6.22.0",
-    "babel-plugin-transform-member-expression-literals": "^6.9.4",
     "babel-plugin-transform-minify-booleans": "^6.9.4",
-    "babel-plugin-transform-property-literals": "^6.9.4",
     "babel-plugin-transform-remove-console": "^6.9.4",
-    "chai": "^4.3.10",
-    "chai-as-promised": "^7.1.1",
-    "chai-spies": "^1.0.0",
-    "eslint": "^8.52.0",
-    "mocha": "^10.2.0",
-    "nyc": "^15.1.0"
+    "c8": "^8.0.1",
+    "eslint": "^8.52.0"
   }
 }

package/regexp/is.js

@@ -3,7 +3,9 @@
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
+exports.PROTO_RGX = void 0;
 exports["default"] = isRegExp;
+var PROTO_RGX = exports.PROTO_RGX = '[object RegExp]';
 function isRegExp(val) {
-  return Object.prototype.toString.call(val) === '[object RegExp]';
+  return Object.prototype.toString.call(val) === PROTO_RGX;
 }

package/regexp/sanitize.js

@@ -1,10 +1,10 @@
-"use strict";
+'use strict';
 
 Object.defineProperty(exports, "__esModule", {
   value: !0
 });
 exports["default"] = sanitizeRegExp;
-var _isNotEmpty = _interopRequireDefault(require("../string/isNotEmpty"));
+var _isNotEmpty = _interopRequireDefault(require("../string/isNotEmpty.js"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 function sanitizeRegExp(val) {
   if (!(0, _isNotEmpty["default"])(val)) return !1;

package/src/array/dedupe.mjs

@@ -0,0 +1,24 @@
+'use strict';
+
+import fnv1A from '../hash/fnv1A.mjs';
+
+export default function dedupe (val) {
+    if (!Array.isArray(val) || val.length === 0)  return [];
+
+    const map = new Map();
+    const acc = [];
+    let hash;
+    for (const item of val) {
+        //  Calculate hash for item and continue if already seen
+        hash = fnv1A(item);
+        if (map.has(hash)) continue;
+
+        //  Set seen hash to true
+        map.set(hash, true);
+
+        //  Push into accumulator
+        acc.push(item);
+    }
+
+    return acc;
+}

package/src/array/is.mjs

@@ -0,0 +1,5 @@
+'use strict';
+
+export default function isArray (val) {
+    return Array.isArray(val);
+}

package/src/array/isNotEmpty.mjs

@@ -0,0 +1,5 @@
+'use strict';
+
+export default function isNotEmptyArray (val) {
+    return Array.isArray(val) && val.length !== 0;
+}

package/src/array/join.mjs

@@ -0,0 +1,31 @@
+'use strict';
+
+import isNotEmptyString from '../string/isNotEmpty.mjs';
+import isNotEmptyObject from '../object/isNotEmpty.mjs';
+import round            from '../number/round.mjs';
+
+//  Join an array of values while autofiltering any non-string/non-number elements
+//
+//  @param array    arr     Array of values to join
+//  @param object   options (default={}) Override options
+export default function join (arr, options = {}) {
+    if (!Array.isArray(arr) || arr.length === 0) return '';
+
+    const OPTS = Object.assign({
+        delim       : ' ',      //  Delimiter to join with
+        trim        : true,     //  Trim after joining
+        valtrim     : true,     //  Automatically trim string values
+        valround    : false,    //  Automatically round numbers
+    }, isNotEmptyObject(options) ? options : {});
+
+    const filtered = [];
+    for (const el of arr) {
+        if (isNotEmptyString(el)) {
+            filtered.push(OPTS.valtrim === true ? el.trim() : el);
+        } else if (Number.isFinite(el)) {
+            filtered.push(Number.isFinite(OPTS.valround) ? round(el, OPTS.valround) : el);
+        }
+    }
+
+    return OPTS.trim === true ? filtered.join(OPTS.delim).trim() : filtered.join(OPTS.delim);
+}

package/src/array/mapFn.mjs

@@ -0,0 +1,34 @@
+'use strict';
+
+import isFunction       from '../function/is.mjs';
+import isNotEmptyString from '../string/isNotEmpty.mjs';
+import {PROTO_OBJ}      from '../object/is.mjs';
+
+export default function mapFn (arr, fn, opts = {}) {
+    if (
+        (!Array.isArray(arr) || arr.length === 0) ||
+        !isFunction(fn)
+    ) return {};
+
+    const OPTS = Object.assign({
+        merge: false,
+    }, Object.prototype.toString.call(opts) === PROTO_OBJ ? opts : {});
+
+    const map = {};
+    let hash = false;
+    for (const el of arr) {
+        if (Object.prototype.toString.call(el) !== PROTO_OBJ) continue;
+
+        //  Get hash
+        hash = fn(el);
+        if (!Number.isFinite(hash) && !isNotEmptyString(hash)) continue;
+
+        if (OPTS.merge === true && map.hasOwnProperty(hash)) {
+            map[hash] = Object.assign(map[hash], el);
+        } else {
+            map[hash] = el;
+        }
+    }
+
+    return map;
+}

package/src/array/mapKey.mjs

@@ -0,0 +1,29 @@
+'use strict';
+
+import isNotEmptyString from '../string/isNotEmpty.mjs';
+import {PROTO_OBJ}      from '../object/is.mjs';
+
+export default function mapKey (arr, key, opts = {}) {
+    if (
+        (!Array.isArray(arr) || arr.length === 0) ||
+        !isNotEmptyString(key)
+    ) return {};
+
+    const OPTS = Object.assign({
+        merge: false,
+    }, Object.prototype.toString.call(opts) === PROTO_OBJ ? opts : {});
+
+    const map = {};
+    for (const el of arr) {
+        if (
+            Object.prototype.toString.call(el) !== PROTO_OBJ ||
+            !el.hasOwnProperty(key)) continue;
+        if (OPTS.merge === true && map.hasOwnProperty(el[key])) {
+            map[el[key]] = Object.assign(map[el[key]], el);
+        } else {
+            map[el[key]] = el;
+        }
+    }
+
+    return map;
+}

package/src/array/mapPrimitive.mjs

@@ -0,0 +1,29 @@
+'use strict';
+
+import isNotEmptyString from '../string/isNotEmpty.mjs';
+import isNotEmptyObject from '../object/isNotEmpty.mjs';
+
+export default function mapPrimitive (arr, opts = {}) {
+    if (!Array.isArray(arr) || arr.length === 0) return {};
+
+    const OPTS = Object.assign({
+        valtrim: false,
+        keyround: false,
+        valround: false,
+    }, isNotEmptyObject(opts) ? opts : {});
+
+    const map = {};
+    for (const el of arr) {
+        if (Number.isFinite(el)) {
+            if (OPTS.keyround === true) {
+                map[Math.round(el)] = OPTS.valround ? Math.round(el) : el;
+            } else {
+                map[el] = OPTS.valround ? Math.round(el) : el;
+            }
+        } else if (isNotEmptyString(el)) {
+            map[el.trim()] = OPTS.valtrim ? el.trim() : el;
+        }
+    }
+
+    return map;
+}

package/src/array/shuffle.mjs

@@ -0,0 +1,14 @@
+'use strict';
+
+//  Fisher - Yates shuffle O(n)
+//  https://en.wikipedia.org/wiki/Fisher%E2%80%93Yates_shuffle
+//
+//  @param array    arr     Array to shuffle
+export default function shuffle (arr) {
+    if (!Array.isArray(arr) || arr.length === 0) return;
+
+    for (let i = arr.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));  // Random index from 0 to i
+        [arr[i], arr[j]] = [arr[j], arr[i]];            // Swap elements
+    }
+}

package/src/array/sort.mjs

@@ -0,0 +1,100 @@
+'use strict';
+
+import isBoolean        from '../boolean/is.mjs';
+import isNotEmptyObject from '../object/isNotEmpty.mjs';
+import {PROTO_OBJ}      from '../object/is.mjs';
+import isNotEmptyString from '../string/isNotEmpty.mjs';
+import isFunction       from '../function/is.mjs';
+
+function partition (arr, start_ix, end_ix) {
+    const pivot_val = arr[Math.floor((start_ix + end_ix) / 2)].t;
+
+    while (start_ix <= end_ix) {
+        while (arr[start_ix].t < pivot_val) {
+            start_ix++;
+        }
+
+        while (arr[end_ix].t > pivot_val) {
+            end_ix--;
+        }
+
+        if (start_ix <= end_ix) {
+            const temp = arr[start_ix];
+            arr[start_ix] = arr[end_ix];
+            arr[end_ix] = temp;
+
+            start_ix++;
+            end_ix--;
+        }
+    }
+
+    return start_ix;
+}
+
+function quickSort (arr, start_ix = 0, end_ix = arr.length - 1) {
+    if (start_ix < end_ix) {
+        const ix = partition(arr, start_ix, end_ix);
+
+        quickSort(arr, start_ix, ix - 1);
+        quickSort(arr, ix, end_ix);
+    }
+
+    return arr;
+}
+
+export default function sort (arr, by, dir = 'asc', options = {}) {
+    if (!Array.isArray(arr) || arr.length === 0) return [];
+
+    //  Check by
+    if (!isNotEmptyString(by) && !isFunction(by)) throw new Error('Sort by should be either a string or a function');
+
+    //  Check dir
+    if (dir !== 'asc' && dir !== 'desc') throw new Error('Direction should be either asc or desc');
+
+    const has_opts = Object.prototype.toString.call(options) === PROTO_OBJ;
+
+    const OPTS = {
+        filter_fn   : has_opts && isFunction(options.filter_fn) ? options.filter_fn : isNotEmptyObject,
+        nokey_hide  : has_opts && isBoolean(options.nokey_hide) ? options.nokey_hide : false,
+        nokey_atend : has_opts && isBoolean(options.nokey_atend) ? options.nokey_atend : true,
+    };
+
+    //  Prepare for sort
+    const prepared_arr    = [];
+    const nokey_arr       = [];
+    if (isNotEmptyString(by)) {
+        for (const el of arr) {
+            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});
+            }
+        }
+    } else {
+        let key;
+        for (const el of arr) {
+            if (!OPTS.filter_fn(el)) continue;
+
+            key = by(el);
+            if (key === undefined) {
+                nokey_arr.push(el);
+            } else {
+                prepared_arr.push({t: by(el), el});
+            }
+        }
+    }
+
+    //  Sort
+    quickSort(prepared_arr);
+    if (dir === 'desc') prepared_arr.reverse();
+
+    if (OPTS.nokey_hide) {
+        return prepared_arr.map(obj => obj.el);
+    } else if (OPTS.nokey_atend) {
+        return [...prepared_arr.map(obj => obj.el), ...nokey_arr];
+    } else {
+        return [...nokey_arr, ...prepared_arr.map(obj => obj.el)];
+    }
+}

package/src/boolean/is.mjs

@@ -0,0 +1,5 @@
+'use strict';
+
+export default function isBoolean (val) {
+    return val === true || val === false || typeof val === 'boolean' || val instanceof Boolean;
+}