@naturalcycles/js-lib 14.223.0 → 14.225.0

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

@@ -103,12 +103,19 @@ export declare function _sortBy<T>(items: T[], mapper: Mapper<T, any>, mutate?:
  */
 export declare function _sortDescBy<T>(items: T[], mapper: Mapper<T, any>, mutate?: boolean): T[];
 /**
- * Like items.find(), but it tries to find from the END of the array.
+ * Similar to `Array.find`, but the `predicate` may return `END` to stop the iteration early.
  *
- * Node 18+ supports native array.findLast() - use that.
- * iOS Safari only has it since 15.4
+ * Use `Array.find` if you don't need to stop the iteration early.
  */
-export declare function _findLast<T>(items: T[], predicate: Predicate<T>): T | undefined;
+export declare function _find<T>(items: T[], predicate: AbortablePredicate<T>): T | undefined;
+/**
+ * Similar to `Array.findLast`, but the `predicate` may return `END` to stop the iteration early.
+ *
+ * Use `Array.findLast` if you don't need to stop the iteration early, which is supported:
+ * - in Node since 18+
+ * - in iOS Safari since 15.4
+ */
+export declare function _findLast<T>(items: T[], predicate: AbortablePredicate<T>): T | undefined;
 export declare function _takeWhile<T>(items: T[], predicate: Predicate<T>): T[];
 export declare function _takeRightWhile<T>(items: T[], predicate: Predicate<T>): T[];
 export declare function _dropWhile<T>(items: T[], predicate: Predicate<T>): T[];

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._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;
+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._find = 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");
 /**
@@ -172,13 +172,29 @@ function _sortDescBy(items, mapper, mutate = false) {
 }
 exports._sortDescBy = _sortDescBy;
 /**
- * Like items.find(), but it tries to find from the END of the array.
+ * Similar to `Array.find`, but the `predicate` may return `END` to stop the iteration early.
  *
- * Node 18+ supports native array.findLast() - use that.
- * iOS Safari only has it since 15.4
+ * Use `Array.find` if you don't need to stop the iteration early.
+ */
+function _find(items, predicate) {
+    for (const [i, item] of items.entries()) {
+        const result = predicate(item, i);
+        if (result === types_1.END)
+            return;
+        if (result)
+            return item;
+    }
+}
+exports._find = _find;
+/**
+ * Similar to `Array.findLast`, but the `predicate` may return `END` to stop the iteration early.
+ *
+ * Use `Array.findLast` if you don't need to stop the iteration early, which is supported:
+ * - in Node since 18+
+ * - in iOS Safari since 15.4
  */
 function _findLast(items, predicate) {
-    return [...items].reverse().find(predicate);
+    return _find(items.slice().reverse(), predicate);
 }
 exports._findLast = _findLast;
 function _takeWhile(items, predicate) {

package/dist/types.d.ts

@@ -177,6 +177,8 @@ export type UnixTimestampNumber = number;
  * @example 1628945450000
  */
 export type UnixTimestampMillisNumber = number;
+export type NumberOfHours = number;
+export type NumberOfMinutes = number;
 export type NumberOfSeconds = number;
 export type NumberOfMilliseconds = number;
 /**

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

@@ -159,13 +159,28 @@ export function _sortDescBy(items, mapper, mutate = false) {
     return _sortBy(items, mapper, mutate, 'desc');
 }
 /**
- * Like items.find(), but it tries to find from the END of the array.
+ * Similar to `Array.find`, but the `predicate` may return `END` to stop the iteration early.
  *
- * Node 18+ supports native array.findLast() - use that.
- * iOS Safari only has it since 15.4
+ * Use `Array.find` if you don't need to stop the iteration early.
+ */
+export function _find(items, predicate) {
+    for (const [i, item] of items.entries()) {
+        const result = predicate(item, i);
+        if (result === END)
+            return;
+        if (result)
+            return item;
+    }
+}
+/**
+ * Similar to `Array.findLast`, but the `predicate` may return `END` to stop the iteration early.
+ *
+ * Use `Array.findLast` if you don't need to stop the iteration early, which is supported:
+ * - in Node since 18+
+ * - in iOS Safari since 15.4
  */
 export function _findLast(items, predicate) {
-    return [...items].reverse().find(predicate);
+    return _find(items.slice().reverse(), predicate);
 }
 export function _takeWhile(items, predicate) {
     let proceed = true;

package/package.json

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

package/src/array/array.util.ts

@@ -195,13 +195,27 @@ export function _sortDescBy<T>(items: T[], mapper: Mapper<T, any>, mutate = fals
 }
 
 /**
- * Like items.find(), but it tries to find from the END of the array.
+ * Similar to `Array.find`, but the `predicate` may return `END` to stop the iteration early.
  *
- * Node 18+ supports native array.findLast() - use that.
- * iOS Safari only has it since 15.4
+ * Use `Array.find` if you don't need to stop the iteration early.
  */
-export function _findLast<T>(items: T[], predicate: Predicate<T>): T | undefined {
-  return [...items].reverse().find(predicate)
+export function _find<T>(items: T[], predicate: AbortablePredicate<T>): T | undefined {
+  for (const [i, item] of items.entries()) {
+    const result = predicate(item, i)
+    if (result === END) return
+    if (result) return item
+  }
+}
+
+/**
+ * Similar to `Array.findLast`, but the `predicate` may return `END` to stop the iteration early.
+ *
+ * Use `Array.findLast` if you don't need to stop the iteration early, which is supported:
+ * - in Node since 18+
+ * - in iOS Safari since 15.4
+ */
+export function _findLast<T>(items: T[], predicate: AbortablePredicate<T>): T | undefined {
+  return _find(items.slice().reverse(), predicate)
 }
 
 export function _takeWhile<T>(items: T[], predicate: Predicate<T>): T[] {

package/src/types.ts

@@ -233,6 +233,8 @@ export type UnixTimestampNumber = number
  */
 export type UnixTimestampMillisNumber = number
 
+export type NumberOfHours = number
+export type NumberOfMinutes = number
 export type NumberOfSeconds = number
 export type NumberOfMilliseconds = number