@koine/utils 2.0.0-beta.1 → 2.0.0-beta.11

package/Defer.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Defer = void 0;
-/**
- * @category async
- * @see https://stackoverflow.com/a/37673534/1938970
- * @example
- *
- * ```ts
- * const deferred = Defer();
- * deferred.resolve();
- * deferred.then(handleSuccess, handleError);
- * ```
- */
-function Defer() {
-    // @ts-expect-error nevermind
-    var self = this || {};
-    var p = (self.promise = new Promise(function (resolve, reject) {
-        self.resolve = resolve;
-        self.reject = reject;
-    }));
-    self.then = p.then.bind(p);
-    self.catch = p.catch.bind(p);
-    // if (p.finally) {
-    //   self.finally = p.finally.bind(p);
-    // }
-    return self;
-}
-exports.Defer = Defer;
-exports.default = Defer;

package/Emitter.js

@@ -1,42 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Emitter = void 0;
-/**
- * Emitter super simple class
- *
- * Events will be prefixed with the given `namespace` plus a `.` so:
- * `{namespace}.myevent`
- *
- * Adapted from https://github.com/developit/mitt
- *
- * Regarding typescript support @see:
- * - https://stackoverflow.com/q/53299743/1938970
- * - https://github.com/Microsoft/TypeScript/pull/26349
- */
-function Emitter(namespace) {
-    var all = new Map();
-    return {
-        /**
-         * Register an event handler for the given type.
-         */
-        on: function (name, handler) {
-            var handlers = all.get("".concat(namespace, ".").concat(String(name)));
-            var added = handlers && handlers.push(handler);
-            if (!added) {
-                all.set("".concat(namespace, ".").concat(String(name)), [handler]);
-            }
-        },
-        /**
-         * Invoke all handlers for the given type.
-         */
-        emit: function (name, data) {
-            (all.get("".concat(namespace, ".").concat(String(name))) || [])
-                .slice()
-                .map(function (handler) {
-                handler(data);
-            });
-        },
-    };
-}
-exports.Emitter = Emitter;
-exports.default = Emitter;

package/accentSets.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.accentsSets = void 0;
-/**
- * Accent sets
- *
- * @category text
- * @see https://gist.github.com/mathewbyrne/1280286#gistcomment-3498021
- * @see https://gist.github.com/eek/9c4887e80b3ede05c0e39fee4dce3747 for usage
- * of [normalize](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize)
- */
-exports.accentsSets = [
-    ["a", "ÀÁÂÃÅÆĀĂĄẠẢẤẦẨẪẬẮẰẲẴẶ"],
-    ["ae", "Ä"],
-    ["c", "ÇĆĈČ"],
-    ["d", "ÐĎĐÞ"],
-    ["e", "ÈÉÊËĒĔĖĘĚẸẺẼẾỀỂỄỆ"],
-    ["g", "ĜĞĢǴ"],
-    ["h", "ĤḦ"],
-    ["i", "ÌÍÎÏĨĪĮİỈỊ"],
-    ["j", "Ĵ"],
-    ["ij", "IJ"],
-    ["k", "Ķ"],
-    ["l", "ĹĻĽŁ"],
-    ["m", "Ḿ"],
-    ["n", "ÑŃŅŇ"],
-    ["o", "ÒÓÔÕØŌŎŐỌỎỐỒỔỖỘỚỜỞỠỢǪǬƠ"],
-    ["oe", "΅"],
-    ["p", "ṕ"],
-    ["r", "ŔŖŘ"],
-    ["s", "ŚŜŞŠ"],
-    ["ss", "ß"],
-    ["t", "ŢŤ"],
-    ["u", "ÙÚÛŨŪŬŮŰŲỤỦỨỪỬỮỰƯ"],
-    ["ue", "Ü"],
-    ["w", "ẂŴẀẄ"],
-    ["x", "ẍ"],
-    ["y", "ÝŶŸỲỴỶỸ"],
-    ["z", "ŹŻŽ"],
-];
-exports.default = exports.accentsSets;

package/addOrReplaceAtIdx.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addOrReplaceAtIdx = void 0;
-var tslib_1 = require("tslib");
-/**
- * @category array
- */
-function addOrReplaceAtIdx(list, newItem, newIdx) {
-    if (list.length === 0) {
-        return [newItem];
-    }
-    if (typeof newIdx === "undefined" || list.length - 1 < newIdx) {
-        return tslib_1.__spreadArray(tslib_1.__spreadArray([], list, true), [newItem], false);
-    }
-    return list.map(function (item, idx) {
-        if (idx === newIdx) {
-            return newItem;
-        }
-        return item;
-    });
-}
-exports.addOrReplaceAtIdx = addOrReplaceAtIdx;
-exports.default = addOrReplaceAtIdx;

package/areEqual.js

@@ -1,81 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.areEqual = void 0;
-var isArray_1 = require("./isArray");
-var isObject_1 = require("./isObject");
-function areEqualArrays(a, b) {
-    if (!b)
-        return false;
-    if (a.length !== b.length)
-        return false;
-    for (var i = 0; i < a.length; i++) {
-        var aValue = a[i];
-        var bValue = b[i];
-        if (!areEqual(aValue, bValue))
-            return false;
-    }
-    return true;
-}
-function areEqualObjects(a, b) {
-    if (!b)
-        return false;
-    var aKeys = Object.keys(a);
-    var bKeys = Object.keys(b);
-    if (aKeys.length !== bKeys.length) {
-        return false;
-    }
-    for (var _i = 0, aKeys_1 = aKeys; _i < aKeys_1.length; _i++) {
-        var _key = aKeys_1[_i];
-        var key = _key;
-        var aValue = a[key];
-        var bValue = b[key];
-        if (!areEqual(aValue, bValue)) {
-            return false;
-        }
-    }
-    return true;
-}
-/**
- * A simple and quick deep equal objects utility. This is meant to be used
- * solely to deduplicate requests payload and perform comparison on JSON ready
- * objects made of primitives `string`, `number` and `boolean`s.
- *
- * It support nested `object`s and `array`s only.
- *
- * NB: `undefined` and `null` values do not count in the comparison as they are
- * usually meant to be ignored in JSON requestBody payloads.
- *
- * According to very rudimentary tests this function takes on average between
- * 0.15 ms and 2ms to compare two averaged sizes requet body payloads.
- *
- * @category objects
- */
-function areEqual(a, b) {
-    if (!a && !b) {
-        // console.log(`areEqual took ${performance.now() - t0} ms`);
-        return true;
-    }
-    // const t0 = performance.now();
-    if (!b && a !== b) {
-        // console.log(`areEqual took ${performance.now() - t0} ms`);
-        return false;
-    }
-    var areObjects = (0, isObject_1.isObject)(a) && (0, isObject_1.isObject)(b);
-    if (areObjects && !areEqualObjects(a, b)) {
-        // console.log(`areEqual took ${performance.now() - t0} ms`);
-        return false;
-    }
-    var areArrays = (0, isArray_1.isArray)(a) && (0, isArray_1.isArray)(b);
-    if (areArrays && !areEqualArrays(a, b)) {
-        // console.log(`areEqual took ${performance.now() - t0} ms`);
-        return false;
-    }
-    if (!areObjects && !areArrays && a !== b) {
-        // console.log(`areEqual took ${performance.now() - t0} ms`);
-        return false;
-    }
-    // console.log(`areEqual took ${performance.now() - t0} ms`);
-    return true;
-}
-exports.areEqual = areEqual;
-exports.default = areEqual;

