@koine/utils 1.0.26 → 1.0.29

package/navigateToParams.js

@@ -0,0 +1,18 @@
+import buildUrlQueryString from "./buildUrlQueryString";
+import isBrowser from "./isBrowser";
+/**
+ * Change current URL query parameters, it uses `history`.
+ *
+ * @category location
+ * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
+ * @returns The query string with initial `?`
+ */
+export function navigateToParams(params, replace) {
+    if (params === void 0) { params = {}; }
+    var queryString = typeof params === "string" ? params : buildUrlQueryString(params);
+    if (isBrowser) {
+        history[replace ? "replaceState" : "pushState"](null, "", location.pathname + queryString);
+    }
+    return queryString;
+}
+export default navigateToParams;

package/navigateWithoutUrlParam.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Remove URL query parameter, it uses `history`
+ *
+ * @category location
+ * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
+ */
+export declare function navigateWithoutUrlParam(paramName?: string, replace?: boolean): string;
+export default navigateWithoutUrlParam;

package/navigateWithoutUrlParam.js

@@ -0,0 +1,19 @@
+import getUrlQueryParams from "./getUrlQueryParams";
+import navigateToParams from "./navigateToParams";
+/**
+ * Remove URL query parameter, it uses `history`
+ *
+ * @category location
+ * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
+ */
+export function navigateWithoutUrlParam(paramName, replace) {
+    var params = {};
+    var currentParams = getUrlQueryParams();
+    for (var key in currentParams) {
+        if (key !== paramName) {
+            params[key] = currentParams[key];
+        }
+    }
+    return navigateToParams(params, replace);
+}
+export default navigateWithoutUrlParam;

package/node/{async.js → Defer.js}

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.wait = exports.Defer = void 0;
+exports.Defer = void 0;
 /**
+ * @category async
  * @see https://stackoverflow.com/a/37673534/1938970
- *
  * @example
  *
  * ```ts
@@ -27,10 +27,4 @@ function Defer() {
     return self;
 }
 exports.Defer = Defer;
-/**
- * A promisified `setTimeout`
- */
-var wait = function (milliseconds) {
-    return new Promise(function (resolve) { return setTimeout(resolve, milliseconds); });
-};
-exports.wait = wait;
+exports.default = Defer;

package/node/{emitter.js → Emitter.js}

@@ -39,3 +39,4 @@ function Emitter(namespace) {
     };
 }
 exports.Emitter = Emitter;
+exports.default = Emitter;

package/node/accentSets.js

@@ -0,0 +1,41 @@
+"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/node/addOrReplaceAtIdx.js

@@ -0,0 +1,23 @@
+"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/node/arrayToLookup.js

