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

package/uid.js

@@ -1,16 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.uid = void 0;
 var lastId = 0;
-/**
- * Super basic UID increment-based generator
- *
- * @category uid
- */
-var uid = function (prefix) {
+export var uid = function (prefix) {
     if (prefix === void 0) { prefix = "id"; }
     lastId++;
     return "".concat(prefix, "-").concat(lastId);
 };
-exports.uid = uid;
-exports.default = exports.uid;
+export default uid;

package/updateLinkParams.d.ts

@@ -1,10 +1,3 @@
-import { type AnyQueryParams } from "./location";
-/**
- * Update link `<a href="">` merging the given new query parameters.
- * it returns the newly created `href` URL value
- *
- * @category location
- * @pure
- */
+import { type AnyQueryParams } from "./location.js";
 export declare function updateLinkParams($anchor: HTMLAnchorElement, newParams: NonNullable<AnyQueryParams>): string;
 export default updateLinkParams;

package/updateLinkParams.js

@@ -1,19 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateLinkParams = void 0;
-var tslib_1 = require("tslib");
-var updateUrlQueryParams_1 = tslib_1.__importDefault(require("./updateUrlQueryParams"));
-/**
- * Update link `<a href="">` merging the given new query parameters.
- * it returns the newly created `href` URL value
- *
- * @category location
- * @pure
- */
-function updateLinkParams($anchor, newParams) {
-    var href = (0, updateUrlQueryParams_1.default)($anchor.href, newParams);
+import updateUrlQueryParams from "./updateUrlQueryParams.js";
+export function updateLinkParams($anchor, newParams) {
+    var href = updateUrlQueryParams($anchor.href, newParams);
     $anchor.href = href;
     return href;
 }
-exports.updateLinkParams = updateLinkParams;
-exports.default = updateLinkParams;
+export default updateLinkParams;

package/updateUrlQueryParams.d.ts

@@ -1,9 +1,3 @@
-import { type AnyQueryParams } from "./location";
-/**
- * Update a URL string query parameters merging the given new query parameters
- *
- * @category location
- * @pure
- */
+import { type AnyQueryParams } from "./location.js";
 export declare function updateUrlQueryParams(url: string, newParams?: NonNullable<AnyQueryParams>): string;
 export default updateUrlQueryParams;

package/updateUrlQueryParams.js

@@ -1,23 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateUrlQueryParams = void 0;
-var tslib_1 = require("tslib");
-var buildUrlQueryString_1 = tslib_1.__importDefault(require("./buildUrlQueryString"));
-var getUrlQueryParams_1 = tslib_1.__importDefault(require("./getUrlQueryParams"));
-var mergeUrlQueryParams_1 = tslib_1.__importDefault(require("./mergeUrlQueryParams"));
-/**
- * Update a URL string query parameters merging the given new query parameters
- *
- * @category location
- * @pure
- */
-function updateUrlQueryParams(url, newParams) {
+import buildUrlQueryString from "./buildUrlQueryString.js";
+import getUrlQueryParams from "./getUrlQueryParams.js";
+import mergeUrlQueryParams from "./mergeUrlQueryParams.js";
+export function updateUrlQueryParams(url, newParams) {
     if (newParams === void 0) { newParams = {}; }
     var parts = url.split("?");
     var allParams = parts[1]
-        ? (0, mergeUrlQueryParams_1.default)((0, getUrlQueryParams_1.default)(url), newParams)
+        ? mergeUrlQueryParams(getUrlQueryParams(url), newParams)
         : newParams;
-    return parts[0] + (0, buildUrlQueryString_1.default)(allParams);
+    return parts[0] + buildUrlQueryString(allParams);
 }
-exports.updateUrlQueryParams = updateUrlQueryParams;
-exports.default = updateUrlQueryParams;
+export default updateUrlQueryParams;

package/uppercase.d.ts

@@ -1,7 +1,2 @@
-/**
- * Replacement for native `toUpperCase` tyescript ready (type narrowing ready)
- *
- * @category native
- */
 export declare const uppercase: <T extends string>(str?: T | null | undefined) => Uppercase<T>;
 export default uppercase;

package/uppercase.js

@@ -1,13 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.uppercase = void 0;
-/**
- * Replacement for native `toUpperCase` tyescript ready (type narrowing ready)
- *
- * @category native
- */
-var uppercase = function (str) {
+export var uppercase = function (str) {
     return (str || "").toUpperCase();
 };
-exports.uppercase = uppercase;
-exports.default = exports.uppercase;
+export default uppercase;

package/uuid.d.ts

@@ -1,8 +1,2 @@
-/**
- * Uuid, tiny custom helper instead of node's uuid/v4
- *
- * @category uid
- * @see https://stackoverflow.com/a/2117523/1938970
- */
 export declare const uuid: () => string;
 export default uuid;

package/uuid.js

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

package/uuidNumeric.d.ts

@@ -1,6 +1,2 @@
-/**
- * @category uid
- * @see https://stackoverflow.com/a/18048162/1938970
- */
 export declare const uuidNumeric: () => number;
 export default uuidNumeric;

package/uuidNumeric.js

@@ -1,10 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.uuidNumeric = void 0;
-/**
- * @category uid
- * @see https://stackoverflow.com/a/18048162/1938970
- */
-var uuidNumeric = function () { return new Date().valueOf(); };
-exports.uuidNumeric = uuidNumeric;
-exports.default = exports.uuidNumeric;
+export var uuidNumeric = function () { return new Date().valueOf(); };
+export default uuidNumeric;

package/wait.d.ts

@@ -1,7 +1,2 @@
-/**
- * A promisified `setTimeout`
- *
- * @category async
- */
 export declare const wait: (milliseconds: number) => Promise<unknown>;
 export default wait;

package/wait.js

@@ -1,13 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.wait = void 0;
-/**
- * A promisified `setTimeout`
- *
- * @category async
- */
-var wait = function (milliseconds) {
+export var wait = function (milliseconds) {
     return new Promise(function (resolve) { return setTimeout(resolve, milliseconds); });
 };
-exports.wait = wait;
-exports.default = exports.wait;
+export default wait;

package/without.js

@@ -1,56 +1 @@
 "use strict";
-/* 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([]);
-// //   ^?

package/Defer.mjs

@@ -1,26 +0,0 @@
-/**
- * @category async
- * @see https://stackoverflow.com/a/37673534/1938970
- * @example
- *
- * ```ts
- * const deferred = Defer();
- * deferred.resolve();
- * deferred.then(handleSuccess, handleError);
- * ```
- */
-export function Defer() {
-    // @ts-expect-error nevermind
-    var self = this || {};
-    var p = (self.promise = new Promise(function (resolve, reject) {
-        self.resolve = resolve;
-        self.reject = reject;
-    }));
-    self.then = p.then.bind(p);
-    self.catch = p.catch.bind(p);
-    // if (p.finally) {
-    //   self.finally = p.finally.bind(p);
-    // }
-    return self;
-}
-export default Defer;

package/README.md

@@ -1,42 +0,0 @@
-# @koine/utils
-
-Libraries to encapsulate and re-export from here, the selection is based on:
-
-- [x] full typescript support
-- [x] treeshake-ability
-- [x] docs in source comments
-
-- [dhmk-utils](https://github.com/dhmk083/dhmk-utils)
-- [mesqueeb/merge-anything](https://github.com/mesqueeb/merge-anything)
-- [mesqueeb/filter-anything](https://github.com/mesqueeb/filter-anything)
-- [mesqueeb/case-anything](https://github.com/mesqueeb/case-anything)
-- [mesqueeb/nestify-anything](https://github.com/mesqueeb/nestify-anything)
-- [mesqueeb/fast-sort (fork)](https://github.com/mesqueeb/fast-sort (fork))
-- [mesqueeb/compare-anything](https://github.com/mesqueeb/compare-anything)
-- [mesqueeb/copy-anything](https://github.com/mesqueeb/copy-anything)
-- [mesqueeb/flatten-anything](https://github.com/mesqueeb/flatten-anything)
-
-About ts utilities types @see:
-
-- [sindresorhus/type-fest](https://github.com/sindresorhus/type-fest)
-- [millsp/ts-toolbelt](https://github.com/millsp/ts-toolbelt)
-- [ts-essentials](https://github.com/ts-essentials/ts-essentials)
-
-For inspiration look at [1loc.dev](https://1loc.dev).
-
-About utilities useful examples @see:
-
-- [chakra-ui](https://github.com/chakra-ui/chakra-ui/blob/main/packages/utils/src)
-
-TODO: We could also re-exports direct dependencies of packages that we often use
-anyway like [those of `yup`](https://github.com/jquense/yup/blob/master/package.json#L103):
-
-- [tiny-case](https://github.com/jquense/tiny-case)
-- [property-expr](https://github.com/jquense/expr/blob/master/index.js)
-- [toposort](https://github.com/marcelklehr/toposort)
-
-TODO: check typescript utilities in [TypeScript core](https://github.com/microsoft/TypeScript/blob/main/src/compiler/core.ts)
-
-## Code
-
-- Transformative functions like `truncate` or `titleCase` should allow for nullable inputs as much as possible, acceptin both `undefined` and `null`.

package/addOrReplaceAtIdx.mjs

@@ -1,19 +0,0 @@
-import { __spreadArray } from "tslib";
-/**
- * @category array
- */
-export function addOrReplaceAtIdx(list, newItem, newIdx) {
-    if (list.length === 0) {
-        return [newItem];
-    }
-    if (typeof newIdx === "undefined" || list.length - 1 < newIdx) {
-        return __spreadArray(__spreadArray([], list, true), [newItem], false);
-    }
-    return list.map(function (item, idx) {
-        if (idx === newIdx) {
-            return newItem;
-        }
-        return item;
-    });
-}
-export default addOrReplaceAtIdx;

package/areEqual.mjs

@@ -1,77 +0,0 @@
-import { isArray } from "./isArray";
-import { isObject } from "./isObject";
-function areEqualArrays(a, b) {
-    if (!b)
-        return false;
-    if (a.length !== b.length)
-        return false;
-    for (var i = 0; i < a.length; i++) {
-        var aValue = a[i];
-        var bValue = b[i];
-        if (!areEqual(aValue, bValue))
-            return false;
-    }
-    return true;
-}
-function areEqualObjects(a, b) {
-    if (!b)
-        return false;
-    var aKeys = Object.keys(a);
-    var bKeys = Object.keys(b);
-    if (aKeys.length !== bKeys.length) {
-        return false;
-    }
-    for (var _i = 0, aKeys_1 = aKeys; _i < aKeys_1.length; _i++) {
-        var _key = aKeys_1[_i];
-        var key = _key;
-        var aValue = a[key];
-        var bValue = b[key];
-        if (!areEqual(aValue, bValue)) {
-            return false;
-        }
-    }
-    return true;
-}
-/**
- * A simple and quick deep equal objects utility. This is meant to be used
- * solely to deduplicate requests payload and perform comparison on JSON ready
- * objects made of primitives `string`, `number` and `boolean`s.
- *
- * It support nested `object`s and `array`s only.
- *
- * NB: `undefined` and `null` values do not count in the comparison as they are
- * usually meant to be ignored in JSON requestBody payloads.
- *
- * According to very rudimentary tests this function takes on average between
- * 0.15 ms and 2ms to compare two averaged sizes requet body payloads.
- *
- * @category objects
- */
-export function areEqual(a, b) {
-    if (!a && !b) {
-        // console.log(`areEqual took ${performance.now() - t0} ms`);
-        return true;
-    }
-    // const t0 = performance.now();
-    if (!b && a !== b) {
-        // console.log(`areEqual took ${performance.now() - t0} ms`);
-        return false;
-    }
-    var areObjects = isObject(a) && isObject(b);
-    if (areObjects && !areEqualObjects(a, b)) {
-        // console.log(`areEqual took ${performance.now() - t0} ms`);
-        return false;
-    }
-    var areArrays = isArray(a) && isArray(b);
-    if (areArrays && !areEqualArrays(a, b)) {
-        // console.log(`areEqual took ${performance.now() - t0} ms`);
-        return false;
-    }
-    if (!areObjects && !areArrays && a !== b) {
-        // console.log(`areEqual took ${performance.now() - t0} ms`);
-        return false;
-    }
-    // console.log(`areEqual took ${performance.now() - t0} ms`);
-    return true;
-}
-export default areEqual;

package/arrayOfAll.mjs

@@ -1,32 +0,0 @@
-/**
- * Ensure an array contains all desired values
- *
- * @category array
- * @borrows [SO comment by `CertainPerformance`](https://stackoverflow.com/a/60132060/1938970)
- *
- * @usage
- *
- * ```
- * type Fruit = "pear" | "apple" | "orange";
- *
- * const arrayOfAllFruits = arrayOfAll<Fruit>();
- *
- * const allFruits = arrayOfAllFruits([
- *  "pear",
- *  "apple",
- *  "orange"
- * ]); // ts compiler ok
- *
- * const allFruits = arrayOfAllFruits([
- *  "pear",
- *  "apple",
- * ]); // ts compiler fails
- * ```
- *
- */
-export var arrayOfAll = function () {
-    return function (array) {
-        return array;
-    };
-};
-export default arrayOfAll;

package/arraySum.mjs

@@ -1,9 +0,0 @@
-/**
- * Sum array of numbers
- *
- * @category array | math
- */
-export var arraySum = function (numbers) {
-    return numbers.reduce(function (sum, current) { return sum + current; }, 0);
-};
-export default arraySum;

package/arrayToLookup.mjs

@@ -1,13 +0,0 @@
-/**
- * Maps a simple flat array to a lookup dictionary object
- *
- * @category array
- */
-export function arrayToLookup(array) {
-    if (array === void 0) { array = []; }
-    return array.reduce(function (obj, item) {
-        obj[item] = 1;
-        return obj;
-    }, {});
-}
-export default arrayToLookup;

package/buildUrlQueryString.mjs

@@ -1,31 +0,0 @@
-import isNull from "./isNull";
-import isUndefined from "./isUndefined";
-import isArray from "./isArray";
-/**
- * Get clean query string for URL
- *
- * It returns the query string **with** the initial `?`
- *
- * TODO: at some point replace with `URLSearchParams`, @see [caniuse](https://caniuse.com/?search=URLSearchParams)
- *
- * @category location
- */
-export function buildUrlQueryString(params) {
-    var output = "";
-    if (!params)
-        return output;
-    for (var key in params) {
-        var value = params[key];
-        if (isArray(value)) {
-            for (var i = 0; i < value.length; i++) {
-                output += "".concat(key, "=").concat(encodeURIComponent(value[i] + ""), "&");
-            }
-        }
-        else if (!isNull(value) && !isUndefined(value)) {
-            output += "".concat(key, "=").concat(encodeURIComponent(value + ""), "&");
-        }
-    }
-    // removes the last &
-    return output ? "?".concat(output.replace(/&+$/, "")) : "";
-}
-export default buildUrlQueryString;

package/capitalize.mjs

@@ -1,12 +0,0 @@
-/**
- * Capitalize first letter of the given string.
- *
- * @category text
- * @see https://stackoverflow.com/a/11409944/1938970
- */
-export function capitalize(string) {
-    var ensuredString = string || "";
-    return (ensuredString.charAt(0).toUpperCase() +
-        ensuredString.slice(1));
-}
-export default capitalize;

package/changeUrlPath.mjs

@@ -1,18 +0,0 @@
-import isBrowser from "./isBrowser";
-import normaliseUrlPathname from "./normaliseUrlPathname";
-/**
- * Change URL path, ensures initial and ending slashes and normalise eventual
- * consecutive slashes, it uses `history`.
- *
- * @category location
- * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
- * @returns {string} The new cleaned pathname
- */
-export function changeUrlPath(pathname, state, replace) {
-    var path = normaliseUrlPathname("/".concat(pathname, "/"));
-    if (isBrowser) {
-        history[replace ? "replaceState" : "pushState"](state, "", path);
-    }
-    return path;
-}
-export default changeUrlPath;

package/chunkBySize.mjs

@@ -1,12 +0,0 @@
-/**
- * @category array
- * @see https://stackoverflow.com/a/40682136/1938970
- */
-export function chunkBySize(arr, size) {
-    var output = [];
-    for (var i = 0; i < arr.length; i += size) {
-        output.push(arr.slice(i, i + size));
-    }
-    return output;
-}
-export default chunkBySize;

package/clamp.mjs

@@ -1,10 +0,0 @@
-/**
- * Returns a number whose value is limited to the given range.
- *
- * @category math
- * @see https://stackoverflow.com/a/11409944/1938970
- */
-export function clamp(num, min, max) {
-    return Math.min(Math.max(num, min), max);
-}
-export default clamp;

package/convertRange.mjs

@@ -1,16 +0,0 @@
-/**
- * Convert range of a number
- *
- * e.g. converting number 5 in a scale/range from 0 10 to a scale/range from 50
- * to 100 would return 75
- * ```
- * convertRange(5, [0, 10], [50, 100]);
- * ```
- *
- * @category math
- * @see https://stackoverflow.com/a/14224813
- */
-export function convertRange(num, r1, r2) {
-    return ((num - r1[0]) * (r2[1] - r2[0])) / (r1[1] - r1[0]) + r2[0];
-}
-export default convertRange;

package/cookie.mjs

@@ -1,10 +0,0 @@
-/**
- * @file
- *
- * @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 var defaultAttributesClient = { path: "/" };

package/createPalette.mjs

@@ -1,22 +0,0 @@
-/**
- * Create palette, this is primarily thought to improve the reuse of a palette
- * definition between TailwindCSS and straight ES imports
- *
- * @category styling|tailwind|colours
- *
- * @returns An array with: 1) A flat palette map 2) A TailwindCSS ready palette
- * object 3) A flat array of colors (no special sorting, same order as the `shades`
- * given as argument)
- */
-export var createPalette = function (name, shades) {
-    var map = shades.reduce(function (map, def) {
-        map[def[0]] = def[1];
-        return map;
-    }, {});
-    var tailwindPalette = shades.reduce(function (map, def) {
-        map["".concat(name, "-").concat(def[0])] = def[1];
-        return map;
-    }, {});
-    return [map, tailwindPalette, Object.values(map)];
-};
-export default createPalette;

package/debouncePromise.mjs

@@ -1,9 +0,0 @@
-import { debounce as tsDebounce } from "ts-debounce";
-/**
- * Debounce function (with `Promise`)
- *
- * @category function
- * @borrows [chodorowicz/ts-debounce](https://github.com/chodorowicz/ts-debounce)
- */
-export var debouncePromise = tsDebounce;
-export default debouncePromise;