@koine/utils 2.0.0-beta.13 → 2.0.0-beta.130

package/accentSets.mjs

@@ -1,123 +0,0 @@
-/**
- * First value is the `to`, second is `from`, from *which* chars do we translates *to*
- *
- * @category text
- */ /**
- * Accent sets
- *
- * @category text
- * @resources
- * - https://gist.github.com/mathewbyrne/1280286#gistcomment-3498021
- * - 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 const 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.mjs

@@ -1,26 +0,0 @@
-/**
- * Add or replace an item in the given array, it returns a new array (immutable).
- * Typescript wise this is meant to keep the same type on the newly returned
- * array, therefore the `newItem` must match the type of the `list` items.
- *
- * @category array
- */ export function addOrReplaceAtIdx(list, newItem, newIdx) {
-    if (list.length === 0) {
-        return [
-            newItem
-        ];
-    }
-    if (typeof newIdx === "undefined" || list.length - 1 < newIdx) {
-        return [
-            ...list,
-            newItem
-        ];
-    }
-    return list.map((item, idx)=>{
-        if (idx === newIdx) {
-            return newItem;
-        }
-        return item;
-    });
-}
-export default addOrReplaceAtIdx;

package/areEqual.mjs

@@ -1,71 +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(let i = 0; i < a.length; i++){
-        const aValue = a[i];
-        const bValue = b[i];
-        if (!areEqual(aValue, bValue)) return false;
-    }
-    return true;
-}
-function areEqualObjects(a, b) {
-    if (!b) return false;
-    const aKeys = Object.keys(a);
-    const bKeys = Object.keys(b);
-    if (aKeys.length !== bKeys.length) {
-        return false;
-    }
-    for (const _key of aKeys){
-        const key = _key;
-        const aValue = a[key];
-        const 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 object
- */ 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;
-    }
-    const areObjects = isObject(a) && isObject(b);
-    if (areObjects && !areEqualObjects(a, b)) {
-        // console.log(`areEqual took ${performance.now() - t0} ms`);
-        return false;
-    }
-    const 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/arraySum.mjs

@@ -1,7 +0,0 @@
-/**
- * Sum array of numbers
- *
- * @category array
- * @category math
- */ export const arraySum = (numbers)=>numbers.reduce((sum, current)=>sum + current, 0);
-export default arraySum;

package/arrayToLookup.mjs

@@ -1,11 +0,0 @@
-/**
- * Maps a simple flat array to a lookup dictionary object
- *
- * @category array
- */ export function arrayToLookup(array = []) {
-    return array.reduce((obj, item)=>{
-        obj[item] = 1;
-        return obj;
-    }, {});
-}
-export default arrayToLookup;

package/buildUrlQueryString.mjs

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

package/capitalize.mjs

@@ -1,11 +0,0 @@
-/**
- * Capitalize first letter of the given string.
- *
- * @category text
- * @resources
- * - https://stackoverflow.com/a/11409944/1938970
- */ export function capitalize(string) {
-    const 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.mjs

@@ -1,17 +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) {
-    const path = normaliseUrlPathname(`/${pathname}/`);
-    if (isBrowser) {
-        history[replace ? "replaceState" : "pushState"](state, "", path);
-    }
-    return path;
-}
-export default changeUrlPath;

package/chunkByChunks.mjs

@@ -1,34 +0,0 @@
-/**
- * @category array
- * @see https://stackoverflow.com/a/8189268/1938970
- * @experimental TODO: untested
- */ export function chunkByChunks(arr, nrOfChunks, balanced) {
-    if (nrOfChunks < 2) return [
-        arr
-    ];
-    const len = arr.length;
-    const output = [];
-    let i = 0;
-    let 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;
-}
-export default chunkByChunks;

package/chunkBySize.mjs

@@ -1,11 +0,0 @@
-/**
- * @category array
- * @see https://stackoverflow.com/a/40682136/1938970
- */ export function chunkBySize(arr, size) {
-    const output = [];
-    for(let i = 0; i < arr.length; i += size){
-        output.push(arr.slice(i, i + size));
-    }
-    return output;
-}
-export default chunkBySize;

package/clsx.mjs

@@ -1,48 +0,0 @@
-// import type { ClassValue } from "clsx";
-// import _clsx from "clsx";
-// export const clsx = _clsx;
-function toVal(mix) {
-    let 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
- *
- * @category impl
- * @borrows [lukeed/clsx](https://github.com/lukeed/clsx)
- * @license MIT Luke Edwards https://github.com/lukeed/clsx/blob/master/license
- */ export const clsx = function() {
-    let 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;
-};
-export default clsx;

package/cookie.mjs

@@ -1,15 +0,0 @@
-/**
- * @module
- *
- * @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)
- */ /**
- * @category cookie
- */ /**
- * @category cookie
- */ export const defaultAttributesClient = {
-    path: "/"
-};

package/createPalette.mjs

@@ -1,32 +0,0 @@
-/**
- * Create palette, this is primarily thought to improve the reuse of a palette
- * definition between TailwindCSS and straight ES imports
- *
- * @category colors
- * @category tailwind
- * @category responsive
- *
- * @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)
- */ export const createPalette = (name, shades)=>{
-    const map = shades.reduce((map, def)=>{
-        map[def[0]] = def[1];
-        return map;
-    }, {});
-    // NOTE: the following breaks typedoc, with `any` it compiles
-    // const map = shades.reduce((map, def) => {
-    //   map[def[0]] = def[1] as TColor;
-    //   return map;
-    // }, {} as { [s: string]: TColor });
-    const tailwindPalette = shades.reduce((map, def)=>{
-        map[`${name}-${def[0]}`] = def[1];
-        return map;
-    }, {});
-    return [
-        map,
-        tailwindPalette,
-        Object.values(map)
-    ];
-};
-export default createPalette;

package/debounce.mjs

@@ -1,21 +0,0 @@
-/**
- * Debounce function (with `setTimeout`)
- *
- * @category function
- * @borrows [davidwalsh/debounce](https://davidwalsh.name/javascript-debounce-function)
- */ export function debounce(fn, wait, immediate) {
-    let timeout;
-    return function(...args) {
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
-        const context = this;
-        const later = function() {
-            timeout = null;
-            if (!immediate) fn.apply(context, args);
-        };
-        const callNow = immediate && !timeout;
-        if (timeout) clearTimeout(timeout);
-        timeout = setTimeout(later, wait);
-        if (callNow) fn.apply(context, args);
-    };
-}
-export default debounce;

package/debouncePromise.mjs

@@ -1,79 +0,0 @@
-// import { debounce as tsDebounce } from "ts-debounce";
-// export { type Options as DebounceOptions } from "ts-debounce";
-// export { type DebouncedFunction } from "ts-debounce";
-// /**
-//  * Debounce function (with `Promise`)
-//  *
-//  * @category function
-//  * @borrows [chodorowicz/ts-debounce](https://github.com/chodorowicz/ts-debounce)
-//  */
-// export const debouncePromise = tsDebounce;
-// export default debouncePromise;
-/**
- * Copy pasted from [chodorowicz/ts-debounce](https://github.com/chodorowicz/ts-debounce/blob/master/src/index.ts)
- *
- * @module
- */ /**
- * @categroy functionn
- */ /**
- * Debounce function (with `Promise`)
- *
- * @category function
- * @borrows [chodorowicz/ts-debounce](https://github.com/chodorowicz/ts-debounce)
- * @license MIT: Jakub Chodorowicz
- */ export function debouncePromise(func, waitMilliseconds = 50, options = {}) {
-    let timeoutId;
-    const isImmediate = options.isImmediate ?? false;
-    const callback = options.callback ?? false;
-    const maxWait = options.maxWait;
-    let lastInvokeTime = Date.now();
-    let promises = [];
-    function nextInvokeTimeout() {
-        if (maxWait !== undefined) {
-            const timeSinceLastInvocation = Date.now() - lastInvokeTime;
-            if (timeSinceLastInvocation + waitMilliseconds >= maxWait) {
-                return maxWait - timeSinceLastInvocation;
-            }
-        }
-        return waitMilliseconds;
-    }
-    const debouncedFunction = function(...args) {
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
-        const context = this;
-        return new Promise((resolve, reject)=>{
-            const invokeFunction = function() {
-                timeoutId = undefined;
-                lastInvokeTime = Date.now();
-                if (!isImmediate) {
-                    const result = func.apply(context, args);
-                    callback && callback(result);
-                    promises.forEach(({ resolve })=>resolve(result));
-                    promises = [];
-                }
-            };
-            const shouldCallNow = isImmediate && timeoutId === undefined;
-            if (timeoutId !== undefined) {
-                clearTimeout(timeoutId);
-            }
-            timeoutId = setTimeout(invokeFunction, nextInvokeTimeout());
-            if (shouldCallNow) {
-                const result = func.apply(context, args);
-                callback && callback(result);
-                return resolve(result);
-            }
-            promises.push({
-                resolve,
-                reject
-            });
-        });
-    };
-    debouncedFunction.cancel = function(reason) {
-        if (timeoutId !== undefined) {
-            clearTimeout(timeoutId);
-        }
-        promises.forEach(({ reject })=>reject(reason));
-        promises = [];
-    };
-    return debouncedFunction;
-}
-export default debouncePromise;

package/debounceRaf.mjs

@@ -1,22 +0,0 @@
-/**
- * Debounce function (with `requestAnimationFrame`)
- *
- * @category function
- * @borrows [vanillajstoolkit/debounce](https://vanillajstoolkit.com/helpers/debounce/)
- * @license (c) 2021 Chris Ferdinandi, MIT License, https://gomakethings.com
- */ export function debounceRaf(fn) {
-    let timeout;
-    return function(...args) {
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
-        const 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);
-        });
-    };
-}
-export default debounceRaf;

