@koine/utils 2.0.0-beta.82 → 2.0.0-beta.83

package/removeDuplicatesComparing.esm.js

@@ -1,6 +1,8 @@
 import { findDuplicatedIndexes } from './findDuplicatedIndexes.esm.js';
 import { removeIndexesFromArray } from './removeIndexesFromArray.esm.js';
 
-let removeDuplicatesComparing=(o,m)=>removeIndexesFromArray(m,findDuplicatedIndexes(o));
+/**
+ * @category array
+ */let removeDuplicatesComparing=(o,m)=>removeIndexesFromArray(m,findDuplicatedIndexes(o));
 
 export { removeDuplicatesComparing as default, removeDuplicatesComparing };

package/removeIndexesFromArray.cjs.js

@@ -2,7 +2,10 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let removeIndexesFromArray=(e,r)=>{let t=[];for(let o=0;o<e.length;o++)r.hasOwnProperty(o)||t.push(e[o]);return t};
+/**
+ * @category array
+ */let removeIndexesFromArray=(e,r)=>{let t=[];for(let o=0;o<e.length;o++)// eslint-disable-next-line no-prototype-builtins
+r.hasOwnProperty(o)||t.push(e[o]);return t};
 
 exports["default"] = removeIndexesFromArray;
 exports.removeIndexesFromArray = removeIndexesFromArray;

package/removeIndexesFromArray.esm.js

@@ -1,3 +1,6 @@
-let removeIndexesFromArray=(e,r)=>{let t=[];for(let o=0;o<e.length;o++)r.hasOwnProperty(o)||t.push(e[o]);return t};
+/**
+ * @category array
+ */let removeIndexesFromArray=(e,r)=>{let t=[];for(let o=0;o<e.length;o++)// eslint-disable-next-line no-prototype-builtins
+r.hasOwnProperty(o)||t.push(e[o]);return t};
 
 export { removeIndexesFromArray as default, removeIndexesFromArray };

package/removeTrailingSlash.cjs.js

