@develia/commons 0.4.24 → 0.4.26

package/dist/cjs/functions.js

@@ -1,262 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.identity = identity;
-exports.constant = constant;
-exports.noop = noop;
-exports.once = once;
-exports.memoize = memoize;
-exports.throttle = throttle;
-exports.partial = partial;
-exports.pipe = pipe;
-exports.compose = compose;
-/**
- * Return the received value unchanged.
- * Useful as a default mapper, placeholder callback, or neutral transform in a pipeline.
- *
- * @example
- * ```ts
- * identity(5); // 5
- *
- * const value = {name: "commons"};
- * identity(value) === value; // true
- * ```
- */
-function identity(value) {
-    return value;
-}
-/**
- * Create a function that always returns the same value.
- *
- * @example
- * ```ts
- * const getAnswer = constant(42);
- *
- * getAnswer(); // 42
- * getAnswer(); // 42
- * ```
- */
-function constant(value) {
-    return () => value;
-}
-/**
- * Do nothing and return undefined.
- * Useful as a safe default callback.
- *
- * @example
- * ```ts
- * const onComplete = options.onComplete ?? noop;
- * onComplete();
- * ```
- */
-function noop() {
-    // Intentionally empty.
-}
-/**
- * Create a function that can be executed only once.
- * Later calls return the result from the first execution without calling the original function again.
- *
- * @example
- * ```ts
- * const initialize = once(() => ({connected: true}));
- *
- * const first = initialize();
- * const second = initialize();
- * first === second; // true
- * ```
- */
-function once(fn) {
-    let called = false;
-    let result;
-    return function (...args) {
-        if (!called) {
-            called = true;
-            result = fn.apply(this, args);
-        }
-        return result;
-    };
-}
-/**
- * Cache the result of a function and reuse it for calls with the same resolved key.
- * By default, the first argument is used as the cache key.
- *
- * @example
- * ```ts
- * const double = memoize((value: number) => value * 2);
- *
- * double(4); // 8, computed
- * double(4); // 8, read from cache
- * double.has(4); // true
- * ```
- *
- * @example
- * ```ts
- * const sum = memoize(
- *     (left: number, right: number) => left + right,
- *     (left, right) => `${left}:${right}`,
- * );
- *
- * sum(2, 3); // 5
- * sum.delete(2, 3); // true
- * sum.clear();
- * ```
- */
-function memoize(fn, resolver, cache = new Map()) {
-    const resolveKey = (...args) => {
-        if (resolver)
-            return resolver(...args);
-        return args[0];
-    };
-    const memoized = function (...args) {
-        const key = resolveKey(...args);
-        if (cache.has(key)) {
-            return cache.get(key);
-        }
-        const value = fn.apply(this, args);
-        cache.set(key, value);
-        return value;
-    };
-    Object.defineProperty(memoized, "cache", {
-        value: cache,
-        enumerable: false,
-    });
-    memoized.clear = () => cache.clear();
-    memoized.delete = (...args) => cache.delete(resolveKey(...args));
-    memoized.has = (...args) => cache.has(resolveKey(...args));
-    return memoized;
-}
-/**
- * Limit how often a function can run during a time window.
- * Calls made while the function is throttled can optionally be replayed once at the end with the latest arguments.
- *
- * @example
- * ```ts
- * const onScroll = throttle(() => {
- *     console.log(window.scrollY);
- * }, 100);
- *
- * window.addEventListener("scroll", onScroll);
- * ```
- *
- * @example
- * ```ts
- * const refresh = throttle(loadData, 500, {leading: false});
- *
- * refresh(); // scheduled instead of executed immediately
- * refresh.flush(); // execute the scheduled call now
- * ```
- */
-function throttle(fn, wait, options = {}) {
-    const delay = normalizeDelay(wait);
-    const leading = options.leading ?? true;
-    const trailing = options.trailing ?? true;
-    let timer;
-    let lastArgs;
-    let lastThis;
-    let lastInvokeTime = 0;
-    let hasInvoked = false;
-    let result;
-    const invoke = (time) => {
-        const args = lastArgs;
-        const context = lastThis;
-        lastArgs = undefined;
-        lastThis = undefined;
-        hasInvoked = true;
-        lastInvokeTime = time;
-        result = fn.apply(context, args);
-        return result;
-    };
-    const expire = () => {
-        timer = undefined;
-        if (trailing && lastArgs) {
-            invoke(Date.now());
-        }
-        else {
-            lastArgs = undefined;
-            lastThis = undefined;
-        }
-    };
-    const throttled = function (...args) {
-        const now = Date.now();
-        lastArgs = args;
-        lastThis = this;
-        if (!hasInvoked) {
-            if (leading) {
-                return invoke(now);
-            }
-            hasInvoked = true;
-            lastInvokeTime = now;
-        }
-        const remaining = delay - (now - lastInvokeTime);
-        if (remaining <= 0 || remaining > delay) {
-            if (timer !== undefined) {
-                clearTimeout(timer);
-                timer = undefined;
-            }
-            return invoke(now);
-        }
-        if (timer === undefined && trailing) {
-            timer = setTimeout(expire, remaining);
-        }
-        return result;
-    };
-    throttled.cancel = () => {
-        if (timer !== undefined) {
-            clearTimeout(timer);
-        }
-        timer = undefined;
-        lastArgs = undefined;
-        lastThis = undefined;
-        lastInvokeTime = 0;
-        hasInvoked = false;
-    };
-    throttled.flush = () => {
-        if (timer !== undefined) {
-            clearTimeout(timer);
-            timer = undefined;
-            if (lastArgs && trailing) {
-                return invoke(Date.now());
-            }
-        }
-        return result;
-    };
-    throttled.pending = () => timer !== undefined;
-    return throttled;
-}
-/**
- * Create a function with one or more arguments already provided.
- * Later arguments are appended after the preset arguments.
- *
- * @example
- * ```ts
- * const sum = (a: number, b: number, c: number) => a + b + c;
- * const addFive = partial(sum, 2, 3);
- *
- * addFive(4); // 9
- * ```
- */
-function partial(fn, ...presetArgs) {
-    return function (...laterArgs) {
-        return fn.apply(this, [...presetArgs, ...laterArgs]);
-    };
-}
-function pipe(...fns) {
-    return createFlow(fns);
-}
-function compose(...fns) {
-    return createFlow(fns.slice().reverse());
-}
-function createFlow(fns) {
-    if (fns.length === 0)
-        return identity;
-    return function (...args) {
-        let result = fns[0].apply(this, args);
-        for (let i = 1; i < fns.length; i++) {
-            result = fns[i].call(this, result);
-        }
-        return result;
-    };
-}
-function normalizeDelay(wait) {
-    return Number.isFinite(wait) ? Math.max(0, wait) : 0;
-}
-//# sourceMappingURL=functions.js.map

