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

package/throttle.js

@@ -0,0 +1,20 @@
+import { __spreadArray } from "tslib";
+export function throttle(fn, limit, context) {
+    var wait;
+    return function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        context = context || this;
+        if (!wait) {
+            fn.apply.apply(fn, __spreadArray([context], args, false));
+            wait = true;
+            return setTimeout(function () {
+                wait = false;
+            }, limit);
+        }
+        return;
+    };
+}
+export default throttle;

package/titleCase.d.ts

@@ -1,8 +1,2 @@
-/**
- * @category text
- *
- * @borrows [blakeembrey/change-case](https://github.com/blakeembrey/change-case/blob/master/packages/title-case/src/index.ts)
- * @license Blake Embrey (hello@blakeembrey.com)
- */
 export declare const titleCase: (input?: null | string) => string;
 export default titleCase;

package/titleCase.js

@@ -0,0 +1,6 @@
+export var titleCase = function (input) {
+    return input
+        ? input.replace(/\w\S*/g, function (txt) { return txt.charAt(0).toUpperCase() + txt.substring(1).toLowerCase(); })
+        : "";
+};
+export default titleCase;

package/toNumber.d.ts

@@ -1,5 +1,2 @@
-/**
- * @category cast
- */
 export declare function toNumber(input?: string | number, fallback?: number): number;
 export default toNumber;

package/toNumber.js

@@ -0,0 +1,5 @@
+import { isNumber } from "./isNumber.js";
+export function toNumber(input, fallback) {
+    return isNumber(input) ? input : input ? parseFloat(input) : fallback || 0;
+}
+export default toNumber;

package/toRgba.d.ts

@@ -1,5 +1,2 @@
-/**
- * @category colors
- */
 export declare function toRgba(hex: string, alpha?: number): string;
 export default toRgba;

package/toRgba.js

@@ -0,0 +1,9 @@
+export function toRgba(hex, alpha) {
+    if (alpha === void 0) { alpha = 1; }
+    var r = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+    if (r) {
+        return "rgba(".concat(parseInt(r[1], 16), ",").concat(parseInt(r[2], 16), ",").concat(parseInt(r[3], 16), ",").concat(alpha, ")");
+    }
+    return "";
+}
+export default toRgba;

package/transformToUrlPathname.d.ts

@@ -1,11 +1,2 @@
-/**
- * Transform string in a URL pathname (relative URL)
- *
- * - adds an initial slash
- * - encode the string
- * - replaces whitespaces with dashes
- *
- * @category location
- */
 export declare function transformToUrlPathname(toPathname?: string): string;
 export default transformToUrlPathname;

package/transformToUrlPathname.js

@@ -0,0 +1,7 @@
+import isString from "./isString.js";
+export function transformToUrlPathname(toPathname) {
+    return isString(toPathname)
+        ? "/".concat(encodeURIComponent(toPathname.replace(/\s/g, "-").toLowerCase()))
+        : "";
+}
+export default transformToUrlPathname;

package/truncate.d.ts

@@ -1,7 +1,2 @@
-/**
- * Truncate string
- *
- * @category text
- */
 export declare const truncate: (input: undefined | null | string, length: number) => string;
 export default truncate;

package/truncate.js

@@ -0,0 +1,8 @@
+export var truncate = function (input, length) {
+    return input
+        ? input.length > length
+            ? input.substring(0, length) + "..."
+            : input
+        : "";
+};
+export default truncate;

package/tryUntil.d.ts

@@ -1,11 +1,2 @@
-/**
- * @category function
- * @category async
- *
- * @borrows [Javascript: Wait Until Something Happens or Timeout](https://levelup.gitconnected.com/javascript-wait-until-something-happens-or-timeout-82636839ea93)
- *
- * @param timeout in `ms`
- * @param interval in `ms`
- */
 export declare const tryUntil: (test: () => boolean, timeout: number, interval: number, resolve: () => void, reject?: () => void) => void;
 export default tryUntil;

package/tryUntil.js

@@ -0,0 +1,15 @@
+export var tryUntil = function (test, timeout, interval, resolve, reject) {
+    var timeWas = new Date();
+    var wait = setInterval(function () {
+        if (test()) {
+            clearInterval(wait);
+            resolve();
+        }
+        else if (new Date() - timeWas > timeout) {
+            clearInterval(wait);
+            if (reject)
+                reject();
+        }
+    }, interval);
+};
+export default tryUntil;

package/types.d.ts

@@ -1,28 +1,10 @@
 import type { Replace } from "type-fest";
-/**
- * Whatever that in javascript returns `false` when checked in an `if` condition
- */
 export type AnythingFalsy = null | undefined | 0 | "";
