es-toolkit 1.19.0 → 1.20.0-dev.625

package/dist/compat/index.d.ts

@@ -3,7 +3,6 @@ export { compact } from '../array/compact.js';
 export { countBy } from '../array/countBy.js';
 export { differenceBy } from '../array/differenceBy.js';
 export { differenceWith } from '../array/differenceWith.js';
-export { drop } from '../array/drop.js';
 export { dropRight } from '../array/dropRight.js';
 export { dropRightWhile } from '../array/dropRightWhile.js';
 export { dropWhile } from '../array/dropWhile.js';
@@ -51,17 +50,13 @@ export { AbortError } from '../error/AbortError.js';
 export { TimeoutError } from '../error/TimeoutError.js';
 export { before } from '../function/before.js';
 export { after } from '../function/after.js';
-export { debounce } from '../function/debounce.js';
 export { noop } from '../function/noop.js';
 export { once } from '../function/once.js';
-export { throttle } from '../function/throttle.js';
 export { negate } from '../function/negate.js';
 export { MemoizeCache, memoize } from '../function/memoize.js';
 export { unary } from '../function/unary.js';
 export { partial } from '../function/partial.js';
 export { partialRight } from '../function/partialRight.js';
-export { curry } from '../function/curry.js';
-export { clamp } from '../math/clamp.js';
 export { inRange } from '../math/inRange.js';
 export { mean } from '../math/mean.js';
 export { meanBy } from '../math/meanBy.js';
@@ -89,7 +84,6 @@ export { isPrimitive } from '../predicate/isPrimitive.js';
 export { delay } from '../promise/delay.js';
 export { withTimeout } from '../promise/withTimeout.js';
 export { timeout } from '../promise/timeout.js';
-export { upperCase } from '../string/upperCase.js';
 export { capitalize } from '../string/capitalize.js';
 export { pascalCase } from '../string/pascalCase.js';
 export { upperFirst } from '../string/upperFirst.js';
@@ -103,6 +97,7 @@ export { castArray } from './array/castArray.js';
 export { chunk } from './array/chunk.js';
 export { concat } from './array/concat.js';
 export { difference } from './array/difference.js';
+export { drop } from './array/drop.js';
 export { fill } from './array/fill.js';
 export { find } from './array/find.js';
 export { findIndex } from './array/findIndex.js';
@@ -124,6 +119,9 @@ export { rest } from './function/rest.js';
 export { spread } from './function/spread.js';
 export { attempt } from './function/attempt.js';
 export { rearg } from './function/rearg.js';
+export { curry } from './function/curry.js';
+export { debounce } from './function/debounce.js';
+export { throttle } from './function/throttle.js';
 export { get } from './object/get.js';
 export { set } from './object/set.js';
 export { pick } from './object/pick.js';
@@ -156,11 +154,14 @@ export { conforms } from './predicate/conforms.js';
 export { conformsTo } from './predicate/conformsTo.js';
 export { isInteger } from './predicate/isInteger.js';
 export { isSafeInteger } from './predicate/isSafeInteger.js';
+export { isNumber } from './predicate/isNumber.js';
+export { isNaN } from './predicate/isNaN.js';
 export { camelCase } from './string/camelCase.js';
 export { kebabCase } from './string/kebabCase.js';
 export { snakeCase } from './string/snakeCase.js';
 export { startCase } from './string/startCase.js';
 export { lowerCase } from './string/lowerCase.js';
+export { upperCase } from './string/upperCase.js';
 export { startsWith } from './string/startsWith.js';
 export { endsWith } from './string/endsWith.js';
 export { padStart } from './string/padStart.js';
@@ -169,6 +170,7 @@ export { repeat } from './string/repeat.js';
 export { trim } from './string/trim.js';
 export { trimStart } from './string/trimStart.js';
 export { trimEnd } from './string/trimEnd.js';
+export { clamp } from './math/clamp.js';
 export { max } from './math/max.js';
 export { min } from './math/min.js';
 export { ceil } from './math/ceil.js';

package/dist/compat/index.js

@@ -2,9 +2,9 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const zipWith = require('../_chunk/zipWith-B-5AMf.js');
+const zipWith = require('../_chunk/zipWith-CDtN9Y.js');
 const promise_index = require('../_chunk/index-BGZDR9.js');
-const curry = require('../_chunk/curry-BmwJrK.js');
+const rest$1 = require('../_chunk/rest-pUyjvl.js');
 const range = require('../_chunk/range-BXlMmn.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 const toMerged = require('../_chunk/toMerged-Bzkqyz.js');
@@ -37,6 +37,14 @@ function difference(arr, ...values) {
     return zipWith.difference(arr1, arr2);
 }
 
+function drop(collection, itemsCount) {
+    if (collection === null || collection === undefined) {
+        return [];
+    }
+    itemsCount = Math.max(itemsCount, 0);
+    return collection.slice(itemsCount);
+}
+
 function fill(array, value, start = 0, end = array.length) {
     start = Math.floor(start);
     end = Math.floor(end);
@@ -430,30 +438,30 @@ function findIndex(source, doesMatch) {
     }
 }
 
-function findLastIndex(source, doesMatch, fromIndex = source.length - 1) {
+function findLastIndex(arr, doesMatch, fromIndex = arr.length - 1) {
     if (fromIndex < 0) {
-        fromIndex = Math.max(source.length + fromIndex, 0);
+        fromIndex = Math.max(arr.length + fromIndex, 0);
     }
     else {
-        fromIndex = Math.min(fromIndex, source.length - 1);
+        fromIndex = Math.min(fromIndex, arr.length - 1);
     }
-    source = source.slice(0, fromIndex + 1);
+    arr = arr.slice(0, fromIndex + 1);
     switch (typeof doesMatch) {
         case 'function': {
-            return source.findLastIndex(doesMatch);
+            return arr.findLastIndex(doesMatch);
         }
         case 'object': {
             if (Array.isArray(doesMatch) && doesMatch.length === 2) {
                 const key = doesMatch[0];
                 const value = doesMatch[1];
-                return source.findLastIndex(matchesProperty(key, value));
+                return arr.findLastIndex(matchesProperty(key, value));
             }
             else {
-                return source.findLastIndex(matches(doesMatch));
+                return arr.findLastIndex(matches(doesMatch));
             }
         }
         case 'string': {
-            return source.findLastIndex(property(doesMatch));
+            return arr.findLastIndex(property(doesMatch));
         }
     }
 }
@@ -721,7 +729,7 @@ function ary(func, n = func.length, guard) {
     if (Number.isNaN(n) || n < 0) {
         n = 0;
     }
-    return curry.ary(func, n);
+    return rest$1.ary(func, n);
 }
 
 function bind(func, thisObj, ...partialArgs) {
@@ -781,7 +789,7 @@ function rest(func, start = func.length - 1) {
     if (Number.isNaN(start) || start < 0) {
         start = func.length - 1;
     }
-    return curry.rest(func, start);
+    return rest$1.rest(func, start);
 }
 
 function spread(func, argsIndex = 0) {
@@ -819,6 +827,123 @@ function rearg(func, ...indices) {
     };
 }
 
+function curry(func, arity = func.length, guard) {
+    arity = guard ? func.length : arity;
+    arity = Number.parseInt(arity, 10);
+    if (Number.isNaN(arity) || arity < 1) {
+        arity = 0;
+    }
+    const wrapper = function (...partials) {
+        const holders = replaceHolders(partials);
+        const length = partials.length - holders.length;
+        if (length < arity) {
+            return makeCurry(func, holders, arity - length, partials);
+        }
+        if (this instanceof wrapper) {
+            return new func(...partials);
+        }
+        return func.apply(this, partials);
+    };
+    wrapper.placeholder = curryPlaceholder;
+    return wrapper;
+}
+function makeCurry(func, holders, arity, partials) {
+    function wrapper(...args) {
+        const holdersCount = args.filter(item => item === curry.placeholder).length;
+        const length = args.length - holdersCount;
+        args = composeArgs(args, partials, holders);
+        if (length < arity) {
+            const newHolders = replaceHolders(args);
+            return makeCurry(func, newHolders, arity - length, args);
+        }
+        if (this instanceof wrapper) {
+            return new func(...args);
+        }
+        return func.apply(this, args);
+    }
+    wrapper.placeholder = curryPlaceholder;
+    return wrapper;
+}
+function replaceHolders(args) {
+    const result = [];
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === curry.placeholder) {
+            result.push(i);
+        }
+    }
+    return result;
+}
+function composeArgs(args, partials, holders) {
+    const result = [...partials];
+    const argsLength = args.length;
+    const holdersLength = holders.length;
+    let argsIndex = -1, leftIndex = partials.length, rangeLength = Math.max(argsLength - holdersLength, 0);
+    while (++argsIndex < holdersLength) {
+        if (argsIndex < argsLength) {
+            result[holders[argsIndex]] = args[argsIndex];
+        }
+    }
+    while (rangeLength--) {
+        result[leftIndex++] = args[argsIndex++];
+    }
+    return result;
+}
+const curryPlaceholder = Symbol('curry.placeholder');
+curry.placeholder = curryPlaceholder;
+
+function debounce(func, debounceMs = 0, options = {}) {
+    if (typeof options !== 'object') {
+        options = {};
+    }
+    const { signal, leading = false, trailing = true, maxWait } = options;
+    const edges = Array(2);
+    if (leading) {
+        edges[0] = 'leading';
+    }
+    if (trailing) {
+        edges[1] = 'trailing';
+    }
+    let result = undefined;
+    let pendingAt = null;
+    const _debounced = rest$1.debounce(function (...args) {
+        result = func.apply(this, args);
+        pendingAt = null;
+    }, debounceMs, { signal, edges });
+    const debounced = function (...args) {
+        if (maxWait != null) {
+            if (pendingAt === null) {
+                pendingAt = Date.now();
+            }
+            else {
+                if (Date.now() - pendingAt >= maxWait) {
+                    result = func.apply(this, args);
+                    pendingAt = Date.now();
+                    _debounced.cancel();
+                    _debounced.schedule();
+                    return result;
+                }
+            }
+        }
+        _debounced.apply(this, args);
+        return result;
+    };
+    const flush = () => {
+        _debounced.flush();
+        return result;
+    };
+    debounced.cancel = _debounced.cancel;
+    debounced.flush = flush;
+    return debounced;
+}
+
+function throttle(func, throttleMs = 0, options = {}) {
+    if (typeof options !== 'object') {
+        options = {};
+    }
+    const { leading = true, trailing = true, signal } = options;
+    return debounce(func, throttleMs, { leading, trailing, signal, maxWait: throttleMs });
+}
+
 function isNil(x) {
     return x == null;
 }
@@ -1085,7 +1210,7 @@ function mergeWithDeep(target, source, merge, stack) {
 }
 
 function merge(object, ...sources) {
-    return mergeWith(object, ...sources, curry.noop);
+    return mergeWith(object, ...sources, rest$1.noop);
 }
 
 function isArrayLike(value) {
@@ -1175,6 +1300,17 @@ function isSafeInteger(value) {
     return Number.isSafeInteger(value);
 }
 
+function isNumber(value) {
+    if (typeof value === 'object' && value != null && isWeakSet$1.getTag(value) === '[object Number]') {
+        return true;
+    }
+    return typeof value === 'number';
+}
+
+function isNaN(value) {
+    return Number.isNaN(value);
+}
+
 function toString(value) {
     if (value == null) {
         return '';
@@ -1216,6 +1352,10 @@ function lowerCase(str) {
     return string_index.lowerCase(normalizeForCase(str));
 }
 
+function upperCase(str) {
+    return string_index.upperCase(normalizeForCase(str));
+}
+
 function startsWith(str, target, position = 0) {
     return str.startsWith(target, position);
 }
@@ -1302,6 +1442,16 @@ function trimEnd(str, chars, guard) {
     }
 }
 
+function clamp(value, bound1, bound2) {
+    if (Number.isNaN(bound1)) {
+        bound1 = 0;
+    }
+    if (Number.isNaN(bound2)) {
+        bound2 = 0;
+    }
+    return range.clamp(value, bound1, bound2);
+}
+
 function max(items = []) {
     let maxElement = items[0];
     let max = undefined;
@@ -1368,7 +1518,6 @@ exports.compact = zipWith.compact;
 exports.countBy = zipWith.countBy;
 exports.differenceBy = zipWith.differenceBy;
 exports.differenceWith = zipWith.differenceWith;
-exports.drop = zipWith.drop;
 exports.dropRight = zipWith.dropRight;
 exports.dropRightWhile = zipWith.dropRightWhile;
 exports.dropWhile = zipWith.dropWhile;
@@ -1418,19 +1567,15 @@ exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
 exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
-exports.after = curry.after;
-exports.before = curry.before;
-exports.curry = curry.curry;
-exports.debounce = curry.debounce;
-exports.memoize = curry.memoize;
-exports.negate = curry.negate;
-exports.noop = curry.noop;
-exports.once = curry.once;
-exports.partial = curry.partial;
-exports.partialRight = curry.partialRight;
-exports.throttle = curry.throttle;
-exports.unary = curry.unary;
-exports.clamp = range.clamp;
+exports.after = rest$1.after;
+exports.before = rest$1.before;
+exports.memoize = rest$1.memoize;
+exports.negate = rest$1.negate;
+exports.noop = rest$1.noop;
+exports.once = rest$1.once;
+exports.partial = rest$1.partial;
+exports.partialRight = rest$1.partialRight;
+exports.unary = rest$1.unary;
 exports.inRange = range.inRange;
 exports.mean = range.mean;
 exports.meanBy = range.meanBy;
@@ -1464,7 +1609,6 @@ exports.lowerFirst = string_index.lowerFirst;
 exports.pad = string_index.pad;
 exports.pascalCase = string_index.pascalCase;
 exports.unescape = string_index.unescape;
-exports.upperCase = string_index.upperCase;
 exports.upperFirst = string_index.upperFirst;
 exports.ary = ary;
 exports.attempt = attempt;
@@ -1474,10 +1618,14 @@ exports.camelCase = camelCase;
 exports.castArray = castArray;
 exports.ceil = ceil;
 exports.chunk = chunk;
+exports.clamp = clamp;
 exports.concat = concat;
 exports.conforms = conforms;
 exports.conformsTo = conformsTo;
+exports.curry = curry;
+exports.debounce = debounce;
 exports.difference = difference;
+exports.drop = drop;
 exports.endsWith = endsWith;
 exports.fill = fill;
 exports.find = find;
@@ -1497,6 +1645,8 @@ exports.isArrayLike = isArrayLike;
 exports.isBoolean = isBoolean;
 exports.isInteger = isInteger;
 exports.isMatch = isMatch;
+exports.isNaN = isNaN;
+exports.isNumber = isNumber;
 exports.isObject = isObject;
 exports.isPlainObject = isPlainObject;
 exports.isRegExp = isRegExp;
@@ -1536,10 +1686,12 @@ exports.sortBy = sortBy;
 exports.spread = spread;
 exports.startCase = startCase;
 exports.startsWith = startsWith;
+exports.throttle = throttle;
 exports.toPath = toPath;
 exports.toString = toString;
 exports.trim = trim;
 exports.trimEnd = trimEnd;
 exports.trimStart = trimStart;
 exports.unset = unset;
+exports.upperCase = upperCase;
 exports.zipObjectDeep = zipObjectDeep;

package/dist/compat/index.mjs

@@ -3,7 +3,6 @@ export { compact } from '../array/compact.mjs';
 export { countBy } from '../array/countBy.mjs';
 export { differenceBy } from '../array/differenceBy.mjs';
 export { differenceWith } from '../array/differenceWith.mjs';
-export { drop } from '../array/drop.mjs';
 export { dropRight } from '../array/dropRight.mjs';
 export { dropRightWhile } from '../array/dropRightWhile.mjs';
 export { dropWhile } from '../array/dropWhile.mjs';
@@ -51,17 +50,13 @@ export { AbortError } from '../error/AbortError.mjs';
 export { TimeoutError } from '../error/TimeoutError.mjs';
 export { before } from '../function/before.mjs';
 export { after } from '../function/after.mjs';
-export { debounce } from '../function/debounce.mjs';
 export { noop } from '../function/noop.mjs';
 export { once } from '../function/once.mjs';
-export { throttle } from '../function/throttle.mjs';
 export { negate } from '../function/negate.mjs';
 export { memoize } from '../function/memoize.mjs';
 export { unary } from '../function/unary.mjs';
 export { partial } from '../function/partial.mjs';
 export { partialRight } from '../function/partialRight.mjs';
-export { curry } from '../function/curry.mjs';
-export { clamp } from '../math/clamp.mjs';
 export { inRange } from '../math/inRange.mjs';
 export { mean } from '../math/mean.mjs';
 export { meanBy } from '../math/meanBy.mjs';
@@ -91,7 +86,6 @@ export { delay } from '../promise/delay.mjs';
 export { withTimeout } from '../promise/withTimeout.mjs';
 export { timeout } from '../promise/timeout.mjs';
 export { capitalize } from '../string/capitalize.mjs';
-export { upperCase } from '../string/upperCase.mjs';
 export { pascalCase } from '../string/pascalCase.mjs';
 export { upperFirst } from '../string/upperFirst.mjs';
 export { lowerFirst } from '../string/lowerFirst.mjs';
@@ -104,6 +98,7 @@ export { castArray } from './array/castArray.mjs';
 export { chunk } from './array/chunk.mjs';
 export { concat } from './array/concat.mjs';
 export { difference } from './array/difference.mjs';
+export { drop } from './array/drop.mjs';
 export { fill } from './array/fill.mjs';
 export { find } from './array/find.mjs';
 export { findIndex } from './array/findIndex.mjs';
@@ -125,6 +120,9 @@ export { rest } from './function/rest.mjs';
 export { spread } from './function/spread.mjs';
 export { attempt } from './function/attempt.mjs';
 export { rearg } from './function/rearg.mjs';
+export { curry } from './function/curry.mjs';
+export { debounce } from './function/debounce.mjs';
+export { throttle } from './function/throttle.mjs';
 export { get } from './object/get.mjs';
 export { set } from './object/set.mjs';
 export { pick } from './object/pick.mjs';
@@ -156,11 +154,14 @@ export { conforms } from './predicate/conforms.mjs';
 export { conformsTo } from './predicate/conformsTo.mjs';
 export { isInteger } from './predicate/isInteger.mjs';
 export { isSafeInteger } from './predicate/isSafeInteger.mjs';
+export { isNumber } from './predicate/isNumber.mjs';
+export { isNaN } from './predicate/isNaN.mjs';
 export { camelCase } from './string/camelCase.mjs';
 export { kebabCase } from './string/kebabCase.mjs';
 export { snakeCase } from './string/snakeCase.mjs';
 export { startCase } from './string/startCase.mjs';
 export { lowerCase } from './string/lowerCase.mjs';
+export { upperCase } from './string/upperCase.mjs';
 export { startsWith } from './string/startsWith.mjs';
 export { endsWith } from './string/endsWith.mjs';
 export { padStart } from './string/padStart.mjs';
@@ -169,6 +170,7 @@ export { repeat } from './string/repeat.mjs';
 export { trim } from './string/trim.mjs';
 export { trimStart } from './string/trimStart.mjs';
 export { trimEnd } from './string/trimEnd.mjs';
+export { clamp } from './math/clamp.mjs';
 export { max } from './math/max.mjs';
 export { min } from './math/min.mjs';
 export { ceil } from './math/ceil.mjs';

package/dist/compat/math/clamp.d.mts

@@ -0,0 +1,32 @@
+/**
+ * Clamps a number within the inclusive upper bound.
+ *
+ * This function takes a number and a maximum bound, and returns the number clamped within the specified upper bound.
+ * If only one bound is provided, it returns the minimum of the value and the bound.
+ *
+ * @param {number} value - The number to clamp.
+ * @param {number} maximum - The maximum bound to clamp the number.
+ * @returns {number} The clamped number within the specified upper bound.
+ *
+ * @example
+ * const result1 = clamp(10, 5); // result1 will be 5, as 10 is clamped to the bound 5
+ */
+declare function clamp(value: number, maximum: number): number;
+/**
+ * Clamps a number within the inclusive lower and upper bounds.
+ *
+ * This function takes a number and two bounds, and returns the number clamped within the specified bounds.
+ *
+ * @param {number} value - The number to clamp.
+ * @param {number} minimum - The minimum bound to clamp the number.
+ * @param {number} maximum - The maximum bound to clamp the number.
+ * @returns {number} The clamped number within the specified bounds.
+ *
+ * @example
+ * const result2 = clamp(10, 5, 15); // result2 will be 10, as it is within the bounds 5 and 15
+ * const result3 = clamp(2, 5, 15); // result3 will be 5, as 2 is clamped to the lower bound 5
+ * const result4 = clamp(20, 5, 15); // result4 will be 15, as 20 is clamped to the upper bound 15
+ */
+declare function clamp(value: number, minimum: number, maximum: number): number;
+
+export { clamp };

package/dist/compat/math/clamp.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Clamps a number within the inclusive upper bound.
+ *
+ * This function takes a number and a maximum bound, and returns the number clamped within the specified upper bound.
+ * If only one bound is provided, it returns the minimum of the value and the bound.
+ *
+ * @param {number} value - The number to clamp.
+ * @param {number} maximum - The maximum bound to clamp the number.
+ * @returns {number} The clamped number within the specified upper bound.
+ *
+ * @example
+ * const result1 = clamp(10, 5); // result1 will be 5, as 10 is clamped to the bound 5
+ */
+declare function clamp(value: number, maximum: number): number;
+/**
+ * Clamps a number within the inclusive lower and upper bounds.
+ *
+ * This function takes a number and two bounds, and returns the number clamped within the specified bounds.
+ *
+ * @param {number} value - The number to clamp.
+ * @param {number} minimum - The minimum bound to clamp the number.
+ * @param {number} maximum - The maximum bound to clamp the number.
+ * @returns {number} The clamped number within the specified bounds.
+ *
+ * @example
+ * const result2 = clamp(10, 5, 15); // result2 will be 10, as it is within the bounds 5 and 15
+ * const result3 = clamp(2, 5, 15); // result3 will be 5, as 2 is clamped to the lower bound 5
+ * const result4 = clamp(20, 5, 15); // result4 will be 15, as 20 is clamped to the upper bound 15
+ */
+declare function clamp(value: number, minimum: number, maximum: number): number;
+
+export { clamp };

package/dist/compat/math/clamp.mjs

@@ -0,0 +1,13 @@
+import { clamp as clamp$1 } from '../../math/clamp.mjs';
+
+function clamp(value, bound1, bound2) {
+    if (Number.isNaN(bound1)) {
+        bound1 = 0;
+    }
+    if (Number.isNaN(bound2)) {
+        bound2 = 0;
+    }
+    return clamp$1(value, bound1, bound2);
+}
+
+export { clamp };

package/dist/compat/predicate/isNaN.d.mts

@@ -0,0 +1,15 @@
+/**
+ * Checks if the value is NaN.
+ *
+ * @param {unknown} value - The value to check.
+ * @returns {value is typeof NaN} `true` if the value is NaN, `false` otherwise.
+ *
+ * @example
+ * isNaN(NaN); // true
+ * isNaN(0); // false
+ * isNaN('NaN'); // false
+ * isNaN(undefined); // false
+ */
+declare function isNaN(value: unknown): value is typeof NaN;
+
+export { isNaN };

package/dist/compat/predicate/isNaN.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Checks if the value is NaN.
+ *
+ * @param {unknown} value - The value to check.
+ * @returns {value is typeof NaN} `true` if the value is NaN, `false` otherwise.
+ *
+ * @example
+ * isNaN(NaN); // true
+ * isNaN(0); // false
+ * isNaN('NaN'); // false
+ * isNaN(undefined); // false
+ */
+declare function isNaN(value: unknown): value is typeof NaN;
+
+export { isNaN };

package/dist/compat/predicate/isNaN.mjs

@@ -0,0 +1,5 @@
+function isNaN(value) {
+    return Number.isNaN(value);
+}
+
+export { isNaN };

package/dist/compat/predicate/isNumber.d.mts

@@ -0,0 +1,20 @@
+/**
+ * Checks if a given value is a number.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to `number`.
+ *
+ * @param {unknown} value The value to check if it is a number.
+ * @returns {value is number} Returns `true` if `value` is a number, else `false`.
+ *
+ * @example
+ * const value1 = 123;
+ * const value2 = 'abc';
+ * const value3 = true;
+ *
+ * console.log(isNumber(value1)); // true
+ * console.log(isNumber(value2)); // false
+ * console.log(isNumber(value3)); // false
+ */
+declare function isNumber(value?: unknown): value is number;
+
+export { isNumber };

package/dist/compat/predicate/isNumber.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Checks if a given value is a number.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to `number`.
+ *
+ * @param {unknown} value The value to check if it is a number.
+ * @returns {value is number} Returns `true` if `value` is a number, else `false`.
+ *
+ * @example
+ * const value1 = 123;
+ * const value2 = 'abc';
+ * const value3 = true;
+ *
+ * console.log(isNumber(value1)); // true
+ * console.log(isNumber(value2)); // false
+ * console.log(isNumber(value3)); // false
+ */
+declare function isNumber(value?: unknown): value is number;
+
+export { isNumber };

package/dist/compat/predicate/isNumber.mjs

@@ -0,0 +1,10 @@
+import { getTag } from '../_internal/getTag.mjs';
+
+function isNumber(value) {
+    if (typeof value === 'object' && value != null && getTag(value) === '[object Number]') {
+        return true;
+    }
+    return typeof value === 'number';
+}
+
+export { isNumber };

package/dist/compat/string/camelCase.d.mts

@@ -13,6 +13,6 @@
  * const convertedStr3 = camelCase('hyphen-text') // returns 'hyphenText'
  * const convertedStr4 = camelCase('HTTPRequest') // returns 'httpRequest'
  */
-declare function camelCase(str: string | object): string;
+declare function camelCase(str?: string | object): string;
 
 export { camelCase };