@koine/utils 2.0.0-beta.1 → 2.0.0-beta.11

package/package.json

@@ -1,16 +1,12 @@
 {
   "name": "@koine/utils",
   "sideEffects": false,
-  "dependencies": {
-    "clsx": "1.2.1",
-    "ts-debounce": "^4.0.0",
-    "type-fest": "^3.11.1"
-  },
-  "peerDependencies": {
-    "tslib": "2.5.3"
-  },
+  "dependencies": {},
+  "module": "./index.mjs",
   "main": "./index.js",
   "types": "./index.d.ts",
-  "version": "2.0.0-beta.1",
-  "module": "./index.mjs"
-}
+  "peerDependencies": {
+    "type-fest": "^4.1.0"
+  },
+  "version": "2.0.0-beta.11"
+}

package/parseCookie.mjs

@@ -1,11 +1,9 @@
 /**
  * Try decoding a string using a decoding function.
- */
-function tryDecode(str, decode) {
+ */ function tryDecode(str, decode) {
     try {
         return decode(str);
-    }
-    catch (e) {
+    } catch (e) {
         return str;
     }
 }
@@ -16,26 +14,24 @@ function tryDecode(str, decode) {
  * The object has the various cookies as keys(names) => values
  *
  * @category cookie
- */
-export function parseCookie(str, attributes) {
-    if (attributes === void 0) { attributes = {}; }
+ */ export function parseCookie(str, 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("=");
+    const obj = {};
+    const pairs = str.split(";");
+    const { decode = decodeURIComponent } = attributes;
+    for(let i = 0; i < pairs.length; i++){
+        const pair = pairs[i];
+        const index = pair.indexOf("=");
         // skip things that don't look like key=value
         if (index < 0) {
             continue;
         }
-        var key = pair.substring(0, index).trim();
+        const key = pair.substring(0, index).trim();
         // only assign once
         if (undefined == obj[key]) {
-            var val = pair.substring(index + 1, pair.length).trim();
+            let val = pair.substring(index + 1, pair.length).trim();
             // quoted values
             if (val[0] === '"') {
                 val = val.slice(1, -1);

package/parseURL.mjs

@@ -3,10 +3,9 @@
  *
  * @category location
  * @see https://stackoverflow.com/a/21553982/1938970
- */
-export function parseURL(url) {
-    var match = url.match(/^(https?:)\/\/(([^:/?#]*)(?::([0-9]+))?)([/]{0,1}[^?#]*)(\?[^#]*|)(#.*|)$/);
-    return (match && {
+ */ export function parseURL(url) {
+    const match = url.match(/^(https?:)\/\/(([^:/?#]*)(?::([0-9]+))?)([/]{0,1}[^?#]*)(\?[^#]*|)(#.*|)$/);
+    return match && {
         href: url,
         protocol: match[1],
         host: match[2],
@@ -14,7 +13,7 @@ export function parseURL(url) {
         port: match[4],
         pathname: match[5],
         search: match[6],
-        hash: match[7],
-    });
+        hash: match[7]
+    };
 }
 export default parseURL;

package/quaranteneProps.d.ts

@@ -1,6 +1,6 @@
 /**
  * @category impl
- * @usage
+ * @example
  *
  * ```ts
  * const { _: { onKeyDown }, myOwnProp, ...rest } = quaranteneProps([

package/quaranteneProps.mjs

@@ -1,6 +1,6 @@
 /**
  * @category impl
- * @usage
+ * @example
  *
  * ```ts
  * const { _: { onKeyDown }, myOwnProp, ...rest } = quaranteneProps([
@@ -12,18 +12,16 @@
  *   "onKeyDown",
  * ]);
  * ```
- */
-export function quaranteneProps(props, propsKeysToQuarantene) {
+ */ export function quaranteneProps(props, propsKeysToQuarantene) {
     // approach 1)
-    var healthyProps = {
-        _: {},
+    const healthyProps = {
+        _: {}
     };
-    for (var key in props) {
-        var prop = props[key];
+    for(const key in props){
+        const prop = props[key];
         if (propsKeysToQuarantene.includes(key)) {
             healthyProps._[key] = prop;
-        }
-        else {
+        } else {
             // @ts-expect-error nevermind
             healthyProps[key] = prop;
         }

package/randomInt.mjs

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

package/randomKey.mjs

@@ -3,9 +3,8 @@
  *
  * @category misc
  * @see https://stackoverflow.com/a/15106541/1938970
- */
-export function randomKey(obj) {
-    var keys = Object.keys(obj);
-    return keys[(keys.length * Math.random()) << 0];
+ */ export function randomKey(obj) {
+    const keys = Object.keys(obj);
+    return keys[keys.length * Math.random() << 0];
 }
 export default randomKey;

package/readCookie.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Read cookie
+ *
+ * @category cookie
+ */
 export declare function readCookie<T extends Record<string, unknown> = Record<string, string>>(name?: null): T;
 export declare function readCookie<T extends Record<string, unknown> = Record<string, string>, N extends keyof T = keyof T>(name: N): T[N];
 export default readCookie;

package/readCookie.mjs

@@ -11,19 +11,18 @@ export function readCookie(name) {
         }
         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("=");
+    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 {
-            var found = decodeURIComponent(parts[0]);
+            const found = decodeURIComponent(parts[0]);
             all[found] = converterRead(value);
             if (name === found) {
                 break;
             }
-        }
-        catch (e) {
+        } catch (e) {
             if (process.env["NODE_ENV"] !== "production") {
                 console.warn("[@koine/utils:readCookie] failed to decode", value);
             }

package/removeAccents.mjs

@@ -1,14 +1,11 @@
 import { accentsSets } from "./accentSets";
 /**
  * @category text
- */
-export function removeAccents(text, sets) {
-    if (text === void 0) { text = ""; }
-    if (sets === void 0) { sets = accentsSets; }
-    var len = sets.length;
-    while (len--) {
-        var _a = sets[len], to = _a[0], from = _a[1];
-        text = text.replace(new RegExp("[".concat(from, "]"), "gi"), to);
+ */ 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;
 }

package/removeCookie.d.ts

@@ -1,10 +1,6 @@
 import { type CookieAttributesClient } from "./cookie";
 /**
  * @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)
  */
 export declare function removeCookie(name: string, attributes?: CookieAttributesClient): void;
 export default removeCookie;

package/removeCookie.mjs

@@ -1,15 +1,12 @@
-import { __assign } from "tslib";
 import { defaultAttributesClient } from "./cookie";
 import { setCookie } from "./setCookie";
 /**
  * @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)
- */
-export function removeCookie(name, attributes) {
-    if (attributes === void 0) { attributes = {}; }
-    setCookie(name, "", __assign(__assign(__assign({}, defaultAttributesClient), attributes), { expires: -1 }));
+ */ export function removeCookie(name, attributes = {}) {
+    setCookie(name, "", {
+        ...defaultAttributesClient,
+        ...attributes,
+        expires: -1
+    });
 }
 export default removeCookie;

package/removeDuplicates.mjs

@@ -1,4 +1,3 @@
-"use strict";
 // /**
 //  * FIXME: Type 'Set<any>' can only be iterated through when using the
 //  * '--downlevelIteration' flag or with a '--target' of 'es2015' or higher.

package/removeDuplicatesByKey.mjs

@@ -3,13 +3,11 @@
  * comparison of each object's given key
  *
  * @category array
- */
-export function removeDuplicatesByKey(array, key) {
-    if (array === void 0) { array = []; }
-    var keysMap = {};
-    var output = [];
-    for (var i = 0; i < array.length; i++) {
-        var item = array[i];
+ */ 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;

package/removeDuplicatesComparing.mjs

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

package/removeIndexesFromArray.mjs

@@ -1,9 +1,8 @@
 /**
  * @category array
- */
-export function removeIndexesFromArray(arr, indexes) {
-    var output = [];
-    for (var i = 0; i < arr.length; i++) {
+ */ 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]);

package/removeTrailingSlash.mjs

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

package/removeUrlQueryParams.d.ts

@@ -2,7 +2,6 @@
  * Remove the given keys from the given URL query parameters
  *
  * @category location
- * @pure
  */
 export declare function removeUrlQueryParams(url: string, paramsToRemove?: string[]): string;
 export default removeUrlQueryParams;

package/removeUrlQueryParams.mjs

@@ -4,14 +4,11 @@ import getUrlQueryParams from "./getUrlQueryParams";
  * Remove the given keys from the given URL query parameters
  *
  * @category location
- * @pure
- */
-export function removeUrlQueryParams(url, paramsToRemove) {
-    if (paramsToRemove === void 0) { paramsToRemove = []; }
-    var parts = url.split("?");
-    var allParams = getUrlQueryParams(url);
-    var params = {};
-    for (var key in allParams) {
+ */ 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];
         }

package/render.d.ts

@@ -33,9 +33,10 @@ type RenderFunction = (data: object) => string;
  * <%! %>	for interpolation with encoding
  * ```
  *
+ * @category impl
  * @example
  *
- * ```js
+ * ```ts
  * import { render } from "...";
  *
  * const data = { name: "XYZ" };

package/render.mjs

@@ -1,57 +1,51 @@
-var varname = "data";
-var evaluate = /<%([\s\S]+?(\}?)+)%>/g;
-var interpolate = /<%=([\s\S]+?)%>/g;
-var conditional = /<%\?(\?)?\s*([\s\S]*?)\s*%>/g;
-var iterate = /<%~\s*(?:%>|([\s\S]+?)\s*:\s*([\w$]+)\s*(?::\s*([\w$]+))?\s*%>)/g;
+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;
-var use = /<%#([\s\S]+?)%>/g;
-var useParams = /(^|[^\w$])def(?:\.|\[['"])([\w$.]+)(?:['"]\])?\s*:\s*([\w$.]+|"[^"]+"|'[^']+'|\{[^}]+\})/g;
-var define = /<%##\s*([\w.$]+)\s*(:|=)([\s\S]+?)#%>/g;
-var defineParams = /^\s*([\w$]+):([\s\S]+)/;
-var start = "'+(";
-var end = ")+'";
+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(";
-var skip = /$^/;
-var resolveDefs = function (block, def) {
-    return (typeof block === "string" ? block : block.toString())
-        .replace(define || skip, function (_, code, assign, value) {
+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
-                function (_, param, v) {
-                    def[code] = { arg: param, text: v };
+                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 {
+                if (!(code in def)) def[code] = value;
+            } else {
                 new Function("def", "def['" + code + "']=" + value)(def);
             }
         }
         return "";
-    })
-        .replace(use || skip, function (_, code) {
-        code = code.replace(useParams, function (_, s, d, param) {
+    }).replace(use || skip, (_, code)=>{
+        code = code.replace(useParams, (_, s, d, param)=>{
             if (def[d] && def[d].arg && param) {
-                var rw = (d + ":" + param).replace(/'|\\/g, "_");
+                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;
         });
-        var v = new Function("def", "return " + code)(def);
+        const v = new Function("def", "return " + code)(def);
         return v ? resolveDefs(v, def) : v;
     });
-};
-var unescape = function (code) {
-    return code.replace(/\\('|\\)/g, "$1").replace(/[\r\t\n]/g, " ");
-};
+const unescape = (code)=>code.replace(/\\('|\\)/g, "$1").replace(/[\r\t\n]/g, " ");
 /**
  * Render template (adapted from doT.js)
  *
@@ -73,9 +67,10 @@ var unescape = function (code) {
  * <%! %>	for interpolation with encoding
  * ```
  *
+ * @category impl
  * @example
  *
- * ```js
+ * ```ts
  * import { render } from "...";
  *
  * const data = { name: "XYZ" };
@@ -87,79 +82,30 @@ var unescape = function (code) {
  *
  * @borrows [olado/doT by Laura Doktorova](https://github.com/olado/doT)
  * @see https://olado.github.io/doT/index.html
- */
-export var render = function (tmpl, def) {
-    var sid = 0;
-    var indv;
-    var 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, function (_, code) { return start + unescape(code) + end; })
-            // .replace(
-            //   encode || skip,
-            //   (_, code) => cse.startencode + unescape(code) + cse.end
-            // )
-            .replace(conditional || skip, function (_, elseCase, code) {
-            return elseCase
-                ? code
-                    ? "';}else if(" + unescape(code) + "){X+='"
-                    : "';}else{X+='"
-                : code
-                    ? "';if(" + unescape(code) + "){X+='"
-                    : "';}X+='";
-        })
-            .replace(iterate || skip, function (_, 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, function (_, code) { return "';" + unescape(code) + "X+='"; }) +
-        "';return X;")
-        .replace(/\n/g, "\\n")
-        .replace(/\t/g, "\\t")
-        .replace(/\r/g, "\\r")
-        .replace(/(\s|;|\}|^|\{)X\+='';/g, "$1")
-        .replace(/\+''/g, "");
+ */ 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) {
+    } catch (e) {
         if (process.env["NODE_ENV"] !== "production") {
             console.log("Could not create a template function: " + str);
             throw e;
         }
     }
-    return function () { return ""; };
+    return ()=>"";
 };
 export default render;

package/roundTo.mjs

@@ -3,28 +3,26 @@
  *
  * @category math
  * @see https://stackoverflow.com/a/15762794/1938970
- */
-export function roundTo(num, decimals) {
-    if (decimals === void 0) { decimals = 2; }
+ */ 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
-        var multiplicator = Math.pow(10, decimals);
+        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;
+    // 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");

package/serializeCookie.d.ts

@@ -1,5 +1,5 @@
 /**
- * @file
+ * @module
  *
  * @category cookie
  *
@@ -18,10 +18,6 @@ import { type CookieAttributesServer } from "./cookie";
  *   => "foo=bar; httpOnly"
  *
  * @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)
  */
 export declare function serializeCookie(name: string, val: string, attributes?: CookieAttributesServer): string;
 export default serializeCookie;