package/dist/cjs/functions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../src/functions.ts"],"names":[],"mappings":"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","sourcesContent":["type AnyFunction = (this: any, ...args: any[]) => any;\ntype TimerHandle = ReturnType<typeof setTimeout>;\n\n/** Options that control when a throttled function is executed. */\nexport interface ThrottleOptions {\n    /** Execute immediately on the first call in a throttle window. Defaults to true. */\n    leading?: boolean;\n    /** Execute once more at the end of the throttle window using the latest arguments. Defaults to true. */\n    trailing?: boolean;\n}\n\n/**\n * A delayed function returned by {@link throttle}.\n *\n * @example\n * ```ts\n * const refresh = throttle(loadData, 250);\n * refresh();\n *\n * if (refresh.pending()) {\n *     refresh.flush();\n * }\n * ```\n */\nexport type DeferredFunction<F extends AnyFunction> = ((\n    this: ThisParameterType<F>,\n    ...args: Parameters<F>\n) => ReturnType<F> | undefined) & {\n    /** Cancel the scheduled call and forget the latest arguments. */\n    cancel(): void;\n    /** Execute the scheduled trailing call immediately, when one exists. */\n    flush(): ReturnType<F> | undefined;\n    /** Return true while a trailing call is scheduled. */\n    pending(): boolean;\n};\n\n/**\n * A memoized function with helpers for inspecting and invalidating its cache.\n *\n * @example\n * ```ts\n * const getUser = memoize((id: string) => fetchUser(id));\n *\n * getUser(\"42\");\n * getUser.has(\"42\"); // true\n * getUser.delete(\"42\");\n * ```\n */\nexport type MemoizedFunction<F extends AnyFunction, K> = ((\n    this: ThisParameterType<F>,\n    ...args: Parameters<F>\n) => ReturnType<F>) & {\n    /** The backing cache used by the memoized function. */\n    readonly cache: Map<K, ReturnType<F>>;\n    /** Remove every cached value. */\n    clear(): void;\n    /** Remove the cached value for the key resolved from the provided arguments. */\n    delete(...args: Parameters<F>): boolean;\n    /** Return true when a cached value exists for the key resolved from the provided arguments. */\n    has(...args: Parameters<F>): boolean;\n};\n\ntype Unary<T, R> = (arg: T) => R;\n\n/**\n * Return the received value unchanged.\n * Useful as a default mapper, placeholder callback, or neutral transform in a pipeline.\n *\n * @example\n * ```ts\n * identity(5); // 5\n *\n * const value = {name: \"commons\"};\n * identity(value) === value; // true\n * ```\n */\nexport function identity<T>(value: T): T {\n    return value;\n}\n\n/**\n * Create a function that always returns the same value.\n *\n * @example\n * ```ts\n * const getAnswer = constant(42);\n *\n * getAnswer(); // 42\n * getAnswer(); // 42\n * ```\n */\nexport function constant<T>(value: T): () => T {\n    return () => value;\n}\n\n/**\n * Do nothing and return undefined.\n * Useful as a safe default callback.\n *\n * @example\n * ```ts\n * const onComplete = options.onComplete ?? noop;\n * onComplete();\n * ```\n */\nexport function noop(): void {\n    // Intentionally empty.\n}\n\n/**\n * Create a function that can be executed only once.\n * Later calls return the result from the first execution without calling the original function again.\n *\n * @example\n * ```ts\n * const initialize = once(() => ({connected: true}));\n *\n * const first = initialize();\n * const second = initialize();\n * first === second; // true\n * ```\n */\nexport function once<F extends AnyFunction>(fn: F): F {\n    let called = false;\n    let result: ReturnType<F>;\n\n    return function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> {\n        if (!called) {\n            called = true;\n            result = fn.apply(this, args);\n        }\n        return result;\n    } as F;\n}\n\n/**\n * Cache the result of a function and reuse it for calls with the same resolved key.\n * By default, the first argument is used as the cache key.\n *\n * @example\n * ```ts\n * const double = memoize((value: number) => value * 2);\n *\n * double(4); // 8, computed\n * double(4); // 8, read from cache\n * double.has(4); // true\n * ```\n *\n * @example\n * ```ts\n * const sum = memoize(\n *     (left: number, right: number) => left + right,\n *     (left, right) => `${left}:${right}`,\n * );\n *\n * sum(2, 3); // 5\n * sum.delete(2, 3); // true\n * sum.clear();\n * ```\n */\nexport function memoize<F extends AnyFunction, K = Parameters<F>[0]>(\n    fn: F,\n    resolver?: (...args: Parameters<F>) => K,\n    cache: Map<K, ReturnType<F>> = new Map<K, ReturnType<F>>()\n): MemoizedFunction<F, K> {\n    const resolveKey = (...args: Parameters<F>): K => {\n        if (resolver) return resolver(...args);\n        return args[0] as K;\n    };\n\n    const memoized = function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> {\n        const key = resolveKey(...args);\n        if (cache.has(key)) {\n            return cache.get(key)!;\n        }\n\n        const value = fn.apply(this, args);\n        cache.set(key, value);\n        return value;\n    } as MemoizedFunction<F, K>;\n\n    Object.defineProperty(memoized, \"cache\", {\n        value: cache,\n        enumerable: false,\n    });\n\n    memoized.clear = () => cache.clear();\n    memoized.delete = (...args: Parameters<F>) => cache.delete(resolveKey(...args));\n    memoized.has = (...args: Parameters<F>) => cache.has(resolveKey(...args));\n\n    return memoized;\n}\n\n/**\n * Limit how often a function can run during a time window.\n * Calls made while the function is throttled can optionally be replayed once at the end with the latest arguments.\n *\n * @example\n * ```ts\n * const onScroll = throttle(() => {\n *     console.log(window.scrollY);\n * }, 100);\n *\n * window.addEventListener(\"scroll\", onScroll);\n * ```\n *\n * @example\n * ```ts\n * const refresh = throttle(loadData, 500, {leading: false});\n *\n * refresh(); // scheduled instead of executed immediately\n * refresh.flush(); // execute the scheduled call now\n * ```\n */\nexport function throttle<F extends AnyFunction>(\n    fn: F,\n    wait: number,\n    options: ThrottleOptions = {}\n): DeferredFunction<F> {\n    const delay = normalizeDelay(wait);\n    const leading = options.leading ?? true;\n    const trailing = options.trailing ?? true;\n\n    let timer: TimerHandle | undefined;\n    let lastArgs: Parameters<F> | undefined;\n    let lastThis: ThisParameterType<F> | undefined;\n    let lastInvokeTime = 0;\n    let hasInvoked = false;\n    let result: ReturnType<F> | undefined;\n\n    const invoke = (time: number): ReturnType<F> => {\n        const args = lastArgs!;\n        const context = lastThis!;\n        lastArgs = undefined;\n        lastThis = undefined;\n        hasInvoked = true;\n        lastInvokeTime = time;\n        result = fn.apply(context, args);\n        return result as ReturnType<F>;\n    };\n\n    const expire = (): void => {\n        timer = undefined;\n        if (trailing && lastArgs) {\n            invoke(Date.now());\n        } else {\n            lastArgs = undefined;\n            lastThis = undefined;\n        }\n    };\n\n    const throttled = function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> | undefined {\n        const now = Date.now();\n        lastArgs = args;\n        lastThis = this;\n\n        if (!hasInvoked) {\n            if (leading) {\n                return invoke(now);\n            }\n            hasInvoked = true;\n            lastInvokeTime = now;\n        }\n\n        const remaining = delay - (now - lastInvokeTime);\n        if (remaining <= 0 || remaining > delay) {\n            if (timer !== undefined) {\n                clearTimeout(timer);\n                timer = undefined;\n            }\n            return invoke(now);\n        }\n\n        if (timer === undefined && trailing) {\n            timer = setTimeout(expire, remaining);\n        }\n\n        return result;\n    } as DeferredFunction<F>;\n\n    throttled.cancel = (): void => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n        }\n        timer = undefined;\n        lastArgs = undefined;\n        lastThis = undefined;\n        lastInvokeTime = 0;\n        hasInvoked = false;\n    };\n\n    throttled.flush = (): ReturnType<F> | undefined => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n            timer = undefined;\n            if (lastArgs && trailing) {\n                return invoke(Date.now());\n            }\n        }\n        return result;\n    };\n\n    throttled.pending = (): boolean => timer !== undefined;\n\n    return throttled;\n}\n\n/**\n * Create a function with one or more arguments already provided.\n * Later arguments are appended after the preset arguments.\n *\n * @example\n * ```ts\n * const sum = (a: number, b: number, c: number) => a + b + c;\n * const addFive = partial(sum, 2, 3);\n *\n * addFive(4); // 9\n * ```\n */\nexport function partial<F extends AnyFunction>(\n    fn: F,\n    ...presetArgs: unknown[]\n): (...laterArgs: unknown[]) => ReturnType<F> {\n    return function (this: ThisParameterType<F>, ...laterArgs: unknown[]): ReturnType<F> {\n        return fn.apply(this, [...presetArgs, ...laterArgs] as Parameters<F>);\n    };\n}\n\n/**\n * Compose unary functions from left to right.\n * The first function receives the original arguments, and each next function receives the previous result.\n *\n * @example\n * ```ts\n * const transform = pipe(\n *     (value: number) => value + 1,\n *     (value: number) => value * 2,\n * );\n *\n * transform(2); // 6\n * ```\n */\nexport function pipe<A, B>(ab: Unary<A, B>): Unary<A, B>;\nexport function pipe<A, B, C>(ab: Unary<A, B>, bc: Unary<B, C>): Unary<A, C>;\nexport function pipe<A, B, C, D>(ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>): Unary<A, D>;\nexport function pipe<A, B, C, D, E>(ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>): Unary<A, E>;\nexport function pipe(...fns: AnyFunction[]): AnyFunction {\n    return createFlow(fns);\n}\n\n/**\n * Compose unary functions from right to left.\n * The rightmost function receives the original arguments, and each function to its left receives the previous result.\n *\n * @example\n * ```ts\n * const transform = compose(\n *     (value: number) => value + 1,\n *     (value: number) => value * 2,\n * );\n *\n * transform(2); // 5\n * ```\n */\nexport function compose<A, B>(ab: Unary<A, B>): Unary<A, B>;\nexport function compose<A, B, C>(bc: Unary<B, C>, ab: Unary<A, B>): Unary<A, C>;\nexport function compose<A, B, C, D>(cd: Unary<C, D>, bc: Unary<B, C>, ab: Unary<A, B>): Unary<A, D>;\nexport function compose<A, B, C, D, E>(de: Unary<D, E>, cd: Unary<C, D>, bc: Unary<B, C>, ab: Unary<A, B>): Unary<A, E>;\nexport function compose(...fns: AnyFunction[]): AnyFunction {\n    return createFlow(fns.slice().reverse());\n}\n\nfunction createFlow(fns: AnyFunction[]): AnyFunction {\n    if (fns.length === 0) return identity;\n\n    return function (this: any, ...args: any[]): unknown {\n        let result = fns[0].apply(this, args);\n        for (let i = 1; i < fns.length; i++) {\n            result = fns[i].call(this, result);\n        }\n        return result;\n    };\n}\n\nfunction normalizeDelay(wait: number): number {\n    return Number.isFinite(wait) ? Math.max(0, wait) : 0;\n}"]}

package/dist/cjs/index.js

@@ -1,84 +0,0 @@
-"use strict";
-// src/index.ts
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formToObject = exports.submitForm = exports.ajaxSubmission = exports.ajaxSubmit = exports.CleanURLSearchParams = exports.draft = exports.Range = exports.Event = exports.EventBus = exports.from = exports.Lazy = exports.KeyedDebouncer = exports.Debouncer = exports.AsyncPoolExecutor = exports.CountTrigger = exports.TimeTrigger = exports.Stopwatch = exports.TimeSpan = exports.Timer = exports.Order = exports.KeyValuePair = exports.CancellablePromise = exports.TypeCode = exports.Type = void 0;
-// ─── Types ───────────────────────────────────────────
-__exportStar(require("./types.js"), exports);
-var type_js_1 = require("./type.js");
-Object.defineProperty(exports, "Type", { enumerable: true, get: function () { return __importDefault(type_js_1).default; } });
-var type_code_js_1 = require("./type-code.js");
-Object.defineProperty(exports, "TypeCode", { enumerable: true, get: function () { return __importDefault(type_code_js_1).default; } });
-// ─── Utilities ───────────────────────────────────────
-__exportStar(require("./utilities.js"), exports);
-__exportStar(require("./functions.js"), exports);
-__exportStar(require("./string.js"), exports);
-__exportStar(require("./math.js"), exports);
-__exportStar(require("./parse.js"), exports);
-var cancellable_promise_js_1 = require("./cancellable-promise.js");
-Object.defineProperty(exports, "CancellablePromise", { enumerable: true, get: function () { return __importDefault(cancellable_promise_js_1).default; } });
-// ─── Data Structures ────────────────────────────────
-var key_value_pair_js_1 = require("./key-value-pair.js");
-Object.defineProperty(exports, "KeyValuePair", { enumerable: true, get: function () { return __importDefault(key_value_pair_js_1).default; } });
-var order_js_1 = require("./order.js");
-Object.defineProperty(exports, "Order", { enumerable: true, get: function () { return __importDefault(order_js_1).default; } });
-// ─── Async & Timing ─────────────────────────────────
-var timer_js_1 = require("./timer.js");
-Object.defineProperty(exports, "Timer", { enumerable: true, get: function () { return __importDefault(timer_js_1).default; } });
-var timespan_js_1 = require("./timespan.js");
-Object.defineProperty(exports, "TimeSpan", { enumerable: true, get: function () { return __importDefault(timespan_js_1).default; } });
-var stopwatch_js_1 = require("./stopwatch.js");
-Object.defineProperty(exports, "Stopwatch", { enumerable: true, get: function () { return __importDefault(stopwatch_js_1).default; } });
-var triggers_js_1 = require("./triggers.js");
-Object.defineProperty(exports, "TimeTrigger", { enumerable: true, get: function () { return triggers_js_1.TimeTrigger; } });
-Object.defineProperty(exports, "CountTrigger", { enumerable: true, get: function () { return triggers_js_1.CountTrigger; } });
-var async_pool_executor_js_1 = require("./async-pool-executor.js");
-Object.defineProperty(exports, "AsyncPoolExecutor", { enumerable: true, get: function () { return __importDefault(async_pool_executor_js_1).default; } });
-var debouncer_js_1 = require("./debouncer.js");
-Object.defineProperty(exports, "Debouncer", { enumerable: true, get: function () { return __importDefault(debouncer_js_1).default; } });
-var keyed_debouncer_js_1 = require("./keyed-debouncer.js");
-Object.defineProperty(exports, "KeyedDebouncer", { enumerable: true, get: function () { return __importDefault(keyed_debouncer_js_1).default; } });
-// ─── Patterns ────────────────────────────────────────
-var lazy_js_1 = require("./lazy.js");
-Object.defineProperty(exports, "Lazy", { enumerable: true, get: function () { return __importDefault(lazy_js_1).default; } });
-var from_js_1 = require("./collections/from.js");
-Object.defineProperty(exports, "from", { enumerable: true, get: function () { return __importDefault(from_js_1).default; } });
-var event_bus_js_1 = require("./event-bus.js");
-Object.defineProperty(exports, "EventBus", { enumerable: true, get: function () { return event_bus_js_1.EventBus; } });
-Object.defineProperty(exports, "Event", { enumerable: true, get: function () { return event_bus_js_1.Event; } });
-var range_js_1 = require("./range.js");
-Object.defineProperty(exports, "Range", { enumerable: true, get: function () { return __importDefault(range_js_1).default; } });
-// ─── Draft ────────────────────────────────────────
-var draft_js_1 = require("./draft.js");
-Object.defineProperty(exports, "draft", { enumerable: true, get: function () { return __importDefault(draft_js_1).default; } });
-// ─── Web ─────────────────────────────────────────────
-var clean_url_search_params_js_1 = require("./clean-url-search-params.js");
-Object.defineProperty(exports, "CleanURLSearchParams", { enumerable: true, get: function () { return __importDefault(clean_url_search_params_js_1).default; } });
-/** @deprecated  */
-var index_js_1 = require("./browser/index.js");
-Object.defineProperty(exports, "ajaxSubmit", { enumerable: true, get: function () { return index_js_1.ajaxSubmit; } });
-Object.defineProperty(exports, "ajaxSubmission", { enumerable: true, get: function () { return index_js_1.ajaxSubmission; } });
-Object.defineProperty(exports, "submitForm", { enumerable: true, get: function () { return index_js_1.submitForm; } });
-Object.defineProperty(exports, "formToObject", { enumerable: true, get: function () { return index_js_1.formToObject; } });
-// ─── Deprecated ──────────────────────────────────────
-/** @deprecated  */
-__exportStar(require("./array.js"), exports);
-/** @deprecated  */
-__exportStar(require("./collections/index.js"), exports);
-//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,eAAe;;;;;;;;;;;;;;;;;;;;AAEf,wDAAwD;AACxD,6CAA2B;AAC3B,qCAA0C;AAAlC,gHAAA,OAAO,OAAQ;AACvB,+CAAmD;AAA3C,yHAAA,OAAO,OAAY;AAE3B,wDAAwD;AACxD,iDAA+B;AAC/B,iDAA+B;AAC/B,8CAA4B;AAC5B,4CAA0B;AAC1B,6CAA2B;AAC3B,mEAAuE;AAA/D,6IAAA,OAAO,OAAsB;AAErC,uDAAuD;AACvD,yDAA4D;AAApD,kIAAA,OAAO,OAAgB;AAC/B,uCAA4C;AAApC,kHAAA,OAAO,OAAS;AAExB,uDAAuD;AACvD,uCAA4C;AAApC,kHAAA,OAAO,OAAS;AACxB,6CAAkD;AAA1C,wHAAA,OAAO,OAAY;AAC3B,+CAAoD;AAA5C,0HAAA,OAAO,OAAa;AAE5B,6CAAwD;AAAhD,0GAAA,WAAW,OAAA;AAAE,2GAAA,YAAY,OAAA;AACjC,mEAAsE;AAA9D,4IAAA,OAAO,OAAqB;AACpC,+CAAoD;AAA5C,0HAAA,OAAO,OAAa;AAE5B,2DAA+D;AAAvD,qIAAA,OAAO,OAAkB;AAGjC,wDAAwD;AACxD,qCAA0C;AAAlC,gHAAA,OAAO,OAAQ;AACvB,iDAAsD;AAA9C,gHAAA,OAAO,OAAQ;AACvB,+CAA+C;AAAvC,wGAAA,QAAQ,OAAA;AAAE,qGAAA,KAAK,OAAA;AACvB,uCAA4C;AAApC,kHAAA,OAAO,OAAS;AAExB,qDAAqD;AACrD,uCAA4C;AAApC,kHAAA,OAAO,OAAS;AAExB,wDAAwD;AACxD,2EAA6E;AAArE,mJAAA,OAAO,OAAwB;AACvC,mBAAmB;AACnB,+CAAwF;AAAhF,sGAAA,UAAU,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,sGAAA,UAAU,OAAA;AAAE,wGAAA,YAAY,OAAA;AAI5D,wDAAwD;AACxD,mBAAmB;AACnB,6CAA2B;AAC3B,mBAAmB;AACnB,yDAAuC","sourcesContent":["// src/index.ts\n\n// ─── Types ───────────────────────────────────────────\nexport * from './types.js';\nexport {default as Type} from './type.js';\nexport {default as TypeCode} from './type-code.js';\n\n// ─── Utilities ───────────────────────────────────────\nexport * from './utilities.js';\nexport * from './functions.js';\nexport * from './string.js';\nexport * from './math.js';\nexport * from './parse.js';\nexport {default as CancellablePromise} from \"./cancellable-promise.js\";\n\n// ─── Data Structures ────────────────────────────────\nexport {default as KeyValuePair} from './key-value-pair.js';\nexport {default as Order} from './order.js';\n\n// ─── Async & Timing ─────────────────────────────────\nexport {default as Timer} from './timer.js';\nexport {default as TimeSpan} from './timespan.js';\nexport {default as Stopwatch} from './stopwatch.js';\nexport type {Result} from './result.js';\nexport {TimeTrigger, CountTrigger} from './triggers.js';\nexport {default as AsyncPoolExecutor} from './async-pool-executor.js';\nexport {default as Debouncer} from './debouncer.js';\nexport type {DebouncedTask, DebouncerOptions} from './debouncer.js';\nexport {default as KeyedDebouncer} from './keyed-debouncer.js';\nexport type {KeyedDebouncerOptions} from './keyed-debouncer.js';\n\n// ─── Patterns ────────────────────────────────────────\nexport {default as Lazy} from './lazy.js';\nexport {default as from} from './collections/from.js';\nexport {EventBus, Event} from './event-bus.js';\nexport {default as Range} from './range.js';\n\n// ─── Draft ────────────────────────────────────────\nexport {default as draft} from './draft.js';\n\n// ─── Web ─────────────────────────────────────────────\nexport {default as CleanURLSearchParams} from './clean-url-search-params.js';\n/** @deprecated  */\nexport {ajaxSubmit, ajaxSubmission, submitForm, formToObject} from './browser/index.js';\n\n\n\n// ─── Deprecated ──────────────────────────────────────\n/** @deprecated  */\nexport * from './array.js';\n/** @deprecated  */\nexport * from './collections/index.js';"]}

package/dist/cjs/key-value-pair.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Represents a pair of key and value.
- *
- * @template TKey The type of the key.
- * @template TValue The type of the value.
- */
-class KeyValuePair {
-    get value() {
-        return this._value;
-    }
-    get key() {
-        return this._key;
-    }
-    constructor(key, value) {
-        this._key = key;
-        this._value = value;
-    }
-}
-exports.default = KeyValuePair;
-//# sourceMappingURL=key-value-pair.js.map

package/dist/cjs/key-value-pair.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"key-value-pair.js","sourceRoot":"","sources":["../../src/key-value-pair.ts"],"names":[],"mappings":";;AAAA;;;;;GAKG;AACH,MAAqB,YAAY;IAC7B,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,GAAG;QACH,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAKD,YAAY,GAAS,EAAE,KAAa;QAChC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;CAGJ;AAlBD,+BAkBC","sourcesContent":["/**\n * Represents a pair of key and value.\n *\n * @template TKey The type of the key.\n * @template TValue The type of the value.\n */\nexport default class KeyValuePair<TKey, TValue> {\n    get value(): TValue {\n        return this._value;\n    }\n\n    get key(): TKey {\n        return this._key;\n    }\n\n    private readonly _key: TKey;\n    private readonly _value: TValue;\n\n    constructor(key: TKey, value: TValue) {\n        this._key = key;\n        this._value = value;\n    }\n\n\n}"]}

