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

package/quaranteneProps.mjs

@@ -1,31 +0,0 @@
-/**
- * @category impl
- * @example
- *
- * ```ts
- * const { _: { onKeyDown }, myOwnProp, ...rest } = quaranteneProps([
- *   "onPointerLeave",
- *   "onPointerMove",
- *   "onClick",
- *   "onPointerDown",
- *   "onPointerUp",
- *   "onKeyDown",
- * ]);
- * ```
- */ export function quaranteneProps(props, propsKeysToQuarantene) {
-    // approach 1)
-    const healthyProps = {
-        _: {}
-    };
-    for(const key in props){
-        const prop = props[key];
-        if (propsKeysToQuarantene.includes(key)) {
-            healthyProps._[key] = prop;
-        } else {
-            // @ts-expect-error nevermind
-            healthyProps[key] = prop;
-        }
-    }
-    return healthyProps;
-}
-export default quaranteneProps;

package/randomInt.mjs

@@ -1,8 +0,0 @@
-/**
- * Get random int (min and max included)
- *
- * @category math
- */ export function randomInt(min, max) {
-    return Math.floor(Math.random() * (max - min + 1) + min);
-}
-export default randomInt;

package/randomKey.mjs

@@ -1,10 +0,0 @@
-/**
- * Get random key from given object
- *
- * @category misc
- * @see https://stackoverflow.com/a/15106541/1938970
- */ export function randomKey(obj) {
-    const keys = Object.keys(obj);
-    return keys[keys.length * Math.random() << 0];
-}
-export default randomKey;

package/readCookie.mjs

@@ -1,33 +0,0 @@
-function converterRead(value) {
-    if (value[0] === '"') {
-        value = value.slice(1, -1);
-    }
-    return value.replace(/(%[\dA-F]{2})+/gi, decodeURIComponent);
-}
-export function readCookie(name) {
-    if (typeof document === "undefined") {
-        if (process.env["NODE_ENV"] !== "production") {
-            console.warn("[@koine/utils:readCookie] document is undefined");
-        }
-        return name ? "" : {};
-    }
-    const cookies = document.cookie ? document.cookie.split("; ") : [];
-    const all = {};
-    for(let i = 0; i < cookies.length; i++){
-        const parts = cookies[i].split("=");
-        const value = parts.slice(1).join("=");
-        try {
-            const found = decodeURIComponent(parts[0]);
-            all[found] = converterRead(value);
-            if (name === found) {
-                break;
-            }
-        } catch (e) {
-            if (process.env["NODE_ENV"] !== "production") {
-                console.warn("[@koine/utils:readCookie] failed to decode", value);
-            }
-        }
-    }
-    return name ? all[name] : all;
-}
-export default readCookie;

package/removeAccents.mjs

@@ -1,12 +0,0 @@
-import { accentsSets } from "./accentSets";
-/**
- * @category text
- */ export function removeAccents(text = "", sets = accentsSets) {
-    let len = sets.length;
-    while(len--){
-        const [to, from] = sets[len];
-        text = text.replace(new RegExp(`[${from}]`, "gi"), to);
-    }
-    return text;
-}
-export default removeAccents;

package/removeCookie.mjs

@@ -1,12 +0,0 @@
-import { defaultAttributesClient } from "./cookie";
-import { setCookie } from "./setCookie";
-/**
- * @category cookie
- */ export function removeCookie(name, attributes = {}) {
-    setCookie(name, "", {
-        ...defaultAttributesClient,
-        ...attributes,
-        expires: -1
-    });
-}
-export default removeCookie;

package/removeDuplicates.mjs

@@ -1,12 +0,0 @@
-// /**
-//  * FIXME: Type 'Set<any>' can only be iterated through when using the
-//  * '--downlevelIteration' flag or with a '--target' of 'es2015' or higher.
-//  * I am not sure I want to use those ts options here. Let's keep it commented
-//  * for now
-//  *
-//  * @category array
-//  */
-// export function removeDuplicates<T extends any[]>(arr: T) {
-//   return [...new Set(arr)];
-// }
-// export default removeDuplicates;

package/removeDuplicatesByKey.mjs

@@ -1,18 +0,0 @@
-/**
- * Remove duplicated array objects, equality is determined by a strict (`===`)
- * comparison of each object's given key
- *
- * @category array
- */ export function removeDuplicatesByKey(array = [], key) {
-    const keysMap = {};
-    const output = [];
-    for(let i = 0; i < array.length; i++){
-        const item = array[i];
-        if (!keysMap[item[key]]) {
-            output.push(item);
-            keysMap[item[key]] = true;
-        }
-    }
-    return output;
-}
-export default removeDuplicatesByKey;

package/removeDuplicatesComparing.mjs

@@ -1,9 +0,0 @@
-import { findDuplicatedIndexes } from "./findDuplicatedIndexes";
-import { removeIndexesFromArray } from "./removeIndexesFromArray";
-/**
- * @category array
- */ export function removeDuplicatesComparing(from, to) {
-    const indexes = findDuplicatedIndexes(from);
-    return removeIndexesFromArray(to, indexes);
-}
-export default removeDuplicatesComparing;

package/removeIndexesFromArray.mjs

@@ -1,13 +0,0 @@
-/**
- * @category array
- */ export function removeIndexesFromArray(arr, indexes) {
-    const output = [];
-    for(let i = 0; i < arr.length; i++){
-        // eslint-disable-next-line no-prototype-builtins
-        if (!indexes.hasOwnProperty(i)) {
-            output.push(arr[i]);
-        }
-    }
-    return output;
-}
-export default removeIndexesFromArray;

package/removeTrailingSlash.mjs

@@ -1,8 +0,0 @@
-/**
- * Strips out the trailing slash
- *
- * @category location
- */ export function removeTralingSlash(urlLike = "") {
-    return urlLike.replace(/\/*$/, "");
-}
-export default removeTralingSlash;

package/removeUrlQueryParams.mjs

@@ -1,18 +0,0 @@
-import buildUrlQueryString from "./buildUrlQueryString";
-import getUrlQueryParams from "./getUrlQueryParams";
-/**
- * Remove the given keys from the given URL query parameters
- *
- * @category location
- */ export function removeUrlQueryParams(url, paramsToRemove = []) {
-    const parts = url.split("?");
-    const allParams = getUrlQueryParams(url);
-    const params = {};
-    for(const key in allParams){
-        if (!paramsToRemove.includes(key)) {
-            params[key] = allParams[key];
-        }
-    }
-    return parts[0] + buildUrlQueryString(params);
-}
-export default removeUrlQueryParams;

package/render.mjs

@@ -1,111 +0,0 @@
-const varname = "data";
-const evaluate = /<%([\s\S]+?(\}?)+)%>/g;
-const interpolate = /<%=([\s\S]+?)%>/g;
-const conditional = /<%\?(\?)?\s*([\s\S]*?)\s*%>/g;
-const iterate = /<%~\s*(?:%>|([\s\S]+?)\s*:\s*([\w$]+)\s*(?::\s*([\w$]+))?\s*%>)/g;
-// const encode = /<%!([\s\S]+?)%>/g;
-const use = /<%#([\s\S]+?)%>/g;
-const useParams = /(^|[^\w$])def(?:\.|\[['"])([\w$.]+)(?:['"]\])?\s*:\s*([\w$.]+|"[^"]+"|'[^']+'|\{[^}]+\})/g;
-const define = /<%##\s*([\w.$]+)\s*(:|=)([\s\S]+?)#%>/g;
-const defineParams = /^\s*([\w$]+):([\s\S]+)/;
-const start = "'+(";
-const end = ")+'";
-// const startencode = "'+encodeHTML(";
-const skip = /$^/;
-const resolveDefs = (block, def)=>(typeof block === "string" ? block : block.toString()).replace(define || skip, (_, code, assign, value)=>{
-        if (code.indexOf("def.") === 0) {
-            code = code.substring(4);
-        }
-        if (!(code in def)) {
-            if (assign === ":") {
-                value.replace(defineParams, // @ts-expect-error nevermind
-                (_, param, v)=>{
-                    def[code] = {
-                        arg: param,
-                        text: v
-                    };
-                });
-                // @ts-expect-error nevermind
-                if (!(code in def)) def[code] = value;
-            } else {
-                new Function("def", "def['" + code + "']=" + value)(def);
-            }
-        }
-        return "";
-    }).replace(use || skip, (_, code)=>{
-        code = code.replace(useParams, (_, s, d, param)=>{
-            if (def[d] && def[d].arg && param) {
-                const rw = (d + ":" + param).replace(/'|\\/g, "_");
-                def.__exp = def.__exp || {};
-                def.__exp[rw] = def[d].text.replace(new RegExp("(^|[^\\w$])" + def[d].arg + "([^\\w$])", "g"), "$1" + param + "$2");
-                return s + "def.__exp['" + rw + "']";
-            }
-            return s;
-        });
-        const v = new Function("def", "return " + code)(def);
-        return v ? resolveDefs(v, def) : v;
-    });
-const unescape = (code)=>code.replace(/\\('|\\)/g, "$1").replace(/[\r\t\n]/g, " ");
-/**
- * Render template (adapted from doT.js)
- *
- * The data made available to the template is always on the `data` key, e.g.:
- * `renderer({ myVal: "xx" })`
- * ... will be accessible on
- * `<%= data.myVal %>`
- *
- * The default delimiters are customised to work without conflicts with Blade and Twig:
- * ```
- * <% %>	for evaluation
- * <%= %>	for interpolation
- * <%? %>	for conditionals
- * <%~ %>	for array iteration
- * <%# %>	for compile-time evaluation/includes and partials
- * <%## #%>	for compile-time defines
- *
- * Unsupported:
- * <%! %>	for interpolation with encoding
- * ```
- *
- * @category impl
- * @example
- *
- * ```ts
- * import { render } from "...";
- *
- * const data = { name: "XYZ" };
- * const tpl = `Hello <%= data.name %>`;
- * const renderer = render(tpl);
- *
- * console.log(renderer(data)); // outputs 'Hello XYZ'
- * ```
- *
- * @borrows [olado/doT by Laura Doktorova](https://github.com/olado/doT)
- * @see https://olado.github.io/doT/index.html
- */ export const render = (tmpl, def)=>{
-    let sid = 0;
-    let indv;
-    let str = use || define ? resolveDefs(tmpl, def || {}) : tmpl;
-    str = ("var X='" + str.replace(/(^|\r|\n)\t* +| +\t*(\r|\n|$)/g, " ").replace(/\r|\n|\t|\/\*[\s\S]*?\*\//g, "").replace(/'|\\/g, "\\$&").replace(interpolate || skip, (_, code)=>start + unescape(code) + end)// .replace(
-    //   encode || skip,
-    //   (_, code) => cse.startencode + unescape(code) + cse.end
-    // )
-    .replace(conditional || skip, (_, elseCase, code)=>elseCase ? code ? "';}else if(" + unescape(code) + "){X+='" : "';}else{X+='" : code ? "';if(" + unescape(code) + "){X+='" : "';}X+='").replace(iterate || skip, (_, arr, vName, iName)=>{
-        if (!arr) return "';} } X+='";
-        sid++;
-        indv = iName || "i" + sid;
-        arr = unescape(arr);
-        return "';var arr" + sid + "=" + arr + ";if(arr" + sid + "){var " + vName + "," + indv + "=-1,l" + sid + "=arr" + sid + ".length-1;while(" + indv + "<l" + sid + "){" + vName + "=arr" + sid + "[" + indv + "+=1];X+='";
-    }).replace(evaluate || skip, (_, code)=>"';" + unescape(code) + "X+='") + "';return X;").replace(/\n/g, "\\n").replace(/\t/g, "\\t").replace(/\r/g, "\\r").replace(/(\s|;|\}|^|\{)X\+='';/g, "$1").replace(/\+''/g, "");
-    //.replace(/(\s|;|\}|^|\{)X\+=''\+/g,'$1X+=');
-    try {
-        return new Function(varname, str);
-    } catch (e) {
-        if (process.env["NODE_ENV"] !== "production") {
-            console.log("Could not create a template function: " + str);
-            throw e;
-        }
-    }
-    return ()=>"";
-};
-export default render;

package/roundTo.mjs

@@ -1,32 +0,0 @@
-/**
- * Round to given number of the given number of decimals
- *
- * @category math
- * @see https://stackoverflow.com/a/15762794/1938970
- */ export function roundTo(num, decimals = 2) {
-    if (isFinite(num) && !isNaN(num)) {
-        // method 1
-        // return Number(num).toFixed(decimals);
-        // method 2: @see https://stackoverflow.com/a/43532829/1938970
-        const multiplicator = Math.pow(10, decimals);
-        return Math.round(num * multiplicator) / multiplicator + "";
-    // method 3: @see https://stackoverflow.com/a/15762794/1938970
-    // let negative = false;
-    // if (num < 0) {
-    //   negative = true;
-    //   num = num * -1;
-    // }
-    // const multiplicator = Math.pow(10, decimals);
-    // const outputStr = parseFloat((num * multiplicator).toFixed(11));
-    // let outputNum = (Math.round(outputStr) / multiplicator).toFixed(decimals);
-    // if (negative) {
-    //   return (Number(outputNum) * -1).toFixed(decimals);
-    // }
-    // return outputNum;
-    }
-    if (process.env["NODE_ENV"] !== "production") {
-        console.warn("[@koine/utils] math:roundTo -> given not a finite number as first arg");
-    }
-    return "";
-}
-export default roundTo;

package/serializeCookie.mjs

@@ -1,94 +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)
- */ import { isNumber } from "./isNumber";
-/**
- * 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
-const fieldContentRegExp = /^[\u0009\u0020-\u007e\u0080-\u00ff]+$/;
-/**
- * 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"
- *
- * @category cookie
- */ export function serializeCookie(name, val, attributes = {}) {
-    const { encode = encodeURIComponent, domain, path, httpOnly, secure, sameSite } = attributes;
-    let { maxAge, expires } = attributes;
-    const 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");
-        }
-    }
-    let 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 (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;
-        }
-    }
-    return str;
-}
-export default serializeCookie;

package/setCookie.mjs

@@ -1,51 +0,0 @@
-import { defaultAttributesClient } from "./cookie";
-import isNumber from "./isNumber";
-import isUndefined from "./isUndefined";
-function converterWrite(value) {
-    return encodeURIComponent(value).replace(/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g, decodeURIComponent);
-}
-/**
- * @category cookie
- */ export function setCookie(name, value, attributes = {}) {
-    // eslint-disable-next-line prefer-const
-    let { expires, ...restAttrs } = attributes;
-    const cleanedAttrs = {
-        expires: "",
-        ...defaultAttributesClient,
-        ...restAttrs
-    };
-    if (isUndefined(document)) {
-        if (process.env["NODE_ENV"] !== "production") {
-            console.warn("[@koine/utils:setCookie] document is undefined");
-        }
-        return undefined;
-    }
-    if (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);
-    let stringifiedAttributes = "";
-    for(const name in attributes){
-        const attrName = name;
-        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;
-}
-export default setCookie;

package/shuffle.mjs

@@ -1,33 +0,0 @@
-/**
- * Creates an array of shuffled values, using a version of the
- * [Fisher-Yates shuffle](https://en.wikipedia.org/wiki/Fisher-Yates_shuffle).
- *
- * @category array
- * @borrows [lodash.shuffle](https://github.com/lodash/lodash/blob/master/shuffle.js)
- * @example
- * ```ts
- * shuffle([1, 2, 3, 4])
- * // => [4, 1, 3, 2]
- * ```
- *
- * @param array The array to shuffle.
- * @returns The new shuffled array.
- */ export function shuffle(array) {
-    const length = array == null ? 0 : array.length;
-    if (!length) {
-        return [];
-    }
-    let index = -1;
-    const lastIndex = length - 1;
-    const result = [
-        ...array
-    ];
-    while(++index < length){
-        const rand = index + Math.floor(Math.random() * (lastIndex - index + 1));
-        const value = result[rand];
-        result[rand] = result[index];
-        result[index] = value;
-    }
-    return result;
-}
-export default shuffle;

package/slugify.mjs

@@ -1,26 +0,0 @@
-import { accentsSets } from "./accentSets";
-import { removeAccents } from "./removeAccents";
-/**
- * Slugify a text
- *
- * - replaces the accented letters
- * - replaces the punctuation with dashes
- *
- * @category text
- *
- * @borrows [mathewbyrne's gist](https://gist.github.com/mathewbyrne/1280286#gistcomment-3498021)
- */ export function slugify(text, separator = "-") {
-    return removeAccents(text.toString().toLowerCase().trim(), accentsSets.concat([
-        [
-            "-",
-            "[·/_,:;']"
-        ]
-    ])).replace(/\s+/g, "-") // replace spaces with -
-    .replace(/&/g, "-and-") // replace & with 'and'
-    .replace(/[^\w-]+/g, "") // remove all non-word chars
-    .replace(/--+/g, "-") // replace multiple - with single -
-    .replace(/^-+/, "") // trim - from start of text
-    .replace(/-+$/, "") // trim - from end of text
-    .replace(/-/g, separator);
-}
-export default slugify;

package/split.mjs

@@ -1,7 +0,0 @@
-/**
- * @category native
- * @category text
- */ export function split(str, delimiter) {
-    return str.split(delimiter);
-}
-export default split;

package/swapMap.mjs

@@ -1,12 +0,0 @@
-/**
- * Swap object map key/value
- *
- * @category object
- */ export function swapMap(map = {}) {
-    const output = {};
-    for(const key in map){
-        output[map[key]] = key;
-    }
-    return output;
-}
-export default swapMap;

package/throttle.mjs

@@ -1,20 +0,0 @@
-/**
- * Throttle function (e.g. for resize / scroll handlers)
- *
- * @category function
- * @borrows [Mobius1/Rangeable](https://github.com/Mobius1/Rangeable/)
- */ export function throttle(fn, limit, context) {
-    let wait;
-    return function(...args) {
-        context = context || this;
-        if (!wait) {
-            fn.apply(context, ...args);
-            wait = true;
-            return setTimeout(function() {
-                wait = false;
-            }, limit);
-        }
-        return;
-    };
-}
-export default throttle;

package/titleCase.mjs

@@ -1,7 +0,0 @@
-/**
- * @category text
- *
- * @borrows [blakeembrey/change-case](https://github.com/blakeembrey/change-case/blob/master/packages/title-case/src/index.ts)
- * @license Blake Embrey (hello@blakeembrey.com)
- */ export const titleCase = (input)=>input ? input.replace(/\w\S*/g, (txt)=>txt.charAt(0).toUpperCase() + txt.substring(1).toLowerCase()) : "";
-export default titleCase;

package/toNumber.mjs

@@ -1,7 +0,0 @@
-import { isNumber } from "./isNumber";
-/**
- * @category cast
- */ export function toNumber(input, fallback) {
-    return isNumber(input) ? input : input ? parseFloat(input) : fallback || 0;
-}
-export default toNumber;

package/toRgba.mjs

@@ -1,14 +0,0 @@
-// import hexRgb from "hex-rgb";
-// export const toRgb = (hexColor: string) => hexRgb(hexColor, { format: "css" });
-// export const toRgba = (hexColor: string, alpha: number) =>
-//   hexRgb(hexColor, { format: "css", alpha });
-/**
- * @category colors
- */ export function toRgba(hex, alpha = 1) {
-    const r = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
-    if (r) {
-        return `rgba(${parseInt(r[1], 16)},${parseInt(r[2], 16)},${parseInt(r[3], 16)},${alpha})`;
-    }
-    return "";
-}
-export default toRgba;

package/transformToUrlPathname.mjs

@@ -1,13 +0,0 @@
-import isString from "./isString";
-/**
- * Transform string in a URL pathname (relative URL)
- *
- * - adds an initial slash
- * - encode the string
- * - replaces whitespaces with dashes
- *
- * @category location
- */ export function transformToUrlPathname(toPathname) {
-    return isString(toPathname) ? `/${encodeURIComponent(toPathname.replace(/\s/g, "-").toLowerCase())}` : "";
-}
-export default transformToUrlPathname;

package/truncate.mjs

@@ -1,6 +0,0 @@
-/**
- * Truncate string
- *
- * @category text
- */ export const truncate = (input, length)=>input ? input.length > length ? input.substring(0, length) + "..." : input : "";
-export default truncate;