package/arrayOfAll.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.arrayOfAll = void 0;
-/**
- * Ensure an array contains all desired values
- *
- * @category array
- * @borrows [SO comment by `CertainPerformance`](https://stackoverflow.com/a/60132060/1938970)
- *
- * @usage
- *
- * ```
- * type Fruit = "pear" | "apple" | "orange";
- *
- * const arrayOfAllFruits = arrayOfAll<Fruit>();
- *
- * const allFruits = arrayOfAllFruits([
- *  "pear",
- *  "apple",
- *  "orange"
- * ]); // ts compiler ok
- *
- * const allFruits = arrayOfAllFruits([
- *  "pear",
- *  "apple",
- * ]); // ts compiler fails
- * ```
- *
- */
-var arrayOfAll = function () {
-    return function (array) {
-        return array;
-    };
-};
-exports.arrayOfAll = arrayOfAll;
-exports.default = exports.arrayOfAll;

package/arraySum.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.arraySum = void 0;
-/**
- * Sum array of numbers
- *
- * @category array | math
- */
-var arraySum = function (numbers) {
-    return numbers.reduce(function (sum, current) { return sum + current; }, 0);
-};
-exports.arraySum = arraySum;
-exports.default = exports.arraySum;

package/arrayToLookup.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.arrayToLookup = void 0;
-/**
- * Maps a simple flat array to a lookup dictionary object
- *
- * @category array
- */
-function arrayToLookup(array) {
-    if (array === void 0) { array = []; }
-    return array.reduce(function (obj, item) {
-        obj[item] = 1;
-        return obj;
-    }, {});
-}
-exports.arrayToLookup = arrayToLookup;
-exports.default = arrayToLookup;

package/buildUrlQueryString.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildUrlQueryString = void 0;
-var tslib_1 = require("tslib");
-var isNull_1 = tslib_1.__importDefault(require("./isNull"));
-var isUndefined_1 = tslib_1.__importDefault(require("./isUndefined"));
-var isArray_1 = tslib_1.__importDefault(require("./isArray"));
-/**
- * Get clean query string for URL
- *
- * It returns the query string **with** the initial `?`
- *
- * TODO: at some point replace with `URLSearchParams`, @see [caniuse](https://caniuse.com/?search=URLSearchParams)
- *
- * @category location
- */
-function buildUrlQueryString(params) {
-    var output = "";
-    if (!params)
-        return output;
-    for (var key in params) {
-        var value = params[key];
-        if ((0, isArray_1.default)(value)) {
-            for (var i = 0; i < value.length; i++) {
-                output += "".concat(key, "=").concat(encodeURIComponent(value[i] + ""), "&");
-            }
-        }
-        else if (!(0, isNull_1.default)(value) && !(0, isUndefined_1.default)(value)) {
-            output += "".concat(key, "=").concat(encodeURIComponent(value + ""), "&");
-        }
-    }
-    // removes the last &
-    return output ? "?".concat(output.replace(/&+$/, "")) : "";
-}
-exports.buildUrlQueryString = buildUrlQueryString;
-exports.default = buildUrlQueryString;

package/capitalize.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.capitalize = void 0;
-/**
- * Capitalize first letter of the given string.
- *
- * @category text
- * @see https://stackoverflow.com/a/11409944/1938970
- */
-function capitalize(string) {
-    var ensuredString = string || "";
-    return (ensuredString.charAt(0).toUpperCase() +
-        ensuredString.slice(1));
-}
-exports.capitalize = capitalize;
-exports.default = capitalize;

package/changeUrlPath.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.changeUrlPath = void 0;
-var tslib_1 = require("tslib");
-var isBrowser_1 = tslib_1.__importDefault(require("./isBrowser"));
-var normaliseUrlPathname_1 = tslib_1.__importDefault(require("./normaliseUrlPathname"));
-/**
- * Change URL path, ensures initial and ending slashes and normalise eventual
- * consecutive slashes, it uses `history`.
- *
- * @category location
- * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
- * @returns {string} The new cleaned pathname
- */
-function changeUrlPath(pathname, state, replace) {
-    var path = (0, normaliseUrlPathname_1.default)("/".concat(pathname, "/"));
-    if (isBrowser_1.default) {
-        history[replace ? "replaceState" : "pushState"](state, "", path);
-    }
-    return path;
-}
-exports.changeUrlPath = changeUrlPath;
-exports.default = changeUrlPath;

