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

package/cjs/toNumber.d.ts

@@ -0,0 +1,2 @@
+export declare function toNumber(input?: string | number, fallback?: number): number;
+export default toNumber;

package/cjs/toNumber.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toNumber = void 0;
+var isNumber_1 = require("./isNumber");
+function toNumber(input, fallback) {
+    return (0, isNumber_1.isNumber)(input) ? input : input ? parseFloat(input) : fallback || 0;
+}
+exports.toNumber = toNumber;
+exports.default = toNumber;

package/cjs/toRgba.d.ts

@@ -0,0 +1,2 @@
+export declare function toRgba(hex: string, alpha?: number): string;
+export default toRgba;

package/cjs/toRgba.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toRgba = void 0;
+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 "";
+}
+exports.toRgba = toRgba;
+exports.default = toRgba;

package/cjs/transformToUrlPathname.d.ts

@@ -0,0 +1,2 @@
+export declare function transformToUrlPathname(toPathname?: string): string;
+export default transformToUrlPathname;

package/cjs/transformToUrlPathname.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformToUrlPathname = void 0;
+var isString_1 = require("./isString");
+function transformToUrlPathname(toPathname) {
+    return (0, isString_1.default)(toPathname)
+        ? "/".concat(encodeURIComponent(toPathname.replace(/\s/g, "-").toLowerCase()))
+        : "";
+}
+exports.transformToUrlPathname = transformToUrlPathname;
+exports.default = transformToUrlPathname;

package/cjs/truncate.d.ts

@@ -0,0 +1,2 @@
+export declare const truncate: (input: undefined | null | string, length: number) => string;
+export default truncate;

package/cjs/truncate.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.truncate = void 0;
+var truncate = function (input, length) {
+    return input
+        ? input.length > length
+            ? input.substring(0, length) + "..."
+            : input
+        : "";
+};
+exports.truncate = truncate;
+exports.default = exports.truncate;

package/cjs/tryUntil.d.ts

@@ -0,0 +1,2 @@
+export declare const tryUntil: (test: () => boolean, timeout: number, interval: number, resolve: () => void, reject?: () => void) => void;
+export default tryUntil;

package/cjs/tryUntil.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tryUntil = void 0;
+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);
+};
+exports.tryUntil = tryUntil;
+exports.default = exports.tryUntil;

package/cjs/types.d.ts

@@ -0,0 +1,10 @@
+import type { Replace } from "type-fest";
+export type AnythingFalsy = null | undefined | 0 | "";
+export type PickStartsWith<T extends object, S extends string> = {
+    [K in keyof T as K extends `${S}${string}` ? K : never]: T[K];
+};
+export type KeysStartsWith<T extends object, S extends string> = keyof PickStartsWith<T, S>;
+export type PickStartsWithTails<T extends object, S extends string> = {
+    [K in keyof T as K extends `${S}${string}` ? Replace<K, S, ""> : never]: T[K];
+};
+export type KeysTailsStartsWith<T extends object, S extends string> = keyof PickStartsWithTails<T, S>;

package/cjs/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/uid.d.ts

@@ -0,0 +1,2 @@
+export declare const uid: (prefix?: string) => string;
+export default uid;

package/cjs/uid.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uid = void 0;
+var lastId = 0;
+var uid = function (prefix) {
+    if (prefix === void 0) { prefix = "id"; }
+    lastId++;
+    return "".concat(prefix, "-").concat(lastId);
+};
+exports.uid = uid;
+exports.default = exports.uid;

package/cjs/updateLinkParams.d.ts

@@ -0,0 +1,3 @@
+import { type AnyQueryParams } from "./location";
+export declare function updateLinkParams($anchor: HTMLAnchorElement, newParams: NonNullable<AnyQueryParams>): string;
+export default updateLinkParams;

package/cjs/updateLinkParams.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateLinkParams = void 0;
+var updateUrlQueryParams_1 = require("./updateUrlQueryParams");
+function updateLinkParams($anchor, newParams) {
+    var href = (0, updateUrlQueryParams_1.default)($anchor.href, newParams);
+    $anchor.href = href;
+    return href;
+}
+exports.updateLinkParams = updateLinkParams;
+exports.default = updateLinkParams;

package/cjs/updateUrlQueryParams.d.ts

@@ -0,0 +1,3 @@
+import { type AnyQueryParams } from "./location";
+export declare function updateUrlQueryParams(url: string, newParams?: NonNullable<AnyQueryParams>): string;
+export default updateUrlQueryParams;