package/decode.mjs

@@ -1,9 +0,0 @@
-/**
- * @category security
- * @see https://stackoverflow.com/a/22405578/9122820
- */ export function decode(str) {
-    return str.replace(/.{3}/g, function(c) {
-        return String.fromCharCode(parseInt(c, 10));
-    });
-}
-export default decode;

package/encode.mjs

@@ -1,9 +0,0 @@
-/**
- * @category security
- * @see https://stackoverflow.com/a/22405578/9122820
- */ export function encode(str) {
-    return str.replace(/./g, function(c) {
-        return ("00" + c.charCodeAt(0)).slice(-3);
-    });
-}
-export default encode;

package/ensureInt.mjs

@@ -1,6 +0,0 @@
-/**
- * Ensure input to be an integer
- *
- * @category cast
- */ export const ensureInt = (input)=>typeof input === "string" ? parseInt(input, 10) : Math.round(input);
-export default ensureInt;

package/env.mjs

@@ -1,2 +0,0 @@
-// export const __DEV__ = process.env["NODE_ENV"] !== "production";
-// export const __TEST__ = process.env["NODE_ENV"] === "test";

package/errorToString.mjs

@@ -1,8 +0,0 @@
-import isString from "./isString";
-/**
- * Ensure to transform a JavaScript `Error` into a string (uses its `message`)
- *
- * @category error
- * @category cast
- */ export const errorToString = (e)=>e instanceof Error ? e.message : isString(e) ? e : "";
-export default errorToString;

