@naturalcycles/js-lib 14.208.0 → 14.210.0

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

@@ -116,11 +116,26 @@ export declare function _dropRightWhile<T>(items: T[], predicate: Predicate<T>):
 export declare function _count<T>(items: T[], predicate: AbortablePredicate<T>): number;
 export declare function _countBy<T>(items: T[], mapper: Mapper<T, any>): StringMap<number>;
 /**
+ * Returns an intersection between 2 arrays.
+ *
+ * Intersecion means an array of items that are present in both of the arrays.
+ *
+ * It's more performant to pass a Set as a second argument.
+ *
  * @example
  * _intersection([2, 1], [2, 3])
  * // [2]
  */
-export declare function _intersection<T>(...arrays: T[][]): T[];
+export declare function _intersection<T>(a1: T[], a2: T[] | Set<T>): T[];
+/**
+ * Returns true if there is at least 1 item common between 2 arrays.
+ * Otherwise returns false.
+ *
+ * It's more performant to use that versus `_intersection(a1, a2).length > 0`.
+ *
+ * Passing second array as Set is more performant (it'll skip turning the array into Set in-place).
+ */
+export declare function _intersectsWith<T>(a1: T[], a2: T[] | Set<T>): boolean;
 /**
  * @example
  * _difference([2, 1], [2, 3])
@@ -171,8 +186,8 @@ export declare function _maxOrUndefined<T>(array: T[]): NonNullable<T> | undefin
  * Filters out nullish values (undefined and null).
  */
 export declare function _max<T>(array: T[]): NonNullable<T>;
-export declare function _maxBy<T>(array: T[], mapper: Mapper<T, number | undefined>): T;
-export declare function _minBy<T>(array: T[], mapper: Mapper<T, number | undefined>): T;
-export declare function _maxByOrUndefined<T>(array: T[], mapper: Mapper<T, number | undefined>): T | undefined;
-export declare function _minByOrUndefined<T>(array: T[], mapper: Mapper<T, number | undefined>): T | undefined;
+export declare function _maxBy<T>(array: T[], mapper: Mapper<T, number | string | undefined>): T;
+export declare function _minBy<T>(array: T[], mapper: Mapper<T, number | string | undefined>): T;
+export declare function _maxByOrUndefined<T>(array: T[], mapper: Mapper<T, number | string | undefined>): T | undefined;
+export declare function _minByOrUndefined<T>(array: T[], mapper: Mapper<T, number | string | undefined>): T | undefined;
 export declare function _zip<T1, T2>(array1: T1[], array2: T2[]): [T1, T2][];

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._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._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");
 /**
@@ -227,16 +227,34 @@ function _countBy(items, mapper) {
 exports._countBy = _countBy;
 // investigate: _groupBy
 /**
+ * Returns an intersection between 2 arrays.
+ *
+ * Intersecion means an array of items that are present in both of the arrays.
+ *
+ * It's more performant to pass a Set as a second argument.
+ *
  * @example
  * _intersection([2, 1], [2, 3])
  * // [2]
  */
