es-toolkit 1.19.0-dev.619 → 1.19.0-dev.621

package/dist/compat/array/findLastIndex.mjs

@@ -2,30 +2,30 @@ import { property } from '../object/property.mjs';
 import { matches } from '../predicate/matches.mjs';
 import { matchesProperty } from '../predicate/matchesProperty.mjs';
 
-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));
         }
     }
 }

package/dist/compat/array/some.d.mts

@@ -65,7 +65,6 @@ declare function some<T>(arr: readonly T[], doesMatch: Partial<T>): boolean;
  * @param {T[]} arr The array to iterate over.
  * @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | string} [predicate=identity] The function invoked per iteration.
  * If a property name or an object is provided it will be used to create a predicate function.
- * @param guard
  * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
  *
  * @example

package/dist/compat/array/some.d.ts

@@ -65,7 +65,6 @@ declare function some<T>(arr: readonly T[], doesMatch: Partial<T>): boolean;
  * @param {T[]} arr The array to iterate over.
  * @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | string} [predicate=identity] The function invoked per iteration.
  * If a property name or an object is provided it will be used to create a predicate function.
- * @param guard
  * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
  *
  * @example

package/dist/compat/function/throttle.d.mts

@@ -14,6 +14,36 @@ interface ThrottleOptions {
      */
     trailing?: boolean;
 }
