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

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/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;

package/tryUntil.mjs

@@ -1,27 +0,0 @@
-/**
- * @category function
- * @category async
- *
- * @borrows [Javascript: Wait Until Something Happens or Timeout](https://levelup.gitconnected.com/javascript-wait-until-something-happens-or-timeout-82636839ea93)
- *
- * @param timeout in `ms`
- * @param interval in `ms`
- */ export const tryUntil = (test, timeout, interval, resolve, reject)=>{
-    // return new Promise((resolve, reject) => {
-    const timeWas = new Date();
-    const wait = setInterval(function() {
-        if (test()) {
-            // console.log("resolved after", new Date() - timeWas, "ms");
-            clearInterval(wait);
-            resolve();
-        // @ts-expect-error ...
-        } else if (new Date() - timeWas > timeout) {
-            // Timeout
-            // console.log("rejected after", new Date() - timeWas, "ms");
-            clearInterval(wait);
-            if (reject) reject();
-        }
-    }, interval);
-// });
-};
-export default tryUntil;

package/types.mjs

@@ -1,2 +0,0 @@
-// import type { Replace } from "@koine/utils";
-export { };

package/uid.mjs

@@ -1,10 +0,0 @@
-let lastId = 0;
-/**
- * Super basic UID increment-based generator
- *
- * @category uid
- */ export const uid = (prefix = "id")=>{
-    lastId++;
-    return `${prefix}-${lastId}`;
-};
-export default uid;

package/updateLinkParams.mjs

@@ -1,13 +0,0 @@
-import updateUrlQueryParams from "./updateUrlQueryParams";
-/**
- * Update link `<a href="">` merging the given new query parameters.
- * it returns the newly created `href` URL value
- *
- * @category location
- * @pure
- */ export function updateLinkParams($anchor, newParams) {
-    const href = updateUrlQueryParams($anchor.href, newParams);
-    $anchor.href = href;
-    return href;
-}
-export default updateLinkParams;

package/updateUrlQueryParams.mjs

@@ -1,13 +0,0 @@
-import buildUrlQueryString from "./buildUrlQueryString";
-import getUrlQueryParams from "./getUrlQueryParams";
-import mergeUrlQueryParams from "./mergeUrlQueryParams";
-/**
- * Update a URL string query parameters merging the given new query parameters
- *
- * @category location
- */ export function updateUrlQueryParams(url, newParams = {}) {
-    const parts = url.split("?");
-    const allParams = parts[1] ? mergeUrlQueryParams(getUrlQueryParams(url), newParams) : newParams;
-    return parts[0] + buildUrlQueryString(allParams);
-}
-export default updateUrlQueryParams;

package/uppercase.mjs

@@ -1,7 +0,0 @@
-/**
- * Replacement for native `toUpperCase` tyescript ready (type narrowing ready)
- *
- * @category native
- * @category text
- */ export const uppercase = (str)=>(str || "").toUpperCase();
-export default uppercase;

package/uuid.mjs

@@ -1,10 +0,0 @@
-/**
- * Uuid, tiny custom helper instead of node's uuid/v4
- *
- * @category uid
- * @see https://stackoverflow.com/a/2117523/1938970
- */ export const uuid = ()=>"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c)=>{
-        const r = Math.random() * 16 | 0, v = c == "x" ? r : r & 0x3 | 0x8;
-        return v.toString(16);
-    });
-export default uuid;

package/uuidNumeric.mjs

@@ -1,5 +0,0 @@
-/**
- * @category uid
- * @see https://stackoverflow.com/a/18048162/1938970
- */ export const uuidNumeric = ()=>new Date().valueOf();
-export default uuidNumeric;

package/wait.mjs

@@ -1,6 +0,0 @@
-/**
- * A promisified `setTimeout`
- *
- * @category async
- */ export const wait = (milliseconds)=>new Promise((resolve)=>setTimeout(resolve, milliseconds));
-export default wait;

package/without.mjs

@@ -1,54 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unused-vars */ // TODO: finish this up, this is not exported yet
-// ready to copy-paste to https://www.typescriptlang.org/play
-// type EmptyObject = Record<string, never>;
-// type EmptyArray = never[];
-// type EmptyString = "";
-// type WithoutEmptyObject<T> = T extends EmptyObject ? never : T;
-// type WithoutEmptyArray<T> = T extends EmptyArray ? never : T;
-// type WithoutEmptyString<T> = T extends EmptyString ? never : T;
-// type WithoutEmpty<T> = T extends EmptyObject | EmptyArray | EmptyString | null | undefined ? never : T;
-// function withoutEmptyObject<T>(arg: WithoutEmptyObject<T>) {
-//   return arg;
-// }
-// function withoutEmptyArray<T>(arg: WithoutEmptyArray<T>) {
-//   return arg;
-// }
-// function withoutEmptyString<T>(arg: WithoutEmptyString<T>) {
-//   return arg;
-// }
-// function withoutEmpty<T>(arg: WithoutEmpty<T>) {
-//   return arg;
-// }
-// // @ts-expect-error
-// const o1 = withoutEmptyObject({});
-// //   ^?
-// const o2 = withoutEmptyObject({ accepted: 1 });
-// // @ts-expect-error
-// const a1 = withoutEmptyArray([]);
-// //   ^?
-// const a2 = withoutEmptyArray(["accepted"]);
-// //   ^?
-// const a3 = withoutEmptyArray("accepted");
-// //   ^?
-// const a4 = withoutEmptyArray("accepted" === "accepted");
-// //   ^?
-// // @ts-expect-error
-// const s1 = withoutEmptyString("");
-// //   ^?
-// const s2 = withoutEmptyString("accepted");
-// //   ^?
-// // @ts-expect-error
-// const w1 = withoutEmpty("");
-// //   ^?
-// // @ts-expect-error
-// const w2 = withoutEmpty(undefined);
-// //   ^?
-// // @ts-expect-error
-// const w3 = withoutEmpty(null);
-// //   ^?
-// // @ts-expect-error
-// const w4 = withoutEmpty({});
-// //   ^?
-// // @ts-expect-error
-// const w5 = withoutEmpty([]);
-// //   ^?