package/cjs/updateUrlQueryParams.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateUrlQueryParams = void 0;
+var buildUrlQueryString_1 = require("./buildUrlQueryString");
+var getUrlQueryParams_1 = require("./getUrlQueryParams");
+var mergeUrlQueryParams_1 = require("./mergeUrlQueryParams");
+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)
+        : newParams;
+    return parts[0] + (0, buildUrlQueryString_1.default)(allParams);
+}
+exports.updateUrlQueryParams = updateUrlQueryParams;
+exports.default = updateUrlQueryParams;

package/cjs/uppercase.d.ts

@@ -0,0 +1,2 @@
+export declare const uppercase: <T extends string>(str?: T | null | undefined) => Uppercase<T>;
+export default uppercase;

package/cjs/uppercase.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uppercase = void 0;
+var uppercase = function (str) {
+    return (str || "").toUpperCase();
+};
+exports.uppercase = uppercase;
+exports.default = exports.uppercase;

package/cjs/uuid.d.ts

@@ -0,0 +1,2 @@
+export declare const uuid: () => string;
+export default uuid;

package/{uuid.mjs → cjs/uuid.js}

@@ -1,13 +1,11 @@
-/**
- * Uuid, tiny custom helper instead of node's uuid/v4
- *
- * @category uid
- * @see https://stackoverflow.com/a/2117523/1938970
- */
-export var uuid = function () {
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uuid = void 0;
+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;
+exports.uuid = uuid;
+exports.default = exports.uuid;

package/cjs/uuidNumeric.d.ts

@@ -0,0 +1,2 @@
+export declare const uuidNumeric: () => number;
+export default uuidNumeric;

package/cjs/uuidNumeric.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uuidNumeric = void 0;
+var uuidNumeric = function () { return new Date().valueOf(); };
+exports.uuidNumeric = uuidNumeric;
+exports.default = exports.uuidNumeric;

package/cjs/wait.d.ts

@@ -0,0 +1,2 @@
+export declare const wait: (milliseconds: number) => Promise<unknown>;
+export default wait;

package/cjs/wait.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wait = void 0;
+var wait = function (milliseconds) {
+    return new Promise(function (resolve) { return setTimeout(resolve, milliseconds); });
+};
+exports.wait = wait;
+exports.default = exports.wait;

package/cjs/without.js

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

package/clamp.d.ts

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

package/clamp.js

@@ -1,14 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.clamp = void 0;
-/**
- * Returns a number whose value is limited to the given range.
- *
- * @category math
- * @see https://stackoverflow.com/a/11409944/1938970
- */
-function clamp(num, min, max) {
+export function clamp(num, min, max) {
     return Math.min(Math.max(num, min), max);
 }
-exports.clamp = clamp;
-exports.default = clamp;
+export default clamp;

package/clsx.d.ts

@@ -1,9 +1,6 @@
-import type { ClassValue } from "clsx";
-/**
- * Class names utility
- *
- * @borrows [lukeed/clsx](https://github.com/lukeed/clsx)
- * @license [MIT: Luke Edwards](https://github.com/lukeed/clsx/blob/master/license)
- */
+type ClassValue = ClassArray | ClassDictionary | string | number | null | boolean | undefined;
+type ClassDictionary = Record<string, any>;
+type ClassArray = ClassValue[];
+export type ClsxClassValue = ClassValue;
 export declare const clsx: (...args: ClassValue[]) => string;
 export default clsx;

package/clsx.js

@@ -1,8 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.clsx = void 0;
-// import _clsx from "clsx";
-// export const clsx = _clsx;
 function toVal(mix) {
     var k, y, str = "";
     if (typeof mix === "string" || typeof mix === "number") {
@@ -30,16 +25,9 @@ function toVal(mix) {
     }
     return str;
 }
-/**
- * Class names utility
- *
- * @borrows [lukeed/clsx](https://github.com/lukeed/clsx)
- * @license [MIT: Luke Edwards](https://github.com/lukeed/clsx/blob/master/license)
- */
-var clsx = function () {
+export var clsx = function () {
     var i = 0, tmp, x, str = "";
     while (i < arguments.length) {
-        // eslint-disable-next-line prefer-rest-params
         if ((tmp = arguments[i++])) {
             if ((x = toVal(tmp))) {
                 str && (str += " ");
@@ -49,5 +37,4 @@ var clsx = function () {
     }
     return str;
 };
-exports.clsx = clsx;
-exports.default = exports.clsx;
+export default clsx;

package/convertRange.d.ts

@@ -1,14 +1,2 @@
-/**
- * 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 declare function convertRange(num: number, r1: number[], r2: number[]): number;
 export default convertRange;

package/convertRange.js

@@ -1,20 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertRange = void 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
- */
-function convertRange(num, r1, r2) {
+export function convertRange(num, r1, r2) {
     return ((num - r1[0]) * (r2[1] - r2[0])) / (r1[1] - r1[0]) + r2[0];
 }
-exports.convertRange = convertRange;
-exports.default = convertRange;
+export default convertRange;

package/cookie.d.ts

@@ -1,44 +1,8 @@
-/**
- * @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)
- */
 type CookieAttributes = {
-    /**
-     * Define when the cookie will be removed. Value can be a Number
-     * which will be interpreted as days from time of creation or a
-     * Date instance. If omitted, the cookie becomes a session cookie.
-     */
     expires?: number | Date | undefined;
-    /**
-     * Define the path where the cookie is available. Defaults to '/'
-     *
-     * @default "/"
-     */
     path?: string | undefined;
-    /**
-     * Define the domain where the cookie is available. Defaults to
-     * the domain of the page where the cookie was created.
-     */
     domain?: string | undefined;
-    /**
-     * A Boolean indicating if the cookie transmission requires a
-     * secure protocol (https).
-     *
-     * @default "true"
-     */
     secure?: boolean | undefined;
-    /**
-     * Asserts that a cookie must not be sent with cross-origin requests,
-     * providing some protection against cross-site request forgery
-     * attacks (CSRF)
-     *
-     * @default "strict"
-     */
     sameSite?: "strict" | "Strict" | "lax" | "Lax" | "none" | "None" | undefined;
 };
 export type CookieAttributesServer = CookieAttributes & {

package/cookie.js

@@ -1,13 +1 @@
-"use strict";
-/**
- * @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)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultAttributesClient = void 0;
-exports.defaultAttributesClient = { path: "/" };
+export var defaultAttributesClient = { path: "/" };

package/createPalette.d.ts

@@ -6,15 +6,5 @@ type PaletteMapPair<T extends PaletteShade> = {
 type PaletteMap<T extends PaletteShades> = {
     [PS in T[number] as keyof PaletteMapPair<PS>]: PaletteMapPair<PS>[keyof PaletteMapPair<PS>];
 };
-/**
- * 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 declare const createPalette: <TName extends string, TShades extends PaletteShades, TColor = TShades[number][1], TMap = PaletteMap<TShades>>(name: TName, shades: TShades) => readonly [TMap, Record<`${TName}-${TShades[number][0]}`, string>, TColor[]];
 export default createPalette;

package/createPalette.js

@@ -1,17 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createPalette = void 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)
- */
-var createPalette = function (name, shades) {
+export var createPalette = function (name, shades) {
     var map = shades.reduce(function (map, def) {
         map[def[0]] = def[1];
         return map;
@@ -22,5 +9,4 @@ var createPalette = function (name, shades) {
     }, {});
     return [map, tailwindPalette, Object.values(map)];
 };
-exports.createPalette = createPalette;
-exports.default = exports.createPalette;
+export default createPalette;

package/debounce.d.ts

@@ -1,8 +1,2 @@
-/**
- * Debounce function (with `setTimeout`)
- *
- * @category function
- * @borrows [davidwalsh/debounce](https://davidwalsh.name/javascript-debounce-function)
- */
 export declare function debounce<T extends (...args: any[]) => any>(fn: T, wait?: number, immediate?: boolean): (this: unknown, ...args: Parameters<T>) => void;
 export default debounce;

package/debounce.js

@@ -1,20 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.debounce = void 0;
-/**
- * Debounce function (with `setTimeout`)
- *
- * @category function
- * @borrows [davidwalsh/debounce](https://davidwalsh.name/javascript-debounce-function)
- */
-function debounce(fn, wait, immediate) {
+export function debounce(fn, wait, immediate) {
     var timeout;
     return function () {
         var args = [];
         for (var _i = 0; _i < arguments.length; _i++) {
             args[_i] = arguments[_i];
         }
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
         var context = this;
         var later = function () {
             timeout = null;
@@ -29,5 +19,4 @@ function debounce(fn, wait, immediate) {
             fn.apply(context, args);
     };
 }
-exports.debounce = debounce;
-exports.default = debounce;
+export default debounce;

package/debouncePromise.d.ts

@@ -1,11 +1,11 @@
-import { debounce as tsDebounce } from "ts-debounce";
-export { type Options as DebounceOptions } from "ts-debounce";
-export { type DebouncedFunction } from "ts-debounce";
-/**
- * Debounce function (with `Promise`)
- *
- * @category function
- * @borrows [chodorowicz/ts-debounce](https://github.com/chodorowicz/ts-debounce)
- */
-export declare const debouncePromise: typeof tsDebounce;
+export type DebounceOptions<Result> = {
+    isImmediate?: boolean;
+    maxWait?: number;
+    callback?: (data: Result) => void;
+};
+export interface DebouncedFunction<Args extends any[], F extends (...args: Args) => any> {
+    (this: ThisParameterType<F>, ...args: Args & Parameters<F>): Promise<ReturnType<F>>;
+    cancel: (reason?: any) => void;
+}
+export declare function debouncePromise<Args extends any[], F extends (...args: Args) => any>(func: F, waitMilliseconds?: number, options?: DebounceOptions<ReturnType<F>>): DebouncedFunction<Args, F>;
 export default debouncePromise;

package/debouncePromise.js

@@ -1,12 +1,65 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.debouncePromise = void 0;
-var ts_debounce_1 = require("ts-debounce");
-/**
- * Debounce function (with `Promise`)
- *
- * @category function
- * @borrows [chodorowicz/ts-debounce](https://github.com/chodorowicz/ts-debounce)
- */
-exports.debouncePromise = ts_debounce_1.debounce;
-exports.default = exports.debouncePromise;
+export function debouncePromise(func, waitMilliseconds, options) {
+    var _a, _b;
+    if (waitMilliseconds === void 0) { waitMilliseconds = 50; }
+    if (options === void 0) { options = {}; }
+    var timeoutId;
+    var isImmediate = (_a = options.isImmediate) !== null && _a !== void 0 ? _a : false;
+    var callback = (_b = options.callback) !== null && _b !== void 0 ? _b : false;
+    var maxWait = options.maxWait;
+    var lastInvokeTime = Date.now();
+    var promises = [];
+    function nextInvokeTimeout() {
+        if (maxWait !== undefined) {
+            var timeSinceLastInvocation = Date.now() - lastInvokeTime;
+            if (timeSinceLastInvocation + waitMilliseconds >= maxWait) {
+                return maxWait - timeSinceLastInvocation;
+            }
+        }
+        return waitMilliseconds;
+    }
+    var debouncedFunction = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        var context = this;
+        return new Promise(function (resolve, reject) {
+            var invokeFunction = function () {
+                timeoutId = undefined;
+                lastInvokeTime = Date.now();
+                if (!isImmediate) {
+                    var result_1 = func.apply(context, args);
+                    callback && callback(result_1);
+                    promises.forEach(function (_a) {
+                        var resolve = _a.resolve;
+                        return resolve(result_1);
+                    });
+                    promises = [];
+                }
+            };
+            var shouldCallNow = isImmediate && timeoutId === undefined;
+            if (timeoutId !== undefined) {
+                clearTimeout(timeoutId);
+            }
+            timeoutId = setTimeout(invokeFunction, nextInvokeTimeout());
+            if (shouldCallNow) {
+                var result = func.apply(context, args);
+                callback && callback(result);
+                return resolve(result);
+            }
+            promises.push({ resolve: resolve, reject: reject });
+        });
+    };
+    debouncedFunction.cancel = function (reason) {
+        if (timeoutId !== undefined) {
+            clearTimeout(timeoutId);
+        }
+        promises.forEach(function (_a) {
+            var reject = _a.reject;
+            return reject(reason);
+        });
+        promises = [];
+    };
+    return debouncedFunction;
+}
+export default debouncePromise;

package/debounceRaf.d.ts

@@ -1,9 +1,2 @@
-/**
- * Debounce function (with `requestAnimationFrame`)
- *
- * (c) 2021 Chris Ferdinandi, MIT License, https://gomakethings.com
- * @category function
- * @borrows [vanillajstoolkit/debounce](https://vanillajstoolkit.com/helpers/debounce/)
- */
 export declare function debounceRaf<T extends (...args: any[]) => any>(this: unknown, fn: T): (this: unknown, ...args: Parameters<T>) => void;
 export default debounceRaf;

package/debounceRaf.js

@@ -1,31 +1,17 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.debounceRaf = void 0;
-/**
- * Debounce function (with `requestAnimationFrame`)
- *
- * (c) 2021 Chris Ferdinandi, MIT License, https://gomakethings.com
- * @category function
- * @borrows [vanillajstoolkit/debounce](https://vanillajstoolkit.com/helpers/debounce/)
- */
-function debounceRaf(fn) {
+export function debounceRaf(fn) {
     var timeout;
     return function () {
         var args = [];
         for (var _i = 0; _i < arguments.length; _i++) {
             args[_i] = arguments[_i];
         }
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
         var context = this;
-        // If there's a timer, cancel it
         if (timeout) {
             window.cancelAnimationFrame(timeout);
         }
-        // Setup the new requestAnimationFrame()
         timeout = window.requestAnimationFrame(function () {
             fn.apply(context, args);
         });
     };
 }
-exports.debounceRaf = debounceRaf;
-exports.default = debounceRaf;
+export default debounceRaf;