@@ -0,0 +1,17 @@
+"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/node/buildUrlQueryString.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildUrlQueryString = void 0;
+var isNull_1 = require("./isNull");
+var isUndefined_1 = require("./isUndefined");
+/**
+ * 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) {
+    if (params === void 0) { params = {}; }
+    var output = "";
+    for (var key in params) {
+        var value = params[key];
+        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/node/changeUrlPath.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.changeUrlPath = void 0;
+var isBrowser_1 = require("./isBrowser");
+var normaliseUrlPathname_1 = 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/node/chunkByChunks.js

@@ -0,0 +1,41 @@
+"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/node/chunkBySize.js

@@ -0,0 +1,16 @@
+"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/node/clamp.js

@@ -0,0 +1,14 @@
+"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/node/clsx.js

@@ -0,0 +1,53 @@
+"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, embedded from [clsx](https://github.com/lukeed/clsx)
+ *
+ * @see 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/node/convertRange.js

@@ -0,0 +1,20 @@
+"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/node/cookie.js

@@ -2,235 +2,12 @@
 /**
  * @file
  *
- * Inspired and adapted from
+ * @category cookie
  *
+ * All cookie related code is inspired and adapted from:
  * - [js-cookie](https://github.com/js-cookie/js-cookie)
- * @see https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/js-cookie/index.d.ts
  * - [cookie](https://github.com/jshttp/cookie)
- *
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeCookie = exports.setCookie = exports.readCookie = exports.serializeCookie = exports.parseCookie = void 0;
-var tslib_1 = require("tslib");
-var is_1 = require("./is");
-/**
- * RegExp to match field-content in RFC 7230 sec 3.2
- *
- * field-content = field-vchar [ 1*( SP / HTAB ) field-vchar ]
- * field-vchar   = VCHAR / obs-text
- * obs-text      = %x80-FF
- */
-// eslint-disable-next-line no-control-regex
-var fieldContentRegExp = /^[\u0009\u0020-\u007e\u0080-\u00ff]+$/;
-/**
- * Parse a cookie header.
- *
- * Parse the given cookie header string into an object
- * The object has the various cookies as keys(names) => values
- */
-function parseCookie(str, attributes) {
-    if (attributes === void 0) { attributes = {}; }
-    if (typeof str !== "string") {
-        throw new TypeError("argument str must be a string");
-    }
-    var obj = {};
-    var pairs = str.split(";");
-    var _a = attributes.decode, decode = _a === void 0 ? decodeURIComponent : _a;
-    for (var i = 0; i < pairs.length; i++) {
-        var pair = pairs[i];
-        var index = pair.indexOf("=");
-        // skip things that don't look like key=value
-        if (index < 0) {
-            continue;
-        }
-        var key = pair.substring(0, index).trim();
-        // only assign once
-        if (undefined == obj[key]) {
-            var val = pair.substring(index + 1, pair.length).trim();
-            // quoted values
-            if (val[0] === '"') {
-                val = val.slice(1, -1);
-            }
-            obj[key] = tryDecode(val, decode);
-        }
-    }
-    return obj;
-}
-exports.parseCookie = parseCookie;
-/**
- * Serialize data into a cookie header.
- *
- * Serialize the a name value pair into a cookie string suitable for
- * http headers. An optional attributes object specified cookie parameters.
- *
- * serialize('foo', 'bar', { httpOnly: true })
- *   => "foo=bar; httpOnly"
- */
-function serializeCookie(name, val, attributes) {
-    if (attributes === void 0) { attributes = {}; }
-    var _a = attributes.encode, encode = _a === void 0 ? encodeURIComponent : _a, domain = attributes.domain, path = attributes.path, httpOnly = attributes.httpOnly, secure = attributes.secure, sameSite = attributes.sameSite;
-    var maxAge = attributes.maxAge, expires = attributes.expires;
-    var value = encode(val);
-    if (process.env["NODE_ENV"] !== "production") {
-        if (!fieldContentRegExp.test(name)) {
-            throw new TypeError("argument name is invalid");
-        }
-        if (typeof attributes.encode !== "function") {
-            throw new TypeError("option encode is invalid");
-        }
-        if (value && !fieldContentRegExp.test(value)) {
-            throw new TypeError("argument val is invalid");
-        }
-    }
-    var str = name + "=" + value;
-    if (null != maxAge) {
-        maxAge = maxAge - 0;
-        if (isNaN(maxAge) || !isFinite(maxAge)) {
-            throw new TypeError("option maxAge is invalid");
-        }
-        str += "; Max-Age=" + Math.floor(maxAge);
-    }
-    if (domain) {
-        if (process.env["NODE_ENV"] !== "production") {
-            if (!fieldContentRegExp.test(domain)) {
-                throw new TypeError("option domain is invalid");
-            }
-        }
-        str += "; Domain=" + domain;
-    }
-    if (path) {
-        if (process.env["NODE_ENV"] !== "production") {
-            if (!fieldContentRegExp.test(path)) {
-                throw new TypeError("option path is invalid");
-            }
-        }
-        str += "; Path=" + path;
-    }
-    if (expires) {
-        if ((0, is_1.isNumber)(expires)) {
-            expires = new Date(Date.now() + expires * 864e5);
-        }
-        str += "; Expires=" + expires.toUTCString();
-    }
-    if (httpOnly) {
-        str += "; HttpOnly";
-    }
-    if (secure) {
-        str += "; Secure";
-    }
-    if (sameSite) {
-        switch (sameSite.toLowerCase()) {
-            case "lax":
-                str += "; SameSite=Lax";
-                break;
-            case "strict":
-                str += "; SameSite=Strict";
-                break;
-            case "none":
-                str += "; SameSite=None";
-                break;
-            //  default:
-            //    throw new TypeError('option sameSite is invalid');
-        }
-    }
-    return str;
-}
-exports.serializeCookie = serializeCookie;
-/**
- * Try decoding a string using a decoding function.
- */
-function tryDecode(str, decode) {
-    try {
-        return decode(str);
-    }
-    catch (e) {
-        return str;
-    }
-}
-function converterRead(value) {
-    if (value[0] === '"') {
-        value = value.slice(1, -1);
-    }
-    return value.replace(/(%[\dA-F]{2})+/gi, decodeURIComponent);
-}
-function converterWrite(value) {
-    return encodeURIComponent(value).replace(/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g, decodeURIComponent);
-}
-function readCookie(name) {
-    if (typeof document === "undefined") {
-        if (process.env["NODE_ENV"] !== "production") {
-            console.warn("@koine/utils:cookie readCookie, document is undefined");
-        }
-        return name ? "" : {};
-    }
-    var cookies = document.cookie ? document.cookie.split("; ") : [];
-    var all = {};
-    for (var i = 0; i < cookies.length; i++) {
-        var parts = cookies[i].split("=");
-        var value = parts.slice(1).join("=");
-        try {
-            var found = decodeURIComponent(parts[0]);
-            all[found] = converterRead(value);
-            if (name === found) {
-                break;
-            }
-        }
-        catch (e) {
-            if (process.env["NODE_ENV"] !== "production") {
-                console.warn("@koine/utils:cookie readCookie, failed to decode", value);
-            }
-        }
-    }
-    return name ? all[name] : all;
-}
-exports.readCookie = readCookie;
-var defaultAttributesClient = { path: "/" };
-function setCookie(name, value, attributes) {
-    if (attributes === void 0) { attributes = {}; }
-    // eslint-disable-next-line prefer-const
-    var expires = attributes.expires, restAttrs = tslib_1.__rest(attributes, ["expires"]);
-    var cleanedAttrs = tslib_1.__assign(tslib_1.__assign({ expires: "" }, defaultAttributesClient), restAttrs);
-    if (typeof document === "undefined") {
-        if (process.env["NODE_ENV"] !== "production") {
-            console.warn("@koine/utils:cookie setCookie, document is undefined");
-        }
-        return;
-    }
-    if ((0, is_1.isNumber)(expires)) {
-        expires = new Date(Date.now() + expires * 864e5);
-    }
-    if (expires) {
-        cleanedAttrs.expires = expires.toUTCString();
-    }
-    name = encodeURIComponent(name)
-        .replace(/%(2[346B]|5E|60|7C)/g, decodeURIComponent)
-        .replace(/[()]/g, escape);
-    var stringifiedAttributes = "";
-    for (var name_1 in attributes) {
-        var attrName = name_1;
-        if (!attributes[attrName]) {
-            continue;
-        }
-        stringifiedAttributes += "; " + attrName;
-        if (attributes[attrName] === true) {
-            continue;
-        }
-        // Considers RFC 6265 section 5.2:
-        // ...
-        // 3.  If the remaining unparsed-attributes contains a %x3B (";")
-        //     character:
-        // Consume the characters of the unparsed-attributes up to,
-        // not including, the first %x3B (";") character.
-        // ...
-        stringifiedAttributes +=
-            "=" + String(attributes[attrName]).split(";")[0];
-    }
-    return (document.cookie =
-        name + "=" + converterWrite(value) + stringifiedAttributes);
-}
-exports.setCookie = setCookie;
-function removeCookie(name, attributes) {
-    if (attributes === void 0) { attributes = {}; }
-    setCookie(name, "", tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, defaultAttributesClient), attributes), { expires: -1 }));
-}
-exports.removeCookie = removeCookie;
+exports.defaultAttributesClient = void 0;
+exports.defaultAttributesClient = { path: "/" };