+/**
+ * Creates a throttled function that only invokes the provided function at most once
+ * per every `throttleMs` milliseconds. Subsequent calls to the throttled function
+ * within the wait time will not trigger the execution of the original function.
+ *
+ * @template F - The type of function.
+ * @param {F} func - The function to throttle.
+ * @param {number} throttleMs - The number of milliseconds to throttle executions to.
+ * @param {ThrottleOptions} options - The options object
+ * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the throttled function.
+ * @param {boolean} options.leading - If `true`, the function will be invoked on the leading edge of the timeout.
+ * @param {boolean} options.trailing - If `true`, the function will be invoked on the trailing edge of the timeout.
+ * @returns {(...args: Parameters<F>) => void} A new throttled function that accepts the same parameters as the original function.
+ *
+ * @example
+ * const throttledFunction = throttle(() => {
+ *   console.log('Function executed');
+ * }, 1000);
+ *
+ * // Will log 'Function executed' immediately
+ * throttledFunction();
+ *
+ * // Will not log anything as it is within the throttle time
+ * throttledFunction();
+ *
+ * // After 1 second
+ * setTimeout(() => {
+ *   throttledFunction(); // Will log 'Function executed'
+ * }, 1000);
+ */
 declare function throttle<F extends (...args: any[]) => any>(func: F, throttleMs?: number, options?: ThrottleOptions): ((...args: Parameters<F>) => ReturnType<F> | undefined) & {
     cancel: () => void;
     flush: () => void;

package/dist/compat/function/throttle.d.ts

@@ -14,6 +14,36 @@ interface ThrottleOptions {
      */
     trailing?: boolean;
 }
+/**
+ * Creates a throttled function that only invokes the provided function at most once
+ * per every `throttleMs` milliseconds. Subsequent calls to the throttled function
+ * within the wait time will not trigger the execution of the original function.
+ *
+ * @template F - The type of function.
+ * @param {F} func - The function to throttle.
+ * @param {number} throttleMs - The number of milliseconds to throttle executions to.
+ * @param {ThrottleOptions} options - The options object
+ * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the throttled function.
+ * @param {boolean} options.leading - If `true`, the function will be invoked on the leading edge of the timeout.
+ * @param {boolean} options.trailing - If `true`, the function will be invoked on the trailing edge of the timeout.
+ * @returns {(...args: Parameters<F>) => void} A new throttled function that accepts the same parameters as the original function.
+ *
+ * @example
+ * const throttledFunction = throttle(() => {
+ *   console.log('Function executed');
+ * }, 1000);
+ *
+ * // Will log 'Function executed' immediately
+ * throttledFunction();
+ *
+ * // Will not log anything as it is within the throttle time
+ * throttledFunction();
+ *
+ * // After 1 second
+ * setTimeout(() => {
+ *   throttledFunction(); // Will log 'Function executed'
+ * }, 1000);
+ */
 declare function throttle<F extends (...args: any[]) => any>(func: F, throttleMs?: number, options?: ThrottleOptions): ((...args: Parameters<F>) => ReturnType<F> | undefined) & {
     cancel: () => void;
     flush: () => void;

package/dist/compat/index.d.mts

@@ -75,7 +75,6 @@ export { cloneDeep } from '../object/cloneDeep.mjs';
 export { toMerged } from '../object/toMerged.mjs';
 export { isDate } from '../predicate/isDate.mjs';
 export { isEqual } from '../predicate/isEqual.mjs';
-export { isNaN } from '../predicate/isNaN.mjs';
 export { isNil } from '../predicate/isNil.mjs';
 export { isNotNil } from '../predicate/isNotNil.mjs';
 export { isNull } from '../predicate/isNull.mjs';
@@ -83,11 +82,9 @@ export { isUndefined } from '../predicate/isUndefined.mjs';
 export { isLength } from '../predicate/isLength.mjs';
 export { isFunction } from '../predicate/isFunction.mjs';
 export { isPrimitive } from '../predicate/isPrimitive.mjs';
-export { isNumber } from '../predicate/isNumber.mjs';
 export { delay } from '../promise/delay.mjs';
 export { withTimeout } from '../promise/withTimeout.mjs';
 export { timeout } from '../promise/timeout.mjs';
-export { upperCase } from '../string/upperCase.mjs';
 export { capitalize } from '../string/capitalize.mjs';
 export { pascalCase } from '../string/pascalCase.mjs';
 export { upperFirst } from '../string/upperFirst.mjs';
@@ -158,11 +155,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';

package/dist/compat/index.d.ts

@@ -75,7 +75,6 @@ export { cloneDeep } from '../object/cloneDeep.js';
 export { toMerged } from '../object/toMerged.js';
 export { isDate } from '../predicate/isDate.js';
 export { isEqual } from '../predicate/isEqual.js';
-export { isNaN } from '../predicate/isNaN.js';
 export { isNil } from '../predicate/isNil.js';
 export { isNotNil } from '../predicate/isNotNil.js';
 export { isNull } from '../predicate/isNull.js';
@@ -83,11 +82,9 @@ export { isUndefined } from '../predicate/isUndefined.js';
 export { isLength } from '../predicate/isLength.js';
 export { isFunction } from '../predicate/isFunction.js';
 export { isPrimitive } from '../predicate/isPrimitive.js';
-export { isNumber } from '../predicate/isNumber.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';
@@ -158,11 +155,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';

package/dist/compat/index.js

@@ -8,7 +8,7 @@ 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');
-const isNumber = require('../_chunk/isNumber-CM_Bs0.js');
+const isWeakSet$1 = require('../_chunk/isWeakSet-E_VMwB.js');
 const isPlainObject$1 = require('../_chunk/isPlainObject-BIekvL.js');
 const string_index = require('../string/index.js');
 
@@ -287,14 +287,14 @@ function cloneDeep(obj) {
         return toMerged.cloneDeep(obj);
     }
     switch (Object.prototype.toString.call(obj)) {
-        case isNumber.numberTag:
-        case isNumber.stringTag:
-        case isNumber.booleanTag: {
+        case isWeakSet$1.numberTag:
+        case isWeakSet$1.stringTag:
+        case isWeakSet$1.booleanTag: {
             const result = new obj.constructor(obj?.valueOf());
             toMerged.copyProperties(result, obj);
             return result;
         }
-        case isNumber.argumentsTag: {
+        case isWeakSet$1.argumentsTag: {
             const result = {};
             toMerged.copyProperties(result, obj);
             result.length = obj.length;
@@ -323,7 +323,7 @@ function isIndex(value) {
 }
 
 function isArguments(value) {
-    return value !== null && typeof value === 'object' && isNumber.getTag(value) === '[object Arguments]';
+    return value !== null && typeof value === 'object' && isWeakSet$1.getTag(value) === '[object Arguments]';
 }
 
 function has(object, path) {
@@ -438,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));
         }
     }
 }
@@ -651,7 +651,7 @@ function sortBy(collection, criteria) {
 }
 
 function size(target) {
-    if (isNumber.isNil(target)) {
+    if (isWeakSet$1.isNil(target)) {
         return 0;
     }
     if (target instanceof Map || target instanceof Set) {
@@ -1158,7 +1158,7 @@ function mergeWithDeep(target, source, merge, stack) {
             source[i] = source[i] ?? undefined;
         }
     }
-    const sourceKeys = [...Object.keys(source), ...isNumber.getSymbols(source)];
+    const sourceKeys = [...Object.keys(source), ...isWeakSet$1.getSymbols(source)];
     for (let i = 0; i < sourceKeys.length; i++) {
         const key = sourceKeys[i];
         let sourceValue = source[key];
@@ -1214,7 +1214,7 @@ function merge(object, ...sources) {
 }
 
 function isArrayLike(value) {
-    return value != null && typeof value !== 'function' && isNumber.isLength(value.length);
+    return value != null && typeof value !== 'function' && isWeakSet$1.isLength(value.length);
 }
 
 function fromPairs(pairs) {
@@ -1240,32 +1240,32 @@ function isBoolean(x) {
     if (x === true || x === false) {
         return true;
     }
-    if (typeof x === 'object' && x != null && isNumber.getTag(x) === '[object Boolean]') {
+    if (typeof x === 'object' && x != null && isWeakSet$1.getTag(x) === '[object Boolean]') {
         return true;
     }
     return false;
 }
 
 function isRegExp(value) {
-    return isNumber.getTag(value) === '[object RegExp]';
+    return isWeakSet$1.getTag(value) === '[object RegExp]';
 }
 
 function isString(value) {
     if (typeof value === 'string') {
         return true;
     }
-    if (typeof value === 'object' && value != null && isNumber.getTag(value) === '[object String]') {
+    if (typeof value === 'object' && value != null && isWeakSet$1.getTag(value) === '[object String]') {
         return true;
     }
     return false;
 }
 
 function isWeakMap(value) {
-    return isNumber.isWeakMap(value);
+    return isWeakSet$1.isWeakMap(value);
 }
 
 function isWeakSet(value) {
-    return isNumber.isWeakSet(value);
+    return isWeakSet$1.isWeakSet(value);
 }
 
 function conformsTo(target, source) {
@@ -1300,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 '';
@@ -1341,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);
 }
@@ -1568,16 +1583,14 @@ exports.isObjectLike = toMerged.isObjectLike;
 exports.omitBy = toMerged.omitBy;
 exports.pickBy = toMerged.pickBy;
 exports.toMerged = toMerged.toMerged;
-exports.isDate = isNumber.isDate;
-exports.isEqual = isNumber.isEqual;
-exports.isFunction = isNumber.isFunction;
-exports.isLength = isNumber.isLength;
-exports.isNaN = isNumber.isNaN;
-exports.isNil = isNumber.isNil;
-exports.isNotNil = isNumber.isNotNil;
-exports.isNull = isNumber.isNull;
-exports.isNumber = isNumber.isNumber;
-exports.isUndefined = isNumber.isUndefined;
+exports.isDate = isWeakSet$1.isDate;
+exports.isEqual = isWeakSet$1.isEqual;
+exports.isFunction = isWeakSet$1.isFunction;
+exports.isLength = isWeakSet$1.isLength;
+exports.isNil = isWeakSet$1.isNil;
+exports.isNotNil = isWeakSet$1.isNotNil;
+exports.isNull = isWeakSet$1.isNull;
+exports.isUndefined = isWeakSet$1.isUndefined;
 exports.isPrimitive = isPlainObject$1.isPrimitive;
 exports.capitalize = string_index.capitalize;
 exports.deburr = string_index.deburr;
@@ -1587,7 +1600,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;
@@ -1623,6 +1635,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;
@@ -1669,4 +1683,5 @@ exports.trim = trim;
 exports.trimEnd = trimEnd;
 exports.trimStart = trimStart;
 exports.unset = unset;
+exports.upperCase = upperCase;
 exports.zipObjectDeep = zipObjectDeep;

package/dist/compat/index.mjs

@@ -76,7 +76,6 @@ export { isObjectLike } from './predicate/isObjectLike.mjs';
 export { toMerged } from '../object/toMerged.mjs';
 export { isDate } from '../predicate/isDate.mjs';
 export { isEqual } from '../predicate/isEqual.mjs';
-export { isNaN } from '../predicate/isNaN.mjs';
 export { isNil } from '../predicate/isNil.mjs';
 export { isNotNil } from '../predicate/isNotNil.mjs';
 export { isNull } from '../predicate/isNull.mjs';
@@ -84,12 +83,10 @@ export { isUndefined } from '../predicate/isUndefined.mjs';
 export { isLength } from '../predicate/isLength.mjs';
 export { isFunction } from '../predicate/isFunction.mjs';
 export { isPrimitive } from '../predicate/isPrimitive.mjs';
-export { isNumber } from '../predicate/isNumber.mjs';
 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';
@@ -158,11 +155,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';

package/dist/{predicate → compat/predicate}/isNumber.d.mts

@@ -15,6 +15,6 @@
  * console.log(isNumber(value2)); // false
  * console.log(isNumber(value3)); // false
  */
-declare function isNumber(value: unknown): value is number;
+declare function isNumber(value?: unknown): value is number;
 
 export { isNumber };

package/dist/{predicate → compat/predicate}/isNumber.d.ts

@@ -15,6 +15,6 @@
  * console.log(isNumber(value2)); // false
  * console.log(isNumber(value3)); // false
  */
-declare function isNumber(value: unknown): value is number;
+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 };

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

@@ -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 };

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

@@ -3,7 +3,7 @@
  *
  * Kebab case is the naming convention in which each word is written in lowercase and separated by a dash (-) character.
  *
- * @param {string} str - The string that is to be changed to kebab case.
+ * @param {string | object} str - The string that is to be changed to kebab case.
  * @returns {string} - The converted string to kebab case.
  *
  * @example
@@ -12,6 +12,6 @@
  * const convertedStr3 = kebabCase('hyphen-text') // returns 'hyphen-text'
  * const convertedStr4 = kebabCase('HTTPRequest') // returns 'http-request'
  */
-declare function kebabCase(str: string | object): string;
+declare function kebabCase(str?: string | object): string;
 
 export { kebabCase };

package/dist/compat/string/kebabCase.d.ts

@@ -3,7 +3,7 @@
  *
  * Kebab case is the naming convention in which each word is written in lowercase and separated by a dash (-) character.
  *
- * @param {string} str - The string that is to be changed to kebab case.
+ * @param {string | object} str - The string that is to be changed to kebab case.
  * @returns {string} - The converted string to kebab case.
  *
  * @example
@@ -12,6 +12,6 @@
  * const convertedStr3 = kebabCase('hyphen-text') // returns 'hyphen-text'
  * const convertedStr4 = kebabCase('HTTPRequest') // returns 'http-request'
  */
-declare function kebabCase(str: string | object): string;
+declare function kebabCase(str?: string | object): string;
 
 export { kebabCase };

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

@@ -3,7 +3,7 @@
  *
  * Lower case is the naming convention in which each word is written in lowercase and separated by an space ( ) character.
  *
- * @param {string} str - The string that is to be changed to lower case.
+ * @param {string | object} str - The string that is to be changed to lower case.
  * @returns {string} - The converted string to lower case.
  *
  * @example
@@ -12,6 +12,6 @@
  * const convertedStr3 = lowerCase('hyphen-text') // returns 'hyphen text'
  * const convertedStr4 = lowerCase('HTTPRequest') // returns 'http request'
  */
-declare function lowerCase(str: string | object): string;
+declare function lowerCase(str?: string | object): string;
 
 export { lowerCase };

package/dist/compat/string/lowerCase.d.ts

@@ -3,7 +3,7 @@
  *
  * Lower case is the naming convention in which each word is written in lowercase and separated by an space ( ) character.
  *
- * @param {string} str - The string that is to be changed to lower case.
+ * @param {string | object} str - The string that is to be changed to lower case.
  * @returns {string} - The converted string to lower case.
  *
  * @example
@@ -12,6 +12,6 @@
  * const convertedStr3 = lowerCase('hyphen-text') // returns 'hyphen text'
  * const convertedStr4 = lowerCase('HTTPRequest') // returns 'http request'
  */
-declare function lowerCase(str: string | object): string;
+declare function lowerCase(str?: string | object): string;
 
 export { lowerCase };

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

@@ -3,7 +3,7 @@
  *
  * Snake case is the naming convention in which each word is written in lowercase and separated by an underscore (_) character.
  *
- * @param {string} str - The string that is to be changed to snake case.
+ * @param {string | object} str - The string that is to be changed to snake case.
  * @returns {string} - The converted string to snake case.
  *
  * @example
@@ -12,6 +12,6 @@
  * const convertedStr3 = snakeCase('hyphen-text') // returns 'hyphen_text'
  * const convertedStr4 = snakeCase('HTTPRequest') // returns 'http_request'
  */
-declare function snakeCase(str: string | object): string;
+declare function snakeCase(str?: string | object): string;
 
 export { snakeCase };

package/dist/compat/string/snakeCase.d.ts

@@ -3,7 +3,7 @@
  *
  * Snake case is the naming convention in which each word is written in lowercase and separated by an underscore (_) character.
  *
- * @param {string} str - The string that is to be changed to snake case.
+ * @param {string | object} str - The string that is to be changed to snake case.
  * @returns {string} - The converted string to snake case.
  *
  * @example
@@ -12,6 +12,6 @@
  * const convertedStr3 = snakeCase('hyphen-text') // returns 'hyphen_text'
  * const convertedStr4 = snakeCase('HTTPRequest') // returns 'http_request'
  */
-declare function snakeCase(str: string | object): string;
+declare function snakeCase(str?: string | object): string;
 
 export { snakeCase };

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

@@ -2,7 +2,7 @@
  * Converts the first character of each word in a string to uppercase and the remaining characters to lowercase.
  *
  * Start case is the naming convention in which each word is written with an initial capital letter.
- * @param {string} str - The string to convert.
+ * @param {string | object} str - The string to convert.
  * @returns {string} The converted string.
  *
  * @example
@@ -11,6 +11,6 @@
  * const result3 = startCase('hello-world');  // result will be 'Hello World'
  * const result4 = startCase('hello_world');  // result will be 'Hello World'
  */
-declare function startCase(str: string | object): string;
+declare function startCase(str?: string | object): string;
 
 export { startCase };

package/dist/compat/string/startCase.d.ts

@@ -2,7 +2,7 @@
  * Converts the first character of each word in a string to uppercase and the remaining characters to lowercase.
  *
  * Start case is the naming convention in which each word is written with an initial capital letter.
- * @param {string} str - The string to convert.
+ * @param {string | object} str - The string to convert.
  * @returns {string} The converted string.
  *
  * @example
@@ -11,6 +11,6 @@
  * const result3 = startCase('hello-world');  // result will be 'Hello World'
  * const result4 = startCase('hello_world');  // result will be 'Hello World'
  */
-declare function startCase(str: string | object): string;
+declare function startCase(str?: string | object): string;
 
 export { startCase };

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

@@ -3,7 +3,6 @@
  *
  * @param {string} str - The string from which leading and trailing characters will be trimmed.
  * @param {string | string[]} chars - The character(s) to remove from the end of the string. Defaults to `" "`.
- * @param guard
  * @returns {string} - The resulting string after the specified leading and trailing characters have been removed.
  *
  * @example