@naturalcycles/js-lib 14.193.0 → 14.195.0

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

@@ -74,6 +74,10 @@ export declare function _uniqBy<T>(arr: readonly T[], mapper: Mapper<T, any>): T
  * Returning `undefined` from the Mapper will EXCLUDE the item.
  */
 export declare function _by<T>(items: readonly T[], mapper: Mapper<T, any>): StringMap<T>;
+/**
+ * Map an array of items by a key, that is calculated by a Mapper.
+ */
+export declare function _mapBy<ITEM, KEY>(items: readonly ITEM[], mapper: Mapper<ITEM, KEY>): Map<KEY, ITEM>;
 /**
  * const a = [1, 2, 3, 4, 5]
  *

package/dist/array/array.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortDescBy = exports._sortBy = exports._groupBy = exports._by = exports._uniqBy = exports._pushUniqBy = exports._pushUniq = exports._uniq = exports._chunk = void 0;
+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._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");
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
@@ -115,14 +115,16 @@ exports._uniqBy = _uniqBy;
  * Returning `undefined` from the Mapper will EXCLUDE the item.
  */
 function _by(items, mapper) {
-    return items.reduce((map, item, index) => {
-        const res = mapper(item, index);
-        if (res !== undefined)
-            map[res] = item;
-        return map;
-    }, {});
+    return Object.fromEntries(items.map((item, i) => [mapper(item, i), item]).filter(([k]) => k !== undefined));
 }
 exports._by = _by;
+/**
+ * Map an array of items by a key, that is calculated by a Mapper.
+ */
+function _mapBy(items, mapper) {
+    return new Map(items.map((item, i) => [mapper(item, i), item]).filter(([k]) => k !== undefined));
+}
+exports._mapBy = _mapBy;
 /**
  * const a = [1, 2, 3, 4, 5]
  *

package/dist/datetime/dateInterval.d.ts

@@ -1,4 +1,5 @@
-import type { Inclusiveness, LocalDateInput, LocalDateUnit } from './localDate';
+import { Inclusiveness } from '../types';
+import type { LocalDateInput, LocalDateUnit } from './localDate';
 import { LocalDate } from './localDate';
 export type DateIntervalConfig = DateInterval | DateIntervalString;
 export type DateIntervalString = string;

package/dist/datetime/localDate.d.ts

@@ -1,9 +1,8 @@
 import { Iterable2 } from '../iter/iterable2';
-import type { IsoDateString, IsoDateTimeString, MonthId, SortDirection, UnixTimestampMillisNumber, UnixTimestampNumber } from '../types';
+import type { Inclusiveness, IsoDateString, IsoDateTimeString, MonthId, SortDirection, UnixTimestampMillisNumber, UnixTimestampNumber } from '../types';
 import { LocalTime } from './localTime';
 export type LocalDateUnit = LocalDateUnitStrict | 'week';
 export type LocalDateUnitStrict = 'year' | 'month' | 'day';
-export type Inclusiveness = '()' | '[]' | '[)' | '(]';
 export type LocalDateInput = LocalDate | Date | IsoDateString;
 export type LocalDateFormatter = (ld: LocalDate) => string;
 /**

package/dist/datetime/localTime.d.ts

@@ -1,5 +1,4 @@
-import type { IsoDateString, IsoDateTimeString, MonthId, SortDirection, UnixTimestampMillisNumber, UnixTimestampNumber } from '../types';
-import type { Inclusiveness } from './localDate';
+import type { Inclusiveness, IsoDateString, IsoDateTimeString, MonthId, SortDirection, UnixTimestampMillisNumber, UnixTimestampNumber } from '../types';
 import { LocalDate } from './localDate';
 export type LocalTimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second';
 export declare enum ISODayOfWeek {

package/dist/datetime/timeInterval.d.ts

@@ -1,5 +1,4 @@
-import type { UnixTimestampNumber } from '../types';
-import type { Inclusiveness } from './localDate';
+import type { UnixTimestampNumber, Inclusiveness } from '../types';
 import type { LocalTimeInput } from './localTime';
 import { LocalTime } from './localTime';
 export type TimeIntervalConfig = TimeInterval | TimeIntervalString;

package/dist/number/number.util.d.ts

@@ -1,4 +1,4 @@
-import { SortDirection } from '../types';
+import type { Inclusiveness, SortDirection } from '../types';
 export declare function _randomInt(minIncl: number, maxIncl: number): number;
 /**
  * Returns random item from an array.
@@ -17,13 +17,13 @@ export declare function _randomArrayItem<T>(array: T[]): T;
  */
 export declare function _runLessOften(percent: number): boolean;
 /**
- *  _inRange(-10, 1, 5) // false
- * _inRange(1, 1, 5) // true
- * _inRange(3, 1, 5) // true
- * _inRange(5, 1, 5) // false
- * _inRange(7, 1, 5) // false
+ *  _isBetween(-10, 1, 5) // false
+ * _isBetween(1, 1, 5) // true
+ * _isBetween(3, 1, 5) // true
+ * _isBetween(5, 1, 5) // false
+ * _isBetween(7, 1, 5) // false
  */
-export declare function _inRange(x: number, minIncl: number, maxExcl: number): boolean;
+export declare function _isBetween(x: number, min: number, max: number, incl?: Inclusiveness): boolean;
 export declare function _clamp(x: number, minIncl: number, maxIncl: number): number;
 /**
  * This function exists, because in JS you cannot just .sort() numbers,

package/dist/number/number.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._round = exports._toPrecision = exports._toFixed = exports._sortNumbers = exports._clamp = exports._inRange = exports._runLessOften = exports._randomArrayItem = exports._randomInt = void 0;
+exports._round = exports._toPrecision = exports._toFixed = exports._sortNumbers = exports._clamp = exports._isBetween = exports._runLessOften = exports._randomArrayItem = exports._randomInt = void 0;
 function _randomInt(minIncl, maxIncl) {
     return Math.floor(Math.random() * (maxIncl - minIncl + 1) + minIncl);
 }
@@ -29,16 +29,26 @@ function _runLessOften(percent) {
 exports._runLessOften = _runLessOften;
 // todo: _.random to support floats
 /**
- *  _inRange(-10, 1, 5) // false
- * _inRange(1, 1, 5) // true
- * _inRange(3, 1, 5) // true
- * _inRange(5, 1, 5) // false
- * _inRange(7, 1, 5) // false
+ *  _isBetween(-10, 1, 5) // false
+ * _isBetween(1, 1, 5) // true
+ * _isBetween(3, 1, 5) // true
+ * _isBetween(5, 1, 5) // false
+ * _isBetween(7, 1, 5) // false
  */
-function _inRange(x, minIncl, maxExcl) {
-    return x >= minIncl && x < maxExcl;
+function _isBetween(x, min, max, incl = '[)') {
+    if (incl === '[)') {
+        return x >= min && x < max;
+    }
+    else if (incl === '[]') {
+        return x >= min && x <= max;
+    }
+    else if (incl === '(]') {
+        return x > min && x <= max;
+    }
+    // ()
+    return x > min && x < max;
 }
-exports._inRange = _inRange;
+exports._isBetween = _isBetween;
 function _clamp(x, minIncl, maxIncl) {
     return x <= minIncl ? minIncl : x >= maxIncl ? maxIncl : x;
 }

package/dist/types.d.ts

@@ -243,3 +243,4 @@ export declare const _objectAssign: <T extends AnyObject>(target: T, part: Parti
  */
 export type ErrorDataTuple<T = unknown, ERR = Error> = [err: null, data: T] | [err: ERR, data: null];
 export type SortDirection = 'asc' | 'desc';
+export type Inclusiveness = '()' | '[]' | '[)' | '(]';

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

@@ -107,12 +107,13 @@ export function _uniqBy(arr, mapper) {
  * Returning `undefined` from the Mapper will EXCLUDE the item.
  */
 export function _by(items, mapper) {
-    return items.reduce((map, item, index) => {
-        const res = mapper(item, index);
-        if (res !== undefined)
-            map[res] = item;
-        return map;
-    }, {});
+    return Object.fromEntries(items.map((item, i) => [mapper(item, i), item]).filter(([k]) => k !== undefined));
+}
+/**
+ * Map an array of items by a key, that is calculated by a Mapper.
+ */
+export function _mapBy(items, mapper) {
+    return new Map(items.map((item, i) => [mapper(item, i), item]).filter(([k]) => k !== undefined));
 }
 /**
  * const a = [1, 2, 3, 4, 5]

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

@@ -23,14 +23,24 @@ export function _runLessOften(percent) {
 }
 // todo: _.random to support floats
 /**
- *  _inRange(-10, 1, 5) // false
- * _inRange(1, 1, 5) // true
- * _inRange(3, 1, 5) // true
- * _inRange(5, 1, 5) // false
- * _inRange(7, 1, 5) // false
+ *  _isBetween(-10, 1, 5) // false
+ * _isBetween(1, 1, 5) // true
+ * _isBetween(3, 1, 5) // true
+ * _isBetween(5, 1, 5) // false
+ * _isBetween(7, 1, 5) // false
  */
-export function _inRange(x, minIncl, maxExcl) {
-    return x >= minIncl && x < maxExcl;
+export function _isBetween(x, min, max, incl = '[)') {
+    if (incl === '[)') {
+        return x >= min && x < max;
+    }
+    else if (incl === '[]') {
+        return x >= min && x <= max;
+    }
+    else if (incl === '(]') {
+        return x > min && x <= max;
+    }
+    // ()
+    return x > min && x < max;
 }
 export function _clamp(x, minIncl, maxIncl) {
     return x <= minIncl ? minIncl : x >= maxIncl ? maxIncl : x;

package/package.json

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

package/src/array/array.util.ts

@@ -114,11 +114,24 @@ export function _uniqBy<T>(arr: readonly T[], mapper: Mapper<T, any>): T[] {
  * Returning `undefined` from the Mapper will EXCLUDE the item.
  */
 export function _by<T>(items: readonly T[], mapper: Mapper<T, any>): StringMap<T> {
-  return items.reduce((map, item, index) => {
-    const res = mapper(item, index)
-    if (res !== undefined) map[res] = item
-    return map
-  }, {} as StringMap<T>)
+  return Object.fromEntries(
+    items.map((item, i) => [mapper(item, i), item]).filter(([k]) => k !== undefined) as [any, T][],
+  )
+}
+
+/**
+ * Map an array of items by a key, that is calculated by a Mapper.
+ */
+export function _mapBy<ITEM, KEY>(
+  items: readonly ITEM[],
+  mapper: Mapper<ITEM, KEY>,
+): Map<KEY, ITEM> {
+  return new Map(
+    items.map((item, i) => [mapper(item, i), item]).filter(([k]) => k !== undefined) as [
+      KEY,
+      ITEM,
+    ][],
+  )
 }
 
 /**

package/src/datetime/dateInterval.ts

@@ -1,4 +1,5 @@
-import type { Inclusiveness, LocalDateInput, LocalDateUnit } from './localDate'
+import { Inclusiveness } from '../types'
+import type { LocalDateInput, LocalDateUnit } from './localDate'
 import { LocalDate, localDateRange } from './localDate'
 
 export type DateIntervalConfig = DateInterval | DateIntervalString

package/src/datetime/localDate.ts

@@ -1,6 +1,7 @@
 import { _assert } from '../error/assert'
 import { Iterable2 } from '../iter/iterable2'
 import type {
+  Inclusiveness,
   IsoDateString,
   IsoDateTimeString,
   MonthId,
@@ -12,7 +13,6 @@ import { LocalTime } from './localTime'
 
 export type LocalDateUnit = LocalDateUnitStrict | 'week'
 export type LocalDateUnitStrict = 'year' | 'month' | 'day'
-export type Inclusiveness = '()' | '[]' | '[)' | '(]'
 
 const MDAYS = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
 const DATE_REGEX = /^(\d\d\d\d)-(\d\d)-(\d\d)$/

package/src/datetime/localTime.ts

@@ -1,6 +1,7 @@
 import { _assert } from '../error/assert'
 import { _ms } from '../time/time.util'
 import type {
+  Inclusiveness,
   IsoDateString,
   IsoDateTimeString,
   MonthId,
@@ -8,7 +9,6 @@ import type {
   UnixTimestampMillisNumber,
   UnixTimestampNumber,
 } from '../types'
-import type { Inclusiveness } from './localDate'
 import { LocalDate } from './localDate'
 
 export type LocalTimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second'

package/src/datetime/timeInterval.ts

@@ -1,5 +1,4 @@
-import type { UnixTimestampNumber } from '../types'
-import type { Inclusiveness } from './localDate'
+import type { UnixTimestampNumber, Inclusiveness } from '../types'
 import type { LocalTimeInput } from './localTime'
 import { LocalTime } from './localTime'
 

package/src/number/number.util.ts

@@ -1,4 +1,4 @@
-import { SortDirection } from '../types'
+import type { Inclusiveness, SortDirection } from '../types'
 
 export function _randomInt(minIncl: number, maxIncl: number): number {
   return Math.floor(Math.random() * (maxIncl - minIncl + 1) + minIncl)
@@ -29,14 +29,27 @@ export function _runLessOften(percent: number): boolean {
 // todo: _.random to support floats
 
 /**
- *  _inRange(-10, 1, 5) // false
- * _inRange(1, 1, 5) // true
- * _inRange(3, 1, 5) // true
- * _inRange(5, 1, 5) // false
- * _inRange(7, 1, 5) // false
+ *  _isBetween(-10, 1, 5) // false
+ * _isBetween(1, 1, 5) // true
+ * _isBetween(3, 1, 5) // true
+ * _isBetween(5, 1, 5) // false
+ * _isBetween(7, 1, 5) // false
  */
-export function _inRange(x: number, minIncl: number, maxExcl: number): boolean {
-  return x >= minIncl && x < maxExcl
+export function _isBetween(
+  x: number,
+  min: number,
+  max: number,
+  incl: Inclusiveness = '[)',
+): boolean {
+  if (incl === '[)') {
+    return x >= min && x < max
+  } else if (incl === '[]') {
+    return x >= min && x <= max
+  } else if (incl === '(]') {
+    return x > min && x <= max
+  }
+  // ()
+  return x > min && x < max
 }
 
 export function _clamp(x: number, minIncl: number, maxIncl: number): number {

package/src/types.ts

@@ -326,3 +326,5 @@ export const _objectAssign = Object.assign as <T extends AnyObject>(
 export type ErrorDataTuple<T = unknown, ERR = Error> = [err: null, data: T] | [err: ERR, data: null]
 
 export type SortDirection = 'asc' | 'desc'
+
+export type Inclusiveness = '()' | '[]' | '[)' | '(]'