@@ -2,7 +2,11 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let removeTrailingSlash=e=>(e||"").replace(/\/*$/,"");
+/**
+ * Strips out the trailing slash
+ *
+ * @category location
+ */let removeTrailingSlash=e=>(e||"").replace(/\/*$/,"");
 
 exports["default"] = removeTrailingSlash;
 exports.removeTrailingSlash = removeTrailingSlash;

package/removeTrailingSlash.esm.js

@@ -1,3 +1,7 @@
-let removeTrailingSlash=e=>(e||"").replace(/\/*$/,"");
+/**
+ * Strips out the trailing slash
+ *
+ * @category location
+ */let removeTrailingSlash=e=>(e||"").replace(/\/*$/,"");
 
 export { removeTrailingSlash as default, removeTrailingSlash };

package/removeUrlQueryParams.cjs.js

@@ -10,7 +10,11 @@ require('./isNull.cjs.js');
 require('./isUndefined.cjs.js');
 require('./isBrowser.cjs.js');
 
-let removeUrlQueryParams=(t,l=[])=>{let m=t.split("?"),o=getUrlQueryParams.getUrlQueryParams(t),u={};for(let r in o)l.includes(r)||(u[r]=o[r]);return m[0]+buildUrlQueryString.buildUrlQueryString(u)};
+/**
+ * Remove the given keys from the given URL query parameters
+ *
+ * @category location
+ */let removeUrlQueryParams=(t,l=[])=>{let m=t.split("?"),o=getUrlQueryParams.getUrlQueryParams(t),u={};for(let r in o)l.includes(r)||(u[r]=o[r]);return m[0]+buildUrlQueryString.buildUrlQueryString(u)};
 
 exports["default"] = removeUrlQueryParams;
 exports.removeUrlQueryParams = removeUrlQueryParams;

package/removeUrlQueryParams.esm.js

@@ -6,6 +6,10 @@ import './isNull.esm.js';
 import './isUndefined.esm.js';
 import './isBrowser.esm.js';
 
-let removeUrlQueryParams=(t,l=[])=>{let m=t.split("?"),o=getUrlQueryParams(t),u={};for(let r in o)l.includes(r)||(u[r]=o[r]);return m[0]+buildUrlQueryString(u)};
+/**
+ * Remove the given keys from the given URL query parameters
+ *
+ * @category location
+ */let removeUrlQueryParams=(t,l=[])=>{let m=t.split("?"),o=getUrlQueryParams(t),u={};for(let r in o)l.includes(r)||(u[r]=o[r]);return m[0]+buildUrlQueryString(u)};
 
 export { removeUrlQueryParams as default, removeUrlQueryParams };

package/render.cjs.js

@@ -2,7 +2,58 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let e=/<%([\s\S]+?(\}?)+)%>/g,r=/<%=([\s\S]+?)%>/g,t=/<%\?(\?)?\s*([\s\S]*?)\s*%>/g,a=/<%~\s*(?:%>|([\s\S]+?)\s*:\s*([\w$]+)\s*(?::\s*([\w$]+))?\s*%>)/g,l=/<%#([\s\S]+?)%>/g,n=/(^|[^\w$])def(?:\.|\[['"])([\w$.]+)(?:['"]\])?\s*:\s*([\w$.]+|"[^"]+"|'[^']+'|\{[^}]+\})/g,p=/<%##\s*([\w.$]+)\s*(:|=)([\s\S]+?)#%>/g,s=/^\s*([\w$]+):([\s\S]+)/,c=/$^/,g=(e,r)=>("string"==typeof e?e:e.toString()).replace(p||c,(e,t,a,l)=>(0===t.indexOf("def.")&&(t=t.substring(4)),t in r||(":"===a?(l.replace(s,(e,a,l)=>{r[t]={arg:a,text:l};}),t in r||(r[t]=l)):Function("def","def['"+t+"']="+l)(r)),"")).replace(l||c,(e,t)=>{let a=Function("def","return "+(t=t.replace(n,(e,t,a,l)=>{if(r[a]&&r[a].arg&&l){let e=(a+":"+l).replace(/'|\\/g,"_");return r.__exp=r.__exp||{},r.__exp[e]=r[a].text.replace(RegExp("(^|[^\\w$])"+r[a].arg+"([^\\w$])","g"),"$1"+l+"$2"),t+"def.__exp['"+e+"']"}return t})))(r);return a?g(a,r):a}),i=e=>e.replace(/\\('|\\)/g,"$1").replace(/[\r\t\n]/g," ");let render=(n,s)=>{let o,$=0,f=l||p?g(n,s||{}):n;f=("var X='"+f.replace(/(^|\r|\n)\t* +| +\t*(\r|\n|$)/g," ").replace(/\r|\n|\t|\/\*[\s\S]*?\*\//g,"").replace(/'|\\/g,"\\$&").replace(r||c,(e,r)=>"'+("+i(r)+")+'").replace(t||c,(e,r,t)=>r?t?"';}else if("+i(t)+"){X+='":"';}else{X+='":t?"';if("+i(t)+"){X+='":"';}X+='").replace(a||c,(e,r,t,a)=>r?($++,o=a||"i"+$,r=i(r),"';var arr"+$+"="+r+";if(arr"+$+"){var "+t+","+o+"=-1,l"+$+"=arr"+$+".length-1;while("+o+"<l"+$+"){"+t+"=arr"+$+"["+o+"+=1];X+='"):"';} } X+='").replace(e||c,(e,r)=>"';"+i(r)+"X+='")+"';return X;").replace(/\n/g,"\\n").replace(/\t/g,"\\t").replace(/\r/g,"\\r").replace(/(\s|;|\}|^|\{)X\+='';/g,"$1").replace(/\+''/g,"");try{return Function("data",f)}catch(e){if("development"===process.env.NODE_ENV)throw console.log("Could not create a template function: "+f),e}return ()=>""};
+let e=/<%([\s\S]+?(\}?)+)%>/g,r=/<%=([\s\S]+?)%>/g,t=/<%\?(\?)?\s*([\s\S]*?)\s*%>/g,a=/<%~\s*(?:%>|([\s\S]+?)\s*:\s*([\w$]+)\s*(?::\s*([\w$]+))?\s*%>)/g,// let encode = /<%!([\s\S]+?)%>/g;
+l=/<%#([\s\S]+?)%>/g,n=/(^|[^\w$])def(?:\.|\[['"])([\w$.]+)(?:['"]\])?\s*:\s*([\w$.]+|"[^"]+"|'[^']+'|\{[^}]+\})/g,p=/<%##\s*([\w.$]+)\s*(:|=)([\s\S]+?)#%>/g,s=/^\s*([\w$]+):([\s\S]+)/,// let startencode = "'+encodeHTML(";
+c=/$^/,g=(e,r)=>("string"==typeof e?e:e.toString()).replace(p||c,(e,t,a,l)=>(0===t.indexOf("def.")&&(t=t.substring(4)),t in r||(":"===a?(l.replace(s,// @ts-expect-error nevermind
+        (e,a,l)=>{r[t]={arg:a,text:l};}),// @ts-expect-error nevermind
+        t in r||(r[t]=l)):Function("def","def['"+t+"']="+l)(r)),"")).replace(l||c,(e,t)=>{let a=Function("def","return "+(t=t.replace(n,(e,t,a,l)=>{if(r[a]&&r[a].arg&&l){let e=(a+":"+l).replace(/'|\\/g,"_");return r.__exp=r.__exp||{},r.__exp[e]=r[a].text.replace(RegExp("(^|[^\\w$])"+r[a].arg+"([^\\w$])","g"),"$1"+l+"$2"),t+"def.__exp['"+e+"']"}return t})))(r);return a?g(a,r):a}),i=e=>e.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
+ */let render=(n,s)=>{let o,$=0,f=l||p?g(n,s||{}):n;f=("var X='"+f.replace(/(^|\r|\n)\t* +| +\t*(\r|\n|$)/g," ").replace(/\r|\n|\t|\/\*[\s\S]*?\*\//g,"").replace(/'|\\/g,"\\$&").replace(r||c,(e,r)=>"'+("+i(r)+")+'").// .replace(
+//   encode || skip,
+//   (_, code) => cse.startencode + unescape(code) + cse.end
+// )
+replace(t||c,(e,r,t)=>r?t?"';}else if("+i(t)+"){X+='":"';}else{X+='":t?"';if("+i(t)+"){X+='":"';}X+='").replace(a||c,(e,r,t,a)=>r?($++,o=a||"i"+$,r=i(r),"';var arr"+$+"="+r+";if(arr"+$+"){var "+t+","+o+"=-1,l"+$+"=arr"+$+".length-1;while("+o+"<l"+$+"){"+t+"=arr"+$+"["+o+"+=1];X+='"):"';} } X+='").replace(e||c,(e,r)=>"';"+i(r)+"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 Function(// RenderData;
+/**
+ * Returned render function
+ *//**
+ * Default render function creator
+ */// eslint-disable-next-line @typescript-eslint/no-unused-vars
+"data",f)}catch(e){if("development"===process.env.NODE_ENV)throw console.log("Could not create a template function: "+f),e}return ()=>""};
 
 exports["default"] = render;
 exports.render = render;

package/render.esm.js

@@ -1,3 +1,54 @@
-let e=/<%([\s\S]+?(\}?)+)%>/g,r=/<%=([\s\S]+?)%>/g,t=/<%\?(\?)?\s*([\s\S]*?)\s*%>/g,a=/<%~\s*(?:%>|([\s\S]+?)\s*:\s*([\w$]+)\s*(?::\s*([\w$]+))?\s*%>)/g,l=/<%#([\s\S]+?)%>/g,n=/(^|[^\w$])def(?:\.|\[['"])([\w$.]+)(?:['"]\])?\s*:\s*([\w$.]+|"[^"]+"|'[^']+'|\{[^}]+\})/g,p=/<%##\s*([\w.$]+)\s*(:|=)([\s\S]+?)#%>/g,s=/^\s*([\w$]+):([\s\S]+)/,c=/$^/,g=(e,r)=>("string"==typeof e?e:e.toString()).replace(p||c,(e,t,a,l)=>(0===t.indexOf("def.")&&(t=t.substring(4)),t in r||(":"===a?(l.replace(s,(e,a,l)=>{r[t]={arg:a,text:l};}),t in r||(r[t]=l)):Function("def","def['"+t+"']="+l)(r)),"")).replace(l||c,(e,t)=>{let a=Function("def","return "+(t=t.replace(n,(e,t,a,l)=>{if(r[a]&&r[a].arg&&l){let e=(a+":"+l).replace(/'|\\/g,"_");return r.__exp=r.__exp||{},r.__exp[e]=r[a].text.replace(RegExp("(^|[^\\w$])"+r[a].arg+"([^\\w$])","g"),"$1"+l+"$2"),t+"def.__exp['"+e+"']"}return t})))(r);return a?g(a,r):a}),i=e=>e.replace(/\\('|\\)/g,"$1").replace(/[\r\t\n]/g," ");let render=(n,s)=>{let o,$=0,f=l||p?g(n,s||{}):n;f=("var X='"+f.replace(/(^|\r|\n)\t* +| +\t*(\r|\n|$)/g," ").replace(/\r|\n|\t|\/\*[\s\S]*?\*\//g,"").replace(/'|\\/g,"\\$&").replace(r||c,(e,r)=>"'+("+i(r)+")+'").replace(t||c,(e,r,t)=>r?t?"';}else if("+i(t)+"){X+='":"';}else{X+='":t?"';if("+i(t)+"){X+='":"';}X+='").replace(a||c,(e,r,t,a)=>r?($++,o=a||"i"+$,r=i(r),"';var arr"+$+"="+r+";if(arr"+$+"){var "+t+","+o+"=-1,l"+$+"=arr"+$+".length-1;while("+o+"<l"+$+"){"+t+"=arr"+$+"["+o+"+=1];X+='"):"';} } X+='").replace(e||c,(e,r)=>"';"+i(r)+"X+='")+"';return X;").replace(/\n/g,"\\n").replace(/\t/g,"\\t").replace(/\r/g,"\\r").replace(/(\s|;|\}|^|\{)X\+='';/g,"$1").replace(/\+''/g,"");try{return Function("data",f)}catch(e){if("development"===process.env.NODE_ENV)throw console.log("Could not create a template function: "+f),e}return ()=>""};
+let e=/<%([\s\S]+?(\}?)+)%>/g,r=/<%=([\s\S]+?)%>/g,t=/<%\?(\?)?\s*([\s\S]*?)\s*%>/g,a=/<%~\s*(?:%>|([\s\S]+?)\s*:\s*([\w$]+)\s*(?::\s*([\w$]+))?\s*%>)/g,// let encode = /<%!([\s\S]+?)%>/g;
+l=/<%#([\s\S]+?)%>/g,n=/(^|[^\w$])def(?:\.|\[['"])([\w$.]+)(?:['"]\])?\s*:\s*([\w$.]+|"[^"]+"|'[^']+'|\{[^}]+\})/g,p=/<%##\s*([\w.$]+)\s*(:|=)([\s\S]+?)#%>/g,s=/^\s*([\w$]+):([\s\S]+)/,// let startencode = "'+encodeHTML(";
+c=/$^/,g=(e,r)=>("string"==typeof e?e:e.toString()).replace(p||c,(e,t,a,l)=>(0===t.indexOf("def.")&&(t=t.substring(4)),t in r||(":"===a?(l.replace(s,// @ts-expect-error nevermind
+        (e,a,l)=>{r[t]={arg:a,text:l};}),// @ts-expect-error nevermind
+        t in r||(r[t]=l)):Function("def","def['"+t+"']="+l)(r)),"")).replace(l||c,(e,t)=>{let a=Function("def","return "+(t=t.replace(n,(e,t,a,l)=>{if(r[a]&&r[a].arg&&l){let e=(a+":"+l).replace(/'|\\/g,"_");return r.__exp=r.__exp||{},r.__exp[e]=r[a].text.replace(RegExp("(^|[^\\w$])"+r[a].arg+"([^\\w$])","g"),"$1"+l+"$2"),t+"def.__exp['"+e+"']"}return t})))(r);return a?g(a,r):a}),i=e=>e.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
+ */let render=(n,s)=>{let o,$=0,f=l||p?g(n,s||{}):n;f=("var X='"+f.replace(/(^|\r|\n)\t* +| +\t*(\r|\n|$)/g," ").replace(/\r|\n|\t|\/\*[\s\S]*?\*\//g,"").replace(/'|\\/g,"\\$&").replace(r||c,(e,r)=>"'+("+i(r)+")+'").// .replace(
+//   encode || skip,
+//   (_, code) => cse.startencode + unescape(code) + cse.end
+// )
+replace(t||c,(e,r,t)=>r?t?"';}else if("+i(t)+"){X+='":"';}else{X+='":t?"';if("+i(t)+"){X+='":"';}X+='").replace(a||c,(e,r,t,a)=>r?($++,o=a||"i"+$,r=i(r),"';var arr"+$+"="+r+";if(arr"+$+"){var "+t+","+o+"=-1,l"+$+"=arr"+$+".length-1;while("+o+"<l"+$+"){"+t+"=arr"+$+"["+o+"+=1];X+='"):"';} } X+='").replace(e||c,(e,r)=>"';"+i(r)+"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 Function(// RenderData;
+/**
+ * Returned render function
+ *//**
+ * Default render function creator
+ */// eslint-disable-next-line @typescript-eslint/no-unused-vars
+"data",f)}catch(e){if("development"===process.env.NODE_ENV)throw console.log("Could not create a template function: "+f),e}return ()=>""};
 
 export { render as default, render };

package/round.cjs.js

@@ -2,7 +2,17 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let round=(e,r,t)=>r?parseFloat(e.toFixed(r).replace(t?"":/\.+0*$/,"")):parseInt(e+"",10);
+/**
+ * Round a number to the given amount of decimals
+ *
+ * If `keepZeroes` is `false` we normalises `x.00` to `x` and `x.10` to `x.1`
+ *
+ * @category number
+ *
+ * @param number
+ * @param decimals default `undefined`
+ * @param trailingZeroes default `undefined` Whether to keep trailing zeroes
+ */let round=(e,r,t)=>r?parseFloat(e.toFixed(r).replace(t?"":/\.+0*$/,"")):parseInt(e+"",10);
 
 exports["default"] = round;
 exports.round = round;

package/round.esm.js

@@ -1,3 +1,13 @@
-let round=(e,r,t)=>r?parseFloat(e.toFixed(r).replace(t?"":/\.+0*$/,"")):parseInt(e+"",10);
+/**
+ * Round a number to the given amount of decimals
+ *
+ * If `keepZeroes` is `false` we normalises `x.00` to `x` and `x.10` to `x.1`
+ *
+ * @category number
+ *
+ * @param number
+ * @param decimals default `undefined`
+ * @param trailingZeroes default `undefined` Whether to keep trailing zeroes
+ */let round=(e,r,t)=>r?parseFloat(e.toFixed(r).replace(t?"":/\.+0*$/,"")):parseInt(e+"",10);
 
 export { round as default, round };

package/roundTo.cjs.js

@@ -2,7 +2,28 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let roundTo=(e,n=2)=>{if(isFinite(e)&&!isNaN(e)){let o=Math.pow(10,n);return Math.round(e*o)/o+""}return "development"===process.env.NODE_ENV&&console.warn("[@koine/utils] math:roundTo -> given not a finite number as first arg"),""};
+/**
+ * Round to given number of the given number of decimals
+ *
+ * @category math
+ * @see https://stackoverflow.com/a/15762794/1938970
+ */let roundTo=(e,n=2)=>{if(isFinite(e)&&!isNaN(e)){// method 1
+// return Number(num).toFixed(decimals);
+// method 2: @see https://stackoverflow.com/a/43532829/1938970
+let o=Math.pow(10,n);return Math.round(e*o)/o+""}return("development"===// 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;
+process.env.NODE_ENV&&console.warn("[@koine/utils] math:roundTo -> given not a finite number as first arg"),"")};
 
 exports["default"] = roundTo;
 exports.roundTo = roundTo;

package/roundTo.esm.js

@@ -1,3 +1,24 @@
-let roundTo=(e,n=2)=>{if(isFinite(e)&&!isNaN(e)){let o=Math.pow(10,n);return Math.round(e*o)/o+""}return "development"===process.env.NODE_ENV&&console.warn("[@koine/utils] math:roundTo -> given not a finite number as first arg"),""};
+/**
+ * Round to given number of the given number of decimals
+ *
+ * @category math
+ * @see https://stackoverflow.com/a/15762794/1938970
+ */let roundTo=(e,n=2)=>{if(isFinite(e)&&!isNaN(e)){// method 1
+// return Number(num).toFixed(decimals);
+// method 2: @see https://stackoverflow.com/a/43532829/1938970
+let o=Math.pow(10,n);return Math.round(e*o)/o+""}return("development"===// 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;
+process.env.NODE_ENV&&console.warn("[@koine/utils] math:roundTo -> given not a finite number as first arg"),"")};
 
 export { roundTo as default, roundTo };

package/serializeCookie.cjs.js

@@ -5,7 +5,19 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var isNumber = require('./isNumber.cjs.js');
 require('./getType.cjs.js');
 
-let i=/^[\u0009\u0020-\u007e\u0080-\u00ff]+$/;let serializeCookie=(t,o,r={})=>{let{encode:n=encodeURIComponent,domain:a,path:s,httpOnly:p,secure:l,sameSite:f}=r,{maxAge:m,expires:c}=r,d=n(o);if("development"===process.env.NODE_ENV){if(!i.test(t))throw TypeError("argument name is invalid");if("function"!=typeof r.encode)throw TypeError("option encode is invalid");if(d&&!i.test(d))throw TypeError("argument val is invalid")}let u=t+"="+d;if(null!=m){if(isNaN(m-=0)||!isFinite(m))throw TypeError("option maxAge is invalid");u+="; Max-Age="+Math.floor(m);}if(a){if("development"===process.env.NODE_ENV&&!i.test(a))throw TypeError("option domain is invalid");u+="; Domain="+a;}if(s){if("development"===process.env.NODE_ENV&&!i.test(s))throw TypeError("option path is invalid");u+="; Path="+s;}if(c&&(isNumber.isNumber(c)&&(c=new Date(Date.now()+864e5*c)),u+="; Expires="+c.toUTCString()),p&&(u+="; HttpOnly"),l&&(u+="; Secure"),f)switch(f.toLowerCase()){case"lax":u+="; SameSite=Lax";break;case"strict":u+="; SameSite=Strict";break;case"none":u+="; SameSite=None";}return u};
+let i=/^[\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
+ */let serializeCookie=(t,o,r={})=>{let{encode:n=encodeURIComponent,domain:a,path:s,httpOnly:p,secure:l,sameSite:f}=r,{maxAge:m,expires:c}=r,d=n(o);if("development"===process.env.NODE_ENV){if(!i.test(t))throw TypeError("argument name is invalid");if("function"!=typeof r.encode)throw TypeError("option encode is invalid");if(d&&!i.test(d))throw TypeError("argument val is invalid")}let u=t+"="+d;if(null!=m){if(isNaN(m-=0)||!isFinite(m))throw TypeError("option maxAge is invalid");u+="; Max-Age="+Math.floor(m);}if(a){if("development"===process.env.NODE_ENV&&!i.test(a))throw TypeError("option domain is invalid");u+="; Domain="+a;}if(s){if("development"===process.env.NODE_ENV&&!i.test(s))throw TypeError("option path is invalid");u+="; Path="+s;}if(c&&(isNumber.isNumber(c)&&(c=new Date(Date.now()+864e5*c)),u+="; Expires="+c.toUTCString()),p&&(u+="; HttpOnly"),l&&(u+="; Secure"),f)switch(f.toLowerCase()){case"lax":u+="; SameSite=Lax";break;case"strict":u+="; SameSite=Strict";break;case"none":u+="; SameSite=None";}//  default:
+//    throw new TypeError('option sameSite is invalid');
+return u};
 
 exports["default"] = serializeCookie;
 exports.serializeCookie = serializeCookie;

package/serializeCookie.esm.js

@@ -1,6 +1,18 @@
 import { isNumber } from './isNumber.esm.js';
 import './getType.esm.js';
 
-let i=/^[\u0009\u0020-\u007e\u0080-\u00ff]+$/;let serializeCookie=(t,o,r={})=>{let{encode:n=encodeURIComponent,domain:a,path:s,httpOnly:p,secure:l,sameSite:f}=r,{maxAge:m,expires:c}=r,d=n(o);if("development"===process.env.NODE_ENV){if(!i.test(t))throw TypeError("argument name is invalid");if("function"!=typeof r.encode)throw TypeError("option encode is invalid");if(d&&!i.test(d))throw TypeError("argument val is invalid")}let u=t+"="+d;if(null!=m){if(isNaN(m-=0)||!isFinite(m))throw TypeError("option maxAge is invalid");u+="; Max-Age="+Math.floor(m);}if(a){if("development"===process.env.NODE_ENV&&!i.test(a))throw TypeError("option domain is invalid");u+="; Domain="+a;}if(s){if("development"===process.env.NODE_ENV&&!i.test(s))throw TypeError("option path is invalid");u+="; Path="+s;}if(c&&(isNumber(c)&&(c=new Date(Date.now()+864e5*c)),u+="; Expires="+c.toUTCString()),p&&(u+="; HttpOnly"),l&&(u+="; Secure"),f)switch(f.toLowerCase()){case"lax":u+="; SameSite=Lax";break;case"strict":u+="; SameSite=Strict";break;case"none":u+="; SameSite=None";}return u};
+let i=/^[\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
+ */let serializeCookie=(t,o,r={})=>{let{encode:n=encodeURIComponent,domain:a,path:s,httpOnly:p,secure:l,sameSite:f}=r,{maxAge:m,expires:c}=r,d=n(o);if("development"===process.env.NODE_ENV){if(!i.test(t))throw TypeError("argument name is invalid");if("function"!=typeof r.encode)throw TypeError("option encode is invalid");if(d&&!i.test(d))throw TypeError("argument val is invalid")}let u=t+"="+d;if(null!=m){if(isNaN(m-=0)||!isFinite(m))throw TypeError("option maxAge is invalid");u+="; Max-Age="+Math.floor(m);}if(a){if("development"===process.env.NODE_ENV&&!i.test(a))throw TypeError("option domain is invalid");u+="; Domain="+a;}if(s){if("development"===process.env.NODE_ENV&&!i.test(s))throw TypeError("option path is invalid");u+="; Path="+s;}if(c&&(isNumber(c)&&(c=new Date(Date.now()+864e5*c)),u+="; Expires="+c.toUTCString()),p&&(u+="; HttpOnly"),l&&(u+="; Secure"),f)switch(f.toLowerCase()){case"lax":u+="; SameSite=Lax";break;case"strict":u+="; SameSite=Strict";break;case"none":u+="; SameSite=None";}//  default:
+//    throw new TypeError('option sameSite is invalid');
+return u};
 
 export { serializeCookie as default, serializeCookie };

package/setCookie.cjs.js

@@ -7,7 +7,17 @@ var isNumber = require('./isNumber.cjs.js');
 var isUndefined = require('./isUndefined.cjs.js');
 require('./getType.cjs.js');
 
-let n=e=>encodeURIComponent(e).replace(/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g,decodeURIComponent);let setCookie=(r,i,p={})=>{let {expires:c,...d}=p;({expires:"",...cookie.defaultAttributesClient,...d});if(isUndefined.isUndefined(document)){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:setCookie] document is undefined");return}isNumber.isNumber(c)&&(c=new Date(Date.now()+864e5*c)),c&&(c.toUTCString()),r=encodeURIComponent(r).replace(/%(2[346B]|5E|60|7C)/g,decodeURIComponent).replace(/[()]/g,escape);let s="";for(let e in p)p[e]&&(s+="; "+e,!0!==p[e]&&(s+="="+String(p[e]).split(";")[0]));return document.cookie=r+"="+n(i)+s};
+let n=e=>encodeURIComponent(e).replace(/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g,decodeURIComponent);/**
+ * @category cookie
+ */let setCookie=(r,i,p={})=>{// eslint-disable-next-line prefer-const
+let {expires:c,...d}=p;({expires:"",...cookie.defaultAttributesClient,...d});if(isUndefined.isUndefined(document)){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:setCookie] document is undefined");return}isNumber.isNumber(c)&&(c=new Date(Date.now()+864e5*c)),c&&(c.toUTCString()),r=encodeURIComponent(r).replace(/%(2[346B]|5E|60|7C)/g,decodeURIComponent).replace(/[()]/g,escape);let s="";for(let e in p)p[e]&&(s+="; "+e,!0!==p[e]&&// 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.
+// ...
+(s+="="+String(p[e]).split(";")[0]));return document.cookie=r+"="+n(i)+s};
 
 exports["default"] = setCookie;
 exports.setCookie = setCookie;

package/setCookie.esm.js

@@ -3,6 +3,16 @@ import { isNumber } from './isNumber.esm.js';
 import { isUndefined } from './isUndefined.esm.js';
 import './getType.esm.js';
 
-let n=e=>encodeURIComponent(e).replace(/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g,decodeURIComponent);let setCookie=(r,i,p={})=>{let {expires:c,...d}=p;({expires:"",...defaultAttributesClient,...d});if(isUndefined(document)){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:setCookie] document is undefined");return}isNumber(c)&&(c=new Date(Date.now()+864e5*c)),c&&(c.toUTCString()),r=encodeURIComponent(r).replace(/%(2[346B]|5E|60|7C)/g,decodeURIComponent).replace(/[()]/g,escape);let s="";for(let e in p)p[e]&&(s+="; "+e,!0!==p[e]&&(s+="="+String(p[e]).split(";")[0]));return document.cookie=r+"="+n(i)+s};
+let n=e=>encodeURIComponent(e).replace(/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g,decodeURIComponent);/**
+ * @category cookie
+ */let setCookie=(r,i,p={})=>{// eslint-disable-next-line prefer-const
+let {expires:c,...d}=p;({expires:"",...defaultAttributesClient,...d});if(isUndefined(document)){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:setCookie] document is undefined");return}isNumber(c)&&(c=new Date(Date.now()+864e5*c)),c&&(c.toUTCString()),r=encodeURIComponent(r).replace(/%(2[346B]|5E|60|7C)/g,decodeURIComponent).replace(/[()]/g,escape);let s="";for(let e in p)p[e]&&(s+="; "+e,!0!==p[e]&&// 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.
+// ...
+(s+="="+String(p[e]).split(";")[0]));return document.cookie=r+"="+n(i)+s};
 
 export { setCookie as default, setCookie };

package/shuffle.cjs.js

@@ -2,7 +2,21 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let shuffle=e=>{let t=null==e?0:e.length;if(!t)return [];let l=-1,r=t-1,f=[...e];for(;++l<t;){let e=l+Math.floor(Math.random()*(r-l+1)),t=f[e];f[e]=f[l],f[l]=t;}return f};
+/**
+ * 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.
+ */let shuffle=e=>{let t=null==e?0:e.length;if(!t)return [];let l=-1,r=t-1,f=[...e];for(;++l<t;){let e=l+Math.floor(Math.random()*(r-l+1)),t=f[e];f[e]=f[l],f[l]=t;}return f};
 
 exports["default"] = shuffle;
 exports.shuffle = shuffle;

package/shuffle.esm.js

@@ -1,3 +1,17 @@
-let shuffle=e=>{let t=null==e?0:e.length;if(!t)return [];let l=-1,r=t-1,f=[...e];for(;++l<t;){let e=l+Math.floor(Math.random()*(r-l+1)),t=f[e];f[e]=f[l],f[l]=t;}return f};
+/**
+ * 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.
+ */let shuffle=e=>{let t=null==e?0:e.length;if(!t)return [];let l=-1,r=t-1,f=[...e];for(;++l<t;){let e=l+Math.floor(Math.random()*(r-l+1)),t=f[e];f[e]=f[l],f[l]=t;}return f};
 
 export { shuffle as default, shuffle };

package/slugify.cjs.js

@@ -5,7 +5,25 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var accentsSets = require('./accentsSets.cjs.js');
 var removeAccents = require('./removeAccents.cjs.js');
 
-let slugify=(t,c="-")=>removeAccents.removeAccents(t.toString().toLowerCase().trim(),accentsSets.accentsSets.concat([["-","[·/_,:;']"]])).replace(/\s+/g,"-").replace(/[^a-zA-Z0-9_\u3400-\u9FBF\s-]+/g,"").replace(/--+/g,"-").replace(/^-+/,"").replace(/-+$/,"").replace(/-/g,c);
+/**
+ * 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)
+ */let slugify=(t,c="-")=>removeAccents.removeAccents(t.toString().toLowerCase().trim(),accentsSets.accentsSets.concat([["-","[·/_,:;']"]])).replace(/\s+/g,"-").// replace spaces with -
+    // .replace(/&/g, "-and-") // replace & with 'and'
+    // it used to be:
+    // .replace(/[^\w-]+/g, "") // remove all non-word chars
+    // and now with chinese support @see https://stackoverflow.com/a/25698970
+    replace(/[^a-zA-Z0-9_\u3400-\u9FBF\s-]+/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,c);
 
 exports["default"] = slugify;
 exports.slugify = slugify;

package/slugify.esm.js

@@ -1,6 +1,24 @@
 import { accentsSets } from './accentsSets.esm.js';
 import { removeAccents } from './removeAccents.esm.js';
 
-let slugify=(t,c="-")=>removeAccents(t.toString().toLowerCase().trim(),accentsSets.concat([["-","[·/_,:;']"]])).replace(/\s+/g,"-").replace(/[^a-zA-Z0-9_\u3400-\u9FBF\s-]+/g,"").replace(/--+/g,"-").replace(/^-+/,"").replace(/-+$/,"").replace(/-/g,c);
+/**
+ * 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)
+ */let slugify=(t,c="-")=>removeAccents(t.toString().toLowerCase().trim(),accentsSets.concat([["-","[·/_,:;']"]])).replace(/\s+/g,"-").// replace spaces with -
+    // .replace(/&/g, "-and-") // replace & with 'and'
+    // it used to be:
+    // .replace(/[^\w-]+/g, "") // remove all non-word chars
+    // and now with chinese support @see https://stackoverflow.com/a/25698970
+    replace(/[^a-zA-Z0-9_\u3400-\u9FBF\s-]+/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,c);
 
 export { slugify as default, slugify };

package/split.cjs.js

@@ -2,7 +2,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let split=(t,l)=>t.split(l);
+/**
+ * Quick typed replacement for `string.split("delimiter")`
+ *
+ * @category string
+ * @category text
+ */let split=(t,l)=>t.split(l);
 
 exports["default"] = split;
 exports.split = split;

package/split.esm.js

@@ -1,3 +1,8 @@
-let split=(t,l)=>t.split(l);
+/**
+ * Quick typed replacement for `string.split("delimiter")`
+ *
+ * @category string
+ * @category text
+ */let split=(t,l)=>t.split(l);
 
 export { split as default, split };

package/splitReverse.cjs.js

@@ -2,7 +2,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let splitReverse=(e,t)=>e.split(t).reverse();
+/**
+ * Quick typed replacement for `string.split("delimiter").reverse()`
+ *
+ * @category string
+ * @category text
+ */let splitReverse=(e,t)=>e.split(t).reverse();
 
 exports["default"] = splitReverse;
 exports.splitReverse = splitReverse;

package/splitReverse.esm.js

@@ -1,3 +1,8 @@
-let splitReverse=(e,t)=>e.split(t).reverse();
+/**
+ * Quick typed replacement for `string.split("delimiter").reverse()`
+ *
+ * @category string
+ * @category text
+ */let splitReverse=(e,t)=>e.split(t).reverse();
 
 export { splitReverse as default, splitReverse };

package/swapMap.cjs.js

@@ -2,7 +2,11 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let swapMap=(e={})=>{let t={};for(let p in e)t[e[p]]=p;return t};
+/**
+ * Swap object map key/value
+ *
+ * @category object
+ */let swapMap=(e={})=>{let t={};for(let p in e)t[e[p]]=p;return t};
 
 exports["default"] = swapMap;
 exports.swapMap = swapMap;

package/swapMap.esm.js

@@ -1,3 +1,7 @@
-let swapMap=(e={})=>{let t={};for(let p in e)t[e[p]]=p;return t};
+/**
+ * Swap object map key/value
+ *
+ * @category object
+ */let swapMap=(e={})=>{let t={};for(let p in e)t[e[p]]=p;return t};
 
 export { swapMap as default, swapMap };

package/throttle.cjs.js

@@ -2,7 +2,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let throttle=(t,e,r)=>{let o;return function(...l){if(r=r||this,!o)return t.apply(r,...l),o=!0,setTimeout(function(){o=!1;},e)}};
+/**
+ * Throttle function (e.g. for resize / scroll handlers)
+ *
+ * @category function
+ * @borrows [Mobius1/Rangeable](https://github.com/Mobius1/Rangeable/)
+ */let throttle=(t,e,r)=>{let o;return function(...l){if(r=r||this,!o)return t.apply(r,...l),o=!0,setTimeout(function(){o=!1;},e)}};
 
 exports["default"] = throttle;
 exports.throttle = throttle;

package/throttle.esm.js

@@ -1,3 +1,8 @@
-let throttle=(t,e,r)=>{let o;return function(...l){if(r=r||this,!o)return t.apply(r,...l),o=!0,setTimeout(function(){o=!1;},e)}};
+/**
+ * Throttle function (e.g. for resize / scroll handlers)
+ *
+ * @category function
+ * @borrows [Mobius1/Rangeable](https://github.com/Mobius1/Rangeable/)
+ */let throttle=(t,e,r)=>{let o;return function(...l){if(r=r||this,!o)return t.apply(r,...l),o=!0,setTimeout(function(){o=!1;},e)}};
 
 export { throttle as default, throttle };

package/toNumber.cjs.js

@@ -5,7 +5,11 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var isNumber = require('./isNumber.cjs.js');
 require('./getType.cjs.js');
 
-let toNumber=(r,t)=>isNumber.isNumber(r)?r:r?parseFloat(r):t||0;
+/**
+ * @category cast
+ *
+ * @param fallback Defaults to `0`
+ */let toNumber=(r,t)=>isNumber.isNumber(r)?r:r?parseFloat(r):t||0;
 
 exports["default"] = toNumber;
 exports.toNumber = toNumber;

package/toNumber.esm.js

@@ -1,6 +1,10 @@
 import { isNumber } from './isNumber.esm.js';
 import './getType.esm.js';
 
-let toNumber=(r,t)=>isNumber(r)?r:r?parseFloat(r):t||0;
+/**
+ * @category cast
+ *
+ * @param fallback Defaults to `0`
+ */let toNumber=(r,t)=>isNumber(r)?r:r?parseFloat(r):t||0;
 
 export { toNumber as default, toNumber };