@naturalcycles/js-lib 15.67.0 → 15.68.0

package/dist/array/array.util.d.ts

@@ -197,6 +197,8 @@ export declare function _mapToObject<T, V>(array: Iterable<T>, mapper: (item: T)
  * Based on: https://stackoverflow.com/a/12646864/4919972
  */
 export declare function _shuffle<T>(array: T[], opt?: MutateOptions): T[];
+export declare function _firstLast<T>(array: readonly T[]): [first: T, last: T];
+export declare function _firstLastOrUndefined<T>(array: readonly T[]): [first: T, last: T] | undefined;
 /**
  * Returns last item of non-empty array.
  * Throws if array is empty.

package/dist/array/array.util.js

@@ -363,6 +363,16 @@ export function _shuffle(array, opt = {}) {
     }
     return a;
 }
+export function _firstLast(array) {
+    if (!array.length)
+        throw new Error('_firstLast called on empty array');
+    return [array[0], array[array.length - 1]];
+}
+export function _firstLastOrUndefined(array) {
+    if (!array.length)
+        return;
+    return [array[0], array[array.length - 1]];
+}
 /**
  * Returns last item of non-empty array.
  * Throws if array is empty.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.67.0",
+  "version": "15.68.0",
   "dependencies": {
     "tslib": "^2"
   },
@@ -24,7 +24,7 @@
     "@typescript/native-preview": "7.0.0-dev.20260201.1",
     "crypto-js": "^4",
     "dayjs": "^1",
-    "@naturalcycles/dev-lib": "20.36.0"
+    "@naturalcycles/dev-lib": "18.4.2"
   },
   "exports": {
     ".": "./dist/index.js",

package/src/array/array.util.ts

@@ -426,6 +426,16 @@ export function _shuffle<T>(array: T[], opt: MutateOptions = {}): T[] {
   return a
 }
 
+export function _firstLast<T>(array: readonly T[]): [first: T, last: T] {
+  if (!array.length) throw new Error('_firstLast called on empty array')
+  return [array[0]!, array[array.length - 1]!]
+}
+
+export function _firstLastOrUndefined<T>(array: readonly T[]): [first: T, last: T] | undefined {
+  if (!array.length) return
+  return [array[0]!, array[array.length - 1]!]
+}
+
 /**
  * Returns last item of non-empty array.
  * Throws if array is empty.