-/**
- * Pick the keys of an object `T` that starts with `S`. It produces a mapped type
- * with a subset of `T` whose keys start with `S`.
- */
 export type PickStartsWith<T extends object, S extends string> = {
     [K in keyof T as K extends `${S}${string}` ? K : never]: T[K];
 };
-/**
- * Returns a union of all the keys of an object `T` which starts with `S`.
- */
 export type KeysStartsWith<T extends object, S extends string> = keyof PickStartsWith<T, S>;
-/**
- * Pick the keys of an object `T` that starts with `S`. It produces a mapped type
- * with a subset of `T` whose keys start with `S` *and have `S`* removed.
- */
 export type PickStartsWithTails<T extends object, S extends string> = {
     [K in keyof T as K extends `${S}${string}` ? Replace<K, S, ""> : never]: T[K];
 };
-/**
- * Returns a union of all the keys of an object `T` which starts with `S`.
- * The strings in the produced union *have `S` removed*.
- */
 export type KeysTailsStartsWith<T extends object, S extends string> = keyof PickStartsWithTails<T, S>;

package/types.js

@@ -0,0 +1 @@
+export {};

package/uid.d.ts

@@ -1,7 +1,2 @@
-/**
- * Super basic UID increment-based generator
- *
- * @category uid
- */
 export declare const uid: (prefix?: string) => string;
 export default uid;

package/uid.js

@@ -0,0 +1,7 @@
+var lastId = 0;
+export var uid = function (prefix) {
+    if (prefix === void 0) { prefix = "id"; }
+    lastId++;
+    return "".concat(prefix, "-").concat(lastId);
+};
+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

@@ -0,0 +1,7 @@
+import updateUrlQueryParams from "./updateUrlQueryParams.js";
+export function updateLinkParams($anchor, newParams) {
+    var href = updateUrlQueryParams($anchor.href, newParams);
+    $anchor.href = href;
+    return href;
+}
+export default updateLinkParams;

package/updateUrlQueryParams.d.ts

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

package/updateUrlQueryParams.js

@@ -0,0 +1,12 @@
+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]
+        ? mergeUrlQueryParams(getUrlQueryParams(url), newParams)
+        : newParams;
+    return parts[0] + buildUrlQueryString(allParams);
+}
+export default updateUrlQueryParams;

package/uppercase.d.ts

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

package/uppercase.js

@@ -0,0 +1,4 @@
+export var uppercase = function (str) {
+    return (str || "").toUpperCase();
+};
+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

@@ -0,0 +1,7 @@
+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);
+    });
+};
+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

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1,4 @@
+export var wait = function (milliseconds) {
+    return new Promise(function (resolve) { return setTimeout(resolve, milliseconds); });
+};
+export default wait;

package/without.js

@@ -0,0 +1 @@
+"use strict";

package/Defer.mjs