package/chunkByChunks.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.chunkByChunks = void 0;
-/**
- * TODO: untested
- * @category array
- * @see https://stackoverflow.com/a/8189268/1938970
- */
-function chunkByChunks(arr, nrOfChunks, balanced) {
-    if (nrOfChunks < 2)
-        return [arr];
-    var len = arr.length;
-    var output = [];
-    var i = 0;
-    var size;
-    if (len % nrOfChunks === 0) {
-        size = Math.floor(len / nrOfChunks);
-        while (i < len) {
-            output.push(arr.slice(i, (i += size)));
-        }
-    }
-    else if (balanced) {
-        while (i < len) {
-            size = Math.ceil((len - i) / nrOfChunks--);
-            output.push(arr.slice(i, (i += size)));
-        }
-    }
-    else {
-        nrOfChunks--;
-        size = Math.floor(len / nrOfChunks);
-        if (len % size === 0)
-            size--;
-        while (i < size * nrOfChunks) {
-            output.push(arr.slice(i, (i += size)));
-        }
-        output.push(arr.slice(size * nrOfChunks));
-    }
-    return output;
-}
-exports.chunkByChunks = chunkByChunks;
-exports.default = chunkByChunks;

package/chunkBySize.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.chunkBySize = void 0;
-/**
- * @category array
- * @see https://stackoverflow.com/a/40682136/1938970
- */
-function chunkBySize(arr, size) {
-    var output = [];
-    for (var i = 0; i < arr.length; i += size) {
-        output.push(arr.slice(i, i + size));
-    }
-    return output;
-}
-exports.chunkBySize = chunkBySize;
-exports.default = chunkBySize;

package/clamp.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.clamp = void 0;
-/**
- * Returns a number whose value is limited to the given range.
- *
- * @category math
- * @see https://stackoverflow.com/a/11409944/1938970
- */
-function clamp(num, min, max) {
-    return Math.min(Math.max(num, min), max);
-}
-exports.clamp = clamp;
-exports.default = clamp;

package/clsx.js

@@ -1,53 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.clsx = void 0;
-// import _clsx from "clsx";
-// export const clsx = _clsx;
-function toVal(mix) {
-    var k, y, str = "";
-    if (typeof mix === "string" || typeof mix === "number") {
-        str += mix;
-    }
-    else if (typeof mix === "object") {
-        if (Array.isArray(mix)) {
-            for (k = 0; k < mix.length; k++) {
-                if (mix[k]) {
-                    if ((y = toVal(mix[k]))) {
-                        str && (str += " ");
-                        str += y;
-                    }
-                }
-            }
-        }
-        else {
-            for (k in mix) {
-                if (mix[k]) {
-                    str && (str += " ");
-                    str += k;
-                }
-            }
-        }
-    }
-    return str;
-}
-/**
- * Class names utility
- *
- * @borrows [lukeed/clsx](https://github.com/lukeed/clsx)
- * @license [MIT: Luke Edwards](https://github.com/lukeed/clsx/blob/master/license)
- */
-var clsx = function () {
-    var i = 0, tmp, x, str = "";
-    while (i < arguments.length) {
-        // eslint-disable-next-line prefer-rest-params
-        if ((tmp = arguments[i++])) {
-            if ((x = toVal(tmp))) {
-                str && (str += " ");
-                str += x;
-            }
-        }
-    }
-    return str;
-};
-exports.clsx = clsx;
-exports.default = exports.clsx;

package/convertRange.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertRange = void 0;
-/**
- * Convert range of a number
- *
- * e.g. converting number 5 in a scale/range from 0 10 to a scale/range from 50
- * to 100 would return 75
- * ```
- * convertRange(5, [0, 10], [50, 100]);
- * ```
- *
- * @category math
- * @see https://stackoverflow.com/a/14224813
- */
-function convertRange(num, r1, r2) {
-    return ((num - r1[0]) * (r2[1] - r2[0])) / (r1[1] - r1[0]) + r2[0];
-}
-exports.convertRange = convertRange;
-exports.default = convertRange;

package/cookie.js

@@ -1,13 +0,0 @@
-"use strict";
-/**
- * @file
- *
- * @category cookie
- *
- * All cookie related code is inspired and adapted from:
- * - [js-cookie](https://github.com/js-cookie/js-cookie)
- * - [cookie](https://github.com/jshttp/cookie)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultAttributesClient = void 0;
-exports.defaultAttributesClient = { path: "/" };

package/createPalette.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createPalette = void 0;
-/**
- * Create palette, this is primarily thought to improve the reuse of a palette
- * definition between TailwindCSS and straight ES imports
- *
- * @category styling|tailwind|colours
- *
- * @returns An array with: 1) A flat palette map 2) A TailwindCSS ready palette
- * object 3) A flat array of colors (no special sorting, same order as the `shades`
- * given as argument)
- */
-var createPalette = function (name, shades) {
-    var map = shades.reduce(function (map, def) {
-        map[def[0]] = def[1];
-        return map;
-    }, {});
-    var tailwindPalette = shades.reduce(function (map, def) {
-        map["".concat(name, "-").concat(def[0])] = def[1];
-        return map;
-    }, {});
-    return [map, tailwindPalette, Object.values(map)];
-};
-exports.createPalette = createPalette;
-exports.default = exports.createPalette;

package/debounce.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.debounce = void 0;
-/**
- * Debounce function (with `setTimeout`)
- *
- * @category function
- * @borrows [davidwalsh/debounce](https://davidwalsh.name/javascript-debounce-function)
- */
-function debounce(fn, wait, immediate) {
-    var timeout;
-    return function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
-        var context = this;
-        var later = function () {
-            timeout = null;
-            if (!immediate)
-                fn.apply(context, args);
-        };
-        var callNow = immediate && !timeout;
-        if (timeout)
-            clearTimeout(timeout);
-        timeout = setTimeout(later, wait);
-        if (callNow)
-            fn.apply(context, args);
-    };
-}
-exports.debounce = debounce;
-exports.default = debounce;

package/debouncePromise.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.debouncePromise = void 0;
-var ts_debounce_1 = require("ts-debounce");
-/**
- * Debounce function (with `Promise`)
- *
- * @category function
- * @borrows [chodorowicz/ts-debounce](https://github.com/chodorowicz/ts-debounce)
- */
-exports.debouncePromise = ts_debounce_1.debounce;
-exports.default = exports.debouncePromise;

package/debounceRaf.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.debounceRaf = void 0;
-/**
- * Debounce function (with `requestAnimationFrame`)
- *
- * (c) 2021 Chris Ferdinandi, MIT License, https://gomakethings.com
- * @category function
- * @borrows [vanillajstoolkit/debounce](https://vanillajstoolkit.com/helpers/debounce/)
- */
-function debounceRaf(fn) {
-    var timeout;
-    return function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
-        var context = this;
-        // If there's a timer, cancel it
-        if (timeout) {
-            window.cancelAnimationFrame(timeout);
-        }
-        // Setup the new requestAnimationFrame()
-        timeout = window.requestAnimationFrame(function () {
-            fn.apply(context, args);
-        });
-    };
-}
-exports.debounceRaf = debounceRaf;
-exports.default = debounceRaf;

package/decode.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.decode = void 0;
-/**
- * @category security
- * @see https://stackoverflow.com/a/22405578/9122820
- */
-function decode(str) {
-    return str.replace(/.{3}/g, function (c) {
-        return String.fromCharCode(parseInt(c, 10));
-    });
-}
-exports.decode = decode;
-exports.default = decode;

package/encode.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.encode = void 0;
-/**
- * @category security
- * @see https://stackoverflow.com/a/22405578/9122820
- */
-function encode(str) {
-    return str.replace(/./g, function (c) {
-        return ("00" + c.charCodeAt(0)).slice(-3);
-    });
-}
-exports.encode = encode;
-exports.default = encode;