@koine/utils 2.0.0-beta.2 → 2.0.0-beta.200

package/Emitter.mjs

@@ -1,38 +0,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
- */
-export 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);
-            });
-        },
-    };
-}
-export default Emitter;

package/accentSets.d.ts

@@ -1,16 +0,0 @@
-/**
- * First value is the `to`, second is `from`, from *which* chars do we translates *to*
- *
- * @category text
- */
-export type AccentsSet = [string, string];
-/**
- * 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)
- */
-export declare const accentsSets: AccentsSet[];
-export default accentsSets;

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/accentSets.mjs

@@ -1,38 +0,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)
- */
-export var 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", "ŹŻŽ"],
-];
-export default 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/addOrReplaceAtIdx.mjs

@@ -1,19 +0,0 @@
-import { __spreadArray } from "tslib";
-/**
- * @category array
- */
-export function addOrReplaceAtIdx(list, newItem, newIdx) {
-    if (list.length === 0) {
-        return [newItem];
-    }
-    if (typeof newIdx === "undefined" || list.length - 1 < newIdx) {
-        return __spreadArray(__spreadArray([], list, true), [newItem], false);
-    }
-    return list.map(function (item, idx) {
-        if (idx === newIdx) {
-            return newItem;
-        }
-        return item;
-    });
-}
-export 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/areEqual.mjs

@@ -1,77 +0,0 @@
-import { isArray } from "./isArray";
-import { isObject } from "./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
- */
-export 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 = isObject(a) && isObject(b);
-    if (areObjects && !areEqualObjects(a, b)) {
-        // console.log(`areEqual took ${performance.now() - t0} ms`);
-        return false;
-    }
-    var areArrays = isArray(a) && 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;
-}
-export 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/arrayOfAll.mjs

@@ -1,32 +0,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
- * ```
- *
- */
-export var arrayOfAll = function () {
-    return function (array) {
-        return array;
-    };
-};
-export default 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/arraySum.mjs

@@ -1,9 +0,0 @@
-/**
- * Sum array of numbers
- *
- * @category array | math
- */
-export var arraySum = function (numbers) {
-    return numbers.reduce(function (sum, current) { return sum + current; }, 0);
-};
-export default 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/arrayToLookup.mjs

@@ -1,13 +0,0 @@
-/**
- * Maps a simple flat array to a lookup dictionary object
- *
- * @category array
- */
-export function arrayToLookup(array) {
-    if (array === void 0) { array = []; }
-    return array.reduce(function (obj, item) {
-        obj[item] = 1;
-        return obj;
-    }, {});
-}
-export 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/buildUrlQueryString.mjs

@@ -1,31 +0,0 @@
-import isNull from "./isNull";
-import isUndefined from "./isUndefined";
-import isArray from "./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
- */
-export function buildUrlQueryString(params) {
-    var output = "";
-    if (!params)
-        return output;
-    for (var key in params) {
-        var value = params[key];
-        if (isArray(value)) {
-            for (var i = 0; i < value.length; i++) {
-                output += "".concat(key, "=").concat(encodeURIComponent(value[i] + ""), "&");
-            }
-        }
-        else if (!isNull(value) && !isUndefined(value)) {
-            output += "".concat(key, "=").concat(encodeURIComponent(value + ""), "&");
-        }
-    }
-    // removes the last &
-    return output ? "?".concat(output.replace(/&+$/, "")) : "";
-}
-export 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/capitalize.mjs

@@ -1,12 +0,0 @@
-/**
- * Capitalize first letter of the given string.
- *
- * @category text
- * @see https://stackoverflow.com/a/11409944/1938970
- */
-export function capitalize(string) {
-    var ensuredString = string || "";
-    return (ensuredString.charAt(0).toUpperCase() +
-        ensuredString.slice(1));
-}
-export default capitalize;

package/changeUrlPath.d.ts

@@ -1,10 +0,0 @@
-/**
- * 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
- */
-export declare function changeUrlPath(pathname: string, state?: object, replace?: boolean): string;
-export default changeUrlPath;

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/changeUrlPath.mjs

@@ -1,18 +0,0 @@
-import isBrowser from "./isBrowser";
-import normaliseUrlPathname from "./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
- */
-export function changeUrlPath(pathname, state, replace) {
-    var path = normaliseUrlPathname("/".concat(pathname, "/"));
-    if (isBrowser) {
-        history[replace ? "replaceState" : "pushState"](state, "", path);
-    }
-    return path;
-}
-export 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;