package/findDuplicatedIndexes.mjs

@@ -1,13 +0,0 @@
-/**
- * @category array
- */ export function findDuplicatedIndexes(arr) {
-    const indexes = {};
-    for(let i = 0; i < arr.length; i++){
-        const idxInArray = arr.indexOf(arr[i]);
-        if (idxInArray !== i && idxInArray !== -1) {
-            indexes[i] = true;
-        }
-    }
-    return indexes;
-}
-export default findDuplicatedIndexes;

package/forin.mjs

@@ -1,11 +0,0 @@
-/**
- * To easily get typed native `for in`
- *
- * @category native
- * @category object
- */ export function forin(object, cb) {
-    for(const key in object){
-        cb(key, object[key]);
-    }
-}
-export default forin;

package/gbToBytes.mjs

@@ -1,6 +0,0 @@
-/**
- * Gigabytes to bytes
- *
- * @category format
- */ export const gbToBytes = (bytes)=>bytes * 1000 * 1000 * 1000;
-export default gbToBytes;

package/getEmptyArray.mjs

@@ -1,15 +0,0 @@
-import isNumber from "./isNumber";
-/**
- * Returns an array of undefined values of the desired length, useful to build
- * skeleton UIs.
- *
- * @category array
- */ export function getEmptyArray(length) {
-    if (!isNumber(length)) {
-        length = parseInt(length, 10);
-    }
-    return Array.from({
-        length
-    });
-}
-export default getEmptyArray;