@zelgadis87/utils-core 5.2.5 → 5.2.7

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@zelgadis87/utils-core",
-  "version": "5.2.5",
+  "version": "5.2.7",
   "author": "Zelgadis87",
   "license": "ISC",
   "private": false,

package/src/utils/arrays.ts

@@ -178,3 +178,16 @@ export function unzip<T, R>( arr: [ T, R ][] ): [ T[], R[] ] {
 		return [ [ ...ts, t ], [ ...rs, r ] ];
 	}, [ [], [] ] as [ T[], R[] ] );
 }
+
+/**
+ * Gets the element at the specified index in the array, wrapped in an Optional.
+ * Returns an empty Optional if the index is out of bounds (negative or >= array length).
+ * @param arr - The array to get the element from
+ * @param index - The index of the element to retrieve
+ * @returns An Optional containing the element at the index, or empty if index is out of bounds
+ */
+export function arrayGet<T>( arr: TReadableArray<T>, index: number ) {
+	if ( index < 0 || index >= arr.length )
+		return Optional.empty<T>();
+	return Optional.of<T>( arr[ index ] );
+}