es-toolkit 1.47.0 → 1.47.1-dev.1851

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;

package/dist/compat/function/flowRight.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 {(a: R) => R} f7 - The seventh function to invoke.
- * @param {(a: R) => R} f6 - The sixth function to invoke.
- * @param {(a: R) => R} f5 - The fifth function to invoke.
- * @param {(a: R) => R} f4 - The fourth function to invoke.
- * @param {(a: R) => R} f3 - The third function to invoke.
- * @param {(a: R) => R} f2 - The second function to invoke.
- * @param {(...args: A) => R} f1 - The first function to invoke.
- * @returns {(...args: A) => R} Returns the new composite function.
+ * @param f7 - The seventh function to invoke.
+ * @param f6 - The sixth function to invoke.
+ * @param f5 - The fifth function to invoke.
+ * @param f4 - The fourth function to invoke.
+ * @param f3 - The third function to invoke.
+ * @param f2 - The second function to invoke.
+ * @param f1 - The first function to invoke.
+ * @returns Returns the new composite function.
  *
  * @example
  * function square(n) {

package/dist/compat/function/flowRight.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 {(a: R) => R} f7 - The seventh function to invoke.
- * @param {(a: R) => R} f6 - The sixth function to invoke.
- * @param {(a: R) => R} f5 - The fifth function to invoke.
- * @param {(a: R) => R} f4 - The fourth function to invoke.
- * @param {(a: R) => R} f3 - The third function to invoke.
- * @param {(a: R) => R} f2 - The second function to invoke.
- * @param {(...args: A) => R} f1 - The first function to invoke.
- * @returns {(...args: A) => R} Returns the new composite function.
+ * @param f7 - The seventh function to invoke.
+ * @param f6 - The sixth function to invoke.
+ * @param f5 - The fifth function to invoke.
+ * @param f4 - The fourth function to invoke.
+ * @param f3 - The third function to invoke.
+ * @param f2 - The second function to invoke.
+ * @param f1 - The first function to invoke.
+ * @returns Returns the new composite function.
  *
  * @example
  * function square(n) {

package/dist/compat/function/flowRight.js

@@ -8,8 +8,8 @@ const require_flowRight = require("../../function/flowRight.js");
 *
 * This method is like `flow` except that it creates a function that invokes the given functions from right to left.
 *
-* @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/flowRight.mjs

@@ -8,8 +8,8 @@ import { flowRight as flowRight$1 } from "../../function/flowRight.mjs";
 *
 * This method is like `flow` except that it creates a function that invokes the given functions from right to left.
 *
-* @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/identity.d.mts

@@ -3,8 +3,8 @@
  * Returns the input value unchanged.
  *
  * @template T - The type of the input value.
- * @param {T} x - The value to be returned.
- * @returns {T} The input value.
+ * @param x - The value to be returned.
+ * @returns The input value.
  *
  * @example
  * // Returns 5
@@ -23,8 +23,8 @@ declare function identity<T>(value: T): T;
  * Returns the input value unchanged.
  *
  * @template T - The type of the input value.
- * @param {T} x - The value to be returned.
- * @returns {T} The input value.
+ * @param x - The value to be returned.
+ * @returns The input value.
  *
  * @example
  * // Returns 5

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

@@ -3,8 +3,8 @@
  * Returns the input value unchanged.
  *
  * @template T - The type of the input value.
- * @param {T} x - The value to be returned.
- * @returns {T} The input value.
+ * @param x - The value to be returned.
+ * @returns The input value.
  *
  * @example
  * // Returns 5
@@ -23,8 +23,8 @@ declare function identity<T>(value: T): T;
  * Returns the input value unchanged.
  *
  * @template T - The type of the input value.
- * @param {T} x - The value to be returned.
- * @returns {T} The input value.
+ * @param x - The value to be returned.
+ * @returns The input value.
  *
  * @example
  * // Returns 5

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

@@ -108,8 +108,8 @@ interface MemoizedFunction {
  * the this binding of the memoized function.
  *
  * @template T - The type of the original function being memoized
- * @param {T} func The function to have its output memoized.
- * @param {Function} [resolver] The function to resolve the cache key.
+ * @param func The function to have its output memoized.
+ * @param [resolver] The function to resolve the cache key.
  * @return {MemoizedFunction<T>} Returns the new memoizing function.
  */
 declare function memoize<T extends (...args: any) => any>(func: T, resolver?: (...args: Parameters<T>) => any): T & MemoizedFunction;

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

@@ -108,8 +108,8 @@ interface MemoizedFunction {
  * the this binding of the memoized function.
  *
  * @template T - The type of the original function being memoized
- * @param {T} func The function to have its output memoized.
- * @param {Function} [resolver] The function to resolve the cache key.
+ * @param func The function to have its output memoized.
+ * @param [resolver] The function to resolve the cache key.
  * @return {MemoizedFunction<T>} Returns the new memoizing function.
  */
 declare function memoize<T extends (...args: any) => any>(func: T, resolver?: (...args: Parameters<T>) => any): T & MemoizedFunction;

package/dist/compat/function/memoize.js

@@ -6,8 +6,8 @@
 * the this binding of the memoized function.
 *
 * @template T - The type of the original function being memoized
-* @param {T} func The function to have its output memoized.
-* @param {Function} [resolver] The function to resolve the cache key.
+* @param func The function to have its output memoized.
+* @param [resolver] The function to resolve the cache key.
 * @return {MemoizedFunction<T>} Returns the new memoizing function.
 */
 function memoize(func, resolver) {

package/dist/compat/function/memoize.mjs

@@ -6,8 +6,8 @@
 * the this binding of the memoized function.
 *
 * @template T - The type of the original function being memoized
-* @param {T} func The function to have its output memoized.
-* @param {Function} [resolver] The function to resolve the cache key.
+* @param func The function to have its output memoized.
+* @param [resolver] The function to resolve the cache key.
 * @return {MemoizedFunction<T>} Returns the new memoizing function.
 */
 function memoize(func, resolver) {

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

@@ -3,8 +3,8 @@
  * Creates a function that negates the result of the predicate function.
  *
  * @template T - The type of the arguments array.
- * @param {(...args: T) => boolean} predicate - The predicate to negate.
- * @returns {(...args: T) => boolean} The new negated function.
+ * @param predicate - The predicate to negate.
+ * @returns The new negated function.
  *
  * @example
  * function isEven(n) {

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

@@ -3,8 +3,8 @@
  * Creates a function that negates the result of the predicate function.
  *
  * @template T - The type of the arguments array.
- * @param {(...args: T) => boolean} predicate - The predicate to negate.
- * @returns {(...args: T) => boolean} The new negated function.
+ * @param predicate - The predicate to negate.
+ * @returns The new negated function.
  *
  * @example
  * function isEven(n) {

package/dist/compat/function/negate.js

@@ -3,8 +3,8 @@
 * Creates a function that negates the result of the predicate function.
 *
 * @template F - The type of the function to negate.
-* @param {F} func - The function to negate.
-* @returns {F} The new negated function, which negates the boolean result of `func`.
+* @param func - The function to negate.
+* @returns The new negated function, which negates the boolean result of `func`.
 *
 * @example
 * const array = [1, 2, 3, 4, 5, 6];

package/dist/compat/function/negate.mjs

@@ -3,8 +3,8 @@
 * Creates a function that negates the result of the predicate function.
 *
 * @template F - The type of the function to negate.
-* @param {F} func - The function to negate.
-* @returns {F} The new negated function, which negates the boolean result of `func`.
+* @param func - The function to negate.
+* @returns The new negated function, which negates the boolean result of `func`.
 *
 * @example
 * const array = [1, 2, 3, 4, 5, 6];

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

@@ -6,7 +6,7 @@
  * @example
  * noop(); // Does nothing
  *
- * @returns {void} This function does not return anything.
+ * @returns This function does not return anything.
  */
 declare function noop(..._: any[]): void;
 //#endregion

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

@@ -6,7 +6,7 @@
  * @example
  * noop(); // Does nothing
  *
- * @returns {void} This function does not return anything.
+ * @returns This function does not return anything.
  */
 declare function noop(..._: any[]): void;
 //#endregion

package/dist/compat/function/noop.js

@@ -6,7 +6,7 @@
 * @example
 * noop(); // Does nothing
 *
-* @returns {void} This function does not return anything.
+* @returns This function does not return anything.
 */
 function noop(..._) {}
 //#endregion

package/dist/compat/function/noop.mjs

@@ -6,7 +6,7 @@
 * @example
 * noop(); // Does nothing
 *
-* @returns {void} This function does not return anything.
+* @returns This function does not return anything.
 */
 function noop(..._) {}
 //#endregion

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

@@ -2,8 +2,8 @@
 /**
  * Creates a function that gets the argument at index `n`. If `n` is negative, the nth argument from the end is returned.
  *
- * @param {number} [n=0] - The index of the argument to return.
- * @returns {(...args: any[]) => any} Returns the new function.
+ * @param [n=0] - The index of the argument to return.
+ * @returns Returns the new function.
  *
  * @example
  * var func = nthArg(1);

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

@@ -2,8 +2,8 @@
 /**
  * Creates a function that gets the argument at index `n`. If `n` is negative, the nth argument from the end is returned.
  *
- * @param {number} [n=0] - The index of the argument to return.
- * @returns {(...args: any[]) => any} Returns the new function.
+ * @param [n=0] - The index of the argument to return.
+ * @returns Returns the new function.
  *
  * @example
  * var func = nthArg(1);

package/dist/compat/function/nthArg.js

@@ -5,9 +5,9 @@ const require_toInteger = require("../util/toInteger.js");
 *
 * If `n` is negative, the nth argument from the end is returned.
 *
-* @param {number} [n=0] - The index of the argument to retrieve.
+* @param [n=0] - The index of the argument to retrieve.
 *   If negative, counts from the end of the arguments list.
-* @returns {(args: any[]) => unknown} A new function that returns the argument at the specified index.
+* @returns A new function that returns the argument at the specified index.
 *
 * @example
 * const getSecondArg = nthArg(1);

package/dist/compat/function/nthArg.mjs

@@ -5,9 +5,9 @@ import { toInteger } from "../util/toInteger.mjs";
 *
 * If `n` is negative, the nth argument from the end is returned.
 *
-* @param {number} [n=0] - The index of the argument to retrieve.
+* @param [n=0] - The index of the argument to retrieve.
 *   If negative, counts from the end of the arguments list.
-* @returns {(args: any[]) => unknown} A new function that returns the argument at the specified index.
+* @returns A new function that returns the argument at the specified index.
 *
 * @example
 * const getSecondArg = nthArg(1);

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

@@ -13,13 +13,13 @@ import { Many } from "../_internal/Many.mjs";
  * If a transform is nullish, the identity function is used instead.
  * Only transforms arguments up to the number of transform functions provided.
  *
- * @param {(...args: any[]) => any} func - The function to wrap
- * @param {Array<Many<(...args: any[]) => any>>} transforms - The functions to transform arguments. Each transform can be:
+ * @param func - The function to wrap
+ * @param transforms - The functions to transform arguments. Each transform can be:
  *   - A function that accepts and returns a value
  *   - A string to get a property value (e.g. 'name' gets the name property)
  *   - An object to check if arguments match its properties
  *   - An array of [property, value] to check property matches
- * @returns {(...args: any[]) => any} A new function that transforms arguments before passing them to func
+ * @returns A new function that transforms arguments before passing them to func
  * @throws {TypeError} If func is not a function.
  * @example
  * ```ts

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

@@ -13,13 +13,13 @@ import { Many } from "../_internal/Many.js";
  * If a transform is nullish, the identity function is used instead.
  * Only transforms arguments up to the number of transform functions provided.
  *
- * @param {(...args: any[]) => any} func - The function to wrap
- * @param {Array<Many<(...args: any[]) => any>>} transforms - The functions to transform arguments. Each transform can be:
+ * @param func - The function to wrap
+ * @param transforms - The functions to transform arguments. Each transform can be:
  *   - A function that accepts and returns a value
  *   - A string to get a property value (e.g. 'name' gets the name property)
  *   - An object to check if arguments match its properties
  *   - An array of [property, value] to check property matches
- * @returns {(...args: any[]) => any} A new function that transforms arguments before passing them to func
+ * @returns A new function that transforms arguments before passing them to func
  * @throws {TypeError} If func is not a function.
  * @example
  * ```ts

package/dist/compat/function/overArgs.js

@@ -13,13 +13,13 @@ const require_iteratee = require("../util/iteratee.js");
 * If a transform is nullish, the identity function is used instead.
 * Only transforms arguments up to the number of transform functions provided.
 *
-* @param {(...args: any[]) => any} func - The function to wrap
-* @param {Array<Many<(...args: any[]) => any>>} transforms - The functions to transform arguments. Each transform can be:
+* @param func - The function to wrap
+* @param transforms - The functions to transform arguments. Each transform can be:
 *   - A function that accepts and returns a value
 *   - A string to get a property value (e.g. 'name' gets the name property)
 *   - An object to check if arguments match its properties
 *   - An array of [property, value] to check property matches
-* @returns {(...args: any[]) => any} A new function that transforms arguments before passing them to func
+* @returns A new function that transforms arguments before passing them to func
 * @throws {TypeError} If func is not a function.
 * @example
 * ```ts

package/dist/compat/function/overArgs.mjs

@@ -13,13 +13,13 @@ import { iteratee } from "../util/iteratee.mjs";
 * If a transform is nullish, the identity function is used instead.
 * Only transforms arguments up to the number of transform functions provided.
 *
-* @param {(...args: any[]) => any} func - The function to wrap
-* @param {Array<Many<(...args: any[]) => any>>} transforms - The functions to transform arguments. Each transform can be:
+* @param func - The function to wrap
+* @param transforms - The functions to transform arguments. Each transform can be:
 *   - A function that accepts and returns a value
 *   - A string to get a property value (e.g. 'name' gets the name property)
 *   - An object to check if arguments match its properties
 *   - An array of [property, value] to check property matches
-* @returns {(...args: any[]) => any} A new function that transforms arguments before passing them to func
+* @returns A new function that transforms arguments before passing them to func
 * @throws {TypeError} If func is not a function.
 * @example
 * ```ts

package/dist/compat/function/partial.js

@@ -8,9 +8,9 @@ const require_partial = require("../../function/partial.js");
 * Note: This method doesn't set the `length` property of partially applied functions.
 *
 * @template F The type of the function to partially apply.
-* @param {F} func The function to partially apply arguments to.
-* @param {any[]} partialArgs The arguments to be partially applied.
-* @returns {(...args: any[]) => ReturnType<F>} Returns the new partially applied function.
+* @param func The function to partially apply arguments to.
+* @param partialArgs The arguments to be partially applied.
+* @returns Returns the new partially applied function.
 *
 * @example
 * function greet(greeting, name) {

package/dist/compat/function/partial.mjs

@@ -8,9 +8,9 @@ import { partialImpl } from "../../function/partial.mjs";
 * Note: This method doesn't set the `length` property of partially applied functions.
 *
 * @template F The type of the function to partially apply.
-* @param {F} func The function to partially apply arguments to.
-* @param {any[]} partialArgs The arguments to be partially applied.
-* @returns {(...args: any[]) => ReturnType<F>} Returns the new partially applied function.
+* @param func The function to partially apply arguments to.
+* @param partialArgs The arguments to be partially applied.
+* @returns Returns the new partially applied function.
 *
 * @example
 * function greet(greeting, name) {