es-toolkit 1.29.0-dev.930 → 1.29.0-dev.931

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

@@ -0,0 +1,14 @@
+/**
+ * Gets the element at index `n` of `array`. If `n` is negative, the nth element from the end is returned.
+ *
+ * @param {ArrayLike<T> | null | undefined} array - The array to query.
+ * @param {number} [n=0] - The index of the element to return.
+ * @return {T | undefined} Returns the nth element of `array`.
+ *
+ * @example
+ * nth([1, 2, 3], 1); // => 2
+ * nth([1, 2, 3], -1); // => 3
+ */
+declare function nth<T>(array: ArrayLike<T> | null | undefined, n?: number): T | undefined;
+
+export { nth };

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

@@ -0,0 +1,14 @@
+/**
+ * Gets the element at index `n` of `array`. If `n` is negative, the nth element from the end is returned.
+ *
+ * @param {ArrayLike<T> | null | undefined} array - The array to query.
+ * @param {number} [n=0] - The index of the element to return.
+ * @return {T | undefined} Returns the nth element of `array`.
+ *
+ * @example
+ * nth([1, 2, 3], 1); // => 2
+ * nth([1, 2, 3], -1); // => 3
+ */
+declare function nth<T>(array: ArrayLike<T> | null | undefined, n?: number): T | undefined;
+
+export { nth };

package/dist/compat/array/nth.mjs

@@ -0,0 +1,15 @@
+import { isArrayLikeObject } from '../predicate/isArrayLikeObject.mjs';
+import { toInteger } from '../util/toInteger.mjs';
+
+function nth(array, n = 0) {
+    if (!isArrayLikeObject(array) || array.length === 0) {
+        return undefined;
+    }
+    n = toInteger(n);
+    if (n < 0) {
+        n += array.length;
+    }
+    return array[n];
+}
+
+export { nth };

package/dist/compat/index.d.mts

@@ -104,6 +104,7 @@ export { intersectionBy } from './array/intersectionBy.mjs';
 export { join } from './array/join.mjs';
 export { last } from './array/last.mjs';
 export { lastIndexOf } from './array/lastIndexOf.mjs';
+export { nth } from './array/nth.mjs';
 export { orderBy } from './array/orderBy.mjs';
 export { pull } from './array/pull.mjs';
 export { sample } from './array/sample.mjs';

package/dist/compat/index.d.ts

@@ -104,6 +104,7 @@ export { intersectionBy } from './array/intersectionBy.js';
 export { join } from './array/join.js';
 export { last } from './array/last.js';
 export { lastIndexOf } from './array/lastIndexOf.js';
+export { nth } from './array/nth.js';
 export { orderBy } from './array/orderBy.js';
 export { pull } from './array/pull.js';
 export { sample } from './array/sample.js';

package/dist/compat/index.js

@@ -1008,6 +1008,17 @@ function lastIndexOf(array, searchElement, fromIndex) {
     return Array.from(array).lastIndexOf(searchElement, index);
 }
 
+function nth(array, n = 0) {
+    if (!isArrayLikeObject(array) || array.length === 0) {
+        return undefined;
+    }
+    n = toInteger(n);
+    if (n < 0) {
+        n += array.length;
+    }
+    return array[n];
+}
+
 function getPriority(a) {
     if (typeof a === 'symbol') {
         return 1;
@@ -2968,6 +2979,7 @@ exports.merge = merge;
 exports.mergeWith = mergeWith;
 exports.min = min;
 exports.now = now;
+exports.nth = nth;
 exports.omit = omit;
 exports.orderBy = orderBy;
 exports.pad = pad;

package/dist/compat/index.mjs

@@ -105,6 +105,7 @@ export { intersectionBy } from './array/intersectionBy.mjs';
 export { join } from './array/join.mjs';
 export { last } from './array/last.mjs';
 export { lastIndexOf } from './array/lastIndexOf.mjs';
+export { nth } from './array/nth.mjs';
 export { orderBy } from './array/orderBy.mjs';
 export { pull } from './array/pull.mjs';
 export { sample } from './array/sample.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.930+c93ff843",
+  "version": "1.29.0-dev.931+f7abb57d",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {