es-toolkit 1.47.0-dev.1841 → 1.47.0-dev.1842

package/dist/compat/function/bind.mjs

@@ -6,10 +6,10 @@
 *
 * Note: Unlike native `Function#bind`, this method doesn't set the `length` property of bound functions.
 *
-* @param {(...args: any[]) => any} func - The function to bind.
-* @param {any} thisObj - The `this` binding of `func`.
-* @param {...any} partialArgs - The arguments to be partially applied.
-* @returns {(...args: any[]) => any} - Returns the new bound function.
+* @param func - The function to bind.
+* @param thisObj - The `this` binding of `func`.
+* @param partialArgs - The arguments to be partially applied.
+* @returns Returns the new bound function.
 *
 * @example
 * function greet(greeting, punctuation) {

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

@@ -8,10 +8,10 @@
  *
  * @template T - The type of the object to bind.
  * @template K - The type of the key to bind.
- * @param {T} object - The object to invoke the method on.
- * @param {K} key - The key of the method.
- * @param {...any} partialArgs - The arguments to be partially applied.
- * @returns {T[K] extends (...args: any[]) => any ? (...args: any[]) => ReturnType<T[K]> : never} - Returns the new bound function.
+ * @param object - The object to invoke the method on.
+ * @param key - The key of the method.
+ * @param partialArgs - The arguments to be partially applied.
+ * @returns Returns the new bound function.
  *
  * @example
  * const object = {

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

@@ -8,10 +8,10 @@
  *
  * @template T - The type of the object to bind.
  * @template K - The type of the key to bind.
- * @param {T} object - The object to invoke the method on.
- * @param {K} key - The key of the method.
- * @param {...any} partialArgs - The arguments to be partially applied.
- * @returns {T[K] extends (...args: any[]) => any ? (...args: any[]) => ReturnType<T[K]> : never} - Returns the new bound function.
+ * @param object - The object to invoke the method on.
+ * @param key - The key of the method.
+ * @param partialArgs - The arguments to be partially applied.
+ * @returns Returns the new bound function.
  *
  * @example
  * const object = {

package/dist/compat/function/bindKey.js

@@ -8,10 +8,10 @@
 *
 * @template T - The type of the object to bind.
 * @template K - The type of the key to bind.
-* @param {T} object - The object to invoke the method on.
-* @param {K} key - The key of the method.
-* @param {...any} partialArgs - The arguments to be partially applied.
-* @returns {T[K] extends (...args: any[]) => any ? (...args: any[]) => ReturnType<T[K]> : never} - Returns the new bound function.
+* @param object - The object to invoke the method on.
+* @param key - The key of the method.
+* @param partialArgs - The arguments to be partially applied.
+* @returns Returns the new bound function.
 *
 * @example
 * const object = {

package/dist/compat/function/bindKey.mjs

@@ -8,10 +8,10 @@
 *
 * @template T - The type of the object to bind.
 * @template K - The type of the key to bind.
-* @param {T} object - The object to invoke the method on.
-* @param {K} key - The key of the method.
-* @param {...any} partialArgs - The arguments to be partially applied.
-* @returns {T[K] extends (...args: any[]) => any ? (...args: any[]) => ReturnType<T[K]> : never} - Returns the new bound function.
+* @param object - The object to invoke the method on.
+* @param key - The key of the method.
+* @param partialArgs - The arguments to be partially applied.
+* @returns Returns the new bound function.
 *
 * @example
 * const object = {

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

@@ -74,9 +74,9 @@ interface CurriedFunction5<T1, T2, T3, T4, T5, R> {
 }
 /**
  * Creates a curried function that accepts a single argument.
- * @param {(t1: T1) => R} func - The function to curry.
- * @param {number=func.length} arity - The arity of func.
- * @returns {CurriedFunction1<T1, R>} - Returns the new curried function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func.
+ * @returns Returns the new curried function.
  * @example
  * const greet = (name: string) => `Hello ${name}`;
  * const curriedGreet = curry(greet);
@@ -85,9 +85,9 @@ interface CurriedFunction5<T1, T2, T3, T4, T5, R> {
 declare function curry<T1, R>(func: (t1: T1) => R, arity?: number): CurriedFunction1<T1, R>;
 /**
  * Creates a curried function that accepts two arguments.
- * @param {(t1: T1, t2: T2) => R} func - The function to curry.
- * @param {number=func.length} arity - The arity of func.
- * @returns {CurriedFunction2<T1, T2, R>} - Returns the new curried function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func.
+ * @returns Returns the new curried function.
  * @example
  * const add = (a: number, b: number) => a + b;
  * const curriedAdd = curry(add);
@@ -97,9 +97,9 @@ declare function curry<T1, R>(func: (t1: T1) => R, arity?: number): CurriedFunct
 declare function curry<T1, T2, R>(func: (t1: T1, t2: T2) => R, arity?: number): CurriedFunction2<T1, T2, R>;
 /**
  * Creates a curried function that accepts three arguments.
- * @param {(t1: T1, t2: T2, t3: T3) => R} func - The function to curry.
- * @param {number=func.length} arity - The arity of func.
- * @returns {CurriedFunction3<T1, T2, T3, R>} - Returns the new curried function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func.
+ * @returns Returns the new curried function.
  * @example
  * const volume = (l: number, w: number, h: number) => l * w * h;
  * const curriedVolume = curry(volume);
@@ -110,9 +110,9 @@ declare function curry<T1, T2, R>(func: (t1: T1, t2: T2) => R, arity?: number):
 declare function curry<T1, T2, T3, R>(func: (t1: T1, t2: T2, t3: T3) => R, arity?: number): CurriedFunction3<T1, T2, T3, R>;
 /**
  * Creates a curried function that accepts four arguments.
- * @param {(t1: T1, t2: T2, t3: T3, t4: T4) => R} func - The function to curry.
- * @param {number=func.length} arity - The arity of func.
- * @returns {CurriedFunction4<T1, T2, T3, T4, R>} - Returns the new curried function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func.
+ * @returns Returns the new curried function.
  * @example
  * const fn = (a: number, b: number, c: number, d: number) => a + b + c + d;
  * const curriedFn = curry(fn);
@@ -123,9 +123,9 @@ declare function curry<T1, T2, T3, R>(func: (t1: T1, t2: T2, t3: T3) => R, arity
 declare function curry<T1, T2, T3, T4, R>(func: (t1: T1, t2: T2, t3: T3, t4: T4) => R, arity?: number): CurriedFunction4<T1, T2, T3, T4, R>;
 /**
  * Creates a curried function that accepts five arguments.
- * @param {(t1: T1, t2: T2, t3: T3, t4: T4, t5: T5) => R} func - The function to curry.
- * @param {number=func.length} arity - The arity of func.
- * @returns {CurriedFunction5<T1, T2, T3, T4, T5, R>} - Returns the new curried function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func.
+ * @returns Returns the new curried function.
  * @example
  * const fn = (a: number, b: number, c: number, d: number, e: number) => a + b + c + d + e;
  * const curriedFn = curry(fn);
@@ -136,9 +136,9 @@ declare function curry<T1, T2, T3, T4, R>(func: (t1: T1, t2: T2, t3: T3, t4: T4)
 declare function curry<T1, T2, T3, T4, T5, R>(func: (t1: T1, t2: T2, t3: T3, t4: T4, t5: T5) => R, arity?: number): CurriedFunction5<T1, T2, T3, T4, T5, R>;
 /**
  * Creates a curried function that accepts any number of arguments.
- * @param {(...args: any[]) => any} func - The function to curry.
- * @param {number=func.length} arity - The arity of func.
- * @returns {(...args: any[]) => any} - Returns the new curried function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func.
+ * @returns Returns the new curried function.
  * @example
  * const sum = (...args: number[]) => args.reduce((a, b) => a + b, 0);
  * const curriedSum = curry(sum);

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

@@ -74,9 +74,9 @@ interface CurriedFunction5<T1, T2, T3, T4, T5, R> {
 }
 /**
  * Creates a curried function that accepts a single argument.
- * @param {(t1: T1) => R} func - The function to curry.
- * @param {number=func.length} arity - The arity of func.
- * @returns {CurriedFunction1<T1, R>} - Returns the new curried function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func.
+ * @returns Returns the new curried function.
  * @example
  * const greet = (name: string) => `Hello ${name}`;
  * const curriedGreet = curry(greet);
@@ -85,9 +85,9 @@ interface CurriedFunction5<T1, T2, T3, T4, T5, R> {
 declare function curry<T1, R>(func: (t1: T1) => R, arity?: number): CurriedFunction1<T1, R>;
 /**
  * Creates a curried function that accepts two arguments.
- * @param {(t1: T1, t2: T2) => R} func - The function to curry.
- * @param {number=func.length} arity - The arity of func.
- * @returns {CurriedFunction2<T1, T2, R>} - Returns the new curried function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func.
+ * @returns Returns the new curried function.
  * @example
  * const add = (a: number, b: number) => a + b;
  * const curriedAdd = curry(add);
@@ -97,9 +97,9 @@ declare function curry<T1, R>(func: (t1: T1) => R, arity?: number): CurriedFunct
 declare function curry<T1, T2, R>(func: (t1: T1, t2: T2) => R, arity?: number): CurriedFunction2<T1, T2, R>;
 /**
  * Creates a curried function that accepts three arguments.
- * @param {(t1: T1, t2: T2, t3: T3) => R} func - The function to curry.
- * @param {number=func.length} arity - The arity of func.
- * @returns {CurriedFunction3<T1, T2, T3, R>} - Returns the new curried function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func.
+ * @returns Returns the new curried function.
  * @example
  * const volume = (l: number, w: number, h: number) => l * w * h;
  * const curriedVolume = curry(volume);
@@ -110,9 +110,9 @@ declare function curry<T1, T2, R>(func: (t1: T1, t2: T2) => R, arity?: number):
 declare function curry<T1, T2, T3, R>(func: (t1: T1, t2: T2, t3: T3) => R, arity?: number): CurriedFunction3<T1, T2, T3, R>;
 /**
  * Creates a curried function that accepts four arguments.
- * @param {(t1: T1, t2: T2, t3: T3, t4: T4) => R} func - The function to curry.
- * @param {number=func.length} arity - The arity of func.
- * @returns {CurriedFunction4<T1, T2, T3, T4, R>} - Returns the new curried function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func.
+ * @returns Returns the new curried function.
  * @example
  * const fn = (a: number, b: number, c: number, d: number) => a + b + c + d;
  * const curriedFn = curry(fn);
@@ -123,9 +123,9 @@ declare function curry<T1, T2, T3, R>(func: (t1: T1, t2: T2, t3: T3) => R, arity
 declare function curry<T1, T2, T3, T4, R>(func: (t1: T1, t2: T2, t3: T3, t4: T4) => R, arity?: number): CurriedFunction4<T1, T2, T3, T4, R>;
 /**
  * Creates a curried function that accepts five arguments.
- * @param {(t1: T1, t2: T2, t3: T3, t4: T4, t5: T5) => R} func - The function to curry.
- * @param {number=func.length} arity - The arity of func.
- * @returns {CurriedFunction5<T1, T2, T3, T4, T5, R>} - Returns the new curried function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func.
+ * @returns Returns the new curried function.
  * @example
  * const fn = (a: number, b: number, c: number, d: number, e: number) => a + b + c + d + e;
  * const curriedFn = curry(fn);
@@ -136,9 +136,9 @@ declare function curry<T1, T2, T3, T4, R>(func: (t1: T1, t2: T2, t3: T3, t4: T4)
 declare function curry<T1, T2, T3, T4, T5, R>(func: (t1: T1, t2: T2, t3: T3, t4: T4, t5: T5) => R, arity?: number): CurriedFunction5<T1, T2, T3, T4, T5, R>;
 /**
  * Creates a curried function that accepts any number of arguments.
- * @param {(...args: any[]) => any} func - The function to curry.
- * @param {number=func.length} arity - The arity of func.
- * @returns {(...args: any[]) => any} - Returns the new curried function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func.
+ * @returns Returns the new curried function.
  * @example
  * const sum = (...args: number[]) => args.reduce((a, b) => a + b, 0);
  * const curriedSum = curry(sum);

package/dist/compat/function/curry.js

@@ -7,10 +7,10 @@
 *
 * Note: This method doesn't set the `length` property of curried functions.
 *
-* @param {(...args: any[]) => any} func - The function to curry.
-* @param {number=func.length} arity - The arity of func.
-* @param {unknown} guard - Enables use as an iteratee for methods like `Array#map`.
-* @returns {((...args: any[]) => any) & { placeholder: typeof curry.placeholder }} - Returns the new curried function.
+* @param func - The function to curry.
+* @param arity - The arity of func.
+* @param guard - Enables use as an iteratee for methods like `Array#map`.
+* @returns} - Returns the new curried function.
 *
 * @example
 * const abc = function(a, b, c) {

package/dist/compat/function/curry.mjs

@@ -7,10 +7,10 @@
 *
 * Note: This method doesn't set the `length` property of curried functions.
 *
-* @param {(...args: any[]) => any} func - The function to curry.
-* @param {number=func.length} arity - The arity of func.
-* @param {unknown} guard - Enables use as an iteratee for methods like `Array#map`.
-* @returns {((...args: any[]) => any) & { placeholder: typeof curry.placeholder }} - Returns the new curried function.
+* @param func - The function to curry.
+* @param arity - The arity of func.
+* @param guard - Enables use as an iteratee for methods like `Array#map`.
+* @returns} - Returns the new curried function.
 *
 * @example
 * const abc = function(a, b, c) {

package/dist/compat/function/curryRight.js

@@ -9,10 +9,10 @@
 *
 * Note: This method doesn't set the `length` property of curried functions.
 *
-* @param {(...args: any[]) => any} func - The function to curry.
-* @param {number=func.length} arity - The arity of func.
-* @param {unknown} guard - Enables use as an iteratee for methods like `Array#map`.
-* @returns {((...args: any[]) => any) & { placeholder: typeof curryRight.placeholder }} - Returns the new curried function.
+* @param func - The function to curry.
+* @param arity - The arity of func.
+* @param guard - Enables use as an iteratee for methods like `Array#map`.
+* @returns} - Returns the new curried function.
 *
 * @example
 * const abc = function(a, b, c) {

package/dist/compat/function/curryRight.mjs

@@ -9,10 +9,10 @@
 *
 * Note: This method doesn't set the `length` property of curried functions.
 *
-* @param {(...args: any[]) => any} func - The function to curry.
-* @param {number=func.length} arity - The arity of func.
-* @param {unknown} guard - Enables use as an iteratee for methods like `Array#map`.
-* @returns {((...args: any[]) => any) & { placeholder: typeof curryRight.placeholder }} - Returns the new curried function.
+* @param func - The function to curry.
+* @param arity - The arity of func.
+* @param guard - Enables use as an iteratee for methods like `Array#map`.
+* @returns} - Returns the new curried function.
 *
 * @example
 * const abc = function(a, b, c) {

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

@@ -61,13 +61,13 @@ interface DebouncedFuncLeading<T extends (...args: any[]) => any> extends Deboun
  * You can also set a `maxWait` time, which is the maximum time the function is allowed to be delayed before it is called.
  *
  * @template F - The type of function.
- * @param {F} func - The function to debounce.
- * @param {number} debounceMs - The number of milliseconds to delay.
- * @param {DebounceOptions} options - The options object
- * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the debounced 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.
- * @param {number} options.maxWait - The maximum time `func` is allowed to be delayed before it's invoked.
+ * @param func - The function to debounce.
+ * @param debounceMs - The number of milliseconds to delay.
+ * @param options - The options object
+ * @param options.signal - An optional AbortSignal to cancel the debounced function.
+ * @param options.leading - If `true`, the function will be invoked on the leading edge of the timeout.
+ * @param options.trailing - If `true`, the function will be invoked on the trailing edge of the timeout.
+ * @param options.maxWait - The maximum time `func` is allowed to be delayed before it's invoked.
  * @returns A new debounced function with a `cancel` method.
  *
  * @example
@@ -108,13 +108,13 @@ declare function debounce<T extends (...args: any) => any>(func: T, wait: number
  * You can also set a `maxWait` time, which is the maximum time the function is allowed to be delayed before it is called.
  *
  * @template F - The type of function.
- * @param {F} func - The function to debounce.
- * @param {number} debounceMs - The number of milliseconds to delay.
- * @param {DebounceOptions} options - The options object
- * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the debounced 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.
- * @param {number} options.maxWait - The maximum time `func` is allowed to be delayed before it's invoked.
+ * @param func - The function to debounce.
+ * @param debounceMs - The number of milliseconds to delay.
+ * @param options - The options object
+ * @param options.signal - An optional AbortSignal to cancel the debounced function.
+ * @param options.leading - If `true`, the function will be invoked on the leading edge of the timeout.
+ * @param options.trailing - If `true`, the function will be invoked on the trailing edge of the timeout.
+ * @param options.maxWait - The maximum time `func` is allowed to be delayed before it's invoked.
  * @returns A new debounced function with a `cancel` method.
  *
  * @example

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

@@ -61,13 +61,13 @@ interface DebouncedFuncLeading<T extends (...args: any[]) => any> extends Deboun
  * You can also set a `maxWait` time, which is the maximum time the function is allowed to be delayed before it is called.
  *
  * @template F - The type of function.
- * @param {F} func - The function to debounce.
- * @param {number} debounceMs - The number of milliseconds to delay.
- * @param {DebounceOptions} options - The options object
- * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the debounced 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.
- * @param {number} options.maxWait - The maximum time `func` is allowed to be delayed before it's invoked.
+ * @param func - The function to debounce.
+ * @param debounceMs - The number of milliseconds to delay.
+ * @param options - The options object
+ * @param options.signal - An optional AbortSignal to cancel the debounced function.
+ * @param options.leading - If `true`, the function will be invoked on the leading edge of the timeout.
+ * @param options.trailing - If `true`, the function will be invoked on the trailing edge of the timeout.
+ * @param options.maxWait - The maximum time `func` is allowed to be delayed before it's invoked.
  * @returns A new debounced function with a `cancel` method.
  *
  * @example
@@ -108,13 +108,13 @@ declare function debounce<T extends (...args: any) => any>(func: T, wait: number
  * You can also set a `maxWait` time, which is the maximum time the function is allowed to be delayed before it is called.
  *
  * @template F - The type of function.
- * @param {F} func - The function to debounce.
- * @param {number} debounceMs - The number of milliseconds to delay.
- * @param {DebounceOptions} options - The options object
- * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the debounced 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.
- * @param {number} options.maxWait - The maximum time `func` is allowed to be delayed before it's invoked.
+ * @param func - The function to debounce.
+ * @param debounceMs - The number of milliseconds to delay.
+ * @param options - The options object
+ * @param options.signal - An optional AbortSignal to cancel the debounced function.
+ * @param options.leading - If `true`, the function will be invoked on the leading edge of the timeout.
+ * @param options.trailing - If `true`, the function will be invoked on the trailing edge of the timeout.
+ * @param options.maxWait - The maximum time `func` is allowed to be delayed before it's invoked.
  * @returns A new debounced function with a `cancel` method.
  *
  * @example

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

@@ -2,9 +2,9 @@
 /**
  * Defers invoking the `func` until the current call stack has cleared. Any additional arguments are provided to func when it's invoked.
  *
- * @param {(...args: any[]) => any} func The function to defer.
- * @param {...any[]} args The arguments to invoke `func` with.
- * @returns {number} Returns the timer id.
+ * @param func The function to defer.
+ * @param args The arguments to invoke `func` with.
+ * @returns Returns the timer id.
  *
  * @example
  * defer(console.log, 'deferred');

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

@@ -2,9 +2,9 @@
 /**
  * Defers invoking the `func` until the current call stack has cleared. Any additional arguments are provided to func when it's invoked.
  *
- * @param {(...args: any[]) => any} func The function to defer.
- * @param {...any[]} args The arguments to invoke `func` with.
- * @returns {number} Returns the timer id.
+ * @param func The function to defer.
+ * @param args The arguments to invoke `func` with.
+ * @returns Returns the timer id.
  *
  * @example
  * defer(console.log, 'deferred');

package/dist/compat/function/defer.js

@@ -2,9 +2,9 @@
 /**
 * Defers invoking the `func` until the current call stack has cleared. Any additional arguments are provided to func when it's invoked.
 *
-* @param {F} func The function to defer.
-* @param {Parameters<F>} args The arguments to invoke `func` with.
-* @returns {number} Returns the timer id.
+* @param func The function to defer.
+* @param args The arguments to invoke `func` with.
+* @returns Returns the timer id.
 *
 * @example
 * defer((text) => {

package/dist/compat/function/defer.mjs

@@ -2,9 +2,9 @@
 /**
 * Defers invoking the `func` until the current call stack has cleared. Any additional arguments are provided to func when it's invoked.
 *
-* @param {F} func The function to defer.
-* @param {Parameters<F>} args The arguments to invoke `func` with.
-* @returns {number} Returns the timer id.
+* @param func The function to defer.
+* @param args The arguments to invoke `func` with.
+* @returns Returns the timer id.
 *
 * @example
 * defer((text) => {

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

@@ -3,10 +3,10 @@
  * Invokes the specified function after a delay of the given number of milliseconds.
  * Any additional arguments are passed to the function when it is invoked.
  *
- * @param {(...args: any[]) => any} func - The function to delay.
- * @param {number} wait - The number of milliseconds to delay the invocation.
- * @param {...any[]} args - The arguments to pass to the function when it is invoked.
- * @returns {number} Returns the timer id.
+ * @param func - The function to delay.
+ * @param wait - The number of milliseconds to delay the invocation.
+ * @param args - The arguments to pass to the function when it is invoked.
+ * @returns Returns the timer id.
  * @throws {TypeError} If the first argument is not a function.
  *
  * @example

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

@@ -3,10 +3,10 @@
  * Invokes the specified function after a delay of the given number of milliseconds.
  * Any additional arguments are passed to the function when it is invoked.
  *
- * @param {(...args: any[]) => any} func - The function to delay.
- * @param {number} wait - The number of milliseconds to delay the invocation.
- * @param {...any[]} args - The arguments to pass to the function when it is invoked.
- * @returns {number} Returns the timer id.
+ * @param func - The function to delay.
+ * @param wait - The number of milliseconds to delay the invocation.
+ * @param args - The arguments to pass to the function when it is invoked.
+ * @returns Returns the timer id.
  * @throws {TypeError} If the first argument is not a function.
  *
  * @example

package/dist/compat/function/delay.js

@@ -4,10 +4,10 @@ const require_toNumber = require("../util/toNumber.js");
 * Invokes the specified function after a delay of the given number of milliseconds.
 * Any additional arguments are passed to the function when it is invoked.
 *
-* @param {(...args: any[]) => any} func - The function to delay.
-* @param {number} wait - The number of milliseconds to delay the invocation.
-* @param {...any[]} args - The arguments to pass to the function when it is invoked.
-* @returns {number} Returns the timer id.
+* @param func - The function to delay.
+* @param wait - The number of milliseconds to delay the invocation.
+* @param args - The arguments to pass to the function when it is invoked.
+* @returns Returns the timer id.
 * @throws {TypeError} If the first argument is not a function.
 *
 * @example

package/dist/compat/function/delay.mjs

@@ -4,10 +4,10 @@ import { toNumber } from "../util/toNumber.mjs";
 * Invokes the specified function after a delay of the given number of milliseconds.
 * Any additional arguments are passed to the function when it is invoked.
 *
-* @param {(...args: any[]) => any} func - The function to delay.
-* @param {number} wait - The number of milliseconds to delay the invocation.
-* @param {...any[]} args - The arguments to pass to the function when it is invoked.
-* @returns {number} Returns the timer id.
+* @param func - The function to delay.
+* @param wait - The number of milliseconds to delay the invocation.
+* @param args - The arguments to pass to the function when it is invoked.
+* @returns Returns the timer id.
 * @throws {TypeError} If the first argument is not a function.
 *
 * @example

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

@@ -3,8 +3,8 @@
  * Reverses the order of arguments for a given function.
  *
  * @template T - The type of the function being flipped.
- * @param {T} func - The function whose arguments will be reversed.
- * @returns {T} A new function that takes the reversed arguments and returns the result of calling `func`.
+ * @param func - The function whose arguments will be reversed.
+ * @returns A new function that takes the reversed arguments and returns the result of calling `func`.
  *
  * @example
  * var flipped = flip(function() {

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

@@ -3,8 +3,8 @@
  * Reverses the order of arguments for a given function.
  *
  * @template T - The type of the function being flipped.
- * @param {T} func - The function whose arguments will be reversed.
- * @returns {T} A new function that takes the reversed arguments and returns the result of calling `func`.
+ * @param func - The function whose arguments will be reversed.
+ * @returns A new function that takes the reversed arguments and returns the result of calling `func`.
  *
  * @example
  * var flipped = flip(function() {

package/dist/compat/function/flip.js

@@ -3,8 +3,8 @@
 * Reverses the order of arguments for a given function.
 *
 * @template F - The type of the function being flipped.
-* @param {F} func - The function whose arguments will be reversed.
-* @returns {(...args: Reversed<Parameters<F>>) => ReturnType<F>} A new function that takes the
+* @param func - The function whose arguments will be reversed.
+* @returns A new function that takes the
 * reversed arguments and returns the result of calling `func`.
 *
 * @example

package/dist/compat/function/flip.mjs

@@ -3,8 +3,8 @@
 * Reverses the order of arguments for a given function.
 *
 * @template F - The type of the function being flipped.
-* @param {F} func - The function whose arguments will be reversed.
-* @returns {(...args: Reversed<Parameters<F>>) => ReturnType<F>} A new function that takes the
+* @param func - The function whose arguments will be reversed.
+* @returns A new function that takes the
 * reversed arguments and returns the result of calling `func`.
 *
 * @example

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

@@ -6,14 +6,14 @@ import { Many } from "../_internal/Many.mjs";
  *
  * @template A - The type of the arguments.
  * @template R - The type of the return values.
- * @param {(...args: A) => R} f1 - The first function to invoke.
- * @param {(a: R) => R} f2 - The second function to invoke.
- * @param {(a: R) => R} f3 - The third function to invoke.
- * @param {(a: R) => R} f4 - The fourth function to invoke.
- * @param {(a: R) => R} f5 - The fifth function to invoke.
- * @param {(a: R) => R} f6 - The sixth function to invoke.
- * @param {(a: R) => R} f7 - The seventh function to invoke.
- * @returns {(...args: A) => R} Returns the new composite function.
+ * @param f1 - The first function to invoke.
+ * @param f2 - The second function to invoke.
+ * @param f3 - The third function to invoke.
+ * @param f4 - The fourth function to invoke.
+ * @param f5 - The fifth function to invoke.
+ * @param f6 - The sixth function to invoke.
+ * @param f7 - The seventh function to invoke.
+ * @returns Returns the new composite function.
  *
  * @example
  * function square(n) {

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

@@ -6,14 +6,14 @@ import { Many } from "../_internal/Many.js";
  *
  * @template A - The type of the arguments.
  * @template R - The type of the return values.
- * @param {(...args: A) => R} f1 - The first function to invoke.
- * @param {(a: R) => R} f2 - The second function to invoke.
- * @param {(a: R) => R} f3 - The third function to invoke.
- * @param {(a: R) => R} f4 - The fourth function to invoke.
- * @param {(a: R) => R} f5 - The fifth function to invoke.
- * @param {(a: R) => R} f6 - The sixth function to invoke.
- * @param {(a: R) => R} f7 - The seventh function to invoke.
- * @returns {(...args: A) => R} Returns the new composite function.
+ * @param f1 - The first function to invoke.
+ * @param f2 - The second function to invoke.
+ * @param f3 - The third function to invoke.
+ * @param f4 - The fourth function to invoke.
+ * @param f5 - The fifth function to invoke.
+ * @param f6 - The sixth function to invoke.
+ * @param f7 - The seventh function to invoke.
+ * @returns Returns the new composite function.
  *
  * @example
  * function square(n) {

package/dist/compat/function/flow.js

@@ -6,8 +6,8 @@ const require_flow = require("../../function/flow.js");
 *
 * The `this` context of the returned function is also passed to the functions provided as parameters.
 *
-* @param {Array<((...args: any[]) => any) | Array<(...args: any[]) => any>>} funcs The functions to invoke.
-* @returns {(...args: any[]) => any} Returns the new composite function.
+* @param funcs The functions to invoke.
+* @returns Returns the new composite function.
 *
 * @example
 * const add = (x: number, y: number) => x + y;

package/dist/compat/function/flow.mjs

@@ -6,8 +6,8 @@ import { flow as flow$1 } from "../../function/flow.mjs";
 *
 * The `this` context of the returned function is also passed to the functions provided as parameters.
 *
-* @param {Array<((...args: any[]) => any) | Array<(...args: any[]) => any>>} funcs The functions to invoke.
-* @returns {(...args: any[]) => any} Returns the new composite function.
+* @param funcs The functions to invoke.
+* @returns Returns the new composite function.
 *
 * @example
 * const add = (x: number, y: number) => x + y;