es-toolkit 1.29.0-dev.948 → 1.29.0-dev.950

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

@@ -0,0 +1,22 @@
+/**
+ * Creates a function that retrieves the argument at the specified index `n`.
+ *
+ * If `n` is negative, the nth argument from the end is returned.
+ *
+ * @param {number} [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.
+ *
+ * @example
+ * const getSecondArg = nthArg(1);
+ * const result = getSecondArg('a', 'b', 'c');
+ * console.log(result); // => 'b'
+ *
+ * @example
+ * const getLastArg = nthArg(-1);
+ * const result = getLastArg('a', 'b', 'c');
+ * console.log(result); // => 'c'
+ */
+declare function nthArg(n?: number): (...args: any[]) => unknown;
+
+export { nthArg };

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

@@ -0,0 +1,22 @@
+/**
+ * Creates a function that retrieves the argument at the specified index `n`.
+ *
+ * If `n` is negative, the nth argument from the end is returned.
+ *
+ * @param {number} [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.
+ *
+ * @example
+ * const getSecondArg = nthArg(1);
+ * const result = getSecondArg('a', 'b', 'c');
+ * console.log(result); // => 'b'
+ *
+ * @example
+ * const getLastArg = nthArg(-1);
+ * const result = getLastArg('a', 'b', 'c');
+ * console.log(result); // => 'c'
+ */
+declare function nthArg(n?: number): (...args: any[]) => unknown;
+
+export { nthArg };

package/dist/compat/function/nthArg.mjs

@@ -0,0 +1,9 @@
+import { toInteger } from '../util/toInteger.mjs';
+
+function nthArg(n = 0) {
+    return function (...args) {
+        return args.at(toInteger(n));
+    };
+}
+
+export { nthArg };

package/dist/compat/index.d.mts

@@ -130,6 +130,7 @@ export { defer } from './function/defer.mjs';
 export { flip } from './function/flip.mjs';
 export { flow } from './function/flow.mjs';
 export { flowRight } from './function/flowRight.mjs';
+export { nthArg } from './function/nthArg.mjs';
 export { rearg } from './function/rearg.mjs';
 export { rest } from './function/rest.mjs';
 export { spread } from './function/spread.mjs';

package/dist/compat/index.d.ts

@@ -130,6 +130,7 @@ export { defer } from './function/defer.js';
 export { flip } from './function/flip.js';
 export { flow } from './function/flow.js';
 export { flowRight } from './function/flowRight.js';
+export { nthArg } from './function/nthArg.js';
 export { rearg } from './function/rearg.js';
 export { rest } from './function/rest.js';
 export { spread } from './function/spread.js';

package/dist/compat/index.js

@@ -1683,6 +1683,12 @@ function flowRight(...funcs) {
     return unary.flowRight(...flattenFuncs);
 }
 
+function nthArg(n = 0) {
+    return function (...args) {
+        return args.at(toInteger(n));
+    };
+}
+
 function rearg(func, ...indices) {
     const flattenIndices = flatten(indices);
     return function (...args) {
@@ -3116,6 +3122,7 @@ exports.method = method;
 exports.min = min;
 exports.now = now;
 exports.nth = nth;
+exports.nthArg = nthArg;
 exports.omit = omit;
 exports.orderBy = orderBy;
 exports.pad = pad;

package/dist/compat/index.mjs

@@ -132,6 +132,7 @@ export { defer } from './function/defer.mjs';
 export { flip } from './function/flip.mjs';
 export { flow } from './function/flow.mjs';
 export { flowRight } from './function/flowRight.mjs';
+export { nthArg } from './function/nthArg.mjs';
 export { rearg } from './function/rearg.mjs';
 export { rest } from './function/rest.mjs';
 export { spread } from './function/spread.mjs';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.29.0-dev.948+f7b12269",
+  "version": "1.29.0-dev.950+77c3509b",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {