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

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

@@ -3,9 +3,9 @@
  * Combines two arrays, one of property names and one of corresponding values, into a single object.
  *
  * @template T - The type of values in the values array
- * @param {ArrayLike<PropertyKey>} props - An array of property names
- * @param {ArrayLike<T>} values - An array of values corresponding to the property names
- * @returns {Record<string, T>} A new object composed of the given property names and values
+ * @param props - An array of property names
+ * @param values - An array of values corresponding to the property names
+ * @returns A new object composed of the given property names and values
  *
  * @example
  * const props = ['a', 'b', 'c'];
@@ -17,8 +17,8 @@ declare function zipObject<T>(props: ArrayLike<PropertyKey>, values: ArrayLike<T
 /**
  * Creates an object from an array of property names, with undefined values.
  *
- * @param {ArrayLike<PropertyKey>} [props] - An array of property names
- * @returns {Record<string, undefined>} A new object with the given property names and undefined values
+ * @param [props] - An array of property names
+ * @returns A new object with the given property names and undefined values
  *
  * @example
  * const props = ['a', 'b', 'c'];

package/dist/compat/array/zipObject.js

@@ -10,9 +10,9 @@ const require_assignValue = require("../_internal/assignValue.js");
 *
 * @template P - The type of elements in the array.
 * @template V - The type of elements in the array.
-* @param {ArrayLike<K>} keys - An array of property names.
-* @param {ArrayLike<V>} values - An array of values corresponding to the property names.
-* @returns {Record<K, V>} - A new object composed of the given property names and values.
+* @param keys - An array of property names.
+* @param values - An array of values corresponding to the property names.
+* @returns A new object composed of the given property names and values.
 *
 * @example
 * const keys = ['a', 'b', 'c'];

package/dist/compat/array/zipObject.mjs

@@ -10,9 +10,9 @@ import { assignValue } from "../_internal/assignValue.mjs";
 *
 * @template P - The type of elements in the array.
 * @template V - The type of elements in the array.
-* @param {ArrayLike<K>} keys - An array of property names.
-* @param {ArrayLike<V>} values - An array of values corresponding to the property names.
-* @returns {Record<K, V>} - A new object composed of the given property names and values.
+* @param keys - An array of property names.
+* @param values - An array of values corresponding to the property names.
+* @returns A new object composed of the given property names and values.
 *
 * @example
 * const keys = ['a', 'b', 'c'];

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

@@ -12,9 +12,9 @@ import { PropertyPath } from "../_internal/PropertyPath.mjs";
  *
  * @template P - The type of property paths.
  * @template V - The type of values corresponding to the property paths.
- * @param {ArrayLike<P | P[]>} keys - An array of property paths, each path can be a dot-separated string or an array of property names.
- * @param {ArrayLike<V>} values - An array of values corresponding to the property paths.
- * @returns {Record<P, V>} A new object composed of the given property paths and values.
+ * @param keys - An array of property paths, each path can be a dot-separated string or an array of property names.
+ * @param values - An array of values corresponding to the property paths.
+ * @returns A new object composed of the given property paths and values.
  *
  * @example
  * const paths = ['a.b.c', 'd.e.f'];

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

@@ -12,9 +12,9 @@ import { PropertyPath } from "../_internal/PropertyPath.js";
  *
  * @template P - The type of property paths.
  * @template V - The type of values corresponding to the property paths.
- * @param {ArrayLike<P | P[]>} keys - An array of property paths, each path can be a dot-separated string or an array of property names.
- * @param {ArrayLike<V>} values - An array of values corresponding to the property paths.
- * @returns {Record<P, V>} A new object composed of the given property paths and values.
+ * @param keys - An array of property paths, each path can be a dot-separated string or an array of property names.
+ * @param values - An array of values corresponding to the property paths.
+ * @returns A new object composed of the given property paths and values.
  *
  * @example
  * const paths = ['a.b.c', 'd.e.f'];

package/dist/compat/array/zipObjectDeep.js

@@ -13,9 +13,9 @@ const require_set = require("../object/set.js");
 *
 * @template P - The type of property paths.
 * @template V - The type of values corresponding to the property paths.
-* @param {ArrayLike<P | P[]>} keys - An array of property paths, each path can be a dot-separated string or an array of property names.
-* @param {ArrayLike<V>} values - An array of values corresponding to the property paths.
-* @returns {Record<P, V>} A new object composed of the given property paths and values.
+* @param keys - An array of property paths, each path can be a dot-separated string or an array of property names.
+* @param values - An array of values corresponding to the property paths.
+* @returns A new object composed of the given property paths and values.
 *
 * @example
 * const paths = ['a.b.c', 'd.e.f'];

package/dist/compat/array/zipObjectDeep.mjs

@@ -13,9 +13,9 @@ import { set } from "../object/set.mjs";
 *
 * @template P - The type of property paths.
 * @template V - The type of values corresponding to the property paths.
-* @param {ArrayLike<P | P[]>} keys - An array of property paths, each path can be a dot-separated string or an array of property names.
-* @param {ArrayLike<V>} values - An array of values corresponding to the property paths.
-* @returns {Record<P, V>} A new object composed of the given property paths and values.
+* @param keys - An array of property paths, each path can be a dot-separated string or an array of property names.
+* @param values - An array of values corresponding to the property paths.
+* @returns A new object composed of the given property paths and values.
 *
 * @example
 * const paths = ['a.b.c', 'd.e.f'];

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

@@ -4,9 +4,9 @@
  *
  * @template T - The type of elements in the first array.
  * @template R - The type of elements in the resulting array.
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {(item: T) => R} combine - The combiner function that takes corresponding elements from each array and returns a single value.
- * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+ * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
  */
 declare function zipWith<T, R>(arr1: ArrayLike<T>, combine: (item: T) => R): R[];
 /**
@@ -15,10 +15,10 @@ declare function zipWith<T, R>(arr1: ArrayLike<T>, combine: (item: T) => R): R[]
  * @template T - The type of elements in the first array.
  * @template U - The type of elements in the second array.
  * @template R - The type of elements in the resulting array.
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {(item1: T, item2: U) => R} combine - The combiner function that takes corresponding elements from each array and returns a single value.
- * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+ * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
  */
 declare function zipWith<T, U, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, combine: (item1: T, item2: U) => R): R[];
 /**
@@ -28,11 +28,11 @@ declare function zipWith<T, U, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, combin
  * @template U - The type of elements in the second array.
  * @template V - The type of elements in the third array.
  * @template R - The type of elements in the resulting array.
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {(item1: T, item2: U, item3: V) => R} combine - The combiner function that takes corresponding elements from each array and returns a single value.
- * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+ * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
  */
 declare function zipWith<T, U, V, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: ArrayLike<V>, combine: (item1: T, item2: U, item3: V) => R): R[];
 /**
@@ -43,12 +43,12 @@ declare function zipWith<T, U, V, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr
  * @template V - The type of elements in the third array.
  * @template W - The type of elements in the fourth array.
  * @template R - The type of elements in the resulting array.
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {ArrayLike<W>} arr4 - The fourth array to zip.
- * @param {(item1: T, item2: U, item3: V, item4: W) => R} combine - The combiner function that takes corresponding elements from each array and returns a single value.
- * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param arr4 - The fourth array to zip.
+ * @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+ * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
  */
 declare function zipWith<T, U, V, W, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: ArrayLike<V>, arr4: ArrayLike<W>, combine: (item1: T, item2: U, item3: V, item4: W) => R): R[];
 /**
@@ -60,13 +60,13 @@ declare function zipWith<T, U, V, W, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>,
  * @template W - The type of elements in the fourth array.
  * @template X - The type of elements in the fifth array.
  * @template R - The type of elements in the resulting array.
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {ArrayLike<W>} arr4 - The fourth array to zip.
- * @param {ArrayLike<X>} arr5 - The fifth array to zip.
- * @param {(item1: T, item2: U, item3: V, item4: W, item5: X) => R} combine - The combiner function that takes corresponding elements from each array and returns a single value.
- * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param arr4 - The fourth array to zip.
+ * @param arr5 - The fifth array to zip.
+ * @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+ * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
  */
 declare function zipWith<T, U, V, W, X, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: ArrayLike<V>, arr4: ArrayLike<W>, arr5: ArrayLike<X>, combine: (item1: T, item2: U, item3: V, item4: W, item5: X) => R): R[];
 /**
@@ -79,8 +79,8 @@ declare function zipWith<T, U, V, W, X, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U
  *
  * @template T - The type of elements in the input arrays.
  * @template R - The type of elements in the resulting array.
- * @param {Array<((...group: T[]) => R) | ArrayLike<T> | null | undefined>} combine - The combiner function that takes corresponding elements from each array and returns a single value.
- * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+ * @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+ * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
  *
  * @example
  * const arr1 = [1, 2, 3];

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

@@ -4,9 +4,9 @@
  *
  * @template T - The type of elements in the first array.
  * @template R - The type of elements in the resulting array.
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {(item: T) => R} combine - The combiner function that takes corresponding elements from each array and returns a single value.
- * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+ * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
  */
 declare function zipWith<T, R>(arr1: ArrayLike<T>, combine: (item: T) => R): R[];
 /**
@@ -15,10 +15,10 @@ declare function zipWith<T, R>(arr1: ArrayLike<T>, combine: (item: T) => R): R[]
  * @template T - The type of elements in the first array.
  * @template U - The type of elements in the second array.
  * @template R - The type of elements in the resulting array.
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {(item1: T, item2: U) => R} combine - The combiner function that takes corresponding elements from each array and returns a single value.
- * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+ * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
  */
 declare function zipWith<T, U, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, combine: (item1: T, item2: U) => R): R[];
 /**
@@ -28,11 +28,11 @@ declare function zipWith<T, U, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, combin
  * @template U - The type of elements in the second array.
  * @template V - The type of elements in the third array.
  * @template R - The type of elements in the resulting array.
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {(item1: T, item2: U, item3: V) => R} combine - The combiner function that takes corresponding elements from each array and returns a single value.
- * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+ * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
  */
 declare function zipWith<T, U, V, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: ArrayLike<V>, combine: (item1: T, item2: U, item3: V) => R): R[];
 /**
@@ -43,12 +43,12 @@ declare function zipWith<T, U, V, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr
  * @template V - The type of elements in the third array.
  * @template W - The type of elements in the fourth array.
  * @template R - The type of elements in the resulting array.
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {ArrayLike<W>} arr4 - The fourth array to zip.
- * @param {(item1: T, item2: U, item3: V, item4: W) => R} combine - The combiner function that takes corresponding elements from each array and returns a single value.
- * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param arr4 - The fourth array to zip.
+ * @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+ * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
  */
 declare function zipWith<T, U, V, W, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: ArrayLike<V>, arr4: ArrayLike<W>, combine: (item1: T, item2: U, item3: V, item4: W) => R): R[];
 /**
@@ -60,13 +60,13 @@ declare function zipWith<T, U, V, W, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>,
  * @template W - The type of elements in the fourth array.
  * @template X - The type of elements in the fifth array.
  * @template R - The type of elements in the resulting array.
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {ArrayLike<W>} arr4 - The fourth array to zip.
- * @param {ArrayLike<X>} arr5 - The fifth array to zip.
- * @param {(item1: T, item2: U, item3: V, item4: W, item5: X) => R} combine - The combiner function that takes corresponding elements from each array and returns a single value.
- * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param arr4 - The fourth array to zip.
+ * @param arr5 - The fifth array to zip.
+ * @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+ * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
  */
 declare function zipWith<T, U, V, W, X, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: ArrayLike<V>, arr4: ArrayLike<W>, arr5: ArrayLike<X>, combine: (item1: T, item2: U, item3: V, item4: W, item5: X) => R): R[];
 /**
@@ -79,8 +79,8 @@ declare function zipWith<T, U, V, W, X, R>(arr1: ArrayLike<T>, arr2: ArrayLike<U
  *
  * @template T - The type of elements in the input arrays.
  * @template R - The type of elements in the resulting array.
- * @param {Array<((...group: T[]) => R) | ArrayLike<T> | null | undefined>} combine - The combiner function that takes corresponding elements from each array and returns a single value.
- * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+ * @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+ * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
  *
  * @example
  * const arr1 = [1, 2, 3];

package/dist/compat/array/zipWith.js

@@ -11,8 +11,8 @@ const require_unzip = require("./unzip.js");
 *
 * @template T - The type of elements in the input arrays.
 * @template R - The type of elements in the resulting array.
-* @param {Array<((...group: T[]) => R) | ArrayLike<T> | null | undefined>} combine - The combiner function that takes corresponding elements from each array and returns a single value.
-* @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+* @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+* @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
 *
 * @example
 * const arr1 = [1, 2, 3];

package/dist/compat/array/zipWith.mjs

@@ -11,8 +11,8 @@ import { unzip } from "./unzip.mjs";
 *
 * @template T - The type of elements in the input arrays.
 * @template R - The type of elements in the resulting array.
-* @param {Array<((...group: T[]) => R) | ArrayLike<T> | null | undefined>} combine - The combiner function that takes corresponding elements from each array and returns a single value.
-* @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
+* @param combine - The combiner function that takes corresponding elements from each array and returns a single value.
+* @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
 *
 * @example
 * const arr1 = [1, 2, 3];

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

@@ -4,9 +4,9 @@
  * `func` once it's called `n` or more times.
  *
  * @template TFunc - The type of the function to be invoked.
- * @param {number} n - The number of calls before `func` is invoked.
- * @param {TFunc} func - The function to restrict.
- * @returns {TFunc} Returns the new restricted function.
+ * @param n - The number of calls before `func` is invoked.
+ * @param func - The function to restrict.
+ * @returns Returns the new restricted function.
  * @throws {TypeError} - If `func` is not a function.
  *
  * @example

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

@@ -4,9 +4,9 @@
  * `func` once it's called `n` or more times.
  *
  * @template TFunc - The type of the function to be invoked.
- * @param {number} n - The number of calls before `func` is invoked.
- * @param {TFunc} func - The function to restrict.
- * @returns {TFunc} Returns the new restricted function.
+ * @param n - The number of calls before `func` is invoked.
+ * @param func - The function to restrict.
+ * @returns Returns the new restricted function.
  * @throws {TypeError} - If `func` is not a function.
  *
  * @example

package/dist/compat/function/after.js

@@ -5,9 +5,9 @@ const require_toInteger = require("../util/toInteger.js");
 * `func` once it's called `n` or more times.
 *
 * @template TFunc - The type of the function to be invoked.
-* @param {number} n - The number of calls before `func` is invoked.
-* @param {TFunc} func - The function to restrict.
-* @returns {TFunc} Returns the new restricted function.
+* @param n - The number of calls before `func` is invoked.
+* @param func - The function to restrict.
+* @returns Returns the new restricted function.
 * @throws {TypeError} - If `func` is not a function.
 *
 * @example

package/dist/compat/function/after.mjs

@@ -5,9 +5,9 @@ import { toInteger } from "../util/toInteger.mjs";
 * `func` once it's called `n` or more times.
 *
 * @template TFunc - The type of the function to be invoked.
-* @param {number} n - The number of calls before `func` is invoked.
-* @param {TFunc} func - The function to restrict.
-* @returns {TFunc} Returns the new restricted function.
+* @param n - The number of calls before `func` is invoked.
+* @param func - The function to restrict.
+* @returns Returns the new restricted function.
 * @throws {TypeError} - If `func` is not a function.
 *
 * @example

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

@@ -3,9 +3,9 @@
  * Creates a function that invokes func, with up to `n` arguments, ignoring any additional arguments.
  * If `n` is not provided, it defaults to the function's length.
  *
- * @param {Function} func - The function to cap arguments for.
- * @param {number} [n] - The arity cap. Defaults to func.length.
- * @returns {Function} Returns the new capped function.
+ * @param func - The function to cap arguments for.
+ * @param [n] - The arity cap. Defaults to func.length.
+ * @returns Returns the new capped function.
  *
  * @example
  * function fn(a: number, b: number, c: number) {

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

@@ -3,9 +3,9 @@
  * Creates a function that invokes func, with up to `n` arguments, ignoring any additional arguments.
  * If `n` is not provided, it defaults to the function's length.
  *
- * @param {Function} func - The function to cap arguments for.
- * @param {number} [n] - The arity cap. Defaults to func.length.
- * @returns {Function} Returns the new capped function.
+ * @param func - The function to cap arguments for.
+ * @param [n] - The arity cap. Defaults to func.length.
+ * @returns Returns the new capped function.
  *
  * @example
  * function fn(a: number, b: number, c: number) {

package/dist/compat/function/ary.js

@@ -4,10 +4,10 @@ const require_ary = require("../../function/ary.js");
 * Creates a function that invokes func, with up to `n` arguments, ignoring any additional arguments.
 *
 * @template F - The type of the function.
-* @param {F} func - The function to cap arguments for.
-* @param {number} n - The arity cap.
-* @param {unknown} guard - The value to guard the arity cap.
-* @returns {(...args: any[]) => ReturnType<F>} Returns the new capped function.
+* @param func - The function to cap arguments for.
+* @param n - The arity cap.
+* @param guard - The value to guard the arity cap.
+* @returns Returns the new capped function.
 *
 * @example
 * function fn(a: number, b: number, c: number) {

package/dist/compat/function/ary.mjs

@@ -4,10 +4,10 @@ import { ary as ary$1 } from "../../function/ary.mjs";
 * Creates a function that invokes func, with up to `n` arguments, ignoring any additional arguments.
 *
 * @template F - The type of the function.
-* @param {F} func - The function to cap arguments for.
-* @param {number} n - The arity cap.
-* @param {unknown} guard - The value to guard the arity cap.
-* @returns {(...args: any[]) => ReturnType<F>} Returns the new capped function.
+* @param func - The function to cap arguments for.
+* @param n - The arity cap.
+* @param guard - The value to guard the arity cap.
+* @returns Returns the new capped function.
 *
 * @example
 * function fn(a: number, b: number, c: number) {

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

@@ -4,9 +4,9 @@
  * If the function throws an error, it catches the error and returns it.
  * If the caught error is not an instance of Error, it wraps it in a new Error.
  *
- * @param {(...args: any[]) => R} func - The function to be executed.
- * @param {...any[]} args - The arguments to pass to the function.
- * @returns {R | Error} The return value of the function if successful, or an Error if an exception is thrown.
+ * @param func - The function to be executed.
+ * @param args - The arguments to pass to the function.
+ * @returns The return value of the function if successful, or an Error if an exception is thrown.
  *
  * @template R - The type of the function return value.
  *

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

@@ -4,9 +4,9 @@
  * If the function throws an error, it catches the error and returns it.
  * If the caught error is not an instance of Error, it wraps it in a new Error.
  *
- * @param {(...args: any[]) => R} func - The function to be executed.
- * @param {...any[]} args - The arguments to pass to the function.
- * @returns {R | Error} The return value of the function if successful, or an Error if an exception is thrown.
+ * @param func - The function to be executed.
+ * @param args - The arguments to pass to the function.
+ * @returns The return value of the function if successful, or an Error if an exception is thrown.
  *
  * @template R - The type of the function return value.
  *

package/dist/compat/function/attempt.js

@@ -4,9 +4,9 @@
 * If the function throws an error, it catches the error and returns it.
 * If the caught error is not an instance of Error, it wraps it in a new Error.
 *
-* @param {(...args: any[]) => R} func - The function to be executed.
-* @param {...any[]} args - The arguments to pass to the function.
-* @returns {R | Error} The return value of the function if successful, or an Error if an exception is thrown.
+* @param func - The function to be executed.
+* @param args - The arguments to pass to the function.
+* @returns The return value of the function if successful, or an Error if an exception is thrown.
 *
 * @template R - The type of the function return value.
 *

package/dist/compat/function/attempt.mjs

@@ -4,9 +4,9 @@
 * If the function throws an error, it catches the error and returns it.
 * If the caught error is not an instance of Error, it wraps it in a new Error.
 *
-* @param {(...args: any[]) => R} func - The function to be executed.
-* @param {...any[]} args - The arguments to pass to the function.
-* @returns {R | Error} The return value of the function if successful, or an Error if an exception is thrown.
+* @param func - The function to be executed.
+* @param args - The arguments to pass to the function.
+* @returns The return value of the function if successful, or an Error if an exception is thrown.
 *
 * @template R - The type of the function return value.
 *

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

@@ -5,11 +5,11 @@
  * calls to the created function return the result of the last `func` invocation.
  *
  * @template F - The type of the function to be invoked.
- * @param {number} n - The number of times the returned function is allowed to call `func` before stopping.
+ * @param n - The number of times the returned function is allowed to call `func` before stopping.
  * - If `n` is 0, `func` will never be called.
  * - If `n` is a positive integer, `func` will be called up to `n-1` times.
- * @param {F} func - The function to be called with the limit applied.
- * @returns {(...args: Parameters<F>) => ReturnType<F> } - A new function that:
+ * @param func - The function to be called with the limit applied.
+ * @returns A new function that:
  * - Tracks the number of calls.
  * - Invokes `func` until the `n-1`-th call.
  * - Returns last result of `func`, if `n` is reached.

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

@@ -5,11 +5,11 @@
  * calls to the created function return the result of the last `func` invocation.
  *
  * @template F - The type of the function to be invoked.
- * @param {number} n - The number of times the returned function is allowed to call `func` before stopping.
+ * @param n - The number of times the returned function is allowed to call `func` before stopping.
  * - If `n` is 0, `func` will never be called.
  * - If `n` is a positive integer, `func` will be called up to `n-1` times.
- * @param {F} func - The function to be called with the limit applied.
- * @returns {(...args: Parameters<F>) => ReturnType<F> } - A new function that:
+ * @param func - The function to be called with the limit applied.
+ * @returns A new function that:
  * - Tracks the number of calls.
  * - Invokes `func` until the `n-1`-th call.
  * - Returns last result of `func`, if `n` is reached.

package/dist/compat/function/before.js

@@ -6,11 +6,11 @@ const require_toInteger = require("../util/toInteger.js");
 * calls to the created function return the result of the last `func` invocation.
 *
 * @template F - The type of the function to be invoked.
-* @param {number} n - The number of times the returned function is allowed to call `func` before stopping.
+* @param n - The number of times the returned function is allowed to call `func` before stopping.
 * - If `n` is 0, `func` will never be called.
 * - If `n` is a positive integer, `func` will be called up to `n-1` times.
-* @param {F} func - The function to be called with the limit applied.
-* @returns {(...args: Parameters<F>) => ReturnType<F> } - A new function that:
+* @param func - The function to be called with the limit applied.
+* @returns A new function that:
 * - Tracks the number of calls.
 * - Invokes `func` until the `n-1`-th call.
 * - Returns last result of `func`, if `n` is reached.

package/dist/compat/function/before.mjs

@@ -6,11 +6,11 @@ import { toInteger } from "../util/toInteger.mjs";
 * calls to the created function return the result of the last `func` invocation.
 *
 * @template F - The type of the function to be invoked.
-* @param {number} n - The number of times the returned function is allowed to call `func` before stopping.
+* @param n - The number of times the returned function is allowed to call `func` before stopping.
 * - If `n` is 0, `func` will never be called.
 * - If `n` is a positive integer, `func` will be called up to `n-1` times.
-* @param {F} func - The function to be called with the limit applied.
-* @returns {(...args: Parameters<F>) => ReturnType<F> } - A new function that:
+* @param func - The function to be called with the limit applied.
+* @returns A new function that:
 * - Tracks the number of calls.
 * - Invokes `func` until the `n-1`-th call.
 * - Returns last result of `func`, if `n` is reached.

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

@@ -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/bind.d.ts

@@ -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/bind.js

@@ -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) {