@naturalcycles/js-lib 14.211.0 → 14.212.0

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

@@ -176,6 +176,11 @@ export declare function _last<T>(array: T[]): T;
  * Returns last item of the array (or undefined if array is empty).
  */
 export declare function _lastOrUndefined<T>(array: T[]): T | undefined;
+/**
+ * Returns the first item of non-empty array.
+ * Throws if array is empty.
+ */
+export declare function _first<T>(array: T[]): T;
 export declare function _minOrUndefined<T>(array: T[]): NonNullable<T> | undefined;
 /**
  * Filters out nullish values (undefined and null).

package/dist/array/array.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._zip = exports._minByOrUndefined = exports._maxByOrUndefined = exports._minBy = exports._maxBy = exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersectsWith = exports._intersection = exports._countBy = exports._count = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortDescBy = exports._sortBy = exports._groupBy = exports._mapBy = exports._by = exports._uniqBy = exports._pushUniqBy = exports._pushUniq = exports._uniq = exports._chunk = void 0;
+exports._zip = exports._minByOrUndefined = exports._maxByOrUndefined = exports._minBy = exports._maxBy = exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._first = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersectsWith = exports._intersection = exports._countBy = exports._count = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortDescBy = exports._sortBy = exports._groupBy = exports._mapBy = exports._by = exports._uniqBy = exports._pushUniqBy = exports._pushUniq = exports._uniq = exports._chunk = void 0;
 const is_util_1 = require("../is.util");
 const types_1 = require("../types");
 /**
@@ -333,6 +333,16 @@ function _lastOrUndefined(array) {
     return array[array.length - 1];
 }
 exports._lastOrUndefined = _lastOrUndefined;
+/**
+ * Returns the first item of non-empty array.
+ * Throws if array is empty.
+ */
+function _first(array) {
+    if (!array.length)
+        throw new Error('_first called on empty array');
+    return array[0];
+}
+exports._first = _first;
 function _minOrUndefined(array) {
     const a = array.filter(is_util_1._isNotNullish);
     if (!a.length)

package/dist-esm/array/array.util.js

@@ -304,6 +304,15 @@ export function _last(array) {
 export function _lastOrUndefined(array) {
     return array[array.length - 1];
 }
+/**
+ * Returns the first item of non-empty array.
+ * Throws if array is empty.
+ */
+export function _first(array) {
+    if (!array.length)
+        throw new Error('_first called on empty array');
+    return array[0];
+}
 export function _minOrUndefined(array) {
     const a = array.filter(_isNotNullish);
     if (!a.length)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.211.0",
+  "version": "14.212.0",
   "scripts": {
     "prepare": "husky",
     "build-prod": "build-prod-esm-cjs",

package/src/array/array.util.ts

@@ -365,6 +365,15 @@ export function _lastOrUndefined<T>(array: T[]): T | undefined {
   return array[array.length - 1]
 }
 
+/**
+ * Returns the first item of non-empty array.
+ * Throws if array is empty.
+ */
+export function _first<T>(array: T[]): T {
+  if (!array.length) throw new Error('_first called on empty array')
+  return array[0]!
+}
+
 export function _minOrUndefined<T>(array: T[]): NonNullable<T> | undefined {
   const a = array.filter(_isNotNullish)
   if (!a.length) return