package/node/decode.js

@@ -0,0 +1,14 @@
+"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/node/encode.js

@@ -0,0 +1,14 @@
+"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;

package/node/{cast.js → ensureInt.js}

@@ -1,15 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ensureInt = exports.toNumber = void 0;
-var is_1 = require("./is");
-function toNumber(input, fallback) {
-    return (0, is_1.isNumber)(input) ? input : input ? parseFloat(input) : fallback || 0;
-}
-exports.toNumber = toNumber;
+exports.ensureInt = void 0;
 /**
  * Ensure input to be an integer
+ *
+ * @category cast
  */
 var ensureInt = function (input) {
     return typeof input === "string" ? parseInt(input, 10) : Math.round(input);
 };
 exports.ensureInt = ensureInt;
+exports.default = exports.ensureInt;

package/node/findDuplicatedIndexes.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findDuplicatedIndexes = void 0;
+/**
+ * @category array
+ */
+function findDuplicatedIndexes(arr) {
+    var indexes = {};
+    for (var i = 0; i < arr.length; i++) {
+        var idxInArray = arr.indexOf(arr[i]);
+        if (idxInArray !== i && idxInArray !== -1) {
+            indexes[i] = true;
+        }
+    }
+    return indexes;
+}
+exports.findDuplicatedIndexes = findDuplicatedIndexes;
+exports.default = findDuplicatedIndexes;