package/dist/cjs/keyed-debouncer.js

@@ -1,144 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _KeyedDebouncer_instances, _KeyedDebouncer_debouncers, _KeyedDebouncer_delayMs, _KeyedDebouncer_onSchedule, _KeyedDebouncer_onStart, _KeyedDebouncer_onSuccess, _KeyedDebouncer_onCancel, _KeyedDebouncer_onError, _KeyedDebouncer_onIdle, _KeyedDebouncer_create;
-Object.defineProperty(exports, "__esModule", { value: true });
-const debouncer_js_1 = __importStar(require("./debouncer.js"));
-const functions_js_1 = require("./functions.js");
-/**
- * An independent {@link Debouncer} per key.
- * Debouncers only exist for keys with pending work: each one is created when
- * its first task is scheduled and removed as soon as it becomes idle.
- *
- * @example
- * ```ts
- * const debouncer = new KeyedDebouncer<string>({delayMs: 1500});
- *
- * debouncer.schedule(chatId, async (signal) => {
- *     const pending = await store.getPending(chatId);
- *     const reply = await callAI(pending, {signal});
- *     if (signal.aborted) return;
- *     await sendReply(chatId, reply);
- * });
- * ```
- */
-class KeyedDebouncer {
-    constructor(options) {
-        _KeyedDebouncer_instances.add(this);
-        _KeyedDebouncer_debouncers.set(this, new Map());
-        _KeyedDebouncer_delayMs.set(this, void 0);
-        _KeyedDebouncer_onSchedule.set(this, void 0);
-        _KeyedDebouncer_onStart.set(this, void 0);
-        _KeyedDebouncer_onSuccess.set(this, void 0);
-        _KeyedDebouncer_onCancel.set(this, void 0);
-        _KeyedDebouncer_onError.set(this, void 0);
-        _KeyedDebouncer_onIdle.set(this, void 0);
-        (0, debouncer_js_1.assertValidDelay)(options.delayMs);
-        __classPrivateFieldSet(this, _KeyedDebouncer_delayMs, options.delayMs, "f");
-        __classPrivateFieldSet(this, _KeyedDebouncer_onSchedule, options.onSchedule ?? functions_js_1.noop, "f");
-        __classPrivateFieldSet(this, _KeyedDebouncer_onStart, options.onStart ?? functions_js_1.noop, "f");
-        __classPrivateFieldSet(this, _KeyedDebouncer_onSuccess, options.onSuccess ?? functions_js_1.noop, "f");
-        __classPrivateFieldSet(this, _KeyedDebouncer_onCancel, options.onCancel ?? functions_js_1.noop, "f");
-        __classPrivateFieldSet(this, _KeyedDebouncer_onError, options.onError ?? console.error, "f");
-        __classPrivateFieldSet(this, _KeyedDebouncer_onIdle, options.onIdle ?? functions_js_1.noop, "f");
-    }
-    /** Number of keys with a task waiting or running. */
-    get size() {
-        return __classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").size;
-    }
-    /**
-     * Schedule `task` for `key`, cancelling any previous task of that key.
-     *
-     * @param key - The key whose task is replaced.
-     * @param task - The task to run once the delay elapses.
-     * @param delayMs - Wait for this task only. Defaults to the configured `delayMs`.
-     */
-    schedule(key, task, delayMs) {
-        const existing = __classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").get(key);
-        if (existing !== undefined) {
-            existing.schedule(task, delayMs);
-            return;
-        }
-        // Validate first so an invalid delay never registers the key.
-        (0, debouncer_js_1.assertValidDelay)(delayMs ?? __classPrivateFieldGet(this, _KeyedDebouncer_delayMs, "f"));
-        const debouncer = __classPrivateFieldGet(this, _KeyedDebouncer_instances, "m", _KeyedDebouncer_create).call(this, key);
-        __classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").set(key, debouncer);
-        debouncer.schedule(task, delayMs);
-    }
-    /** Cancel the task of `key`, if any. */
-    cancel(key) {
-        __classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").get(key)?.cancel();
-    }
-    /** Cancel every task. Useful when shutting the process down. */
-    cancelAll() {
-        // Copy first: cancelling removes the debouncer from the map.
-        for (const debouncer of [...__classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").values()]) {
-            debouncer.cancel();
-        }
-    }
-    /** Whether a task is waiting or running for `key`. */
-    isPending(key) {
-        return __classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").has(key);
-    }
-}
-_KeyedDebouncer_debouncers = new WeakMap(), _KeyedDebouncer_delayMs = new WeakMap(), _KeyedDebouncer_onSchedule = new WeakMap(), _KeyedDebouncer_onStart = new WeakMap(), _KeyedDebouncer_onSuccess = new WeakMap(), _KeyedDebouncer_onCancel = new WeakMap(), _KeyedDebouncer_onError = new WeakMap(), _KeyedDebouncer_onIdle = new WeakMap(), _KeyedDebouncer_instances = new WeakSet(), _KeyedDebouncer_create = function _KeyedDebouncer_create(key) {
-    const debouncer = new debouncer_js_1.default({
-        delayMs: __classPrivateFieldGet(this, _KeyedDebouncer_delayMs, "f"),
-        onSchedule: () => __classPrivateFieldGet(this, _KeyedDebouncer_onSchedule, "f").call(this, key),
-        onStart: () => __classPrivateFieldGet(this, _KeyedDebouncer_onStart, "f").call(this, key),
-        onSuccess: () => __classPrivateFieldGet(this, _KeyedDebouncer_onSuccess, "f").call(this, key),
-        onCancel: () => __classPrivateFieldGet(this, _KeyedDebouncer_onCancel, "f").call(this, key),
-        onError: (error) => __classPrivateFieldGet(this, _KeyedDebouncer_onError, "f").call(this, error, key),
-        onIdle: () => {
-            if (__classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").get(key) === debouncer) {
-                __classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").delete(key);
-                __classPrivateFieldGet(this, _KeyedDebouncer_onIdle, "f").call(this, key);
-            }
-        },
-    });
-    return debouncer;
-};
-exports.default = KeyedDebouncer;
-//# sourceMappingURL=keyed-debouncer.js.map

package/dist/cjs/keyed-debouncer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"keyed-debouncer.js","sourceRoot":"","sources":["../../src/keyed-debouncer.ts"],"names":[],"mappings":"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","sourcesContent":["import Debouncer, {assertValidDelay, type DebouncedTask} from \"./debouncer.js\";\nimport {noop} from \"./functions.js\";\n\n/** Options accepted by {@link KeyedDebouncer}. Every callback receives the affected key. */\nexport interface KeyedDebouncerOptions<K> {\n    /** Default wait, in milliseconds, before a task is executed. */\n    delayMs: number;\n    /** Called every time a task is scheduled for `key`, after any previous task of that key has been cancelled. */\n    onSchedule?: (key: K) => void;\n    /** Called when the wait elapses and the task of `key` is about to run. */\n    onStart?: (key: K) => void;\n    /** Called when the task of `key` completes without throwing and without being cancelled. */\n    onSuccess?: (key: K) => void;\n    /** Called when a live task of `key` is cancelled, either explicitly or by being replaced. */\n    onCancel?: (key: K) => void;\n    /** Receives task errors. Cancellations never reach this callback. Defaults to `console.error`. */\n    onError?: (error: unknown, key: K) => void;\n    /** Called when `key` has no more pending work, after it has been removed from the debouncer. */\n    onIdle?: (key: K) => void;\n}\n\n/**\n * An independent {@link Debouncer} per key.\n * Debouncers only exist for keys with pending work: each one is created when\n * its first task is scheduled and removed as soon as it becomes idle.\n *\n * @example\n * ```ts\n * const debouncer = new KeyedDebouncer<string>({delayMs: 1500});\n *\n * debouncer.schedule(chatId, async (signal) => {\n *     const pending = await store.getPending(chatId);\n *     const reply = await callAI(pending, {signal});\n *     if (signal.aborted) return;\n *     await sendReply(chatId, reply);\n * });\n * ```\n */\nexport default class KeyedDebouncer<K = string> {\n    readonly #debouncers = new Map<K, Debouncer>();\n    readonly #delayMs: number;\n    readonly #onSchedule: (key: K) => void;\n    readonly #onStart: (key: K) => void;\n    readonly #onSuccess: (key: K) => void;\n    readonly #onCancel: (key: K) => void;\n    readonly #onError: (error: unknown, key: K) => void;\n    readonly #onIdle: (key: K) => void;\n\n    constructor(options: KeyedDebouncerOptions<K>) {\n        assertValidDelay(options.delayMs);\n        this.#delayMs = options.delayMs;\n        this.#onSchedule = options.onSchedule ?? noop;\n        this.#onStart = options.onStart ?? noop;\n        this.#onSuccess = options.onSuccess ?? noop;\n        this.#onCancel = options.onCancel ?? noop;\n        this.#onError = options.onError ?? console.error;\n        this.#onIdle = options.onIdle ?? noop;\n    }\n\n    /** Number of keys with a task waiting or running. */\n    get size(): number {\n        return this.#debouncers.size;\n    }\n\n    /**\n     * Schedule `task` for `key`, cancelling any previous task of that key.\n     *\n     * @param key - The key whose task is replaced.\n     * @param task - The task to run once the delay elapses.\n     * @param delayMs - Wait for this task only. Defaults to the configured `delayMs`.\n     */\n    schedule(key: K, task: DebouncedTask, delayMs?: number): void {\n        const existing = this.#debouncers.get(key);\n        if (existing !== undefined) {\n            existing.schedule(task, delayMs);\n            return;\n        }\n\n        // Validate first so an invalid delay never registers the key.\n        assertValidDelay(delayMs ?? this.#delayMs);\n        const debouncer = this.#create(key);\n        this.#debouncers.set(key, debouncer);\n        debouncer.schedule(task, delayMs);\n    }\n\n    /** Cancel the task of `key`, if any. */\n    cancel(key: K): void {\n        this.#debouncers.get(key)?.cancel();\n    }\n\n    /** Cancel every task. Useful when shutting the process down. */\n    cancelAll(): void {\n        // Copy first: cancelling removes the debouncer from the map.\n        for (const debouncer of [...this.#debouncers.values()]) {\n            debouncer.cancel();\n        }\n    }\n\n    /** Whether a task is waiting or running for `key`. */\n    isPending(key: K): boolean {\n        return this.#debouncers.has(key);\n    }\n\n    #create(key: K): Debouncer {\n        const debouncer: Debouncer = new Debouncer({\n            delayMs: this.#delayMs,\n            onSchedule: () => this.#onSchedule(key),\n            onStart: () => this.#onStart(key),\n            onSuccess: () => this.#onSuccess(key),\n            onCancel: () => this.#onCancel(key),\n            onError: (error) => this.#onError(error, key),\n            onIdle: () => {\n                if (this.#debouncers.get(key) === debouncer) {\n                    this.#debouncers.delete(key);\n                    this.#onIdle(key);\n                }\n            },\n        });\n        return debouncer;\n    }\n}\n"]}

package/dist/cjs/lazy.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Represents a lazy value that is created only when it is accessed for the first time.
- * @template T The type of the lazy value.
- */
-class Lazy {
-    constructor(getter) {
-        this._valueCreated = false;
-        this._value = null;
-        this._factoryMethod = getter;
-    }
-    get valueCreated() {
-        return this._valueCreated;
-    }
-    get value() {
-        if (!this._valueCreated) {
-            this._value = this._factoryMethod();
-            this._valueCreated = true;
-        }
-        return this._value;
-    }
-    reset() {
-        this._valueCreated = false;
-        this._value = null;
-    }
-}
-exports.default = Lazy;
-//# sourceMappingURL=lazy.js.map

package/dist/cjs/lazy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../../src/lazy.ts"],"names":[],"mappings":";;AAGA;;;GAGG;AACH,MAAqB,IAAI;IAKrB,YAAY,MAAmB;QAJvB,kBAAa,GAAG,KAAK,CAAC;QACtB,WAAM,GAAgB,IAAI,CAAC;QAI/B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;IACjC,CAAC;IAED,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,IAAW,KAAK;QACZ,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YACpC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,MAAW,CAAC;IAC5B,CAAC;IAED,KAAK;QACD,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC;CACJ;AAzBD,uBAyBC","sourcesContent":["import type {Nullable, Supplier} from \"./types.js\";\n\n\n/**\n * Represents a lazy value that is created only when it is accessed for the first time.\n * @template T The type of the lazy value.\n */\nexport default class Lazy<T> {\n    private _valueCreated = false;\n    private _value: Nullable<T> = null;\n    private readonly _factoryMethod: Supplier<T>;\n\n    constructor(getter: Supplier<T>) {\n        this._factoryMethod = getter;\n    }\n\n    get valueCreated(): boolean {\n        return this._valueCreated;\n    }\n\n    public get value(): T {\n        if (!this._valueCreated) {\n            this._value = this._factoryMethod();\n            this._valueCreated = true;\n        }\n        return this._value as T;\n    }\n\n    reset(): void {\n        this._valueCreated = false;\n        this._value = null;\n    }\n}"]}

package/dist/cjs/math.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.lerp = lerp;
-exports.clamp = clamp;
-/**
- * Linearly interpolates a number between two ranges.
- *
- * @param {number} n - The number to interpolate.
- * @param {number} inMin - The minimum value of the input range.
- * @param {number} inMax - The maximum value of the input range.
- * @param {number} outMin - The minimum value of the output range.
- * @param {number} outMax - The maximum value of the output range.
- *
- * @return {number} - The interpolated value.
- */
-function lerp(n, inMin, inMax, outMin, outMax) {
-    if (inMax === inMin) {
-        throw new Error("Input range cannot be zero");
-    }
-    return outMin + (outMax - outMin) * ((n - inMin) / (inMax - inMin));
-}
-/**
- * Clamps a number between a minimum and maximum value.
- *
- * @param {number} n - The value to be clamped.
- * @param {number} min - The minimum value.
- * @param {number} max - The maximum value.
- * @return {number} The clamped value.
- */
-function clamp(n, min, max) {
-    if (n <= min)
-        return min;
-    if (n >= max)
-        return max;
-    return n;
-}
-//# sourceMappingURL=math.js.map