-function _intersection(...arrays) {
-    if (arrays.length === 0)
-        return []; // edge case
-    return arrays.reduce((a, b) => a.filter(v => b.includes(v)));
+function _intersection(a1, a2) {
+    const a2set = a2 instanceof Set ? a2 : new Set(a2);
+    return a1.filter(v => a2set.has(v));
 }
 exports._intersection = _intersection;
+/**
+ * Returns true if there is at least 1 item common between 2 arrays.
+ * Otherwise returns false.
+ *
+ * It's more performant to use that versus `_intersection(a1, a2).length > 0`.
+ *
+ * Passing second array as Set is more performant (it'll skip turning the array into Set in-place).
+ */
+function _intersectsWith(a1, a2) {
+    const a2set = a2 instanceof Set ? a2 : new Set(a2);
+    return a1.some(v => a2set.has(v));
+}
+exports._intersectsWith = _intersectsWith;
 /**
  * @example
  * _difference([2, 1], [2, 3])

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

@@ -207,14 +207,31 @@ export function _countBy(items, mapper) {
 }
 // investigate: _groupBy
 /**
+ * Returns an intersection between 2 arrays.
+ *
+ * Intersecion means an array of items that are present in both of the arrays.
+ *
+ * It's more performant to pass a Set as a second argument.
+ *
  * @example
  * _intersection([2, 1], [2, 3])
  * // [2]
  */
-export function _intersection(...arrays) {
-    if (arrays.length === 0)
-        return []; // edge case
-    return arrays.reduce((a, b) => a.filter(v => b.includes(v)));
+export function _intersection(a1, a2) {
+    const a2set = a2 instanceof Set ? a2 : new Set(a2);
+    return a1.filter(v => a2set.has(v));
+}
+/**
+ * Returns true if there is at least 1 item common between 2 arrays.
+ * Otherwise returns false.
+ *
+ * It's more performant to use that versus `_intersection(a1, a2).length > 0`.
+ *
+ * Passing second array as Set is more performant (it'll skip turning the array into Set in-place).
+ */
+export function _intersectsWith(a1, a2) {
+    const a2set = a2 instanceof Set ? a2 : new Set(a2);
+    return a1.some(v => a2set.has(v));
 }
 /**
  * @example

package/package.json

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

package/src/array/array.util.ts

@@ -253,13 +253,32 @@ export function _countBy<T>(items: T[], mapper: Mapper<T, any>): StringMap<numbe
 // investigate: _groupBy
 
 /**
+ * Returns an intersection between 2 arrays.
+ *
+ * Intersecion means an array of items that are present in both of the arrays.
+ *
+ * It's more performant to pass a Set as a second argument.
+ *
  * @example
  * _intersection([2, 1], [2, 3])
  * // [2]
  */
-export function _intersection<T>(...arrays: T[][]): T[] {
-  if (arrays.length === 0) return [] // edge case
-  return arrays.reduce((a, b) => a.filter(v => b.includes(v)))
+export function _intersection<T>(a1: T[], a2: T[] | Set<T>): T[] {
+  const a2set = a2 instanceof Set ? a2 : new Set(a2)
+  return a1.filter(v => a2set.has(v))
+}
+
+/**
+ * Returns true if there is at least 1 item common between 2 arrays.
+ * Otherwise returns false.
+ *
+ * It's more performant to use that versus `_intersection(a1, a2).length > 0`.
+ *
+ * Passing second array as Set is more performant (it'll skip turning the array into Set in-place).
+ */
+export function _intersectsWith<T>(a1: T[], a2: T[] | Set<T>): boolean {
+  const a2set = a2 instanceof Set ? a2 : new Set(a2)
+  return a1.some(v => a2set.has(v))
 }
 
 /**
@@ -376,13 +395,13 @@ export function _max<T>(array: T[]): NonNullable<T> {
   return a.reduce((max, item) => (max >= item ? max : item))
 }
 
-export function _maxBy<T>(array: T[], mapper: Mapper<T, number | undefined>): T {
+export function _maxBy<T>(array: T[], mapper: Mapper<T, number | string | undefined>): T {
   const max = _maxByOrUndefined(array, mapper)
   if (max === undefined) throw new Error(`_maxBy returned undefined`)
   return max
 }
 
-export function _minBy<T>(array: T[], mapper: Mapper<T, number | undefined>): T {
+export function _minBy<T>(array: T[], mapper: Mapper<T, number | string | undefined>): T {
   const min = _minByOrUndefined(array, mapper)
   if (min === undefined) throw new Error(`_minBy returned undefined`)
   return min
@@ -392,11 +411,11 @@ export function _minBy<T>(array: T[], mapper: Mapper<T, number | undefined>): T
 
 export function _maxByOrUndefined<T>(
   array: T[],
-  mapper: Mapper<T, number | undefined>,
+  mapper: Mapper<T, number | string | undefined>,
 ): T | undefined {
   if (!array.length) return
   let maxItem: T | undefined
-  let max: number | undefined
+  let max: number | string | undefined
   array.forEach((item, i) => {
     const v = mapper(item, i)
     if (v !== undefined && (max === undefined || v > max)) {
@@ -410,11 +429,11 @@ export function _maxByOrUndefined<T>(
 
 export function _minByOrUndefined<T>(
   array: T[],
-  mapper: Mapper<T, number | undefined>,
+  mapper: Mapper<T, number | string | undefined>,
 ): T | undefined {
   if (!array.length) return
   let minItem: T | undefined
-  let min: number | undefined
+  let min: number | string | undefined
   array.forEach((item, i) => {
     const v = mapper(item, i)
     if (v !== undefined && (min === undefined || v < min)) {