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

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

@@ -1,9 +0,0 @@
-/**
- * Returns a number whose value is limited to the given range.
- *
- * @category math
- * @see https://stackoverflow.com/a/11409944/1938970
- */ export function clamp(num, min, max) {
-    return Math.min(Math.max(num, min), max);
-}
-export default clamp;

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

@@ -1,17 +0,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
- * @example
- *
- * ```ts
- * convertRange(5, [0, 10], [50, 100]);
- * ```
- *
- * @category math
- * @see https://stackoverflow.com/a/14224813
- */ export function convertRange(num, r1, r2) {
-    return (num - r1[0]) * (r2[1] - r2[0]) / (r1[1] - r1[0]) + r2[0];
-}
-export default convertRange;

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;

package/getKeys.mjs

@@ -1,9 +0,0 @@
-/**
- * Type safe replacement for `Object.keys(myObject)` to iterate over a record
- * without loosing the key's types in simple `string`s.
- *
- * @category native
- * @category object
- * @see https://stackoverflow.com/a/59459000/1938970
- */ export const getKeys = Object.keys;
-export default getKeys;

package/getMediaQueryWidthResolvers.mjs

@@ -1,67 +0,0 @@
-/**
- * @category responsive
- */ /**
- * @category responsive
- */ export function getMediaQueryWidthResolvers(customBreakpoints) {
-    const breakpoints = {
-        xs: 0,
-        ...customBreakpoints
-    };
-    const sortedBreakpointsNames = Object.keys(breakpoints).map((key)=>{
-        const br = key;
-        return [
-            br,
-            breakpoints[br]
-        ];
-    }).sort((a, b)=>a[1] - b[1]).map((item)=>item[0]);
-    const getNextBreakpoint = (breakpoint)=>{
-        const index = sortedBreakpointsNames.indexOf(breakpoint);
-        return sortedBreakpointsNames[index + 1];
-    };
-    /**
-   * It behaves the same as `(min-width: ${value}px)`
-   * where value is the given breakpoint value.
-   * For ease of use this can be used both as a function `min("md")` and as an
-   * object literal `min.md`.
-   */ const min = (br)=>`(min-width: ${breakpoints[br]}px)`;
-    /**
-   * It behaves the same as `(max-width: ${value}px)`
-   * where value is the given breakpoint value.
-   * For ease of use this can be used both as a function `max("md")` and as an
-   * object literal `max.md`.
-   */ const max = (br)=>`(max-width: ${breakpoints[br] - 0.02}px)`;
-    /**
-   * It behaves the same as `min`
-   * @inheritdoc {max}
-   */ const up = min;
-    /**
-   * It behaves similarly to `max` but you will use the "next" breakpoint,
-   * specifying CSS that will apply from the given breakpoint and down.
-   */ const down = (br)=>{
-        const brNext = getNextBreakpoint(br);
-        // TODO: if br does not exists otherwise throw Error
-        return brNext && `(max-width: ${breakpoints[brNext] - 0.02}px)`;
-    };
-    /**
-   * Media query between the two given breakpoints
-   */ const between = (br1, br2)=>{
-        br2 = br2 || getNextBreakpoint(br1);
-        return br2 ? `(min-width: ${breakpoints[br1]}px) and (max-width: ${breakpoints[br2] - 0.02}px)` : min(br1);
-    };
-    /**
-   * Media query to apply from the given breakpoint until the next, just for its
-   * full range
-   */ const only = (br)=>{
-        const brNext = getNextBreakpoint(br);
-        return brNext ? between(br, brNext) : min(br);
-    };
-    return {
-        max,
-        min,
-        down,
-        up,
-        between,
-        only
-    };
-}
-export default getMediaQueryWidthResolvers;

package/getMediaQueryWidthTailwindScreens.mjs

@@ -1,36 +0,0 @@
-import { getMediaQueryWidthResolvers } from "./getMediaQueryWidthResolvers";
-/**
- * @category responsive
- * @category tailwind
- */ export function getMediaQueryWidthTailwindScreens(breakpoints) {
-    const mqWidthResolvers = getMediaQueryWidthResolvers(breakpoints);
-    // Object.keys(breakpoints).reduce((screens, br) => {
-    const screens = Object.keys(breakpoints).reduce((output, br, idx)=>{
-        const brNext = Object.keys(breakpoints)[idx + 1];
-        for(const resolverName in mqWidthResolvers){
-            // this line is just for typescript..
-            const resolver = resolverName;
-            const resolverFn = mqWidthResolvers[resolver];
-            const raw = resolverFn(br);
-            if (raw) {
-                if (resolverName === "min") {
-                    output[`@${br}`] = {
-                        raw
-                    };
-                }
-                if (resolverName === "between") {
-                    if (brNext) output[`@${resolverName}-${br}_${brNext}`] = {
-                        raw
-                    };
-                } else {
-                    output[`@${resolverName}-${br}`] = {
-                        raw
-                    };
-                }
-            }
-        }
-        return output;
-    }, {});
-    return screens;
-}
-export default getMediaQueryWidthTailwindScreens;

package/getNonce.mjs

@@ -1,8 +0,0 @@
-import { isUndefined } from "./isUndefined";
-/**
- * @category security
- * @see https://github.com/styled-components/styled-components/blob/main/packages/styled-components/src/utils/nonce.ts
- */ export function getNonce() {
-    return isUndefined(__webpack_nonce__) ? null : __webpack_nonce__;
-}
-export default getNonce;

package/getParamAmong.mjs

@@ -1,16 +0,0 @@
-import getParamAsString from "./getParamAsString";
-/**
- * Get query parameter as `string` treating the `ParsedUrlQuery` result of
- * [`querystring`](https://nodejs.org/api/querystring.html) (used in next.js
- * router and elsewhere)
- *
- * @category location
- *
- * @param raw The _raw_ query parameter
- * @param allowedValues The list of values (as strings) that the parameter can
- * have, if not one of them `null` is returned
- */ export function getParamAmong(raw, allowedValues = []) {
-    const string = getParamAsString(raw);
-    return allowedValues.includes(string) ? string : null;
-}
-export default getParamAmong;

package/getParamAsInt.mjs

@@ -1,18 +0,0 @@
-import getParamAsString from "./getParamAsString";
-/**
- * Get query parameter as `int`eger treating the `ParsedUrlQuery` result of
- * [`querystring`](https://nodejs.org/api/querystring.html) (used in next.js
- * router and elsewhere)
- *
- * @category location
- *
- * @param raw The _raw_ query parameter
- * @param fallback Fallback number, we return `null` if not provided
- */ export function getParamAsInt(raw, fallback = null) {
-    const string = getParamAsString(raw);
-    if (string) {
-        return parseInt(string, 10);
-    }
-    return fallback;
-}
-export default getParamAsInt;

package/getParamAsString.mjs

@@ -1,13 +0,0 @@
-import isArray from "./isArray";
-/**
- * Get query parameter as `string` treating the `ParsedUrlQuery` result of
- * [`querystring`](https://nodejs.org/api/querystring.html) (used in next.js
- * router and elsewhere)
- *
- * @category location
- *
- * @param raw The _raw_ query parameter
- */ export function getParamAsString(raw) {
-    return (isArray(raw) ? raw[0] : raw) || "";
-}
-export default getParamAsString;

package/getType.mjs

@@ -1,14 +0,0 @@
-/**
- * @file
- *
- * Same as [is-what](https://github.com/mesqueeb/is-what) plus:
- *
- * - `isFormData`
- * - `isInt`
- * - `isFloat`
- */ /**
- * Returns the object type of the given payload
- */ export function getType(payload) {
-    return Object.prototype.toString.call(payload).slice(8, -1);
-}
-export default getType;