@koine/utils 2.0.0-beta.2 → 2.0.0-beta.21

package/parseURL.d.ts

@@ -1,9 +1,3 @@
-/**
- * Solution without DOM or specific env native methods
- *
- * @category location
- * @see https://stackoverflow.com/a/21553982/1938970
- */
 export declare function parseURL(url: string): {
     href: string;
     protocol: string;

package/parseURL.js

@@ -1,13 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseURL = void 0;
-/**
- * Solution without DOM or specific env native methods
- *
- * @category location
- * @see https://stackoverflow.com/a/21553982/1938970
- */
-function parseURL(url) {
+export function parseURL(url) {
     var match = url.match(/^(https?:)\/\/(([^:/?#]*)(?::([0-9]+))?)([/]{0,1}[^?#]*)(\?[^#]*|)(#.*|)$/);
     return (match && {
         href: url,
@@ -20,5 +11,4 @@ function parseURL(url) {
         hash: match[7],
     });
 }
-exports.parseURL = parseURL;
-exports.default = parseURL;
+export default parseURL;

package/quaranteneProps.d.ts

@@ -1,18 +1,3 @@
-/**
- * @category impl
- * @usage
- *
- * ```ts
- * const { _: { onKeyDown }, myOwnProp, ...rest } = quaranteneProps([
- *   "onPointerLeave",
- *   "onPointerMove",
- *   "onClick",
- *   "onPointerDown",
- *   "onPointerUp",
- *   "onKeyDown",
- * ]);
- * ```
- */
 export declare function quaranteneProps<TProps extends Record<never, never>, TSupectPropsKeys extends QuaranteneProps<TProps>>(props: TProps, propsKeysToQuarantene: TSupectPropsKeys): Omit<TProps, TSupectPropsKeys[number]> & {
     _: Pick<TProps, TSupectPropsKeys[number]>;
 };

package/quaranteneProps.js

@@ -1,23 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.quaranteneProps = void 0;
-/**
- * @category impl
- * @usage
- *
- * ```ts
- * const { _: { onKeyDown }, myOwnProp, ...rest } = quaranteneProps([
- *   "onPointerLeave",
- *   "onPointerMove",
- *   "onClick",
- *   "onPointerDown",
- *   "onPointerUp",
- *   "onKeyDown",
- * ]);
- * ```
- */
-function quaranteneProps(props, propsKeysToQuarantene) {
-    // approach 1)
+export function quaranteneProps(props, propsKeysToQuarantene) {
     var healthyProps = {
         _: {},
     };
@@ -27,11 +8,9 @@ function quaranteneProps(props, propsKeysToQuarantene) {
             healthyProps._[key] = prop;
         }
         else {
-            // @ts-expect-error nevermind
             healthyProps[key] = prop;
         }
     }
     return healthyProps;
 }
-exports.quaranteneProps = quaranteneProps;
-exports.default = quaranteneProps;
+export default quaranteneProps;

package/randomInt.d.ts

@@ -1,7 +1,2 @@
-/**
- * Get random int (min and max included)
- *
- * @category math
- */
 export declare function randomInt(min: number, max: number): number;
 export default randomInt;

package/randomInt.js

@@ -1,13 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomInt = void 0;
-/**
- * Get random int (min and max included)
- *
- * @category math
- */
-function randomInt(min, max) {
+export function randomInt(min, max) {
     return Math.floor(Math.random() * (max - min + 1) + min);
 }
-exports.randomInt = randomInt;
-exports.default = randomInt;
+export default randomInt;

package/randomKey.d.ts

@@ -1,8 +1,2 @@
-/**
- * Get random key from given object
- *
- * @category misc
- * @see https://stackoverflow.com/a/15106541/1938970
- */
 export declare function randomKey<T extends Record<string | number, unknown>>(obj: T): keyof T;
 export default randomKey;

package/randomKey.js

@@ -1,15 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomKey = void 0;
-/**
- * Get random key from given object
- *
- * @category misc
- * @see https://stackoverflow.com/a/15106541/1938970
- */
-function randomKey(obj) {
+export function randomKey(obj) {
     var keys = Object.keys(obj);
     return keys[(keys.length * Math.random()) << 0];
 }
-exports.randomKey = randomKey;
-exports.default = randomKey;
+export default randomKey;

package/readCookie.js

@@ -1,15 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readCookie = void 0;
 function converterRead(value) {
     if (value[0] === '"') {
         value = value.slice(1, -1);
     }
     return value.replace(/(%[\dA-F]{2})+/gi, decodeURIComponent);
 }
-function readCookie(name) {
+export function readCookie(name) {
     if (typeof document === "undefined") {
-        if (process.env["NODE_ENV"] !== "production") {
+        if (process.env["NODE_ENV"] === "development") {
             console.warn("[@koine/utils:readCookie] document is undefined");
         }
         return name ? "" : {};
@@ -27,12 +24,11 @@ function readCookie(name) {
             }
         }
         catch (e) {
-            if (process.env["NODE_ENV"] !== "production") {
+            if (process.env["NODE_ENV"] === "development") {
                 console.warn("[@koine/utils:readCookie] failed to decode", value);
             }
         }
     }
     return name ? all[name] : all;
 }
-exports.readCookie = readCookie;
-exports.default = readCookie;
+export default readCookie;

package/removeAccents.d.ts

@@ -1,6 +1,3 @@
-import { type AccentsSet } from "./accentSets";
-/**
- * @category text
- */
+import { type AccentsSet } from "./accentSets.js";
 export declare function removeAccents(text?: string, sets?: AccentsSet[]): string;
 export default removeAccents;

package/removeAccents.js

@@ -1,19 +1,13 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeAccents = void 0;
-var accentSets_1 = require("./accentSets");
-/**
- * @category text
- */
-function removeAccents(text, sets) {
+import { __read } from "tslib";
+import { accentsSets } from "./accentSets.js";
+export function removeAccents(text, sets) {
     if (text === void 0) { text = ""; }
-    if (sets === void 0) { sets = accentSets_1.accentsSets; }
+    if (sets === void 0) { sets = accentsSets; }
     var len = sets.length;
     while (len--) {
-        var _a = sets[len], to = _a[0], from = _a[1];
+        var _a = __read(sets[len], 2), to = _a[0], from = _a[1];
         text = text.replace(new RegExp("[".concat(from, "]"), "gi"), to);
     }
     return text;
 }
-exports.removeAccents = removeAccents;
-exports.default = removeAccents;
+export default removeAccents;

package/removeCookie.d.ts

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

package/removeCookie.js

@@ -1,19 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeCookie = void 0;
-var tslib_1 = require("tslib");
-var cookie_1 = require("./cookie");
-var setCookie_1 = require("./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)
- */
-function removeCookie(name, attributes) {
+import { __assign } from "tslib";
+import { defaultAttributesClient } from "./cookie.js";
+import { setCookie } from "./setCookie.js";
+export function removeCookie(name, attributes) {
     if (attributes === void 0) { attributes = {}; }
-    (0, setCookie_1.setCookie)(name, "", tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, cookie_1.defaultAttributesClient), attributes), { expires: -1 }));
+    setCookie(name, "", __assign(__assign(__assign({}, defaultAttributesClient), attributes), { expires: -1 }));
 }
-exports.removeCookie = removeCookie;
-exports.default = removeCookie;
+export default removeCookie;

package/removeDuplicates.js

@@ -1,13 +1 @@
 "use strict";
-// /**
-//  * 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.d.ts

@@ -1,8 +1,2 @@
-/**
- * Remove duplicated array objects, equality is determined by a strict (`===`)
- * comparison of each object's given key
- *
- * @category array
- */
 export declare function removeDuplicatesByKey<T extends Record<string | number | symbol, any>>(array: T[] | undefined, key: keyof T): T[];
 export default removeDuplicatesByKey;

package/removeDuplicatesByKey.js

@@ -1,13 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeDuplicatesByKey = void 0;
-/**
- * Remove duplicated array objects, equality is determined by a strict (`===`)
- * comparison of each object's given key
- *
- * @category array
- */
-function removeDuplicatesByKey(array, key) {
+export function removeDuplicatesByKey(array, key) {
     if (array === void 0) { array = []; }
     var keysMap = {};
     var output = [];
@@ -20,5 +11,4 @@ function removeDuplicatesByKey(array, key) {
     }
     return output;
 }
-exports.removeDuplicatesByKey = removeDuplicatesByKey;
-exports.default = removeDuplicatesByKey;
+export default removeDuplicatesByKey;

package/removeDuplicatesComparing.d.ts

@@ -1,5 +1,2 @@
-/**
- * @category array
- */
 export declare function removeDuplicatesComparing<T>(from: any[], to: T[]): T[];
 export default removeDuplicatesComparing;

package/removeDuplicatesComparing.js

@@ -1,14 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeDuplicatesComparing = void 0;
-var removeIndexesFromArray_1 = require("./removeIndexesFromArray");
-var findDuplicatedIndexes_1 = require("./findDuplicatedIndexes");
-/**
- * @category array
- */
-function removeDuplicatesComparing(from, to) {
-    var indexes = (0, findDuplicatedIndexes_1.findDuplicatedIndexes)(from);
-    return (0, removeIndexesFromArray_1.removeIndexesFromArray)(to, indexes);
+import { findDuplicatedIndexes } from "./findDuplicatedIndexes.js";
+import { removeIndexesFromArray } from "./removeIndexesFromArray.js";
+export function removeDuplicatesComparing(from, to) {
+    var indexes = findDuplicatedIndexes(from);
+    return removeIndexesFromArray(to, indexes);
 }
-exports.removeDuplicatesComparing = removeDuplicatesComparing;
-exports.default = removeDuplicatesComparing;
+export default removeDuplicatesComparing;

package/removeIndexesFromArray.d.ts

@@ -1,5 +1,2 @@
-/**
- * @category array
- */
 export declare function removeIndexesFromArray<T>(arr: T[], indexes: Record<number, true>): T[];
 export default removeIndexesFromArray;

package/removeIndexesFromArray.js

@@ -1,18 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeIndexesFromArray = void 0;
-/**
- * @category array
- */
-function removeIndexesFromArray(arr, indexes) {
+export function removeIndexesFromArray(arr, indexes) {
     var output = [];
     for (var i = 0; i < arr.length; i++) {
-        // eslint-disable-next-line no-prototype-builtins
         if (!indexes.hasOwnProperty(i)) {
             output.push(arr[i]);
         }
     }
     return output;
 }
-exports.removeIndexesFromArray = removeIndexesFromArray;
-exports.default = removeIndexesFromArray;
+export default removeIndexesFromArray;

package/removeTrailingSlash.d.ts

@@ -1,7 +1,2 @@
-/**
- * Strips out the trailing slash
- *
- * @category location
- */
 export declare function removeTralingSlash(urlLike?: string): string;
 export default removeTralingSlash;

package/removeTrailingSlash.js

@@ -1,14 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeTralingSlash = void 0;
-/**
- * Strips out the trailing slash
- *
- * @category location
- */
-function removeTralingSlash(urlLike) {
+export function removeTralingSlash(urlLike) {
     if (urlLike === void 0) { urlLike = ""; }
     return urlLike.replace(/\/*$/, "");
 }
-exports.removeTralingSlash = removeTralingSlash;
-exports.default = removeTralingSlash;
+export default removeTralingSlash;

package/removeUrlQueryParams.d.ts

@@ -1,8 +1,2 @@
-/**
- * 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.js

@@ -1,26 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeUrlQueryParams = void 0;
-var tslib_1 = require("tslib");
-var buildUrlQueryString_1 = tslib_1.__importDefault(require("./buildUrlQueryString"));
-var getUrlQueryParams_1 = tslib_1.__importDefault(require("./getUrlQueryParams"));
-/**
- * Remove the given keys from the given URL query parameters
- *
- * @category location
- * @pure
- */
-function removeUrlQueryParams(url, paramsToRemove) {
+import buildUrlQueryString from "./buildUrlQueryString.js";
+import getUrlQueryParams from "./getUrlQueryParams.js";
+export function removeUrlQueryParams(url, paramsToRemove) {
     if (paramsToRemove === void 0) { paramsToRemove = []; }
     var parts = url.split("?");
-    var allParams = (0, getUrlQueryParams_1.default)(url);
+    var allParams = getUrlQueryParams(url);
     var params = {};
     for (var key in allParams) {
         if (!paramsToRemove.includes(key)) {
             params[key] = allParams[key];
         }
     }
-    return parts[0] + (0, buildUrlQueryString_1.default)(params);
+    return parts[0] + buildUrlQueryString(params);
 }
-exports.removeUrlQueryParams = removeUrlQueryParams;
-exports.default = removeUrlQueryParams;
+export default removeUrlQueryParams;

package/render.d.ts

@@ -8,45 +8,6 @@ type DefinitionExtended = {
 type Definitions = {
     [key: string]: DefinitionExtended;
 } & DefinitionExtended;
-/**
- * Returned render function
- */
 type RenderFunction = (data: object) => string;
-/**
- * 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
- * ```
- *
- * @example
- *
- * ```js
- * 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 declare const render: (tmpl: string, def?: Definitions) => RenderFunction;
 export default render;

package/render.js

@@ -1,19 +1,14 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.render = void 0;
 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 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 startencode = "'+encodeHTML(";
 var skip = /$^/;
 var resolveDefs = function (block, def) {
     return (typeof block === "string" ? block : block.toString())
@@ -23,12 +18,9 @@ var resolveDefs = function (block, def) {
         }
         if (!(code in def)) {
             if (assign === ":") {
-                value.replace(defineParams, 
-                // @ts-expect-error nevermind
-                function (_, param, v) {
+                value.replace(defineParams, function (_, param, v) {
                     def[code] = { arg: param, text: v };
                 });
-                // @ts-expect-error nevermind
                 if (!(code in def))
                     def[code] = value;
             }
@@ -55,43 +47,7 @@ var resolveDefs = function (block, def) {
 var unescape = function (code) {
     return 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
- * ```
- *
- * @example
- *
- * ```js
- * 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
- */
-var render = function (tmpl, def) {
+export var render = function (tmpl, def) {
     var sid = 0;
     var indv;
     var str = use || define ? resolveDefs(tmpl, def || {}) : tmpl;
@@ -101,10 +57,6 @@ var render = function (tmpl, def) {
             .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
@@ -153,17 +105,15 @@ var render = function (tmpl, def) {
         .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") {
+        if (process.env["NODE_ENV"] === "development") {
             console.log("Could not create a template function: " + str);
             throw e;
         }
     }
     return function () { return ""; };
 };
-exports.render = render;
-exports.default = exports.render;
+export default render;

package/round.d.ts

@@ -0,0 +1,3 @@
+import type { AnythingFalsy } from "./types.js";
+export declare const round: (number: number, decimals?: AnythingFalsy | number, trailingZeroes?: 1 | boolean | AnythingFalsy) => number;
+export default round;

package/round.js

@@ -0,0 +1,6 @@
+export var round = function (number, decimals, trailingZeroes) {
+    return decimals
+        ? parseFloat(number.toFixed(decimals).replace(trailingZeroes ? "" : /\.+0*$/, ""))
+        : parseInt(number + "", 10);
+};
+export default round;

package/roundTo.d.ts

@@ -1,8 +1,2 @@
-/**
- * Round to given number of the given number of decimals
- *
- * @category math
- * @see https://stackoverflow.com/a/15762794/1938970
- */
 export declare function roundTo(num: number, decimals?: number): string;
 export default roundTo;

package/roundTo.js

@@ -1,38 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.roundTo = void 0;
-/**
- * Round to given number of the given number of decimals
- *
- * @category math
- * @see https://stackoverflow.com/a/15762794/1938970
- */
-function roundTo(num, decimals) {
+export function roundTo(num, decimals) {
     if (decimals === void 0) { 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);
         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") {
+    if (process.env["NODE_ENV"] === "development") {
         console.warn("[@koine/utils] math:roundTo -> given not a finite number as first arg");
     }
     return "";
 }
-exports.roundTo = roundTo;
-exports.default = roundTo;
+export default roundTo;