@@ -1,27 +0,0 @@
-/**
- * @category async
- */ /**
- * @category async
- * @see https://stackoverflow.com/a/37673534/1938970
- * @example
- *
- * ```ts
- * const deferred = Defer();
- * deferred.resolve();
- * deferred.then(handleSuccess, handleError);
- * ```
- */ export function Defer() /* : PromiseConstructor */ {
-    // @ts-expect-error nevermind
-    const self = this || {};
-    const p = self.promise = new Promise((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/Emitter.mjs

@@ -1,37 +0,0 @@
-/**
- * Emitter super simple class
- *
- * Events will be prefixed with the given `namespace` plus a `.` so:
- * `{namespace}.myevent`
- *
- * Adapted from https://github.com/developit/mitt
- *
- * Regarding typescript support see:
- * - https://stackoverflow.com/q/53299743/1938970
- * - https://github.com/Microsoft/TypeScript/pull/26349
- *
- * @category impl
- */ export function Emitter(namespace) {
-    const all = new Map();
-    return {
-        /**
-     * Register an event handler for the given type.
-     */ on (name, handler) {
-            const handlers = all.get(`${namespace}.${String(name)}`);
-            const added = handlers && handlers.push(handler);
-            if (!added) {
-                all.set(`${namespace}.${String(name)}`, [
-                    handler
-                ]);
-            }
-        },
-        /**
-     * Invoke all handlers for the given type.
-     */ emit (name, data) {
-            (all.get(`${namespace}.${String(name)}`) || []).slice().map((handler)=>{
-                handler(data);
-            });
-        }
-    };
-}
-export default Emitter;

package/README.md

@@ -1,47 +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)
-
-To considerç
-
-- [dlv](https://www.npmjs.com/package/dlv)
-- [dset](https://github.com/lukeed/dset)
-
-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/accentSets.mjs

@@ -1,123 +0,0 @@
-/**
- * First value is the `to`, second is `from`, from *which* chars do we translates *to*
- *
- * @category text
- */ /**
- * Accent sets
- *
- * @category text
- * @resources
- * - https://gist.github.com/mathewbyrne/1280286#gistcomment-3498021
- * - https://gist.github.com/eek/9c4887e80b3ede05c0e39fee4dce3747 for usage
- * of [normalize](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize)
- */ export const accentsSets = [
-    [
-        "a",
-        "ÀÁÂÃÅÆĀĂĄẠẢẤẦẨẪẬẮẰẲẴẶ"
-    ],
-    [
-        "ae",
-        "Ä"
-    ],
-    [
-        "c",
-        "ÇĆĈČ"
-    ],
-    [
-        "d",
-        "ÐĎĐÞ"
-    ],
-    [
-        "e",
-        "ÈÉÊËĒĔĖĘĚẸẺẼẾỀỂỄỆ"
-    ],
-    [
-        "g",
-        "ĜĞĢǴ"
-    ],
-    [
-        "h",
-        "ĤḦ"
-    ],
-    [
-        "i",
-        "ÌÍÎÏĨĪĮİỈỊ"
-    ],
-    [
-        "j",
-        "Ĵ"
-    ],
-    [
-        "ij",
-        "IJ"
-    ],
-    [
-        "k",
-        "Ķ"
-    ],
-    [
-        "l",
-        "ĹĻĽŁ"
-    ],
-    [
-        "m",
-        "Ḿ"
-    ],
-    [
-        "n",
-        "ÑŃŅŇ"
-    ],
-    [
-        "o",
-        "ÒÓÔÕØŌŎŐỌỎỐỒỔỖỘỚỜỞỠỢǪǬƠ"
-    ],
-    [
-        "oe",
-        "΅"
-    ],
-    [
-        "p",
-        "ṕ"
-    ],
-    [
-        "r",
-        "ŔŖŘ"
-    ],
-    [
-        "s",
-        "ŚŜŞŠ"
-    ],
-    [
-        "ss",
-        "ß"
-    ],
-    [
-        "t",
-        "ŢŤ"
-    ],
-    [
-        "u",
-        "ÙÚÛŨŪŬŮŰŲỤỦỨỪỬỮỰƯ"
-    ],
-    [
-        "ue",
-        "Ü"
-    ],
-    [
-        "w",
-        "ẂŴẀẄ"
-    ],
-    [
-        "x",
-        "ẍ"
-    ],
-    [
-        "y",
-        "ÝŶŸỲỴỶỸ"
-    ],
-    [
-        "z",
-        "ŹŻŽ"
-    ]
-];
-export default accentsSets;

package/addOrReplaceAtIdx.mjs

@@ -1,26 +0,0 @@
-/**
- * Add or replace an item in the given array, it returns a new array (immutable).
- * Typescript wise this is meant to keep the same type on the newly returned
- * array, therefore the `newItem` must match the type of the `list` items.
- *
- * @category array
- */ export function addOrReplaceAtIdx(list, newItem, newIdx) {
-    if (list.length === 0) {
-        return [
-            newItem
-        ];
-    }
-    if (typeof newIdx === "undefined" || list.length - 1 < newIdx) {
-        return [
-            ...list,
-            newItem
-        ];
-    }
-    return list.map((item, idx)=>{
-        if (idx === newIdx) {
-            return newItem;
-        }
-        return item;
-    });
-}
-export default addOrReplaceAtIdx;

package/areEqual.mjs

@@ -1,71 +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(let i = 0; i < a.length; i++){
-        const aValue = a[i];
-        const bValue = b[i];
-        if (!areEqual(aValue, bValue)) return false;
-    }
-    return true;
-}
-function areEqualObjects(a, b) {
-    if (!b) return false;
-    const aKeys = Object.keys(a);
-    const bKeys = Object.keys(b);
-    if (aKeys.length !== bKeys.length) {
-        return false;
-    }
-    for (const _key of aKeys){
-        const key = _key;
-        const aValue = a[key];
-        const 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 object
- */ 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;
-    }
-    const areObjects = isObject(a) && isObject(b);
-    if (areObjects && !areEqualObjects(a, b)) {
-        // console.log(`areEqual took ${performance.now() - t0} ms`);
-        return false;
-    }
-    const 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,26 +0,0 @@
-/**
- * Ensure an array contains all desired values
- *
- * @category array
- * @borrows [SO comment by `CertainPerformance`](https://stackoverflow.com/a/60132060/1938970)
- *
- * @usage
- * ```ts
- * 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 const arrayOfAll = ()=>(array)=>array;
-export default arrayOfAll;